> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exploratory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタム (R) チャート

> R のコードを書いて、Exploratory が標準で対応していないチャートを作り、チャート・ビューで管理します。

カスタム (R) は、チャート・ビューで使えるチャートタイプのひとつです。R のコードを書くことで、Exploratory が標準でサポートしていない任意のチャートを作れます。作ったチャートは、ダッシュボードやノートで再利用できます。

以前は、R のコードでカスタムチャートを作るには、ノートやダッシュボードのコードブロックに R スクリプトを直接書く必要がありました。同じチャートを複数のレポートで使うたびにコードをコピー＆ペーストする必要があり、通常のチャートのようにパブリッシュしたり、コメントを付けたりもできませんでした。バージョン15で、カスタム (R) がチャートタイプとして追加されました。

## できること

カスタム (R) チャートは、通常のチャートと同様に、次のように扱えます。

* チャート・ビューでの確認と管理
* コメントの挿入
* チャートとしてのパブリッシュ
* ダッシュボードやノートへの挿入と、複数レポートでの再利用

## 使い方

1. チャート・ビューのチャートタイプの一覧から「カスタム (R)」を選びます。R のコードを入力するエディターが表示されます。

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-01.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=89a322255822fc8a1162c3da50754c0f)

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-02.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=1c2a0603e9a7f6570699c9cfbf273030)

2. エディターに R のコードを書きます。データフレームを参照するときは、通常の R スクリプトと違って、`${DATA}` と書きます。現在開いているデータフレームが指定されます。

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-03.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=d2569dca78c56d0c811e9861b7f6a4e0)

3. 「ビュー」ボタンをクリックすると、チャートが表示されます。

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-04.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=28e556e3c58f7a543d8f2304b9dc753a)

参照できるのは、現在開いているデータフレームだけです。コードの中で他のデータフレームを直接参照する書き方は使えません。

## R パッケージをインストールする

カスタム (R) チャートでは、任意の R パッケージを使えます。Exploratory にプリインストールされていないパッケージを使うときは、先にインストールします。

1. プロジェクトメニューから「Rパッケージの管理」を選びます。

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-05.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=795a3ad2a65211efb765a0201e6f7087)

2. 表示されたダイアログにパッケージ名を入力して、インストールします。

   ![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-06.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=468243a987eac37dca1068153bf7e0c3)

インストールが終わると、エディターでパッケージを読み込み、パッケージがサポートする関数を使えます。

## チャートの作成例

### ツリーマップ

`treemap` パッケージの `treemap` 関数を使うと、階層構造を持つデータを四角形の面積で表すツリーマップを作れます。親カテゴリを同系色でグループ化すると、全体に占める各カテゴリの割合をひと目で把握できます。製品カテゴリ別の売上構成、予算の内訳、Web サイトのトラフィックの内訳など、「大きい順に何がどれくらいを占めているか」を見たいときに向いています。

![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-07.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=d402c7ba0f4131adf3642e2922eb0e75)

ツリーマップには、親カテゴリ・子カテゴリと、それぞれに対応する数値（売上など）を集計したデータフレームが必要です。

![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-08.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=d18dc12a15917d7b04e5f34fc83662f8)

次のようなコードを書きます。

```text theme={null}
library(treemap)

treemap(${DATA}, index=c("製品カテゴリー", "製品サブカテゴリー"), 
vSize= "売上",                           # 値を指定
type="index",                            # ツリーの色分けの方法を指定
palette = "Set1",                        # カラーパレットの選択
title="My Treemap",                      # チャートタイトルを設定
fontsize.labels=c(15,12),                # ラベルサイズの指定
fontcolor.labels=c("white","orange"),    # ラベルの色の指定
bg.labels=c("transparent"),              # ラベルの背景色の指定
align.labels=list(
    c("center", "center"), 
    c("right", "bottom")
        ),                               # ラベルの表示位置の指定
fontfamily.labels = "HiraKakuProN-W3",   # 日本語をラベルに利用したい時に指定
fontfamily.title = "HiraKakuProN-W3",    # 日本語をラベルに利用したい時に指定
fontfamily.legend = "HiraKakuProN-W3",   # 日本語をラベルに利用したい時に指定
)
```

![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-09.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=82e7f7ca248e78d3829b449a0dd0c026)

「ビュー」ボタンをクリックすると、ツリーマップが表示されます。

![](https://mintcdn.com/exploratory-inc/NGuHQ7KJ_8uae9w-/ja/viz/images/ja/r-custom-10.png?fit=max\&auto=format\&n=NGuHQ7KJ_8uae9w-\&q=85\&s=0e7a3e80c350e74ff308a91baacd61cd)

### 円形コードダイアグラム

円形コードダイアグラムは、複数のカテゴリ間の関係や流れを円形のレイアウトで表すチャートです。`circlize` パッケージの `chordDiagram` 関数で作れます。弧の太さが関連の強さを表し、すべてのカテゴリ間の関係を1つの図で把握できます。地域間の人口移動、取引先間の資金フロー、チーム間のコミュニケーション量など、「多数のカテゴリがお互いにどれくらい関係しているか」を見渡したいときに向いています。

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-11.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=8236b7acbcfc5b7ea052eb72792164ff)

移動元と移動先の2列を含むデータが必要です。

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-12.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=f1836e9df74f3d3a496353e4b331148d)

次のようなコードを書きます。

```text theme={null}
library(showtext)
library(circlize)

showtext_auto() # これを実行するだけで日本語が通るようになります

chordDiagram(${DATA}[, c("移動元", "移動先")], transparency = 0.5)
# 方向の情報は持たないため、移動元と移動先の列は逆でも問題ありません。
```

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-13.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=d062c3e013af3db87fe76837b897f5be)

「ビュー」ボタンをクリックすると、円形コードダイアグラムが表示されます。

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-14.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=041cd9e251715b6c9c87357486c38f34)

## エラーと自動修正

使おうとしている R パッケージがインストールされていないときは、インストールを促すダイアログが表示され、そこから R パッケージをインストールできます。

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-15.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=7e7c433aa704f3b32d9554ef97de8569)

エラーが発生したときは、次のダイアログが表示されます。

![](https://mintcdn.com/exploratory-inc/0KNiqYvfTe-izYDU/ja/viz/images/ja/r-custom-16.png?fit=max\&auto=format\&n=0KNiqYvfTe-izYDU\&q=85\&s=2317f2cb4192234244c21acfc7c3c061)

* AI 自動修正: 書いたコードの問題を、AI が自動で修正しようとします。
* AI に聞く: チャットウィンドウが開き、問題を解決するための回答を AI から得られます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.