Graphviz プレビュー
DOT 言語で書いたグラフを、Graphviz でその場で描く無料ツール。
dot・neato などのレイアウトを切り替えられ、日本語のラベルもはみ出さないように描きます。ブラウザの中だけで動くので、インストールは要らず、書いた文を外に送りません。SVG と PNG で保存できます。
左の欄に DOT の文を書くと、手を止めたところで右に図を描きます。
サンプルから、処理の流れ・無向グラフ・グループ分け・表の形(record)・HTML 風のラベル・状態遷移・組織図を選べます。
レイアウトの方式(dot・neato・fdp・sfdp・circo・twopi・osage・patchwork)は、上の欄で切り替えます。
Graphviz プレビューの機能と特徴
Graphviz とは
Graphviz は、オープンソースのグラフの描画のソフトウェアです。DOT という文で書いたグラフから、ノード(箱や丸)と線の配置を自動で決めて、SVG などの図にします。
プログラムの依存関係、状態遷移、組織図、ネットワークの構成など、「点と線」で表せるものに向いています。
このツールは、Graphviz 14.1.1 をブラウザで動くようにした Viz.js を使っています。PlantUML プレビュー が図の配置に使っているものと同じです。
DOT の書き方の基本
DOT は、グラフの種類を決めてから、{ } の中にノードと線を並べて書きます。サンプルにも同じ書き方を入れてあります。
名前に日本語を使うときは、引用符で囲まなくても書けます。空白や記号を含む名前は "…" で囲みます。
| 書き方 | 意味 |
|---|---|
digraph 名前 { … } | 向きのあるグラフ(線は ->) |
graph 名前 { … } | 向きのないグラフ(線は --) |
A -> B [label="文"]; | A から B への線と、線のラベル |
A [shape=box, label="文"]; | ノードの形と表示する文 |
rankdir=LR; | 左から右へ並べる(既定は上から下) |
subgraph cluster_名前 { … } | 名前が cluster で始まると、枠で囲んだグループになる |
{rank=same; A B} | A と B を同じ高さにそろえる(dot のとき) |
// 文 | コメント(/* … */ も使えます) |
レイアウトの方式と使い分け
同じ DOT の文でも、レイアウトの方式で配置が変わります。説明は Graphviz の公式の説明をもとにしています。
DOT の文の中に layout=neato のように書くと、画面の選択より文の中の指定が優先されます(公式の説明のとおり)。
線の多い大きなグラフは、dot では計算に時間がかかります(このツールで試すと、ノード300個・線600本で約30秒)。20秒を過ぎたら止めるので、そのときは sfdp か neato を試してください。
| 方式 | 描き方 | 向いているもの |
|---|---|---|
| dot | 向きのあるグラフを、階層(層)にして描く | 処理の流れ・依存関係・組織図 |
| neato | ばねモデルで配置する | 向きのない小さめのグラフ |
| fdp | 力学モデル(Force-Directed Placement)で配置する | グループ(cluster)を含むネットワーク |
| sfdp | fdp を大きなグラフ向けにしたもの | ノードや線の多いグラフ |
| circo | 円の形に並べる | 輪になったつながり |
| twopi | 中心から放射状に並べる | 1つを中心にしたつながり |
| osage | グループ(cluster)を並べて描く | グループ分けが主なもの |
| patchwork | グループを面積の図(ツリーマップ)にする | 大きさの割合を見るもの |
日本語のラベルがはみ出す理由と、このツールでの直し方
ブラウザで動く Graphviz は、字の幅を本物の字体で測れないので、表で推し量ります。このツールで測ったところ、日本語の字は1字を0.75字ぶんの幅と数えていました。
そのままでは、箱や線のラベルの場所が実際の字より4分の1ほど狭くなり、日本語のラベルが箱からはみ出します。ブラウザで動く Graphviz を使うほかのエディタでも、同じことが起きることがあります。
このツールは、描く前に日本語の字の幅の見積もりを1字ぶんに直し、描いたあとで元に戻しています。ノードの名前、線のラベル、グループの見出し、表の形のラベルのどれでも効きます。保存する SVG にも余計な字は残りません。
SVG の字は、開いたパソコンの字体で表示されます。字の形まで決めたいときは、PNG で保存してください。
PlantUML・Mermaid との使い分け
外に送らないこと・使えないもの
図はブラウザの中で描き、書いた文は外のサーバーに送りません。書いた文は、続きから書けるよう、このブラウザの中にだけ残します。
ブラウザの中ではファイルを読めないので、画像のファイルを入れる image 属性は使えません。図の中の URL・href のリンクは、プレビューでは押しても開きません(保存する SVG には残ります)。
Graphviz プレビューに関するよくある質問
日本語のラベルは、本当にはみ出しませんか?
幅の見積もりを1字ぶんに直してから描くので、ふつうの字体なら箱の中に収まります。
字体によっては、字の幅がわずかに違うので、少し余白ができることがあります。
Python の graphviz や dot コマンドで作った DOT も描けますか?
描けます。DOT の文を貼り付けてください。
このツールは Graphviz 14.1.1 で描くので、手元の Graphviz と版が違うと、配置が同じにならないことがあります。
レイアウトを選んでも、配置が変わりません。
DOT の文の中に
layout=…があると、そちらが優先されます。そのときは、画面にも知らせを出します。文の中の
layoutを消すと、画面の選択で切り替えられます。大きなグラフが描けません。
配置の計算が20秒を過ぎたら止めます。線の多い大きなグラフは、dot より sfdp や neato のほうがずっと速く描けます。
PNG は、1辺 8,192px と面積の上限に収まるよう、縮めて保存します。
保存した SVG を別のパソコンで開くと、字の形が変わります。
SVG の字は、開いたパソコンの字体で表示されるためです。字の形を固定したいときは、PNG で保存してください。
書いた文はどこかに保存されますか?
このブラウザの中にだけ保存し、外には送りません。「クリア」を押すと消えます。
Graphviz プレビューの使い方
-
DOT の文を書く
左の欄に DOT の文を書きます。サンプルを選ぶと、書き方の例が入ります。
-
レイアウトを選ぶ
上の欄で、dot・neato などのレイアウトの方式を選びます。図はその場で描き直されます。
-
保存する
「SVG で保存」か「PNG で保存」を押します。「SVG をコピー」で、SVG の文をそのまま貼り付けることもできます。
カテゴリ デザイン