Motorcycle Chain

R2026b

Implement motorcycle chain

• 

Motorcycle Chain block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Powertrain Blockset / Drivetrain / Couplings
Vehicle Dynamics Blockset / Powertrain / Drivetrain / Couplings

Description

The Motorcycle Chain block implements the dynamic effects of a motorcycle chain on the Motorcycle Body Longitudinal In-Plane block

This figure shows how the chain relates geometrically to the motorcycle frame, rear arm, and rear wheel.

Frame	Variable in Figure	Description
Motorcycle main frame iFrm – Forward along vector normal to front fork steer axis kFrm – Downward normal to iFrm jFrm – Orthogonal to motorcycle plane	OFrm	Main frame origin

Examples

Longitudinal Motorcycle Braking Test Reference Application

Simulate an in-plane motorcycle model undergoing a braking test. Use for motorcycle dynamics ride and handling analysis and chassis controls development.

• Open Script

Ports

Input

MDshft — Drive shaft moment on front sprocket

scalar

Drive shaft moment on front sprocket about y_m, in N·m.

FCpR — Longitudinal and vertical forces at rear wheel contact patch

vector

Longitudinal and vertical forces at rear wheel contact patch O_CpR, along i_CpR and k_CpR, in N. Signal vector dimensions are [1x2] or [2x1].

ThetaFrm — Main frame pitch angle

scalar

Main frame pitch angle, ϴ_frm, in rad.

ThetaArmR — Rear arm pitch angle

scalar

Rear arm pitch angle, ϴ_ra, in rad.

MBrkR — Brake moment at rear wheel

scalar

Brake moment at the rear wheel G_WhlRr, about j_WhlRr, in N·m.

AngAWhlR — Rear wheel angular acceleration

scalar

Rear wheel angular acceleration, in rad/s².

Output

Info — Bus signal

bus

Bus signal containing these block calculations.

Signal	Description	Units
FChn	Chain force applied to rear arm	N
AngVSprtR	Angular velocity of rear sprocket	rad/s
MDrvSprtR	Wheel hub damper moment applied to rear sprocket	N·m
WhlDmpAng	Angle between rear sprocket and rear wheel	rad

MDrvSprtR — Wheel hub damper moment at rear sprocket

scalar

Wheel damper moment applied to rear sprocket, in N·m.

MDrvArmR — Drive chain moment at rear arm

scalar

Drive chain moment at rear arm O_ArmRr, about j_ArmRr, in N·m.

MDrvFrm — Drive chain moment at frame

scalar

Drive chain moment at the frame O_Frm, about j_Frm, in N·m.

Parameters

This figure shows how the chain relates geometrically to the motorcycle frame, rear arm, and rear wheel.

Front Sprocket

Coordinates, SprktFrPxz — Front sprocket position

[0.05 -0.05] (default) | vector

Position of front sprocket, SprktFrPxz, along x_m z_m, respectively, in m.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktFrPxz
Values:	[0.05 -0.05] (default) | vector
Data Types:	double

Mass moment of inertia, SprktFrIyy — Front sprocket inertia

0.005 (default) | scalar

Front sprocket mass moment of inertia, SprktFrIyy, in kg·m².

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktFrIyy
Values:	0.005 (default) | scalar
Data Types:	double

Radius, SprktFrR — Front sprocket radius

0.04 (default) | scalar

Front sprocket radius, SprktFrR, in m.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktFrR
Values:	0.04 (default) | scalar
Data Types:	double

Rear Sprocket

Mass moment of inertia, SprktRrIyy — Rear sprocket inertia

0.01 (default) | scalar

Rear sprocket mass moment of inertia, SprktRrIyy, in kg·m².

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktRrIyy
Values:	0.01 (default) | scalar
Data Types:	double

Radius, SprktRrR — Rear sprocket radius

0.12 (default) | scalar

Rear sprocket radius, SprktRrR, in m.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktRrR
Values:	0.12 (default) | scalar
Data Types:	double

Rear Wheel

Mass moment of inertia, WhlRrIyy — Rear wheel inertia

0.66 (default) | scalar

Rear wheel mass moment of inertia, WhlRrIyy, in kg·m².

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlRrIyy
Values:	0.66 (default) | scalar
Data Types:	double

Radius, WhlRrR — Rear wheel radius

0.33 (default) | scalar

Rear wheel radius, WhlRrR, in m.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlRrR
Values:	0.33 (default) | scalar
Data Types:	double

Swing Arm

Arm length, ArmRrLen — Swing arm length

0.535 (default) | scalar

Arm length, ArmRrLen, in m.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	ArmRrLen
Values:	0.535 (default) | scalar
Data Types:	double

Wheel Hub Damper

Stiffness, WhlDmpK — Wheel hub damper stiffness

1e4 (default) | scalar

Wheel hub damper stiffness, WhlDmpK, in N/rad.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlDmpK
Values:	1e4 (default) | scalar
Data Types:	double

Damping, WhlDmpC — Wheel hub damper damping

1e2 (default) | scalar

Wheel hub damper damping, WhlDmpC, in N·s/rad.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlDmpC
Values:	1e2 (default) | scalar
Data Types:	double

Equilibrium angle, WhlDmpAng0 — Wheel hub damper equilibrium angle

-15e-3 (default) | scalar

Wheel hub damper equilibrium angle, WhlDmpAng0, in rad.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlDmpAng0
Values:	-15e-3 (default) | scalar
Data Types:	double

Initial Conditions

Rear sprocket angular velocity, SprktRrAngV0 — Angular velocity

0 (default) | scalar

Rear sprocket angular velocity, SprktRrAngV0, in rad/s.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	SprktRrAngV0
Values:	0 (default) | scalar
Data Types:	double

Rear wheel angular velocity, WhlRrAngV0 — Angular velocity

0 (default) | scalar

Rear wheel angular velocity, WhlRrAngV0, in rad/s.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	WhlRrAngV0
Values:	0 (default) | scalar
Data Types:	double

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"autolibcoupling/Motorcycle Chain"

"vdynlib/Powertrain/Drivetrain/Couplings/Motorcycle Chain"

Example: add_block("autolibcoupling/Motorcycle Chain","myModel/myBlock",MakeNameUnique="on")

For information about programmatic access to individual block parameters, see the Programmatic Use section of parameter descriptions on this page.

References

[1] Giner, David Moreno. “Symbolic-Numeric Tools for the Analysis of Motorcycle Dynamics. Development of a Virtual Rider for Motorcycles Based on Model Predictive Control.” PhD diss., Universidad Miguel Hernández de Elche, 2016.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2021b