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 EPC),
estudiar las posiciones mediante repetición espaciada (panel Anki),
mostrar los metadatos de la base de datos (panel de metadatos),
mostrar el registro de operaciones (panel de registro).
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. Configuración
El botón de configuración (icono con forma de engranaje) situado en la barra de herramientas, a la izquierda del botón de ayuda, abre la ventana de configuración de blunderDB.
Esta permite elegir el idioma de la interfaz 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 mantiene de una sesión a otra.
La ventana de configuración también permite personalizar los colores del tablero. Cada elemento dispone de su propio selector de color: el fondo, el borde, las puntas claras y oscuras, las fichas del jugador 1 y del jugador 2, los dados, los puntos de los dados y el cubo. El botón Restablecer restaura todos los colores predeterminados. Al igual que el idioma, los colores elegidos se conservan de una sesión a otra.
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.5. 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.7. 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.8. 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.9. 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.10. 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.11. 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.
Truco
Consulte la Sección 4 para ver la lista de filtros disponibles.
2.12. Panel de Colecciones
El panel Colecciones (CTRL-B) permite gestionar colecciones de posiciones. Las colecciones pueden crearse, renombrarse y eliminarse. Pueden añadirse o quitarse posiciones de ellas. Haga doble clic en una colección para recorrer sus posiciones con las teclas IZQUIERDA y DERECHA. El orden de las colecciones y de las posiciones dentro de ellas puede modificarse arrastrando y soltando. Pulse CTRL-B o ejecute el comando collection para mostrar u ocultar el panel.
2.13. 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.
Cuando hay una partida abierta, aparece una barra de información sobre el tablero: indica 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 esta información está disponible).
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.
Truco
Consulte Atajos de teclado para ver los atajos disponibles.
2.14. 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.
2.15. Panel Stats
2.15.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.15.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.15.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.15.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.15.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.15.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.15.5. Pestaña Dashboard
La pestaña Dashboard ofrece una vista sintética de los indicadores clave.
2.15.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.15.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.15.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.15.6. Pestaña Progresión
La pestaña Progresión presenta la evolución del nivel a lo largo del tiempo.
2.15.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.15.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.15.7. Pestaña Errores
La pestaña Errores desglosa las fuentes de error.
2.15.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.15.7.2. 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.15.7.3. 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.15.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.15.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.16. Panel EPC
El panel EPC (CTRL-E) calcula el EPC (Effective Pip Count) de una posición de bearoff. Se activa pulsando CTRL-E, haciendo clic en la pestaña EPC del panel inferior, o ejecutando el comando epc.
En este panel, el usuario edita la posición de las fichas en el tablero interior (los 6 últimos puntos) y se muestra en tiempo real la siguiente información para cada jugador:
el EPC (Effective Pip Count),
el número medio de tiradas necesarias (Mean Rolls),
la desviación típica (Standard Deviation),
el pip count,
el wastage (diferencia entre el EPC y el pip count).
Cuando ambos jugadores tienen fichas en su tablero interior, una sección de comparación muestra las diferencias de EPC y de pip count.
Para cerrar el panel EPC, pulse CTRL-E o cambie a otra pestaña.
Nota
El cálculo se basa en la base de datos interna de bearoff de 6 puntos de GNUbg.
2.17. 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ó.
Gestión de mazos: Utilice los botones de acción para renombrar, sincronizar, reiniciar o eliminar mazos. Los parámetros FSRS (retención objetivo, intervalo máximo, factor de aleatoriedad) pueden configurarse por mazo en los Ajustes (icono de engranaje).
2.18. 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.
2.19. Panel de Registro
El panel Registro muestra el registro de las operaciones recientes: importaciones, exportaciones y operaciones sobre la base de datos, con sus resultados y marcas de tiempo. Resulta útil para diagnosticar los errores de importación.