DEVELOPERS · IMPORT URDF

TOOLCHAIN 0.1.1 · WORKING ALPHA

Extract what the URDF proves. Invent nothing.

The current URDF importer creates a partial, non-actuating OpenRGD Foundation profile from source-supported structural and physical evidence.

IMPLEMENTATION BOUNDARY

URDF import is implemented and lifecycle-tested. It does not create kernel identity, safety policy, alignment, cognition, skills, HAL bindings, controller configuration or hardware authorization.

COMMAND

Import to a partial profile.

URDF importshell
rgd import robot.urdf --out partial-robot

OUTPUT

Only two Foundation modules are emitted.

partial-robotshell
partial-robot/
└── spec/
    └── 01_foundation/
        ├── description.jsonc
        └── actuation_dynamics.jsonc

SUPPORTED EVIDENCE

The importer preserves source facts that it can justify.

01

Robot + links

Robot name, links and supported structural relationships.

02

Inertials

Mass, origin and complete inertia tensor when present.

03

Joint topology

Joint name/type, parent-child connectivity, origin and axis.

04

Limits

Declared revolute/prismatic limits using type-correct units.

05

Dynamics

Source damping and friction when authored.

06

Mimic

Mimic relationships remain explicit rather than inferred.

FAIL CLOSED

Missing or malformed data does not receive a convenient default.

Absent numeric values remain absent. Malformed or non-finite physical values fail import. The importer does not infer transmissions, controllers, vendor plugins, bus addresses or calibration.

OPTIONAL ENRICHMENT

Enrichment is a separate explicit operation.

Seed enrichmentshell
rgd alive robot.urdf --out RGD-robot --seed default

The resulting project records seed_compatibility_status = UNVERIFIED. A valid source-tree hash does not prove that inherited calibration, HAL, safety or behavioral assumptions fit the imported body.

RELATED GUIDES

Continue through the verified toolchain.

CANONICAL SOURCE