6 出力と本文への引用
6.1 gtsummary の表は「変換」して使う
gtsummary の表は、表示や保存のときに別の表パッケージの形式に 変換 されます。
| 関数 | 変換先 | 主な用途 |
|---|---|---|
as_gt() |
gt | HTML、PNG、PDF、RTF |
as_flex_table() |
flextable | Word、PowerPoint |
as_kable() |
knitr::kable | Markdown |
as_kable_extra() |
kableExtra | LaTeX / PDF |
as_tibble() |
tibble | データとして加工・Excel 出力 |
6.2 gt に変換してさらに加工する
gtsummary にない装飾は、gt に変換してから gt の関数で加えられます。
as_gt() などで変換した後は、gtsummary の modify_*() や add_*() は使えません。 gtsummary での加工をすべて済ませてから、最後に変換 します。
6.3 データとして取り出す:as_tibble()
列名をそのまま使いたい場合は as_tibble(col_labels = FALSE)。 writexl::write_xlsx() などで Excel に書き出すこともできます。
6.4 ファイルに保存する(自分の PC で)
ブラウザ上ではファイルを保存できないので、ここは自分の R 環境で実行してください。
6.4.1 Word (.docx)
論文投稿では Word で表を求められることが多いです。flextable 経由で保存します。
library(flextable)
tbl |>
as_flex_table() |>
save_as_docx(path = "table1.docx")複数の表を1つの Word ファイルにまとめる場合:
save_as_docx(
"Table 1" = as_flex_table(tbl1),
"Table 2" = as_flex_table(tbl2),
path = "tables.docx"
)6.4.2 HTML / PNG / PDF
tbl |> as_gt() |> gt::gtsave("table1.html")
tbl |> as_gt() |> gt::gtsave("table1.png") # webshot2 パッケージが必要
tbl |> as_gt() |> gt::gtsave("table1.pdf")6.4.3 Quarto / R Markdown で原稿ごと作る
Quarto(.qmd)や R Markdown のコードチャンクに表のコードを書くと、format: docx / html / pdf に合わせて自動で適切な形式に変換されます。 Word 出力なら自動的に flextable 形式になるので、変換を意識する必要はありません。
---
title: "Results"
format: docx
---
```{r}
library(gtsummary)
trial |> tbl_summary(by = trt) |> add_p()
```6.5 本文に数値を引用する:inline_text()
本文に「年齢の中央値は Drug A 群で 46 歳(Q1, Q3: 37, 60)」のように書くとき、表から数値を手で写すと転記ミスが起きます。 inline_text() を使えば、表と同じ数値 を取り出せます。
回帰の表では、推定値と信頼区間をまとめて取り出せます。
本文中に `r inline_text(t_reg, variable = trt, level = "Drug B")` と書くと、 レンダリング時に数値が埋め込まれます。データを更新しても本文の数値が自動で追従します。
- 加工を済ませてから最後に変換:
as_gt()(HTML/画像)、as_flex_table()(Word)、as_tibble()(データ) - Word:
as_flex_table() |> flextable::save_as_docx() - 本文の数値は
inline_text()で表から取り出す → 転記ミスを防ぐ