Product and Configuration Dependencies for Virtual Vehicle Composer

R2026b

The Virtual Vehicle Composer automatically creates a virtual vehicle model based on the vehicle class and vehicle components you choose. The resulting model runs in Simulink^®.

To meet the requirements for your project, you must configure the correct virtual vehicle for your planned tests. The Virtual Vehicle Composer requires either a Powertrain Blockset™ or Vehicle Dynamics Blockset™ license, but the types of models you can construct - and the types of tests you can run - depend on which licenses you have.

These general guidelines apply:

• Powertrain Blockset enables a broad range of powertrain architectures and power generation detail. You can run acceleration and braking performance tests, and energy-related tests, such as those for fuel economy, battery state of charge, and emissions. Powertrain Blockset enables straight-line longitudinal vehicle motion.

• Vehicle Dynamics Blockset enables more detailed modeling of vehicle motion that includes longitudinal, lateral, and vertical motions. You can simulate vehicle tests such as lane changes or increasing steer maneuvers. Vehicle Dynamics Blockset provides fewer powertrain options than Powertrain Blockset.

• If you have both Powertrain Blockset and Vehicle Dynamics Blockset, you can combine the options for both.

• The Vehicle class parameter options have these requirements:

  • Passenger vehicle — Requires either a Powertrain Blockset or Vehicle Dynamics Blockset license. A Simscape™ license provides additional component options.

  • Motorcycle — Requires licenses for Vehicle Dynamics Blockset, Simscape, and Simscape Multibody™.

Installed licenses have the greatest effect on these Setup pane choices:

• Vehicle class

• Model template

• Powertrain architecture

• Vehicle dynamics

• Custom component catalog

Setting Model template to Simulink incorporates Simulink physical components. Setting Model template to Simscape incorporates Simscape physical components.

Note

Simulating a virtual vehicle model requires a supported compiler. For a list, see Supported and Compatible Compilers.

Vehicle Class

This table shows the base license requirements for each Vehicle class.

Vehicle Class Option	Required Licenses
Passenger Vehicle	Vehicle Dynamics Blockset or Powertrain Blockset If you have Simscape and these Simscape add-ons, you can set Model template to Simscape to configure vehicles with Simscape subsystems: Simscape Driveline™ Simscape Electrical™ Simscape Multibody
Motorcycle	Vehicle Dynamics Blockset Simscape Simscape Multibody

In addition, the selections you make when configuring your virtual vehicle determine which tests you can run. For example, to run a lane change test when you set Vehicle class to Passenger vehicle, you must set Vehicle dynamics to Combined longitudinal and lateral dynamics.

Passenger Vehicle License Requirements and Dependencies

This table shows the Powertrain architecture options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Powertrain Architecture Option	Powertrain Blockset	Vehicle Dynamics Blockset
Conventional Vehicle	✔	✔
Electric Vehicle 1EM	✔	✔
Electric Vehicle 2EM	✔
Electric Vehicle 3EM Dual Front	✔
Electric Vehicle 3EM Dual Rear	✔
Electric Vehicle 4EM	✔
Hybrid Electric Vehicle P0	✔
Hybrid Electric Vehicle P1	✔
Hybrid Electric Vehicle P2	✔
Hybrid Electric Vehicle P3	✔
Hybrid Electric Vehicle P4	✔
Hybrid Electric Vehicle MM	✔
Hybrid Electric Vehicle IPS	✔

Note

If you set Model template to Simscape, all electric vehicle (EV) and hybrid electric vehicle (HEV) powertrain architectures require Simscape Electrical.

This table shows the Vehicle dynamics options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Vehicle Dynamics Option	Powertrain Blockset	Vehicle Dynamics Blockset
Longitudinal dynamics	✔	✔
Combined longitudinal and lateral dynamics		✔

Note

If you set Model template to Simscape, and Vehicle Dynamics is set to Combined longitudinal and lateral dynamics, the vehicle requires Simscape Multibody.

This table shows the license requirements for Model template options when you set Vehicle class to Passenger vehicle.

Model Template Option	Required Licenses
Simulink	Vehicle Dynamics Blockset or Powertrain Blockset
Simscape	Vehicle Dynamics Blockset or Powertrain Blockset Simscape, Simscape Driveline, and these Simscape add-ons: Simscape Electrical — Required for electric vehicle (EV) and hybrid electric vehicle (HEV) powertrain configurations Simscape Multibody — Required for lateral and longitudinal vehicle dynamics configurations

You can use a Custom component catalog to access Simulink custom components you have stored.

Custom component catalog availability depends on the Model template chosen. It is only available when you set Model template to Simulink. You cannot use a Custom component catalog when you set Model template to Simscape.

You can model the motion of the body and frame of the vehicle using several methods. This table shows the Body and Frame options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Body and Frame Option	Powertrain Blockset	Vehicle Dynamics Blockset
Vehicle Body 1DOF Longitudinal	✔	✔
Vehicle Body 3DOF Longitudinal	✔	✔
Vehicle Body 6DOF Longitudinal and Lateral		✔

This table shows the Front Tire and Wheel options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Front Tire and Wheel Option	Powertrain Blockset	Vehicle Dynamics Blockset
MF Tires Longitudinal Front	✔	✔
Combined Slip Tires Longitudinal Front		✔
MF Tires Longitudinal and Lateral Front		✔
Fiala Tires Longitudinal and Lateral Front		✔
Simscape MF Tires Front Requires Simscape.		✔

This table shows the Rear Tire and Wheel options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Rear Tire and Wheel Option	Powertrain Blockset	Vehicle Dynamics Blockset
MF Tires Longitudinal Rear	✔	✔
Combined Slip Tires Longitudinal Rear		✔
MF Tires Longitudinal and Lateral Rear		✔
Fiala Tires Longitudinal and Lateral Rear		✔
Simscape MF Tires Rear Requires Simscape.		✔

This table shows the Engine options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Engine Option	Powertrain Blockset	Vehicle Dynamics Blockset
SI Mapped Engine	✔	✔
SI Simple Engine	✔	✔
SI Engine	✔
SI Deep Learning Engine	✔
SI H2 Engine	✔
SI H2 Mapped Engine	✔
SI H2 Simple Engine	✔
SI H2 Deep Learning Engine	✔
CI Mapped Engine	✔
CI Simple Engine	✔
CI Engine	✔
FMU Engine	✔	✔

This table shows the Energy Storage options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Energy Storage Option	Powertrain Blockset	Vehicle Dynamics Blockset
Mapped Battery (Electric Vehicle 1EM)	✔	✔
Mapped Battery (Electric Vehicle 2EM)	✔
Mapped Battery (Electric Vehicle 3EM Dual Front)	✔
Mapped Battery (Electric Vehicle 3EM Dual Rear)	✔
Mapped Battery (Electric Vehicle 4EM)	✔
Mapped Battery (Hybrid Electric Vehicle P0)	✔
Mapped Battery (Hybrid Electric Vehicle P1)	✔
Mapped Battery (Hybrid Electric Vehicle P2)	✔
Mapped Battery (Hybrid Electric Vehicle P3)	✔
Mapped Battery (Hybrid Electric Vehicle P4)	✔
Mapped Battery (Hybrid Electric Vehicle MM)	✔
Mapped Battery (Hybrid Electric Vehicle IPS)	✔
Ideal Voltage Source	✔	✔
Detailed Battery	✔

The default options for Energy Storage further depend on the Powertrain architecture chosen.

This table shows the Electric Machine options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Electric Machine Option	Powertrain Blockset	Vehicle Dynamics Blockset
Electric Vehicle 1EM - Mapped Motor	✔	✔
Electric Vehicle 2EM - Mapped Motor	✔
Electric Vehicle 3EM Dual Front - Mapped Motor	✔
Electric Vehicle 3EM Dual Rear - Mapped Motor	✔
Electric Vehicle 4EM - Mapped Motor	✔
Hybrid Electric Vehicle P0 - Mapped Motor	✔
Hybrid Electric Vehicle P1 - Mapped Motor	✔
Hybrid Electric Vehicle P2 - Mapped Motor	✔
Hybrid Electric Vehicle P3 - Mapped Motor	✔
Hybrid Electric Vehicle P4 - Mapped Motor	✔
Hybrid Electric Vehicle MM - Mapped Motor	✔
Hybrid Electric Vehicle IPS - Mapped Motor	✔
Electric Vehicle 1EM - Simple Motor	✔	✔
Electric Vehicle 2EM - Simple Motor	✔
Electric Vehicle 3EM Dual Front - Simple Motor	✔
Electric Vehicle 3EM Dual Rear - Simple Motor	✔
Electric Vehicle 4EM - Simple Motor	✔
Hybrid Electric Vehicle P0 - Simple Motor	✔
Hybrid Electric Vehicle P1 - Simple Motor	✔
Hybrid Electric Vehicle P2 - Simple Motor	✔
Hybrid Electric Vehicle P3 - Simple Motor	✔
Hybrid Electric Vehicle P4 - Simple Motor	✔
Hybrid Electric Vehicle MM - Simple Motor	✔
Hybrid Electric Vehicle IPS - Simple Motor	✔

The default options for Electric Machine further depend on the Powertrain architecture chosen.

This table shows the Drivetrain options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Drivetrain Option	Powertrain Blockset	Vehicle Dynamics Blockset
Front Wheel Drive	✔	✔
Rear Wheel Drive	✔	✔
All Wheel Drive	✔	✔
All Wheel Driven by 2EM	✔
All Wheel Driven by 3EM Front	✔
All Wheel Driven by 3EM Rear	✔
All Wheel Driven by 4EM	✔

The default options for Drivetrain further depend on the Powertrain architecture chosen.

This table shows the Transmission options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Transmission Option	Powertrain Blockset	Vehicle Dynamics Blockset
Ideal Fixed Gear Transmission	✔	✔
Automatic Transmission with Torque Converter	✔
Automated Manual Transmission	✔

The default options for Transmission further depend on the Powertrain architecture chosen.

This table shows the Front Differential System Option options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Front Differential System Option	Powertrain Blockset	Vehicle Dynamics Blockset
Open Differential	✔	✔
Limited Slip Differential	✔	✔
Dual EM Drive Front	✔

The default options for Front Differential System further depend on the Powertrain architecture chosen.

This table shows the Rear Differential System options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Rear Differential System Option	Powertrain Blockset	Vehicle Dynamics Blockset
Open Differential Rear	✔	✔
Active Differential Rear	✔	✔
Limited Slip Differential Rear	✔	✔
Dual EM Drive Rear	✔

This table shows the Driver options for a Passenger vehicle enabled by Powertrain Blockset and Vehicle Dynamics Blockset licenses.

Driver Option	Powertrain Blockset	Vehicle Dynamics Blockset
Longitudinal Driver	✔	✔
Predictive Driver		✔
Predictive Stanley Driver		✔

This table shows component and scenario options that require additional licenses.

Component or Scenario	Setting	Required Licenses
Thermal System	Constant Temperature	Stateflow®
	Managed Thermal System	Stateflow and Simscape Fluids™
3D Scene Selection	3D Scene	Vehicle Dynamics Blockset and Simulink 3D Animation™

Motorcycle License Requirements and Dependencies

The Motorcycle option for Vehicle class requires these Vehicle Dynamics Blockset and Simscape licenses and add-ons. A Powertrain Blockset license does not change any options.

• Vehicle Dynamics Blockset

• Simscape

• Simscape Multibody

The only Model template option for a Motorcycle is Simscape.

Because you must set Model template to Simscape when you set Vehicle class to Motorcycle, you cannot use a Custom component catalog to store or retrieve customized vehicle components.