Skip to content

Evidence methods guide

DXF Units and Coordinate Export Review: Keep Header Hints and Entity Coordinates Together

Review DXF header unit hints, group-code pairs, entity boundaries, WCS coordinates, extrusion vectors, layers, and export transforms before importing a drawing.

DXF coordinates are numbers in a structured text stream, but a number alone does not identify units, coordinate system, entity role, or transform history. Start with the HEADER variables such as INSUNITS and MEASUREMENT, then parse entity group codes without relying on their displayed order. Keep WCS point values, extrusion vectors, layer and space metadata, and any export transform as separate evidence. This guide is CAD-format guidance, not a viewer, coordinate transformation, survey assessment, privacy decision, or permission claim.

Updated

On this page

Record unit hints without treating them as a transform

Record a neutral file ID, digest, DXF version, code page if present, $INSUNITS, $MEASUREMENT, $LUNITS, base points, extents, and the exporter or transform note. The Autodesk, (opens in a new tab) table gives $INSUNITS as a default unit hint and $MEASUREMENT as an English or Metric setting. Neither field alone proves the units used by every entity or dimension.

The source dates in this guide use 22 October 2026 as retrieval evidence for documentation without a verified publication date. They are not publication claims. Where a verified publication date is available, it is recorded in the source ledger.

Record unit hints without treating them as a transform (table)
Header evidenceRecordStop if
DXF versionACADVER value and readerVersion is guessed from extension
$INSUNITSCode and decoded labelUnitless is converted silently
$MEASUREMENTEnglish or Metric settingIt is treated as a coordinate scale
$INSBASEWCS insertion base pointBase is applied without recording
ExtentsHeader min and max valuesExtents are treated as geometry proof
Export noteSource transform and tool versionA transform is inferred from drawing size

Keep a raw header snapshot and a normalized interpretation. If a consumer asks for millimeters or a projected coordinate system, record the requested transform separately from the source unit hint. Do not overwrite the source numbers to make a preview look correct.

Parse group codes as typed pairs, not fixed line positions

The Autodesk, (opens in a new tab) documentation says group-code order can change and undefined codes should be tolerated by a table-driven parser. Record code, raw value, decoded type, entity path, source offset, and whether the code is optional. A point is assembled from related X, Y, and Z code values, not from one number chosen by line position.

Parse group codes as typed pairs, not fixed line positions (table)
Parser fieldRecordOpen question
Entity boundaryCode 0 and entity typeIs the next 0 a new entity or section end?
HandleCode 5 and owner referencesCan the object be linked without names?
LayerCode 8 and layer stateDoes layer visibility change interpretation?
Point codes10, 20, 30 or related tripletsAre all coordinates in the same WCS?
Extrusion210, 220, 230 when presentDid a consumer apply a normal transform?
Unknown codeRaw code and bounded value summaryCan it affect geometry or ownership?

Keep WCS coordinates, entity roles, and flags together

The Autodesk, (opens in a new tab) reference lists 3DFACE corner coordinates in WCS and an optional invisible-edge flag. Record entity type, section, layer, point tuples, elevation or extrusion fields, flags, and sequence. A coordinate range can be numerically plausible while belonging to a different unit or entity role.

Keep WCS coordinates, entity roles, and flags together (table)
Entity evidenceSupportsCannot prove
Point tupleDecoded X, Y, Z values for one entity fieldReal-world location or datum
WCS labelThe specification’s coordinate contextA drawing-wide projection
Extrusion vectorEntity orientation metadataA complete transform history
LayerGrouping and display contextOwnership of the geometry
Invisible-edge flagRendering hint for a face edgeThat the edge is absent
Handle and ownerReference relationshipsHuman identity of a creator

Synthetic 3DFACE record

Keep WCS coordinates, entity roles, and flags together code example, JSON
{"entity":"3DFACE","layer":"fixture-layer","corners":[["fixture-x1","fixture-y1","fixture-z1"],["fixture-x2","fixture-y2","fixture-z2"],["fixture-x3","fixture-y3","fixture-z3"],["fixture-x4","fixture-y4","fixture-z4"]],"coordinate_context":"WCS","invisible_edges":"fixture-flags","unit_decision":"unresolved"}

Reconcile source and transformed exports

Compare entity counts by type, layer, and section before and after any import or export. Capture source digest, reader version, transformed digest, unit assumption, origin shift, scale, axis change, and dropped or synthesized entities. A visually aligned preview does not prove coordinate identity or preservation of non-graphical objects.

Reconcile source and transformed exports (table)
ComparisonRecordHold when
Header to entity unitsHint and interpreted unit policyNo source basis for scale
Entity countCounts by type and sectionImporter drops unknown entities
CoordinatesSampled tuples and transform formulaAxis or origin changes are implicit
LayersNames, visibility, and countsLayer state is flattened
Unknown codesPreserved, ignored, or rewrittenParser silently discards them
Round tripChanged bytes and semantic findingsOnly visual comparison is available

Stop before unit or coordinate meaning is guessed

Stop conditions

  • Stop if DXF version, unit hints, code page, base point, or export transform is unknown.
  • Stop if an entity parser depends on code order, skips group 0 boundaries, or drops undefined codes.
  • Stop if coordinate triplets, WCS context, extrusion vectors, or entity roles cannot be matched.
  • Stop if a unitless drawing is scaled from a preview or a layer name without source evidence.
  • Stop if a round trip changes entities, flags, or coordinates without a transform record.
  • Stop before sampling real geometry when layers, paths, or coordinates expose private locations.

Pair this worksheet with the data provenance log for export and transform history and the data card template for collection context. A valid DXF parse does not prove coordinate accuracy, ownership, privacy clearance, or permission.

For a supported non-health collection, after the owner has authority to describe the scope and a controlled metadata packet, the qualified physical-data appraisal request path may be a preparation step. It does not render CAD, transform coordinates, certify a survey, create a quote, match a buyer, or grant a license.

Sources

  1. Autodesk: HEADER Section Group Codes, DXF (opens in a new tab)
  2. Autodesk: Common Group Codes for Entities, DXF (opens in a new tab)
  3. Autodesk: 3DFACE, DXF (opens in a new tab)

Use the physical-data appraisal path after the DXF packet is organized.

It does not render CAD, transform coordinates, certify a survey, create a quote, match a buyer, or grant a license.