このドキュメントでは、Chart API を使って GraphViz グラフを作成する方法について説明します。
概要
GraphViz は、接続グラフを可視化するためのオープンソース ツールのパッケージです。DOT 言語と任意のレイアウト エンジンを使用して、GraphViz グラフを作成できます。
GraphViz グラフは、さまざまな必須パラメータ セットをサポートしています。サポートされているパラメータは次のとおりです。
パラメータ | 必須または任意 | 説明 |
---|---|---|
cht=gv[:<opt_engine>] |
必須 | GraphViz グラフを指定します。必要に応じて、GraphViz エンジンを指定できます。レイアウト エンジンを指定する場合は、セミコロン : マークを追加し、<opt_engine> に次のいずれかの文字列を指定します。
これらの各エンジンの説明については、GraphViz のウェブサイトをご覧ください。 |
chs=<width>x<height> |
任意 | サイズを指定しない場合、グラフのサイズは自動的に調整されます。 |
chl=<DOT_string> |
必須 | 描画するグラフ(DOT 言語表記)。DOT 言語リファレンスは、GraphViz のウェブサイトで確認できます。 |
chd |
未使用 | GraphViz コードは通常、chd パラメータを無視する点で珍しいものです。URL には含めないでください。 |
chof=<output_format> |
任意 | グラフの出力形式。サポートされている出力形式については、パラメータの説明を参照してください。chof=json を指定すると、グラフの JSON 表現が HTML イメージマップとして返されます。これを使用して、リンクやインタラクティビティをグラフに追加できます。詳しくは、グラフの画像マップの作成をご覧ください。 |
callback=<handling_function_name> |
任意 | chof=json を指定した場合、返された JSON (グラフの画像マップを含む)で呼び出す関数も指定できます。関数は、グラフの JSON 表現である単一の JSON パラメータを受け入れる必要があります。その後、ページでは、グラフを <img> 要素として指定してグラフをレンダリングできます。また、 chof=json&callback=somefunc を使用して同じ URL を呼び出し、返された JSON を解析してリンクまたはインタラクティビティを追加する somefunc() という関数を含めることができます。 |
例:
説明 | 例 |
---|---|
ドットエンジンの例(デフォルト)。 |
|
neato エンジンの例(同じグラフ)。 | cht=gv:neato |
サイズが指定されていないドットグラフ。 グラフのサイズは自動的に調整されます。 | cht=gv |
より複雑なグラフ。 | cht=gv |
現在の GraphViz グラフに関するヒントと既知の制限事項は次のとおりです。
graph
属性size
は使用しないでください。代わりに Chart API パラメータchs
を使用してください。- ノードの最大数は 200、エッジの最大数は 400 です。
- アンチ エイリアス、透明度、代替フォントはサポートされていません。
node
属性のimage
とshapefile
はサポートされていません。この属性が存在する場合は、エラーが発生します。graph
属性ratio
、margin
、pad
はサポートされていないため、存在する場合は無視されます。