dataPlotOptions
Option set for idplot
when plotting input/output estimation data
contained in a timetable, numeric matrices, or an iddata
object
Since R2023a
Syntax
Description
creates the default
option set for plotting time-domain data. Use dot notation to customize the option
set, if needed.opt
= dataPlotOptions('time')
creates a default
option set for plotting frequency-domain data. Use dot notation to customize the
option set, if needed.opt
= dataPlotOptions('frequency')
initializes the plot options with the System Identification Toolbox™
preferences. This syntax can include any of the input argument
combinations in the previous syntaxes. Use this syntax to change a few plot options
but otherwise use your toolbox preferences.opt
= dataPlotOptions(___,'identpref')
Examples
Create Option Set for Plotting Time-Domain Data
Create an options set with default options for time-domain data.
opt = dataPlotOptions('time');
Specify plot properties, such as time units and grid. View the plot in minutes
opt.TimeUnits = 'minutes'; % Turn grid on opt.Grid = 'on';
Create a plot using the specified options.
load iddata1 z1 h = idplot(z1, opt);
Change Orientation of Input-Output Data Axes
Generate data with two inputs and one output.
z = iddata(randn(100,1),rand(100,2));
Configure a time plot.
opt = iddataPlotOptions('time');
Plot the data.
h = idplot(z,opt);
Change the orientation of the plots such that all inputs are plotted in one column, and all outputs are in a second column.
opt.Orientation = 'two-column';
h = idplot(z,opt);
Alternatively, use setoptions
.
setoptions(h,'Orientation','two-column')
You can also change the orientation by right-clicking the plot and choosing Orientation
in the context menu.
Create Option Set for Plotting Frequency-Domain Data
Create an option set with default options for frequency-domain data.
opt = dataPlotOptions('frequency');
Specify plot properties, such as phase visibility and frequency units.
opt.PhaseVisible = 'off'; opt.FreqUnits = 'Hz';
Create a plot with the specified options.
load iddata7 z7 zf = fft(z7); h = idplot(zf,opt);
Initialize a Plot Using Toolbox Preferences
opt = dataPlotOptions('time','identpref');
Output Arguments
opt
— Option set for idplot
dataPlotOptions
option set
Option set containing the specified options for idplot
. The structure has
the following fields:
Field | Description | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Title , XLabel ,
YLabel
| Text and style for axes labels and plot title, specified as a structure array with the following fields:
| ||||||||||||||||||||||||||||||
TickLabel | Tick label style, specified as a structure array with the following fields:
| ||||||||||||||||||||||||||||||
Grid | Show or hide the grid, specified as one of the
following values: Default:
| ||||||||||||||||||||||||||||||
GridColor | Color of the grid lines, specified as one of the
following values: vector of RGB values in the range
Default:
| ||||||||||||||||||||||||||||||
XlimMode ,
YlimMode | Axes limit modes, specified as one of the following values:
Default:
| ||||||||||||||||||||||||||||||
Xlim , Ylim
| Axes limits, specified as maximum and minimum values. Default: | ||||||||||||||||||||||||||||||
IOGrouping
| Grouping of input-output pairs, specified as one of
the following values: Default:
| ||||||||||||||||||||||||||||||
InputLabels ,
OutputLabels
| Input and output label styles on individual plot axes, specified as a structure array with the following fields:
| ||||||||||||||||||||||||||||||
InputVisible ,
OutputVisible | Visibility of input and output channels, specified
as one of the following values: Default:
| ||||||||||||||||||||||||||||||
Orientation | Orientation of the input and output data plots, specified as one of the following values:
Default:
| ||||||||||||||||||||||||||||||
For time-domain data plots only:
| |||||||||||||||||||||||||||||||
For frequency-domain data plots only:
|
Version History
Introduced in R2023aR2023a: dataPlotOptions
function replaces the iddataPlotOptions
method of
iddata
R2022b: Time-domain estimation data is accepted in the form of timetables and matrices
Most estimation, validation, analysis, and utility functions now accept time-domain
input/output data in the form of a single timetable that contains both input and output data
or a pair of matrices that contain the input and output data separately. These functions
continue to accept iddata
objects as a data source as well, for
both time-domain and frequency-domain data.
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)