This section explains the content of the modal results file (jobname.mode).
See The Standard Header for ANSYS Binary Files for a description of this set. File number (Item 1) is 9.
*comdeck,fdmode
c *** Copyright ANSYS. All Rights Reserved.
c *** ansys, inc.
c ********** description of modal result file **********
character*8 MODENM
parameter (MODENM='mode ')
character*8 MODENM_LEFT
parameter (MODENM_LEFT='lmode ')
c *** NOTE: if this variable is changed in the future it should be
c *** updated in spdefines.h also for symbolic assembly (jrb)
integer MODEHDLEN
parameter (MODEHDLEN=100)
LONGINT modefpL
integer modebk, modeut
LONGINT modeLeftfpL
integer modeLeftbk, modeLeftut
common /fdmode/ modefpL, modebk, modeut,
x modeLeftfpL, modeLeftbk, modeLeftut
c ********** common variable descriptions ***********
co modefpL file position on file mode
co modebk block number for file mode
co modeut file unit for file mode
co modeLeftfpL file position on file .lmode
co modeLeftbk block number for file .lmode
co modeLeftut file unit for file .lmode
c See fddesc for documentation of how binary files are stored.
c
c ********** file format **********
c recid tells the identifier for this record. Not all records will have
c identifiers -- they are only indicated for those records whose
c record pointers are stored in the second file header.
c type tells what kind of information is stored in this record:
c i - integer
c dp - double precision
c cmp - complex
c nrec tells how many records of this description are found here
c lrec tells how long the records are (how many items are stored)
c recid type nrec lrec contents
c --- i 1 100 standard ANSYS file header (see binhed for
c details of header contents)
c --- i 1 100 .MODE FILE HEADER
c
c fun09, nmrow, nmatrx, nmode, numdof, < 5
c maxn, wfmax, lenbac, nEnfGrp, neqns, < 10
c lumpms, extopt, SvCode, kan, ldstep, < 15
c numitr, expbeg, expend, nspect, nSPdat, < 20
c ptrRDF, ptrFRQ, kPerturb, ptrSHP, ptrLOD, < 25
c ptrSTF, ptrMAS, ptrDMP,nrkeyPert, nrigid, < 30
c ptrLPM, ptrSP1, ptrSHPh, ptrLODh, ptrSTFh, < 35
c ptrMASh, ptrDMPh, ptrLPMh, ptrSP1h, ptrIRHSl, < 40
c ptrIRHSh, PowerDyn, ptrRES, ptrRESh,Glblenbac, < 45
c KeyStress, ptrELD, ptrELDh, ptrGBk, ptrGBkh, < 50
c modlstp, nresi, ptrEf1, ptrEf1h, sstif, < 55
c ptrFSTA, ptrEf2, ptrEf2h, ptrEf3, ptrEf3h, < 60
c qrDampKey,cycMSUPkey,cycnmode, ptrHI, ptrKUNS, < 65
c ptrKUNSh, mrestart, LPrestls, LPrestss, cpxmod, < 70
c keyLeft, cpxlv, 0, 0, 0, < 75
c 0, 0, 0, 0, 0, < 80
c 0, 0, 0, 0, 0, < 85
c 0, 0, 0, 0, 0, < 90
c 0, 0, 0, 0, 0, <100
c each item in header is described below:
c fun09 - unit number (mode file is 9)
c nmrow - number of rows/columns in matrices
c (maxn*numdof). If extopt=0, nmrow
c is the number of rows in the
c reduced matrices and the number of
c master degrees of freedom.
c nmatrx - number of reduced matrices on the
c file (applies only if extopt=0)
c nmode - number of modes extracted
c numdof - number of dof per node
c maxn - maximum node number (if extopt=3
c or 4, the actual number of nodes is
c referenced.)
c wfmax - maximum wavefront (does not apply
c if extopt=3 or 4)
c lenbac - number of nodes
c nEnfGrp - numbre of enforced group
c neqns - number of equations on the .LN22
c file (does not apply if extopt=0)
c lumpms - lumped mass key
c = 0 - default matrix type
c = 1 - lumped
c (does not apply if extopt=3 or 4)
c extopt - mode extraction method
c = 0 - reduced
c = 3 - unsymmetric Lanczos
c = 4 - damped Lanczos
c = 6 - block Lanczos
c = 8 - SuperNode
c = 9 - PCG Lanczos
c SvCode - Solver assembly code
c = 0 Frontal assembly (SV_ANSYS)
c = 1 Symbolic assembly (SV_CASI)
c kan - analysis type
c = 1 - buckling
c = 2 - modal
c ldstep - load step number - also number of load vectors
c numitr - total number of cumulative
c iterations done during analysis
c (does not apply if extopt=3 or 4)
c expbeg - beginning of the frequency range of
c interest
c expend - end of the frequency range of
c interest
c nspect - number of spectra; if -6, these are
c the 6 default unit spectra
c nSPdat - number of data items per spectrum
c ptrRDF - pointer to reduced degree of
c freedom set used in model
c ptrFRQ - pointer to the frequencies
c kPerturb - Linear Perturbation key
c ptrSHP - pointer to the mode shapes
c (eigenvectors)
c ptrLOD, ptrLODh - pointer to the load vectors
c ptrSTF - pointer to the reduced stiffness
c matrix
c ptrMAS - pointer to the reduced mass matrix
c ptrDMP, ptrDMPh - pointer to the reduced/modal damping
c matrix
c ptrKUNS, ptrKUNSh - pointer to the modal stiffness
c matrix (unsymmetric part)
c nrkeyPert - nrkey setting of base analysis (Linear Pertubation)
c nrigid - number of rigid body modes
c ptrLPM - pointer to the diagonal mass vector
c ptrSP1 - pointer to the the spectrum data
c ptrIRHSl,h - pointer to imaginary part of RHS vector
c PowerDyn - PowerDynamics key
c = 0 non-PowerDynamics method
c = 1 PowerDynamics method
c ptrRES,ptrRESh - pointer to residual vectors
c Glblenbac - global number of nodes (for D-ANSYS)
c ptrGBk,ptrGBkh - pointer to global nodal equivalence table
c modlstp - multiple load step key
c nresi - number of residual vectors in file
c KeyStress - key set if mode stresses on file
c ptrELD,ptrELDh - pointer to element records
c ptrEf1,ptrEf1h - pointer to enforced motion dof information
c sstif - key denoting prestress effects are included,
c this key is for internal usage only. SSTIF,on
c or off is controlled by NLGEOM on or off now.
c ptrFSTA - pointer to fstacm data
c ptrEf2,ptrEf2h - pointer to enforced motion modes
c ptrEf3,ptrEf3h - pointer to enforced motion force
c qrDampKey - QR damped calcaulations key
c cycMSUPkey - mode file format is for subsequent cyclic MSUP
c (only base results on file)
c cycnmode - total number of cyclic modes extracted
c (sum of all harmonic indices)
c ptrHI - pointer to harmonic indices
c mrestart - key for modal restart (=0 none, =1 modal restart)
c LPrestls - restarted load step (from linear perturbation)
c LPrestss - restarted substep (from linear perturbation)
c cpxmod - key for complex frequencies/shapes (0=no 1=yes)
c keyLeft - key for LMODE writing (0=no 1=yes)
c cpxlv - key for RHS vector in complex form (0=no 1=yes)
c = 0 no (before version 17.0)
c = 1 yes (since version 17.0) ; ptrIRHSl,h is 0
c 0 - position not used
c --- i 1 numdof Degrees of freedom per node
c DOF reference numbers are:
c UX = 1, UY = 2, UZ = 3, ROTX= 4, ROTY= 5, ROTZ= 6, AX = 7, AY = 8
c AZ = 9, VX =10, VY =11, VZ =12 ****** 13-18 are spares **********
c **************** PRES=19, TEMP=20, VOLT=21, MAG =22, ENKE=23, ENDS=24
c EMF =25, CURR=26 ********* 27-32 are spares *************************
c (curdof(i),i=1,numdof)
c --- i 1 lenbac Nodal equivalence table
c This table equates the number used for
c storage to the actual node number.
c (Back(i),i=1,lenbac)
c GBK i 1 Glblenbac Global nodal equivalence table
c This table equates the number used for
c storage to the actual global node number.
c (GlbBack(i),i=1,Glblenbac)
c FSTA dp 1 30 fstacm.inc information (mass and MofI)
c RDF i 1 nmrow Reduced set of degrees of freedom used.
c This record is present only if extopt=0
c The DOFs are calculated as (N-1)*NUMDOF+DOF,
c where N is position number of the node in
c the nodal equivalence table and DOF is the
c DOF reference number given above
c (l(i),i=1,nmrow) (if nmatrx>0)
c HI i 1 cycnmode Signed harmonic index for each extracted frequency.
c Only present if cycMSUPkey=1.
c FRQ dp/cmp 1 nf Frequencies (eigenvalues).
c Frequencies are complex if cpxmod=1 or qrdampKey=1.
c If frequencies are real, numbers stored are
c the squares of the natural circular
c frequencies (w**2, where w=radians/time).
c You can obtain the natural frequencies, f
c (in cycles/time), using the equation f=w/2pi
c If frequencies are complex, numbers stored are
c the natural frequencies (Hz)
c (freq(i),i=1,nf)
c nf = nmode+nresi
c if cycMSUPkey=1 then
c nf = cycnmode
c SHP dp/cmp ns nmrow Mode shapes (eigenvectors). Mode shapes are
c complex if cpxmod=1. If extopt=0, the
c mode shape order corresponds to the DOF list
c stored at position ptrRDF. If extopt does
c not equal 0, the order corresponds to the
c nodal equivalence table
c (psi(i,j),i=1,nmrow)
c ns = nmode
c if cycMSUPkey=1 then
c ns = cycnmode
c RES dp nresi nmrow Residual vectors
c LOD cmp ldstep nmrow Load vectors in complex form (since version 17.0)
c (f(i),i=1,nmrow)
c Before version 17.0, records were (cpxlv=0):
c LOD dp ldstep nmrow Load vectors
c (f(i),i=1,nmrow)
c IRHS dp ldstep nmrow Imaginary Load vectors
c (fimag(i),i=1,nmrow)
c LPM dp 1 nmrow Lumped mass vector. This record is present
c only if lumpms=1 and nmatrix=0. It is a
c vector containing the mass at each node in
c the system.
c (mass(i),i=1,nmrow)
c STF dp nmrow nmrow Reduced stiffness matrix. Each row of the
c matrix is stored as a record. The matrix is
c present only if nmatrx > 0. Row order is the
c same as the DOF order stored at position
c ptrRDF.
c (ak(i,j),i=1,nmrow)
c MAS dp nmrow nmrow Reduced mass matrix. Each row of the matrix
c is stored as a record. The matrix is present
c only if nmatrx > 1. Row order is the same as
c the DOF order stored at position ptrRDF.
c (am(i,j),i=1,nmrow)
c DMP dp nmrow nmrow Reduced/modal damping matrix. Each row of the
c matrix is stored as a record. If extopt=0,
c the row order is the same as the DOF order
c stored at position ptrRDF.
c (ac(i,j),i=1,nmrow)
c KUNS dp nmrow nmrow Modal unsymmetric stiffness matrix. Each row of the
c matrix is stored as a record.
c (aku(i,j),i=1,nmrow)
c EF1 int 1 nEnfGrp (groupID(i),i=1,nEnfGrp)
c int 1 nEnfGrp (grpdof(i),i=1,nEnfGrp)
c dp nEnfGrp grpdof(i) dofIndx(i,j) i=1,grpdof(j)
c The above records contain information about each
c enforced motion group.
c EF2 dp nEnfGrp nmrow Enforced static modes
c EF3 dp nEnfGrp nmrow Enforced forced vector
c for each spectrum (|nspect| records):
c SP1 dp 1 nmode+nresi Participation factors for this spectra
c --- dp 1 nmode+nresi Mode coefficients for this spectra
c --- dp 1 nmode+nresi Modal damping values
c --- dp 1 613 svcom.inc (freqtb,...)
c --- dp 1 20 misc. spectra data
c ELD int 1 15 nelm, mask, nItems, ptrELM, ptrERS,
c ptrCER,ptrCERh, ptrESL,ptrESLh, nRF
c ptrFR, ptrRFh, PrecKey
c each item in header is described below:
c nelm - number of elements
c mask - output mask (OUTRES)
c nItems - number of element records (7, VOL
c not included)
c ptrELM - pointer to element equivalence table
c ptrERS - pointer to element record sizes
c ptrCER,h - pointer to constant element records
c ptrESL,h - pointer to element index
c nRF - number of reaction forces
c ptrRF,h - pointer to reaction forces
c PrecKey - 0, double precision 1, single
c above pointers are relative to ptrELD
c --- int 1 2*nItems Total size of each element record (LONGINT)
c ELM int 1 nelm Element equivalence table
c This table equates the order number used to
c the actual element number
c ERS int nItems nelm Sizes of the nItem element results sets for
c each element
c CER int 1 5 ptrVOL, ptrEPT, ptrEUL, 0, 0
c above pointers are relative to ptrCER
c constant element records (do not vary by mode):
c VOL dp 1 nelm*1 Element volume
c EPT dp 1 nelm*size Element structural nodal temperatures
c EUL dp 1 nelm*size Element Euler angles
c ESL int 1 10 ptrENS, ptrEEL, ptrEMS, ptrENF, ptrENG,
c ptrENSh,ptrEELh,ptrEMSh,ptrENFh,ptrENGh
c above pointers are relative to ptrESL
c non-constant element records (do vary by mode):
c ENS dp nelm nmode*size Element nodal component stresses
c EEL dp nelm nmode*size Element nodal component elastic strains
c EMS dp nelm nmode*size Element summable miscellaneous data
c ENF dp nelm nmode*size Element nodal forces
c ENG dp nelm nmode*3 Element energies
c see fdresu.inc for more information on the element results