Main Content

Get Started with Virtual Vehicle Composer

The Virtual Vehicle Composer enables you to quickly configure and build a virtual vehicle that you can use for system-level performance testing and analysis, including component sizing, fuel economy, battery state of charge, drive cycle tracking, vehicle handling maneuvers, software integration testing, and hardware-in-the-loop (HIL) testing. Use the app to configure your virtual vehicle architecture, define and parameterize its components, build the vehicle model, run test scenarios, and analyze the results.

The virtual vehicle model uses sets of blocks and reference application subsystems in Powertrain Blockset™, Vehicle Dynamics Blockset™, and Simscape™ add-ons. Virtual Vehicle Composer simplifies the task of configuring the vehicle and test plan.

Open the Virtual Vehicle Composer App

To open the app, perform one of these actions:

  • MATLAB® Toolstrip: On the Apps tab, under Automotive, click the Virtual Vehicle Composer icon Virtual Vehicle Composer icon.

  • MATLAB Command Window: Enter virtualVehicleComposer.

Build a Vehicle with Virtual Vehicle Composer

To configure, build, operate, and analyze your virtual vehicle, use the Composer tab. To get started with this example workflow, click New "New" button to start new virtual vehicle..

Follow these steps to build a battery-electric vehicle (EV), operate it in a FTP–75 drive cycle, and analyze the results.





Configure Virtual Vehicle Setup

Virtual Vehicle Setup icon



  • Vehicle class

  • Model template

  • Powertrain architecture

  • Vehicle dynamics

  • Project path and Configuration name

  • Custom component catalog

Click Confirm Setup.


Configure Virtual Vehicle Components

Virtual Vehicle Data and Calibration icon

Data and Calibration

Specify the chassis, tire, brake type, powertrain, driver, and operating environment. Set parameters for each selection.


Configure Virtual Vehicle Scenario and Test

Virtual Vehicle Scenario and Test icon

Scenario and Test

Construct a test plan including one or more test scenarios. Options include drive cycles for fuel economy and energy management and vehicle handling maneuvers.


Configure Virtual Vehicle Signal Logging

Virtual Vehicle Logging icon


Select the model signal data to log while testing your virtual vehicle, such as energy-related quantities, and vehicle position, velocity, and acceleration.

You can also set the default signals for further testing.


Build Virtual Vehicle

Virtual Vehicle Build icon

Virtual Vehicle

Build your virtual vehicle. When you build, the Virtual Vehicle Composer creates a Simulink® or Simscape model with the vehicle and powertrain architectures and parameters you specify and associates the model with the test plan.


Operate Virtual Vehicle

Virtual Vehicle Operate icon

Run Test Plan

Simulate your model according to your test plan and log the output data.


To run the full test plan, on the Composer tab, in the Operate section, click Run Test Plan.


Analyze Virtual Vehicle Test Results

Virtual Vehicle Analyze icon

Simulation Data Inspector

Use the Simulation Data Inspector to view and inspect the data signals that you logged.

You can store your data for further processing.

See Also

Related Topics