Skip to Main Content Skip to Search
Product Documentation

covf - Estimate covariance functions for time-domain iddata object

Syntax

cov = covf(data,max_delay)
cov = covf(data,max_delay,MaxSize)

Description

cov = covf(data,max_delay) estimates the covariance for the input-output data, data, with the maximum delay - 1, max_delay.

cov = covf(data,max_delay,MaxSize) specifies the maximum size of the arrays, MaxSize, formed by the algorithm.

Let z contain the output and input channels

where y and u are the rows of data.OutputData and data.InputData, respectively, with a total of nz channels.

cov is returned as an nz2 -by- max_delay matrix with entries

where zj is the jth row of z, and missing values in the sum are replaced by zero.

The easiest way to describe and unpack the result is to use

reshape(cov(:,k+1),nz,nz) = E z(t)*z'(t+k)

Here ' is complex conjugate transpose, which also explains how complex data is handled. The expectation symbol E corresponds to the sample means.

Input Arguments

data

Input-output data.

data is an iddata object containing time-domain data only.

max_delay

Maximum delay – 1.

The maximum delay, less one, for which the covariance is estimated.

MaxSize

Specifies the maximum number of elements in a segment when input-output data is split into segments.

If larger matrices are needed, the software will use loops for calculations. Use this option to manage the trade-off between memory management and program execution speed. The original data matrix must be smaller than the matrix specified by MaxSize.

MaxSize must be a positive integer.

Default: 250000

Output Arguments

cov

Algorithms

When nz is at most two, and when permitted by maxsize, a fast Fourier transform technique is applied. Otherwise, straightforward summing is used.

See Also

cra | iddata | impulseest | spa | spafdr

  


Free Control Systems Interactive Kit

Learn more about resources for designing, testing, and implementing control systems.

Get free kit

Trials Available

Try the latest control systems products.

Get trial software
 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS