Main Content

Configure Virtual Vehicle Data

Use the Virtual Vehicle Composer app to configure your virtual vehicle. First, specify the vehicle architecture, dynamics model, chassis, powertrain, driver, and environment. For each selection, enter the vehicle parameter data. For this example, configure an electric vehicle (EV).

In the Virtual Vehicle Composer app, on the Composer tab, click New. The app opens a default virtual vehicle template and creates virtual vehicle project files.

Virtual Vehicle Composer app configuration vehicle data tab

Vehicle Architecture and Vehicle Model

To configure the vehicle architecture and vehicle model for your virtual vehicle, on the Vehicle Data tab, set:

  1. PassengerCar > Vehicle Architecture. By default, Vehicle Architecture is set to Conventional Vehicle. For this example, set it to Electric Vehicle.

  2. PassengerCar > Vehicle Model. For this example, set Vehicle Model to Longitudinal Vehicle Dynamics to configure a model suitable for drive cycle analysis.

    • On the Vehicle Data tab, enter the vehicle dynamics parameter data for your virtual vehicle, including:

      • PIntVehMass — Vehicle mass

      • PlntVehCGHgtAxl — Vertical distance from center of mass to axle plane

      • PlntVehInitLongVel — Initial longitudinal velocity

      For this example, use the default parameter values.

Note

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

Chassis

Use the Chassis parameters to select the tire, brake type, steering system, and suspension systems for your virtual vehicle. The available options depend on your Vehicle Architecture and Vehicle Model parameter settings.

For this example, under PassengerCar > Chassis, set:

  1. Tire to Longitudinal Tire to configure a tire model suitable for drive cycle analysis.

    • On the Vehicle Data tab, enter the tire data for your virtual vehicle, including:

      • PlntWhlLdRadius — Loaded radius

      • PlntWhlMass — Wheel mass

      For this example, use the default parameter values.

  2. Brake Type to Disc.

    • On the Vehicle Data tab, enter the tire data for your virtual vehicle, including:

      • PlntBrkStcFricCff — Static friction coefficient

      • PlntBrkKinFricCff — Kinetic friction coefficient

      For this example, use the default parameter values.

Powertrain

Use the Powertrain parameters to select the engine, transmission, drivetrain, differential system, and electrical system parameters for your virtual vehicle. The available options depend on your Vehicle Architecture and Vehicle Model parameter settings.

For this example, under PassengerCar > Powertrain, set:

  1. Drivetrain to One Actuator Input.

  2. Differential to Open Differential.

  3. Electrical System to Electrical System 1EM BEV Ideal Voltage Source.

    • Use the Electrical Machine parameters to specify a mapped motor and drive electronics operating in torque-control model, including:

      • PlntEM1Spd — Vector of rotational speeds

      • PlntEM1EffTbl — Corresponding efficiency

    • Use the Energy Storage parameters to specify a datasheet battery model for lithium-ion battery, including:

      • PlntBattOpenCirctVolt — Open circuit voltage table data

      • PlntBattVoltSocBpt — Open circuit voltage breakpoints

  4. Vehicle Control Unit to EV 1EM.

Driver

Use the Driver parameter to select the driver. The available options depend on your Vehicle Architecture and Vehicle Model parameter settings.

For this example, set PassengerCar > Driver to Longitudinal Driver to implement a driver suitable for drive-cycle tracking.

  • On the Vehicle Data tab, enter the tire data for your driver, including:

    • DriverAeroRes — Aerodynamic drag coefficient

    • DriverDrivelineRes — Rolling and driveline resistance coefficient

    For this example, use the default parameter values.

Environment

Use the Environment parameter to select the driver. For this example, set PassengerCar > Environment to Standard Ambient.

  • On the Vehicle Data tab, enter the tire data for your driver, including:

    • EnvAirTemp — Ambient air temperature

    • EnvWindVelX — Ambient wind velocity in X direction

    For this example, use the default parameter values.

After completing this step, see Configure Virtual Vehicle Scenario and Test.

See Also

Related Topics