shikakusphere is a collection of miscellaneous funcitons for Japanese mahjong that wraps C++ sources derived from tomohxx/shanten-number and TadaoYamaoka/cmajiang.
The name “shikakusphere” is a compound word of “shikaku” + “sphere”. “shikaku” means “square” in Japanese. It comes from “Shikakui Uchuu De Matteru Yo”, which is the third ED of the anime “Saki”, and sounds exactly like mahjong games.
You can install the development version of shikakusphere from GitHub with:
# install.packages("pak")
pak::pak("paithiov909/shikakusphere")手牌はkobalab/majiang-coreの記法で文字列として表現します。
参考
- 牌 · kobalab/majiang-core Wiki
- 面子 · kobalab/majiang-core Wiki
- 牌姿 · kobalab/majiang-core Wiki
- 電脳麻将のプログラム中の中国語一覧 - koba::blog
paistr()は、こうした手牌の文字列表現を扱いやすくするためのS3クラス（<skksph_paistr>）です。print()したときに、その文字列に含まれる牌の枚数を表示します。また、plot(<skksph_paistr>)で牌姿を画像としてプロットできます。
library(shikakusphere)
hands <- c(
"m11p234s555z11122*",
"p1122334455667",
"m19p19s19z1234567",
"m055z7z7,m78-9,z5555,z666=",
"m055z7z7,m78-9,z5555,z666=,"
)
hands <- paistr(hands)
hands
#> <skksph_paistr[5]>
#> [1] <13>'m11p234s555z11122*' <13>'p1122334455667'
#> [3] <13>'m19p19s19z1234567' <15>'m055z7z7,m78-9,z5555,z666='
#> [5] <15>'m055z7z7,m78-9,z5555,z666=,'
plot(hands[4])
<skksph_paistr>をprint()したときに表示される牌の枚数は不正確な場合があります。手牌の表現にどの牌が何枚含まれるかを正確に確認するには、tidy(<skksph_paistr>)を使うことができます。
tidy(hands)
#> # A tibble: 43 × 3
#> id tile n
#> <int> <fct> <int>
#> 1 1 m1 2
#> 2 1 p2 1
#> 3 1 p3 1
#> 4 1 p4 1
#> 5 1 s5 3
#> 6 1 z1 3
#> 7 1 z2 2
#> 8 2 p1 2
#> 9 2 p2 2
#> 10 2 p3 2
#> # ℹ 33 more rowsこのかたちの表現はlineup()でlist of factorsにすることができます。
tidy(hands) |>
lineup()
#> [[1]]
#> [1] m1 m1 p2 p3 p4 s5 s5 s5 z1 z1 z1 z2 z2
#> 38 Levels: _ m0 m1 m2 m3 m4 m5 m6 m7 m8 m9 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 ... z7
#>
#> [[2]]
#> [1] p1 p1 p2 p2 p3 p3 p4 p4 p5 p5 p6 p6 p7
#> 38 Levels: _ m0 m1 m2 m3 m4 m5 m6 m7 m8 m9 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 ... z7
#>
#> [[3]]
#> [1] m1 m9 p1 p9 s1 s9 z1 z2 z3 z4 z5 z6 z7
#> 38 Levels: _ m0 m1 m2 m3 m4 m5 m6 m7 m8 m9 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 ... z7
#>
#> [[4]]
#> [1] m0 m5 m5 m7 m8 m9 z5 z5 z5 z5 z6 z6 z6 z7 z7
#> 38 Levels: _ m0 m1 m2 m3 m4 m5 m6 m7 m8 m9 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 ... z7
#>
#> [[5]]
#> [1] m0 m5 m5 m7 m8 m9 z5 z5 z5 z5 z6 z6 z6 z7 z7
#> 38 Levels: _ m0 m1 m2 m3 m4 m5 m6 m7 m8 m9 p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 ... z7さらに、このかたちのlist of factors（またはlist of
characters）はlipai()で文字列表現に変換できます（ただし、lipai()では_*+=-,は扱えません）。
c(paste0("m", 1:9), paste0("s", 4:6), paste0("z", c(1, 1))) |>
lipai()
#> [1] "m123456789s456z11"手牌のうちでも、副露面子を除いた打牌可能な部分のことを兵牌（bingpai）と呼びます。このパッケージで使用している実装における「シャンテン数」は、大まかには「その手牌の兵牌に注目したとき、手牌を聴牌形（和了形）に変形させるために必要なツモの最小数」のことを指しています。そのため、少牌だったりして素朴な意味での和了形になっていないかたちであっても、兵牌がn面子1雀頭のかたちになってさえいれば、ここでのシャンテン数は-1を返します。
また、ここでの「有効牌」というのは、その牌を新たにツモったときに、この意味でのシャンテン数が減少する牌のことです。兵牌の枚数が14,
11, 8, 5,
2枚の場合や、すでに和了形であって有効牌が定義できないときには、character(0)を有効牌として返します。なお、兵牌のなかに同じ牌が4枚ある場合についてのみ、有効牌であっても待ち牌としません。
# シャンテン数
n_xiangting <- calc_xiangting(hands)
n_xiangting
#> # A tibble: 5 × 2
#> num mode
#> <int> <fct>
#> 1 0 yiban
#> 2 0 yiban-qidui
#> 3 0 guoshi
#> 4 -1 yiban
#> 5 0 yiban
# 有効牌
collect_tingpai(hands[n_xiangting$num >= 0])
#> Warning in .Call(`_shikakusphere_skksph_get_tingpai`, pai, index_s, index_h):
#> zimo must be empty at: m055z77,m78-9,z5555,z666=,
#> [[1]]
#> [1] "m1" "z2"
#>
#> [[2]]
#> [1] "p1" "p4" "p7"
#>
#> [[3]]
#> [1] "m1" "m9" "p1" "p9" "s1" "s9" "z1" "z2" "z3" "z4" "z5" "z6" "z7"
#>
#> [[4]]
#> character(0)
collect_tingpai(c("m1234444p456s789", "m13p456s789z11,m2222"))
#> [[1]]
#> [1] "m1"
#>
#> [[2]]
#> [1] "m2"「あと何枚ツモれば手牌全体として聴牌形にできるか」という意味でのシャンテン数は、たとえば次のようにして計算できると思います。
dplyr::tibble(
hand = paistr(c("m1", "m1134", "m1,m45-6", "m1122p334455,s6-78", "m19p19s19z112345")),
calc_xiangting(hand),
calculate(hand)
) |>
dplyr::mutate(
bingpai = rowSums(bingpai),
n_zimo_to_hule = dplyr::case_when(
mode == "yiban" & bingpai + n_fulou * 3 < 13 ~ 13 - bingpai - n_fulou * 3,
.default = num
)
)
#> # A tibble: 5 × 7
#> hand num mode id n_fulou bingpai n_zimo_to_hule
#> <paistr> <int> <fct> <int> <int> <dbl> <dbl>
#> 1 <1>'m1' 0 yiban 1 0 1 12
#> 2 <4>'m1134' 0 yiban 2 0 4 9
#> 3 <4>'m1,m45-6' 0 yiban 3 1 1 9
#> 4 <13>'m1122p334455,s6-78' 0 yiban 4 1 10 0
#> 5 <12>'m19p19s19z112345' 1 guoshi 5 0 12 1calc_defen()はvectorizeされていないため、必ず、長さが1の文字列表現を渡してください。
# 得点
score <- calc_defen(hands[n_xiangting$num == -1][1], baopai = "z1")
score
#> shoupai hupai fu fanshu damanguan defen menfeng
#> 1 m055z7z7,m78-9,z5555,z666= 8,9,34,35,12 70 7 0 12000 1
# ロン和了のときはこんなふうに書く
calc_defen("m345567p234s3378", baopai = "z1", rongpai = "s9=")
#> shoupai hupai fu fanshu damanguan defen menfeng
#> 1 m345567p234s3378s9= 22 30 1 0 1000 1
# あがり役の表示
parse_hupai(score$hupai, "jp")
#> [[1]]
#> [1] 翻牌 白 翻牌 發 小三元 混一色 赤ドラ
#> 54 Levels: 場風 東 場風 南 場風 西 場風 北 自風 東 自風 南 自風 西 ... 地和convlogパッケージを使うと、天鳳のJSON形式（tenhou.net/6）のファイルから牌譜を読み込むことができます。
convlog::read_tenhou6()の戻り値は、次のようなかたちをしています。
json_log <-
list.files(
system.file("testdata/", package = "convlog"),
pattern = "*.json$",
full.names = TRUE
) |>
convlog::read_tenhou6()
json_log
#> $game_info
#> # A tibble: 21 × 4
#> game_id names qijia aka
#> <int> <named list> <int> <lgl>
#> 1 1 <chr [4]> 4 TRUE
#> 2 2 <chr [4]> 0 TRUE
#> 3 3 <chr [4]> 0 TRUE
#> 4 4 <chr [4]> 0 TRUE
#> 5 5 <chr [4]> 0 TRUE
#> 6 6 <chr [4]> 0 TRUE
#> 7 7 <chr [4]> 0 TRUE
#> 8 8 <chr [4]> 0 TRUE
#> 9 9 <chr [4]> 0 TRUE
#> 10 10 <chr [4]> 0 TRUE
#> # ℹ 11 more rows
#>
#> $round_info
#> # A tibble: 33 × 10
#> game_id round_id bakaze dora_marker kyoku honba kyotaku oya scores tehais
#> <int> <int> <chr> <chr> <int> <int> <int> <int> <list> <list>
#> 1 1 1 E 3s 1 0 0 0 <int> <chr[…]>
#> 2 2 1 E 4m 3 3 0 2 <int> <chr[…]>
#> 3 3 1 E 6m 1 0 0 0 <int> <chr[…]>
#> 4 4 1 E E 4 0 0 3 <int> <chr[…]>
#> 5 5 1 E 8p 2 2 0 1 <int> <chr[…]>
#> 6 6 1 E 7s 1 0 0 0 <int> <chr[…]>
#> 7 7 1 S 6s 4 0 0 3 <int> <chr[…]>
#> 8 8 1 S 2m 4 1 1 3 <int> <chr[…]>
#> 9 9 1 S 2m 1 0 0 0 <int> <chr[…]>
#> 10 10 1 S 7s 2 2 0 1 <int> <chr[…]>
#> # ℹ 23 more rows
#>
#> $paifu
#> # A tibble: 3,255 × 12
#> game_id round_id event_id type actor target pai tsumogiri consumed
#> <int> <int> <int> <chr> <int> <int> <chr> <lgl> <list>
#> 1 1 1 1 tsumo 0 NA S NA <NULL>
#> 2 1 1 2 dahai 0 NA N FALSE <NULL>
#> 3 1 1 3 tsumo 1 NA 2m NA <NULL>
#> 4 1 1 4 dahai 1 NA 8p FALSE <NULL>
#> 5 1 1 5 tsumo 2 NA 6p NA <NULL>
#> 6 1 1 6 dahai 2 NA 8s FALSE <NULL>
#> 7 1 1 7 tsumo 3 NA 1m NA <NULL>
#> 8 1 1 8 dahai 3 NA P FALSE <NULL>
#> 9 1 1 9 tsumo 0 NA 1m NA <NULL>
#> 10 1 1 10 dahai 0 NA 1p FALSE <NULL>
#> # ℹ 3,245 more rows
#> # ℹ 3 more variables: dora_marker <chr>, deltas <list>, ura_markers <list>この関数は、天鳳のJSON形式を一度MJAIフォーマットのJSON文字列へと変換したうえでパースするため、牌の表現などがshikakusphereで用いているものとは異なっています。MJAIフォーマットにおける牌の表現をshikakusphereで用いている表現に変換するには、trans_tile(),
mjai_target(), mjai_conv()を使って、次のようにします。
paifu <-
json_log[["paifu"]] |>
dplyr::filter(
type %in% c("tsumo", "dahai", "chi", "pon", "daiminkan", "kakan", "ankan", "reach")
) |>
dplyr::mutate(
# ツモ切りかを判定する場合、あらかじめ`NA`を`FALSE`で埋めておく
tsumogiri = dplyr::if_else(is.na(tsumogiri), FALSE, tsumogiri),
# 牌の表現の変換
pai = trans_tile(pai)
) |>
dplyr::mutate(
# 副露メンツの変換
pai = mjai_conv(type, pai, consumed, mjai_target(actor, target)),
# ツモ切りなら末尾に"_"を付ける
pai = dplyr::if_else(tsumogiri,
paste0(pai, "_"),
pai
),
# リーチ宣言牌なら末尾に"*"を付ける
pai = dplyr::if_else(
dplyr::lag(type, default = "") == "reach",
paste0(pai, "*"),
pai
),
.by = c(game_id, round_id, actor)
)
paifu
#> # A tibble: 3,185 × 12
#> game_id round_id event_id type actor target pai tsumogiri consumed
#> <int> <int> <int> <chr> <int> <int> <chr> <lgl> <list>
#> 1 1 1 1 tsumo 0 NA z2 FALSE <NULL>
#> 2 1 1 2 dahai 0 NA z4 FALSE <NULL>
#> 3 1 1 3 tsumo 1 NA m2 FALSE <NULL>
#> 4 1 1 4 dahai 1 NA p8 FALSE <NULL>
#> 5 1 1 5 tsumo 2 NA p6 FALSE <NULL>
#> 6 1 1 6 dahai 2 NA s8 FALSE <NULL>
#> 7 1 1 7 tsumo 3 NA m1 FALSE <NULL>
#> 8 1 1 8 dahai 3 NA z5 FALSE <NULL>
#> 9 1 1 9 tsumo 0 NA m1 FALSE <NULL>
#> 10 1 1 10 dahai 0 NA p1 FALSE <NULL>
#> # ℹ 3,175 more rows
#> # ℹ 3 more variables: dora_marker <chr>, deltas <list>, ura_markers <list>proceed()を使うと、ゲームのある時点におけるプレイヤーの手牌の状態を再現することができます。この関数には、各プレイヤーの配牌とその時点までのツモ・打牌をそれぞれlistとして与えます。チー・ポンと大明槓についてはツモの一部、暗槓と加槓については打牌の一部とします。
たとえば、ここで読み込んでいるデータについて、各本場の終わりの時点におけるプレイヤーの手牌を再現するには、次のようにします。
qipai <-
json_log[["round_info"]] |>
dplyr::rowwise() |>
dplyr::reframe(
game_id = game_id,
round_id = round_id,
actor = 0:3,
tehais
) |>
dplyr::mutate(
qipai = list(trans_tile(as.character(tehais))),
.by = c(game_id, round_id, actor),
.keep = "unused"
)
paifu |>
dplyr::left_join(qipai, by = dplyr::join_by(game_id, round_id, actor)) |>
dplyr::summarise(
zimo = list(pai[which(type %in% c("tsumo", "chi", "pon", "daiminkan"))]),
dapai = list(pai[which(type %in% c("dahai", "kakan", "ankan"))]),
.by = c(game_id, round_id, actor)
) |>
dplyr::left_join(qipai, by = dplyr::join_by(game_id, round_id, actor)) |>
dplyr::reframe(
game_id = game_id,
round_id = round_id,
player = actor,
last_state = proceed(qipai, zimo, dapai)
)
#> Warning: There were 2 warnings in `dplyr::reframe()`.
#> The first warning was:
#> ℹ In argument: `last_state = proceed(qipai, zimo, dapai)`.
#> Caused by warning in `.Call()`:
#> ! possibly incorrect mianzi at: m04-6
#> ℹ Run `dplyr::last_dplyr_warnings()` to see the 1 remaining warning.
#> # A tibble: 130 × 4
#> game_id round_id player last_state
#> <int> <int> <int> <paistr>
#> 1 1 1 0 <13>'m34677p33405s123'
#> 2 1 1 1 <13>'m12227999z13336'
#> 3 1 1 2 <13>'m05567s40z111,m333='
#> 4 1 1 3 <14>'m56688p3377s4,s666-6'
#> 5 2 1 2 <13>'m24777789z55,m666-'
#> 6 2 1 3 <14>'m3445688s406m2,z222+'
#> 7 2 1 0 <13>'m2255p345567s567'
#> 8 2 1 1 <13>'m3p222,z777=,s222=,z111-'
#> 9 3 1 0 <13>'m34p8s23466z11,m67-8'
#> 10 3 1 1 <13>'m88p456s06789,z555-'
#> # ℹ 120 more rowsGPL (>= 3). This package contains the tinyxml2 code released under the zlib license.