Skip to content

matlab/matlab-agentic-toolkit / skills-catalog/automotive/roadrunner-build-rrhd-map

roadrunner-build-rrhd-map

Verified

Build, convert, and import RoadRunner HD Maps (.rrhd) in MATLAB. Author lanes, lane boundaries, markings, junctions, signs, barriers, and speed limits with roadrunnerHDMap; convert Lanelet2 (.osm, Autoware) maps to RRHD; resolve RoadRunner road asset paths for markings, crosswalks, signs, signals, and barriers; and import or build .rrhd or OpenDRIVE (.xodr) files into a RoadRunner scene. Use when creating road networks for driving simulation, converting Lanelet2 or other HD map sources to RRHD, looking up road asset paths, or loading and verifying a map in RoadRunner or RoadRunner Scene Builder. Not for building scenes from recorded sensor data, running simulations, or recreating OpenSCENARIO (.xosc) scenarios.

FileKindSize
SKILL.mdskill md15.5 KB
manifest.yamlconfig557 B
references/assets/assetCatalog.mdmarkdown7.4 KB
references/assets/barriers.mdmarkdown3.6 KB
references/assets/laneMarkings.mdmarkdown5.8 KB
references/assets/laneTypes.mdmarkdown2.2 KB
references/assets/signs.mdmarkdown5.0 KB
references/assets/staticObjects.mdmarkdown5.1 KB
references/authoring/alignmentRules.mdmarkdown10.3 KB
references/authoring/apiReference.mdmarkdown9.0 KB
references/authoring/authoringWorkflow.mdmarkdown20.4 KB
references/authoring/deduplicateBoundaries.mdmarkdown4.9 KB
references/authoring/junctionPolygon.mdmarkdown6.8 KB
references/authoring/leftGapFilter.mdmarkdown6.5 KB
references/authoring/orthogonalSplit.mdmarkdown7.7 KB
references/authoring/resolveHeights.mdmarkdown2.4 KB
references/authoring/snapEndpoints.mdmarkdown4.0 KB
references/authoring/splitClosedGeometry.mdmarkdown3.8 KB
references/authoring/synthesizeCenterLine.mdmarkdown4.6 KB
references/authoring/validateMap.mdmarkdown1.1 KB
references/import/buildOptions.mdmarkdown4.0 KB
references/import/importScene.mdmarkdown12.9 KB
references/lanelet2/buildRRHD.mdmarkdown14.2 KB
references/lanelet2/conversionPipeline.mdmarkdown13.3 KB
references/lanelet2/coordinates.mdmarkdown4.9 KB
references/lanelet2/discoverRelations.mdmarkdown2.4 KB
references/lanelet2/enforcementGate.mdmarkdown3.3 KB
references/lanelet2/extractGeometry.mdmarkdown3.4 KB
references/lanelet2/extractJunctions.mdmarkdown5.0 KB
references/lanelet2/extractLanelets.mdmarkdown2.6 KB
references/lanelet2/extractNonLaneElements.mdmarkdown14.4 KB
references/lanelet2/extractSemantics.mdmarkdown4.4 KB
references/lanelet2/extractTopology.mdmarkdown5.4 KB
references/lanelet2/placedObjects.mdmarkdown4.4 KB
references/lanelet2/readOSM.mdmarkdown4.0 KB
references/lanelet2/splitClosedRoads.mdmarkdown3.0 KB
scripts/detectAlignment.mother3.3 KB
scripts/detectClosedLoop.mother5.8 KB
scripts/detectJunctions.mother12.4 KB
scripts/discoverWayTypes.mother4.8 KB
scripts/parseOSM.mother4.0 KB
scripts/resolveHeightConflicts.mother6.8 KB
scripts/resolveSignAsset.mother7.2 KB
scripts/snapConnectedEndpoints.mother4.0 KB
scripts/validateRRHD.mother6.3 KB

references/lanelet2/extractSemantics.md

View on GitHub
# Extract Semantics

## Description
Extracts semantic information from Lanelet2 data and maps it to RRHD equivalents:
- **Lane markings:** Maps linestring `type`/`subtype` tags (e.g. `line_thin`/`solid`) to RRHD marking asset paths
- **Speed limits:** Collects unique speed limit values and groups lanelets by value
- **Lane types:** Maps lanelet `subtype` (road, highway, crosswalk, etc.) to RRHD `LaneType`

### Linestring Type Mapping
Colour comes from the way's `color` tag when present; otherwise from `region` ([coordinates.md](coordinates.md)): double and dashed-solid lines are **yellow in the US**, **white elsewhere** (German StVO and Japanese centre lines are white). Single lines are white unless tagged yellow.

| Lanelet2 subtype | White (default outside US) | Yellow (US default, or `color=yellow`) |
|---|---|---|
| `solid` | `SolidSingleWhite.rrlms` | `SolidSingleYellow.rrlms` |
| `dashed` | `DashedSingleWhite.rrlms` | `DashedSingleYellow.rrlms` |
| `solid_solid` | `SolidDoubleWhite.rrlms` | `SolidDoubleYellow.rrlms` |
| `dashed_solid` | `DashedSolidWhite.rrlms` | `DashedSolidYellow.rrlms` |
| `solid_dashed` | `DashedSolidWhite.rrlms` (+ `FlipLaterally=true`) | `DashedSolidYellow.rrlms` (+ `FlipLaterally=true`) |

## Inputs
| Parameter | Type | Description |
|-----------|------|-------------|
| `lanelets` | struct array | From `extractLanelets` |
| `region` | string | `"Japan"`/`"Germany"`/`"US"` from [coordinates.md](coordinates.md) |
| `ll2` | struct | Parsed Lanelet2 data from `readOSM` |

## Output
`sem` — struct with:
| Field | Type | Description |
|-------|------|-------------|
| `.markingMap` | containers.Map | wayID -> struct(type, subtype, rrhdAsset, rrhdMarkingID) |
| `.speedLimits` | struct array | Each with `.value` (double), `.laneletIDs` (string array) |
| `.laneTypeMap` | containers.Map | laneletID -> RRHD lane type string |

## Validated Implementation Pattern
```matlab
% Marking lookup: way subtype + colour -> RRHD asset/ID (colour: `color` tag, else region default)
markingStyle = containers.Map( ...
    {'solid','dashed','solid_solid','dashed_solid','solid_dashed'}, ...
    {{'SolidSingle', false, false}, {'DashedSingle', false, false}, {'SolidDouble', true, false}, ...
     {'DashedSolid', true, false}, {'DashedSolid', true, true}});   % {base, isDoubleLine, flip}

sem.markingMap = containers.Map('KeyType','char','ValueType','any');
sem.markingDefs = containers.Map('KeyType','char','ValueType','any');
wayKeys = ways.keys;
for i = 1:numel(wayKeys)
    w = ways(wayKeys{i});
    if ~w.tags.isKey('subtype') || ~markingStyle.isKey(w.tags('subtype')), continue; end
    st = markingStyle(w.tags('subtype'));
    if w.tags.isKey('color')
        isYellow = strcmpi(w.tags('color'), 'yellow');
    else
        isYellow = st{2} && region == "US";
    end
    colour = 'White'; if isYellow, colour = 'Yellow'; end
    info = struct('asset', ['Assets/Markings/' st{1} colour '.rrlms'], 'id', [st{1} colour], 'flip', st{3});
    sem.markingMap(wayKeys{i}) = info;
    sem.markingDefs(info.id) = info;  % unique marking definitions
end

% Lane type mapping
ltLookup = containers.Map( ...
    {'road','highway','parking','bicycle_lane','emergency_lane','bus_lane'}, ...
    {'Driving','Driving','Parking','Biking','Shoulder','Driving'});
% NOTE: 'crosswalk' and 'walkway' subtypes are NOT lanes — they become CurveMarkings (Step 8b)

% Participant tags take precedence over subtype (Lanelet2 participant:* overrides the subtype default).
% e.g. an urban map: subtype=road with participant:vehicle=no, participant:bicycle=yes -> Biking.
isTag = @(t, k, v) t.isKey(k) && strcmp(t(k), v);
sem.laneTypeMap = containers.Map('KeyType','char','ValueType','char');
for i = 1:numel(lanelets)
    t = lanelets(i).tags;
    st = char(lanelets(i).subtype);
    if isTag(t, 'participant:vehicle', 'no') && isTag(t, 'participant:bicycle', 'yes')
        lt = 'Biking';
    elseif isTag(t, 'participant:vehicle', 'no') && isTag(t, 'participant:pedestrian', 'yes')
        lt = 'Sidewalk';
    elseif ltLookup.isKey(st)
        lt = ltLookup(st);
    else
        lt = 'Driving';
    end
    sem.laneTypeMap(char(lanelets(i).id)) = lt;
end
```

> **Note:** Ways without `type`/`subtype` tags have no lane markings — their boundaries
> should get no `ParametricAttributes` (unmarked/virtual boundaries).

## Example
```matlab
info = sem.markingMap('70');  % Get marking info for way ID "70"
```

----

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