importScenario

Import file into RoadRunner Scenario using MATLAB

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. You can import only CSV trajectory files.

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

csvTrajectoryImportOptions object

Import options configuration, specified as a csvTrajectoryImportOptions object. To use 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 with the actorImportOptions object.

Version History

Introduced in R2022a

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.