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/splitClosedRoads.md

View on GitHub
# Split Closed Roads

## Description
Detects closed-loop lanelets and splits each into two open segments (`_A` and `_B`). RoadRunner cannot render self-closed roads. This is a Lanelet2-specific wrapper around the closed-loop split in [splitClosedGeometry.md](../authoring/splitClosedGeometry.md).

## Inputs
| Parameter | Type | Description |
|-----------|------|-------------|
| `lanelets` | struct array | Extracted lanelet structs |
| `ll2` | struct | Parsed OSM struct from `readOSM` |
| `geom` | containers.Map | wayID -> Nx3 geometry |
| `topo` | struct array | Topology structs parallel to lanelets |

## Outputs
- `lanelets` — updated array with split lanelets replacing originals
- `geom` — updated map with `_A`/`_B` suffixed geometry keys
- `topo` — updated topology with circular `A -> B -> A` wiring

## Algorithm (3 passes)

### Pass 1: Identify closed lanelets
Check each lanelet's center way: if `splitClosedGeometry` detects it as closed, OR the OSM way has first==last node ref, mark it for splitting.

### Pass 2: Split each closed lanelet
For each closed lanelet:
1. Split all 3 ways (center, left, right) at midpoint using `splitAtMidpoint`
2. Store as `wayID_A` and `wayID_B` in geom map
3. Create two lanelets: `id_A` and `id_B` with same subtype/speed/participants
4. Wire topology: A's predecessor = B, A's successor = B (circular)
5. B ends at A's start point for proper alignment at loop closure

### Pass 3: Update dangling references
For non-split lanelets that reference split lanelets:
- predecessor X -> X_B (end of X feeds into start)
- successor X -> X_A (start of X receives from end)
- neighbor X -> X_A

### Splitting at cross-section (not index midpoint)
**Critical:** Split boundaries at the **perpendicular cross-section through the center split point**, NOT at each boundary's own 50% arc length. Inner/outer boundaries have different curvatures, so same arc fraction ≠ same physical cross-section. Wrong cross-sections cause RoadRunner longitudinal alignment warnings.

```matlab
% 1. Split center at 50% arc length → get splitPt and tangent
% 2. For each boundary, find where the perpendicular plane intersects:
tangent2D = centerTangent(1:2) / norm(centerTangent(1:2));
projections = (bndPts(:,1:2) - centerSplitPt(1:2)) * tangent2D';
% Find zero-crossing (sign change) near the boundary midpoint
segIdx = find(diff(sign(projections)) ~= 0 & idx >= midIdx, 1);
% Interpolate exact crossing point
t = -projections(segIdx) / (projections(segIdx+1) - projections(segIdx));
bndSplitPt = bndPts(segIdx,:) + t * (bndPts(segIdx+1,:) - bndPts(segIdx,:));
```

### Both junctions need alignment
Apply the same perpendicular projection at BOTH split joints:
- **Midpoint junction** (A→B): project center midpoint tangent onto boundaries
- **Closure junction** (B→A): project center start tangent onto boundaries

Without closure alignment, boundary start/end points have longitudinal offsets (validated: ±0.14m on TestTrack).

## Example
```matlab
% "Closed roads split: 2 lanelet(s) -> 4 segments"
```

----

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