マトリックス / クアドラントダイアグラム

マトリックスダイアグラムについて

マトリックスダイアグラムは、2つの交差する軸によって定義される二次元空間にアイテムを配置します——最も一般的なのは2×2のクアドラントグリッド——位置によって一目で意味が伝わります。プロダクトマネージャーはアイゼンハワーマトリックスを使用して緊急な仕事と重要な仕事を分けます。戦略コンサルタントはBCGマトリックスを使用してポートフォリオ投資を配分します。HRチームは9ボックスグリッドを使用してパフォーマンスとポテンシャルをマッピングします。この視覚的な慣習は、ボストンコンサルティンググループの1970年代のポートフォリオ研究に端を発し、Ansoff、Johari、RICEなどのフレームワークによって拡張されてきました。

Schematex は3つのマトリックスモードをサポートします：quadrant（ラベル付き軸を持つ2×2または3×3のバブルプロット）、heatmap（N×Mの色付きセルグリッド）、correlation（N×Mのドット強度テーブル）。8つのプリビルドテンプレートが最も一般的なフレームワークをすぐに使える形でカバーし、すべての軸ラベル、クアドラント名、ポイントプロパティは完全にカスタマイズ可能です。

1. 最初のマトリックス

最小限の有用なマトリックス：カスタム2×2、2つのラベル付き軸、3つのポイント。

使用方法の80%をカバーする4つのルール：

1. キーワード matrix で始め、オプションでテンプレート名または引用符付きのタイトルを続けます。
2. x-axis: と y-axis: で軸を設定します——または組み込みテンプレートを使用してこのステップを省略します。
3. 各ポイントは "Label" at (x, y) です。x と y は0.0（低/左/下）から1.0（高/右/上）の小数分数です。
4. 座標の後にオプションのプロパティを追加します——size:、category:、color:、shape:、highlight:。

コメントは行のどこでも（引用符付き文字列の外で）# で始まります。

2. 組み込みテンプレート

テンプレートは軸、クアドラントラベル、グリッドサイズをプリ設定します。ヘッダー行の2番目のトークンとしてテンプレート名を使用するだけです。

テンプレートの軸とクアドラントラベルは、明示的な x-axis: / y-axis: / quadrant ディレクティブで上書きできます。

3. 軸

軸ラインは各次元の意味的な極を宣言します。

x-axis: Low Effort → High Effort
y-axis: Low Value → High Value

矢印は低ラベル（左/下）と高ラベル（右/上）を区切ります。以下のセパレーターはすべて同等です：

逆軸は「高い」値が左または下にある慣習のためのものです：

x-axis: High Market Share ← Low Market Share

4. ポイント

各ポイントは正規化された（x, y）座標ペアで位置決めされたバブルです。

"Label" at (x, y)
"Label" at (x, y) size: 4 category: design color: #7B1FA2 highlight: true note: "clarify spec"

[0, 1] の外の座標はチャート境界にクランプされ、バッジでフラグ付けされます——元の値はツールチップ表示のために保存されます。

5. クアドラントラベル

各クアドラントに名前とオプションのサブタイトルでラベルを付けます。

quadrant Q1 "Do First"
quadrant Q2 "Schedule"
quadrant Q3 "Delete"
quadrant Q4 "Delegate"

# オプションのサブタイトル付き：
quadrant Q1 "Do First" description: "High urgency, high importance"

クアドラントの番号付けは標準的な数学の慣習に従います：Q1 = 右上、Q2 = 左上、Q3 = 左下、Q4 = 右下。Q プレフィックスはオプションです——quadrant 1 "Label" も同様に有効です。

6. ヒートマップモード

ヒートマップモードは、バブル位置をプロットする代わりに N×M セルをカラー強度で塗りつぶします。

matrix heatmap 4x3 "Skill Matrix"
rows: [Strategy, Execution, Communication, Technical]
cols: [Junior, Mid, Senior]

cell (0,0) level: weak
cell (1,0) level: medium
cell (2,0) level: strong
cell (0,1) value: 7
cell (1,2) label: "Top 10%"

• matrix heatmap COLxROW — ヘッダーでグリッドの次元を設定。
• rows: と cols: — カンマ区切りまたはブラケットリストの軸ラベル。
• cell (col, row) — ゼロインデックス、列が先、行が後（行0 = 下）。
• level: — strong（3）、medium（2）、weak（1）——熱強度のショートハンド。
• value: — 明示的な数値（level: を上書き）。
• label: — セル内に配置される引用符付きテキスト。

7. 相関モード

相関モードは、行と列の変数間の関係の強さを表す強度でN×Mドットマトリックスをレンダリングします。

matrix correlation 4x4 "Product Metrics"
rows: [DAU, Retention, Revenue, NPS]
cols: [DAU, Retention, Revenue, NPS]

cell (0,0) value: 1
cell (1,0) value: 0.82
cell (2,0) value: 0.54
cell (3,0) value: 0.71

同じ cell 構文が適用されます。相関モードでも level: strong | medium | weak が受け入れられます。

8. SIPOCモード

SIPOC は、Six Sigma DMAICプロジェクトのDefineフェーズを開始する1ページのスコープテーブルです。5つの固定された列に、左から右にプロセスが関与するすべての人とものを記述します：Suppliers（供給者）・Inputs（投入物）・Process（プロセス）・Outputs（産出物）・Customers（顧客）。チームが何かを測定または改善する前に、SIPOCは境界を定めます——「このプロセスはどこから始まり、どこで終わり、誰が仕事を受け渡しするのか」。

matrix sipoc "Order fulfilment"
suppliers: "Vendor", "Warehouse"
inputs: "PO", "Stock levels"
process: "Receive order", "Pick", "Pack", "Ship"
outputs: "Shipped package", "Invoice"
customers: "End customer", "Finance"

• matrix sipoc で始め、オプションで引用符付きのタイトルを続けます。
• 5つの列それぞれが独自のディレクティブです：suppliers:、inputs:、process:、outputs:、customers:。
• コロンの後に、カンマ区切りの引用符付き文字列としてエントリを列記します。列は任意の数のエントリを持てます。行はその列内で上から下にスタックされます。
• process: 列は高レベルのステップシーケンスです（通常4〜7ステップ）——詳細なフローチャートではなく主要な段階だけにします。

5つの列は、宣言した順序に関わらず、常に正規のS-I-P-O-Cの順序でレンダリングされます。そのため、LLMがブロックを順序外で出力しても、ダイアグラムは正しく読めます。

9. QFDモード（品質の家）

品質機能展開（QFD） ——赤尾洋二が導入した品質の家——は顧客が求めるものをそれを実現するエンジニアリング特性に変換します。行はWHAT（顧客要件、それぞれに重要度の重みを持つ）；列はHOW（チームが制御する測定可能なエンジニアリング特性）。グリッドの本体には各HOWが各WHATにどれだけ強く貢献するかを記録します。

差別化要因は：エンジンが下の行を計算することです。各HOWの技術的重要度は、その列の 重み × 関係の強さ の合計です——「どのエンジニアリング特性が最も顧客価値を動かすか、したがって最も努力を注ぐ価値があるか」への順位付けされた答えです。そして家の屋根——列の上の半行列のダイヤモンドセル——は2つのHOWが互いに助け合うか妨げ合うかを記録します。

matrix qfd "Coffee maker"
what: "Quiet operation" weight: 5
what: "Brews fast" weight: 3
what: "Energy efficient" weight: 4
how: "Fan RPM" dir: down
how: "Heater watts" dir: up
how: "Insulation" dir: up
rel (0,0): 9
rel (0,2): 3
rel (1,1): 9
rel (2,1): 3
rel (2,2): 9
roof (0,1): --
roof (1,2): +

WHATとHOW

関係セル

rel (i, j): strength は列 j のHOWが行 i のWHATにどれだけ強く貢献するかを記録します。インデックスは**（行、列）**、どちらもゼロベース。

この9 / 3 / 1スケールはQFDの慣習です：重要度行が合計されたとき、1つの強いリンクが複数の弱いリンクを上回るように意図的に非線形にされています。

計算される技術的重要度行

エンジンは各列を合計して家の下部に技術的重要度行を生成します：

importance(j) = Σ 行i について  ( weight(i) × strength(i, j) )

上記のコーヒーメーカーの例では、この行は 45 / 39 / 51 と計算されます——Insulation（51）が最も高いレバレッジ特性、Heater watts（39）が最低。このランキングが成果物です：チームがエンジニアリング努力を注ぐべき場所を示します。

normalize: true（ブロック内の任意の行に独立した行として）を追加すると、各列が生の合計の代わりに合計に対するパーセンテージとして表示されます——この例では 33% / 29% / 38%。パーセンテージにより、非常に異なる重みスケールにわたる相対的な優先度が読みやすくなります。

屋根——HOW × HOW相関

屋根は列の上にある三角形の半行列です。roof (i, j): glyph はHOW i とHOW j が互いに強化し合うか対立するかを記録します——チームが調整しなければならない相乗効果とトレードオフ。

各屋根エントリは標準QFDの傾斜屋根グリッドのダイヤモンドセルとしてレンダリングされます。例では、roof (0,1): -- がFan RPMを下げながらHeater wattsを上げることがトレードオフであることを示し、roof (1,2): + がHeater wattsとInsulationが互いに強化し合うことを示します。

10. パネットモード（メンデル遺伝学）

パネット方形は遺伝交配の子孫を予測します。2つの親の遺伝子型を書くだけで、エンジンがメンデルの計算を行います——各親の配偶子（遺伝子座ごとに1つの対立遺伝子）を列挙し、グリッドをすべての配偶子の組み合わせで埋め、遺伝子型と表現型の比率を計算します。ユーザーがグリッドを埋める必要はありません。

matrix punnett "Eye color  (Bb × Bb)"
cross: Bb x Bb
trait B: "Brown eyes" / "Blue eyes"

交配

対立遺伝子の大文字・小文字が優性を決定します ——これは標準的な遺伝学の慣習です。大文字の文字が優性対立遺伝子、一致する小文字が劣性です。遺伝子型は文字ごとに対立遺伝子をグループ化します：RrYy は2つの遺伝子座、R/r（丸/しわ）と Y/y（黄/緑）。1つの遺伝子は単性雑種交配（2×2グリッド）、2つの遺伝子は二性雑種（4×4）、3つは三性雑種（8×8）です。

計算される比率（差別化要因）

エンジンは遺伝子型のみから以下を導出します：

• 各親の配偶子——列と行のヘッダー——各遺伝子座で1つの対立遺伝子を取ることで（ヘテロ接合体 Bb は B と b を生成）；
• 子孫グリッド——すべての配偶子のペア、優性対立遺伝子を先に書く（Bb、bB ではない）；
• 表現型比率——どの表現型を発現するかでグループ化されたボックス、最小公倍数に約分。単性雑種 Bb × Bb は古典的な 3:1 を与え、二性雑種 RrYy × RrYy は有名な 9:3:3:1 を与える；
• 遺伝子型比率——例えば単性雑種では 1:2:1（BB 1、Bb 2、bb 1）。

各ボックスはその表現型クラスで色付けされ、フッターには表現型比率（凡例付き）と遺伝子型比率が記載されます。

11. 設定オプション

config: ブロックは視覚的なレンダリングを調整します。各オプションは config: ヘッダーの下の独自のインデントされた行に記述します。

config:
  quadrantBg: true
  gridLines: true
  axisArrows: true
  bubbleScale: area
  legendPosition: bottom-right

2つのショートハンドディレクティブはトップレベルでも機能します（config: ブロック内でなく）：

axis: off          # off | on | auto — 軸ラインの表示・非表示
margins: true      # true | false — スコアとランクのマージンを表示（相関モード）

12. ラベルとコメント

• タイトル： matrix "My Title" または独立した行として title: My Title。
• ポイントラベル： at (…) の前の引用符付き文字列。
• 軸ラベル： x-axis: と y-axis: ディレクティブ。
• クアドラントラベル： quadrant Q1 "Name" ディレクティブ。
• コメント： 引用符付き文字列の外で行のどこでも #。

matrix "Prioritization"
# これはコメントです
x-axis: Low Cost → High Cost   # ディレクティブの後のインラインコメント
"Fix bug" at (0.1, 0.9) size: 3  # ポイントの後のコメント

13. テーブルモード（style: table）

デフォルトのマトリックスレンダリングは散布図 / バブルチャートです——ポイントが（x, y）座標に浮かんでいます。アウトプットがクアドラントごとにアイテムをグループ化したリストになるフレームワーク（Eisenhower、Johari、Impact-Effort、9-box）では、style: table を使用してテキストインセルレイアウトに切り替えます。

matrix eisenhower "This Week"
style: table
Q2: "Ship hotfix"
Q2: "Customer demo prep"
Q1: "Write Q3 OKRs"
Q1: "Refactor auth layer"
Q4: "LinkedIn updates"
Q3: "Reorganize Slack channels"

style: table はこれらの変更を自動的に適用します：

Q1〜Q4 ショートハンド（2×2のみ）

2×2テンプレートでは、より長い cell (col, row) label: "item" 形式の代わりに Qn: "item" を使用します。マッピング：

同じクアドラントに複数のアイテムを追加するにはショートハンドキーを繰り返します：

Q2: "Ship hotfix"
Q2: "Customer demo prep"

3×3グリッド（9-box）では、cell (col, row) label: "…" を直接使用します——Q ショートハンドは2×2専用です。

テーブルと散布図の使い分け

14. 予約語とエスケープ

行頭で予約： matrix（ヘッダー）、x-axis:、y-axis:、quadrant、config:、title:、rows:、cols:、grid:、axis:、margins:、cell。SIPOC モードでは：suppliers:、inputs:、process:、outputs:、customers:。QFD モードでは：what:、how:、rel、roof、normalize:。

ポイント行はクォート文字（" または '）で始まる必要があります。 クォートで始まらない行はポイントとして扱われません。

軸ラベルのスペースを含む文字列はクォート不要です——コロンの後（および矢印の後）のテキストはそのまま取られます。ポイントプロパティの note: と label: ではダブルクォートを使用します。

15. よくある間違い

16. 文法（EBNF）

document     = header directive*

header       = "matrix" ( template-name | mode-header | title )? NEWLINE
template-name = "eisenhower"|"impact-effort"|"rice"|"bcg"|"ansoff"|"johari"|"9-box"|"risk-matrix"
mode-header  = ( "heatmap" | "correlation" ) ( number "x" number )? title?
             | ( "sipoc" | "qfd" | "punnett" ) title?
title        = quoted-string | bare-text

directive    = x-axis | y-axis | quadrant-dir | config-block
             | point | cell | q-short | rows-dir | cols-dir | grid-dir
             | style-dir | title-dir | axis-dir | margins-dir
             | sipoc-col | qfd-what | qfd-how | qfd-rel | qfd-roof | normalize-dir
             | punnett-cross | punnett-trait
             | comment | blank

# SIPOCモード
sipoc-col    = ( "suppliers:" | "inputs:" | "process:" | "outputs:" | "customers:" )
               WS quoted-string ( "," quoted-string )* NEWLINE

# QFD / 品質の家モード
qfd-what     = "what:" WS quoted-string WS "weight:" number NEWLINE
qfd-how      = "how:" WS quoted-string ( WS "dir:" ( "up" | "down" ) )? NEWLINE
qfd-rel      = "rel" WS "(" number "," number ")" ":" WS ( "9" | "3" | "1" ) NEWLINE  # (行, 列)
qfd-roof     = "roof" WS "(" number "," number ")" ":" WS ( "++" | "+" | "-" | "--" ) NEWLINE  # (how, how)
normalize-dir = "normalize:" WS "true" NEWLINE

# パネット（メンデル遺伝学）モード
punnett-cross = ( "cross:" | "parents:" ) WS genotype WS ( "x" | "×" | "*" ) WS genotype NEWLINE
punnett-trait = "trait" WS letter ":" WS quoted-string WS "/" WS quoted-string NEWLINE  # 優性 / 劣性
genotype     = ( letter letter )+   # 文字でグループ化された対立遺伝子ペア；大文字・小文字 = 優性、例：「RrYy」

x-axis       = "x-axis:" WS axis-spec NEWLINE
y-axis       = "y-axis:" WS axis-spec NEWLINE
axis-spec    = text arrow text  |  text   # プレーンテキスト → 高ラベルのみ
arrow        = "→" | "->" | "↑" | "←" | "<-" | "<" | "↓"

quadrant-dir = "quadrant" WS "Q"? digit WS quoted-string ( WS "description:" quoted-string )? NEWLINE

config-block = "config:" NEWLINE ( INDENT key ":" WS value NEWLINE )*

point        = quoted-string WS "at" WS "(" number "," number ")" ( WS point-prop )* NEWLINE
point-prop   = "size:" number
             | "category:" bareword
             | "color:" hex-color
             | "shape:" ( "circle"|"square"|"triangle"|"diamond" )
             | "highlight:" "true"
             | "note:" quoted-string
             | "label:" quoted-string

cell         = "cell" WS "(" digit "," digit ")" ( WS cell-prop )* NEWLINE
cell-prop    = "value:" number
             | "label:" quoted-string
             | "level:" ( "strong" | "medium" | "weak" )

style-dir    = "style:" WS "table" NEWLINE
q-short      = "Q" ( "1" | "2" | "3" | "4" ) ":" WS quoted-string NEWLINE   # 2×2のみ

rows-dir     = "rows:" WS label-list NEWLINE
cols-dir     = "cols:" WS label-list NEWLINE
grid-dir     = "grid:" WS number "x" number NEWLINE
axis-dir     = "axis:" WS ( "off" | "on" | "auto" ) NEWLINE
margins-dir  = "margins:" WS ( "true" | "false" | "on" | "1" ) NEWLINE

label-list   = "[" text ("," text)* "]" | text ("," text)*
quoted-string = '"' any-char-but-quote* '"' | "'" any-char-but-quote* "'"
comment      = "#" any NEWLINE

権威ある情報源：src/diagrams/matrix/parser.ts。これがパーサーと異なる場合はパーサーが優先されます——Issueを立ててください。

17. 標準への準拠

Schematex のマトリックスダイアグラムは、ボストンコンサルティンググループ（1970）、アイゼンハワー意思決定マトリックス、アンソフ成長マトリックス、ジョハリの窓フレームワークで使用される標準的な2×2クアドラント慣習を実装しています。9ボックスグリッドはマッキンゼー/GEタレントレビュー慣習（3×3、パフォーマンス × ポテンシャル）に従います。ヒートマップと相関モードは特定の外部標準に従いませんが、ExcelのCondtional FormattingやRの corrplot などのツールに見られる普遍的なセル強度エンコーディングを使用しています。

現在実装されているもの：

• ✅ カスタム軸とクアドラントラベルを持つ2×2クアドラントモード
• ✅ 3×3クアドラントモード（9-box テンプレート）
• ✅ level: と value: セルを持つN×Mヒートマップモード
• ✅ N×M相関モード
• ✅ SIPOCモード——5列のSuppliers · Inputs · Process · Outputs · Customersスコーピングテーブル（Six Sigma DMAICのDefine）
• ✅ QFD / 品質の家モード——WHATs × HOWsグリッド、9 / 3 / 1関係スケール、計算済み技術的重要度行（normalize: true でパーセンテージ表示）、HOW × HOW相関屋根（++ / + / - / --）
• ✅ パネットモード——2つの親の遺伝子型からのメンデル交配；エンジンが配偶子、子孫グリッド、遺伝子型 + 表現型比率（単性雑種3:1、二性雑種9:3:3:1）を計算；対立遺伝子の大文字・小文字 = 優性；オプションの trait 表現型名；単性雑種/二性雑種/三性雑種（2×2 / 4×4 / 8×8）
• ✅ 8つの組み込みテンプレート（eisenhower、impact-effort、rice、bcg、ansoff、johari、9-box、risk-matrix）
• ✅ ポイントプロパティ：size、category、color、shape、highlight、note
• ✅ 逆軸（← / <-）
• ✅ configブロック（quadrantBg、gridLines、axisArrows、bubbleScale、legendPosition、labelCollision、offChartPolicy）
• ✅ style: table ——Q1〜Q4 ショートハンド（2×2）とスタックされた箇条書きリストを持つテキストインセルレイアウト
• ⏳ ポイントの label: 上書き（パース済み、レンダラーのサポートは保留中）
• ⏳ オフチャートの drop ポリシー（パース済み、レンダラーは常に今日clamp-badge）
• ⏳ margins: 相関スコア/ランクサイドバー（パース済み、まだレンダリングされていない）

参考文献：

• Henderson, B. (1970). The Product Portfolio. Boston Consulting Group.
• Covey, S. (1989). The 7 Habits of Highly Effective People. （アイゼンハワーマトリックスの普及）
• Ansoff, H.I. (1957). "Strategies for Diversification." Harvard Business Review.
• Akao, Y. (1990). Quality Function Deployment: Integrating Customer Requirements into Product Design. Productivity Press.（品質の家）
• Pyzdek, T. & Keller, P. (2018). The Six Sigma Handbook (第5版). McGraw-Hill.（DMAICのDefineにおけるSIPOC）
• Punnett, R.C. (1905). Mendelism. Macmillan.（パネット方形）；Mendel, G. (1866). "Versuche über Pflanzenhybriden."

18. ロードマップ

計画中——まだパース不可。 今日生成された DSL ではこれらを使用しないでください。パーサーが拒否または無視します。

• スイムレーン / ゾーンオーバーレイ — グリッドの背後に描画された名前付き矩形ハイライト領域。
• 閾値ライン — ラベル付きの水平または垂直の参照ライン（例：「損益分岐点」ライン）。
• バブル内ラベル — ポイントラベルを横ではなくバブル内に印刷するオプション。
• テーブルへのエクスポート — スプレッドシートインポート用のSVGに加えた構造化CSV / JSONアウトプット。
• 4×4とカスタムラベルクアドラントモード — ヒートマップだけでなくクアドラント（バブルプロット）モードでもラベル付きセルを持つ任意のNxM。

これらが早期に必要な場合はGitHubのIssueでトラックしてください。

関連するサンプル

サンプルギャラリーからすぐに使えるシナリオ：