Skip to content

keiono/d3-layout-sample

Repository files navigation

Day 11: 12/11/2013 スクリプトを書かずに各種グラフデータをD3.jsで扱える形式に書き出す

はじめに

私はアメリカの大学の医学部で、お医者さんや生物学者向けのソフトウェア開発を行っているものです。ずっとJavaやC++などの世界に居ましたので、Webの世界はまだまだ勉強中です。その勉強の過程ででっち上げたツールなどを少し公開させていただきます。一部「生煮え」のものも含まれるので、徐々に改善していきます。

D3.jsとグラフデータ

D3.jsには「元になるデータのフォーマットに関する制約は最小限にする」と言う思想があるようです。基本的にはCSVなどのテーブル形式でデータを用意すれば大抵の場合は間に合います。そんな中グラフ形式のデータに関しては、並び順(ordinal)をIDとみなすという、冗長性は少なくなる一方、若干可読性に欠ける方式となっています。もちろんそれでもシンプルなので、ちょっとしたスクリプトを書いてしまえば済む作業ですが、目で見ながらグラフィカルにグラフ構造をエディットし、それを自動的に書き出せたらそれも便利です。

というわけで作りました。これは、Cytoscapeと言うグラフ解析・可視化アプリケーションの上で動くプラグイン(App)で、読み込まれたグラフのトポロジと属性データをそのままD3.jsで読み込める形式に書き出すものです。

ソフトウェアのダウンロードとインストール

現在このAppは正式発表前のCytoscape 3.1.0以降にのみの対応しているため、ベータ版のダウンロードが必要となります。 (注: どちらも、最終版がリリースされた時にこのドキュメントもアップデートします。)

http://chianti.ucsd.edu/~kono/data/cy3latest/build-2013-12-04-21-32-34-PST/ (12/4/2013の最新ビルド)

そして、このAppをインストールする。

https://github.com/keiono/cytoscape-d3/releases/tag/1.0.0-BETA

App-->App ManagerでAppのインストール画面を開いて、Install from File... ボタンをクリックすれば、あとはダウンロードした.jarファイルを指定するだけです。

ネットワークの作成

Cytoscapeで読み込める形式なら何でもかまいませんが、最もシンプルなものはエッジのリストを書いただけのテーブル形式でしょう。

例えば、このリストは

1	2
2	3
3	1
1	4
4	3

以下のように読み込む事ができます:

Small Network Sample

ネットワークの読み込み方は、こちらを参考にして下さい。

各種データの追加

D3.jsに限りませんが、複雑な可視化を目指す場合、各種統計量や、その他ノードやエッジに付随するデータを一緒に使うのが一般的です。Cytoscape上であれば、そういったものを比較的簡単に統合することが出来、それをそのままD3.jsように書き出されるJSONに含めることが可能です。以下は、読み込んだ比較的小規模なネットワークを、NetworkAnalyzerと言う機能で各種統計量を計算して、それをそのまま書き出した例です:

  "nodes" : [ {
    "id" : "1480",
    "NeighborhoodConnectivity" : 2.0,
    "NumberOfDirectedEdges" : 1,
    "SUID" : 1480,
    "Stress" : 0,
    "SelfLoops" : 0,
    "IsSingleNode" : false,
    "PartnerOfMultiEdgedNodePairs" : 0,
    "selected" : false,
    "name" : "YDL194W",
    "Degree" : 1,
    "TopologicalCoefficient" : 0.0,
    "BetweennessCentrality" : 0.0,
    "Radiality" : 0.55122461,
    "Eccentricity" : 26,
    "NumberOfUndirectedEdges" : 0,
    "ClosenessCentrality" : 0.07623732,
    "shared_name" : "YDL194W",
    "AverageShortestPathLength" : 13.11693548,
    "ClusteringCoefficient" : 0.0
  }]

このように、各種統計量が含まれた状態でネットワークを書き出すことができれば、D3.jsの基本的な機能を使って、それらを視覚効果へとマッピングすることが容易です。

この記事の主眼は、あくまでCytoscape上でエディットしたデータを簡単にD3.js形式に書き出すという点なので、Cytoscapeに関する詳しい説明はしませんが、興味のある方は以下のリンクを参考にして下さい。

いくつかプレゼンテーションスライドもありますので、興味のある方はどうぞ:

D3.jsへの書き出し

File-->Export-->Networkで、D3.js形式のフォーマットを選択するだけです。書き出しの結果はこんな感じになります:

書き出されるデータのサンプルと実際の可視化

一度様々な属性値(attributes)を付随したグラフデータをJSON化すれば、それをマッピングするのは非常に容易で、例えばEdge Betweennessをエッジの太さとしたいときは、stroke-width attributeの返り値にそのデータを指定するだけで良い(そのままでは太さの値としては大きすぎるので、底を10とする対数としました):

var link = svg.selectAll(".link")
    .data(graph.links)
    .enter().append("line")
    .attr("class", "link")
    .attr('stroke-width', function(d) {
        return Math.log(d.EdgeBetweenness)/ Math.LN10;
    });

更にシンプルな例として、ノードの次数をそのままノードの大きさにマッピングすることも、同じように返り値を半径にマップするだけで可能です:

node.append("circle")
    .attr("class", "node")
    .attr("r", function(d) {
        return d.Degree;
    });

書き出した結果を単純に可視化したものはこちらです。このレポジトリにサンプルコードを含めておきます。Yeomanで作成したテンプレートほぼそのままです。ビルドにはnode.jsとGruntが必要です。

net1.json

このように、予め外部でネットワークに関する詳細なデータを付加しておくことにより、より複雑な可視化のアイデアを実装していくことが可能になります。

Tree形式の書き出しと、更に複雑な可視化例は次回の記事に。

質問等は、kono アットマークucsdドットeduまでお願いします。

Day 20: 12/20/2013 Tree形式のデータを外部ツールを使って書き出す

前回の落ち穂拾い

前回の続きです。先に紹介したCytoscape用のAppは、グラフの特殊形態の一つとみなすことが出来るTree形式のデータの書き出しにも使えます。D3.jsには、様々なTreeデータを可視化するプリセットレイアウトが含まれていますので、これを利用することにより、ひとつの形式のデータを様々な方式でレンダリングすることが可能になります。同一のデータを様々な形で簡単に見ることが出来るのは、D3.jsの利点の一つです。

Tree形式での書き出し

基本的にグラフと同じですが、rootノードを自分で選択しておく必要があります。以下の例だと、ROOTとラベルの付いたノードをクリックすることによりそれがルートノードとして指定され、それに基づいてTree形式のJSONとして出力されます。D3.jsのTree形式JSONはルートから始まり、ネストさせて記述する形式ですので、手で作成するのはさすがに厳しいですが、この書き出しツールを使うとテーブル形式のエッジの集合を、自動的に変換することができます。

例えば、以下のテーブルは、

N1 child_of ROOT
N2 child_of ROOT
N3 child_of ROOT
N4 child_of ROOT
N5 child_of N1
N6 child_of N1
N7 child_of N4
N8 child_of N2
N9 child_of N5

以下のように読み込まれます:

tree1.json

このデータから書きだされたツリー形式のデータはこんな感じになります。

{
  "name" : "ROOT",
  "shared_name" : "ROOT",
  "SUID" : 63,
  "selected" : true,
  "name" : "ROOT",
  "children" : [ {
    "name" : "N3",
    "shared_name" : "N3",
    "SUID" : 67,
    "selected" : false,
    "name" : "N3"
  }, {
    "name" : "N4",
    "shared_name" : "N4",
    "SUID" : 69,
    "selected" : false,
    "name" : "N4",
    "children" : [ {
      "name" : "N7",
      "shared_name" : "N7",
      "SUID" : 75,
      "selected" : false,
      "name" : "N7"
    } ]
  }, {
    "name" : "N2",
    "shared_name" : "N2",
    "SUID" : 65,
    "selected" : false,
    "name" : "N2",
    "children" : [ {
      "name" : "N8",
      "shared_name" : "N8",
      "SUID" : 77,
      "selected" : false,
      "name" : "N8"
    } ]
  }, {
    "name" : "N1",
    "shared_name" : "N1",
    "SUID" : 62,
    "selected" : false,
    "name" : "N1",
    "children" : [ {
      "name" : "N5",
      "shared_name" : "N5",
      "SUID" : 71,
      "selected" : false,
      "name" : "N5",
      "children" : [ {
        "name" : "N9",
        "shared_name" : "N9",
        "SUID" : 79,
        "selected" : false,
        "name" : "N9"
      } ]
    }, {
      "name" : "N6",
      "shared_name" : "N6",
      "SUID" : 73,
      "selected" : false,
      "name" : "N6"
    } ]
  } ]
}

これが便利なのは、Cytoscape上で計算したり入力した各種スコアなどを含めて出力できる点で、GUIからtry&errorで様々な可視化を試した後に、最終結果をウェブで共有できる形式としてD3.jsへ書き出すことが出来ます。

同一データを様々な方式でレンダリングする

Tree(もしくは階層構造)は、現実のデータを扱う時に様々な場面で現れる形式です。プログラマの方なら、オブジェクト指向プログラミング自体が、抽象化のプロセスで世界を階層構造とみなすことにより行っていると感じておられるでしょう。ただし多くの場合は、きれいなツリーではなくDAG(Directed Acyclic Graph、つまり無閉路有向グラフ)になるでしょうが... この辺りのデータに興味のある方は、オントロジーなどを含むSemantic Web周辺のデータセットを覗いてみると面白いでしょう。

さて、書きだされたTreeデータを可視化する場合の最も典型的な例はこれでしょう:

treeview1

しかしこの表示方法がいつも適切かというとそうではありません。リンク情報が最も有用な場合もあれば、Treeで表現されるクラスタの大きさが見たい場合もあります。同じデータを様々な方式で眺めたいとき、D3のプリセットは威力を発揮します。一つのデータモデルから全く異なる出力結果を容易に得る事ができるのはD3.jsを利用する利点の一つです。D3.jsプロジェクト立ち上げにも関わっているJ. Heer教授の論文でも、これは可視化アプリケーションをデザインするときの一つのパターンとして形式化されています(2.9: Reference Model):

また実際の描画の中でも、各コンポーネントは独立してカスタマイズ可能なようになっており(例えば、グラフやTreeならノードの形、色など)、これも上の論文の中でパターン化された形式に従ってD3.jsはデザインされています(2.9: Renderer)。

そして、彼のもとで研究を行っていたM. Bostock氏のD3論文でも、上記の論文の思想のもとにD3.jsが設計してあることが窺えます:

D3.jsを使うということは、ある意味強制的にこういったパターンに従って書くようになるので、最初の学習曲線の山を超えるまではわかりにくく見える書き方も、実はこういう思想に基づいた合理的な方式だと気づくと思います。

(長くなりそうなので明日のエントリーに続きます。)

Day 21: 12/20/2013 D3.jsと周辺ツールによるデータの可視化 最終的なアプリケーションのデザイン

About

Sample code for D3.js layouts.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published