plot
R2026bDescription
Add-On Required: This feature requires the Extended Tire Features for Vehicle Dynamics Blockset add-on.
plot(___, specifies
additional options using one or more name-value arguments. For example, to show a legend on
a plot, set Name=Value)ShowLegend to true.
Examples
Use the plot function to visually inspect data stored in tireData objects. First, import the tire data from Tyre Data Exchange Format (TYDEX) v1.3 files. Then, specify arguments in the plot function to customize different plot views.
This example requires the Extended Tire Features for Vehicle Dynamics Blockset™ support package. See Install Support Package.
Import Tire Data
Build a string array from the TYDEX filenames that contain the tire data.
tirepath = fullfile(pwd); tydexdir = dir(fullfile(tirepath,"data_tydex_files","*.tdx")); tydexstr = join([{tydexdir.folder}',{tydexdir.name}'],filesep);
Import the tire data into an array of tireData objects from the files specified in the string array tydexstr. The length of the tireData objects array is the same length as the input string array. Data from each file is stored in a tireData object. For more information on tire data permitted, see Example Tire Data.
td = tireData(tydexstr);
Autoplot Tire Data
Plot the array of tireData objects without specifying input arguments. If you do not specify the input argument DataVariableNames, the plot function automatically generates plots common for the test procedure associated with the data.
Note that not all tire test types are supported.
plot(td)
![Figure contains 72 axes objects and another object of type uitabgroup. Axes object 1 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5190, 6500. Axes object 2 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5190, 6500. Axes object 3 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5190, 6500. Axes object 4 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5190, 6500. Axes object 5 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5180, 6480. Axes object 6 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5180, 6480. Axes object 7 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5180, 6480. Axes object 8 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5180, 6480. Axes object 9 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 10 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 11 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 12 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 13 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 14 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 15 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 16 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 17 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 18 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 19 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 20 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 21 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 22 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 23 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 24 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 25 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 26 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 27 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 28 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4310, 5180, 6480. Axes object 29 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 30 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 31 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 32 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500. Axes object 33 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4340, 5210, 6510. Axes object 34 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4340, 5210, 6510. Axes object 35 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4340, 5210, 6510. Axes object 36 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4340, 5210, 6510. Axes object 37 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4320, 5170, 6480. Axes object 38 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4320, 5170, 6480. Axes object 39 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4320, 5170, 6480. Axes object 40 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4320, 5170, 6480. Axes object 41 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5190, 6490. Axes object 42 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5190, 6490. Axes object 43 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5190, 6490. Axes object 44 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5190, 6490. Axes object 45 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4350, 5210, 6510. Axes object 46 with title Fy vs kappa, xlabel Longitudinal slip [], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4350, 5210, 6510. Axes object 47 with title Mz vs kappa, xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4350, 5210, 6510. Axes object 48 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2170, 4350, 5210, 6510. Axes object 49 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5170, 6460. Axes object 50 with xlabel Longitudinal slip [], ylabel Lateral force [N] contains an object of type text. Axes object 51 with xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains an object of type text. Axes object 52 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5170, 6460. Axes object 53 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4280, 5170, 6460. Axes object 54 with xlabel Longitudinal slip [], ylabel Lateral force [N] contains an object of type text. Axes object 55 with xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains an object of type text. Axes object 56 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4280, 5170, 6460. Axes object 57 with title Fx vs kappa, xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4310, 5170, 6460. Axes object 58 with xlabel Longitudinal slip [], ylabel Lateral force [N] contains an object of type text. Axes object 59 with xlabel Longitudinal slip [], ylabel Self-aligning moment [Nm] contains an object of type text. Axes object 60 with title Mx vs kappa, xlabel Longitudinal slip [], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4310, 5170, 6460. Axes object 61 with title Fy vs alpha, xlabel Slip angle [rad], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 62 with title Mz vs alpha, xlabel Slip angle [rad], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 63 with title Mx vs alpha, xlabel Slip angle [rad], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6460. Axes object 64 with title Fy vs alpha, xlabel Slip angle [rad], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4270, 5160, 6460. Axes object 65 with title Mz vs alpha, xlabel Slip angle [rad], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4270, 5160, 6460. Axes object 66 with title Mx vs alpha, xlabel Slip angle [rad], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4270, 5160, 6460. Axes object 67 with title Fy vs alpha, xlabel Slip angle [rad], ylabel Lateral force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6450. Axes object 68 with title Mz vs alpha, xlabel Slip angle [rad], ylabel Self-aligning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6450. Axes object 69 with title Mx vs alpha, xlabel Slip angle [rad], ylabel Overturning moment [Nm] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4300, 5160, 6450. Axes object 70 with title Friction Plot gamma = 0.105, xlabel Lateral force [kN], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2140, 4310, 5180, 6480. Axes object 71 with title Friction Plot gamma = 0, xlabel Lateral force [kN], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2150, 4320, 5190, 6490. Axes object 72 with title Friction Plot gamma = -0.105, xlabel Lateral force [kN], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6490.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_01.png)
Plot Tire Data Channels
You can plot a single or multiple tireData objects, assign colors, and legend values to plots and plot filtered tire data.
Plot a Single tireData Object
Specifying the input argument DataVariableNames, plot the longitudinal force versus the longitudinal slip of a single tireData object.
plot(td(1),DataVariableNames=["kappa","Fx"]);
![Figure contains an axes object. The axes object with title Longitudinal force [kN] vs Longitudinal slip [], xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains a line object which displays its values using only markers. This object represents 0.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_02.png)
Plot Multiple tireData Objects
Specifying the input argument DataVariableNames, plot the longitudinal force versus the longitudinal slip of multiple tireData objects.
plot(td(1:2),DataVariableNames=["kappa","Fx"]);
![Figure contains an axes object. The axes object with title Longitudinal force [kN] vs Longitudinal slip [], xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains a line object which displays its values using only markers. This object represents 0.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_03.png)
Assign Colors and Legend Values to Plot
Specifying the input arguments DataVariableNames and ColorBy, plot the longitudinal force versus the longitudinal slip of multiple tireData objects using the normal force to assign colors and legend values to the plot.
Note that the mean value of Fz is used to assign the legend values, which are rounded with the mean values of other tireData objects.
plot(td(1:8),DataVariableNames=["kappa","Fx"],ColorBy="Fz");
![Figure contains an axes object. The axes object with title Longitudinal force [kN] vs Longitudinal slip [], xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent 2160, 4330, 5200, 6500.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_04.png)
Plot a Subset of Tire Data
Specifying the input arguments DataVariableNames, ColorBy, FilterBy, and FilterByValues, plot the longitudinal force versus the longitudinal slip of multiple tireData objects. Use the inclination angle to assign colors and legend values to the plot. Filter by the normal force values of 4000 and 5000.
plot(td(1:24),DataVariableNames=["kappa","Fx"],ColorBy="gamma", ... FilterBy="Fz",FilterByValues={[4000,5000]});
![Figure contains an axes object. The axes object with title Longitudinal force [kN] vs Longitudinal slip [], xlabel Longitudinal slip [], ylabel Longitudinal force [kN] contains 3 objects of type line. One or more of the lines displays its values using only markers These objects represent -0.105, 0, 0.105.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_05.png)
Specifying the input arguments DataVariableNames, ColorBy, FilterBy, and FilterByValues, plot the longitudinal force versus the lateral force of the tireData object array. Use the slip angle to assign colors and legend values to the plot. Filter by the inclination angle values of -0.2 and 0.2 and the test method value of Combined.
plot(td,DataVariableNames=["Fy","Fx"],ColorBy="alpha", ... FilterBy=["TestMethod","gamma"], ... FilterByValues={"Combined",[-0.02 0.02]});
![Figure contains an axes object. The axes object with title Longitudinal force [kN] vs Lateral force [kN], xlabel Lateral force [kN], ylabel Longitudinal force [kN] contains 4 objects of type line. One or more of the lines displays its values using only markers These objects represent -0.14, -0.087, -0.035, 0.035.](../../examples/vdynblks/PlotTireMeasurementDataForVisualInspectionExample_06.png)
