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
{  , |
| - |
|
| |
|
}=
{ a ± i b} =
{-  ±(1-2)1/2}
|
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
|
po = { |
|
} for example |
| po=[-0.0200 + 1.9999i |
| -0.0200 - 1.9999i |
| -1.0000] |
|
|
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
|
po = [ |
|
] for example |
| po=[-0.0200 1.9999 |
| -1.0000 0.0000] |
|
Format 3: frequency and damping ratio
|
po = [ |
| 1 |
1 |
·
·
· |
·
·
· |
|
] for example |
| po=[ 2.0000 0.0100 |
|
-1.0000 1.0000] |
|
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 2.6).
See also
idcom, id_rc, ii_plp
©1991-2007 by SDTools
