Skip to main content

Import and Export

Use the header Export menu to save the current chain in several formats or load a previously exported JSON chain.

Diagram export​

Use these options when you want an image of the canvas:

FormatUse case
PNGScreenshots, slides, documentation
PDFPrint-ready chain diagram

These exports include only the chain canvas. Interactive controls such as buttons and handles are hidden automatically.

Data export​

The same menu also provides structured exports for reuse outside the canvas:

FormatContentsTypical use
JSONFull chain structure in importable form: ordered blocks, roles, labels, linked MPNs, numeric parameters, tags, and connectionsSave, share, duplicate, or migrate a chain
CSVOne row per block with canonical parameter columnsSpreadsheet review or editing
BOM CSVLinked component and bill-of-materials-oriented dataParts review or procurement workflows
Analysis CSVCurrent computed analysis resultsOffline reporting or comparisons

Import JSON​

Use Export > Import JSON to load a clean JSON chain file.

The import file must contain:

  • nodes
  • edges

Optional top-level metadata may also be present:

  • format_version
  • exported_at

Each node can include:

  • block
  • component
  • label
  • mpn
  • params
  • tags

Each edge can include:

  • from_block
  • to_block
  • src_port
  • dst_port

Import behavior​

Import rebuilds the chain from the JSON payload in a deterministic order:

  1. The current chain is reset.
  2. Blocks are recreated in block order.
  3. Connections are restored.
  4. Numeric parameters are applied.
  5. Tags are applied.
caution

Import replaces the current chain contents. Save a Snapshot first if you may want to return to the current state.

Parameter handling​

JSON import accepts numeric block parameters only.

Parameter keys are matched flexibly against the block parameter registry. For example, import can resolve canonical IDs such as gain_db as well as label-style keys such as Gain (dB) when they map unambiguously to a block parameter.

Unknown parameter keys are ignored. Invalid non-numeric parameter values cause the import to fail.

Notes​

  • JSON export is intended to round-trip with JSON import.
  • CSV export is for review convenience and is not the same as the JSON import format.
  • BOM CSV and Analysis CSV depend on the data currently available in the UI.