Virtual Vehicle Composer

Configure, build, and analyze a virtual automotive vehicle

Since R2022a

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: Vehicle class Powertrain architecture Vehicle dynamics Model template Project path Configuration name Custom component catalog 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.

More

Required Products

This is a brief summary of the major product license requirements. See Product and Configuration Dependencies for Virtual Vehicle Composer for more detail.

The Virtual Vehicle Composer requires either of these products:

• Powertrain Blockset

• Vehicle Dynamics Blockset

  With Vehicle Dynamics Blockset and Simulink 3D Animation, you can 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 Simscape and these Simscape add-ons, you can use the app to configure vehicles with Simscape subsystems:

• Simscape Driveline

• Simscape Electrical

• Simscape Fluids

• Simscape Multibody — Required for motorcycles

×

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.

Examples

• Get Started with the Virtual Vehicle Composer

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
Passenger vehicle	Four-wheeled passenger vehicle
Motorcycle	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
Conventional Vehicle	Passenger vehicle with an SI or CI internal combustion engine, transmission, and corresponding control units. May be FWD, RWD, or AWD.
Electric Vehicle 1EM	Passenger vehicle with one electric motor, battery, driveline, and corresponding control units. May be FWD, RWD, or AWD.
Electric Vehicle 2EM	Passenger vehicle with one motor driving the front axle and one motor driving the rear axle; battery, driveline, and corresponding control units.
Electric Vehicle 3EM Dual Front	Passenger vehicle with two independent motors driving the front wheels and one motor driving the rear axle; battery, driveline, and corresponding control units.
Electric Vehicle 3EM Dual Rear	Passenger vehicle with one motor driving the front axle and two independent motors driving the rear wheels; battery, driveline, and corresponding control units.
Electric Vehicle 4EM	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.
Conventional Motorcycle with Chain Drive	Motorcycle with an SI engine, transmission and chain/belt drive reductions, and corresponding control units.
Electric Motorcycle with Chain Drive	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	Longitudinal dynamics	Fuel economy and energy management analysis, and straight-line performance
	Combined longitudinal and lateral dynamics	Vehicle handling, stability, and ride comfort analysis
Motorcycle	In-plane dynamics	Fuel economy and energy management analysis
	Out-of-plane dynamics	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
Longitudinal dynamics	One- or three-degree-of-freedom (DOF) passenger vehicle model suitable for fuel economy and energy management analysis.
Combined longitudinal and lateral dynamics	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)

Specify 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

Specify 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 Combined longitudinal and lateral dynamics, you can specify the steering system.
Suspension System	If you set Vehicle dynamics to Combined longitudinal and lateral dynamics, you can specify the suspensions for the front and rear axles.
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 Ambient Conditions.

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
Vehicle Body 1DOF Longitudinal	Body and frame model for one-DOF longitudinal vehicle dynamics. Available when you set Vehicle dynamics to Longitudinal dynamics.
Vehicle Body 3DOF Longitudinal	Body and frame model for three-DOF vehicle dynamics, allowing longitudinal, vertical, and pitch motions. Available when you set Vehicle dynamics to Longitudinal dynamics.
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 Combined longitudinal and lateral dynamics.

Dependencies

To enable this parameter, on the Setup pane, set Vehicle class to Passenger vehicle.

Passenger Vehicle Steering System

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	Kinematic steering model. Suitable for Ackerman steering.	Available when you set Body and frame to Vehicle Body 6DOF Longitudinal and Lateral.
Mapped Steering	Mapped rack-and-pinion steering model.
Steering System	Detailed steering system incorporating rack-and-pinion steering geometry and compliances.
Multibody Steering System	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.

Passenger Vehicle Front Suspension

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 Independent Suspension Front	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 Front Suspension	MacPherson strut independent front suspension
Simscape Suspension Front	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.

Passenger Vehicle Rear Suspension

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 Independent Suspension Rear	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 Axle Rear Suspension	Solid rear axle.
Kinematics and Compliance Twist Beam Suspension Rear	K and C characteristics of twist beam rear suspension.
Simscape Suspension Rear	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.

Passenger Vehicle Front Tire and Wheel System

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
MF Tires Longitudinal Front	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.
Combined Slip Tires Longitudinal Front	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: 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 Not available if you set Model template to Simscape.
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: 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 Not available if you set Model template to Simscape.	Available when you set Body and frame to Vehicle Body 6DOF Longitudinal and Lateral.
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.
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 Simscape and set 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.

Passenger Vehicle Rear Tire and Wheel System

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
MF Tires Longitudinal Rear	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.
Combined Slip Tires Longitudinal Rear	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: 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 Not available if you set Model template to Simscape.
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: 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	Available when you set Body and frame to Vehicle Body 6DOF Longitudinal and Lateral.
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.
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 Simscape and set 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.

Passenger Vehicle Brake System

Front Brake Type — Braking system architecture

Disc | Drum | Mapped

Setting	Description
Disc	Brake model converts the brake fluid pressure into a braking torque.
Drum	Brake model converts the brake fluid pressure and brake geometry into a braking torque. Not available if you set Model template to Simscape.
Mapped	Brake torque is a mapped function of the wheel speed and the brake fluid pressure. Not available if you set Model template to Simscape.

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
Disc	Brake model converts the brake fluid pressure into a braking torque.
Drum	Brake model converts the brake fluid pressure and brake geometry into a braking torque. Not available if you set Model template to Simscape.
Mapped	Brake torque is a mapped function of the wheel speed and the brake fluid pressure. Not available if you set Model template to Simscape.

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	Open loop brake control. The controller commands brake pressure as a sole function of the brake command.
Bang Bang ABS	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.

Passenger Vehicle Powertrain

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
SI Mapped Engine	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 SI Mapped Engine sets the Engine Control Unit parameter to SI Engine Controller. 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 Simscape.
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 Simple Engine (SI) sets the Engine Control Unit parameter to Simple ECU.
SI Engine	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 SI Engine sets the Engine Control Unit parameter to SI Engine Controller. Not available if you set Model template to Simscape.
SI Deep Learning Engine	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 SI Deep Learning Engine sets the Engine Control Unit parameter to SI Engine Controller. For more detail, see Generate Deep Learning SI Engine Model (Powertrain Blockset). Not available if you set Model template to Simscape.
SI H2 Engine	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 SI H2 Engine sets the Engine Control Unit parameter to SI Engine Controller. Not available if you set Model template to Simscape.
SI H2 Mapped Engine	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 SI H2 Mapped Engine sets the Engine Control Unit parameter to SI Engine Controller. 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 Simscape.
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 Simple H2 Engine (SI) sets the Engine Control Unit parameter to Simple ECU.
SI H2 Deep Learning Engine	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 SI H2 Deep Learning Engine sets the Engine Control Unit parameter to SI Engine Controller. For more detail, see Generate Deep Learning SI Engine Model (Powertrain Blockset). Not available if you set Model template to Simscape.
CI Mapped Engine	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 CI Mapped Engine sets the Engine Control Unit parameter to CI Engine Controller. 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 Simscape.
CI Simple Engine	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 Simple Engine (CI) sets the Engine Control Unit parameter to Simple ECU. Not available if you set Model template to Simscape.
CI Engine	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 CI Engine sets the Engine Control Unit parameter to CI Engine Controller. Not available if you set Model template to Simscape.
FMU Engine	The functional mockup unit (FMU) engine implements an FMU block with these engine inputs and outputs. Inputs Outputs Torque command Engine RPM Brake torque Fuel flow Air flow Exhaust gas temperature Air fuel ratio Brake-specific fuel consumption (BSFC) Crank angle Selecting FMU Engine sets the Engine Control Unit parameter to Simple ECU. To implement the FMU engine model: Set Engine to FMU Engine. Use Browse to select the FMU file. Select Read to verify the FMU inputs and outputs. If verification passes, the number of FMU inputs and outputs matches the signals in the FMU Import subsystem. If verification warns, the number of FMU inputs and outputs does not match the signals in the FMU Import subsystem. However, you can still import the FMU file and manually connect the signals. Select Import to integrate the FMU in the virtual vehicle FMU Import subsystem.

Dependencies

To enable this parameter, on the Setup pane:

• Set Vehicle class to Passenger vehicle.

• 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

  • Hybrid Electric Vehicle MM

  • Hybrid 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
HEVP0 Optimal	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.
HEVP1 Optimal	Hybrid Electric Vehicle P1
HEVP2 Optimal	Hybrid Electric Vehicle P2
HEVP3 Optimal	Hybrid Electric Vehicle P3
HEVP4 Optimal	Hybrid Electric Vehicle P4
HEVMM RuleBased	Hybrid Electric Vehicle MM	Controls the motor, generator, and engine through a set of rules and decision logic implemented in Stateflow®. Implements regenerative braking.
HEVIPS RuleBased	Hybrid Electric Vehicle IPS

Dependencies

To enable this parameter, set Vehicle class to Passenger vehicle and Powertrain architecture to one of these options:

• Electric Vehicle xEM, where x is 1, 2, or 4

• Electric Vehicle 3EM Dual Front

• Electric Vehicle 3EM Dual Rear

• Hybrid Electric Vehicle Px, where x is 0, 1, 2, 3 or 4

• Hybrid Electric Vehicle MM

• Hybrid 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 xEM, where x is 1, 2, or 4

• Electric Vehicle 3EM Dual Front

• Electric Vehicle 3EM Dual Rear

• Hybrid Electric Vehicle Px, where x is 0, 1, 2, 3 or 4

• Hybrid Electric Vehicle MM

• Hybrid 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
Mapped Battery (Electric Vehicle 1EM)	Open-circuit voltage and internal resistance are mapped functions of the state of charge (SOC) and battery temperature.
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	Constant-voltage source with infinite storage capacity.
Detailed Battery	Available if you set Model Template to Simscape.

Dependencies

To enable this parameter, set Vehicle class to Passenger vehicle and Powertrain architecture to one of these options:

• Electric Vehicle xEM, where x is 1, 2, or 4

• Electric Vehicle 3EM Dual Front

• Electric Vehicle 3EM Dual Rear

• Hybrid Electric Vehicle Px, where x is 0, 1, 2, 3 or 4

• Hybrid Electric Vehicle MM

• Hybrid 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

Options 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
Electric Vehicle 1EM - Mapped Motor	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.
Electric Vehicle 2EM - Mapped Motor
Electric Vehicle 3EM Dual Front - Mapped Motor
Electric Vehicle 3EM Dual Rear - Mapped Motor
Electric Vehicle 4EM - Mapped Motor
Hybrid Electric Vehicle P0 - Mapped Motor
Hybrid Electric Vehicle P1 - Mapped Motor
Hybrid Electric Vehicle P2 - Mapped Motor
Hybrid Electric Vehicle P3 - Mapped Motor
Hybrid Electric Vehicle P4 - Mapped Motor
Hybrid Electric Vehicle MM - Mapped Motor
Hybrid Electric Vehicle IPS - Mapped Motor
Electric Vehicle 1EM - Simple Motor	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.
Electric Vehicle 2EM - Simple Motor
Electric Vehicle 3EM Dual Front - Simple Motor
Electric Vehicle 3EM Dual Rear - Simple Motor
Electric Vehicle 4EM - Simple Motor
Hybrid Electric Vehicle P0 - Simple Motor
Hybrid Electric Vehicle P1 - Simple Motor
Hybrid Electric Vehicle P2 - Simple Motor
Hybrid Electric Vehicle P3 - Simple Motor
Hybrid Electric Vehicle P4 - Simple Motor
Hybrid Electric Vehicle MM - Simple Motor
Hybrid Electric Vehicle IPS - Simple Motor

Dependencies

To enable this parameter, set Vehicle class to Passenger vehicle and Powertrain architecture to one of these options:

• Electric Vehicle xEM, where x is 1, 2, or 4

• Electric Vehicle 3EM Dual Front

• Electric Vehicle 3EM Dual Rear

• Hybrid Electric Vehicle Px, where x is 0, 1, 2, 3 or 4

• Hybrid Electric Vehicle MM

• Hybrid Electric Vehicle IPS

Passenger Vehicle Thermal Control System

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 xEM, where x is 1, 2, or 4

• Electric Vehicle 3EM Dual Front

• Electric 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
Front Wheel Drive	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
Ideal Fixed Gear Transmission	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 Torque Converter	Automatic transmission with planetary gears and a torque converter.
Automated Manual Transmission	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 Simscape.

Dependencies

To enable this parameter, on the Setup pane:

• Set Vehicle class to Passenger vehicle.

• 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

Setting	Description
PRNDL Controller	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 Vehicle

  • Hybrid Electric Vehicle P0

  • Hybrid Electric Vehicle P1

  • Hybrid Electric Vehicle P2

  • Hybrid Electric Vehicle P3

  • Hybrid 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
Open Differential	Mechanical differential providing equal torque to both wheels.
Limited Slip Differential	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
Open Differential Rear	Mechanical differential providing equal torque to both wheels.
Active Differential Rear	Couples active elements to an open differential to achieve the desired axle torque bias. Not available if you set Model template to Simscape.
Limited Slip Differential Rear	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.

Passenger Vehicle Trailer

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

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 Out-of-plane dynamics, you can specify the steering system.
Front Suspension	With Vehicle dynamics set to Out-of-plane dynamics, you can specify the front suspension.
Rear Suspension	With Vehicle dynamics set to Out-of-plane dynamics, you can specify the rear suspension.
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 Ambient Conditions.

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
In-Plane Model	Models dynamics in the longitudinal-vertical plane. Available when Vehicle dynamics is set to In-plane dynamics.
Out-of-Plane Model	Models dynamics in six degrees of freedom. Available when Vehicle dynamics is set to Out-of-plane dynamics.

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
Steering	Handlebar-steered front fork on a frame-mounted revolute joint
No Steering	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 Damper	No torsional damping
Linear Damper	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
Linear Spring and Damper Front	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
Linear Spring and Damper Rear	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
Linear Tire Front	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
Linear Tire Rear	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
Disc	Brake model converts the brake fluid pressure into a braking torque
Drum	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
Disc	Brake model converts the brake fluid pressure into a braking torque.
Drum	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 Controller	Open loop brake control. The controller commands brake pressure as a sole function of the brake command.
Bang Bang ABS	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.

Motorcycle Powertrain

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
Simple Engine	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 Conventional Motorcycle with Chain Drive.
SI Mapped Engine	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 Conventional Motorcycle with Chain Drive.
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 Electric Motorcycle with Chain Drive.

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
Chain/Belt Drive	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

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.

Passenger Vehicle Driver

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.
Predictive Driver	Tracks longitudinal velocity and a lateral displacement relative to a reference pose. Available when you set Vehicle dynamics to Combined longitudinal and lateral dynamics.
Predictive Stanley Driver	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 Combined longitudinal and lateral dynamics.

Dependencies

To enable this parameter, on the Setup pane, set Vehicle class to Passenger vehicle.

Motorcycle Rider

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
Rigid	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.
6DOF and External Forces and Moments	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
Open Loop	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 to Longitudinal dynamics, you can select:

  • Standard drive cycles from industry agencies and institutions. The default selection is the FTP75 drive cycle. Certain drive cycles include gear shift schedules, for example, JC08 and CUEDC.

  • 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 to Combined longitudinal and lateral dynamics, you can select maneuvers for vehicle handling, stability, and ride analysis. Maneuvers include:

  • Increasing Steer

  • Swept Sine

  • Sine with Dwell

  • Fishhook

  • Wide Open Throttle

• Motorcycle — For a Motorcycle, if you set Vehicle dynamics to In-plane dynamics, you can select:

  • Standard drive cycles from industry agencies and institutions. The default selection is the FTP75 drive cycle. Certain drive cycles include gear shift schedules, for example, JC08 and CUEDC.

  • 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 to Out-of-plane dynamics, you can select maneuvers for vehicle handling, stability, and ride analysis. Maneuvers include:

  • Steady Turning

  • Handle 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

virtualVehicleComposer

Entering the command virtualVehicleComposer opens a new session of the app, enabling you to configure, build, and analyze your virtual vehicle.

Version History

Introduced in R2022a

R2024b: Virtual Vehicle Composer: Changed functionality

The Virtual Vehicle Composer has changed functionality.

• Custom catalogs can be used only with a Simulink model template.

• Two mapped electric motor models for hybrid and electric vehicles provide support for calibration workflows. On the Data and Calibration tab, for each electric motor, you can specify either:

  • Mapped Motor – Maps the torque envelope versus motor speed and applied voltage, and maps mechanical losses versus motor speed, torque, operating temperature, and voltage. You can modify this motor type by directly importing calibration tables from an .xlsx file.

  • Simple Motor – Maps the torque envelope versus motor speed, and maps mechanical losses versus motor speed and torque. You can modify this motor type by using the motor resize app or by virtual calibration. This is the model used in previous versions.

R2024a: Virtual Vehicle Composer: New functionality

The Virtual Vehicle Composer now allows you to:

• Store Simulink custom components in a custom component catalog for easy retrieval, such as electric motors, IC engines, and batteries.

• Attach a single-axle trailer to a passenger vehicle.

R2023b: Virtual Vehicle Composer: Improved interface and build time and expanded Simscape functionality

The Virtual Vehicle Composer has these improvements:

• Revised parameter descriptions in the Data and Calibration section provide more detail.

• Diagrams supplement parameter descriptions.

• Model build time has been reduced.

• The Simscape Passenger vehicle model template accommodates combined longitudinal and lateral dynamics and incorporates a multibody dual wishbone suspension.

R2023a: Configure motorcycles with Simscape subsystems

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

When you build your virtual vehicle, on the Setup tab, set Model template to Simscape.

The app provides the Simscape subsystem templates for longitudinal vehicle analysis.

R2022b: Configure vehicles with Simscape subsystems

If you have these Simscape products, you can use the Virtual Vehicle Composer app to configure the vehicle plant model with Simscape subsystems.

• Simscape Driveline

• Simscape Electrical

When you build your virtual vehicle, on the Setup tab, set Model template to Simscape.

The app provides the Simscape subsystem templates for longitudinal vehicle analysis.