Charts — Dependency Forest Chart — Semiotic

Home · Getting Started · Charts · Features · Playground

This page requires JavaScript for interactive chart demos.

AI / Machine-readable docs: llms.txt · llms-full.txt · Full AI Reference · schema.json · API Reference · Examples

View on GitHub · npx semiotic-ai for CLI access

Machine-readable page content

Canonical: https://semiotic.nteract.io/charts/dependency-forest-chart

Dependency Forest

charts

import { DependencyForestChart } from "semiotic/atlas"

Wraps: NetworkCustomChart

Display backbone, original residual edges and required paths. Prepare analysis once upstream with semiotic/atlas/core, then share the artifact across readers, JSON exports and static SVG.

Synthetic design fixtures. These stories demonstrate evidence handling, not production findings.

StoryAdd zero-capacity bypass

Do three suppliers provide three independent paths?

75% of allocation depends on X. Losing X creates a 70% shortfall; the independent-capacity target is 4,000 units/week.

Read chart interactions

Focus a mark with the arrow keys and press Space, or click a module. This readout subscribes through ObservationReadout to the chart’s ID inside LinkedCharts. The observation carries the canonical vertex and analysis revision for linked views and inspectors.

No mark activated yet.

Read the evidence

Inspect vertex

Required predecessors in the admitted directed graph, from the declared roots. Capacity is a separate measurement.
Vertex	Reading
world	{"target":"world","reachable":true,"dominatorIds":[]}
X	{"target":"X","reachable":true,"dominatorIds":["world"]}
A	{"target":"A","reachable":true,"dominatorIds":["world","X"]}
B	{"target":"B","reachable":true,"dominatorIds":["world","X"]}
C	{"target":"C","reachable":true,"dominatorIds":["world"]}
product	{"target":"product","reachable":true,"dominatorIds":["world"]}

Source revision: synthetic-suppliers:original. Selection and exported evidence retain the complete analysis identity.

Reachability and required paths do not establish usable transport capacity. A zero-capacity bypass changes topology, not supply.

Data dictionary and independent inputs

{ "id": "supplier-redundancy-v1", "synthetic": true, "label": "Synthetic design fixture. Not a production analysis.", "leadView": "DependencyForestChart (not implemented in Phase 1)", "dataDictionary": { "unitsPerWeek": "Planning allocation. Not a probability of outage.", "exposure": "Share of current allocation whose admitted path includes X.", "shortfall": "Demand minus remaining independent capacity under the no-inventory outage scenario." }, "inputs": { "demandPerWeek": 10000, "suppliers": { "A": 4000, "B": 3500, "C": 2500 }, "dependsOnX": [ "A", "B" ], "independentInFixture": [ "C" ], "cExpandableTo": 3000, "outputRetentionTargetBps": 7000 }, "graph": { "root": "world", "nodes": [ "world", "X", "A", "B", "C", "product" ], "edges": [ { "id": "wX", "source": "world", "target": "X" }, { "id": "wC", "source": "world", "target": "C" }, { "id": "XA", "source": "X", "target": "A" }, { "id": "XB", "source": "X", "target": "B" }, { "id": "Ap", "source": "A", "target": "product" }, { "id": "Bp", "source": "B", "target": "product" }, { "id": "Cp", "source": "C", "target": "product" } ] }, "expected": { "exposedAllocation": 7500, "exposureBps": 7500, "remainingUnderXOutage": 3000, "shortfallBps": 7000, "additionalIndependentUnitsPerWeek": 4000, "dominance": { "root": "world", "dominates": { "X": [ "A", "B" ] }, "doesNotDominate": { "X": [ "product" ] } }, "limitations": [ "75% current allocation exposed is not a 75% probability of outage.", "A capacity-limited route still defeats an unconditional claim of topological domination of the product node." ] } }

Serialized public chart props

JSON

{ "forest": { "atlas": { "sourceGraphRef": "supplier-redundancy-v1", "analysisRevision": "[1,\"supplier-redundancy-v1\",\"synthetic-suppliers:original\",{\"coordinate\":{\"kind\":\"ordinal\",\"sectionIds\":[\"Origin\",\"Upstream\",\"Suppliers\",\"Product\"]},\"dataRevision\":\"synthetic-suppliers:original\",\"evidencePolicyId\":\"synthetic-supplier-snapshot\",\"forest\":{\"display\":{\"kind\":\"rooted-backbone\",\"rankingPolicyId\":\"rooted-traversal:id-asc\",\"roots\":[\"world\"]},\"requiredPaths\":{\"relationScopeId\":\"directed-admitted\",\"roots\":[\"world\"]}},\"measures\":{\"allocation\":{\"countUnit\":\"work-item\",\"timeDenominator\":\"week\",\"unitKind\":\"rate\"},\"capacity\":{\"countUnit\":\"work-item\",\"timeDenominator\":\"week\",\"unitKind\":\"capacity\"}},\"motifs\":{\"anchor\":\"completion\",\"catalogId\":\"atlas-core\",\"catalogVersion\":\"1\",\"countUnit\":\"embedding\"},\"relations\":{\"directed\":true,\"edgeIdRequired\":true,\"parallelEdges\":\"keep-by-id\",\"selfLoops\":\"keep-by-id\"},\"schemaVersion\":\"0.2\",\"temporal\":{\"kind\":\"snapshot\"}}]", "spec": { "schemaVersion": "0.2", "coordinate": { "kind": "ordinal", "sectionIds": [ "Origin", "Upstream", "Suppliers", "Product" ] }, "relations": { "directed": true, "edgeIdRequired": true, "parallelEdges": "keep-by-id", "selfLoops": "keep-by-id" }, "evidencePolicyId": "synthetic-supplier-snapshot", "measures": { "allocation": { "unitKind": "rate", "countUnit": "work-item", "timeDenominator": "week" }, "capacity": { "unitKind": "capacity", "countUnit": "work-item", "timeDenominator": "week" } }, "motifs": { "catalogId": "atlas-core", "catalogVersion": "1", "countUnit": "embedding", "anchor": "completion" }, "forest": { "display": { "kind": "rooted-backbone", "roots": [ "world" ], "rankingPolicyId": "rooted-traversal:id-asc" }, "requiredPaths": { "roots": [ "world" ], "relationScopeId": "directed-admitted" } }, "dataRevision": "synthetic-suppliers:original", "temporal": { "kind": "snapshot" } }, "source": { "graphRef": "supplier-redundancy-v1", "revision": "synthetic-suppliers:original", "nodes": [ { "id": "world", "sectionId": "Origin" }, { "id": "X", "sectionId": "Upstream" }, { "id": "A", "sectionId": "Suppliers" }, { "id": "B", "sectionId": "Suppliers" }, { "id": "C", "sectionId": "Suppliers" }, { "id": "product", "sectionId": "Product" } ], "edges": [ { "id": "wX", "source": "world", "target": "X" }, { "id": "wC", "source": "world", "target": "C" }, { "id": "XA", "source": "X", "target": "A" }, { "id": "XB", "source": "X", "target": "B" }, { "id": "Ap", "source": "A", "target": "product" }, { "id": "Bp", "source": "B", "target": "product" }, { "id": "Cp", "source": "C", "target": "product" } ], "measureValues": [ { "measureId": "allocation", "subjectId": "A", "value": 4000, "status": "exact" }, { "measureId": "allocation", "subjectId": "B", "value": 3500, "status": "exact" }, { "measureId": "allocation", "subjectId": "C", "value": 2500, "status": "exact" }, { "measureId": "capacity", "subjectId": "C", "value": 3000, "status": "exact" } ] }, "sections": { "kind": "ordinal", "sectionIds": [ "Origin", "Upstream", "Suppliers", "Product" ], "nodeIdsBySection": { "Origin": [ "world" ], "Upstream": [ "X" ], "Suppliers": [ "A", "B", "C" ], "Product": [ "product" ] } }, "motifs": { "catalogId": "atlas-core", "catalogVersion": "1", "matches": [ { "id": "fan-out:world", "template": "fan-out", "roles": { "source": "world", "destinations": [ "X", "C" ] }, "nodePath": [ "world", "X", "C" ], "edgeIds": [ "wX", "wC" ], "startSectionId": "Origin", "completionSectionId": "Suppliers", "intersectSectionIds": [ "Origin", "Upstream", "Suppliers" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } }, { "id": "fan-out:X", "template": "fan-out", "roles": { "source": "X", "destinations": [ "A", "B" ] }, "nodePath": [ "X", "A", "B" ], "edgeIds": [ "XA", "XB" ], "startSectionId": "Upstream", "completionSectionId": "Suppliers", "intersectSectionIds": [ "Upstream", "Suppliers" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } }, { "id": "fan-in:product", "template": "fan-in", "roles": { "destination": "product", "sources": [ "A", "B", "C" ] }, "nodePath": [ "product", "A", "B", "C" ], "edgeIds": [ "Ap", "Bp", "Cp" ], "startSectionId": "Product", "completionSectionId": "Suppliers", "intersectSectionIds": [ "Product", "Suppliers" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } }, { "id": "serial-chain:A>product", "template": "serial-chain", "roles": { "nodes": [ "A", "product" ], "start": "A", "end": "product" }, "nodePath": [ "A", "product" ], "edgeIds": [ "Ap" ], "startSectionId": "Suppliers", "completionSectionId": "Product", "intersectSectionIds": [ "Suppliers", "Product" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } }, { "id": "serial-chain:B>product", "template": "serial-chain", "roles": { "nodes": [ "B", "product" ], "start": "B", "end": "product" }, "nodePath": [ "B", "product" ], "edgeIds": [ "Bp" ], "startSectionId": "Suppliers", "completionSectionId": "Product", "intersectSectionIds": [ "Suppliers", "Product" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } }, { "id": "serial-chain:C>product", "template": "serial-chain", "roles": { "nodes": [ "C", "product" ], "start": "C", "end": "product" }, "nodePath": [ "C", "product" ], "edgeIds": [ "Cp" ], "startSectionId": "Suppliers", "completionSectionId": "Product", "intersectSectionIds": [ "Suppliers", "Product" ], "entityIds": [], "entityWeights": {}, "entityCount": 0, "flags": { "occurrence": false, "temporal": false, "trajectorySupported": false, "enriched": false } } ], "incompleteCandidates": [], "unsupportedTemplates": [ "split-rejoin-diamond", "shared-upstream-source", "connector-bypass" ] }, "forest": { "kind": "rooted-backbone", "roots": [ "world" ], "rankingPolicyId": "rooted-traversal:id-asc", "backboneEdgeIds": [ "wC", "Cp", "wX", "XA", "XB" ], "primaryParentEdgeIdByNode": { "C": "wC", "product": "Cp", "X": "wX", "A": "XA", "B": "XB" } }, "residualEdges": { "originalEdgeIds": [ "wX", "wC", "XA", "XB", "Ap", "Bp", "Cp" ], "residualEdgeIds": [ "Ap", "Bp" ] }, "ports": { "hops": [], "graphAdjacency": [ { "source": "world", "target": "X", "edgeId": "wX" }, { "source": "world", "target": "C", "edgeId": "wC" }, { "source": "X", "target": "A", "edgeId": "XA" }, { "source": "X", "target": "B", "edgeId": "XB" }, { "source": "A", "target": "product", "edgeId": "Ap" }, { "source": "B", "target": "product", "edgeId": "Bp" }, { "source": "C", "target": "product", "edgeId": "Cp" } ] }, "ledger": { "entries": [ { "measureId": "allocation", "subjectId": "A", "subjectKind": "node", "value": 4000, "status": "exact", "unitKind": "rate", "countUnit": "work-item", "timeDenominator": "week" }, { "measureId": "allocation", "subjectId": "B", "subjectKind": "node", "value": 3500, "status": "exact", "unitKind": "rate", "countUnit": "work-item", "timeDenominator": "week" }, { "measureId": "allocation", "subjectId": "C", "subjectKind": "node", "value": 2500, "status": "exact", "unitKind": "rate", "countUnit": "work-item", "timeDenominator": "week" }, { "measureId": "capacity", "subjectId": "C", "subjectKind": "node", "value": 3000, "status": "exact", "unitKind": "capacity", "countUnit": "work-item", "timeDenominator": "week" }, { "measureId": "allocation", "subjectId": "Suppliers", "subjectKind": "section", "value": 10000, "status": "exact", "unitKind": "rate", "countUnit": "work-item", "timeDenominator": "week" }, { "measureId": "capacity", "subjectId": "Suppliers", "subjectKind": "section", "value": 3000, "status": "exact", "unitKind": "capacity", "countUnit": "work-item", "timeDenominator": "week" } ] }, "completeness": { "nodes": { "world": "known", "X": "known", "A": "known", "B": "known", "C": "known", "product": "known" }, "motifs": { "split-rejoin-diamond": "unsupported-template", "shared-upstream-source": "unsupported-template", "connector-bypass": "unsupported-template" }, "traces": "known" }, "provenance": { "sourceRevision": "synthetic-suppliers:original", "analysisRevision": "[1,\"supplier-redundancy-v1\",\"synthetic-suppliers:original\",{\"coordinate\":{\"kind\":\"ordinal\",\"sectionIds\":[\"Origin\",\"Upstream\",\"Suppliers\",\"Product\"]},\"dataRevision\":\"synthetic-suppliers:original\",\"evidencePolicyId\":\"synthetic-supplier-snapshot\",\"forest\":{\"display\":{\"kind\":\"rooted-backbone\",\"rankingPolicyId\":\"rooted-traversal:id-asc\",\"roots\":[\"world\"]},\"requiredPaths\":{\"relationScopeId\":\"directed-admitted\",\"roots\":[\"world\"]}},\"measures\":{\"allocation\":{\"countUnit\":\"work-item\",\"timeDenominator\":\"week\",\"unitKind\":\"rate\"},\"capacity\":{\"countUnit\":\"work-item\",\"timeDenominator\":\"week\",\"unitKind\":\"capacity\"}},\"motifs\":{\"anchor\":\"completion\",\"catalogId\":\"atlas-core\",\"catalogVersion\":\"1\",\"countUnit\":\"embedding\"},\"relations\":{\"directed\":true,\"edgeIdRequired\":true,\"parallelEdges\":\"keep-by-id\",\"selfLoops\":\"keep-by-id\"},\"schemaVersion\":\"0.2\",\"temporal\":{\"kind\":\"snapshot\"}}]", "generation": 1, "relationScope": "directed-admitted", "motifCatalogVersion": "1", "coordinatePolicy": "ordinal:Origin,Upstream,Suppliers,Product", "forestRoots": [ "world" ], "rankingPolicyId": "rooted-traversal:id-asc", "population": "embedding", "temporalHorizon": "snapshot", "evidencePolicyId": "synthetic-supplier-snapshot" }, "requiredPaths": { "roots": [ "world" ], "relationScopeId": "directed-admitted", "status": "exact", "immediateDominatorByNode": { "A": "X", "B": "X", "C": "world", "X": "world", "product": "world", "world": null }, "reachableNodeIds": [ "A", "B", "C", "X", "product", "world" ], "unreachableNodeIds": [] } }, "forest": { "kind": "rooted-backbone", "roots": [ "world" ], "rankingPolicyId": "rooted-traversal:id-asc", "backboneEdgeIds": [ "wC", "Cp", "wX", "XA", "XB" ], "primaryParentEdgeIdByNode": { "C": "wC", "product": "Cp", "X": "wX", "A": "XA", "B": "XB" } }, "residual": { "originalEdgeIds": [ "wX", "wC", "XA", "XB", "Ap", "Bp", "Cp" ], "residualEdgeIds": [ "Ap", "Bp" ] }, "order": [ "world", "C", "product", "X", "A", "B" ], "children": { "world": [ "C", "X" ], "X": [ "A", "B" ], "A": [], "B": [], "C": [ "product" ], "product": [] }, "components": [ [ "A" ], [ "B" ], [ "C" ], [ "product" ], [ "world" ], [ "X" ] ], "requiredChildren": { "world": [ "C", "X", "product" ], "X": [ "A", "B" ], "A": [], "B": [], "C": [], "product": [] }, "sceneSeeds": { "nodes": [ { "id": "world", "sectionId": "Origin" }, { "id": "X", "sectionId": "Upstream" }, { "id": "A", "sectionId": "Suppliers" }, { "id": "B", "sectionId": "Suppliers" }, { "id": "C", "sectionId": "Suppliers" }, { "id": "product", "sectionId": "Product" } ], "edges": [ { "id": "wX", "source": "world", "target": "X" }, { "id": "wC", "source": "world", "target": "C" }, { "id": "XA", "source": "X", "target": "A" }, { "id": "XB", "source": "X", "target": "B" }, { "id": "Ap", "source": "A", "target": "product" }, { "id": "Bp", "source": "B", "target": "product" }, { "id": "Cp", "source": "C", "target": "product" } ] } }, "reading": "required-paths", "width": 920, "height": 440, "chartId": "atlas-reference-supplier", "title": "False supplier redundancy", "description": "Do three suppliers provide three independent paths?", "summary": "75% of allocation depends on X. Losing X creates a 70% shortfall; the independent-capacity target is 4,000 units/week.", "accessibleTable": true }

Prepare, render and share

Use prepareNetworkAtlas(spec, source) in a worker or upstream service. Inspectresult.ok and its admission issues before passing result.atlas to a reader. prepareNetworkAtlasAsync loads preparation lazily; it does not create a worker.

JSX

import { prepareDependencyForest } from "semiotic/atlas/core" import { DependencyForestChart } from "semiotic/atlas" import { renderChartWithEvidence } from "semiotic/server" // atlas is an admitted PreparedNetworkAtlas with declared roots. const forest = prepareDependencyForest(atlas) const props = { forest, reading: "required-paths", title: "Required supply paths" } const { svg, evidence } = renderChartWithEvidence("DependencyForestChart", props) <DependencyForestChart {...props} />

Declare roots in spec.forest.requiredPaths before preparing the atlas. Required paths are computed over all admitted directed edges. Changing the display backbone does not change those paths; a structural bypass does not establish usable capacity.

On phones the playground keeps the task table and inspector controls available. On desktop, focus marks and use the arrow keys; press Space to activate a vertex. Flow Circuit also supports Enter activation. The full supplier and circuit studies add linked inspectors, matrices and modeled comparisons at Dependency X-Rayand Flow Circuit.

Props

Prop	Type	Required	Default	Description
`forest`	DependencyForestProjection	—	—	prepareDependencyForest(atlas) result. Required.
`reading`	string	—	—	organize or required-paths.
`collapsedNodeIds`	array	—	—	Collapse display branches while retaining original edge evidence.
`selection`	object	—	—	nodeId, analysisRevision and relationScopeId.
`width`	number	—	—	Chart width in pixels.
`height`	number	—	—	Chart height in pixels.
`title`	string	—	—	Visible and accessible name.
`description`	string	—	—	Accessible description.
`summary`	string	—	—	Accessible task summary.
`accessibleTable`	boolean \| object	—	—	Data table, enabled by default.
`chartId`	string	—	—	Stable ID for observations.
`linkedHover`	boolean \| string \| object	—	—	Linked canonical node hover.
`onObservation`	function	—	—	React observation callback.
`colors`	object	—	—	Semantic role color overrides; unspecified roles use ThemeProvider.
`linkedSelection`	object	—	—	Named linked-view selection.
`onSelectNode`	function	—	—	Pointer and keyboard activation return the canonical vertex ID.