Access zero-pole-gain data - MATLAB zpkdata - MathWorks Deutschland (2024)

z — Zeros
cell array (default) | column vector

Zeros of the zero-pole-gain model, returned as a cell array with as many rows as outputs and as many columns as inputs. The (i,j) entry z{i,j} is the (column) vector of zeros of the transfer function from input j to output i.

p — Poles
cell array (default) | column vector

Poles of the zero-pole-gain model, returned as a cell array with as many rows as outputs and as many columns as inputs. The (i,j) entry p{i,j} is the (column) vector of zeros of the transfer function from input j to output i.

k — Gain
matrix

Gain of the zero-pole-gain model, returned as a matrix with as many rows as outputs and as many columns as inputs such that k(i,j) is the gain of the transfer function from input j to output i. If sys is a transfer function or state-space model, it is first converted to zero-pole-gain form using zpk.

Ts — Sample time
scalar

Sample time, specified as a scalar.

covz — Covariance of zeros
cell array

Covariance of zeros, returned as a cell array such that covz{ky,ku} contains the covariance information about the zeros in the vector z{ky,ku}. covz{ky,ku} is a 3-D array of dimension 2-by-2-by-Nz, where Nz is the length of z{ky,ku}, so that the (1,1) element is the variance of the real part, the (2,2) element is the variance of the imaginary part, and the (1,2) and (2,1) elements contain the covariance between the real and imaginary parts.

covp — Covariance of poles
cell array

Covariance of poles, returned as a cell array such that covp{ky,ku} contains the covariance information about the poles in the vector p{ky,ku}. covp{ky,ku} is a 3-D array of dimension 2-by-2-by-Np, where Np is the length of p{ky,ku}, so that the (1,1) element is the variance of the real part, the (2,2) element is the variance of the imaginary part, and the (1,2) and (2,1) elements contain the covariance between the real and imaginary parts.

covk — Covariance of gain
cell array

Covariance of zeros, returned as a cell array such that covk{ky,ku} contains the covariance information about the zeros in the vector k{ky,ku}. covk{ky,ku} is a 3-D array of dimension 2-by-2-by-Nk, where Nk is the length of k{ky,ku}, so that the (1,1) element is the variance of the real part, the (2,2) element is the variance of the imaginary part, and the (1,2) and (2,1) elements contain the covariance between the real and imaginary parts.