Main Content

copyExampleSim3dProject

Copy support package files and plugins to specified folder

Syntax

sim3d.utils.copyExampleSim3dProject(DestFldr)
sim3d.utils.copyExampleSim3dProject(DestFldr,Name=Value)

Description

sim3d.utils.copyExampleSim3dProject(DestFldr) copies the support package files to the destination folder, DestFldr.

sim3d.utils.copyExampleSim3dProject(DestFldr,Name=Value) copies support package files to the destination with additional options specified by name-value arguments.

Running the sim3d.utils.copyExampleSim3dProject function configures your environment so that you can customize scenes. The destination folder contains these Automated Driving Toolbox™ Interface for Unreal Engine® 4 Projects support package components.

  • An Unreal® project, defined in AutoVrtlEnv.uproject, and its associated files. The project includes editable versions of the prebuilt 3D scenes that you can select from the Scene description parameter of the Simulation 3D Scene Configuration block.

  • Three plugins, MathWorkSimulation: RoadRunnerMaterials, and MathWorksAutomotiveContent. These plugins establish the connection between MATLAB® and the Unreal Editor and are required for co-simulation.

  • A RoadRunner scene project defined in RRscene.uproject file, along with a WindowsPackage folder that contains supporting files and the executable RRscene.exe. This project contains the editable version of the scene and the executable with supporting files to co-simulate the Highway Lane Following with RoadRunner Scene example.

Input Arguments

expand all

Destination folder name, specified as a character vector.

Note

You must have write permission for the destination folder.

Data Types: char | string

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Support package source folder, specified as a character vector. The folder contains the downloaded support packages files.

By default, if you do not specify the source folder, copyExampleSim3dProject copies the file from the support package installation folder, matlabshared.supportpkg.getSupportPackageRoot().

Example: Source="shared\sim3dprojects\spkg\"

Data Types: char | string

Option to enable verbose logging, specified as a logical 0 (false) or 1 (true). Verbose logging displays intermediate iteration information on the MATLAB command line.

Example: VerboseOutput=true

Data Types: logical

Examples

expand all

Copy the support package files to C:\project.

sim3d.utils.copyExampleSim3dProject("C:\project");

Copy the support package files to C:\project with VerboseOutput set to true.

sim3d.utils.copyExampleSim3dProject("C:\project", VerboseOutput=true)
Copying ...\spkg\project\AutoVrtlEnv to C:\project\AutoVrtlEnv
Creating C:\project\AutoVrtlEnv\Plugins
Copying ...\spkg\plugins\mw_aerospace\MathWorksAerospace to C:\project\AutoVrtlEnv\Plugins\MathWorksAerospace
Copying ...\spkg\plugins\mw_automotive\MathWorksAutomotiveContent to C:\project\AutoVrtlEnv\Plugins\MathWorksAutomotiveContent
Copying ...\spkg\plugins\mw_simulation\MathWorksSimulation to C:\project\AutoVrtlEnv\Plugins\MathWorksSimulation
Copying ...\spkg\plugins\mw_uav\MathWorksUAVContent to C:\project\AutoVrtlEnv\Plugins\MathWorksUAVContent
Copying ...\spkg\plugins\rr_materials\RoadRunnerMaterials to C:\project\AutoVrtlEnv\Plugins\RoadRunnerMaterials
Ensuring C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject is writable
Enabling plugin MathWorksSimulation in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin MathWorksUAVContent in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin MathWorksAutomotiveContent in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject
Enabling plugin RoadRunnerMaterials in C:\project\AutoVrtlEnv\AutoVrtlEnv.uproject

Version History

Introduced in R2022b