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/importIntoRoadRunner.md
View on GitHub# Import into RoadRunner
After writing the `.rrhd` file, import it into RoadRunner using the `roadrunner-import-scene` skill. This reference covers build options for controlling how the RRHD is built into a scene.
## Build Options Reference (`roadrunnerHDMapBuildOptions`)
| Property | Type | Default | Description |
|---|---|---|---|
| `FitCrossSections` | logical | `"auto"` | Enable cross-section fitting |
| `DetectAsphaltSurfaces` | logical | `"auto"` | Generate road surfaces |
| `ClearSceneOfExistingData` | logical | `"auto"` | Remove prior scene content |
| `CurvatureBlend` | double | `"auto"` | Position of fit arcs in transitions |
| `UseLaneGroups` | logical | `"auto"` | Combine only same-group lanes into roads (R2024a+) |
| `CombineTransitionLanes` | logical | `"auto"` | Merge transition lanes into single road (R2025a+) |
| `AutoDetectBridgesOptions` | `autoDetectBridgesOptions` | `"auto"` | Bridge detection settings |
| `EnableOverlapGroupsOptions` | `enableOverlapGroupsOptions` | `"auto"` | Junction creation from overlaps |
## `enableOverlapGroupsOptions` Properties
| Property | Type | Default | Description |
|---|---|---|---|
| `IsEnabled` | logical | `false` | When `false`, RoadRunner creates automatic junctions at geometric overlaps. When `true`, overlapping lanes are grouped (no auto junctions). |
| `GroupName` | string | `"SceneBuild"` | Overlap group identifier |
| `PreserveJunctionLanes` | logical | `"auto"` | Retain junction lane definitions from RRHD (R2026a+) |
| `PreserveJunctionShape` | logical | `"auto"` | Maintain junction polygon geometry from RRHD (R2026a+) |
## CRITICAL: Use `roadrunner-import-scene` Skill
For the full import workflow (file location requirements, `ImportStep="Load"` for inspection, connection strategy), see the `roadrunner-import-scene` skill. Key points:
- **File must be inside the RoadRunner project folder** — copy it there before `importScene`
- **`ImportStep="Load"`** for HD Map inspection without building
- **Omitting ImportStep triggers a build** — use `"Load"` explicitly when you only want to inspect
## Without explicit junctions — let RoadRunner auto-detect from overlaps:
```matlab
importOpts = roadrunnerHDMapImportOptions;
buildOpts = roadrunnerHDMapBuildOptions;
buildOpts.ClearSceneOfExistingData = true;
buildOpts.DetectAsphaltSurfaces = true;
% EnableOverlapGroups.IsEnabled = false (default) means RoadRunner
% creates junctions automatically where lanes geometrically overlap.
% No explicit action needed — default behavior produces junctions from overlaps.
importOpts.BuildOptions = buildOpts;
importScene(rrApp, destFile, "RoadRunner HD Map", importOpts);
```
## With explicit junctions in RRHD (preserve authored junction polygons):
```matlab
importOpts = roadrunnerHDMapImportOptions;
buildOpts = roadrunnerHDMapBuildOptions;
buildOpts.ClearSceneOfExistingData = true;
buildOpts.DetectAsphaltSurfaces = true;
% Enable overlap groups + preserve junction definitions from RRHD
eoOpts = enableOverlapGroupsOptions;
eoOpts.IsEnabled = true;
eoOpts.PreserveJunctionLanes = true;
eoOpts.PreserveJunctionShape = true;
buildOpts.EnableOverlapGroupsOptions = eoOpts;
importOpts.BuildOptions = buildOpts;
importScene(rrApp, destFile, "RoadRunner HD Map", importOpts);
```
## Suppress junctions entirely (overlap grouping, no junctions):
```matlab
eoOpts = enableOverlapGroupsOptions;
eoOpts.IsEnabled = true; % group overlapping lanes instead of creating junctions
buildOpts.EnableOverlapGroupsOptions = eoOpts;
```
## Troubleshooting After Import
| Issue | Cause |
|---|---|
| Grass on road surface | Wrong boundary alignment — check dot product logic |
| Markings in junction | Junction boundary markings not stripped |
| Disconnected lanes | Topology threshold too tight or opposing boundaries not detected |
| Giant junction polygon | Used union-find instead of proximity BFS clustering |
| No junctions at intersections | `EnableOverlapGroupsOptions.IsEnabled` is `true` — set to `false` |
| "connectedLane.Object != this" error on import | Self-referencing topology (lane is its own pred/succ) |
| "A name is expected" error | Used positional args for RelativeAssetPath or AlignedReference |
| Empty array assignment error | Used `[]` instead of `ClassName.empty` for typed properties |
---
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: 196k | 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: 196k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |