coordinateTransform

R2026b

Perform coordinate transformation on tire data channels

Since R2023b

collapse all in page

    Syntax

    objTransformed = coordinateTransform(obj, outCoord)

    Description

    Add-On Required: This feature requires the Extended Tire Features for Vehicle Dynamics Blockset add-on.

    objTransformed = coordinateTransform(obj, outCoord) transforms the data channels in the tireData object specified by obj. The function converts from the coordinate system stored in the CoordinateSystem property to the coordinate system specified by outCoord.

    example

    Examples

    collapse all

    Transform tire data from ISO to SAE coordinate system.

    Generate synthetic tire data with lateral force values. The function creates the data in ISO coordinates by default.

    td = tireData.generate("Ramp", ...
    direction="alpha", ...
    initialValue=-0.15, ...
    finalValue=0.15, ...
    Fz=4000, ...
    kappa=0, ...
    gamma=0, ...
    Vx=16.7, ...
    IP=220000);

    Check the coordinate system and the first lateral force value in ISO convention.

    td.CoordinateSystem
td.alpha(1)
    ans = "ISO"
ans = -0.15

    Transform the tire data to SAE coordinates. In SAE convention, the lateral force sign has the opposite orientation relative to ISO.

    tdSAE = coordinateTransform(td,"SAE");
tdSAE.CoordinateSystem
tdSAE.alpha(1)
    ans = "SAE"
ans = 0.15

    The lateral force value has changed sign, reflecting the different axis orientation defined by the SAE coordinate system.

    Input Arguments

    collapse all

    Tire data, specified as a tireData object or an array of tireData objects.

    Output coordinate system, specified as "ISO", "SAE", or "H". For more information, see Tire and Wheel Coordinate Systems.

    Example: SAEdata = coordinateTransform(ISOdata, "SAE")

    Data Types: string

    Output Arguments

    collapse all

    Transformed tire data, returned as a tireData object or an array of tireData objects.

    Version History

    Introduced in R2023b

    See Also

    |