importScene

R2026b

Import scene into RoadRunner

Since R2022a

collapse all in page

    Syntax

    importScene(rrApp,filename,formatname)
    importScene(rrApp,filename,formatname,importoptions)

    Description

    importScene(rrApp,filename,formatname) imports data from a file specified by filename into the currently open scene. The specified file must be in a format RoadRunner supports.

    importScene(rrApp,filename,formatname,importoptions) sets options for import using the importoptions argument.

    example

    Examples

    collapse all

    This example uses:

    Open Live Script

    Open a project in RoadRunner using the roadrunner function by specifying the location in which to create a project. This example assumes that RoadRunner is installed in its default location in Windows.

    Specify the path to an existing project. For example, this code shows the path to a project located on C:\RR\MyProject. The function returns a roadrunner object, rrApp, that provides functions for performing basic workflow tasks such as opening, closing, and saving scenes and projects.

    projectFolder = "C:\RR\MyProject";
rrApp = roadrunner(projectFolder);

    Open a new scene in the current project. The newScene function opens a blank scene in the currently open project.

    newScene(rrApp);

    Set import options by creating an openDriveImportOptions object that disables the import of signals and objects from the file.

    options = openDriveImportOptions(ImportSignals=false,ImportObjects=false);

    Specify the path to an ASAM OpenDRIVE file. Then, use the importScene function to import data from the specified ASAM OpenDRIVE file into the blank open scene.

    filename = "C:\RR\MyProject\Exports\FourWaySignal.xodr";
formatname = "OpenDRIVE";
importScene(rrApp,filename,formatname,options);

    Input Arguments

    collapse all

    RoadRunner application associated with a project, specified as a roadrunner object. This object provides functions for performing common workflow tasks such as opening, closing, and saving scenes and projects. rrApp provides functions that support importing data from files and exporting scenes to other formats from RoadRunner.

    Path of the file to import into RoadRunner, specified as a character vector or string scalar. This argument specifies the absolute or relative file path of the file to import. If you specify a relative path, then the path is relative to the Assets folder of the current project.

    Note

    When you import HERE HD Map, TomTom HD Map, or Zenrin Japan Map data into RoadRunner, the filename argument must be an empty character vector or string scalar.

    Example: importScene(rrApp,"C:\RR\MyProject\Exports\FourWaySignal.xodr","OpenDRIVE",options), where "C:\RR\MyProject\Exports\FourWaySignal.xodr" represents the absolute file path of the file to import.

    Example: importScene(rrApp,"sample.osm","OpenStreetMap",options) represents the OpenStreetMap file in the Assets folder of the current project.

    Data Types: char | string

    Import format name, specified as a character vector or string scalar. This value must correspond to a valid import format supported by RoadRunner. Format name options are case-insensitive. RoadRunner supports these options:

    • "OpenDRIVE" — Import ASAM OpenDRIVE® data.

    • "RoadRunner HD Map" — Import RoadRunner HD Map data.

    • "HERE HD Map" — Import HERE HD Map data. For this option, the filename argument must be an empty character vector or string scalar. (since R2024a)

    • "TomTom HD Map" — Import TomTom HD Map data. For this option, the filename argument must be an empty character vector or string scalar. (since R2024b)

    • "OpenStreetMap" — Import OpenStreetMap data. (since R2026b)

    • "Zenrin Japan Map" — Import ZENRIN Japan Map API 3.0 (Itsumo NAVI API 3.0) data. For this option, the filename argument must be an empty character vector or string scalar. Before importing, you must configure the world settings of your scene using the changeWorldSettings function and set up Zenrin credentials using the zenrinCredentials (Automated Driving Toolbox) function in the RoadRunner application. (since R2026b)

    Example: importScene(rrApp,"FourWaySignal.xodr","OpenDRIVE",options), "OpenDRIVE" specifies that the imported file FourWaySignal.xodr is in the ASAM OpenDRIVE format.

    Example: importScene(rrApp,"tokyo_map.osm","OpenStreetMap",options), "OpenStreetMap" specifies that the imported file tokyo_map.osm is in the OpenStreetMap format.

    Data Types: char | string

    Import options configuration, specified as one of the import options objects compatible with the format specified in the formatname argument. Supported objects are:

    • openDRIVEImportOptions

    • roadrunnerHDMapImportOptions

    • hereHDMapImportOptions (since R2024a)

    • tomtomHDMapImportOptions (since R2024b)

    • openStreetMapImportOptions (since R2026b)

    • zenrinJapanMapImportOptions (since R2026b)

    Import FormatDescription Properties
    openDriveImportOptions

    Options for importing ASAM OpenDRIVE files into RoadRunner scene.

    openDriveImportOptions(Name=Value) creates an import options configuration object for the ASAM OpenDRIVE format, with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    ImportObjects

    Map all <object> entries in the imported file to props or markings, specified as a logical 1 (true) or 0 (false).

    Default: 0

    ImportHeadingOffsetRelativeToOrientation

    Import the <hOffset> (heading offset) values of <signal> entries as being relative to <orientation>, which is the direction of travel of the road that the signal applies to. By default, the heading offset is relative to the heading of the road, regardless of the direction of travel, specified as a logical 1 (true) or 0 (false).

    Default: auto

    SmoothFitRoadGeometryOptions (since R2024a)

    Smooth fit road geometry options, specified as a smoothFitRoadGeometryOptions object.

    LaneOptions

    Lane import options specified as a laneImportOptions object.

    Offset

    Offset of the imported ASAM OpenDRIVE scene, relative to the center of the RoadRunner scene, specified as a three-element vector of form [x y z]. Values are in meters.

    Projection

    Projection of the imported ASAM OpenDRIVE scene, specified as a projectionImportOptions. If the file does not have projection information, then RoadRunner uses the projection of the scene. If both the scene and the file do not have projection information, then RoadRunner uses the Transverse Mercator projection centered at 0 degrees latitude and longitude.

    ImportSignals

    Map all <signal> entries in the imported file to signals or signs, specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    ProjectionMode

    Projection mode, specified as: "Unspecified", "FullProjection", "TranslateOnly", "NoProjection".

    ImportRegion (since R2024a)

    Area of the road network to be imported from an ASAM OpenDRIVE file, specified as a 2-by-2 matrix [xMin yMin; xMax yMax]. The first row, xMin and yMin, represents the position of the lower-left corner of a 2D axis-aligned box. The second row, xMax and yMax, represents the position of the upper-right corner of the box.

    Default: "auto"

    Example: options = openDriveImportOptions(ImportSignals=true);

    laneImportOptions

    laneImportOptions(Name=Value) creates an options configuration object, with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    ConvertShoulderToCurb

    Specify this property as logical 1 (true) to import lanes with "curb" markings and type "shoulder" as type "curb" if this option is enabled. Otherwise, the function imports these lanes as type "shoulder", specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    ConvertLaneHeights

    Map all <height> entries to imported lanes, specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    MedianLaneType

    Map all <lane> types as "median" or "raised median", specified as: "Unspecified", "Median", "RaisedMedian".

    Default: "auto"

    Example:

    options = laneImportOptions(MedianLaneType="RaisedMedian"); creates a lane import options object that maps all lanes as a raised median lane type.

    projectionImportOptions

    projectionImportOptions(Name=Value) creates an options configuration object for a map projection with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    Projection

    Geospatial projection and datum used to represent spatial coordinates in the map. This property supports valid WKT (including ESRI WKT) or PROJ.4 projection strings. Specified as a string scalar or character vector.

    Default: "auto"

    Example:

    options = projectionImportOptions(Projection="utm +zone=11 +datum=WGS84 + units=m +no_defs +ellps=WGS84 +towgs84=0,0,"); creates projection a projection import options object that uses a PROJ.4 projection string.

    roadrunnerHDMapImportOptions

    Options for importing RoadRunner HD Map files into RoadRunner scene.

    roadrunnerHDMapImportOptions(Name=Value) creates an import options configuration object for the RoadRunner HD Map format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    ImportStep

    Import step, specified as one of the following strings: "Unspecified or "Load".

    Default: "auto"

    LoadOptions

    Load options, specified as roadrunnerHDMapLoadOptions.

    Default: "auto"

    BuildOptions

    Build options, specified as roadrunnerHDMapBuildOptions.

    Default: "auto"

    Example:

    options = roadrunnerHDMapImportOptions(ImportStep="Load"); creates a RoadRunner HD map import options that loads the map.

    roadrunnerHDMapLoadOptions

    Options for loading RoadRunner HD Map files into RoadRunner scene.

    roadrunnerHDMapLoadOptions(Name=Value) creates an options configuration object for loading the RoadRunner HD Map format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    Offset

    Offset of the imported HD map, relative to the center of the RoadRunner scene, specified as a 3-element vector.

    Projection

    Projection of the imported HD map scene, specified as a projectionImportOptions. If the projection is not set, then RoadRunner uses the file's projection. If the file does not have projection information, then RoadRunner uses the projection of the scene. If both the scene and the file do not have projection information, then RoadRunner uses the Transverse Mercator projection centered at 0 degrees latitude and longitude.

    Example:

    options = roadrunnerHDMapLoadOptions(Offset=[0 10 0]); creates a RoadRunner HD map load options with the specified offset.

    roadrunnerHDMapBuildOptions

    Options for building RoadRunner HD Map files into RoadRunner scene.

    roadrunnerHDMapBuildOptions(Name=Value) creates an options configuration object for building the RoadRunner HD Map format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    FitCrossSections

    Fit cross sections, specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    DetectAsphaltSurfaces

    Detect asphalt surfaces, specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    ClearSceneOfExistingData

    Clear the scene of existing data , specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    CurvatureBlend

    Position of fit arcs used from transition from line to arc, specified as a scalar double value.

    Default: "auto"

    AutoDetectBridgesOptions

    Options to auto detect bridges, specified as a autoDetectBridgesOptions.

    Default: "auto"

    UseLaneGroups (since R2024a)

    Flag to use lane groups, specified as a logical 1 (true) or 0 (false).

    When you use lane groups, RoadRunner builds a distinct road by combining only those lanes that are part of the same lane group.

    Set this property to false to ignore the lane group data, which enables RoadRunner to combine more lanes together to build a road. RoadRunner combines all the lanes, between junctions, into a single road. This enables you to build a smaller number of longer roads than you can build by using lane groups.

    Default: "auto"

    CombineTransitionLanes (since R2025a)

    Flag to combine transition lanes, specified as a logical 1 (true) or 0 (false).

    Transition lanes are multiple lanes derived from a single road, used to guide vehicle movement from one lane to another in response to changes in road conditions.

    Set this property to true to combine the transition lanes in the imported HD map to build a single road, and to reduce the creation of overlapping roads and the number of junctions in the built scene.

    Set this property to false to retain the connectivity information among adjacent transition lanes in the built scene.

    Default: "auto"

    Example:

    options = roadrunnerHDMapBuildOptions(DetectAsphaltSurfaces=true); creates a RoadRunner HD map build options that detects asphalt surfaces.

    autoDetectBridgesOptions

    Options for auto detecting bridges.

    autoDetectBridgesOptions(Name=Value) creates an options configuration object for auto detecting bridges when building the RoadRunner HD Map. Properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    BridgeSpanInflation

    Length of the bridge span specified as a scalar double value.

    Default: "auto"

    IsEnabled (since R2026a)

    Specifies whether to auto detect bridges, specified as a logical 1 (true) or 0 (false).

    By default, RoadRunner creates bridges at road intersections when the intersecting roads have different elevations. To prevent RoadRunner from creating bridges, set this property to false. Otherwise, set this property to true.

    Default: 1 (true)

    Example:

    options = autoDetectBridgesOptions(BridgeSpanInflation=35); creates options that set bridge span inflation.

    enableOverlapGroupsOptions

    Options for enabling overlap group settings.

    enableOverlapGroupsOptions(Name=Value) creates an options configuration object for enabling overlap group settings when building the RoadRunner HD Map. Properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    IsEnabled

    Specifies whether the overlap groups should be enabled. It is specified as a logical 1 (true) or 0 (false).

    By default, RoadRunner does not create automatic junctions at road overlaps. To create junctions, it uses explicit junction information specified in the imported HD map data. To create automatic junctions at geometric overlaps, set this field to 0 (false). For more information on overlap groups, see Prevent Creation of Automatic Junctions Between Roads.

    Default: 0 (false)

    GroupName

    Name of the overlap group. You can use the GroupName parameter to control the behavior of automatic junction creation when you build an HD map data over an existing scene. For example, if roads in the existing scene have an GroupName parameter value of TransferImport, and you do not want to create automatic junctions at geometric overlaps between them and roads specified by HD map data, you must set the GroupName parameter to TransferImport. Otherwise RoadRunner creates automatic junctions at geometric overlaps between the roads of the existing scene and the roads specified by the imported HD map data.

    Default: SceneBuild

    PreserveJunctionLanes (since R2026a)

    Flag to preserve junction lanes, specified as a logical 1 (true) or 0 (false).

    Set this property to true to preserve all junction lanes present in the imported map. Otherwise, set this property to false. When you set this property to true, RoadRunner does not consider road overlaps in the map, and instead builds the RoadRunner scene while using the junction definitions from the imported map. RoadRunner builds junctions in the scene that retain the original junction lanes from the imported map, which prevents RoadRunner from creating multiple broken junctions in the built scene.

    Default: "auto"

    PreserveJunctionShape (since R2026a)

    Flag to preserve the shapes of junctions, specified as a logical 1 (true) or 0 (false).

    Set this property to true to preserve the shapes of junctions present in the imported map. Otherwise, set this field to false. When you set this field to true, RoadRunner builds the scene while using the junction polygon definitions from the imported map to preserve the original junction geometry in the built scene. If a junction definition does not include polygons, RoadRunner does not preserve the junction shape. Additionally, if a junction polygon definition is complex and unrealistic, or if a junction polygon extends beyond junction lanes, RoadRunner might not preserve the exact junction shape.

    Default: "auto"

    Example:

    options = enableOverlapGroupsOptions(Enable=1); creates options that enables overlap groups.

    smoothFitRoadGeometryOptions (since R2024a)

    Options for smoothly fitting road geometry.

    smoothFitRoadGeometryOptions(Name=Value) creates an options configuration object with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    Tolerance

    Tolerance for fit, specified as a double.

    Default: "auto"

    MaxDepth

    Maximum depth, specified as an integer.

    Default: "auto"

    Example:

    options = smoothFitRoadGeometryOptions(Tolerance=0.5); creates options for smoothly fitting road geometry.

    hereHDMapImportOptions (since R2024a)

    Options for importing HERE HD Map data into RoadRunner scene.

    hereHDMapImportOptions creates options configuration object with default properties for importing HERE HD Map data.

    hereHDMapImportOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.
    LoadOptions

    Load options, specified as a hereHDMapLoadOptions object.

    Default: "auto"

    BuildOptions

    Build options, specified as a roadrunnerHDMapBuildOptions object.

    Default: "auto"

    hereHDMapLoadOptions (since R2024a)

    Options for loading HERE HD Map data into RoadRunner scene.

    hereHDMapLoadOptions creates an options configuration object with default properties for loading HERE HD Map data.

    hereHDMapLoadOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    ProtoFilesOptions

    Options to load HERE HD Map data from protobuf files, specified as a hereProtoFilesOptions object.

    Default: "auto"

    AssetMappingRegion

    Region-specific asset mapping configuration, specified as "Unspecified", "NorthAmerica", or "WesternEurope".

    Default: "auto"

    RouteImportOptions

    Options for importing routes from GPS trace files, specified as a routeImportOptions object. Specifying this property enables route-based import instead of region-based import. When specified, RoadRunner imports HERE HD Map data along the route defined in the CSV or KML file associated with the routeImportOptions object.

    Default: "auto"

    Example:

    loadOpts = hereHDMapLoadOptions(RouteImportOptions=routeOpts,AssetMappingRegion="NorthAmerica"); creates load options for route-based import with North America asset mapping.

    hereProtoFilesOptions (since R2024a)

    Options for importing data from HERE HD Map protobuf files into RoadRunner scene.

    hereProtoFilesOptions creates an options configuration object with default properties for importing HERE HD Map data from protobuf files.

    hereProtoFilesOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    RootFolder

    Absolute path to the root folder containing HERE HD Map protobuf files, specified as a character vector or string scalar.

    Default: "auto"

    UncompressUsingGZIP

    Extract contents of a GNU ZIP file containing HERE HD Map protobuf files, specified as a logical 1 (true) or 0 (false).

    Default: "auto"

    Example:

    options = hereProtoFilesOptions(UncompressUsingGZIP=true); extracts the contents of a GNU ZIP file containing HERE protobuf files.

    routeImportOptions (since R2026b)

    Options for importing routes from GPS trace files (CSV or KML) for HERE HD Map.

    routeImportOptions creates an options configuration object with default properties for importing routes.

    routeImportOptions(Name=Value) sets one or more properties using name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    FilePath

    Absolute path to the CSV or KML file containing route data as GPS trace waypoints, specified as a character vector or string scalar.

    Default: "auto"

    ObjectInclusionDistance

    Distance, in meters, up to which to include objects such as signs, barriers, and poles, around the route, specified as a numeric scalar of type double or string scalar.

    Default: "auto"

    Example:

    routeOpts = routeImportOptions(FilePath="C:\Routes\Eisenhower Expy.csv", ObjectInclusionDistance=50); creates route import options that specify a 50-meter object inclusion distance.

    tomtomHDMapImportOptions (since R2024b)

    Options for importing TomTom HD Map data into RoadRunner scene.

    tomtomHDMapImportOptions creates options configuration object with default properties for importing TomTom HD Map data.

    tomtomHDMapImportOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.
    LoadOptions

    Load options, specified as a tomtomHDMapLoadOptions object.

    Default: "auto"

    BuildOptions

    Build options, specified as a roadrunnerHDMapBuildOptions object.

    Default: "auto"

    tomtomHDMapLoadOptions (since R2024b)

    Options for loading TomTom HD Map data into RoadRunner scene.

    tomtomHDMapLoadOptions creates an options configuration object with default properties for loading TomTom HD Map data.

    tomtomHDMapLoadOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.
    DataFilesOptions

    Options to load TomTom HD Map data from data files, specified as a tomtomHDMapFilesOptions object.

    Default: "auto"

    tomtomHDMapFilesOptions (since R2024b)

    Options for importing TomTom HD Map files into RoadRunner scene.

    tomtomHDMapFilesOptions creates an options configuration object with default properties for importing TomTom HD Map files.

    tomtomHDMapFilesOptions(Name=Value) sets properties using one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    DataFormat

    Data format, specified as: "Unspecified", "Avro", "GeoPackage".

    Default: "auto"

    RootFolder

    Absolute path to the root folder containing TomTom HD Map files, specified as a character vector or string scalar.

    Default: "auto"

    Example:

    options = tomtomHdMapFilesOptions(DataFormat="Avro");

    openStreetMapImportOptions (since R2026b)

    Options for importing OpenStreetMap files into RoadRunner scene.

    openStreetMapImportOptions creates an import options configuration object with default properties for the OpenStreetMap format.

    openStreetMapImportOptions(Name=Value) creates an import options configuration object for the OpenStreetMap format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    BuildOptions

    Build options for constructing the scene from OpenStreetMap data, specified as an sdMapBuildOptions object.

    Default: "auto"

    Example:

    buildOpts = sdMapBuildOptions(DrivingSide="Right",CreateTurnLanes=true);

    options = openStreetMapImportOptions(BuildOptions=buildOpts); creates OpenStreetMap import options with custom build settings.

    zenrinJapanMapImportOptions (since R2026b)

    Options for importing ZENRIN Japan Map data into RoadRunner scene.

    zenrinJapanMapImportOptions creates an import options configuration object with default properties for the ZENRIN Japan Map format.

    zenrinJapanMapImportOptions(Name=Value) creates an import options configuration object for the ZENRIN Japan Map format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    Note

    Before importing ZENRIN Japan Map data, you must:

    • Configure world settings using changeWorldSettings to set the latitude, longitude, and scene extents.

    • Set up ZENRIN credentials once in the RoadRunner application.

    BuildOptions

    Build options for constructing the scene from ZENRIN Japan Map data, specified as an sdMapBuildOptions object.

    Default: "auto"

    Example:

    buildOpts = sdMapBuildOptions(DrivingSide="Left",ElevateRoadsByLayer=true,PreserveHeights=true);

    options = zenrinJapanMapImportOptions(BuildOptions=buildOpts); creates ZENRIN Japan Map import options with custom build settings.

    sdMapBuildOptions (since R2026b)

    Options for building SD map files into RoadRunner scene.

    sdMapBuildOptions creates a build options configuration object with default properties.

    sdMapBuildOptions(Name=Value) creates an options configuration object for building the SD map format with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    PreserveHeights

    Preserve road heights when elevating bridges, specified as a logical 1 (true) or 0 (false). This option is applicable only when ElevateRoadsByLayer is true and the imported file contains layer ID information. To get better build results of elevated bridges, set PreserveHeights to true and set the AutoDetectBridgesOptions property.

    Default: "auto"

    ClearSceneOfExistingData

    Clear the scene of existing road data before import, specified as a logical 1 (true) or 0 (false). Set this property to true to clear already built roads from the scene. To keep the existing roads in the scene, set this property to false.

    Default: "auto"

    DrivingSide

    Driving side of the imported scene, specified as one of these values: "Unspecified", "Left", "Right".

    By default, RoadRunner considers the left side of the road as the forward direction of driving. To consider the right side of the road as the forward direction of driving, set this property to "Right".

    Default: "auto"

    ElevateRoadsByLayer

    Elevate bridges using layer information, specified as a logical 1(true) or 0(false). If the SD map file does not contain road elevation information, the imported files might contain overlapping roads. To elevate bridges using layer information, set ElevateRoadsByLayer to true.

    Dependencies

    • To use this property, you must have a RoadRunner Scene Builder license.

    • To use this property with OpenStreetMap import, the data must contain layer information.

    Default: "auto"

    CreateTurnLanes

    Create turn lane markings using turn lane information, specified as a logical 1 (true) or 0 (false). Turn lane indicates the forward or backward direction of the road in a bi-directional way. To include turn lane markings using turn lane information, set CreateTurnLanes to true.

    Dependencies

    • To use this property, you must have a RoadRunner Scene Builder license.

    • To use this property with OpenStreetMap import, the data must contain layer information.

    Default: "auto"

    AutoDetectBridgesOptions

    Options for automatic detection of bridges when roads have different elevations at intersections, specified as an autoDetectBridgesOptions object.

    Default: "auto"

    EnableOverlapGroupsOptions

    Options for enabling overlap groups, specified as an sdEnableOverlapGroupsOptions object.

    Default: "auto"

    Example:

    options = sdMapBuildOptions(DrivingSide="Right",CreateTurnLanes=true,ClearSceneOfExistingData=true); creates SD map build options for right-hand traffic with turn lanes and scene clearing enabled.

    sdEnableOverlapGroupsOptions (since R2026b)

    Options for enabling overlap groups when building scene for OpenStreetMap or ZENRIN Japan Map data.

    sdEnableOverlapGroupsOptions creates an options configuration object for enabling overlap groups with default properties.

    sdEnableOverlapGroupsOptions(Name=Value) creates an options configuration object for enabling overlap groups with properties specified as one or more name-value arguments.

    If a default property value is "auto", the RoadRunner application determines what value to use and sets the property to that value.

    IsEnabled

    Enable junction creation using geometric overlaps, specified as a logical 1(true) or 0(false). By default, the SD map build enforces junction location information to create junctions. To create junctions using geometric overlaps instead, set IsEnabled to true.

    Default: "auto"

    GroupName

    Name of the overlap group, specified as a string scalar or character vector.

    Default: "auto"

    Example:

    overlapOpts = sdEnableOverlapGroupsOptions(IsEnabled=true,GroupName="CustomOverlapGroup");

    buildOpts = sdMapBuildOptions(EnableOverlapGroupsOptions=overlapOpts); creates build options with a custom overlap group configuration.

    Version History

    Introduced in R2022a

    expand all

    See Also

    | | |

    Topics