readxlパッケージ 1.0.0の主要な変更点

先日、エクセルファイルのデータをRに読み込ませるパッケージのreadxlパッケージの1.0.0がCRANに登録されました。

実はしばらく更新を追えていなくて、色々な新機能があったのでメモしておきます。まとめると以下の通りです。気になった点を挙げていますので、詳細はNEWSをご覧ください。

• エクセルファイル読み込み関数に2つの引数の追加
  • 範囲を指定した読み込みのためのrange引数
  • 読み込み時の行制限としてn_maxの適用
• 列指定の際の挙動に大きな変更
  • col_types引数にlist, logical, guessが指定することが可能に
  • blankの廃止。代わりにskipの指定
  • 欠損値に複数の値を指定可能に
  • …
• その他
  • 変数名の初期値がX__1からX__0に変更

特に気になるのが読み込み時の範囲指定とcol_types引数のlist対応です。それぞれ詳しく見ていきましょう。

読み込み時の範囲指定

エクセルファイルだと、目的のデータ以外の備考や合計値を算出している行などが含まれていることがよくありますね。これまでの readxlパッケージでは、対象のシートに含まれるセルをよしなにデータフレームに変換して読み込み、そこから利用者が必要なデータを選択するという手間がありました。今回のバージョンで追加されたrange引数は、その手間を省略するのに大変役立ちます。

エクセルファイルを印刷する際、「範囲指定した部分のみを印刷」という処理をしたことがある人が多いと思います。range引数はそれと同じく、read_excel()の実行時に範囲を指定できるようになりました。これにより直接必要な箇所だけを読み込ませることができます。

range引数の指定方法は、エクセルで使われるA1:B2 (A1セルからB2セルまで)のような記述が可能です。また範囲指定の専用の関数としてcell_rows()、anchored()なども実装されています。

col_types引数のlist対応

Rのデータフレームの性質として、変数内の値はベクトルとして扱われ、そのデータ型は統一される、というものがあります。 そのため、文字列と日付が含まれる列を読み込む場合、日付は文字列に変換されてしまいます。一方でリストは異なるデータ型の値を保持するのに適しています。

今回、引数col_typesがlistに対応したことで、複数のデータ型が含まれる列であっても元の値を保持しておくことが可能になっています。少しわかりにくいのでヘルプに掲載されているコードを実行してみましょう。

library(readxl)
(df <- read_excel(readxl_example("clippy.xlsx"), 
    col_types = c("text", "list")))

## # A tibble: 4 × 2
##                   name      value
##                  <chr>     <list>
## 1                 Name  <chr [1]>
## 2              Species  <chr [1]>
## 3 Approx date of death <dttm [1]>
## 4      Weight in grams  <dbl [1]>

2列目、value列はlistとして格納されているのがわかります。各行は、実際の値でなく、データ型を示しています。リストとして保存することで、文字列、日付・時間、数値という異なるデータ型が共存しています。比較のため、通常の方法で読み込む例も示します。

read_excel(readxl_example("clippy.xlsx"))

## # A tibble: 4 × 2
##                   name     value
##                  <chr>     <chr>
## 1                 Name    Clippy
## 2              Species paperclip
## 3 Approx date of death     39083
## 4      Weight in grams       0.9

今度は直接、値が出力されました。しかし3行目の値が39083となっている点に注意です。これは元のエクセルファイルでは日付となっていたものでした。value列(ベクトル)が文字列として処理された結果、値が変化してしまいました。今回のアップデートでは、list列として処理することで、この問題を改善しています。

readxlのメジャーリリースとなる1.0.0が出たことで、Clippy君は悲しんでいるようですが、アップデートが済んでいない方は、ぜひ新しいreadxlをお試しください。

Clippy is sad, because readxl v1.0.0 is out! He's afraid you'll move your data out of Excel and into #rstats. https://t.co/nG0NmwYYkl pic.twitter.com/yfSwc0UfOm

— Jenny Bryan (@JennyBryan) 2017年4月19日

おまけ… RStudioのGUIからエクセルファイルも読み込めます

Enjoy!