Skip to examples

A visual reference · D2

D2,
one change at a time

From a first connection to data models, messages and architecture drawn with text. 140 complete examples in 23 chapters follow a fictional field archive: collect a sample, review its record and publish a trustworthy catalog. Every example pairs editable D2 source with its actual diagram and a concrete experiment. Names and quantities are illustrative.

The Org file is the canonical source. Read the HTML guide beside your work, or download its PDF and source for offline reading.

Last changes: 2026-11-15. Added 24 process examples covering decisions, parallel work, handoffs, retries, deadlines, compensation and recovery.

Download PDFRendered tour · read offline
140worked examples
23topic families
1canonical Org source

Reading the tour

Three ways to see a change

D2 source

Read a complete diagram. A focused parameter table explains its new syntax.

Actual diagram

Inspect the native SVG beside its source; PDF and PNG downloads are available too.

Try a change

Follow a sibling comparison, edit the downloaded program and render it with the same configuration.

Start with the visual overview or follow the chapters in order. Search and topic filters narrow the examples. Back to diagram overview returns to the matching thumbnail; Copy link preserves the address of the guide you are reading.

For process design, follow chapters 20–23 after the first four chapters. Name every decision outcome and distinguish an exclusive merge from an AND or ANY join. Dashed arrows in these worked processes carry records; solid arrows order work. A finished check is not necessarily a successful check. These are explicit D2 drawing conventions, not an executable workflow or a BPMN validator.

Reproduce the diagrams

All examples use D2 v0.9.0, theme 0 and 24 px outer padding. Built-in Source Sans Pro and Source Code Pro fonts travel with the renderer. Dagre is the default; examples that need port routing select ELK explicitly. Geometry is version-sensitive.

Install the shared publisher Python dependencies with make setup in the publisher folder, plus Emacs and Poppler. The tested versions are Python 3.14.10, Emacs 31.1 / Org 9.8.7, WeasyPrint 70.0, PyMuPDF 1.28.2, Pygments 2.21.0, FontTools 4.66.1, librsvg 2.63.4 and Poppler 26.11.0. See VERSIONS.json for the release checksum and linked rendering-library versions. The official macOS arm64 D2 archive is bundled in tools/vendor/; tools/d2 verifies its SHA-256 and extracts it locally without network access. On another platform install D2 v0.9.0 beforehand and set D2=/absolute/path/to/d2. This release exports PDF/PNG/PPTX itself, without Chromium.

Download the complete offline reproduction bundle for every source, shared configuration, local input, renderer archive and license notice. Extract it before running the commands. The included tools/d2 also accepts an installed v0.9.0 selected with D2 or found on PATH.

Download the shared render configuration. After installing the Python dependencies, activate the publisher environment with source ../67.00_export-tourguide/.venv/bin/activate before copying commands that invoke python3. In a standalone diagram bundle, install its pinned requirements.txt into an environment and activate that environment instead.

The one shared config/render.json is:

{"version": "v0.9.0", "theme": 0, "pad": 24}

The publisher reads this configuration for every command. Per-example flags select only the feature under discussion. Run commands from the tour root; create figures/ first. Source bundles preserve relative paths to local imports and icons.

make full
make check
tools/d2 --version
tools/d2 fmt examples/D2L-01-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-001 --target '' examples/D2L-01-001.d2 figures/D2L-01-001.svg
CLI argument Meaning in this tour
fmt / validate Format the whole source / check it with the installed compiler.
--layout dagre / elk Select the two permitted engines.
--theme 0 Use the same built-in palette throughout.
--pad 24 Reserve 24 pixels around the diagram.
--salt ID Stabilize SVG identifiers and isolate embedded diagrams.
--target '' Export only the root board.
--target layers.detail Select one named board.
--animate-interval 1200 Advance boards every 1200 milliseconds.
.svg / .pdf / .pptx / .txt Infer output format from the filename.

HTML embeds all displayed figures for offline reading. Individual downloads use companion folders. The publisher converts native SVG to compact vector PDF with librsvg 2.63.4, loading the SVG’s exact embedded font subsets through tools/svg-pdf.py; animated examples have a static root-board print view. PDF metadata dates are removed after export. Repeated native renders use no timestamps, random layout engines, remote icons or build-time URLs.

Feature coverage

The shape catalog groups all 25 built-in shapes in the pinned version by use. Later chapters explain the specialized notation in complete worked examples.

Feature Chapter Examples
Shapes, labels, comments and direction 01 · First diagrams 6
Every built-in shape, grouped by role 02 · Shape catalog 6
Operators, chains, arrowheads and endpoint labels 03 · Connections 6
Nested maps, paths and parent references 04 · Containers 6
Fill, stroke, dashes, opacity, patterns and depth cues 05 · Styles 6
Classes, local overrides, fixed theme and sketch 06 · Reusable appearance 6
Markdown, math and code on objects and edges 07 · Text 6
Local object/edge icons and image objects 08 · Images 4
SQL constraints, ELK column edges and UML classes 09 · Data and object models 8
Actors, spans, groups, notes and self-messages 10 · Sequence diagrams 8
Rows, columns, independent gaps, nesting and edges 11 · Grids 6
Near, dimensions, labels and identical Dagre/ELK input 12 · Positioning 6
Scalars, styles, object/edge globs and filters 13 · Variables and globs 8
Local/map/selective imports, spread and model suspension 14 · Imports and models 6
Layers, independent scenarios, cumulative steps and targets 15 · Boards 6
Animated boards/edges, tooltips and local links 16 · Interactivity 6
C4-style context, containers, components, deployment and legends 17 · Architecture 6
SVG, paged PDF, PPTX, standard ASCII, fmt and validate 18 · Exports 6
Context, components, messages and stored data for one system 19 · Four views 4
Decisions, correction loops and explicit outcomes 20 · Process paths 6
Forks, AND/ANY joins and optional branches 21 · Parallel work 6
Ownership, receipt, escalation and custody 22 · Responsibilities 6
Queues, retries, deadlines, compensation and recovery 23 · Reliability 6
Total 23 chapters 140

Choosing a diagram

Choose the question first. A component view explains responsibilities, a sequence view explains message order, and a table view explains record structure. None of these views executes the process, validates a business rule or enforces a database constraint. State what an arrow means in each diagram.

Reader’s question Choose Start here
What happens next? A bounded process with named outcomes Complete intake
Must all branches finish? An explicit AND join Wait for both checks
What happens after a failed attempt? A bounded retry path Retry budget
What must be undone after a failure? A compensation path Undo completed work
Who owns this work? Nested responsibility boundaries Field intake
Which fields identify a record? A SQL-table model Primary key
In which order are requests handled? A sequence diagram Submission message
Which option changes the system? Independent scenarios Outage alternative
How does the system fit its environment? A C4-style context Archive context

Keep labels short, distinguish identity from display text and add one boundary at a time. Use both words and visual cues for status so a grayscale copy still works. Inspect a downloaded SVG at its intended size before adjusting font sizes or adding more structure. Use Graphviz layout examples for another approach to placement, Mermaid sequences, Mermaid classes and Mermaid C4 views for comparisons, and SQLite schemas to turn a table design into an executable database.

References

These examples and their field-archive story are original. Syntax was checked with tools/d2 --help, d2 fmt, d2 validate, actual renders and the compiler/rendering fixtures in the official v0.9.0 source tree. Documentation pages may evolve after this pinned release; the executable and its archived version own this tour’s results.

Content is dedicated under CC0 1.0. Tour structure and publishing framework are CC BY 4.0 by Lukas C. Bossert. See license notes and D2’s third-party notices for the bundled renderer and fonts. D2 itself retains its upstream license.

01 · First diagrams

Create a sample, connect its next action and separate identity from visible labels.

Reference: Official D2 documentation.

D2L-01-001

Name a sample

A bare key creates a rectangular object. Use it to put the first item in a sketch before choosing a visual vocabulary.

Back to diagram overview

D2 source

sample
ParameterMeaning in this example
sampleCreate an object whose label initially matches its key.

Render this diagram

tools/d2 fmt examples/D2L-01-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-001 --target '' examples/D2L-01-001.d2 figures/D2L-01-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-001 --target '' examples/D2L-01-001.d2 figures/D2L-01-001.png
python3 tools/svg-pdf.py figures/D2L-01-001.svg figures/D2L-01-001.pdf

Try changing: Rename sample to specimen.

Actual output

Name a sample
D2L-01-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-001.d2 to figures/D2L-01-001.svg in 1.794917ms

success: successfully compiled examples/D2L-01-001.d2 to figures/D2L-01-001.png in 2.854625ms
Render this diagram
tools/d2 fmt examples/D2L-01-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-001 --target '' examples/D2L-01-001.d2 figures/D2L-01-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-001 --target '' examples/D2L-01-001.d2 figures/D2L-01-001.png
python3 tools/svg-pdf.py figures/D2L-01-001.svg figures/D2L-01-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Compare with Mermaid · first nodes and connection.

Try changing: Rename sample to specimen.

D2L-01-002

Choose a sample shape

A shape describes how an object is drawn. Use a cylinder when this archive record represents stored data.

Back to diagram overview

Compare with D2L-01-001 · Name a sample.

D2 source

sample: {shape: cylinder}
ParameterMeaning in this example
shape: cylinderDraw the sample as stored data.

Render this diagram

tools/d2 fmt examples/D2L-01-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-002 --target '' examples/D2L-01-002.d2 figures/D2L-01-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-002 --target '' examples/D2L-01-002.d2 figures/D2L-01-002.png
python3 tools/svg-pdf.py figures/D2L-01-002.svg figures/D2L-01-002.pdf

Try changing: Change cylinder to rectangle.

Actual output

Choose a sample shape
D2L-01-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-002.d2 to figures/D2L-01-002.svg in 1.782166ms

success: successfully compiled examples/D2L-01-002.d2 to figures/D2L-01-002.png in 3.737583ms
Render this diagram
tools/d2 fmt examples/D2L-01-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-002 --target '' examples/D2L-01-002.d2 figures/D2L-01-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-002 --target '' examples/D2L-01-002.d2 figures/D2L-01-002.png
python3 tools/svg-pdf.py figures/D2L-01-002.svg figures/D2L-01-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change cylinder to rectangle.

D2L-01-003

Connect the review

A directed connection says which action follows collection. Use a verb on each activity so the arrow can carry the ordering.

Back to diagram overview

Compare with D2L-01-002 · Choose a sample shape.

D2 source

collect -> review
ParameterMeaning in this example
->Connect collection to review with a target arrowhead.

Render this diagram

tools/d2 fmt examples/D2L-01-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-003 --target '' examples/D2L-01-003.d2 figures/D2L-01-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-003 --target '' examples/D2L-01-003.d2 figures/D2L-01-003.png
python3 tools/svg-pdf.py figures/D2L-01-003.svg figures/D2L-01-003.pdf

Try changing: Reverse the arrow to show a request for collection.

Actual output

Connect the review
D2L-01-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-003.d2 to figures/D2L-01-003.svg in 2.047459ms

success: successfully compiled examples/D2L-01-003.d2 to figures/D2L-01-003.png in 3.458583ms
Render this diagram
tools/d2 fmt examples/D2L-01-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-003 --target '' examples/D2L-01-003.d2 figures/D2L-01-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-003 --target '' examples/D2L-01-003.d2 figures/D2L-01-003.png
python3 tools/svg-pdf.py figures/D2L-01-003.svg figures/D2L-01-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Reverse the arrow to show a request for collection.

D2L-01-004

Separate keys from labels

Keys remain stable while reader-facing labels become more descriptive. Use this separation when short identifiers keep repeated references readable.

Back to diagram overview

Compare with D2L-01-003 · Connect the review.

D2 source

s: Field sample
r: Review record
s -> r: submit
ParameterMeaning in this example
s: Field sampleKeep s as the key and show Field sample.
submitLabel what travels along this connection.

Render this diagram

tools/d2 fmt examples/D2L-01-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-004 --target '' examples/D2L-01-004.d2 figures/D2L-01-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-004 --target '' examples/D2L-01-004.d2 figures/D2L-01-004.png
python3 tools/svg-pdf.py figures/D2L-01-004.svg figures/D2L-01-004.pdf

Try changing: Change Field sample to Water sample; keep the key s.

Actual output

Separate keys from labels
D2L-01-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-004.d2 to figures/D2L-01-004.svg in 2.4065ms

success: successfully compiled examples/D2L-01-004.d2 to figures/D2L-01-004.png in 5.081583ms
Render this diagram
tools/d2 fmt examples/D2L-01-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-004 --target '' examples/D2L-01-004.d2 figures/D2L-01-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-004 --target '' examples/D2L-01-004.d2 figures/D2L-01-004.png
python3 tools/svg-pdf.py figures/D2L-01-004.svg figures/D2L-01-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change Field sample to Water sample; keep the key s.

D2L-01-005

Explain an assumption

A comment records an assumption without creating a visible object. Use it to preserve why this diagram leaves rejected records out.

Back to diagram overview

Compare with D2L-01-004 · Separate keys from labels.

D2 source

# Only accepted samples reach the archive.
review -> archive: accepted
ParameterMeaning in this example
#Start a source comment that the renderer ignores.

Render this diagram

tools/d2 fmt examples/D2L-01-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-005 --target '' examples/D2L-01-005.d2 figures/D2L-01-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-005 --target '' examples/D2L-01-005.d2 figures/D2L-01-005.png
python3 tools/svg-pdf.py figures/D2L-01-005.svg figures/D2L-01-005.pdf

Try changing: Edit only the comment and confirm the figure stays the same.

Actual output

Explain an assumption
D2L-01-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-005.d2 to figures/D2L-01-005.svg in 2.225209ms

success: successfully compiled examples/D2L-01-005.d2 to figures/D2L-01-005.png in 4.521417ms
Render this diagram
tools/d2 fmt examples/D2L-01-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-005 --target '' examples/D2L-01-005.d2 figures/D2L-01-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-005 --target '' examples/D2L-01-005.d2 figures/D2L-01-005.png
python3 tools/svg-pdf.py figures/D2L-01-005.svg figures/D2L-01-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Edit only the comment and confirm the figure stays the same.

D2L-01-006

Read from left to right

Direction changes placement while preserving the same relationship. Use a horizontal route when collection and review belong on one line.

Back to diagram overview

Compare with D2L-01-003 · Connect the review.

D2 source

direction: right
collect -> review
ParameterMeaning in this example
direction: rightArrange the main flow horizontally.

Render this diagram

tools/d2 fmt examples/D2L-01-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-006 --target '' examples/D2L-01-006.d2 figures/D2L-01-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-006 --target '' examples/D2L-01-006.d2 figures/D2L-01-006.png
python3 tools/svg-pdf.py figures/D2L-01-006.svg figures/D2L-01-006.pdf

Try changing: Change right to down.

Actual output

Read from left to right
D2L-01-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-01-006.d2 to figures/D2L-01-006.svg in 1.931458ms

success: successfully compiled examples/D2L-01-006.d2 to figures/D2L-01-006.png in 3.406459ms
Render this diagram
tools/d2 fmt examples/D2L-01-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-006 --target '' examples/D2L-01-006.d2 figures/D2L-01-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-01-006 --target '' examples/D2L-01-006.d2 figures/D2L-01-006.png
python3 tools/svg-pdf.py figures/D2L-01-006.svg figures/D2L-01-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change right to down.

02 · Shape catalog

Choose a visual vocabulary by role; specialized shapes receive full treatments in later chapters.

Reference: Official D2 documentation.

D2L-02-001

Distinguish task silhouettes

Task shapes can suggest a plain activity, a compact station or a step in a route. Use this small catalog to choose one convention before drawing a process.

Back to diagram overview

Compare with D2L-01-002 · Choose a sample shape.

D2 source

direction: right
collect: {shape: rectangle}
station: {shape: square}
review: {shape: step}
collect -> station -> review
ParameterMeaning in this example
rectangle / square / stepCompare three task silhouettes in the same route.

Render this diagram

tools/d2 fmt examples/D2L-02-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-001 --target '' examples/D2L-02-001.d2 figures/D2L-02-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-001 --target '' examples/D2L-02-001.d2 figures/D2L-02-001.png
python3 tools/svg-pdf.py figures/D2L-02-001.svg figures/D2L-02-001.pdf

Try changing: Change review to rectangle.

Actual output

Distinguish task silhouettes
D2L-02-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-001.d2 to figures/D2L-02-001.svg in 2.146875ms

success: successfully compiled examples/D2L-02-001.d2 to figures/D2L-02-001.png in 6.519625ms
Render this diagram
tools/d2 fmt examples/D2L-02-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-001 --target '' examples/D2L-02-001.d2 figures/D2L-02-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-001 --target '' examples/D2L-02-001.d2 figures/D2L-02-001.png
python3 tools/svg-pdf.py figures/D2L-02-001.svg figures/D2L-02-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change review to rectangle.

D2L-02-002

Mark decisions and milestones

Decision and boundary shapes make different kinds of checkpoints visible. Use a diamond for a question, and state the meaning of the other silhouettes in the labels.

Back to diagram overview

Compare with D2L-02-001 · Distinguish task silhouettes.

D2 source

direction: right
input: Field input {shape: parallelogram}
check: Complete? {shape: diamond}
permit: Permit {shape: hexagon}
start: Start {shape: circle}
end: Finish {shape: oval}
start -> input -> check -> permit -> end
ParameterMeaning in this example
parallelogram / diamond / hexagonMark input, a question and an approval checkpoint.
circle / ovalMark the route endpoints.

Render this diagram

tools/d2 fmt examples/D2L-02-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-002 --target '' examples/D2L-02-002.d2 figures/D2L-02-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-002 --target '' examples/D2L-02-002.d2 figures/D2L-02-002.png
python3 tools/svg-pdf.py figures/D2L-02-002.svg figures/D2L-02-002.pdf

Try changing: Change Permit to Batch gate.

Actual output

Mark decisions and milestones
D2L-02-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-002.d2 to figures/D2L-02-002.svg in 2.333667ms

success: successfully compiled examples/D2L-02-002.d2 to figures/D2L-02-002.png in 12.858334ms
Render this diagram
tools/d2 fmt examples/D2L-02-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-002 --target '' examples/D2L-02-002.d2 figures/D2L-02-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-002 --target '' examples/D2L-02-002.d2 figures/D2L-02-002.png
python3 tools/svg-pdf.py figures/D2L-02-002.svg figures/D2L-02-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change Permit to Batch gate.

D2L-02-003

Distinguish storage roles

A cylinder, queue and stored-data symbol can distinguish persistence from waiting. Use explicit labels because the silhouettes alone do not define retention or delivery guarantees.

Back to diagram overview

Compare with D2L-02-002 · Mark decisions and milestones.

D2 source

direction: right
records: {shape: cylinder}
waiting: {shape: queue}
backup: {shape: stored_data}
waiting -> records -> backup
ParameterMeaning in this example
cylinder / queue / stored_dataSeparate the working archive, incoming queue and backup.

Render this diagram

tools/d2 fmt examples/D2L-02-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-003 --target '' examples/D2L-02-003.d2 figures/D2L-02-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-003 --target '' examples/D2L-02-003.d2 figures/D2L-02-003.png
python3 tools/svg-pdf.py figures/D2L-02-003.svg figures/D2L-02-003.pdf

Try changing: Rename backup to Nightly copy.

Actual output

Distinguish storage roles
D2L-02-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-003.d2 to figures/D2L-02-003.svg in 2.039583ms

success: successfully compiled examples/D2L-02-003.d2 to figures/D2L-02-003.png in 8.021584ms
Render this diagram
tools/d2 fmt examples/D2L-02-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-003 --target '' examples/D2L-02-003.d2 figures/D2L-02-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-003 --target '' examples/D2L-02-003.d2 figures/D2L-02-003.png
python3 tools/svg-pdf.py figures/D2L-02-003.svg figures/D2L-02-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename backup to Nightly copy.

D2L-02-004

Separate records from packages

Page and document shapes suggest individual artifacts while a package suggests a collection. Use these together when explaining the deliverables of a field campaign.

Back to diagram overview

Compare with D2L-02-003 · Distinguish storage roles.

D2 source

direction: right
form: {shape: page}
report: {shape: document}
release: {shape: package}
form -> report -> release
ParameterMeaning in this example
page / document / packageDistinguish a form, report and release bundle.

Render this diagram

tools/d2 fmt examples/D2L-02-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-004 --target '' examples/D2L-02-004.d2 figures/D2L-02-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-004 --target '' examples/D2L-02-004.d2 figures/D2L-02-004.png
python3 tools/svg-pdf.py figures/D2L-02-004.svg figures/D2L-02-004.pdf

Try changing: Replace report with Summary sheet.

Actual output

Separate records from packages
D2L-02-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-004.d2 to figures/D2L-02-004.svg in 1.959083ms

success: successfully compiled examples/D2L-02-004.d2 to figures/D2L-02-004.png in 5.388793ms
Render this diagram
tools/d2 fmt examples/D2L-02-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-004 --target '' examples/D2L-02-004.d2 figures/D2L-02-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-004 --target '' examples/D2L-02-004.d2 figures/D2L-02-004.png
python3 tools/svg-pdf.py figures/D2L-02-004.svg figures/D2L-02-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Replace report with Summary sheet.

D2L-02-005

Introduce people and boundaries

Person silhouettes identify human roles and a cloud can mark an outside service. Use a callout to keep an explicit boundary assumption close to the drawing.

Back to diagram overview

Compare with D2L-02-004 · Separate records from packages.

D2 source

direction: right
collector: {shape: person}
curator: {shape: c4-person}
partner: {shape: cloud}
assumption: Offline first {shape: callout}
collector -> curator -> partner
ParameterMeaning in this example
person / c4-personCompare the two built-in person silhouettes.
cloud / calloutMark an external service and an explanatory aside.

Render this diagram

tools/d2 fmt examples/D2L-02-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-005 --target '' examples/D2L-02-005.d2 figures/D2L-02-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-005 --target '' examples/D2L-02-005.d2 figures/D2L-02-005.png
python3 tools/svg-pdf.py figures/D2L-02-005.svg figures/D2L-02-005.pdf

Try changing: Rename partner to Partner catalog.

Actual output

Introduce people and boundaries
D2L-02-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-005.d2 to figures/D2L-02-005.svg in 2.067542ms

success: successfully compiled examples/D2L-02-005.d2 to figures/D2L-02-005.png in 9.565459ms
Render this diagram
tools/d2 fmt examples/D2L-02-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-005 --target '' examples/D2L-02-005.d2 figures/D2L-02-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-005 --target '' examples/D2L-02-005.d2 figures/D2L-02-005.png
python3 tools/svg-pdf.py figures/D2L-02-005.svg figures/D2L-02-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename partner to Partner catalog.

D2L-02-006

Recognize specialized notation

Specialized shapes bring their own internal notation rather than just changing an outline. Use this catalog as a signpost to the text, data-model, sequence and image chapters.

Back to diagram overview

Compare with D2L-02-005 · Introduce people and boundaries.

D2 source

grid-columns: 3
caption: Catalog guide {shape: text}
listing: |text
  sample_id = 7
|
record: {shape: class; id: int}
table: {shape: sql_table; id: int}
mark: {shape: image; icon: ../assets/field-mark.png}
exchange: {shape: sequence_diagram; collector -> archive: submit}
family: {shape: hierarchy; field; lab; field -> lab}
ParameterMeaning in this example
text / code / class / sql_tableSelect a label-only, code, class or table representation.
image / sequence_diagram / hierarchySelect an image, ordered exchange or hierarchical group.

Render this diagram

tools/d2 fmt examples/D2L-02-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-006 --target '' examples/D2L-02-006.d2 figures/D2L-02-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-006 --target '' examples/D2L-02-006.d2 figures/D2L-02-006.png
python3 tools/svg-pdf.py figures/D2L-02-006.svg figures/D2L-02-006.pdf

Try changing: Change the code value from 7 to 8.

Actual output

Recognize specialized notation
D2L-02-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-02-006.d2 to figures/D2L-02-006.svg in 6.642583ms

success: successfully compiled examples/D2L-02-006.d2 to figures/D2L-02-006.png in 35.634417ms
Render this diagram
tools/d2 fmt examples/D2L-02-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-006 --target '' examples/D2L-02-006.d2 figures/D2L-02-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-02-006 --target '' examples/D2L-02-006.d2 figures/D2L-02-006.png
python3 tools/svg-pdf.py figures/D2L-02-006.svg figures/D2L-02-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the code value from 7 to 8.

03 · Connections and arrowheads

Give each relationship a direction, then explain what its endpoints mean.

Reference: Official D2 documentation.

D2L-03-001

Choose connection directions

Four operators distinguish association, forward flow, backward flow and exchange. Use the direction that matches the stated relationship rather than the position of the boxes.

Back to diagram overview

Compare with D2L-02-001 · Distinguish task silhouettes.

D2 source

direction: right
collector -- form: uses
form -> review: submits
review <- curator: performs
curator <-> archive: exchanges
ParameterMeaning in this example
-- / -> / <- / <->Draw undirected, forward, reversed and two-headed connections.

Render this diagram

tools/d2 fmt examples/D2L-03-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-001 --target '' examples/D2L-03-001.d2 figures/D2L-03-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-001 --target '' examples/D2L-03-001.d2 figures/D2L-03-001.png
python3 tools/svg-pdf.py figures/D2L-03-001.svg figures/D2L-03-001.pdf

Try changing: Change exchanges to synchronization.

Actual output

Choose connection directions
D2L-03-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-001.d2 to figures/D2L-03-001.svg in 2.579541ms

success: successfully compiled examples/D2L-03-001.d2 to figures/D2L-03-001.png in 11.500875ms
Render this diagram
tools/d2 fmt examples/D2L-03-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-001 --target '' examples/D2L-03-001.d2 figures/D2L-03-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-001 --target '' examples/D2L-03-001.d2 figures/D2L-03-001.png
python3 tools/svg-pdf.py figures/D2L-03-001.svg figures/D2L-03-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change exchanges to synchronization.

D2L-03-002

Chain the handoffs

A chain connects successive activities with one expression. Use it when adjacent handoffs have the same direction and need no separate styling.

Back to diagram overview

Compare with D2L-03-001 · Choose connection directions.

D2 source

direction: right
collect -> tag -> review -> archive
ParameterMeaning in this example
a -> b -> cCreate consecutive connections, without implying an atomic transaction.

Render this diagram

tools/d2 fmt examples/D2L-03-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-002 --target '' examples/D2L-03-002.d2 figures/D2L-03-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-002 --target '' examples/D2L-03-002.d2 figures/D2L-03-002.png
python3 tools/svg-pdf.py figures/D2L-03-002.svg figures/D2L-03-002.pdf

Try changing: Insert scan between tag and review.

Actual output

Chain the handoffs
D2L-03-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-002.d2 to figures/D2L-03-002.svg in 1.918333ms

success: successfully compiled examples/D2L-03-002.d2 to figures/D2L-03-002.png in 4.803541ms
Render this diagram
tools/d2 fmt examples/D2L-03-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-002 --target '' examples/D2L-03-002.d2 figures/D2L-03-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-002 --target '' examples/D2L-03-002.d2 figures/D2L-03-002.png
python3 tools/svg-pdf.py figures/D2L-03-002.svg figures/D2L-03-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Insert scan between tag and review.

D2L-03-003

Choose an endpoint symbol

Arrowhead shape changes the endpoint symbol without changing the edge direction. Use this catalog to select a symbol whose meaning you will explain in the diagram text.

Back to diagram overview

Compare with D2L-03-002 · Chain the handoffs.

D2 source

direction: right
a: Collect
b: Inspect
c: Store
d: Publish
e: Stop
a -> b: {target-arrowhead.shape: triangle}
b -> c: {target-arrowhead.shape: arrow}
c -> d: {target-arrowhead.shape: diamond}
d -> e: {target-arrowhead.shape: circle}
a -> e: {target-arrowhead.shape: cross}
b -> e: {target-arrowhead.shape: box}
ParameterMeaning in this example
target-arrowhead.shapeChoose triangle, arrow, diamond, circle, cross or box explicitly.

Render this diagram

tools/d2 fmt examples/D2L-03-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-003 --target '' examples/D2L-03-003.d2 figures/D2L-03-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-003 --target '' examples/D2L-03-003.d2 figures/D2L-03-003.png
python3 tools/svg-pdf.py figures/D2L-03-003.svg figures/D2L-03-003.pdf

Try changing: Replace circle with box.

Actual output

Choose an endpoint symbol
D2L-03-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-003.d2 to figures/D2L-03-003.svg in 2.432ms

success: successfully compiled examples/D2L-03-003.d2 to figures/D2L-03-003.png in 10.936209ms
Render this diagram
tools/d2 fmt examples/D2L-03-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-003 --target '' examples/D2L-03-003.d2 figures/D2L-03-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-003 --target '' examples/D2L-03-003.d2 figures/D2L-03-003.png
python3 tools/svg-pdf.py figures/D2L-03-003.svg figures/D2L-03-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Replace circle with box.

D2L-03-004

Mark relational cardinalities

Crow-foot endpoints can distinguish optional and required multiplicities. Use this notation for data relationships only after stating which side owns each key.

Back to diagram overview

Compare with D2L-03-003 · Choose an endpoint symbol.

D2 source

direction: right
site -> sample: {source-arrowhead.shape: cf-one; target-arrowhead.shape: cf-many}
sample -> observation: {source-arrowhead.shape: cf-one-required; target-arrowhead.shape: cf-many-required}
ParameterMeaning in this example
cf-one / cf-manyShow one versus many endpoints.
cf-one-required / cf-many-requiredAdd the required-marker variant.

Render this diagram

tools/d2 fmt examples/D2L-03-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-004 --target '' examples/D2L-03-004.d2 figures/D2L-03-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-004 --target '' examples/D2L-03-004.d2 figures/D2L-03-004.png
python3 tools/svg-pdf.py figures/D2L-03-004.svg figures/D2L-03-004.pdf

Try changing: Change cf-many-required to cf-many.

Actual output

Mark relational cardinalities
D2L-03-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-004.d2 to figures/D2L-03-004.svg in 1.943458ms

success: successfully compiled examples/D2L-03-004.d2 to figures/D2L-03-004.png in 4.151958ms
Render this diagram
tools/d2 fmt examples/D2L-03-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-004 --target '' examples/D2L-03-004.d2 figures/D2L-03-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-004 --target '' examples/D2L-03-004.d2 figures/D2L-03-004.png
python3 tools/svg-pdf.py figures/D2L-03-004.svg figures/D2L-03-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change cf-many-required to cf-many.

D2L-03-005

Outline an ownership marker

An unfilled endpoint gives an ownership marker a different visual weight. Use it when an open diamond has a defined meaning in your chosen notation.

Back to diagram overview

Compare with D2L-03-004 · Mark relational cardinalities.

D2 source

direction: right
batch -> sample: contains {source-arrowhead: {shape: diamond; style.filled: false}; target-arrowhead.shape: none}
ParameterMeaning in this example
source-arrowheadConfigure the endpoint at the beginning of the edge.
style.filled: falseLeave this source diamond hollow.
noneSuppress the target symbol.

Render this diagram

tools/d2 fmt examples/D2L-03-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-005 --target '' examples/D2L-03-005.d2 figures/D2L-03-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-005 --target '' examples/D2L-03-005.d2 figures/D2L-03-005.png
python3 tools/svg-pdf.py figures/D2L-03-005.svg figures/D2L-03-005.pdf

Try changing: Set filled to true.

Actual output

Outline an ownership marker
D2L-03-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-005.d2 to figures/D2L-03-005.svg in 2.465292ms

success: successfully compiled examples/D2L-03-005.d2 to figures/D2L-03-005.png in 4.772959ms
Render this diagram
tools/d2 fmt examples/D2L-03-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-005 --target '' examples/D2L-03-005.d2 figures/D2L-03-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-005 --target '' examples/D2L-03-005.d2 figures/D2L-03-005.png
python3 tools/svg-pdf.py figures/D2L-03-005.svg figures/D2L-03-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set filled to true.

D2L-03-006

Label both ends

Endpoint labels keep multiplicity beside the object it qualifies. Use them when a centered verb alone cannot explain the relationship.

Back to diagram overview

Compare with D2L-03-005 · Outline an ownership marker.

D2 source

direction: right
batch -> sample: contains {source-arrowhead: "1"; target-arrowhead: "1..n"}
ParameterMeaning in this example
source-arrowhead: "1"Label the batch end.
target-arrowhead: "1..n"Label the sample end.

Render this diagram

tools/d2 fmt examples/D2L-03-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-006 --target '' examples/D2L-03-006.d2 figures/D2L-03-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-006 --target '' examples/D2L-03-006.d2 figures/D2L-03-006.png
python3 tools/svg-pdf.py figures/D2L-03-006.svg figures/D2L-03-006.pdf

Try changing: Change 1..n to 0..n.

Actual output

Label both ends
D2L-03-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-03-006.d2 to figures/D2L-03-006.svg in 2.375334ms

success: successfully compiled examples/D2L-03-006.d2 to figures/D2L-03-006.png in 4.803917ms
Render this diagram
tools/d2 fmt examples/D2L-03-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-006 --target '' examples/D2L-03-006.d2 figures/D2L-03-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-03-006 --target '' examples/D2L-03-006.d2 figures/D2L-03-006.png
python3 tools/svg-pdf.py figures/D2L-03-006.svg figures/D2L-03-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change 1..n to 0..n.

04 · Containers and nesting

Make ownership boundaries explicit while keeping each object identity unambiguous.

Reference: Official D2 documentation.

D2L-04-001

Group the intake work

A map with children draws a container around related work. Use one boundary when the same team owns collection and labeling.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

intake: Field intake {collect -> tag}
ParameterMeaning in this example
intake: { ... }Create a named container with two children.

Render this diagram

tools/d2 fmt examples/D2L-04-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-001 --target '' examples/D2L-04-001.d2 figures/D2L-04-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-001 --target '' examples/D2L-04-001.d2 figures/D2L-04-001.png
python3 tools/svg-pdf.py figures/D2L-04-001.svg figures/D2L-04-001.pdf

Try changing: Rename the container to Mobile team.

Actual output

Group the intake work
D2L-04-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-001.d2 to figures/D2L-04-001.svg in 2.327208ms

success: successfully compiled examples/D2L-04-001.d2 to figures/D2L-04-001.png in 5.615292ms
Render this diagram
tools/d2 fmt examples/D2L-04-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-001 --target '' examples/D2L-04-001.d2 figures/D2L-04-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-001 --target '' examples/D2L-04-001.d2 figures/D2L-04-001.png
python3 tools/svg-pdf.py figures/D2L-04-001.svg figures/D2L-04-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename the container to Mobile team.

D2L-04-002

Nest a review station

Nested containers show a second ownership level. Use them when a quality station belongs to a larger laboratory boundary.

Back to diagram overview

Compare with D2L-04-001 · Group the intake work.

D2 source

lab: Laboratory {quality: Quality station {inspect -> approve}}
ParameterMeaning in this example
lab.qualityGive the inner station an identity inside the laboratory.

Render this diagram

tools/d2 fmt examples/D2L-04-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-002 --target '' examples/D2L-04-002.d2 figures/D2L-04-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-002 --target '' examples/D2L-04-002.d2 figures/D2L-04-002.png
python3 tools/svg-pdf.py figures/D2L-04-002.svg figures/D2L-04-002.pdf

Try changing: Add reject beside approve inside quality.

Actual output

Nest a review station
D2L-04-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-002.d2 to figures/D2L-04-002.svg in 3.072084ms

success: successfully compiled examples/D2L-04-002.d2 to figures/D2L-04-002.png in 8.280709ms
Render this diagram
tools/d2 fmt examples/D2L-04-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-002 --target '' examples/D2L-04-002.d2 figures/D2L-04-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-002 --target '' examples/D2L-04-002.d2 figures/D2L-04-002.png
python3 tools/svg-pdf.py figures/D2L-04-002.svg figures/D2L-04-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add reject beside approve inside quality.

D2L-04-003

Address a child by path

Dot paths address children without reopening every enclosing map. Use them when a later part of the file adds a handoff to an established boundary.

Back to diagram overview

Compare with D2L-04-002 · Nest a review station.

D2 source

field.collect: Collect
lab.review: Review
field.collect -> lab.review: hand off
ParameterMeaning in this example
field.collectCreate or reference collect inside field.

Render this diagram

tools/d2 fmt examples/D2L-04-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-003 --target '' examples/D2L-04-003.d2 figures/D2L-04-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-003 --target '' examples/D2L-04-003.d2 figures/D2L-04-003.png
python3 tools/svg-pdf.py figures/D2L-04-003.svg figures/D2L-04-003.pdf

Try changing: Change lab.review to lab.inspect in both lines.

Actual output

Address a child by path
D2L-04-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-003.d2 to figures/D2L-04-003.svg in 3.684042ms

success: successfully compiled examples/D2L-04-003.d2 to figures/D2L-04-003.png in 8.083875ms
Render this diagram
tools/d2 fmt examples/D2L-04-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-003 --target '' examples/D2L-04-003.d2 figures/D2L-04-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-003 --target '' examples/D2L-04-003.d2 figures/D2L-04-003.png
python3 tools/svg-pdf.py figures/D2L-04-003.svg figures/D2L-04-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change lab.review to lab.inspect in both lines.

D2L-04-004

Connect two boundaries

Connecting containers summarizes collaboration at a higher level. Use this view when the internal steps would distract from the team handoff.

Back to diagram overview

Compare with D2L-04-003 · Address a child by path.

D2 source

direction: right
field: {collect}
lab: {review}
field -> lab: deliver batch
ParameterMeaning in this example
field -> labAttach the relationship to the containers themselves.

Render this diagram

tools/d2 fmt examples/D2L-04-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-004 --target '' examples/D2L-04-004.d2 figures/D2L-04-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-004 --target '' examples/D2L-04-004.d2 figures/D2L-04-004.png
python3 tools/svg-pdf.py figures/D2L-04-004.svg figures/D2L-04-004.pdf

Try changing: Connect field.collect to lab.review instead.

Actual output

Connect two boundaries
D2L-04-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-004.d2 to figures/D2L-04-004.svg in 3.488792ms

success: successfully compiled examples/D2L-04-004.d2 to figures/D2L-04-004.png in 8.494791ms
Render this diagram
tools/d2 fmt examples/D2L-04-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-004 --target '' examples/D2L-04-004.d2 figures/D2L-04-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-004 --target '' examples/D2L-04-004.d2 figures/D2L-04-004.png
python3 tools/svg-pdf.py figures/D2L-04-004.svg figures/D2L-04-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Connect field.collect to lab.review instead.

D2L-04-005

Refer to the parent scope

The underscore steps out of the current container. Use it to connect a local collector to a sibling service without repeating the outer path.

Back to diagram overview

Compare with D2L-04-004 · Connect two boundaries.

D2 source

archive: Archive
field: Field team {collect -> _.archive: submit}
ParameterMeaning in this example
_.archiveResolve archive in the parent scope.

Render this diagram

tools/d2 fmt examples/D2L-04-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-005 --target '' examples/D2L-04-005.d2 figures/D2L-04-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-005 --target '' examples/D2L-04-005.d2 figures/D2L-04-005.png
python3 tools/svg-pdf.py figures/D2L-04-005.svg figures/D2L-04-005.pdf

Try changing: Add field.tag and connect it to _.archive.

Actual output

Refer to the parent scope
D2L-04-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-005.d2 to figures/D2L-04-005.svg in 3.017249ms

success: successfully compiled examples/D2L-04-005.d2 to figures/D2L-04-005.png in 7.024959ms
Render this diagram
tools/d2 fmt examples/D2L-04-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-005 --target '' examples/D2L-04-005.d2 figures/D2L-04-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-005 --target '' examples/D2L-04-005.d2 figures/D2L-04-005.png
python3 tools/svg-pdf.py figures/D2L-04-005.svg figures/D2L-04-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add field.tag and connect it to _.archive.

D2L-04-006

Keep repeated local names distinct

The same child key can appear in different containers. Use qualified paths to show a transfer between two independent review stations.

Back to diagram overview

Compare with D2L-04-005 · Refer to the parent scope.

D2 source

direction: right
field: {review: Field review}
lab: {review: Lab review}
field.review -> lab.review: escalate
ParameterMeaning in this example
field.review / lab.reviewKeep two review objects distinct through their scope.

Render this diagram

tools/d2 fmt examples/D2L-04-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-006 --target '' examples/D2L-04-006.d2 figures/D2L-04-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-006 --target '' examples/D2L-04-006.d2 figures/D2L-04-006.png
python3 tools/svg-pdf.py figures/D2L-04-006.svg figures/D2L-04-006.pdf

Try changing: Rename only Lab review to Specialist review.

Actual output

Keep repeated local names distinct
D2L-04-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-04-006.d2 to figures/D2L-04-006.svg in 3.268626ms

success: successfully compiled examples/D2L-04-006.d2 to figures/D2L-04-006.png in 8.652167ms
Render this diagram
tools/d2 fmt examples/D2L-04-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-006 --target '' examples/D2L-04-006.d2 figures/D2L-04-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-04-006 --target '' examples/D2L-04-006.d2 figures/D2L-04-006.png
python3 tools/svg-pdf.py figures/D2L-04-006.svg figures/D2L-04-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename only Lab review to Specialist review.

05 · Styles and fill patterns

Use a small number of visual cues to distinguish status, uncertainty and repeated work.

Reference: Official D2 documentation.

D2L-05-001

Highlight accepted work

Fill and stroke can emphasize a state without changing the process. Use a readable border and a light interior when acceptance needs to stand out in print.

Back to diagram overview

D2 source

review -> accepted
accepted.style: {fill: "#d9eee7"; stroke: "#20594a"}
ParameterMeaning in this example
style.fill / style.strokeSet interior and outline colors explicitly.

Render this diagram

tools/d2 fmt examples/D2L-05-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-001 --target '' examples/D2L-05-001.d2 figures/D2L-05-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-001 --target '' examples/D2L-05-001.d2 figures/D2L-05-001.png
python3 tools/svg-pdf.py figures/D2L-05-001.svg figures/D2L-05-001.pdf

Try changing: Change the accepted fill to #fff0c2.

Actual output

Highlight accepted work
D2L-05-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-001.d2 to figures/D2L-05-001.svg in 2.006251ms

success: successfully compiled examples/D2L-05-001.d2 to figures/D2L-05-001.png in 3.652459ms
Render this diagram
tools/d2 fmt examples/D2L-05-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-001 --target '' examples/D2L-05-001.d2 figures/D2L-05-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-001 --target '' examples/D2L-05-001.d2 figures/D2L-05-001.png
python3 tools/svg-pdf.py figures/D2L-05-001.svg figures/D2L-05-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Compare with Graphviz · emphasize a process with color.

Try changing: Change the accepted fill to #fff0c2.

D2L-05-002

Distinguish a proposed route

Dashed strokes separate a proposed connection from the active route. Use a nearby label so the meaning survives a monochrome copy.

Back to diagram overview

Compare with D2L-05-001 · Highlight accepted work.

D2 source

direction: right
collect -> archive: active
collect -> backup: proposed {style.stroke-dash: 4}
ParameterMeaning in this example
style.stroke-dash: 4Draw the proposed connection with a dashed stroke.

Render this diagram

tools/d2 fmt examples/D2L-05-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-002 --target '' examples/D2L-05-002.d2 figures/D2L-05-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-002 --target '' examples/D2L-05-002.d2 figures/D2L-05-002.png
python3 tools/svg-pdf.py figures/D2L-05-002.svg figures/D2L-05-002.pdf

Try changing: Set stroke-dash to 0.

Actual output

Distinguish a proposed route
D2L-05-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-002.d2 to figures/D2L-05-002.svg in 2.556416ms

success: successfully compiled examples/D2L-05-002.d2 to figures/D2L-05-002.png in 7.19075ms
Render this diagram
tools/d2 fmt examples/D2L-05-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-002 --target '' examples/D2L-05-002.d2 figures/D2L-05-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-002 --target '' examples/D2L-05-002.d2 figures/D2L-05-002.png
python3 tools/svg-pdf.py figures/D2L-05-002.svg figures/D2L-05-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set stroke-dash to 0.

D2L-05-003

Soften a retired station

Opacity reduces visual weight while preserving context. Use it for an old station that readers still need to recognize.

Back to diagram overview

Compare with D2L-05-002 · Distinguish a proposed route.

D2 source

direction: right
old: Retired station {style.opacity: 0.4}
new: Current station
old -> new: migrate
ParameterMeaning in this example
style.opacity: 0.4Draw the retired object at forty percent opacity.

Render this diagram

tools/d2 fmt examples/D2L-05-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-003 --target '' examples/D2L-05-003.d2 figures/D2L-05-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-003 --target '' examples/D2L-05-003.d2 figures/D2L-05-003.png
python3 tools/svg-pdf.py figures/D2L-05-003.svg figures/D2L-05-003.pdf

Try changing: Raise opacity to 0.8.

Actual output

Soften a retired station
D2L-05-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-003.d2 to figures/D2L-05-003.svg in 2.575834ms

success: successfully compiled examples/D2L-05-003.d2 to figures/D2L-05-003.png in 5.416958ms
Render this diagram
tools/d2 fmt examples/D2L-05-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-003 --target '' examples/D2L-05-003.d2 figures/D2L-05-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-003 --target '' examples/D2L-05-003.d2 figures/D2L-05-003.png
python3 tools/svg-pdf.py figures/D2L-05-003.svg figures/D2L-05-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Raise opacity to 0.8.

D2L-05-004

Texture an uncertain store

A fill pattern adds a cue that does not depend on hue. Use it to mark a staging store whose contents are still awaiting review.

Back to diagram overview

Compare with D2L-05-003 · Soften a retired station.

D2 source

staging: Awaiting review {shape: cylinder; style: {fill: "#fff1d6"; fill-pattern: lines}}
ParameterMeaning in this example
style.fill-pattern: linesOverlay a line pattern on the light fill.

Render this diagram

tools/d2 fmt examples/D2L-05-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-004 --target '' examples/D2L-05-004.d2 figures/D2L-05-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-004 --target '' examples/D2L-05-004.d2 figures/D2L-05-004.png
python3 tools/svg-pdf.py figures/D2L-05-004.svg figures/D2L-05-004.pdf

Try changing: Try dots, then grain as the fill-pattern.

Actual output

Texture an uncertain store
D2L-05-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-004.d2 to figures/D2L-05-004.svg in 1.59375ms

success: successfully compiled examples/D2L-05-004.d2 to figures/D2L-05-004.png in 7.400167ms
Render this diagram
tools/d2 fmt examples/D2L-05-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-004 --target '' examples/D2L-05-004.d2 figures/D2L-05-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-004 --target '' examples/D2L-05-004.d2 figures/D2L-05-004.png
python3 tools/svg-pdf.py figures/D2L-05-004.svg figures/D2L-05-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Try dots, then grain as the fill-pattern.

D2L-05-005

Lift the current release

Shadow suggests visual emphasis without adding a new process object. Use it sparingly for the one deliverable readers should locate first.

Back to diagram overview

Compare with D2L-05-004 · Texture an uncertain store.

D2 source

release: Current release {style.shadow: true}
ParameterMeaning in this example
style.shadow: trueDraw a shadow behind the release object.

Render this diagram

tools/d2 fmt examples/D2L-05-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-005 --target '' examples/D2L-05-005.d2 figures/D2L-05-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-005 --target '' examples/D2L-05-005.d2 figures/D2L-05-005.png
python3 tools/svg-pdf.py figures/D2L-05-005.svg figures/D2L-05-005.pdf

Try changing: Set shadow to false.

Actual output

Lift the current release
D2L-05-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-005.d2 to figures/D2L-05-005.svg in 1.854583ms

success: successfully compiled examples/D2L-05-005.d2 to figures/D2L-05-005.png in 3.38125ms
Render this diagram
tools/d2 fmt examples/D2L-05-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-005 --target '' examples/D2L-05-005.d2 figures/D2L-05-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-005 --target '' examples/D2L-05-005.d2 figures/D2L-05-005.png
python3 tools/svg-pdf.py figures/D2L-05-005.svg figures/D2L-05-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set shadow to false.

D2L-05-006

Suggest a stack and depth

Multiple and three-dimensional treatments are decorative cues for repeated artifacts and infrastructure. Use labeled objects so neither effect becomes the only way to infer meaning.

Back to diagram overview

Compare with D2L-05-005 · Lift the current release.

D2 source

direction: right
forms: Batch of forms {style.multiple: true}
server: Archive host {style.3d: true}
forms -> server: ingest
ParameterMeaning in this example
style.multiple: trueDraw stacked outlines behind the form object.
style.3d: trueGive the rectangular host an extruded outline.

Render this diagram

tools/d2 fmt examples/D2L-05-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-006 --target '' examples/D2L-05-006.d2 figures/D2L-05-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-006 --target '' examples/D2L-05-006.d2 figures/D2L-05-006.png
python3 tools/svg-pdf.py figures/D2L-05-006.svg figures/D2L-05-006.pdf

Try changing: Turn off 3d while leaving multiple on.

Actual output

Suggest a stack and depth
D2L-05-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-05-006.d2 to figures/D2L-05-006.svg in 1.786542ms

success: successfully compiled examples/D2L-05-006.d2 to figures/D2L-05-006.png in 5.826167ms
Render this diagram
tools/d2 fmt examples/D2L-05-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-006 --target '' examples/D2L-05-006.d2 figures/D2L-05-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-05-006 --target '' examples/D2L-05-006.d2 figures/D2L-05-006.png
python3 tools/svg-pdf.py figures/D2L-05-006.svg figures/D2L-05-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Turn off 3d while leaving multiple on.

06 · Classes, themes and sketch mode

Reuse a visual vocabulary while keeping the tour on one theme.

Reference: Official D2 documentation.

D2L-06-001

Define a reusable task style

A class gives a repeated visual rule a name. Use it when several archive activities should share the same fill and outline.

Back to diagram overview

Compare with D2L-05-001 · Highlight accepted work.

D2 source

classes: {task: {style.fill: "#e0f2f1"; style.stroke: "#0b6775"}}
collect: {class: task}
review: {class: task}
collect -> review
ParameterMeaning in this example
classes.taskDefine the task class once.
class: taskApply that class to an object.

Render this diagram

tools/d2 fmt examples/D2L-06-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-001 --target '' examples/D2L-06-001.d2 figures/D2L-06-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-001 --target '' examples/D2L-06-001.d2 figures/D2L-06-001.png
python3 tools/svg-pdf.py figures/D2L-06-001.svg figures/D2L-06-001.pdf

Try changing: Change the task fill in one place.

Actual output

Define a reusable task style
D2L-06-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-001.d2 to figures/D2L-06-001.svg in 2.146708ms

success: successfully compiled examples/D2L-06-001.d2 to figures/D2L-06-001.png in 3.61275ms
Render this diagram
tools/d2 fmt examples/D2L-06-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-001 --target '' examples/D2L-06-001.d2 figures/D2L-06-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-001 --target '' examples/D2L-06-001.d2 figures/D2L-06-001.png
python3 tools/svg-pdf.py figures/D2L-06-001.svg figures/D2L-06-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the task fill in one place.

D2L-06-002

Reuse a style across roles

A class can style different object shapes. Use that separation when status should look consistent across a task and a store.

Back to diagram overview

Compare with D2L-06-001 · Define a reusable task style.

D2 source

classes: {ready: {style.fill: "#e0f2f1"}}
review: {class: ready}
archive: {shape: cylinder; class: ready}
review -> archive
ParameterMeaning in this example
class: readyReuse a status style independently of object shape.

Render this diagram

tools/d2 fmt examples/D2L-06-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-002 --target '' examples/D2L-06-002.d2 figures/D2L-06-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-002 --target '' examples/D2L-06-002.d2 figures/D2L-06-002.png
python3 tools/svg-pdf.py figures/D2L-06-002.svg figures/D2L-06-002.pdf

Try changing: Apply ready only to archive.

Actual output

Reuse a style across roles
D2L-06-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-002.d2 to figures/D2L-06-002.svg in 1.912792ms

success: successfully compiled examples/D2L-06-002.d2 to figures/D2L-06-002.png in 4.682084ms
Render this diagram
tools/d2 fmt examples/D2L-06-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-002 --target '' examples/D2L-06-002.d2 figures/D2L-06-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-002 --target '' examples/D2L-06-002.d2 figures/D2L-06-002.png
python3 tools/svg-pdf.py figures/D2L-06-002.svg figures/D2L-06-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Apply ready only to archive.

D2L-06-003

Combine named classes

An ordered list combines reusable class definitions. Use it to layer the current-state emphasis over a common task appearance.

Back to diagram overview

Compare with D2L-06-002 · Reuse a style across roles.

D2 source

classes: {task: {style.fill: "#e0f2f1"}; current: {style.stroke-width: 4}}
review: {class: [task; current]}
ParameterMeaning in this example
class: [task; current]Apply the task class and then the current class.

Render this diagram

tools/d2 fmt examples/D2L-06-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-003 --target '' examples/D2L-06-003.d2 figures/D2L-06-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-003 --target '' examples/D2L-06-003.d2 figures/D2L-06-003.png
python3 tools/svg-pdf.py figures/D2L-06-003.svg figures/D2L-06-003.pdf

Try changing: Remove current from the list.

Actual output

Combine named classes
D2L-06-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-003.d2 to figures/D2L-06-003.svg in 1.641ms

success: successfully compiled examples/D2L-06-003.d2 to figures/D2L-06-003.png in 2.726292ms
Render this diagram
tools/d2 fmt examples/D2L-06-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-003 --target '' examples/D2L-06-003.d2 figures/D2L-06-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-003 --target '' examples/D2L-06-003.d2 figures/D2L-06-003.png
python3 tools/svg-pdf.py figures/D2L-06-003.svg figures/D2L-06-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Remove current from the list.

D2L-06-004

Override one instance

A local style can specialize one object that uses a shared class. Use it for an exception while retaining the common task definition.

Back to diagram overview

Compare with D2L-06-003 · Combine named classes.

D2 source

classes: {task: {style.fill: "#e0f2f1"}}
collect: {class: task}
review: {class: task; style.fill: "#fff1d6"}
collect -> review
ParameterMeaning in this example
style.fill on reviewOverride the class fill for this instance.

Render this diagram

tools/d2 fmt examples/D2L-06-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-004 --target '' examples/D2L-06-004.d2 figures/D2L-06-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-004 --target '' examples/D2L-06-004.d2 figures/D2L-06-004.png
python3 tools/svg-pdf.py figures/D2L-06-004.svg figures/D2L-06-004.pdf

Try changing: Remove the local review fill.

Actual output

Override one instance
D2L-06-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-004.d2 to figures/D2L-06-004.svg in 1.835334ms

success: successfully compiled examples/D2L-06-004.d2 to figures/D2L-06-004.png in 3.333333ms
Render this diagram
tools/d2 fmt examples/D2L-06-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-004 --target '' examples/D2L-06-004.d2 figures/D2L-06-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-004 --target '' examples/D2L-06-004.d2 figures/D2L-06-004.png
python3 tools/svg-pdf.py figures/D2L-06-004.svg figures/D2L-06-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Remove the local review fill.

D2L-06-005

Pin the palette in the source

The embedded D2 configuration can declare the same theme used by the shared command. Use it when a downloaded source should state its palette explicitly.

Back to diagram overview

Compare with D2L-06-004 · Override one instance.

D2 source

vars: {d2-config: {theme-id: 0}}
collect -> archive
ParameterMeaning in this example
vars.d2-config.theme-id: 0Declare the shared theme without introducing a second palette.

Render this diagram

tools/d2 fmt examples/D2L-06-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-005 --target '' examples/D2L-06-005.d2 figures/D2L-06-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-005 --target '' examples/D2L-06-005.d2 figures/D2L-06-005.png
python3 tools/svg-pdf.py figures/D2L-06-005.svg figures/D2L-06-005.pdf

Try changing: Add a local archive fill while retaining theme-id 0.

Actual output

Pin the palette in the source
D2L-06-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-005.d2 to figures/D2L-06-005.svg in 1.83975ms

success: successfully compiled examples/D2L-06-005.d2 to figures/D2L-06-005.png in 3.372875ms
Render this diagram
tools/d2 fmt examples/D2L-06-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-005 --target '' examples/D2L-06-005.d2 figures/D2L-06-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-005 --target '' examples/D2L-06-005.d2 figures/D2L-06-005.png
python3 tools/svg-pdf.py figures/D2L-06-005.svg figures/D2L-06-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a local archive fill while retaining theme-id 0.

D2L-06-006

Sketch an early proposal

Sketch mode changes the treatment of lines and lettering. Use it to signal an exploratory proposal while keeping the underlying graph and theme fixed.

Back to diagram overview

Compare with D2L-06-005 · Pin the palette in the source.

D2 source

vars: {d2-config: {sketch: true}}
direction: right
collect -> review -> archive
ParameterMeaning in this example
vars.d2-config.sketch: trueUse the built-in sketch renderer for this example.

Render this diagram

tools/d2 fmt examples/D2L-06-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-006 --target '' examples/D2L-06-006.d2 figures/D2L-06-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-006 --target '' examples/D2L-06-006.d2 figures/D2L-06-006.png
python3 tools/svg-pdf.py figures/D2L-06-006.svg figures/D2L-06-006.pdf

Try changing: Set sketch to false.

Actual output

Sketch an early proposal
D2L-06-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-06-006.d2 to figures/D2L-06-006.svg in 2.482042ms

success: successfully compiled examples/D2L-06-006.d2 to figures/D2L-06-006.png in 12.659209ms
Render this diagram
tools/d2 fmt examples/D2L-06-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-006 --target '' examples/D2L-06-006.d2 figures/D2L-06-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-06-006 --target '' examples/D2L-06-006.d2 figures/D2L-06-006.png
python3 tools/svg-pdf.py figures/D2L-06-006.svg figures/D2L-06-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set sketch to false.

07 · Text: Markdown, LaTeX, code

Choose the smallest text notation that carries the explanation a reader needs.

Reference: Official D2 documentation.

D2L-07-001

Format a field note

A Markdown block supports emphasis and a short list. Use it for a note whose structure matters more than a geometric outline.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

note: |md
  ## Sample checklist
  - Label the vial
  - Record the **site**
|
ParameterMeaning in this example
|md ... |Render a Markdown label; the block is complete.

Render this diagram

tools/d2 fmt examples/D2L-07-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-001 --target '' examples/D2L-07-001.d2 figures/D2L-07-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-001 --target '' examples/D2L-07-001.d2 figures/D2L-07-001.png
python3 tools/svg-pdf.py figures/D2L-07-001.svg figures/D2L-07-001.pdf

Try changing: Add one checklist item.

Actual output

Format a field note
D2L-07-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-001.d2 to figures/D2L-07-001.svg in 3.972542ms

success: successfully compiled examples/D2L-07-001.d2 to figures/D2L-07-001.png in 7.618ms
Render this diagram
tools/d2 fmt examples/D2L-07-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-001 --target '' examples/D2L-07-001.d2 figures/D2L-07-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-001 --target '' examples/D2L-07-001.d2 figures/D2L-07-001.png
python3 tools/svg-pdf.py figures/D2L-07-001.svg figures/D2L-07-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add one checklist item.

D2L-07-002

Write a mathematical condition

A LaTeX block typesets a compact formula. Use it when the acceptance rule is easier to read as notation than as prose.

Back to diagram overview

Compare with D2L-07-001 · Format a field note.

D2 source

threshold: |latex
  q \geq 0.95
|
ParameterMeaning in this example
|latex ... |Typeset q, the illustrative sample quality score, with threshold 0.95.

Render this diagram

tools/d2 fmt examples/D2L-07-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-002 --target '' examples/D2L-07-002.d2 figures/D2L-07-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-002 --target '' examples/D2L-07-002.d2 figures/D2L-07-002.png
python3 tools/svg-pdf.py figures/D2L-07-002.svg figures/D2L-07-002.pdf

Try changing: Change 0.95 to 0.90.

Actual output

Write a mathematical condition
D2L-07-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-002.d2 to figures/D2L-07-002.svg in 1.327334ms

success: successfully compiled examples/D2L-07-002.d2 to figures/D2L-07-002.png in 1.490667ms
Render this diagram
tools/d2 fmt examples/D2L-07-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-002 --target '' examples/D2L-07-002.d2 figures/D2L-07-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-002 --target '' examples/D2L-07-002.d2 figures/D2L-07-002.png
python3 tools/svg-pdf.py figures/D2L-07-002.svg figures/D2L-07-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change 0.95 to 0.90.

D2L-07-003

Show a query as code

A language-tagged block preserves source layout and highlights its syntax. Use it to identify the query an archive component executes.

Back to diagram overview

Compare with D2L-07-002 · Write a mathematical condition.

D2 source

query: |sql
  SELECT id, site
  FROM sample
  ORDER BY id;
|
ParameterMeaning in this example
|sql ... |Render a complete SQL query as a code label.

Render this diagram

tools/d2 fmt examples/D2L-07-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-003 --target '' examples/D2L-07-003.d2 figures/D2L-07-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-003 --target '' examples/D2L-07-003.d2 figures/D2L-07-003.png
python3 tools/svg-pdf.py figures/D2L-07-003.svg figures/D2L-07-003.pdf

Try changing: Select only id.

Actual output

Show a query as code
D2L-07-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-003.d2 to figures/D2L-07-003.svg in 5.038375ms

success: successfully compiled examples/D2L-07-003.d2 to figures/D2L-07-003.png in 6.052792ms
Render this diagram
tools/d2 fmt examples/D2L-07-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-003 --target '' examples/D2L-07-003.d2 figures/D2L-07-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-003 --target '' examples/D2L-07-003.d2 figures/D2L-07-003.png
python3 tools/svg-pdf.py figures/D2L-07-003.svg figures/D2L-07-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Select only id.

D2L-07-004

Put formatted text inside an object

A rich label can remain attached to an ordinary shape. Use it when a component needs a short emphasized responsibility.

Back to diagram overview

Compare with D2L-07-003 · Show a query as code.

D2 source

archive: {
  label: |md
    **Field archive**

    Stores reviewed records
  |
  shape: rectangle
}
ParameterMeaning in this example
label: |mdKeep the rectangle and render Markdown inside its label.

Render this diagram

tools/d2 fmt examples/D2L-07-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-004 --target '' examples/D2L-07-004.d2 figures/D2L-07-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-004 --target '' examples/D2L-07-004.d2 figures/D2L-07-004.png
python3 tools/svg-pdf.py figures/D2L-07-004.svg figures/D2L-07-004.pdf

Try changing: Change Stores to Publishes.

Actual output

Put formatted text inside an object
D2L-07-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-004.d2 to figures/D2L-07-004.svg in 3.035792ms

success: successfully compiled examples/D2L-07-004.d2 to figures/D2L-07-004.png in 5.599333ms
Render this diagram
tools/d2 fmt examples/D2L-07-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-004 --target '' examples/D2L-07-004.d2 figures/D2L-07-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-004 --target '' examples/D2L-07-004.d2 figures/D2L-07-004.png
python3 tools/svg-pdf.py figures/D2L-07-004.svg figures/D2L-07-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change Stores to Publishes.

D2L-07-005

Explain a transfer with Markdown

Rich text is also available on a connection label in this pinned version. Use a short emphasized transfer name when it helps distinguish a handoff.

Back to diagram overview

Compare with D2L-07-004 · Put formatted text inside an object.

D2 source

direction: right
collector -> archive: |md
  **Reviewed** batch
|
ParameterMeaning in this example
Markdown connection labelAttach formatted text to the edge, rather than to a new node.

Render this diagram

tools/d2 fmt examples/D2L-07-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-005 --target '' examples/D2L-07-005.d2 figures/D2L-07-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-005 --target '' examples/D2L-07-005.d2 figures/D2L-07-005.png
python3 tools/svg-pdf.py figures/D2L-07-005.svg figures/D2L-07-005.pdf

Try changing: Replace Reviewed with Signed.

Actual output

Explain a transfer with Markdown
D2L-07-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-005.d2 to figures/D2L-07-005.svg in 3.236999ms

success: successfully compiled examples/D2L-07-005.d2 to figures/D2L-07-005.png in 6.043875ms
Render this diagram
tools/d2 fmt examples/D2L-07-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-005 --target '' examples/D2L-07-005.d2 figures/D2L-07-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-005 --target '' examples/D2L-07-005.d2 figures/D2L-07-005.png
python3 tools/svg-pdf.py figures/D2L-07-005.svg figures/D2L-07-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Replace Reviewed with Signed.

D2L-07-006

Label connections with math and code

Math and code blocks can annotate what a connection carries. Use them sparingly so an edge remains readable at the size of the final diagram.

Back to diagram overview

Compare with D2L-07-005 · Explain a transfer with Markdown.

D2 source

direction: right
measure -> review: |latex
  q \geq 0.95
|
review -> archive: |json
  {"accepted": true}
|
ParameterMeaning in this example
LaTeX edge labelDisplay the threshold on the review edge.
JSON edge labelDisplay a complete JSON object on the archive edge.

Render this diagram

tools/d2 fmt examples/D2L-07-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-006 --target '' examples/D2L-07-006.d2 figures/D2L-07-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-006 --target '' examples/D2L-07-006.d2 figures/D2L-07-006.png
python3 tools/svg-pdf.py figures/D2L-07-006.svg figures/D2L-07-006.pdf

Try changing: Change the JSON value to false.

Actual output

Label connections with math and code
D2L-07-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-07-006.d2 to figures/D2L-07-006.svg in 3.02475ms

success: successfully compiled examples/D2L-07-006.d2 to figures/D2L-07-006.png in 7.35825ms
Render this diagram
tools/d2 fmt examples/D2L-07-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-006 --target '' examples/D2L-07-006.d2 figures/D2L-07-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-07-006 --target '' examples/D2L-07-006.d2 figures/D2L-07-006.png
python3 tools/svg-pdf.py figures/D2L-07-006.svg figures/D2L-07-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the JSON value to false.

08 · Icons and images

Use original local artwork while keeping every figure independent of remote assets.

Reference: Official D2 documentation.

D2L-08-001

Attach a local icon

An icon decorates an object without replacing its label. Use the bundled field mark when a small visual cue helps readers find the archive.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

archive: Field archive {icon: ../assets/field-mark.png}
ParameterMeaning in this example
icon: ../assets/field-mark.pngResolve the local image relative to the source in examples/.

Render this diagram

tools/d2 fmt examples/D2L-08-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-001 --target '' examples/D2L-08-001.d2 figures/D2L-08-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-001 --target '' examples/D2L-08-001.d2 figures/D2L-08-001.png
python3 tools/svg-pdf.py figures/D2L-08-001.svg figures/D2L-08-001.pdf

Try changing: Rename Field archive to Regional archive.

Actual output

Attach a local icon
D2L-08-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-08-001.d2 to figures/D2L-08-001.svg in 2.638084ms

success: successfully compiled examples/D2L-08-001.d2 to figures/D2L-08-001.png in 5.710541ms
Render this diagram
tools/d2 fmt examples/D2L-08-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-001 --target '' examples/D2L-08-001.d2 figures/D2L-08-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-001 --target '' examples/D2L-08-001.d2 figures/D2L-08-001.png
python3 tools/svg-pdf.py figures/D2L-08-001.svg figures/D2L-08-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename Field archive to Regional archive.

D2L-08-002

Place the icon deliberately

Icon placement controls the relationship between the cue and the object label. Use an outside position when a compact object needs its interior for text.

Back to diagram overview

Compare with D2L-08-001 · Attach a local icon.

D2 source

archive: Field archive {icon: ../assets/field-mark.png; icon.near: outside-top-center}
ParameterMeaning in this example
icon.near: outside-top-centerPlace the icon above the object.

Render this diagram

tools/d2 fmt examples/D2L-08-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-002 --target '' examples/D2L-08-002.d2 figures/D2L-08-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-002 --target '' examples/D2L-08-002.d2 figures/D2L-08-002.png
python3 tools/svg-pdf.py figures/D2L-08-002.svg figures/D2L-08-002.pdf

Try changing: Try outside-left-center.

Actual output

Place the icon deliberately
D2L-08-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-08-002.d2 to figures/D2L-08-002.svg in 2.794666ms

success: successfully compiled examples/D2L-08-002.d2 to figures/D2L-08-002.png in 5.60425ms
Render this diagram
tools/d2 fmt examples/D2L-08-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-002 --target '' examples/D2L-08-002.d2 figures/D2L-08-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-002 --target '' examples/D2L-08-002.d2 figures/D2L-08-002.png
python3 tools/svg-pdf.py figures/D2L-08-002.svg figures/D2L-08-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Try outside-left-center.

D2L-08-003

Use the image as the object

The image shape displays the artwork itself as the main object. Use it for a local visual asset whose surrounding box would add no meaning.

Back to diagram overview

Compare with D2L-08-002 · Place the icon deliberately.

D2 source

mark: Archive mark {shape: image; icon: ../assets/field-mark.png; width: 96; height: 96}
ParameterMeaning in this example
shape: imageUse the local bitmap as the object.
width / heightReserve a 96 by 96 pixel image area.

Render this diagram

tools/d2 fmt examples/D2L-08-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-003 --target '' examples/D2L-08-003.d2 figures/D2L-08-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-003 --target '' examples/D2L-08-003.d2 figures/D2L-08-003.png
python3 tools/svg-pdf.py figures/D2L-08-003.svg figures/D2L-08-003.pdf

Try changing: Set width and height to 128.

Actual output

Use the image as the object
D2L-08-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-08-003.d2 to figures/D2L-08-003.svg in 2.806375ms

success: successfully compiled examples/D2L-08-003.d2 to figures/D2L-08-003.png in 8.954917ms
Render this diagram
tools/d2 fmt examples/D2L-08-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-003 --target '' examples/D2L-08-003.d2 figures/D2L-08-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-003 --target '' examples/D2L-08-003.d2 figures/D2L-08-003.png
python3 tools/svg-pdf.py figures/D2L-08-003.svg figures/D2L-08-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set width and height to 128.

D2L-08-004

Mark a transfer with an icon

A connection can carry a local icon as well as text. Use it for a recognizable artifact transferred between field collection and storage.

Back to diagram overview

Compare with D2L-08-003 · Use the image as the object.

D2 source

direction: right
collector -> archive: sample {icon: ../assets/field-mark.png}
ParameterMeaning in this example
icon on a connectionAttach the bundled mark to the sample transfer.

Render this diagram

tools/d2 fmt examples/D2L-08-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-004 --target '' examples/D2L-08-004.d2 figures/D2L-08-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-004 --target '' examples/D2L-08-004.d2 figures/D2L-08-004.png
python3 tools/svg-pdf.py figures/D2L-08-004.svg figures/D2L-08-004.pdf

Try changing: Change the transfer label to reviewed sample.

Actual output

Mark a transfer with an icon
D2L-08-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-08-004.d2 to figures/D2L-08-004.svg in 3.411625ms

success: successfully compiled examples/D2L-08-004.d2 to figures/D2L-08-004.png in 6.669292ms
Render this diagram
tools/d2 fmt examples/D2L-08-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-004 --target '' examples/D2L-08-004.d2 figures/D2L-08-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-08-004 --target '' examples/D2L-08-004.d2 figures/D2L-08-004.png
python3 tools/svg-pdf.py figures/D2L-08-004.svg figures/D2L-08-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the transfer label to reviewed sample.

09 · SQL tables and UML classes

Describe record structure separately from executable SQL and distinguish it from object behavior. Compare table diagrams with the SQLite schema examples and classes with Mermaid classes.

Reference: Official D2 documentation.

D2L-09-001

List a table structure

The SQL-table shape splits column names from their types. Use it to discuss the archive schema before writing executable DDL.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

sample: {shape: sql_table; id: integer; site: text; quality: real}
ParameterMeaning in this example
shape: sql_tableRender a structured table rather than an ordinary box.
column: typeShow a column name and its declared type as diagram text.

Render this diagram

tools/d2 fmt examples/D2L-09-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-001 --target '' examples/D2L-09-001.d2 figures/D2L-09-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-001 --target '' examples/D2L-09-001.d2 figures/D2L-09-001.png
python3 tools/svg-pdf.py figures/D2L-09-001.svg figures/D2L-09-001.pdf

Try changing: Add collected_at: text.

Actual output

List a table structure
D2L-09-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-001.d2 to figures/D2L-09-001.svg in 2.045917ms

success: successfully compiled examples/D2L-09-001.d2 to figures/D2L-09-001.png in 4.630334ms
Render this diagram
tools/d2 fmt examples/D2L-09-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-001 --target '' examples/D2L-09-001.d2 figures/D2L-09-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-001 --target '' examples/D2L-09-001.d2 figures/D2L-09-001.png
python3 tools/svg-pdf.py figures/D2L-09-001.svg figures/D2L-09-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add collected_at: text.

D2L-09-002

Identify a primary key

A constraint marker makes the row identity visible. Use it when explaining why two samples can share a site name without being the same record.

Back to diagram overview

Compare with D2L-09-001 · List a table structure.

D2 source

sample: {shape: sql_table; id: integer {constraint: primary_key}; site: text}
ParameterMeaning in this example
constraint: primary_keyAnnotate id as the table primary key; this does not execute SQL.

Render this diagram

tools/d2 fmt examples/D2L-09-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-002 --target '' examples/D2L-09-002.d2 figures/D2L-09-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-002 --target '' examples/D2L-09-002.d2 figures/D2L-09-002.png
python3 tools/svg-pdf.py figures/D2L-09-002.svg figures/D2L-09-002.pdf

Try changing: Rename id to sample_id.

Actual output

Identify a primary key
D2L-09-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-002.d2 to figures/D2L-09-002.svg in 2.154917ms

success: successfully compiled examples/D2L-09-002.d2 to figures/D2L-09-002.png in 4.284ms
Render this diagram
tools/d2 fmt examples/D2L-09-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-002 --target '' examples/D2L-09-002.d2 figures/D2L-09-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-002 --target '' examples/D2L-09-002.d2 figures/D2L-09-002.png
python3 tools/svg-pdf.py figures/D2L-09-002.svg figures/D2L-09-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename id to sample_id.

D2L-09-003

Combine column constraints

A constraint list places several schema annotations beside one field. Use it to discuss a unique accession identifier that must be present.

Back to diagram overview

Compare with D2L-09-002 · Identify a primary key.

D2 source

sample: {shape: sql_table; id: integer {constraint: primary_key}; accession: text {constraint: [unique; not_null]}}
ParameterMeaning in this example
constraint: [unique; not_null]Display both annotations on accession.

Render this diagram

tools/d2 fmt examples/D2L-09-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-003 --target '' examples/D2L-09-003.d2 figures/D2L-09-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-003 --target '' examples/D2L-09-003.d2 figures/D2L-09-003.png
python3 tools/svg-pdf.py figures/D2L-09-003.svg figures/D2L-09-003.pdf

Try changing: Remove unique while retaining not_null.

Actual output

Combine column constraints
D2L-09-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-003.d2 to figures/D2L-09-003.svg in 2.344791ms

success: successfully compiled examples/D2L-09-003.d2 to figures/D2L-09-003.png in 5.361709ms
Render this diagram
tools/d2 fmt examples/D2L-09-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-003 --target '' examples/D2L-09-003.d2 figures/D2L-09-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-003 --target '' examples/D2L-09-003.d2 figures/D2L-09-003.png
python3 tools/svg-pdf.py figures/D2L-09-003.svg figures/D2L-09-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Remove unique while retaining not_null.

D2L-09-004

Connect foreign-key columns

Column endpoints show exactly which keys participate in a relationship. Use ELK here so the route attaches to the named rows instead of the whole tables.

Back to diagram overview

Compare with D2L-09-003 · Combine column constraints.

D2 source

direction: right
site: {shape: sql_table; id: integer {constraint: primary_key}; name: text}
sample: {shape: sql_table; id: integer {constraint: primary_key}; site_id: integer {constraint: foreign_key}}
sample.site_id -> site.id
ParameterMeaning in this example
sample.site_id -> site.idConnect the referencing and referenced columns.
--layout elkRoute connections to SQL-table columns.

Render this diagram

tools/d2 fmt examples/D2L-09-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-004 --target '' examples/D2L-09-004.d2 figures/D2L-09-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-004 --target '' examples/D2L-09-004.d2 figures/D2L-09-004.png
python3 tools/svg-pdf.py figures/D2L-09-004.svg figures/D2L-09-004.pdf

Try changing: Rename site_id consistently in its declaration and edge.

Actual output

Connect foreign-key columns
D2L-09-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-004.d2 to figures/D2L-09-004.svg in 2.973582ms

success: successfully compiled examples/D2L-09-004.d2 to figures/D2L-09-004.png in 7.28975ms
Render this diagram
tools/d2 fmt examples/D2L-09-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-004 --target '' examples/D2L-09-004.d2 figures/D2L-09-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-004 --target '' examples/D2L-09-004.d2 figures/D2L-09-004.png
python3 tools/svg-pdf.py figures/D2L-09-004.svg figures/D2L-09-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename site_id consistently in its declaration and edge.

D2L-09-005

Resolve a many-to-many relation

A join table makes membership explicit between campaigns and samples. Use this view when the same sample can belong to more than one release campaign.

Back to diagram overview

Compare with D2L-09-004 · Connect foreign-key columns.

D2 source

direction: right
campaign: {shape: sql_table; id: integer {constraint: primary_key}}
sample: {shape: sql_table; id: integer {constraint: primary_key}}
membership: {shape: sql_table; campaign_id: integer {constraint: foreign_key}; sample_id: integer {constraint: foreign_key}}
membership.campaign_id -> campaign.id
membership.sample_id -> sample.id
ParameterMeaning in this example
membershipRepresent the association with its two foreign-key columns.

Render this diagram

tools/d2 fmt examples/D2L-09-005.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-005 --target '' examples/D2L-09-005.d2 figures/D2L-09-005.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-005 --target '' examples/D2L-09-005.d2 figures/D2L-09-005.png
python3 tools/svg-pdf.py figures/D2L-09-005.svg figures/D2L-09-005.pdf

Try changing: Add role: text to membership.

Actual output

Resolve a many-to-many relation
D2L-09-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-005.d2 to figures/D2L-09-005.svg in 3.262666ms

success: successfully compiled examples/D2L-09-005.d2 to figures/D2L-09-005.png in 10.259458ms
Render this diagram
tools/d2 fmt examples/D2L-09-005.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-005 --target '' examples/D2L-09-005.d2 figures/D2L-09-005.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-09-005 --target '' examples/D2L-09-005.d2 figures/D2L-09-005.png
python3 tools/svg-pdf.py figures/D2L-09-005.svg figures/D2L-09-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add role: text to membership.

D2L-09-006

Describe an archive object

The class shape separates an object type from its fields. Use it when discussing the in-memory record rather than the database table.

Back to diagram overview

Compare with D2L-09-005 · Resolve a many-to-many relation.

D2 source

Sample: {shape: class; id: int; site: string; quality: float}
ParameterMeaning in this example
shape: classRender fields in a UML-like class compartment.

Render this diagram

tools/d2 fmt examples/D2L-09-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-006 --target '' examples/D2L-09-006.d2 figures/D2L-09-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-006 --target '' examples/D2L-09-006.d2 figures/D2L-09-006.png
python3 tools/svg-pdf.py figures/D2L-09-006.svg figures/D2L-09-006.pdf

Try changing: Add accepted: bool.

Actual output

Describe an archive object
D2L-09-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-006.d2 to figures/D2L-09-006.svg in 2.188ms

success: successfully compiled examples/D2L-09-006.d2 to figures/D2L-09-006.png in 5.230166ms
Render this diagram
tools/d2 fmt examples/D2L-09-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-006 --target '' examples/D2L-09-006.d2 figures/D2L-09-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-006 --target '' examples/D2L-09-006.d2 figures/D2L-09-006.png
python3 tools/svg-pdf.py figures/D2L-09-006.svg figures/D2L-09-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add accepted: bool.

D2L-09-007

Separate fields and operations

Parentheses identify operations and visibility prefixes distinguish the public API from internal state. Use this view to explain how a sample object validates itself.

Back to diagram overview

Compare with D2L-09-006 · Describe an archive object.

D2 source

Sample: {shape: class; +id: int; -quality: float; +validate(): bool; -normalize(): void}
ParameterMeaning in this example
+ / -Mark public and private members.
validate(): boolDeclare an operation and its result type.

Render this diagram

tools/d2 fmt examples/D2L-09-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-007 --target '' examples/D2L-09-007.d2 figures/D2L-09-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-007 --target '' examples/D2L-09-007.d2 figures/D2L-09-007.png
python3 tools/svg-pdf.py figures/D2L-09-007.svg figures/D2L-09-007.pdf

Try changing: Make normalize public.

Actual output

Separate fields and operations
D2L-09-007 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-007.d2 to figures/D2L-09-007.svg in 2.382791ms

success: successfully compiled examples/D2L-09-007.d2 to figures/D2L-09-007.png in 6.339543ms
Render this diagram
tools/d2 fmt examples/D2L-09-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-007 --target '' examples/D2L-09-007.d2 figures/D2L-09-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-007 --target '' examples/D2L-09-007.d2 figures/D2L-09-007.png
python3 tools/svg-pdf.py figures/D2L-09-007.svg figures/D2L-09-007.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Make normalize public.

D2L-09-008

Show a specialization

An open triangle can mark a generalization from a specialized sample to its base class. Use this convention only when the text explains that the relationship means inheritance.

Back to diagram overview

Compare with D2L-09-007 · Separate fields and operations.

D2 source

direction: up
Sample: {shape: class; id: int}
WaterSample: {shape: class; salinity: float}
WaterSample -> Sample: inherits {target-arrowhead: {shape: triangle; style.filled: false}}
ParameterMeaning in this example
target-arrowhead.style.filled: falseDraw the inheritance triangle open.

Render this diagram

tools/d2 fmt examples/D2L-09-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-008 --target '' examples/D2L-09-008.d2 figures/D2L-09-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-008 --target '' examples/D2L-09-008.d2 figures/D2L-09-008.png
python3 tools/svg-pdf.py figures/D2L-09-008.svg figures/D2L-09-008.pdf

Try changing: Add temperature: float to WaterSample.

Actual output

Show a specialization
D2L-09-008 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-09-008.d2 to figures/D2L-09-008.svg in 2.999418ms

success: successfully compiled examples/D2L-09-008.d2 to figures/D2L-09-008.png in 7.560792ms
Render this diagram
tools/d2 fmt examples/D2L-09-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-008 --target '' examples/D2L-09-008.d2 figures/D2L-09-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-09-008 --target '' examples/D2L-09-008.d2 figures/D2L-09-008.png
python3 tools/svg-pdf.py figures/D2L-09-008.svg figures/D2L-09-008.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add temperature: float to WaterSample.

10 · Sequence diagrams

Read messages in source order down the page; distance does not represent elapsed time. Compare the same notation with Mermaid sequence diagrams.

Reference: Official D2 documentation.

D2L-10-001

Send the first message

The sequence-diagram shape turns connections into an ordered exchange. Use it to explain how a collector submits a sample to the archive.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

shape: sequence_diagram
collector -> archive: submit sample
ParameterMeaning in this example
shape: sequence_diagramLay out actors across the page and messages in source order.

Render this diagram

tools/d2 fmt examples/D2L-10-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-001 --target '' examples/D2L-10-001.d2 figures/D2L-10-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-001 --target '' examples/D2L-10-001.d2 figures/D2L-10-001.png
python3 tools/svg-pdf.py figures/D2L-10-001.svg figures/D2L-10-001.pdf

Try changing: Rename the message to submit batch.

Actual output

Send the first message
D2L-10-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-001.d2 to figures/D2L-10-001.svg in 2.222625ms

success: successfully compiled examples/D2L-10-001.d2 to figures/D2L-10-001.png in 5.374625ms
Render this diagram
tools/d2 fmt examples/D2L-10-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-001 --target '' examples/D2L-10-001.d2 figures/D2L-10-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-001 --target '' examples/D2L-10-001.d2 figures/D2L-10-001.png
python3 tools/svg-pdf.py figures/D2L-10-001.svg figures/D2L-10-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename the message to submit batch.

D2L-10-002

Declare the actor order

Explicit actor declarations establish the reading order before messages begin. Use them when a gateway belongs between the collector and the archive.

Back to diagram overview

Compare with D2L-10-001 · Send the first message.

D2 source

shape: sequence_diagram
collector
gateway
archive
collector -> gateway: submit
gateway -> archive: forward
ParameterMeaning in this example
Actor declarationsFix the intended participant order independently of the first message.

Render this diagram

tools/d2 fmt examples/D2L-10-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-002 --target '' examples/D2L-10-002.d2 figures/D2L-10-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-002 --target '' examples/D2L-10-002.d2 figures/D2L-10-002.png
python3 tools/svg-pdf.py figures/D2L-10-002.svg figures/D2L-10-002.pdf

Try changing: Swap gateway and archive declarations.

Actual output

Declare the actor order
D2L-10-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-002.d2 to figures/D2L-10-002.svg in 2.366166ms

success: successfully compiled examples/D2L-10-002.d2 to figures/D2L-10-002.png in 7.416709ms
Render this diagram
tools/d2 fmt examples/D2L-10-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-002 --target '' examples/D2L-10-002.d2 figures/D2L-10-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-002 --target '' examples/D2L-10-002.d2 figures/D2L-10-002.png
python3 tools/svg-pdf.py figures/D2L-10-002.svg figures/D2L-10-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Swap gateway and archive declarations.

D2L-10-003

Return an acknowledgement

A later connection records the reply after the submission. Use a dashed reply to distinguish acknowledgement from the original request.

Back to diagram overview

Compare with D2L-10-002 · Declare the actor order.

D2 source

shape: sequence_diagram
collector -> archive: submit
archive -> collector: receipt {style.stroke-dash: 4}
ParameterMeaning in this example
Source orderPlace the receipt below the submission.
Dashed replyDistinguish the acknowledgement visually.

Render this diagram

tools/d2 fmt examples/D2L-10-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-003 --target '' examples/D2L-10-003.d2 figures/D2L-10-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-003 --target '' examples/D2L-10-003.d2 figures/D2L-10-003.png
python3 tools/svg-pdf.py figures/D2L-10-003.svg figures/D2L-10-003.pdf

Try changing: Rename receipt to accession ID.

Actual output

Return an acknowledgement
D2L-10-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-003.d2 to figures/D2L-10-003.svg in 2.286291ms

success: successfully compiled examples/D2L-10-003.d2 to figures/D2L-10-003.png in 6.151584ms
Render this diagram
tools/d2 fmt examples/D2L-10-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-003 --target '' examples/D2L-10-003.d2 figures/D2L-10-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-003 --target '' examples/D2L-10-003.d2 figures/D2L-10-003.png
python3 tools/svg-pdf.py figures/D2L-10-003.svg figures/D2L-10-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename receipt to accession ID.

D2L-10-004

Show active processing

A nested actor key creates a processing span. Use it to show that the archive remains active while validating and replying.

Back to diagram overview

Compare with D2L-10-003 · Return an acknowledgement.

D2 source

shape: sequence_diagram
collector -> archive.check: submit
archive.check -> collector: accepted
ParameterMeaning in this example
archive.checkCreate an activation span on the archive actor.

Render this diagram

tools/d2 fmt examples/D2L-10-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-004 --target '' examples/D2L-10-004.d2 figures/D2L-10-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-004 --target '' examples/D2L-10-004.d2 figures/D2L-10-004.png
python3 tools/svg-pdf.py figures/D2L-10-004.svg figures/D2L-10-004.pdf

Try changing: Rename check to validate.

Actual output

Show active processing
D2L-10-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-004.d2 to figures/D2L-10-004.svg in 2.275667ms

success: successfully compiled examples/D2L-10-004.d2 to figures/D2L-10-004.png in 6.335167ms
Render this diagram
tools/d2 fmt examples/D2L-10-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-004 --target '' examples/D2L-10-004.d2 figures/D2L-10-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-004 --target '' examples/D2L-10-004.d2 figures/D2L-10-004.png
python3 tools/svg-pdf.py figures/D2L-10-004.svg figures/D2L-10-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename check to validate.

D2L-10-005

Group a review exchange

A named group frames related messages without creating another actor. Use it when several handoffs belong to the same review phase.

Back to diagram overview

Compare with D2L-10-004 · Show active processing.

D2 source

shape: sequence_diagram
collector
archive
review: Review phase {collector -> archive: submit; archive -> collector: accepted}
ParameterMeaning in this example
review: { messages }Frame the messages as one named phase.

Render this diagram

tools/d2 fmt examples/D2L-10-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-005 --target '' examples/D2L-10-005.d2 figures/D2L-10-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-005 --target '' examples/D2L-10-005.d2 figures/D2L-10-005.png
python3 tools/svg-pdf.py figures/D2L-10-005.svg figures/D2L-10-005.pdf

Try changing: Change the group label to Intake phase.

Actual output

Group a review exchange
D2L-10-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-005.d2 to figures/D2L-10-005.svg in 2.323376ms

success: successfully compiled examples/D2L-10-005.d2 to figures/D2L-10-005.png in 9.27825ms
Render this diagram
tools/d2 fmt examples/D2L-10-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-005 --target '' examples/D2L-10-005.d2 figures/D2L-10-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-005 --target '' examples/D2L-10-005.d2 figures/D2L-10-005.png
python3 tools/svg-pdf.py figures/D2L-10-005.svg figures/D2L-10-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the group label to Intake phase.

D2L-10-006

Attach an actor note

A child object without message endpoints becomes a note on the actor. Use it for an assumption the reader should see at that point in the exchange.

Back to diagram overview

Compare with D2L-10-005 · Group a review exchange.

D2 source

shape: sequence_diagram
collector -> archive: submit
archive.note: Keep the original record
archive -> collector: receipt
ParameterMeaning in this example
archive.noteAttach the explanatory note to the archive lifeline.

Render this diagram

tools/d2 fmt examples/D2L-10-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-006 --target '' examples/D2L-10-006.d2 figures/D2L-10-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-006 --target '' examples/D2L-10-006.d2 figures/D2L-10-006.png
python3 tools/svg-pdf.py figures/D2L-10-006.svg figures/D2L-10-006.pdf

Try changing: Change the note to Verify the site code.

Actual output

Attach an actor note
D2L-10-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-006.d2 to figures/D2L-10-006.svg in 2.451667ms

success: successfully compiled examples/D2L-10-006.d2 to figures/D2L-10-006.png in 8.278084ms
Render this diagram
tools/d2 fmt examples/D2L-10-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-006 --target '' examples/D2L-10-006.d2 figures/D2L-10-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-006 --target '' examples/D2L-10-006.d2 figures/D2L-10-006.png
python3 tools/svg-pdf.py figures/D2L-10-006.svg figures/D2L-10-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the note to Verify the site code.

D2L-10-007

Call the same actor

A self-message records internal work on a participant. Use it when the archive performs normalization without calling another service.

Back to diagram overview

Compare with D2L-10-006 · Attach an actor note.

D2 source

shape: sequence_diagram
collector -> archive: submit
archive -> archive: normalize
archive -> collector: receipt
ParameterMeaning in this example
archive -> archiveDraw a self-message after submission.

Render this diagram

tools/d2 fmt examples/D2L-10-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-007 --target '' examples/D2L-10-007.d2 figures/D2L-10-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-007 --target '' examples/D2L-10-007.d2 figures/D2L-10-007.png
python3 tools/svg-pdf.py figures/D2L-10-007.svg figures/D2L-10-007.pdf

Try changing: Add a second self-message called validate.

Actual output

Call the same actor
D2L-10-007 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-007.d2 to figures/D2L-10-007.svg in 2.346208ms

success: successfully compiled examples/D2L-10-007.d2 to figures/D2L-10-007.png in 7.737459ms
Render this diagram
tools/d2 fmt examples/D2L-10-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-007 --target '' examples/D2L-10-007.d2 figures/D2L-10-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-007 --target '' examples/D2L-10-007.d2 figures/D2L-10-007.png
python3 tools/svg-pdf.py figures/D2L-10-007.svg figures/D2L-10-007.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a second self-message called validate.

D2L-10-008

Nest a processing span

Nested span keys show work performed during an existing activation. Use them to distinguish a short lookup from the wider intake operation.

Back to diagram overview

Compare with D2L-10-007 · Call the same actor.

D2 source

shape: sequence_diagram
collector -> archive.intake: submit
archive.intake -> archive.intake.lookup: find site
archive.intake.lookup -> archive.intake: site found
archive.intake -> collector: receipt
ParameterMeaning in this example
archive.intake.lookupNest the lookup span inside intake.

Render this diagram

tools/d2 fmt examples/D2L-10-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-008 --target '' examples/D2L-10-008.d2 figures/D2L-10-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-008 --target '' examples/D2L-10-008.d2 figures/D2L-10-008.png
python3 tools/svg-pdf.py figures/D2L-10-008.svg figures/D2L-10-008.pdf

Try changing: Rename lookup to check_site.

Actual output

Nest a processing span
D2L-10-008 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-10-008.d2 to figures/D2L-10-008.svg in 2.281875ms

success: successfully compiled examples/D2L-10-008.d2 to figures/D2L-10-008.png in 9.179834ms
Render this diagram
tools/d2 fmt examples/D2L-10-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-008 --target '' examples/D2L-10-008.d2 figures/D2L-10-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-10-008 --target '' examples/D2L-10-008.d2 figures/D2L-10-008.png
python3 tools/svg-pdf.py figures/D2L-10-008.svg figures/D2L-10-008.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename lookup to check_site.

11 · Grid diagrams

Reserve grid layouts for organized collections; use explicit connections when cells also form a process.

Reference: Official D2 documentation.

D2L-11-001

Arrange cards in rows

A row count fills a grid with a fixed number of rows. Use it to compare four collection stations without implying a process order.

Back to diagram overview

Compare with D2L-02-006 · Recognize specialized notation.

D2 source

grid-rows: 2
north: North station
south: South station
east: East station
west: West station
ParameterMeaning in this example
grid-rows: 2Arrange the four cells in two rows.

Render this diagram

tools/d2 fmt examples/D2L-11-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-001 --target '' examples/D2L-11-001.d2 figures/D2L-11-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-001 --target '' examples/D2L-11-001.d2 figures/D2L-11-001.png
python3 tools/svg-pdf.py figures/D2L-11-001.svg figures/D2L-11-001.pdf

Try changing: Set grid-rows to 1.

Actual output

Arrange cards in rows
D2L-11-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-001.d2 to figures/D2L-11-001.svg in 1.827875ms

success: successfully compiled examples/D2L-11-001.d2 to figures/D2L-11-001.png in 4.575041ms
Render this diagram
tools/d2 fmt examples/D2L-11-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-001 --target '' examples/D2L-11-001.d2 figures/D2L-11-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-001 --target '' examples/D2L-11-001.d2 figures/D2L-11-001.png
python3 tools/svg-pdf.py figures/D2L-11-001.svg figures/D2L-11-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set grid-rows to 1.

D2L-11-002

Arrange cards in columns

A column count makes the width of a catalog deliberate. Use it when two record categories should sit beside each other.

Back to diagram overview

Compare with D2L-11-001 · Arrange cards in rows.

D2 source

grid-columns: 2
water: Water samples
soil: Soil samples
rock: Rock samples
air: Air samples
ParameterMeaning in this example
grid-columns: 2Place cells in two columns in declaration order.

Render this diagram

tools/d2 fmt examples/D2L-11-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-002 --target '' examples/D2L-11-002.d2 figures/D2L-11-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-002 --target '' examples/D2L-11-002.d2 figures/D2L-11-002.png
python3 tools/svg-pdf.py figures/D2L-11-002.svg figures/D2L-11-002.pdf

Try changing: Set grid-columns to 4.

Actual output

Arrange cards in columns
D2L-11-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-002.d2 to figures/D2L-11-002.svg in 1.567376ms

success: successfully compiled examples/D2L-11-002.d2 to figures/D2L-11-002.png in 4.558791ms
Render this diagram
tools/d2 fmt examples/D2L-11-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-002 --target '' examples/D2L-11-002.d2 figures/D2L-11-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-002 --target '' examples/D2L-11-002.d2 figures/D2L-11-002.png
python3 tools/svg-pdf.py figures/D2L-11-002.svg figures/D2L-11-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set grid-columns to 4.

D2L-11-003

Give cells breathing room

The grid gap separates cells without adding invisible objects. Use it when labels or icons need more visual space.

Back to diagram overview

Compare with D2L-11-002 · Arrange cards in columns.

D2 source

grid-columns: 2
grid-gap: 48
water: Water samples
soil: Soil samples
rock: Rock samples
air: Air samples
ParameterMeaning in this example
grid-gap: 48Set the gap between adjacent cells in pixels.

Render this diagram

tools/d2 fmt examples/D2L-11-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-003 --target '' examples/D2L-11-003.d2 figures/D2L-11-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-003 --target '' examples/D2L-11-003.d2 figures/D2L-11-003.png
python3 tools/svg-pdf.py figures/D2L-11-003.svg figures/D2L-11-003.pdf

Try changing: Reduce grid-gap to 16.

Actual output

Give cells breathing room
D2L-11-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-003.d2 to figures/D2L-11-003.svg in 1.639833ms

success: successfully compiled examples/D2L-11-003.d2 to figures/D2L-11-003.png in 4.623041ms
Render this diagram
tools/d2 fmt examples/D2L-11-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-003 --target '' examples/D2L-11-003.d2 figures/D2L-11-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-003 --target '' examples/D2L-11-003.d2 figures/D2L-11-003.png
python3 tools/svg-pdf.py figures/D2L-11-003.svg figures/D2L-11-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Reduce grid-gap to 16.

D2L-11-004

Tune gaps by axis

Separate horizontal and vertical gaps let a grid fit its surrounding page. Use a wider horizontal gap when categories need a stronger separation than successive rows.

Back to diagram overview

Compare with D2L-11-003 · Give cells breathing room.

D2 source

grid-columns: 2
horizontal-gap: 64
vertical-gap: 16
water
soil
rock
air
ParameterMeaning in this example
horizontal-gap / vertical-gapReserve different spacing along the two grid axes.

Render this diagram

tools/d2 fmt examples/D2L-11-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-004 --target '' examples/D2L-11-004.d2 figures/D2L-11-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-004 --target '' examples/D2L-11-004.d2 figures/D2L-11-004.png
python3 tools/svg-pdf.py figures/D2L-11-004.svg figures/D2L-11-004.pdf

Try changing: Swap the two gap values.

Actual output

Tune gaps by axis
D2L-11-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-004.d2 to figures/D2L-11-004.svg in 1.388958ms

success: successfully compiled examples/D2L-11-004.d2 to figures/D2L-11-004.png in 3.649375ms
Render this diagram
tools/d2 fmt examples/D2L-11-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-004 --target '' examples/D2L-11-004.d2 figures/D2L-11-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-004 --target '' examples/D2L-11-004.d2 figures/D2L-11-004.png
python3 tools/svg-pdf.py figures/D2L-11-004.svg figures/D2L-11-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Swap the two gap values.

D2L-11-005

Nest a small catalog

Each grid cell can itself hold a container or another grid. Use this structure to compare field and laboratory responsibilities at the same level.

Back to diagram overview

Compare with D2L-11-004 · Tune gaps by axis.

D2 source

grid-columns: 2
field: Field {grid-columns: 1; collect; tag}
lab: Laboratory {grid-columns: 1; inspect; approve}
ParameterMeaning in this example
Nested grid-columnsArrange each team’s activities inside its own grid cell.

Render this diagram

tools/d2 fmt examples/D2L-11-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-005 --target '' examples/D2L-11-005.d2 figures/D2L-11-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-005 --target '' examples/D2L-11-005.d2 figures/D2L-11-005.png
python3 tools/svg-pdf.py figures/D2L-11-005.svg figures/D2L-11-005.pdf

Try changing: Set the inner grids to two columns.

Actual output

Nest a small catalog
D2L-11-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-005.d2 to figures/D2L-11-005.svg in 2.391959ms

success: successfully compiled examples/D2L-11-005.d2 to figures/D2L-11-005.png in 8.4885ms
Render this diagram
tools/d2 fmt examples/D2L-11-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-005 --target '' examples/D2L-11-005.d2 figures/D2L-11-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-005 --target '' examples/D2L-11-005.d2 figures/D2L-11-005.png
python3 tools/svg-pdf.py figures/D2L-11-005.svg figures/D2L-11-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set the inner grids to two columns.

D2L-11-006

Connect grid cells

Edges make a relationship explicit even when grid placement fixes the cell order. Use this to show the handoff between two independent workstations.

Back to diagram overview

Compare with D2L-11-005 · Nest a small catalog.

D2 source

grid-columns: 2
grid-gap: 180
field: Field station
lab: Laboratory
field -> lab: deliver batch
ParameterMeaning in this example
field -> labConnect cells without relying on adjacency to imply a handoff.

Render this diagram

tools/d2 fmt examples/D2L-11-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-006 --target '' examples/D2L-11-006.d2 figures/D2L-11-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-006 --target '' examples/D2L-11-006.d2 figures/D2L-11-006.png
python3 tools/svg-pdf.py figures/D2L-11-006.svg figures/D2L-11-006.pdf

Try changing: Reverse the edge and label it request batch.

Actual output

Connect grid cells
D2L-11-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-11-006.d2 to figures/D2L-11-006.svg in 2.248209ms

success: successfully compiled examples/D2L-11-006.d2 to figures/D2L-11-006.png in 5.059875ms
Render this diagram
tools/d2 fmt examples/D2L-11-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-006 --target '' examples/D2L-11-006.d2 figures/D2L-11-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-11-006 --target '' examples/D2L-11-006.d2 figures/D2L-11-006.png
python3 tools/svg-pdf.py figures/D2L-11-006.svg figures/D2L-11-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Reverse the edge and label it request batch.

12 · Positioning and layout engines

Let the engine arrange relationships, then use limited hints for labels, notes and object sizes. Compare rank and routing choices with Graphviz layout.

Reference: Official D2 documentation.

D2L-12-001

Reserve a corner for a note

A constant near position places an independent annotation around the main diagram. Use it for an assumption that should stay outside the process route.

Back to diagram overview

Compare with D2L-11-003 · Give cells breathing room.

D2 source

direction: right
collect -> archive
note: Reviewed records only {near: top-center; shape: text}
ParameterMeaning in this example
near: top-centerPlace the independent note above the laid-out graph.

Render this diagram

tools/d2 fmt examples/D2L-12-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-001 --target '' examples/D2L-12-001.d2 figures/D2L-12-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-001 --target '' examples/D2L-12-001.d2 figures/D2L-12-001.png
python3 tools/svg-pdf.py figures/D2L-12-001.svg figures/D2L-12-001.pdf

Try changing: Change near to bottom-center.

Actual output

Reserve a corner for a note
D2L-12-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-001.d2 to figures/D2L-12-001.svg in 2.622124ms

success: successfully compiled examples/D2L-12-001.d2 to figures/D2L-12-001.png in 5.936167ms
Render this diagram
tools/d2 fmt examples/D2L-12-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-001 --target '' examples/D2L-12-001.d2 figures/D2L-12-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-001 --target '' examples/D2L-12-001.d2 figures/D2L-12-001.png
python3 tools/svg-pdf.py figures/D2L-12-001.svg figures/D2L-12-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change near to bottom-center.

D2L-12-002

Set an object width

Width provides a minimum visual extent for a shape. Use it to reserve room for a component’s responsibility without inserting padding spaces in the label.

Back to diagram overview

Compare with D2L-12-001 · Reserve a corner for a note.

D2 source

direction: right
review: Review {width: 240}
review -> archive
ParameterMeaning in this example
width: 240Reserve a 240-pixel-wide review object.

Render this diagram

tools/d2 fmt examples/D2L-12-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-002 --target '' examples/D2L-12-002.d2 figures/D2L-12-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-002 --target '' examples/D2L-12-002.d2 figures/D2L-12-002.png
python3 tools/svg-pdf.py figures/D2L-12-002.svg figures/D2L-12-002.pdf

Try changing: Change width to 160.

Actual output

Set an object width
D2L-12-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-002.d2 to figures/D2L-12-002.svg in 2.18975ms

success: successfully compiled examples/D2L-12-002.d2 to figures/D2L-12-002.png in 4.047417ms
Render this diagram
tools/d2 fmt examples/D2L-12-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-002 --target '' examples/D2L-12-002.d2 figures/D2L-12-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-002 --target '' examples/D2L-12-002.d2 figures/D2L-12-002.png
python3 tools/svg-pdf.py figures/D2L-12-002.svg figures/D2L-12-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change width to 160.

D2L-12-003

Set an object height

Height can emphasize the visual extent of a store or component. Use it when a compact label should occupy a taller shape in a presentation.

Back to diagram overview

Compare with D2L-12-002 · Set an object width.

D2 source

archive: Archive {shape: cylinder; height: 180; width: 140}
ParameterMeaning in this example
height: 180Reserve a 180-pixel-high archive shape.

Render this diagram

tools/d2 fmt examples/D2L-12-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-003 --target '' examples/D2L-12-003.d2 figures/D2L-12-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-003 --target '' examples/D2L-12-003.d2 figures/D2L-12-003.png
python3 tools/svg-pdf.py figures/D2L-12-003.svg figures/D2L-12-003.pdf

Try changing: Reduce height to 100.

Actual output

Set an object height
D2L-12-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-003.d2 to figures/D2L-12-003.svg in 1.857875ms

success: successfully compiled examples/D2L-12-003.d2 to figures/D2L-12-003.png in 4.433751ms
Render this diagram
tools/d2 fmt examples/D2L-12-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-003 --target '' examples/D2L-12-003.d2 figures/D2L-12-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-003 --target '' examples/D2L-12-003.d2 figures/D2L-12-003.png
python3 tools/svg-pdf.py figures/D2L-12-003.svg figures/D2L-12-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Reduce height to 100.

D2L-12-004

Move a label outside

Label placement controls where the caption sits relative to the shape. Use an outside caption when the empty interior is the important visual cue.

Back to diagram overview

Compare with D2L-12-003 · Set an object height.

D2 source

archive: Field archive {shape: cylinder; label.near: outside-bottom-center}
ParameterMeaning in this example
label.near: outside-bottom-centerMove the caption below the cylinder.

Render this diagram

tools/d2 fmt examples/D2L-12-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-004 --target '' examples/D2L-12-004.d2 figures/D2L-12-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-004 --target '' examples/D2L-12-004.d2 figures/D2L-12-004.png
python3 tools/svg-pdf.py figures/D2L-12-004.svg figures/D2L-12-004.pdf

Try changing: Try outside-top-center.

Actual output

Move a label outside
D2L-12-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-004.d2 to figures/D2L-12-004.svg in 1.811625ms

success: successfully compiled examples/D2L-12-004.d2 to figures/D2L-12-004.png in 3.835583ms
Render this diagram
tools/d2 fmt examples/D2L-12-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-004 --target '' examples/D2L-12-004.d2 figures/D2L-12-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-004 --target '' examples/D2L-12-004.d2 figures/D2L-12-004.png
python3 tools/svg-pdf.py figures/D2L-12-004.svg figures/D2L-12-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Try outside-top-center.

D2L-12-005

Lay out the intake with Dagre

Dagre computes a layered route through the same branch structure used next. Use this baseline to separate the source graph from the engine’s placement choices.

Back to diagram overview

Compare with D2L-12-001 · Reserve a corner for a note.

D2 source

direction: right
field -> gateway: submit
gateway -> archive: accepted
gateway -> review: uncertain
review -> archive: approved
ParameterMeaning in this example
--layout dagreChoose the shared default layered layout engine.

Render this diagram

tools/d2 fmt examples/D2L-12-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-005 --target '' examples/D2L-12-005.d2 figures/D2L-12-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-005 --target '' examples/D2L-12-005.d2 figures/D2L-12-005.png
python3 tools/svg-pdf.py figures/D2L-12-005.svg figures/D2L-12-005.pdf

Try changing: Add review -> gateway: revise.

Actual output

Lay out the intake with Dagre
D2L-12-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-005.d2 to figures/D2L-12-005.svg in 2.980291ms

success: successfully compiled examples/D2L-12-005.d2 to figures/D2L-12-005.png in 10.369916ms
Render this diagram
tools/d2 fmt examples/D2L-12-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-005 --target '' examples/D2L-12-005.d2 figures/D2L-12-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-12-005 --target '' examples/D2L-12-005.d2 figures/D2L-12-005.png
python3 tools/svg-pdf.py figures/D2L-12-005.svg figures/D2L-12-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add review -> gateway: revise.

D2L-12-006

Lay out the same intake with ELK

ELK lays out exactly the same source graph as the preceding example. Use the pair to compare routing and spacing while preserving all node and edge declarations.

Back to diagram overview

Compare with D2L-12-005 · Lay out the intake with Dagre.

D2 source

direction: right
field -> gateway: submit
gateway -> archive: accepted
gateway -> review: uncertain
review -> archive: approved
ParameterMeaning in this example
--layout elkRender the unchanged graph with ELK instead of Dagre.

Render this diagram

tools/d2 fmt examples/D2L-12-006.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-12-006 --target '' examples/D2L-12-006.d2 figures/D2L-12-006.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-12-006 --target '' examples/D2L-12-006.d2 figures/D2L-12-006.png
python3 tools/svg-pdf.py figures/D2L-12-006.svg figures/D2L-12-006.pdf

Try changing: Render this source once with --layout dagre.

Actual output

Lay out the same intake with ELK
D2L-12-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-12-006.d2 to figures/D2L-12-006.svg in 4.890334ms

success: successfully compiled examples/D2L-12-006.d2 to figures/D2L-12-006.png in 19.5065ms
Render this diagram
tools/d2 fmt examples/D2L-12-006.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-12-006 --target '' examples/D2L-12-006.d2 figures/D2L-12-006.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-12-006 --target '' examples/D2L-12-006.d2 figures/D2L-12-006.png
python3 tools/svg-pdf.py figures/D2L-12-006.svg figures/D2L-12-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Render this source once with --layout dagre.

13 · Variables, globs and filters

Factor repeated values and apply precise selection rules to an existing model.

Reference: Official D2 documentation.

D2L-13-001

Name a repeated label

A variable gives a repeated text value one source of truth. Use it when the archive name appears in several views or captions.

Back to diagram overview

Compare with D2L-01-004 · Separate keys from labels.

D2 source

vars: {archive_name: Field archive}
archive: ${archive_name}
collector -> archive
ParameterMeaning in this example
vars.archive_nameDefine a scalar value.
${archive_name}Substitute that value as the object label.

Render this diagram

tools/d2 fmt examples/D2L-13-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-001 --target '' examples/D2L-13-001.d2 figures/D2L-13-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-001 --target '' examples/D2L-13-001.d2 figures/D2L-13-001.png
python3 tools/svg-pdf.py figures/D2L-13-001.svg figures/D2L-13-001.pdf

Try changing: Change Field archive in vars.

Actual output

Name a repeated label
D2L-13-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-001.d2 to figures/D2L-13-001.svg in 2.016041ms

success: successfully compiled examples/D2L-13-001.d2 to figures/D2L-13-001.png in 3.826666ms
Render this diagram
tools/d2 fmt examples/D2L-13-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-001 --target '' examples/D2L-13-001.d2 figures/D2L-13-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-001 --target '' examples/D2L-13-001.d2 figures/D2L-13-001.png
python3 tools/svg-pdf.py figures/D2L-13-001.svg figures/D2L-13-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change Field archive in vars.

D2L-13-002

Reuse a style value

Variables can supply individual style properties as well as labels. Use one accent when several objects should share an approved-state color.

Back to diagram overview

Compare with D2L-13-001 · Name a repeated label.

D2 source

vars: {accent: "#d9eee7"}
collect: {style.fill: ${accent}}
review: {style.fill: ${accent}}
collect -> review
ParameterMeaning in this example
style.fill: ${accent}Substitute the shared color into each style.

Render this diagram

tools/d2 fmt examples/D2L-13-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-002 --target '' examples/D2L-13-002.d2 figures/D2L-13-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-002 --target '' examples/D2L-13-002.d2 figures/D2L-13-002.png
python3 tools/svg-pdf.py figures/D2L-13-002.svg figures/D2L-13-002.pdf

Try changing: Change accent to #fff1d6.

Actual output

Reuse a style value
D2L-13-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-002.d2 to figures/D2L-13-002.svg in 2.199083ms

success: successfully compiled examples/D2L-13-002.d2 to figures/D2L-13-002.png in 3.836958ms
Render this diagram
tools/d2 fmt examples/D2L-13-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-002 --target '' examples/D2L-13-002.d2 figures/D2L-13-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-002 --target '' examples/D2L-13-002.d2 figures/D2L-13-002.png
python3 tools/svg-pdf.py figures/D2L-13-002.svg figures/D2L-13-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change accent to #fff1d6.

D2L-13-003

Style direct children with a glob

A single-star glob matches objects in its own scope. Use it to style one team’s immediate tasks without listing every task key.

Back to diagram overview

Compare with D2L-13-002 · Reuse a style value.

D2 source

field: {collect; tag; *.style.fill: "#e0f2f1"}
archive
ParameterMeaning in this example
*.style.fillApply the fill to matching objects in the current scope.

Render this diagram

tools/d2 fmt examples/D2L-13-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-003 --target '' examples/D2L-13-003.d2 figures/D2L-13-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-003 --target '' examples/D2L-13-003.d2 figures/D2L-13-003.png
python3 tools/svg-pdf.py figures/D2L-13-003.svg figures/D2L-13-003.pdf

Try changing: Add ship inside field.

Actual output

Style direct children with a glob
D2L-13-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-003.d2 to figures/D2L-13-003.svg in 2.367542ms

success: successfully compiled examples/D2L-13-003.d2 to figures/D2L-13-003.png in 6.494791ms
Render this diagram
tools/d2 fmt examples/D2L-13-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-003 --target '' examples/D2L-13-003.d2 figures/D2L-13-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-003 --target '' examples/D2L-13-003.d2 figures/D2L-13-003.png
python3 tools/svg-pdf.py figures/D2L-13-003.svg figures/D2L-13-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add ship inside field.

D2L-13-004

Reach nested objects with a glob

A double-star glob includes deeper objects in a hierarchy. Use it for a visual rule that should reach nested stations as well as their boundary.

Back to diagram overview

Compare with D2L-13-003 · Style direct children with a glob.

D2 source

field: {collect; station: {tag; inspect}}
**.style.stroke: "#0b6775"
ParameterMeaning in this example
**.style.strokeApply the stroke rule recursively through the hierarchy.

Render this diagram

tools/d2 fmt examples/D2L-13-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-004 --target '' examples/D2L-13-004.d2 figures/D2L-13-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-004 --target '' examples/D2L-13-004.d2 figures/D2L-13-004.png
python3 tools/svg-pdf.py figures/D2L-13-004.svg figures/D2L-13-004.pdf

Try changing: Add a second nested station.

Actual output

Reach nested objects with a glob
D2L-13-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-004.d2 to figures/D2L-13-004.svg in 2.980208ms

success: successfully compiled examples/D2L-13-004.d2 to figures/D2L-13-004.png in 8.948791ms
Render this diagram
tools/d2 fmt examples/D2L-13-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-004 --target '' examples/D2L-13-004.d2 figures/D2L-13-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-004 --target '' examples/D2L-13-004.d2 figures/D2L-13-004.png
python3 tools/svg-pdf.py figures/D2L-13-004.svg figures/D2L-13-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a second nested station.

D2L-13-005

Style a set of connections

Connection globs address every matching edge instead of each object. Use them when all handoffs in a process share a visual convention.

Back to diagram overview

Compare with D2L-13-004 · Reach nested objects with a glob.

D2 source

collect -> review -> archive
(* -> *)[*].style.stroke-width: 3
ParameterMeaning in this example
(* -> *)[*]Select all matching root-scope connections.

Render this diagram

tools/d2 fmt examples/D2L-13-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-005 --target '' examples/D2L-13-005.d2 figures/D2L-13-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-005 --target '' examples/D2L-13-005.d2 figures/D2L-13-005.png
python3 tools/svg-pdf.py figures/D2L-13-005.svg figures/D2L-13-005.pdf

Try changing: Set the width to 1.

Actual output

Style a set of connections
D2L-13-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-005.d2 to figures/D2L-13-005.svg in 2.0505ms

success: successfully compiled examples/D2L-13-005.d2 to figures/D2L-13-005.png in 4.020833ms
Render this diagram
tools/d2 fmt examples/D2L-13-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-005 --target '' examples/D2L-13-005.d2 figures/D2L-13-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-005 --target '' examples/D2L-13-005.d2 figures/D2L-13-005.png
python3 tools/svg-pdf.py figures/D2L-13-005.svg figures/D2L-13-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set the width to 1.

D2L-13-006

Filter objects by shape

An ampersand filter restricts a glob to objects with a matching property. Use it when all storage cylinders need the same fill while tasks remain unchanged.

Back to diagram overview

Compare with D2L-13-005 · Style a set of connections.

D2 source

collect
archive: {shape: cylinder}
backup: {shape: cylinder}
*: {&shape: cylinder; style.fill: "#e0f2f1"}
ParameterMeaning in this example
&shape: cylinderLimit the wildcard rule to cylinder objects.

Render this diagram

tools/d2 fmt examples/D2L-13-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-006 --target '' examples/D2L-13-006.d2 figures/D2L-13-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-006 --target '' examples/D2L-13-006.d2 figures/D2L-13-006.png
python3 tools/svg-pdf.py figures/D2L-13-006.svg figures/D2L-13-006.pdf

Try changing: Change backup to a rectangle.

Actual output

Filter objects by shape
D2L-13-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-006.d2 to figures/D2L-13-006.svg in 2.036416ms

success: successfully compiled examples/D2L-13-006.d2 to figures/D2L-13-006.png in 6.345083ms
Render this diagram
tools/d2 fmt examples/D2L-13-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-006 --target '' examples/D2L-13-006.d2 figures/D2L-13-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-006 --target '' examples/D2L-13-006.d2 figures/D2L-13-006.png
python3 tools/svg-pdf.py figures/D2L-13-006.svg figures/D2L-13-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change backup to a rectangle.

D2L-13-007

Filter edges by their source

Endpoint filters select relationships using a property of the source object. Use them to highlight transfers leaving a storage component.

Back to diagram overview

Compare with D2L-13-006 · Filter objects by shape.

D2 source

archive: {shape: cylinder}
archive -> export: records
collect -> review: draft
(* -> *)[*]: {&src.shape: cylinder; style.stroke: "#c07000"}
ParameterMeaning in this example
&src.shape: cylinderMatch only connections whose source is a cylinder.

Render this diagram

tools/d2 fmt examples/D2L-13-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-007 --target '' examples/D2L-13-007.d2 figures/D2L-13-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-007 --target '' examples/D2L-13-007.d2 figures/D2L-13-007.png
python3 tools/svg-pdf.py figures/D2L-13-007.svg figures/D2L-13-007.pdf

Try changing: Change the filter to &dst.shape: cylinder and add review -> archive.

Actual output

Filter edges by their source
D2L-13-007 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-007.d2 to figures/D2L-13-007.svg in 2.118333ms

success: successfully compiled examples/D2L-13-007.d2 to figures/D2L-13-007.png in 7.455834ms
Render this diagram
tools/d2 fmt examples/D2L-13-007.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-007 --target '' examples/D2L-13-007.d2 figures/D2L-13-007.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-007 --target '' examples/D2L-13-007.d2 figures/D2L-13-007.png
python3 tools/svg-pdf.py figures/D2L-13-007.svg figures/D2L-13-007.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the filter to &dst.shape: cylinder and add review -> archive.

D2L-13-008

Filter a hierarchy by level

The level filter selects a particular depth in the object tree. Use it to emphasize team boundaries while leaving their internal task styling alone.

Back to diagram overview

Compare with D2L-13-007 · Filter edges by their source.

D2 source

field: {collect; tag}
lab: {review; approve}
**: {&level: 0; style.stroke-width: 4}
ParameterMeaning in this example
&level: 0Match top-level objects at zero-based depth 0.

Render this diagram

tools/d2 fmt examples/D2L-13-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-008 --target '' examples/D2L-13-008.d2 figures/D2L-13-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-008 --target '' examples/D2L-13-008.d2 figures/D2L-13-008.png
python3 tools/svg-pdf.py figures/D2L-13-008.svg figures/D2L-13-008.pdf

Try changing: Change level to 1.

Actual output

Filter a hierarchy by level
D2L-13-008 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-13-008.d2 to figures/D2L-13-008.svg in 2.639667ms

success: successfully compiled examples/D2L-13-008.d2 to figures/D2L-13-008.png in 8.033375ms
Render this diagram
tools/d2 fmt examples/D2L-13-008.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-008 --target '' examples/D2L-13-008.d2 figures/D2L-13-008.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-13-008 --target '' examples/D2L-13-008.d2 figures/D2L-13-008.png
python3 tools/svg-pdf.py figures/D2L-13-008.svg figures/D2L-13-008.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change level to 1.

14 · Imports and models

Keep reusable pieces local and preserve their relative paths in the source-and-input ZIP. The support files are complete D2 programs bundled in examples/support; no remote includes are used.

Reference: Official D2 documentation.

D2L-14-001

Import a local intake

A map import places a local file under a named container. Use it when the same intake workflow belongs inside several larger views.

Back to diagram overview

Compare with D2L-04-001 · Group the intake work.

D2 source

intake: @support/intake
ParameterMeaning in this example
@support/intakeLoad examples/support/intake.d2 beneath intake.

Render this diagram

tools/d2 fmt examples/D2L-14-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-001 --target '' examples/D2L-14-001.d2 figures/D2L-14-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-001 --target '' examples/D2L-14-001.d2 figures/D2L-14-001.png
python3 tools/svg-pdf.py figures/D2L-14-001.svg figures/D2L-14-001.pdf

Try changing: Rename intake to field_team.

Actual output

Import a local intake
D2L-14-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-001.d2 to figures/D2L-14-001.svg in 2.742709ms

success: successfully compiled examples/D2L-14-001.d2 to figures/D2L-14-001.png in 6.935041ms
Render this diagram
tools/d2 fmt examples/D2L-14-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-001 --target '' examples/D2L-14-001.d2 figures/D2L-14-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-001 --target '' examples/D2L-14-001.d2 figures/D2L-14-001.png
python3 tools/svg-pdf.py figures/D2L-14-001.svg figures/D2L-14-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename intake to field_team.

D2L-14-002

Spread the intake into this scope

A spread import inserts the file contents directly into the current scope. Use it when the imported tasks should become the current view’s top-level objects.

Back to diagram overview

Compare with D2L-14-001 · Import a local intake.

D2 source

...@support/intake
review -> archive
ParameterMeaning in this example
...@support/intakeMerge the local program into the current scope.

Render this diagram

tools/d2 fmt examples/D2L-14-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-002 --target '' examples/D2L-14-002.d2 figures/D2L-14-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-002 --target '' examples/D2L-14-002.d2 figures/D2L-14-002.png
python3 tools/svg-pdf.py figures/D2L-14-002.svg figures/D2L-14-002.pdf

Try changing: Add archive: Reviewed archive.

Actual output

Spread the intake into this scope
D2L-14-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-002.d2 to figures/D2L-14-002.svg in 1.881708ms

success: successfully compiled examples/D2L-14-002.d2 to figures/D2L-14-002.png in 4.721501ms
Render this diagram
tools/d2 fmt examples/D2L-14-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-002 --target '' examples/D2L-14-002.d2 figures/D2L-14-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-002 --target '' examples/D2L-14-002.d2 figures/D2L-14-002.png
python3 tools/svg-pdf.py figures/D2L-14-002.svg figures/D2L-14-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add archive: Reviewed archive.

D2L-14-003

Import one named piece

A selective import retrieves a named value from a local file. Use it to reuse the archive object without importing unrelated objects from a larger model.

Back to diagram overview

Compare with D2L-14-002 · Spread the intake into this scope.

D2 source

archive: @support/pieces.store
review -> archive
ParameterMeaning in this example
@support/pieces.storeSelect the store object from pieces.d2.

Render this diagram

tools/d2 fmt examples/D2L-14-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-003 --target '' examples/D2L-14-003.d2 figures/D2L-14-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-003 --target '' examples/D2L-14-003.d2 figures/D2L-14-003.png
python3 tools/svg-pdf.py figures/D2L-14-003.svg figures/D2L-14-003.pdf

Try changing: Rename the local archive key to repository.

Actual output

Import one named piece
D2L-14-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-003.d2 to figures/D2L-14-003.svg in 2.055416ms

success: successfully compiled examples/D2L-14-003.d2 to figures/D2L-14-003.png in 5.118667ms
Render this diagram
tools/d2 fmt examples/D2L-14-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-003 --target '' examples/D2L-14-003.d2 figures/D2L-14-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-003 --target '' examples/D2L-14-003.d2 figures/D2L-14-003.png
python3 tools/svg-pdf.py figures/D2L-14-003.svg figures/D2L-14-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename the local archive key to repository.

D2L-14-004

Spread a reusable map value

A map variable can provide reusable object properties without an external file. Use it when several tasks need the same small structural definition.

Back to diagram overview

Compare with D2L-14-003 · Import one named piece.

D2 source

vars: {task: {shape: rectangle; style.fill: "#e0f2f1"}}
collect: {...${task}}
review: {...${task}}
collect -> review
ParameterMeaning in this example
...${task}Spread the map variable into the object’s property map.

Render this diagram

tools/d2 fmt examples/D2L-14-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-004 --target '' examples/D2L-14-004.d2 figures/D2L-14-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-004 --target '' examples/D2L-14-004.d2 figures/D2L-14-004.png
python3 tools/svg-pdf.py figures/D2L-14-004.svg figures/D2L-14-004.pdf

Try changing: Add style.stroke-width: 3 to task.

Actual output

Spread a reusable map value
D2L-14-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-004.d2 to figures/D2L-14-004.svg in 2.047209ms

success: successfully compiled examples/D2L-14-004.d2 to figures/D2L-14-004.png in 3.290292ms
Render this diagram
tools/d2 fmt examples/D2L-14-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-004 --target '' examples/D2L-14-004.d2 figures/D2L-14-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-004 --target '' examples/D2L-14-004.d2 figures/D2L-14-004.png
python3 tools/svg-pdf.py figures/D2L-14-004.svg figures/D2L-14-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add style.stroke-width: 3 to task.

D2L-14-005

Suspend an optional station

Suspend removes an object from this rendered view while retaining its model declaration. Use it to omit a future station without deleting the underlying source.

Back to diagram overview

Compare with D2L-14-004 · Spread a reusable map value.

D2 source

direction: right
collect -> review -> archive
review: suspend
ParameterMeaning in this example
review: suspendHide review and its incident connections in this view.

Render this diagram

tools/d2 fmt examples/D2L-14-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-005 --target '' examples/D2L-14-005.d2 figures/D2L-14-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-005 --target '' examples/D2L-14-005.d2 figures/D2L-14-005.png
python3 tools/svg-pdf.py figures/D2L-14-005.svg figures/D2L-14-005.pdf

Try changing: Remove the suspend statement.

Actual output

Suspend an optional station
D2L-14-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-005.d2 to figures/D2L-14-005.svg in 1.7415ms

success: successfully compiled examples/D2L-14-005.d2 to figures/D2L-14-005.png in 3.339084ms
Render this diagram
tools/d2 fmt examples/D2L-14-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-005 --target '' examples/D2L-14-005.d2 figures/D2L-14-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-005 --target '' examples/D2L-14-005.d2 figures/D2L-14-005.png
python3 tools/svg-pdf.py figures/D2L-14-005.svg figures/D2L-14-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Remove the suspend statement.

D2L-14-006

Reveal a model relationship

Unsuspend makes a selected part of a suspended model visible again. Use it to derive a focused intake view from a complete hidden model.

Back to diagram overview

Compare with D2L-14-005 · Suspend an optional station.

D2 source

...@support/model
(collect -> review)[0]: unsuspend
ParameterMeaning in this example
(collect -> review)[0]: unsuspendReveal the first matching connection and its endpoint objects.

Render this diagram

tools/d2 fmt examples/D2L-14-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-006 --target '' examples/D2L-14-006.d2 figures/D2L-14-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-006 --target '' examples/D2L-14-006.d2 figures/D2L-14-006.png
python3 tools/svg-pdf.py figures/D2L-14-006.svg figures/D2L-14-006.pdf

Try changing: Also unsuspend (review -> archive)[0].

Actual output

Reveal a model relationship
D2L-14-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-14-006.d2 to figures/D2L-14-006.svg in 2.096417ms

success: successfully compiled examples/D2L-14-006.d2 to figures/D2L-14-006.png in 3.550792ms
Render this diagram
tools/d2 fmt examples/D2L-14-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-006 --target '' examples/D2L-14-006.d2 figures/D2L-14-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-14-006 --target '' examples/D2L-14-006.d2 figures/D2L-14-006.png
python3 tools/svg-pdf.py figures/D2L-14-006.svg figures/D2L-14-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Also unsuspend (review -> archive)[0].

15 · Layers, scenarios, steps

Separate independent views, alternatives and cumulative changes instead of forcing them into one crowded diagram.

Reference: Official D2 documentation.

D2L-15-001

Add an independent layer

A layer is a separate board that does not inherit the root graph. Use it for the archive’s detailed internal structure beside a simpler overview.

Back to diagram overview

Compare with D2L-14-001 · Import a local intake.

D2 source

collector -> archive

layers: {detail: {api -> store}}
ParameterMeaning in this example
layers.detailDefine an independent board with its own objects.

Render this diagram

tools/d2 fmt examples/D2L-15-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '' examples/D2L-15-001.d2 figures/D2L-15-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '' examples/D2L-15-001.d2 figures/D2L-15-001.png
python3 tools/svg-pdf.py figures/D2L-15-001.svg figures/D2L-15-001.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '*' examples/D2L-15-001.d2 figures/D2L-15-001-boards.svg

Try changing: Add cache inside the detail layer.

Actual output

Add an independent layer
D2L-15-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-001.d2 to figures/D2L-15-001.svg in 2.249834ms

success: successfully compiled examples/D2L-15-001.d2 to figures/D2L-15-001.png in 3.795083ms


success: successfully compiled examples/D2L-15-001.d2 to figures/D2L-15-001-boards/detail.svg in 2.109583ms
success: successfully compiled examples/D2L-15-001.d2 to figures/D2L-15-001-boards/index.svg in 1.405249ms
Render this diagram
tools/d2 fmt examples/D2L-15-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '' examples/D2L-15-001.d2 figures/D2L-15-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '' examples/D2L-15-001.d2 figures/D2L-15-001.png
python3 tools/svg-pdf.py figures/D2L-15-001.svg figures/D2L-15-001.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-001 --target '*' examples/D2L-15-001.d2 figures/D2L-15-001-boards.svg

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · All SVG boards ZIP

Try changing: Add cache inside the detail layer.

D2L-15-002

Select one layer

The target flag exports a named board without its siblings. Use it when a document needs only the detailed archive view from the same source file.

Back to diagram overview

Compare with D2L-15-001 · Add an independent layer.

D2 source

collector -> archive

layers: {detail: {api -> store}}
ParameterMeaning in this example
--target layers.detailRender just the detail board, whose API/store objects are independent of the root.

Render this diagram

tools/d2 fmt examples/D2L-15-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-002 --target layers.detail examples/D2L-15-002.d2 figures/D2L-15-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-002 --target layers.detail examples/D2L-15-002.d2 figures/D2L-15-002.png
python3 tools/svg-pdf.py figures/D2L-15-002.svg figures/D2L-15-002.pdf

Try changing: Change the target to an empty string to render the root.

Actual output

Select one layer
D2L-15-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-002.d2 to figures/D2L-15-002.svg in 2.207583ms

success: successfully compiled examples/D2L-15-002.d2 to figures/D2L-15-002.png in 3.685999ms
Render this diagram
tools/d2 fmt examples/D2L-15-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-002 --target layers.detail examples/D2L-15-002.d2 figures/D2L-15-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-002 --target layers.detail examples/D2L-15-002.d2 figures/D2L-15-002.png
python3 tools/svg-pdf.py figures/D2L-15-002.svg figures/D2L-15-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the target to an empty string to render the root.

D2L-15-003

Describe an alternative scenario

A scenario inherits the root before applying its changes. Use it to explore a review outage while keeping the normal intake as the baseline.

Back to diagram overview

Compare with D2L-15-002 · Select one layer.

D2 source

collector -> archive: submit

scenarios: {outage: {archive.style.opacity: 0.3; collector -> queue: hold}}
ParameterMeaning in this example
scenarios.outageCreate a variant of the root graph.

Render this diagram

tools/d2 fmt examples/D2L-15-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target scenarios.outage examples/D2L-15-003.d2 figures/D2L-15-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target scenarios.outage examples/D2L-15-003.d2 figures/D2L-15-003.png
python3 tools/svg-pdf.py figures/D2L-15-003.svg figures/D2L-15-003.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target '*' examples/D2L-15-003.d2 figures/D2L-15-003-boards.svg

Try changing: Rename hold to retry later.

Actual output

Describe an alternative scenario
D2L-15-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-003.d2 to figures/D2L-15-003.svg in 2.816876ms

success: successfully compiled examples/D2L-15-003.d2 to figures/D2L-15-003.png in 6.929ms


success: successfully compiled examples/D2L-15-003.d2 to figures/D2L-15-003-boards/outage.svg in 2.705791ms
success: successfully compiled examples/D2L-15-003.d2 to figures/D2L-15-003-boards/index.svg in 2.202999ms
Render this diagram
tools/d2 fmt examples/D2L-15-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target scenarios.outage examples/D2L-15-003.d2 figures/D2L-15-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target scenarios.outage examples/D2L-15-003.d2 figures/D2L-15-003.png
python3 tools/svg-pdf.py figures/D2L-15-003.svg figures/D2L-15-003.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-003 --target '*' examples/D2L-15-003.d2 figures/D2L-15-003-boards.svg

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · All SVG boards ZIP

Try changing: Rename hold to retry later.

D2L-15-004

Keep scenarios independent

Sibling scenarios each begin from the root rather than from one another. Use them to compare outage handling with a separate maintenance plan.

Back to diagram overview

Compare with D2L-15-003 · Describe an alternative scenario.

D2 source

collector -> archive: submit

scenarios: {outage: {collector -> queue: hold}; maintenance: {archive.style.stroke-dash: 4}}
ParameterMeaning in this example
Sibling scenariosApply each alternative to the same unchanged baseline.

Render this diagram

tools/d2 fmt examples/D2L-15-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target scenarios.maintenance examples/D2L-15-004.d2 figures/D2L-15-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target scenarios.maintenance examples/D2L-15-004.d2 figures/D2L-15-004.png
python3 tools/svg-pdf.py figures/D2L-15-004.svg figures/D2L-15-004.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target '*' examples/D2L-15-004.d2 figures/D2L-15-004-boards.svg

Try changing: Add a maintenance label to archive.

Actual output

Keep scenarios independent
D2L-15-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-004.d2 to figures/D2L-15-004.svg in 2.78325ms

success: successfully compiled examples/D2L-15-004.d2 to figures/D2L-15-004.png in 5.122458ms


success: successfully compiled examples/D2L-15-004.d2 to figures/D2L-15-004-boards/outage.svg in 2.478417ms
success: successfully compiled examples/D2L-15-004.d2 to figures/D2L-15-004-boards/maintenance.svg in 2.053125ms
success: successfully compiled examples/D2L-15-004.d2 to figures/D2L-15-004-boards/index.svg in 2.4145ms
Render this diagram
tools/d2 fmt examples/D2L-15-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target scenarios.maintenance examples/D2L-15-004.d2 figures/D2L-15-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target scenarios.maintenance examples/D2L-15-004.d2 figures/D2L-15-004.png
python3 tools/svg-pdf.py figures/D2L-15-004.svg figures/D2L-15-004.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-004 --target '*' examples/D2L-15-004.d2 figures/D2L-15-004-boards.svg

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · All SVG boards ZIP

Try changing: Add a maintenance label to archive.

D2L-15-005

Accumulate a sequence of steps

Steps inherit the preceding state and add the next change. Use them to explain how an intake view grows from collection to storage.

Back to diagram overview

Compare with D2L-15-004 · Keep scenarios independent.

D2 source

collect

steps: {tagged: {collect -> tag}; reviewed: {tag -> review}; stored: {review -> archive}}
ParameterMeaning in this example
stepsApply boards cumulatively in declaration order.

Render this diagram

tools/d2 fmt examples/D2L-15-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target steps.stored examples/D2L-15-005.d2 figures/D2L-15-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target steps.stored examples/D2L-15-005.d2 figures/D2L-15-005.png
python3 tools/svg-pdf.py figures/D2L-15-005.svg figures/D2L-15-005.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target '*' examples/D2L-15-005.d2 figures/D2L-15-005-boards.svg

Try changing: Add a final published step.

Actual output

Accumulate a sequence of steps
D2L-15-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005.svg in 2.601167ms

success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005.png in 5.192541ms


success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005-boards/tagged.svg in 2.412541ms
success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005-boards/reviewed.svg in 2.061666ms
success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005-boards/stored.svg in 2.078041ms
success: successfully compiled examples/D2L-15-005.d2 to figures/D2L-15-005-boards/index.svg in 2.345874ms
Render this diagram
tools/d2 fmt examples/D2L-15-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target steps.stored examples/D2L-15-005.d2 figures/D2L-15-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target steps.stored examples/D2L-15-005.d2 figures/D2L-15-005.png
python3 tools/svg-pdf.py figures/D2L-15-005.svg figures/D2L-15-005.pdf
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-005 --target '*' examples/D2L-15-005.d2 figures/D2L-15-005-boards.svg

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · All SVG boards ZIP

Try changing: Add a final published step.

D2L-15-006

Export a middle step

A single-board target captures one intermediate state from a cumulative story. Use it when a review document should stop before the archive handoff.

Back to diagram overview

Compare with D2L-15-005 · Accumulate a sequence of steps.

D2 source

collect

steps: {tagged: {collect -> tag}; reviewed: {tag -> review}; stored: {review -> archive}}
ParameterMeaning in this example
--target steps.reviewedSelect the state after review is introduced and before archive is added.

Render this diagram

tools/d2 fmt examples/D2L-15-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-006 --target steps.reviewed examples/D2L-15-006.d2 figures/D2L-15-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-006 --target steps.reviewed examples/D2L-15-006.d2 figures/D2L-15-006.png
python3 tools/svg-pdf.py figures/D2L-15-006.svg figures/D2L-15-006.pdf

Try changing: Target steps.tagged instead.

Actual output

Export a middle step
D2L-15-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-15-006.d2 to figures/D2L-15-006.svg in 2.355459ms

success: successfully compiled examples/D2L-15-006.d2 to figures/D2L-15-006.png in 4.715ms
Render this diagram
tools/d2 fmt examples/D2L-15-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-006 --target steps.reviewed examples/D2L-15-006.d2 figures/D2L-15-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-15-006 --target steps.reviewed examples/D2L-15-006.d2 figures/D2L-15-006.png
python3 tools/svg-pdf.py figures/D2L-15-006.svg figures/D2L-15-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Target steps.tagged instead.

16 · Animation and interactivity

Keep interactive meaning in text too: printed pages show a static root board and cannot play or hover.

Reference: Official D2 documentation.

D2L-16-001

Animate a growing intake

An animated SVG cycles through the root and its cumulative steps. Use it for a short introduction in which readers can follow one new handoff at a time.

Back to diagram overview

Compare with D2L-15-005 · Accumulate a sequence of steps.

D2 source

collect

steps: {tagged: {collect -> tag}; reviewed: {tag -> review}; stored: {review -> archive}}
ParameterMeaning in this example
--animate-interval 1200Advance among four boards every 1200 ms; the cycle lasts 4.8 seconds.

Render this diagram

tools/d2 fmt examples/D2L-16-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '*' --animate-interval 1200 examples/D2L-16-001.d2 figures/D2L-16-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '' examples/D2L-16-001.d2 figures/D2L-16-001.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '' examples/D2L-16-001.d2 figures/D2L-16-001.print.svg
python3 tools/svg-pdf.py figures/D2L-16-001.print.svg figures/D2L-16-001.pdf

Try changing: Use 1800 milliseconds between boards.

Actual output

Animate a growing intake
D2L-16-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-001.d2 to figures/D2L-16-001.svg in 2.683417ms

success: successfully compiled examples/D2L-16-001.d2 to figures/D2L-16-001.png in 3.387041ms

success: successfully compiled examples/D2L-16-001.d2 to figures/D2L-16-001.print.svg in 2.140124ms
Render this diagram
tools/d2 fmt examples/D2L-16-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '*' --animate-interval 1200 examples/D2L-16-001.d2 figures/D2L-16-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '' examples/D2L-16-001.d2 figures/D2L-16-001.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-001 --target '' examples/D2L-16-001.d2 figures/D2L-16-001.print.svg
python3 tools/svg-pdf.py figures/D2L-16-001.print.svg figures/D2L-16-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Use 1800 milliseconds between boards.

The HTML SVG cycles through the boards. The PDF and PNG show the root board.

D2L-16-002

Animate two operating conditions

An animated scenario view alternates a baseline with an inherited alternative. Use it to explain why an outage queue exists without presenting both states on one static canvas.

Back to diagram overview

Compare with D2L-16-001 · Animate a growing intake.

D2 source

collector -> archive: submit

scenarios: {outage: {collector -> queue: hold; archive.style.opacity: 0.3}}
ParameterMeaning in this example
Animated scenariosCycle through the root and outage boards at 1200 ms per board.

Render this diagram

tools/d2 fmt examples/D2L-16-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '*' --animate-interval 1200 examples/D2L-16-002.d2 figures/D2L-16-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '' examples/D2L-16-002.d2 figures/D2L-16-002.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '' examples/D2L-16-002.d2 figures/D2L-16-002.print.svg
python3 tools/svg-pdf.py figures/D2L-16-002.print.svg figures/D2L-16-002.pdf

Try changing: Change hold to retry after recovery.

Actual output

Animate two operating conditions
D2L-16-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-002.d2 to figures/D2L-16-002.svg in 2.762209ms

success: successfully compiled examples/D2L-16-002.d2 to figures/D2L-16-002.png in 5.157208ms

success: successfully compiled examples/D2L-16-002.d2 to figures/D2L-16-002.print.svg in 2.769792ms
Render this diagram
tools/d2 fmt examples/D2L-16-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '*' --animate-interval 1200 examples/D2L-16-002.d2 figures/D2L-16-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '' examples/D2L-16-002.d2 figures/D2L-16-002.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-002 --target '' examples/D2L-16-002.d2 figures/D2L-16-002.print.svg
python3 tools/svg-pdf.py figures/D2L-16-002.print.svg figures/D2L-16-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change hold to retry after recovery.

The HTML SVG cycles through the boards. The PDF and PNG show the root board.

D2L-16-003

Animate a transfer edge

Animated edge styling adds motion along a connection. Use it for a live transfer cue while retaining the verb that explains the relationship.

Back to diagram overview

Compare with D2L-16-002 · Animate two operating conditions.

D2 source

direction: right
collector -> archive: stream {style.animated: true}
ParameterMeaning in this example
style.animated: trueAnimate the connection in SVG-capable viewers.

Render this diagram

tools/d2 fmt examples/D2L-16-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-003 --target '' examples/D2L-16-003.d2 figures/D2L-16-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-003 --target '' examples/D2L-16-003.d2 figures/D2L-16-003.png
python3 tools/svg-pdf.py figures/D2L-16-003.svg figures/D2L-16-003.pdf

Try changing: Set animated to false.

Actual output

Animate a transfer edge
D2L-16-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-003.d2 to figures/D2L-16-003.svg in 2.202584ms

success: successfully compiled examples/D2L-16-003.d2 to figures/D2L-16-003.png in 4.640917ms
Render this diagram
tools/d2 fmt examples/D2L-16-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-003 --target '' examples/D2L-16-003.d2 figures/D2L-16-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-003 --target '' examples/D2L-16-003.d2 figures/D2L-16-003.png
python3 tools/svg-pdf.py figures/D2L-16-003.svg figures/D2L-16-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Set animated to false.

D2L-16-004

Explain an object on hover

A tooltip carries a short supplementary explanation. Use it when the main label should remain compact and the same information can be repeated in accessible prose.

Back to diagram overview

Compare with D2L-16-003 · Animate a transfer edge.

D2 source

archive: Field archive {tooltip: Stores reviewed sample records}
ParameterMeaning in this example
tooltipShow the supplementary storage responsibility on hover; it is also stated here in prose.

Render this diagram

tools/d2 fmt examples/D2L-16-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-004 --target '' examples/D2L-16-004.d2 figures/D2L-16-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-004 --target '' examples/D2L-16-004.d2 figures/D2L-16-004.png
python3 tools/svg-pdf.py figures/D2L-16-004.svg figures/D2L-16-004.pdf

Try changing: Change the tooltip to Stores accepted batches.

Actual output

Field archiveStores reviewed sample recordsStores reviewed sample records
Explain an object on hover
D2L-16-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-004.d2 to figures/D2L-16-004.svg in 1.848958ms

success: successfully compiled examples/D2L-16-004.d2 to figures/D2L-16-004.png in 10.268041ms
Render this diagram
tools/d2 fmt examples/D2L-16-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-004 --target '' examples/D2L-16-004.d2 figures/D2L-16-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-004 --target '' examples/D2L-16-004.d2 figures/D2L-16-004.png
python3 tools/svg-pdf.py figures/D2L-16-004.svg figures/D2L-16-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the tooltip to Stores accepted batches.

D2L-16-005

Link to another example

A local fragment link connects a diagram object to an explanation in the same guide. Use it to let readers jump from the archive to its table model without a network request.

Back to diagram overview

Compare with D2L-16-004 · Explain an object on hover.

D2 source

archive: Field archive {link: "#D2L-09-001"}
ParameterMeaning in this example
link: "#D2L-09-001"Link to the table example in this HTML guide; standalone SVG fragments need a matching host anchor.

Render this diagram

tools/d2 fmt examples/D2L-16-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-005 --target '' examples/D2L-16-005.d2 figures/D2L-16-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-005 --target '' examples/D2L-16-005.d2 figures/D2L-16-005.png
python3 tools/svg-pdf.py figures/D2L-16-005.svg figures/D2L-16-005.pdf

Try changing: Link to #D2L-10-001 instead.

Actual output

Field archive
Link to another example
D2L-16-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-005.d2 to figures/D2L-16-005.svg in 2.00725ms

success: successfully compiled examples/D2L-16-005.d2 to figures/D2L-16-005.png in 9.69125ms
Render this diagram
tools/d2 fmt examples/D2L-16-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-005 --target '' examples/D2L-16-005.d2 figures/D2L-16-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-005 --target '' examples/D2L-16-005.d2 figures/D2L-16-005.png
python3 tools/svg-pdf.py figures/D2L-16-005.svg figures/D2L-16-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Link to #D2L-10-001 instead.

D2L-16-006

Keep a condition visible

A positioned tooltip keeps an important condition visible beside the object. Use it when readers need the condition in a static export as well as in the browser.

Back to diagram overview

Compare with D2L-16-004 · Explain an object on hover.

D2 source

archive: Field archive {tooltip: Only reviewed records are stored; tooltip.near: bottom-center}
ParameterMeaning in this example
tooltip.near: bottom-centerKeep the explanation visible below the archive object.

Render this diagram

tools/d2 fmt examples/D2L-16-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-006 --target '' examples/D2L-16-006.d2 figures/D2L-16-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-006 --target '' examples/D2L-16-006.d2 figures/D2L-16-006.png
python3 tools/svg-pdf.py figures/D2L-16-006.svg figures/D2L-16-006.pdf

Try changing: Change bottom-center to top-center.

Actual output

Field archiveOnly reviewed records are stored
Keep a condition visible
D2L-16-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-16-006.d2 to figures/D2L-16-006.svg in 2.7985ms

success: successfully compiled examples/D2L-16-006.d2 to figures/D2L-16-006.png in 11.0255ms
Render this diagram
tools/d2 fmt examples/D2L-16-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-006 --target '' examples/D2L-16-006.d2 figures/D2L-16-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-16-006 --target '' examples/D2L-16-006.d2 figures/D2L-16-006.png
python3 tools/svg-pdf.py figures/D2L-16-006.svg figures/D2L-16-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change bottom-center to top-center.

17 · C4 views and legends

Use consistent levels of detail for architecture conversations. These are explanatory C4-style views, not a C4 model validator; compare Mermaid C4 views.

Reference: Official D2 documentation.

D2L-17-001

Place the archive in context

A context view keeps the archive as one system and names its human and external neighbors. Use it when readers need the system boundary before internal implementation details.

Back to diagram overview

D2 source

direction: right
collector: Collector {shape: c4-person}
archive: Field archive
partner: Partner catalog {shape: cloud}
collector -> archive: submits samples
archive -> partner: publishes metadata
ParameterMeaning in this example
shape: c4-personUse the architecture-oriented person symbol.
Context scopeKeep internal archive components out of this view.

Render this diagram

tools/d2 fmt examples/D2L-17-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-001 --target '' examples/D2L-17-001.d2 figures/D2L-17-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-001 --target '' examples/D2L-17-001.d2 figures/D2L-17-001.png
python3 tools/svg-pdf.py figures/D2L-17-001.svg figures/D2L-17-001.pdf

Try changing: Add curator as another person.

Actual output

Place the archive in context
D2L-17-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-001.d2 to figures/D2L-17-001.svg in 2.529501ms

success: successfully compiled examples/D2L-17-001.d2 to figures/D2L-17-001.png in 12.711334ms
Render this diagram
tools/d2 fmt examples/D2L-17-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-001 --target '' examples/D2L-17-001.d2 figures/D2L-17-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-001 --target '' examples/D2L-17-001.d2 figures/D2L-17-001.png
python3 tools/svg-pdf.py figures/D2L-17-001.svg figures/D2L-17-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Compare with Mermaid · C4 context.

Try changing: Add curator as another person.

D2L-17-002

Open the system boundary

A container view separates deployable responsibilities inside the archive. Use it to show how the web client, API and store collaborate.

Back to diagram overview

Compare with D2L-17-001 · Place the archive in context.

D2 source

direction: right
collector: {shape: c4-person}
archive: Field archive {web: Web client; api: API; store: Record store {shape: cylinder}; web -> api: HTTPS; api -> store: SQL}
collector -> archive.web: enters sample
ParameterMeaning in this example
Archive boundaryGroup the deployable pieces of one system.

Render this diagram

tools/d2 fmt examples/D2L-17-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-002 --target '' examples/D2L-17-002.d2 figures/D2L-17-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-002 --target '' examples/D2L-17-002.d2 figures/D2L-17-002.png
python3 tools/svg-pdf.py figures/D2L-17-002.svg figures/D2L-17-002.pdf

Try changing: Add a worker container after api.

Actual output

Open the system boundary
D2L-17-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-002.d2 to figures/D2L-17-002.svg in 3.489542ms

success: successfully compiled examples/D2L-17-002.d2 to figures/D2L-17-002.png in 17.547375ms
Render this diagram
tools/d2 fmt examples/D2L-17-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-002 --target '' examples/D2L-17-002.d2 figures/D2L-17-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-002 --target '' examples/D2L-17-002.d2 figures/D2L-17-002.png
python3 tools/svg-pdf.py figures/D2L-17-002.svg figures/D2L-17-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a worker container after api.

D2L-17-003

Focus on API components

A component view opens one container while keeping its neighbors coarse. Use it when a developer needs to understand the intake API’s responsibilities.

Back to diagram overview

Compare with D2L-17-002 · Open the system boundary.

D2 source

direction: right
api: Intake API {handler: Request handler; validator: Record validator; repository: Repository; handler -> validator -> repository}
store: Record store {shape: cylinder}
api.repository -> store: writes
ParameterMeaning in this example
Component scopeOpen only the API container into internal responsibilities.

Render this diagram

tools/d2 fmt examples/D2L-17-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-003 --target '' examples/D2L-17-003.d2 figures/D2L-17-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-003 --target '' examples/D2L-17-003.d2 figures/D2L-17-003.png
python3 tools/svg-pdf.py figures/D2L-17-003.svg figures/D2L-17-003.pdf

Try changing: Rename validator to Site validator.

Actual output

Focus on API components
D2L-17-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-003.d2 to figures/D2L-17-003.svg in 3.409625ms

success: successfully compiled examples/D2L-17-003.d2 to figures/D2L-17-003.png in 14.911874ms
Render this diagram
tools/d2 fmt examples/D2L-17-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-003 --target '' examples/D2L-17-003.d2 figures/D2L-17-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-003 --target '' examples/D2L-17-003.d2 figures/D2L-17-003.png
python3 tools/svg-pdf.py figures/D2L-17-003.svg figures/D2L-17-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename validator to Site validator.

D2L-17-004

Show the runtime placement

A deployment view groups running components by host boundary. Use it when operators need to know where the API and archive store are placed.

Back to diagram overview

Compare with D2L-17-003 · Focus on API components.

D2 source

direction: right
field_host: Field laptop {client: Collection client}
service_host: Archive host {api: Intake API}
data_host: Data host {store: Record store {shape: cylinder}}
field_host.client -> service_host.api: HTTPS
service_host.api -> data_host.store: SQL
ParameterMeaning in this example
Host containersGroup runtime instances by deployment location.

Render this diagram

tools/d2 fmt examples/D2L-17-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-004 --target '' examples/D2L-17-004.d2 figures/D2L-17-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-004 --target '' examples/D2L-17-004.d2 figures/D2L-17-004.png
python3 tools/svg-pdf.py figures/D2L-17-004.svg figures/D2L-17-004.pdf

Try changing: Place api and store in the same host container.

Actual output

Show the runtime placement
D2L-17-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-004.d2 to figures/D2L-17-004.svg in 3.588041ms

success: successfully compiled examples/D2L-17-004.d2 to figures/D2L-17-004.png in 16.47125ms
Render this diagram
tools/d2 fmt examples/D2L-17-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-004 --target '' examples/D2L-17-004.d2 figures/D2L-17-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-004 --target '' examples/D2L-17-004.d2 figures/D2L-17-004.png
python3 tools/svg-pdf.py figures/D2L-17-004.svg figures/D2L-17-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Place api and store in the same host container.

D2L-17-005

Explain the diagram vocabulary

A legend makes the chosen shape and color conventions explicit. Use it when an architecture drawing introduces categories that readers cannot infer reliably from appearance alone.

Back to diagram overview

Compare with D2L-17-004 · Show the runtime placement.

D2 source

direction: right
collector: Collector {shape: c4-person}
archive: Field archive {style.fill: "#e0f2f1"}
collector -> archive: submits
vars: {d2-legend: Reading key {person: Human role {shape: c4-person}; system: Owned system {style.fill: "#e0f2f1"}}}
ParameterMeaning in this example
vars.d2-legendPlace a local reading key beside the main architecture.
Matching legend stylesReuse the exact cues shown in the diagram.

Render this diagram

tools/d2 fmt examples/D2L-17-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-005 --target '' examples/D2L-17-005.d2 figures/D2L-17-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-005 --target '' examples/D2L-17-005.d2 figures/D2L-17-005.png
python3 tools/svg-pdf.py figures/D2L-17-005.svg figures/D2L-17-005.pdf

Try changing: Rename the key to Architecture key.

Actual output

Explain the diagram vocabulary
D2L-17-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-005.d2 to figures/D2L-17-005.svg in 3.657792ms

success: successfully compiled examples/D2L-17-005.d2 to figures/D2L-17-005.png in 12.513042ms
Render this diagram
tools/d2 fmt examples/D2L-17-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-005 --target '' examples/D2L-17-005.d2 figures/D2L-17-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-005 --target '' examples/D2L-17-005.d2 figures/D2L-17-005.png
python3 tools/svg-pdf.py figures/D2L-17-005.svg figures/D2L-17-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename the key to Architecture key.

D2L-17-006

Explain relationship conventions

A legend can explain line styles as well as object categories. Use it when a planned integration and a running transfer share one view.

Back to diagram overview

Compare with D2L-17-005 · Explain the diagram vocabulary.

D2 source

direction: right
archive -> partner: planned {style.stroke-dash: 4}
vars: {d2-legend: Relationship key {source: Owned system; target: External system; source -> target: Planned transfer {style.stroke-dash: 4}}}
ParameterMeaning in this example
Dashed legend relationshipState explicitly that dashes mean planned integration here.

Render this diagram

tools/d2 fmt examples/D2L-17-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-006 --target '' examples/D2L-17-006.d2 figures/D2L-17-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-006 --target '' examples/D2L-17-006.d2 figures/D2L-17-006.png
python3 tools/svg-pdf.py figures/D2L-17-006.svg figures/D2L-17-006.pdf

Try changing: Change both dashed relationships to solid and rename planned to active.

Actual output

Explain relationship conventions
D2L-17-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-17-006.d2 to figures/D2L-17-006.svg in 3.849791ms

success: successfully compiled examples/D2L-17-006.d2 to figures/D2L-17-006.png in 13.091916ms
Render this diagram
tools/d2 fmt examples/D2L-17-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-006 --target '' examples/D2L-17-006.d2 figures/D2L-17-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-17-006 --target '' examples/D2L-17-006.d2 figures/D2L-17-006.png
python3 tools/svg-pdf.py figures/D2L-17-006.svg figures/D2L-17-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change both dashed relationships to solid and rename planned to active.

18 · Output formats: SVG, PDF, PPTX, ASCII

Use the same small graph to compare export formats. D2 v0.9.0 uses a built-in raster-backed paged PDF/PPTX exporter; the tour’s compact vector PDFs are converted from native SVG with librsvg.

Reference: Official D2 documentation.

D2L-18-001

Export a portable SVG

SVG is the primary format throughout this tour and embeds its font resources. Use it for a scalable diagram that can be opened in an offline browser.

Back to diagram overview

Compare with D2L-01-006 · Read from left to right.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
.svg outputSelect SVG by the destination filename.
--saltKeep SVG identifiers stable and isolated per example.

Render this diagram

tools/d2 fmt examples/D2L-18-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-001 --target '' examples/D2L-18-001.d2 figures/D2L-18-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-001 --target '' examples/D2L-18-001.d2 figures/D2L-18-001.png
python3 tools/svg-pdf.py figures/D2L-18-001.svg figures/D2L-18-001.pdf

Try changing: Change accepted to reviewed.

Actual output

Export a portable SVG
D2L-18-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-001.d2 to figures/D2L-18-001.svg in 2.177292ms

success: successfully compiled examples/D2L-18-001.d2 to figures/D2L-18-001.png in 4.105541ms
Render this diagram
tools/d2 fmt examples/D2L-18-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-001 --target '' examples/D2L-18-001.d2 figures/D2L-18-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-001 --target '' examples/D2L-18-001.d2 figures/D2L-18-001.png
python3 tools/svg-pdf.py figures/D2L-18-001.svg figures/D2L-18-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change accepted to reviewed.

D2L-18-002

Export a paged PDF

The PDF extension invokes D2’s own paged exporter. Use its separate download to compare the native page framing with the compact SVG-derived vector PDF used in the guide.

Back to diagram overview

Compare with D2L-18-001 · Export a portable SVG.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
.native.pdf downloadContain the actual D2 paged PDF export.
Compact vector PDFConvert the same SVG with rsvg-convert for page-size-independent reuse.

Render this diagram

tools/d2 fmt examples/D2L-18-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.native.pdf
python3 tools/pdf_metadata.py figures/D2L-18-002.native.pdf
python3 tools/svg-pdf.py figures/D2L-18-002.svg figures/D2L-18-002.pdf

Try changing: Compare the whitespace in both PDF downloads.

Actual output

Export a paged PDF
D2L-18-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-002.d2 to figures/D2L-18-002.svg in 2.568458ms

success: successfully compiled examples/D2L-18-002.d2 to figures/D2L-18-002.png in 5.24675ms

success: successfully compiled examples/D2L-18-002.d2 to figures/D2L-18-002.native.pdf in 10.007167ms
Render this diagram
tools/d2 fmt examples/D2L-18-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-002 --target '' examples/D2L-18-002.d2 figures/D2L-18-002.native.pdf
python3 tools/pdf_metadata.py figures/D2L-18-002.native.pdf
python3 tools/svg-pdf.py figures/D2L-18-002.svg figures/D2L-18-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · D2 paged PDF export

Try changing: Compare the whitespace in both PDF downloads.

D2L-18-003

Export a presentation slide

PPTX produces a presentation from the same diagram source. Use it when a collaborator needs the picture on a slide rather than embedded in a web page.

Back to diagram overview

Compare with D2L-18-002 · Export a paged PDF.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
.pptx outputWrite a presentation with the native D2 exporter; objects are rendered artwork, not editable D2 nodes.

Render this diagram

tools/d2 fmt examples/D2L-18-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.pptx
python3 tools/svg-pdf.py figures/D2L-18-003.svg figures/D2L-18-003.pdf

Try changing: Change the source direction to down before exporting.

Actual output

Export a presentation slide
D2L-18-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-003.d2 to figures/D2L-18-003.svg in 2.563459ms

success: successfully compiled examples/D2L-18-003.d2 to figures/D2L-18-003.png in 4.75375ms

success: successfully compiled examples/D2L-18-003.d2 to figures/D2L-18-003.pptx in 7.5345ms
Render this diagram
tools/d2 fmt examples/D2L-18-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.png
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-003 --target '' examples/D2L-18-003.d2 figures/D2L-18-003.pptx
python3 tools/svg-pdf.py figures/D2L-18-003.svg figures/D2L-18-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · PPTX export

Try changing: Change the source direction to down before exporting.

D2L-18-004

Export standard ASCII

Standard ASCII avoids Unicode box-drawing characters for older text environments. Use a small box-and-arrow graph because visual styles and many shapes cannot survive this conversion.

Back to diagram overview

Compare with D2L-18-003 · Export a presentation slide.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
.txt outputUse the text renderer with ELK.
--ascii-mode standardRestrict the output to basic ASCII characters.

Render this diagram

tools/d2 fmt examples/D2L-18-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' examples/D2L-18-004.d2 figures/D2L-18-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' examples/D2L-18-004.d2 figures/D2L-18-004.png
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' --ascii-mode standard examples/D2L-18-004.d2 figures/D2L-18-004.txt
python3 tools/svg-pdf.py figures/D2L-18-004.svg figures/D2L-18-004.pdf

Try changing: Rename collect to read.

Actual output

Export standard ASCII
D2L-18-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-004.d2 to figures/D2L-18-004.svg in 2.82875ms

success: successfully compiled examples/D2L-18-004.d2 to figures/D2L-18-004.png in 5.37425ms

success: successfully compiled examples/D2L-18-004.d2 to figures/D2L-18-004.txt in 2.1555ms
Render this diagram
tools/d2 fmt examples/D2L-18-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' examples/D2L-18-004.d2 figures/D2L-18-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' examples/D2L-18-004.d2 figures/D2L-18-004.png
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-18-004 --target '' --ascii-mode standard examples/D2L-18-004.d2 figures/D2L-18-004.txt
python3 tools/svg-pdf.py figures/D2L-18-004.svg figures/D2L-18-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview · TXT export

Actual ASCII output
+--------+                    +--------+
|collect |------accepted----->|archive |
|        |                    |        |
+--------+                    +--------+

Try changing: Rename collect to read.

D2L-18-005

Format the whole source

The formatter makes whitespace and indentation consistent without drawing a new concept. Use it before reviewing a diff so layout-independent formatting changes are easy to recognize.

Back to diagram overview

Compare with D2L-18-004 · Export standard ASCII.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
d2 fmt source.d2Rewrite the complete source in the pinned formatter’s canonical style.

Render this diagram

tools/d2 fmt examples/D2L-18-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-005 --target '' examples/D2L-18-005.d2 figures/D2L-18-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-005 --target '' examples/D2L-18-005.d2 figures/D2L-18-005.png
python3 tools/svg-pdf.py figures/D2L-18-005.svg figures/D2L-18-005.pdf

Try changing: Add spaces around the colon, run fmt and compare the result.

Actual output

Format the whole source
D2L-18-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-005.d2 to figures/D2L-18-005.svg in 2.570125ms

success: successfully compiled examples/D2L-18-005.d2 to figures/D2L-18-005.png in 4.751375ms
Render this diagram
tools/d2 fmt examples/D2L-18-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-005 --target '' examples/D2L-18-005.d2 figures/D2L-18-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-005 --target '' examples/D2L-18-005.d2 figures/D2L-18-005.png
python3 tools/svg-pdf.py figures/D2L-18-005.svg figures/D2L-18-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add spaces around the colon, run fmt and compare the result.

D2L-18-006

Validate before rendering

The validate subcommand checks a complete file before export. Use it in a build pipeline to reject malformed sources before generating diagrams.

Back to diagram overview

Compare with D2L-18-005 · Format the whole source.

D2 source

direction: right
collect -> archive: accepted
ParameterMeaning in this example
d2 validate source.d2Check the program with the real compiler and require exit status zero.

Render this diagram

tools/d2 fmt examples/D2L-18-006.d2
tools/d2 validate examples/D2L-18-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-006 --target '' examples/D2L-18-006.d2 figures/D2L-18-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-006 --target '' examples/D2L-18-006.d2 figures/D2L-18-006.png
python3 tools/svg-pdf.py figures/D2L-18-006.svg figures/D2L-18-006.pdf

Try changing: Rename archive consistently in the source, then validate again.

Actual output

Validate before rendering
D2L-18-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-18-006.d2 to figures/D2L-18-006.svg in 2.448582ms

success: successfully compiled examples/D2L-18-006.d2 to figures/D2L-18-006.png in 4.807ms
Render this diagram
tools/d2 fmt examples/D2L-18-006.d2
tools/d2 validate examples/D2L-18-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-006 --target '' examples/D2L-18-006.d2 figures/D2L-18-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-18-006 --target '' examples/D2L-18-006.d2 figures/D2L-18-006.png
python3 tools/svg-pdf.py figures/D2L-18-006.svg figures/D2L-18-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename archive consistently in the source, then validate again.

19 · One system in four views

Keep the same names and responsibilities while choosing the view that answers the reader’s question.

Reference: Official D2 documentation.

D2L-19-001

Explain the system context

A collector submits samples and a curator reviews records in the field archive, which publishes metadata to a partner catalog. Use this context view to agree on all four roles before opening the system.

Back to diagram overview

Compare with D2L-17-001 · Place the archive in context.

D2 source

direction: right
collector: Collector {shape: c4-person}
curator: Curator {shape: c4-person}
archive: Field archive
partner: Partner catalog {shape: cloud}
collector -> archive: submits samples
curator -> archive: reviews records
archive -> partner: publishes metadata
ParameterMeaning in this example
Context viewKeep the field archive as a single system.

Render this diagram

tools/d2 fmt examples/D2L-19-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-001 --target '' examples/D2L-19-001.d2 figures/D2L-19-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-001 --target '' examples/D2L-19-001.d2 figures/D2L-19-001.png
python3 tools/svg-pdf.py figures/D2L-19-001.svg figures/D2L-19-001.pdf

Try changing: Add a research user who reads published metadata from the partner catalog.

Actual output

Explain the system context
D2L-19-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-19-001.d2 to figures/D2L-19-001.svg in 2.760167ms

success: successfully compiled examples/D2L-19-001.d2 to figures/D2L-19-001.png in 20.085291ms
Render this diagram
tools/d2 fmt examples/D2L-19-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-001 --target '' examples/D2L-19-001.d2 figures/D2L-19-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-001 --target '' examples/D2L-19-001.d2 figures/D2L-19-001.png
python3 tools/svg-pdf.py figures/D2L-19-001.svg figures/D2L-19-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a research user who reads published metadata from the partner catalog.

D2L-19-002

Explain the component handoffs

The intake API validates samples before placing them in the record store. Use this view to assign implementation responsibilities inside the same field archive.

Back to diagram overview

Compare with D2L-19-001 · Explain the system context.

D2 source

direction: right
archive: Field archive {api: Intake API; validator: Record validator; store: Record store {shape: cylinder}; api -> validator: checks; validator -> store: stores accepted records}
partner: Partner catalog {shape: cloud}
archive.store -> partner: publishes metadata
ParameterMeaning in this example
Component viewOpen the archive boundary and retain the external partner.

Render this diagram

tools/d2 fmt examples/D2L-19-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-002 --target '' examples/D2L-19-002.d2 figures/D2L-19-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-002 --target '' examples/D2L-19-002.d2 figures/D2L-19-002.png
python3 tools/svg-pdf.py figures/D2L-19-002.svg figures/D2L-19-002.pdf

Try changing: Add a publisher component between store and partner.

Actual output

Explain the component handoffs
D2L-19-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-19-002.d2 to figures/D2L-19-002.svg in 3.770959ms

success: successfully compiled examples/D2L-19-002.d2 to figures/D2L-19-002.png in 24.974917ms
Render this diagram
tools/d2 fmt examples/D2L-19-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-002 --target '' examples/D2L-19-002.d2 figures/D2L-19-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-002 --target '' examples/D2L-19-002.d2 figures/D2L-19-002.png
python3 tools/svg-pdf.py figures/D2L-19-002.svg figures/D2L-19-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a publisher component between store and partner.

D2L-19-003

Explain one submission exchange

The collector submits a sample and receives a receipt after validation and storage. Use this view to discuss message order while keeping the same API, validator and store identities.

Back to diagram overview

Compare with D2L-19-002 · Explain the component handoffs.

D2 source

shape: sequence_diagram
collector: Collector
api: Intake API
validator: Record validator
store: Record store
collector -> api.intake: submit sample
api.intake -> validator: check record
validator -> api.intake: accepted
api.intake -> store: store record
store -> api.intake: stored
api.intake -> collector: receipt
ParameterMeaning in this example
Sequence viewShow the submission order rather than component placement.

Render this diagram

tools/d2 fmt examples/D2L-19-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-003 --target '' examples/D2L-19-003.d2 figures/D2L-19-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-003 --target '' examples/D2L-19-003.d2 figures/D2L-19-003.png
python3 tools/svg-pdf.py figures/D2L-19-003.svg figures/D2L-19-003.pdf

Try changing: Add a partner actor and a publish metadata message after stored.

Actual output

Explain one submission exchange
D2L-19-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-19-003.d2 to figures/D2L-19-003.svg in 2.598167ms

success: successfully compiled examples/D2L-19-003.d2 to figures/D2L-19-003.png in 15.816041ms
Render this diagram
tools/d2 fmt examples/D2L-19-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-003 --target '' examples/D2L-19-003.d2 figures/D2L-19-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-19-003 --target '' examples/D2L-19-003.d2 figures/D2L-19-003.png
python3 tools/svg-pdf.py figures/D2L-19-003.svg figures/D2L-19-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a partner actor and a publish metadata message after stored.

D2L-19-004

Explain the stored records

The record store keeps samples at named collection sites. Use this view to discuss column identity and foreign keys for the same records that the API accepted.

Back to diagram overview

Compare with D2L-19-003 · Explain one submission exchange.

D2 source

direction: right
site: Collection site {shape: sql_table; id: integer {constraint: primary_key}; name: text}
sample: Sample record {shape: sql_table; id: integer {constraint: primary_key}; site_id: integer {constraint: foreign_key}; accepted: boolean}
sample.site_id -> site.id
ParameterMeaning in this example
Data viewShow stored record structure rather than runtime messages.
Column endpoints with ELKAttach the foreign-key relationship to its exact columns.

Render this diagram

tools/d2 fmt examples/D2L-19-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-19-004 --target '' examples/D2L-19-004.d2 figures/D2L-19-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-19-004 --target '' examples/D2L-19-004.d2 figures/D2L-19-004.png
python3 tools/svg-pdf.py figures/D2L-19-004.svg figures/D2L-19-004.pdf

Try changing: Add accession: text to sample.

Actual output

Explain the stored records
D2L-19-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-19-004.d2 to figures/D2L-19-004.svg in 3.148916ms

success: successfully compiled examples/D2L-19-004.d2 to figures/D2L-19-004.png in 8.874291ms
Render this diagram
tools/d2 fmt examples/D2L-19-004.d2
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-19-004 --target '' examples/D2L-19-004.d2 figures/D2L-19-004.svg
tools/d2 --layout elk --theme 0 --pad 24 --salt D2L-19-004 --target '' examples/D2L-19-004.d2 figures/D2L-19-004.png
python3 tools/svg-pdf.py figures/D2L-19-004.svg figures/D2L-19-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add accession: text to sample.

20 · Process paths and decisions

Read a process as a set of explicit outcomes. Solid arrows show the work order unless an example states another convention; decisions need named exits. These are explanatory process maps: D2 draws the model and does not execute it or validate workflow rules. Compare the Graphviz process patterns.

Reference: Official D2 documentation.

D2L-20-001

Bound a complete intake

A process boundary identifies the event that starts work and the outcome that finishes it. Use a short happy path to agree on the scope of an intake before adding exceptions.

Back to diagram overview

Compare with D2L-01-006 · Read from left to right.

D2 source

direction: right
start: Batch arrives {shape: circle}
capture: Capture record
inspect: Inspect sample
store: Store record
finish: Intake complete {shape: oval}
start -> capture -> inspect -> store -> finish
ParameterMeaning in this example
circle / ovalDistinguish the arrival event from the finished intake.
start -> ... -> finishShow one complete successful route through the work.

Render this diagram

tools/d2 fmt examples/D2L-20-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-001 --target '' examples/D2L-20-001.d2 figures/D2L-20-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-001 --target '' examples/D2L-20-001.d2 figures/D2L-20-001.png
python3 tools/svg-pdf.py figures/D2L-20-001.svg figures/D2L-20-001.pdf

Try changing: Add a Tag sample activity between capture and inspect.

Actual output

Bound a complete intake
D2L-20-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-001.d2 to figures/D2L-20-001.svg in 2.544792ms

success: successfully compiled examples/D2L-20-001.d2 to figures/D2L-20-001.png in 16.601166ms
Render this diagram
tools/d2 fmt examples/D2L-20-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-001 --target '' examples/D2L-20-001.d2 figures/D2L-20-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-001 --target '' examples/D2L-20-001.d2 figures/D2L-20-001.png
python3 tools/svg-pdf.py figures/D2L-20-001.svg figures/D2L-20-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Tag sample activity between capture and inspect.

D2L-20-002

Name both decision outcomes

A question creates alternative routes rather than concurrent work. Use explicit yes and no labels when a record can be accepted or returned for correction.

Back to diagram overview

Compare with D2L-20-001 · Bound a complete intake.

D2 source

direction: right
capture: Capture record
check: Record complete? {shape: diamond}
store: Store record
return_record: Return to collector
accepted: Accepted {shape: oval}
returned: Returned for correction {shape: oval}
capture -> check
check -> store: yes
check -> return_record: no
store -> accepted
return_record -> returned
ParameterMeaning in this example
shape: diamondAsk one question about record completeness.
yes / noName mutually exclusive exits; only one route is taken for a record.

Render this diagram

tools/d2 fmt examples/D2L-20-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-002 --target '' examples/D2L-20-002.d2 figures/D2L-20-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-002 --target '' examples/D2L-20-002.d2 figures/D2L-20-002.png
python3 tools/svg-pdf.py figures/D2L-20-002.svg figures/D2L-20-002.pdf

Try changing: Change the question to Site code present? and keep both exit labels.

Actual output

Name both decision outcomes
D2L-20-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-002.d2 to figures/D2L-20-002.svg in 2.93325ms

success: successfully compiled examples/D2L-20-002.d2 to figures/D2L-20-002.png in 23.248709ms
Render this diagram
tools/d2 fmt examples/D2L-20-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-002 --target '' examples/D2L-20-002.d2 figures/D2L-20-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-002 --target '' examples/D2L-20-002.d2 figures/D2L-20-002.png
python3 tools/svg-pdf.py figures/D2L-20-002.svg figures/D2L-20-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the question to Site code present? and keep both exit labels.

D2L-20-003

Merge alternative intake channels

A paper form and a scanner produce the same kind of record through different routes. Use an exclusive merge when either route can continue by itself; it does not wait for both channels.

Back to diagram overview

Compare with D2L-20-002 · Name both decision outcomes.

D2 source

direction: right
channel: Input channel? {shape: diamond}
paper: Transcribe form
scanner: Read barcode
merge: Continue with one record
register: Register sample
finish: Registered {shape: oval}
channel -> paper: paper form
channel -> scanner: scanned label
paper -> merge
scanner -> merge
merge -> register -> finish
ParameterMeaning in this example
paper / scanner exitsSelect the intake route for this particular record.
mergeContinue after either route; no synchronization is implied.

Render this diagram

tools/d2 fmt examples/D2L-20-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-003 --target '' examples/D2L-20-003.d2 figures/D2L-20-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-003 --target '' examples/D2L-20-003.d2 figures/D2L-20-003.png
python3 tools/svg-pdf.py figures/D2L-20-003.svg figures/D2L-20-003.pdf

Try changing: Add a third route named Import field file that also enters merge.

Actual output

Merge alternative intake channels
D2L-20-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-003.d2 to figures/D2L-20-003.svg in 3.017042ms

success: successfully compiled examples/D2L-20-003.d2 to figures/D2L-20-003.png in 20.76325ms
Render this diagram
tools/d2 fmt examples/D2L-20-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-003 --target '' examples/D2L-20-003.d2 figures/D2L-20-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-003 --target '' examples/D2L-20-003.d2 figures/D2L-20-003.png
python3 tools/svg-pdf.py figures/D2L-20-003.svg figures/D2L-20-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a third route named Import field file that also enters merge.

D2L-20-004

Return incomplete work for correction

A rework edge sends an incomplete record back through a specific correction activity. Use a loop with a named exit so the drawing explains how a record eventually leaves review.

Back to diagram overview

Compare with D2L-20-003 · Merge alternative intake channels.

D2 source

direction: right
submit: Submit record
review: Record complete? {shape: diamond}
correct: Correct missing fields
store: Archive record
finish: Accepted {shape: oval}
submit -> review
review -> store: yes
store -> finish
review -> correct: no
correct -> review: resubmit {style.stroke-dash: 4}
ParameterMeaning in this example
correct -> reviewReturn the corrected record to the same completeness check.
yes exitLeave the rework loop only when the record is complete.

Render this diagram

tools/d2 fmt examples/D2L-20-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-004 --target '' examples/D2L-20-004.d2 figures/D2L-20-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-004 --target '' examples/D2L-20-004.d2 figures/D2L-20-004.png
python3 tools/svg-pdf.py figures/D2L-20-004.svg figures/D2L-20-004.pdf

Try changing: Add a Cancel intake outcome from correct without routing it to store.

Actual output

Return incomplete work for correction
D2L-20-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-004.d2 to figures/D2L-20-004.svg in 2.743917ms

success: successfully compiled examples/D2L-20-004.d2 to figures/D2L-20-004.png in 18.537791ms
Render this diagram
tools/d2 fmt examples/D2L-20-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-004 --target '' examples/D2L-20-004.d2 figures/D2L-20-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-004 --target '' examples/D2L-20-004.d2 figures/D2L-20-004.png
python3 tools/svg-pdf.py figures/D2L-20-004.svg figures/D2L-20-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Cancel intake outcome from correct without routing it to store.

D2L-20-005

Separate work order from record flow

An activity and the document it produces are different objects. Use solid arrows for work order and dashed arrows for record inputs and outputs when explaining what each step consumes.

Back to diagram overview

Compare with D2L-20-004 · Return incomplete work for correction.

D2 source

direction: right
capture: Capture record
review: Review record
store: Archive record
draft: Draft record {shape: document}
checked: Reviewed record {shape: document}
capture -> review -> store
capture -> draft: creates {style.stroke-dash: 4}
draft -> review: input {style.stroke-dash: 4}
review -> checked: produces {style.stroke-dash: 4}
checked -> store: input {style.stroke-dash: 4}
ParameterMeaning in this example
Solid connectionsOrder the three activities.
document / dashed connectionsShow record artifacts and how activities produce or consume them.

Render this diagram

tools/d2 fmt examples/D2L-20-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-005 --target '' examples/D2L-20-005.d2 figures/D2L-20-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-005 --target '' examples/D2L-20-005.d2 figures/D2L-20-005.png
python3 tools/svg-pdf.py figures/D2L-20-005.svg figures/D2L-20-005.pdf

Try changing: Add a Signed review document as another output of review.

Actual output

Separate work order from record flow
D2L-20-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-005.d2 to figures/D2L-20-005.svg in 2.792792ms

success: successfully compiled examples/D2L-20-005.d2 to figures/D2L-20-005.png in 14.333334ms
Render this diagram
tools/d2 fmt examples/D2L-20-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-005 --target '' examples/D2L-20-005.d2 figures/D2L-20-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-005 --target '' examples/D2L-20-005.d2 figures/D2L-20-005.png
python3 tools/svg-pdf.py figures/D2L-20-005.svg figures/D2L-20-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Signed review document as another output of review.

D2L-20-006

Finish with explicit outcomes

An automated intake can end accepted, rejected or passed to a separate manual-review queue. Use distinct outcomes to show what the caller must handle after this process finishes.

Back to diagram overview

Compare with D2L-20-005 · Separate work order from record flow.

D2 source

direction: right
inspect: Inspect batch
result: Inspection result? {shape: diamond}
store: Archive records
queue: Queue curator review {shape: queue}
reject: Report rejection
accepted: Accepted {shape: oval}
manual: Manual review queued {shape: oval}
rejected: Rejected {shape: oval}
inspect -> result
result -> store: valid
result -> queue: uncertain
result -> reject: unusable
store -> accepted
queue -> manual
reject -> rejected
ParameterMeaning in this example
valid / uncertain / unusableTreat the inspection result as three distinct outcomes.
Named oval outcomesState how this intake run ends, including the manual-review handoff.

Render this diagram

tools/d2 fmt examples/D2L-20-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-006 --target '' examples/D2L-20-006.d2 figures/D2L-20-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-006 --target '' examples/D2L-20-006.d2 figures/D2L-20-006.png
python3 tools/svg-pdf.py figures/D2L-20-006.svg figures/D2L-20-006.pdf

Try changing: Rename uncertain to Needs expert review and keep its route separate from rejection.

Actual output

Finish with explicit outcomes
D2L-20-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-20-006.d2 to figures/D2L-20-006.svg in 3.010584ms

success: successfully compiled examples/D2L-20-006.d2 to figures/D2L-20-006.png in 34.203791ms
Render this diagram
tools/d2 fmt examples/D2L-20-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-006 --target '' examples/D2L-20-006.d2 figures/D2L-20-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-20-006 --target '' examples/D2L-20-006.d2 figures/D2L-20-006.png
python3 tools/svg-pdf.py figures/D2L-20-006.svg figures/D2L-20-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename uncertain to Needs expert review and keep its route separate from rejection.

21 · Parallel work and synchronization

A fork starts independent work; a join states which completions are required before continuing. These examples name AND and ANY rules explicitly. Arrow length is not duration, and D2 does not schedule tasks or provide runtime synchronization.

Reference: Official D2 documentation.

D2L-21-001

Start two independent checks

One batch can need a record check and a specimen check without imposing an order between them. Use a named fork when both activities may start independently after intake.

Back to diagram overview

Compare with D2L-20-002 · Name both decision outcomes.

D2 source

direction: right
intake: Receive batch
fork: Start both {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
record: Check record
sample: Check specimen
record_done: Record check finished {shape: oval}
sample_done: Specimen check finished {shape: oval}
intake -> fork
fork -> record
fork -> sample
record -> record_done
sample -> sample_done
ParameterMeaning in this example
Thin rectangleDraw a fork whose label says that both branches start.
Separate finished outcomesShow that neither check depends on completion of the other.

Render this diagram

tools/d2 fmt examples/D2L-21-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-001 --target '' examples/D2L-21-001.d2 figures/D2L-21-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-001 --target '' examples/D2L-21-001.d2 figures/D2L-21-001.png
python3 tools/svg-pdf.py figures/D2L-21-001.svg figures/D2L-21-001.pdf

Try changing: Add a third independent branch called Check image quality.

Actual output

Start two independent checks
D2L-21-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-001.d2 to figures/D2L-21-001.svg in 2.280209ms

success: successfully compiled examples/D2L-21-001.d2 to figures/D2L-21-001.png in 19.647459ms
Render this diagram
tools/d2 fmt examples/D2L-21-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-001 --target '' examples/D2L-21-001.d2 figures/D2L-21-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-001 --target '' examples/D2L-21-001.d2 figures/D2L-21-001.png
python3 tools/svg-pdf.py figures/D2L-21-001.svg figures/D2L-21-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a third independent branch called Check image quality.

D2L-21-002

Wait for both checks

Two completed checks meet at an explicit AND join before the batch advances. Use this barrier when one finished check must never stand in for the missing other check.

Back to diagram overview

Compare with D2L-21-001 · Start two independent checks.

D2 source

direction: right
intake: Receive batch
fork: Start both {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
record: Check record
sample: Check specimen
join: AND - both finished {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
evaluate: Evaluate results
intake -> fork
fork -> record
fork -> sample
record -> join
sample -> join
join -> evaluate
ParameterMeaning in this example
Both incoming connectionsRequire completion from the record and specimen branches.
AND - both finishedState the synchronization rule rather than relying on the bar alone.

Render this diagram

tools/d2 fmt examples/D2L-21-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-002 --target '' examples/D2L-21-002.d2 figures/D2L-21-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-002 --target '' examples/D2L-21-002.d2 figures/D2L-21-002.png
python3 tools/svg-pdf.py figures/D2L-21-002.svg figures/D2L-21-002.pdf

Try changing: Add an image check and connect its completion to join as well.

Actual output

Wait for both checks
D2L-21-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-002.d2 to figures/D2L-21-002.svg in 2.334041ms

success: successfully compiled examples/D2L-21-002.d2 to figures/D2L-21-002.png in 11.848416ms
Render this diagram
tools/d2 fmt examples/D2L-21-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-002 --target '' examples/D2L-21-002.d2 figures/D2L-21-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-002 --target '' examples/D2L-21-002.d2 figures/D2L-21-002.png
python3 tools/svg-pdf.py figures/D2L-21-002.svg figures/D2L-21-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add an image check and connect its completion to join as well.

D2L-21-003

Wait for every sample in a batch

Per-sample checks are separate instances of the same work, rather than different kinds of batch-level review. Use this fixed three-sample model to explain that the whole batch waits for every sample check.

Back to diagram overview

Compare with D2L-21-002 · Wait for both checks.

D2 source

direction: right
batch: Batch checks {
  a: Check sample A
  b: Check sample B
  c: Check sample C
}
start: Start all three {width: 12; height: 140; label.near: outside-top-center; style.fill: "#0b6775"}
join: AND - all three finished {width: 12; height: 140; label.near: outside-top-center; style.fill: "#0b6775"}
release: Review batch results
start -> batch.a
start -> batch.b
start -> batch.c
batch.a -> join
batch.b -> join
batch.c -> join
join -> release
ParameterMeaning in this example
Three named sample instancesDraw the complete illustrative batch; D2 does not generate or execute a runtime loop.
AND - all three finishedWait for A, B and C before reviewing the batch results.

Render this diagram

tools/d2 fmt examples/D2L-21-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-003 --target '' examples/D2L-21-003.d2 figures/D2L-21-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-003 --target '' examples/D2L-21-003.d2 figures/D2L-21-003.png
python3 tools/svg-pdf.py figures/D2L-21-003.svg figures/D2L-21-003.pdf

Try changing: Add sample D and connect it to both start and join.

Actual output

Wait for every sample in a batch
D2L-21-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-003.d2 to figures/D2L-21-003.svg in 3.325709ms

success: successfully compiled examples/D2L-21-003.d2 to figures/D2L-21-003.png in 18.165292ms
Render this diagram
tools/d2 fmt examples/D2L-21-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-003 --target '' examples/D2L-21-003.d2 figures/D2L-21-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-003 --target '' examples/D2L-21-003.d2 figures/D2L-21-003.png
python3 tools/svg-pdf.py figures/D2L-21-003.svg figures/D2L-21-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add sample D and connect it to both start and join.

D2L-21-004

Separate completion from success

A synchronization barrier only says that both checks finished. Use a separate decision to evaluate their results so a failed check cannot be mistaken for a missing completion.

Back to diagram overview

Compare with D2L-21-003 · Wait for every sample in a batch.

D2 source

direction: right
fork: Start both {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
record: Run record check
sample: Run specimen check
join: AND - both finished {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
passed: Both results pass? {shape: diamond}
publish: Release batch
hold: Hold for curator
fork -> record
fork -> sample
record -> join
sample -> join
join -> passed
passed -> publish: yes
passed -> hold: no
ParameterMeaning in this example
AND joinWait for two completions, including checks that report failure.
Separate result decisionChoose release or hold only after evaluating both results.

Render this diagram

tools/d2 fmt examples/D2L-21-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-004 --target '' examples/D2L-21-004.d2 figures/D2L-21-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-004 --target '' examples/D2L-21-004.d2 figures/D2L-21-004.png
python3 tools/svg-pdf.py figures/D2L-21-004.svg figures/D2L-21-004.pdf

Try changing: Rename Both results pass? to All required checks pass? without changing the join rule.

Actual output

Separate completion from success
D2L-21-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-004.d2 to figures/D2L-21-004.svg in 2.87525ms

success: successfully compiled examples/D2L-21-004.d2 to figures/D2L-21-004.png in 18.47725ms
Render this diagram
tools/d2 fmt examples/D2L-21-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-004 --target '' examples/D2L-21-004.d2 figures/D2L-21-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-004 --target '' examples/D2L-21-004.d2 figures/D2L-21-004.png
python3 tools/svg-pdf.py figures/D2L-21-004.svg figures/D2L-21-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Rename Both results pass? to All required checks pass? without changing the join rule.

D2L-21-005

Complete an optional branch explicitly

An optional branch still needs a completion route when the model waits for both branches. Use a skip path when no laboratory test is required so the intended join rule remains clear.

Back to diagram overview

Compare with D2L-21-004 · Separate completion from success.

D2 source

direction: right
fork: Start both {width: 12; height: 120; label.near: outside-top-center; style.fill: "#0b6775"}
record: Check record
needed: Lab test required? {shape: diamond}
lab: Run lab test
skip: Lab test not needed
join: AND - both branches finished {width: 12; height: 120; label.near: outside-top-center; style.fill: "#0b6775"}
review: Review all results
fork -> record
fork -> needed
needed -> lab: yes
needed -> skip: no
record -> join
lab -> join
skip -> join
join -> review
ParameterMeaning in this example
yes / no lab pathsEither perform the lab test or explicitly complete that branch by skipping it.
Both branches finishedWait for the record check and whichever lab route was selected.

Render this diagram

tools/d2 fmt examples/D2L-21-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-005 --target '' examples/D2L-21-005.d2 figures/D2L-21-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-005 --target '' examples/D2L-21-005.d2 figures/D2L-21-005.png
python3 tools/svg-pdf.py figures/D2L-21-005.svg figures/D2L-21-005.pdf

Try changing: Add an Explain skip reason activity between skip and join.

Actual output

Complete an optional branch explicitly
D2L-21-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-005.d2 to figures/D2L-21-005.svg in 3.055249ms

success: successfully compiled examples/D2L-21-005.d2 to figures/D2L-21-005.png in 24.242666ms
Render this diagram
tools/d2 fmt examples/D2L-21-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-005 --target '' examples/D2L-21-005.d2 figures/D2L-21-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-005 --target '' examples/D2L-21-005.d2 figures/D2L-21-005.png
python3 tools/svg-pdf.py figures/D2L-21-005.svg figures/D2L-21-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add an Explain skip reason activity between skip and join.

D2L-21-006

Continue after the first valid reply

Two catalog lookups can race when either valid reply is sufficient. Use an ANY selection and a cancellation step to distinguish this policy from waiting for both responses.

Back to diagram overview

Compare with D2L-21-005 · Complete an optional branch explicitly.

D2 source

direction: right
fork: Start both lookups {width: 12; height: 100; label.near: outside-top-center; style.fill: "#0b6775"}
local: Query local catalog
partner: Query partner catalog
first: ANY - first valid reply {shape: hexagon}
cancel: Cancel remaining request
use: Use selected record
fork -> local
fork -> partner
local -> first: valid reply
partner -> first: valid reply
first -> cancel -> use
tie: "Simultaneous valid replies: prefer local" {shape: text; near: bottom-center}
ParameterMeaning in this example
ANY - first valid replyContinue after one valid response; this is not an AND join.
Cancellation / tie noteState what happens to the other request and how a simultaneous result is resolved.

Render this diagram

tools/d2 fmt examples/D2L-21-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-006 --target '' examples/D2L-21-006.d2 figures/D2L-21-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-006 --target '' examples/D2L-21-006.d2 figures/D2L-21-006.png
python3 tools/svg-pdf.py figures/D2L-21-006.svg figures/D2L-21-006.pdf

Try changing: Change the tie policy to prefer partner while keeping the ANY rule.

Actual output

Continue after the first valid reply
D2L-21-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-21-006.d2 to figures/D2L-21-006.svg in 3.560084ms

success: successfully compiled examples/D2L-21-006.d2 to figures/D2L-21-006.png in 23.8475ms
Render this diagram
tools/d2 fmt examples/D2L-21-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-006 --target '' examples/D2L-21-006.d2 figures/D2L-21-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-21-006 --target '' examples/D2L-21-006.d2 figures/D2L-21-006.png
python3 tools/svg-pdf.py figures/D2L-21-006.svg figures/D2L-21-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the tie policy to prefer partner while keeping the ANY rule.

22 · Responsibilities and handoffs

Use ownership boundaries to show who performs work, who can decide and what crosses a handoff. A container documents responsibility; it does not enforce access rights or create a fixed swimlane. Compare the Graphviz responsibility views.

Reference: Official D2 documentation.

D2L-22-001

Assign each intake step to an owner

A process can cross teams while keeping each activity inside its responsible boundary. Use this view to agree on the handoff between field collection and curatorial review.

Back to diagram overview

Compare with D2L-04-003 · Address a child by path.

D2 source

direction: right
field: Field team {
  collect: Collect sample
  tag: Tag sample
  collect -> tag
}
curator: Curator {
  inspect: Inspect record
  store: Archive record
  inspect -> store
}
field.tag -> curator.inspect: submit batch
ParameterMeaning in this example
field / curator containersAssign the work to its owner.
Connection between childrenName the actual activities that exchange the batch.

Render this diagram

tools/d2 fmt examples/D2L-22-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-001 --target '' examples/D2L-22-001.d2 figures/D2L-22-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-001 --target '' examples/D2L-22-001.d2 figures/D2L-22-001.png
python3 tools/svg-pdf.py figures/D2L-22-001.svg figures/D2L-22-001.pdf

Try changing: Move Tag sample into the curator boundary and reconnect the handoff.

Actual output

Assign each intake step to an owner
D2L-22-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-001.d2 to figures/D2L-22-001.svg in 3.691042ms

success: successfully compiled examples/D2L-22-001.d2 to figures/D2L-22-001.png in 13.077792ms
Render this diagram
tools/d2 fmt examples/D2L-22-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-001 --target '' examples/D2L-22-001.d2 figures/D2L-22-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-001 --target '' examples/D2L-22-001.d2 figures/D2L-22-001.png
python3 tools/svg-pdf.py figures/D2L-22-001.svg figures/D2L-22-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Move Tag sample into the curator boundary and reconnect the handoff.

D2L-22-002

Distinguish receipt from acceptance

A receipt confirms delivery before the laboratory decides whether to accept the batch. Use separate messages when the collector must distinguish a successful handoff from a successful review.

Back to diagram overview

Compare with D2L-10-003 · Return an acknowledgement.

D2 source

shape: sequence_diagram
collector: Field collector
lab: Laboratory
collector -> lab: submit batch B17
lab -> collector: received B17
lab -> lab: inspect B17
lab -> collector: accepted B17
ParameterMeaning in this example
received B17Acknowledge receipt without claiming that review has passed.
accepted B17Report the later business outcome for the same batch identifier.

Render this diagram

tools/d2 fmt examples/D2L-22-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-002 --target '' examples/D2L-22-002.d2 figures/D2L-22-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-002 --target '' examples/D2L-22-002.d2 figures/D2L-22-002.png
python3 tools/svg-pdf.py figures/D2L-22-002.svg figures/D2L-22-002.pdf

Try changing: Change the final message to rejected B17 while retaining the receipt.

Actual output

Distinguish receipt from acceptance
D2L-22-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-002.d2 to figures/D2L-22-002.svg in 2.422208ms

success: successfully compiled examples/D2L-22-002.d2 to figures/D2L-22-002.png in 9.914125ms
Render this diagram
tools/d2 fmt examples/D2L-22-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-002 --target '' examples/D2L-22-002.d2 figures/D2L-22-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-002 --target '' examples/D2L-22-002.d2 figures/D2L-22-002.png
python3 tools/svg-pdf.py figures/D2L-22-002.svg figures/D2L-22-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the final message to rejected B17 while retaining the receipt.

D2L-22-003

Keep the review decision with its owner

A curator makes the review decision while the collector performs corrections. Use a return edge that crosses the ownership boundary so a rejected review has an explicit next action.

Back to diagram overview

Compare with D2L-20-004 · Return incomplete work for correction.

D2 source

direction: right
field: Field team {
  submit: Submit record
  correct: Correct record
  correct -> submit: resubmit {style.stroke-dash: 4}
}
curator: Curator {
  review: Record approved? {shape: diamond}
  store: Archive record
  review -> store: yes
}
field.submit -> curator.review: review request
curator.review -> field.correct: changes needed
ParameterMeaning in this example
curator.reviewPlace approval responsibility inside the curator boundary.
Return handoffSend corrections to the field team rather than leaving a failed review unresolved.

Render this diagram

tools/d2 fmt examples/D2L-22-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-003 --target '' examples/D2L-22-003.d2 figures/D2L-22-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-003 --target '' examples/D2L-22-003.d2 figures/D2L-22-003.png
python3 tools/svg-pdf.py figures/D2L-22-003.svg figures/D2L-22-003.pdf

Try changing: Add a Withdraw record outcome inside field and connect correct to it.

Actual output

Keep the review decision with its owner
D2L-22-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-003.d2 to figures/D2L-22-003.svg in 4.318374ms

success: successfully compiled examples/D2L-22-003.d2 to figures/D2L-22-003.png in 33.444041ms
Render this diagram
tools/d2 fmt examples/D2L-22-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-003 --target '' examples/D2L-22-003.d2 figures/D2L-22-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-003 --target '' examples/D2L-22-003.d2 figures/D2L-22-003.png
python3 tools/svg-pdf.py figures/D2L-22-003.svg figures/D2L-22-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Withdraw record outcome inside field and connect correct to it.

D2L-22-004

Escalate an unresolved exception

An exception can move from routine review to a role with additional decision authority. Use an explicit escalation route when a curator may identify a problem but cannot approve the exception.

Back to diagram overview

Compare with D2L-22-003 · Keep the review decision with its owner.

D2 source

direction: right
submit: Submit exception
curator: Curator {resolve: Within normal policy? {shape: diamond}}
senior: Senior curator {decide: Exception approved? {shape: diamond}}
store: Archive record
reject: Reject request
submit -> curator.resolve
curator.resolve -> store: yes
curator.resolve -> senior.decide: no - escalate
senior.decide -> store: yes
senior.decide -> reject: no
ParameterMeaning in this example
no - escalateHand the exception to the senior curator.
Two decision scopesDistinguish routine policy checks from exception authority.

Render this diagram

tools/d2 fmt examples/D2L-22-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-004 --target '' examples/D2L-22-004.d2 figures/D2L-22-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-004 --target '' examples/D2L-22-004.d2 figures/D2L-22-004.png
python3 tools/svg-pdf.py figures/D2L-22-004.svg figures/D2L-22-004.pdf

Try changing: Add a Request evidence activity before senior.decide.

Actual output

Escalate an unresolved exception
D2L-22-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-004.d2 to figures/D2L-22-004.svg in 5.106209ms

success: successfully compiled examples/D2L-22-004.d2 to figures/D2L-22-004.png in 33.259917ms
Render this diagram
tools/d2 fmt examples/D2L-22-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-004 --target '' examples/D2L-22-004.d2 figures/D2L-22-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-004 --target '' examples/D2L-22-004.d2 figures/D2L-22-004.png
python3 tools/svg-pdf.py figures/D2L-22-004.svg figures/D2L-22-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Request evidence activity before senior.decide.

D2L-22-005

Record every custody transfer

Each physical handoff adds an event to the custody history. Use dashed document associations to distinguish the audit trail from the solid route taken by the sample.

Back to diagram overview

Compare with D2L-20-005 · Separate work order from record flow.

D2 source

direction: right
field: Field team {seal: Seal sample}
courier: Courier {collect: Collect sealed sample}
lab: Laboratory {receive: Receive sealed sample}
log: Custody log {shape: document}
field.seal -> courier.collect: sealed batch
courier.collect -> lab.receive: delivery
field.seal -> log: sealed {style.stroke-dash: 4}
courier.collect -> log: collected {style.stroke-dash: 4}
lab.receive -> log: received {style.stroke-dash: 4}
ParameterMeaning in this example
Solid handoff connectionsTrace the sample from field team through courier to laboratory.
Dashed log connectionsRecord separate custody events without treating the document as another delivery activity.

Render this diagram

tools/d2 fmt examples/D2L-22-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-005 --target '' examples/D2L-22-005.d2 figures/D2L-22-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-005 --target '' examples/D2L-22-005.d2 figures/D2L-22-005.png
python3 tools/svg-pdf.py figures/D2L-22-005.svg figures/D2L-22-005.pdf

Try changing: Add a Check seal activity after lab.receive and a checked event to log.

Actual output

Record every custody transfer
D2L-22-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-005.d2 to figures/D2L-22-005.svg in 4.697958ms

success: successfully compiled examples/D2L-22-005.d2 to figures/D2L-22-005.png in 29.632292ms
Render this diagram
tools/d2 fmt examples/D2L-22-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-005 --target '' examples/D2L-22-005.d2 figures/D2L-22-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-005 --target '' examples/D2L-22-005.d2 figures/D2L-22-005.png
python3 tools/svg-pdf.py figures/D2L-22-005.svg figures/D2L-22-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Check seal activity after lab.receive and a checked event to log.

D2L-22-006

Separate submission from release authority

The person submitting a record is different from the curator reviewing it and the publisher authorizing release. Use separate boundaries to document an independent approval rule and who has the final decision.

Back to diagram overview

Compare with D2L-22-005 · Record every custody transfer.

D2 source

direction: right
field: Field team {
  submit: Submit record
  correct: Correct record
  correct -> submit: resubmit {style.stroke-dash: 4}
}
curator: Curator {review: Review passed? {shape: diamond}}
publisher: Publisher {
  authorize: Release authorized? {shape: diamond}
  release: Publish catalog
  hold: Release held {shape: oval}
  authorize -> release: yes
  authorize -> hold: no
}
field.submit -> curator.review
curator.review -> field.correct: no
curator.review -> publisher.authorize: yes
ParameterMeaning in this example
Three responsibility boundariesKeep submission, review and release authorization distinct.
Release held outcomeShow what happens when the final authority declines to publish.

Render this diagram

tools/d2 fmt examples/D2L-22-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-006 --target '' examples/D2L-22-006.d2 figures/D2L-22-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-006 --target '' examples/D2L-22-006.d2 figures/D2L-22-006.png
python3 tools/svg-pdf.py figures/D2L-22-006.svg figures/D2L-22-006.pdf

Try changing: Add an Explain hold activity before publisher.hold.

Actual output

Separate submission from release authority
D2L-22-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-22-006.d2 to figures/D2L-22-006.svg in 5.195875ms

success: successfully compiled examples/D2L-22-006.d2 to figures/D2L-22-006.png in 46.965417ms
Render this diagram
tools/d2 fmt examples/D2L-22-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-006 --target '' examples/D2L-22-006.d2 figures/D2L-22-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-22-006 --target '' examples/D2L-22-006.d2 figures/D2L-22-006.png
python3 tools/svg-pdf.py figures/D2L-22-006.svg figures/D2L-22-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add an Explain hold activity before publisher.hold.

23 · Reliable operational processes

Model the important failure boundary as carefully as the happy path. Each example states when work is acknowledged, what can be retried or undone and which checks permit the system to continue; D2 itself does not run these operations.

Reference: Official D2 documentation.

D2L-23-001

Acknowledge a queued job separately

A queued receipt confirms admission to the work queue rather than completion of processing. Use separate receipt and completion outcomes when intake work happens asynchronously.

Back to diagram overview

Compare with D2L-22-002 · Distinguish receipt from acceptance.

D2 source

direction: right
submit: Submit batch
queue: Accepted jobs {shape: queue}
receipt: Queued receipt {shape: document}
worker: Validate and store
complete: Completion notice {shape: document}
submit -> queue: enqueue
queue -> receipt: accepted
queue -> worker: dequeue
worker -> complete: processed
ParameterMeaning in this example
queue -> receiptConfirm that the queue accepted the job.
worker -> completeReport completion only after the worker finishes processing.

Render this diagram

tools/d2 fmt examples/D2L-23-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-001 --target '' examples/D2L-23-001.d2 figures/D2L-23-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-001 --target '' examples/D2L-23-001.d2 figures/D2L-23-001.png
python3 tools/svg-pdf.py figures/D2L-23-001.svg figures/D2L-23-001.pdf

Try changing: Add a Failed notice as another labeled outcome of worker.

Actual output

Acknowledge a queued job separately
D2L-23-001 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-001.d2 to figures/D2L-23-001.svg in 2.824167ms

success: successfully compiled examples/D2L-23-001.d2 to figures/D2L-23-001.png in 19.564958ms
Render this diagram
tools/d2 fmt examples/D2L-23-001.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-001 --target '' examples/D2L-23-001.d2 figures/D2L-23-001.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-001 --target '' examples/D2L-23-001.d2 figures/D2L-23-001.png
python3 tools/svg-pdf.py figures/D2L-23-001.svg figures/D2L-23-001.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Failed notice as another labeled outcome of worker.

D2L-23-002

Bound retries with an attempt limit

A retry loop needs a finite attempt budget and an exhausted outcome. Use this model when partner publication may fail repeatedly; n is an illustrative counter drawn as process text, not a value calculated by D2.

Back to diagram overview

Compare with D2L-20-004 · Return incomplete work for correction.

D2 source

direction: right
init: "n = 0"
send: "n = n + 1; send"
ack: Acknowledged? {shape: diamond}
budget: "n < 3?" {shape: diamond}
wait: Wait 30 seconds
done: Delivered {shape: oval}
manual: Hand to operator {shape: oval}
init -> send -> ack
ack -> done: yes
ack -> budget: no
budget -> wait: yes
wait -> send: retry {style.stroke-dash: 4}
budget -> manual: no
ParameterMeaning in this example
n < 3 decisionAllow at most three sends because n increments before each attempt.
Fixed wait / operator outcomeSeparate retry delay from the action taken after the budget is exhausted.

Render this diagram

tools/d2 fmt examples/D2L-23-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-002 --target '' examples/D2L-23-002.d2 figures/D2L-23-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-002 --target '' examples/D2L-23-002.d2 figures/D2L-23-002.png
python3 tools/svg-pdf.py figures/D2L-23-002.svg figures/D2L-23-002.pdf

Try changing: Change the attempt limit to 5 and the fixed delay to 60 seconds.

Actual output

Bound retries with an attempt limit
D2L-23-002 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-002.d2 to figures/D2L-23-002.svg in 3.427834ms

success: successfully compiled examples/D2L-23-002.d2 to figures/D2L-23-002.png in 32.383834ms
Render this diagram
tools/d2 fmt examples/D2L-23-002.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-002 --target '' examples/D2L-23-002.d2 figures/D2L-23-002.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-002 --target '' examples/D2L-23-002.d2 figures/D2L-23-002.png
python3 tools/svg-pdf.py figures/D2L-23-002.svg figures/D2L-23-002.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the attempt limit to 5 and the fixed delay to 60 seconds.

D2L-23-003

Ignore replies after the deadline

The timeout path closes a request identifier before a late reply arrives. Use this sequence to explain why a delayed response must not reopen work that the caller has already timed out.

Back to diagram overview

Compare with D2L-10-005 · Group a review exchange.

D2 source

shape: sequence_diagram
caller: Archive caller
partner: Partner catalog
caller -> partner: request R17
caller.deadline: Deadline is 30 seconds
timeout: Deadline expires {
  caller -> caller: close R17 and record timeout
}
late: Reply arrives later {
  partner -> caller: reply for R17
  caller -> caller: ignore closed R17
}
ParameterMeaning in this example
Deadline groupClose R17 when its deadline expires.
Late reply groupCorrelate the reply with the closed identifier and ignore it.

Render this diagram

tools/d2 fmt examples/D2L-23-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-003 --target '' examples/D2L-23-003.d2 figures/D2L-23-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-003 --target '' examples/D2L-23-003.d2 figures/D2L-23-003.png
python3 tools/svg-pdf.py figures/D2L-23-003.svg figures/D2L-23-003.pdf

Try changing: Change the deadline to 60 seconds without moving the late reply before closure.

Actual output

Ignore replies after the deadline
D2L-23-003 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-003.d2 to figures/D2L-23-003.svg in 2.638083ms

success: successfully compiled examples/D2L-23-003.d2 to figures/D2L-23-003.png in 20.205416ms
Render this diagram
tools/d2 fmt examples/D2L-23-003.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-003 --target '' examples/D2L-23-003.d2 figures/D2L-23-003.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-003 --target '' examples/D2L-23-003.d2 figures/D2L-23-003.png
python3 tools/svg-pdf.py figures/D2L-23-003.svg figures/D2L-23-003.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Change the deadline to 60 seconds without moving the late reply before closure.

D2L-23-004

Undo completed work in reverse order

This process slice assumes accession reservation and data upload succeeded before publication fails. Use compensating actions to remove the uploaded data and then release the accession; these are logical repairs rather than a database transaction rollback.

Back to diagram overview

Compare with D2L-23-003 · Ignore replies after the deadline.

D2 source

grid-columns: 3
horizontal-gap: 140
forward: Completed work {
  reserve: Reserve accession
  upload: Upload data
  publish: Publish metadata
  reserve -> upload -> publish
}
result: Outcome {
  ok: Publication succeeded? {shape: diamond}
  done: Published {shape: oval}
  ok -> done: yes
}
repair: Compensation {
  remove: Remove uploaded data
  release: Release accession
  failed: Publication failed {shape: oval}
  remove -> release -> failed
}
forward.publish -> result.ok
result.ok -> repair.remove: no
ParameterMeaning in this example
Completed work boundaryState which successful actions need compensation.
remove -> releaseUndo the upload before releasing the accession it used.
Grid columns / gapKeep work, outcome and compensation in separate readable columns.

Render this diagram

tools/d2 fmt examples/D2L-23-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-004 --target '' examples/D2L-23-004.d2 figures/D2L-23-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-004 --target '' examples/D2L-23-004.d2 figures/D2L-23-004.png
python3 tools/svg-pdf.py figures/D2L-23-004.svg figures/D2L-23-004.pdf

Try changing: Insert a Record repair result activity before repair.failed.

Actual output

Undo completed work in reverse order
D2L-23-004 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-004.d2 to figures/D2L-23-004.svg in 4.975292ms

success: successfully compiled examples/D2L-23-004.d2 to figures/D2L-23-004.png in 41.558125ms
Render this diagram
tools/d2 fmt examples/D2L-23-004.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-004 --target '' examples/D2L-23-004.d2 figures/D2L-23-004.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-004 --target '' examples/D2L-23-004.d2 figures/D2L-23-004.png
python3 tools/svg-pdf.py figures/D2L-23-004.svg figures/D2L-23-004.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Insert a Record repair result activity before repair.failed.

D2L-23-005

Publish only a verified candidate

The current catalog keeps serving the previous release while a candidate is assembled and checked. Use a staging boundary and a single publication step so failed verification never exposes an unfinished catalog; the model assumes that switching the current pointer is atomic.

Back to diagram overview

Compare with D2L-21-004 · Separate completion from success.

D2 source

direction: right
build: Build candidate
staging: Staged release {shape: cylinder}
verify: Verification passed? {shape: diamond}
promote: Switch current pointer
published: New release current {shape: oval}
discard: Discard candidate
previous: Previous release current {shape: oval}
build -> staging -> verify
verify -> promote: yes
promote -> published
verify -> discard: no
discard -> previous
ParameterMeaning in this example
Staged releaseKeep unfinished candidate data outside the current catalog.
Switch current pointerPublish only after verification; atomic switching is a stated system assumption.

Render this diagram

tools/d2 fmt examples/D2L-23-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-005 --target '' examples/D2L-23-005.d2 figures/D2L-23-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-005 --target '' examples/D2L-23-005.d2 figures/D2L-23-005.png
python3 tools/svg-pdf.py figures/D2L-23-005.svg figures/D2L-23-005.pdf

Try changing: Add a Check signature activity before verify.

Actual output

Publish only a verified candidate
D2L-23-005 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-005.d2 to figures/D2L-23-005.svg in 2.755083ms

success: successfully compiled examples/D2L-23-005.d2 to figures/D2L-23-005.png in 32.231042ms
Render this diagram
tools/d2 fmt examples/D2L-23-005.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-005 --target '' examples/D2L-23-005.d2 figures/D2L-23-005.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-005 --target '' examples/D2L-23-005.d2 figures/D2L-23-005.png
python3 tools/svg-pdf.py figures/D2L-23-005.svg figures/D2L-23-005.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Check signature activity before verify.

D2L-23-006

Resume intake only after recovery checks

Recovery pauses writes before restoring a verified snapshot. Use an explicit validation gate so a failed recovery check leaves intake paused and hands the incident to an operator.

Back to diagram overview

Compare with D2L-23-005 · Publish only a verified candidate.

D2 source

direction: right
incident: Detect corruption
pause: Pause intake writes
restore: Restore snapshot
check: Recovery checks pass? {shape: diamond}
resume: Resume intake
recovered: Service restored {shape: oval}
manual: Keep paused - operator recovery {shape: oval}
snapshot: Verified snapshot {shape: cylinder}
incident -> pause -> restore -> check
snapshot -> restore: restore source {style.stroke-dash: 4}
check -> resume: yes
resume -> recovered
check -> manual: no
ParameterMeaning in this example
pause -> restore -> checkRestore while intake writes remain disabled.
yes / no recovery outcomesResume only after successful validation; failure keeps the system paused.

Render this diagram

tools/d2 fmt examples/D2L-23-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-006 --target '' examples/D2L-23-006.d2 figures/D2L-23-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-006 --target '' examples/D2L-23-006.d2 figures/D2L-23-006.png
python3 tools/svg-pdf.py figures/D2L-23-006.svg figures/D2L-23-006.pdf

Try changing: Add a Verify catalog links activity between restore and check.

Actual output

Resume intake only after recovery checks
D2L-23-006 · Rendered by D2

D2 · exit 0

Native compiler log

Standard error

success: successfully compiled examples/D2L-23-006.d2 to figures/D2L-23-006.svg in 3.120167ms

success: successfully compiled examples/D2L-23-006.d2 to figures/D2L-23-006.png in 46.328292ms
Render this diagram
tools/d2 fmt examples/D2L-23-006.d2
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-006 --target '' examples/D2L-23-006.d2 figures/D2L-23-006.svg
tools/d2 --layout dagre --theme 0 --pad 24 --salt D2L-23-006 --target '' examples/D2L-23-006.d2 figures/D2L-23-006.png
python3 tools/svg-pdf.py figures/D2L-23-006.svg figures/D2L-23-006.pdf

Download: D2 source · Source + local inputs ZIP · Render configuration · SVG diagram · Vector PDF · PNG preview

Try changing: Add a Verify catalog links activity between restore and check.

Example and command index

Content: CC0 1.0. Structure and publishing framework: CC BY 4.0 by Lukas C. Bossert. Repository source · Publishing framework source · License scope and third-party notices.