Virtual Vehicle Composer
Configure, build, and analyze a virtual automotive vehicle
Open the Virtual Vehicle Composer App
MATLAB® Toolstrip: On the Apps tab, under Automotive, click the app icon.
MATLAB Command Window: Enter
virtualVehicleComposer
.
Parameters
SetupProject name
— Project name
VVProj
(default)
Name of virtual vehicle project, specified as a character vector.
Note
The combined folder and project name must be less than 80 characters.
Data Types: char
Project folder
— Project folder
C:\Users\UserName
\MATLAB\Projects\examples
(default)
UserName
\MATLAB\Projects\examplesProject folder path, specified as a character vector.
Note
The combined folder and project name must be less than 80 characters.
Data Types: char
Model name
— Virtual vehicle model name
ConfiguredVirtualVehicleModel
(default)
Name of virtual vehicle model, specified as a character vector.
Data Types: char
Powertrain architecture
— Hybrid electric, conventional, or electric vehicle
Conventional Vehicle
| Electric Vehicle 1EM
| Hybrid Electric IPS
| Hybrid Electric MM
| Hybrid Electric P0
| Hybrid Electric P1
| Hybrid Electric P2
| Hybrid Electric P3
| Hybrid Electric P4
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Model architecture for a vehicle with a SI or CI internal combustion engine, transmission, and associated powertrain control algorithms. If you have Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. |
| ✔ | ✔ | Model architecture for an electric vehicle (EV) with a motor-generator, battery, direct-drive transmission, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. |
Hybrid Electric IPS | ✔ | Model architecture for a input power split (IPS) hybrid electric vehicle (HEV) with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric MM | ✔ | Model architecture for a multimode HEV with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric P0 | ✔ | Model architecture for a HEV P0 with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric P1 | ✔ | Model architecture for a HEV P1 with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric P2 | ✔ | Model architecture for a HEV P2 with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric P3 | ✔ | Model architecture for a HEV P3 with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. | |
Hybrid Electric P4 | ✔ | Model architecture for a HEV P4 with an internal combustion engine, transmission, battery, motor, generator, and associated powertrain control algorithms. If you have Simscape Electrical and Simscape Driveline, you can configure the vehicle plant and powertrain architecture with Simulink or Simscape model templates. |
Model template
— Vehicle plant and powertrain architecture template
Simulink
(default) | Simscape
Use the 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
— Virtual vehicle longitudinal or lateral vehicle dynamics
Longitudinal vehicle dynamics
(default) | Combined longitudinal and lateral vehicle
dynamics
Use the parameter to configure the virtual vehicle dynamics.
Longitudinal vehicle dynamics
— Suitable for fuel economy and energy management analysis.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. For more information, see Coordinate Systems in Vehicle Dynamics Blockset (Vehicle Dynamics Blockset).
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Model suitable for fuel economy and energy management analysis. |
| ✔ | Model suitable for vehicle handling, stability, and ride comfort analysis. |
Chassis
— Chassis type
Vehicle Body 1DOF Longitudinal
| Vehicle Body 3DOF Longitudinal
| Vehicle Body 6DOF Longitudinal and Lateral
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Chassis model for 1DOF longitudinal vehicle dynamics. Available
when you set Vehicle dynamics to
|
| ✔ | ✔ | Chassis model for 3DOF longitudinal vehicle dynamics. Available
when you set Vehicle dynamics to
|
Vehicle Body 6DOF Longitudinal and
Lateral | ✔ | Chassis model for 3DOF longitudinal vehicle dynamics. Available
when you set Vehicle dynamics to |
Tire
— Virtual vehicle tires
MF Tires Longitudinal
| Fiala Tires Longitudinal and Lateral
| MF Tires Longitudinal and Lateral
| Longitudinal Combined Slip Tire
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Tire model suitable for longitudinal vehicle dynamics studies, including fuel economy and energy management analysis. |
Fiala Tires Longitudinal and Lateral | ✔ | Tire models suitable for lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Implements a simplified tire with lateral and longitudinal slip capability. Uses a translational friction model to calculate the forces and moments during combined longitudinal and lateral slip. If you do not have the tire coefficients needed by the Magic Formula, consider using this setting for studies that do not involve extensive nonlinear combined lateral slip or lateral dynamics. | |
MF Tires Longitudinal and Lateral | ✔ | Tire models suitable for lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Tire model implements the longitudinal and lateral behavior of a wheel characterized by the Magic Formula. You can use Tire Data parameter to specify fitted tire data sets provided by the Global Center for Automotive Performance Simulation (GCAPS) for tires, including:
| |
| ✔ |
Brake Type
— Virtual vehicle brakes
Disc
| Drum
| Mapped
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Brake model converts the brake cylinder pressure into a braking force. |
| ✔ | ✔ | Brake model converts the applied force and brake geometry into a net braking torque. |
Mapped | ✔ | ✔ | Brake model is a function of the wheel speed and applied brake pressure. |
Brake Control Unit
— Brake control
Bang Bang ABS
| Open Loop
| Five-State ABS and TCS
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Anti-lock braking system (ABS) feedback controller that switches between two states to regulate wheel slip. The bang-bang control minimizes the error between the actual slip and the desired slip. For the desired slip, the controller uses the slip value at which the mu-slip curve reaches a peak value. This desired slip value is optimal for minimum braking distance. |
| ✔ | ✔ | Open loop brake control. The controller sets the brake pressure command to a reference brake pressure based on the brake command. |
Five-State ABS and TCS | ✔ | ✔ | Five-state ABS and traction control system (TCS) that uses logic-switching based on wheel deceleration and vehicle acceleration to control the braking pressure at each wheel. Consider using five-state ABS and TCS control to prevent wheel lock-up, decrease braking distance, or maintain yaw stability during the maneuver. The default ABS parameters are set to work on roads that have a constant friction coefficient scaling factor of 0.6. |
Engine
— Virtual vehicle engine
Simple Engine (SI)
| Simple Engine (CI)
| CI Engine
| CI Mapped Engine
| SI Engine
| SI Mapped Engine
| SI DL Engine
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
Simple Engine (SI) | ✔ | ✔ | Simplified SI engine model using a maximum torque verses engine speed table, two scalar fuel mass properties, and one scalar engine efficiency parameter to estimate engine torque and fuel flow. Selecting |
| ✔ | ✔ | Simplified CI engine model using a maximum torque verses engine speed table, two scalar fuel mass properties, and one scalar engine efficiency parameter to estimate engine torque and fuel flow. Selecting |
| ✔ | Compression-ignition (CI) engine from intake to the exhaust port. Selecting | |
| ✔ | ✔ | Mapped CI engine model using power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. Selecting |
| ✔ | Spark-ignition (SI) engine from intake to exhaust port. Selecting | |
| ✔ | ✔ | Mapped SI engine model using power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. Selecting |
| ✔ | Deep learning SI engine. Available if you have the Deep Learning Toolbox™ and Statistics and Machine Learning Toolbox™ licenses. Use this setting to generate a dynamic deep learning SI engine model to use for powertrain control, diagnostic, and estimator algorithm design. Selecting |
Transmission
— Virtual vehicle transmission
Ideal Fixed Gear Transmission
| Automatic Transmission with Torque Converter
| Automated Manual Transmission
| No Transmission
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Idealized fixed-gear transmission without a clutch or synchronization. Use this setting to model the overall gear ratio and power loss when you do not need a detailed transmission model. |
| ✔ | Automatic transmission with a torque converter. | |
| ✔ | Ideal automated transmission (AMT). An AMT is a manual transmission with additional actuators and an electronic control unit (ECU) to regulate clutch and gear selection based on commands from a controller. Specify the number of gears as an integer vector with corresponding gear ratios, inertias, viscous damping, and efficiency factors. The clutch and synchronization engagement rates are linear and adjustable. | |
No Transmission | ✔ | No transmission. |
Dependencies
To enable this parameter, set Powertrain architecture to any of these options:
Conventional Vehicle
Hybrid Electric Vehicle P0
Hybrid Electric Vehicle P1
Hybrid Electric Vehicle P2
Hybrid Electric Vehicle P3
Hybrid Electric Vehicle P4
Transmission Control Unit
— Virtual vehicle transmission control
PRNDL Controller
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Controller that optimizes forward, reverse, neutral, park, and N-speed gear shift scheduling for fuel economy. |
Dependencies
To enable this parameter, set Powertrain architecture to any of these options:
Conventional Vehicle
Hybrid Electric Vehicle P0
Hybrid Electric Vehicle P1
Hybrid Electric Vehicle P2
Hybrid Electric Vehicle P3
Hybrid Electric Vehicle P4
Drivetrain
— Virtual vehicle drivetrain
Front Wheel Drive
| Front Wheel Drive
| All Wheel Drive
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Configure vehicle with front wheel drive. |
Rear Wheel Drive | ✔ | ✔ | Configure vehicle with rear wheel drive. |
All Wheel Drive | ✔ | ✔ | Configure vehicle with all wheel drive. |
Differential System
— Virtual vehicle differential system
Open Differential
| Active Differential
| Limited Slip Differential
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | ✔ | Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify:
|
| ✔ | ✔ | Active differential that accounts for the power transfer from the transmission to the axles. The model implements the active differential as an open differential coupled to either a spur or a planetary differential gear set. |
| ✔ | ✔ | Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify:
|
Electrical System
— Virtual vehicle electric machine and energy storage
Electrical System 1EM Battery
| Electrical System 2EM
| Electrical System 1EM
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Electrical System Settings | Powertrain Blockset | Vehicle Dynamics Blockset | Powertrain Architecture | Description |
---|---|---|---|---|
| ✔ | Electrical System 1EM |
| |
| ✔ | ✔ | Electrical System 1EM |
|
Electrical System 2EM | ✔ |
|
| |
Electrical System 1EM | ✔ |
|
|
Use the Electrical Machine parameters to specify a mapped motor and drive electronics operating in torque-control mode.
Use the Energy Storage parameters to specify a datasheet battery model for a lithium-ion battery.
Vehicle Control Unit
— HEV and EV virtual vehicle control
EV 1EM
| HEVIPS RuleBased
| HEVMM RuleBased
| HEVP0 Optimal
| HEVP1 Optimal
| HEVP2 Optimal
| HEVP3 Optimal
| HEVP4 Optimal
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Powertrain Architecture | Description |
---|---|---|---|---|
EV 1EM | ✔ | ✔ | Electric Vehicle | Controls the motor with torque arbitration and power management. Implements regenerative braking. |
HEVIPS RuleBased | ✔ | Hybrid Electric Vehicle IPS | Controls the motor, generator, and engine through a set of rules and decision logic implemented in Stateflow®. | |
HEVMM RuleBased | ✔ | Hybrid Electric Vehicle MM | ||
| ✔ | Hybrid Electric Vehicle P4 | Implements an equivalent consumption minimization strategy (ECMS) to control the energy management of hybrid electric vehicles (HEVs). The strategy optimizes the torque split between the engine and motor to minimize energy consumption while maintaining the battery state of charge (SOC). | |
| ✔ | Hybrid Electric Vehicle P4 | ||
| ✔ |
| ||
| ✔ |
| ||
HEVP4 Optimal | ✔ |
|
Driver
— Virtual vehicle driver
Longitudinal Driver
| Predictive Driver
If you have Vehicle Dynamics Blockset, you can set Driver to Predictive
Driver
to track longitudinal velocity and a lateral reference
displacement.
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
Longitudinal Driver | ✔ | ✔ | Implements a longitudinal speed-tracking controller. |
| ✔ | Track longitudinal velocity and a lateral reference displacement. Available when you set Vehicle
dynamics to |
Environment
— Virtual vehicle environment
Standard Ambient
The parameter setting Standard Ambient
implements an
ambient environment model.
Steering System
— Steering
Mapped
| Kinematic
| Dynamic
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | Mapped rack-and-pinion steering model. | |
| ✔ | Kinematic model for ideal rack-and-pinion steering. Gears convert the steering rotation into linear motion. | |
| ✔ | Dynamic model for ideal rack-and-pinion steering. Gears convert the steering rotation into linear motion. |
Suspension
— Suspension
Kinematics and Compliance Independent Suspension
| MacPherson Front Suspension Solid Axle Rear
Suspension
These parameters depend on the available products. This table summarizes the parameters available with Powertrain Blockset or Vehicle Dynamics Blockset.
Setting | Powertrain Blockset | Vehicle Dynamics Blockset | Description |
---|---|---|---|
| ✔ | Kinematics and compliance (K & C) test suspension characteristics measured from simulated or actual laboratory suspension tests. | |
| ✔ | Independent MacPherson suspension for multiple axles with multiple tracks per axle. |
Programmatic Use
Version History
Introduced in R2022aSee Also
Topics
- Simulation Data Inspector
- How 3D Simulation for Vehicle Dynamics Blockset Works (Vehicle Dynamics Blockset)