Contents     Functions         Previous Next     PDF Index



Transformations between the three accepted pole formats.


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


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


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


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


Format 3: frequency ω and damping ratio ζ


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


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

©1991-2019 by SDTools
Previous Up Next