なるほど機能 の変更点

• 追加された行はこの色です。
• 削除された行はこの色です。
• なるほど機能 へ行く。
• なるほど機能 の差分を削除

COLOR(magenta){SIZE(20){なるほど機能}}
// 間瀬(2004.3.24--)
~
~
「COLOR(blue){こんな機能があればいいな}」と思うことが時々ありますが、多くの場合実際にあるのが R の魅力です。コツは COLOR(red){help.search("hoge")} でキーワード検索することですが、適切なキーワード COLOR(blue){hoge} を思いつくのが意外に困難です。 以下に Ｑ＆Ａ 等でCOLOR(blue){発見}されたそうした機能をメモしておくことにします。ポインターだけ紹介しますので、詳しくは該当関数のオンラインヘルプで使い方を確かめてください。この Wiki に関連記事があることも多いはずなので、RjpWiki 各頁の末尾にある RjpWiki 内専用の検索機能も試してください。
~
-COLOR(blue){R 関連のドキュメントからの全文検索} 困った時は <<[[R site search::http://finzi.psych.upenn.edu/search.html]]>> でキーワード検索
//
~
-COLOR(blue){オブジェクトに注釈用のコメントを加える} COLOR(red){comment()} 関数
//
~
-COLOR(blue){一画面に収まらない長いオブジェクトを pager で自在に閲覧する} COLOR(red){page()} 関数
//
~
-COLOR(blue){(複雑な)オブジェクトを後から再現できるようにテキスト形式でファイルにセーブ} COLOR(red){dump()} 関数
//
~
-COLOR(blue){関数オンラインヘルプを dvi (ps) 形式で得る} COLOR(red){help()} 関数の COLOR(red){offline} オプション
//
~
-COLOR(blue){example 関数等で複数のグラフィックスが瞬時に消え去るのを防ぐ} COLOR(red){par(ask=TRUE)} 
次のグラフィックス表示前に確認を求めるのでゆっくり眺められる
//
~
-COLOR(blue){使えそうな関数を見つける} COLOR(red){help.search("keyword")} 
ただし適切なキーワードを思いつくにはそれなりの経験が必要なことが多い。検索は現在インストールされているすべてのパッケージを対象として行なわれるので、とりあえず不要なパッケージもまめにインストールしておくのが良い。標準パッケージにある関数も、他のパッケージに改良版があることも多い。
//
-COLOR(blue){シミュレーション等で同じ操作を何度も繰り返す際、ある試行でエラーが起きても残りを実行する} COLOR(red){try} 関数
//
-COLOR(blue){関数から複数の（一般にタイプの異なる）値を返す} リスト返り値 COLOR(red){return(list(..., ..., ...))}, COLOR(red){return(list(x=..., y=..., ...))}
//
-COLOR(blue){変数への付値とその値の表示を一度に行なう} 付値式を丸括弧で囲む COLOR(red){(x <- 1:10)}
//
-COLOR(blue){オブジェクトの内容を簡潔に整形して表示} COLOR(red){str()} 関数
//
-COLOR(blue){データフレームの成分を一時的に展開した環境中で操作} COLOR(red){with()} 
具体的には attach(データフレーム); 成分名を使った操作; detach(データフレーム) という前後処理が不要になる
//
-COLOR(blue){複数回の同一操作の結果を一括してリスト、ベクトルとして返す} COLOR(red){apply} 関数群 lapply, mapply 等
//
-COLOR(blue){関数を返す関数} 関数Tips を参照。同一関数のパラメータをさまざまに変えて使いたい時便利
//
-COLOR(blue){二者択一選択} COLOR(red){ifelse()} 関数 
条件式の真偽に応じて異なる値を返すことができ、if (..) ... else ... 構文を簡略化できる
//
-COLOR(blue){サマリー機能} COLOR(red){summary()} 
多くの R の統計処理関数の結果は summary() 関数で結果の簡潔かつ本質的な要約を得ることが出来る。「もしや」と一度試してみる価値がある。
//
-COLOR(blue){プロット機能} COLOR(red){plot()}  
多くの R の統計処理関数の結果は plot() 関数でグラフィックス表示を得ることが出来る。「もしや」と一度試してみる価値がある。
//
-COLOR(blue){文字列と(数値)変数を結合して文字列を得る} COLOR(red){paste()} 
関数は文字列と、数値オブジェクトを文字列化したものを結合し、一つの文字列にする。オプションで間に挟む文字も指定できる
//
-COLOR(blue){プログラムの実行時間を計る} COLOR(red){system.time()}
//
-COLOR(blue){プログラムの実行を指定秒数中断} COLOR(red){Sys.sleep()}
//
-COLOR(blue){プログラムの実行中にコンソールから行入力} COLOR(red){readline()} 
プログラムの実行を一時中断するのにも使える。
//
-COLOR(blue){メニュー方式で選択分岐} COLOR(red){menu()}関数
//
-COLOR(blue){プログラムのデバッグ} COLOR(red){browser()}, COLOR(red){debug()}
//
-COLOR(blue){プログラムの実行速度のボトルネックの発見} COLOR(red){Rprof()}
//
-COLOR(blue){関数オプションの入力省略} 
各関数のオプション COLOR(red){option=value} は一意的に決まる範囲で省略できる。例えば COLOR(red){optim(..., method = "BFGS", ...)} は COLOR(red){optim(..., m = "BFGS", ...)} でOK。
//
-COLOR(blue){論理値 TRUE, FALSE の省略記法} 
論理値 COLOR(red){TRUE}, COLOR(red){FALSE} はCOLOR(blue){構文上混同が起きない限り}それぞれ COLOR(red){T}, COLOR(red){F} と省略できる。またこれらは数値が要求される場合はそれぞれ COLOR(red){1}, COLOR(red){0} と解釈される。
//
-COLOR(blue){ベクトル、行列、配列の特定の成分の添字を得る} COLOR(red){which(x==3)} (x をベクトルとみなしベクトルとしての添字を返す), COLOR(red){which(x==3, array.ind=TRUE)} (x が行列、配列ならば行列、配列としての多次元添字を返す)。
//
-COLOR(blue){安全な完全一致判断} COLOR(red){identical()} 
二つの R オブジェクトが完全に一致するかどうかを検査する安全で信頼できる方法。
//
-COLOR(blue){すべて該当するか？} COLOR(red){all()}
//
-COLOR(blue){ほとんど該当するか？} COLOR(red){all.equal()} 
二つの R オブジェクトが「殆んど等しいか」どうかをチェックする。「殆んど等しい」の意味はオブジェクトにより異なる。数値ベクトルでは誤差の範囲内で一致するかどうかを判断する。
//
-COLOR(blue){階乗 n! を計算する} COLOR(red){gamma(n+1)} 
COLOR(red){+1} を忘れない。その対数値は COLOR(red){lgamma(n+1)} 。R 1.9 より階乗関数とその対数値に対する専用関数 COLOR(red){factorial(n)}, COLOR(red){lfactorial(n)} が登場した。
引数の COLOR(red){+1} を忘れない。その対数値は COLOR(red){lgamma(n+1)} 。R 1.9 より階乗関数とその対数値に対する専用関数 COLOR(red){factorial(n)}, COLOR(red){lfactorial(n)} が登場した。
//
-COLOR(blue){二項係数 nCk を計算する} COLOR(red){choose(n, k)} その対数値は COLOR(red){lchoose(n,k)} 
//
-COLOR(blue){数列の部分和・積、そして部分最大・最小値からなる数列を計算} COLOR(red){cumsum()}, COLOR(red){cumprod()}, COLOR(red){cummax()}, COLOR(red){cummin()}
//
-COLOR(blue){ベクトルの最大・小要素の位置を求める} COLOR(red){which.max()}, COLOR(red){which.min()}
//
-COLOR(blue){行列の各列毎の最大要素の位置を求める} COLOR(red){max.col()}
//
-COLOR(blue){ベクトルの要素の一意化} COLOR(red){unique()}
//
-COLOR(blue){ベクトルの要素のソート} COLOR(red){sort()} 
オプションで逆順ソートも可能
//
-COLOR(blue){ベクトルの要素を逆順に並べ変える} COLOR(red){rev()}
//
-COLOR(blue){C の sprintf 風の整形付き出力} COLOR(red){sprintf()}
//
-COLOR(blue){条件(群)がすべて真でなければストップ} COLOR(red){stopifnot()}
//
-COLOR(blue){データフレームの成分を名前だけで引用できるようにする} COLOR(red){attach(...)}~
不要になれば COLOR(red){detach(...)} で消去する。
//
-COLOR(blue){データフレームの成分を展開した一時的環境中で作業} COLOR(red){with()} 
一々 attach(...), detach(...) しなくても成分名で操作できる
//
-COLOR(blue){ベクトルに対する集合演算} COLOR(red){union(x, y)}, COLOR(red){intersect(x, y)}, COLOR(red){setdiff(x, y)},  COLOR(red){setequal(x, y)}, COLOR(red){is.element(el, set)}, COLOR(red){%in%}
//
-COLOR(blue){表示される有効桁数を変える。} COLOR(red){options(digits=10)} 
内部演算桁数は変更されず。最大22桁まで指定できるが、意味のある最大桁数はせいぜい 15, 16 桁です。
//
-COLOR(blue){日時、時間を得る} COLOR(red){date()}
//
-COLOR(blue){機械固有定数のリストを得る} COLOR(red){.Machine}
//
-COLOR(blue){組み込み定数} COLOR(red){LETTERS}, COLOR(red){letters} 
大文字アルファベット、小文字アルファベット、
COLOR(red){month.abb} 英字月名(3文字省略)、
COLOR(red){month.name} 英字月名(フル)
//
-COLOR(blue){ファイルに書き出す} COLOR(red){write}、COLOR(red){save}、COLOR(red){write.table}
//
-COLOR(blue){ファイルから読み込む} COLOR(red){scan}、COLOR(red){read.table}、COLOR(red){read.csv}、COLOR(red){read.csv2}、COLOR(red){read.delim}、COLOR(red){read.delim2}、COLOR(red){read.fwf}
//
-COLOR(blue){C 風演算子 +=, -=, *=, /= を R で実現} 
[[二項演算子定義の例]] 参照
//
-COLOR(blue){不特定多数の引数を関数に渡す} 
特殊な引数 COLOR(red){...}。各引数はそれぞれ COLOR(red){...[1]}, COLOR(red){...[2]},... と関数内で参照できる。 
//
-COLOR(blue){オブジェクト名を与えてその値を得る} COLOR(red){get()}
//
-COLOR(blue){一つのケースについて(数値、文字列等が混在した)何組かの項目を行列風に表現し、操作する。} COLOR(red){data.frame()} 
実際データフレームは多くの R/S の統計関数の基本的なデータ表現方法であり、これをマスターすることが上達のコツです。
//
-COLOR(blue){関数の名前つき引数の既定省略値} 
関数 f に対する名前つき引数には指定省略時の既定値を与えることができる。この既定値の値は R の他の関数 g の返り値であってもよい。さらに関数 g の引数が f の引数を用いて計算されても良い。~
例 COLOR(red){f(x, foo="bar")},  COLOR(red){digitsBase(x, base = 2, ndigits = 1 + floor(log(max(x), base)))}
//
-COLOR(blue){名前つき引数の名前の一部省略} 
名前つき引数に値を指定する際、引数名は一意的に決定される限り先頭の数文字を与えるだけで良い~
 例 digitsBase(x, base = 2, ndigits = 1 + floor(log(max(x), base)))
    digitsBase(10, b=16), digitsBase(10, b=8, n=5)
//
-COLOR(blue){複数行の一括コメント化} 
複数の行を COLOR(red){if(0){ 複数の行 } } と囲めばコメントとして無視される。
-COLOR(blue){繰返し} while(論理値を返す表現){ コード } 
//
-COLOR(blue){行列の行・列和を加える関数(R 1.9 の新機能)}
 > x <-matrix(1:4, nc=2)
 > addmargins(x)
      [,1] [,2] [,3]
 [1,]    1    3    4
 [2,]    2    4    6
 [3,]    3    7   10
//
-COLOR(blue){パッケージ中のオブジェクトの一覧} COLOR(red){library(help=stats)} 
"stats" パッケージ中のオブジェクトの一覧
//
-COLOR(blue){パッケージ中の組み込みデータオブジェクトの一覧} COLOR(red){data(package="stats")} 
"stats" パッケージ中の組み込みデータオブジェクトの一覧
//
-COLOR(blue){複雑なオブジェクトに含まれる項目数を得る} 
COLOR(red){unlist()} 関数 
リストや、ベクトル、行列をベクトル化する。R の関数の返り値はしばしば膨大な附属情報を隠れて持つが、どれくらいか見積もるのに使える。
 > x = list(rnorm(10), "abc", matrix(1:16,4,4)) # 複雑なオブジェクトのつもり
 > length(unlist(x))
 [1] 27   # 総計27項目(大雑把に8倍すれば対応メモリ量が見積もれる)
//
-COLOR(blue){オブジェクトのベクトル化} 
COLOR(red){c()} 
時系列、データフレームをベクトル化するのに使える 
//
-COLOR(blue){メモリーの利用状況の表示} 
COLOR(red){gc}, COLOR(red){gcinfo} 
//
-COLOR(blue){総称的関数、クラス用のメソッドの一覧を得る} 
COLOR(red){methods()} 
 > methods(plot)              # 総称的関数 plot() に対するメソッドの一覧を得る
  [1] plot.HoltWinters* plot.POSIXct plot.POSIXlt
  [4] plot.TukeyHSD     plot.acf*    plot.data.frame
 (途中省略)
 [28] plot.table        plot.ts      plot.tskernel*
     Non-visible functions are asterisked
 > methods(class = "lm")      # クラス "lm" のオブジェクト用のメソッド一覧を得る
//
-COLOR(blue){関数中からのオブジェクトのコンソールへの強制出力} 
COLOR(red){print()} 
関数中からの出力は最後のものを除き原則出力されない。もしどうしても出力したければそれを print() 関数の中にいれる。
 test <- function (x) {
           print(x)      # 引数の値を強制的に出力
           return(x^2)   # 最後の値は(変数に付値されない限り)出力される
         } 
 > test(2)
 [1] 2
 [1] 4

//
-COLOR(blue){R のさまざまな機能のデモ} 
COLOR(red){demo(), demo(テーマ)} 
R は様々な機能についてまとめて紹介するためのデモ機能を持つ。現在可能なテーマについては demo() で一覧できる。各テーマについては例えば demo(image) 等で実行する。グラフィックスを段階的に眺めるため、あらかじめ par(ask=TRUE) を実行しておくことを忘れないように。
//
-COLOR(blue){構文を表す文字列を命令として解釈実行} 
COLOR(red){eval(parse(text="..."))} は R の適正な構文を表す文字列を命令として解釈実行する定番構文です。
 ## paste 関数を使って "temp20=-13" という文字列を作っている
 > k=-13; j=20; eval(parse(text=paste("temp",j,"=",k,sep="")))
 > temp20
 [1] -13
 ## プログラム中で機械的に新しい変数を作るのにも使えます。
 > for(i in 1:5) eval(parse(text=paste("temp",i," <- ", runif(1), sep="")))
 > c(temp1, temp2, temp3, temp4, temp5)
 [1] 0.6150512 0.4978222 0.2924681 0.4796008 0.4626195
//
-COLOR(blue){棒グラフを縦に（横隣に）並べる} 
barplot() 関数の COLOR(red){beside} 引数 
//
-COLOR(blue){棒グラフの隣り合う棒の間のすき間調整を} 
barplot() 関数の COLOR(red){space} 引数。負の値を与えると棒が重なる。
space は長さ 2 のベクトルを値にとることができ、棒グループ内、間のスペーシングを与える
//     
-COLOR(blue){コンソールへの出力の抑制}  (2004.09.18) 
COLOR(red){invisible()} 関数は変数へ付値するのでなければ、結果のコンソールへの出力を抑制する。これは普通、グラフィックス情報等、可読性の低い大量の出力をコンソールに表示しないために、関数の返り値に return(...) の代わりに invisible(...) のように使われる。単独でも次のように余計な出力を抑制するために使うことができる。
 > x <- matrix(1:2^3, c(2,2,2))
 > apply(x, 2, print)
 [1] 1 2                         # 以下４行は print 関数の出力
 [1] 3 4
 [1] 5 6
 [1] 7 8
      [,1] [,2] [,3] [,4]        # 以下は apply 関数の既定の出力
 [1,]    1    3    5    7
 [2,]    2    4    6    8
 > invisible(apply(x, 2, print)) # 必要な出力だけにする 
 [1] 1 2
 [1] 3 4
 [1] 5 6
 [1] 7 8

 # 参考：変数に付値すると apply 関数の既定出力が取り出せる
 > y <- invisible(apply(x, 2, print))
 [1] 1 2
 [1] 3 4
 [1] 5 6
 [1] 7 8
 > y
      [,1] [,2] [,3] [,4]
 [1,]    1    3    5    7
 [2,]    2    4    6    8
//
-COLOR(blue){先頭、末尾数行の出力} (2004.09.18) 
COLOR(red){head(x, n=6)}, COLOR(red){tail(x, n=6)} はベクトル、行列、データフレーム、関数オブジェクトの先頭、末尾の数行(既定値は６行)を出力する。出力行数は引数 COLOR(red){n} で変えることができる。
//
-COLOR(blue){長たらしいリスト等を簡潔に表示 (2004.10.25)} 
 > x=list(rep(1,5), matrix(runif(8),4,2), LETTERS[1:6])
 > x
 [[1]]
 [1] 1 1 1 1 1
 
 [[2]]
                     [,1]                [,2]
 [1,] 0.48470060224644840 0.83881441224366426
 [2,] 0.39877605694346130 0.51671746163628995
 [3,] 0.64727503922767937 0.20069422083906829
 [4,] 0.92800087924115360 0.14544645673595369
 
 [[3]]
 [1] "A" "B" "C" "D" "E" "F"
 
 > noquote(unlist(format(x)))
 [1] 1, 1, 1, 1, 1
 [2] 0.48470060224644840, 0.39877605694346130, 0.64727503922767937,  0.92800087924115360, 
     0.83881441224366426, 0.51671746163628995, 0.20069422083906829, 0.14544645673595369
 [3] A, B, C, D, E, F
c.f.
 > noquote("jkflds")
 [1] jkflds
 > print("jkljkljkL", quote=F)
 [1] jkljkljkL

//
-COLOR(blue){一連の入力コマンド履歴をファイルに保存する}。(2004.11.09) 
R の終了時に save オプションを指定すると現在の入力履歴はワーキングディレクトリのファイル .Rhistory に保存され、次回起動時に自動的に読み込まれ、矢印キー等で復元できる。コマンド  
COLOR(red){savehistory("入力コマンド履歴保存ファイル名"} は指定したファイルに現在の入力コマンド履歴を保存する。保存した履歴は COLOR(red){loadhistory("入力コマンド履歴保存ファイル名")} で現在の R セッションに読み込むことができる。重要な操作を恒久的に保存するのにつかうと便利。
//
-COLOR(blue){ファイル名に作成時の日付や変数名を付け加える} (2004.11.16)~
データや画像ファイルを系統的に作成するのに使える 
 > res <- 12; i <- 5
 > paste(substitute(res), ".", gsub(" ", "-", date()),".",i,".png",sep="")
 [1] "res.Tue-Nov-16-19:27:01-2004.5.png"
 # 画像ファイルに作成日時等を含める
 png(filename=paste(substitute(res), ".", 
     gsub(" ", "-", date()),".",i,".png",sep=""), width=240, height=24)


//
-COLOR(blue){文字列の先頭、末尾、そして途中の引き続く空白を取り除く}   - from r-help, 2004.12.22 

 >x <- c("a b ", "dfhskf   ", "FGF", "IUOI UOUO UOUO  ")
 > sub(" *$", "", x)
 [1] "a b"            "dfhskf"         "FGF"            "IUOI UOUO UOUO"


//
-COLOR(blue){データフレームの小計計算} 
COLOR(red){aggregate(集計列,基準列,演算内容)}で基準列ごとに集計列を演算します。基準列にベクトルを指定するとエラーが出ます（１列だけ指定するときもリストにします）。
 >n<- c(3,4,1,9,6,9,6)
 >m<- length(n)
 >class <- rep(letters[1:m],n)
 >grade <- sample(6,sum(n),rep=T)
 >sansu <- sample(100,sum(n),rep=T)
 >kokugo <- sample(100,sum(n),rep=T)
 >aggregate(list(sansu=sansu,kokugo=kokugo),list(grade=grade,class=class),mean)
//
-COLOR(blue){} 
COLOR(red){} 
//
-COLOR(blue){} 
COLOR(red){}