Tweet
Tweet

Slide 1

Slide 1 text

第77回R勉強会@東京 R Markdownを使った 再現的レポーティング niszet 2019/4/13

Slide 2

Slide 2 text

R Markdownを使った再現的レポーティング

Slide 3

Slide 3 text

誰？ • なまえ: niszet (@niszet0) • R歴: 3年目のRおじさん • AtCoder: 茶色になりました！ • 日本Pandocユーザー会

Slide 4

Slide 4 text

「R MarkdownでWord文書をつくろう」の献本あります 想定している対象読者層は R Markdownをある程度知っていて、 • Wordを使わないといけない方 • PowerPointを使わないといけない方 ※ このスライドもR Markdownから作っ ています

Slide 5

Slide 5 text

アウトプットしよう（技術同人誌界隈目線） • 何かしたら最後は必ずアウトプット • 成果をまとめるため • アウトプットすることで、理解できている/いないがはっきりする • 結果をshareする相手は将来の自分かもしれない。 • Qiitaでもブログでも（個人ブログはおすすめ） • 2018年は208件ブログ投稿してました もちろん外部に公開しなくてもOKです でも…結果は再現できた方が良いですよね。

Slide 6

Slide 6 text

よくある？シチュエーション 3か月前に作ったレポートをもう一度作らないといけな くなった。しかし… • データが行方不明… • どうやって処理したのかわからない • どうやって作図したのかわからない 結果や図が再現しない…！

Slide 7

Slide 7 text

R Markdownを使おう • データの前処理からドキュメント生成まで、書いた通りにR （knitやrmarkdown、その他のパッケージたち）が実行する 。 • 途中に手作業が入らない ので、何度やっても同じ結果や見 た目を保つ ことが出来る • 毎回クリーンな環境で実行されるので結果が変わらない • コンソール上で定義した変数や読み込んだライブラリは無効 • テキストファイルなので、gitでの管理にも向いている。

Slide 8

Slide 8 text

R Markdownで管理すべきもの • 生データ • 前処理、モデリング、可視化などのコード • ドキュメント本文の文章 • その他必要なもの（外部の画像ファイルなど） 全部！

Slide 9

Slide 9 text

出力ファイルの例 • HTMLのレポート • https://niszet.github.io/TokyoR77_rep_rmd/Sample1.html • スライド • https://niszet.github.io/TokyoR72LT/TokyoR72LT.html#/ • Word形式で書いた同人誌 • 名刺 • Webサイト、ブログ、オンライン書籍 …などなど、様々な形式のファイルが作れます。

Slide 10

Slide 10 text

RStudioでR Markdownを作る（実演） 実際に作ってみよう。 RStudioが既にインストールされていれば、簡単に試すこ とが出来ます。

Slide 11

Slide 11 text

これを ツールバーの File - NewFile から R Markdown… を選択

Slide 12

Slide 12 text

こうして… HTML形式を選択してtitleとauthorを決める

Slide 13

Slide 13 text

こうじゃ！ Knitボタンを押す。ファイルを保存していない場合は保存する。

Slide 14

Slide 14 text

出来た！ 生成されたHTMLファイルがRStudio上で表示される。ブラウザで開くことも出来る。

Slide 15

Slide 15 text

R Markdownの構造 R Markdownのファイル構造は大きく3つの部分に分けられる。

Slide 16

Slide 16 text

YAML • YAML Ain’t a Markup Language の略。 • リストや連想配列のような構造のあるデータを書く • R MarkdownではPandocにデータや指示を送るために使う • キー: 値の形で書く。 • title: HTML形式のR Markdownサンプル のように。 • 最低限outputだけ指定すれば動きます。 • outputに指定するのはrmarkdownパッケージの関数なので、詳細な 使い方はhelpを読みましょう

Slide 17

Slide 17 text

Markdown 文章の構造（意味のまとまり）を記号を使って書くのに 適した言語。基本は普通の文字列。 慣れるまではCheatSheetやHelpを見よう • ツールバーのHelpからCheatSheetを表示 • Markdown Quick ReferenceをHelp Paneに表示

Slide 18

Slide 18 text

Markdownのハマるところ 表示が意図通りにならなくて困ったら… • 空の行を入れる • ブロック要素の前後に空の行） • 記号の前後に空白を入れる と意図した表示になりやすい • インライン要素の前後に半角スペース • 記号の表示は直前にバックスラッシュ(¥) • 改行は行末にバックスラッシュか半角スペース2つ。

Slide 19

Slide 19 text

チャンク R のコードのまとまりをチャンクと呼びます。

Slide 20

Slide 20 text

表を出力してみる Sepal.Length Sepal.Width Petal.Length Petal.Width Species 5.1 3.5 1.4 0.2 setosa 4.9 3.0 1.4 0.2 setosa 4.7 3.2 1.3 0.2 setosa 4.6 3.1 1.5 0.2 setosa 5.0 3.6 1.4 0.2 setosa 5.4 3.9 1.7 0.4 setosa knitr::kable(head(iris), caption=キャプション)

Slide 21

Slide 21 text

チャンクオプション • チャンク名=値の形で書く • チャンク名は付けた方が良い • setupチャンクにはlibrary()やデータの読み込みなどを書く • よく使うオプション • eval（コードを実行するか） • echo（コードを表示するか） • fig.width、fig.height（画像の幅と高さ）

Slide 22

Slide 22 text

インラインコード 本文中に `r nrow(iris)` のように書くと、irisデータの行数 150を違和感なく埋め込むことができます。 データフレームなどは普通のブロックのチャンクで表示 しましょう。

Slide 23

Slide 23 text

チャンクオプションで困ったらココへ R markdown(knitr)パッケージのchunk optionまとめ My Life as a Mock Quant https://teramonagi.hatenablog.com/entry/20130615/13713 03616

Slide 24

Slide 24 text

画像 Rのプロットはそのまま画像になる • 中間データでファイルが生成され、自動で削除される 外部の画像は • Markdownの画像の文法、![表示する文字列](URLかファイルパス) • Rのknitr::include_graphics("ファイルパス") を使う。

Slide 25

Slide 25 text

plotの例 plot(iris)

Slide 26

Slide 26 text

ggplot2の例 ggplot(iris, aes(x=Sepal.Length, y=Petal.Length))+geom_point()

Slide 27

Slide 27 text

TIPS • ショートカットキーのCtrl+Shift+K は良く使うので覚えておき ましょう。 • ショートカットキー一覧はShift+Alt+K で表示されます。 • チャンクのコードを三角ボタンで実行すると、Consoleで実 行されるので注意（前後の実行環境で結果が変わる） • Environment Paneで確認。実行前後に箒のボタンで消しましょう

Slide 28

Slide 28 text

困ったときは… • kazutanさんのR Markdown入門がおすすめ • https://kazutan.github.io/kazutanR/Rmd_intro.html • r-wakalang に rmarkdown 部屋があります

Slide 29

Slide 29 text

Appendix • R言語初学者のための参考図書やサイトのまとめがあると便 利そうだけどないので勝手に作ろうと思う。 https://niszet.hatenablog.com/entry/2019/04/13/075059

Slide 30

Slide 30 text

Enjoy!!