cmif


Purpose

Compute complex mode indicator function

Syntax

mif=cmif(f,ref,res,'tracking')
mif=cmif(f)
[mif,refshp,resshp]=cmif(f,...)
[mif,refshp]=cmif(f,...)
[mif,refshp,resshp,res,ref]=cmif(f,tam)

Description

CMIF computes the complex mode indicator function.

MIF=CMIF(F,REF,RES) returns an imat_fn containing complex mode indicator functions for the requested reference and response coordinate traces. All reference/response pairs must be present in F. The output MIF will be dimensioned nmif x 1, where nmif=min(nref,nres).

MIF=CMIF(F) uses all references and responses present in F.

MIF=CMIF(F,...,'tracking') includes cmif tracking. If the tracking option is not used, the the CMIF functions are sorted by decreasing magnitude at each spectral line. When the tracking option is used, the CMIF functions are sorted based on the similarity of the left singular vectors between adjacent spectral lines. The left singular vectors are compared by determining the maximum inner product for the vectors from adjacent spectral lines, and the singular values are sorted accordingly.

[MIF,REFSHP,RESSHP]=CMIF(F,...) also returns complex shape functions in the multidimensional arrays REFSHP and RESSHP. REFSHP will be dimensioned nref x nmif x nfreq, and RESSHP will be dimensioned nres x nmif x nfreq. These arrays provide shape information to go with each CMIF value at each frequency. The order of the shapes is the same as the order of the REF and RES coordinate traces.

[MIF,RESSHP,REFSHP,RES,REF] = CMIF(F,...,TAM) computes the mass-weighted TAM using the supplied TAM structure containing at minimum the fields .mass (mass matrix) and .aset (DOF corresponding to the mass matrix). When the TAM is supplied, the 'tracking' and 'reftrack' options are not valid, and RES may not be supplied (RES = TAM.aset). RES is an imat_ctrace whose DOF correspond to the rows in RESSHP. REF is an imat_ctrace whose DOF correspond to the rows in REFSHP.

[MIF,REFSHP]=CMIF(F,...) returns only the shapes at references.

Examples

>> mif=cmif(f);

See Also

mmif, nmif, psmif