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/import/buildOptions.md

View on GitHub
# Choose Build Options

## 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+) |

## Import Workflow

For the full import workflow (file location requirements, `ImportStep="Load"` for inspection, connection strategy), see [importScene.md](importScene.md). 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.

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