Main Content


Level of excitation of input signals


Ped = pexcit(Data)
[Ped,Maxnr] = pexcit(Data,Maxnr,Threshold)
ped = pexcit(___,Name,Value)


Ped = pexcit(Data) tests the degree of persistence of excitation for the input.

Data can contain time-domain or frequency-domain input/output data, and can be in the form of a timetable, a comma-separated pair of numeric matrices, or an iddata object. If there are multiple experiments, data can be a cell array.

Ped is the degree or order of excitation of the inputs in Data and is a row vector of integers with as many components as there are inputs in Data. The intuitive interpretation of the degree of excitation in an input is the order of a model that the input is capable of estimating in an unambiguous way.

[Ped,Maxnr] = pexcit(Data,Maxnr,Threshold) specifies the maximum order tested and threshold level used to measure which singular values are significant. Default value of Maxnr is min(N/3,50), where N is the number of input data. Default value of Threshold is 1e-9.

ped = pexcit(___,Name,Value) uses additional model options specified by one or more name-value arguments.

The available arguments consist of InputName and OutputName, which are the input and output channel names. Use these arguments especially when data is a timetable that has more variables than you want to use. Also use OutputName to identify the output channels when the timetable data contains more than one output variable. Otherwise, the software interprets only the last variable as an output channel.

For example, specify the input and output signal variable names using sys = pexcit(data,'InputName',["u1","u3"],'OutputName',"y1").


Section 13.2 in Ljung (1999).

Version History

Introduced before R2006a