iddata

Datos de entrada-salida y sus propiedades para la identificación de sistemas en el dominio del tiempo o la frecuencia

Descripción

Utilice el objeto iddata para encapsular los datos de medición de entrada y salida para el sistema que desea identificar. Las funciones de identificación de sistemas utilizan estas mediciones para estimar un modelo. Las funciones de validación de modelos utilizan las mediciones de entrada para proporcionar la entrada para las simulaciones y las mediciones de salida para comparar el grado en el que la respuesta estimada del modelo se ajusta a los datos originales.

Los objetos iddata pueden contener un único conjunto de mediciones o múltiples conjuntos. Cada conjunto de datos corresponde a un experimento. Los objetos tienen las siguientes características, que están codificadas en las propiedades del objeto:

• Los datos pueden estar en el dominio de la frecuencia o en el dominio del tiempo. Puede convertir objetos de un dominio al otro.

• En el dominio del tiempo, los datos se pueden muestrear de manera uniforme o no uniforme. Sin embargo, para usar el objeto iddata para la estimación, los datos deben estar muestreados de manera uniforme y los datos de entrada y salida para cada experimento deben estar registrados en los mismos instantes de tiempo.

• Puede especificar propiedades de datos, como el tiempo de muestreo, el tiempo de inicio, los puntos de tiempo, los puntos de muestra de frecuencia y el comportamiento entre muestras.

• Puede proporcionar etiquetas y comentarios para diferenciar y hacer anotaciones en componentes de datos, experimentos y en todo el objeto.

Para acceder a las propiedades del objeto, utilice la notación de puntos. Por ejemplo, supongamos que crea un objeto iddata con el comando sys = iddata(ym,um,Tsamp), donde ym son los datos de salida medidos, um son los datos de entrada medidos y Tsamp es el tiempo de muestreo. iddata almacena estas variables en las propiedades InputData, OutputData y Ts, respectivamente. Puede ver o modificar los datos con sys.InputData, sys.OutputData y sys.Ts. Para ver un ejemplo de cómo usar la notación de puntos para visualizar y modificar propiedades, consulte Visualizar y modificar propiedades.

Creación

Sintaxis

data = iddata(y,u,Ts)

data = iddata(y,[],Ts)

data = iddata(tt)

data = iddata(y,u,Ts,'Frequency',W)

data = iddata(___,Name,Value)

Descripción

Usar datos del dominio del tiempo

data = iddata(y,u,Ts) crea un objeto iddata que contiene una señal de salida y y una señal de entrada u del dominio del tiempo. Ts especifica el tiempo de muestreo de los datos experimentales.

Puede utilizar iddata para crear un objeto iddata multiexperimento especificando y y u como arreglos de celdas. De manera alternativa, puede crear objetos iddata con un único experimento y usar merge (iddata) para combinar los objetos en un objeto iddata multiexperimento. Para obtener más información sobre objetos iddata multiexperimento, consulte Create Multiexperiment Data at the Command Line.

data = iddata(y,[],Ts) crea un objeto iddata para datos de series temporales. El objeto contiene una señal de salida y y una señal de entrada vacía [] del dominio del tiempo. Ts especifica el tiempo de muestreo de los datos experimentales.

data = iddata(tt) crea un objeto iddata a partir del horario tt.

El software extrae los nombres de variable y el tiempo de muestreo de tt.

De forma predeterminada, el software interpreta la última variable en tt como el único canal de salida y el resto de variables son canales de entrada. Para cambiar esta interpretación, establezca las propiedades 'InputName' y 'OutputName' con argumentos nombre-valor.

Usar datos del dominio de la frecuencia

data = iddata(y,u,Ts,'Frequency',W) crea un objeto iddata que contiene datos del dominio de la frecuencia. W establece la propiedad Frequency de iddata en un vector de frecuencias. Normalmente, y y u son las transformadas de Fourier discretas de señales del dominio del tiempo.

Configurar propiedades adicionales

data = iddata(___,Name,Value) establece propiedades adicionales con argumentos nombre-valor. Especifique Name,Value después de cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

Argumentos de entrada

y — Señal de salida de un sistema

vector columna | matriz | arreglo de celdas | []

Señal de salida de un sistema, especificada como una de las siguientes opciones:

• Un vector de N por 1 para un sistema de única salida, donde N es el número de observaciones

• Una matriz de N por Ny para un sistema de múltiples salidas, donde Ny es el número de canales de salida

• Un arreglo de celdas de N_e elementos para un conjunto de datos multiexperimento, donde N_e es el número de experimentos y cada celda contiene las señales de salida para un experimento

• [] para un sistema que no tiene señal de salida, como cuando solo se registra la señal de entrada

y debe estar en el mismo dominio que los datos de entrada u. Si los datos están en el dominio del tiempo, y y u deben registrarse en los mismos instantes de tiempo.

Si utiliza el objeto iddata para la estimación, y y u deben estar muestreados de manera uniforme. Si la falta de uniformidad es pequeña, se pueden convertir los datos en un conjunto muestreado de manera uniforme con suficiente integridad como para que los datos convertidos admitan la estimación. Para obtener más información sobre las técnicas que puede probar, consulte interp1 y Datos que faltan en MATLAB.

y establece la propiedad OutputData del objeto iddata.

u — Señal de entrada a un sistema

vector columna | matriz | arreglo de celdas | []

Señal de entrada a un sistema, especificada como una de las siguientes opciones:

• Un vector de N por 1 para un sistema de única entrada, donde N es el número de observaciones

• Una matriz de N por N_u para un sistema de múltiples entradas, donde N_u es el número de canales de entrada

• Un arreglo de celdas de N_e elementos para un conjunto de datos multiexperimento, donde N_e es el número de experimentos y cada celda contiene las señales de entrada para un experimento

• [] para un sistema que no tiene señal de entrada, como una serie temporal

u debe estar en el mismo dominio que los datos de salida y. Si los datos están en el dominio del tiempo, y y u deben registrarse en los mismos instantes de tiempo.

Si utiliza el objeto iddata para la estimación, y y u deben estar muestreados de manera uniforme. Si la falta de uniformidad es pequeña, se pueden convertir los datos en un conjunto muestreado de manera uniforme con suficiente integridad como para que los datos convertidos admitan la estimación. Para obtener más información sobre las técnicas que puede probar, consulte interp1 y Datos que faltan en MATLAB.

u establece la propiedad InputData del objeto iddata.

tt — Horario de señales de entrada y salida

horario | arreglo de celdas de horarios

Horario de señales de entrada y salida, especificado como un horario que usa un vector de tiempo espaciado uniformemente.

Para datos multiexperimento, especifique tt como un arreglo de celdas de Ne por 1, donde Ne es el número de experimentos.

Para identificar qué variables son señales de entrada y cuáles señales de salida, o extraer un subconjunto de las variables para su conversión, establezca las propiedades 'InputName' y 'OutputName' con argumentos nombre-valor.

Ts — Tiempo de muestreo

1 (predeterminado) | escalar | 0 | []

Tiempo de muestreo en las unidades especificadas por la propiedad TimeUnit, especificado como una de las siguientes opciones:

• Un escalar cuando y y u están muestreados de manera uniforme.

• 0 para datos en tiempo continuo del dominio de la frecuencia.

• [] cuando y y u no están muestreados de manera uniforme y se especifican los valores de tiempo en la propiedad SamplingInstants. Para un muestreo no uniforme, y y u deben estar en el dominio del tiempo.

Ts establece la propiedad Ts del objeto iddata.

Propiedades

Domain — Dominio del tiempo o de la frecuencia de los datos

'Time' (predeterminado) | 'Frequency'

Dominio del tiempo o de la frecuencia de los datos, especificado como:

• 'Time': los datos están en el dominio del tiempo

• 'Frequency': los datos están en el dominio de la frecuencia

ExperimentName — Nombre de cada conjunto de datos

{'Exp1';'Exp2';…} (predeterminado) | arreglo de celdas

Nombre de cada conjunto de datos incluido en el objeto iddata, especificado como un arreglo de celdas de N_e por 1 de vectores de caracteres, donde N_e es el número de experimentos. Cada celda contiene el nombre del experimento correspondiente. Por ejemplo, {'MyMeas1';'MyMeas2';'MyMeas3'} contiene nombres de experimento para un objeto iddata de tres experimentos.

Frequency — Valores de frecuencia

vector columna | arreglo de celdas

Valores de frecuencia para datos del dominio de la frecuencia, especificados como:

• Un vector de N por 1, donde N es el número de valores de frecuencia en un único experimento.

• Un arreglo de celdas de 1 por N_e, donde N_e es el número de experimentos y cada celda contiene el vector de frecuencia para el experimento correspondiente. Todos los valores de frecuencia deben estar en las mismas unidades.

FrequencyUnit — Unidades de frecuencia para datos del dominio de la frecuencia

'rad/TimeUnit' (predeterminado) | 'cycles/TimeUnit' | 'rad/s' | 'Hz' | 'kHz' | 'MHz' | 'GHz' | 'rpm'

Unidades de frecuencia para datos del dominio de la frecuencia, especificadas como escalar. Esta propiedad se aplica a todos los elementos del conjunto de datos.

Cuando se cambia esta propiedad no se escalan ni se convierten los datos. Cuando se modifica la propiedad cambia solo la interpretación de los datos existentes.

InputData — Valores de la señal de entrada

vector | matriz | arreglo de celdas de matrices

Valores de la señal de entrada al sistema, especificados como una de las siguientes opciones:

• Para un único experimento, una matriz de N por N_u, donde N es el número de muestras de datos y N_u es el número de canales de entrada

• Para múltiples experimentos, un arreglo de celdas que contiene N_e matrices de único experimento, donde N_e es el número de experimentos

Cuando se accede a InputData desde la línea de comandos, se puede utilizar el formato abreviado u. Por ejemplo, u1 = data.InputData es equivalente a u1 = data.u.

InputName — Nombres de los canales de entrada

{'u1';'u2';…} (predeterminado) | arreglo de celdas de vectores de caracteres

Nombres de los canales de entrada, especificados como un arreglo de celdas de N_u por 1, donde N_u es el número de canales de entrada.

InputUnit — Unidades de los canales de entrada

arreglo de celdas

Unidades de los canales de entrada, especificadas como un arreglo de celdas de N_u por 1, donde N_u es el número de canales de entrada. Cada celda contiene las unidades del canal de entrada correspondiente.

Ejemplo: {'rad';'rad/s'}

InterSample — Comportamiento entre muestras

'zoh' (predeterminado) | 'foh' | 'bl' | arreglo de celdas de vectores de caracteres

Comportamiento entre muestras para transformaciones entre tiempo discreto y tiempo continuo, especificado como un vector de caracteres o un arreglo de celdas de vectores de caracteres. Para cada experimento, los valores posibles para cada canal de entrada son:

• zoh: la retención de orden cero mantiene una señal de entrada constante por tramos entre muestras.

• foh: la retención de primer orden mantiene una señal de entrada lineal por tramos entre muestras.

• bl: el comportamiento de banda limitada especifica que la señal de entrada en tiempo continuo no tiene potencia por encima de la frecuencia Nyquist.

Para un único experimento con un único canal de entrada, InterSample contiene uno de los valores de la lista anterior. Para múltiples experimentos, InterSample es un arreglo de celdas de N_u por N_e, donde N_u es el número de canales de entrada y N_e es el número de experimentos. Cada celda contiene el valor de comportamiento asociado al experimento y al canal de entrada que representa la celda.

Name — Nombre del conjunto de datos

' ' (predeterminado) | vector de caracteres

Nombre del conjunto de datos, especificado como un vector de caracteres.

Ejemplo: 'dryer data'

Notes — Comentarios sobre el conjunto de datos

' ' (predeterminado) | vector de caracteres | arreglo de celdas

Comentarios sobre el conjunto de datos, especificado como un vector de caracteres o, para conjuntos de datos multiexperimento, un arreglo de celdas de N_e por 1 de vectores de caracteres, donde N_e es el número de experimentos.

Ejemplo: {'data from experiment 1';data from experiment 2'}

OutputData — Valores de la señal de salida

vector | matriz

Valores de la señal de salida del sistema, especificados como una de las siguientes opciones:

• Para un único experimento, una matriz de N por N_y, donde N es el número de muestras de datos y N_y es el número de canales de salida

• Para múltiples experimentos, un arreglo de celdas que contiene N_e matrices de único experimento, donde N_e es el número de experimentos

Cuando se accede a OutputData desde la línea de comandos, se puede utilizar el formato abreviado y. Por ejemplo, y1 = data.InputData es equivalente a y1 = data.y.

OutputName — Nombres de los canales de salida

{'y1';'y2';…} (predeterminado) | arreglo de celdas de vectores de caracteres

Nombres de los canales de salida, especificados como un arreglo de celdas de N_y por 1, donde N_y es el número de canales de salida.

OutputUnit — Unidades de los canales de salida

arreglo de celdas

Unidades de los canales de salida, especificadas como un arreglo de celdas de N_y por 1, donde N_u es el número de canales de salida. Cada celda contiene las unidades del canal de entrada correspondiente.

Ejemplo: {'rad';'rad/s'}

Period — Periodo de la señal de entrada

Inf (predeterminado) | doble | vector | arreglo de celdas | arreglo de celdas de vectores de caracteres

Periodo de la señal de entrada, especificado como un valor de tipo doble para cada experimento. El valor es Inf para señales de entrada no periódicas o el periodo en las unidades especificadas por la propiedad TimeUnit para señales de entrada periódicas.

• Para un único experimento con un único canal de entrada, Period contiene un único valor.

• Para un sistema de múltiples entradas, Period es un vector de N_u por 1, donde N_u es el número de canales de entrada y el elemento k-ésimo contiene el periodo de la k-ésima entrada.

• Para datos de múltiples experimentos, Period es un arreglo de celdas de 1 por N_e, donde N_e es el número de experimentos y cada celda contiene un escalar o un vector de periodos para el experimento correspondiente.

SamplingInstants — Valores de tiempo para datos del dominio del tiempo

vector | arreglo de celdas

Valores de tiempo para datos del dominio del tiempo en unidades especificadas por TimeUnit, especificados como:

• Un vector de N por 1, donde N es el número de puntos de datos.

• Un arreglo de celdas de 1 por N_e, donde N_e es el número de experimentos y cada celda contiene los instantes de muestreo para el experimento correspondiente.

Los valores de SamplingInstants pueden ser uniformes o no uniformes. Si especifica la propiedad Ts, el software calcula valores de tiempo uniformes en SamplingInstants a partir de Ts y Tstart. Si tiene puntos de muestra no uniformes, especifique los valores de tiempo en SamplingInstants. Después, el software establece la propiedad Ts como vacía. Las funciones de estimación no admiten el muestreo no uniforme.

TimeUnit — Unidades para la variable tiempo y el tiempo de muestreo Ts

'seconds' (predeterminado) | 'nanoseconds' | 'microseconds' | 'milliseconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years'

Unidades para la variable tiempo y el tiempo de muestreo, especificadas como un escalar. Esta propiedad se aplica a todos los experimentos del conjunto de datos.

Cuando se cambia esta propiedad no se remuestrean ni se convierten los datos. Cuando se modifica la propiedad cambia solo la interpretación de los datos existentes.

Ts — Tiempo de muestreo

1 (predeterminado) | escalar positivo | 0 | [] | arreglo de celdas

Tiempo de muestreo en unidades especificadas por TimeUnit, especificado como un escalar o un arreglo de celdas. Para cada experimento, el valor es una de las siguientes opciones:

• Un escalar, cuando y y u están muestreados de manera uniforme.

• 0 para datos en tiempo continuo del dominio de la frecuencia.

• [] cuando y y u no están muestreados de manera uniforme y se encuentran en el dominio del tiempo, ya que la propiedad SamplingInstants establece los valores de tiempo para esos datos.

Para un único experimento, Ts es un escalar. Para datos multiexperimento, Ts es un arreglo de celdas de 1 por N_e, donde N_e es el número de experimentos y cada celda contiene el tiempo de muestreo para el experimento correspondiente.

Para datos del dominio de la frecuencia, el software utiliza Ts para interpretar los datos.

• Si Ts es 0, el software interpreta las entradas y salidas como transformadas de Fourier en tiempo continuo (CTFT) de las señales correspondientes.

• Si Ts es un escalar, el software interpreta las entradas y salidas como transformadas de Fourier en tiempo discreto (DTFT) de las señales correspondientes con Ts como tiempo de muestreo.

Tstart — Tiempo de inicio para datos del dominio del tiempo

escalar | arreglo de celdas

Tiempo de inicio para datos del dominio del tiempo, especificado como:

• Un escalar para un único experimento

• Un arreglo de celdas de 1 por N_e para múltiples experimentos, donde N_e es el número de experimentos y cada celda contiene el tiempo de inicio para el experimento correspondiente

El valor predeterminado de Tstart es Ts para datos muestreados de manera uniforme y [] para datos muestreados de manera no uniforme.

UserData — Comentarios adicionales

[] (predeterminado) | cualquier tipo de datos de MATLAB

Comentarios adicionales sobre el conjunto de datos, especificados como cualquier tipo de datos de MATLAB.

Funciones del objeto

En general, cualquier función que se pueda aplicar a datos de identificación del sistema se puede aplicar a un objeto del tipo iddata. Estas funciones son de tres tipos generales.

1. Las funciones que operan y devuelven objetos iddata permiten manipular y procesar objetos iddata.

   • Utilice fft y ifft para transformar objetos iddata existentes desde y hacia los dominios del tiempo y la frecuencia. Por ejemplo:

     datafd = fft(Data);
     datatd = ifft(Dataf);

   • Utilice merge (iddata) para fusionar objetos iddata en un único objeto iddata que contiene múltiples experimentos. Para extraer un experimento de un objeto iddata multiexperimento, utilice getexp. Por ejemplo:

     data123 = merge(data1,data2,data3);
     data2 = getexp(data123,2);
     

     Para ver un ejemplo más detallado, consulte Extract and Model Specific Data Segments.

   • Utilice funciones de preprocesamiento como detrend o idfilt para filtrar datos en objetos iddata y para eliminar datos incorrectos. Por ejemplo:

     data_d = detrend(data);
     data_f = idfilt(data,filter);

2. Las funciones que realizan un procesamiento analítico de objetos iddata y crean gráficas o devuelven parámetros o valores específicos permiten analizar datos y determinar qué entradas utilizar para la estimación.

   • Utilice funciones de análisis como delayest y spa para calcular variables como el retardo de tiempo y el espectro de frecuencia.

3. Las funciones que utilizan los datos de objetos iddata para estimar, simular y validar modelos permiten crear modelos dinámicos y evaluar la precisión con la que la respuesta del modelo coincide con los datos de validación.

   • Utilice funciones de estimación como ssest y tfest para estimar modelos con estructuras específicas.

   • Utilice funciones de validación como compare y sim para simular modelos estimados y comparar las salidas simuladas con datos de validación y con otros modelos.

   Las siguientes listas contienen un subconjunto de las funciones que se pueden usar con los objetos del tipo iddata.

Visualización de datos

idplot

Plot input and output channels of estimation data

Selección de datos

getexp	Get specific experiments from multiple-experiment data set
merge (iddata)	Merge data sets into iddata object

Preprocesamiento de datos

detrend	Subtract offset or trend from time-domain signals contained in iddata objects
retrend	Add offsets or trends to time-domain data signals stored in iddata objects
idfilt	Filter data using user-defined passbands, general filters, or Butterworth filters
diff	Señales de diferencia en objetos iddata
misdata	Reconstruct missing input and output data
idresamp	Resample time-domain data by decimation or interpolation

Transformación de datos

fft	Fast Fourier transform (FFT) of iddata object
ifft	Transform iddata objects from frequency to time domain

Análisis de datos

realdata	Determine whether iddata is based on real-valued signals
delayest	Estimate time delay (dead time) from data
isreal	Determine whether model parameters or data values are real
impulseest	Nonparametric impulse response estimation
pexcit	Level of excitation of input signals
checkFeedback	Identify possible feedback data
etfe	Estimate empirical transfer functions and periodograms
spafdr	Estimate frequency response and spectrum using spectral analysis with frequency-dependent resolution
spa	Estimate frequency response with fixed frequency resolution using spectral analysis
dataPlotOptions	Option set for idplot when plotting input/output estimation data contained in a timetable, numeric matrices, or an iddata object

Estimación, simulación y validación de modelos

ssest	Estimate state-space model using time-domain or frequency-domain data
tfest	Estimate transfer function model
ar	Estimate parameters when identifying AR model or ARI model for scalar time series
sim	Simulate response of identified model
findstates	Estimate initial states of model
compare	Compare identified model output with measured output
predict	Predecir la salida del modelo identificado con K pasos de anticipación
goodnessOfFit	Goodness of fit between test and reference data for analysis and validation of identified models
procest	Estimate process model using time-domain or frequency-domain data
resid	Compute and test residuals

Ejemplos

Datos del dominio del tiempo

Cree un objeto iddata utilizando datos del dominio del tiempo de única entrada/única salida (SISO). La entrada y la salida contienen 1000 muestras cada una con un tiempo de muestreo de 0.08 segundos.

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

El software asigna el nombre de canal predeterminado 'y1' al primer y único canal de salida. Cuando la señal de salida contiene varios canales, el software asigna los nombres predeterminados 'y1','y2',...,'yn'. Del mismo modo, el software asigna el nombre de canal predeterminado 'u1' al primer y único canal de entrada. Para obtener más información sobre cómo poner nombres a los canales, consulte Naming, Adding, and Removing Data Channels.

Represente los datos.

idplot(data)

Las gráficas adyacentes muestran datos de salida y datos de entrada.

Datos de series temporales

Cree un objeto iddata a partir de los datos de series temporales. Los datos de series temporales no tienen canal de entrada.

Cargue el canal de salida de un conjunto de datos y cree un objeto iddata que tenga un tiempo de muestreo de 0.08 segundos.

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

Represente los datos.

idplot(data)

Puede utilizar data para la estimación de modelos de series temporales.

Convertir un horario a un objeto iddata

Cargue los datos de horario tt7 y muestre las primeras cuatro filas.

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 tiene dos entradas, con nombres de variable u1 y u2, y una salida con nombre de variable y. Convierta tt7 a un objeto 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 array
    "'u1'"
    "'u2'"

z7conv conserva el tiempo de muestreo y almacena los nombres de variable en las propiedades OutputName e InputName.

Datos del dominio de la frecuencia

Cree y examine un objeto iddata a partir de datos de entrada-salida del dominio de la frecuencia con valores complejos. Convierta el objeto al dominio del tiempo.

Los datos de entrada y salida en ocasiones se expresan en forma de transformadas de Fourier de señales de entrada-salida del dominio del tiempo. Puede encapsular estos datos en un objeto iddata del dominio de la frecuencia.

Cargue los datos, que constan de los datos del dominio de la frecuencia de entrada-salida con valores complejos U e Y, el vector de frecuencia W y el tiempo de muestreo Ts.

load demofr1 U Y W Ts

Cree el objeto iddata data_fr del dominio de la frecuencia.

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

Examine las propiedades. Los objetos iddata del dominio de la frecuencia incluyen propiedades específicas de la frecuencia, como Frequency para el vector de frecuencia y FrequencyUnit para las unidades de frecuencia. En contraste, los objetos iddata del dominio del tiempo incluyen propiedades específicas del tiempo como Tstart y SamplingInstants para los datos del dominio del tiempo.

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: []

Asigne el contenido de la propiedad de frecuencia a la variable F.

F = data_fr.Frequency;

Obtenga las unidades de frecuencia de los datos. La propiedad TimeUnit establece las unidades del tiempo de muestreo.

frequ = data_fr.FrequencyUnit

frequ = 
'rad/TimeUnit'

timeu = data_fr.TimeUnit

timeu = 
'seconds'

Vuelva a convertir data_fr al dominio del tiempo utilizando la función de transformada de Fourier inversa ifft.

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: []

Visualizar y modificar propiedades

Visualice las propiedades de un objeto iddata. Modifique las propiedades durante y después de la creación del objeto.

Cargue los datos de entrada y salida.

load dryer2_data input output

Cree un objeto 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

Visualice todas las propiedades del objeto 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: []

Se pueden especificar propiedades cuando se crea un objeto iddata con argumentos de par nombre-valor. Cree un objeto iddata a partir de las mismas entradas de datos, pero cambie el nombre del experimento de su configuración predeterminada a 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

Para cambiar los valores de propiedad de un objeto iddata existente, utilice la notación de puntos. Cambie la propiedad de tiempo de muestreo Ts a 0.05 segundos.

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

Los nombres de propiedad no distinguen entre mayúsculas y minúsculas. Asimismo, si las primeras letras identifican inequívocamente la propiedad, no es necesario escribir el nombre de la propiedad completo.

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

Puede utilizar data.y como abreviación de data.OutputData para acceder a los valores de salida o utilizar data.u como abreviación de data.InputData para acceder a los valores de entrada.

y_data = data.y;
u_data = data.u;

Historial de versiones

Introducido antes de R2006a

R2023a: iddata añade la funcionalidad para convertir horarios a objetos iddata

Como parte de la ampliación de formatos de datos de estimación de System Identification Toolbox™ a horarios y pares de matrices separados por comas, iddata ahora puede convertir horarios a objetos iddata.

Para convertir objetos iddata a horarios, utilice iddata2timetable.

Consulte también

idfrd | idinput

Temas

• Representing Data in MATLAB Workspace
• Create Multiexperiment Data at the Command Line
• Representing Time- and Frequency-Domain Data Using iddata Objects
• Managing iddata Objects