インストラクター用メモ

タイミング

各ワークショップの開始時に約30分、各セッションの開始時にさらに15分程度を、WiFiやソフトウェアのインストールなどの技術的な問題に費やせるようにしてください
（事前にインストールを依頼していても同様です。依頼していない場合はさらに時間が必要です）。

レッスンプラン

このレッスンには、1日で教えられる量を超える内容が含まれています。
インストラクターは、標準的な1日コースで使用するエピソードの適切なサブセットを選ぶ必要があります。

いくつかの推奨ルートは以下の通りです：

（@liz-is による提案）

01 R と RStudio の概要
04 データ構造
05 データフレームの探索（「実践的な例」セクション以降）
08 ggplot2 を使った出版品質のグラフィック作成
10 関数の解説
13 dplyr によるデータフレーム操作
15 knitr を使用したレポート作成

（@naupaka による提案）

01 R と RStudio の概要
02 RStudio を使ったプロジェクト管理
03 ヘルプの検索方法
04 データ構造
05 データフレームの探索
06 データのサブセット化
09 ベクトル化
08 ggplot2 を使った出版品質のグラフィック作成 または
13 dplyr によるデータフレーム操作
15 knitr を使用したレポート作成

（@karawoo による半日コースの提案）

01 R と RStudio の概要
04 データ構造（c() を使ったベクトルの作成のみ）
05 データフレームの探索（「実践的な例」セクション以降）
06 データのサブセット化（因子、行列、リストのサブセット化を除外）
08 ggplot2 を使った出版品質のグラフィック作成

RStudio での Git 設定

Git を RStudio にリンクさせる際には、オペレーティングシステムやそのバージョンによって問題が生じる場合があります。
Git が正しくインストールおよび設定されていることを確認するには、RStudio アプリケーションの「オプション」ウィンドウを開きます。

Mac OS X:
- RStudio -> Preferences… -> Git/SVN に移動します。
- 「Git 実行可能ファイル」ウィンドウにファイルへのパスが表示されているか確認します。表示されていない場合は、次のステップとして Git の場所を特定する必要があります。
- ターミナルで which git と入力すると、Git 実行可能ファイルへのパスが表示されます。「Git 実行可能ファイル」ウィンドウでファイルを選択するのが難しい場合、OS X は多くのシステムファイルを非表示にしているためです。この場合、ファイル選択ウィンドウが開いている状態で「Command-Shift-G」を押すと、テキスト入力ボックスが表示され、Git 実行可能ファイルへのフルパス（例: /usr/bin/git）を入力または貼り付けることができます。
Windows:
- Tools -> Global options… -> Git/SVN に移動します。
- Software Carpentry Installer を使用した場合、‘git.exe’ は C:/Program Files/Git/bin/git.exe にインストールされているはずです。

GitHub にコミットをプッシュするたびにパスワードを再入力しなくて済むようにするには、以下のコマンドを bash プロンプトで実行します。これにより、パスワードを一度だけ入力する設定になります：

BASH

$ git config --global credential.helper 'cache --timeout=10000000'

RStudio カラープレビュー

RStudio には、特定の名前付き色や16進数色のプレビューを表示する機能があります。
これにより、予期していない受講者（およびインストラクター）が混乱したり注意をそらされたりする可能性があります。

主に、次のコードブロックを含む「データ構造」エピソード中にこれが問題になることがあります：

R

cats <- data.frame(coat = c("calico", "black", "tabby"),
                    weight = c(2.1, 5.0, 3.2),
                    likes_string = c(1, 0, 1))

このオプションは、以下のメニュー設定でオン/オフを切り替えることができます：
Tools -> Global Options -> Code -> Display -> Enable preview of named and hexadecimal colors （「構文」セクション内）

データの取り込み

ワークショップ中に使用するデータを簡単に取得するには、参加者に gapminder-data と gapminder-data-wide から
生データをダウンロードしてもらうのが最も簡単です。

参加者はブラウザの File - Save As ダイアログを使ってファイルを保存できます。

全体的な注意点

良いプラクティスを強調してください：コードをスクリプトに書き、バージョン管理されていることを確認してください。
チャレンジ用のスクリプトファイルを作成するよう学生に促してください。

クラウド環境で作業している場合、第2レッスンの後に Gapminder データをアップロードさせてください。

行列は内部的にはベクトルであり、データフレームはリストであることを強調してください：
これにより、基本操作で遭遇する多くの特異な動作を説明できます。

ベクトルのリサイクルや関数スタックは、ホワイトボード上の図で説明するのが最適です。

R のヘルプページの例を実際に紹介することを忘れないでください：ヘルプファイルは最初は威圧的に感じられますが、
それを読む方法を知ることは非常に役立ちます。

CRAN タスクビューを見せ、その中の1つのトピックを確認してください。

内容が多いため、初期のレッスンを迅速に進めてください。
これらの広範な内容は主に学習の浸透を目的としています：後で問題や特異な動作に遭遇したときに記憶が呼び起こされるようにするためです。

じっくり時間をかけるべき重要なレッスン：

データのサブセット化 - 初心者には概念的に難しい
関数 - 学習者が特に苦労するポイント
データ構造 - 徹底する価値がありますが、迅速に進めることができます。

正確であることや教材を完全に把握していることを気にする必要はありません。
ミスを指導の機会として活用してください：最も重要なスキルは、予期しないエラーからデバッグして回復する方法を伝えることです。

RとRStudio入門