ii_pof

ii_pof#

Purpose

Transformations between the three accepted pole formats.

Syntax

[pob] = ii_pof(poa,DesiredFormatNumber)
[pob] = ii_pof(poa,DesiredFormatNumber,SortFlag)

Description

The Structural Dynamics Toolbox deals with real models so that poles are either real or come in conjugate pairs

 
    (10.55)

Poles can be stored in three accepted formats which are automatically recognized by ii_pof(see warnings below for exceptions).


Format 1: a column vector of complex poles. ii_pof puts the pairs of complex conjugate poles λ,λ first and real poles at the end


 
    (10.56)

Because non-real poles come in conjugate pairs with conjugate eigenvectors, it is generally easier to only view the positive-imaginary and real poles, as done in the two other formats.


Format 2: real and imaginary part

 
    (10.57)

Format 3: frequency ω and damping ratio ζ

 
    (10.58)

To sort the poles while changing format use an arbitrary third argument SortFlag.

Warnings

The input format is recognized automatically. An error is however found for poles in input format 2 (real and imaginary) with all imaginary below 1 and all real parts positive (unstable poles). In this rare case you should change your frequency unit so that some of the imaginary parts are above 1.

Real poles are always put at the end. If you create your own residue matrices, make sure that there is no mismatch between the pole and residue order (the format for storing residues is described in section 5.6).

See also

idcom, id_rc, ii_plp