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() を使えば、表と同じ数値 を取り出せます。

回帰の表では、推定値と信頼区間をまとめて取り出せます。

ヒントQuarto / R Markdown で使う

本文中に `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() で表から取り出す → 転記ミスを防ぐ