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/snapEndpoints.md
View on GitHub# Snap Connected Endpoints
Snaps lane and boundary geometry endpoints for connected lanes (predecessor/successor pairs) to eliminate small gaps that cause visual artifacts in RoadRunner.
## Algorithm
For each lane with successors:
1. Check if the 2D gap between predecessor end and successor start is within threshold (default 1.0m)
2. If within threshold, snap successor start point to predecessor end point (XY only, preserve Z)
3. Also snap corresponding boundary endpoints, respecting alignment direction
## Inline Implementation (Script Context)
Since this runs in `mcp__matlab__evaluate_matlab_code` (script context, no `function` blocks), inline the logic directly:
```matlab
% Build ID->index maps for lanes and boundaries
laneIdx = containers.Map('KeyType','char','ValueType','double');
for i = 1:numel(lanes), laneIdx(char(string(lanes(i).ID))) = i; end
bndIdx = containers.Map('KeyType','char','ValueType','double');
for i = 1:numel(laneBoundaries), bndIdx(char(string(laneBoundaries(i).ID))) = i; end
% Determine boundary alignment per lane via dot product
nLanes = numel(lanes);
leftFwd = true(nLanes,1);
rightFwd = true(nLanes,1);
for i = 1:nLanes
lDir = lanes(i).Geometry(end,:) - lanes(i).Geometry(1,:);
lbID = char(string(lanes(i).LeftLaneBoundary.Reference.ID));
if bndIdx.isKey(lbID)
bg = laneBoundaries(bndIdx(lbID)).Geometry;
leftFwd(i) = dot(lDir(1:2), bg(end,1:2) - bg(1,1:2)) >= 0;
end
rbID = char(string(lanes(i).RightLaneBoundary.Reference.ID));
if bndIdx.isKey(rbID)
bg = laneBoundaries(bndIdx(rbID)).Geometry;
rightFwd(i) = dot(lDir(1:2), bg(end,1:2) - bg(1,1:2)) >= 0;
end
end
% Snap: successor start -> predecessor end (XY only)
SNAP_THRESH = 1.0; % meters
snapCount = 0;
for i = 1:nLanes
if numel(lanes(i).Successors) == 0, continue; end
predEnd = lanes(i).Geometry(end,:);
for k = 1:numel(lanes(i).Successors)
succID = char(string(lanes(i).Successors(k).Reference.ID));
if ~laneIdx.isKey(succID), continue; end
j = laneIdx(succID);
gap = norm(predEnd(1:2) - lanes(j).Geometry(1,1:2));
if gap > SNAP_THRESH || gap < 1e-6, continue; end
% Snap lane center
lanes(j).Geometry(1,1:2) = predEnd(1:2);
% Snap left boundary
predLB = char(string(lanes(i).LeftLaneBoundary.Reference.ID));
succLB = char(string(lanes(j).LeftLaneBoundary.Reference.ID));
if bndIdx.isKey(predLB) && bndIdx.isKey(succLB)
if leftFwd(i), srcPt = laneBoundaries(bndIdx(predLB)).Geometry(end,1:2);
else, srcPt = laneBoundaries(bndIdx(predLB)).Geometry(1,1:2); end
if leftFwd(j), laneBoundaries(bndIdx(succLB)).Geometry(1,1:2) = srcPt;
else, laneBoundaries(bndIdx(succLB)).Geometry(end,1:2) = srcPt; end
end
% Snap right boundary
predRB = char(string(lanes(i).RightLaneBoundary.Reference.ID));
succRB = char(string(lanes(j).RightLaneBoundary.Reference.ID));
if bndIdx.isKey(predRB) && bndIdx.isKey(succRB)
if rightFwd(i), srcPt = laneBoundaries(bndIdx(predRB)).Geometry(end,1:2);
else, srcPt = laneBoundaries(bndIdx(predRB)).Geometry(1,1:2); end
if rightFwd(j), laneBoundaries(bndIdx(succRB)).Geometry(1,1:2) = srcPt;
else, laneBoundaries(bndIdx(succRB)).Geometry(end,1:2) = srcPt; end
end
snapCount = snapCount + 1;
end
end
fprintf('Endpoint snapping: %d connections snapped (threshold=%.1fm)\n', snapCount, SNAP_THRESH);
```
## Key Details
- **XY only** — Z is preserved (handled separately by height conflict resolution)
- **Alignment-aware** — Forward boundaries: use end point as source/start as target. Backward: reversed.
- **Threshold** — Default 1.0m. Gaps larger than this are intentional (junction gaps).
- **Skip tiny gaps** — < 1e-6m means already snapped, no action needed.
- **Overall direction** — Use `Geometry(end,:) - Geometry(1,:)` for dot product, never segment-local direction.
----
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 |