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

View on GitHub
# Enforcement Gate

Run this validation block BEFORE calling `write(rrMap, outputFile)`. It catches the three most common conversion errors. Do NOT skip or simplify it.

## Alignment Check (informational)

```matlab
lanes = rrMap.Lanes;
nFwd = 0; nBwd = 0;
for i = 1:numel(lanes)
    if lanes(i).LeftLaneBoundary.Alignment == "Forward", nFwd = nFwd+1;
    else, nBwd = nBwd+1; end
    if lanes(i).RightLaneBoundary.Alignment == "Forward", nFwd = nFwd+1;
    else, nBwd = nBwd+1; end
end
fprintf('Alignment check: %d Forward, %d Backward\n', nFwd, nBwd);
% NOTE: All-Forward IS valid for oval/circular tracks where boundaries run same direction.
% The spatial check below is the authoritative correctness test.
```

## Left Boundary Spatial Check (multi-sample)

Uses LOCAL tangent at multiple sample points — NOT overall direction. Overall direction fails on highly curved lanes (split half-ovals, U-turns).

```matlab
bnds = rrMap.LaneBoundaries;
bndMap = containers.Map;
for i = 1:numel(bnds), bndMap(bnds(i).ID) = bnds(i).Geometry; end
nBadSide = 0;
for i = 1:numel(lanes)
    lGeom = lanes(i).Geometry;
    if size(lGeom,1) < 3, continue; end
    nSamples = min(5, size(lGeom,1)-1);
    sampleIdx = round(linspace(2, size(lGeom,1)-1, nSamples));
    leftBndID = lanes(i).LeftLaneBoundary.Reference.ID;
    if ~bndMap.isKey(leftBndID), continue; end
    leftBndGeom = bndMap(leftBndID);
    badCount = 0;
    for si = 1:numel(sampleIdx)
        idx = sampleIdx(si);
        localTan = lGeom(min(idx+1,size(lGeom,1)),1:2) - lGeom(max(idx-1,1),1:2);
        if norm(localTan) < 1e-6, continue; end
        localTan = localTan / norm(localTan);
        localLeftN = [-localTan(2), localTan(1)];
        distsL = vecnorm(leftBndGeom(:,1:2) - lGeom(idx,1:2), 2, 2);
        [~, closestL] = min(distsL);
        toBnd = leftBndGeom(closestL,1:2) - lGeom(idx,1:2);
        if dot(toBnd, localLeftN) < 0, badCount = badCount + 1; end
    end
    if badCount > numel(sampleIdx)/2, nBadSide = nBadSide + 1; end
end
assert(nBadSide == 0, ...
    'SPATIAL ERROR: %d lanes have left boundary on the RIGHT side — fix alignment algorithm.', nBadSide);
fprintf('Spatial left-side check (multi-sample): PASS\n');
```

## Asset Extension Check

Verify no `.rrcws` used for non-crosswalk CurveMarkingTypes (stop lines and bike markings use `.rrlms`).

```matlab
cmTypes = rrMap.CurveMarkingTypes;
for i = 1:numel(cmTypes)
    ap = string(cmTypes(i).AssetPath.AssetPath);
    id = string(cmTypes(i).ID);
    if contains(id, "Stop", IgnoreCase=true) || contains(id, "Bike", IgnoreCase=true) || contains(id, "Zig", IgnoreCase=true)
        assert(~endsWith(ap, ".rrcws"), ...
            sprintf('ASSET ERROR: %s uses .rrcws but should use .rrlms', id));
    end
end
fprintf('Asset extension check: PASS\n');
```

## Completeness Check

```matlab
assert(numel(rrMap.CurveMarkings) > 0 || (numel(stopLineWays)==0 && numel(pedestrianMarkingWays)==0 && numel(crosswalkLanelets)==0), ...
    'INCOMPLETE: CurveMarkings not built');
assert(numel(rrMap.Barriers) > 0 || (numel(fenceWays)==0 && numel(guardRailWays)==0), ...
    'INCOMPLETE: Barriers not built');
assert(numel(rrMap.Signs) > 0 || (numel(trafficSignWays)==0 && numel(trafficSignRels)==0), ...
    'INCOMPLETE: Signs not built');
assert(all(rrMap.GeoReference ~= 0), 'GeoReference not set');
fprintf('Completeness check: PASS\n');
```

----

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