Rでちゃんとしたプログラムを書くために

しっかりしたRのプログラムを書こうとした時に、とりあえず知っておくと良い知識をまとめました。

ソースとしては以下を参照：

• Creating R Packages: A Tutorial (http://cran.r-project.org/doc/contrib/Leisch-CreatingPackages.pdf)
• Google's R Style Guide (https://google-styleguide.googlecode.com/svn/trunk/Rguide.xml)
• CRANのPackege一覧 (http://cran.r-project.org/web/packages/available_packages_by_name.html)
• Rの拡張を書く (http://cran.r-project.org/doc/contrib/manuals-jp/R-exts.jp.pdf)

ディレクトリ構成

以下の関数で自動生成することができる。

package.skeleton

.
├── DESCRIPTION
├── NAMESPACE
├── MD5
├── R
│   └── package_name.R
├── data
│   └── sample_data.Rda
├── man
│   ├── some_function.Rd
│   └── the_other_function.Rd
└── tests
    └── package_name_test.R

ファイル名

アンダースコアでつなぎ.Rと大文字で終わる。

great_program.R

変数名

dot.splitedというように.でつなぐこと推奨。-や_は使わない。場合によっては、camelCaseもOK。

関数名

付け方は特に規定されていないが、GoogleはCamelCase(arg1, arg2 = val)というように大文字始まりのキャメルケースを推奨している模様。

Rのデフォルトはis.func(x)というように変数名と同様だが、この方法だとisインスタンスのfuncメソッドとも解釈できてしまうので良くない。大文字始まりが嫌いなら小文字のcamelCaseにすると良い。

関数の引数

デフォルト引数のあるものは最後に書く。(デフォルト引数は=を使う。)
折り返すときは、=の前後では折り返さない。

short <- function(a1, a2, a3 = value)

LongFunction <- function(arg1,
                         arg2,
                         arg3 = default_value) 

代入

<-を使う。=は使わない。

コメントの書き方

#の後に1つ空白を空けた後、コメントを書く。
ソースと同じ行にコメントを書く場合、前に2つスペースを空ける。

# Create histogram of frequency of campaigns by pct budget spent.
hist(df$pct.spent,
     breaks = "scott",  # method for choosing number of buckets

起動方法

インタプリタとしてRを起動したい時

-no-saveをつけると作業スペースを保存しないので便利。

$ R –no-save

プログラムを実行したい時

$ R --vanilla --slave < sample.R

プログラムを実行したい時（引数あり）

--argsパラメータを渡すと、RプログラムからcommandArgs()として受け取れるようになる。

$ R --vanilla --slave --args 1 2 str < test.R

commandArgs()の中身は"R" "--vanilla" "--slave" "--args" "1" "2" "str"となり使いにくい。
commandArgs(trailingOnly = T)とすると"1" "2" "str"となり、扱いやすくなる。
数字を数値として扱うときは、as.numericを使って変換する必要がある。