インストラクター用メモ

全般的な注意事項


例は徐々に、Palmer Penguins データセットの完全な分析へと発展していきます。このデータセットは、R の基本パッケージに penguins と penguins_raw として含まれています。最終版はこのリポジトリにあります。ワークフロー(_targets.R)は plan_11.R(episodes/files/plans/ にある番号付きプランファイルの最後のもの)、それが使用するカスタム関数は tar_functions、レポートは penguin_report.qmd です。

R のバージョン


penguins データセットは R バージョン 4.5.0 で基本パッケージに追加されたため、このレッスンには R 4.5.0 以降が必要です。ワークショップの前に、学習者(および使用予定の共有サーバーやクラウドインスタンス)が十分に新しいバージョンの R を使用していることを確認してください。

このレッスンは、ホスト済みの環境を提供していません。Posit Cloud などのクラウドサービスでワークショップを実施したい場合は、R 4.5.0 以降とセットアップ手順に記載されているパッケージを備えた環境を、ご自身で用意する必要があります。

オプションのエピソード


「パッケージの管理」のエピソードは、より発展的なトピック(パッケージを読み込むさまざまな方法、renv によるパッケージバージョンの管理、名前空間の衝突)を扱っており、時間が足りない場合は省略できます。レッスンの残りの部分はこのエピソードに依存しません。ワークフローはすでに library() でパッケージを読み込んでいます。

「関数の簡単な紹介」のエピソードはオプションのエピソードであり、ワークショップに参加する学習者によって必要かどうかが変わります。 関数を使った経験がある人はいるか、挙手(または付箋)で確認し、経験のない学習者がいる場合にこのエピソードを実施することをお勧めします。

targets は関数に大きく依存しているため、関数に不慣れな学習者がいる場合は、少し時間をかける価値があると考えています。関数について簡単な導入を受けないと、そうした学習者はすぐについていけなくなり、ワークショップの終了時に targets を使いこなせるようにならないでしょう。

はじめに


インストラクター用メモ

エピソードの概要: 再現性の概念と targets を使用する理由や対象者について紹介する



初めての targets ワークフロー


インストラクター用メモ

エピソードの概要: 非常にシンプルなワークフローを書いて、初めて実際に手を動かしてみる機会



関数の簡単な紹介


インストラクター用メモ

Episode summary: 関数の使用経験がない学習者がいる場合のための、関数のごく簡単な紹介。



ワークフローオブジェクトの読み込み


インストラクター用メモ

エピソードの概要: 作成したオブジェクトにアクセスする方法を示す



インストラクター用メモ

  • targets が別のRセッションで実行されるという概念を強調するために、penguins_data を実行しようとしてエラーになるふりをして驚きを装い、それを教育的な瞬間として使用することができます(エラーは教育の一部です!)。


ワークフローのライフサイクル


インストラクター用メモ

エピソードの概要: targets の典型的なサイクルである make、inspect、adjust、make を実演する



targetsプロジェクト組織のベストプラクティス


インストラクター用メモ

Episode summary: プロジェクト組織のベストプラクティスを実演する



パッケージの管理


インストラクター用メモ

エピソードの概要: パッケージの読み込み方法とパッケージバージョンの維持方法を示す



ブランチング


インストラクター用メモ

エピソードの概要: ブランチングの使用方法を示す



並列処理


インストラクター用メモ

エピソードの概要: 並列処理の使用方法を示す



外部ファイルの取り扱い


インストラクター用メモ

エピソードの概要: 外部ファイルの読み書き方法を示す



Quartoを用いた再現可能なレポート


インストラクター用メモ

エピソードの概要: Quartoを使用したレポートの書き方を紹介