matlab/matlab-agentic-toolkit / skills-catalog/automotive/roadrunner-build-rrhd-map
roadrunner-build-rrhd-map
VerifiedBuild, 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.
references/lanelet2/readOSM.md
View on GitHub# Parse OSM
## Description
Parses a Lanelet2 `.osm` file into a structured MATLAB representation. Extracts all nodes (with lat, lon, ele, local_x, local_y), ways (with node references and tags), and relations (with members and tags).
## Inputs
| Parameter | Type | Description |
|-----------|------|-------------|
| `osmFile` | string | Path to a Lanelet2 `.osm` file |
## Output
`ll2` — struct with:
| Field | Type | Description |
|-------|------|-------------|
| `.nodes` | containers.Map | nodeID -> struct(lat, lon, ele, local_x, local_y) |
| `.ways` | containers.Map | wayID -> struct(nodeRefs, tags) |
| `.relations` | containers.Map | relID -> struct(members, tags) |
| `.sourceFile` | string | Input file path |
## Validated Implementation Pattern
Use `xmlread` (Java DOM parser) — works for files up to ~10MB:
```matlab
doc = xmlread(osmFile);
% Nodes
nodeElems = doc.getElementsByTagName('node');
nodes = containers.Map('KeyType','char','ValueType','any');
for i = 0:nodeElems.getLength()-1
elem = nodeElems.item(i);
nid = char(elem.getAttribute('id'));
s.lat = str2double(elem.getAttribute('lat'));
s.lon = str2double(elem.getAttribute('lon'));
s.ele = 0; s.local_x = NaN; s.local_y = NaN;
tags = elem.getElementsByTagName('tag');
for t = 0:tags.getLength()-1
tag = tags.item(t);
k = char(tag.getAttribute('k'));
v = str2double(tag.getAttribute('v'));
switch k
case 'ele', s.ele = v;
case 'local_x', s.local_x = v;
case 'local_y', s.local_y = v;
end
end
nodes(nid) = s;
end
% Ways — nodeRefs as string array, tags as containers.Map
wayElems = doc.getElementsByTagName('way');
ways = containers.Map('KeyType','char','ValueType','any');
for i = 0:wayElems.getLength()-1
elem = wayElems.item(i);
wid = char(elem.getAttribute('id'));
nds = elem.getElementsByTagName('nd');
nodeRefs = strings(1, nds.getLength());
for n = 0:nds.getLength()-1
nodeRefs(n+1) = string(nds.item(n).getAttribute('ref'));
end
s.nodeRefs = nodeRefs;
s.tags = containers.Map('KeyType','char','ValueType','char');
tags = elem.getElementsByTagName('tag');
for t = 0:tags.getLength()-1
tag = tags.item(t);
s.tags(char(tag.getAttribute('k'))) = char(tag.getAttribute('v'));
end
ways(wid) = s;
end
% Relations — members as struct array, tags as containers.Map
relElems = doc.getElementsByTagName('relation');
relations = containers.Map('KeyType','char','ValueType','any');
for i = 0:relElems.getLength()-1
elem = relElems.item(i);
rid = char(elem.getAttribute('id'));
members = elem.getElementsByTagName('member');
s.members = struct('type',{},'ref',{},'role',{});
for m = 0:members.getLength()-1
mem = members.item(m);
s.members(end+1).type = string(mem.getAttribute('type'));
s.members(end).ref = string(mem.getAttribute('ref'));
s.members(end).role = string(mem.getAttribute('role'));
end
s.tags = containers.Map('KeyType','char','ValueType','char');
tags = elem.getElementsByTagName('tag');
for t = 0:tags.getLength()-1
tag = tags.item(t);
s.tags(char(tag.getAttribute('k'))) = char(tag.getAttribute('v'));
end
relations(rid) = s;
end
```
### Typical OSM Structure
```xml
<node id="3" lat="0.00068" lon="0.000099">
<tag k="ele" v="0.1524"/>
<tag k="local_x" v="11.0482"/>
<tag k="local_y" v="75.259"/>
</node>
<way id="2">
<nd ref="3"/><nd ref="4"/>...
<tag k="type" v="line_thin"/>
<tag k="subtype" v="solid"/>
</way>
<relation id="1">
<member type="way" ref="2" role="center"/>
<member type="way" ref="33" role="left"/>
<member type="way" ref="64" role="right"/>
<tag k="type" v="lanelet"/>
<tag k="subtype" v="road"/>
<tag k="one_way" v="yes"/>
</relation>
```
## Example
```matlab
fprintf("Nodes: %d, Ways: %d, Relations: %d\n", nodes.Count, ways.Count, relations.Count);
```
----
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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |