Virtual Vehicle Composer
Description
The Virtual Vehicle Composer enables you to quickly configure and build a virtual vehicle that you can use for system-level performance testing and analysis, including component sizing, fuel economy, battery state of charge, drive cycle tracking, vehicle handling maneuvers, software integration testing, and hardware-in-the-loop (HIL) testing. Use the app to configure your virtual vehicle architecture, select and parameterize its components, build the vehicle model, run test scenarios, and analyze the results.
The virtual vehicle model uses sets of blocks and reference application subsystems in Powertrain Blockset™, Vehicle Dynamics Blockset™, and Simscape™ add-ons. Virtual Vehicle Composer simplifies the task of configuring the vehicle and test plan.
If you have Powertrain Blockset, use the app to:
Configure and build a passenger vehicle with a conventional, battery-electric, or hybrid-electric powertrain architecture.
Operate the vehicle in test conditions such as FTP drive cycles.
Analyze design tradeoffs and size components.
If you have Vehicle Dynamics Blockset, use the app to:
Configure and build a passenger vehicle and analyze its handling characteristics by running standard test maneuvers.
Configure and build a motorcycle, and run it in drive cycles or vehicle handling maneuvers. Requires a Simscape license.
Visualize your virtual vehicle in the Unreal Engine® simulation environment. Requires a Simulink® 3D Animation™ license.
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 Fluids™
Simscape Multibody™ — Required for motorcycles
To build, operate, and analyze your virtual vehicle, use the Composer tab. The options and settings depend on the available products. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
| Step | Section | Button | Description | |
|---|---|---|---|---|
1 | Configure |
| Setup | Specify these parameters:
Click Confirm Setup.
Note Except for Configuration name, once you click Confirm Setup, you cannot change the selections on the Setup pane.
|
2 |
| Data and Calibration | Specify the body and frame, steering, suspension, tires, brakes, powertrain, and environment. For each selection, enter the parameter data. | |
3 |
| Scenario and Test | Construct a test plan including one or more virtual vehicle test scenarios. Options include driver or rider type, drive cycles for evaluating fuel economy and energy management, and vehicle handling maneuvers. | |
4 |
| Logging | Select the model signal data to log while running your test plan. Options include energy-related quantities and 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 and powertrain architectures and parameters you specify and associates the model with your test plan. |
6 | Operate |
| Run Test Plan | Simulate your model according to your test plan and log the resulting output data.
Note To run your entire test plan, on the Composer tab, in the Operate section, click Run Test Plan.
|
7 | Analyze |
| Simulation Data Inspector | Use the Simulation Data Inspector to view and inspect the data signals that you log. You can store your data for further processing. |
Open the Virtual Vehicle Composer App
MATLAB® Toolstrip: On the Apps tab, under Automotive, click the Virtual Vehicle Composer icon.
MATLAB Command Window: Enter
virtualVehicleComposer.
Parameters
The flow chart shows the steps to follow to configure, build, and test a vehicle with the Virtual Vehicle Composer app.
Setup
Start here to enter your virtual vehicle class, powertrain architecture, model template, and vehicle dynamics.
Vehicle class — Type of vehicle
Passenger vehicle (default) | Motorcycle
Specify the vehicle type.
Options for Vehicle class depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Four-wheeled passenger vehicle |
| Two-wheeled motorcycle. |
Dependencies
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 Fluids
Simscape Multibody — Required for motorcycles
Powertrain architecture — Conventional, battery-electric (EV), or hybrid-electric (HEV) passenger vehicle, or conventional or battery-electric motorcycle
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 | Conventional Motorcycle with Chain Drive | Electric Motorcycle with Chain Drive
Options for Powertrain architecture depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Passenger vehicle with an SI or CI internal combustion engine, transmission, and corresponding control units. May be FWD, RWD, or AWD. |
| Passenger vehicle with one electric motor, battery, driveline, and corresponding control units. May be FWD, RWD, or AWD. |
| Passenger vehicle with one motor driving the front axle and one motor driving the rear axle; battery, driveline, and corresponding control units. |
| Passenger vehicle with two independent motors driving the front wheels and one motor driving the rear axle; battery, driveline, and corresponding control units. |
| Passenger vehicle with one motor driving the front axle and two independent motors driving the rear wheels; battery, driveline, and corresponding control units. |
| Passenger vehicle with one independent motor driving each wheel; battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle P0 | Passenger vehicle with P0 hybrid-electric propulsion, including an SI engine, transmission, motor, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle P1 | Passenger vehicle with P1 hybrid-electric propulsion, including an SI engine, transmission, motor, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle P2 | Passenger vehicle with P2 hybrid-electric propulsion, including an SI engine, transmission, motor, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle P3 | Passenger vehicle with P3 hybrid-electric propulsion, including an SI engine, transmission, motor, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle P4 | Passenger vehicle with P4 hybrid-electric propulsion, including an SI engine, transmission, motor, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle MM | Passenger vehicle with multimode hybrid-electric propulsion, including an SI engine, transmission, motor, generator, battery, and corresponding control units. May be FWD, RWD, or AWD. |
Hybrid Electric Vehicle IPS | Passenger vehicle with input power split hybrid-electric propulsion, including an SI engine, transmission, motor, generator, battery, and corresponding control units. May be FWD, RWD, or AWD. |
| Motorcycle with an SI engine, transmission and chain/belt drive reductions, and corresponding control units. |
| Motorcycle with an electric motor, gear and chain/belt drive reductions, battery, and corresponding control units. |
Note
To refer back to your Powertrain architecture diagram, click the Setup tab. You can view the configuration of the system, including motor placements.
Vehicle dynamics — Virtual vehicle longitudinal or combined longitudinal and lateral dynamics
Longitudinal dynamics | Combined longitudinal and lateral dynamics | In-plane dynamics | Out-of-plane dynamics
Specify the virtual vehicle dynamics modeling.
Options for Vehicle dynamics depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
| Vehicle Class | Vehicle Dynamics | Goals |
|---|---|---|
Passenger vehicle |
| Fuel economy and energy management analysis, and straight-line performance |
| Vehicle handling, stability, and ride comfort analysis | |
Motorcycle |
| Fuel economy and energy management analysis |
| Vehicle handling, stability, and ride comfort analysis |
The virtual vehicle uses the Z-down coordinate system as defined in SAE J670. For more detail, see Coordinate Systems in Vehicle Dynamics Blockset.
Setting | Description |
|---|---|
| One- or three-degree-of-freedom (DOF) passenger vehicle model suitable for fuel economy and energy management analysis. |
| Six-DOF passenger vehicle suitable for vehicle handling, stability, and ride comfort analysis. |
In-plane dynamics | Three-DOF motorcycle model suitable for fuel economy and energy management analysis. The model implements a longitudinal in-plane motorcycle body model to simulate longitudinal, vertical, and pitch motions. |
Out-of-plane dynamics | Six-DOF motorcycle suitable for vehicle handling, stability, and ride comfort analysis. |
Model template — Vehicle plant and powertrain template
Simulink (default) | Simscape
Specify a Simulink or
Simscape vehicle plant model and powertrain architecture.
For Passenger vehicle, the default template is
Simulink. For Motorcycle, the
only option is Simscape.
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 Fluids
Simscape Multibody — Required for motorcycles
Dependencies
If you set Vehicle class to
Motorcycle, the app sets Model
template to Simscape. You cannot configure a
motorcycle and select Simulink as the model
template.
Project path — Project location
C:\Users\username\MATLAB\Projects\examples (default)
username\MATLAB\Projects\examplesSpecify the project location as a character vector.
Note
The combined Project path and Configuration name must be less than 80 characters.
Data Types: char
Configuration name — Unique name for each vehicle and test configuration within the project
ConfiguredVirtualVehicle (default)
Provide a brief identifier for each vehicle and test plan configuration.
Note
The combined Project path and Configuration name must be less than 80 characters.
Data Types: char
Custom component catalog (*.xml) — Directory of custom components
C:\Users\username\Projects\examples\VVCCustomCatalog.xml (default) | string
username\Projects\examples\VVCCustomCatalog.xmlSpecify a catalog of custom components as a string. The custom component catalog points to any custom components you want to have easy access to. A custom component could be a Simulink component from Virtual Vehicle Composer that you have reparameterized, or a Simulink model you have imported.
Note
If you set Model template to
Simscape, you cannot use a Custom component
catalog.
See Add Virtual Vehicle Custom Component and Edit or Remove Virtual Vehicle Custom Component.
Data and Calibration: Passenger Vehicle
Use the app to select and parameterize your virtual vehicle components, such as body and frame, suspension, tires, and powertrain.
You can select and modify components from the lists provided in
the Virtual Vehicle Composer, and if you set Model template to
Simulink, you can choose a custom component you have stored in
the Custom component catalog. See Add Virtual Vehicle Custom Component and Edit or Remove Virtual Vehicle Custom Component for more
detail.
Select one of the options for each component. The available options depend on available product licenses and your Setup pane selections. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
| Component | Description |
|---|---|
Body and Frame | Select how the body and frame assembly motion is modeled, and set its dimensional and inertial parameters. The available options depend on the Vehicle dynamics setting. |
Steering System | If you set Vehicle dynamics to
|
Suspension System | If you set Vehicle dynamics to
|
Tire and Wheel Systems | Select the tire model and tire data for the front and rear axles. The available options depend on the Vehicle dynamics setting. |
Brake System | Select the brake type and parameters for the front and rear axles. Use the Brake Control Unit parameter to specify anti-lock brakes and traction control. |
| Powertrain | Select the engine, electric motors, transmission, drivetrain, differential system, and electrical system parameters. The available options depend on the Powertrain architecture selected. |
Trailer | If you have Vehicle Dynamics Blockset, you can select a One-Axle
Trailer. |
Environment | Set parameters for the operating environment by selecting
|
Passenger Vehicle Body and Frame
Body and Frame — Body and frame type
Vehicle Body 1DOF Longitudinal | Vehicle Body 3DOF Longitudinal | Vehicle Body 6DOF Longitudinal and Lateral
Options for Body and Frame depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Body and frame model for one-DOF longitudinal vehicle dynamics.
Available when you set Vehicle dynamics to
|
| Body and frame model for three-DOF vehicle dynamics, allowing
longitudinal, vertical, and pitch motions. Available when you set
Vehicle dynamics to |
Vehicle Body 6DOF Longitudinal and
Lateral | Body and frame model for six-DOF longitudinal, lateral, and
vertical vehicle dynamics with corresponding rotations. Available when you
set Vehicle dynamics to |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Steering System — Virtual vehicle steering system
Kinematic Steering | Mapped Steering | Steering System | Multibody Steering
Options for Steering System depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | Availability |
|---|---|---|
| Kinematic steering model. Suitable for Ackerman steering. | Available when you set Body and frame
to Vehicle Body 6DOF Longitudinal and
Lateral. |
| Mapped rack-and-pinion steering model. | |
| Detailed steering system incorporating rack-and-pinion steering geometry and compliances. | |
| Simscape Multibody Link model incorporating rack and pinion geometry. This option does not include system compliance. | Available when you set Model template to
Simscape and Body and
frame to Vehicle Body 6DOF Longitudinal and
Lateral. |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Vehicle dynamics to
Combined longitudinal and lateral dynamics.
Front Suspension — Virtual vehicle front suspension
Kinematics and Compliance Independent Suspension
Front | MacPherson Front Suspension | Simscape Suspension Front
Options for Front Suspension depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | Availability |
|---|---|---|
| Kinematics and compliance (K and C) characteristics of independent front suspension | Available when you set
Body and frame to
Vehicle Body 6DOF Longitudinal and
Lateral |
| MacPherson strut independent front suspension | |
| Double-wishbone front suspension | Available when you set Model
template to
Simscape and Body and
frame to Vehicle Body 6DOF
Longitudinal and Lateral |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Vehicle dynamics to
Combined longitudinal and lateral dynamics.
Rear Suspension — Virtual vehicle rear suspension
Kinematics and Compliance Independent Suspension
Rear | Solid Axle Rear Suspension | Kinematics and Compliance Twist Beam Suspension
Rear | Simscape Suspension Rear
Options for Rear Suspension depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | Availability |
|---|---|---|
| Kinematics and compliance (K and C) characteristics of independent rear suspension. | Available when you set Body and frame
to Vehicle Body 6DOF Longitudinal and
Lateral. |
| Solid rear axle. | |
| K and C characteristics of twist beam rear suspension. | |
| Double-wishbone rear suspension. | Available when you set Model template to
Simscape and Body and
frame to Vehicle Body 6DOF Longitudinal and
Lateral. |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Vehicle dynamics to
Combined longitudinal and lateral dynamics.
Front Tire and Wheel — Tire model type
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
Options for Front Tire and Wheel depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | Availability |
|---|---|---|
| Tire model suitable for longitudinal vehicle motion studies, including fuel economy and energy management analysis. Only longitudinal parameters of the Magic Formula 6.2 equations are used. Includes options for modifying rolling resistance. | Available when you set Body and frame
to Vehicle Body 1DOF Longitudinal or
Vehicle Body 3DOF Longitudinal. |
| Tire model suitable for longitudinal vehicle dynamics studies, including acceleration, braking, and ride comfort analysis. Only longitudinal parameters of the Magic Formula 6.2 equations are used. You can select fitted tire data sets provided by the Global Center for Automotive Performance Simulation (GCAPS) for tires, including:
Not available if you set Model
template to
| |
MF Tires Longitudinal and Lateral
Front | Tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Magic Formula 6.2 equations are used. You can select fitted tire data sets provided by the Global Center for Automotive Performance Simulation (GCAPS) for tires, including:
Not available if you set Model
template to
| Available when you set Body and
frame to |
Fiala Tires Longitudinal and Lateral
Front | Simplified tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Parameters are intuitive and easy to tune, with some loss in fidelity. Consider this setting if you do not have the tire coefficients needed by the Magic Formula and are conducting studies that do not involve extensive nonlinear combined lateral slip or lateral dynamics. Not available if you set
Model template to
| |
Simscape MF Tires Front | Simscape tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Magic Formula equations are used. | Available when you set Model template to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Rear Tire and Wheel — Tire model type
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
Options for Rear Tire and Wheel depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | Availability |
|---|---|---|
| Tire model suitable for longitudinal vehicle motion studies, including fuel economy and energy management analysis. Only longitudinal parameters of the Magic Formula 6.2 equations are used. Includes options for modifying rolling resistance. | Available when you set Body and frame
to Vehicle Body 1DOF Longitudinal or
Vehicle Body 3DOF Longitudinal. |
| Tire model suitable for longitudinal vehicle dynamics studies, including acceleration, braking, and ride comfort analysis. Only longitudinal parameters of the Magic Formula 6.2 equations are used. You can select fitted tire data sets provided by the Global Center for Automotive Performance Simulation (GCAPS) for tires, including:
Not available if you set Model
template to
| |
MF Tires Longitudinal and Lateral Rear | Tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Magic Formula 6.2 equations are used. You can select fitted tire data sets provided by the Global Center for Automotive Performance Simulation (GCAPS) for tires, including:
| Available when you set Body and
frame to |
Fiala Tires Longitudinal and Lateral
Rear | Simplified tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Parameters are intuitive and easy to tune, with some loss in fidelity. Consider this setting if you do not have the tire coefficients needed by the Magic Formula and are conducting studies that do not involve extensive nonlinear combined lateral slip or lateral dynamics. Not available if you set
Model template to
| |
Simscape MF Tires Rear | Simscape tire model suitable for longitudinal and lateral vehicle dynamics studies, including vehicle handling, stability, and ride comfort analysis. Magic Formula equations are used. | Available when you set Model template to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Front Brake Type — Braking system architecture
Disc | Drum | Mapped
Setting | Description |
|---|---|
| Brake model converts the brake fluid pressure into a braking torque. |
| Brake model converts the brake fluid pressure and brake geometry into a braking torque. Not available if you set
Model template to
|
Mapped | Brake torque is a mapped function of the wheel speed and the brake fluid pressure. Not available if you set Model
template to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Rear Brake Type — Braking system architecture
Disc | Drum | Mapped
Setting | Description |
|---|---|
| Brake model converts the brake fluid pressure into a braking torque. |
| Brake model converts the brake fluid pressure and brake geometry into a braking torque. Not available if you set
Model template to
|
Mapped | Brake torque is a mapped function of the wheel speed and the brake fluid pressure. Not available if you set Model
template to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Brake Control Unit — Brake control
Open Loop (default) | Bang Bang ABS | Five-State ABS and TCS
Setting | Description |
|---|---|
| Open loop brake control. The controller commands brake pressure as a sole function of the brake command. |
| Anti-lock braking system (ABS) feedback controller that switches between two states to minimize the error between the actual slip and the desired slip. Here, the desired slip is the value where the friction coefficient of the tires reaches its maximum. |
Five-State ABS and TCS | Five-state ABS and traction control system (TCS) that uses logic-switching based on wheel and vehicle accelerations to control the braking pressure at each wheel. Consider using five-state ABS and TCS control to prevent wheel lock-up, decrease braking distance, and maintain yaw stability during maneuvers. The default ABS parameters are set to work on roads that have a constant friction coefficient scaling factor of 0.6. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Engine — Spark-ignition (SI) or compression-ignition (CI) internal combustion engine
SI Mapped Engine (default) | 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 Simple Engine | CI Engine | CI Mapped Engine | FMU Engine
Options for Engine depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description | ||||
|---|---|---|---|---|---|
| Mapped gasoline-fueled SI engine model using detailed look-up tables from steady-state operation. The data input includes include power, air mass flow rate, fuel flow, exhaust temperature, efficiency, and emission performance. Selecting If you have the Model-Based Calibration Toolbox™, you can generate a static calibration. Select from options on Calibrate from Data. For more detail, see Calibrate Mapped SI Engine Using Data (Powertrain Blockset). Not available if you set Model
template to
| ||||
SI Simple Engine | Simplified gasoline-fueled SI engine model that estimates engine torque and fuel flow rate using a steady-state table of maximum torque versus engine speed, along with two scalar fuel mass properties, and one scalar engine efficiency parameter. Selecting
| ||||
| SI gasoline-fueled engine physically modeled from intake port to exhaust port, including transient operating conditions. The model takes into account the ambient values of atmospheric temperature and pressure. Selecting Not
available if you set Model template to
| ||||
| A deep learning model that is generated from transient gasoline-fueled SI engine training data. This model type is capable of responding to rapid changes in operating conditions. Available if you have 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, diagnostics, and estimator algorithm design. Selecting For more detail, see Generate Deep Learning SI Engine Model (Powertrain Blockset). Not available if you set Model
template to
| ||||
| SI hydrogen-fueled engine physically modeled from intake port to exhaust port, including transient operating conditions. The model takes into account the ambient values of atmospheric temperature and pressure. Selecting Not
available if you set Model template to
| ||||
| Mapped hydrogen-fueled SI engine model using detailed look-up tables from steady-state operation. The data input includes include power, air mass flow rate, fuel flow, exhaust temperature, efficiency, and emission performance. Selecting If you have the Model-Based Calibration Toolbox, you can generate a static calibration. Select from options on Calibrate from Data. For more detail, see Calibrate Mapped SI Engine Using Data (Powertrain Blockset). Not available if you set Model
template to
| ||||
SI H2 Simple Engine | Simplified hydrogen-fueled SI engine model that estimates engine torque and fuel flow rate using a steady-state table of maximum torque versus engine speed, along with two scalar fuel mass properties, and one scalar engine efficiency parameter. Selecting
| ||||
| A deep learning model that is generated from transient hydrogen-fueled SI engine training data. This model type is capable of responding to rapid changes in operating conditions. Available if you have 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, diagnostics, and estimator algorithm design. Selecting For more detail, see Generate Deep Learning SI Engine Model (Powertrain Blockset). Not available if you set Model
template to
| ||||
| Mapped diesel-fueled compression-ignition engine model using detailed look-up tables from steady-state operation. The data input includes include power, air mass flow rate, fuel flow, exhaust temperature, efficiency, and emission performance. Selecting
If you have the Model-Based Calibration Toolbox, you can generate a static calibration. Select from options on Calibrate from Data. For more detail, see Calibrate Mapped CI Engine Using Data (Powertrain Blockset). Not available if you set Model
template to
| ||||
| Simplified diesel-fueled CI engine model that estimates engine torque and fuel flow rate using a steady-state table of maximum torque versus engine speed, along with two scalar fuel mass properties, and one scalar engine efficiency parameter. Selecting
Not available if
you set Model template to
| ||||
| CI diesel-fueled engine physically modeled from intake port to exhaust port, including transient operating conditions. The model takes into account the ambient values of atmospheric temperature and pressure. Selecting Not
available if you set Model template to
| ||||
| The functional mockup unit (FMU) engine implements an FMU block with these engine inputs and outputs.
Selecting To implement the FMU engine model:
|
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Powertrain architecture to any of these options:
Conventional VehicleHybrid Electric Vehicle P0Hybrid Electric Vehicle P1Hybrid Electric Vehicle P2Hybrid Electric Vehicle P3Hybrid Electric Vehicle P4Hybrid Electric Vehicle MMHybrid Electric Vehicle IPS
Vehicle Control Unit — Control system to direct energy flows in electric and hybrid-electric vehicles
EV 1EM with BMS | EV 2EM | EV 3EM Dual Front | EV 3EM Dual Rear | EV 4EM | HEVP0 Optimal | HEVP1 Optimal | HEVP2 Optimal | HEVP3 Optimal | HEVP4 Optimal | HEVMM RuleBased | HEVIPS RuleBased
Setting | Powertrain Architecture | Description |
|---|---|---|
EV 1EM with BMS | Electric Vehicle 1EM | Controls motors with torque arbitration and power management. Implements regenerative braking. |
EV 2EM | Electric Vehicle 2EM | |
EV 3EM Dual Front | Electric Vehicle 3EM Dual Front | |
EV 3EM Dual Rear | Electric Vehicle 3EM Dual Rear | |
EV 4EM | Electric Vehicle 4EM | |
| Hybrid Electric Vehicle P0 | 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 SOC. Implements regenerative braking. |
| Hybrid Electric Vehicle P1 | |
|
| |
|
| |
HEVP4 Optimal |
| |
HEVMM RuleBased |
| Controls the motor, generator, and engine through a set of rules and decision logic implemented in Stateflow®. Implements regenerative braking. |
HEVIPS RuleBased |
|
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Powertrain
architecture to one of these options:
Electric Vehicle, wherexEMxis 1, 2, or 4Electric Vehicle 3EM Dual FrontElectric Vehicle 3EM Dual RearHybrid Electric Vehicle P, wherexxis 0, 1, 2, 3 or 4Hybrid Electric Vehicle MMHybrid Electric Vehicle IPS
DC-DC Converter — Power electronics device to change voltage of supplied current
DC-DC Converter (default) | HVDCPassThrough
The DC-DC Converter option provides a bidirectional
DC-to-DC converter that supports boost (voltage-increasing) and buck
(voltage-reducing) operations. With the HVDCPassThrough
option, the current is supplied at battery voltage.
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Powertrain
architecture to one of these options:
Electric Vehicle, wherexEMxis 1, 2, or 4Electric Vehicle 3EM Dual FrontElectric Vehicle 3EM Dual RearHybrid Electric Vehicle P, wherexxis 0, 1, 2, 3 or 4Hybrid Electric Vehicle MMHybrid Electric Vehicle IPS
Energy Storage — Virtual vehicle electrical energy storage
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
Options for Energy Storage depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Open-circuit voltage and internal resistance are mapped functions of the state of charge (SOC) and battery temperature. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Constant-voltage source with infinite storage capacity. |
| Available if you set Model Template to
|
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Powertrain
architecture to one of these options:
Electric Vehicle, wherexEMxis 1, 2, or 4Electric Vehicle 3EM Dual FrontElectric Vehicle 3EM Dual RearHybrid Electric Vehicle P, wherexxis 0, 1, 2, 3 or 4Hybrid Electric Vehicle MMHybrid Electric Vehicle IPS
Electric Machine x — Virtual vehicle electric motor
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
xOptions for electric machines depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
The table shows electric machine options for motors in each location
x, as shown on the Powertrain
architecture diagram on the Setup pane.
Setting | Description |
|---|---|
| Torque envelope is mapped versus motor speed and applied voltage. Mechanical losses are mapped versus motor speed, torque, operating temperature, and voltage. The app sets default parameters for the motor based on the powertrain architecture. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Torque envelope is mapped versus motor speed. Mechanical losses are mapped versus motor speed and torque. The app sets default parameters for the motor based on the powertrain architecture. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
|
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Powertrain
architecture to one of these options:
Electric Vehicle, wherexEMxis 1, 2, or 4Electric Vehicle 3EM Dual FrontElectric Vehicle 3EM Dual RearHybrid Electric Vehicle P, wherexxis 0, 1, 2, 3 or 4Hybrid Electric Vehicle MMHybrid Electric Vehicle IPS
Thermal — Thermal management system for component cooling in battery-electric vehicles
No Thermal System | Thermal System
Set the parameters under Thermal System to specify the
thermal management system physical properties. Set the target control temperatures
under Thermal Control.
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Powertrain
architecture to one of these options:
Electric Vehicle, wherexEMxis 1, 2, or 4Electric Vehicle 3EM Dual FrontElectric Vehicle 3EM Dual Rear
Drivetrain — Virtual vehicle drivetrain
Front Wheel Drive (default) | 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
Options for Drivetrain depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Drives both wheels on the front axle through a differential |
Rear Wheel Drive | Drives both wheels on the rear axle through a differential |
All Wheel Drive | Drives all four wheels through a transfer case and differentials |
All Wheel Driven by 2EM | Uses a single motor to drive the front wheels through a differential and a single motor to drive the rear wheels through a differential |
All Wheel Driven by 3EM Front | Uses two motors to drive the front wheels separately and a single motor to drive the rear wheels through a differential |
All Wheel Driven by 3EM Rear | Uses two motors to drive the rear wheels separately and a single motor to drive the front wheels through a differential |
All Wheel Driven by 4EM | Uses a single motor to drive each wheel separately. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Transmission — Virtual vehicle transmission
Ideal Fixed Gear Transmission | Automatic Transmission with Torque Converter | Automated Manual Transmission
Options for Transmission depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Idealized transmission without clutch or synchronization detail. Use this setting to model the gear ratios and power loss when you do not need a detailed transmission model. |
| Automatic transmission with planetary gears and a torque converter. |
| A manual transmission with additional actuators and an electronic control unit (ECU) to regulate clutch and gear selection based on commands from a controller. Clutch and synchronizer engagement rates are linear and adjustable. Not available if Model
template is set to
|
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Powertrain architecture to any of these options:
Conventional VehicleHybrid Electric Vehicle P0Hybrid Electric Vehicle P1Hybrid Electric Vehicle P2Hybrid Electric Vehicle P3Hybrid Electric Vehicle P4
Transmission Control Unit — Virtual vehicle transmission control
PRNDL Controller
Setting | Description |
|---|---|
| Controller that executes forward, reverse, neutral, park, and N-speed gear shifts according to the selected shift schedule. You can supply multiple schedules and select them using a block input. |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Passenger vehicle.Set Powertrain architecture to any of these options:
Conventional VehicleHybrid Electric Vehicle P0Hybrid Electric Vehicle P1Hybrid Electric Vehicle P2Hybrid Electric Vehicle P3Hybrid Electric Vehicle P4
Front Differential System — Final drive ratio and differential action
Open Differential (default) | Limited Slip Differential | Dual EM Drive Front
Options for Front Differential System depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Mechanical differential providing equal torque to both wheels. |
| Couples passive friction elements to an open differential to achieve the desired axle torque bias. |
Dual EM Drive Front | Two electric motors independently driving the front wheels, providing differential action. |
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Drivetrain
to Front Wheel Drive or All Wheel
Drive.
Alternatively, set Vehicle class to Passenger
vehicle and Powertrain architecture to
Electric Vehicle 2EM, Electric Vehicle 3EM
Dual Front, Electric Vehicle 3EM Dual
Rear, or Electric Vehicle 4EM.
Rear Differential System — Final drive ratio and differential action
Open Differential Rear (default) | Active Differential Rear | Limited Slip Differential Rear | Dual EM Drive Rear
Options for Rear Differential System depend on available product licenses. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.
Setting | Description |
|---|---|
| Mechanical differential providing equal torque to both wheels. |
| Couples active elements to an open differential to achieve the desired axle torque bias. Not available if you set
Model template to
|
| Couples passive friction elements to an open differential to achieve the desired axle torque bias. |
Dual EM Drive Rear | Two electric motors independently driving the rear wheels, providing differential action. |
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Drivetrain
to Rear Wheel Drive or All Wheel
Drive.
Alternatively, set Vehicle class to Passenger
vehicle and Powertrain architecture to
Electric Vehicle 2EM, Electric Vehicle 3EM
Dual Front, Electric Vehicle 3EM Dual
Rear, or Electric Vehicle 4EM.
Active Differential Control — Active differential control for rear axle
No Control (default) | Rear Differential Controller
Choose whether to activate the active differential controller.
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle, Drivetrain to
Rear Wheel Drive, All Wheel
Drive, All Wheel Driven by 2EM, or
All Wheel Driven by 3EM Front, and Rear
Differential System to Active Differential
Rear.
Axle Interconnect — Coupling between front and rear axles
Transfer Case (default)
Specify the coupling between front and rear axles as a transfer case.
Dependencies
To enable this parameter, set Vehicle class to
Passenger vehicle and Drivetrain
to All Wheel Drive.
Trailer — Single-axle trailer
No Trailer | One-Axle Trailer
Specify trailer dimensions and inertial properties by selecting
One-Axle Trailer.
Requires a Vehicle Dynamics Blockset license. Not available if you set Model template to
Simscape.
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Environment — Virtual vehicle environment
Ambient Conditions
Set parameters for the operating environment by selecting Ambient
Conditions.
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Data and Calibration: Motorcycle
Use the app to select and parameterize your virtual motorcycle components, such as the body and frame, suspension, tires, and powertrain.
All vehicles configured with Vehicle class set to
Motorcycle require:
Vehicle Dynamics Blockset
Simscape Multibody
Select one of the options for each component. The available options depend on your Setup selections.
| Parameter | Description |
|---|---|
| Body and Frame | Select the body and frame type. The available options depend on the Vehicle dynamics setting. |
| Steering System | With Vehicle dynamics set to
|
| Front Suspension | With Vehicle dynamics set to
|
| Rear Suspension | With Vehicle dynamics set to
|
| Front Tire | Set the front tire parameters. |
| Rear Tire | Set the rear tire parameters. |
| Front Brake Type | Select the front brake type and set parameters. |
| Rear Brake Type | Select the rear brake type and set parameters. |
| Brake Control Unit | Use the Brake Control Unit parameter to specify anti-lock brakes. |
| Powertrain | Select the engine or electric motor, and chain drive parameters. The available options depend on the Powertrain architecture setting. |
| Environment | Set parameters for the operating environment by selecting
|
Motorcycle Body and Frame
Body and Frame — Vehicle body and frame assembly model
In-Plane Model | Out-of-Plane Model
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Models dynamics in the longitudinal-vertical plane. Available when Vehicle dynamics is
set to |
| Models dynamics in six degrees of freedom. Available
when Vehicle dynamics is set to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Steering System — Steered front fork
Steering (default) | No Steering
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Handlebar-steered front fork on a frame-mounted revolute joint |
| Steering angle fixed at zero |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Motorcycle.Set Vehicle dynamics to
Out-of-plane dynamics.
Steering Damper — Damper
No Damper (default) | Linear Damper
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| No torsional damping |
| Torsional damper about steering axis, with linear viscous damping |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Motorcycle.Set Vehicle dynamics to
Out-of-plane dynamics.
Front Suspension — Front fork suspension
Linear Spring and Damper Front (default)
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Telescoping fork with linear spring and damper |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Motorcycle.Set Vehicle dynamics to
Out-of-plane dynamics.
Rear Suspension — Rear swing arm suspension
Linear Spring and Damper Rear (default)
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Swing arm with torsional spring and damper at its pivot. Stiffness and damping are linear. |
Dependencies
To enable this parameter, on the Setup pane:
Set Vehicle class to
Motorcycle.Set Vehicle dynamics to
Out-of-plane dynamics.
Front Tire and Wheel — Tire with linear properties
Linear Tire Front (default)
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Tire with linear force and moment model, using Simscape modeling |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Rear Tire and Wheel — Tire with linear properties
Linear Tire Rear (default)
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Tire with linear force and moment model, using Simscape modeling |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Front Brake Type — Brake hardware
Disc (default) | Drum | Mapped
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Brake model converts the brake fluid pressure into a braking torque |
| Brake model converts the brake fluid pressure and brake geometry into a braking torque |
Mapped | Brake torque is a mapped function of the wheel speed and the brake fluid pressure |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Rear Brake Type — Brake hardware
Disc (default) | Drum | Mapped
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Brake model converts the brake fluid pressure into a braking torque. |
| Brake model converts the brake fluid pressure and brake geometry into a braking torque. |
Mapped | Brake torque is a mapped function of the wheel speed and the brake fluid pressure. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Brake Control Unit — Brake control
Open Loop Controller (default) | Bang Bang ABS | Five-State ABS
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Open loop brake control. The controller commands brake pressure as a sole function of the brake command. |
| Anti-lock braking system (ABS) feedback controller that switches between two states to minimize the error between the actual slip and the desired slip. Here, the desired slip is the value where the friction coefficient of the tires reaches its maximum. |
Five-State ABS | Five-state ABS that uses logic-switching based on wheel and vehicle accelerations to control the braking pressure at each wheel. Consider using five-state ABS control to prevent wheel lock-up, decrease braking distance, and maintain yaw stability during maneuvers. The default ABS parameters are set to work on roads that have a constant friction coefficient scaling factor of 0.6. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Propulsion System — Motorcycle power generation
Simple Engine | SI Mapped Engine | Mapped Motor
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Simplified SI engine model using a maximum torque versus engine speed table, two scalar fuel mass properties, and one scalar engine efficiency parameter to estimate engine torque and fuel flow. Available when you set Powertrain
architecture to |
| Mapped SI engine model using detailed power, air mass flow, fuel flow, exhaust temperature, efficiency, and emission performance lookup tables. Available when you set Powertrain
architecture to |
Mapped Motor | Electric motor with maximum torque mapped vs. motor speed, and mechanical losses mapped vs. speed and torque. Available when
you set Powertrain architecture to
|
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Chain — Motorcycle chain drive or belt drive system
Chain/Belt Drive (default)
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Inextensible chain or belt which meshes with front and rear sprockets or pulleys. Rear sprocket or pulley mounts to wheel with a torsional damper. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Environment — Virtual vehicle environment
Ambient Conditions
Set parameters for the operating environment by selecting Ambient
Conditions.
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Scenario and Test
Assemble a test plan for your virtual vehicle.
Driver — Driver control model
Longitudinal Driver | Predictive Driver | Predictive Stanley Driver
Options for Driver depend on available product licenses. See Passenger Vehicle License Requirements and Dependencies (Powertrain Blockset) for more detail.
Setting | Description |
|---|---|
Longitudinal Driver | Implements a longitudinal speed-tracking controller. |
| Tracks longitudinal velocity and a lateral displacement relative to a reference pose. Available when you set Vehicle
dynamics to |
| Adjusts the steering angle command to match the current pose of a vehicle to a reference pose, given the vehicle's current velocity and direction. Available when you set Vehicle
dynamics to |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to Passenger
vehicle.
Rider — Rider inertial characteristics
Rigid (default) | 6DOF and External Forces and Moments
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
| Rider implemented as a rigid body so that their relative motion to the motorcycle frame is zero. No crouching or longitudinal shifting, and their lean angle is the same as the motorcycle frame. |
| Rider body implemented with six degrees of freedom relative to the motorcycle frame. Able to lean and crouch independently of frame. |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Rider Control — Rider control model
Longitudinal Rider (default) | Open Loop
All vehicles configured with Vehicle class
set to Motorcycle require Vehicle Dynamics Blockset and Simscape
Multibody. See Motorcycle License Requirements and Dependencies
for more detail.
Setting | Description |
|---|---|
Longitudinal Rider | Implements a longitudinal speed-tracking controller |
| Rider operates controls as prescribed by test scenarios |
Dependencies
To enable this parameter, on the Setup pane, set
Vehicle class to
Motorcycle.
Passenger vehicle — For a
Passenger vehicle, if you set Vehicle dynamics toLongitudinal dynamics, you can select:Standard drive cycles from industry agencies and institutions. The default selection is the
FTP75drive cycle. Certain drive cycles include gear shift schedules, for example,JC08andCUEDC.Wide open throttle (WOT) parameters, including initial and nominal reference speeds, deceleration start time, and final reference speed.
For a
Passenger vehicle, if you have Vehicle Dynamics Blockset and set Vehicle dynamics toCombined longitudinal and lateral dynamics, you can select maneuvers for vehicle handling, stability, and ride analysis. Maneuvers include:Increasing SteerSwept SineSine with DwellFishhookWide Open Throttle
Motorcycle — For a
Motorcycle, if you set Vehicle dynamics toIn-plane dynamics, you can select:Standard drive cycles from industry agencies and institutions. The default selection is the
FTP75drive cycle. Certain drive cycles include gear shift schedules, for example,JC08andCUEDC.Wide open throttle (WOT) parameters, including initial and nominal reference speeds, deceleration start time, and final reference speed.
For a
Motorcycle, if you set Vehicle dynamics toOut-of-plane dynamics, you can select maneuvers for vehicle handling, stability, and ride analysis. Maneuvers include:Steady TurningHandle Hit
If you want to run your virtual vehicle in the Unreal Engine 3D simulation environment, set 3D Scene Selection to
3D Scene. See the requirements in Unreal Engine Simulation Environment Requirements and Limitations.
Logging
On the Logging tab, select the signals to log. The app has a default set of signals in the Selected Signals list. The default list depends on the vehicle configuration. You can add or remove signals. Options include energy-related quantities, and vehicle position, velocity, and acceleration.
Build
To build your virtual vehicle, on the Composer tab, in the Build section, Click Virtual Vehicle. When you build, the Virtual Vehicle Composer app creates a Simulink model that incorporates the vehicle architecture and parameters that you have specified and associates the model with the test plan you have assembled.
The build takes time to complete. View progress in the progress bar.
Operate
To run your entire test plan, on the Composer tab, in the
Operate section, click Run Test Plan
.
The simulations take time to complete. View progress in the MATLAB Command Window.
The app can also produce a power analysis report for the last scenario in your test plan. For more detail, see Run Power Accounting.
Analyze
To view and analyze simulation signals you chose to log during operation, on the Composer tab, in the Analyze section, click Simulation Data Inspector.
If your test plan includes more than one test scenario, the Simulation Data Inspector displays the results from the last scenario. To see results from earlier scenarios, load the archived results.
For more detail, see Simulation Data Inspector.
Programmatic Use
Version History
Introduced in R2022a
You can also select a web site from the following list
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本Japanese (日本語)
- 한국Korean (한국어)