Altium Exporter Mapping Guide
Informative mapping guidance for Altium-based CGES exporters.
Status
| Guide Type | Informative (non-normative) |
| Primary Contract | CGES-CORE-1.0 + CGES-JSON-1.0 |
| Reference Script | exporters/altium/24.x/cges_altium_json_v1_0.pas |
| Last Updated | 2026-03-13 |
This guide does not replace profile-level MUST language in the CGES standard.
Recommended exporter workflow is summarized in docs/implementer-workflow.html.
Human-readable EPSA transport semantics and canonical JSON field names are summarized in docs/reference/epsa-extension.html.
Recommended Mapping
| CGES Field / Concept | Recommended Altium Source | Notes |
|---|---|---|
identity.board_pn | Project parameter PART_NUMBER (fallback: schematic parameter) | If unresolved, apply default UNKNOWN. |
identity.board_rev | Project parameter REVISION (fallback: schematic parameter) | If unresolved, apply default -. |
metadata.schematic_revision | Project or schematic parameter representing document revision (for example SCH_REVISION or mapped equivalent; fallback: REVISION) | May equal identity.board_rev when no separate schematic revision exists. |
metadata.revision | Deprecated legacy alias for metadata.schematic_revision | Do not emit in new CGES-CORE-1.0 payloads unless backward compatibility requires it. If emitted, it must equal metadata.schematic_revision. |
metadata.project_name | Project parameter TITLE | May be empty when unavailable. |
metadata.analysis_context.epsa_board | Project or board parameter set mapped from EPSA_* board attributes | Use when claiming CGES-EPSA-BOARD-0.1. |
metadata.source_tool | Exporter-generated literal (for example Altium Designer 24.x) | Keep deterministic and versioned. |
components[].refdes | Component designator | Must be non-empty and unique within emitted scope. |
components[].value | Component comment/value parameter | May be empty. |
components[].footprint | Assigned PCB footprint model name | May be empty. |
role/function | Component parameters with case-insensitive key matching | Core required component semantics. |
components[].analysis_modules.epsa | Mapped from tolerance, v_rating, i_rating, p_rating, and EPSA_* aliases | Normalize into canonical keys such as tolerance, voltage_rating, current_rating, and power_rating. Use when claiming CGES-EPSA-COMPONENT-0.1. |
components[].analysis_modules.fmea, components[].analysis_modules.wcca | Project/component parameters mapped to module keys | Optional analysis bundles. |
components[].pins[].pin_number | Pin designator from compiled connectivity model | Use deterministic string representation. |
components[].pins[].net | Connected net name | May be empty when unresolved. |
nets[].name | Compiled net label/name | Use empty string only when unnamed. |
test_integration.test_points | Components with designator prefix TP | Follow profile-level requirements for measurement type and net mapping. |
Markdown pinout (P1) | Component parameters on designator P1 where key starts with pin | Follow Section 7.7 emission rules. |
| Excluded utility parts | Designator prefix filtering per Section 5.1 | Apply profile-specific exclusions consistently. |
P1 and similar identifiers are informative source-side examples from the core documentation, not mandatory Altium object names.