Skip to content

zrwangems/dsh-zrwang-plugin / skills/engineering/matlab/automotive/roadrunner-convert-lanelet2-to-rrhd

roadrunner-convert-lanelet2-to-rrhd

Verified

Convert 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.

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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall