zrwangems/dsh-zrwang-plugin / skills/engineering/matlab/automotive/roadrunner-convert-lanelet2-to-rrhd
roadrunner-convert-lanelet2-to-rrhd
VerifiedConvert Lanelet2 maps (.osm) to RoadRunner HD Map (.rrhd) format using MATLAB. Use when converting Lanelet2 maps into RoadRunner Scene Builder, building driving scenes from open-source map data, or transforming road network definitions for simulation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 27.2 KB |
| manifest.yaml | config | 635 B |
| references/buildRRHD.md | markdown | 14.4 KB |
| references/detectGeoReference.md | markdown | 1.2 KB |
| references/discoverRelations.md | markdown | 2.2 KB |
| references/enforcementGate.md | markdown | 3.3 KB |
| references/extractGeometry.md | markdown | 6.1 KB |
| references/extractJunctions.md | markdown | 6.4 KB |
| references/extractLanelets.md | markdown | 2.3 KB |
| references/extractNonLaneElements.md | markdown | 21.1 KB |
| references/extractSemantics.md | markdown | 3.5 KB |
| references/extractTopology.md | markdown | 5.2 KB |
| references/importIntoRoadRunner.md | markdown | 4.3 KB |
| references/latlon2enu.md | markdown | 1.4 KB |
| references/mapLanelet2SignCode.md | markdown | 3.7 KB |
| references/placedObjects.md | markdown | 3.9 KB |
| references/readOSM.md | markdown | 4.0 KB |
| references/signCodeMapping.md | markdown | 4.4 KB |
| references/snapEndpoints.md | markdown | 4.0 KB |
| references/splitClosedRoads.md | markdown | 3.0 KB |
| scripts/discoverWayTypes.m | other | 3.7 KB |
| scripts/parseOSM.m | other | 3.8 KB |
references/placedObjects.md
View on GitHub# Placed Objects (Custom Relations)
Lanelet2 files exported from RRHD contain placed objects encoded as custom relations. This reference describes how to parse and reconstruct them.
## Relation Type Patterns
### Type Definitions (`custom:*_type`)
Relations with `type` matching `custom:{category}_type` define asset types:
| Relation type tag | Category | Fields |
|---|---|---|
| `custom:sign_type` | Sign | `custom:id`, `custom:asset_path` |
| `custom:signal_type` | Signal | `custom:id`, `custom:asset_path` |
| `custom:static_object_type` | StaticObject | `custom:id`, `custom:asset_path` |
| `custom:stencil_marking_type` | StencilMarking | `custom:id`, `custom:asset_path` |
| `custom:curve_marking_type` | CurveMarking | `custom:id`, `custom:asset_path` |
### Placed Instances (Bounding Box)
Relations with `type` matching `custom:sign`, `custom:signal`, `custom:static_object`, or `custom:stencil_marking`:
| Tag | Description |
|---|---|
| `custom:id` | Instance ID |
| `custom:type_ref` | Reference to type definition ID |
| `custom:center_x/y/z` | Position in ENU meters |
| `custom:dim_x/y/z` | Bounding box dimensions |
| `custom:rot_x/y/z` | Rotation in degrees |
| `custom:metadata` | Optional metadata string |
### CurveMarking Instances
Relations with `type=custom:curve_marking`:
| Tag | Description |
|---|---|
| `custom:id` | Instance ID |
| `custom:type_ref` | Reference to type definition ID |
| `custom:flip` | `"true"` or `"false"` |
| `custom:reverse` | `"true"` or `"false"` |
| Member with `role="geometry"` | Way reference containing polyline geometry |
### LaneGroup Definitions
Relations with `type=custom:lane_group`:
| Tag/Member | Description |
|---|---|
| `custom:id` | Group ID |
| Member with `role="geometry"`, `type="way"` | Reference line geometry |
| Members with `type="relation"`, `role="lane_{alignment}"` | Lane references with alignment suffix |
## Building RRHD Placed Objects
### SignTypes / SignalTypes / StaticObjectTypes / StencilMarkingTypes / CurveMarkingTypes
```matlab
% For each type definition:
typeObj = roadrunner.hdmap.SignType; % (or SignalType, etc.)
typeObj.ID = typeID;
rap = roadrunner.hdmap.RelativeAssetPath;
rap.AssetPath = assetPath;
typeObj.AssetPath = rap;
```
### Sign / Signal / StaticObject / StencilMarking Instances
```matlab
% For each placed instance:
obj = roadrunner.hdmap.Sign; % (or Signal, StaticObject, StencilMarking)
obj.ID = instanceID;
% Type reference
typeRef = roadrunner.hdmap.Reference;
typeRef.ID = typeRefID;
obj.SignTypeID = typeRef; % (or SignalTypeID, etc.)
% Bounding box
bb = roadrunner.hdmap.BoundingBox;
bb.Center = center; % [x y z]
bb.Dimension = dimension; % [dx dy dz]
bb.Orientation = orientation; % [rx ry rz] degrees
obj.BoundingBox = bb;
```
### CurveMarking Instances
```matlab
obj = roadrunner.hdmap.CurveMarking;
obj.ID = instanceID;
typeRef = roadrunner.hdmap.Reference;
typeRef.ID = typeRefID;
obj.CurveMarkingTypeID = typeRef;
obj.Geometry = geometry; % Nx3 from way member
obj.Flip = logical(flip);
obj.Reverse = logical(reverse);
```
### LaneGroups
```matlab
obj = roadrunner.hdmap.LaneGroup;
obj.ID = groupID;
obj.Geometry = geometry; % from way member
% Lane references with alignment
for each lane ref:
ar = roadrunner.hdmap.AlignedReference;
ref = roadrunner.hdmap.Reference;
ref.ID = laneID;
ar.Reference = ref;
ar.Alignment = alignment; % from role suffix
obj.Lanes(end+1) = ar;
end
```
## Assembly
After building all placed object arrays, assign to the map:
```matlab
rrMap.SignTypes = signTypeArray;
rrMap.Signs = signArray;
rrMap.SignalTypes = signalTypeArray;
rrMap.Signals = signalArray;
rrMap.StaticObjectTypes = staticObjTypeArray;
rrMap.StaticObjects = staticObjArray;
rrMap.StencilMarkingTypes = stencilTypeArray;
rrMap.StencilMarkings = stencilArray;
rrMap.CurveMarkingTypes = curveMarkingTypeArray;
rrMap.CurveMarkings = curveMarkingArray;
rrMap.LaneGroups = laneGroupArray;
```
----
Copyright 2026 The MathWorks, Inc.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |