コース目次
アカデミーモジュール 2 · ナレッジグラフの構築と管理
グラフ操作：絞り込み、検索、書き出し
このレッスンで学ぶこと
- 「表示設定」で「詳細」、孤立ノード、コードレイヤー、「種類別に色分け」、「最小接続数」を調整できる
- 「グラフ内を検索」でグラフを検索し、キーボードから一致項目を順番に移動できる
- リセットボタンを使い、分離表示の階層を1段ずつ戻せる
- 効果、品質、速度を選び、グラフ全体をPNG、ループGIF、動画として書き出せる
数週間使い続け、グラフが大きくなりました。ゆっくり回転するノードの雲のどこかに、本当に見たいハブがいくつかあります。それだけを画面に残したいところです。明日のスライド用には、グラフ全体が滑らかにループする映像も必要です。
どちらも、グラフキャンバスに浮かぶ小さな操作群から行えます。このレッスンでは、3つのフローティングボタンから、グラフをPNG、GIF、動画として保存するダイアログまで、すべてを扱います。
3つのフローティングボタン
グラフの操作部は邪魔にならないよう、上部の両隅に置かれています。一方には、回転、パン、ズームのマウス操作を示す3行のヒントがあります。もう一方には、FAB（フローティングアクションボタン）と呼ばれる3つの丸いボタンがあります。
| ボタン | ツールチップ | 機能 |
|---|---|---|
| 円形の矢印 | 「ホームビューに戻す」 | グラフ全体が収まるように表示を戻します。分離表示、コレクション、テーマへのフォーカス中は、代わりにその階層を1段戻します |
| 目のアイコン | 「表示設定」 | 表示に関するすべての調整、リアルタイム統計、書き出し操作をまとめた設定ドロップダウンを開きます |
| 重なった四角形 | 「コレクション」 | コレクションのポップオーバーを開きます。コレクションを投影中は件数バッジも表示されます |
操作部は薄くなるだけで、消えたわけではありません
ドラッグやズーム中、カードを開いている間、スクロールした直後は、ヒントとFABが薄くなります。
操作を止めるかカードを閉じると、すぐに元へ戻ります。
「表示設定」の中身
目のFABをクリックすると、ひとつのコンパクトなドロップダウンが開きます。キャンバスに何を表示するかをすべてここで制御でき、各項目の役割は明確です。
| 設定 | 初期値 | 機能 |
|---|---|---|
| 「詳細」スライダー | 0.7 | 表示する情報量をひとつのつまみで調整します。上げるほどラベルが増え、奥行きの霞が弱くなります。最大にすると、表示範囲内の全ラベルが描画されます |
| 「孤立ノードを表示」 | オン | 接続のないノードを表示または非表示にします |
| 「コードを表示」 | オン | ソースファイルのノードとコードのエッジから成るコードレイヤーをオンまたはオフにします |
| 「種類別に色分け」 | オフ | 人物、組織、場所など、エンティティの種類ごとに色を付けます。種類が未設定のエンティティは中立色のままです |
| 「最小接続数」 | 「オフ」（0） | 表示中のエッジが指定数に満たないエンティティを隠します（値は「≥ N」で表示）。密なグラフをハブだけに絞り込めます |
| 「マップモード」 | オフ | テーマごとに1つのノードへグラフをまとめます。トピックマップが作成済みの場合だけ表示されます |
トグルの下には、「ノード」、「エッジ」、「テーマ」、「孤立」のリアルタイム統計と、2つの操作があります。「画像または動画として保存」は書き出しダイアログを開き、「すべての設定をリセット」は上記の初期値に戻します。
5本のスライダーではなく、ひとつのつまみ
以前のビルドには「広がり」「孤立ノードの広がり」「ラベル範囲」「奥行きフォグ」など、個別のスライダーがありました。現在はレイアウトが自動調整されるため、表示のつまみは「詳細」だけです。
古いガイドに物理演算用スライダーが出てくるのに、いまの画面で見つからないのはそのためです。
「グラフ内を検索」とリセットボタン
グラフタブを開いた状態で⌘Fを押すと、タイトルバーの検索欄が「グラフ内を検索」に変わります。入力すると一致するノードが脈動し、一致しないエッジが暗くなり、件数が「n/m」で表示されます。入力しただけでカメラが動くことはありません。
Mod+Shift+G open / toggle the Knowledge graph tab
Cmd/Ctrl+F "Find in graph" (while the graph tab is active)
Enter fly to the next match (wraps around)
Shift+Enter fly to the previous match (wraps around)
Esc clear search / close popoversリセットボタン（「ホームビューに戻す」）は、押すたびに1段ずつ戻ります。テーマを掘り下げていればテーママップへ、コレクション内のメンバーを掘り下げていればコレクション全体へ戻り、そこからさらにグラフ全体へ戻ります。拡大したまま迷ったときは、もう一度押してください。
「コレクション」ボタンの要点
重なった四角形のFABは、「コレクション」ポップオーバーを開きます。コレクションとは、ルールで定義して保存したエンティティの集合です。
保存済みの行をクリックすると、その集合がキャンバスへ投影されます。メンバーだけが分離表示され、「種類別に色分け」が自動的にオンになります（解除すると以前の設定へ戻ります）。投影中はFABに件数バッジが付き、ポップオーバーには「適用中 · {count}」バナーと「クリア」ボタンが表示されます。コレクションを定義するルールの書き方は、別のレッスンで扱います。
- FAB
- フローティングアクションボタン。グラフキャンバス上に浮かぶ、小さな丸いボタンです。
- 詳細
- 表示する情報量を調整する唯一のつまみ（0〜1）。上げるほどラベルが増え、奥行きのフォグが弱くなります。
- 孤立ノード
- 接続を持たないノード。「孤立ノードを表示」で表示・非表示を切り替えます。
- 最小接続数
- 指定した接続数に満たないエンティティを隠し、ハブだけを残すフィルターです。
- マップモード
- テーマごとに1つのスーパーノードへグラフをまとめる表示です。
- コレクション
- 現在のグラフに対して毎回ルールを再評価する、変化し続けるエンティティ集合の保存済みレシピです。
「画像または動画として保存」
「表示設定」の下部にある「画像または動画として保存」を押すと、「ナレッジグラフを保存」ダイアログが開きます。グラフ全体（ノード、接続、ラベル）を静止画またはループアニメーションとして書き出せます。最初に3つの形式カードが並びます。
| 形式 | 書き出されるもの | 適した用途 |
|---|---|---|
| 「画像」 | 「1枚の静止画（PNG）。」「背景色を含める」をオフにすると透過PNGになります | 文書、スライド、印刷 |
| 「GIF」 | 「継ぎ目なくループする1回転。どこでも再生できます。」 | チャットやREADMEなど、動画を埋め込めない場所 |
| 「動画」 | 「ループする1回転。GIFより小さく鮮明です。」macOSではmp4、それ以外ではwebm | 鮮明さが必要なプレゼンテーションや投稿 |
- 「効果」（アニメーションのみ）：ターンテーブルは単純な回転。初期値のオービットは斜めに傾いた軌道で回ります。ブリーズはカメラを前後に動かします。パルスはグラフ全体を脈動させます。ショーケースはオービットとパルスを組み合わせます。
- 「品質」：オリジナル／高／中／小。オリジナルはライブビューと同じです。高、中、小は長辺をそれぞれ1600、1080、720 pxへ縮小し、ファイルを軽くします。
- 「速度」（アニメーションのみ）：遅い／標準／速い。1回転あたり10秒、6秒、3秒です。
- 「フレームレート」（動画のみ）：24、30、60 fps。初期値は30です。
- 「背景色を含める」（PNGのみ、初期値はオン）：グラフの背後をライトまたはダークのキャンバス色で塗ります。アニメーションには常に背景が含まれます。
どのアニメーションも、見える継ぎ目なくループするよう、ちょうど1回転分を描画します。保存中は「フレームを描画中 {done}/{total}…」、続いて「エンコード中…」と表示されます。初期ファイル名はknowledge-graphです。
最初のグラフループを書き出す
- ⌘⇧G（またはタイトルバーのウェイポイントボタン）でグラフを開きます。
- 目のFABをクリックし、「画像または動画として保存」を選びます。
- 「GIF」カードを選び、「効果」をショーケース、「速度」を標準にします。
- 「保存」を押し、保存先を選びます。
「フレームを描画中 {done}/{total}…」、続いて「エンコード中…」と表示され、軌道移動と脈動が継ぎ目なく1周するナレッジグラフのGIFが保存されます。
巨大なグラフを3つの操作で絞り込む
設定を組み合わせます。ハブだけが残るまで「最小接続数」を上げ、残ったラベルがすべて表示されるよう「詳細」を最大にしてから、⌘Fを押し、Enterでハブからハブへ移動します。
1,000ノードの雲が、見たかったノードだけを巡るガイドツアーに変わります。
操作面の全体像はこれだけです。3つのボタン、1つのドロップダウン、1つの検索欄、1つの書き出しダイアログ。この組み合わせで、1,000ノードの絡まりを、画面上でもファイルでも、必要な図へ変えられます。次は、元のファイルが変わるたびにグラフが最新状態を保つ仕組みを見ていきます。