Main Content

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, define 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.

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

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

Step

Section

Button

Description

1

Configure

Virtual Vehicle data icon

Setup

Specify:

  • Vehicle class

  • Powertrain architecture

  • Model template

  • Vehicle dynamics

  • Project path

  • Configuration name

  • Custom component catalog

Click Confirm Setup.

Note

Except for Configuration name, the selections on the Setup pane cannot be changed once you click Confirm Setup.

2

Virtual Vehicle data icon

Data and Calibration

Specify the chassis, steering, suspension, tires, brakes, powertrain, driver/rider, and environment. For each selection, enter the parameter data.

3

Virtual Vehicle scenario icon

Scenario and Test

Construct a test plan including one or more virtual vehicle test scenarios. Options include drive cycles for evaluating fuel economy and energy management, and vehicle handling maneuvers.

4

Virtual Vehicle data logging icon

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 icon

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

Virtual Vehicle operate icon

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

Virtual Vehicle analyze icon

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.

Required Products

The Virtual Vehicle Composer requires either of these products:

If you have Simscape and these Simscape add-ons, you can use the app to configure vehicles with Simscape subsystems:

Virtual Vehicle Composer Passenger vehicle Data and Calibration pane

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 flowchart shows the steps to follow to configure, build, and test a vehicle with the Virtual Vehicle Composer app.

Workflow steps for the Virtual Vehicle Composer app

Setup

Start here to enter your virtual vehicle class, powertrain architecture, model template, and vehicle dynamics.

Specify the vehicle type.

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Passenger vehicle icon

Passenger vehicle

Four-wheeled passenger vehicle.

Motorcycle icon

Motorcycle

 

Two-wheeled motorcycle.

Requires Simscape.

Dependencies

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 MultibodyRequired for motorcycles

Specify a Simulink or Simscape vehicle plant model and powertrain architecture. For Passenger vehicle, the default template is Simulink.

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 MultibodyRequired 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.

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

Provide a brief identifier for each vehicle and test configuration.

Note

The combined Project path and Configuration name must be less than 80 characters.

Data Types: char

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Note

To refer back to your Powertrain architecture diagram, click the Setup tab. You will see the configuration of the system, including motor placements.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Conventional Vehicle

Vehicle with an SI or CI internal combustion engine, transmission, and corresponding control units. May be FWD, RWD, or AWD.

Electric Vehicle 1EM

Vehicle with one electric motor, battery, driveline, and corresponding control units. May be FWD, RWD, or AWD.

Electric Vehicle 2EM

 

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

 

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

 

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

 

Vehicle with one independent motor driving each wheel; battery, and corresponding control units. May be FWD, RWD, or AWD.

Hybrid Electric Vehicle P0

 

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

 

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

 

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

 

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

 

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

 

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

 

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.

Requires Simscape.

Electric Motorcycle with Chain Drive

 

Motorcycle with an electric motor, gear and chain/belt drive reductions, battery, and corresponding control units.

Requires Simscape.

Specify the virtual vehicle dynamics.

Vehicle ClassVehicle DynamicsGoals
Passenger vehicle

Longitudinal vehicle dynamics icon

Longitudinal vehicle dynamics

Fuel economy and energy management analysis, and straight-line performance.

Combined longitudinal and lateral vehicle dynamics icon

Combined longitudinal and lateral vehicle dynamics

Vehicle handling, stability, and ride comfort analysis.

Motorcycle

In-plane motorcycle dynamics icon

In-plane motorcycle dynamics

Fuel economy and energy management analysis.

Out-of-plane motorcycle dynamics icon

Out-of-plane motorcycle dynamics

Vehicle handling, stability, and ride comfort analysis.

The virtual vehicle uses the Z-down coordinate system as defined in SAE J670 and ISO 8855. For more information, see Coordinate Systems in Vehicle Dynamics Blockset (Vehicle Dynamics Blockset).

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Longitudinal vehicle dynamics

One or three degree-of-freedom (DOF) passenger vehicle model suitable for fuel economy and energy management analysis.

Combined longitudinal and lateral vehicle dynamics

 

Six-DOF passenger vehicle suitable for vehicle handling, stability, and ride comfort analysis.

In-plane motorcycle 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.

Available if you have Simscape and Simscape add-ons.

Out-of-plane motorcycle dynamics 

Six-DOF motorcycle suitable for vehicle handling, stability, and ride comfort analysis.

Available if you have Simscape and Simscape add-ons.

Catalog of custom components, specified 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 component from Virtual Vehicle Composer that you have reparameterized, or a Simulink model you have imported.

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 chassis and suspension, tires, powertrain, and driver.

Parameters for data and calibration of a passenger vehicle

You can select components from the lists provided in Virtual Vehicle Composer and modify them, or 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 information.

Select one of the options for each component. The available options depend on your Setup selections.

ParameterDescription

Chassis

Select the chassis type. The available options depend on the Vehicle dynamics setting.

Steering System

If you have Vehicle Dynamics Blockset and set Vehicle dynamics to Combined longitudinal and lateral vehicle dynamics, you can specify the steering system.

Front Suspension

Rear Suspension

If you have Vehicle Dynamics Blockset and set Vehicle dynamics to Combined longitudinal and lateral vehicle dynamics, you can specify the suspension.

Front Tire

Rear Tire

Select the tire model and tire data. The available options depend on the Vehicle dynamics setting.

Brake System

Select the brake type and parameters. Use the Brake Control Unit parameter to specify anti-lock brakes and traction control.

PowertrainSelect the engine, electric motors, transmission, drivetrain, differential system, and electrical system parameters. The available options depend on the Powertrain architecture selected.

Thermal

For battery-electric vehicles, select a thermal management system to control component temperatures.

Trailer

Select a One-Axle Trailer.

Driver

Select the Driver model. The available options depend on the Vehicle dynamics setting.

Environment

Set the parameters under Ambient Conditions to specify the operating environment.

Virtual Vehicle Composer app scenario and test tab

Passenger Vehicle Chassis

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Vehicle Body 1DOF Longitudinal

Chassis model for one-DOF longitudinal vehicle dynamics. Available when you set Vehicle dynamics to Longitudinal vehicle dynamics.

Vehicle Body 3DOF Longitudinal

Chassis model for three-DOF vehicle dynamics, allowing longitudinal, vertical, and pitch motions. Available when you set Vehicle dynamics to Longitudinal vehicle dynamics.

Vehicle Body 6DOF Longitudinal and Lateral 

Chassis model for six-DOF longitudinal, lateral, and vertical vehicle dynamics with corresponding rotations. Available when you set Vehicle dynamics to Combined longitudinal and lateral vehicle dynamics.

Dependencies

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

Passenger Vehicle Steering System

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Availability

Kinematic Steering

 

Kinematic steering model. Suitable for Ackerman steering.

Available when you set Chassis 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 Chassis to Vehicle Body 6DOF Longitudinal and Lateral.

Dependencies

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

Passenger Vehicle Front Suspension

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Availability

Kinematics and Compliance Independent Suspension Front

 

Kinematics and compliance (K&C) characteristics of independent front suspension.

Available when you set Chassis 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 Chassis 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 vehicle dynamics.

Passenger Vehicle Rear Suspension

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Availability

Kinematics and Compliance Independent Suspension Rear

 

Kinematics and compliance (K&C) characteristics of independent rear suspension.

Available when you set Chassis to Vehicle Body 6DOF Longitudinal and Lateral.

Solid Axle Rear Suspension

 

Solid rear axle.

Kinematics and Compliance Twist Beam Suspension Rear

 

Kinematics and compliance (K&C) characteristics of twist beam rear suspension.

Simscape Suspension Rear

 

Double-wishbone rear suspension.

Available when you set Model template to Simscape and Chassis 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 vehicle dynamics.

Passenger Vehicle Front Tires

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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 Chassis 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 Chassis 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, at 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 Chassis 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 Tires

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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 Chassis 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 Chassis 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, at 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 Chassis 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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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 information, see Calibrate Mapped SI Engine Using Data.

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

 

Spark-ignition 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.

Not available if you set Model template to Simscape.

SI H2 Engine

 

Spark-ignition 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 information, see Calibrate Mapped SI Engine Using Data.

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.

Not available if you set Model template to Simscape.

CI Mapped Engine

 

Mapped diesel-fueled CI 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 information, see Calibrate Mapped CI Engine Using Data.

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

 

Compression-ignition 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.

InputsOutputs

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:

  1. Set Engine to FMU Engine.

  2. Use Browse to select the FMU file.

  3. 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.

  4. 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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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.

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.

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.

DC-DC Converter provides a bidirectional DC-to-DC converter that supports boost (voltage-increasing) and buck (voltage-reducing) operations. With HVDCPassThrough, 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

Virtual vehicle electric machine settings for motors in each location x as seen on the Powertrain architecture diagram on the Setup pane.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Description

Electric Vehicle 1EM

Maximum torque is mapped vs. motor speed, and mechanical losses are mapped vs. speed and torque. Default parameters for each motor are set by its application.

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

 

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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

Powertrain Architecture

Description

EV 1EM with BMS

Electric Vehicle 1EMControls 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 state of charge (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

Passenger Vehicle Thermal Control 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

Passenger Vehicle Driver

Parameter options depend on the available products. The table summarizes the options for this parameter enabled by Powertrain Blockset and Vehicle Dynamics Blockset.

Setting

Powertrain Blockset

Vehicle Dynamics Blockset

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 vehicle 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 vehicle dynamics.

Dependencies

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

Passenger Vehicle Trailer

Set the parameters under One-Axle Trailer to specify trailer dimensions and inertial properties.

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

Set the parameters under Ambient Conditions to specify the operating environment.

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 parameters, such as chassis and suspension, tires, powertrain, and rider.

Parameters for data and calibration of a motorcycle

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.

ParameterDescription
Chassis

Select the chassis type. The available options depend on the Vehicle dynamics setting.

Steering System

With Vehicle dynamics set to Out-of-plane motorcycle dynamics, you can specify the steering system.

Front Suspension

With Vehicle dynamics set to Out-of-plane motorcycle dynamics, you can specify the front suspension.

Rear Suspension

With Vehicle dynamics set to Out-of-plane motorcycle 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.

Rider

Specify the rider physical model and controller model. The available options depend on the Vehicle dynamics setting.

Environment

Set the parameters under Ambient Conditions to specify the operating environment.

Virtual Vehicle Composer app data and calibration tab

Motorcycle Chassis

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

Setting

Description

In-Plane Model

Models dynamics in the longitudinal/vertical plane.

Available when Vehicle dynamics is set to In-plane motorcycle dynamics.

Out-of-Plane Model

Models dynamics in six degrees of freedom.

Available when Vehicle dynamics is set to Out-of-plane motorcycle dynamics.

Dependencies

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

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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 motorcycle dynamics.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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 motorcycle dynamics.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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 motorcycle dynamics.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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 motorcycle dynamics.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.
MappedBrake 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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.
MappedBrake 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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

Setting

Description

Chain/Belt Drive

Inextensible chain/belt which meshes with front and rear sprockets/pulleys. Rear sprocket/pulley mounts to wheel with a torsional damper.

Dependencies

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

Motorcycle Rider

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.

All vehicles configured with Vehicle class set to Motorcycle require Vehicle Dynamics Blockset and Simscape Multibody.

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.

Environment

Set the parameters under Ambient Conditions to specify the operating environment.

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.

Scenario and test tab on the Virtual Vehicle Composer App

  • Passenger vehicle - For a Passenger vehicle, if you set Vehicle dynamics to Longitudinal vehicle 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 vehicle 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 motorcycle 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 motorcycle 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 (Vehicle Dynamics Blockset).

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.

Logging tab on the Virtual Vehicle Composer App

Build

Click Virtual Vehicle to build your 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.

Build tab on the Virtual Vehicle Composer App

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 Virtual Vehicle operate icon.

Operate tab on the Virtual Vehicle Composer App

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 information, see Run Power Accounting.

Analyze

Click Simulation Data Inspector to view and analyze simulation signals you chose to log during operation.

Analyze tab on the Virtual Vehicle Composer App

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 information, see Simulation Data Inspector.

Programmatic Use

expand all

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

expand all