外部定跡（DB2016 / SBK）

DB2016 や SBK といった、他エンジン向けの定跡ファイルを 読み取り専用で 参照するためのクラスです。rsshogi 独自の定跡バイナリ（StaticBook / MemoryBook） とは別系統の API で、外部ファイルをそのまま開いて検索します。

import rsshogi as rs

yo_book = rs.book.YaneuraOuBook.open("book.db")   # DB2016
sbk_book = rs.book.SbkBook.open("book.sbk")        # SBK

DB2016

YaneuraOuBook

YaneuraOuBookEntry

len(entry) で候補手数を取得できます。

YaneuraOuBookMove

参照可否の診断

open() は先頭の一定行だけを検証して開きます。大きなファイルでも開く時間を抑えるためです。 diagnostics() は二分探索が安全に使えるかを返します。

• diagnostics().complete が False の場合、validate_full() でファイル全体の ソートを確認するまで lookup_sfen() はエラーになります。
• ファイルがソートされていない場合も、lookup_sfen() は（数 GB のファイルを暗黙に 全走査しないよう）エラーになります。全件スキャンを意図する場合のみ lookup_sfen_by_scan() を使ってください。

YaneuraOuBookDiagnostics の主なプロパティ:

DB2016 のテキストは UTF-8 として解釈されます。日本語の旧ファイルで パースに失敗する場合は、元データが CP932 / Shift_JIS でないか確認してください。

例

import rsshogi as rs

book = rs.book.YaneuraOuBook.open("book.db")

# 全体が検証済みでなければ、必要に応じて全検証
if book.diagnostics().complete is False:
    book.validate_full()

entry = book.lookup_position(rs.core.Board())
if entry is not None:
    print(entry.min_ply, entry.comment)
    for move in entry.moves:
        print(move.mv.to_usi(), move.ponder.to_usi(), move.score, move.depth, move.count, move.comment)

SBK

SbkBook

len(book) で局面数を取得できます。lookup_state_id() は SBK の id メタデータを使い、 物理インデックスと同一とは仮定しません。lookup_state_index() は物理インデックスを指します。 不明な id・範囲外インデックス・next_state_id を持たない手・範囲外の手インデックスは いずれも None を返します。

SbkEntry

len(entry) で候補手数を取得できます。

SbkMove

SbkEval

SbkEntry.evals から取得できる評価情報オブジェクトです。各フィールドはすべて None になる場合があります。

例

import rsshogi as rs

book = rs.book.SbkBook.open("book.sbk")
entry = book.lookup_position(rs.core.Board())

if entry is not None:
    print(entry.games, entry.won_black, entry.won_white)
    for move in entry.moves:
        print(move.mv.to_usi(), move.weight, move.evaluation, move.next_state_id)
    for ev in entry.evals:
        print(ev.evaluation_value, ev.depth, ev.engine_name)

進捗通知付きで開く

インデックス構築の進捗取得や協調的なキャンセルが必要な場合は open_with_control(path, callback) を使います。callback は SbkOpenProgress （indexed_states / total_states）を受け取ります。False を返すと open を キャンセルし、None または True を返すと続行します。

import rsshogi as rs

progress = []

book = rs.book.SbkBook.open_with_control(
    "book.sbk",
    lambda step: progress.append((step.indexed_states, step.total_states)),
)

ツリー探索

SBK は局面ツリーを持つため、子局面を直接たどれます。

import rsshogi as rs

book = rs.book.SbkBook.open("book.sbk")
parent = book.lookup_position(rs.core.Board())
if parent is not None:
    child = book.child_entry(parent, 0)

SbkDiagnostics は、インデックス構築後の重複 Packed SFEN 局面 （duplicate_positions）と未解決の state payload（unresolved_next_states）を報告します。

Packed SFEN

外部定跡ツールと相互運用する場合、Board.to_packed_sfen() が 32 バイトの Packed SFEN キーを返します。詳細は NumPy 連携 と Board を参照してください。

関連項目

• 定跡 (Book) - rsshogi 独自の定跡バイナリ（StaticBook / MemoryBook）
• 定跡バイナリ形式 - rsshogi 定跡バイナリのフォーマット仕様
• 外部定跡フォーマット（リファレンス） - DB2016 / SBK の詳細
• Board - 盤面管理クラス