Virtual Vehicle Composer

Configure, build, and analyze a virtual automotive vehicle

Description

The Virtual Vehicle Composer app enables you to configure and build a virtual vehicle that you can use for system-level performance analysis, including component sizing, fuel economy, drive cycle tracking, software integration testing, and hardware-in-the-loop (HIL) testing. Use the app to quickly enter your vehicle parameter data, build a virtual vehicle model, run test scenarios, and analyze the results.

The virtual vehicle model contains the blocks and reference application subsystems available with Powertrain Blockset™, Vehicle Dynamics Blockset™, Simscape™ Driveline™, and Simscape Electrical™. You can use the app to quickly configure the architecture and enter parameter data.

If you have Powertrain Blockset, use the app to:

Analyze design tradeoffs and size components.
Configure hybrid-electric vehicle (HEV) architectures.

If you have Vehicle Dynamics Blockset, use the app to:

Analyze ride-and-handling effects of standard test maneuvers.
Visualize your virtual vehicle in the Unreal Engine^® simulation environment.

If you have Simscape Driveline and Simscape Electrical, use the app to configure the vehicle plant and powertrain architecture with Simscape subsystems.

To build, operate, and analyze your virtual vehicle, use the Composer tab. The options and settings depend on the available products.

Step	Section		Description
1	Configure	Setup	Select New, then specify: Project, folder, and model name Note The combined folder and project name must be less than 80 characters. Powertrain architecture Model template Vehicle dynamics
2		Data and Calibration	Specify the chassis, tire, brake type, powertrain, environment, and driver. For each selection, enter the vehicle parameter data.
3		Scenario and Test	Select the virtual vehicle driving maneuvers and add them to the test plan. Options include drive cycle scenarios for longitudinal studies and standard test maneuvers for vehicle dynamics studies.
4		Logging	Select the model signal data to log when operating your virtual vehicle. Options include vehicle position, velocity, and acceleration.
5	Build	Virtual Vehicle	Build your virtual vehicle. When you build, the Virtual Vehicle Composer creates a Simulink^® model that contains the vehicle architecture and the data that you specify in the configuration.
6	Operate	Run Test Plan	Use the Simulation Manager to operate your model using the test plans that you specify in step 3.
7	Analyze	Simulation Data Inspector	Use the Simulation Data Inspector to view and inspect the simulation signals that you select in step 4.

Required Products

The Virtual Vehicle Composer requires either of these products:

Powertrain Blockset
Vehicle Dynamics Blockset
If you want to run your virtual vehicle in the Unreal Engine 3D simulation environment, see the requirements in Unreal Engine Simulation Environment Requirements and Limitations.

If you have these Simscape products, you can use the app to configure the vehicle plant with Simscape subsystems:

Setup

Use the app to quickly enter your virtual vehicle class, powertrain architecture, model template, and vehicle dynamics.

Parameter Description

Parameter	Description
Powertrain architecture	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	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	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.

Powertrain architecture

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

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

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.

Data and Calibration

Use the app to quickly enter your virtual vehicle parameter data for the vehicle architecture, vehicle dynamics model, chassis, powertrain, and driver. For each selection, enter the parameter data.

Parameter	Description
Chassis	Select the chassis type.
Tire	Select the tire model and tire data. The available parameters depend on the available products, vehicle architecture, and vehicle model.
Brake Type	Select the brake type, including `Disc`, `Drum`, and `Mapped`. Use the Brake Control Unit parameter to specify the brake control.
Powertrain	Select the engine, transmission, drivetrain, differential system, and electrical system parameters for your virtual vehicle. The available parameters depend on the products, vehicle architecture, and vehicle model.
Driver	Select the driver. The parameter setting `Longitudinal Driver` implements a longitudinal speed-tracking controller. If you have Vehicle Dynamics Blockset, you can set Driver to `Predictive Driver` to track longitudinal velocity and a lateral reference displacement.
Environment	The parameter setting `Standard Ambient` implements an ambient environment model.
Steering System	If you have Vehicle Dynamics Blockset and set Vehicle dynamics to `Combined longitudinal and lateral vehicle dynamics`, you can specify the steering system, including `Kinematic Steering`, `Dynamic Steering`, and `Mapped Steering`.
Suspension	If you have Vehicle Dynamics Blockset and set Vehicle dynamics to `Combined longitudinal and lateral vehicle dynamics`, you can specify the suspension system, including `Kinematics and Compliance Independent Suspension` and `MacPherson Front Suspension Solid Axle Rear Suspension`.

Scenario and Test

Select the scenario to use to test your virtual vehicle.

If you set Scenario to Drive Cycle, you can use:

Drive cycles from predefined sources. By default, the block includes the FTP–75 drive cycle. To install additional drive cycles from a support package, see Support Package for Maneuver and Drive Cycle Data. The support package has drive cycles that include the gear shift schedules, for example, JC08 and CUEDC.
Workspace variables that define your own drive cycles.
.mat, .xls, .xlsx, or .txt files.
Wide open throttle (WOT) parameters, including initial and nominal reference speed, deceleration start time, and final reference speed.

If you have Vehicle Dynamics Blockset and set Vehicle dynamics to Combined longitudinal and lateral vehicle dynamics, you can select maneuvers for vehicle handling, stability, and ride analysis. Maneuvers include:

Double Lane Change
Increasing Steer
Constant Radius

If you want to run your virtual vehicle in the Unreal Engine 3D simulation environment, set 3D Simulation to Enable. For hardware requirements, see Unreal Engine Simulation Environment Requirements and Limitations.

Logging

Select the model signal data to log when operating your virtual vehicle. Options include vehicle position, velocity, and acceleration. By default, the app lists frequently used signals.

Virtual Vehicle

Build your virtual vehicle. When you build, the Virtual Vehicle Composer creates a Simulink model that contains the specified vehicle architecture and data.

Test Plan

Simulate your model in the scenario that you specified in Vehicle Scenario and Test.

Simulation Data Inspector

Use the Simulation Data Inspector to view and inspect the simulation signals.

If you run your virtual vehicle through more than one test scenario, the Simulation Data Inspector displays the results from the last simulation. To see results from previous simulations, load the archived results.

Open the Virtual Vehicle Composer App

MATLAB^® Toolstrip: On the Apps tab, under Automotive, click the app icon.
MATLAB Command Window: Enter virtualVehicleComposer.

Examples

Get Started with the Virtual Vehicle Composer

Parameters

Setup

`Project 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)

Project 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
`Conventional Vehicle`	✔	✔	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.
`Electric Vehicle 1EM`	✔	✔	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.

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 vehicle dynamics`	✔	✔	Model suitable for fuel economy and energy management analysis.
`Combined longitudinal and lateral vehicle dynamics`		✔	Model suitable for vehicle handling, stability, and ride comfort analysis.

Data and Calibration

`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
`Vehicle Body 1DOF Longitudinal`	✔	✔	Chassis model for 1DOF longitudinal vehicle dynamics. Available when you set Vehicle dynamics to `Longitudinal vehicle dynamics`.
`Vehicle Body 3DOF Longitudinal`	✔	✔	Chassis model for 3DOF longitudinal vehicle dynamics. Available when you set Vehicle dynamics to `Longitudinal vehicle dynamics`.
`Vehicle Body 6DOF Longitudinal and Lateral`		✔	Chassis model for 3DOF longitudinal vehicle dynamics. Available when you set Vehicle dynamics to `Combined longitudinal and lateral vehicle dynamics`.

`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
`MF Tires Longitudinal`	✔	✔	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: `Light passenger car 205/60R15` `Mid-size passenger car 235/45R18` `Performance car 225/40R19` `SUV 265/50R20` `Light truck 275/65R18` `Commercial truck 295/75R22.5`
`Longitudinal Combined Slip Tire`		✔

`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
`Disc`	✔	✔	Brake model converts the brake cylinder pressure into a braking force.
`Drum`	✔	✔	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
`Bang Bang ABS`	✔	✔	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`	✔	✔	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.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Bang Bang ABS

✔

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

✔

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 `Simple Engine SI` sets the Engine Control Unit parameter to `Simple ECU`.
`Simple Engine (CI)`	✔	✔	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 `Simple Engine CI` sets the Engine Control Unit parameter to `Simple ECU`.
`CI Engine`	✔		Compression-ignition (CI) engine from intake to the exhaust port. Selecting `CI Engine` sets the Engine Control Unit parameter to `CI Engine Controller`.
`CI Mapped Engine`	✔	✔	Mapped CI engine model using power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. Selecting `CI Mapped Engine` sets the Engine Control Unit parameter to `CI Engine Controller`.
`SI Engine`	✔		Spark-ignition (SI) engine from intake to exhaust port. Selecting `SI Engine` sets the Engine Control Unit parameter to `SI Engine Controller`.
`SI Mapped Engine`	✔	✔	Mapped SI engine model using power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. Selecting `SI Mapped Engine` sets the Engine Control Unit parameter to `SI Engine Controller`.
`SI DL Engine`	✔		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 `SI DL Engine` sets the Engine Control Unit parameter to `SI Engine Controller`.

`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
`Ideal Fixed Gear Transmission`	✔	✔	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 Torque Converter`	✔		Automatic transmission with a torque converter.
`Automated Manual Transmission`	✔		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
`PRNDL Controller`	✔	✔	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
`Front Wheel Drive`	✔	✔	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
`Open Differential`	✔	✔	Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify: Carrier-to-driveshaft ratio Crown wheel location Viscous and damping coefficients for the axles and carrier
`Active Differential`	✔	✔	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.
`Limited Slip Differential`	✔	✔	Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify: Carrier-to-driveshaft ratio Crown wheel location Viscous and damping coefficients for the axles and carrier Type of slip coupling

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Open Differential

✔

Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify:

Carrier-to-driveshaft ratio
Crown wheel location
Viscous and damping coefficients for the axles and carrier

Active Differential

✔

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.

Limited Slip Differential

✔

Differential as a planetary bevel gear train. The block matches the driveshaft bevel gear to the crown (ring) bevel gear. You can specify:

Carrier-to-driveshaft ratio
Crown wheel location
Viscous and damping coefficients for the axles and carrier
Type of slip coupling

`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 Battery`	✔		`Electrical System 1EM`	Mapped motor and drive electronics operating in torque-control mode. Lithium ion battery model based on discharge characteristics taken at different temperatures.
`Electrical System 1EM Battery` with Energy Storage set to `Ideal Voltage Source`	✔	✔	`Electrical System 1EM`	Mapped motor and drive electronics operating in torque-control mode. Ideal voltage source battery model.
`Electrical System 2EM`	✔		`Hybrid Electric Vehicle IPS` `Hybrid Electric Vehicle MM`	Two mapped motors and drive electronics operating in torque-control mode. Lithium ion battery model based off of discharge characteristics taken at different temperatures.
`Electrical System 1EM`	✔		`Hybrid Electric Vehicle P0` `Hybrid Electric Vehicle P1` `Hybrid Electric Vehicle P2` `Hybrid Electric Vehicle P3` `Hybrid Electric Vehicle P4`	Two mapped motors and drive electronics operating in torque-control mode. Lithium ion battery model with DC-DC conversion.

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`
`HEVP0 Optimal`	✔		`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).
`HEVP1 Optimal`	✔		`Hybrid Electric Vehicle P4`
`HEVP2 Optimal`	✔		`Hybrid Electric Vehicle P4`
`HEVP3 Optimal`	✔		`Hybrid Electric Vehicle P4`
`HEVP4 Optimal`	✔		`Hybrid Electric Vehicle P4`

`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.
`Predictive Driver`		✔	Track longitudinal velocity and a lateral reference displacement. Available when you set Vehicle dynamics to `Combined longitudinal and lateral vehicle dynamics`.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Longitudinal Driver

✔

Implements a longitudinal speed-tracking controller.

Predictive Driver

✔

Track longitudinal velocity and a lateral reference displacement.

Available when you set Vehicle dynamics to Combined longitudinal and lateral vehicle dynamics.

`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	Vehicle Dynamics Blockset	Description
`Mapped`	✔	Mapped rack-and-pinion steering model.
`Kinematic`	✔	Kinematic model for ideal rack-and-pinion steering. Gears convert the steering rotation into linear motion.
`Dynamic`	✔	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 Independent Suspension`		✔	Kinematics and compliance (K & C) test suspension characteristics measured from simulated or actual laboratory suspension tests.
`MacPherson Front Suspension Solid Axle Rear Suspension`		✔	Independent MacPherson suspension for multiple axles with multiple tracks per axle.

Programmatic Use

expand all