1.9. Description of the Full Stiffness-Mass File

This section explains the contents of the full file (jobname.full).

1.9.1. Standard ANSYS File Header

See The Standard Header for ANSYS Binary Files for a description of this set. File number (Item 1) is 4.

1.9.2. FULL File Format

*comdeck,fdfull

c *** Copyright ANSYS.  All Rights Reserved.
c *** ansys, inc.

c     **********  description of full stiffness-mass file  **********

      character*8  FULLNM 
      parameter  (FULLNM='full    ')

c     *** NOTE: if this variable is changed in the future it should be
c     ***       updated in spdefines.h also for symbolic assembly (jrb)
      integer         FULLHDLEN
      parameter      (FULLHDLEN=160)

      LONGINT         fullfpL, fullfp
      integer         fullbk,  fullut, wrLdstep, wrSbstep, wrEqiter,
     x                wrOption
      common /fdfull/ fullfpL, fullbk, fullut,
     x                wrLdstep,wrSbstep,wrEqiter,wrOption
      equivalence  (fullfp,fullfpL)

c   ********** common variable descriptions ***********
co  fullfpL      file position on file full
co  fullbk       block number for file full
co  fullut       file unit for file full

c     **********  file format (except for extopt=3,4) **********

c   See fddesc for documentation of how binary files are stored.

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      160      .FULL FILE HEADER
c                                     
c                                  fun04,     neqn,    nmrow,   nmatrx,      kan,
c                                  wfmax,   lenbac,   numdof,  ntermKl,  ntermKh,   (10)
c                                  lumpm,    nmrow,   ntermK,   keyuns,   extopt,
c                                  keyse,   sclstf,   nxrows,  ptrSTFl,  ptrSTFh,   (20)
c                                ncefull,  ntermMh,  ptrENDl,  ptrENDh, ptrIRHSl,
c                               ptrIRHSh,  ptrMASl,  ptrMASh,  ptrDMPl,  ptrDMPh,   (30)
c                                 ptrCEl,   ptrCEh,   nNodes,  ntermMl,  ntermDl,
c                                ptrDOFl,  ptrDOFh,  ptrRHSl,  ptrRHSh,  ntermDh,   (40)
c                                ngMaxNZ, ptrNGPHl, ptrNGPHh, minKdiag, maxKdiag,
c                               minMdiag, maxMdiag, minDdiag, maxDdiag,  ngTerml,   (50)
c                                ngTermh, ngTermCl, ngTermCh,ptrDIAGKl,ptrDIAGKh,
c                              ptrDIAGMl,ptrDIAGMh,ptrDIAGCl,ptrDIAGCh, ptrSCLKl,   (60)
c                               ptrSCLKh,  Glbneqn,  distKey, ngTermFl, ngTermFh,
c                              GlbnNodes, GlbnVars, GlbfAcCE,  lcAcLen,   GlbfCE,   (70)
c                                ptrGmtl,  ptrGmth,nceGprime,numA12A11,GnVirtBCs,
c                                ntermGl,  ntermGh,ptrDensel,ptrDenseh, nVirtBCs,   (80)
c                              ptrVrtBCl,ptrVrtBCh,  ptrMRKl,  ptrMRKh, ptrKclxl,
c                               ptrKclxh, ntermKCl, ntermKCh,minKCdiag,maxKCdiag,   (90)
c                                  ngChg,   ptrBCl,   ptrBCh, ptrPHYSl, ptrPHYSh,
c                                predKey,fullDistF, ptrGVBCl, ptrGVBCh,    nzRow,  (100)
c                           localNonlKey,        0,        0,        0,        0,
c                                      0,        0,        0,        0,        0,  (120)
c                                      0,        0,        0,        0,        0,
c                                      0,        0,        0,        0,        0,  (140)
c                                      0,        0,        0,        0,        0,
c                                      0,        0,        0,        0,        0   (160)


c                                  each item in header is described below:

c                                   fun04  - negative of the unit number (-4)
c                                            NOTE: if fun04 is > 0 it means that
c                                                  frontal assembly was used (which
c                                                  is longer documented here)
c                                   neqn   - number of equations on file
c                                   nmrow  - number of active DOF (neqn-BC)
c                                   nmatrx - number of matrices on file
c                                   kan    - analysis type
c                                   wfmax  - maximum row size
c                                   lenbac - number of nodes
c                                   numdof - number of dofs per node
c                                   ntermKl,ntermKh - number of terms in Stiffness
c                                                     matrix
c                                   lumpm  - lumped mass key
c                                            = 0 - default matrix type
c                                            = 1 - lumped
c                                   ntermK - pre-8.1 this is the number of terms 
c                                            in Stiffness matrix (otherwise this 
c                                            value must be 0 and ntermKl,ntermKh 
c                                            must be used)
c                                   keyuns - unsymmetric key
c                                            = 0 - no unsymmetric matrices on 
c                                                   file
c                                            = 1 - there is at least one 
c                                                   unsymmetric matrix on file
c                                   extopt - mode extraction method
c                                            = 0 - reduced
c                                            = 1 - lumped
c                                            = 3 - unsymmetric Lanczos
c                                            = 4 - damped Lanczos
c                                            = 6 - block Lanczos
c                                            = 7 - QRdamped
c                                            = 8 - SuperNode
c                                            = 9 - PCG Lanczos
c                                   keyse  - superelement key; set if at least
c                                           one superelement
c                                   sclstf - maximum absolute stiffness matrix term
c                                   nxrows - the maximum rank for this solution
c                                   ptrSTFl,h  - pointer to Stiffness matrix
c                                   ncefull    - number of CE+CP equations
c                                   ptrENDl    - low part of 64 bit end of file ptr
c                                   ptrENDh    - high part of 64 bit end of file ptr
c                                   ptrIRHSl,h - pointer to imaginary RHS (F)
c                                   ptrMASl,h  - pointer to Mass matrix
c                                   ptrDMPl,h  - pointer to Damping matrix
c                                   ptrCEl,h   - pointer to Gt and g matrices
c                                   nNodes     - number of nodes considered by assembly
c                                   ntermMl,h  - number of terms in Mass matrix
c                                   ntermDl,h  - number of terms in Damping matrix
c                                   ptrDOFl,h  - pointer to DOF info
c                                   ptrRHSl,h  - pointer to RHS (F)
c                                   ngMaxNZ    - maximum number of nodes per nodal
c                                                block in nodal graph structure
c                                   ptrNGPHl,h - pointer to vectors needed for
c                                                nodal graph structure
c                                   minKdiag - minimum absolute stiffness matrix 
c                                              diagonal term
c                                   maxKdiag - maximum absolute stiffness matrix 
c                                              diagonal term
c                                   minMdiag - minimum absolute mass matrix 
c                                              diagonal term 
c                                   maxMdiag - maximum absolute mass matrix 
c                                              diagonal term 
c                                   minDdiag - minimum absolute damping matrix 
c                                              diagonal term 
c                                   maxDdiag - maximum absolute damping matrix 
c                                              diagonal term  
c                                   ngTerml,h  - total number of nonzeroes in nodal graph
c                                                 (expanded graph based value, no BC applied)
c                                   ngTermCl,h - total number of nonzeroes in nodal graph
c                                                 (compressed graph based value)
c                                   ptrDIAGKl,h - pointer to stiffness matrix DIAGONAL vector
c                                                 (NOTE: this is a copy of the diagonal
c                                                        values stored in the full matrix)
c                                   ptrDIAGMl,h - pointer to mass matrix DIAGONAL vector
c                                                 (NOTE: this is a copy of the diagonal 
c                                                        values stored in the full matrix)
c                                   ptrDIAGCl,h - pointer to damping matrix DIAGONAL vector
c                                                 (NOTE: this is a copy of the diagonal 
c                                                        values stored in the full matrix)
c                                   ptrSCLKl,h  - pointer to stiffness matrix diagonal scaling
c                                                 vector (may contain all 1.0's when not scaling)
c                                   Glbneqn  - global number of active DOF (this will match nmrow
c                                              unless we are writing distributed "local" FULL files
c                                              in Distributed ANSYS
c                                   distKey  - key denoting whether the FULL file is a single,
c                                              global FULL file (0) or multiple, local FULL file (1)
c                                   ngTermFl,h - total number of nonzeroes in nodal graph
c                                                as passed to the solver (after BC applied)
c                                   GlbnNodes - global number of nodes considered by assembly
c                                   GlbnVars  - global number of equations (will match neqn
c                                               unless we are writing distributed "local" FULL files
c                                               in Distributed ANSYS
c                                   GlbfAcCE  - total number of across CE
c                                   lcAcLen   - number of acrossCE where slaves are in my domain
c                                   GlbfCE    - total number of all the CE
c                                   ptrGmtl,h - pointer to G prime matrix for local nonlinearity
c                                   nceGprime - number of CE (or equations) in G prime local nonlinearity
c                                   numA12A11 - number of equations in local nonlinear matrix: excluding
c                                               equations from G prime
c                                   GnVirtBCs - global number of virtual constraints
c                                   ntermGl,ntermGh - total number of terms in total local nonlinear
c                                                     matrix including A12,A11 and G: total sum
c                                   ptrDensel,ptrDenseh - dense matrix information in local nonlinear
c                                                         matrix
c                                   nVirtBCs  - number of virtual constraints
c                                   ptrVrtBCl,ptrVrtBCh - pointer to the virtual constraint DOF data
c                                   ptrMRKl,h - pointer to the DOF marker array
c                                   0         - position not used
c                                   ptrKclxl,h - pointer to K complex (the 4th matrix) matrix
c                                                full case is: K, M, C, Kcplx: existing at same time
c                                   ntermKCl,h - number of terms in Complex Stiffness matrix
c                                   minKCdiag - minimum absolute complex stiffness matrix
c                                               diagonal term
c                                   maxKCdiag - maximum absolute complex stiffness matrix
c                                               diagonal term
c                                   ngChg     - key denoting whether or not the nodal graph written
c                                               to this FULL file differs from the previous FULL file
c                                   ptrBCl,h  - pointer to boundary condition data
c                                   ptrPHYSl,h - pointer to the physics marker array
c                                   predKey   - nonlinear analysis predictor key
c                                   fullDistF - indicate the global profiling of distributed full file
c                                   ptrGVBCl,ptrGVBCh - pointer to the global virtual constraint DOF data
c                                   nzRow - number of non-zero rows of the matrics for the full file under
c                                           global full file, -1 means not applicable
c                                   localNonlKey - local nonlinearity speedup key


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  ---      i       1      lenbac   Nodal equivalence table. This table equates
c                                   the number used for storage to the actual 
c                                   node number 

c  ---      i       1   Glblenbac   Global nodal equivalence table.  This record  
c                                   EXISTS ONLY for distributed .full files.
c
c Stiffness Matrix. The next two records are repeated as a group neqn times. 
c The pair of records will repeat GlbnVars times when model has across CEs.
c And row indices are global in the case.

c  STF      i       1      varies   Matrix row indices. The last item 
c                                   corresponds to the diagonal. The
c                                   length of this record will vary (actual 
c                                   length is returned from routine BINRD8)

c  ---   dp/cmp     1      varies   Matrix terms

c                                   If keyuns=0, this record will contain the 
c                                   terms before the diagonal.

c                                   If keyuns=1, this record will contain the 
c                                   entire row.
c          
c Load Vector

c  RHS   dp/cmp     1        neqn   Load vector terms.

c Imaginary part of Load Vector

c  IRHS    dp       1        neqn   Imaginary load vector terms.
c                                   This record EXISTS ONLY if its pointer in the header
c                                   is not zero. Record length will be GlbnVars for model
c                                   with across CE.

c Stiffness matrix diagonal vector

c  DIAGK   dp/cmp   1        neqn   diagonal vector data for stiffness matrix. Its length
c                                   will be GlbnVars for model with across CE.

c Stiffness matrix diagonal scaling vector

c  SCLK    dp/cmp   1        neqn   diagonal scaling vector for stiffness matrix. Record length
c                                   will be GlbnVars for across CE model.

c DOF marker array

c  MRK      i       1        neqn   marker array flagging various types of DOF
c                                   (1=U_EQN, 2=P_EQN, 3=E_EQN, 4=A_EQN).  Positive
c                                   values mean the DOF belongs to a user-defined node,
c                                   negative values mean the DOF belongs to an internal node.
c                                   Record length will be GlbnVars for models with across CE.

c PHYSICS marker array

c  PHYS     i       1        neqn   marker array flagging the various types of physics
c                                   (1=STRUCTURAL_EQN, 2=THERMAL_EQN, 3=ELECTRICAL_EQN,
c                                    4=MAGNETIC_EQN, 5=FLUID_EQN, 6=DIFFUSION_EQN)
c                                   Record length will be GlbnVars for models with across CE.

c DOF information

c  DOF      i       1      nNodes   Nodal extent vector. Number of DOFs at each node

c  ---      i       1   GlbnNodes   Global nodal extent vector giving numbers of DOFs at each 
c                                   global nodes. This record EXISTS ONLY for the model with
c                                   across CE.

c  ---      i       1   GlbnNodes   A vector mapping global node number to local node number.
c                                   -1 in the vector means the node is not in this domain.
c                                   This record EXISTS ONLY for model with across CE.

c  ---      i       1        neqn   DOF vector. If negative, this DOF is constrained.

c  ---      i       1    GlbnVars   A vector of global DOF reference numbers.  
c                                   this record EXISTS ONLY for the model with across CE.

c BC information

c  BC       i       1        neqn   DOFs with imposed values

c  ---   dp/cmp     1      varies   Imposed values

c Mass Matrix. 
c    if lumpm = 0:
c      The next two records are repeated as a group neqn times.
c      It will be in global form the same way as stiffness matrix if model has across CE.

c  MAS      i       1      varies   Matrix row indices. The last item 
c                                   corresponds to the diagonal. The
c                                   length of this record will vary (actual 
c                                   length is returned from routine BINRD8)

c  ---     dp       1      varies   Matrix terms

c    if lumpm = 1:
c  ---     dp       1        neqn   Matrix diagonals. 
c                                   Record length will be GlbnVars for across CE model.

c Mass matrix diagonal vector

c  DIAGM   dp       1        neqn   diagonal vector data for mass matrix. 
c                                   Record length will be GlbnVars for across CE model.

c Damping Matrix. The next two records are repeated as a group neqn times.
c For model with across CE, it will be in global form the same way as stiffness matrix.

c  DMP      i       1      varies   Matrix row indices. The last item 
c                                   corresponds to the diagonal. The
c                                   length of this record will vary (actual 
c                                   length is returned from routine BINRD8)

c  ---     dp       1      varies   Matrix terms

c Damping matrix diagonal vector

c  DIAGC   dp       1        neqn   diagonal vector data for damping matrix.
c                                   Record length will be GlbnVars for across CE model.

c K complex Matrix. The next two records are repeated as a group neqn times.
c For model with across CE, it will be in global form the same way as stiffness matrix.

c  KC      i       1       varies   Matrix row indices. The last item
c                                   corresponds to the diagonal. The
c                                   length of this record will vary (actual
c                                   length is returned from routine BINRD8)

c  ---     dp       1      varies   Matrix terms


c Nodal graph vectors

c  NGPH     i       1      nNodes   number of nonzeroes for each node.
c                                   Record length will be GlbnNodes for across CE model.

c   Repeat for each node

c           i       1      varies   Index vector. Node number in the vector is global when 
c                                   model has across CE.

c G matrix if ncefull > 0.

c  CE       i       1     ncefull   List of slave DOFs of local CEs.
c                                   It EXISTS ONLY if ncefull>0. The slave DOF is local.

c  ---      i       1      lcAcCE   List of slave DOFs of local across CEs.
c                                   This record EXISTS ONLY if lcAcCE>0. The slave DOF is
c                                   local.

c  ---      i       1    GlbfAcCE   List of slave DOFs of all across CEs. 
c                                   This record EXISTS ONLY if GlbfAcCE>0. And it is ONLY
c                                   in the full file of master domain.

c  ---      i       1      GlbfCE   List of slave DOFs of all CEs. This record EXISTS ONLY
c                                   if GlbAcCE>0.  And it is ONLY in the full file of the
c                                   master domain.

c  ---     dp       1     ncefull   g vector (constant terms) of local CEs. This record
c                                   EXISTS ONLY if ncefull>0.

c  ---     dp       1     ncefull   imaginary g vector (constant terms) of local CEs. This
c                                   vector only exists for FULL harmonic analyses (kan=3).
c                                   This record EXISTS ONLY if ncefull>0.

c  ---     dp       1     ncefull   g vector (constant terms) of local CEs for nonlinear
c                                   analysis predictor logic.
c                                   This record EXISTS ONLY if ncefull>0 & predKey=1.

c  ---     dp       1    GlbfAcCE   g vector (constant terms) of across CEs. This record
c                                   EXISTS ONLY if GlbfAcCE>0 in the master full file.

c  ---     dp       1    GlbfAcCE   imaginary g vector (constant terms) of across CEs. This
c                                   vector only exists for FULL harmonic analyses (kan=3).
c                                   This record EXISTS ONLY if GlbfAcCE>0 in the master full file.

c  ---     dp       1    GlbfAcCE   g vector (constant terms) of across CEs for nonlinear
c                                   analysis predictor logic.  This record EXISTS ONLY
c                                   if GlbfAcCE>0 & predKey=1 in the master full file.

c  Following local CE data records EXIST ONLY in the full file of the domain with local CEs:
c  ---      i       1           4   Header for local CEs; 1=nRows, 2=nRows, 3=1, 4=0

c  ---      i       1       nRows   Vector of 1's

c  ---      i       1       nRows   Number of non-zero terms in each row for one local CE

c   Repeat for each row:

c  ---      i       1      varies   Column indices in local equation numbers

c  ---     dp       1      varies   Column values


c   Following across CE data records EXIST ONLY if GlbfAcCE>0 in the full file of master domain:
c  ---      i       1           4   Header for across CEs; 1=nRows, 2=nRows, 3=1, 4=0

c  ---      i       1       nRows   Vector of 1's

c  ---      i       1       nRows   Number of non-zero terms in each row for an across CE

c   Repeat for each row:

c  ---      i       1      varies   Column indices in global equation numbers

c  ---     dp       1      varies   Column values


c   Following CE data records EXIST ONLY if n>0 in the full file, where n == ncefull with
c   SMP and n == GlbfCE with DMP.  NOTE: for DMP these records only exist in the .full file
c   of master domain

c  ---      i       1           n   List of slave DOFs of all CEs. This record EXISTS ONLY
c                                   if n>0.  And it is ONLY in the full file of the master
c                                   domain.

c   NOTE: this matrix includes boundary d.o.f. which touch the CEs (for cnvfor.F)
c  ---      i       1           4   Header for across CEs; 1=nRows, 2=nRows, 3=1, 4=0

c  ---      i       1       nRows   Vector of 1's

c  ---      i       1       nRows   Number of non-zero terms in each row for an across CE

c   Repeat for each row:

c  ---      i       1      varies   Column indices in global equation numbers

c  ---     dp       1      varies   Column values




c Virtual constraint vector

c  VBC      i       1    nVirtBCs   marker array (bit 1 set -> constrained DOF for residual vector)
c                                                (bit 2 set -> constrained DOF for enforced motion)
c                                                (bit 3 set -> eliminated DOF for substructure master DOF)
c           i       1    nVirtBCs   virtual constraint DOFs

c  GVBC     i       1    GnVirtBCs  marker array (bit 1 set -> constrained DOF for residual vector)
c                                                (bit 2 set -> constrained DOF for enforced motion)
c                                                (bit 3 set -> eliminated DOF for substructure master DOF)

c                                   this record EXISTS ONLY for the model with across CE.

c           i       1    GnVirtBCs  virtual constraint DOFs
c                                   this record EXISTS ONLY for the model with across CE.


c  Meaning of K11, K12, and G matrices:
c     Given
c         [K]{x} = {F}
c     subject to the constraints
c           {x1} = [G]{x2} + {g}
c     where {x1} are the slave DOFs, {x2} the master DOFs

c     This results in
c         [K*]{x2} = {F*}
c     where
c         [K*] = [G]'[K11][G] + [G]'[K12] + [K21][G] + [K22]
c         {F*} = [G]'{f1} + {f2} - [G]'[K11]{g} - [K21]{g}

c complex version of {F*} decomposed into, we assume G' is always real
c and g could be complex denoted as g' == (g,gx) :
c         G' K11' g' = G' (K11,M11)*(g,gx) 
c                    = G' [K11*g - M11*gx, M11*g + K11*gx]

c         K21' *g'   = (K21,M21)*(g,gx)
c                    = (K21*g- M21*gx, K21*gx + M21*g)



Release 18.2 - © ANSYS, Inc. All rights reserved.