主要内容

cktzpk

Zeros, poles, and gains for linear circuit

Since R2026a

Description

[z,p,k] = cktzpk(circuit) calculates the zeros, poles, and gains for a linear circuit from a Simscape™ electrical diagram or subsystem or a circuit configuration object.

[z,p,k,inports,outports] = cktzpk(circuit) lists in names of the input and output ports in addition to calculating the zeros, poles, and gains.

Input Arguments

collapse all

Simscape electrical diagram or subsystem or a circuit configuration object for which to calculate the zeros, poles, and gains, specified either as a schematic or as an object. For more information, see cktconfig.

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: [z,p,k] = cktssmodel(circuit,BlockName='Power Train') calculates the zeros, poles, and gains of the transfer function of the block Power Train.

Name on the icon if the function builds a Simulink block, specified as a string.

Name of the block instance in the Simulink model, specified as a string.

Option to display the resulting plots of the function, specified as true or false.

Device noise sources in the circuit, specified as an n×6 cell array. The function uses resistors to model the device noise sources. The cell array contains the following information:

ColumnDescription
NameThe circuit element designator.
EnabledOption to indicate if the noise source is active, specified as true or false. Set the value to true to indicate that the noise source is active.
Noise coefficientThe RMS amplitude of the noise source. If empty, the function uses Johnson/Nyquist noise value based on the value of the resistor.
Corner frequencyThe frequency below which the flicker noise has a higher amplitude than the white Gaussian noise. This value may equal zero to indicate an absence of flicker noise.
Independent noiseOption to indicate if the device noise is correlated with other noise sources, specified as true or false. Set the value to true to indicate the device noise is independent off other noise sources.
SeedAn integer used to select the sequence of random samples. A value of 0 indicates an independent noise source. For multiple device noise outputs, set the value to the same non-zero integer value for all noise sources that share the same source.

Output Arguments

collapse all

Zeros of the transfer function, returned as a column vector for SISO (single input single output) circuits or a cell array of column vectors for MIMO (multiple inputs multiple outputs) circuits.

Poles of the transfer function, returned as a column vector.

Gains of the transfer function, returned as a matrix.

Names of the input ports, returned as a cell array.

Names of the output ports, returned as a cell array.

Version History

Introduced in R2026a