SuperElevationNode

Create a RoadRunner authoring API object, rrAPi, that references the object for the current RoadRunner instance rrApp. The rrApi object enables you to programmatically author scenes, such as by adding and modifying road and lane components, using MATLAB^®.

rrApi = roadrunnerAPI(rrApp);

Extract the object for your scene from the Scene property of the authoring API object rrApi. The extracted Scene object enables you to specify the scene in which to add scene components, such as roads and lanes.

scn = rrApi.Scene;

Extract the object for your RoadRunner project from the Project property of the authoring API object rrApi. The extracted Project object enables you to specify the project folder for the current RoadRunner session from which to retrieve asset objects. You can use the asset objects to add lane markings to the lanes in your scene.

prj = rrApi.Project;

Use the addClothoidFitRoad function to add a new road. Specify the position of the road by specifying the positions of its start point startPt and end point endPt.

startPt = [0 0 0];
endPt = [50 0 0];
rrRoad = addClothoidFitRoad(scn,[startPt; endPt]);

Extract the reference lane from the ReferenceLane property of the road rrRoad. The extracted property ReferenceLane defines the center line of the road.

refLane = rrRoad.ReferenceLane;

Use the extracted refLane object to add lanes on either side of the reference lane of the road using the addLaneToLeft and addLaneToRight functions.

leftLane = addLaneToLeft(refLane);
rightLane = addLaneToRight(refLane);

Use the getAsset function to retrieve the LaneMarkingStyle objects for a dashed solid yellow lane marking. These objects define the lane marking assets used to mark the spans in the lane marking profile of the reference lane.

dashedWhiteMarkingStyle = prj.getAsset("<PROJECT>/Assets/Markings/DashedSingleWhite.rrlms","LaneMarkingStyle");
solidWhiteMarkingStyle = prj.getAsset("<PROJECT>/Assets/Markings/SolidSingleWhite.rrlms","LaneMarkingStyle");

Mark the boundaries of the lanes.

leftLaneSpan = leftLane.LaneMarkingProfile.Spans(1);
leftLaneSpan.LaneMarkingStyle = solidWhiteMarkingStyle;
rightLaneSpan = rightLane.LaneMarkingProfile.Spans(1);
rightLaneSpan.LaneMarkingStyle = solidWhiteMarkingStyle;
referenceLaneSpan = refLane.LaneMarkingProfile.Spans(1);
referenceLaneSpan.LaneMarkingStyle = dashedWhiteMarkingStyle;

Access the superelevation definition of the road by extracting its SuperElevationCurve property.

seCurve = rrRoad.SuperElevationCurve;

Inspect the default superelevation nodes of the road. By default, the SuperElevationCurve contains two nodes: one at the start of the road and one at the end of the road.

nodes = seCurve.Nodes

Apply Uniform Banking Along the Entire Road

Set the same banking angle at the start and end nodes to apply uniform banking along the full road length.

nodes(1).Angle = 10;
nodes(end).Angle = 10;

Define Non-Uniform Banking Using Start and End Nodes

Assign different banking angles at the start and end of the road to create a continuous banking transition.

nodes(1).Angle = 15;
nodes(end).Angle = -15;

You can also use the addSuperElevation function to define different banking angles at the start and end of the road.

addSuperElevation(rrRoad,0,15)   % 0 indicates the start position of the road
addSuperElevation(rrRoad,50,-15) % 50 indicates the end position of the road

Insert an Intermediate Superelevation Node

Insert a new superelevation control point at a specified distance along the road.

midNode = insertNode(seCurve,25);
midNode.Angle = -10;

Insert another superelevation node between the start node and your new midpoint node.

addSuperElevation(rrRoad,12,-10);

Modify Existing Superelevation Node

Update the banking angle of an existing node without inserting a new one.

midNode.Angle = 20;