Elenco dei comandi

La riga di comando, situata nella barra di stato, si apre premendo il tasto SPAZIO. Durante la digitazione di un comando, appare automaticamente un elenco di suggerimenti: il tasto TAB (o MAIUSC-TAB) scorre le proposte e completa il comando, mentre ESC chiude l’elenco (un secondo ESC chiude la riga di comando). I tasti SU e GIÙ restano riservati alla cronologia dei comandi.

Operazioni globali

Comando	Azione
new, ne, n	Crea un nuovo database.
open, op, o	Apre un database esistente.
import_db, idb	Importa e unisce un altro database.
export_db, edb	Esporta la selezione corrente in un nuovo database.
quit, q	Chiude blunderDB.
help, he, h	Apre la guida di blunderDB.
tutorial, tour	Apre il catalogo delle visite guidate dell’interfaccia.
demo	Carica un database di esempio (partite, torneo, raccolte, commenti, mazzo Anki, analisi) per scoprire lo strumento.
meta	Mostra i metadati del database.
eval, epc	Apre il pannello Eval (Effective Pip Count, probabilità di vittoria e verdetto di cubo in bearoff). epc è il vecchio nome di questo pannello, conservato.
transcribe, tr	Apre il pannello Trascrizione: le bozze di partite in corso di inserimento, e il modo di iniziarne una.
direct	Apre il pannello Tornei per dirigere un torneo, e lo richiude. Finché vi è aperta una direzione, l’area principale mostra il torneo invece del tavoliere; qualsiasi altra scheda riporta il tavoliere.
met	Apre la tabella di match equity Kazaross-XG2.
cm	Apre la matrice del cubo: il verdetto della posizione corrente a tutti i punteggi di un incontro da 5, 7 o 9 punti.
tags	Apre il vocabolario di tag: i tag usati in questo database, con il numero di posizioni, cliccabili per lanciare la ricerca.
log	Apre il registro attività: le ultime duecento righe del file di log, con il necessario per copiarle in un rapporto o aprire la cartella che le contiene.
train	Apre il pannello Allenamento. Con un argomento, apre e avvia: train scores (la scheda di punteggio di un punteggio estratto a sorte; train tp e train takepoint sono sinonimi), train pips (il conteggio delle pedine dei due lati), train bearoff (l’EPC dei due lati su una posizione generata; train epc è un sinonimo), train evaluation (la probabilità di vittoria e l’azione di cubo di una posizione generata, in partita a soldi), train decision (una decisione analizzata della lista sfogliata: la mossa si gioca sulla tavola, l’azione di cubo si sceglie nel pannello; train quiz è un sinonimo).
tp2	Apre la tabella dei takepoint con cubo a 2.
tp2_live	Apre la tabella dei takepoint con cubo a 2 per le corse lunghe.
tp2_last	Apre la tabella dei takepoint con cubo a 2 morto.
tp4	Apre la tabella dei takepoint con cubo a 4.
tp4_live	Apre la tabella dei takepoint con cubo a 4 per le corse lunghe.
tp4_last	Apre la tabella dei takepoint con cubo a 4 morto.
gv1	Apre la tabella dei valori di gammon con cubo a 1.
gv2	Apre la tabella dei valori di gammon con cubo a 2.
gv4	Apre la tabella dei valori di gammon con cubo a 4.

Posizioni e navigazione

Comando	Azione
import, i	Importa una o più posizioni/incontri da file (xg, xgp, sgf, mat, txt, bgf). Con un argomento — import XGID=… o import OGID=… — legge l’identificatore invece di aprire un selettore di file, per quando arriva da un messaggio, un forum o uno script.
delete, del, d	Elimina la posizione corrente (con conferma); la cancellazione passa dal cestino e resta annullabile per trenta giorni.
trash	Apre il cestino: ciò che è stato eliminato, con quanto serve a ripristinarlo.
[number]	Vai alla posizione con l’indice indicato.
[number]%	Va a quella percentuale dell’elenco: 0% la prima posizione, 50% la metà, 100% l’ultima.
grid, gr	Apre il provino: l’elenco sfogliato come griglia di mini-tavolieri, una pagina di ventiquattro alla volta; scegliere una miniatura ne apre la posizione.
list, l	Mostra l’analisi della posizione corrente.
comment, co	Mostra/scrivi commenti.
rollout, ro [fast|standard]	Rolla la posizione corrente (con l’impostazione scelta nel pannello Analisi, o il preset indicato) e apre il pannello Analisi. ro search [fast|standard] lo avvia sulla lista mostrata, dopo una conferma con il totale; ro stop ferma il rollout in corso.
history, hi	Apre il pannello di ricerca (la cronologia di ricerca si trova nella sua scheda Cronologia).
stats, st	Mostra/nascondi il pannello delle statistiche.
match, ma	Mostra/nascondi il pannello delle partite.
collection, coll	Mostra/nascondi il pannello delle collezioni.
#tag1 tag2 …	Etichetta la posizione corrente.
e	Carica tutte le posizioni del database.
blunders, bl [n]	Carica gli errori peggiori (equity/MWC) nella vista di analisi, secondo il filtro statistico corrente. Un numero opzionale sceglie quanti caricarne (bl 50); 10 per impostazione predefinita.
m	Naviga nell’ultima partita visitata.

Modifica e ricerca

Comando	Azione
write, wr, w	Salva la posizione corrente.
write!, wr!, w!	Aggiorna la posizione corrente.
s	Cerca posizioni con i filtri.
ss	Cercare tra le posizioni visualizzate: risultati correnti, collezione aperta o match in revisione.

Filtri di ricerca

Questa tabella è il riferimento della grammatica di ricerca: la riga di comando, la biblioteca di filtri e l’opzione --query di blunderdb search leggono tutte gli stessi token. La colonna Equivalente CLI dà, quando esiste, l’opzione di search che fa la stessa cosa (vedere Interfaccia a riga di comando (CLI)); un trattino segnala un filtro che solo la grammatica esprime.

Cinque token non portano il proprio valore: lo leggono sul tavoliere di ricerca. cube e score riprendono il cubo e il punteggio lì impostati, d il tipo di decisione, D e D1 i dadi, x la struttura disegnata nella scheda Tranne. Un lancio non si scrive quindi mai nel token: D65 non esiste, solo la forma di esclusione porta le sue cifre (xD65). Sulla riga di comando, dove non c’è tavoliere, questi token si confrontano con un tavoliere vuoto; sono le opzioni della terza colonna che occorre impiegare al loro posto.

Un solo token ordina invece di restringere: like dispone il risultato per distanza crescente da una posizione bersaglio, e tutti gli altri token restringono l’insieme così ordinato.

Gli errori e le equity si contano in millesimi di equity — i millipoints della tabella qui sotto: E>100 mantiene le mosse che sono costate almeno un decimo di punto, un punto valendo 1000 millesimi.

Due ricerche complete:

• s p>30 w40,60 xco — più di 30 pip di ritardo, tra il 40 % e il 60 % di probabilità di vittoria, nessun commento.

• s ph:race E>50 co:xg — in corsa, una mossa che è costata almeno 50 millesimi, e un commento proveniente da eXtreme Gammon.

Query	Azione	Equivalente CLI
cube, cub, cu, c	La posizione verifica la configurazione del cubo.	--cube
score, sco, sc, s	La posizione verifica il punteggio.	--score1 --score2
d	La posizione verifica il tipo di decisione (pedina o cubo).	--decision
D	La posizione verifica il lancio dei dadi (entrambi i dadi, in qualsiasi ordine).	--dice 6,5
D1	La posizione verifica il lancio dei dadi solo sul primo dado (il valore del primo dado compare su uno dei due dadi della posizione).	--dice 6
xD65	La posizione non è stata giocata con il lancio 6-5 (in qualsiasi ordine). Il valore è indicato nel gettone; ripetibile per escludere più lanci (xD65 xD54).	—
nc	La posizione è senza contatto.	—
ph:race	La posizione si trova in una data fase di gioco: opening (apertura), middlegame (mediogioco), race (corsa) o bearoff (uscita delle pedine). Ripetibile (ph:race ph:bearoff). L’etichetta è derivata dalla tavola e non è mai modificabile; blunderdb repair la ricalcola.	--phase
gt:holding	La posizione rientra in un dato piano di gioco, dal punto di vista del giocatore di turno: race, bearin (rientro sotto contatto), crunch, backgame, acepoint, blitz, primevprime, mutualholding, holding, contact. Ripetibile (gt:holding gt:mutualholding). Etichetta derivata come la fase: calcolata dalla tavola, mai modificabile, ricalcolata da blunderdb repair.	--game-type
#prime	La posizione porta questo tag in uno dei suoi commenti. Un tag è una #parola scritta nella prosa; nulla lo dichiara. Il confronto è delimitato, quindi #prime non trova #priming — è tutta la differenza rispetto al filtro di testo, che cerca una sottostringa. Ripetibile, e i tag si sommano (#prime #backgame chiede entrambi): una posizione porta più tag, quindi nominarne due vuol dire «entrambi».	—
n>x	La posizione è stata incontrata più di x volte nella base — il numero di mosse che vi arrivano, in tutti gli incontri. Forme n>3, n<2, n3,10 e n4 (esattamente quattro).	—
M	La posizione o quella speculare verifica i filtri.	—
i	La posizione è stata importata singolarmente, non portata da un import di partita.	--individual
fl	La posizione è stata contrassegnata nel software di origine, durante l’importazione di una partita eXtreme Gammon.	--flagged
x	La posizione non contiene alcuna pedina della struttura di esclusione (scheda Tranne del pannello di ricerca).	—
p>x	Il giocatore ha almeno x pip di svantaggio nella corsa.	--pip-min
p<x	Il giocatore ha al massimo x pip di svantaggio nella corsa.	--pip-max
px,y	Il giocatore ha tra x e y pip di svantaggio nella corsa.	--pip-min --pip-max
P>x	Il giocatore ha una corsa di almeno x pip.	—
P<x	Il giocatore ha una corsa di al massimo x pip.	—
Px,y	Il giocatore ha una corsa tra x e y pip.	—
e>x	L’equity (in millipunti) della posizione è maggiore di x.	—
e<x	L’equity (in millipunti) della posizione è minore di x.	—
ex,y	L’equity (in millipunti) della posizione è compresa tra x e y.	—
E>x	L’errore della mossa giocata dal giocatore 1 (in millipunti) è maggiore di x.	--move-error-min
E<x	L’errore della mossa giocata dal giocatore 1 (in millipunti) è minore di x.	--move-error-max
Ex,y	L’errore della mossa giocata dal giocatore 1 (in millipunti) è compreso tra x e y.	--move-error-min --move-error-max
w>x	Il giocatore ha probabilità di vittoria superiori a x %.	--winrate-min
w<x	Il giocatore ha probabilità di vittoria inferiori a x %.	--winrate-max
wx,y	Il giocatore ha probabilità di vittoria comprese tra x % e y %.	--winrate-min --winrate-max
g>x	Il giocatore ha probabilità di gammon superiori a x %.	—
g<x	Il giocatore ha probabilità di gammon inferiori a x %.	—
gx,y	Il giocatore ha probabilità di gammon comprese tra x % e y %.	—
b>x	Il giocatore ha probabilità di backgammon superiori a x %.	—
b<x	Il giocatore ha probabilità di backgammon inferiori a x %.	—
bx,y	Il giocatore ha probabilità di backgammon comprese tra x % e y %.	—
W>x	L’avversario ha probabilità di vittoria superiori a x %.	—
W<x	L’avversario ha probabilità di vittoria inferiori a x %.	—
Wx,y	L’avversario ha probabilità di vittoria comprese tra x % e y %.	—
G>x	L’avversario ha probabilità di gammon superiori a x %.	—
G<x	L’avversario ha probabilità di gammon inferiori a x %.	—
Gx,y	L’avversario ha probabilità di gammon comprese tra x % e y %.	—
B>x	L’avversario ha probabilità di backgammon superiori a x %.	—
B<x	L’avversario ha probabilità di backgammon inferiori a x %.	—
Bx,y	L’avversario ha probabilità di backgammon comprese tra x % e y %.	—
o>x	Il giocatore ha almeno x pedine fuori.	--off1-min
o<x	Il giocatore ha al massimo x pedine fuori.	—
ox,y	Il giocatore ha tra x e y pedine fuori.	—
O>x	L’avversario ha almeno x pedine fuori.	--off2-min
O<x	L’avversario ha al massimo x pedine fuori.	—
Ox,y	L’avversario ha tra x e y pedine fuori.	—
k>x	Il giocatore ha almeno x pedine arretrate.	—
k<x	Il giocatore ha al massimo x pedine arretrate.	—
kx,y	Il giocatore ha tra x e y pedine arretrate.	—
K>x	L’avversario ha almeno x pedine arretrate.	—
K<x	L’avversario ha al massimo x pedine arretrate.	—
Kx,y	L’avversario ha tra x e y pedine arretrate.	—
z>x	Il giocatore ha almeno x pedine nella zona.	—
z<x	Il giocatore ha al massimo x pedine nella zona.	—
zx,y	Il giocatore ha tra x e y pedine nella zona.	—
Z>x	L’avversario ha almeno x pedine nella zona.	—
Z<x	L’avversario ha al massimo x pedine nella zona.	—
Zx,y	L’avversario ha tra x e y pedine nella zona.	—
bo>x	Il giocatore ha almeno x blot nell’outfield.	—
bo<x	Il giocatore ha al massimo x blot nell’outfield.	—
box,y	Il giocatore ha tra x e y blot nell’outfield.	—
BO>x	L’avversario ha almeno x blot nell’outfield.	—
BO<x	L’avversario ha al massimo x blot nell’outfield.	—
BOx,y	L’avversario ha tra x e y blot nell’outfield.	—
bj>x	Il giocatore ha almeno x blot nel jan.	—
bj<x	Il giocatore ha al massimo x blot nel jan.	—
bjx,y	Il giocatore ha tra x e y blot nel jan.	—
BJ>x	L’avversario ha almeno x blot nel jan.	—
BJ<x	L’avversario ha al massimo x blot nel jan.	—
BJx,y	L’avversario ha tra x e y blot nel jan.	—
t'parola1;parola2;...'	I commenti della posizione contengono almeno una delle parole.	—
co	La posizione ha un commento, qualunque sia il suo contenuto.	--has-comment
xco	La posizione non ha alcun commento.	--no-comment
co:user	La posizione porta un commento di una data provenienza: user (scritto da te), xg, gnubg, bgf (portato dall’importazione di una partita) o unknown. Ripetibile (co:xg co:gnubg).	--comment-origin
m'schema1,schema2,...'	Le migliori mosse di pedine contenenti almeno uno degli schemi.	—
m'ND,DT,DP,...'	Le migliori decisioni di cubo di No Double/Take, Double Take, Double Pass.	—
T>x	Data di aggiunta della posizione dopo x (AAAA/MM/GG).	—
T<x	Data di aggiunta della posizione prima di x (AAAA/MM/GG).	—
Tx,y	Data di aggiunta della posizione tra x e y (AAAA/MM/GG).	—
max	Cerca nella partita con identificatore x (es: ma3).	--match-ids
max,y	Cerca nelle partite con identificatori da x a y (es: ma2,5).	--match-ids
tnx	Cerca nel torneo con identificatore x (es: tn1).	--tournament-ids
tnx,y	Cerca nei tornei con identificatori da x a y (es: tn1,3).	--tournament-ids
idx	Cercare la posizione con identificativo x (es. id12).	--position-ids
idx,y	Cercare le posizioni con identificativi da x a y (es. id5,10).	--position-ids
pl'nome'	Cerca posizioni di una partita a cui ha partecipato il giocatore indicato, su entrambi i lati (es. pl'Alice'). Non distingue maiuscole e minuscole.	—
like, like42, like<12, like42*	Ordina il risultato per distanza crescente da una posizione bersaglio, invece di restringerlo: like prende la posizione corrente, like42 quella di indice 42, like<12 scarta ciò che dista più di dodici pip di pedina, like42* allarga la classe del bersaglio a tutti i tipi di decisione e a entrambi i regimi, soldi e incontro. Vedere Pannello Ricerca.	—

I valori pl, m e t si aprono con le virgolette o un apostrofo e si chiudono con l’uno o l’altro. Un token che conserva una virgoletta senza formare un valore completo viene ignorato, e blunderdb search --query lo segnala. Un tag può contenere un apostrofo (#l'ouverture), mai le virgolette. Il punto e virgola è il separatore delle liste di identificatori e di tag: non compare in nessun valore, e ma1;2 non è un token (scrivere ma1 ma2).

Trascrivere da un terminale

La riga di comando non ha un comando di trascrizione: i gesti si digitano nella scheda Trascrizione. Fuori dall’applicazione, passano per blunderdb call (Trascrivere tramite l’API), per esempio blunderdb call transcriptions.apply --db base.db --if-match 3 --json '{"id":1,"gesture":{"Kind":"validate"}}'. --if-match nomina la revisione restituita dalla chiamata precedente; ogni chiamata è una sessione a sé, senza sessionId né annullamento da una chiamata all’altra.

Comandi vari

Comando	Azione
clear, cl	Cancella la cronologia dei comandi.