Main Content

Setup Virtual Vehicle

Use the Virtual Vehicle Composer app to configure your virtual vehicle. First, specify the project and model name, powertrain architecture, model template, and vehicle dynamics.

In the Virtual Vehicle Composer app, on the Composer tab, click New. The app opens a default virtual vehicle template and creates virtual vehicle project files.

Virtual Vehicle Composer app configuration setup tab

For this example, configure an electric vehicle (EV) that uses a Simulink® model template with longitudinal vehicle dynamics. Set:

  1. Project name to VVProj.

  2. Project folder to C:\Users\<user_name>\MATLAB\Projects\examples.

  3. Model name to ConfiguredVirtualVehicleModel.

  4. Powertrain Architecture to Electric Vehicle 1EM.

  5. Model template to Simulink .

  6. Vehicle dynamics to Longitudinal vehicle dynamics.

Click Create.

After completing this step, see Configure Virtual Vehicle Data.

More About

Powertrain Architecture

Use the Powertrain Architecture parameter to specify the powertrain architecture. By default, the parameter is set to Conventional Vehicle. The conventional vehicle architecture has a spark-ignition (SI) or compression-ignition (CI) internal combustion engine, transmission, chassis, and associated powertrain control algorithms. You can also select Electric Vehicle 1EM to specify an electric vehicle (EV) powertrain architecture.

If you have Powertrain Blockset™, you can specify model architectures for hybrid electric vehicles (HEVs).

The HEV and EV model architectures include an internal combustion engine, chassis, transmission, battery, motor, generator, and associated powertrain control algorithms.

Model Template

Use the Model template parameter to specify a Simulink or Simscape vehicle plant and powertrain architecture. By default, the virtual vehicle uses a Simulink model template. If you have Simscape™ Driveline™, you can configure the vehicle plant and powertrain architecture with Simscape subsystems that model a conventional vehicle.

If you have Simscape Driveline and Simscape Electrical™, you can configure the vehicle plant and powertrain architecture with Simscape subsystems that model EVs and HEVs.

Vehicle Dynamics

Use the Vehicle Dynamics parameter to configure the virtual vehicle dynamics.

  • Longitudinal vehicle dynamics icon Longitudinal vehicle dynamics — Suitable for fuel economy and energy management analysis.

  • Longitudinal vehicle dynamics icon Combined longitudinal and lateral vehicle dynamics — If you have Vehicle Dynamics Blockset™, you can specify dynamics suitable for vehicle handling, stability, and ride comfort analysis.


The virtual vehicle uses the Z-up coordinate system as defined in SAE J670 and ISO 8855.

See Also

Related Topics