2. Manuale
2.1. Introduzione
blunderDB è un software per creare database di posizioni di backgammon. Il suo punto di forza principale è fornire un luogo unico in cui aggregare le posizioni che un giocatore ha incontrato (online, in torneo) e poterle riesaminare filtrandole secondo vari filtri combinabili arbitrariamente. blunderDB può anche essere usato per creare cataloghi di posizioni di riferimento.
Le posizioni sono memorizzate in un database rappresentato da un file .db.
2.2. Interazioni principali
Le principali interazioni possibili con blunderDB sono:
aggiungere una nuova posizione,
modificare una posizione esistente,
copiare l’immagine del board negli appunti (PNG) tramite Ctrl+X, oppure con l’analisi completa tramite Ctrl+X Ctrl+X,
eliminare una posizione esistente,
cercare una o più posizioni,
importare match da diverse fonti (XG, GNUbg, BGBlitz, Jellyfish), compresi i commenti dai file XG,
navigare tra le mosse di un match importato,
organizzare le posizioni in raccolte,
organizzare i match in tornei.
L’utente può etichettare liberamente le posizioni con tag e annotarle tramite commenti.
2.3. Descrizione dell’interfaccia
L’interfaccia di blunderDB è composta, dall’alto verso il basso, da:
[in alto] la barra degli strumenti, che raccoglie tutte le principali operazioni eseguibili sul database,
[al centro] l’area di visualizzazione principale, che permette di visualizzare o modificare posizioni di backgammon,
[in basso] la barra di stato, che presenta diverse informazioni sul database o sulla posizione corrente e integra la riga di comando.
Possono essere visualizzati dei pannelli per:
visualizzare i dati di analisi associati alla posizione corrente provenienti da eXtreme Gammon (XG), GNUbg o BGBlitz,
visualizzare, aggiungere o modificare commenti,
cercare e filtrare posizioni secondo criteri combinabili,
visualizzare e gestire le raccolte di posizioni (pannello raccolte),
visualizzare l’elenco dei match importati e navigare tra le mosse di un match (pannello match),
visualizzare e gestire i tornei (pannello tornei),
visualizzare le statistiche di performance (pannello Stats),
calcolare l’EPC (Effective Pip Count) di una posizione di bearoff (pannello Bearoff),
studiare le posizioni tramite ripetizione dilazionata (pannello Anki),
visualizzare i metadati del database (pannello Metadati).
Possono comparire finestre modali per:
visualizzare la guida di blunderDB,
visualizzare il catalogo delle visite guidate (vedi Visite guidate e database di esempio),
configurare le impostazioni di esportazione del database,
configurare blunderDB, in particolare la lingua dell’interfaccia (vedi Configurazione).
L’area di visualizzazione principale mette a disposizione dell’utente:
un board per visualizzare o modificare una posizione di backgammon,
il livello e il proprietario del cubo,
il pip count di ciascun giocatore,
il punteggio di ciascun giocatore,
i dadi da giocare. Se sui dadi non è mostrato alcun valore, la posizione dei dadi indica quale giocatore ha il turno e che la posizione è una decisione di cubo. Quando la decisione di cubo è una risposta a un raddoppio (prendi/passa), il cubo proposto è mostrato al centro del board, al valore offerto.
La barra di stato è strutturata da sinistra a destra con le seguenti informazioni:
la riga di comando, accessibile premendo il tasto SPAZIO,
un messaggio informativo relativo a un’operazione eseguita dall’utente,
l’indice della posizione corrente, seguito dal numero di posizioni nella libreria corrente (oppure le informazioni di mossa/partita durante la navigazione in un match).
Nota
Nel caso di posizioni derivanti da una ricerca dell’utente, il numero di posizioni indicato nella barra di stato corrisponde al numero di posizioni filtrate.
2.4. Schede delle viste
Sotto la barra degli strumenti, una barra delle schede consente di lavorare con più viste in parallelo. Ogni vista è uno spazio di lavoro indipendente che conserva il proprio elenco di posizioni, l’indice della posizione corrente, la posizione visualizzata, l’analisi e la mossa selezionata, il pannello attivo, il commento in corso nonché il contesto di navigazione in un match. È così possibile, ad esempio, tenere aperta una ricerca in una vista mentre si scorre un match in un’altra.
Creare una vista : fare clic sul pulsante + della barra delle schede o premere CTRL-T. La nuova vista parte come copia della vista corrente.
Chiudere una vista : fare clic sulla croce della scheda o premere CTRL-W. L’ultima vista non può essere chiusa.
Cambiare vista : fare clic su una scheda, premere CTRL-PageUp / CTRL-PageDown (o MAIUSC-J / MAIUSC-K) per passare alla vista precedente / successiva, oppure da CTRL-1 a CTRL-9 per raggiungere direttamente l’n-esima vista.
Rinominare una vista : fare doppio clic sulla scheda, inserire il nuovo nome e confermare con INVIO.
Le viste vengono salvate con lo stato di sessione del database e ripristinate alla sua riapertura.
2.5. Configurazione
Le bouton de configuration (icône en forme de rouage) situé dans la barre d’outils, à gauche du bouton d’aide, ouvre la fenêtre de configuration de blunderDB. Elle est organisée en quatre onglets :
Interfaccia — lingua, scala di visualizzazione, posizione del pannello;
Colori della board — i colori della board;
Bearoff — la base de sortie two-sided étendue utilisée par le panneau Bearoff ;
Identità dell’emittente — la chiave che firma i tuoi contrassegni di origine, descritta nella sezione Distribuire un database: origine e password.
La scheda Interfaccia permette di scegliere la lingua tra inglese, francese, tedesco, italiano, spagnolo, finlandese, giapponese, greco e russo. L’intera interfaccia (barra degli strumenti, pannelli, messaggi, aiuto) viene tradotta nella lingua selezionata. La scelta della lingua viene salvata e mantenuta da una sessione all’altra.
Le même onglet propose aussi le bouton Compacter la base, qui récupère
l’espace disque laissé par les suppressions (matchs, tournois, purges) : la
base de données ne rétrécit jamais toute seule quand on supprime des données,
il faut demander explicitement ce compactage. L’opération peut prendre du
temps sur une grosse base et nécessite, temporairement, environ deux fois sa
taille en espace disque libre (blunderDB refuse de démarrer plutôt que de
risquer un compactage interrompu) ; une confirmation est donc demandée avant
de lancer l’opération. Le résultat — l’espace gagné, en mégaoctets — s’affiche
ensuite dans la barre d’état. La même opération est disponible en ligne de
commande via blunderdb vacuum (voir Interfaccia a riga di comando (CLI)).
La scheda Colori della board permette di personalizzare i colori della board. Ogni elemento dispone di un proprio selettore di colore: lo sfondo, il bordo, le punte chiare e scure, le pedine del giocatore 1 e del giocatore 2, i dadi, i punti dei dadi e il cubo. Il pulsante Reimposta ripristina tutti i colori predefiniti. Come la lingua, i colori scelti vengono mantenuti da una sessione all’altra.
L’onglet Bearoff gère la base two-sided qui étend le domaine exact du
panneau Bearoff (voir Pannello Bearoff) au-delà de la base TS-06-06
embarquée dans l’exécutable. Il affiche le domaine actuellement actif
(TS-06-06 ou TS-06-11 une fois téléchargée) et son origine, propose de
lancer le téléchargement de la base étendue TS-06-11 avec une barre de
progression, et reprend automatiquement un téléchargement interrompu au
lieu de repartir de zéro (requêtes HTTP par plage). Une fois téléchargée, la
base peut être supprimée — une confirmation est demandée avant toute
suppression, la taille du fichier étant rappelée dans le message. L’onglet
permet aussi de pointer vers un fichier .bd two-sided externe (par exemple
une base générée soi-même) plutôt que d’utiliser le téléchargement intégré.
La finestra di configurazione raggruppa anche alcune impostazioni di visualizzazione dell’interfaccia. Un cursore di scala dell’interfaccia consente di ingrandire o ridurre l’insieme degli elementi, il che è utile sugli schermi ad alta densità o per migliorare la leggibilità. Un menu posizione dei pannelli determina la collocazione dei pannelli (ricerca, match, analisi) rispetto al tavoliere: in basso, di lato o automatica (il lato viene allora scelto sugli schermi larghi per sfruttare meglio lo spazio disponibile). Come le altre impostazioni, queste scelte vengono conservate da una sessione all’altra.
2.6. Visite guidate e database di esempio
Per facilitare i primi passi, blunderDB propone delle visite guidate dell’interfaccia. Il catalogo delle visite si apre dalla barra degli strumenti o con il comando tour (alias tutorial). Sono disponibili quattro visite: una visita generale dell’interfaccia e visite dedicate alla ricerca di posizioni, alla revisione delle partite e alla revisione dei tornei. Ogni visita evidenzia gli elementi interessati dell’interfaccia, passo dopo passo, e può essere ripetuta in qualsiasi momento. Al primo avvio, la visita generale viene proposta automaticamente.
Il comando demo carica un database di esempio (partite, un torneo e analisi) che permette di scoprire le funzionalità dello strumento senza importare le proprie partite. Le visite guidate si appoggiano a questo database quando nessun database è aperto.
2.8. Modifica delle posizioni
La pressione del tasto TAB apre il pannello di ricerca e permette di modificare una posizione sul board per aggiungerla al database o per definire una struttura di posizione da cercare. La distribuzione delle pedine, il cubo, il punteggio e il turno possono essere modificati con il mouse (vedi Modificare una posizione).
Suggerimento
Fare riferimento a Scorciatoie da tastiera per le scorciatoie disponibili.
2.9. La riga di comando
La riga di comando, integrata nella barra di stato, permette di eseguire tutte le funzionalità di blunderDB disponibili nell’interfaccia grafica: operazioni generali sul database, navigazione delle posizioni, visualizzazione dell’analisi e/o dei commenti, ricerca di posizioni secondo filtri… Dopo aver preso confidenza con l’interfaccia, si raccomanda di utilizzare progressivamente la riga di comando, che consente un uso potente e fluido di blunderDB, in particolare per le funzionalità di ricerca delle posizioni.
Per aprire la riga di comando, premere il tasto SPAZIO. Per inviare una richiesta e chiudere la riga di comando, premere il tasto INVIO.
blunderDB esegue le richieste inviate dall’utente a condizione che siano valide e modifica immediatamente lo stato del database se necessario. Non sono richieste azioni di salvataggio esplicite da parte dell’utente.
Suggerimento
Fare riferimento a Sezione 4 per l’elenco dei comandi disponibili nella riga di comando.
2.10. Pannello Analisi
Il pannello Analisi (CTRL-L) visualizza i dati di analisi della posizione corrente importati da eXtreme Gammon (XG), GNUbg o BGBlitz. Mostra le migliori alternative (mosse di pedine o decisioni di cubo) con i relativi valori di equity e gli errori corrispondenti. Il tasto d alterna tra l’analisi delle mosse di pedine e l’analisi del cubo. Durante la navigazione in un match, la mossa effettivamente giocata viene evidenziata nell’elenco delle alternative. Premere CTRL-L o eseguire il comando list per mostrare o nascondere il pannello.
2.11. Pannello Commenti
Il pannello Commenti (CTRL-P) visualizza, aggiunge e modifica i commenti associati alla posizione corrente. I commenti importati dai file XG vengono automaticamente associati alle posizioni corrispondenti. Premere CTRL-P o eseguire il comando comment per mostrare o nascondere il pannello.
2.12. Pannello Ricerca
Il pannello Ricerca (CTRL-F o TAB) permette di filtrare le posizioni secondo criteri liberamente combinabili: struttura delle pedine, tipo di decisione di cubo, magnitudo dell’errore, date, tag, ecc. Il tasto TAB apre contemporaneamente il pannello di ricerca e l’editor di posizione, consentendo di definire una struttura di pedine da cercare direttamente sul board.
Per affinare una ricerca tra le posizioni attualmente filtrate, usare il comando ss seguito da filtri (es.: ss nc, ss E>40). Il pannello di ricerca offre anche una casella di spunta Search in current results per la stessa funzionalità.
Il pannello offre un controllo esplicito del tipo di decisione ricercato: Indifferente (nessun filtro), Pedine (decisioni di mossa) o Cubo (decisioni di cubo). Quando è selezionato Cubo, un secondo elenco precisa il sotto-tipo: Tutti, Raddoppio / No raddoppio (il giocatore di turno deve decidere se raddoppiare) o Accetta / Passa (risposta a un raddoppio avversario). Il controllo è sincronizzato con il board: modificare i dadi o il cubo sul board aggiorna il tipo di decisione, e viceversa. In modalità Accetta / Passa, il cubo è mostrato al centro del board al valore offerto; tale valore resta modificabile.
Il filtro Contrassegnata conserva le posizioni che avete contrassegnato nel software di origine della partita. Solo eXtreme Gammon produce questa informazione, registrata mossa per mossa nel file .xg; blunderDB la legge all’importazione e la conserva. Una decisione di cubo contrassegnata dà due posizioni contrassegnate, il raddoppio e l’accetta/passa, poiché blunderDB divide in due ciò che il file di origine registra come una sola decisione.
Nota
La marcatura non è retroattiva: le partite già presenti nel database non contengono questa informazione, poiché esiste solo nei file di origine. È sufficiente reimportare il file .xg interessato — l’importazione rileva il duplicato e non aggiunge altro che i contrassegni, senza toccare i commenti né le analisi esistenti. Il contrassegno non può essere né posto né rimosso da blunderDB: per un elenco di lavoro temporaneo, utilizzate piuttosto una collezione.
Il filtro Commento interroga i commenti associati alle posizioni secondo tre modalità esclusive. contiene il testo cerca una o più parole nel testo dei commenti (campo di immissione, parole separate da ;, almeno una deve corrispondere); ha un commento conserva ogni posizione che porti un commento, qualunque sia il suo contenuto; senza commento conserva al contrario le posizioni non annotate — utile, combinato con un filtro di errore o di data, per stilare l’elenco di ciò che resta da commentare.
Nota
I commenti importati da un file di partita (XG, GNUbg) contano come commenti: blunderDB non conserva la loro origine e non può quindi distinguere una nota da voi inserita da una nota ripresa dal file di origine. Inoltre, i commenti associati a una partita o a un torneo non sono interessati: annotano la partita o il torneo, non le sue posizioni.
Il filtro Match & Tornei si basa su un selettore comune (finestra modale) anziché sull’inserimento di identificativi numerici: due elenchi con caselle di spunta, uno per i match e uno per i tornei, ciascuno filtrabile per testo (giocatore, data, evento per i match; nome, data, luogo per i tornei), con pulsanti Tutti / Nessuno che agiscono solo sul sottoinsieme attualmente filtrato. Selezionare un torneo seleziona automaticamente (e disabilita, mostrandoli in grigio) i match che ne fanno parte nell’elenco dei match, rendendo visibile il fatto che un torneo equivale all’insieme dei suoi match.
Il pannello di ricerca presenta tre schede sul bordo sinistro: Ricerca (i filtri), Cronologia e Salvati. La scheda Cronologia elenca le ricerche passate con la loro data e il loro comando: un clic seleziona una ricerca e mostra la posizione associata sul tavoliere, un doppio clic la riesegue. Ogni voce può essere salvata nella libreria di filtri (icona segnalibro, assegnando un nome al filtro) o eliminata. La scheda Salvati contiene la libreria di filtri : fare doppio clic su un filtro salvato per rilanciare la ricerca corrispondente (vedere Appendice: Utilizzo avanzato dei filtri). Il comando history (alias hi) apre il pannello di ricerca.
Suggerimento
Fare riferimento a Sezione 4 per l’elenco dei filtri disponibili.
2.13. Pannello Raccolte
Le panneau Collections (CTRL-B) permet de gérer des collections de
positions. Les collections peuvent être créées, renommées et supprimées. Des
positions peuvent y être ajoutées ou retirées (touche Suppr, confirmation
demandée). Double-cliquer sur une collection pour parcourir ses positions
avec les touches GAUCHE et DROITE. L’ordre des collections et des
positions au sein des collections peut être modifié par glisser-déposer.
Appuyer sur CTRL-B ou exécuter la commande collection pour afficher ou
masquer le panneau.
2.14. Pannello Match
Il pannello Match (CTRL-Tab) elenca i match importati. Fare doppio clic su un match (o premere INVIO) per navigare tra le sue mosse. Il comando m riprende la navigazione nell’ultimo match visitato.
L’utente può:
scorrere le mosse di un match usando i tasti SINISTRA e DESTRA,
passare da una partita all’altra con i tasti PageUp e PageDown,
visualizzare l’analisi delle mosse (pedine e cubo) premendo CTRL-L,
alternare tra l’analisi delle mosse di pedine e quella del cubo con il tasto d,
vedere la mossa effettivamente giocata evidenziata nell’analisi.
L’ultima posizione visitata in ciascun match viene memorizzata e ripristinata automaticamente. Premere CTRL-Tab o eseguire il comando match per mostrare o nascondere il pannello.
Ogni match può essere esportato in trascrizione Jellyfish .mat tramite il pulsante ⬇ dell’elenco dei match o il pulsante .mat della scheda del match.
Il pulsante Unisci giocatori della barra degli strumenti del pannello apre una finestra che elenca tutti i nomi dei giocatori del database con il loro numero di match: selezionare le varianti di ortografia di uno stesso giocatore, scegliere il nome canonico da conservare, quindi unire. Utile per unificare le statistiche per giocatore quando uno stesso giocatore compare con più nomi.
Quando un match è aperto, una barra delle informazioni compare sopra il tavoliere: ricorda i giocatori presenti (giocatore 1 contro giocatore 2) nonché il contesto del match (evento, luogo, turno, data e lunghezza del match, quando queste informazioni sono disponibili). Questa barra viene mostrata anche al di fuori della modalità match: quando una posizione studiata (proveniente da una ricerca, da una collezione o da un accesso diretto) proviene da uno o più match, ne indica la provenienza — il primo match interessato e, se del caso, un badge « +N » che elenca gli altri al passaggio del mouse. Una posizione importata da sola, che nessun match referenzia, non mostra nulla.
All’apertura di un database contenente match, il pannello Match viene mostrato subito e la revisione inizia direttamente sulla prima posizione, così da cominciare immediatamente la navigazione.
Nota
Un database può essere aperto in scrittura da una sola finestra alla volta. Se si apre un database già aperto in un’altra finestra di blunderDB, esso si apre in sola lettura : la navigazione, la ricerca e l’analisi restano possibili, ma qualsiasi modifica è disattivata e la barra del titolo mostra « [sola lettura] ».
Suggerimento
Fare riferimento a Scorciatoie da tastiera per le scorciatoie disponibili.
2.15. Pannello Tornei
Il pannello Tornei (CTRL-Y) permette di raggruppare i match in tornei per un monitoraggio organizzato e un’analisi statistica per evento. I tornei possono essere creati, rinominati ed eliminati; i match possono essere assegnati ad essi. Le statistiche del pannello Stats possono essere filtrate per torneo. Premere CTRL-Y per mostrare o nascondere il pannello.
La colonna PR di ogni torneo mostra il PR del giocatore di riferimento — vale a dire il giocatore presente nel maggior numero di partite del torneo (in caso di parità, quello che ha preso più decisioni). Il PR non mescola quindi il vostro gioco con quello dei vostri avversari: per i vostri tornei, riflette la vostra sola prestazione. Il nome del giocatore di riferimento appare in un suggerimento passando sopra il valore.
2.16. Pannello Stats
2.16.1. Introduzione
Il pannello Stats permette di analizzare il proprio livello di gioco e di seguire la propria progressione nel tempo a partire dalle posizioni importate nel database. Calcola e visualizza gli indicatori PR (Performance Rate) e MWC cost (Match Winning Chance cost) per l’insieme delle posizioni o per un sottoinsieme filtrato.
Il pannello Stats è particolarmente utile per:
valutare il proprio livello rispetto alle soglie di riferimento (world-class, esperto, avanzato…) grazie al PR globale;
seguire la propria progressione torneo dopo torneo o match dopo match grazie ai grafici della scheda Progressione;
individuare i propri punti deboli: la scheda Errori mostra la ripartizione tra mosse di pedine e decisioni di cubo e la distribuzione delle magnitudo d’errore;
accedere direttamente alle posizioni interessate cliccando su qualsiasi indicatore (drill-down).
2.16.2. Apertura del pannello
Per aprire il pannello Stats:
Premere CTRL-D.
Digitare il comando
:statso:stnella riga di comando.
Nota
Il pannello si aggiorna automaticamente a ogni modifica del filtro. Non ricalcola le statistiche in caso di semplice passaggio PR ↔ MWC: entrambe le metriche vengono calcolate simultaneamente dal backend.
2.16.3. Barra dei filtri
La barra dei filtri, in alto nel pannello, permette di limitare il calcolo a un sottoinsieme di posizioni.
2.16.3.1. Prospettiva del giocatore
Il menu a discesa Giocatore permette di filtrare le statistiche in base al giocatore analizzato. blunderDB seleziona automaticamente il giocatore il cui nome compare più spesso nel database — modificabile in qualsiasi momento.
Suggerimento
Cambiare giocatore non comporta alcuna perdita di dati; è sufficiente riselezionare il giocatore precedente dall’elenco.
2.16.3.2. Filtri disponibili
Torneo(i) — restrizione a uno o più tornei. È possibile selezionare più tornei contemporaneamente.
Date — intervallo temporale (Da … A). Se viene indicata solo la data di inizio, vengono incluse le posizioni più recenti.
Tipo di decisione — Tutti / Mosse di pedine / Decisioni di cubo.
Lunghezza del match — restrizione a lunghezze di match specifiche (1, 3, 5, 7, 9, 11, 13, 15, 21 punti). È possibile combinare più lunghezze.
Un pulsante Reset azzera tutti i filtri (tranne il giocatore rilevato automaticamente).
Nota
I filtri vengono salvati nella configurazione di blunderDB (config.yaml) e ripristinati all’avvio successivo.
2.16.4. Commutazione PR / MWC
Il pulsante PR / MWC in alto nel pannello commuta la metrica visualizzata in tutte le schede.
PR (Performance Rate)
Misura la qualità di gioco money-game: somma degli errori in millesimi di punto, divisa per il numero di decisioni. Indipendente dal punteggio del match.
Soglie di riferimento approssimative:
Livello
PR
World-class
< 3
Esperto
3 – 5
Avanzato
5 – 8
Intermedio
8 – 12
Principiante
> 12
MWC cost (Match Winning Chance cost)
Probabilità cumulata di vittoria del match persa a causa degli errori, sull’intero set di dati filtrato. Calcolata a partire dalla MET Kazaross-XG2 integrata in blunderDB.
Attenzione
Il MWC cost non è applicabile alle posizioni money-game (senza posta di match). Queste posizioni sono escluse dal calcolo MWC. I valori MWC dipendono dalla MET utilizzata; non sono direttamente confrontabili tra software che usano MET diverse.
La commutazione PR ↔ MWC è istantanea: non viene eseguito alcun ricalcolo da parte del backend.
2.16.5. Scheda Dashboard
La scheda Dashboard offre una visione sintetica degli indicatori chiave.
2.16.5.1. Schede di livello
Tre schede visualizzano il PR (o MWC) per:
All — tutte le decisioni (pedine + cubo);
Checker — solo mosse di pedine;
Cube — solo decisioni di cubo.
Cliccando su una scheda si caricano nel pannello di analisi le posizioni del sottoinsieme corrispondente (drill-down).
Nota
Il numero totale di decisioni viene visualizzato in fondo a ciascuna scheda al passaggio del mouse.
2.16.5.2. PR mobile sulle ultime N decisioni
Una riga di valori PR (o MWC) calcolati sulle ultime N decisioni (N = 5, 10, 50, 100, 250, 500, 1000) permette di misurare la tendenza recente. I valori in grigio corrispondono a un N superiore al numero di decisioni disponibili.
Cliccando su un valore si caricano le ultime N posizioni corrispondenti.
2.16.5.3. Top blunder
L’elenco dei 10 errori peggiori (o MWC cost), ordinati per magnitudo decrescente. Cliccando su una riga si carica la posizione interessata nel pannello di analisi.
2.16.6. Scheda Progressione
La scheda Progressione presenta l’evoluzione del livello nel tempo.
2.16.6.1. Grafico a linee per torneo
Un grafico a linee visualizza il PR (o MWC) per ciascun torneo (asse X: ordine dei tornei, asse Y: valore della metrica). Bande colorate evidenziano le soglie di livello.
Cliccando su un punto del grafico si apre un menu contestuale con due opzioni:
Open tournament — apre il torneo nel pannello Tornei.
Open positions — carica tutte le posizioni del torneo nel pannello di analisi.
2.16.6.2. Scatter plot per match
Un grafico a dispersione rappresenta ciascun match (asse X: data, asse Y: PR o MWC). La dimensione del punto è proporzionale al numero di decisioni nel match.
Cliccando su un punto si apre un menu contestuale:
Open match — apre il match nel pannello Match.
Open positions — carica tutte le posizioni del match nel pannello di analisi.
2.16.7. Scheda Errori
La scheda Errori scompone le fonti di errore.
2.16.7.1. Ripartizione per azione di cubo
Un diagramma a barre visualizza il PR (o MWC) per ciascun tipo di decisione di cubo: NoDouble, DoubleTake, DoublePass, TooGood. Ogni barra indica inoltre il numero di decisioni e il tasso di blunder in un suggerimento.
Cliccando su una barra si caricano le posizioni corrispondenti a quell’azione di cubo, solo quelle con un errore (drill-down).
2.16.7.2. Direction des erreurs de videau
La répartition ci-dessus indique combien coûtent les décisions de videau ; ce tableau indique dans quel sens elles se trompent.
Une position de videau porte deux décisions prises par deux joueurs différents, présentées ici en deux lignes :
Offrir — le joueur qui tient le videau double ou ne double pas. Ses erreurs sont les doubles manqués (il fallait doubler) et les doubles prématurés (il ne fallait pas).
Répondre — le joueur à qui le videau est offert prend ou passe. Ses erreurs sont les passes à tort (une prise correcte a été passée) et les prises à tort (une passe correcte a été prise).
Les deux lignes restent séparées à dessein : un joueur peut parfaitement doubler tard et prendre large, et un indicateur unique appellerait cela « équilibré » en perdant les deux moitiés de l’information.
Chaque case affiche le nombre de décisions ; l’infobulle donne l’équité perdue cumulée. Cliquer sur une case charge les positions correspondantes. Une case à zéro n’est pas cliquable.
Nota
Ce tableau compte des décisions, il ne porte pas de jugement. À partir de quel écart une tendance mérite d’être nommée dépend de l’effectif et d’un point de référence, qui ne sont pas des données du moteur.
2.16.7.3. Confronto Checker / Cube
Un diagramma comparativo affianca il PR delle mosse di pedine e quello delle decisioni di cubo. Cliccando su una barra si caricano le posizioni del sottoinsieme con errore.
2.16.7.4. Istogramma delle magnitudo d’errore
Un istogramma distribuisce gli errori in base alla loro magnitudo in millesimi di punto (fasce: 0–5, 5–10, 10–25, 25–50, 50–100, ≥ 100). Cliccando su una barra si caricano le posizioni della fascia.
2.16.8. Regola di aggregazione
Importante
Il PR di un torneo (o di un qualsiasi sottoinsieme) è calcolato con la regola somma/somma — mai come media dei PR individuali dei match.
Formula:
Esempio: un giocatore disputa due match in un torneo —
Match A: 10 decisioni, errore totale 50 mp → PR = 5,0
Match B: 90 decisioni, errore totale 270 mp → PR = 3,0
Media ingenua dei PR: (5,0 + 3,0) / 2 = 4,0 (errato)
Regola somma/somma: (50 + 270) / (10 + 90) = 320 / 100 = 3,2 (corretto)
La regola somma/somma è l’unica che gestisce correttamente la variazione di lunghezza dei match (un match a 21 punti pesa più di un match a 1 punto).
2.16.9. MWC: limitazioni
Il MWC cost è calcolato a partire dalla MET Kazaross-XG2, tabella di riferimento di fatto nel backgammon agonistico. I risultati non sono direttamente confrontabili con software che usano altre MET.
Le posizioni money-game (senza punteggio di match) sono escluse dal calcolo MWC. Se il database contiene molte posizioni money-game, il MWC cost potrebbe essere sottostimato o non disponibile.
Il MWC cost è cumulativo sull’intero set di dati filtrato — non è un indicatore per singola decisione. Misura l’impatto totale dei tuoi errori sulle tue probabilità di vittoria.
2.17. Pannello Bearoff
Le panneau Bearoff (CTRL-E) calcule l’EPC (Effective Pip Count) d’une
position de bearoff. Il est activé en appuyant sur CTRL-E, en cliquant sur
l’onglet Bearoff dans le panneau inférieur, ou en exécutant la commande
epc.
In questo pannello l’utente modifica la posizione delle pedine nelle due tavole interne: un clic sulle punte da 1 a 6 colloca pedine del giocatore in basso, un clic sulle punte da 19 a 24 colloca pedine del giocatore in alto (il pulsante del mouse è indifferente).
I risultati sono presentati sotto forma di due tabelle impilate:
in alto, una tabella dei giocatori — una riga per giocatore (contrassegnata dal suo pallino colorato, con il giocatore nero sempre in basso), una colonna per grandezza: EPC, pip count, wastage (differenza tra l’EPC e il pip count), numero medio di lanci e deviazione standard. Quando entrambi i giocatori hanno pedine nella propria tavola, una riga Δ fornisce le differenze con segno (basso − alto: negativo quando il giocatore nero è in vantaggio) di EPC, pip e wastage;
sotto, separata da un filetto, una tabella corsa/cubo: due colonne di probabilità di vittoria (una per pallino di giocatore, valori senza il segno %) e le equità money — sotto ogni decisione diversa dalla migliore, lo scarto di equità rispetto alla migliore decisione è indicato tra parentesi. La decisione è mostrata a destra della tabella, con il badge esatto/stimato. Il giocatore al tiro e la posizione del cubo si modificano direttamente sul tavoliere, come in modalità di modifica: cliccare il rettangolo bearoff/punteggio di un giocatore gli assegna il tiro; cliccare il cubo lo fa ruotare centrato → posseduto in basso → posseduto in alto (clic destro in senso inverso). Il valore del cubo resta fissato — in money game le equità sono espresse in unità del cubo corrente, conta solo il suo proprietario. L’analisi viene ricalcolata immediatamente. In regime stimato, il collegamento « Vedi le impostazioni di configurazione » apre direttamente la scheda Bearoff della configurazione.
La casella Sfida resta fissata in alto a destra del pannello.
Quando la posizione è un bearoff puro (tutte le pedine dei due giocatori nella propria tavola), la tabella corsa mostra, per il giocatore al tiro:
la probabilità di vittoria,
in regime esatto: le equità money (cubeless, senza raddoppio, raddoppio/prende, raddoppio/passa) e il verdetto di cubo money (nessun raddoppio, raddoppio/prende o raddoppio/passa),
in regime stimato: la sola probabilità di vittoria, accompagnata dal suo margine d’errore — il verdetto di cubo non viene allora volutamente mostrato.
Un badge indica il regime: esatto (valore letto in un database two-sided) o stimato ± margine. Vedere Metodologia e ipotesi del pannello Bearoff per la definizione precisa dei due regimi e delle loro ipotesi.
Estendere il dominio esatto. Il database integrato copre 6 pedine per giocatore. Due modi per andare oltre, nella scheda Bearoff della configurazione:
télécharger la base étendue TS-06-11 (1,2 Go, vérifiée par SHA-256, supprimable au même endroit après confirmation) : verdict exact jusqu’à 11 pions par joueur. Un téléchargement interrompu ou annulé reprend où il s’était arrêté (le fichier partiel est conservé et complété par requête HTTP Range) ;
indicare un qualsiasi file
.bdtwo-sided di gnubg. Il database con il dominio più ampio prevale automaticamente.
Modalità sfida. La casella Sfida del pannello attiva una modalità di allenamento: a ogni modifica della posizione, i valori delle tre zone — la riga del giocatore in basso, la riga del giocatore in alto e la tabella corsa — vengono nascosti (sostituiti da « ··· »); un clic su una zona rivela solo quella zona. La riga Δ appare solo una volta rivelate le due righe dei giocatori. Ci si può così allenare a stimare l’EPC di ciascun campo, poi a pronunciarsi sul cubo, prima di verificare. L’impostazione viene memorizzata.
Per chiudere il pannello Bearoff, premere CTRL-E o passare a un’altra scheda.
2.17.1. Metodologia e ipotesi del pannello Bearoff
Ogni valore mostrato dal pannello si basa su ipotesi precise, enunciate qui in modo esaustivo.
Dominio. Il pannello tratta solo il bearoff puro: tutte le pedine rimanenti dei due giocatori nella propria tavola interna. La posizione è valutata prima del lancio; gli eventuali dadi presenti vengono ignorati. Le corse senza contatto con pedine fuori dalla tavola non vengono trattate.
Blocchi EPC (sempre esatti). L’EPC, il numero medio di lanci e la deviazione standard provengono dalla distribuzione esatta del numero di lanci necessari per far uscire tutte le pedine, letta nel database one-sided di GNUbg (6 punte, 15 pedine, integrato). EPC = lanci medi × 49/6 (49/6 ≈ 8,167 è la media esatta di pip per lancio, con i doppi contati quattro volte); wastage = EPC − pip count. L’unica idealizzazione è il gioco one-sided ottimale: ogni giocatore minimizza i propri lanci ignorando l’avversario — è la definizione standard dell’EPC.
Probabilità di vittoria, regime esatto. Lettura diretta nel database two-sided disponibile più ampio (integrato TS-06-06, file esterno o TS-06-11 scaricato). Questi database risultano da un’analisi retrograda completa sotto gioco two-sided ottimale di entrambi i campi: nessuna ipotesi supplementare, errore limitato alla quantizzazione (< 0,002 %).
Probabilità di vittoria, regime stimato. Fuori dal dominio del database: la probabilità si ottiene convolvendo le due distribuzioni one-sided (il giocatore al tiro vince se il suo numero di lanci è inferiore o uguale a quello dell’avversario), poi applicando una correzione polinomiale fissa, calibrata offline rispetto al database TS-06-11. Tre ipotesi:
indipendenza dei due processi di uscita — strutturale in corsa, senza contatto non c’è alcuna interazione;
gioco one-sided ottimale di entrambi i campi — è l’approssimazione: in realtà il giocatore in svantaggio devia per giocare la varianza e chi conduce per la sicurezza. L’effetto misurato è un bias antisimmetrico (la convoluzione esagera il vantaggio di chi conduce) che la correzione assorbe statisticamente;
la correzione è stata calibrata e validata sul dominio dell’oracolo (fino a 11 pedine per giocatore). Errore residuo misurato: deviazione standard 0,05 %, 99º percentile 0,17 %, massimo osservato 0,9 % (in punti di probabilità di vittoria). Oltre 11 pedine per giocatore, questo limite è estrapolato — la tendenza è monotona ma nessun oracolo la certifica.
Equità e verdetto di cubo (solo regime esatto). Le equità mostrate sono quelle del money game, senza Jacoby, nel riferimento della letteratura del bearoff. Nel dominio ≤ 11 pedine per giocatore i gammon sono impossibili (ogni campo ha già fatto uscire almeno 4 pedine): non è un’approssimazione. Il verdetto (nessun raddoppio / raddoppio, prende / raddoppio, passa) è ricostruito esattamente dalle equità memorizzate, secondo la regola di GNUbg, validata punto per punto rispetto alla sua analisi.
Nota
Le equità cubeful presuppongono un gioco di cubo ottimale di entrambi i campi fino alla fine: i recube futuri sono integralmente valorizzati (analisi retrograda completa). Nelle corse molto volatili di fine partita, la cascata di recube consuma quasi tutto il vantaggio del campo al tiro — le equità « senza raddoppio » e « raddoppio/prende » possono allora essere vicine allo zero là dove un motore come XG, il cui modello di cubo non valorizza questa cascata, mostra valori vicini al dead cube (per esempio 2 pedine sulla punta 3 contro 2 pedine sulla punta 2: 62 % di vittoria, D/T esatto +0,006 contro +0,475 per XG). La decisione mostrata, invece, coincide con quella dei motori.
Perché il verdetto non è mai stimato? L’equità cubeful è un problema di traiettoria (quando raddoppiare), che nessun riassunto statistico della posizione riesce a catturare: il miglior modello statico misurato lascia un errore residuo (deviazione standard 0,016 di equità, massimo 0,20) sufficiente a invertire tutte le decisioni serrate. Allo stesso modo, la conversione del verdetto al punteggio del match tramite una tabella di equità di match è risultata insufficiente (12 % di disaccordi con l’analisi 2-ply di GNUbg, con veri blunder). Poiché un verdetto sbagliato mostrato con sicurezza è peggio di nessun verdetto, blunderDB mostra il verdetto solo quando è esatto — e money.
Nota
I database di bearoff sono tabelle matematiche immutabili, rigenerabili con lo strumento makebearoff di GNUbg.
2.18. Pannello Anki
Il pannello Anki (CTRL-K) permette di studiare le posizioni tramite ripetizione dilazionata utilizzando l’algoritmo FSRS. L’utente può creare mazzi a partire da raccolte o risultati di ricerca.
Creazione di mazzi: Cliccare su New Deck per creare un mazzo a partire da una raccolta o dai risultati di ricerca correnti. I mazzi basati su una ricerca si sincronizzano automaticamente all’apertura della scheda Anki.
Revisione: Selezionare un mazzo e poi cliccare su Study (oppure fare doppio clic su un mazzo) per iniziare la revisione delle carte in scadenza. Ogni carta mostra la posizione corrispondente sul board. Valutare il proprio richiamo con i tasti 1 (Da rivedere), 2 (Difficile), 3 (Bene) o 4 (Facile). Premere Esc per interrompere e tornare all’elenco dei mazzi.
Allenamento libero (cram): Il pulsante Cram, accanto a Study, avvia una sessione di allenamento libero: ti vengono mostrate posizioni casuali del mazzo senza tenere conto della pianificazione FSRS. Questa modalità non modifica mai il piano di ripetizione dilazionata — ideale per scaldarsi prima di un torneo o per ripassare intensamente un mazzo tematico senza alterarne l’ordine. Un’etichetta Cram sostituisce lo stato della carta e un pulsante Avanti (tasti 1–4) scorre le posizioni. Esc torna all’elenco senza salvare una sessione interrotta.
Interruzione/Ripresa: È possibile interrompere una sessione di revisione in qualsiasi momento con Esc. Il pulsante cambia in Resume e mostra la tua progressione. Cliccarci sopra per riprendere da dove ci si era fermati.
Gestion des paquets : Utilisez les boutons d’action pour renommer, synchroniser, réinitialiser ou supprimer des paquets (confirmation demandée pour ces deux dernières actions). Les paramètres FSRS (rétention cible, intervalle maximum, aléa) peuvent être configurés par paquet dans les Paramètres (icône engrenage).
2.19. Pannello Metadati
Il pannello Metadati visualizza le informazioni generali del database corrente: nome, descrizione, numero di posizioni, numero di match e di partite, versione dello schema. Accessibile tramite il comando meta.
Mostra inoltre, quando esiste, l’origine del database — vedere Distribuire un database: origine e password. Un database ordinario non mostra questa sezione.
2.20. Distribuire un database: origine e password
Un insegnante che distribuisce un database di posizioni dispone di due meccanismi, indipendenti l’uno dall’altro, entrambi facoltativi e scelti al momento dell’esportazione: contrassegnare il file con la sua origine e proteggerlo con una password.
Nota
Nessuno dei due tiene traccia di ciò che accade al file. blunderDB non registra nulla dal lato di chi riceve il database: aprire un database contrassegnato è esattamente come aprirne uno qualsiasi, e da nessuna parte viene annotato chi lo ha aperto, quando, né da dove proviene il suo contenuto.
2.20.1. Contrassegnare un database con la sua origine
La finestra di esportazione sta in una sola schermata: il modulo e, sovrapposto ad esso durante la scrittura, un indicatore di avanzamento. Si chiude da sola al termine e il risultato appare nella barra di stato.
Tre punti meritano attenzione:
L’esportazione riguarda le posizioni attualmente visualizzate, non l’intero database. Dopo una ricerca vengono esportati solo i risultati: la finestra lo ricorda in alto.
Una raccolta le cui posizioni non siano tutte nella selezione arriva troncata. L’elenco mostra quindi, per ogni raccolta, la parte coperta («12/40») e la segnala in rosso quando è parziale.
I tornei possono essere esportati solo insieme ai match: senza di essi il collegamento torneo–match non esiste e il torneo arriverebbe vuoto. La casella resta disattivata finché non è selezionato «includi i match».
I campi Utente, Descrizione e Data descrivono il file prodotto; sono precompilati a partire dal database di origine. La casella I miei filtri salvati è a sé stante: non esporta contenuti ma le tue ricerche salvate, inutili nel database di qualcun altro.
Selezionando Contrassegna questo file con la sua origine compaiono due campi:
Origine — che cos’è questo file e da dove proviene, con parole tue: «Lezione di Jean Dupont — 12 marzo 2026». Questo campo è obbligatorio: finché è vuoto, il pulsante di esportazione resta inattivo.
Nota, facoltativa — condizioni d’uso, indirizzo di contatto, la richiesta di non ridistribuire.
Il contrassegno è firmato con la tua identità di emittente. È quindi inalterabile e non falsificabile: nessuno può modificarlo né fabbricarne uno a tuo nome. Non è invece incancellabile: il file distribuito è un normale database SQLite e blunderDB è software libero. Non impedisce nulla: dice da dove viene il file.
2.20.2. Identità dell’emittente
I contrassegni sono firmati con la tua identità di emittente, creata da sé la prima volta che contrassegni un file; non c’è nulla da configurare. Appartiene a una persona e non a un database: tutti i tuoi file recano la stessa impronta pubblica, nella forma A3F1-9C24-7B05-E1D8.
Puoi comunicare questa impronta ai tuoi destinatari perché verifichino che un file proviene davvero da te. L’identità si sposta da un computer all’altro in un unico file (estensione .bdbid), eventualmente protetto da una passphrase. Questo file permette di firmare a tuo nome: non condividerlo.
Nelle impostazioni (icona a ingranaggio della barra degli strumenti), la scheda Identità dell’emittente mostra il tuo nome e la tua impronta e propone Salva identità…, Carica identità… e Rigenera….
Avvertimento
Rigenerare non revoca nulla. Un contrassegno incorpora la chiave pubblica che lo ha firmato: si verifica quindi per sempre, da sé. Se il tuo file di identità è trapelato, chi lo possiede potrà continuare a firmare con la tua vecchia impronta, e quei contrassegni resteranno validi.
Ciò che ti protegge dopo una fuga non è il software: è pubblicare la tua nuova impronta e disconoscere la vecchia presso i tuoi destinatari.
La rigenerazione sovrascrive la chiave attuale; blunderDB propone di salvarla prima di sostituirla.
2.20.3. Proteggere un database con una password
La password si digita mascherata, qui come all’apertura di un file protetto; l’icona a forma di occhio la mostra finché la si tiene premuta e la nasconde di nuovo appena la si rilascia.
Selezionando Proteggi questo file con una password si ottiene un file con estensione .dbx, anche se nella finestra di salvataggio avevi scelto un nome in .db, poiché tale finestra si apre prima che venga chiesta la password. Per aprirlo, usa la consueta apertura di un database: la finestra di selezione accetta sia i .db sia i .dbx. blunderDB chiede allora la password e installa accanto un database ordinario; in seguito non viene più chiesto nulla.
La finestra propone di eliminare il file protetto una volta aperto: altrimenti si conserva lo stesso contenuto sotto due nomi. La casella non è selezionata per impostazione predefinita — il file protetto resta tuo se intendi trasmetterlo — e l’eliminazione avviene solo dopo un’apertura riuscita.
Avvertimento
La password protegge il trasporto del file, non il database. Impedisce a un terzo di aprire un file dimenticato in una cartella di download o un allegato inoltrato per errore. Non protegge da colui al quale hai dato la password.
La password viene verificata a ogni apertura, anche quando il file è già stato aperto in precedenza su quel computer.
Tecnicamente il database è cifrato con AES-256 in modalità GCM, con una chiave derivata dalla password tramite Argon2id (64 MiB di memoria, 3 passaggi, 4 thread) e un sale casuale proprio di ogni file. La modalità GCM autentica l’insieme: una password errata viene rilevata come tale, e così pure qualsiasi alterazione del file cifrato — non si ottiene mai in silenzio un database corrotto.
L’intestazione del file protetto resta in chiaro: la sua origine rimane leggibile senza la password.
2.20.4. Leggere l’origine di un file
Nell’applicazione, apri il file e mostra il pannello Metadati (comando meta). In cima al pannello compare una sezione Origine, in sola lettura, che indica ciò che è stato iscritto, da chi, quando, e lo stato della firma:
«✓ firma verificata — contrassegnato da te»: il file reca il tuo contrassegno, intatto;
«✓ firma verificata»: il contrassegno è intatto e proviene da un’altra chiave — confronta la sua impronta con quella che l’autore ti ha comunicato;
«⚠ firma non valida»: il documento è stato modificato o contraffatto.
Questa sezione non compare in un database ordinario.
Da riga di comando, blunderdb info --db file.db mostra l’origine e lo stato della firma, senza mai scrivere nel file. Il comando funziona anche su un file protetto, senza la password. Vedere CLI_USAGE.md per le opzioni --watermark e --password di export, nonché per identity e open.