Product and Configuration Dependencies for Virtual Vehicle Composer

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 and Simscape, as well as certain Simscape add-ons.

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

Vehicle class
Model template
Powertrain architecture
Vehicle dynamics
Custom component catalog

Note that setting Model template to Simulink incorporates Simulink physical components. Setting Model template to Simscape incorporates Simscape physical components.

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 Simscape provides additional vehicle component choices
`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. A Simscape license does not change Powertrain architecture options.

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`	✔

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`		✔

This table shows the license requirements for Model template options when you set Vehicle class to Passenger vehicle. Setting Model template to Simulink incorporates Simulink physical components. Setting Model template to Simscape incorporates Simscape physical components.

Model Template Option	Required Licenses
`Simulink`	Vehicle Dynamics Blockset or Powertrain Blockset
`Simscape`	Vehicle Dynamics Blockset or Powertrain Blockset Simscape

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`		✔

You can choose from several tire models for your virtual vehicle. 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.		✔

You can choose from several tire models for your virtual vehicle. 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	Required Licenses
`Thermal system`	Stateflow^®
`3D Scene Selection`	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.