gtsummary で論文の表を作る ハンズオン
Table 1 から回帰分析の表、Word 出力まで
はじめに
English version available — Read in English (machine-assisted translation by generative AI).
このハンズオンでは、R の gtsummary パッケージを使って、論文にそのまま載せられる表を作れるようになることを目指します。
- 患者背景の表(いわゆる Table 1)
- 群間比較の p 値 や差の信頼区間
- 層別(strata) した表、複数の表の結合
- 回帰分析 の結果表(オッズ比・ハザード比など)
- 見出し・脚注・太字・ジャーナル書式などの カスタマイズ
- Word / HTML / 画像 への出力
- オッズ比などの フォレストプロット
対象読者
- R で
data.frameを読み込んだり、|>(パイプ)を見たことがある方 - 平均・中央値・割合、t 検定やカイ二乗検定という言葉を知っている方(統計検定3級程度)
このハンズオンの特徴:ブラウザで R が動きます
各章のコードセルは、あなたのブラウザの中で R が実行されています(webR という技術)。 コードを書き換えて「Run Code」を押せば、すぐに表が作り直されます。インストールは不要です。
ノート
- 各章を開いた直後は、R とパッケージの読み込みに 数十秒〜1分ほど かかります
- 読み込み中にタブを裏に回すと処理が遅くなるので、表示されるまでそのままお待ちください
- PC での閲覧を推奨します
章構成
| 章 | 内容 |
|---|---|
| 1 | 最初の表:tbl_summary() の基本 |
| 2 | 群間比較と p 値:by, add_p() ほか |
| 3 | 層別・結合:tbl_strata(), tbl_merge(), tbl_stack() |
| 4 | 回帰分析の表:tbl_regression(), tbl_uvregression() |
| 5 | 見た目のカスタマイズ:modify_*(), テーマ |
| 6 | 出力と本文への引用:Word / HTML / inline_text() |
| 7 | オッズ比を図にする(フォレストプロット) |
| 8 | 演習問題 |
練習データ:trial
gtsummary に付属している、架空の抗がん剤試験のデータ(200 人)を使います。
| 変数 | 意味 |
|---|---|
trt |
治療群(Drug A / Drug B) |
age |
年齢 |
marker |
腫瘍マーカー値 (ng/mL) |
stage |
T ステージ(T1〜T4) |
grade |
グレード(I〜III) |
response |
腫瘍縮小あり (1) / なし (0) |
death |
死亡 (1) / 生存 (0) |
ttdeath |
死亡または打ち切りまでの月数 |
各変数には英語の ラベル(例:age → “Age”)が付いていて、表にはこのラベルが表示されます。
自分の PC で使う場合
install.packages(c("gtsummary", "dplyr", "broom", "broom.helpers", "cardx",
"car", "parameters", "smd", "flextable", "ggplot2", "ggstats", "patchwork"))gtsummary は p 値の計算や回帰表の作成で、ここに挙げた補助パッケージを使います。 「パッケージ “broom” が必要です」のようなメッセージが出たら、そのパッケージをインストールしてください。
ヒントこのハンズオンは gtsummary 2.x 系に対応しています
1.x 系とは一部の関数名・引数が異なります(例:modify_footnote() → modify_footnote_header())。 古い記事のコードが動かないときはバージョンを確認してください:packageVersion("gtsummary")