メインコンテンツへスキップ

Graphviz プレビュー

DOT 言語で書いたグラフを、Graphviz でその場で描く無料ツール。

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)を含むネットワーク
sfdpfdp を大きなグラフ向けにしたものノードや線の多いグラフ
circo円の形に並べる輪になったつながり
twopi中心から放射状に並べる1つを中心にしたつながり
osageグループ(cluster)を並べて描くグループ分けが主なもの
patchworkグループを面積の図(ツリーマップ)にする大きさの割合を見るもの

日本語のラベルがはみ出す理由と、このツールでの直し方

ブラウザで動く Graphviz は、字の幅を本物の字体で測れないので、表で推し量ります。このツールで測ったところ、日本語の字は1字を0.75字ぶんの幅と数えていました。

そのままでは、箱や線のラベルの場所が実際の字より4分の1ほど狭くなり、日本語のラベルが箱からはみ出します。ブラウザで動く Graphviz を使うほかのエディタでも、同じことが起きることがあります。

このツールは、描く前に日本語の字の幅の見積もりを1字ぶんに直し、描いたあとで元に戻しています。ノードの名前、線のラベル、グループの見出し、表の形のラベルのどれでも効きます。保存する SVG にも余計な字は残りません。

SVG の字は、開いたパソコンの字体で表示されます。字の形まで決めたいときは、PNG で保存してください。

PlantUML・Mermaid との使い分け

どれも文から図を描く仕組みですが、得意なものが違います。

  • UML(シーケンス図・クラス図など)をきちんと描くなら PlantUML
  • GitHub などの Markdown にそのまま書いて見せたいなら Mermaid
  • ノードと線の配置を、レイアウトの方式や rank・cluster で細かく決めたいなら Graphviz

外に送らないこと・使えないもの

図はブラウザの中で描き、書いた文は外のサーバーに送りません。書いた文は、続きから書けるよう、このブラウザの中にだけ残します。

ブラウザの中ではファイルを読めないので、画像のファイルを入れる 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 プレビューの使い方

  1. DOT の文を書く

    左の欄に DOT の文を書きます。サンプルを選ぶと、書き方の例が入ります。

  2. レイアウトを選ぶ

    上の欄で、dot・neato などのレイアウトの方式を選びます。図はその場で描き直されます。

  3. 保存する

    「SVG で保存」か「PNG で保存」を押します。「SVG をコピー」で、SVG の文をそのまま貼り付けることもできます。

カテゴリ デザイン