iddata
在时域或频域中用于系统辨识的输入-输出数目据及其属性
说明
使用 iddata 对象封装您想要辨识的系统的输入和输出测量数据。系统辨识函数使用这些测量值来估计模型。模型验证函数使用输入测量值来提供仿真的输入，并使用输出测量值来比较估计的模型响应与原始数据的拟合度。
iddata 对象可以包含一组测量值或多组测量值。每组数据对应一个试验。对象具有以下特征，这些特征在对象属性中编码：
数据可以位于频域中，也可以位于时域中。您可以将对象从一个域转换到另一个域。
在时域中，数据可以均匀采样，也可以非均匀采样。然而，要使用
iddata对象进行估计，必须对数据进行均匀采样，并且必须在同一时刻记录每个试验的输入和输出数目据。您可以指定数据属性，例如采样时间、开始时间、时间点、频率采样点和采样间行为。
您可以提供标签和注释来区分和注释数据组件、试验和整个对象。
要访问对象属性，请使用圆点表示法。例如，假设您使用命令 sys = iddata(ym,um,Tsamp) 创建了一个 iddata 对象，其中 ym 是测量的输出数目据，um 是测量的输入数目据，Tsamp 是采样时间。iddata 分别将这些变量存储在属性 InputData、OutputData 和 Ts 中。您可以使用 sys.InputData、sys.OutputData 和 sys.Ts 查看或修改数据。有关使用圆点表示法查看和修改属性的示例，请参阅查看和修改属性。
创建对象
语法
描述
使用时域数据
data = iddata(y,u,Ts)y 和输入信号 u 的 iddata 对象。Ts 指定试验数据的采样时间。
您可以通过将 y 和 u 指定为元胞数组来使用 iddata 创建多试验 iddata 对象。您也可以创建单试验 iddata 对象并使用 merge (iddata) 将这些对象组合成一个多试验 iddata 对象。有关多试验 iddata 对象的详细信息，请参阅Create Multiexperiment Data at the Command Line。
使用频域数据
配置其他属性
data = iddata(___,Name,Value)Name,Value。
输入参量
属性
对象函数
一般来说，任何适用于系统辨识数据的函数都适用于 iddata 对象。这些函数有三种通用类型。
对
iddata对象进行运算并返回该对象的函数使您能够操作和处理iddata对象。使用
fft和ifft将现有的iddata对象转换为时域和频域。例如：datafd = fft(Data); datatd = ifft(Dataf);
使用
merge (iddata)将iddata对象合并为包含多个试验的单个iddata对象。要从多试验iddata对象中提取试验，请使用getexp。例如：data123 = merge(data1,data2,data3); data2 = getexp(data123,2);
有关更详细的示例，请参阅提取并建模特定数据段。
使用预处理函数（例如
detrend或idfilt）来过滤iddata对象中的数据并删除不正确的数据。例如：data_d = detrend(data); data_f = idfilt(data,filter);
对
iddata对象执行解析处理并创建绘图或返回特定参数或值的函数可让您分析数据并确定用于估计的输入。使用
iddata对象中的数据来估计、仿真和验证模型的函数可让您创建动态模型并评估模型响应与验证数据的匹配度。以下列表包含可与
iddata对象一起使用的函数的代表性子集。
示例
使用单输入/单输出 (SISO) 时域数据创建 iddata 对象。输入和输出各包含 1000 个采样，采样时间为 0.08 秒。
load dryer2_data output input; data = iddata(output,input,0.08)
data =
Time domain data set with 1000 samples.
Sample time: 0.08 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
该软件将默认通道名称 'y1' 分配给第一个也是唯一的输出通道。当输出信号包含多个通道时，该软件会分配默认名称 'y1','y2',...,'yn'。类似地，该软件将默认通道名称 'u1' 分配给第一个也是唯一的输入通道。有关命名通道的详细信息，请参阅Naming, Adding, and Removing Data Channels。
绘制数据。
idplot(data)
相邻的图显示输出数目据和输入数目据。
从时间序列数据创建 iddata 对象。时间序列数据没有输入通道。
加载数据集的输出通道，并创建采样时间为 0.08 秒的 iddata 对象。
load dryer2_data output data = iddata(output,[],0.08)
data =
Time domain data set with 1000 samples.
Sample time: 0.08 seconds
Outputs Unit (if specified)
y1
Data Properties
绘制数据。
idplot(data)
您可以使用 data 进行时间序列模型估计。
加载时间表数据 tt7 并显示前四行。
load sdata7 tt7 head(tt7,4)
t u1 u2 y
_____ __ _______ _________
1 sec 1 0.2749 -0.091981
2 sec -1 0.25148 0.22567
3 sec -1 1.2381 -0.28617
4 sec -1 -1.2216 1.4581
tt7 有两个输入，变量名称为 u1 和 u2，还有一个输出，变量名称为 y。将 tt7 转换为 iddata 对象。
z7conv = iddata(tt7)
z7conv =
Time domain data set with 400 samples.
Sample time: 1 seconds
Outputs Unit (if specified)
y
Inputs Unit (if specified)
u1
u2
z7conv.OutputName
ans = 1×1 cell array
{'y'}
z7conv.InputName
ans = 2×1 cell
{'u1'}
{'u2'}
z7conv 保留采样时间，并将变量名称存储在 OutputName 和 InputName 属性中。
从复数值频域输入-输出数目据创建并检查 iddata 对象。将对象转换到时域中。
输入和输出数目据有时以时域输入-输出信号的傅里叶变换形式表示。您可以将此数据封装在频域 iddata 对象中。
加载数据，该数据由复数值输入-输出频域数据 U 和 Y、频率向量 W 以及采样时间 Ts 组成。
load demofr1 U Y W Ts
创建频域 iddata 对象 data_fr。
data_fr = iddata(Y,U,Ts,'Frequency',W)data_fr =
Frequency domain data set with responses at 501 frequencies.
Frequency range: 0 to 31.416 rad/seconds
Sample time: 0.1 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
检查属性。频域 iddata 对象包括频率特定的属性，例如频率矢量的 Frequency 和频率单位的 FrequencyUnit。相比之下，时域 iddata 对象包括时间特定属性，例如时域数据的 Tstart 和 SamplingInstants。
get(data_fr)
ans = struct with fields:
Domain: 'Frequency'
Name: ''
OutputData: [501×1 double]
OutputName: {'y1'}
OutputUnit: {''}
InputData: [501×1 double]
InputName: {'u1'}
InputUnit: {''}
Period: Inf
InterSample: 'zoh'
Ts: 0.1000
FrequencyUnit: 'rad/TimeUnit'
Frequency: [501×1 double]
TimeUnit: 'seconds'
ExperimentName: 'Exp1'
Notes: [0×1 string]
UserData: []
将频率属性的内容分配给变量 F。
F = data_fr.Frequency;
获取数据的频率单位。属性 TimeUnit 设置采样时间的单位。
frequ = data_fr.FrequencyUnit
frequ = 'rad/TimeUnit'
timeu = data_fr.TimeUnit
timeu = 'seconds'
使用傅里叶逆变换函数 ifft 将 data_fr 转换回时域。
data_t = ifft(data_fr)
data_t =
Time domain data set with 1000 samples.
Sample time: 0.1 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
get(data_t)
ans = struct with fields:
Domain: 'Time'
Name: ''
OutputData: [1000×1 double]
OutputName: {'y1'}
OutputUnit: {''}
InputData: [1000×1 double]
InputName: {'u1'}
InputUnit: {''}
Period: Inf
InterSample: 'zoh'
Ts: 0.1000
Tstart: 0.1000
SamplingInstants: [1000×1 double]
TimeUnit: 'seconds'
ExperimentName: 'Exp1'
Notes: [0×1 string]
UserData: []
查看 iddata 对象的属性。在对象创建期间和之后修改属性。
加载输入和输出数目据。
load dryer2_data input output
创建 iddata 对象。
data = iddata(output,input,0.08)
data =
Time domain data set with 1000 samples.
Sample time: 0.08 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
查看 iddata 对象的所有属性。
get(data)
ans = struct with fields:
Domain: 'Time'
Name: ''
OutputData: [1000×1 double]
OutputName: {'y1'}
OutputUnit: {''}
InputData: [1000×1 double]
InputName: {'u1'}
InputUnit: {''}
Period: Inf
InterSample: 'zoh'
Ts: 0.0800
Tstart: 0.0800
SamplingInstants: [1000×1 double]
TimeUnit: 'seconds'
ExperimentName: 'Exp1'
Notes: [0×1 string]
UserData: []
您可以在使用名称-值对组参量创建 iddata 对象时指定属性。从相同的数据输入创建 iddata 对象，但将试验名称从默认设置更改为 Dryer2。
data = iddata(output,input,0.08,'ExperimentName','Dryer2')
data =
Time domain data set with 1000 samples.
Sample time: 0.08 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
要更改现有 iddata 对象的属性值，请使用圆点表示法。将采样时间属性 Ts 更改为 0.05 秒。
data.Ts = 0.05
data =
Time domain data set with 1000 samples.
Sample time: 0.05 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
属性名称不区分大小写。此外，如果前几个字母可以唯一辨识属性，则无需输入整个属性名称。
data.exp = "Dryer2 January 2015"data =
Time domain data set with 1000 samples.
Sample time: 0.05 seconds
Outputs Unit (if specified)
y1
Inputs Unit (if specified)
u1
Data Properties
您可以使用 data.y 作为 data.OutputData 的简写形式来访问输出值，或者使用 data.u 作为 data.InputData 的简写形式来访问输入值。
y_data = data.y; u_data = data.u;
