このドキュメントでは、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() という関数を含めることができます。 |
例:
説明 | 例 |
---|---|
ドットエンジンの例(デフォルト)。 |
|
同じグラフの Neo エンジンの例。 | cht=gv:neato |
サイズが指定されていないドットグラフ。グラフのサイズは自動的に調整されます。 | cht=gv |
より複雑なグラフです。 | cht=gv |
現在の GraphViz チャートのヒントと既知の制限事項は次のとおりです。
graph
属性size
は使用しないでください。代わりに、Chart API パラメータchs
を使用してください。- ノードの最大数は 200 で、エッジの最大数は 400 です。
- アンチエイリアス、透明度、代替フォントはサポートされていません。
node
属性のimage
とshapefile
はサポートされていないため、存在する場合はエラーになります。graph
属性のratio
、margin
、pad
はサポートされていないため、存在する場合は無視されます。