Main Content

Install Support Package and Configure Environment

Step 1 of 4 in Customize 3D Scenes for Aerospace Blockset Simulations

To customize scenes in your installation of the Unreal® Editor and simulate within these scenes in Simulink®, you must first install and configure the Aerospace Blockset™ Interface for Unreal Engine® Projects support package.

Note

These installation instructions apply to R2024b. If you are using a previous release, see the documentation for Other Releases.

Verify Software and Hardware Requirements

Before installing the support package, make sure that your environment meets the minimum software and hardware requirements described in Unreal Engine Simulation Environment Requirements and Limitations.

Install Support Package

To install the Aerospace Blockset Interface for Unreal Engine Projects support package, follow these steps:

  1. On the MATLAB® Home tab, in the Environment section, select Add-Ons > Get Add-Ons.

    Get Add-Ons menu choice

  2. In the Add-On Explorer window, search for the Aerospace Blockset Interface for Unreal Engine Projects support package. Click Install.

    Note

    You must have write permission for the installation folder.

Limitations

Simulink Online™ does not support Aerospace Blockset Interface for Unreal Engine Projects.

Configure Environment

The Aerospace Blockset Interface for Unreal Engine Projects support package includes these components.

  • An Unreal project, 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. To use this project, you must copy the file to a folder on your local machine.

  • A plugin, MathWorkInterface (with a folder name of MathWorkSimulation). This plugin establishes the connection between MATLAB and the Unreal Editor and is required for co-simulation. It also includes some shared automotive-oriented assets. You must copy this plugin to your local installation of the editor.

  • A second plugin, MathWorksAerospaceContent. This plugin contains the aerospace components and connects them to MATLAB using the MathWorksSimulation plugin. You must also copy this plugin to your local installation of the editor.

  • A third plugin, RoadRunnerMaterials. This plugin is required for scenes created by the RoadRunner scene editing software, and for packaging the project into an executable.

To configure your environment so that you can customize scenes, use copyExampleSim3dProject to copy the support package components to a folder on your local machine. The project and plugin files are copied to separate locations. For example, this code copies the project files to C:\project. The plugin files are copied to the default location, c:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Marketplace\Mathworks.

sim3d.utils.copyExampleSim3dProject("C:\project");
If you do not install Unreal Engine to the default location, specify the PluginDestination argument.

If you want to use a project developed using a prior release of the Aerospace Blockset Interface for Unreal Engine Projects support package, you must migrate the project to make it compatible with Unreal Editor 5.3. See Migrate Projects Developed Using Prior Support Packages. Otherwise, you can Customize Scenes Using Simulink and Unreal Editor.

Note

If you want to use the plugins to co-simulate with more than one Unreal project, see Unreal Engine 5.3 Plugins.

Configure Environment on Linux Platforms

To configure your environment so that you can customize scenes on Linux® platforms:

  1. Install the Unreal Editor in the root directory with this folder structure: /UnrealEngine/UnrealEngine-5.3/UnrealEngine/Engine/...

  2. Use copyExampleSim3dProject to copy the support package components and specify the PluginDestination as /UnrealEngine/UnrealEngine-5.3/UnrealEngine/Engine/Plugins/Marketplace/Mathworks.

  3. Set the Unreal Editor as the default application for .uproject file.

    For example, navigate to AutoVrtlEnv.uproject.

    • Right-click the AutoVrtlEnv.uproject file, select Open With, and then select Open With Other Application.

      Application selector in Linux

    • Click Browse and select the Unreal Editor application. In the Open With dialog box, select Use as default for this kind of file.

      Browse application in Linux

Install Cesium for Unreal Plugin

Install the Cesium® for Unreal Plugin and enable the MathWorks Geospatial plugin.

Note

The Aerospace Blockset Interface for Unreal Engine Projects supports the Cesium plugin version 2.1.0.

To download this version of the plugin, see https://github.com/CesiumGS/cesium-unreal.

  1. Install the Cesium for Unreal plugin from https://cesium.com/unreal-marketplace/. Follow the directions to download the plugin.

  2. Enable the MathWorks Geospatial plugin in the Unreal Editor. In the Unreal Editor toolbar, select Settings > Plugins.

  3. In the Plugins window, verify that the MathWorks Geospatial plugin is listed in the installed window. If the plugin is not already enabled, select the Enabled check box.

  4. Close the editor.

See Also

|

Related Topics

Customize 3D Scenes for Aerospace Blockset Simulations
Next