importScenario

R2026b

Import file into RoadRunner Scenario

Since R2022a

Syntax

importScenario(rrApp,filename,formatname)

importScenario(rrApp,filename,formatname,importoptions)

Description

importScenario(rrApp,filename,formatname) imports an ASAM OpenSCENARIO^® file or a CSV file trajectory into the currently open scenario.

importScenario(rrApp,filename,formatname,importoptions) sets options for import using importoptions.The import options configuration is specified as one of the import options objects compatible with the file specified in the filename argument.

Input Arguments

rrApp — RoadRunner application

roadrunner object

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.

filename — Path of file to import

character vector | string scalar

Path of the file to import, specified as a character vector or string scalar. filename is the absolute or relative path to the file to be imported. If you specify a relative path, then you must specify a path to a file in the Assets folder of the current project.

Example: importScenario(rrApp,"C:\RR\MyProject\Assets\FourWaySignal.xosc","OpenSCENARIO XML"), imports the file FourWaySignal.xosc from the Assets folder of the current project.

Data Types: char | string

formatname — Import format name

"OpenSCENARIO XML" | "CSV Trajectory"

Import format name, specified as "OpenSCENARIO XML" or "CSV Trajectory". Format name options are case-insensitive.

• "OpenSCENARIO XML" — Import an ASAM OpenSCENARIO XML file

• "CSV Trajectory" — Import a vehicle trajectory from a CSV file

Example: importScenario(rrApp,"C:\RR\MyProject\Assets\FourWaySignal.xosc","OpenSCENARIO XML"), specifies that the file to be imported, FourWaySignal.xosc, is in the ASAM OpenSCENARIO XML format.

Data Types: char | string

importoptions — Import options configuration

openScenarioXMLImportOptions object | csvTrajectoryImportOptions object

Import options configuration, specified as an openScenarioXMLImportOptions or csvTrajectoryImportOptions object.

• openScenarioXMLImportOptions object — Options to import an ASAM OpenSCENARIO XML file. To use this object for this argument, you must specify formatname as "OpenSCENARIO XML" and specify an ASAM OpenSCENARIO XML file with the .xosc extension to the filename argument.

• csvTrajectoryImportOptions object — Options to import a vehicle trajectory from a CSV file. To use this object for this argument, you must specify formatname as "CSV Trajectory" and specify a CSV file to the filename argument. When specifying options for importing CSV files with csvTrajectoryImportOptions, you can also modify the attributes of any actors imported with the trajectory by using the actorImportOptions object.

Version History

Introduced in R2022a

R2026b: Import scenarios from ASAM OpenSCENARIO XML files

You can now import scenario data, including actors, routes, and scenario logic, from ASAM OpenSCENARIO XML files. You can also configure import settings when importing an ASAM OpenSCENARIO XML file using the openScenarioXMLImportOptions object. In previous releases, RoadRunner Scenario supports importing only trajectory data from ASAM OpenSCENARIO XML files.

R2025a: ASAM OpenSCENARIO standards renamed

ASAM has updated the names of the ASAM OpenSCENARIO standards. ASAM OpenSCENARIO 1.x is now referred to as ASAM OpenSCENARIO XML. Consequently, the format name "OpenSCENARIO" has been renamed "OpenSCENARIO XML" to align with this new naming convention.

Support for the old name will be removed in a future release. If your code uses this format name, consider modifying it to use the new name. The functionality of the format name remains the same.