3. Guide utilisateur

Ce guide est une introduction pratique à blunderDB pour une prise en main rapide.

3.1. Créer une nouvelle base de données

Pour créer une nouvelle base de données, cliquer dans la barre d’outils sur le bouton « New Database ». Choisir un chemin où enregistrer la base de données, ainsi qu’un nom et cliquer sur « Save ».

Note

L’extension des bases de données blunderDB est .db.

Astuce

Raccourcis clavier: CTRL-N. Commande: n

3.2. Ouvrir une base de donnée existante

Pour charger une base de données existante, cliquer dans la barre d’outils sur le bouton « Open Database ». Choisir le chemin où se trouve la base de données, choisir le fichier .db et cliquer sur « Open ».

Astuce

Raccourcis clavier: CTRL-O. Commande: o

3.3. Importer et fusionner une base de données

Pour importer et fusionner une autre base de données blunderDB dans la base de données actuellement ouverte, cliquer dans la barre d’outils sur le bouton « Import Database ». Choisir le fichier .db à importer et cliquer sur « Open ».

blunderDB va fusionner intelligemment les deux bases de données:

  • Les positions qui n’existent pas dans la base de données actuelle seront ajoutées avec leurs analyses et commentaires.

  • Les positions qui existent déjà seront mises à jour: les analyses seront complétées si manquantes, et les commentaires seront fusionnés (ajout des nouveaux commentaires sans dupliquer les existants).

  • Un message résumera le nombre de positions ajoutées, fusionnées et ignorées.

Note

L’import nécessite que les deux bases de données aient des versions de schéma compatibles. Il est possible d’importer une base de données d’une version inférieure ou égale dans une base de données de version supérieure.

Prudence

L’opération d’import modifie immédiatement la base de données actuellement ouverte. Il est recommandé de faire une copie de sauvegarde avant d’importer une autre base de données.

3.4. Editer une position

Pour éditer une position, basculer en mode EDIT à l’aide de la touche TAB. Editer la position à la souris:

  • cliquer sur les points pour ajouter des pions. Le clic gauche attribue les pions au joueur 1. Le clic droit attribue les pions au joueur 2. Pour insérer une prime, cliquer sur le point de départ, maintenir le bouton appuyé, relacher sur le point d’arrivée. Cliquer sur la barre pour mettre des pions à la barre.

  • pour effacer la position, double-clic sur une zone vide en dehors du board ou appuyer sur la touche RETOUR ARRIERE.

  • pour envoyer le cube vers le joueur 1, clic gauche sur le cube. Pour envoyer le cube vers le joueur 2, click droit sur le cube.

  • pour indiquer le joueur qui a le trait, cliquer à l’emplacement prévu des dés.

  • pour éditer les dés, clic gauche pour augmenter la valeur d’un dé, clic droit pour augmenter la valeur d’un dé. Si la face des dés est vide, cela signifie que la position est une décision de cube.

  • pour éditer le score des joueurs, clic gauche pour augmenter le score, clic droit pour réduire le score.

Astuce

La saisie de la position avec la souris pour les pions se fait de la même manière que dans XG.

3.5. Ajouter une position à la base de données

Après l’édition de la position précédente, blunderDB est dans le mode EDIT.

Pour enregistrer la position obtenue précédemment, faire CTRL-S ou appuiyer dans la barre d’outils sur le bouton « Save Position ».

Astuce

Depuis le mode EDIT, basculer en mode COMMAND et exécuter: w

3.6. Etiqueter une position

Pour ajouter un tag toto à la position courante, basculer en mode COMMAND en appuyant sur ESPACE, taper #toto et valider la commande en appuyant sur ENTREE.

3.7. Supprimer une position

Pour supprimer la position courante de la base de données, faire Del ou clicker dans la barre d’outils sur le bouton « Delete Position »

Astuce

En mode COMMAND, exécuter d.

Prudence

La suppression de la position est définitive et ne nécessite aucune confirmation de la part de l’utilisateur.

3.8. Import une position depuis XG

Pour importer une position directement depuis XG,

  1. afficher dans XG la position à importer et appuyer CTRL-C,

  2. afficher blunderDB et appuyer CTRL-V.

Note

Le collage automatique détecte le format de la source (XG, GNUbg, BGBlitz).

3.9. Importer un match

blunderDB peut importer des matchs depuis différentes sources.

Formats supportés:

  • eXtreme Gammon (XG): fichiers .xg et .xgp (positions)

  • GNUbg: fichiers .sgf

  • Jellyfish: fichiers .mat et .txt

  • BGBlitz: fichiers .bgf et .txt

Pour importer un ou plusieurs fichiers de match:

  1. Appuyer sur CTRL-I ou cliquer sur le bouton « Import » dans la barre d’outils.

  2. Sélectionner un ou plusieurs fichiers à importer.

  3. blunderDB détecte automatiquement le format et importe le match.

  4. Une fenêtre de progression affiche le nombre de fichiers importés, échoués et ignorés (doublons).

Astuce

Commande: i

Note

blunderDB détecte automatiquement les doublons et empêche l’import d’un match déjà présent dans la base de données.

3.10. Importer un dossier de matchs

Pour importer récursivement tous les fichiers de matchs contenus dans un dossier et ses sous-dossiers:

  1. Appuyer sur CTRL-SHIFT-F ou cliquer sur le bouton correspondant dans la barre d’outils.

  2. Sélectionner le dossier contenant les fichiers de matchs.

  3. blunderDB collecte et importe automatiquement tous les fichiers reconnus (.xg, .xgp, .sgf, .mat, .txt, .bgf).

3.11. Glisser-déposer

blunderDB supporte le glisser-déposer. Il est possible de glisser-déposer sur la fenêtre de blunderDB:

  • des fichiers de match ou de position (.xg, .xgp, .sgf, .mat, .txt, .bgf) pour les importer,

  • des fichiers de base de données (.db) pour les ouvrir ou les fusionner avec la base de données courante,

  • des dossiers pour importer récursivement tous les fichiers qu’ils contiennent.

3.13. Gérer le panneau des matchs

Le panneau des matchs (CTRL-T) permet de:

  • lister l’ensemble des matchs importés (triés du plus récent au plus ancien),

  • trier les matchs par colonnes (joueur 1, joueur 2, date, longueur du match, tournoi),

  • modifier les noms des joueurs ou la date en double-cliquant sur les champs,

  • permuter les joueurs 1 et 2 à l’aide du bouton de permutation,

  • assigner un match à un tournoi,

  • supprimer un match à l’aide de la touche Del.

3.14. Gérer les collections

Les collections permettent d’organiser des positions en groupes personnalisés. Pour accéder au panneau des collections, appuyer sur CTRL-K.

Créer une collection:

  1. Ouvrir le panneau des collections (CTRL-K).

  2. Saisir le nom de la nouvelle collection et cliquer sur « Add ».

Ajouter des positions à une collection:

  1. Sélectionner les positions souhaitées.

  2. Les ajouter à la collection depuis le panneau des collections.

Parcourir une collection:

  • Double-cliquer sur une collection pour entrer en mode COLLECTION et parcourir ses positions.

Astuce

Commande: coll

3.15. Gérer les tournois

Les tournois permettent d’organiser les matchs importés par événement. Pour accéder au panneau des tournois, appuyer sur CTRL-Y.

Créer un tournoi:

  1. Ouvrir le panneau des tournois (CTRL-Y).

  2. Cliquer sur « Add » et saisir le nom du tournoi.

Assigner un match à un tournoi:

  • Depuis le panneau des matchs (CTRL-T), utiliser le menu déroulant de la colonne tournoi pour assigner un match.

3.16. Calculer l’EPC

Le calculateur EPC (Effective Pip Count) permet de calculer les statistiques de bearoff d’une position.

  1. Exécuter la commande epc ou cliquer sur le bouton correspondant dans la barre d’outils.

  2. Éditer la position des pions dans le jan (6 derniers points).

  3. Les résultats sont affichés en temps réel: EPC, nombre moyen de lancers, écart type, pip count et wastage.

Note

Le calculateur fonctionne pour les deux joueurs simultanément.

3.17. Afficher l’analyse d’une position importée depuis XG

Si une position analysée par XG, GNUbg ou BGBlitz a été importée dans blunderDB, l’analyse peut être affichée en appuyant CTRL-L.

Si la position correspond à une décision de pions, les cinq meilleurs coups sont affichés sur des lignes distinctes. Pour chaque ligne, les informations fournies sont dans cet ordre, le coup de pion associé, l’équité normalisée, l’erreur en équité du coup, les chances de gain, gammon et backgammon du joueur, les chances de gain, gammon et backgammon de l’adversaire, le niveau d’analyse.

Si la position correspond à une décision de cube, le coût de chaque décision est affiché ainsi que les chances de gain de la position.

Lorsque plusieurs moteurs d’analyse sont présents pour la même position (par exemple XG et GNUbg), une colonne supplémentaire indique le moteur d’origine de chaque analyse.

En mode MATCH, le coup effectivement joué est mis en évidence dans la liste des coups. En mode NORMAL, si la position a été rencontrée dans plusieurs matchs, tous les coups joués sont indiqués.

Astuce

En cliquant sur un coup dans le panneau d’analyse, les flèches correspondantes sont affichées sur le board.

3.18. Exporter une position vers XG

Pour exporter une position de blunderDB vers XG,

  1. afficher dans blunderDB la position à exporter et appuyter CTRL-C,

  2. afficher XG et appuyer CTRL-V.

3.19. Visualiser les différentes positions

Pour visualiser les différentes positions de la bibliothèque courante, utiliser les touches GAUCHE et DROITE. La touche HOME permet d’aller à la première position. La touche FIN permet d’aller à la dernière position.

Pour afficher le bearoff à gauche, appuyer CTRL-GAUCHE. Pour afficher le bearoff à droite, appuyer CTRL-DROITE.

3.20. Rechercher des positions selon des critères

Pour rechercher des types de positions,

  • basculer en mode EDIT en appuyant sur TAB,

  • éditer la structure de position à rechercher. blunderDB va filtrer les positions ayant a minima la structure de pions saisie. Dans le doute, afin d’obtenir le maximum de résultats, effacer la position en appuyant sur la touche RETOUR ARRIERE. Editer si besoin la position du cube et le score.

Méthode 1 (simple):

  • Ouvrir la fenêtre de recherche (CTRL-F)

  • Ajouter et paramétrer les filtres de recherche

  • Valider en cliquant sur « Search ».

Méthode 2 (avancée):

  • basculer en mode COMMAND en appuyant sur ESPACE,

  • écrire s, ajouter d’éventuels filtres supplémentaires (par exemple cube ou score pour prendre respectivement en compte le cube et le score. Voir Section 4.4 pour une liste exhaustive des filtres disponibles).

  • valider la requête en appuyant sur ENTREE.

Les positions affichées sont celles de la base de données ayant vérifié les critères de recherche entrés par l’utilisateur.