shantenx 0.1.12

No project description provided

shantenx

麻雀におけるシャンテン数の計算を提供します.

features

max_fans

limit 枚以下の牌の入れ替えにより, 最大何翻の聴牌が作れるかを返します.

引数名	概要	e.g.	default
pure	純手牌	['1m','1m','1m','2m','3m','4m','5m']
furo	副露	['123m','666s','1111m','3__3z']
limit		0, 1, 2, ...
dora	ドラ	['1m', '1m', '6z']
bakaze	場風	'1z', '2z', '3z', '4z'
jikaze	自風	'1z', '2z', '3z', '4z'
red_manzu	赤5萬の有無	True, False	False
red_pinzu	赤5筒の有無	True, False	False
red_souzu	赤5索の有無	True, False	False

以下の役満を考慮します.

• ダブル役満 (26翻)
  • 大四喜
  • 純正九蓮宝燈
• 役満 (13翻)
  • 国士無双
  • 四槓子
  • 四暗刻
  • 大三元
  • 小四喜
  • 字一色
  • 清老頭
  • 緑一色
  • 九蓮宝燈

これらを含まない場合, 以下の通常役を考慮します. ただし13翻以上の場合は 13翻を返します.

• ドラ
• 赤ドラ
• 断么
• 混老頭
• 清一色
• 混一色
• 自摸
• 立直 (TODO)
• 三槓子
• 小三元
• 七対子
• 対々和
• 三暗刻
• 平和
• 役牌
• 一盃口
• 二盃口
• 純チャン
• チャンタ
• 一気通貫
• 三色同順
• 三色同刻

Examples

import shantenx
assert(shantenx.max_fans(
    pure=['1m','1m','1m','2m','3m','4m','5m','6m','7m','8m','9m','9m','9m'],
    furo=[],
    limit=0,
    dora=[],
    jikaze='1z',
    bakaze='2z') == 26)

Verify

python3 pytest/test.py -t pytest/resources/shanten-online-testcases.json