コードダイアグラムでモノや情報の流れを可視化 ： Yellowfin と FusionCharts の活用

[前回記事](https://qiita.com/ExtremeCarvFJ/items/01e6c0eaad6864ef4c8f)で、サンキーダイアグラムを使ってモノや情報の流れを可視化する内容を取り扱いました。サンキーダイアグラムと類似の目的で用いるチャートの一つとして、コードダイアグラムがあります。今回は、コードダイアグラムを使って、各国間の輸出量を可視化します。

## 1. 事前準備

#### 1-1. データの準備まで
[前回記事](https://qiita.com/ExtremeCarvFJ/items/ad453a6110cec093bdb9)  を参考に、『1-3. データの準備』 までの作業を実施します。なお、以下の手順と同じデータを使いたい方は、[こちら]( https://github.com/ChasingHH/ShareFiles/blob/Share/GrossExport.csv)にサンプルデータを共有しています。

#### 1-2. ビューの作成
以下の通りに軸 (Dimensions) と集計値 (Metrics) を設定します。
&nbsp; &nbsp; &nbsp;軸 : from, to
&nbsp; &nbsp; &nbsp;集計値 : value

## 2. グラフの作成
準備が整ったら、グラフの作成に手順を進めます。新規でレポートを作成し、以下の手順に従ってグラフを作成します。

#### 2-1. [データ] ステップ
ビューに設定した軸と集計値を全てテーブルに配置します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/56c8ca82-7636-5577-f65a-ecc4bc439ef3.png)

#### 2-2. [グラフ] ステップ
[グラフ] ステップに進み、画面右側 [グラフの選択] から [JavaScriptグラフ] を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/851bc9ac-0f24-ccab-0730-0daf75831d04.png)

##### JavaScriptタブ
雛形を全て削除し、以下のコードに置き換えます。コードの処理の内容は後ほど説明します。
```javascript:JS
generateChart = function(options) {
   var $chartDrawDiv = $(options.divSelector);
   var processedDataLabel = processDataLabel(options.dataset.data);
   var processedDataValue = processDataValue(options.dataset.data);
   doDrawing(processedDataLabel, processedDataValue, $chartDrawDiv);
},

processDataLabel = function(dataset) {
    var ds_label = [];
    for (i=0;i<dataset.from.length;i++){
        if(dataset.value[i].formatted_data === "0"){
            ds_label.push({
                label: dataset.from[i].raw_data,
            });
        }
    }
    return ds_label;
},

processDataValue = function(dataset) {
    var ds_value = [];
    for (ii=0;ii<dataset.from.length;ii++){
        if(dataset.value[ii].formatted_data != "0"){
            ds_value.push({
                from: dataset.from[ii].raw_data,
                to: dataset.to[ii].raw_data,
                value: dataset.value[ii].raw_data,
            });
        }
    }
    return ds_value;
},

doDrawing = function(ds_label, ds_value, $chartDrawDiv) {
    console.log(JSON.stringify(ds_label));
    console.log(JSON.stringify(ds_value));
    require(['js/chartingLibraries/fusioncharts-suite-xt/js/fusioncharts.js'], function(){
        const dataSource = {
            chart: {
                caption: "2017年総輸出高",
                theme: "fusion",
                nodelabelposition: "outside",
                showlegend: 0,
            },
            nodes: ds_label,
            links: ds_value
        };
        FusionCharts.ready(function() {
            var myChart = new FusionCharts({
                type: "chord",
                renderAt: $chartDrawDiv[0],
                width: 500,
                height: 500,
                dataFormat: "json",
                dataSource
            }).render();
        });
    });
};

```
##### プレビュー
[プレビュー] に移り、どのようなチャートが作成されるか確認します。マウスをホバーすると、ツールチップが表示され、2 か国間の輸出高が確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/37b1fbef-840b-93ac-cf69-d0d5bc0d4ffe.png)

## 3. コードの内容
動作概要が分かったところで、コードの中身を見てみましょう。
##### generateChart
```JavaScript:generateChart
generateChart = function(options) {
   var $chartDrawDiv = $(options.divSelector);
   var processedDataLabel = processDataLabel(options.dataset.data);
   var processedDataValue = processDataValue(options.dataset.data);
   doDrawing(processedDataLabel, processedDataValue, $chartDrawDiv);
},
```

JavaScript グラフの処理において、最初に呼び出されるのが generateChart = function(options) です。
[データ] ステップでテーブルに追加した情報が、options に格納されて、メソッドに受け渡されます。
`var $chartDrawDiv = $(options.divSelector)` でグラフを出力する div を選択します。

下記 3 行で、別の関数を呼び出して、データ処理とグラフ描画処理を行っています。呼び出し先の関数での処理内容は後続の個所で説明をします。
`var processedDataLabel = processDataLabel(options.dataset.data);`
`var processedDataValue = processDataValue(options.dataset.data);`
`doDrawing(processedDataLabel, processedDataValue, $chartDrawDiv);`

##### processDataLabel
```JavaScript:processDataLabel
processDataLabel = function(dataset) {
    var ds_label = [];
    for (i=0;i<dataset.from.length;i++){
        if(dataset.value[i].formatted_data === "0"){
            ds_label.push({
                label: dataset.from[i].raw_data,
            });
        }
    }
    return ds_label;
},
```

Yellowfin のデータセットを JSON の配列に変換して ds_label にオブジェクトとして格納しています。[データ] ステップでテーブルに追加した列 [from] から、ノード (国名) に用いる情報を取得しています。
今回のサンプルデータであれば、以下のような JSON の書式になります。画面ショットは [グラフ] ステップでディベロッパーツールのコンソールから確認したものです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/5ec1c7f0-2e30-fa2c-3db1-169c1cd1a756.png)
コードの中に `console.log(JSON.stringify(ds_label))` を記述しておくと、データオブジェクトの中身をコンソールで確認することができます。今回の場合は、doDrawing の先頭に記述しています。デバッグに便利なので、活用してみてください。

##### processDataValue
```JavaScript:processDataLabel
processDataValue = function(dataset) {
    var ds_value = [];
    for (ii=0;ii<dataset.from.length;ii++){
        if(dataset.value[ii].formatted_data != "0"){
            ds_value.push({
                from: dataset.from[ii].raw_data,
                to: dataset.to[ii].raw_data,
                value: dataset.value[ii].raw_data,
            });
        }
    }
    return ds_value;
},
```

Yellowfin のデータセットを JSON の配列に変換して ds_value にオブジェクトとして格納しています。[データ] ステップでテーブルに追加した列 [from] [to] [value] を全て格納して、ノード間のデータの流れを表示するためのデータオブジェクトを作成します。サンプルデータの JSON 書式は以下の通りです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2128512/f53f5d09-3842-ee08-48dd-1519f7a02a55.png)

##### doDrawing
```JavaScript:doDrawing
doDrawing = function(ds_label, ds_value, $chartDrawDiv) {
    console.log(JSON.stringify(ds_label));
    console.log(JSON.stringify(ds_value));
    require(['js/chartingLibraries/fusioncharts-suite-xt/js/fusioncharts.js'], function(){
        const dataSource = {
            chart: {
                caption: "2017年総輸出高",
                theme: "fusion",
                nodelabelposition: "outside",
                showlegend: 0,
            },
            nodes: ds_label,
            links: ds_value
        };
        FusionCharts.ready(function() {
            var myChart = new FusionCharts({
                type: "chord",
                renderAt: $chartDrawDiv[0],
                width: 500,
                height: 500,
                dataFormat: "json",
                dataSource
            }).render();
        });
    });
};
```

`require[]` の中で、JavaScriptライブラリーを格納したディレクトリーを相対パスで記述します。

`dataSource` `chart` の中で、チャートのタイトルやラベル位置などに関する設定を施しています。
`nodes: ds_label` で ds_label データセットの中身を FushionCharts に受け渡しています。
同様に、`links: ds_value` で ds_value データセットの中身を FushionCharts に受け渡しています。

`FusionCharts.ready` でチャートを描画します。
`type: "chord",` でチャートの種類を指定します。
`renderAt: $chartDrawDiv[0]` でチャートを描画する div を指定します。`$chartDrawDiv` はコードの先頭で宣言した変数です。
`width` と `height` はダッシュボードの大きさなどに合わせてピクセル単位で指定します。FusionCharts のサンプルを見ると、% で指定していますが、Yellowfin で扱う場合は、ピクセルで指定した方がきれいに表示されます。

## 4. 最後に
2 国間の情報の流れを把握するためには、とても便利なチャートですね。何より見た目が美しい。

皆様、良いデータ分析を! Cheers!!