evalRequirement

Class: sdo.requirements.PZNaturalFrequency
Package: sdo.requirements

Evaluate natural frequency bound on linear system

Syntax

c = evalRequirement(req,lin_sys)


Description

c = evalRequirement(req,lin_sys) evaluates whether the poles of a linear system satisfies the specified natural frequency bound.

Input Arguments

req	Requirement object (sdo.requirements.StepResponseEnvelope, ...). For MIMO systems, the bound applies to each input/output (I/O) channel.
lin_sys	Linear system (tf, ss, zpk, frd, genss, or genfrd).

Output Arguments

c

Signed distance of the natural frequency of each system pole to the bound. If the Type property of req is >=, <=, negative values indicate that the bound is satisfied while positive values indicate that the bound is violated. If ==, any value other than 0 indicates that the bound is violated. Negative of the natural frequency of the linear system poles such that minimizing the values maximizes the natural frequency, if the Type property of req is 'max'.

Examples

Evaluate natural frequency requirement.

req = sdo.requirements.PZNaturalFrequency;
sys = tf(0.5,[1 3 3 1]);
c = evalRequirement(req,sys);

c is positive, which indicates that the system does not satisfy the natural frequency requirement.