2. マニュアル
2.1. はじめに
blunderDB はバックギャモンのポジションのデータベースを構築するためのソフトウェアです。その主な強みは、プレイヤーが遭遇したポジション（オンラインやトーナメントで）を一か所に集約し、自由に組み合わせ可能なさまざまなフィルターで絞り込みながら再検討できる点にあります。blunderDB は参照用ポジションのカタログを作成するためにも利用できます。
ポジションは .db ファイルとして表されるデータベースに保存されます。
2.2. 主な操作
blunderDB で可能な主な操作は次のとおりです：
新しいポジションを追加する、
既存のポジションを編集する、
Ctrl+X でボードの画像をクリップボードにコピーする（PNG）、または Ctrl+X Ctrl+X で完全な分析と共にコピーする、
既存のポジションを削除する、
1 つまたは複数のポジションを検索する、
さまざまなソース（XG、GNUbg、BGBlitz、Jellyfish）からマッチをインポートする。XG ファイルからのコメントも含む、
インポートしたマッチの手を辿る、
ポジションをコレクションに整理する、
マッチをトーナメントに整理する。
ユーザーはタグを使ってポジションに自由にラベルを付け、コメントで注釈を加えることができます。
2.3. インターフェースの説明
blunderDB のインターフェースは上から下に次の要素で構成されています：
［上部］ツールバー。データベースに対して実行できる主な操作がすべてまとめられています、
［中央］メイン表示エリア。バックギャモンのポジションを表示または編集できます、
［下部］ステータスバー。データベースや現在のポジションに関するさまざまな情報を表示し、コマンドラインを内蔵しています。
次の目的でパネルを表示できます：
eXtreme Gammon（XG）、GNUbg、または BGBlitz から取得した、現在のポジションに関連する分析データを表示する、
コメントを表示、追加、または編集する、
組み合わせ可能な条件に従ってポジションを検索・フィルターする、
ポジションのコレクションを表示・管理する（コレクションパネル）、
インポートしたマッチの一覧を表示し、マッチの手を辿る（マッチパネル）、
トーナメントを表示・管理する（トーナメントパネル）、
パフォーマンス統計を表示する（Stats パネル）、
ベアオフポジションの EPC（Effective Pip Count）を計算する（EPC パネル）、
間隔反復によってポジションを学習する（Anki パネル）、
データベースのメタデータを表示する（メタデータパネル）、
操作のログを表示する（ログパネル）。
次の目的でモーダルウィンドウを表示できます：
blunderDB のヘルプを表示する、
ガイドツアーのカタログを表示します（ ガイドツアーとサンプルデータベース を参照）、
データベースのエクスポートを設定する、
blunderDB を設定する。特にインターフェースの言語を設定する（設定 を参照）。
メイン表示エリアはユーザーに次のものを提供します：
バックギャモンのポジションを表示または編集するためのボード、
キューブのレベルと所有者、
各プレイヤーのピップカウント、
各プレイヤーのスコア、
出目です。ダイスに値が表示されていない場合、ダイスの位置はどちらのプレイヤーに手番があるかを示し、そのポジションがキューブの判断であることを表します。キューブの判断がダブルへの応答（テイク／パス）である場合、提示されたキューブが盤面の中央に、提示された値で表示されます。
ステータスバーは左から右に次の情報で構成されています：
コマンドライン。スペース キーを押すとアクセスできます、
ユーザーが実行した操作に関連する情報メッセージ、
現在のポジションのインデックス。続いて現在のライブラリ内のポジション数（またはマッチを辿っているときは手／ゲームの情報）が表示されます。
注釈
ユーザーによる検索から得られたポジションの場合、ステータスバーに表示されるポジション数はフィルターされたポジションの数に対応します。
2.4. 設定
ツールバーのヘルプボタンの左にある設定ボタン（歯車の形のアイコン）を押すと、blunderDB の設定ウィンドウが開きます。
このウィンドウでは、英語、フランス語、ドイツ語、イタリア語、スペイン語、フィンランド語、日本語、ギリシャ語、ロシア語の中からインターフェースの言語を選択できます。インターフェース全体（ツールバー、パネル、メッセージ、ヘルプ）が選択した言語に翻訳されます。言語の選択は保存され、セッションをまたいで保持されます。
設定ウィンドウでは、盤面の色をカスタマイズすることもできます。各要素にはそれぞれ独自のカラーピッカーがあります。背景、枠線、明るいポイントと暗いポイント、プレイヤー1とプレイヤー2のチェッカー、ダイス、ダイスの目、そしてダブリングキューブです。 デフォルトに戻す ボタンを押すと、すべての色がデフォルトに戻ります。言語と同様に、選択した色はセッションをまたいで保持されます。
設定ウィンドウには、インターフェースの表示設定もまとめられています。インターフェースの拡大率 のスライダーを使うと、すべての要素を拡大または縮小でき、高密度ディスプレイや読みやすさの向上に役立ちます。パネルの位置 メニューでは、パネル（検索、マッチ、分析）をボードに対してどこに配置するかを決定します： 下、横 または *自動*（自動の場合、横長の画面では利用可能なスペースをより有効に活用するため横が選択されます）。他の設定と同様に、これらの選択はセッションをまたいで保持されます。
2.5. ガイドツアーとサンプルデータベース
操作に慣れやすくするため、blunderDB はインターフェースの ガイドツアー を用意しています。ツアーのカタログは、ツールバーから、またはコマンド tour （別名 tutorial ）で開けます。4つのツアーが利用できます。インターフェースの全体ツアー、そしてポジションの検索、マッチのレビュー、トーナメントのレビューに特化したツアーです。各ツアーは、関連するインターフェースの要素を一手順ずつ強調表示し、いつでも再生できます。初回起動時には、全体ツアーが自動的に案内されます。
コマンド demo は、自分の対局をインポートしなくてもツールの機能を試せる サンプルデータベース （マッチ、トーナメント、解析）を読み込みます。データベースが開かれていない場合、ガイドツアーはこのデータベースを利用します。
2.7. ポジションの編集
TAB キーを押すと検索パネルが開き、ボード上のポジションを編集して、データベースに追加したり、検索するポジションの構造を定義したりできます。チェッカーの配置、キューブ、スコア、手番はマウスで変更できます（ポジションを編集する を参照）。
Tip
利用可能なショートカットについては キーボードショートカット を参照してください。
2.8. コマンドライン
ステータスバーに内蔵されたコマンドラインでは、グラフィカルインターフェースで利用できる blunderDB のすべての機能を実行できます。データベースに対する一般的な操作、ポジションのナビゲーション、分析やコメントの表示、フィルターに基づくポジションの検索などです。インターフェースにある程度慣れたら、特にポジション検索機能において blunderDB を強力かつ快適に使用できるコマンドラインを徐々に使うことをお勧めします。
コマンドラインを開くには、スペース キーを押します。リクエストを送信してコマンドラインを閉じるには、Enter キーを押します。
blunderDB は、ユーザーが送信したリクエストが有効である限りそれを実行し、必要に応じてデータベースの状態を即座に変更します。ユーザーによる明示的な保存操作はありません。
Tip
コマンドラインで利用可能なコマンドの一覧については 4 章 を参照してください。
2.9. 分析パネル
分析 パネル（CTRL-L）は、eXtreme Gammon（XG）、GNUbg、または BGBlitz からインポートした現在のポジションの分析データを表示します。最良の選択肢（チェッカーの手またはキューブの判断）を、そのエクイティ値と対応するエラーと共に提示します。d キーでチェッカーの手の分析とキューブの分析を切り替えられます。マッチを辿っているときは、実際にプレイされた手が選択肢のリストで強調表示されます。パネルを表示または非表示にするには、CTRL-L を押すか list コマンドを実行します。
2.10. コメントパネル
コメント パネル（CTRL-P）は、現在のポジションに関連付けられたコメントを表示、追加、編集します。XG ファイルからインポートされたコメントは、対応するポジションに自動的に関連付けられます。パネルを表示または非表示にするには、CTRL-P を押すか comment コマンドを実行します。
2.11. 検索パネル
検索 パネル（CTRL-F または TAB）では、自由に組み合わせ可能な条件に従ってポジションをフィルターできます。チェッカーの構造、キューブの判断の種類、エラーの大きさ、日付、タグなどです。TAB キーは検索パネルとポジションエディターを同時に開き、ボード上で検索するチェッカーの構造を定義できます。
現在フィルターされているポジションの中で検索を絞り込むには、フィルターを続けた ss コマンドを使用します（例：ss nc、ss E>40）。検索パネルには同じ機能のための Search in current results チェックボックスも用意されています。
このパネルでは、検索する 判断タイプ を明示的に制御できます。 指定なし （フィルタなし）、 チェッカー （チェッカーの判断）、または キューブ （キューブの判断）です。 キューブ を選択すると、2つ目のリストでサブタイプを指定できます。 すべて 、 ダブル / ノーダブル （手番のプレイヤーがダブルするかを判断する）、または テイク / パス （相手のダブルへの応答）です。この制御は盤面と同期しています。盤面上でダイスやキューブを変更すると判断タイプが更新され、その逆も同様です。 テイク / パス モードでは、キューブが提示された値で盤面の中央に表示されます。この値は引き続き編集できます。
Tip
利用可能なフィルターの一覧については 4 章 を参照してください。
2.12. コレクションパネル
コレクション パネル（CTRL-B）では、ポジションのコレクションを管理できます。コレクションは作成、名前変更、削除ができます。ポジションを追加したり取り除いたりできます。コレクションをダブルクリックすると、左 キーと 右 キーでそのポジションを閲覧できます。コレクションの順序やコレクション内のポジションの順序は、ドラッグ＆ドロップで変更できます。パネルを表示または非表示にするには、CTRL-B を押すか collection コマンドを実行します。
2.13. マッチパネル
マッチ パネル（CTRL-Tab）はインポートしたマッチを一覧表示します。マッチをダブルクリックする（または Enter を押す）と、その手を辿ることができます。m コマンドは最後に閲覧したマッチのナビゲーションを再開します。
ユーザーは次のことができます：
左 キーと 右 キーを使ってマッチの手を辿る、
PageUp キーと PageDown キーを使ってゲーム間を移動する、
CTRL-L を押して手の分析（チェッカーとキューブ）を表示する、
d キーでチェッカーの手の分析とキューブの分析を切り替える、
分析の中で実際にプレイされた手が強調表示されているのを確認する。
各マッチで最後に閲覧したポジションは記憶され、自動的に復元されます。パネルを表示または非表示にするには、CTRL-Tab を押すか match コマンドを実行します。
マッチを開くと、ボードの上に 情報バー が表示されます： 対戦している両プレイヤー（プレイヤー 1 対 プレイヤー 2）と、マッチの背景情報（イベント、開催地、ラウンド、日付、マッチの長さ。これらの情報が利用可能な場合）が示されます。
マッチを含むデータベースを開くと、マッチ パネルがすぐに表示され、レビューは直接最初のポジションから始まるため、すぐにナビゲーションを開始できます。
Tip
利用可能なショートカットについては キーボードショートカット を参照してください。
2.14. トーナメントパネル
トーナメント パネル（CTRL-Y）では、整理された記録管理とイベントごとの統計分析のために、マッチをトーナメントにまとめることができます。トーナメントは作成、名前変更、削除ができ、マッチを割り当てられます。Stats パネルの統計はトーナメントごとにフィルターできます。パネルを表示または非表示にするには、CTRL-Y を押します。
2.15. Stats パネル
2.15.1. はじめに
Stats パネルでは、データベースにインポートされたポジションをもとに、自分のプレイレベルを分析し、時間の経過に伴う上達を追跡できます。すべてのポジションまたはフィルターされた部分集合について、**PR**（Performance Rate）と **MWC cost**（Match Winning Chance cost）の指標を計算して表示します。
Stats パネルは特に次の用途に役立ちます：
全体の PR を使って、参照しきい値（ワールドクラス、エキスパート、上級者など）に対して 自分のレベルを把握する ；
Progression タブのグラフを使って、トーナメントごと、またはマッチごとに 自分の上達を追跡する ；
自分の弱点を特定する ：Erreurs タブで、プレイした手とキューブの判断の内訳、およびエラーの大きさの分布を確認できます ；
任意の指標をクリックすることで、**該当するポジションに直接アクセスする**（ドリルダウン）。
2.15.2. パネルを開く
Stats パネルを開くには：
CTRL-D を押します。
コマンドラインで
:statsまたは:stコマンドを入力します。
注釈
パネルはフィルターを変更するたびに自動的に更新されます。単に PR ↔ MWC を切り替えるだけでは統計を再計算しません。両方の指標はバックエンドによって同時に計算されます。
2.15.3. フィルターバー
パネル上部のフィルターバーでは、計算をポジションの部分集合に限定できます。
2.15.3.1. プレイヤーの視点
プレイヤー ドロップダウンリストでは、分析対象のプレイヤーに従って統計をフィルターできます。blunderDB はデータベースで最も頻繁に名前が出てくるプレイヤーを自動的に選択します。これはいつでも変更できます。
Tip
プレイヤーを変更してもデータが失われることはありません。リストで前のプレイヤーを再選択するだけで済みます。
2.15.3.2. 利用可能なフィルター
トーナメント — 1 つまたは複数のトーナメントへの限定。複数のトーナメントを同時に選択できます。
日付 — 期間の範囲（開始 … 終了）。開始日のみが指定された場合、それ以降のポジションが含まれます。
判断タイプ — すべて／プレイした手／キューブの判断。
マッチ長 — 特定のマッチ長への限定（1、3、5、7、9、11、13、15、21 ポイント）。複数の長さを組み合わせられます。
Reset ボタンはすべてのフィルターをリセットします（自動検出されたプレイヤーを除く）。
注釈
フィルターは blunderDB の設定（config.yaml）に保存され、次回起動時に復元されます。
2.15.4. PR / MWC の切り替え
パネル上部の PR / MWC ボタンは、すべてのタブで表示される指標を切り替えます。
PR（Performance Rate）
money-game のプレイ品質を測定します。バックギャモンのポイントの千分の一単位でのエラーの合計を、判断の数で割ったものです。マッチのスコアとは独立しています。
おおよその参照しきい値：
レベル
PR
ワールドクラス
< 3
エキスパート
3 – 5
上級者
5 – 8
中級者
8 – 12
初級者
> 12
MWC cost（Match Winning Chance cost）
フィルターされたデータセット全体について、エラーによって失われたマッチ勝利確率の累積です。blunderDB に組み込まれた MET Kazaross-XG2 から計算されます。
注意
MWC cost は money-game のポジション（マッチの懸かりがない）には 適用されません。これらのポジションは MWC の計算から除外されます。MWC の値は使用される MET に依存します。異なる MET を使用するソフトウェア間では直接比較できません。
PR ↔ MWC の切り替えは瞬時に行われます。バックエンドでの再計算は実行されません。
2.15.5. Dashboard タブ
Dashboard タブは主要な指標の概要を示します。
2.15.5.1. レベルカード
3 つのカードが次の項目について PR（または MWC）を表示します：
All — すべての判断（手＋キューブ）；
Checker — プレイした手のみ；
Cube — キューブの判断のみ。
カードをクリックすると、対応する部分集合のポジションが分析パネルに読み込まれます（ドリルダウン）。
注釈
判断の総数は、各カードの下部にマウスオーバー時に表示されます。
2.15.5.2. 直近 N 回の判断にわたる移動 PR
直近 N 回の判断（N = 5、10、50、100、250、500、1000）について計算された PR（または MWC）値の列により、最近の傾向を把握できます。グレー表示の値は、利用可能な判断数を超える N に対応します。
値をクリックすると、対応する直近 N 件のポジションが読み込まれます。
2.15.5.3. Top blunders
最悪のエラー（または MWC cost）上位 10 件のリストで、大きさの降順に並べられています。行をクリックすると、該当するポジションが分析パネルに読み込まれます。
2.15.6. Progression タブ
Progression タブは、時間の経過に伴うレベルの推移を示します。
2.15.6.1. トーナメントごとの曲線
折れ線グラフが各トーナメントの PR（または MWC）を表示します（X 軸：トーナメントの順序、Y 軸：指標の値）。色付きの帯がレベルのしきい値を表します。
グラフ上の点をクリックすると、2 つのオプションを持つコンテキストメニューが開きます：
Open tournament — トーナメントパネルでトーナメントを開きます。
Open positions — トーナメントのすべてのポジションを分析パネルに読み込みます。
2.15.6.2. マッチごとの散布図
散布図が各マッチを表します（X 軸：日付、Y 軸：PR または MWC）。点の大きさはマッチ内の判断数に比例します。
点をクリックするとコンテキストメニューが開きます：
Open match — マッチパネルでマッチを開きます。
Open positions — マッチのすべてのポジションを分析パネルに読み込みます。
2.15.7. Erreurs タブ
Erreurs タブはエラーの原因を分解して示します。
2.15.7.1. キューブのアクションごとの内訳
棒グラフが各種のキューブの判断について PR（または MWC）を表示します：NoDouble、DoubleTake、DoublePass、TooGood。各バーはツールチップで判断数とブランダー率も示します。
バーをクリックすると、そのキューブのアクションに対応するポジションのうち エラーがあるものだけ が読み込まれます（ドリルダウン）。
2.15.7.2. Checker / Cube の内訳
比較図が、プレイした手の PR とキューブの判断の PR を並べて表示します。バーをクリックすると、エラーがある部分集合のポジションが読み込まれます。
2.15.7.3. エラーの大きさのヒストグラム
ヒストグラムが、ポイントの千分の一単位での大きさに従ってエラーを分布させます（区分：0–5、5–10、10–25、25–50、50–100、≥ 100）。バーをクリックすると、その区分のポジションが読み込まれます。
2.15.8. 集計ルール
重要
トーナメント（または任意の部分集合）の PR は 合計／合計 ルールで計算されます。各マッチの個別 PR の平均としては決して計算されません。
計算式：
例： あるプレイヤーがトーナメントで 2 つのマッチを戦う —
マッチ A：10 回の判断、合計エラー 50 mp → PR = 5,0
マッチ B：90 回の判断、合計エラー 270 mp → PR = 3,0
PR の単純平均：(5,0 + 3,0) / 2 = 4,0 (誤り)
合計／合計ルール：(50 + 270) / (10 + 90) = 320 / 100 = 3,2 (正しい)
合計／合計ルールは、マッチ長のばらつきに耐えられる唯一のルールです（21 ポイントのマッチは 1 ポイントのマッチより重みがあります）。
2.15.9. MWC：制限事項
MWC cost は、競技バックギャモンにおける事実上の参照テーブルである MET Kazaross-XG2 から計算されます。結果は、他の MET を使用するソフトウェアと直接比較することはできません。
money-game のポジション（マッチスコアなし）は MWC の計算から 除外 されます。データベースに money-game のポジションが多く含まれている場合、MWC cost は過小評価されるか、利用できないことがあります。
MWC cost はフィルターされたデータセット全体にわたる累積であり、判断ごとの指標ではありません。あなたのエラーが勝利の可能性に与えた総合的な影響を測定します。
2.16. EPC パネル
EPC パネル（CTRL-E）は、ベアオフポジションの EPC（Effective Pip Count）を計算します。CTRL-E を押すか、下部パネルの EPC タブをクリックするか、epc コマンドを実行することで有効になります。
このパネルでは、ユーザーがインナーボード（最後の 6 ポイント）内のチェッカーの配置を編集すると、各プレイヤーについて次の情報がリアルタイムで表示されます：
EPC（Effective Pip Count）、
必要な平均ロール数（Mean Rolls）、
標準偏差（Standard Deviation）、
ピップカウント、
ウェステージ（EPC とピップカウントの差）。
両プレイヤーがインナーボードにチェッカーを持っている場合、比較セクションに EPC とピップカウントの差が表示されます。
EPC パネルを閉じるには、CTRL-E を押すか、別のタブに切り替えます。
注釈
計算は GNUbg の 6 ポイントベアオフ内部データベースに基づいています。
2.17. Anki パネル
Anki パネル（CTRL-K）では、FSRS アルゴリズムを使った間隔反復によってポジションを学習できます。ユーザーはコレクションや検索結果からデッキを作成できます。
デッキの作成： New Deck をクリックすると、コレクションまたは現在の検索結果からデッキを作成できます。検索に基づくデッキは、Anki タブをアクティブにすると自動的に同期されます。
復習： デッキを選択してから Study をクリックする（またはデッキをダブルクリックする）と、期限の来たカードの復習を開始できます。各カードは対応するポジションをボード上に表示します。あなたの想起度を 1*（もう一度）、*2*（難しい）、*3*（普通）、または *4*（簡単）のキーで評価してください。*Esc を押すと停止してデッキのリストに戻ります。
フリー練習（cram）： Study の隣にある Cram ボタンは、フリー練習セッションを開始します。FSRS のスケジュールに関係なく、デッキからランダムな局面が表示されます。このモードは**間隔反復の計画を一切変更しません**。トーナメント前のウォームアップや、順序を乱さずにテーマ別デッキを集中的に復習するのに最適です。カードの状態の代わりに Cram バッジが表示され、次へ ボタン（キー 1〜4）で局面を切り替えます。Esc を押すと、中断したセッションを保存せずに一覧に戻ります。
停止／再開： 復習セッションは Esc でいつでも中断できます。ボタンが Resume に変わり、進捗状況が表示されます。それをクリックすると、中断した場所から再開できます。
デッキの管理： アクションボタンを使って、デッキの名前変更、同期、リセット、削除ができます。FSRS のパラメータ（目標保持率、最大間隔、ランダム性）は、設定（歯車アイコン）でデッキごとに構成できます。
2.18. メタデータパネル
メタデータ パネルは、現在のデータベースの一般情報を表示します：名前、説明、ポジション数、マッチ数とゲーム数、スキーマのバージョン。meta コマンドでアクセスできます。
2.19. ログパネル
ログ パネルは、最近の操作のログを表示します：インポート、エクスポート、およびデータベースに対する操作と、その結果やタイムスタンプです。インポートエラーの診断に役立ちます。