Main Content

Simulation 3D Motorcycle

Implement motorcycle in 3D environment

  • Library:
  • Vehicle Dynamics Blockset / Vehicle Scenarios / Sim3D / Sim3D Vehicle / Components

  • Simulation 3D Motorcycle block

Description

TheSimulation 3D Motorcycleblock implements a motorcycle with two wheels in the 3D simulation environment.

To use this block, ensure that theSimulation 3D Scene Configurationblock is in your model. If you set theSample timeparameter of this block to-1, the block uses the sample time specified in theSimulation 3D Scene Configurationblock.

The block input uses the vehicle Z-downright-handed(RH)Cartesiancoordinate system defined in SAE J6701. The coordinate system is inertial and initially aligned with the vehicle geometric center:

  • X-axis — Along vehicle longitudinal axis, points forward

  • Y-axis — Along vehicle lateral axis, points to the right

  • Z-axis — Points downward

Tip

Verify that theSimulation 3D Motorcycleblock executes before theSimulation 3D Scene Configurationblock. That way,Simulation 3D Motorcycleprepares the signal data before the Unreal Engine®3D visualization environment receives it. To check the block execution order, right-click each block and selectProperties. On theGeneraltab, confirm thesePrioritysettings:

  • Simulation 3D Scene Configuration0

  • Simulation 3D Motorcycle-1

For more information about execution order, seeControl and Display Execution Order.

Ports

Input

expand all

Motorcycle and component translation, in m. Array dimensions are5-by-3.

  • Translation(1,1),Translation(1,2), and翻译(1、3)— Motorcycle translation along the inertial vehicle Z-downX-,Y-, andZ- axes, respectively.

  • Translation(...,1),Translation(...,2), andTranslation(...,3)— Motorcycle component translation relative to vehicle, along the vehicle Z-downX-,Y-, andZ- axes, respectively.

“社会党国际”gnal contains translation information according to the locations.

T r a n s l a t i o n = [ X v Y v Z v X H Y H Z H X S A Y S A Z S A X F Y F Z F X R Y R Z R ]

Translation Array Element Translation Axis

Motorcycle,Xv

Translation(1,1) Inertial vehicle Z-downX-axis

Motorcycle,Yv

Translation(1,2) Inertial vehicle Z-downY-axis

Motorcycle,Zv

翻译(1、3) Inertial vehicle Z-downZ-axis

Handlebars,XH

Translation(2,1) Vehicle Z-downX-axis

Handlebars,YH

Translation(2,2) Vehicle Z-downY-axis

Handlebars,ZH

Translation(2,3) Vehicle Z-downZ-axis

Swing arm,XSA

Translation(3,1) Vehicle Z-downX-axis

Swing arm,YSA

Translation(3,2) Vehicle Z-downY-axis

Swing arm,ZSA

Translation(3,3) Vehicle Z-downZ-axis

Front wheel,XF

Translation(4,1) Vehicle Z-downX-axis

Front wheel,YF

Translation(4,2) Vehicle Z-downY-axis

Front wheel,ZF

Translation(4,3) Vehicle Z-downZ-axis

Rear wheel,XR

Translation(5,1) Vehicle Z-downX-axis

Rear wheel,YR

Translation(5,2) Vehicle Z-downY-axis

Rear wheel,ZR

Translation(5,3) Vehicle Z-downZ-axis

Vehicle and component rotation, in rad. Array dimensions are5-by-3.

  • Rotation(1,1),Rotation(1,2), andRotation(1,3)— Motorcycle rotation about the inertial vehicle Z-downX-,Y-, andZ- axes, respectively.

  • Rotation(...,1),Rotation(...,2), andRotation(...,3)— Motorcycle component rotation relative to vehicle, about the vehicle Z-downX-,Y-, andZ- axes, respectively.

“社会党国际”gnal contains rotation information according to the locations.

R o t a t i o n = [ R o l l v P i t c h v Y a w v R o l l H P i t c h H Y a w H R o l l S A P i t c h S A Y a w S A R o l l F P i t c h F Y a w F R o l l R P i t c h R Y a w R ]

Rotation Array Element Rotation Axis

Vehicle,Rollv

Rotation(1,1) Inertial vehicle Z-downX-axis

Vehicle,Pitchv

Rotation(1,2) Inertial vehicle Z-downY-axis

Vehicle,Yawv

Rotation(1,3) Inertial vehicle Z-downZ-axis

Handlebar,RollH

Rotation(2,1) Vehicle Z-downX-axis

Handlebar,PitchH

Rotation(2,2) Vehicle Z-downY-axis

Handlebar,YawH

Rotation(2,3) Vehicle Z-downZ-axis

Swing arm,RollSA

Rotation(3,1) Vehicle Z-downX-axis

Swing arm,PitchSA

Rotation(3,2) Vehicle Z-downY-axis

Swing arm,YawSA

Rotation(3,3) Vehicle Z-downZ-axis

Front wheel,RollF

Rotation(4,1) Vehicle Z-downX-axis

Front wheel,PitchF

Rotation(4,2) Vehicle Z-downY-axis

Front wheel,YawF

Rotation(4,3) Vehicle Z-downZ-axis

Rear wheel,RollR

Rotation(5,1) Vehicle Z-downX-axis

Rear wheel,PitchR

Rotation(5,2) Vehicle Z-downY-axis

Rear wheel,YawR

Rotation(5,3) Vehicle Z-downZ-axis

Light controls input signal, specified as a 1-by-5 Boolean vector. Each element of the vector turns a specific vehicle light on or off, as indicated in this table. A value of 1 turns the light on; a value of 0 turns the light off

Vector Element Vehicle Light

(1,1)

Headlight high beam

(1,2)

Headlight low beam

(1,3)

Brake

(1,4)

Left signal

(1,5)

Right signal

Dependencies

To create this port, on theLight Controlstab, selectEnable light controls.

Data Types:Boolean

Parameters

expand all

Vehicle Parameters

Use theTypeparameter to specify the motorcycle type. This table provides links to the motorcycle dimensions.

Vehicle TypeSetting Vehicle Dimensions
Sports bike

Sports Bike

Motor bike

Motor Bike

Scooter

Scooter

Select the color of the vehicle.

Name of motorcycle. By default, when you use the block in your model, the block sets theNameparameter toSimulinkVehicleX. The value ofXdepends on the number of 3D simulation blocks that you have in your model.

Sample time,Ts. The graphics frame rate is the inverse of the sample time.

Light Controls

Select whether to control the vehicle headlights. Use the enabled parameters to set the light parameters, including headlight intensity.

Dependencies

Selecting this parameter:

  • Creates the input portLight controls

  • Enables these light parameters.

    Lights Light Parameters
    Headlights

    • Headlight color

    • High beam intensity

    • Low beam intensity

    • High beam cone half angle

    • Low beam cone half angle

    • Left headlight beam orientation

    • Right headlight beam orientation

    Brake lights

    Brake light intensity

    Turn signal lights

    • Turn signal light intensity

    • Period

    • Pulse width

Headlights

Headlight color, specified as a normalized 1-by-3 vector of RGB triplet values.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:int8|uint8

High beam intensity, in cd.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Low beam intensity, in cd.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

High beam cone half angle, in rad.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Low beam cone half angle, in rad.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Pitch and yaw orientation of the left headlight beam orientation in theZ-down coordinate system, specified as a 1-by-2 vector, in rad. The first element of the vector,[1,1], is the pitch angle. The second element of the vector,[1,2]is the yaw angle.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Pitch and yaw orientation of the right headlight beam orientation in theZ-down coordinate system, specified as a 1-by-2 vector, in rad. The first element of the vector,[1,1], is the pitch angle. The second element of the vector,[1,2]is the yaw angle.

Dependencies

To enable this parameter, selectEnable light controls.

Brake Lights

Brake light intensity, in cd/m^2.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Turn Signal Lights

Turn signal light intensity, in cd/m^2.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Turn signal light period, in s.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Turn signal light pulse width, as a percent of the period.

Dependencies

To enable this parameter, selectEnable light controls.

Data Types:double

Initial Values

最初的摩托车和组件的翻译,在m. Array dimensions are5-by-3.

  • Translation(1,1),Translation(1,2), and翻译(1、3)— Initial vehicle translation along the inertial vehicle Z-down coordinate systemX-,Y-, andZ- axes, respectively.

  • Translation(...,1),Translation(...,2), andTranslation(...,3)— Initial motorcycle component translation relative to vehicle, along the vehicle Z-downX-,Y-, andZ- axes, respectively.

The parameter contains translation information according to the locations.

T r a n s l a t i o n = [ X v Y v Z v X H Y H Z H X S A Y S A Z S A X F Y F Z F X R Y R Z R ]

Translation Array Element Translation Axis

Motorcycle,Xv

Translation(1,1) Inertial vehicle Z-downX-axis

Motorcycle,Yv

Translation(1,2) Inertial vehicle Z-downY-axis

Motorcycle,Zv

翻译(1、3) Inertial vehicle Z-downZ-axis

Handlebars,XH

Translation(2,1) Vehicle Z-downX-axis

Handlebars,YH

Translation(2,2) Vehicle Z-downY-axis

Handlebars,ZH

Translation(2,3) Vehicle Z-downZ-axis

Swing arm,XSA

Translation(3,1) Vehicle Z-downX-axis

Swing arm,YSA

Translation(3,2) Vehicle Z-downY-axis

Swing arm,ZSA

Translation(3,3) Vehicle Z-downZ-axis

Front wheel,XF

Translation(4,1) Vehicle Z-downX-axis

Front wheel,YF

Translation(4,2) Vehicle Z-downY-axis

Front wheel,ZF

Translation(4,3) Vehicle Z-downZ-axis

Rear wheel,XR

Translation(5,1) Vehicle Z-downX-axis

Rear wheel,YR

Translation(5,2) Vehicle Z-downY-axis

Rear wheel,ZR

Translation(5,3) Vehicle Z-downZ-axis

Initial motorcycle and component rotation, about the vehicle Z-downX-,Y-, andZ- axes.

Array dimensions are5-by-3.

  • Rotation(1,1),Rotation(1,2), andRotation(1,3)— Initial motorcycle rotation about the inertial vehicle Z-down coordinate systemX-,Y-, andZ- axes, respectively.

  • Rotation(...,1),Rotation(...,2), andRotation(...,3)— Initial motorcycle component rotation relative to vehicle, about the vehicle Z-downX-,Y-, andZ- axes, respectively.

The parameter contains rotation information according to the location.

R o t a t i o n = [ R o l l v P i t c h v Y a w v R o l l F L P i t c h F L Y a w F L R o l l F R P i t c h F R Y a w F R R o l l R L P i t c h R L Y a w R L R o l l R R P i t c h R R Y a w R R ]

Rotation Array Element Rotation Axis

Vehicle,Rollv

Rotation(1,1) Inertial vehicle Z-downX-axis

Vehicle,Pitchv

Rotation(1,2) Inertial vehicle Z-downY-axis

Vehicle,Yawv

Rotation(1,3) Inertial vehicle Z-downZ-axis

Handlebar,RollH

Rotation(2,1) Vehicle Z-downX-axis

Handlebar,PitchH

Rotation(2,2) Vehicle Z-downY-axis

Handlebar,YawH

Rotation(2,3) Vehicle Z-downZ-axis

Swing arm,RollSA

Rotation(3,1) Vehicle Z-downX-axis

Swing arm,PitchSA

Rotation(3,2) Vehicle Z-downY-axis

Swing arm,YawSA

Rotation(3,3) Vehicle Z-downZ-axis

Front wheel,RollF

Rotation(4,1) Vehicle Z-downX-axis

Front wheel,PitchF

Rotation(4,2) Vehicle Z-downY-axis

Front wheel,YawF

Rotation(4,3) Vehicle Z-downZ-axis

Rear wheel,RollR

Rotation(5,1) Vehicle Z-downX-axis

Rear wheel,PitchR

Rotation(5,2) Vehicle Z-downY-axis

Rear wheel,YawR

Rotation(5,3) Vehicle Z-downZ-axis

References

[1] Vehicle Dynamics Standards Committee.Vehicle Dynamics Terminology J670. Warrendale, PA: SAE International, 2008.

Version History

Introduced in R2021b