3. Guida utente

Questa guida è un’introduzione pratica a blunderDB per iniziare rapidamente.

3.1. Creare un nuovo database

Per creare un nuovo database, fare clic sul pulsante «New Database» nella barra degli strumenti. Scegliere un percorso in cui salvare il database, oltre a un nome, e fare clic su «Save».

Nota

L’estensione dei database blunderDB è .db.

Suggerimento

Scorciatoie da tastiera: CTRL-N. Comando: n

3.2. Aprire un database esistente

Per caricare un database esistente, fare clic sul pulsante «Open Database» nella barra degli strumenti. Andare al percorso in cui si trova il database, selezionare il file .db e fare clic su «Open».

Suggerimento

Scorciatoie da tastiera: CTRL-O. Comando: o

3.3. Importare e unire un database

Per importare e unire un altro database blunderDB nel database attualmente aperto, fare clic sul pulsante «Import Database» nella barra degli strumenti. Selezionare il file .db da importare e fare clic su «Open».

blunderDB unirà in modo intelligente i due database:

  • Le posizioni che non esistono nel database attuale verranno aggiunte con le loro analisi e i loro commenti.

  • Le posizioni già esistenti verranno aggiornate: le analisi verranno completate se mancanti e i commenti verranno uniti (aggiungendo i nuovi commenti senza duplicare quelli esistenti).

  • Un messaggio riepilogherà il numero di posizioni aggiunte, unite e ignorate.

Nota

L’importazione richiede che entrambi i database abbiano versioni di schema compatibili. È possibile importare un database con una versione inferiore o uguale in un database con una versione superiore.

Attenzione

L’operazione di importazione modifica immediatamente il database attualmente aperto. Si consiglia di eseguire una copia di backup prima di importare un altro database.

3.4. Modificare una posizione

Per modificare una posizione, premere il tasto TAB per aprire il pannello di ricerca e l’editor di posizione. Modificare la posizione con il mouse:

  • fare clic sui punti per aggiungere pedine. Il clic sinistro assegna le pedine al giocatore 1. Il clic destro assegna le pedine al giocatore 2. Per inserire un prime, fare clic sul punto di partenza, tenere premuto il pulsante e rilasciare sul punto di arrivo. Fare clic sulla barra per mettere le pedine sulla barra.

  • per cancellare la posizione, fare doppio clic su un’area vuota all’esterno del board oppure premere il tasto BACKSPACE.

  • per inviare il cubo al giocatore 1, fare clic sinistro sul cubo. Per inviare il cubo al giocatore 2, fare clic destro sul cubo.

  • per indicare il giocatore che deve muovere, fare clic sull’area dei dadi prevista.

  • per modificare i dadi, clic sinistro per aumentare il valore di un dado, clic destro per diminuire il valore di un dado. Se le facce dei dadi sono vuote, significa che la posizione è una decisione di cubo.

  • per modificare il punteggio dei giocatori, clic sinistro per aumentare il punteggio, clic destro per ridurre il punteggio.

Suggerimento

L’inserimento della posizione con il mouse per le pedine avviene nello stesso modo che in XG.

3.5. Aggiungere una posizione al database

Dopo la modifica della posizione, il pannello di ricerca è aperto.

Per salvare la posizione ottenuta in precedenza, premere CTRL-S oppure fare clic sul pulsante «Save Position» nella barra degli strumenti.

Suggerimento

Aprire la riga di comando ed eseguire: w

3.6. Etichettare una posizione

Per aggiungere un tag toto alla posizione corrente, aprire la riga di comando premendo SPAZIO, digitare #toto e confermare il comando premendo INVIO.

3.7. Eliminare una posizione

Per eliminare la posizione corrente dal database, premere Del oppure fare clic sul pulsante «Delete Position» nella barra degli strumenti.

Suggerimento

Nella riga di comando, eseguire d.

Attenzione

L’eliminazione della posizione è definitiva e non richiede alcuna conferma da parte dell’utente.

3.8. Importare una posizione da XG

Per importare una posizione direttamente da XG,

  1. visualizzare in XG la posizione da importare e premere CTRL-C,

  2. aprire blunderDB e premere CTRL-V.

Nota

L’incolla automatico rileva il formato della sorgente (XG, GNUbg, BGBlitz).

3.9. Importare un match

blunderDB può importare match da diverse sorgenti.

Formati supportati:

  • eXtreme Gammon (XG): file .xg e .xgp (posizioni)

  • GNUbg: file .sgf

  • Jellyfish: file .mat e .txt

  • BGBlitz: file .bgf e .txt

Per importare uno o più file di match:

  1. Premere CTRL-I oppure fare clic sul pulsante «Import» nella barra degli strumenti.

  2. Selezionare uno o più file da importare.

  3. blunderDB rileva automaticamente il formato e importa il match.

  4. Una finestra di avanzamento mostra il numero di file importati, falliti e ignorati (duplicati).

Suggerimento

Comando: i

Nota

blunderDB rileva automaticamente i duplicati e impedisce l’importazione di un match già presente nel database.

3.10. Importare una cartella di match

Per importare ricorsivamente tutti i file di match contenuti in una cartella e nelle sue sottocartelle:

  1. Premere CTRL-SHIFT-F oppure fare clic sul pulsante corrispondente nella barra degli strumenti.

  2. Selezionare la cartella contenente i file di match.

  3. blunderDB raccoglie e importa automaticamente tutti i file riconosciuti (.xg, .xgp, .sgf, .mat, .txt, .bgf).

3.11. Trascina e rilascia

blunderDB supporta il trascina e rilascia. È possibile trascinare e rilasciare sulla finestra di blunderDB:

  • file di match o di posizione (.xg, .xgp, .sgf, .mat, .txt, .bgf) per importarli,

  • file di database (.db) per aprirli o unirli con il database corrente,

  • cartelle per importare ricorsivamente tutti i file che contengono.

3.13. Gestire il pannello dei match

Il pannello dei match (CTRL-Tab) consente di:

  • elencare tutti i match importati (ordinati dal più recente al più vecchio),

  • ordinare i match per colonna (giocatore 1, giocatore 2, data, lunghezza del match, torneo),

  • modificare i nomi dei giocatori o la data facendo doppio clic sui campi,

  • scambiare il giocatore 1 e il giocatore 2 usando il pulsante di scambio,

  • assegnare un match a un torneo,

  • eliminare un match usando il tasto Del.

3.14. Gestire le collezioni

Le collezioni consentono di organizzare le posizioni in gruppi personalizzati. Per accedere al pannello delle collezioni, premere CTRL-B.

Creare una collezione:

  1. Aprire il pannello delle collezioni (CTRL-B).

  2. Inserire il nome della nuova collezione e fare clic su «Add».

Aggiungere posizioni a una collezione:

  1. Selezionare le posizioni desiderate.

  2. Aggiungerle alla collezione dal pannello delle collezioni.

Sfogliare una collezione:

  • Fare doppio clic su una collezione per sfogliare le sue posizioni. L’ordine delle collezioni e delle posizioni può essere modificato tramite trascina e rilascia.

Suggerimento

Comando: coll

3.15. Gestire i tornei

I tornei consentono di organizzare i match importati per evento. Per accedere al pannello dei tornei, premere CTRL-Y.

Creare un torneo:

  1. Aprire il pannello dei tornei (CTRL-Y).

  2. Fare clic su «Add» e inserire il nome del torneo.

Assegnare un match a un torneo:

  • Dal pannello dei match (CTRL-Tab), usare il menu a discesa della colonna torneo per assegnare un match.

3.16. Visualizzare le statistiche di performance

Il pannello Stats consente di visualizzare i propri indicatori di performance (PR e costo MWC) a partire dalle posizioni importate.

  1. Premere CTRL-D oppure fare clic sulla scheda Stats nel pannello inferiore.

  2. Usare la barra dei filtri per limitare l’analisi per giocatore, torneo, intervallo di date, tipo di decisione o lunghezza del match.

  3. Fare clic su un indicatore per accedere direttamente alle posizioni corrispondenti.

3.17. Calcolare l’EPC

Il calcolatore EPC (Effective Pip Count) consente di calcolare le statistiche di bearoff di una posizione.

  1. Premere CTRL-E, fare clic sulla scheda EPC nel pannello inferiore oppure eseguire il comando epc.

  2. Modificare la posizione delle pedine nella casa (ultimi 6 punti).

  3. I risultati vengono visualizzati in tempo reale nel pannello EPC dedicato: EPC, numero medio di lanci, deviazione standard, pip count e wastage.

Nota

Il calcolatore funziona per entrambi i giocatori simultaneamente.

3.18. Visualizzare l’analisi di una posizione importata da XG

Se una posizione analizzata da XG, GNUbg o BGBlitz è stata importata in blunderDB, l’analisi può essere visualizzata premendo CTRL-L.

Se la posizione corrisponde a una decisione di pedine, le cinque mosse migliori vengono visualizzate su righe distinte. Per ogni riga, le informazioni fornite sono in questo ordine: la mossa di pedina associata, l’equity normalizzata, l’errore in equity della mossa, le probabilità di vittoria, gammon e backgammon del giocatore, le probabilità di vittoria, gammon e backgammon dell’avversario, il livello di analisi.

Se la posizione corrisponde a una decisione di cubo, viene visualizzato il costo di ogni decisione, oltre alle probabilità di vittoria della posizione.

Quando sono presenti più motori di analisi per la stessa posizione (ad esempio XG e GNUbg), una colonna aggiuntiva indica il motore di origine di ogni analisi.

Durante la navigazione in un match, la mossa effettivamente giocata viene evidenziata nell’elenco delle mosse. Se la posizione è stata incontrata in più match, vengono indicate tutte le mosse giocate.

Suggerimento

Facendo clic su una mossa nel pannello di analisi, le frecce corrispondenti vengono visualizzate sul board.

3.19. Esportare una posizione verso XG

Per esportare una posizione da blunderDB verso XG,

  1. visualizzare in blunderDB la posizione da esportare e premere CTRL-C,

  2. aprire XG e premere CTRL-V.

3.20. Visualizzare le diverse posizioni

Per visualizzare le diverse posizioni della libreria corrente, usare i tasti SINISTRA e DESTRA. Il tasto HOME consente di andare alla prima posizione. Il tasto FINE consente di andare all’ultima posizione.

Per visualizzare il bearoff a sinistra, premere CTRL-SINISTRA. Per visualizzare il bearoff a destra, premere CTRL-DESTRA.

3.21. Cercare posizioni in base a criteri

Per cercare tipi di posizioni,

  • premere TAB per aprire il pannello di ricerca,

  • modificare la struttura della posizione da cercare. blunderDB filtrerà le posizioni che hanno come minimo la struttura di pedine inserita. In caso di dubbio, per ottenere il massimo dei risultati, cancellare la posizione premendo il tasto BACKSPACE. Modificare se necessario la posizione del cubo e il punteggio.

Il pannello di ricerca propone due strutture di pedine, selezionabili tramite le schede At least e Except situate nella parte superiore del pannello:

  • At least (predefinito): blunderDB filtra le posizioni che hanno come minimo la struttura di pedine inserita;

  • Except: blunderDB esclude le posizioni che contengono una delle pedine inserite. Il board è bordato di rosso durante la modifica di questa struttura. Una posizione viene rifiutata se contiene almeno uno degli elementi disegnati (ad esempio, disegnare una pedina sui punti 1, 3 e 5 conserva solo le posizioni che non hanno alcuna pedina su questi punti). Il numero di pedine per punto non è limitato: indicare 3 pedine su un punto esclude le posizioni che hanno 3 pedine o più in quel punto (utile per cercare un punto chiuso senza spare). Due clic rapidi su un punto lo contrassegnano come dover essere vuoto (cella rossa tratteggiata, nessuna pedina di qualsiasi colore); un singolo clic su quel punto lo sblocca.

Quando un punto appartiene a entrambe le strutture, il criterio Except prevale se contraddice il criterio At least.

Metodo 1 (semplice):

  • Aprire la finestra di ricerca (CTRL-F)

  • Aggiungere e configurare i filtri di ricerca

  • Confermare facendo clic su «Search».

Metodo 2 (avanzato):

  • aprire la riga di comando premendo SPAZIO,

  • digitare s e aggiungere eventuali filtri supplementari (ad esempio cube o score per tenere conto rispettivamente del cubo e del punteggio. Vedere Sezione 4.4 per un elenco esaustivo dei filtri disponibili).

  • confermare la richiesta premendo INVIO.

Le posizioni visualizzate sono quelle del database che hanno soddisfatto i criteri di ricerca inseriti dall’utente.