Policy ラベル（rsshogi.policy）

rsshogi.policy モジュールは、方策ネットワーク（Policy Network）の分類出力層で用いる指し手ラベル変換を提供する。 移動先 81 マス × 移動方向、成り、駒打ち 27 通りの 2187 クラス表現と、将棋盤の構造上出現しえない手を除いた 1496 クラスの圧縮表現を相互に変換できる。

from rsshogi.policy import (
    COMPACT_MOVE_LABEL_COUNT,
    COMPACT_TO_MOVE_LABEL,
    MOVE_LABEL_COUNT,
    MOVE_LABEL_TO_COMPACT,
    compact_move_label,
    compact_move_label_to_move_label,
    is_structurally_valid_move_label,
    move_label,
    move_label_to_compact,
)

定数一覧

関数一覧

引数と例外条件

• move 引数：Move、Move32、0..=65535 の int（16 ビット Move の内部値）、または USI 文字列（"7g7f"、"P*5e" など）を直接渡せる。
  • 上記以外の型を渡した場合は TypeError を送出する。
  • int が 0..=65535 の範囲外である場合、または USI 文字列がパースできない場合は ValueError を送出する。
  • Move.MOVE_NONE などの特殊手や、8 方向および桂馬跳び以外の不正な移動ベクトルを持ち policy ラベルへエンコードできない指し手を渡した場合は ValueError を送出する。
• turn 引数：Color インスタンス（Color.BLACK または Color.WHITE）を渡す。後手番（Color.WHITE）を指定すると、移動元と移動先のマスを盤面 180 度回転して先手視点に正規化してからラベルを計算する。
• label 引数：
  • move_label_to_compact(label) と is_structurally_valid_move_label(label) に 0..2187 の範囲外の整数を渡すと ValueError（負数や u16 範囲外は OverflowError）を送出する。
  • compact_move_label_to_move_label(label) に 0..1496 の範囲外の整数を渡すと ValueError を送出する。

使用例

基本的なラベル変換と後手番の視点正規化

from rsshogi.core import Move
from rsshogi.policy import compact_move_label, move_label
from rsshogi.types import Color

mv = Move.from_usi("7g7f")
raw = move_label(mv, Color.BLACK)
compact = compact_move_label(mv, Color.BLACK)
assert compact is not None

# USI 文字列を直接渡すこともでき、先手の 7g7f と後手の 3c3d は同じラベルになる
assert move_label("7g7f", Color.BLACK) == raw
assert move_label("3c3d", Color.WHITE) == raw
assert compact_move_label("3c3d", Color.WHITE) == compact

構造的に無効なラベルの判定

一段目への歩や香や桂の駒打ち、盤端から外れる移動方向、桂馬の 1 段目および 2 段目への不成などは、いかなる合法局面でも出現しない。 これらの手は 2187 クラスの move_label() では数値に変換されるが、is_structurally_valid_move_label() は False、compact_move_label() と move_label_to_compact() は None を返す。

from rsshogi.policy import (
    COMPACT_TO_MOVE_LABEL,
    MOVE_LABEL_TO_COMPACT,
    compact_move_label,
    compact_move_label_to_move_label,
    is_structurally_valid_move_label,
    move_label,
    move_label_to_compact,
)
from rsshogi.types import Color

# 一段目への歩打ち（P*5a）は構造的に出現しない
invalid_raw = move_label("P*5a", Color.BLACK)
assert not is_structurally_valid_move_label(invalid_raw)
assert compact_move_label("P*5a", Color.BLACK) is None
assert move_label_to_compact(invalid_raw) is None
assert MOVE_LABEL_TO_COMPACT[invalid_raw] is None

# 有効な手の往復変換
valid_raw = move_label("7g7f", Color.BLACK)
valid_compact = move_label_to_compact(valid_raw)
assert valid_compact is not None
assert compact_move_label_to_move_label(valid_compact) == valid_raw
assert COMPACT_TO_MOVE_LABEL[valid_compact] == valid_raw

関連項目

• 指し手クラス（Move / Move32）
• 基本型（Color）
• SAZ2 自己対局教師データ