2. Manual
2.1. Introducción
blunderDB es un programa para crear bases de datos de posiciones de backgammon. Su principal fortaleza es ofrecer un único lugar donde agregar las posiciones que un jugador ha encontrado (en línea, en torneos) y poder reestudiarlas filtrándolas según diversos filtros combinables de forma arbitraria. blunderDB también puede usarse para crear catálogos de posiciones de referencia.
Las posiciones se almacenan en una base de datos representada por un fichero .db.
2.2. Interacciones principales
Las principales interacciones posibles con blunderDB son:
añadir una nueva posición,
modificar una posición existente,
copiar la imagen del tablero al portapapeles (PNG) mediante Ctrl+X, o con el análisis completo mediante Ctrl+X Ctrl+X,
eliminar una posición existente,
buscar una o varias posiciones,
importar partidas desde diferentes fuentes (XG, GNUbg, BGBlitz, Jellyfish), incluidos los comentarios de los ficheros XG,
navegar por las jugadas de una partida importada,
organizar las posiciones en colecciones,
organizar las partidas en torneos.
El usuario puede etiquetar libremente las posiciones mediante etiquetas y anotarlas con comentarios.
2.3. Descripción de la interfaz
La interfaz de blunderDB se compone, de arriba abajo, de:
[arriba] la barra de herramientas, que reúne todas las principales operaciones que pueden realizarse sobre la base de datos,
[en el centro] la zona de visualización principal, que permite mostrar o editar posiciones de backgammon,
[abajo] la barra de estado, que presenta diversa información sobre la base de datos o la posición actual, e integra la línea de comandos.
Pueden mostrarse paneles para:
mostrar los datos de análisis asociados a la posición actual procedentes de eXtreme Gammon (XG), GNUbg o BGBlitz,
mostrar, añadir o modificar comentarios,
buscar y filtrar posiciones según criterios combinables,
mostrar y gestionar las colecciones de posiciones (panel de colecciones),
mostrar la lista de partidas importadas y navegar por las jugadas de una partida (panel de partidas),
mostrar y gestionar los torneos (panel de torneos),
mostrar las estadísticas de rendimiento (panel Stats),
calcular el EPC (Effective Pip Count) de una posición de bearoff (panel Bearoff),
estudiar las posiciones mediante repetición espaciada (panel Anki),
ver los metadatos de la base de datos (panel Metadatos).
Pueden mostrarse ventanas modales para:
mostrar la ayuda de blunderDB,
mostrar el catálogo de visitas guiadas (ver Visitas guiadas y base de ejemplo),
configurar la exportación de la base de datos,
configurar blunderDB, en particular el idioma de la interfaz (véase Configuración).
La zona de visualización principal pone a disposición del usuario:
un tablero para mostrar o editar una posición de backgammon,
el nivel y el propietario del cubo,
el pip count de cada jugador,
la puntuación de cada jugador,
los dados a jugar. Si no se muestra ningún valor en los dados, la posición de los dados indica qué jugador tiene el turno y que la posición es una decisión de cubo. Cuando la decisión de cubo es una respuesta a un doblaje (aceptar/pasar), el cubo propuesto se muestra en el centro del tablero, con el valor ofrecido.
La barra de estado está estructurada de izquierda a derecha con la siguiente información:
la línea de comandos, accesible pulsando la tecla ESPACIO,
un mensaje informativo relacionado con una operación realizada por el usuario,
el índice de la posición actual, seguido del número de posiciones en la biblioteca actual (o la información de jugada/partida al navegar por una partida).
Nota
En el caso de posiciones resultantes de una búsqueda del usuario, el número de posiciones indicado en la barra de estado corresponde al número de posiciones filtradas.
2.4. Pestañas de vistas
Bajo la barra de herramientas, una barra de pestañas permite trabajar con varias vistas en paralelo. Cada vista es un espacio de trabajo independiente que conserva su propia lista de posiciones, el índice de la posición actual, la posición mostrada, el análisis y la jugada seleccionada, el panel activo, el comentario en curso, así como el contexto de navegación en una partida. Así es posible, por ejemplo, mantener una búsqueda abierta en una vista mientras se recorre una partida en otra.
Crear una vista: hacer clic en el botón + de la barra de pestañas o pulsar CTRL-T. La nueva vista comienza como una copia de la vista actual.
Cerrar una vista: hacer clic en la cruz de la pestaña o pulsar CTRL-W. La última vista no se puede cerrar.
Cambiar de vista: hacer clic en una pestaña, pulsar CTRL-PageUp / CTRL-PageDown (o MAJ-J / MAJ-K) para pasar a la vista anterior / siguiente, o CTRL-1 a CTRL-9 para ir directamente a la n-ésima vista.
Renombrar una vista: hacer doble clic en la pestaña, escribir el nuevo nombre y validar con INTRO.
Las vistas se guardan con el estado de sesión de la base de datos y se restauran al reabrirla.
2.5. Configuración
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 :
Interfaz — idioma, escala de visualización, posición del panel;
Colores del tablero — los colores del tablero;
Bearoff — la base de sortie two-sided étendue utilisée par le panneau Bearoff ;
Identidad del emisor — la clave que firma tus marcas de origen, descrita en la sección Distribuir una base de datos: origen y contraseña.
La pestaña Interfaz permite elegir el idioma entre inglés, francés, alemán, italiano, español, finés, japonés, griego y ruso. Toda la interfaz (barra de herramientas, paneles, mensajes, ayuda) se traduce al idioma seleccionado. La elección del idioma se guarda y se conserva de una sesión a otra.
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 Interfaz de línea de comandos (CLI)).
La pestaña Colores del tablero permite personalizar los colores del tablero. Cada elemento dispone de su propio selector de color: el fondo, el borde, las flechas claras y oscuras, las fichas del jugador 1 y del jugador 2, los dados, los puntos de los dados y el cubo de dobles. El botón Restablecer devuelve todos los colores predeterminados. Al igual que el idioma, los colores elegidos se conservan de una sesión a otra.
L’onglet Bearoff gère la base two-sided qui étend le domaine exact du
panneau Bearoff (voir Panel 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 ventana de configuración también incluye ajustes de visualización de la interfaz. Un control deslizante de escala de la interfaz permite agrandar o reducir todos los elementos, lo que resulta útil en pantallas de alta densidad o para mejorar la legibilidad. Un menú posición de los paneles determina la ubicación de los paneles (búsqueda, partidas, análisis) con respecto al tablero: abajo, al lado o automática (en este caso el lado se elige en las pantallas anchas para aprovechar mejor el espacio disponible). Como los demás ajustes, estas opciones se conservan de una sesión a otra.
2.6. Visitas guiadas y base de ejemplo
Para facilitar la toma de contacto, blunderDB ofrece visitas guiadas de la interfaz. El catálogo de visitas se abre desde la barra de herramientas o con el comando tour (alias tutorial). Hay cuatro visitas disponibles: una visita general de la interfaz, y visitas dedicadas a la búsqueda de posiciones, a la revisión de partidas y a la revisión de torneos. Cada visita resalta los elementos correspondientes de la interfaz, paso a paso, y puede repetirse en cualquier momento. En el primer arranque, la visita general se ofrece automáticamente.
El comando demo carga una base de ejemplo (partidas, un torneo y análisis) que permite descubrir las funcionalidades de la herramienta sin importar las partidas propias. Las visitas guiadas se apoyan en esta base cuando no hay ninguna base abierta.
2.8. Edición de posiciones
Pulsar la tecla TAB abre el panel de búsqueda y permite editar una posición en el tablero para añadirla a la base de datos o para definir una estructura de posición que buscar. La distribución de las fichas, el cubo, la puntuación y el turno pueden modificarse con el ratón (véase Editar una posición).
Truco
Consulte Atajos de teclado para ver los atajos disponibles.
2.9. La línea de comandos
La línea de comandos, integrada en la barra de estado, permite realizar todas las funcionalidades de blunderDB disponibles en la interfaz gráfica: operaciones generales sobre la base de datos, navegación por las posiciones, visualización del análisis o de los comentarios, búsqueda de posiciones según filtros… Tras una primera toma de contacto con la interfaz, se recomienda utilizar progresivamente la línea de comandos, que permite un uso potente y fluido de blunderDB, especialmente para las funcionalidades de búsqueda de posiciones.
Para abrir la línea de comandos, pulse la tecla ESPACIO. Para enviar una consulta y cerrar la línea de comandos, pulse la tecla INTRO.
blunderDB ejecuta las consultas enviadas por el usuario siempre que sean válidas y modifica inmediatamente el estado de la base de datos si procede. No se requieren acciones de guardado explícitas por parte del usuario.
Truco
Consulte la Sección 4 para ver la lista de comandos disponibles en la línea de comandos.
2.10. Panel de Análisis
El panel Análisis (CTRL-L) muestra los datos de análisis de la posición actual importados desde eXtreme Gammon (XG), GNUbg o BGBlitz. Presenta las mejores alternativas (jugadas de fichas o decisiones de cubo) con sus valores de equidad y los errores correspondientes. La tecla d alterna entre el análisis de las jugadas de fichas y el análisis del cubo. Durante la navegación por una partida, la jugada realmente jugada se resalta en la lista de alternativas. Pulse CTRL-L o ejecute el comando list para mostrar u ocultar el panel.
2.11. Panel de Comentarios
El panel Comentarios (CTRL-P) muestra, añade y modifica los comentarios asociados a la posición actual. Los comentarios importados de los ficheros XG se asocian automáticamente a las posiciones correspondientes. Pulse CTRL-P o ejecute el comando comment para mostrar u ocultar el panel.
2.12. Panel de Búsqueda
El panel Búsqueda (CTRL-F o TAB) permite filtrar las posiciones según criterios libremente combinables: estructura de fichas, tipo de decisión de cubo, magnitud del error, fechas, etiquetas, etc. La tecla TAB abre simultáneamente el panel de búsqueda y el editor de posición, lo que permite definir una estructura de fichas que buscar directamente en el tablero.
Para afinar una búsqueda entre las posiciones filtradas actualmente, use el comando ss seguido de filtros (p. ej.: ss nc, ss E>40). El panel de búsqueda ofrece también una casilla Search in current results para la misma funcionalidad.
El panel ofrece un control explícito del tipo de decisión buscado: Indiferente (ningún filtro), Fichas (decisiones de jugada) o Cubo (decisiones de cubo). Cuando se selecciona Cubo, una segunda lista precisa el subtipo: Todos, Doblar / No doblar (el jugador con el turno debe decidir si doblar) o Aceptar / Pasar (respuesta a un doblaje del rival). El control está sincronizado con el tablero: modificar los dados o el cubo en el tablero actualiza el tipo de decisión, y viceversa. En modo Aceptar / Pasar, el cubo se muestra en el centro del tablero con el valor ofrecido; ese valor sigue siendo editable.
El filtro Marcada conserva las posiciones que ha marcado en el programa de origen de la partida. Solo eXtreme Gammon produce esta información, registrada jugada a jugada en el archivo .xg; blunderDB la lee al importar y la conserva. Una decisión de cubo marcada da dos posiciones marcadas, el doblez y la aceptación/paso, ya que blunderDB divide en dos lo que el archivo de origen registra como una sola decisión.
Nota
El marcado no es retroactivo: las partidas ya presentes en la base no contienen esta información, puesto que solo existe en los archivos de origen. Basta con volver a importar el archivo .xg correspondiente — la importación detecta el duplicado y no añade nada más que las marcas, sin tocar los comentarios ni los análisis existentes. El marcado no puede ponerse ni quitarse desde blunderDB: para una lista de trabajo temporal, utilice más bien una colección.
El filtro Comentario consulta los comentarios asociados a las posiciones según tres modos exclusivos. contiene el texto busca una o varias palabras en el texto de los comentarios (campo de entrada, palabras separadas por ;, al menos una debe coincidir); tiene un comentario conserva toda posición que lleve un comentario, sea cual sea su contenido; sin comentario conserva por el contrario las posiciones no anotadas — útil, combinado con un filtro de error o de fecha, para elaborar la lista de lo que queda por comentar.
Nota
Los comentarios importados desde un archivo de partida (XG, GNUbg) cuentan como comentarios: blunderDB no conserva su origen y por tanto no puede distinguir una nota que usted haya escrito de una nota tomada del archivo de origen. Por otra parte, los comentarios asociados a una partida o a un torneo no se ven afectados: anotan la partida o el torneo, no sus posiciones.
El filtro Partidas y Torneos se apoya en un selector común (ventana modal) en lugar de la introducción de identificadores numéricos: dos listas de casillas, una para las partidas y otra para los torneos, cada una filtrable por texto (jugador, fecha, evento para las partidas; nombre, fecha, lugar para los torneos), con botones Todo / Ninguno que solo actúan sobre el subconjunto actualmente filtrado. Marcar un torneo marca automáticamente (y atenúa) sus partidas miembro en la lista de partidas, dejando patente que un torneo equivale al conjunto de sus partidas.
El panel de búsqueda cuenta con tres pestañas en su borde izquierdo: Búsqueda (los filtros), Historial y Guardados. La pestaña Historial enumera las búsquedas anteriores con su fecha y su comando: un clic selecciona una búsqueda y muestra la posición asociada en el tablero, un doble clic la vuelve a ejecutar. Cada entrada puede guardarse en la biblioteca de filtros (icono de marcador, dándole un nombre al filtro) o eliminarse. La pestaña Guardados contiene la biblioteca de filtros: hacer doble clic en un filtro guardado para relanzar la búsqueda correspondiente (véase Anexo: Uso avanzado de los filtros). El comando history (alias hi) abre el panel de búsqueda.
Truco
Consulte la Sección 4 para ver la lista de filtros disponibles.
2.13. Panel de Colecciones
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. Panel de Partidas
El panel Partidas (CTRL-Tab) lista las partidas importadas. Haga doble clic en una partida (o pulse INTRO) para navegar por sus jugadas. El comando m reanuda la navegación en la última partida visitada.
El usuario puede:
recorrer las jugadas de una partida con las teclas IZQUIERDA y DERECHA,
pasar de una partida a otra con las teclas PageUp y PageDown,
mostrar el análisis de las jugadas (fichas y cubo) pulsando CTRL-L,
alternar entre el análisis de las jugadas de fichas y del cubo con la tecla d,
ver la jugada realmente jugada resaltada en el análisis.
La última posición visitada en cada partida se guarda y se restaura automáticamente. Pulse CTRL-Tab o ejecute el comando match para mostrar u ocultar el panel.
Cada partida puede exportarse en transcripción Jellyfish .mat mediante el botón ⬇ de la lista de partidas o el botón .mat de la ficha de la partida.
El botón Fusionar jugadores de la barra de herramientas del panel abre una ventana que enumera todos los nombres de jugadores de la base con su número de partidas: seleccionar las variantes de ortografía de un mismo jugador, elegir el nombre canónico que se desea conservar y, a continuación, fusionar. Útil para unificar las estadísticas por jugador cuando un mismo jugador aparece con varios nombres.
Cuando una partida está abierta, aparece una barra de información sobre el tablero: recuerda los jugadores presentes (jugador 1 contra jugador 2) así como el contexto de la partida (evento, lugar, ronda, fecha y longitud de la partida, cuando esa información está disponible). Esta barra también se muestra fuera del modo partida: cuando una posición estudiada (procedente de una búsqueda, de una colección o de un acceso directo) proviene de una o varias partidas, indica su procedencia — la primera partida implicada y, en su caso, una insignia « +N » que enumera las demás al pasar el cursor. Una posición importada por separado, que ninguna partida referencia, no muestra nada.
Al abrir una base que contiene partidas, el panel Partidas se muestra de inmediato y la revisión comienza directamente en la primera posición, para empezar a navegar de inmediato.
Nota
Una base de datos solo puede abrirse en escritura por una única ventana a la vez. Si abre una base ya abierta en otra ventana de blunderDB, se abre en modo de solo lectura: la navegación, la búsqueda y el análisis siguen siendo posibles, pero toda modificación queda desactivada y la barra de título muestra « [solo lectura] ».
Truco
Consulte Atajos de teclado para ver los atajos disponibles.
2.15. Panel de Torneos
El panel Torneos (CTRL-Y) permite agrupar partidas en torneos para un seguimiento organizado y un análisis estadístico por evento. Los torneos pueden crearse, renombrarse y eliminarse; las partidas pueden asignarse a ellos. Las estadísticas del panel Stats pueden filtrarse por torneo. Pulse CTRL-Y para mostrar u ocultar el panel.
La columna PR de cada torneo muestra el PR del jugador de referencia — es decir, el jugador presente en el mayor número de partidas del torneo (en caso de empate, el que haya tomado más decisiones). El PR no mezcla por tanto su juego con el de sus adversarios: para sus propios torneos, refleja únicamente su rendimiento. El nombre del jugador de referencia aparece en un cuadro emergente al pasar por encima del valor.
2.16. Panel Stats
2.16.1. Introducción
El panel Stats permite analizar el nivel de juego y seguir la progresión a lo largo del tiempo a partir de las posiciones importadas en la base de datos. Calcula y muestra los indicadores PR (Performance Rate) y MWC cost (Match Winning Chance cost) para el conjunto de las posiciones o para un subconjunto filtrado.
El panel Stats resulta especialmente útil para:
situar su nivel respecto a los umbrales de referencia (world-class, experto, avanzado…) gracias al PR global;
seguir su progresión torneo a torneo o partida a partida gracias a los gráficos de la pestaña Progresión;
identificar sus puntos débiles: la pestaña Errores para ver el reparto entre jugadas de fichas y decisiones de cubo, y la distribución de las magnitudes de error;
acceder directamente a las posiciones implicadas haciendo clic en cualquier indicador (drill-down).
2.16.2. Apertura del panel
Para abrir el panel Stats:
Pulse CTRL-D.
Escriba el comando
:statso:sten la línea de comandos.
Nota
El panel se actualiza automáticamente cada vez que se modifica el filtro. No recalcula las estadísticas al alternar simplemente entre PR ↔ MWC: ambas métricas se calculan simultáneamente por el backend.
2.16.3. Barra de filtro
La barra de filtro, en la parte superior del panel, permite restringir el cálculo a un subconjunto de posiciones.
2.16.3.1. Perspectiva del jugador
La lista desplegable Jugador permite filtrar las estadísticas según el jugador analizado. blunderDB selecciona automáticamente el jugador cuyo nombre aparece con más frecuencia en la base de datos, modificable en cualquier momento.
Truco
Cambiar de jugador no provoca ninguna pérdida de datos; basta con volver a seleccionar el jugador anterior en la lista.
2.16.3.2. Filtros disponibles
Torneo(s) — restricción a uno o varios torneos. Pueden seleccionarse varios torneos simultáneamente.
Fechas — intervalo temporal (Desde … Hasta). Si solo se indica la fecha de inicio, se incluyen las posiciones más recientes.
Tipo de decisión — Todas / Jugadas de fichas / Decisiones de cubo.
Longitud de match — restricción a longitudes de match concretas (1, 3, 5, 7, 9, 11, 13, 15, 21 puntos). Pueden combinarse varias longitudes.
Un botón Reset restablece todos los filtros (salvo el jugador autodetectado).
Nota
Los filtros se guardan en la configuración de blunderDB (config.yaml) y se restauran en el próximo inicio.
2.16.4. Conmutador PR / MWC
El botón PR / MWC situado en la parte superior del panel alterna la métrica mostrada en todas las pestañas.
PR (Performance Rate)
Mide la calidad de juego en money-game: suma de los errores en milésimas de punto, dividida por el número de decisiones. Independiente de la puntuación del match.
Umbrales de referencia aproximados:
Nivel
PR
World-class
< 3
Experto
3 – 5
Avanzado
5 – 8
Intermedio
8 – 12
Principiante
> 12
MWC cost (Match Winning Chance cost)
Probabilidad acumulada de victoria del match perdida a causa de los errores, sobre el conjunto de datos filtrado. Calculada a partir de la MET Kazaross-XG2 integrada en blunderDB.
Prudencia
El MWC cost no es aplicable a las posiciones de money-game (sin apuesta de match). Esas posiciones se excluyen del cálculo de MWC. Los valores de MWC dependen de la MET utilizada; no son directamente comparables entre programas que usan METs diferentes.
El cambio PR ↔ MWC es instantáneo: no se realiza ningún recálculo en el backend.
2.16.5. Pestaña Dashboard
La pestaña Dashboard ofrece una vista sintética de los indicadores clave.
2.16.5.1. Tarjetas de nivel
Tres tarjetas muestran el PR (o MWC) para:
All — todas las decisiones (fichas + cubo);
Checker — solo jugadas de fichas;
Cube — solo decisiones de cubo.
Hacer clic en una tarjeta carga en el panel de análisis las posiciones del subconjunto correspondiente (drill-down).
Nota
El número total de decisiones se muestra en la parte inferior de cada tarjeta al pasar el cursor.
2.16.5.2. PR deslizante sobre las últimas N decisiones
Una fila de valores PR (o MWC) calculados sobre las últimas N decisiones (N = 5, 10, 50, 100, 250, 500, 1000) permite medir la tendencia reciente. Los valores atenuados corresponden a un N superior al número de decisiones disponibles.
Hacer clic en un valor carga las últimas N posiciones correspondientes.
2.16.5.3. Top blunders
La lista de los 10 peores errores (o MWC cost), ordenados por magnitud decreciente. Hacer clic en una fila carga la posición implicada en el panel de análisis.
2.16.6. Pestaña Progresión
La pestaña Progresión presenta la evolución del nivel a lo largo del tiempo.
2.16.6.1. Curva por torneo
Un gráfico de líneas muestra el PR (o MWC) para cada torneo (eje X: orden de los torneos, eje Y: valor de la métrica). Unas bandas de color materializan los umbrales de nivel.
Hacer clic en un punto del gráfico abre un menú contextual con dos opciones:
Open tournament — abre el torneo en el panel Torneos.
Open positions — carga todas las posiciones del torneo en el panel de análisis.
2.16.6.2. Gráfico de dispersión por partida
Un diagrama de dispersión representa cada partida (eje X: fecha, eje Y: PR o MWC). El tamaño del punto es proporcional al número de decisiones de la partida.
Hacer clic en un punto abre un menú contextual:
Open match — abre la partida en el panel de partidas.
Open positions — carga todas las posiciones de la partida en el panel de análisis.
2.16.7. Pestaña Errores
La pestaña Errores desglosa las fuentes de error.
2.16.7.1. Reparto por acción de cubo
Un diagrama de barras muestra el PR (o MWC) para cada tipo de decisión de cubo: NoDouble, DoubleTake, DoublePass, TooGood. Cada barra indica también el número de decisiones y la tasa de blunders en una información emergente.
Hacer clic en una barra carga las posiciones correspondientes a esa acción de cubo, solo las que tienen un error (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. Comparación Checker / Cube
Un diagrama comparativo coloca lado a lado el PR de las jugadas de fichas y de las decisiones de cubo. Hacer clic en una barra carga las posiciones del subconjunto con error.
2.16.7.4. Histograma de las magnitudes de error
Un histograma distribuye los errores según su magnitud en milésimas de punto (intervalos: 0–5, 5–10, 10–25, 25–50, 50–100, ≥ 100). Hacer clic en una barra carga las posiciones del intervalo.
2.16.8. Regla de agregación
Importante
El PR de un torneo (o de cualquier subconjunto) se calcula mediante la regla suma/suma, nunca como media de los PR individuales de las partidas.
Fórmula:
Ejemplo: un jugador disputa dos partidas en un torneo —
Partida A: 10 decisiones, error total 50 mp → PR = 5,0
Partida B: 90 decisiones, error total 270 mp → PR = 3,0
Media ingenua de los PR: (5,0 + 3,0) / 2 = 4,0 (incorrecto)
Regla suma/suma: (50 + 270) / (10 + 90) = 320 / 100 = 3,2 (correcto)
La regla suma/suma es la única que maneja correctamente la variación de longitud de los matches (un match a 21 puntos pesa más que un match a 1 punto).
2.16.9. MWC: limitaciones
El MWC cost se calcula a partir de la MET Kazaross-XG2, tabla de referencia de facto en el backgammon competitivo. Los resultados no son directamente comparables con programas que usan otras METs.
Las posiciones de money-game (sin puntuación de match) se excluyen del cálculo de MWC. Si su base de datos contiene muchas posiciones de money-game, el MWC cost puede estar subestimado o no estar disponible.
El MWC cost es acumulativo sobre el conjunto de datos filtrado, no es un indicador por decisión. Mide el impacto total de sus errores sobre sus posibilidades de victoria.
2.17. Panel 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.
En este panel, el usuario edita la posición de las fichas en los dos cuadrantes interiores: un clic en los puntos 1 a 6 coloca fichas del jugador de abajo, un clic en los puntos 19 a 24 coloca fichas del jugador de arriba (el botón del ratón es indiferente).
Los resultados se presentan en forma de dos tablas apiladas:
arriba, una tabla de jugadores — una fila por jugador (identificada por su punto de color, con el jugador negro siempre abajo), una columna por magnitud: EPC, pip count, wastage (diferencia entre el EPC y el pip count), número medio de tiradas y desviación típica. Cuando ambos jugadores tienen fichas en su cuadrante, una línea Δ da las diferencias con signo (abajo − arriba: negativa cuando el jugador negro va en cabeza) de EPC, de pips y de wastage;
debajo, separada por un filete, una tabla carrera/cubo: dos columnas de probabilidad de victoria (una por punto de color de jugador, valores sin el signo %) y las equidades money — bajo cada decisión distinta de la mejor, la diferencia de equidad respecto a la mejor decisión se indica entre paréntesis. La decisión se muestra a la derecha de la tabla, con el distintivo exacto/estimado. El jugador al tiro y la posición del cubo se editan directamente en el tablero, como en modo edición: hacer clic en el rectángulo bearoff/marcador de un jugador le da el tiro; hacer clic en el cubo lo hace rotar centrado → poseído abajo → poseído arriba (clic derecho en sentido inverso). El valor del cubo permanece fijado — en money game las equidades se expresan en unidades del cubo actual, solo cuenta su propietario. El análisis se recalcula de inmediato. En régimen estimado, el enlace « Ver los parámetros de configuración » abre directamente la pestaña Bearoff de la configuración.
La casilla Desafío permanece fijada en la parte superior derecha del panel.
Cuando la posición es un bearoff puro (todas las fichas de ambos jugadores en su cuadrante), la tabla de carrera muestra, para el jugador al tiro:
la probabilidad de victoria,
en régimen exacto: las equidades money (cubeless, sin doblar, doblar/tomar, doblar/pasar) y el veredicto de cubo money (no doblar, doblar/tomar o doblar/pasar),
en régimen estimado: la probabilidad de victoria sola, acompañada de su margen de error — el veredicto de cubo, deliberadamente, no se muestra entonces.
Un distintivo indica el régimen: exacto (valor leído en una base de datos two-sided) o estimado ± margen. Véase Metodología e hipótesis del panel Bearoff para la definición precisa de los dos regímenes y de sus hipótesis.
Ampliar el dominio exacto. La base integrada cubre 6 fichas por jugador. Dos maneras de ir más allá, en la pestaña Bearoff de la configuración:
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) ;
indicar cualquier archivo
.bdtwo-sided de gnubg. La base con el dominio más amplio prevalece automáticamente.
Modo desafío. La casilla Desafío del panel activa un modo de entrenamiento: con cada modificación de la posición, los valores de las tres zonas — la fila del jugador de abajo, la fila del jugador de arriba y la tabla de carrera — se ocultan (sustituidos por « ··· »); un clic en una zona revela solo esa zona. La línea Δ solo aparece una vez reveladas las dos filas de jugadores. Así puede uno entrenarse a estimar el EPC de cada bando, y luego a pronunciarse sobre el cubo, antes de comprobar. El ajuste se memoriza.
Para cerrar el panel Bearoff, pulse CTRL-E o cambie a otra pestaña.
2.17.1. Metodología e hipótesis del panel Bearoff
Cada valor mostrado por el panel se basa en hipótesis precisas, enunciadas aquí exhaustivamente.
Dominio. El panel solo trata el bearoff puro: todas las fichas restantes de ambos jugadores en su cuadrante interior. La posición se evalúa antes de la tirada; los dados eventualmente colocados se ignoran. Las carreras sin contacto con fichas fuera del cuadrante no se tratan.
Bloques EPC (siempre exactos). El EPC, el número medio de tiradas y la desviación típica provienen de la distribución exacta del número de tiradas necesarias para sacar todas las fichas, leída en la base one-sided de GNUbg (6 puntos, 15 fichas, integrada). EPC = tiradas medias × 49/6 (49/6 ≈ 8,167 es la media exacta de pips por tirada, con los dobles contados cuatro veces); wastage = EPC − pip count. La única idealización es el juego one-sided óptimo: cada jugador minimiza sus propias tiradas ignorando al adversario — es la definición estándar del EPC.
Probabilidad de victoria, régimen exacto. Lectura directa en la base two-sided disponible más amplia (integrada TS-06-06, archivo externo o TS-06-11 descargada). Estas bases resultan de un análisis retrógrado completo bajo juego two-sided óptimo de ambos bandos: ninguna hipótesis adicional, error limitado a la cuantificación (< 0,002 %).
Probabilidad de victoria, régimen estimado. Fuera del dominio de la base: la probabilidad se obtiene convolucionando las dos distribuciones one-sided (el jugador al tiro gana si su número de tiradas es inferior o igual al del adversario) y aplicando luego una corrección polinómica fija, calibrada fuera de línea contra la base TS-06-11. Tres hipótesis:
independencia de los dos procesos de salida — estructural en carrera: sin contacto no hay ninguna interacción;
juego one-sided óptimo de ambos bandos — esta es la aproximación: en realidad el jugador que va detrás se desvía para jugar la varianza y el líder por seguridad. El efecto medido es un sesgo antisimétrico (la convolución exagera la ventaja del líder) que la corrección absorbe estadísticamente;
la corrección fue calibrada y validada sobre el dominio del oráculo (hasta 11 fichas por jugador). Error residual medido: desviación típica 0,05 %, percentil 99 0,17 %, máximo observado 0,9 % (en puntos de probabilidad de victoria). Más allá de 11 fichas por jugador, esta cota está extrapolada — la tendencia es monótona pero ningún oráculo la certifica.
Equidades y veredicto de cubo (solo régimen exacto). Las equidades mostradas son las del money game, sin Jacoby, en el referencial de la literatura del bearoff. En el dominio ≤ 11 fichas por jugador, los gammons son imposibles (cada bando ya ha sacado al menos 4 fichas): no es una aproximación. El veredicto (no doblar / doblar, tomar / doblar, pasar) se reconstruye exactamente a partir de las equidades almacenadas, según la regla de GNUbg, validada punto por punto contra su análisis.
Nota
Las equidades cubeful suponen un juego de cubo óptimo de ambos bandos hasta el final: los futuros redobles se valoran íntegramente (análisis retrógrado completo). En las carreras muy volátiles de final de partida, la cascada de redobles se come casi toda la ventaja del bando al tiro — las equidades « sin doblar » y « doblar/tomar » pueden entonces estar próximas a cero allí donde un motor como XG, cuyo modelo de cubo no valora esa cascada, muestra valores próximos al dead cube (por ejemplo, 2 fichas en el punto 3 contra 2 fichas en el punto 2: 62 % de victoria, D/T exacto +0,006 frente a +0,475 en XG). La decisión mostrada, en cambio, coincide con la de los motores.
¿Por qué el veredicto nunca se estima? La equidad cubeful es un problema de trayectoria (cuándo doblar) que ningún resumen estadístico de la posición captura: el mejor modelo estático medido deja un error residual (desviación típica 0,016 de equidad, máximo 0,20) que basta para invertir todas las decisiones ajustadas. Del mismo modo, la conversión del veredicto al marcador del match mediante una tabla de equidades de match se ha medido insuficiente (12 % de desacuerdos con el análisis 2-ply de GNUbg, con auténticos blunders). Como un veredicto falso mostrado con aplomo es peor que ningún veredicto, blunderDB solo muestra el veredicto cuando es exacto — y money.
Nota
Las bases de bearoff son tablas matemáticas inmutables, regenerables con la herramienta makebearoff de GNUbg.
2.18. Panel Anki
El panel Anki (CTRL-K) permite estudiar posiciones mediante repetición espaciada utilizando el algoritmo FSRS. El usuario puede crear mazos a partir de colecciones o de resultados de búsqueda.
Creación de mazos: Haga clic en New Deck para crear un mazo a partir de una colección o de los resultados de búsqueda actuales. Los mazos basados en una búsqueda se sincronizan automáticamente al activar la pestaña Anki.
Repaso: Seleccione un mazo y luego haga clic en Study (o haga doble clic en un mazo) para empezar a repasar las cartas pendientes. Cada carta muestra la posición correspondiente en el tablero. Evalúe su recuerdo con las teclas 1 (Repetir), 2 (Difícil), 3 (Bien) o 4 (Fácil). Pulse Esc para detenerse y volver a la lista de mazos.
Práctica libre (cram): El botón Cram, junto a Study, inicia una sesión de práctica libre: se le muestran posiciones aleatorias del mazo sin tener en cuenta el calendario FSRS. Este modo nunca modifica el plan de repetición espaciada — ideal para calentar antes de un torneo o repasar intensamente un mazo temático sin alterar su orden. Una etiqueta Cram reemplaza el estado de la carta y un botón Siguiente (teclas 1 a 4) recorre las posiciones. Esc vuelve a la lista sin guardar una sesión interrumpida.
Pausa/Reanudación: Puede interrumpir una sesión de repaso en cualquier momento con Esc. El botón cambia a Resume y muestra su progreso. Haga clic en él para retomar donde lo dejó.
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. Panel de Metadatos
El panel Metadatos muestra la información general de la base de datos actual: nombre, descripción, número de posiciones, número de partidas y juegos, versión del esquema. Accesible mediante el comando meta.
También muestra, cuando existe, el origen de la base de datos — véase Distribuir una base de datos: origen y contraseña. Una base de datos corriente no muestra esa sección.
2.20. Distribuir una base de datos: origen y contraseña
Un profesor que distribuye una base de posiciones dispone de dos mecanismos, independientes entre sí, ambos opcionales y elegidos en el momento de la exportación: marcar el archivo con su origen y protegerlo con una contraseña.
Nota
Ninguno de los dos hace seguimiento de lo que ocurre con el archivo. blunderDB no registra nada del lado de quien recibe la base: abrir una base marcada es exactamente igual que abrir cualquier otra, y en ningún sitio queda constancia de quién la abrió, cuándo, ni de dónde procede su contenido.
2.20.1. Marcar una base de datos con su origen
La ventana de exportación cabe en una sola pantalla: el formulario y, sobre él, una barra de progreso durante la escritura. Se cierra sola al terminar y el resultado aparece en la barra de estado.
Tres puntos merecen atención:
La exportación afecta a las posiciones mostradas actualmente, no a toda la base. Tras una búsqueda solo se exportan los resultados: la ventana lo recuerda en la parte superior.
Una colección cuyas posiciones no estén todas en la selección llega truncada. Por eso la lista muestra, para cada colección, la parte cubierta («12/40») y la señala en rojo cuando es parcial.
Los torneos solo pueden exportarse junto con los partidos: sin ellos no existe el vínculo torneo–partido y el torneo llegaría vacío. La casilla permanece desactivada mientras no se marque «incluir los partidos».
Los campos Usuario, Descripción y Fecha describen el archivo producido; se rellenan previamente a partir de la base de origen. La casilla Mis filtros guardados es distinta de las demás: no exporta contenido, sino tus propias búsquedas guardadas, que no sirven de nada en la base de otra persona.
Al marcar Marcar este archivo con su origen aparecen dos campos:
Origen — qué es este archivo y de dónde viene, con tus palabras: «Clase de Jean Dupont — 12 de marzo de 2026». Este campo es obligatorio: mientras esté vacío, el botón de exportación permanece inactivo.
Nota, opcional — condiciones de uso, dirección de contacto, una petición de no redistribuir.
La marca se firma con tu identidad de emisor. Es por tanto inalterable e infalsificable: nadie puede modificarla ni fabricar una en tu nombre. En cambio, no es imborrable: el archivo distribuido es una base SQLite corriente y blunderDB es software libre. No impide nada: dice de dónde viene el archivo.
2.20.2. Identidad del emisor
Las marcas se firman con tu identidad de emisor, creada por sí sola la primera vez que marcas un archivo; no hay nada que configurar. Pertenece a una persona y no a una base de datos: todos tus archivos llevan la misma huella pública, con la forma A3F1-9C24-7B05-E1D8.
Puedes comunicar esa huella a tus destinatarios para que comprueben que un archivo procede realmente de ti. La identidad se traslada de un equipo a otro en un único archivo (extensión .bdbid), protegido si se desea por una frase de contraseña. Ese archivo permite firmar en tu nombre: no lo compartas.
En los ajustes (icono de rueda dentada de la barra de herramientas), la pestaña Identidad del emisor muestra tu nombre y tu huella, y ofrece Guardar identidad…, Cargar identidad… y Regenerar….
Advertencia
Regenerar no revoca nada. Una marca lleva incorporada la clave pública que la firmó: se verifica por sí sola para siempre. Si tu archivo de identidad se ha filtrado, quien lo posea podrá seguir firmando con tu huella antigua, y esas marcas seguirán siendo válidas.
Lo que te protege tras una filtración no es el software: es publicar tu nueva huella y desautorizar la antigua ante tus destinatarios.
La regeneración sobrescribe la clave actual; blunderDB ofrece guardarla antes de reemplazarla.
2.20.3. Proteger una base de datos con una contraseña
La contraseña se escribe oculta, tanto aquí como al abrir un archivo protegido; el icono con forma de ojo la muestra mientras se mantiene pulsado y vuelve a ocultarla al soltarlo.
Marcar Proteger este archivo con una contraseña produce un archivo con extensión .dbx, incluso si habías elegido un nombre en .db en la ventana de guardado, ya que esta se abre antes de pedir la contraseña. Para abrirlo, usa la apertura de base habitual: la ventana de selección acepta tanto .db como .dbx. blunderDB pide entonces la contraseña e instala al lado una base corriente; después no se pide nada más.
La ventana ofrece eliminar el archivo protegido una vez abierto: de lo contrario conservas el mismo contenido con dos nombres. La casilla no está marcada por omisión —el archivo protegido sigue siendo tuyo si piensas transmitirlo— y la eliminación solo se produce tras una apertura correcta.
Advertencia
La contraseña protege el transporte del archivo, no la base. Impide que un tercero abra un archivo olvidado en una carpeta de descargas o un adjunto reenviado por error. No protege frente a aquel a quien has dado la contraseña.
La contraseña se comprueba en cada apertura, incluso si el archivo ya se había abierto antes en ese equipo.
Técnicamente, la base se cifra con AES-256 en modo GCM, con una clave derivada de la contraseña mediante Argon2id (64 MiB de memoria, 3 pasadas, 4 hilos) y una sal aleatoria propia de cada archivo. El modo GCM autentica el conjunto: una contraseña errónea se detecta como tal, y también cualquier alteración del archivo cifrado; nunca se obtiene en silencio una base corrupta.
La cabecera del archivo protegido permanece en claro: su origen sigue siendo legible sin la contraseña.
2.20.4. Leer el origen de un archivo
En la aplicación, abre el archivo y muestra el panel Metadatos (comando meta). Aparece una sección Origen en la parte superior del panel, de solo lectura, que indica lo que se inscribió, por quién, cuándo, y el estado de la firma:
«✓ firma verificada — marcada por ti»: el archivo lleva tu marca, intacta;
«✓ firma verificada»: la marca está intacta y procede de otra clave; compara su huella con la que te haya comunicado el autor;
«⚠ firma no válida»: el documento ha sido modificado o falsificado.
Esta sección no aparece en una base de datos corriente.
En línea de comandos, blunderdb info --db archivo.db muestra el origen y el estado de la firma, sin escribir nunca en el archivo. El comando funciona también con un archivo protegido, sin la contraseña. Consulta CLI_USAGE.md para las opciones --watermark y --password de export, así como para identity y open.