Main Content

Get Started with the Virtual Vehicle Composer

The Virtual Vehicle Composer app 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 enter your vehicle parameter data, build a virtual 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 architecture and entering parameter data.

Open the Virtual Vehicle Composer App

To open the app, do either of the following:

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

  • MATLAB command prompt: Enter virtualVehicleComposer.

Virtual Vehicle Composer Workflow

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

For this example, follow the workflow steps to build a four-wheeled electric vehicle (EV), operate it in a FTP–75 drive cycle, and analyze the results.

Step

Button

Description

1

Setup Virtual Vehicle

Virtual Vehicle setup icon

Setup

Specify:

  • Project path and Configuration name

  • Vehicle class

  • Powertrain architecture

  • Model template

  • Vehicle dynamics

Click Configure

2

Configure Virtual Vehicle Data

Virtual Vehicle data icon

Data and Calibration

Specify the chassis, tire, brake type, powertrain, driver, and environment. For each selection, enter the parameter data describing it.

3

Configure Virtual Vehicle Scenario and Test

Virtual Vehicle scenario icon

Scenario and Test

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

4

Configure Virtual Vehicle Data Logging

Virtual Vehicle data logging icon

Logging

Select the model signal data to log while testing your virtual vehicle. Options include energy-related quantities, vehicle position, velocity, acceleration, and many others.

You can also set the default signals for further tests.

5

Build Virtual Vehicle

Virtual Vehicle build icon

Virtual Vehicle

Build your virtual vehicle. When you build, the Virtual Vehicle Composer creates a Simulink® model that contains the vehicle and powertrain architectures and parameters you specified, and associates it with the test plan.

6

Operate Virtual Vehicle

Virtual Vehicle operate icon

Run Test Plan

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

Note

To operate the model, use the Run Test Plan button in the Operate section on the Composer tab.

7

Analyze Virtual Vehicle

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