zpk (MathScript RT Module Function)
- Updated2023-03-14
- 2 minute(s) read
zpk (MathScript RT Module Function)
Owning Class: construct
Requires: Control Design and Simulation Module and MathScript RT Module
Syntax
SysOutZPK = zpk(K)
SysOutZPK = zpk(K, Ts)
SysOutZPK = zpk(z, p, K)
SysOutZPK = zpk(z, p, K, Ts)
SysOutZPK = zpk(z_1, z_2, ..., z_ij, p_1, p_2, ..., p_ij, K)
SysOutZPK = zpk(z_1, z_2, ..., z_ij, p_1, p_2, ..., p_ij, K, Ts)
SysOutZPK = zpk(SysIn)
Description
Creates a continuous or discrete linear time-invariant (LTI) system model in zero-pole-gain form. You also can use this function to convert transfer function and state-space models to zero-pole-gain form.
Inputs
| Name | Description |
|---|---|
| K | Specifies the gain. K is an m x r real matrix, where m is the number of model inputs and r is the number of model outputs. |
| Ts | Specifies the discrete sampling time of the SysOutZPK model. The default value is 0, which constructs a continuous model. Specify a non-zero value to construct a discrete model. Ts is a real scalar. |
| z_ij | Specifies the locations of the zeros of the SysOutZPK model. The coefficients you specify for the z_ij input apply to the zero-pole-gain equation at the i-th input and j-th output of a MIMO model. z is a complex scalar or complex vector, depending on whether you want the model to be SISO or MIMO. |
| p_ij | Specifies the locations of the poles of the SysOutZPK model. The coefficients you specify for the z_ij input apply to the zero-pole-gain equation at the i-th input and j-th output of a MIMO model. p is a complex scalar or complex vector, depending on whether you want the model to be SISO or MIMO. |
| SysIn | Specifies an LTI model you want to convert to zero-pole-gain form. |
Outputs
| Name | Description |
|---|---|
| SysOutZPK | Returns an LTI zero-pole-gain model with zeros at z, poles at p, gain K, and sampling time Ts. The SysOutZPK model is SISO, single-input multiple-output (SIMO), multiple-input single-output (MISO), or MIMO depending on the dimensions of K. |
Details
The following table lists the support characteristics of this function.
| Supported in the LabVIEW Run-Time Engine | Yes |
| Supported on RT targets | Yes |
| Suitable for bounded execution times on RT | Not characterized |
Examples
% Creates a continuous zero-pole-gain model
z_1 = 1
p_1 = 2
z_2 = []
p_2 = [1, 1]
K = [2; 1]
SysOutZPK = zpk(z_1, z_2, p_1, p_2, K)
% Converts a transfer function model to zero-pole-gain form
num = 1
den = [1, -1]
SysInTF = tf(num, den)
SysOutZPK = zpk(SysInTF)