crop

Remove data from tireData object

Since R2024a

Syntax

obj = crop(obj, criteria)

Description

This function requires Extended Tire Features for Vehicle Dynamics Blockset.

obj = crop(obj, criteria) removes tire data using the criteria specified by criteria from the tireData object specified by obj.

Examples

collapse all

Crop Imported Tire Data

This example uses:

Open Live Script

Use the crop function to remove tire data from tireData objects using these input criteria options:

Logical vector
Numeric vector
MATLAB® expression

Import and View Tire Measurement Data

Import tire measurement data into a tireData object, td.

td = tireData("example_data.tdx");

Multiple Fz conditions are included in the data. Use the split function to separate the data by elapsed time et, resulting in eight tireData objects.

td = split(td,"et");

Use the plot function to view the lateral force versus the slip angle using the normal force to assign colors and legend values.

plot(td, DataVariableNames=["alpha","Fy"],ColorBy="Fz");

Crop Data Using Logical Vector

Create a logical vector using true values to indicate the indices of the data to remove. The logical vector must be the same length as the data channel vectors in each tireData object.

tf = false(length(td(1).alpha),1);
tf(end-19:end) = true;

Use the crop function to remove the data at the indices indicated by the logical vector tf.

tdCrop = crop(td,tf);

Plot Result

Plot the resulting tireData objects in tdCrop to visualize the modified data set.

plot(tdCrop,DataVariableNames=["alpha","Fy"],ColorBy="Fz");

Crop Data Using Numeric Vector

Create a numeric vector using integer values to indicate the indices of the data to remove.

idx = find(tf);

Use the crop function to remove the data at the indices indicated by the integer vector idx.

tdCrop = crop(td,idx);

Plot Result

Plot the resulting tireData objects in tdCrop to visualize the modified data set.

plot(tdCrop,DataVariableNames=["alpha","Fy"],ColorBy="Fz");

Crop Data Using MATLAB Expression

Create a MATLAB expression string using data channel names to define the data to crop. This approach is useful when arrays of tireData objects have various lengths for data channels.

expression = "abs(alpha) > deg2rad(10)";

Use the crop function to remove the data that results in the MATLAB expression expression evaluating to true.

tdCrop = crop(td,expression);

Plot Result

Plot the resulting tireData objects in tdCrop to visualize the modified data set.

plot(tdCrop,DataVariableNames=["alpha","Fy"],ColorBy="Fz");

Input Arguments

collapse all

`obj` — Tire data
`tireData` object | array of `tireData` objects

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

`criteria` — Criteria to remove tire data
logical vector | integer vector | string scalar

Criteria to remove tire data, specified as one of these values:

Logical vector — true values indicate the indices to remove from the data channel vectors in tireData objects. The logical vector must be the same length as the data channel vectors in each tireData object.
Integer vector — Integer values indicate the indices to remove from the data channel vectors in tireData objects.
String scalar — Provide a MATLAB expression using tire data channels. Data that results in the MATLAB expression evaluating to true is removed. Tire data channels must be a property of the tireData object. See tireData Properties.

Example: "abs(alpha)>deg2rad(10)" crops all tire data where the absolute value of alpha is less than 0.

Note

You cannot define workspace variables as a string in the criteria input. To use workspace variable values, concatenate the criteria string with the variable value prior to executing the crop function.

Data Types: int8 | int16 | int32 | int64 | logical | string