Road Profile

Road profile with varying elevation and friction properties

  • Library:
  • Simscape / Driveline / Tires & Vehicles

  • Road Profile block

Description

The Road Profile block represents a road profile with varying elevation and friction properties. As a vehicle travels, the axle parameters and the position of the center of gravity (CG) determine the position of the front and rear axles. The block uses the axle positions to compute vehicle angle and, optionally, tire friction coefficients. The block models friction using either Magic Formula or kinetic and static friction coefficients.

Variables

Use the Variables tab to set the priority and initial target values for the block variables before simulating. For more information, see Set Priority and Initial Target for Block Variables.

Unlike block parameters, variables do not have conditional visibility. The Variables tab lists all the existing block variables. If a variable is not used in the set of equations corresponding to the selected block configuration, the values specified for this variable are ignored.

Ports

Conserving

expand all

Conserving port associated with the horizontal motion. Connect to the H port of the Vehicle Body block.

Output

expand all

Physical signal output port for the friction coefficients of the front axle.

The vector contains four elements for the Magic Formula friction model or two elements for the friction coefficients friction model. Connect to the M port of a front axle Tire (Friction Parameterized) or Tire (Magic Formula) block.

This port is visible only when the Friction output parameter is set to one of these values:

  • Physical signal Magic Formula coefficients

  • Physical signal friction coefficients

Physical signal output port for the friction coefficients of the rear axle.

The vector contains four elements for the Magic Formula friction model or two elements for the friction coefficients friction model. Connect to the M port of a rear axle Tire (Friction Parameterized) or Tire (Magic Formula) block.

Dependencies

This port is visible only when the Friction parameter Friction output is set to one of these values:

  • Physical signal Magic Formula coefficients

  • Physical signal friction coefficients

Physical signal output port for the vehicle angle.

Parameters

expand all

Main

Horizontal distance from the center of gravity (CG) to the front axle. Specify the same value as is specified for the Horizontal distance from CG to front axle parameter of the connected Vehicle Body block.

Horizontal distance from the center of gravity (CG) to the rear axle. Specify the same value as is specified for the Horizontal distance from CG to rear axle parameter of the connected Vehicle Body block.

Table lookup corresponding to the distance that the CG of the vehicle moves relative to the reference frame x-axis. For example the figure shows a horizontal profile of [-10, 0, 10]. Table lookup extrapolation is nearest.

Table lookup corresponding to the distance that the CG of the vehicle moves relative to the reference frame y-axis. For example the figure shows a vertical profile of [2, 0, 5]. Table lookup extrapolation is nearest.

Friction

Type of friction coefficient that the block outputs. Select Physical signal Magic Formula coefficients to vary friction for Tire (Magic Formula) blocks. Select Physical signal friction coefficients to vary friction for Tire (Friction Parameterized) blocks.

Dependencies

Setting this parameter to Physical signal Magic Formula coefficients or Physical signal friction coefficients makes the MF and MR ports and associated Friction parameters visible.

Friction profile horizontal distance.

Dependencies

This parameter is visible only when the Friction parameter Friction output is set to one of these values:

  • Physical signal Magic Formula coefficients

  • Physical signal friction coefficients

Magic Formula coefficients specified as an n-by-4 matrix, where n is the number of points in the vector specified by the Horizontal distance for friction profile parameter.

Dependencies

This parameter is visible only when the Friction parameter Friction output is set to Physical signal Magic Formula coefficients.

Magic Formula coefficients specified as an n-by-4 matrix, where n is the number of points in the vector specified by the Horizontal distance for friction profile parameter.

Dependencies

This parameter is visible only when the Friction parameter Friction output is set to Physical signal Magic Formula coefficients.

Front axle static and kinetic friction coefficients specified as an n-by-2 matrix, where n is the number of points in the vector specified by the Horizontal distance for friction profile parameter.

Dependencies

This parameter is visible only when the Friction parameter Friction output is set to Physical signal friction coefficients.

Rear axle static and kinetic friction coefficients specified as an n-by-2 matrix, where n is the number of points in the vector specified by the Horizontal distance for friction profile parameter.

Dependencies

This parameter is visible only when the Friction parameter Friction output is set to Physical signal friction coefficients.

Extended Capabilities

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

Introduced in R2019a