In renkun-ken/formattable: Create 'Formattable' Data Structures

formattable

このパッケージは、ベクトルおよびデータフレームに書式を適用するために開発されました。これにより、データを「より簡単に」「よりリッチに」「より柔軟に」「できるだけ多くの情報を伝えるように」提示することができます。

インストール

最新の開発バージョンを GitHub からインストールするには：

# install.packages("devtools")
devtools::install_github("renkun-ken/formattable")

CRAN からインストールするには：

install.packages("formattable")

イントロダクション

ベクトルはデータを保存するための基本的な単位です。データの中には、書式を適用することで、可読性が高まるものがあります。例えば、Rにおいて複数のパーセント値からなる数値ベクトルは通常の小数点形式で表示されます。このパッケージは、あらかじめ定義された書式のルールに従って、データ構造を作成するための関数を提供します。これにより、元のデータを保持したまま、表示の際には書式を適用することができます。

このパッケージではpercent, comma, currency, accounting, scientificなど典型的な書式を提供しています。これらのオブジェクトは、基本的には数値ベクトルですが、あらかじめ定義された書式ルールとパラメータを持っています。例えば、

library(formattable)
p <- percent(c(0.1, 0.02, 0.03, 0.12))
p

このパーセントベクトルは、通常の数値ベクトルと違いはありません。ただし、コンソール上に表示したときに、パーセントで表示されます。四則演算や基本関数の適用を行っても、この書式は保持されます。

p + 0.05
max(p)

balance <- accounting(c(1000, 500, 200, -150, 0, 1200))
balance
balance + 1000

上で見た関数は、formattable() 関数でできることの特別なケースです。formattable() を使えば、numeric, logical, factor, Date, data.frame などの幅広いクラスのオブジェクトに対して、高度にカスタマイズされた書式を適用することができます。典型的なデータフレームは、列単位でformattable() を適用することによって、より読みやすくなるでしょう。例えば、

p <- data.frame(
  id = c(1, 2, 3, 4, 5),
  name = c("A1", "A2", "B1", "B2", "C1"),
  balance = accounting(c(52500, 36150, 25000, 18300, 7600), format = "d"),
  growth = percent(c(0.3, 0.3, 0.1, 0.15, 0.15), format = "d"),
  ready = formattable(c(TRUE, TRUE, FALSE, FALSE, TRUE), "yes", "no"))
p

動的ドキュメント中のテーブル(表)の書式

動的ドキュメント生成の典型的なワークフローの中で、knitr と rmarkdown は、R コードを含むドキュメントを異なるタイプのドキュメントに変換するための強力なツールです。

knitr は、RMarkdown ドキュメントを Markdown ドキュメントに変換することができます。rmarkdown は、pandoc を使って、markdowon ドキュメントを HTML ウェブページに変換します。これらのドキュメント中に、R の data.frame をテーブル(表)として置きたいときは、knitr::kable 関数を使って markdown 形式に変換することができます。 kable関数で生成されたテーブルは、デフォルトでは書式が適用されていません。ですが、書式を追加することにより、情報が明確化され、データが対比しやすくなる場合があるでしょう。本パッケージは、動的ドキュメントにおいて書式を適用したテーブルを生成するための関数を提供します。

df <- data.frame(
  id = 1:10,
  name = c("Bob", "Ashley", "James", "David", "Jenny",
    "Hans", "Leo", "John", "Emily", "Lee"),
  age = c(28, 27, 30, 28, 29, 29, 27, 27, 31, 30),
  grade = c("C", "A", "A", "C", "B", "B", "B", "A", "C", "C"),
  test1_score = c(8.9, 9.5, 9.6, 8.9, 9.1, 9.3, 9.3, 9.9, 8.5, 8.6),
  test2_score = c(9.1, 9.1, 9.2, 9.1, 8.9, 8.5, 9.2, 9.3, 9.1, 8.8),
  final_score = c(9, 9.3, 9.4, 9, 9, 8.9, 9.25, 9.6, 8.8, 8.7),
  registered = c(TRUE, FALSE, TRUE, FALSE, TRUE, TRUE, TRUE, FALSE, FALSE, FALSE),
  stringsAsFactors = FALSE)

何もしない場合、次のようなテーブルが表示されます：

knitr::kable(df, format = "html")

次のようにテーブルをフォーマットします：

年齢(age)はグラデーションで表示する。
A評価(grade)は緑の太字で表示する。
test1_score と test2_score は得点によってピンクの横棒で示される(長いほど高得点)。
final_score はスコアと順位(rank)を表示する。トップ3は緑、それ以外はグレーの文字。
registered はアイコン付きの Yes/No に変換する。

library(formattable)

formattable(df, list(
  age = color_tile("white", "orange"),
  grade = formatter("span",
    style = x ~ ifelse(x == "A", style(color = "green", font.weight = "bold"), NA)),
  test1_score = normalize_bar("pink", 0.2),
  test2_score = normalize_bar("pink", 0.2),
  final_score = formatter("span",
    style = x ~ style(color = ifelse(rank(-x) <= 3, "green", "gray")),
    x ~ sprintf("%.2f (rank: %02d)", x, rank(-x))),
  registered = formatter("span",
    style = x ~ style(color = ifelse(x, "green", "red")),
    x ~ icontext(ifelse(x, "ok", "remove"), ifelse(x, "Yes", "No")))
))

formattable

テーブルで使用されるアイコンセットは GLYPHICONS.com によるものです。これは Bootstrap に含まれています。

インタラクティブな環境における `htmlwidget` への自動変換

formattable オブジェクトは、コンソールや RStudio IDE などの interactive() な状況では、自動的に htmlwidget オブジェクトへと変換されます。この変換を避けたい場合や、markdown 形式のテーブル出力を見たい場合は、format_table() 関数を使って下さい。この関数は、knitr::kable() に書式を適用して整形した状態で呼び出すことができます。もしくは、formattable data.frame オブジェクトに対しては as.character() を呼び出して下さい。