Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Technical Support
Main Index
DMAP Programmers Guide
About This Book
viii
About This Book
The MSC Nastran 2012 DMAP Programmer's Guide is a replacement for and update of the former
Version 2005 r3 DMAP Modules and Data Blocks book. Contained in this Guide is the introduction to
DMAP, syntax and concepts, data block descriptions, and NDDL statement descriptions. The guide also
contains material that is more frequently referenced: the DMAP Module descriptions.
Main Index
ix Preface
List of MSC Nastran Books
List of MSC Nastran Books
Below is a list of some of the MSC Nastran documents. You may find any of these documents from
MSC.Software at http://simcompanion.mscsoftware.com.
Installation and Release Guides
Installation and Operations Guide
Release Guide
Guides
Reference Books
Quick Reference Guide
DMAP Programmers Guide
Reference Manual
Users Guides
Getting Started
Linear Static Analysis
Dynamic Analysis
MSC Nastran Demonstration Problems
Thermal Analysis
Superelements
Design Sensitivity and Optimization
Implicit Nonlinear (SOL 600)
Explicit Nonlinear (SOL 700)
Aeroelastic Analysis
User Defined Services
EFEA Users Guide
EFEA Tutorial
EBEA Users Guide
Main Index
DMAP Programmers Guide
Technical Support
x
Technical Support
For technical support phone numbers and contact information, please visit:
http://www.mscsoftware.com/Contents/Services/Technical-Support/Contact-Technical-Support.aspx
Support Center (www.simcompanion.mscsoftware.com)
Support Online. The Support Center provides technical articles, frequently asked questions and
documentation from a single location.
Main Index
Chapter 1: Direct Matrix Abstraction
DMAP Programmers Guide
1
Direct Matrix Abstraction
Introduction
Data Blocks
Instructions
Introduction
Table Descriptions
NDDL Summary
X | | A | | B | | C | | or X | | A | |
T
B | | C | | = =
X | | A | | normalized to 1.0 maximum in each column =
A | |
A11 A12
A21 A22
Main Index
MSC Nastran DMAP Programmers Guide
DMAP Module and Statement Description Summary
586
Utility Modules
UMERGE1
UPARTN
Module Basic Function
APPEND Concatenates two data blocks.
COPY Copies a data block.
DBC Converts data blocks for model generation and results processing.
DBDICT Prints database directory tables with optional user-selectable format.
DMIIN Converts DMI Bulk Data entries to data blocks.
DRMS1 Recovers data by mode superposition.
DTIIN Converts DTI Bulk Data entries to data blocks.
ELTPRT Prints element summary information.
IFP1 Reads in the Case Control Section.
IFP, IFP3
through IFP9
Converts the output from the XSORT module into several tables.
INPUTT2 Reads data blocks from FORTRAN-readable files.
INPUTT4 Reads matrices from FORTRAN-readable files.
LAMX Edits or generates real or complex eigenvalue summary table.
MATGEN Generates special matrices, such as identities, etc.
MATGPR Prints matrices with grid point and component identification.
MATMOD Transforms a collection of input matrices into output matrices.
MATPCH Punches the contents of matrix data blocks onto DMI Bulk Data entries.
MATPRN Prints general matrix data blocks (10 items per line).
MATPRT Prints matrix data blocks (6 items per line).
MERGEOFP Merges linear and nonlinear stress data blocks from SDR2.
MESSAGE Prints user defined messages.
MODACC Partitions solution vectors based on the OTIME or OFREQ Case Control
command.
Module Basic Operation
K
i i
| |
K
j j
K
jl
K
l j
K
ll
or
K
j l
K
j j
K
j l
K
ii
| |
K
j j
K
j l
K
l j
K
l l
or P
i
{ }
P
j
P
l
-----
)
`
Main Index
587 Chapter 4: DMAP Modules and Statements
DMAP Module and Statement Description Summary
Executive Modules and Statements
MODTRL Modifies data block trailer data.
MTRXlN Converts DMIG Bulk Data entries to matrix data blocks.
OFP Provides user-oriented self-explanatory formats for data blocks prepared by other
functional modules (e.g., READ, CEAD, SDR2, etc.).
OUTPUT2 Writes tables or matrices onto FORTRAN-readable files.
OUTPUT4 Writes matrices onto FORTRAN-readable files.
PARAML Selects parameters from a user input matrix or table.
PRTPARM Prints parameter values and DMAP error messages.
PVT Sets parameter values from Case Control and/or Bulk Data PARAM entries.
RESTART Compares two data blocks and/or invokes dependencies defined in the NDDL.
SCALAR Selects parameters from a user input matrix or table.
SEQP Generates a mapping matrix for use in resequencing matrices.
TABEDlT Edits tables.
TABPRT Prints selected table data blocks using user-oriented formats.
TABPT Prints table data blocks.
TIMETEST Computes timing data.
VEC Generates partitioning vector.
VECPLOT Transforms, searches, and computes resultants of vectors.
XSORT Reads in the Bulk Data Section.
Module or Statement Basic Function
DBVIEW Creates a virtual data block from an NDDL data block.
DELETE Deletes a data block(s) from the database.
EQUIVX Assigns another name to a data block.
FILE Defines special data block characteristics to DMAP compiler.
PURGEX Flags a data block as empty on the database.
TYPE Identifies NDDL data blocks and parameters.
Module Basic Function
Main Index
MSC Nastran DMAP Programmers Guide
DMAP Module and Statement Description Summary
588
Obsolete Modules and Statements
The following modules are obsolete and are not described in this guide. They are either no longer
available or not recommended:
DMAP Module or Statement Alternate Method or Modules
COND IF and IF ( ) THEN statement
DBDIR DBDICT statement
DYNCTRL None
DYNREDU None
EQUIV EQUIVX module
INREL SubDMAP SEMR3
PARAM Function and assignment statements
PARAMR Function and assignment statements
PURGE PURGEX module
RBMG2 DECOMP
REIGL READ module
REPT DO WHILE statement
SCE1 UPARTN
SETVAL Assignment statement
SMP2 UPARTN, MPYAD, SMPYAD
TASN TASNP2
Main Index
589 ACMG
Detailed Descriptions of DMAP Modules and Statements
Detailed Descriptions of DMAP Modules and
Statements
The following descriptions of commonly used DMAP modules are in alphabetical order.
Computes the coupling matrix for fluid/structure interface at all points or only points on a given structural
panel.
Input Data Blocks:
Output Data Blocks:
ACMG
Computes fluid/structure coupling matrix
ACMG PANSLT,BGPDT,CSTM,SIL,ECT,EQACST,NORTAB,EQEXIN,EDT/
/
LUSET/MPNFLG/NUMPAN/S,N,PANAME/IPANEL/MATCH/
PNLPTV $
PANSLT Panel static load table.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
ECT Element connectivity table.
EQACST Equivalence between internal fluid grid points and internal structural grid points
which lie on the fluid/structure boundary.
NORTAB Table containing fluid face and the maximum of eight structural grids which lie
within the acoustic face.
EQEXIN Equivalence between external grid/scalar and internal identification numbers.
EDT Element deformation table. Contains SET1 entries.
AGG Fluid/structure coupling matrix at all points or for a structural panel.
APART Partitioning vector for panel coupling matrix when PNLPTV=TRUE.
AGG
APART
)
`
Main Index
ACMG
Computes fluid/structure coupling matrix
590
Parameters:
Remarks:
1. MPNFLG, NUMPAN, and MATCH are computed by the GP5 module, whereas the IPANEL
parameter is incremented in DMAP.
2. PANSLT, BGPDT, and SIL cannot be purged if fluid structure interaction is to be considered.
CSTM cannot be purged if any grid point references a coordinate system other than basic.
Example:
Compute global coupling matrices for all points:
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
MPNFLG Input-integer-default=0. Set to 1 if multiple panels exist.
NUMPAN Input-integer-default=1. Number of panels.
PANAME Output-character-default='NASTPANL'. Name of the panel whose coupling matrix
is created.
IPANEL Input-integer-default=1. Number of records to skip to get the required data in the
PANSLT table.
MATCH Input-integer-default=0. Type of fluid/structural mesh matching.
0 Matching mesh
1 Nonmatching mesh
PNLPTV Input-logical-default=FALSE. Panel participation/partition vector flag. If TRUE,
then generate a partitioning vector APART which may be used to partition the g-set
size coupling matrix to obtain the panel's coupling matrix.
GP5 ECTS,BGPDTS,EQEXINS,EDT,SILS/
PANSLT,EQACST,NORTAB/
S,N,MPNFLG//S,N,MATCH/NASOUT $
ACMG PANSLT,BGPDTS,CSTMS,SILS,ECTS,EQACST,NORTAB,EQEXINS/
AGG/LUSETS/////MATCH $
Main Index
591 ACMG
Computes fluid/structure coupling matrix
Compute coupling matrices for all structural panels:
GP5 ECTS,BGPDTS,EQEXINS,EDT,SILS/
MPNSLT,EQACST,MNRTAB/
MPNFLG/S,N,NUMPAN/S,N,MATCH $
IPANEL=1 $
DO WHILE ( IPANEL<=NUMPAN ) $
ACMG MPNSLT,BGPDTS,CSTMS,SILS,ECTS,EQACST,MNRTAB,EQEXINS/
ABE/LUSETS/MPNFLG/NUMPAN/S,N,PANAME/IPANEL/MATCH $
IPANEL=IPANEL+1 $
ENDDO $ IPANEL<=NUMPAN
Main Index
ADAMSMNF
Generate files for MSC.Adams
592
Generate modal neutral files using the MSC.Adams/FLEX MNF toolkit.
Format:
Input Data Blocks:
ADAMSMNF
Generate files for MSC.Adams
ADAMSMNF UNITS,BGPDT,GEOM2,GEOM4,CMBXPHG,MABXWGG,MXWAA,KXWAA,
PXA,GPSETS,ELSET,OGS1,OGSTR1,OGPWGBW,CASECC,PCDB/
BAAEA,OGS1P,OGTR1P/
M9I/
QUALNAM/SEID/NOSE/LUSET/NOASET/MNFOUT/OUTGS1/
OUTGSTR1/MINVAR/PSETID/CCSET/PRECOL/WTMASS $
UNITS Table of units. Usually input by the user via DTI Bulk Data entries.
BGPDT Basic grid point definition table.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
CMBXPHG Matrix of component modes transformed to the basic coordinate system and and
row-ordered in external grid identification number sequence.
MABXWGG Mass matrix for the a-set, expanded to g-set, transformed to the basic coordinate
system, row-ordered in external grid identification number sequence, and divided by
WTMASS.
MXWAA Mass matrix for the a-set, row-ordered in external grid identification number
sequence and divided by WTMASS.
KXWAA Stiffness matrix for the a-set, row-ordered in external grid identification number
sequence and divided by WTMASS.
PXA Matrix of modally reduced static loads.
GPSETS Table of grid point sets related to the element plot sets.
ELSET Table of element sets defined in OUTPUT(PLOT) Section of Case Control.
OGS1 Table of grid point stresses in SORT1 format.
OGSTR1 Table of grid point strains in SORT1 format.
OGPWGBW Grid point weight generator table transformed to the basic coordinate system divided
by WTMASS.
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
Main Index
593 ADAMSMNF
Generate files for MSC.Adams
Output Data Blocks:
Parameters:
BAAEA Modal damping matrix.
OGS1P Table of grid point stresses due to preload.
OGSTR1P Table of grid point strains due to preload.
M9I Table of the nine mass invariants.
QUALNAM Input-character-default=' '. Name of qualifier to be used in selecting data blocks
qualified by SEID.
SEID Input-integer-default=0. Superelement identification number.
NOSE Input-integer-default=0. Number of superelements extracted from trailer of SEMAP.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NOASET Input-integer-default=0. The number of degrees-of-freedom in the a-set.
MNFOUT Input-character-default='MNF'. Output control of modal neutral file and nine mass
invariants, M9I:
'MNF' Modal neutral file only
'NINEMAI' M9I only
'BOTH' Modal neutral file and M9I
OUTGS1 Input-character-default='YES'. Output control of OGS to modal neutral file.
OUTGSTR1 Input-character-default='YES'. Output control of OGSTR1 to modal neutral file.
MINVAR Input-character-default='FULL'. Type of coupling for output of nine mass
invariants, M9I:
CONSTANT' 1, 2, 6 AND 7 only
'PARTIAL' All except 5 and 9
'FULL' All
'NONE' None
PSETID Input-integer-default=-1. Plot set identification number in GPSETS and ELSET
record. If GPSET or ELSET is not found then it is set identification number defined
in CASECC which specifies a collection of GPSETS and ELSET set IDS which in
turn DEFINE a set of nodes and elements to MSC.Adams:
-1 All grids and element plot sets present in GPSET and ELSET sets.
Main Index
ADAMSMNF
Generate files for MSC.Adams
594
Remarks:
1. The invariants can be output to the MNF file only if MINVAR<>'NONE'.
0 None; no plot set is used to restrict element and grid output; all grids and
elements will be output.
>0 All grids and element plot sets present in SET=PSETID.
CCSET Input-integer-default=-1. Case Control set identification number which specifies a
set of grids to be used for the N1,N2... list of the COARSEN option. (Reserved for
possible future implementation.)
PRECOL Input-integer-default=-1. Column number of preload vector in PXA. If
PRECOL<=0, then there is no preload.
WTMASS Input-real-default=1.0. Scale factor on structural mass matrix.
Main Index
595 ADAMSRBM
Calculates rigid body motion based on MSC.ADAMS results
Calculates rigid body motion based on MSC.ADAMS results.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ADAMSRBM
Calculates rigid body motion based on MSC.ADAMS results
ADAMSRBM RBH,UGX,CSTM,BGPDT/URGB/APP $
RBH Large motion matrix computed by MSC.ADAMS. RBH contains six rows: the
first 3 rows are large translations and the next 3 rows are Euler angles.
UGX Solution matrix in g-set from frequency or transient response analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
UGRB UGX matrix updated with large motion (RBH).
APP Input-character-default=' '. Analysis type.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
Main Index
ADAPT
Performs and prints error estimate for current p-values
596
Performs and prints error estimate for current p-values and generates a new set of
p-values for next adaptivity loop.
Format:
Input Data Blocks:
ADAPT
Performs and prints error estimate for current p-values
ADAPT CASECC,EPT,EDT,EST,ELEMVOL,VIEWTB,UG,MPT,ETT,
CSTM,PVAL0,ERROR0,PELSET,DEQATN,DEQIND,DIT,OINT,
GEOM4,BGPDT,GPSNT,EPSSE,LAMA,GLERR/
PVAL1,ERROR1,GLERR1/
ALTSHAPE/APP/ADPTINDX/SEID/
S,N,PVALNEW/S,N,ADPTEXIT/DESITER/DESMAX/CNVFLG $
CASECC Case Control table.
EPT Table of Bulk Data entry images related to element properties.
EDT Element deformation table. Contains ADAPT Bulk Data entries.
EST Element summary table.
ELEMVOL Element volume table, contains p-element volumes and the p-value dependencies of
each p-element grid, edge, face and body.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
UG Displacement matrix in g-set.
MPT Table of Bulk Data entry images related to material properties.
ETT Element temperature table.
CSTM Table of coordinate system transformation matrices.
PVAL0 p-value table generated by ADAPT module in previous superelement or adaptivity
loop.
ERROR0 Error estimate table generated by ADAPT module in previous superelement or
adaptivity loop.
PELSET p-element set table, contains SETS DEFINITIONS.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DIT Table of TABLEij Bulk Data entry images.
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
Main Index
597 ADAPT
Performs and prints error estimate for current p-values
Output Data Blocks:
Parameters:
Remarks:
1. If superelements are present then CASECC must contain only the residual structure. EPT, EST,
UG, MPT, CSTM, GEOM4, BGPDT, and GPSNT apply to the current superelement only. See
Example.
2. If DATAREC Case Control command and OUTPUT Bulk Data entries are specified, then
ADAPT will also print or punch out the p-value and error tables for specified p-element
identification numbers at desired adaptivity loops.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
BGPDT Basic grid point definition table.
GPSNT Grid point shell normal table.
EPSSE Table of epsilon and external work.
LAMA Normal modes eigenvalue summary table.
GLERR Table of global error estimates from previous iteration.
PVAL1 p-value table updated for current superelement or adaptivity loop.
ERROR1 Error-estimate table updated for current superelement or adaptivity loop.
GLERR1 Table of global error estimates for current iteration.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full
Product Space set.
APP Input-character-no default. Analysis type: 'STATICS' or 'REIGEN'.
ADPTIND Input-integer-no default. P-version analysis adaptivity index.
SEID Input-integer-no default. Superelement identification number.
PVALNEW Output-integer-no default. New p-value set identification number.
ADPTEXIT Output-logical-no default. Set to TRUE if this is the final adaptivity loop.
DESITER Input-integer-no default. Design optimization iteration number.
DESMAX Input-integer-no default. Design optimization maximum allowed iteration number.
CNVFLG Input-integer-default=0. Design optimization convergence flag.
Main Index
ADAPT
Performs and prints error estimate for current p-values
598
Example:
Set up ADAPT module for superelement analysis.
EQUIVX CASESX/CASE0/-1 $ CAPTURE R.S. CASE CONTROL
$ FOR ALL SUPERELEMENTS
EQUIVX PVAL /PVALN/-1 $ COPY NDDL, WITH CURRENT VALUE
EQUIVX ERROR/ERRORN/-1 $ OF PVALID QUALIFIER, TO SCRATCH.
DO WHILE (LPFLG >= 0) $
IF ( RSONLY ) THEN $
SEID = 0 $
PEID = 0 $
LPFLG=-1 $ EXIT LOOP AFTER THIS PASS
ELSE $
SEP2DR SLIST,EMAP//S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,LPFLG/
S,N,NOMAT/S,N,NOASM/S,N,NOLOAD/S,N,NOLASM/S,N,NOUP/
S,N,SCNDRY/S,N,EXTRN/S,N,NOMR/'ALL'//-1 $
ENDIF $
CALL SETQ CASESX//SEID/PEID/S,MTEMP/S,K2GG/S,M2GG/S,B2GG/S,MPC/
S,SPC/S,LOAD/S,DEFORM/S,TEMPLD/S,P2G/S,DYRD/S,METH/
S,MFLUID $
ADAPT CASE0,EPTS,EDT,EST,ELEMVOL,VIEWTB,UG,MPTS,ETT,CSTMS,
PVALN,ERRORN,PELSETS,DEQATN,DEQIND,DIT,OINT,GEOM4S,
BGPDTS,GPSNTS/
PVAL1,ERROR1/
ALTSHAPE/APP/ADPTINDX/SEID/S,N,PVALNEW/S,N,FINISH/
DESITER/DESMAX/CNVFLG $
EQUIVX PVAL1/PVALN/ALWAYS $ ..."ACCUMULATE" UPDATED PVALS
EQUIVX ERROR1/ERRORN/ALWAYS $ AND ERRORS ACROSS ALL S.E.'S
DELETE /UG,,,, $
IF ( ADPTEXIT ) ADPTEXIT = FINISH $
ENDDO $ LPFLG >= 0
Main Index
599 ADD
Matrix add
Computes where and are scalar multipliers
.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
ADD
Matrix add
ADD A,B/X/ALPHA/BETA/IOPT $
A Any matrix (real or complex).
B Any matrix (real or complex).
X Matrix
ALPHA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
BETA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
IOPT Input-integer-default = 0. This chooses the operator .
IOPT Operation
0
1
2
+ , add
* , multiply
, divide
3
X | | o A | | | B | | = o |
can be the +, *, or overwrite operators ( )
o
A | |
|
B | |
in x
i j
oA
ij
|B
ij
=
)
`
if A
ij
or B
ij
0, then X
ij
0 = =
oA
ij
if B
ij
= =
|B
ij
if B
ij
= =
Main Index
ADD
Matrix add
600
Remarks:
1. and/or may be purged, in which case the corresponding term in the matrix sum will be
assumed null. The input data blocks must be unique. X may not be purged.
2. The type (complex or real and single or double precision) of is the maximum of the types of
, , , and . The size of is the size of if is present. Otherwise, it is the size
of .
3. If A and B are not the same size, then the size of X will be the size of A. For example,
or
4. If ALPHA or BETA are specified as constants and their imaginary part is zero; e.g., (5.,0.), then
they may alternately be specified as real constants; e.g., 5. See examples.
5. For exponentiation of each element in a matrix, see DIAGONAL, 729 module.
Examples:
1. Add KDD to MDD:
ADD KDD,MDD/DDD $
2. Multiply MAA by 5.0:
ADD MAA,/MAA5/(5.0,0.0) $
or
ADD MAA,/MAA5/5.0 $
3. Overwrite terms of with terms of:
ADD A,B/X///3 $
A | | B | |
X | |
A | | B | | o | X | | A | | A | |
B | |
1 2 5
3 4 6
7 8
8 10 5
3 4 6
= +
7 8
1 2 5
3 4 6
8 10
= +
A | |
Main Index
601 ADD5
Matrix add
To compute , where , , , , and are scalar multipliers.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
ADD5
Matrix add
ADD5 A,B,C,D,E/
X/
ALPHA/BETA/GAMMA/DELTA/EPSLN/
ALPHAD/BETAD/GAMMAD/DELTAD/EPSLND $
A,B,C,D,E Must be distinct matrices. (Real or complex).
X Matrix
ALPHA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
BETA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
GAMMA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
DELTA Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier
for .
EPSLN Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier for
.
ALPHAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar
multiplier for .
BETAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar
multiplier for .
GAMMAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar
multiplier for .
X | | o A | | | B | | C | | A D | | c E | | + + + + = o | A c
o
A | |
|
B | |
A
D | |
A
D | |
c
E | |
A | |
B | |
C | |
Main Index
ADD5
Matrix add
602
Remarks:
1. Any of the matrices may be purged, in which case the corresponding term in the matrix sum will
be assumed null. The input data blocks must be unique.
2. The type (complex or real) of is maximum of the types of A, B, C, D, and E. If the imaginary
parts of any parameter are nonzero, then X will be complex. The precision of is double for
short-word machines and single for long-word machines ADD5 is more efficient than ADD for
sparse matrices.
3. If the input matrices are incompatible, then the User Fatal Message 5423 ATTEMPT TO ADD
INCOMPATIBLE MATRICES is issued.
4. If any of the scalar multipliers are specified as constants and their imaginary part is zero; e.g.,
(5.,0.), then they may be alternately specified as real constants; e.g., 5. See Example 2 below.
5. If any of the scalar single precision multipliers are specified as constants and their imaginary part
is zero; e.g., (5.,0.), then they may be alternately specified as real constants; e.g., 5. See Example
2. This alternate specification is not allowed for the double precision multipliers and constant
double precision values must be entered in full: e.g., (2.0D0, 0.0D0).
6. If ALPHAD, BETAD, GAMMAD, DELTAD, or EPSLND is non-zero then the corresponding
single precision parameter will be ignored.
Examples:
1. Compute
IOMEGA=CMPLX(0.,OMEGA)
OMEGSQ=IOMEGA**2
ADD5 MDD,BDD,KDD,,/DDD/OMEGSQ/IOMEGA $
2. Multiply [MAA] by 5.0
ADD5 MAA,,,,/MAA5/(5.0,0.0) $
or
ADD5 MAA,,,,/MAA5/5.0 $
3. Scale A by a large number. The largest element in A is 1.0.
TYPE PARM,,CD,,SCALER=(1.D40,0.0D0) $
ADD5 A,,,,/ASCALED//////SCALER $
4. Change the type of the real double precision matrix A to complex.
ADD5 A,,,,/ACD//(1.,1.) $
Although the value of the second parameter does not appear in the output, it changes the type from
real double precision (type 2) to complex double precision.
DELTAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar
multiplier for .
EPSLND Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar
multiplier for .
C | |
E | |
X | |
X | |
Main Index
603 ADG
Calculates the downwash matrix
Calculates the downwash matrix that specifies the downwash for each of the aerodynamic extra points.
It also forms the matrices required in the generation of stability derivative information and in the
specification of the aerodynamic trim equations, as well as the hinge moments data matrix.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ADG
Calculates the downwash matrix
ADG AECTRL,CSTMA,AERO,AECOMP,W2GJ,ACPT/
UXVBRL,WJVBRL,ADBINDX/
NJ/NK/SYMXZ $
AECTRL Table of aeroelastic model controls.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set and ks-set grid points.
AERO Table of control information for aerodynamic analysis.
AECOMP Aerodynamic component definition table.
W2GJ Matrix of aerodynamic intercepts. Usually input via DMI Bulk Data entries.
ACPT Aerodynamic connection and property table.
UXVBRL Controller state matrix for WJVBRL downwash vectors. UXVBRL has NX rows
and NV columns.
WJVBRL Downwash matrix (NJ rows by NV columns). Downwash at the j-points due to the
linear, angle/rate rigid body aerodynamic extra-points and linear control surfaces.
ADBINDX Table of the aerodynamic database contents. (one entry for each of the NV instances
created).
NJ Input-integer-no default. Number of aerodynamic boxes (j-points).
NK Input-integer-no default. Number of aerodynamic degrees of freedom (k-points).
SYMXZ Input-integer-no default. x-z symmetry flag.
Main Index
ADG
Calculates the downwash matrix
604
Remarks:
1. NK, and NJ are computed by the APD module.
2. If ACPT is not purged then the DJX matrix is built using ACPT and AECOMP.
Main Index
605 ADJMOD
Modify DRDUG/DRDUTB for adjoint loads
Modify DRDUG/DRDUTB from DSAD (or DOPR3) for supporting the adjoint load method when
superelements are present.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ADJMOD
Modify DRDUG/DRDUTB for adjoint loads
ADJMOD DRDUTB,DRDUG,ADRDUTB/
DRDUTBM,DRDUGM/
S,N,AADJCOL/COLADJ/TCOLADJ/APP $
DRDUTB Table of adjoint load attributes.
DRDUG Matrix of adjoint loads for the g-set.
ADRDUTB Table of adjoint load attributes.
DRDUTBM Modified table of adjoint load attributes.
DRDUGM Modified matrix of adjoint loads.
AADJCOL Input/output-integer-no default. On input, summation of columns in DRDUG for
all previously processed superelements. On output, summation of columns in
DRDUG including current superelement.
COLADJ Input-integer-no default. Number of columns of DRDUG for the current
superelement.
TCOLADJ Input-integer-no default. Total number of columns of DRDUG for all
superelements.
APP Input-character-no default. Analysis type.
'STATICS' Statics
'FREQRESP' Frequency response
Main Index
ADR
Builds a matrix of aerodynamic forces
606
Builds a matrix of aerodynamic forces per frequency for each aerodynamic point based on the AEROF
Case Control command.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
ADR
Builds a matrix of aerodynamic forces
ADR UH,CASECC,QKHL,OL,AEBGPDT,AEUSET/
PKF/
BOV/MACH/APP/AECONFIG/SYMXY/SYMXZ $
UH Complex modal displacements matrix -- h-set.
CASECC Case Control table.
QKHL Aero transformation matrix between h and k sets.
OL Complex eigenvalue summary table for flutter analysis or frequency response
output list for aeroelastic analysis.
AEBGPDT Basic grid point definition table with the aerodynamic degrees of freedom added
(ks-set in AEUSET).
AEUSET Aerodynamic USET table.
PKF Matrix of k-set forces per frequency.
BOV Input-real-no default. Conversion from frequency to reduced frequency.
MACH Input-real-default=0.0. Mach number.
APP Input-character-no default. Analysis type:
'FREQRESP' Aeroelastic
'FLUTTER' Flutter
AECONFIG Input-character-no default. Aerodynamic configuration.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
Main Index
607 ADR
Builds a matrix of aerodynamic forces
Remarks:
1. None of the input data blocks may be purged if an AEROF Case Control command is specified.
2. PKF cannot be purged.
Examples:
1. ADR in flutter analysis:
2. ADR in aeroelastic analysis:
DBVIEW AEUSET=USET ( WHERE MODLTYPE='AEROSTRC' AND WILDCARD)$
DBVIEW AEBGPDT=BGPDTS ( WHERE MODLTYPE='AEROSTRC' AND WILDCARD)$
ADR FPHH,CASEYY,QKHL,FLAMA,AEBGPDT,AEUSET/
PKF/
BOV/MACH/'FLUTTER' $
DBVIEW AEUSET=USET ( WHERE MODLTYPE='AEROSTRC' AND WILDCARD)$
DBVIEW AEBGPDT=BGPDTS ( WHERE MODLTYPE='AEROSTRC' AND WILDCARD)$
ADR AUHF,CASES,QKHL,FOL,AEBGPDT,AEUSET/
PKF/
BOV/MACH/'FREQRESP' $
Main Index
AELOOP
Aerodynamic loop driver
608
Extracts a single record of Case Control and sets parameter values for the generation of aerodynamic
matrices or the solution of aerostatic and divergence analyses.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
AELOOP
Aerodynamic loop driver
AELOOP CASECC,EDT,CCPOS/
CASEA,CCPOS1/
S,N,NSKIP/S,N,LPFLG/S,N,MFLG/S,N,MACH/S,N,Q/
S,N,AEQRATIO/S,N,AECONFIG/S,N,SYMXY/S,N,SYMXZ/
CRTPOS/S,N,RCONFIG/MASSETID/S,N,AESOLN $
CASECC Case Control table.
EDT Element Deformation Table. Contains all of the entries for related to aerostatic and
aeroelastic analysis.
CCPOS Table of Case Control record locations.
CASEA A single record (subcase) of CASECC.
CCPOS1 Table of Case Control record locations.
NSKIP Input/output-integer-default=0. Trim subcase counter.
LPFLG Input/output-integer-default=0. Flag to indicate whether there is another case control
record to process. Set to -1 for the last subcase and Mach number.
MFLG Input/output-integer-default=0. Flag to indicate whether there is another Mach
number to process in the current subcase.
Set to 0 for the last Mach number in the subcase.
MACH Output-real-no default. Mach number.
Q Output-real-no default. Dynamic pressure.
AEQRATIO Output-real-no default. Aeroelastic feedback dynamic pressure ratio.
AECONFIG Output-character-no default. Aerodynamic configuration.
SYMXY Output-integer-no default. Aerodynamic x-y symmetry flag.
Main Index
609 AELOOP
Aerodynamic loop driver
Remarks:
AELOOP performs slightly different functions depending on whether it is used in a divergence or trim
analysis. In both cases, AELOOP skips to the NSKIP-th subcase in CASECC and copies the subcase to
CASEA. CASEA is then interrogated for a a TRIM or a DIVERG Case Control command.
1. If it is TRIM, then the NSKIP parameter is incremented by one and the MACH and Q values are
read from the requested TRIM Bulk Data entry image in EDT.
2. If it is DIVERG, then MFLG is checked for any remaining MACH numbers in the subcase. If any
are found, then MFLG is incremented by one and the MFLG-th MACH number is read from the
requested DIVERG Bulk Data entry image in EDT. If the current MACH number is the last
MACH number, MFLG is set to 0 and NSKIP is incremented by one.
In both cases, if NSKIP is greater than the total number of records in CASECC, then LPFLG is
set to -1.
Examples:
1. Set up for aerostatic analysis.
SYMXZ Output-integer-no default. Aerodynamic x-z symmetry flag.
CRTPOS Input-integer-default=0. CCPOS1 creation flag.
>0 Create CCPOS1
<0 Do not create CCPOS1
RCONFIG Output-character-no default. Configuration name for rigid aero.
MASSETID Input-integer-default=0. Identification number of the MASSSET CaseControl
command.
AESOLN Output-character-default=' '. Aerodynamic solution name extracted from
CASECC at word positions 454 and 455.
DO WHILE ( LPFLG>=0 ) $
AELOOP CASECC,EDT,/
CASEA,/
S,N,NSKIP/S,N,LPFLG/MFLG/S,N,MACH/S,N,Q/
S,N,AEQRATIO/S,N,AEFC/S,N,SYMXY/
S,N,SYMXY/S,N,SYMXZ//S,N,AERC//
S,N,AESOLN $
NSKIP = NSKIP + 1 $
ENDDO $ LPFLG>=0
Main Index
AELOOP
Aerodynamic loop driver
610
2. Set up for divergence analysis.
DO WHILE ( LPFLG>=0 ) $ Loop on number of subcases
MFLG = 1 $
DO WHILE ( MFLG>0 ) $ Loop on Mach number
AELOOP CASECC,EDT/
CASEA/
S,N,NSKIP/S,N,csFLG/S,N,MFLG/S,N,MACHNO/S,N,Q/
S,N,AEQRATIO/S,N,AECONFIG/S,N,SYMXY/
S,N,SYMXZ//S,N,AERC//S,N,AESOLN
ENDDO $ MFLG>0
ENDDO $ LPFLG>=0
Main Index
611 AEMODEL
Aerodynamic model loop driver
Drives the aerodynamic model loop and sets parameter values for the generation of aerodynamic tables.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
AEMODEL
Aerodynamic model loop driver
AEMODEL CASECC,EDT,CCPOS/
CCPOS1
S,N,NSKIP/S,N,LPFLG/S,N,AECONFIG/S,N,SYMXY/
S,N,SYMXZ/CRTPOS $
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics, p-
element analysis, divergence analysis, and the iterative solver. Also contains SET1
entries.
CCPOS Table of Case Control record locations.
CCPOS1 Table of Case Control record locations.
NSKIP Input/output-integer-default=0. Trim subcase counter.
LPFLG Input/output-integer-default=0. Flag to indicate whether there is another case control
record to process. Set to -1 for the last aerodynamic subcase.
AECONFIG Output-character-no default. Aerodynamic configuration.
SYMXY Output-integer-no default. Aerodynamic x-y symmetry flag.
SYMXZ Output-integer-no default. Aerodynamic x-z symmetry flag.
CRTPOS Input-integer-default=0. CCPOS1 creation flag.
>0 Create CCPOS1
<=0 Do not create CCPOS1
Main Index
AFPMP
Field point mesh data recovery
612
Computes acoustic results in a field point mesh.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
AFPMP
Field point mesh data recovery
AFPMP CASECC , ACIECT , EPT , MPT , BGPDT ,
SILD , EDT , BGPDTFP , ECTFP , FOL ,
UPF /
OUGFP1 , OVGFP1 , OAPWR2 /
AFPMID /S,N,NOUG1/S,N,NOVG1/S,N,NOAPWR2/S,N,NOSORT2 $
CASECC Case Control command selections
ACIECT Table of acoustic conjugate infinite elements
EPT Element property table
MPT Material property table
BGPDT Basic grid point definition table
SILD Scalar index list for the p-set
EDT Element Deformation Table: contains ACIFPRM entry
BGPDTFP Basic grid point definition table of field point mesh
ECTFP Element connectivity table of field point mesh
FOL Frequency output list
UPF Displacement matrix in p-set for frequency response.
OUGFP1 Field point results in SORT1 format
OVGFP1 Field point velocities in SORT1 format
OAPWR2 Acoustic power through field point mesh in SORT2 format
AFPMID Input-integer-no default. Acoustic field point mesh identification number.
NOUGFP1 Output-integer-default=-1. OUGFP1 generation flag. Set to +1 if OUGFP1 is
generated; -1 otherwise.
Main Index
613 AFPMP
Field point mesh data recovery
NOVGFP1 Output-integer-default=-1. OVGFP1 generation flag. Set to +1 if OVGFP1 is
generated; -1 otherwise.
NOAPWR2 Output-integer-default=-1. OAPWR2 generation flag. Set to +1 if OAPWR2 is
generated; -1 otherwise.
NOSORT2 Output-integer-default=-1. SORT2 flag. Set to +1 if SORT2 output is requested; -1
otherwise.
Main Index
AIEMGA
Acoustic infinite element matrix generation and assembly
614
Generates acoustic conjugate infinite element stiffness, mass and damping
matrices and assembles them into system matrices for the p-set.
Format:
Input Data Blocks:
Output Data Blocks:
AIEMGA
Acoustic infinite element matrix generation and assembly
AIEMGA GEOM2,EPT,MPT,IFEXPNT,EDT,BGPDT,EQDYN,SILD,DIT/
KAIPP,MAIPP,BAIPP,ACIECT/
LUSETD/NOUE/S,N,NOKAIPP/S,N,NOMAIPP/S,N,NOBAIPP/
UNUSED6 $
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.
EPT Element property table
MPT Material property table
IFEXPNT Table of infinite element extra points and association with fluid-structure grid
points
EDT Table of Bulk Data entry images containing ACINFPRM Bulk Data entry
BGPDT Basic grid point definition table
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data).
SILD Scalar index list for the p-set
DIT Table of TABLEij Bulk Data entry images.
KAIPP Acoustic infinite stiffness matrix in the p-set
MAIPP Acoustic infinite mass matrix in the p-set
BAIPP Acoustic infinite damping matrix in the p-set
ACIECT Table of acoustic conjugate infinite elements
Main Index
615 AIEMGA
Acoustic infinite element matrix generation and assembly
Parameters:
LUSETD Input-integer-no default. The number of degrees-of-freedom in the
p-set.
NOUE Input-integer-no default. Number of extra points. Set to -1 if there are no extra
points
NOKAIPP Input/output-integer-default=-1. KAIPP generation flag.
On input: -1: Generate
0: Do not generate.
On output: -1: Matrix was generated.
0: Matrix was not generated.
NOMAIPP Input/output-integer-default=-1. MAIPP generation flag.
On input: -1: Generate.
0: Do not generate.
On output: -1: Matrix was generated.
0: Matrix was not generated.
NOBAIPP .Input/output-integer-default=-1. BAIPP generation flag.
On input: -1: Generate
0: Do not generate.
On output: -1: Matrix was generated.
0: Matrix was not generated.
UNUSED6 Input-integer-default=0. Unused and may be left blank..
Main Index
AMG
Builds aerodynamic influence matrix
616
Generates a list of aerodynamic influence matrices (AJJT) and the transformation matrices needed to
convert these to the aerodynamic grid points (SKJ, D1JK, D2JK).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
AMG
Builds aerodynamic influence matrix
AMG MKLIST,ACPT/
AJJT,SKJ,D1JK,D2JK/
NK/NJ/SYMXZ/SYMXY/REFC/S,N,MACH0/MACHNO/
KBAR/APP/SUPAERO $
MKLIST Aerodynamic matrix generation table.
ACPT Aerodynamic connection and property table.
AJJT Aerodynamic influence matrix.
SKJ Integration matrix list.
D1JK Real part of downwash matrix.
D2JK Imaginary part of downwash matrix.
NK Input-integer-no default. Number of degrees of freedom in k-set.
NJ Input-integer-no default. Number of degrees of freedom in j-set.
SYMXZ Input-integer-no default. Aerodynamic z-y symmetry flag.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
REFC Input-real-no default.
MACH0 Input/output-real-default=-1.0. Previously processed Mach number.
MACHNO Input-real-default=0.0. Mach number.
KBAR Input-real-default = 0.0. Reduced frequency.
Main Index
617 AMG
Builds aerodynamic influence matrix
Remarks:
1. ACPT may be purged.
2. D2JK is not used in aerostatic analysis.
Examples:
1. Set up AMG for aerostatic analysis:
2. Set up AMG for aeroelastic or flutter analysis:
APP Input-character-default=' '. Analysis type:
'FREQRESP' Aeroelastic
'FLUTTER' Flutter
SUPAERO Input-character-default='ZONA'. Method selection for supersonic aerodynamics. An
alternate method is 'CPM'.
AMG ,,ACPT/
AJJT,SKJ,D1JK,D2JX/
NK/NJ/S,N,MACH0/MACH/0.0/'STATICS' $
AMG MKLIST,ACPT/
AJJT,SKJ1,D1JK,D2JK/
NK/NJ/S,N,MACH0/MACH/KBAR $
Main Index
AMP
Generates modal aerodynamic matrices
618
Generates modal aerodynamic matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
AMP
Generates modal aerodynamic matrices
AMP AJJT,WSKJF,D1JK,D2JK,GDKI,GPIK,GPKH,D1JE,D2JE,
MKLIST,LAJJT,UAJJT/
QHH,QKH,QHJ/
NUMHDOF/NOUE/GUSTAERO/MACH/KBAR $
AJJT Aerodynamic influence matrix.
WSKJF Weighted integration matrix.
D1JK Real part of downwash matrix.
D2JK Imaginary part of downwash matrix.
GDKI Aerodynamic transformation matrix for displacements from the k-set to h-set.
GPIK Aerodynamic transformation matrix for loads from the h-set to k-set.
GPKH Aerodynamic transformation matrix for loads from the k-set to h-set.
D1JE Imaginary part of downwash matrix due to extra points.
D2JE Imaginary part of downwash matrix due to extra points.
MKLIST Table of Mach number and reduced frequency pairs.
LAJJT Lower triangular decomposition factor matrix of AJJT.
UAJJT Upper triangular decomposition factor matrix of AJJT.
QHH Aerodynamic matrix of size h- by h-set.
QKH Aerodynamic matrix of size k- by h-set.
QHJ Aerodynamic matrix of size h- by j-set.
NUMHDOF Input-integer-no default. The number of modes.
NOUE Input-integer-no default. The number of extra points.
GUSTAERO Input-integer-default=0. QHJ computed only if GUSTAERO<0.
Main Index
619 AMP
Generates modal aerodynamic matrices
Remarks:
1. None of the input data blocks may be purged if an AEROF Case Control command is specified.
2. PKF cannot be purged.
3. AMP requires the combination of matrices:
The aerodynamic matrices for aerodynamic cells, produced by the Aerodynamic Matrix
Generator (AMG) module.
The interpolation from the structure to the aerodynamic cells, produced by the Geometry
Interpolator (GI) module.
The downwash matrix due to extra points, may be supplied by the user via INPUTT4. These extra
points are used for control systems and other special effects.
4. If NOUE<0 then D1JE and D2JE may be purged.
5. QKH, relating aerodynamic pressures to modal coordinates, is required for use in a data reduction
module. The matrix of generalized forces, QHH, may be purged if only data reduction is desired.
MACH Input-real-default=0.0. Mach number.
KBAR Input-real-default=0.0. Reduced frequency.
Main Index
APD
Generates aerodynamic geometry tables
620
Generate boxes, grid points, connectivity, degree-of-freedom sets, coordinate systems and control
information for aerodynamic analysis.
Format:
Input Data Blocks:
Output Data Blocks:
APD
Generates aerodynamic geometry tables
APD EDT,CSTM/
AEECT*,AEBGPDT*,AEUSET*,AECOMP,AERO,
ACPT,CSTMA,AMSPLINE,MPJN2O/
S,N,NK/S,N,NJ/S,N,BOV/AERTYP/S,N,BOXIDF $
EDT Table of Bulk Data entry images related to aerodynamics.
CSTM Table of coordinate system transformation matrices.
AEECT* Two aerodynamic element connection tables (ECT) based on MODLTYPE
qualifier: MODLTYPE='AEROMESH' and MODLTYPE='AEROSTRC'. See
Example.
AEBGPDT* Two aerodynamic basic grid point definition tables (BGPDT) with the degrees of
freedom added and based on MODLTYPE qualifier: MODLTYPE='AEROMESH'
and MODLTYPE='AEROSTRC'. See Example.
AEUSET* Aerodynamic USET table defining ks-set based on MODLTYPE qualifier:
MODLTYPE='AEROSTRC'. See Example.
AECOMP Aerodynamic component definition table.
AERO Control information for control of aerodynamic matrix generation and flutter
analysis.
ACPT Aerodynamic connection and property table.
CSTMA Aerodynamic coordinate system transformation matrices for g-set and ks-set grid
points.
AMSPLINE Table of aerodynamic splines for display.
MPJN2O Mapping matrix to map j-set data from neworder to old order.
Main Index
621 APD
Generates aerodynamic geometry tables
Parameters:
Remarks:
1. AEECT*, AEBGPDT*, and AEUSET* are output family data blocks based on qualifiers AEID
and MODLTYPE. AEID is not currently being used and is always 0.
2. BGPDT, ECT, and USET0 where MODLTYPE='STRUCTUR' are output by GP1, GP2, and
GP4, respectively.
NK Output-integer-no default. Number of degrees of freedom in the k displacement set.
NJ Output-integer-no default. Number of degrees of freedom in the j displacement set.
BOV Output-integer-default=0.0. Value calculated by REFC/(2.*VELOCITY).
AERTYP Input-character-default='DYNAMICS'. Analysis type:
'STATICS' Aerostatic
'DYNAMICS' Flutter and aeroelastic
'STADYN' All aerodynamic analysis types
BOXIDF Output-integer-no default. Box corner point identification flag.
0 Points have unique identification numbers starting with the aerodynamic
component identification number.
-1 Points identification numbers are incremented by 1, to avoid an overlap if they
were started with the aerodynamic component identification numbers. No
display of the corner points is possible.
MODLTYPE Model DOF set
STRUCTUR structural p-set
AEROSTRC aero-structural ks-set
AEROMESH plotting n/a
Main Index
APPEND
Concatenate two data blocks
622
E
Produces the union of either two input data blocks or an input and an output data block. Depending on
parameter input, APPEND will perform the following types of unions:
(4-1)
(4-2)
Format:
Input Data Blocks:
Output Data Block:
Parameters:
APPEND
Concatenate two data blocks
APPEND IN1,IN2/OUT/IOPT/NULL1/NULL2/
REAL/REALD/CMPX/CMPXD/CHAR1/CHAR2 $
IN1,IN2 A pair of data blocks contributing to OUT (matrices or tables).
OUT Output data block. This data block may have been created previously. See IOPT > 2.
IOPT Input-integer-default = 1. IOPT selects the method of appending.
1 Append columns (or records) of IN2 to IN1 as shown in Eq. 3-1.
2 Append columns (or records) of IN1 to OUT as shown in Eq. 3-2.
IN2 is ignored.
10 Write NULL2 in the next record of OUT.
11 Write REAL in the next record of OUT.
12 Write REALD in the next record of OUT.
13 Write CMPX in the next record of OUT.
14 Write CMPXD in the next record of OUT.
15 Write CHAR in the next record of OUT.
16 Write NULL2 followed by REAL in the next record of OUT.
17 Write NULL2 followed by REALD in the next record of OUT.
[OUT]
IN1 IN2
=
[OUT]
OUT IN1
=
Main Index
623 APPEND
Concatenate two data blocks
Remarks:
1. Under IOPT = 2, the output matrix data block is also used as an input and must be declared
APPEND in a FILE DMAP statement.
2. If the inputs are matrices then both inputs must be of the same type.
3. Either IN1 or IN2 may be purged. For IOPT = 2, IN2 must be purged.
4. In matrix appends, string formatted records are copied from one matrix data block to another.
5. In table appends, the header record is skipped on the appended file and all remaining records.
Also, the trailer of OUT will be set to that of IN2 (IOPT = 1) or IN1 (IOPT = 2).
6. It is recommended that the OUT data block be a scratch data block. In other words, it should not
be saved on a permanent DBset.
7. For values of IOPT -16, -17, -18, -19, or -2
the order in which the parameters are written is reversed. For example, IOPT=-20 causes CHAR
to be written first, then NULL2.
8. If NULL1 > 0, then a type code value is written in the word immediately preceding the word(s)
containing the value of the parameter. The type codes are: 0:INT, 1:REAL, 2:REALD, 3:CMPX,
4:CMPXD and 8:CHAR.
9. For IOPT > 10, trailer word 1 will contain a count of the number of data records on the file and
word 2 will contain the value of the NULL1 parameter.
18 Write NULL2 followed by CMPX in the next record of OUT.
19 Write NULL2 followed by CMPXD in the next record of OUT.
20 Write NULL2 followed by CHAR in the next record of OUT.
NULL1 Input-integer-default = 0. The number of null columns or records assumed
for IN1 if IN1 is purged. In other words, IN2 will be appended to a data block
with NULL1 number of records or columns. Used only if IOPT = 1.
NULL2 Input-integer-default = 0. For IOPT = 1, the number of null columns or
records to append onto IN1 if IN2 is purged. For lOPT = 10, integer value in
the next record.
REAL Input-real-default=0.0. Real value in the next record.
REALD Input-real double precision-default=0.D0. Real double precision value in the
next record.
CMPX Input-complex-default=(0.0,0.0). Complex value in the next record.
CMPXD Input-complex double precision-default=(0.D0,0.D0). Complex double-
precision value in the next record.
CHAR1 Input-character-default='XXXXXXXX'. Character value in the next record.
CHAR2 Input-character-default='XXXXXXXX'. Character value in the same record
as CHAR1 and following CHAR1.
Main Index
APPEND
Concatenate two data blocks
624
Examples:
1. Generate a matrix whose five columns are a vector multiplied by the column number.
DIAG 8
SOL X
COMPILE X
SUBDMAP X
TYPE PARM,,CS,N,CF $
TYPE PARM,,RS,N,FACTOR $
FILE U=APPEND $
MATGEN ,/US/5/1/7 $
DO WHILE ( FACTOR < 5. ) S
FACTOR=FACTOR+1.
CF=CMPLX(FACTOR,0.) $
ADD5 US,,,,/UI/CF $
APPEND UI,/U/2 $
ENDDO $
MATPRN U/ $
END $
CEND
BEGIN BULK
ENDDATA
2. Create a matrix B by appending five null columns to matrix A.
APPEND A,/B/1//5 $
3. Create a table with a one word record that contains the integer value 1001.
APPEND ,,/OUT1/10//1001 $
U | | U
s
{ }
Main Index
625 ASDR
Prints the extra point aerodynamic displacements
Prints the aerodynamic extra point displacements and the aerodynamic pressures and forces as requested
in Case Control.
Format:
Input Data Blocks:
ASDR
Prints the extra point aerodynamic displacements
ASDR CASEA,UXDAT,AECTRL,FFAJ,ACPT,PAK,AEUSET,AEBGPDT,
AECOMP,MONITOR,MPSR,MPSER,MPSIR,MPSRP,MPSERP,
MPAERP,AEMONPT,MPAR,MPAER,AERO,CSTMA//
MACH/Q/AECONFIG/SYMXY/SYMXZ/IUNITSOL $
CASEA A single record (subcase) of CASECC for aerodynamic analysis.
UXDAT Table of aerodynamic extra point identification numbers, displacements, labels,
type, status, position and hinge moments.
AECTRL Table of aeroelastic model controls.
FFAJ Matrix of pressures at aerodynamic boxes.
ACPT Aerodynamic connection and property table.
PAK Matrix of aerodynamic forces at aerodynamic boxes.
AEUSET Aerodynamic USET table.
AEBGPDT Basic grid point definition table with the aerodynamic degrees of freedom added
(ksa-set in AEUSET).
AECOMP Aerodynamic component definition table.
MONITOR Structural monitor point table.
MPSR Rigid aerodynamic loads on structural monitor points at trim (excluding inertial
loads and static applied loads).
MPSER Elastic restrained loads on structural monitor points at trim (excluding inertial loads
and static applied loads).
MPSIR Inertial loads on structural monitor points at trim.
MPSRP Rigid loads on structural monitor points due to static applied loads.
MPSERP Elastic restrained loads on structural monitor points due to static applied loads.
MPAERP Total elastic restrained loads on aerodynamic monitor points at trim due to static
applied loads.
AEMONPT Aerodynamic monitor point table
MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim.
Main Index
ASDR
Prints the extra point aerodynamic displacements
626
Output Data Blocks:
None.
Parameters:
MPAER Elastic restrained loads on aerodynamic monitor points at trim.
AERO Table of control information for aerodynamic analysis.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
MACH Input-real-no default. Mach number.
Q Input-real-no default. Dynamic pressure.
AECONFIG Input-character-no default. Aerodynamic configuration.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
IUNITSOL Input-integer-default=0. If IUNITSOL=0, then trim solution is being supplied. If
IUNITSOL>0, then IUNITSOL'th unit solution is being supplied.
Main Index
627 ASG
Computes the aerodynamic extra point displacements
Computes the aerodynamic extra point displacements.
Format:
Input Data Blocks:
Output Data Blocks:
ASG
Computes the aerodynamic extra point displacements
ASG CASEA,AEMONPT,MONITOR,MPAERV,MPSERV,MPSIR,AEDBUXV,
MPSERP,MPAERP,AECTRL,EDT,PRBDOFS,DIT,AEDBINDX/
UX,UXDAT,UXDIFV/SYMXZ/ISENS $
CASEA A single record (subcase) of CASECC for aerodynamic analysis.
AEMONPT Aerodynamic monitor point table.
MONITOR Structural monitor point table.
MPAERV Elastic restrained monitor point loads on aerodynamic model.
MPSERV Elastic restrained monitor point loads on structural model.
MPSIR Inertial loads on structural monitor points at trim.
AEDBUXV Matrix of vehicle states.
MPSERP Elastic restrained loads on structural monitor points due to static applied loads.
MPAERP Total elastic restrained loads on aerodynamic monitor points at trim due to static
applied loads.
AECTRL Table of aerodynamic model's control definition.
EDT Table of Bulk Data entry images related to aerodynamics.
PRBDOFS Partitioning matrix to partition the "active" URDDI from the "inactive." Active
URRDI are assigned a 1.0 value and are connected to the SUPORT degrees-of-
freedom.
DIT Table of TABLEij Bulk Data entry images.
AEDBINDX Aeroelastic database index for monitor point data.
UX Matrix of aerodynamic extra point displacements.
UXDAT Table of aerodynamic extra point identification numbers, displacements, labels,
type, status, position and hinge moments.
UXDIFV Derivative interpolation factors matrix at UX = UXREF.
Main Index
ASG
Computes the aerodynamic extra point displacements
628
Parameter:
Remarks:
1. TR, KRZX, DIT, ERHM, and UXDAT may be purged if ISENS=1.
2. ASG solves the following equation for UX:
where the number of rows in the UX vector is equal to the number of aerodynamic extra points.
The ZZX and PZ vectors have as many rows as there are r-set degrees of freedom. The IP matrix
is a pseudo identity matrix with as many rows as there are constrained extra points specified on
the TRIM Bulk Data entry. The IP matrix has ones in the row and columns corresponding to the
constrained variable and zeros located elsewhere. The Y vector contains the magnitudes of the
trim variable constraints. The AEL matrix contains the constraint relations (if any) specified by
AELINK Bulk Data entries. It has as many rows as there are AELINK constraints. It is required
that the sum of the number of supported degrees of freedom plus the number of TRIM constraints
and number of AELINK constraints equal the number of aerodynamic extra points.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
ISENS Input-integer-default=0. Set to 1 if a sensitivity analysis is to be performed.
ZZX
IP
AEL
UX
PZ
Y
O
=
Main Index
629 AXMDRV
Loop driver for auxiliary model processing
Loop driver for auxiliary model processing.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Remarks:
AXMDRV is intended to be called in a DMAP loop. Each time through the loop AXMDRV outputs the
current auxiliary model identification number defined in AMLIST. AUXMFL is TRUE except for the
last call when AUXMFL is set to FALSE, i.e., for the last auxiliary model.
Example:
AUXMID=-1 $ INITIALIZE
DO WHILE ( AUXMFL ) $
IF ( AUXMID=-1 ) THEN $
AUXMID=0 $
ELSE $
AXMDRV AMLIST//S,N,AUXMID/S,N,AUXMFL $
ENDIF $
.
.
.
ENDDO $
AXMDRV
Loop driver for auxiliary model processing
AXMDRV AMLIST//S,N,AUXMID/S,N,AUXMFL $
AMLIST List of auxiliary model identification numbers.
AUXMID Output-integer-default=0. Auxiliary model identification number.
AUXMFL Output-logical-default=TRUE. Auxiliary model loop control flag. Set to FALSE
when processing the last auxiliary model.
Main Index
AXMPR1
Builds a list of auxiliary model Bulk Data Sections
630
Builds a list of auxiliary model Bulk Data Sections.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. All auxiliary model identification numbers that are specified on the AUXCASE command in the
Case Control Section (258th word in CASECC*) are written to the AMLIST table.
2. AXMPR1 checks for the following preliminary errors:
Verify the AUXCAS Case Control command specifies a unique and existing
BULK file.
Verify that each Bulk Data Section is identified with a unique auxiliary model number.
Example:
This is how AXMPR1 is used in subDMAP IFPL. CASEXX and IBULK are generated from IFP1 and
XSORT.
DBVIEW CASEXXAF = CASEXX (WHERE AUXMID>0) $
DBVIEW BULKAF = IBULK (WHERE AUXMID>0) $
AXMPR1 CASEXXAF,BULKAF/AMLIST $
AXMPR1
Builds a list of auxiliary model Bulk Data Sections
AXMPR1 CASECC*,BULK*/
AMLIST/
S,N,AMLFLG $
CASECC* Family of auxiliary model Case Control Sections.
BULK* Family of auxiliary model Bulk Data Sections.
AMLIST List of auxiliary model identification numbers.
AMLFLG Output-logical-default=FALSE. Set to TRUE if AMLIST if generated.
Main Index
631 AXMPR2
Merges geometry of primary model and an auxiliary model
Merges the geometry of the primary model and an auxiliary model and create a Case Control table with
PARTN command specifying auxiliary model grid points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remark:
AXMPR2 merges the primary model geometry (GRID and COORDi Bulk Data entry images) in
GEOM1 with the auxiliary model in GEOM1A. AXMPR2 also writes the grid identification numbers
from all of the auxiliary model grid points in GEOM1A to CASEVEC as a set referenced by the PARTN
command.
AXMPR2
Merges geometry of primary model and an auxiliary model
AXMPR2 GEOM1,GEOM1A/
GEOM1C,CASEVEC/
AUXMID $
GEOM1 Table of Bulk Data entry images related to geometry and assigned to the primary
model.
GEOM1A Table of Bulk Data entry images related to geometry and assigned to the auxiliary
model identified by AUXMID.
GEOM1C Table of Bulk Data entry images related to geometry and merged from GEOM1 and
GEOM1A.
CASEVEC Case Control table with the PARTN command referencing all of auxiliary model's
grid identification numbers.
AUXMID Auxiliary model identification number.
Main Index
BCDR
Drives a boundary condition loop
632
Drives a DMAP loop based on the boundary condition Case Control commands SPC and MPC.
Format:
Input Data Block:
Output Data Block:
None.
Parameters:
BCDR
Drives a boundary condition loop
BCDR CASECC//
SEID/SOLAPP/S,N,NSKIP/S,N,NLOADS/S,N,BCFLAG/S,N,SPC/
S,N,MPC/S,N,SUPORT/S,N,LOAD/S,N,LSEQ/S,N,STATSUB/
S,N,BC/BCLABL $
CASECC Table of Case Control command images. Output by IFP1.
SEID Input-integer-no default. Superelement identification number.
SOLAPP Input-character-no default. Design optimization analysis type. Currently not used.
NSKIP Input/output-integer-no default. The record number in CASECC corresponding to
the first subcase of the current boundary condition.
NLOADS Output-integer-default=0. The number of subcase records contiguous with respect
to the MPC and SPC command in the first subcase of the current boundary
condition.
BCFLAG Output-logical-no default. Set to FALSE at the last boundary condition.
SPC Output-integer-default=0. SPC Case Control command set identification number
specified in the third word of the NSKIP-th record of CASECC.
MPC Output-integer-default=0. MPC Case Control command set identification number
specified in the second word of the NSKIP-th record of CASECC.
SUPORT Output-integer-default=0. SUPORT Case Control command set identification
number specified in the 255-th word of the NSKIP-th record of CASECC.
LOAD Output-integer-default=0. LOAD Case Control command set identification number
specified in the fourth word of the NSKIP-th record of CASECC.
LSEQ Output-integer-default=0. LOADSET Case Control command set identification
number specified in the 205-th word of the NSKIP-th record of CASECC.
Main Index
633 BCDR
Drives a boundary condition loop
Example:
Here is an excerpt from subDMAP PHASE0:
BCFLAG=TRUE $
NSKIP=0 $
DO WHILE ( BCFLAG ) $
BCDR CASES//SEID/' '/
S,N,NSKIP/S,N,NLOADS/S,N,BCFLAG/S,N,SPC/S,N,MPC/
S,N,SUPORT/S,N,LOAD/S,N,LSEQ//S,N,BC $
.
.
.
ENDDO $
STATSUB Output-integer-default=0. STATSUB Case Control command set identification
number specified in the 256-th word of the NSKIP-th record of CASECC.
BC Output-integer-default=0. BC Case Control command set identification number
specified in the 257-th word of the NSKIP-th record of CASECC.
BCLBL Input-integer-default=0. f06 file page header control.
-2 Clear LABEL/SUBTITLE/TITLE.
-1 Clear LABEL.
0 Initialize LABEL without page eject.
1 Initialize LABEL with page eject.
2 Initialize LABEL/SUBTITLE/TITLE with page eject.
3 Initialize LABEL/SUBTITLE/TITLE without page eject.
Main Index
BDRYINFO
Generates geometry and connectivity information
634
Generate the geometry and connectivity information for an external superelement definition based on the
ASETi and QSETi Bulk Data entries and requested by the EXTSEOUT Case Control command.
Format:
Input Data Blocks:
Output Data Block:
BDRYINFO
Generates geometry and connectivity information
BDRYINFO CASECC,GEOM1,GEOM2,BGPDT,USET,BULK,BULKINDX/
GEOM1EX,GEOM2EX,GEOM4EX,CASEEX/
MTRXFLAG/DMIGSFIX $
CASECC Table of Case Control command images.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.
BGPDT Basic grid point definition table.
USET Degree-of-freedom set membership table for g-set.
BULK Table of all Bulk Data entries.
BULKINDX Table of BULK indices.
GEOM1EX GEOM1 table containing records which define an external superelement.
Specifically, it contains CORD1j, CORD2j, EXTRN, and GRID Bulk Data records.
GEOM2EX GEOM2 table containing records which define an external superelement.
Specifically, it contains PLOTEL and SPOINT Bulk Data records.
GEOM4EX GEOM4 table containing records which define an external superelement.
Specifically, it contains ASETi and QSETi Bulk Data records.
CASEEX Table of Case Control modified to include displacement output requests for all
boundary points and all points connected to PLOTEL elements.
Main Index
635 BDRYINFO
Generates geometry and connectivity information
Parameters:
MTRXFLAG Input-integer-no default. Bit pattern indicating existence of boundary
matrices. Used by EXTSEOUT(DMIGPCH) option only.
Boundary Matrix Bit Position from Right
Stiffness
1
Mass
2
Viscous damping
3
Structural damping
4
Static loads
5
Acoustic coupling
6
DMIGSFIX Input-character-no default. DMIG matrix name suffix. Used by
EXTSEOUT(DMIGPCH) option only.
Main Index
BGCASO
Updates Case Control table for contact
636
Updates Case Control table for contact region data recovery operations.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
BGCASO
Updates Case Control table for contact
BGCASO CONTACT,BTOPO,CASECC,XYCDB/
CASECCBO/
S,N,NEWCASE/S,N,NBSORT2 $
CONTACT Table of Bulk Data entries related to contact regions.
CASECC Table of Case Control command images.
BTOPO Contact regions topological information table.
XYCDB Table of x-y plotting command.
CASECCBO Updated CASECC for contact region data recovery operations.
NEWCASE Output-integer-no default. CASECCBO output flag. Set to 1 if CASSECBO is
generated.
NBSORT2 Output-integer-default=0. Contact region output sort format flag.
1 if SORT2 format is requested for printing
2 if x-y plotting is requested.
Main Index
637 BGP
Processes geometry for boundary contact regions
Processes the geometry for the boundary contact regions. Updates the penalty values for slideline
elements in the contact regions topological information table and creates a new boundary grid point
element connection table.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. CSTM may be purged.
2. BTOPO is both input and output. See example.
Example:
Excerpt of BGP for a nonlinear loop in SOL 106.
FILE BTOPSTF=APPEND/BTOPCNV=APPEND $
BGP CSTMS,SILS,KGGT/BTOPSTF,BGPECT/ADPCONx/ISKIP $
BGP
Processes geometry for boundary contact regions
BGP CSTM,SIL,KGGT/
BTOPO,BGPECT/
ADPCON/ISKIP $
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
KGGT Total structural stiffness matrix in g-size (sum of linear, nonlinear and differential
matrices).
BTOPO Contact regions topological information table.
BGPECT Boundary grid point element connection table.
ADPCON Input-real-default=1.0. Scale factor for adjusting penalty values on restart. Update
penalty values if positive.
ISKIP Input-integer-default=0. Counter to update penalty values; updates on first pass and
no update later.
Main Index
BGP
Processes geometry for boundary contact regions
638
COPY BTOPSTF/BTOPCNV/-1/1 $
Main Index
639 BMG
Generates hydroelastic boundary matrices
Generates boundary matrices (in DMIG format) for hydroelastic analysis.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remark:
MTRXIN must always be used in conjunction with module BMG to produce the matrices. See example.
Example:
Generate hydroelastic boundary matrices.
BMG MATPOOL,BGPDTS,CSTMS/
BDPOOL/
S,N,NOKBFL/S,N,NOABFL/S,N,MFACT $
ABFL = NOTL(NOABFL) $
IF ( ABFL OR NOTL(NOKBFL)
) MTRXIN ,,BDPOOL,EQDYN,,/
ABFL,KBFL,/
BMG
Generates hydroelastic boundary matrices
BMG MATPOOL,BGPDT,CSTM/
BDPOOL/
S,N,NOKBFL/S,N,NOABFL/S,N,MFACT $
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary data.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format.
NOKBFL Output-integer-no default. Matrix KBFL existence flag; 0 if KBFL exists and -1
otherwise.
NOABFL Output-integer-no default. Matrix ABFL existence flag; 0 if ABFL exists and -1
otherwise.
MFACT Output-complex-no default. Scale factor for hydroelastic boundary mass matrix.
Main Index
BMG
Generates hydroelastic boundary matrices
640
LUSETD/NOABFL/NOKBFL/0 $
Main Index
641 BNDSPC
Processes constraints on superelement boundaries
Processes constraints and enforced displacements applied on superelement boundaries.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. BNDSPC will perform one of three possible operations, depending on the coordinate system
alignment at the boundary:
a. Allow the SPC to be applied in the current superelement.
b. Move the constraint to a downstream superelement.
c. Issue a fatal error due to incompatible coordinate systems.
2. YS cannot be purged.
BNDSPC
Processes constraints on superelement boundaries
BNDSPC SEMAP,USET,BGPDT,YS,YSD/
USET1,YS1/
SEID/NLOADS $
SEMAP Superelement map table.
USET Degree-of-freedom set membership table.
BGPDT Basic grid point definition table for the current superelement.
YS Matrix of enforced displacements.
YSD Accumulated matrix of enforced displacements from upstream superelements.
USET1 USET updated with constraints from upstream superelements.
YS1 YS updated with enforced displacements from upstream superelements.
SEID Integer-input-default=0. Superelement identification number.
NLOADS Integer-input-default=0. The number of subcase records contiguous with respect to
the MPC and SPC command in the first subcase of the current boundary condition.
Main Index
BNDSPC
Processes constraints on superelement boundaries
642
Example:
Excerpt from subDMAP PHASE0 with BNDSPC in a superelement and boundary condition loop.
DO WHILE (LPFLG >= 0) $
.
.
.
BCFLAG=TRUE $
DO WHILE ( BCFLAG ) $
.
.
.
BNDSPC EMAP,USET0,BGPDTS,YSB,YSD/
USET01,YSB1/
SEID/NLOADS $
EQUIVX USET01/USET0/-1 $
EQUIVX YSB1/YSB/-1 $
.
.
.
ENDDO $ BCFLAG
ENDDO $ LPFLG
Main Index
643 CAMPREP
Creates list of DDVAL entry values for Campbell looping
Creates a list of DDVAL entry values for Campbell looping.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
CAMPREP
Creates list of DDVAL entry values for Campbell looping
CAMPREP CASECC,DYNAMIC,EDOM/
CAMPDD/
S,N,CAMPPARM/S,N,CAMPTYPE/S,N,CAMPID/
S,N,CAMPFID/S,N,CAMPNAME/S,N,NCAMPVAL $
CASECC Table of Case Control selections.
DYNAMIC Table of Bulk Data Entries related to dynamics.
EDOM Table of Bulk Data entries that contain the DDVAL entries referenced by RSPINR
records in DYNAMIC.
CAMPDD Table values from DDVAL Bulk Data entries.
CAMPPARM Output-integer-default=0. Campbell loop parameter.
1 Speed
2 Element property
3 Element material
CAMPTYPE Output-character-default=' '. Campbell loop type.
FREQ/RPM Speed
PBAR/PELAS Element property
MAT1/MAT2 Element material
CAMPID Output-integer-default=0. Campbell loop property identification number.
PID Element property
MID Element material
CAMPFID Output-integer-default=0. Campbell loop property identification number.
Main Index
CAMPREP
Creates list of DDVAL entry values for Campbell looping
644
0 Speed
>0 Word position in EPT for "property" or MPT for "material"
CAMPNAME Output-character-default=' '. Campbell loop name.
Blank Speed
'T' or 'A' Property
'E' or 'RHO' Material
NCAMPVAL Output-integer-default=0. Number of values on the DDVAL entry.
Main Index
645 CASE
Dynamic analysis case control loop driver
Assembles the appropriate subcases (records) of Case Control for the current loop based on various Case
Control commands.
Format:
Input Data Blocks:
Output Data Block:
CASE
Dynamic analysis case control loop driver
CASE CASECC, /
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP/S,N,LINC/GMAFLG/S,N,MSCHG/
S,N,TESTNEG/S,N,IMETHOD/CASCOM1/CASCOM2/CASCOM3/
CASCOM4/CASCOM5/CASCOM6/CASCOM7/CASCOM8/CASCOM9/
CASCOM10/S,N,CASEID/S,N,ORIGDT/PARCOM1/PARCOM2/
PARCOM3/PARCOM4/PARCOM5/PARCOM6/PARCOM7/PARCOM8/
PARCOM9/PARCOM10 $
CASECC Table of Case Control command images.
PSDL Power spectral density list. Required only when APP='FREQ'.
MPT Table of Bulk Data entry images for TSTEPNL, NLPARM, and NLPCI. Required
only when APP='NONL'.
PVT Table containing parameter values from PARAM Bulk Data entries. PVT is only
needed when APP='COMM' and the PARAMi parameters are specified.
CASEXX Subset of CASECC for current loop.
PSDL
MPT
PVT
)
`
Main Index
CASE
Dynamic analysis case control loop driver
646
Parameters:
APP Input-character-no default. Analysis type:
'CEIG' Complex eigenvalue.
'FREQ' Frequency response.
'TRAN' Transient response.
'NONL' Nonlinear static or transient.
'SLIC' Slice a contiguous subset of CASECC records into CASEXX; i.e.,
NOLOOP number of records starting with the NSKIP-th record.
'COMM' Extract a slice of contiguous subset records, beginning at the NSKIP-
th record, with the same Case Control command set identification
numbers for command names specified in CASCOMi.
NSKIP Input/output-integer-default=1. CASECC record counter or nonlinear transient
loop identification number.
Input:
<0 Skip one record on CASECC.
>0 Number of records to skip on CASECC to reach the current subset of
CASECC.
Output:
-1 No more cases.
>0 and APP<>'NONL': Indicates the number of records to skip on CASECC
to reach the next subset of CASECC.
>0 and APP='NONL': Indicates there are more CASECC records to process
and NSKIP must be incremented in the DMAP.
NOLOOP Output-integer-default=-1. Looping test flag.
-1 No DMAP looping is required.
1 DMAP looping is required.
LINC Output-integer-default=0. Number of load increments for this subcase. Used in
nonlinear static analysis only (APP='NONL' and IMETHOD=0).
GMAFLG Input-integer-default=0. Test control flag for changes in the set identification
numbers specified for the SDAMPING, K2PP, M2PP, B2PP, and TFL
commands. Used only when APP='FREQ' or 'CEIG'.
0 Do not ignore changes (default).
1 Ignore changes.
Main Index
647 CASE
Dynamic analysis case control loop driver
Remarks:
The method of operation depends upon APP and IMETHOD.
APP='CEIG': Complex eigenvalue analysis.
CASE CASECC,/
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP//GMAFLG $
The first NSKIP records (subcases) on CASECC are skipped. The next record is read and copied onto
CASEXX and an attempt is made to read the next record of CASECC. If this is not possible, NSKIP is
set to -1 and, if this is the first entry into CASE, NOLOOP is set to -1.
If the next record was read successfully and GMAFLG=0, then the set identification numbers specified
for the K2PP, M2PP, B2PP, TFL, and SDAMPING Case Control commands are compared with the
previous subcase. If they all agree, this record is copied onto CASEXX and the process is nskiped. If they
do not agree, NSKIP is incremented by 1 and NOLOOP is set to 1 and module is exited.
MSCHG Output-integer-default=0. Boundary condition change flag. Used in nonlinear
static analysis only (APP='NONL' and IMETHOD=0).
-1 If MPC and SPC Case Control commands for this subcase are the same
as those in the immediately preceding subcase.
1 If MPC or SPC commands are different.
TESTNEG Output-integer-default=-2. Load increment method flag. Used in nonlinear
static analysis only (APP='NONL' and IMETHOD=0).
-2 Standard.
1 Controlled increment.
IMETHOD Input/output-integer-default=0. Nonlinear transient analysis flag.
Input:
0
Nonlinear static analysis (default).
<>0 Nonlinear transient analysis.
Output (nonlinear transient only):
-1 Auto or TSTEP method (NLTRD module).
2 ADAPT method (NLTRD2 module).
CASCOMi Input-character-default=' '. Case Control command names. See
APP='COMM'.
CASEID Input/output-integer-default=0. Subcase identification number.
ORIGDT Input/output-real-default=0. Original delta-t for SOL 400.
PARCOMi Input-character-default=' '. Names of user PARAMeters to be processed
under the APP=COMM option along with the CASCOMi names.
Main Index
CASE
Dynamic analysis case control loop driver
648
APP='FREQ': Frequency response.
CASE CASECC,PSDL/
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP//GMAFLG $
Processing is the same as complex eigenvalue analysis, except that the set identification numbers
specified for the FREQUENCY Case Control command is also compared. If the RANDOM command is
specified then the selected set is read from PSDL and a list of subcase identification numbers referenced
by the RANDPS Bulk Data entry images is made. If some subcases referenced by RANDPS Bulk Data
entry images have not been output on CASEXX, CASE terminates with User Fatal Message 3033.
APP='TRAN': Linear transient response.
CASE CASECC,/
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP $
The first NSKIP records (subcases) on CASECC are skipped. The next record is read and copied onto
CASEXX and an attempt is made to read the next record of CASECC. If this is not possible, NSKIP is
set to -1 and, if this is the first entry into CASE, NOLOOP is set to -1.
APP='NONL' and IMETHOD=0: Nonlinear static analysis.
CASE CASECC,MPT/
CASEXX/
APP/S,N,NSKIP//S,N,LINC//S,N,MSCHG/S,N,TESTNEG $
The first NSKIP records on CASECC are skipped. The next record is read and copied onto CASEXX.
MSCHG is set to indicate whether the MPC or SPC set identification numbers have changed since the
previous subcase. NINC is set equal to the value in the NINC field on the selected NLPARM Bulk Data
entry image. If there is an associated NLPCI Bulk Data entry image, the controlled increment method is
being used, and the TESTNEG parameter is set to indicate this. TEMPERATURE(INITIAL) and
TEMPERATURE(LOAD) commands are checked for proper specification.
APP='NONL' and IMETHOD<>0: Nonlinear transient response.
CASE CASECC,MPT/
CASEXX/
APP/S,N,NSKIP//////S,N,IMETHOD $
IMETHOD is set according to the METHOD field of the selected TSTEPNL Bulk Data entry image in
MPT. NSKIP is set to the loop identification number.
Main Index
649 CASE
Dynamic analysis case control loop driver
Examples:
1. Extract the load and subcase identification numbers and a parameter value from each subcase.
SOL 100
COMPILE USERDMAP
ALTER 2
TYPE PARM,,I,N,NSKIP $
TYPE PARM,,I,Y,MYPRM $
NSKIP=0 $ INITIALIZE
DO WHILE ( NSKIP>=0 ) $
CASE CASECC,/CASE1/TRAN/S,N,NSKIP $
PVT PVT,CASE1/ $
PARAML CASE1//DTI/1/1//S,N,SUBID $
PARAML CASE1//DTI/1/4//S,N,ILOAD $
MESSAGE // SUBID=/SUBID/ MYPRM=/MYPRM/
ILOAD=/ILOAD $
ENDDO $
CEND
SUBCASE 101
PARAM,MYPRM,1
LOAD=111
SUBCASE 102
PARAM,MYPRM,-6
LOAD=222
SUBCASE 103
PARAM,MYPRM,4
LOAD=333
SUBCASE 104
PARAM,MYPRM,22
LOAD=444
SUBCASE 105
PARAM,MYPRM,-3
LOAD=555
SUBCASE 106
PARAM,MYPRM,77
LOAD=666
BEGIN BULK
ENDDATA
2. Extract Case Control records 10, 11, and 12.
CASECASECC,/CASE10/'SLIC'/10/3 $
3. Extract Case Control records with the same MPC, SPC, and SUPORT set identification
numbers beginning at the NSKIP-th record.
CASECASECC,/CASEBC/'COMM'/S,N,NSKIP/
//////'MPC'/'SPC'/'SUPO' $
Main Index
CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
650
Given that , and are mass, damping, and stiffness, solve the equation:
(4-3)
or
(4-4)
for the eigenvalues p and the associated right eigenvectors or left eigenvectors .
Given a non-null rectangular matrix , real or complex, it can be decomposed by the equation:
where and are square matrices of orthogonal functions, and has non-zero terms along the diagonal
of its left-most partition.
Format:
Input Data Blocks:
CEAD
Complex, unsymmetric eigenvalue analysis or singular value
decomposition
CEAD KXX,BXX,MXX,DYNAMIC,CASECC,VDXC,VDXR/
CPHX,CLAMA,OCEIG,LCPHX,CLAMMAT/
S,N,NEIGV/UNUSED2/SID/METH/EPS/ND1/ALPHAJ/OMEGAJ/
MAXBLK/IBLK/KSTEP/NDJ $
KXX Stiffness matrix. Usually KHH or KDD. If METH=SVD then KXX may be a non-
null real or complex rectangular matrix. See Remark 9.
BXX Viscous damping matrix. Usually BHH or BDD.
MXX Mass matrix. Usually MHH or MDD.
DYNAMIC Table of Bulk Data entry images related to dynamics.
CASECC Table of Case Control command images.
VDXC Partitioning vector with 1.0 at rows corresponding to null columns in KDD, BDD,
and MDD.
VDXR Partitioning vector with 1.0 at rows corresponding to null rows in KDD, BDD, and
MDD.
M | | B | | K | |
M | |p
2
B | |p K | | + + ( ) | { } 0 =
|
L
{ }
T
M | |p
2
B | |p K | | + + ( ) 0 { } (Lanczo =
| { } |
L
{ }
K
U | | S | | V
T
| | K =
U V S
Main Index
651 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
Output Data Blocks:
Parameters:
CPHX Complex eigenvector matrix. Usually CPHH or CPHD. If METH=SVD then
CPHX is V. See Remark 9.
CLAMA Complex eigenvalue summary table.
OCEIG Complex eigenvalue extraction report.
LCPHX Left-handed complex eigenvector matrix (Lanczos only). Usually LCPHH or
LCPHD. If METH=SVD then CPHX is U. See Remark 9.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal. See Remark 8. If
METH=SVD then CPHX is S. See Remark 9.
NEIGV Output-integer-no default. NEIGV indicates the number of eigenvalues found. If
none were found, NEIGV is set to -1.
UNUSED2 Input-integer-default=1. Unused.
SID Input-integer-default=0. Alternate set identification number.
If SID=0, the set identification number is obtained from the CMETHOD
command in CASECC and used to select the EIGC entry in DYNAMIC.
If SID>0, then the CMETHOD command is ignored and the EIGC entry is
selected by this parameter value. Applicable for all methods.
If SID<0, then both the CMETHOD command and all EIGC entries are ignored
and the subsequent parameter values (E, ND1, etc.) will be used to control the
eigenvalue extraction. Applicable for single vector Lanczos, block Lanczos, QZ
Hessenberg, QR Hessenberg, and SVD (Singular Value Decomposition).
METH Input-character-default='CLAN'. If SID<0, then METH specifies the method of
eigenvalue extraction.
CLAN Complex Lanczos (block or single vector).
HESS QZ Hessenberg or QR Hessenberg.
SVD Singular Value Decomposition. See Remark 9.
EPS Input-real-default=1.E-5. Used only when SID<0.
ND1 Input-integer-default=0. The number of desired eigenvectors. Used only when
SID<0. If METH=SVD, then
>0
Full SVD is computed.
<0
The "economy" SVD is computed.
=0
All singular values are computed, but no singular vectors are computed.
Main Index
CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
652
Method:
Complex eigenvalues and the associated eigenvectors are calculated in CEAD (Complex Eigenvalue
Analysis -- Displacement) using the inverse power method, the determinant method, the Hessenberg
method, or the Lanczos method, as requested by the user on the EIGC Bulk Data entry. For direct
complex eigenvalue analysis and if PARAM,ASING = 0 (default) then null rows and columns are
discarded from , , and to form , , and .
In the case of a direct formulation CEAD extracts the eigenvalues from the following equation.
(4-5)
is then augmented with null rows to form .
In the case of a modal formulation the following equation is used:
(4-6)
CEAD also normalizes the eigenvectors according to one of the following user requests:
Unit magnitude of a selected coordinate (POINT).
Unit magnitude of the largest component (MAX).
as specified on the EIGC Bulk Data entry.
Remarks:
1. Eigenvalues are extracted by the Inverse Power, Determinant, Hessenberg, or Lanczos method.
2. At least one of KXX, BXX, and MXX must be present.
3. No output data block can be purged except for LCPHX and CLAMMAT. LCPHX can be purged
for methods other than Lanczos. CLAMMAT may be purged for all.
4. CLAMA and OCEIG are suitable for printing by the OFP module.
5. For the Hessenberg method, spill logic may be requested with SYSTEM(108)=1 on the
NASTRAN statement. This allows for no limits on problem size.
ALPHAJ Input-real-default=0.0. Real part of shift point for pre-Version 70.5 Lanczos
method. Used only when SID<0.
OMEGAJ Input-real-default=0.0. Imaginary part of shift point for
pre-Version 70.5 Lanczos method. Used only when SID<0.
MAXBLK Input-real-default=0.0. Maximum block size. Used only when SID<0.
IBLK Input-real-default=0.0. Initial block size. Used only when SID<0.
KSTEP Input-real-default=0.0. Frequency of solve. Used only when SID<0.
NDJ Input-integer-default=0. The number of desired eigenvectors at desired shift point
for pre-Version 70.5 Lanczos method. Used only when SID<0.
K
dd
| | M
dd
| | B
dd
| | K
xx
d
| | M
xx
d
| | B
xx
d
| |
M
xx
d
p
2
B
xx
d
p K
xx
d
+ + | | u
x
d
{ } 0 =
u
x
d
{ } u
d
{ }
M
hh
p
2
B
hh
p K
hh
+ + | | u
h
{ } 0 =
Main Index
653 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
6. For the Hessenberg method, the mass matrix must be nonsingular.
7. The UEIGL module is recommended for real unsymmetric eigensolutions.
8. CLAMMAT contains the diagonal matrix of eigenvalues, with dimensions compatible with
CPHX and/or LCPHX so that
and
For development purposes, when block Lanczos is selected and system cell 108 is set to 2048, the
fifth output slot will contain the cross orthogonality matrix
which should be identity. See the MSC.Nastran Numerical Methods Users Guide for the
definition of Y and X.
9. CEAD may be used to perform singular value decomposition.
is the transpose of the complex conjugate of . The terms of are always positive or zero
(non-negative), and real. The terms of are sorted in descending order (largest first). The single
matrix eigenproblem can be regarded as a special case of the SVD problem. For the case of
real, symmetric, and positive semi-definite , and is the matrix of roots of
The roots and vectors are sequenced inversely from the MSC Nastran convention. Singular Value
Decomposition is a standard mathematical technique with well-defined properties. Both and
may be purged and CEAD will execute faster if they are are purged. The input matrix must
fit into memory because there is no spill capability. The singular value decomposition uses the
format shown in the Example 2. Although is real by definition, it is returned as a complex
matrix with 0.0 imaginary parts. The other outputs are also complex in form, although they are
sometimes real in content.
Example:
1. The following DMAP sequence extracts eigenvalues and eigenvectors and prints the results.
CEAD K,B,M,DYNAMIC,CASECC,,/VEC,CLAMA,OCEIGS,/
S,N,NFOUND $
OFP CLAMA,OCEIGS// $
IF (NFOUND>-1) MATPRN VEC// $
2. Assume that a rectangular matrix A is provided. Find the matrices of its singular value
decomposition, and test to see that these matrices satisfy the equation
KDD | | CPHX | | BDD | | CPHX | | CLAMMAT | | MDD | | CPHX | | CLAMMAT | |
2
0 = + +
LCPHX | |
T
KDD | | CLAMMAT | | LCPHX | |
T
+ BDD | | CLAMMAT | |
2
LCPHX | |
T
KDD | | 0 = +
Y | |
T
X | |
V
T
V S
S
K
U V = S
K *I | |*| 0 =
U
V K
S
A U*S*V' 0 =
Main Index
CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
654
CEAD A,,,,,,/V,CLAMA,OCEIGS,U,S/
S,N,NFOUND//-1/SVD//1 $ 1 MEANS COMPLETE SET OF VECTORS
MATMOD V,,,,,/VBAR,/10 $ COMPLEX CONJUGATE
TRNSP VBAR/VT $
MATPRN U,S,V// $
SMPYAD U,S,VT,,,/ABAR/3 $
ADD A,ABAR/ERROR//-1.0 $
NORM ERROR/SCRERR///S,N,MAXERROR $
MESSAGE //LARGEST ERROR IN SVD IS /MAXERROR $
Main Index
655 CMPZPR
Generates Bulk Data entry images based on PCOMP and MAT8
Generates the equivalent PSHELL and MAT2 Bulk Data entry images based upon data on PCOMP and
MAT8 Bulk Data entry images. Functionally equivalent to IFP6.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. CMPZPR is functionally equivalent to module IFP6.
2. For each PCOMP entry (with PID<100000000) in EPT, an equivalent PSHELL entry image with
associated MAT2 images is generated. The newly generated images are then merged with the
existing PSHELL and MAT2 entries and written to the output datablocks EPTC and MPTC,,
respectively. If any duplicates are found in EPT and MPT, then they are simply overwritten.
Furthermore, any entries which may have been internally generated (i.e., with PID or
MID>100000000) are also stripped off.
CMPZPR
Generates Bulk Data entry images based on PCOMP and MAT8
CMPZPR EPT,MPT,DIT,PCOMPT/
EPTC,MPTC/
S,N,NOCOMP $
EPT Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries.
MPT Table of Bulk Data entry images related to material properties, in particular, MAT2
and MAT8 entries.
DIT Table of TABLEij Bulk Data entry images.
PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry.
EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL records.
MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2 records.
NOCOMP Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry records
are found.
Main Index
CMSENGY
Compute component modal energies
656
Compute component modal strain and kinetic energies with respect to normal modes and forced response
analysis.
Format:
Format for computing the results in a given superelement:
Format for printing accumulated results for all superelements:
Format for enquiring the CMSENERGY Case Control requests:
Input Data Blocks:
CMSENGY
Compute component modal energies
CMSENGY CASECC,OL,USET,BGPDT,CMLAMA,SYSE,CMSQE,CMSTQE/
CMSEQ,CMSTEQ/
SEID/NOUP/CMEOUT/UNUSED/CMERTYPE/CMETYPE/
S,N,CMSEREQ/S,N,CMKEREQ/S,N,CMDEREQ/
S,N,CMFVEREQ/S,N,CMFREREQ $
CMSENGY CASECC,OL,USET,BGPDT,CMLAMA,SYSE,CMSQE,CMSTQE/
CMSEQ,CMSTEQ/
SEID/NOUP/CMEOUT/UNUSED/CMERTYPE/CMETYPE $
CMSENGY CASECC,,,,,,ITSTNQ,ITOTLQ/,///-1 $
CMSENGY CASECC,,,,,,,/,/
SEID/NOUP/-2//CMERTYPE/CMETYPE/
S,N,CMSEREQ/S,N,CMKEREQ/S,N,CMDEREQ/
S,N,CMFVEREQ/S,N,CMFREREQ $
CASECC Table of Case Control command images.
OL Real eigenvalue summary table, transient response time output list or frequency
response frequency output list. Must be consistent with APP.
USET Degree-of-freedom set membership table for g-set.
BGPDT Basic grid point definition table.
CMLAMA Component modal eigenvalue summary table.
SYSE Matrix of (strain or kinetic) energy in the residual structure a-set.
Main Index
657 CMSENGY
Compute component modal energies
Output Data Blocks:
Parameters:
CMSQE Matrix of (strain, kinetic, or damping) energy in the component.
CMSTQE Matrix of (strain, kinetic, or damping) energy in the component.
CMSEQ Table of (strain, kinetic, or damping) energy in all components.
CMSTEQ Table of (strain, kinetic, or damping) energy in all components.
SEID Input-integer-default=0. Superelement indentification number.
NOUP Input-integer-default=0. Upstream superelement flag. Set to -1 if there are no
superelements connected upstream from the current superelement.
CMEOUT Input-integer-default=0. Module processing flag.
-2 Query the Case Control CMSENERGY request.
-1 Print/punch accumulated results.
0 Compute results tables for the current superelement.
UNUSED Input-integer-default=0. Unused and may be unspecified.
CMERTYPE Input-integer-default=-1. Type of response of input matrices.
1 Free vibrations
2 Modal frequency
3 Modal transient
CMETYPE Input-integer-default=-1. Type of energy of input matrices.
1 Strain energy
2 Kinetic energy
3 Damping energy
CMSEREQ Output-integer-default=-1. Component modal strain energy request flag.
-1 No
0 Yes
CMKEREQ Output-integer-default=-1. Component modal kinetic energy request flag.
-1 No
0 Yes
CMDEREQ Output-integer-default=-1. Component modal damping energy request flag.
-1 No
0 Yes
Main Index
CMSENGY
Compute component modal energies
658
CMFVEREQ Output-integer-default=-1. Component modal free vibration energy request flag.
-1 No
0 Yes
CMFREREQ Output-integer-default=-1. Component modal forced response energy request
flag.
-1 No
0 Yes
Main Index
659 COPY
Explicit data block copy
Copies data blocks.
Format:
Input Data Block:
Output Data Block:
Parameters:
Remarks:
1. If BLOCK < 0 and the block size between DBI and DBO is different, then a fatal error will be
issued.
2. This module is preferred over the copy options in MATMOD option 13 and TABEDIT.
Example:
To copy data block KELM:
COPY KELM/KELMX/ALWAYS/-1 $
COPY
Explicit data block copy
COPY DBI/DBO/PARM/BLOCK $
DBI The data block to be copied.
DBO A copy of DBI.
PARM Input-integer-default=-1 (PARM < 0 - the data block is copied. PARM > 0 -- no
action is taken.).
BLOCK Input-integer-default=1.
BLOCK < 0 -- Block sensitive copy is used.
BLOCK > 0 -- Standard copy is used.
Main Index
CURV
Transforms elemental centroid stresses (or strains)
660
Transforms elemental centroid stresses (or strains) to the element's material coordinate system and/or
interpolate the stresses (or strains) to element's connecting grid points. Applies to CQUAD4 and CTRIA3
elements and non-corner stresses only.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
CURV
Transforms elemental centroid stresses (or strains)
CURV OES1,MPT,CSTM,EST,BGPDT/
OES1M,OES1G/
OUTOPT/OG/NINTPTS $
OES1 Element stress or strain table in SORT1 format.
MPT Table of Bulk Data entry images related to material properties.
CSTM Table of coordinate system transformation matrices.
EST Element summary table.
BGPDT Basic grid point definition table.
OES1M Element stress or strain table in SORT1 format in the element's material coordinate
system defined on the MAT1 entry.
OES1G Grid point stress or strain table in SORT1 format and interpolated from the
centroidal stress table, OES1M.
OUTOPT Input-integer-default=0. Output option:
<0 Use the element output option found on OES1.
1 Print
2 Plot
4 Punch
The above values may be added together to select two or more forms of output. For
example, OUTOPT=6 requests both plot and punch output.
Main Index
661 CURV
Transforms elemental centroid stresses (or strains)
Remarks:
1. CURV computes the CTRIA3 and CQUAD4 element stress and/or strain output in a material
coordinate system (normal output is in the element or basic coordinate system) and/or to
interpolate the stresses (or strains) to its connecting grid points.
2. For further details see also CURV (p. 711) in the MSC Nastran Quick Reference Guide.
OG Input-integer-default=0. Grid point processing flag. If set to 0, then grid point
stresses or strains are computed.
NINPTPS Input-integer-default=0. Approximate number of surrounding independent element
interpolation points to be considered when interpolating at a grid point for a given
material coordinate system.
Main Index
CURVPLOT
Converts grid point output tables
662
Converts grid point output tables; i.e, related to applied loads, SPCforces, displacements, stresses and
strains in SORT1 format, to tables suitable for x-y plotting where the abscissa is grid point locations and
the ordinate is the grid point output quantity.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
CURVPLOT
Converts grid point output tables
CURVPLOT EQEXIN,BGPDT,EDT,XYCDB,OPG1,OQG1,OUG1,OES1G,OSTR1G/
OPG2X,OQG2X,OUG2X,OES2GX,OSTR2GX/
DOPT $
EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
BGPDT Basic grid point definition table.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics, p-
element analysis, and the iterative solver; and in particular, SET1 entries.
XYCDB Table of x-y plotting commands.
OPG1 Table of applied loads in SORT1 format.
OQG1 Table of single point forces of constraint in SORT1 format.
OUG1 Table of displacements in SORT1 format.
OES1G Table of grid point stresses in SORT1 format.
OSTR1G Table of grid point strains in SORT1 format.
OPG2X Table of applied loads in SORT2 format.
OQG2X Table of single point forces of constraint in SORT2 format.
OUG2X Table of displacements in SORT2 format.
OES2GX Table of grid point stresses in SORT2 format.
OSTR2GX Table of grid point strains in SORT2 format.
DOPT Input-integer-default=0. Scaling method between grid points on the abscissa.
0 Proportional with respect to total distance.
Main Index
663 CURVPLOT
Converts grid point output tables
Remarks:
1. If EDT or XYCDB is purged, then CURVPLOT exits without warning.
2. EQEXIN and BGPDT cannot be purged.
3. Any of OPG1, OQG1, OUGV1, OES1G or OSTR1G and any of their corresponding outputs may
be purged.
4. OES1G and OSTR1G are computed by CURV.
5. The grid points used on the abscissa are specified on SET1 entries in EDT.
6. The output data blocks cannot be printed with OFP.
7. CURVPLOT is only applicable to static and normal modes analysis.
Example:
Excerpt from subDMAP SEDRCVR.
CURVPLOT EQEXINS,BGPDTS,EDT,XYCDBDR,OPG1,OQG1,OUGV1,OES1G,/
OPG2X,OQG2X,OUG2X,OES2X,/DOPT $
XYTRAN XYCDBDR,OPG2X,OQG2X,OUG2X,OES2X,/XYPLTS/'SET1'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOXYP $
IF ( NOXYP>=0 ) XYPLOT XYPLTS/ $
1 Proportional with respect to x distance only.
2 Proportional with respect to y distance only.
3 Proportional with respect to z distance only.
4 Equally.
Main Index
CYCLIC1
Generates cyclic symmetry tables and transformation matrices
664
Generates transformation matrices and modifies Case Control and static loads for cyclic symmetry
analysis.
Format:
Input Data Blocks:
Output Data Blocks:
CYCLIC1
Generates cyclic symmetry tables and transformation matrices
CYCLIC1 CASECC,GEOM3,GEOM4,DIT,FRL/
KVAL,GEOM3N,CASEFR,HARM,FORE,CASEBK,BACK/
S,N,NSEG/S,N,CTYPE/APP/S,N,NOGEOM3/S,N,NFREQ/
S,N,TOTALK $
CASECC Table of Case Control command images.
GEOM3 Table of Bulk Data entry images related to static loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
DIT Table of TABLEij Bulk Data entry images.
FRL Frequency response list.
KVAL Table of harmonic indices for analysis.
GEOM3N Updated GEOM3 for cyclic symmetry analysis.
CASEFR Updated Case Control table for static loads generation and solution in cyclic
symmetry analysis. One record for every distinct load set identification number.
HARM Table of harmonic indices.
FORE Transformation matrix from physical to cyclic components.
CASEBK Case Control table for cyclic data recovery. One record for every column in BACK.
Required in static and pre-buckling analysis only.
BACK Transformation matrix from cyclic to physical components. Required in static and
pre-buckling analysis only.
Main Index
665 CYCLIC1
Generates cyclic symmetry tables and transformation matrices
Parameters:
Remark:
CYCLIC1 generates equivalent GRAV and RFORCE Bulk Data entry images in harmonic components.
NSEG Output-integer-no default. Number of cyclic segments as specified on CYSYM
Bulk Data entry.
CTYPE Output-character-no default. Cyclic symmetry type as specified on CYSYM Bulk
Data entry.
'ROT' Rotational
'AXI' Axisymmetric
'DIH' Dihedral
APP Input-character-no default. Analysis type.
'STATICS' Statics
'MODES' Normal modes
'BUCKLNG1' Pre-buckling (statics)
'BUCKLNG2' Buckling
'FREQRESP' Frequency response
NOGEOM3 Output-integer-no default. GEOM3N creation flag. Set to 1 if GEOM3N is created,
otherwise set to -1.
NFREQ Output-integer-no default. Number of frequencies for frequency response analysis.
TOTALK Output-integer-default=0. Total number of harmonics.
Main Index
CYCLIC2
Processes degrees-of-freedom
666
Processes degrees-of-freedom that are to be constrained between segments for cyclic symmetry
problems.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. CYCLIC2 is a preprocessor for the CYCLIC3 and CYCLIC4 modules is specified before the
harmonic index loop in DMAP.
2. CYCLIC2 processes CYJOIN, CYAX, and CYSUP Bulk Data entry images in GEOM4 and
identifies the constraints between the degrees-of-freedom in the analysis set for the cosine
(symmetric) and sine (antisymmetric) models.
3. CYCLIC2 can also accommodate the p-set:
CYCLIC2
Processes degrees-of-freedom
CYCLIC2 GEOM4,EQEXIN,USET/
CYCD/
NSEG/CTYPE $
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
USET Degree-of-freedom set membership table.
CYCD Table of constraints in harmonic components.
NSEG Input-integer-no default. Number of cyclic segments as specified on CYSYM Bulk
Data entry.
CTYPE Input-character-no default. Cyclic symmetry type as specified on CYSYM Bulk
Data entry.
'ROT' Rotational
'AXI' axisymmetric
'DIH' Dihedral
Main Index
667 CYCLIC2
Processes degrees-of-freedom
CYCLIC2 GEOM4,EQDYN,USETD/
CYCD/
NSEG/CTYPE $
where EQDYN and USETD are output by DPD.
Main Index
CYCLIC3
Forms cyclic matrices
668
Forms transformation matrices between cyclic components and solution set. Form partitioning vector for
supported degrees-of-freedom. Perform transformation of structural matrices in cyclic components to the
solution set.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
CYCLIC3
Forms cyclic matrices
CYCLIC3 CYCD,KVAL,KAA,MAA,BAA,K4AA/
KKK,MKK,BKK,K4KK,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $
CYCD Table of constraints in harmonic components.
KVAL Table of harmonic indices for analysis.
KAA Stiffness matrix in a-set or d-set.
MAA Mass matrix in a-set or d-set.
BAA Viscous damping matrix in a-set or d-set.
K4AA Structural damping matrix in a-set or d-set.
KKK Stiffness matrix in cyclic components.
MKK Mass matrix in cyclic components.
BKK Viscous damping matrix in cyclic components.
K4KK Structural damping matrix in cyclic components.
GC Transformations matrix between symmetric (cosine) components and solution set
components.
GS Transformation matrix between symmetric (sine) components and solution set
components.
PVEC Partitioning vector for supported degrees-of-freedom specified on CYSUP Bulk
Data entry.
HINDEX Input-integer-no default. Harmonic index.
NSEG Input-integer-no default. Number of segments.
Main Index
669 CYCLIC3
Forms cyclic matrices
Remarks:
1. For buckling analysis, then the negative of the differential stiffness, -KDAA, may be specified in
place of MAA.
ADD KDAA,/KDAAM/-1. $
CYCLIC3 CYCD,TKVAL,KAA,KDAAM,,/
KKK,MKK,,,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $
2. CYCLIC3 can also accommodate the p-set:
CYCLIC3 CYCD,KVAL,KDD,MDD,BDD,K4DD/
KKK,MKK,BKK,K4KK,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $
3. PVEC is formed in normal modes and static analysis if support degrees-of-freedom are specified
on the CYCSUP Bulk Data entry. PVEC is used to partition the solution set (cyclic degrees-of-
freedom) into l-set and r-set degrees-of- freedom for the zero-th and first harmonics. PVEC will
have rows equal to the number of columns in the GC matrix.
NOKVAL Output-integer-no default. Set to -1 if the value of HINDEX is not in the analysis set
of harmonic identification numbers.
KGTH Output-integer-no default. Set to -1 if all harmonic identification numbers (in
analysis set) have been processed.
REACT Output-integer-no default. Set to -1 if no support degrees-of- freedom; +1 if support
degrees of freedom exist; for k>2, it will always have value of -1.
Main Index
CYCLIC4
Transforms cyclic components of load vectors or displacements
670
Transforms the cyclic components of load vectors associated with a particular harmonic into solution set
load vectors in the forward path. In the backward path, the solution set displacement vectors will be
transformed into cyclic components associated with the particular harmonic and appended to previous
harmonic solutions.
Format:
Input Data Blocks:
CYCLIC4
Transforms cyclic components of load vectors or displacements
CYCLIC4 HARM,GC,GS, ,LAMA,CASEBK,BACK/
,LAMA1,CASEBK1,BACK1/
PATH/HINDEX/APP/S,N,NFREQ/TOTALK $
HARM Table of Case Control command images.
GC Transformations matrix between symmetric (cosine) components and solution set
components.
GS Transformation matrix between symmetric (sine) components and solution set
components.
PAC Static loads matrix in harmonic components.
PHK Eigenvectors in solution set components.
UK Solution vector in solution set components.
LAMA Eigenvalue summary table for current harmonic. Required for normal modes
analysis only (APP='REIG' and PATH='BACK').
CASEBK Case Control Data Block for output requests. Required for normal modes analysis
only. (APP='REIG' and PATH='BACK').
BACK Backward transformation matrix from cyclic to physical components. Required for
normal modes analysis only. (APP='REIG' and PATH='BACK').
PAC
PHK
UK
)
`
PK
PHX
UX
)
`
Main Index
671 CYCLIC4
Transforms cyclic components of load vectors or displacements
Output Data Blocks:
Parameters:
Examples:
1. Static analysis:
FILE UX=APPEND $
PARAML KVAL//'TRAILER'/1/S,N,NKVAL $ NUMBER OF ANALYSIS
HARMONICS
PARAML KVAL//'DTI'/1/NKVAL//S,N,KMAX $ LAST ANALYSIS HARMONIC
INDEX
PARAML KVAL//'IMATCH'/1/S,N,HINDEX//S,N,KVAL $
DO WHILE ( HINDEX<=KMAX ) $
CYCLIC4 HARM,GC,GS,PA,,,/
PK Load vector matrix in solution set components.
UX Solution vector matrix in cyclic components.
PHX Eigenvector matrix in cyclic components.
LAMA1 Appended eigenvalue summary table for all harmonics. Required for normal modes
analysis only. (APP='REIG' and PATH='BACK').
CASEBK1 Case Control table for data recovery requests for all harmonics. Required for normal
modes analysis only. (APP='REIG' and PATH='BACK').
BACK1 Backward transformation matrix from cyclic to physical components for all
harmonics. Required for normal modes analysis only. (APP='REIG' and
PATH='BACK').
PATH Input-character-no default. Direction of cyclic transformation:
'FORE' Forward (analysis)
'BACK' Backward (data recovery)
HINDEX Input-integer-no default. Harmonic index.
APP Input-character-no default. Analysis type.
'STAT' Statics
'REIG' Normal modes
'BUCK' Buckling
'FREQ' Frequency response
NFREQ Input/output-integer-no default. The number of passes through CYCLIC4.
NFREQ is incremented by one on each execution of CYCLIC4.
TOTALK Input-integer-default=0. Total number of harmonics. If TOTALK>0, then
CASEBK1 and BACK1 will be created. Required for normal modes analysis
only.
Main Index
CYCLIC4
Transforms cyclic components of load vectors or displacements
672
PK,,,/
'FORE'/HINDEX/'STAT'/NFREQ $
.
.
.
CYCLIC4 HARM,GC,GS,UK,,,/
UX,,,/
'BACK'/HINDEX/'STAT'/NFREQ $
ENDDO $ HINDEX<=KMAX
MPYAD UX,BACK,/ULC $
2. Frequency response analysis:
FILE UXVF=APPEND $
HINDEX=0 $ QUALIFIER
DO WHILE ( DONE>=0 ) $
IF ( DONE>=0 ) THEN $
IF ( NOKVAL>=0 ) THEN $
.
.
.
CYCLIC4 HARMF,GC,GS,PXF,,,/
PKF,,,/
'FORE'/HINDEX/RFNAME/NFREQ $
.
.
.
CYCLIC4 HARMF,GC,GS,UKVF,,,/
UXVF,,,/
'BACK'/HINDEX/RFNAME/NFREQ $
ENDIF $ NOKVAL>=0
HINDEX=HINDEX+1
ENDIF $ DONE>=0
ENDDO $ DONE>=0
MPYAD UXVF,BACKF,/UDVF $
3. Normal modes or buckling analysis:
FILE CYPHX=APPEND,SAVE/CYLAMA1=APPEND,SAVE/
CASEBK1=SAVE/BACK1=SAVE,OVRWRT $
PARAML KVALM//'TRAILER'/1/S,N,TOTALK $
PARAML KVALM//'DTI'/1/TOTALK//S,N,KMAX $
PARAML KVALM//'IMATCH'/1/HINDEX//S,N,KVAL $
HINDEX=0 $
DO WHILE ( HINDEX<=KMAX ) $
IF ( KVAL=-1 ) THEN $
.
.
.
CYCLIC4 HARM,GC,GS,CYPHA,CYLAMA,CASEBK,BACK/
CYPHX,CYLAMA1,CASEBK1,BACK1/
'BACK'/HINDEX/APPCYC4/S,N,NFREQ/TOTALK $
ENDIF $ KVAL=-1
HINDEX=HINDEX+1 $
PARAML KVALM//'IMATCH'/1/HINDEX//S,N,KVAL $
Main Index
673 CYCLIC4
Transforms cyclic components of load vectors or displacements
ENDDO $ HINDEX<=KMAX
MPYAD CYPHX,BACK1,/CYPHA1 $
Main Index
DBC
Database converter for model generation and results processing
674
Converts data blocks to a form usable by MSC.Access and MSC.Patran.
Format:
Input Data Block:
Output Data Blocks:
None.
Parameters:
DBC
Database converter for model generation and results processing
DBC DB1,DB2,DB3,DB4,DB5,DB6,DB7,DB8,DB9,DB10,DB11,
DB12,DB13,DB14,DB15,DB16,DB17,DB18,DB19,DB20//
P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P13/P14/
P15/P16/P17/P18/P19/P20/SEID/DBCPATH/
S,N,CP/APP/CYCLIC/GEOMU/LOADU/
POSTU/DBCDIAG/PROGRAM/OVRWRT/DESITER/////
ADPTINDX/LUSET $
DBi Data blocks for postprocessing.
Pi Character-input-default is blank. The generic name of the corresponding data block;
e.g., P3 corresponds to DB3, etc. (See table below for generic name.)
SEID Integer-input-default=0. The current superelement identification number. If SEID=-1,
then the current SEID is assumed to be the qualifier value in the path of parameter
DBCPATH.
DBCPATH Dummy variable parameter to allow the passing of qualifiers from the MSC Nastran
database to the DBC database. SEID must be -1.
CP Integer-input/output-default=0. Control parameter. If set to other than zero an error has
occurred in the module and further attempts to execute module will cause a module
return without module execution.
APP Character-input-default is blank. Allowable values of approach code:
'STATICS' or
blank
Statics
'TRANRESP' Linear/nonlinear transient response
'FREQRESP' Frequency response
'REIG' Normal modes
NLST Nonlinear statics
Main Index
675 DBC
Database converter for model generation and results processing
BKL1 Buckling
BKL0 Statics in a buckling solution
CEIGEN Complex modes
AERO Aerodynamics
CYCLIC Integer-input-default is 0. If CYCLIC=-1, then data will be interpreted as cyclic
analysis.
GEOMU Integer-input-default=40; the geometric information will output to this FORTRAN
unit.
LOADU Integer-input-default=-1 (LOADU = GEOMU). If LOADU>0 then, the static load
information will be output to this FORTRAN unit.
POSTU Integer-input-default=-1 (POSTU = GEOMU). If POSTU>0, then, the data recovery
information will be output to this FORTRAN unit.
DBCDIAG Integer-input-default=0. Controls the printing of certain diagnostics during the
conversion. If several diagnostics are desired, then the sum of the following values is
required. For example, DBCDIA=3 requests the printing of grid relation and element
connection record diagnostics.
Value Diagnostic Output
0 No diagnostics will be printed.
1 Grid relation record.
2 Element connection record.
4 Internal module begin message.
8 Internal module statistics.
16 Internal module CPU time and begin message in performance
summary table.
32 DBC database dictionary entries.
64 Messages for null NASTRAN logical file connections.
128 Suppress diagnostics when geometry updates occur.
256 Save the grid point stress surface and volume factors.
512 Do not save the grid point stress surface and volume subcase data.
PROGRAM Character-input-default=XL. If PROGRAM =XL, then the DBC database will be
suitable for processing in MSC.Patran. If PROGRAM =GRASP, then the DBC
database will be suitable for processing in MSC.Access.
OVRWRT Character-input-default=YES. DBC data base overwrite flag. If OVRWRT =YES
and the DBC database was created in a prior run, then data blocks pre-existing on the
DBC database will be overwritten in the current run when the qualifier values are
identical.
DESITER Integer-input-default=0. Design optimization loop identification number.
Main Index
DBC
Database converter for model generation and results processing
676
Remarks:
1. Data block name table:
ADPTINDX Integer-input-default=0. When ADPTINDX is not equal to zero, the data base object
attribute will be qualified by the value of this parameter, which denotes intermediate
p-element results exist.
LUSET Integer-input-default=0. NDOF denotes size of the model (number of degrees of
freedom), which will be saved for p-element iterations indexed by the ADPTINDX
values and used to correlate the size of the model to the p-element iteration index.
Generic
Name
(P1-P20)
Chapter 2
Names Stored on Unit Description
BEPT AEBGPDT --- Aerostructural basic grid point definition
table
BGPDT BGPDT GEOMU Basic grid point definition table
CASECC CASECC POSTU Table of Case Control command images
CONTAB CONTAB POSTU Table of design constraint attributes
CONTROL AECTRL POSTU Table of aerodynamic model's control
definition
CSTM CSTM GEOMU Table of coordinate system transformation
matrices
CVAL CVAL POSTU Matrix of design constraint values
DBCOPT DBCOPT POSTU Design optimization history table for
DESTAB DESTAB POSTU Table of design variable attributes
DIT DIT GEOMU/
POSTU
Table of TABLEij Bulk Data entry images
DSCM2 DSCM2 POSTU Normalized design sensitivity coefficient
matrix
DYNAMIC DYNAMIC GEOMU Table of Bulk Data entry images related to
dynamics
ECT GEOM2 GEOMU Element connectivity table
ELDCT ELDCT POSTU Table of element stress discontinuities
EMAP SEMAP GEOMU Superelement map table
EPT EPT GEOMU Table of Bulk Data entry images related to
element properties
EQEXIN EQEXIN GEOMU Equivalence between external and internal
point identification numbers
Main Index
677 DBC
Database converter for model generation and results processing
EST EST GEOMU Element summary table
FRM --- POSTU Matrix of aerodynamic restrained elastic
forces
FURM --- POSTU Matrix of aerodynamic unrestrained elastic
forces
GEOM1 GEOM1 GEOMU Table of Bulk Data entry images related to
geometry
GEOM3 GEOM3 LOADU Table of Bulk Data entry images related to
static and thermal loads
GEOM4 GEOM4 GEOMU/
LOADU
Table of Bulk Data entry images related to
constraints, degree-of-freedom membership
and rigid element connectivity
GPDCT GPDCT POSTU Table of grid point stress discontinuities
GPDT GPDT GEOMU Grid point definition table
GPECT GPECT POSTU Grid point element connection table
GPL GPL GEOMU/
POSTU
External grid/scalar point identification
number list
GPS EGPSTR POSTU Table of grid point stresses or strains for
post-processing
HIS HIS POSTU Table of design iteration history
IRM --- POSTU Matrix of aerodynamic restrained inertia
forces
IURM --- POSTU Matrix of aerodynamic unrestrained inertia
forces
LAMA LAMA/
CLAMA
POSTU Real or complex eigenvalue summary table
MATPOOL MATPOOL POSTU Table of DMIG Bulk Data entries
MPT MPT GEOMU Table of Bulk Data entry images related to
material properties
OAG OAG POSTU Table of accelerations in SORT1 or SORT2
format
OBJTAB OBJTAB POSTU Design objective table
OEDE ONRGY1 POSTU Table of element energy losses
OEF OEF POSTU Table of element forces in SORT1 or SORT2
format
Generic
Name
(P1-P20)
Chapter 2
Names Stored on Unit Description
Main Index
DBC
Database converter for model generation and results processing
678
OEKE ONRGY1 POSTU Table of element kinetic energies
OES OES POSTU Table of element stresses or strains in
SORT1 or SORT2 format
OESC OES1C POSTU Table of composite element stresses or
strains in SORT1 format
OESE ONRGY1 POSTU Table of element strain energies and energy
densities
OESNL OESNL1 POSTU Table of nonlinear element stresses in
SORT1 format
OGPF OGPFB1 POSTU Table of grid point forces
OGPKE OGPKE1 POSTU Table of grid point kinetic energies
OL OL POSTU Transient or frequency response output list
OMM OMM POSTU Table of MAXMIN results
OMPCF OQMG POSTU Table of MPCforces in SORT1 or SORT2
format
OPG OPG POSTU Table of applied loads in SORT1 or SORT2
format
OQG OQG POSTU Table of single or multipoint forces-of-
constraint in SORT1 or SORT2 format
OUG OUG POSTU Table of displacements in SORT1 or SORT2
format
OVG OVG POSTU Table of velocities in SORT1 or SORT2
format
PERROR ERROR1 POSTU Error-estimate table updated for current
superelement or adaptivity loop
R1MAPR R1MAPR POSTU Table of mapping from original first level
(direct) retained responses
R1TAB R1TAB POSTU Table of first level (direct) (DRESP1 Bulk
Data entry) attributes
R1VAL R1VAL POSTU Matrix of initial values of the retained first
level (direct) responses
R2MAPR R2MAPR POSTU Table of mapping from original second level
(synthetic) retained responses
R2VAL R2VAL POSTU Matrix of initial values of the retained
second level (synthetic) responses
Generic
Name
(P1-P20)
Chapter 2
Names Stored on Unit Description
Main Index
679 DBC
Database converter for model generation and results processing
2. DBCPATH is a parameter defined on a statement in the NASTRAN NDDL; i.e.,
PARAM,DBCPATH = 0,PATH = DBCQUAL
PATH DBCQUAL QUAL1,QUAL2,QUAL3,etc.
where QUALi selects the QUALifier values associated with the PATH of the input data blocks
from NASTRAN to be written along with the input data blocks on the DBC database. In other
words, the intersection of the PATH DBCQUAL and the PATH of the input data blocks will form
the set of QUALifiers to be written to the DBC database and associated with the input data blocks.
Also, the PROJECT and VERSION will be written. It is recommended that the input data blocks
all have the same PATH.
If it is not NDDL, then only the PROJECT and VERSION will be associated with the input data
blocks on the DBC database.
3. Generic data blocks: ECT, GEOM1, and EQEXIN, must exist on POSTU (when PROGRAM
=XL) or GEOMU (when PROGRAM =GRASP) prior to the conversion of the following data
blocks: OUG, OES, OEF, OPG, OQG, and GPS.
4. If PROGRAM =XL then, the converted format of the above data blocks is written to one of three
databases (FORTRAN units): GEOMU, LOADU, and POSTU.
RESP12 RESP12 POSTU Table of second level (synthetic) responses
RM --- POSTU Matrix of aerodynamic rigid forces
SCSTM SCSTM GEOMU Table of global transformation matrices for
partitioned superelements
SETS SET GEOMU Table of combined sets
SVF EGPSF POSTU Table of element to grid point interpolation
factors
UG --- POSTU Matrix of aerodynamic restrained elastic
displacements
UUG --- POSTU Matrix of aerodynamic unrestrained elastic
displacements
VIEWTB VIEWTB GEOMU/
POSTU
View information table, contains the
relationship between each p-element and its
view-elements and view-grids
GEOMU BGPDT, CSTM, ECT, EMAP, EPT, GPDT, MPT, and SETS
LOADU GEOM3 and GEOM4
POSTU CASECC, GPS, EQEXIN, GEOM1, GPL, LAMA, OEF, OES, OESNL, OGPF,
OESE, OPG, OQG, OUG, OESC, DBCOPT, GPDCT, and ELDCT
Generic
Name
(P1-P20)
Chapter 2
Names Stored on Unit Description
Main Index
DBC
Database converter for model generation and results processing
680
5. If PROGRAM =GRASP then, the converted format of the above data blocks is written only to
the database: GEOMU.
6. Generic data blocks ECT, BGPDT, GPL, and GPDT should be specified simultaneously on the
same DBC statement.
7. Generic names OES and OESC must be specified in separate DBC modules and may appear only
once per DBC module.
Examples:
The following examples illustrate how the module might be implemented in a superelement solution
sequence. The following TYPE statements are used to establish authorization and defaults for user
parameters that control the module.
7<3( 3$50,<'%&',$* *(2081,7/2$'81,7326781,7
7<3( 3$50&+$5<352*5$0 ;/
1. After generation of IFP module output data blocks.
DBC CSTM,EPT,MPT,GEOM4,CASECC,,,,,,,,,,,,,,//
CSTM/EPT/MPT/GEOM4/CASECC/
//////////////SEID//S,N,CP/APP//GEOMU/
LOADU/POSTU/DBCDIAG/PROGRAM/ $
2. Inside superelement generation loop. Data required for undeformed plotting of geometry and
loads.
DBC BGPDTS,GPLS,GPDTS,ECTS,GEOM1S,EQEXINS,
GEOM3S,GEOM4S,,,,,,,,,,,//BGPDT/GPL/
GPDT/ECT/GEOM1/EQEXIN/GEOM3/
GEOM4/////////////SEID//S,N,CP/APP//
GEOMU/LOADU/POSTU/DBCDIAG/
PROGRAM/ $
3. Inside superelement data recovery loop.
Grid point stresses:
DBC GPLS,EGPSTR,,,,,,,,,,,,,,,,,//GPL/GPS/
/////////////////SEID//S,N,CP/APP/GEOMU/
LOADU/POSTU/DBCDIAG/PROGRAM $
Forces, stresses, displacements, etc.
DBC OPG1,OUGV1,OEF1X,OES1X,OQG1,ONRGY1,OGPFB1,
ECTS,GEOM1S,EQEXINS,,,,,,,,,//OPG/OUG/
OEF/OES/OQG/OESE/OGPF/ECT/
GEOM1/EQEXIN//////////SEID//S,N,CP/
Note: ECTS, GEOM1S, and EQEXINS are repeated here in case the above call was not executed,
as in a data recovery restart.
Main Index
681 DBC
Database converter for model generation and results processing
APP//GEOMU/LOADU/POSTU/DBCDIAG/
PROGRAM/ $
Main Index
DBDELETE
Deletes NDDL data blocks and parameters
682
Deletes NDDL data blocks and parameters. An optional WHERE clause may be specified for a more
selective deletion.
Format:
Describers:
Remarks:
1. The where-expr has the following rules:
If the where-expr specifies a colname that is not assigned to the data block or parameter then none
of that data block or parameter will be deleted. For example, given that SPC is not a qualifier for
KGG, then the following DBDELETE statement will not delete any KGG:
DBDELETE DATABLK=KGG WHERE(SPC=10)$
If the where-expr does not specify a colname that is assigned to the data block (or parameter), then
the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA,
then the following DBDICT statements are equivalent:
SPC=10 $
DBDELETE DATABLK=KAA $
or
DBDELETE DATABLK=KAA WHERE(SPC=10) $
The WILDCARD keyword may be added in order to wildcard all qualifiers not already specified
in where-expr. For example to delete all KAA where SPC=10 and regardless of MPC, SEID, etc.:
DBDELETE
Deletes NDDL data blocks and parameters
DATABLK Delete data blocks. datablk-list specifies a list of NDDL-defined data blocks
separated by commas.
PARAM Delete parameters. param-list specifies a list of parameters separated by commas.
where-expr Logical expression that specifies the desired values of colnames described in Table
2 under the DBDICT, 684 statement. If where-expr is true then the named items will
be deleted. For example, WHERE(VERSION=4 AND SEID<>2 AND SEID>0)
selects all items under version 4 for all values of SEID greater than 0 except 2. See
WHERE and CONVERT Clauses, 43 for a further description. The default for
VERSION and PROJECT is the current version and project. See also Remark 1.
DBDELETE
DATABLK
*
datablk list ( )
=
PARAM
*
param list ( )
=
WHERE where expr ( ) | | $
Main Index
683 DBDELETE
Deletes NDDL data blocks and parameters
DBDELETE DATABLK=KAA WHERE(SPC=10 AND WILDCARD) $
2. The data block and parameter names in datablk-list and param-list cannot be alias names specified
on the subDMAP argument list. datablk-list and param-list must specify the name of the data
block or parameter as defined in the NDDL.
Note: WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJECT,
VERSION, CDATE, etc.
Main Index
DBDICT
Prints database directory tables
684
Prints the following database directory tables:
Data blocks described by an NDDL DATABLK statement.
Parameters described by an NDDL PARAM statement.
All unique paths (KEYs) and their qualifiers values.
Qualifiers and their current values.
Data blocks not described by an NDDL DATABLK statement.
Parameters not described by an NDDL PARAM statement.
Project and version information.
Basic Format:
The basic format of DBDICT specifies which tables to print and prints all items (data blocks and
parameters) found in the directory. Also, the attributes (colnames) to be printed and the print format are
predefined. Note that more than one table may be specified on the same DBDICT statement.
Examples:
DBDICT
DBDICT PARAM PROJVERS
Full Format:
The full format permits the selection of items by name and/or by the WHERE describer. The full format
also permits the attributes to be printed using the SELECT describer. In addition, the print format can be
DBDICT
Prints database directory tables
DBDICT [DATABLK PARAM PROJVERS QUALCURR QUALIFIERS]
Main Index
685 DBDICT
Prints database directory tables
specified with the SORT, FORMAT, and LABEL describers. Note that the full format only allows the
specification of a single table on a DBDICT statement.
SELECT(colname[- col-label]. . . ),
Describers:
DBDICT
DATABLK
DATABLK LOCAL ( )
*
datablk-list ( )
=
\ .
|
| |
PARAM
PARAM LOCAL ( )
*
param-list ( )
=
\ .
|
| |
PROJVERS
QUALCURR
QUALIFIERS
WHERE(where-expr),
FORMAT (FWIDTH = w [.d] DWIDTH = w [.d] AWIDTH = a IWIDTH =
i,
LWIDTH = k COLSPACE = c VALUE = w,
colname = col-width, . . .),
DATABLK Print the data blocks. datablk-list specifies a list of NDDL-defined data blocks
separated by commas. If LOCAL is specified, the non-NDDL-defined data
blocks are printed.
PARAM Print the parameter table. param-list specifies a list of parameters separated by
commas. If LOCAL is specified, the non-NDDL-defined parameters are
printed.
PROJVERS Print the project-version table.
SORT colname
A
D
. , =
\ .
|
| |
,
LABEL page - title
RIGHT
CENTER
LEFT \ .
|
|
|
| |
Main Index
DBDICT
Prints database directory tables
686
QUALIFIERS Print the qualifier table.
QUALCURR Print the current values of the qualifiers. SORT is ignored.
where-expr Logical expression that specifies the desired values of colnames described
below. For example, WHERE(VERSION = 4 AND SEID <>2 AND SEID>0)
selects all items under version 4 for all values of SEID greater than 0 except 2.
See WHERE and CONVERT Clauses, 43 for a further description. The default
for VERSION is the current version and PROJECT is the current project. The
default for qual is * which is all qualifier values found on the database. See
Remark 12.
SELECT Specifies a list of column names to be printed. The order of the specified
colnames will be printed from left to right. If colname is not specified then all
columns will be printed.
colname Column name. Colname specifies a particular attribute of the database item;
such as, data block name (NAME), creation date (CDATE), number of blocks
(SIZE), or qualifier name (SEID, SPC, etc.). The allowable colnames are given
in the Remarks.
col-label The label to printed above the column identified by colname. The default for
col-label is the colname. col-label may not be specified for colnames:
QUALSET, QUALALL, and TRAILER.
FWIDTH = w.d. Specifies the default width for single precision real numbers in real and
complex qualifiers. (Integers: w>0 and d >0, Default = 12.5).
DWIDTH = w.d. Specifies the default width for double precision real numbers in real and
complex qualifiers. (Integers: w>0 and d>0, Default = 17.10).
AWIDTH = a Specifies the default width for character string qualifiers. Character strings are
printed with enclosing single quotation marks, even if the string is blank.
(Integer>0, Default = 8).
IWIDTH = i Specifies the default width for integer qualifiers. (Integer>0, see Remarks for
defaults).
LWIDTH = k Specifies the default width for logical qualifiers. Logical values are printed as
either T for TRUE or F for FALSE. (Integer> 0, Default = 1).
COLSPACE = c Specifies the default number of spaces between columns. (Integer>0; see
Remarks for defaults).
VALUE = w Specifies the default width for parameter values. The values are printed as
character strings with left justification. Integer > 0, Default = 40.
col-width The print width of the data under colname or qual-name. For real numbers,
specify w.d where w is the width of the field and d is the number of digits in the
mantissa. For integers and character strings, specify w where w is the width of
the field. col-width may not be specified for colnames: QUALSET,
QUALALL, and TRAILER.
Main Index
687 DBDICT
Prints database directory tables
Remarks:
1. DBDICT prints seven different tables according to a default or user-defined format. The tables
are:
If DBDICT is specified without any describers then the NDDL Data Blocks Table will be printed.
See Remark 2.
In an FMS statement, DATABLK(LOCAL) and PARAM(LOCAL) produce no output, and
QUALCURR produces the default values specified on the NDDL QUAL statement.
The defaults and allowable colnames for SELECT, FORMAT, SORT, and LABEL depend on the
table. The defaults are described in the following remarks and tables.
2. The default print of the NDDL Data Blocks Table is obtained by:
DBDICT
or
SORT Specifies how the rows are sorted. The sort based on ASCII sequence and is
performed in order according to each colname specified in the list. A D
following the colname causes the sort to be in descending order. An A
following the colname causes the sort to be in ascending order. Colnames
QUALSET, QUALALL, and TRAILER may not be specified under SORT.
Each colname specified in SORT must be separated by commas.
page-title A title to be printed on each page of the directory output.
RIGHT, CENTER,
LEFT
Print justification of the page title.
Describer Description Default Page-Title
See
Remark
DATABLK Data blocks described by a
NDDL DATABLK statement.
NDDL DATABLOCKS 2
PARAM Parameters described by a
NDDL PARAM statement.
NDDL PARAMETERS 3
QUALCURR Current Qualifiers and their
values.
CURRENT QUALIFIERS 4
QUALIFIERS Qualifiers and their values for
each key number.
QUALIFIERS 5
DATABLK
(LOCAL)
Data blocks not described by a
NDDL DATABLK statement.
LOCAL DATABLOCKS 6
PARAM(LOCAL) Parameters not described by a
NDDL PARAM statement.
LOCAL PARAMETERS 7
PROJVERS Project-Version. PROJECT-VERSION 8
Main Index
DBDICT
Prints database directory tables
688
DBDICT DATABLK
and is equivalent to:
DBDICT DATABLK ,
SELECT(NAME,DATABASE,DBSET,PROJNO=PROJ,VERSION=VERS,CDATE,
CTIME,
SIZE,KEY,PURGED=PU,EQUIVD=EQ,
POINTER=FILE,QUALSET) ,
FORMAT(NAME=8,DBSET=8,CDATE=6,CTIME=6,SIZE=5,
KEY=4 ,PURGED=4,EQUIVD=4,POINTER=8,
IWIDTH=5,COLSPACE=1) ,
SORT(PROJNO=A,VERSION=A,DBSET=A,NAME=A) ,
LABEL(NDDL DATABLOCKS CENTER)
and looks like:
Figure 4-1 DBDICT PARAM Example
The table below gives the allowable colnames along with a description that may be specified in the
FORMAT, SELECT, and SORT describers.
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 20
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 16
NDDL DATABLOCKS
NAME DATABASE DBSET PROJ VERS CDATE CTIME SIZE KEY PU EQ FILE SEID PEID
LOAD SPC MPC METH
-----------------------------------------------------------------------------------
----------------------
AGG MASTER DBALL 1 1 930805 72340 0 326 1 0 132484 0 0
AXIC MASTER DBALL 1 1 930805 72336 0 315 1 0 65764
BGPDTS MASTER DBALL 1 1 930805 72338 1 324 0 2 131332 0
BGPDTX MASTER DBALL 1 1 930805 72338 1 324 0 1 131332 0
BJJ MASTER DBALL 1 1 930805 72341 0 332 1 0 132612 0
BULK MASTER DBALL 1 1 930805 72336 2 315 0 0 65700
CASECC MASTER DBALL 1 1 930805 72336 1 316 0 2 67428
Table 4-1 DBDICT DATABLK Colnames
Column
name
Default
column
width
Default
column label Description
PROJECT 40 PROJECT NAME Project name defined by PROJECT
statement
PROJNO 4 PROJ NO Project number associated with
PROJECT
VERSION 4 VERSION Version number
CDATE 6 CDATE Creation Date
CTIME 6 CTIME Creation Time
Main Index
689 DBDICT
Prints database directory tables
NAME 8 NAME Parameter name
DATABASE 8 DATABASE MASTER DBset name
DBSET 8 DBSET DBset name
RDATE 6 RDATE Revision Date
RTIME 6 RTIME Revision Time
SIZE 5 SIZE Number of blocks
qual-name See Note qualifier name Qualifier name
KEY 4 KEY Key number
TRLi 8 TRLi i-th word in the trailer
TRAILER 8 TRLi All 10 trailer words
EXTNAME 8 EXTNAME Extended name
EQUIVD 4 EQ Equivalenced flag
PURGED 4 PU Purged flag
EQFLAG 4 EF Scratch equivalenced flag
SCRFLAG 4 SF Scratch DBSET flag
POINTER 8 POINTER Directory pointer
DBENTRY 8 DBENTRY Database entry pointer
FEQCHAIN 8 FEQCHAIN Forward equivalence chain
BEQCHAIN 8 BEQCHAIN Backward equivalence chain
DBDIR20 9 DBDIR(20) Directory word 20
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Predefined subset of all qualifiers
Table 4-1 DBDICT DATABLK Colnames (continued)
Column
name
Default
column
width
Default
column label Description
Main Index
DBDICT
Prints database directory tables
690
3. The default print of the NDDL parameter table is obtained by:
DBDICT PARAM
and is equivalent to:
DBDICT PARAM,
SELECT(NAME,DATABASE,DBSET,PROJNO=PROJ,VERSION=VERS,CDATE,CT
IME,
KEY,VALUE,QUALSET),
FORMAT(NAME=8,DATABASE=8,DBSET=8,CDATE=6,CTIME=6,
KEY=4,VALUE=40,IWIDTH=5,COLSPACE=1),
SORT(PROJNO=A,VERSION=A,DBSET=A,NAME=A),
LABEL(NDDL PARAMETERS CENTER)
and looks like:
Figure 4-2 DBDICT PARAM Example
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, AWIDTH=8, and
FWIDTH=12.
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 21
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 17
NDDL PARAMETERS
NAME DATABASE DBSET PROJ VERS CDATE CTIME KEY VALUE SEID PEID LOAD SPC MPC METH
-----------------------------------------------------------------------------------------------
ACOUSTIC MASTER MASTER 1 1 930805 72338 323 0 0 0
ALTRED MASTER MASTER 1 1 930805 72338 319 NO
BCHNG MASTER MASTER 1 1 930805 72337 325 FALSE 0
DBALLX MASTER MASTER 1 1 930805 72336 318 DBALL -1 -1
EPSBIG MASTER MASTER 1 1 930805 72339 323 1.000000E+12 0 0
ERROR MASTER MASTER 1 1 930805 72338 319 -1
FIXEDB MASTER MASTER 1 1 930805 72338 323 0 0 0
Main Index
691 DBDICT
Prints database directory tables
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
4. The default print of the Qualifier Table is obtained by:
DBDICT QUALIFIERS
and is equivalent to:
DBDICT QUALIFIERS ,
SELECT(KEY QUALALL) ,
FORMAT(DWIDTH=17.10 AWIDTH=8 IWIDTH=5 LWIDTH=1 ,
FWIDTH=12.5 COLSPACE=2) SORT(KEY=A) ,
LABEL(QUALIFIERS CENTER )
Table 4-2 DBDICT PARAM Colnames
Column
name
Default
column
width
Default
column
label Description
PROJECT 40 PROJECT NAME Project name defined by PROJECT
statement
PROJNO 5 PROJ Project number associated with
PROJECT
VERSION 4 VERS Version number
CDATE 6 CDATE Creation Date
CTIME 6 CTIME Creation Time
NAME 8 NAME Parameter name
DATABASE 8 DATABASE MASTER DBset name
DBSET 8 DBSET DBset name
RDATE 6 RDATE Revision Date
RTIME 6 RTIME Revision Time
POINTER 8 POINTER Directory pointer
VALUE 40 VALUE Parameter value
KEY 4 KEY Key number
qual-name See Note qualifier name Qualifier name
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Predefined subset of all qualifiers
Note: Default widths for qualifiers are DWIDTH=17.10, AWIDTH=8, IWIDTH=5,
LWIDTH=1, and FWIDTH=12.5.
Main Index
DBDICT
Prints database directory tables
692
and looks like:
Figure 4-3 DBDICT QUALIFIERS Example
QUALALL selects all qualifiers to be printed. The qualifiers will be printed in alphabetic order.
QUALSET selects the only the qualifiers SEID, PEID, SPC, MPC, LOAD, and METH to be
printed.
Table 4-4 gives the allowable colnames along with a description that may be specified in the
FORMAT, SELECT, and SORT describers. QUALALL and QUALSET may not be specified in
the FORMAT or SORT describers. The qualifier names and values are not printed one per row,
but rather from left to right as one logical line that is allowed to wrap after 132 columns.
5. The default print of the current qualifier values table is obtained by:
DBDICT QUALCURR
and is equivalent to:
DBDICT QUALCURR SELECT(QUALALL),
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 22
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 18
QUALIFIERS
KEY APRCH B2GG B2PP BMETH CMETH CONFIG DEFORM DELTA DESITER DLOAD DRMM DYRD EXTRCV FMETH FREQ
FSCOUP GUST HIGHQUAL HINDEX IC IKBAR IMACHNO IPANEL IQ ISA ISOLAPP K2GG K2PP LOAD
M2GG M2PP MACHINE METH METHF MFLUID MODEL MPC MTEMP NCASE NL99 NLOAD NLOOP NOQUAL OPERALEV
OPERASYS P2G PEID PVALID SDAMP SEDWN SEID SOLAPP SOLID SPC STATSUB SUBDMAP SUBMODEL SUPORT
TEMPLD TFL TSTEP ZNAME ZUZR1 ZUZR2 ZUZR3
-----------------------------------------------------------------------------------------------------------
335 F 0
0
0
0 0 0
-----------------------------------------------------------------------------------------------------------
336 0
0
0 0 -1
0 0 0
Column
name
Default
column width Default column label Description
KEY 5 KEY Key number
qual-name See Note qualifier name Qualifier name
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Predefined subset of all
qualifiers
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and
FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.
Main Index
693 DBDICT
Prints database directory tables
FORMAT(AWIDTH=8,IWIDTH=5,LWIDTH=1,COLSPACE=2),
LABEL=(CURRENT QUALIFIERS CENTER)
and looks like:
Figure 4-4 DBDICT QUALCURR Example
The table below gives the allowable colnames along with a description that may be specified in
the SELECT describers.
Table 4-3 DBDICT QUALCURR Colnames.
The default print of the local data block table is obtained by:
DBDICT DATABLK(LOCAL)
and is equivalent to:
DBDICT DATABLK(LOCAL),
SELECT(NAME,SUBDMAP,SIZE=BLOCKS,PURGED=PU,
EQUIVD=EQ,POINTER,TRL1,TRL2,TRL3,TRL4,
TRL5,TRL6,TRL7),
FORMAT(NAME=8,SUBDMAP=8,IWIDTH=8,COLSPACE=2),
SORT(NAME=A) LABEL(LOCAL DATABLOCKS CENTER)
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 24
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 20
CURRENT QUALIFIERS
APRCH B2GG B2PP BMETH CMETH CONFIG DEFORM DELTA DESITER DLOAD DRMM DYRD EXTRCV FMETH FREQ FSCOUP
GUST HIGHQUAL HINDEX IC IKBAR IMACHNO IPANEL IQ ISA ISOLAPP K2GG K2PP LOAD M2GG
M2PP MACHINE METH METHF MFLUID MODEL MPC MTEMP NCASE NL99 NLOAD NLOOP NOQUAL OPERALEV OPERASYS
P2G PEID PVALID SDAMP SEDWN SEID SOLAPP SOLID SPC STATSUB SUBDMAP SUBMODEL SUPORT
TEMPLD TFL TSTEP ZNAME ZUZR1 ZUZR2 ZUZR3
-----------------------------------------------------------------------------------------------------------
0 0 0 0 F 0 0 F 0 0 0 0 F
0 0 0 0 0 0 0 0 0 1 300
0 0 0 0 0 100 0 0 0 0 -1 0 0 0
0 0 0 0 0 0 400 0 0 0
0 0 0 0 0 0
Column
name
Default
column
width
Default
column
label Description
qual-name See Note qualifier name Qualifier name
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Pre-defined subset of all qualifiers
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and
FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.
Main Index
DBDICT
Prints database directory tables
694
and looks like:
Figure 4-5 DBDICT DATABLK(LOCAL) Example
TRLi specifies the data block trailer word i where . TRAILER selects all 10 data
block trailer words.
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
6. The default print of the local parameter table is obtained by:
DBDICT PARAM(LOCAL)
and is equivalent to:
DBDICT PARAM(LOCAL) SELECT(NAME,SUBDMAP,VALUE),
FORMAT(COLSPACE=4,VALUE=40,AWIDTH=8),
SORT(NAME=A) LABEL( LOCAL PARAMETERS CENTER)
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 23
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 19
LOCAL DATABLOCKS
NAME SUBDMAP BLOCKS PU EQ POINTER TRL1 TRL2 TRL3 TRL4 TRL5 TRL6 TRL7
-------------------------------------------------------------------------------------------------
CASEW PHASE1DR 1 0 0 131780 201 4 0 308 0 0 0
Table 4-4 DBDICT DATABLK(LOCAL) Colnames
Column
name
Default
column
width
Default
column
label Description
NAME 8 NAME Parameter name
SUBDMAP 8 SUBDMAP SubDMAP name
SIZE 8 BLOCKS Number of blocks
EQUIVD 8 EQ Equivalenced flag
PURGED 8 PU Scratch flag
POINTER 8 POINTER Directory pointer
TRLi 8 TRLi i-th word in the trailer
TRAILER 8 TRLi All 10 trailer words
EXTNAME 8 EXTNAME Extended name
1 i 10 s s
Main Index
695 DBDICT
Prints database directory tables
and looks like:
Figure 4-6 DBDICT PARAM(LOCAL) Example.
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
7. The default print of Project Version Table is obtained by:
DBDICT PROJVERS
and is equivalent to:
DBDICT PROJVERS ,
SELECT(PROJECT=PROJECT NAME,PROJNO,
VERSION ,DELFLG=DELETED ,
CDATE=CREATION DATE CTIME=CREATION
TIME) ,
FORMAT(PROJECT=40,PROJ=10,VERS=10,DELFLG=7,
COLSPACE=1 ,CDATE=13,CTIME=13) ,
LABEL(PROJECT-VERSION,CENTER)
SORT(PROJNO=A,VERSION=A)
Listing 4-1
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 24
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 20
LOCAL PARAMETERS
NAME SUBDMAP VALUE
----------------------------------------------------------------
AERO SESTATIC FALSE
AERO PHASE1DR FALSE
ALTRED SESTATIC NO
ALTRED PHASE1DR NO
ALTSHAPE SESTATIC 0
ALWAYS PHASE1DR -1
ALWAYS PHASE1C -1
ALWAYS SEKRRS -1
ALWAYS SESTATIC -1
APP PHASE1DR STATICS
APP PHASE1C STATICS
APP SESTATIC STATICS
APRCH SESTATIC
ASING PHASE1DR 0
ASING SEKRRS 0
ASING PHASE1C 0
ASING SESTATIC 0
Table 4-5 DBDICT PARAM(LOCAL) Colnames.
Column
name
Default
column
width
Default
column
label Description
NAME 8 NAME Parameter name
SUBDMAP 8 SUBDMAP SubDMAP name
VALUE 40 VALUE Parameter name
Main Index
DBDICT
Prints database directory tables
696
and looks like:
Figure 4-7 DBDICT PROJVERS Example
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
CDATE is printed as YYMMDD where YY, MM, and DD are the year, month, and date,
respectively. CTIME is HHMMSS where HH, MM, and SS are the hour, minute, and second,
respectively.
8. If a parameter or qualifier value is defined to be a character string, then the value will be printed
with enclosing single quotation marks. Blank strings will also be printed with single quotation
marks.
9. If a given qualifier is not in the path of a given data block or parameter, then blank spaces will be
printed.
10. A line will wrap if additional columns need to be printed and not enough space is available on the
output (which is assumed to be 132). The first column of each additional line is to be indented by
the width of the first column printed for the entry.
11. The where-expr has the following rules:
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 19
MODULE NAME = DBDICT , SUBDMAP SEKRRS , OSCAR RECORD NUMBER 15
PROJECT-VERSION
PROJECT NAME PROJ NO. VERSION DELETED CREATION DATE CREATION TIME
---------------------------------------------------------------------------------------------------
LEFT FENDER 1 1 930805 72319
Table 4-6 DBDICT PROJVERS Colnames
Column
name
Default
column
width
Default
column
label Description
PROJECT 40 PROJECT NAME Project name defined by PROJECT
statement
PROJNO 10 PROJ NO Project number associated with PROJECT
VERSION 10 VERSION Version number
DELFLG 7 DELETED Flag indicating whether this project/version
has been deleted by the RESTART NOKEEP
or DBCLEAN statements
CDATE 13 CREATION DATE Creation Date
CTIME 13 CREATION TIME Creation Time
Main Index
697 DBDICT
Prints database directory tables
a. If the where-expr specifies a colname that is not assigned to the data block or parameter then
no directory information will be printed for that data block or parameter. For example, given
that SPC is not a qualifier for KGG, then the following DBDICT statement will produce no
output:
DBDICT DATABLK=KGG WHERE(SPC=10) $
b. If the where-expr does not specify a colname that is assigned to the data block (or parameter)
then the qualifier is wildcarded. For example, given that SEID is a qualifier for KAA, then the
following DBDICT statements are equivalent:
DBDICT DATABLK=KAA $
DBDICT DATABLK=KAA WHERE(SEID =
*
) $
Examples:
1. Print the Project Version Table with a title.
DBDICT PROJVERS SORT(PROJNO,VERSION),
LABEL(PROJECT VERSION TABLE LEFT) $
2. Print a directory of all data blocks qualified with PEID = 10 or SEID = 10. Print columns for the
NAME and DBSET, and the qualifiers SPC, MPC, and LOAD.
DBDICT DATABLK SELECT(NAME,SPC,MPC,LOAD,DBSET,SIZE,
SEID,PEID) ,
SORT(NAME,SIZE=D) WHERE( SEID=10 OR PEID=10) $
Main Index
DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
698
Equivalences (or copies) NDDL data blocks and parameters based upon a qualifiers in a CONVERT
clause. An optional WHERE and may be specified for a more selective equivalence.
Format:
Describers:
DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
datablk-list Specifies a list of data blocks separated by commas. The default is *, which
selects all data blocks. The equivalenced data block may be renamed by
specifying a slash after the old name followed by the new name. For example,
if KLL is to be renamed to KLL1, then DATABLK=(KLL/KLL1) is specified.
param-list Specifies a list of parameters separated by commas. The default is *, which
selected all parameters. The equivalenced parameter may be renamed by
specifying a slash after the old name followed by the new name. For example,
if LUSETS is to be renamed to LUSET, then PARAM=(LUSETS/LUSET) is
specified.
where-expr Logical expression that specifies the desired values of colnames described in
Table 4-2 under the DBDICT statement. If where-expr is true then the named
items will be equivalenced. For example, WHERE(VERSION=4 AND
SEID<>2 AND SEID>0) selects all items under version 4 for all values of
SEID greater than 0 except 2. See WHERE and CONVERT Clauses, 43 for a
further description. The default for VERSION and PROJECT is the current
version and project. See Remark 1 for more information.
DBEQUIV
DATABLK =
*
(datablk-list)
PARAM =
*
(param-list)
WHERE (where-expr) | | ,
CONVERT (convert-expr) OVRWRT RESTART | | $
Main Index
699 DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
Remarks:
1. The where-expr has the following rules:
If the where-expr specifies a colname that is not assigned to the data block or parameter then none
of that data block or parameter will be equivalenced. For example, given that SPC is not a qualifier
for KGG, then the following DBEQUIV statement will not equivalence any KGG:
DBEQUIV DATABLK=KGG WHERE(SPC=10) CONVERT(SPC=20) $
If the where-expr does not specify a colname that is assigned to the data block (or parameter), then
the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA,
then the following DBEQUIV statements are equivalent:
SPC=10 $
DBEQUIV DATABLK=KAA CONVERT(SPC=20) $
or
DBEQUIV DATABLK=KAA WHERE(SPC=10) CONVERT(SPC=20) $
The WILDCARD keyword may be added in order to wildcard all qualifiers not already specified
in where-expr. For example to equivalence all KAA where SPC=10 and regardless of MPC,
SEID, etc.:
DBEQUIV DATABLK=KAA WHERE(SPC=10 AND WILDCARD) CONVERT(SPC=20) $
convert-expr Modifies the values for PROJECT, VERSION, DBSET, and qualifiers selected
by the where-expr. The format of convert-expr is:
PROJECT=project-expr;VERSION=version-expr;
DBSET=DBsetname;quali=qual-expri[;...]
For example, CONVERT (SEID=100+SEID; SPC=102).
See WHERE and CONVERT Clauses, 43 for a further discussion on WHERE
and CONVERT clauses. The default action for VERSION and PROJECT is to
convert to the current version-identification number and current project-
identification number. But if either PROJECT or VERSION is specified in the
convert-expr, then both must be specified.
OVRWRT
NOOVRWRT
By default (i.e., NOOVRWRT), duplicate data blocks or parameters on the
created by DBEQUIV will cause a fatal message. A duplicate means that a data
block or parameter has not only the same name but also the same qualifier
values, PROJECT, VERSION, and DBSET as the primary data block or
parameter. If OVRWRT is specified, then the primary data block is overwritten.
RESTART By default, data blocks and parameters created by DBEQUIV cannot be output
again in a subsequent DMAP module. If RESTART is specified then the
selected data blocks and parameters may be overwritten once.
Note: WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJNO,
VERSION, CDATE, etc.
Main Index
DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
700
2. The data block and parameter names in datablk-list and param-list cannot be alias names specified
on the subDMAP argument list. datablk-list and param-list must specify the name of the data
block or parameter as defined in the NDDL.
Main Index
701 SubDMAP DBFETCH
Fetch data blocks stored by DBSTORE
Retrieves user-specified data blocks on the database previously stored with
CALL DBSTORE.
Format:
Input Data Blocks:
None.
Output Data Blocks:
Parameters:
Remarks:
1. All parameters must be specified even if they are not used or the default value is desired.
2. DBi is equivalenced to the database data block named ZUZR11 qualified with ZNAME = DBi,
ZUZR1 = Q1, ZUZR2 = Q2, ZUZR3 = 0.
3. If DBi appears on the SUBDMAP statement, then the actual name of the data block to be stored
on the database is the name which appears on the highest CALL statement that contains DBi.
DIAG 47 may be specified so that the actual name is printed to the F06 file.
4. If call DBFETCH is being used to obtain data blocks created in a previous run, then the
RESTART or DBLOCATE FMS statement must be specified. If DBLOCATE is used then
DATABLK = * or DATABLK = (ZUZR11) must be specified on the DBLOCATE statement.
Example:
Fetch data block named A (name flag = 1 drops the character E) and assign local name as EA.
SubDMAP DBFETCH
Fetch data blocks stored by DBSTORE
CALL DBFETCH /DB1,DB2,DB3,DB4,DB5/Q1/Q2/
FLAG/0/S,SUCCESS $
DBi Data blocks to be fetched. See Remark 3.
Q1 Integer-input-no default. First qualifier.
Q2 Integer-input-no default. Second qualifier.
FLAG Integer-input-no default. Name flag: 0 means fetch DBi with name DBi. 1
means drop the first character of DBi before searching the directory.
SUCCESS Integer-output-no default. SUCCESS = -1 means all data blocks were
successfully retrieved. SUCCESS = 0 means otherwise.
Main Index
SubDMAP DBFETCH
Fetch data blocks stored by DBSTORE
702
CALL DBFETCH /EA,,,,/1/1/1/0/S,EXIST $
Main Index
703 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
Performs functions on items stored on the database with this subDMAP and CALL DBSTORE.
Format:
1. Directory print
Print the contents of the database directory.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
None.
2. Data block deletion
Deletes up to five data block(s) previously stored with CALL DBSTORE.
Format:
Parameters:
SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
CALL DBMGR //OPT/P2/P3/P4/P5/P6/DB1/DB2/DB3/DB4/DB5 $
CALL DBMGR
/ / / / $
CALL DBMGR //5/Q1/Q2/0/0/0/DB1/DB2/DB3/DB4/DB5 $
Q1 Integer-input-no default. First qualifier of DBi.
Q2 Integer-input-no default. Second qualifier of DBi.
DBi Character-input-no default. Names of data blocks to be deleted.
Main Index
SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
704
3. Data block equivalence
Assign up to four alias names to one to four data blocks.
Format:
Parameters:
4. Data block rename
Rename and/or modify the qualifier values of a data block previously stored with CALL DBSTORE.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
CALL DBMGR //7/QP1/QP2/QS1/QS2/0/
DBP/DBS1/DBS2/DBS3/DBS4 $
QP1 Integer-input-no default. First qualifier of primary data block (DBP).
QP2 Integer-input-no default. Second qualifier of primary data block (DBP).
QS1 Integer-input-no default. First qualifier of secondary data block (DBSi).
QS2 Integer-input-no default. Second qualifier of secondary data block (DBSi).
DBP Character-input-no default. Primary data block name.
DBSi Character-input-no default. Secondary data block names to be equivalenced to
DBP.
CALL DBMGR //9/QO1/QO2/QN1/QN2/0/
DBOLD/DBNEW/ / $
QO1 Integer-input-no default. First qualifier of previously stored data block
(DBOLD).
QO2 Integer-input-no default. Second qualifier of previously stored data block
(DBOLD).
QN1 Integer-input-no default. First qualifier of new name of data block (DBNEW).
Main Index
705 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
5. Store character string
Store up to five character strings with qualifiers.
Format:
Parameters:
6. Test for presence of a data block or a character string
Test for the presence of a data block previously stored by CALL DBSTORE or a character string
previously stored by CALL DBMGR (OPT=10).
Format:
Parameters:
Remarks:
1. All parameters must be specified even if they are not used or the default value is desired. Unused
integer parameters can be set to 0 and unused character parameters to ' ' (a string with 5 blanks).
2. If data blocks exist when storing, renaming or equivalencing, then they are overwritten.
QN2 Integer-input-no default. Second qualifier of new name of data block
(DBNEW).
DBOLD Character-input-no default. Name of the previously stored data block.
DBNEW Character-input-no default. New name of the previously stored data block.
CALL DBMGR //10/Q1/Q2/0/0/0/STR1/STR2/STR3/STR4/STR5 $
Q1 Integer-input-no default. First qualifier of STRi.
Q2 Integer-input-no default. Second qualifier of STRi.
STRi Character-input-no default. Strings up to 8 characters in length.
CALL DBMGR //11/Q1/Q2/0/S,PRES1/S,PRES2/
DB1/DB2/ / $
Q1 Integer-input-no default. First qualifier of DBi.
Q2 Integer-input-no default. Second qualifier of DBi.
PRESi Integer-output-no default. 0 means DBi not present. -1 means DBi present.
DBi Character-input-no default. Character strings or the names of data blocks.
Main Index
SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
706
3. If CALL DBMGR is to be used in restart runs with the structured solution sequences (SOLs 101
through 200) then PUTSYS(1, 109) should be specified immediately preceding CALL DBMGR
and PUTSYS(0, 109) should be specified immediately following CALL DBMGR.
Main Index
707 DBSTATUS
Checks status of up to ten data blocks
Checks the status of up to ten data blocks.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Remarks:
1. Trailing commas in the input data block list may be omitted without warning. For example the
following statement:
DBSTATUS KAA,,,,,,,,,//S,N,NOKAA $
may be shortened to:
DBSTATUS KAA//S,N,NOKAA $
2. DBSTATUS is similar to PARAML DB//'PRES' with expanded capability for empty and offline
data blocks; i.e., PARAML returns -1 for empty data blocks and fatally terminates for offline data
blocks.
DBSTATUS
Checks status of up to ten data blocks
DBSTATUS DB1,DB2,DB3,DB4,DB5,DB6,DB7,DB8,DB9,DB10//
S,N,NODB1/S,N,NODB2/S,N,NODB3/S,N,NODB4/S,N,NODB5/
S,N,NODB6/S,N,NODB7/S,N,NODB8/S,N,NODB9/S,N,NODB10 $
DBi Any data block (matrix or table).
NODBi Output-integer-default=-1. Status of the DBi-th data block:
-1 Not generated
0 Empty
1 Generated
10 Offline and empty
11 Offline and generated
Main Index
SubDMAP DBSTORE
Stores data blocks on the database
708
Stores user-specified data blocks on the database. Data blocks can only be retrieved by CALL
DBFETCH.
Format:
Input Data Blocks:
Parameters:
Remarks:
1. All parameters must be specified even if they are not used or the default value is desired. Unused
integer parameters can be set to 0. If DBSET is blank; i.e, ' ' (a string with 5 blanks), then DBi
will be stored on DBset DBALL.
2. DBi is stored under the database data block named ZUZR11 qualified with ZNAME = DBi,
ZUZR1 = Q1, ZUZR2 = Q2, ZUZR3 = 0 on DBset = DBSET.
3. DBSET should not be SCRATCH or refer to a scratch dbset.
4. If CALL DBSTORE is to be used in restart runs with the structured solution sequences (SOLs 101
through 200) then PUTSYS(1, 109) should be specified just before CALL DBSTORE and
PUTSYS(0, 109) just after. See Example 1.
5. If DBi appears on the SUBDMAP statement, then the actual name of the data block to be stored
on the database is the name which appears on the highest CALL statement that contains DBi.
DIAG 47 may be specified so that the actual name is printed to the F06 file.
Examples:
1. Store data block B on dbset DB100:
SubDMAP DBSTORE
Stores data blocks on the database
CALL DBSTORE DB1,DB2,DB3,DB4,DB5//Q1/Q2/DBSET/COND $
DBi Data blocks to be stored. See Remark 5.
Q1 Integer-input-no default. First qualifier of DBi.
Q2 Integer-input-no default. Second qualifier of DBi.
DBSET Character-input-no default. The dbset-name to store DBi. The dbset-name must
be padded with blanks to 5 characters in length; e.g., 'DBDN '.
COND Integer-input-no default. Conditional store flag. COND = 0 means store and
COND 0 means do not store.
Main Index
709 SubDMAP DBSTORE
Stores data blocks on the database
PUTSYS(1, 109) $ deactivate restart skipping
CALL DBSTORE B,,,,//2/2/DB100/0 $
PUTSYS(0, 109) $ activate restart skipping
2. The following example computes five variations on a basic matrix + = ,
where K, B, and M are input via DMI Bulk Data entries and ( , i = 1,5) are input via
DTI,LAMLST entries. In the first loop, the matrix KPLM is formed and decomposed and its
factors, L and U, stored. In the second loop, the factors are fetched and, along with B, input to the
FBS module to solve for X.
SOL 100
COMPILE USERDMAP
ALTER 2 $
TYPE PARM,,I,N,LOOPCNT=1,SING=0 $
TYPE PARM,,CHAR8,N,BX $ BLANK STRING
TYPE PARM,,CS,N,LAMC $
DMIIN DMI,DMINDX/K,M,B,,,,,,, $
DTIIN DTI,DTINDX/LAMLST,,,,,,,,, $
MATPRN K,M,B/ $
DO WHILE (LOOPCNT<=5 AND SING>-1) $
PARAML LAMLST//DTI/1/LOOPCNT/S,N,LAMBDA $
LAMC=CMPLX(LAMBDA) $
ADD K,M/KPLM//LAMC $
DECOMP KPLM/L,U/-1/////S,N,SING $
IF (SING>-1) THEN $
CALL DBSTORE L,U,,,//0/LOOPCNT/BX/0 $
LOOPCNT=LOOPCNT+1 $
ENDIF $
ENDDO $
$
IF (SING>-1) THEN $
CALL DBMGR //2/0/0/0/0/0/BX/BX/BX/BX/BX $
LOOPCNT=1 $
DO WHILE (LOOPCNT<=5) $
CALL DBFETCH /FL,FU,,,/0/LOOPCNT/1/0/0 $
FBS FL,FU,B/X $
MESSAGE // LOOPCNT=/LOOPCNT $
MATPRN X/ $
LOOPCNT=LOOPCNT+1 $
ENDDO $
ENDIF $
CEND
TITLE=SOLVE FOR FIVE X
BEGIN BULK
DMI,K,.....
DMI,B,.....
DMI,M,.....
DTI,LAMLST,.....
ENDDATA
K (
i
M| X | | B | |
i
Main Index
DBVIEW
Creates virtual datalock
710
Creates virtual data block (or view) from one or more data blocks.
Format:
'%9,(: view-name = data-block $
Describers:
Remarks:
1. DBVIEW is a nonexecutable statement defined only at compilation. It is not affected by IF ( )
THEN or DO WHILE blocks. Where-expr, however, is evaluated dynamically for the current
values of data-block qualifiers at the module where view-name is specified for input.
2. DBVIEW must be specified prior to the first occurrence of the use of the view-name. It may only
be specified as an input data block to a DMAP module.
3. If the data-block is not generated or if no data blocks satisfy the where-expr, then the view-name
will be considered as not generated. Also, if the where-expr contains a qualifier that is not in
the path of the data-block then the view-name is not generated.
4. view-name is recognized only in the current subDMAP.
5. A view-name that results in more than one data block is also called a family. If a family is
specified as input to a module that does not use families, then the first data block stored will be
the one that is used.
6. The values assigned to qualifiers not specified in the where-expr are taken from current values.
AND WILDCARD may be specified in the where-expr to indicate that unspecified qualifiers
do not have to match their current values to satisfy the DBVIEW statement.
DBVIEW
Creates virtual datalock
view-name Name of the view; 1 through 8 characters in length. The first character must be
alphabetic. The following characters can be used for view-names: A through Z
and 0 through 9.
data-block Name of a data block.
where-expr A logical expression that specifies the desired values of qualifiers, PROJECT,
PROJNO, VERSION, and DBSET. For example, WHERE(VERSION=4 AND
SEID< >2 AND SEID>0) selects all items under version 4 for all values of
SEID greater than 0 except 2. See WHERE and CONVERT Clauses, 43 and
Remark 6. Be aware that certain restrictions apply to the where-expr when the
viewname will be used to specify an output data block on a module (see Remark
8).
WHERE (where-expr)
(WHERE where-expr)
Main Index
711 DBVIEW
Creates virtual datalock
7. A comma may be used in place of the spaces shown under Format to continue the DBVIEW
statement on more than one line. For example,
DBVIEW UGX=UG,
(WHERE SEID=10 AND,
SPC=20,
AND VERSION=5) $
8. 8. If the view-name in the subDMAP is used for an output datablock on a module then the
following restrictions apply:
a. The only operator allowed between qualifier assignments is the ";". For example,
WHERE(SEID)=10; PEID=20).
b. Only one datablock can be specified by the DBVIEW statement (families are not supported
for output datablocks).
c. PROJECT, PROJNO, VERSION,Where Expr modifier "WILDCARD", and the use of
qualifier_name=* are not allowed in the Where Expr.
Examples:
1. The following DBVIEW statement creates a view-name of KAA data blocks called KAA10 for
the path qualifier (see the PATH NDDL-Statement) SEID = 10 and for the current values of the
remaining KAA path qualifiers.
DBVIEW KAA10 = KAA (WHERE SEID=10) $
2. The following DBVIEW statement creates a view-name of the data block BULK, which is stored
under the version referenced on the RESTART FMS statement and gives it the virtual name
BULKR to differentiate it from the current data block BULK.
PROJVER //RESTART/S,N,RESPROJ/S,N,RESVER/S,N,EXISTS $
DBVIEW BULKR = BULK (WHERE VERSION=RESVER AND
PROJNO=RESPROJ) $
3. The following DBVIEW statement creates a view-name for the datablock KAA. The view-name
will be used as an output datablock to a DMAP module. The path qualifiers for this output
datablock will be assigned SEID=20 and SEID=10 and the remaining KAA path qualifiers will
be set to the current values.
DBVIEW KAA20 = KAA WHERE (SEID=20 ; PEID=10) $
4. The following DMAP sequence creates view-names for three input datablocks and four output
datablocks, using the same data block "XYZ".
DBVIEW IN1=XYZ, WHERE(SERIES3=JJ AND SERIES5=0 AND SERIES7=0) $
DBVIEW IN2=XYZ, WHERE(SERIES3=JJ+1 AND SERIES5=0 AND SERIES7=0) $
DBVIEW IN3=XYZ, WHERE(SERIES3=JJ+2 AND SERIES5=0 AND SERIES7=0) $
DBVIEW OUT1=XYZ, WHERE(SERIES3=0 ; SERIES5=1 ; SERIES7=JJ) $
DBVIEW OUT2=XYZ, WHERE(SERIES3=0 ; SERIES 5=2 ; SERIES7=JJ+1) $
Note: Any view-name specified by a DBVIEW statement using the ";" separator can also be used
for input datablocks (in this case, any ";" in the Where Expr will be interpreted as the boolean
"and" operator).
Main Index
DBVIEW
Creates virtual datalock
712
DBVIEW OUT3=XYZ, WHERE(SERIES3=0 ; SERIES5=3 ; SERIES7=JJ+2) $
DBVIEW OUT4=XYZ, WHERE(SERIES3=0 ; SERIES5=4 ; SERIES7=JJ+3) $
JJ=0 $
DO WHILE (JJ<1000) $
PARTN IN1,IN2,IN3/OUT1,OUT2,OUT3,OUT4 $
MATPRN OUT1,OUT2,OUT3,OUT4// $
JJ=JJ+1 $
ENDDO $
Main Index
713 DCMP
Matrix decomposition with extended diagnostics
Decompose a square matrix into upper and lower triangular factors and and diagonal matrix
. DCMP is identical to DECOMP, but also provides extended diagnostics.
Format:
Input Data Blocks:
Output Data Blocks:
DCMP
Matrix decomposition with extended diagnostics
DCMP DUSET,SIL,EQEXIN,A,PARTVEC,EQMAP/
, , /
S,N,KSYM/CHOLSKY/BAILOUT/MAXRATIO/SETNAME/F1/DECOMP/
DEBUG/THRESH/S,N,MINDIAG/S,N,DET/S,N,POWER/S,N,SING/
S,N,NBRCHG/S,N,ERR/LMTROWS $
USET Degree-of-freedom set membership table.
SIL Scalar index list.
EQEXIN Equivalence between external and internal numbers.
A A square matrix (real or complex, symmetric or unsymmetric).
PARTVEC Partitioning vector specified when A is a partition of SETNAME. Its rowsize is
indicated by SETNAME. A is the zero-th partition from PARTVEC.
EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.
LD Nonstandard lower triangular factor [L] and diagonal matrix [D] or Cholesky
Factor. [LD] also contains [D] for symmetric decomposition.
U Upper triangular factor or high ratios matrix. If A is unsymmetric then U is the
nonstandard upper triangular factor of [A] or the Cholesky factor. If A is
symmetric and the value of system cell 166 includes the value of 8 then U
contains the contains the "high ratio terms of the factor diagonal ratios". See
Remark 4.
A | | U | | L | |
D | |
A | | L | | U | | for unsymmetric A | | =
A | | L | | D | | L | |
T
for symmetric A | | =
LD
LAO
)
`
U
AAP
)
`
LSEQ
LSCM
)
`
Main Index
DCMP
Matrix decomposition with extended diagnostics
714
Parameters:
LSEQ Resequencing matrix based on internal resequencing of A.
LAO Sparse partial decomposition factor when KSYM=3.
AAP Sparse partial reduced matrix in update matrix format when KSYM=3.
LSCM Schur complement matrix based on internal partitioning of A.
KSYM Input/output-integer-default=1.
1
Use symmetric decomposition (default).
0
Use unsymmetric decomposition.
-
1
Use decomposition consistent with form of [A]. KSYM will be reset to 0 or 1
consistent with actual decomposition type.
3
Use symmetric partial decomposition.
CHOLSKY Input-integer-default=0. If KSYM=1 or KSYM=-1 and [A] is symmetric then:
1
Use Cholesky decomposition.
0
Use standard decomposition (default).
If KSYM=3, then CHOLSKY is set to the number of degrees of freedom in the
o-set.
BAILOUT Input-integer-default=0. If BAILOUT>0, then the module exits with error
message if factor to diagonal ratio exceeds MAXRATIO. If BAILOUT<-1, then
the module continues with warning message if factor to diagonal ratio exceeds
MAXRATIO.
MAXRATIO Input-real-default=1.E5. See the BAILOUT and ERR parameters.
SETNAME Input-character-default=H. One or two letters indicating the set membership
of [A].
F1 Input-real-default=0.0. Tolerance for suppressing numbers of small magnitude.
Matrix elements with magnitudes less than F1 will be set to zero.
DECOMP Input-integer-default=-1. See DECOMP, 723 module.
DEBUG Input-integer-default=-1. See DECOMP, 723 module.
THRESH Input-integer-default=-6. See DECOMP, 723 module.
MINDIAG Output-real double precision-default=0.0D0. See DECOMP, 723 module.
DET Output-complex-default=(0.0,0.0). See DECOMP, 723 module.
POWER Output-integer-default=0. See DECOMP, 723 module.
SING Output-integer-default=0. See DECOMP, 723 module.
Main Index
715 DCMP
Matrix decomposition with extended diagnostics
Remarks:
1. This module performs all of the functions of the DECOMP module and responds to the same
system cells. However the DCMP module default for KSYM is 1 instead of -1, which is the
default for DECOMP. All Remarks given for the DECOMP module also apply to the DCMP
module.
2. If given unsymmetric matrices (Form 1"), the mechanism diagnostics are not provided. The
module is then functionally equivalent to the DECOMP module.
3. Data blocks USET, SIL, and PARTVEC and parameter SETNAME are required for the most
efficient method of decomposition. PARTVEC is only required if A is not the same size as
SETNAME.
4. If A is symmetric then U contains the "MATRIX/FACTOR DIAGONAL RATIO values printed
under UWM 4698. The mathematical definition of U is
Diag(A) = Ad, a vector.
Diag(T) = Dd, a vector.
In some circumstances T is not a diagonal matrix. The high ratio test being defined here has no
validity in the regions where there are off-diagonal terms (2 by 2 pivots), so those rows are
ignored in this testing. The ratio is defined as
Vi = Adi/Ddi
Regions where the model is approaching singularity have small Ddi terms. They are divided into
Adi to non-dimensionalize them, and checked against a quality parameter value named
MAXRATIO. The default value for MAXRATIO is 1.E7, but the user is allowed to change its
value. Terms less than MAXRATIO are set to zero in Vi. If any terms remain, the matrix is
identified as singular, and various warning and fatal messages may appear, depending on the
context in which the DCMP module is being called.
This vector may be used to better identify singularities and provide other actions when they are
being approached. This feature is used in normal modes analysis, where points with high ratios
are automatically constrained to ground, to make the eigensolution more stable.
5. The sparse symmetric decomposition method may be used to decompose only a certain partition
specified by a partitioning vector (PARTVEC input data block for DCMP). In this case the
following decomposition is obtained:
NBRCHG Output-integer-default=0. See DECOMP, 723 module.
ERR Output-integer-default=-1. If BAILOUT=-1, this parameter always remains at
zero. If BAILOUT=0 and the factor to diagonal ratio is greater than
MAXRATIO, ERR is reset to -1.
LMTROWS Input-integer-default=0. Number of Lagrange Multipliers appended to the A
matrix. These rows are excluded from the internal reordering in the DCMP
module.
Main Index
DCMP
Matrix decomposition with extended diagnostics
716
where
The results of are written to LD and to LSCM.
Example:
Inspect the numerical conditioning of the
matrix. If the matrix is poorly conditioned, diagnostics will be produced.
DCMP USET,SIL,EQEXIN,MMAA,/LAA,UAA,/////A $
DIAGONAL LAA/DLAA $
MATPRN DLAA/$
A
A
oo
A
oa
A
ao
A
aa
L
oo
L
ao
I
D
oo
A
aa
L
oo
T
L
ao
T
I
= =
A
aa
A
aa
L
ao
D
oo
L
ao
T
=
L
oo
D
oo
L
ao
, , A
aa
M
aa
m
Main Index
717 DDR2
Computes displacements due to mode acceleration
Improves accuracy of modal transient or frequency response displacements by computing displacements
due to mode acceleration.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DDR2
Computes displacements due to mode acceleration
DDR2
86(7'8'3'.''%''0''2/8186('///'0
8'8(3'
APP/NOUE/UNUSED1/UNUSED2 $
USETD Degree-of-freedom set membership table for p-set.
UD Solution matrix for the d-set. Displacements only in frequency response.
Displacements, velocities, and accelerations in transient response.
PD Dynamic load matrix for the d-set.
KDD Stiffness matrix for the d-set.
BDD Damping matrix for the d-set.
MDD Mass matrix for the d-set.
OL Transient response time output list or frequency response frequency output list.
LLL Lower triangular factor/diagonal for the l-set.
DM Rigid body transformation matrix for the r-set to the l-set.
UD1 Improved solution matrix for the d-set.
UE Improved solution matrix for the e-set (extra points).
PD1 Equivalent load vector for mode acceleration computations for the
a-set.
APP Input-character-no default. Analysis type:
'TRAN' Transient response
'FREQ' Frequency response
NOUE Input-integer-default=-1. The number of extra points.
Main Index
DDR2
Computes displacements due to mode acceleration
718
Remarks:
1. The solution matrix, UD1, may be used to also improve the data recovery output; such as, stress,
strain, etc.
2. USETD, UD, PD, MDD, OL, and LLL may not be purged.
3. DM may not be purged if support degrees-of-freedom exist.
4. For transient analysis, the velocities and accelerations (every second and third column in UD) are
unchanged in UD1.
5. DDR2 uses a static approximation for the effect of the higher modes.
Method:
The equivalent load vector is computed:
(4-7)
For a transient analysis problem are given explicitly. For frequency response
analysis,
(4-8)
(4-9)
where is the forcing frequency and is the complex response vector. comes from PPF. The
vector is the sum of applied loads and inertia loads due to the motion of the system approximated
by its lower modes. The static solution using these loads will provide a better answer for displacements.
If extra points are present, then:
(4-10)
(4-11)
UNUSED1 Input-integer-default=-1. Unused.
UNUSED2 Input-integer-default=-1. Unused.
P
d
a
{ } P
d
{ } K
dd
2
{ } u
d
{ } B
dd
2
| | u
d
{ } M
dd
| | u
d
{ } =
u
d
{ } , u
d
{ } , and u
d
{ }
u
d
{ } ie u
d
{ } =
u
d
{ } e
2
u
d
{ } =
e u
d
{ } e
P
d
a
{ }
P
d
a
{ }
P
a
a
P
e
------
)
`
u
d
{ }
u
a
a
u
e
-----
)
`
Main Index
719 DDR2
Computes displacements due to mode acceleration
is placed in data block UEVF. Subroutines CALCV and SSG2A perform this calculation. If
supports are present, then:
(4-12)
(4-13)
Solve for :
(4-14)
This is accomplished in subroutine FBSDRV. If supports are present, then:
(4-15)
otherwise,
=
Subroutine SDR1B performs this calculation. If extra points are present, then:
(4-16)
u
e
{ }
P
l
a
{ }
P
l
P
r
-----
)
`
u
a
{ }
u
l
P
r
-----
)
`
u
a
a
{ }
L
ll
| | L
ll
| |
T
u
l
a
{ } P
l
a
{ } =
u
a
a
{ }
u
l
a
{ } D | | u
r
{ } +
u
r
---------------------------------------
)
`
=
u
a
a
{ } u
l
a
{ }
u
d
a
{ }
u
a
a
u
e
-----
)
`
d
{ } u
d
{ }
Main Index
DDRMM
Performs matrix method data recovery
720
Computes data recovery items (stress, displacements, forces, strains, forces) directly from the modal
solution in frequency response, transient response, or scaled response spectra analysis using the matrix
method.
Format:
Input Data Blocks:
Output Data Blocks:
DDRMM
Performs matrix method data recovery
DDRMM CASECC,UH,OL,IUG,IQG,IES,IEF,XYCDB/
OUG,OQG,OES,OEF,UNUSED5,OVG,OAG/
OPTION/NOCOMP/PEXIST/ACOUSTIC/ACOUT/PREFDB/SEID/
DVAFLAG $
CASECC Table of Case Control command images.
EST Element summary table.
UH Solution matrix for the h-set (modal degrees-of-freedom). Modal displacements
only in frequency response. Modal displacements, velocities, and accelerations
in transient response.
OL Transient response time output list or frequency response frequency output list.
IUG Table of displacements due to unit modal displacement in SORT1 or SORT2
format.
IQG Table of single point forces of constraint due to unit modal displacement in
SORT1 or SORT2 format.
IES Table of element stresses or strains due to unit modal displacement in SORT1
or SORT2 format. For strains, NOCOMP must be set to 3.
IEF Table of element forces due to unit modal displacement in SORT1 or SORT2
format.
XYCDB Table of x-y plotting commands.
OUG Table of displacements in SORT1 or SORT2 format.
OQG Table of single point forces of constraint SORT1 or SORT2 format.
OES Table of element stresses or strains in SORT1 or SORT2 format.
OEF Table of element forces in SORT1 or SORT2 format.
UNUSED5 Unused and may be purged.
Main Index
721 DDRMM
Performs matrix method data recovery
Parameters:
Method:
A matrix of modal solution data is formed from each of the modal SDR solution data blocks input to the
module. These data matrices and the matrix solution vectors are multiplied to form an output matrix.
If the modal solutions input to the modal are SORT1, the equation is
(4-17)
If the modal solutions input to the module are SORT2, the equation is
OVG Table of velocities in SORT1 or SORT2 format.
OAG Table of accelerations in SORT1 or SORT2 format.
OPTION Input-character-default=' '. Response summation method for scaled response spectra
analysis only. Possible values are:
'ABS' Absolute
'SRSS' Square root of the sum of the squares
'NRL' Naval Research Laboratory (new)
'NRLO' Naval Research Laboratory (old)
NOCOMP Input-integer-default=0. Set to 3 if IES is element strains.
ACOUSTIC Input-integer-default=0. Fluid-structure analysis flag.
PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.
0 No fluid elements exist.
1 Penalty or fluid acoustic elements exists.
2 Fluid/structure coupling exists.
ACOUT Input-character-default='PEAK'. Type of acoustic pressure output in fluid-structural
analysis.
'RMS' Root-mean-square
'PEAK' Peak
PREFDB Input-real-default=1.0. Peak pressure reference for pressure level in units of dB or
dBA.
SEID Input-integer-default=0. Superelement identification number.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations will be output in
separate data blocks.
-1 Velocities and accelerations are contained in OUG.
1 Velocities and accelerations are contained in OVG and OAG.
Output Matrix
1
| | Data Matrix
1
| | Solution Matrix | | =
Main Index
DDRMM
Performs matrix method data recovery
722
(4-18)
The output matrix formed for each modal input data block is converted to output data block format for
processing by the module OFP.
In (4-17) and (4-18), the solution matrix contains one solution vector (column) of size h (= number of
eigenvalues used) for each time or frequency step. Thus,
where:
In the above, the data matrix, if the modal data input is SORT1, contains one column vector for each
eigenvalue used. Each column contains all modal output component results for all elements or points
requested. If the modal data input is SORT2, the data matrix will be the transpose of that for SORT1 input
data, due to the data input processing requirements. Thus,
where:
Remarks:
1. If UD is a real matrix and OL is purged, then a scaled response spectra analysis is assumed.
2. OUG, OQG, OES, and OEF are suitable for printing or punching by the OFP module.
3. SDR2 is used to compute IUG, IQG, IES, and IEF, which are results due to a unit modal
displacement (eigenvector).
Rows
=
Number of eigenvalues
Columns
=
Number of time or frequency steps
Rows
=
Columns
=
number of time or frequency steps being output.
Output Matrix
2
| | Solution Matrix
T
| | Data Matrix
2
| | =
Solution Matrix | | is of size Rows Columns
Data Matrix
1
| | is of size Rows Columns
E components of all points or elements requested.
Output Matrix
2
| | Output Matrix
1
| |
T
Output Matrix
2
| | Output Matrix
1
| |
T
= =
Main Index
723 DECOMP
Matrix decomposition
To decompose a square matrix [A] into upper and lower triangular factors [U] and [L] and diagonal matrix
[D].
Format:
Input Data Block:
Output Data Blocks:
Parameters:
DECOMP
Matrix decomposition
DECOMP A/
LD,U, ,RPERM /
S,N,KSYM/CHOLSKY/S,N,MINDIAG/S,N,DET/
S,N,POWER/S,N,SING/S,N,NBRCHG/S,N,MAXRAT/DECOMP/
DEBUG/THRESH $
A Square matrix (real or complex; symmetric, or unsymmetric, or indefinite
symmetric).
LD Lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor. [LD]
also contains [D] for symmetric decomposition.
U Upper triangular factor or trapezoidal factor for partial decomposition. (See
Remark 4.)
LSEQ Resequencing matrix based on internal resequencing of A.
CPERM Table of column permutations under KSYM=4.
RPERM Table of row permutations under KSYM=4.
KSYM Input/output-integer-default=-1.
1 Use standard decomposition.
0 Use unsymmetric decomposition.
A | | L | | U | | for unsymmetric A | | =
A | | L | | D | | L | |
T
for symmetric A | | =
LSEQ
CPERM
)
`
Main Index
DECOMP
Matrix decomposition
724
-1 Use decomposition consistent with form of [A]. KSYM will be reset to 0 or 1
consistent with actual decomposition type (default).
3 Use symmetric partial decomposition. Sparse method is not available with
partial decomposition.
4 Sparse unsymmetric rectangular method.
CHOLSKY Input-integer-default=0. If KSYM = 1 or KSYM = -1 and [A] is symmetric then:
1 Use Cholesky decomposition.
0 Use standard decomposition (default).
If KSYM = 3, then CHOLSKY is set to the number of degrees of freedom in the o-set.
MINDIAG Output-real double precision-default = 0.0D0. The norm of the minimum diagonal
term of [U].
DET Output-complex single precision-default=(0.0,0.0). The scaled value of the
determinant of [A]. See the POWER parameter. DET is not applicable to sparse
methods. See Remark 1.
POWER Output-integer-default=0. Integer POWER of 10 by which DET should be multiplied
to obtain the determinant of [A]. In other words, the determinant of [A] is equal to
. POWER is not applicable to sparse methods. See Remark 1.
SING Output-integer-default=0. SING is set to -1 if [A] is singular. See Remark 3.
NBRCHG Output (for symmetric decomposition only)-integer-default=0. NBRCHG is the
number of negative terms on the diagonal.
MAXRAT Output (for symmetric decomposition only)-real-default=0.0. MAXRAT is the
maximum value of the ratio of the matrix diagonal to the factor diagonal.
DECOMP Input-integer-default=-1. Controls operation of module for exceptional conditions as
defined in the following table. If DECOMP > 0 then DECOMP overrides the value
specified on NASTRAN SYSTEM(69) statement.
DECOMP Action
0 or -1 Print up to 50 messages for null columns and zero diagonals
(non-sparse method only).
1 Terminate execution when first null column is encountered.
2 Suppress printing of message when a null column is encountered
(non-sparse method only).
4 Terminate execution when first zero diagonal term is encountered.
8 Suppress printing of message when a zero diagonal term is
encountered (non-sparse method only).
DET*10
POWER
Main Index
725 DECOMP
Matrix decomposition
Remarks:
1. By default, the DECOMP module uses sparse matrix methods. See the MSC.Nastran Numerical
Methods Users Guide.
a. The DECOMP parameter options 0, -1, 2, and 8 are ignored with the sparse method.
b. The precision of A must be equivalent to the machine precision.
c. Cholesky decomposition is not supported under this method; i.e., the parameter CHOLSKY =
1 will be ignored.
d. NASTRAN statement system cell 166 selects options for the sparse method.
2. Nonstandard triangular factor matrix data blocks are used to improve the efficiency of the back
substitution process in module FBS.
3. If the value of 16 is specified for the DECOMP parameter, then SING is set to one if unit values
are placed on the diagonal.
4. If KSYM = 3, the [A] matrix is decomposed through the first n degrees of freedom, where n is the
value provided by the CHOLSKY parameter. The resulting trapezoidal factor is output as [L] and
the remaining undecomposed partition of the [A] matrix, with contributions from the first n
degrees of freedom added, is output as [U].
16 Place 1.0 in diagonal position for all null columns and proceed with
the decomposition.
32 Stop the decomposition when zero diagonal terms are encountered.
64 Exit after execution of preface for symmetric decomposition.
DEBUG Input-integer-default=-1. Passive column logic control. DEBUG is used only by
non-sparse method. See the MSC.Nastran Numerical Methods Users Guide and
Remark 8.
THRESH Input-integer-default=-6. Power of 10 defining the pivoting threshold for
unsymmetric decomposition. Row pivoting will be done if any value on the factor
diagonal is less than . THRESH = -2 is recommended for indefinite matrices
because accuracy is improved even though execution time is increased.
0 No action.
1 If insufficient core is encountered, then switch to conventional decomposition and
continue (default).
2 Print diagnostics.
4 Do not issue fatal message if maximum ratios are exceeded. The maximum ratios are
replaced by 1.0.
10
THRESH
Main Index
DECOMP
Matrix decomposition
726
5. Cholesky factors (matrix form 10) can be used for all standard matrix operations; e.g., ADD,
MPYAD, etc. All other factors are packed, nonstandard data blocks as described in Remark 2 and
cannot be processed by other matrix modules except where noted.
6. The output triangular and trapezoidal matrices will have the following forms in the matrix trailer:
7. In decomposing symmetric matrices, , the diagonal factor is stored in the
diagonal of the matrix output. The factor is not output for this case.
8. Matrices with zero diagonal terms may be reliably solved if the corresponding leading minor is
nonzero. A more conservative course is to take a fatal error exit when zero diagonals occur,
regardless of the value of the leading minor. This action is obtained by setting DECOMP = 32.
9. Parallel sparse decomposition is selected with the NASTRAN statement keyword PARALLEL
(or SYSTEM (107)). To obtain optimal performance, it is also recommended that the SEQP
module be used with parameter NEWSEQ = 2.
Examples:
1. Solve .
DECOMP A/L,U,/ $
FBS L,U,B/X/ $
MATPRN X// $
2. Form .
Then decompose into assuming is a symmetric matrix.
SMPYAD G,A,G,,,/K/3////1////6 $
DECOMP K/L,,/ $
3. Calculate
using partial decomposition, then form given the following:
NOOSET integer parameter defining the size of .
Form Factor Type Matrix Type
4 Lower triangle Symmetric or unsymmetric
5 Upper triangle Unsymmetric only
10 Cholesky Symmetric only
11 Trapezoidal Symmetric only
13 Lower triangular Sparse symmetric
15 Lower or upper triangular Sparse unsymmetric
A | | L | | D | | L | |
T
= D | |
LD | | U | | L | |
T
=
A | | X | | B | | =
K | | G | |
T
A | | G | | =
K | | L | | L | |
T
K | |
K
aa
K
aa
K
ao
K
oo
1
K
oa
=
L
oo
K
oo
Main Index
727 DECOMP
Matrix decomposition
NOASET integer parameter defining the size of and .
NOFSET = NOOSET + NOASET
$ FORM PARTITIONING VECTOR
MATGEN ,/VFOX/6/NOFSET/NOOSET/NOASET $
$ MERGE O-SET AND A-SET WITH A-SET LAST
MERGE KOO,KAO,KOA,KAAB,VFOX,/KFFX/-1/0/6 $
$ PARTIALLY DECOMPOSE KFFX
DECOMP KFFX/LFO,KAA,/3/NOOSET $
PARTN LFO, ,VFOX/LOO, LAO, ,/1 $
K
aa
K
oa
Main Index
DELETE
Deletes data blocks
728
Deletes data blocks.
Format:
Input Data Blocks:
None.
Output Data Blocks:
Parameters:
None.
Remarks:
1. Any or all data blocks may be purged.
2. The output from previous module rule does not apply. See Output from a Previous Module Rule,
37.
Example:
DELETE /A,B,C,, $
DELETE
Deletes data blocks
DELETE /DB1,DB2,DB3,DB4,DB5 $
DBi Any table or matrix.
Main Index
729 DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
Extracts the diagonal elements from a matrix, raises each term to a specified power, and outputs a vector
(column matrix) or a rectangular matrix.
Format:
Input Data Block:
Output Data Block:
Parameters:
Remarks:
1. OPT = 'COLUMN' or 'SQUARE' provide exactly the same functions, except the output using
COLUMN is a vector, and the output using SQUARE is a square diagonal matrix. Both options
process only the real part of the diagonal terms of the input matrix.
DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
DIAGONAL A/B/OPT/POWER $
A Square or diagonal matrix (real or complex) if or
rectangular (real or complex) matrix if OPT = WHOLE
B Real vector (column matrix) or a rectangular matrix containing the terms of A raised
to a power
OPT Input-character-default='COLUMN'. Type of matrix output.
'COLUMN' Extract the diagonal elements of square matrix A into vector B (if
A is complex then only the real part is extracted) and then raise the
elements to the exponent POWER.
'SQUARE' Extract the diagonal elements of square matrix A into diagonal
matrix B (if A is complex then extract only the real part) and then
raise the elements to the exponent POWER.
'WHOLE' Copy rectangular matrix A into rectangular matrix B and then raise
the elements to the exponent POWER. If A is complex and
POWER<>1.0 then extract only the real part; however, if
POWER=1.0 then B will contain the magnitude of the elements.
POWER Input-real single precision-default=1. Exponent to which the real part of each
element is raised. See Remarks.
OPT 'WHOLE' =
Main Index
DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
730
If POWER = 0., unit column or the identity matrix of the dimension of the input matrix is
produced. This is an efficient method for producing these useful DMAP tools. OPT = 'WHOLE'
operates on all terms of the input matrix to produce an output matrix of the same dimension.
Sparse factor matrices (form = 11, 13, or 15) are not supported with OPT = 'WHOLE'. Each term
is processed independently.
2. OPT = 'WHOLE' operates on all terms of the input matrix to produce an output matrix of the same
dimension. Sparse factor matrices (form = 11, 13, or 15) are not supported with OPT = 'WHOLE'.
Each term is processed independently.
If POWER = 0., then all nonzero terms of [A] will produce unit terms in [B]. Zero terms in [A]
will produce zero terms in [B]. This is a means for producing Boolean matrices. [A] may be either
real or complex.
If POWER = 1.0, then [B] is a real matrix with terms that are the absolute value of the terms of
[A]. If [A] is complex then [B] contains the magnitude
of the terms of [A].
3. For fractional values of POWER and OPT = 'WHOLE', all elements must be nonnegative and for
OPT = 'COLUMN' or 'SQUARE' all diagonal elements must be nonnegative.
4. For whole number values of POWER, only real [A] matrices are allowed. The sign of the terms
of [A] are properly preserved.
5. If an illegal operation is requested, a warning message is produced, and [B] is purged.
Examples:
1. Extract the diagonal terms from LOO and KOO and form the ratio of factor diagonal to diagonal
terms and print terms less than .
DIAGONAL LOO/LOOD/COLUMN/1. $
DIAGONAL KOO/KOOD $
ADD LOOD,KOOD/LOVERK///2 $
MATMOD LOVERK,,,,/BIGLOVRK,/2////1.E-3 $
ADD LOVERK,BIGLOVRK/DIFF//-1.0 $
MATGPR BGPDT,USET,,DIFF//H/O $
2. Obtain the absolute value of a matrix [A]
DIAGONAL A/AA/WHOLE $
a
2
b
2
+ ( )
10
3
Main Index
731 DISDCMP
Performs distributed decomposition
Performs distributed decomposition which includes the parallel elimination of boundary nodes and
summation of global schur complement
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DISDCMP
Performs distributed decomposition
DISDCMP USET,SIL,EQEXIN,SCHUR,UNUSED5,EQMAP/
LBB,DSFDSC,SCHURS/
HLPMETH/UNUSED2/UNUSED3/UNUSED4/UNUSED5/
UNUSED6/UNUSED7/UNUSED8/UNUSED9/UNUSED10/
UNUSED11/UNUSED12/UNUSED13/UNUSED14/UNUSED15 $
USET Degree-of-freedom set membership table.
SIL Scalar index list.
EQEXIN Equivalence between external and internal numbers.
SCHUR Local Schur complement matrix in sparse factor format.
UNUSED5 Unused and may be purged.
EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.
LBB
Distributed boundary matrix factor in sparse factor format
(contains the local panels of the fronts).
DSFDSC Distributed boundary matrix factor.
SCHURS Sum of all SCHUR matrices from all processors.
HLPMETH Input-integer-default=1. Processing option.
>0 Summation ONLY.
=0 Complete boundary decomposition (default).
UNUSED2 Input-integer-default=0. Unused and may be left unspecified.
UNUSED3 Input-integer-default=0. Unused and may be left unspecified.
UNUSED4 Input-real-default=1.E5. Unused and may be left unspecified.
Main Index
DISDCMP
Performs distributed decomposition
732
UNUSED5 Input-character-default='H'. Unused and may be left unspecified.
UNUSED6 Input-real-default=0.0. Unused and may be left unspecified.
UNUSED7 Input-integer-default=-1. Unused and may be left unspecified.
UNUSED8 Input-integer-default=-1. Unused and may be left unspecified.
UNUSED9 Input-integer-default=-6. Unused and may be left unspecified.
UNUSED10 Input-real double precision-default=0.D0. Unused and may be left unspecified.
UNUSED11 Output-complex-default=(0.0,0.0). Unused and may be left unspecified.
UNUSED12 Input-integer-default=0. Unused and may be left unspecified.
UNUSED13 Input-integer-default=0. Unused and may be left unspecified.
UNUSED14 Input-integer-default=0. Unused and may be left unspecified.
UNUSED15 Input-integer-default=-1. Unused and may be left unspecified.
Main Index
733 DISFBS
Performs distributed forward-backward substitution
Performs distributed forward-backward substitution.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. LBB and DSFDSC may be purged.
DISFBS
Performs distributed forward-backward substitution
DISFBS LBB,DSFDSC,EQMAP,UABAR/
UA,PABAR,LOO/
HLPMETH $
LBB Distributed boundary sparse factor matrix (contains the local panels of the
fronts).
DSFDSC Table description of boundary sparse factor matrix.
EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.
UABAR Local updated rectangular ("loads") matrix.
UA Global boundary solution for distributed decomposition.
PABAR Summed up updated rectangular ("loads") matrix for distributed
decomposition.
LOO Merged boundary sparse factor matrix for distributed decomposition.
HLPMETH Input-integer-default=0. Processing option.
>0 Summation only.
0 Complete distributed forward-backward substitution (default).
4 Summation operation and merging of distributed sparse boundary factor matrix.
Main Index
DISOFPM
Collects and merges OFP data blocks
734
Collects and merges OFP data blocks from the slave processors to the master processor.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. For SORT1, OFPiM are merged according to normal OFP order of element type, subcase number,
and element identification number.
2. The type and order of data blocks across all DISOFPM/DISOFPS calls must correspond; e.g., if
the element stress OFP data block appears in the first input of the second call to DISOFPS then
the element stress data block must also appear in the first input and output of the second call to
DISOFPM.
DISOFPM
Collects and merges OFP data blocks
DISOFPM OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8/
OFP1M,OFP2M,OFP3M,OFP4M,OFP5M,OFP6M,OFP7M,OFP8M/
MAXBUFF $
OFPi OFP tables in SORT1 (or SORT2) format.
OFPiM Merged OFP tables in SORT1 (or SORT2) format.
MAXBUFF Input-integer-default=250000. Maximum buffer size in words given to each processor
for the merging process.
Main Index
735 DISOFPS
Sends OFP data blocks
Sends OFP data blocks from the slave processors to the master processor.
Format:
Input Data Blocks:
Output Data Blocks
None.
Parameters:
None.
Remarks:
1. OFPi may be purged. However, if OFPi is not purged, then the corresponding OFPiM cannot be
purged on the DISOFPS and DISOFPM statements.
2. The type and order of data blocks across all DISOFPM/DISOFPS calls must correspond; e.g., if
the element stress OFP data block appears in the first input of the second call to DISOFPS then
the element stress data block must also appear in the first input and output of the second call to
DISOFPM.
DISOFPS
Sends OFP data blocks
DISOFPS OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8 $
OFPi OFP tables in SORT1 (or SORT2) format.
Main Index
DISOPT
Performs appropriate discrete optimization problems
736
Performs the approximate discrete optimization problem using design variables, constraints, responses,
sensitivity information, Design of Experiments (DOE), conservative discrete design, rounding-up, and
rounding-down approaches.
Format:
Input Data Blocks:
DISOPT
Performs appropriate discrete optimization problems
DISOPT XINIT,DESTAB,CONSBL*,DPLDXI*,XZ,
DXDXI,DPLDXT*,DEQATN,DEQIND,DXDXIT,
PLIST2*,OPTPRMG,R1VALRG,RSP2RG,R1TABRG,
CNTABRG,DSCMG,DVPTAB*,PROPI*,CONS1T,
OBJTBG,COORDO,CON,SHPVEC,DCLDXT,
TABDEQ,EPTTAB*,DBMLIB,BCON0,BCONXI,
BCONXT,DNODEL,RR2IDRG,RESP3RG,DISTAB,
RQATABRG,PBRMSD/
XO,CVALO,R1VALO,R2VALO,PROPO,
R3VALO/
OBJIN/S,N,OBJOUT/PROTYP/UNUSED4/UNUSED5/
UNUSED6/UNUSED7/UNUSED8/UNUSED9/UNUSED10/
UNUSED11/UNUSED12/UNUSED13 $
XINIT Matrix of initial values of the design variables.
DESTAB Table of design variable attributes.
CONSBL* Matrix family of constant property values.
DPLDXI* Matrix family of coefficients in the property to independent design variable
relationship.
XZ Matrix containing the constant portion of the dependent to independent design
variable linking relationship.
DXDXI Matrix relating linked and independent design variables.
DPLDXT* Matrix family of transpose of DPLDXI.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DXDXIT Matrix transponse of DXDXI.
PLIST2* Table family of type two properties on DVPREL2 Bulk Data entries.
OPTPRMG Table of optimization parameters.
R1VALRG Matrix initial values of the retained first level responses.
RSP2RG Table of attributes of the retained second level responses.
Main Index
737 DISOPT
Performs appropriate discrete optimization problems
Output Data Blocks:
R1TABRG Table of attributes of the retained first level responses.
CNTABRG Table of retained constraint attributes.
DSCMG Unnormalized design sensitivity matrix.
DVPTAB* Table family of attributes of the designed properties by internal property
identification number order.
PROPI* Matrix family of initial property values.
CONS1T Matrix transpose of relationship between dependent and independent design
variables.
OBJTBG Design objective table. Objective attributes with retained response
identification number.
COORDO Updated (optimized) Table of designed coordinate values.
CON Matrix of constants that relates design variables and design coordinates.
SHPVEC Matrix of basis vectors -- coefficients relating designed grid coordinates and
design variables.
DCLDXT Matrix of coefficients in the grid to independent design variable relationship.
TABDEQ Table of unique design variable identification numbers.
EPTTAB* Table family of designed property attributes.
DBMLIB Table of designed beam library data.
BCON0 Table of constant terms in the beam section constraint relationship.
BCONXI Matrix relating beam library constraints to the independent design variables.
BCONXT Matrix transpose of BCONXI.
DNODEL Table of designed node list.
RR2IDRG Table of retained referenced type two response identification list.
RESP3RG Table of retained third level responses in RESP3 table.
DISTAB Table of discrete optimization value sets.
RQATABRG Total table of Rayleigh Quotient Approximation for retained eigenvalues.
PBRMSD Table of arbitrary beam data.
XO Matrix of final (optimized) values of the design variables.
CVALO Matrix of final (optimized) constraint values.
R1VALO Matrix of final (optimized) values of the retained first level responses.
R2VALO Matrix of final (optimized) values of the second level responses.
Main Index
DISOPT
Performs appropriate discrete optimization problems
738
Parameters:
Remarks:
None.
PROPO Matrix of final (optimized) property values.
R3VALO Matrix of final (optimized) values of the third level responses.
OBJIN Input-real-no default. Initial objective value.
OBJOUT Output-real-no default. Final objective value.
PROTYP Input-integer-default=0. Designed property type code.
UNUSEDi Input-integer-default=0. Unused.
Main Index
739 DISPARM
Broadcasts parameter values between slave and master processors
Broadcasts parameter values between slave and master processors for parallel processing.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
DISPARM
Broadcasts parameter values between slave and master processors
DISPARM //SENDID/RECVCODE/
S,N,INT/S,N,REAL/S,N,CMPX/S,N,CHAR/
S,N,REALD/S,N,CMPXD/S,N,LOG $
SENDID Input-integer-no default. Sending processor identification number. Allowable values
are 1 to the number of processors.
RECVCODE Input-integer-no default. Receiving processor identification code.
=0 All non-sending processors are receivers.
<0 Absolute value is the processor identification number of a single receiver.
>0 Bit pattern of receiving processors. The bit position from right to left
corresponds to the processor identification number.
INT Input/output-integer-default=0. Integer value.
REAL Input/output-real-default=0.0. Real value.
CMPX Input/output-complex-default=(0.0,0.0). Complex value.
CHAR Input/output-character-default='NULLNULL'. Character value.
REALD Input/output-double precision real-default=0.0D0. Real double precision value.
CMPXD Input/output-double precision complex-default=(0.0D0,0.0D0). Complex double
precision value.
LOG Input/output-logical-default=FALSE. Logical value.
Main Index
DISUTIL
Broadcasts data blocks between slave and master processors
740
Broadcasts data blocks between slave and master processors for parallel processing. Additional
processing may occur on the master processor.
Format:
Format for DISMETH=1 or 2:
Format for DISMETH=3 on master processor:
Format for DISMETH=3 on slave processor:
Format for DISMETH=4 or 5:
Format for DISMETH=6:
Format for DISMETH=7:
Format for DISMETH=8 or 9 on master processor:
DISUTIL
Broadcasts data blocks between slave and master processors
DISUTIL B,X,R,EQMAP/
EPSSE/
NSKIP/S,N,EPSI/1 or 2 $
DISUTIL DB,,,////3 $
DISUTIL ,,,,/DB///3 $
DISUTIL RESMAX,RESMAX0,CASECC,HEADCNTL////4 or 5 $
DISUTIL UG,SPCPART,,EQMAP/UGG///6 $
DISUTIL PG,SPCPART,,EQMAP/PGG///7 $
DISUTIL MATS,,,////-8, 8, or 9 $
Main Index
741 DISUTIL
Broadcasts data blocks between slave and master processors
Format for DISMETH=8 or 9 on slave processor:
Format for DISMETH=10:
Input Data Blocks:
Output Data Blocks:
DISUTIL MATS,,,////-8, 8, or 9 $
DISUTIL DB,,,/DBOUT/SENDID/RECVCODE/10 $
B Rectangular matrix which is the local load vector (with local values in local a-
set).
X Solution of the equation [A][X]=[B] which is the local solution matrix (with
global values in local a-set).
R Residual matrix which is local (with local or global values in local a-set).
EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.
DB Any data block to be broadcast from the master to the slave processors.
RESMAX Resultant or maxima matrix.
RESMAX0 Resultant or maxima matrix for residual structure.
CASECC Table of Case Control command images.
HEADCNTL List of integer codes for header print control.
UG Displacement matrix in g-set for the current processor (local).
SPCPART Partitioning vector for domain decomposition.
GEQMAP Table of grid based local equation map indicating which grid resides on which
processors/partitions for domain decomposition.
MATS Any matrix on slave processors.
EPSSE Table of epsilon and external work.
UGG Displacement matrix in g-set for all processors (global).
PGG Force matrix in g-set for all processors (global).
DB Any data block to be broadcast from the master to the slave processors.
MATM Any matrix on master processor.
Main Index
DISUTIL
Broadcasts data blocks between slave and master processors
742
Parameters:
Remarks:
1. All executions of DISUTIL must be synchronized across all processors.
2. EPSSE may be purged. EPSSE contains:
NSKIP Input-integer-default=1. Record number in CASECC corresponding to the
first subcase of the current boundary condition.
EPSI Output-integer-default=1. Static solution error ratio flag. Set to -1 if the error
ratio is greater than 1.E-3.
DISMETH Input-integer-default=1. Method.
1 Compute epsilons and external works assuming a-set components of
RUF are local values (which occurs in a direct solution).
2 Compute epsilons and external works assuming a-set components of
RUF are global values (which occurs in a in iterative solution).
3 Broadcast table or matrix from master to slaves.
4 Broadcast VECPLOT resultant output from slaves to master and
combine on master.
5 Broadcast VECPLOT maxima output from slaves to master and
combine on master.
6 Broadcast displacement matrices from slaves to master and merge into
global displacement matrix on master.
7 Broadcast force matrices from slaves to master and add/merge into
global force matrix on master.
8, -8 Broadcast any matrix from slaves to master and add all matrices on
master. DISMETH=8 is recommend for dense matrices and -8 for
sparse matrices.
9 Broadcast any matrix from slaves to master and append columnwise all
matrices on master.
10 Broadcast a data block to one or processors identified by RECVCODE.
SENDID Input-integer-default=1. Sending processor identification number. Allowable
values are 1 to the number of processors.
RECVCODE Input-integer-default=1. Receiving processor identification code.
= 0 All non-sending processors are receivers.
< 0 Absolute value is the processor identification number of a single
receiver.
>0 Bit pattern of receiving processors. The bit position from right to left
corresponds to the processor identification number.
Main Index
743 DISUTIL
Broadcasts data blocks between slave and master processors
a. Sequential number of subcases.
b. Superelement (domain) identification number.
c. Epsilon error ratio.
d. Strain energy (external work).
3. RESMAX0 may be purged, on the slave processors.
4. UGG may not be purged on the master processors.
5. For DISMETH=8 or 9 then MATS and MATM must be in machine precision.
Main Index
DIVERG
Performs aerostatic divergence analysis
744
Performs aerostatic divergence analysis: determines physically meaningful complex eigenvalues and
saves the eigenvectors that correspond to the divergence roots.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DIVERG
Performs aerostatic divergence analysis
DIVERG CLAMA,DYNAMIC,CASEA,EDT,CPHL,LCPHL/
DIVDAT,DCPHL,DLCPHL/
IMACHNO/LPRINT $
CLAMA Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk
Data entries.
DYNAMIC Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk
Data entries.
CASEA A single record (subcase) of CASECC for aerodynamic analysis. Specifies the
DIVERG and CMETHOD command set identification numbers.
EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.
CPHL Complex eigenvector matrix in the l-set.
LCPHL Left-handed complex eigenvector matrix in the l-set.
DIVDAT Table of divergence data.
DCPHL Complex eigenvectors associated with the divergence eigenvalues extracted
from the real part of eigenvectors associated with the divergence eigenvalues.
DLCPHL Left-handed complex eigenvectors associated with the divergence eigenvalues
extracted from the real part of left-handed eigenvectors associated with the
divergence eigenvalues.
IMACHNO Input-integer-no default. Mach number multiplied by 1000 and specified as an
integer.
LPRINT Input-logical-default=TRUE. Print flag for divergence analysis.
Main Index
745 DIVERG
Performs aerostatic divergence analysis
Remark:
Divergence eigenvalues are the eigenvalues with a purely imaginary part or with a negligible real part.
Only the first NROOT number of divergence eigenvalues are extracted, where NROOT is specified by
the DIVERG Bulk Data entry.
Example:
Excerpt from subDMAP DIVERGRS:
FILE DIVDTX=APPEND/PHIDRX=APPEND/PHIDLX=APPEND $
DIVERG CLAMAD,DYNAMICS,CASEA,EDT,PHIR,PHIL/
DIVDAT,PHIDR,PHIDL/
IMACHNO/LPRINT $ OUTPUT DIVERGENCE RESULTS
APPEND DIVDAT, /DIVDTX/2 $ APPEND DIVERGENCE INFORMATION
APPEND PHIDR, /PHIDRX/2 $ APPEND RIGHT EIGENVECTORS
APPEND PHIDL, /PHIDLX/2 $ APPEND LEFT EIGENVECTORS
Main Index
DLT2SLT
Converts DLT to SLT
746
Converts a DLT formatted table to an SLT formatted tablewith follower forces only.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DLT2SLT
Converts DLT to SLT
DLT2SLT DLT1,DIT/SLTF/ITIME/S,N,LOADIDF $
DLT1 Table of dynamic loads updated for nonlinear analysis.
DIT Table of TABLEij Bulk Data entry images.
SLTF Table of static loads with follower forces only.
ITIME Input-real-no default. Time instant at which the dynamicloads are evaluated and
converted to static loads.Usually input by a user parameter.
LOADIDF Output-integer-default=0. Load set identification numberof the newly created static
load set of follower forces.
Main Index
747 DMPCASE
Splits Case Control across multiple processors
Splits Case Control across multiple processors.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
DMPCASE
Splits Case Control across multiple processors
DMPCASE CASECC/CASECCP/NPROC/PROCID/NMASS/NCASE $
CASECC Table of Case Control command specifications.
CASECCP Selected records of CASECC assigned to local processor.
NPROC Input-integer-no default. Total number of processors.
PROCID Input-integer-no default. Local processor ID.
NMASS Input-integer-no default.
NCASE Input-integer-no default.
Main Index
DMIIN
Inputs DMI entries to DMAP
748
Inputs matrices referenced on DMI Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. The input data blocks DMI and DMINDX are output from the preface module IFP.
2. Any output data block may be purged.
3. If the output data blocks are specified on a CALL statement and the DMIIN module is specified
in the subDMAP referenced by the CALL statement, then the data block name specified on the
CALL statement must be the same as the name specified on the DMIIN module.
Example:
Assume the Bulk Data contains three DMI matrices named A, B, and C. The following DMAP
instruction will create the data blocks A and C. Matrix B will be ignored.
DMIIN DMI,DMINDX/A,C,,,,,,,,/S,N,YESA/S,N,YESC $
DMIIN
Inputs DMI entries to DMAP
DMIIN DMI,DMINDX/DMI1,DMI2,DMI3,DMI4,DMI5,DMI6,DMI7,
DMI8,DMI9,DMI10/PARM1/PARM2/PARM3/PARM4/PARM5/
PARM6/PARM7/PARM8/PARM9/PARM10 $
DMI Table of all matrices specified on DMI Bulk Data entries.
DMINDX Index into DMI.
DMIi Matrix data blocks with names that appear in field 2 of the DMI entries (e.g.,
the DMI matrix called DMI1 will be output on data block DMI1). See Remark
3.
PARMi Output-logical-default = FALSE. If the i-th output data block is generated, then
PARMi=TRUE.
Main Index
749 DOM10
Prints initial and final results for design optimization
In design optimization, prints the initial and final results for the approximate optimization problem.
Format:
Input Data Blocks:
DOM10
Prints initial and final results for design optimization
DOM1 DESTAB,XINIT,X0,CNTABRG,CVALRG,CVALO,DVPTAB*,
PROPI*,PROPO*,R1TABRG,R1VALRG,R1VALO,RSP2RG,
R2VALRG,R2VALO,OPTPRMG,OBJTBG,DRSTBLG,TOL1,FOL1,
FRQRPRG,DBMLIB,BCON0,BCONXI,WMID,RSP3RG,R3VALRG,
R3VALO,MODRPRG//
DESCYCLE/DESMAX/OBJIN/OBJOUT/EIGNFREQ/PROTYP/RESTYP
$
DESTAB Table of design variable attributes.
XINIT Matrix of initial values of the design variable.
XO Matrix of final (optimized) values of the design variables.
CNTABRG Table of retained constraint attributes.
CVALRG Matrix of initial constraint values.
CVALO Matrix of final (optimized) constraint values.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
PROPI* Family of matrices of initial property values.
PROPO* Family of matrices of final (optimized) property values.
R1TABRG Table of attributes of the retained first level responses.
R1VALRG Matrix of initial values of the retained first level responses.
R1VALO Matrix of final (optimized) values of the retained first level responses.
RSP2RG Table of attributes of the retained second level responses.
R2VALRG Matrix of initial values of the retained second level responses.
R2VALO Matrix of final values of the second level responses.
OPTPRMG Table of optimization parameters.
OBJTBG Design objective table. Objective attributes with retained response
identification number.
DRSTBLG Table containing the number of retained responses for each subcase for each of
the response types.
Main Index
DOM10
Prints initial and final results for design optimization
750
Output Data Blocks:
None.
Parameters:
TOL1 Transient response time output list truncated by the OTIME Case Control
command.
FOL1 Frequency response frequency output list truncated by the OFREQ Case
Control command.
FRQRPRG Table containing the number of first level retained responses per response type
and per frequency or time step.
DBMLIB Table of designed beam library data.
BCON0 Table of constant terms in the beam section constraint relationship.
BCONXI Matrix relating beam library constraints to the independent design variables.
WMID Table of weight as a function of material identification number.
RSP3RG Table of attributes of the retained third level responses.
R3VALRG Matrix of initial values of the retained third level responses.
R3VALO Matrix of final values of the third level responses.
MODRPRG Table indicating the number of retained responses per response type per mode.
DESCYCLE Input-integer-default=0. Design cycle analysis counter or flag.
-1 Initial execution of DOM10
-2 Final execution of DOM10
>0 Design cycle number
DESMAX Input-integer-default=0. Maximum allowed design optimization iteration number.
OBJIN Input-real-default=0.0. Initial objective value.
OBJOUT Input-real-default=0.0. Final objective value.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time)
2 Frequency (cycle/time)
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations, add above values.
Main Index
751 DOM10
Prints initial and final results for design optimization
Examples:
Excerpt from subDMAP DESOPT for initial execution:
DBVIEW TOLV=OLI WHERE (SOLAPP='MTRAN') $
DBVIEW FOLV=OLI WHERE (SOLAPP='MFREQ' OR SOLAPP='DFREQ') $
IF ( DESCYCLE=1
) DOM10 DESTAB,XINIT,,CNTABRG, CVALRG, ,
DVPTAB,PROPI,,R1TABRG,R1VALRG,,
RSP2RG,R2VALRG,,OPTPRMG,OBJTBG,DRSTBLG,
TOLV,FOLV,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
-1/DESMAX/OBJIN//EIGNFREQ $
Excerpt from subDMAP DESOPT for intermediate executions:
DOM10 DESTAB,XINIT,XO,CNTABRG, CVALRG, CVALO,
DVPTAB,PROPI,PROPO,R1TABRG,R1VALRG,R1VALO,
RSP2RG,R2VALRG,R2VALO,OPTPRMG,OBJTBG,DRSTBLG,
TOLV,FOLV,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
DESCYCLE/DESMAX/OBJIN/OBJOUT/EIGENFREQ $
Excerpt from subDMAP EXITOPT for final execution:
DBVIEW FOL1V=FOL1 WHERE(WILDCARD) $
DBVIEW TOL2V=TOL2 WHERE(WILDCARD) $
IF ( CNVFLG=2 OR DESCYCL1=DESMAX OR OPTEXIT=6 ) DOM10,
DESTAB,XVAL,,CNTABRG, CVALRG, ,
DVPTAB,PROPI,,R1TABRG,R1VALRG,,
RSP2RG,R2VALRG,,OPTPRMG,OBJTBG,DRSTBLG,
TOL2V,FOL1V,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
-2/DESMAX/OBJIN//EIGNFREQ $
RESTYP Input-integer-default=0. Optimization results flag.
0 Approximate model.
1 Exact analysis for fully stessed design optimization.
Main Index
DOM11
Updates geometry and element properties in design optimization
752
Updates geometry and element properties in design optimization.
Format:
Input Data Blocks:
Output Data Blocks:
DOM11
Updates geometry and element properties in design optimization
DOM11 EPT,EPTTAB*,PROPO*,XO,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,GEOM1,GEOM2,MPT,DMATCK,
PBRMSD/
EPTN,COORDN,GEOM1N,GEOM2N,MPTN,PBRMSN/
DESCYCLE/PROTYP/NRANVAR $
EPT Table of Bulk Data entry images related to element properties.
EPTTAB* Family of tables of designed property attributes.
PROPO* Family of matrices of final (optimized) property values.
XO Matrix of final (optimized) values of the design variables.
DESTAB Table of design variable attributes.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
DESGID Table of designed grid coordinate attributes.
COORDO Table of designed coordinate values.
CON Matrix of constants that relates design variables and design coordinates.
SHPVEC Matrix of basis vectors -- coefficients relating designed grid coordinates and
design variables.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
MPT Table of Bulk Data entry images related to material properties.
DMATCK Table of designed material consistency check.
PBRMSD Table of arbitrary beam data.
EPTN Updated (optimized) EPT.
COORDN Updated (optimized) COORDO.
Main Index
753 DOM11
Updates geometry and element properties in design optimization
Parameters:
Remarks:
The DOM11 module performs the following functions:
1. Creates the COORDN data block at the beginning of each iteration and updates property and
shape data blocks EPTN and GEOM1N at the end of each iteration.
2. Writes iteration information to the punch file.
3. Punches updated GRID and DESVAR entries.
Example:
Excerpt from subDMAP PREDOM:
DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,,,
DESGID,COORDO,CON,SHPVEC,/
EPTNN,COORDN,JUNKL/0/0 $
Initial:
DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,/
EPTNNX,COORDN,/0 $
Final:
DOM11 EPT,EPTTAB,PROPO,XO,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,GEOM1/
EPTN,COORDN,GEOM1N/DESCYCLE $
GEOM1N Updated (optimized) GEOM1.
GEOM2N Updated (optimized) GEOM2.
MPTN Updated (optimized) MPT.
PBRMSN Updated (optimized) PBRMSD.
DESCYCLE Input-integer-default=0. Design cycle analysis counter.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations, add above values.
NRANVAR Input-integer-default=0. Number of RANDVAR Bulk Data entries.
Main Index
DOM12
Performs soft and hard convergence checks in design optimization
754
Performs soft and hard convergence checks in design optimization.
Format:
Input Data Blocks:
DOM12
Performs soft and hard convergence checks in design optimization
DOM12 XINIT,XO,CVAL,PROPI*,PROPO*,OPTPRM,HIS,
DESTAB,GEOM1N,COORDO,EDOM,MTRAK,EPT,GEOM2,MPT,EDT,
EPTTAB*,DVPTAB*,XVALP,GEOM1P,
R1TABRG,R1VALRG,RSP2RG,R2VALRG,PCOMPT,UBULK,TOPELE,
PBRMSN,OBJTBG,CVALA,CVALP,DESTBX*,XOS*,PROPOS*,RPART,
SEDVLIST,XOESL,TOPTAB,TPRELE/
HISADD,OPTNEW,DBCOPT,DESNEW,NEWTOP,NEWTPR/
DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/CVTYP/OPTEXIT/
DESMAX/MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ/
DSAPRT/PROTYP/BADMESH/XYUNIT/FSDCYC/OBJAPPX/OBJINIT/
S,N,REJECT/ISHAPE/TREGION/OBJORG/SEID/PSENPCH $
XINIT Matrix of initial values of the design variables.
XO Matrix of final (optimized) values of the design variables.
CVAL Matrix of constraint values, CVALO or CVALRG.
PROPI* Family of matrices of initial property values.
PROPO* Family of matrices of final (optimized) property values.
OPTPRM Table of optimization parameters.
HIS Table of design iteration history.
DESTAB Table of design variable attributes.
GEOM1N Updated (optimized) Table of Bulk Data entry images related to geometry.
COORDO Matrix of designed coordinate values.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to the new mode
numbering.
EPT Table of Bulk Data entry images related to element properties.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.
MPT Table of Bulk Data entry images related to material properties.
EDT Element deformation table
EPTTAB* Family of tables of designed property attributes.
Main Index
755 DOM12
Performs soft and hard convergence checks in design optimization
Output Data Blocks:
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
XVALP XVAL table from previous iteration.
GEOM1P GEOM1 table from previous design iteration.
R1TABRG Table of attributes of the retained first level responses.
R1VALRG Matrix of initial values of the retained first level responses.
RSP2RG Table of attributes of the retained second level responses.
R2VALRG Matrix of initial values of the retained second level responses.
PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry.
UBULK Table of all unsorted Bulk Data entries.
TOPELE Element list for topology optimization.
PBRMSN Updated (optimized) PBRMSD.
OBJTBG Design objective table. Objective attributes with retained response identification
number.
CVALA Table of approximate constraint values for trust region analysis.
CVALP Table of exact constraint values at previous design cycle for trust region analysis.
DESTBX* A family of DESTAB for each PART SE.
XOS* A family design variable values for each PART SE
PROPOS* A family of property values, for each PART SE
RPART A table used to partition the results of the optimization for each PART SE.
SEDVLIST Merged design variables in each PART SE
XOESL Scaled design variables for ESL with topology
TOBTAB Table of topology variable attributes
TPRELE Table of manufacturing constraints.
HISADD Table of design iteration history for current design cycle.
OPTNEW Updated table of optimization parameters.
DBCOPT Design optimization history table for post-processing.
DESNEW Update table of design variable attributes.
NEWTOP Table for topology variable attributes
NEWTPR Updated table of manufacturing constraints
Main Index
DOM12
Performs soft and hard convergence checks in design optimization
756
Parameters:
DESCYCLE Input-integer-default=0. Design cycle analysis counter.
OBJIN Input-real-default=0.0. Initial objective value.
OBJOUT Input-real-default=0.0. Final objective value.
CNVFLG Output-integer-default=0. Design optimization convergence flag.
0 No convergence is achieved.
1 Soft convergence is achieved.
2 Hard convergence is achieved.
CVTYP Input-integer-default=0. Type of convergence test.
1 Soft convergence is to be checked.
2 Hard convergence is to be checked.
3 Final iteration histories are to be printed.
OPTEXIT Input-integer-default=0. Design optimization termination option. See OPTEXIT
description in the MSC Nastran Quick Reference Guide.
DESMAX Input-integer-default=0. Maximum allowed design optimization iteration number.
MDTRKFLG Input-integer-default=0. Mode tracking status flag.
0 Mode tracking was successful.
1 Mode tracking was unsuccessful.
DESPCH Input-integer-default=0. Punch control for updated DESVAR, DREPS1 and GRID
Bulk Data entries. See DESPCH description in the MSC Nastran Quick Reference
Guide.
DESPCH1 Input-integer-default=6. Punch output type flag.
0 None.
1 Designed analysis property entries.
2 All of the entries of the type as long as at least one property entry is designed
for the type.
4 Design model entries.
<>0 For combinations sum above values.
>0 Indicates large field format.
<0 Indicates small field format.
MODETRAK Input-integer-default=0. Mode tracking request flag.
0 Mode tracking was not requested.
>0 Mode tracking is requested.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
Main Index
757 DOM12
Performs soft and hard convergence checks in design optimization
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
DSAPRT Input-logical-default=FALSE. DSAPRT Case Control command print flag.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
BADMESH Input-logical-default=FALSE. Bad geometry was detected.
XYUNIT Input-integer-default=0. Fortran unit number to which the DOM12.
FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this
is a fully stressed design cycle.
OBJAPPX Input-real-default=0.0. approximate objective value for trust region analysis.
MXLAGM Input-real-default=0.0. Maximum Lagrange multiplier for trust region analysis.
REJECT Input/output-logical-default=FALSE. Rejected design flag for trust region analysis.
TRUE: Design is rejected.
FALSE: Design is accepted.
ISHAPE Input-integer-default=0. Shape optimization for trust region analysis.
=0
<>0
TREGION Input-integer-default=0. Trust region analysis flag. Extracted from word position 60
in OPTPRMG.
=0
<>0
OBJORG Input-Real. Original objective function
SEID Input-Integer Superelement ID
PSENPCH Input-Character, default=NO. With YES, updated parts superelements results are
punched. See PARAM (p. 450) in the MSC Nastran Quick Reference Guide.
Main Index
DOM12
Performs soft and hard convergence checks in design optimization
758
Examples:
1. Excerpt from subDMAP DESOPT following hard convergence:
DBVIEW XPREV=XINIT
DBVIEW PROPPV=PROPI
DBVIEW HISPV=HIS
(WHERE DESITER=DESCYCLP) $
(WHERE DESITER=DESCYCLP and dptype=*) $
(WHERE DESITER=DESCYCLP) $
cvtyp=2 $
PARAML optprmg//'DTI'/1/60//S,N,TREGION $
if ( tregion=1 ) trustR = TRUE $
if ( trustR ) then $
if ( mxlagmx=0.0 ) then $
if ( descycle=1 ) objinit = objin*10. $
else $
objinit = 2.*mxlagmx $
endif $ mxlagmx=0.0
endif $ trustR
REJECT=FALSE $
DOM12 XPREV, XINIT, CVALRG, PROPPV, PROPIF, OPTPRMG,
HISPV, DESTAB,,,EDOM,MTRAK,EPT,GEOM2,MPT,
EPTTABF,DVPTABF,,,,,,,PCOMPT,,TOPELE,PBRMSNX,
OBJTBG,CVALAPX,CVALRGP/
HISADD,NEWPRM,,NEWDES/
DESCYCLE/OBJPV/OBJIN/S,N,CNVFLG/CVTYP/OPTEXIT//
MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ/DSAPRT/
PROTYP///FSDCYC/OBJAPPX/OBJINIT/S,N,REJECT/0/
TREGION $
APPEND HISADD,/HISX/2 $
equivx HISX/HIS/-1 $
2
.
Excerpt from subDMAP DESOPT following soft convergence:
DBVIEW PROPIF =PROPI
DBVIEW PROPOF =PROPO
DBVIEW EPTABF =EPTTAB
DBVIEW DVPTABF =DVPTAB
WHERE (DPTYPE=*) $
(WHERE DPTYPE = *)
WHERE (DPTYPE=*) $
WHERE (DPTYPE=*) $
DOM12 XINIT,XO,CVALO,PROPIF,PROPOF,OPTPRMG,HIS,DESTAB,
GEOM1N,COORDO,,,EPTN,GEOM2N,MPTN,EPTTABF,DVPTABF,
,,,,,,PCOMPT,,TOPELE,PBRMSN,OBJTBG,,/
HISADD,NEWPRM,,NEWDES/
DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/CVTYP/OPTEXIT//
MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ//
PROTYP///FSDCYCf $
APPEND HISADD,/HISX/2 $
EQUIVX HISX/HIS/-1 $
Main Index
759 DOM12
Performs soft and hard convergence checks in design optimization
3
.
Excerpt from subDMAP EXITOPT for termination:
DBVIEW PROPIF =PROPI WHERE (DPTYPE=*) $
DBVIEW PROPOF =PROPO (WHERE DPTYPE = *)
DBVIEW EPTTABF =EPTTAB WHERE (DPTYPE=*) $
DBVIEW DVPTABF =DVPTAB WHERE (DPTYPE=*) $
IF ( ABS(OPTEXIT)>3 OR
(OPTEXIT=0 AND (CNVFLG>0 OR DESCYCL1=DESMAX OR NUMDDV>0
OR
DSPRINT OR DSUNFORM OR DSEXPORT OR
MODETRAK>0 OR BADMESH))
) DOM12 ,,XVAL,,,PROPOF,OPTPRMG,HIS,DESTAB,GEOM1,
COORDO,EDOM,MTRAK,EPT,GEOM2,,MPT,EPTTABF,DV[TABF,
XVALP,GEOM1P,,,,,PCOMPT,UBULK,TOPELE,PBRMSD,,,/
,,DBCOPT,/
DESCYCL1///CNVFLG/3/OPTEXIT/DESMAX/MDTRKFLG/
DESPCH/DESPCH1/MODETRAK/EIGNFREQ/DSAPRT/PROTYPE/
BADMESH/XYUNIT $
Main Index
DOM6
Calculates sensitivity of all retained constraints
760
Calculates sensitivity of all retained constraints with respect to independent design variables.
Format:
Input Data Blocks:
DOM6
Calculates sensitivity of all retained constraints
DOM6 XINIT,DPLDXI*,CONSBL*,R1VALRG,R2VALRG,DSCMG,RSP2RG,
DEQATN,PLIST2*,DEQIND,DXDXIT,DCLDXT,COORD,DESTAB,
DVPTAB*,TABDEQ,EPTTAB*,DBMLIB,DPLDXT*,DNODEL,RR2IDR,
RSP3RG,R3VALRG,PBRMSD/
DSCM2/
PROTYP/IFRMAS/UNUSED3/UNUSED4/UNUSED5/UNUSED6/
UNUSED7/UNUSED8/UNUSED9/UNUSED10/UNUSED11/UNUSED12 $
XINIT Matrix of initial values of the design variable.
DPLDXI* Family of matrices of coefficients in the property to independent design
variable relationship.
CONSBL* Family of matrices of constant property values.
R1VALRG Matrix of initial values of the retained first level responses.
R2VALRG Matrix of initial values of the retained second level responses.
DSCMG Unnormalized design sensitivity matrix.
RSP2RG Table of attributes of the retained second level responses.
DEQATN Table of DEQATN Bulk Data entry images.
PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries.
DEQIND Index table to DEQATN data block.
DXDXIT Matrix of coefficients in the design variable linking relationship.
DCLDXT Matrix of coefficients in the grid to design variable relationship.
COORD Matrix of initial or final designed coordinate values, COORDO or COORDN.
DESTAB Table of design variable attributes.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
TABDEQ Table of unique design variable identification numbers.
EPTTAB* Family of tables of designed property attributes.
DBMLIB Table of designed beam library data.
DPLDXT* Family of matrix transposes of DPLDXI.
Main Index
761 DOM6
Calculates sensitivity of all retained constraints
Output Data Blocks:
Parameters:
DNODEL Table of designed and non-designed locations.
RR2IDR Table of retained referenced type two response identification list.
RSP3RG Table of attributes of the retained third level responses.
R3VALRG Matrix of initial values of the retained third level responses.
PBRMSD Table of arbitrary beam data.
DSCM2 Normalized design sensitivity coefficient matrix.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
IFRMAS Input-integer-default=0. Fractional mass response type.
UNUSEDi Input-integer-default=0. Unused.
Main Index
DOM9
Performs the approximate optimization problem
762
Performs the approximate optimization problem using design variables, constraints, responses and
sensitivity information.
Format:
Input Data Blocks:
DOM9
Performs the approximate optimization problem
DOM9 XINIT,DESTAB,CONSBL*,DPLDXI*,XZ,
DXDXI,DPLDXT*,DEQATN,DEQIND,DXDXIT,
PLIST2*,OPTPRMG,R1VALRG,RSP2RG,R1TABRG,
CNTABRG,DSCMG,DVPTAB*,PROPI*,CONS1T,
OBJTBG,COORDO,CON,SHPVEC,DCLDXT,
TABDEQ,EPTTAB*,DBMLIB,BCON0,BCONXI,
BCONXT,DNODEL,RR2IDR,RESP3RG,RQATABRG,TOPTAB,
PBRMSD,TOPMC,TOPMC2,TMINIT,TOPELE,TPRELE,TOPSM/
XO,CVALO,R1VALO,R2VALO,PROPO,R3VALO,TMINIT1/
OBJIN/S,N,OBJOUT/PROTYP/EIGNFREQ/PROPTN/S,N,MXLAGM/
TREGION/UNUSED8/UNUSED9/UNUSED10/UNUSED11/
UNUSED12/UNUSED13/UNUSED14 $
XINIT Matrix of initial values of the design variable.
DESTAB Table of design variable attributes.
CONSBL* Family of matrices of constant property values.
DPLDXI* Family of matrices of coefficients in the property to independent design
variable relationship.
XZ Matrix containing the constant portion of the dependent to independent design
variable linking relationship.
DXDXI Matrix relating linked and independent design variables.
DPLDXT* Family of matrix transposes of DPLDXI.
DEQATN Table of DEQATN Bulk Data entry images. Output by IFP.
DEQIND Index table to DEQATN data block. Output by IFP.
DXDXIT Matrix transpose of DXDXI.
PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries.
OPTPRMG Table of optimization parameters.
R1VALRG Matrix of initial values of the retained first level responses.
RSP2RG Table of attributes of the retained second level responses.
R1TABRG Table of attributes of the retained first level responses.
Main Index
763 DOM9
Performs the approximate optimization problem
CNTABRG Table of retained constraint attributes.
DSCMG Unnormalized design sensitivity matrix.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
PROPI* Family of matrices of initial property values.
CONS1T Matrix transpose of relationship between dependent and independent design
variables.
OBJTBG Design objective table. Objective attributes with retained response
identification number.
COORDO Updated (optimized) Table of designed coordinate values.
CON Matrix of constants that relates design variables and design coordinates.
SHPVEC Matrix of basis vectors -- coefficients relating designed grid coordinates and
design variables.
DCLDXT Matrix of coefficients in the grid to independent design variable relationship.
TABDEQ Table of unique design variable identification numbers.
EPTTAB* Family of tables of designed property attributes.
DBMLIB Table of designed beam library data.
BCON0 Table of constant terms in the beam section constraint relationship.
BCONXI Matrix relating beam library constraints to the independent design variables.
BCONXT Matrix transpose of BCONXI.
DNODEL Table of designed and non-designed locations.
RR2IDR Table of retained referenced type two response identification list.
RESP3RG Table of attributes of the retained third level responses.
RQATABRG Total table of Rayleigh Quotient Approximation for retained eigenvalues.
TOPTAB Table of topology designed properties.
PBRMSD Table of arbitrary beam data.
TOPMC Topology member size control table.
TOPMC2 Topology member size control table for manufacturing constraints.
TMINIT Table of initial design variable values for topology with manufacturing
constraints.
TOPOLE Table of topology pole parameters (used only for topology manufacturing
constraints).
TPRELE Table of topology pole vs. element ids (used only for topology manufacturing
constraints).
TOPSM Table of topological symmetric constraints.
Main Index
DOM9
Performs the approximate optimization problem
764
Output Data Blocks:
Parameters:
XO Matrix of final (optimized) values of the design variables.
CVALO Matrix of final (optimized) constraint values.
R1VALO Matrix of final (optimized) values of the retained first level responses.
R2VALO Matrix of final (optimized) values of the second level responses.
PROPO Matrix of final (optimized) property values.
R3VALO Matrix of final (optimized) values of the third level responses.
TMINIT1 Updated table of initial design variable values for topology with manufacturing
constraints.
OBJIN Input-real-no default. Initial objective value.
OBJOUT Output-real-no default. Final objective value.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
PROPTN Input-integer-default=0. In order to support a pre-Version 68 capability, if
PROPTN=-1 then an EPT data block which is based on the values and the
property to design variable relations will be produced.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
MXLAGM Output-real-default=0.0. Maximum Lagrange multiplier for trust region analysis.
TREGION Input-integer-default=0. Trust region analysis flag. extracted from word position
60 in OPTPRMG.
=0
<>0
UNUSEDi Input-integer-default=0. Unused.
Main Index
765 DOPFS
Performs optimization of the fully stressed design
Performs optimization of the fully stressed design.
Format:
Input Data Blocks:
DOPFS
Performs optimization of the fully stressed design
DOPFS R1TABRG,CNTABRG,DESELM,DVPTAB*,CVALRG,
PROPI,OPTPRMG,DPLDXT*,CONSBL*,DESTAB,
XINIT,DPLDXI*,PLIST2*,DEQIND,DEQATN,
EPTTAB*,DBMLIB,XZ,DXDXI,DXDXIT,PBRMSD/
XO,PROPO $
R1TABRG Table of attributes of the retained first level (direct) responses.
CNTABRG Table of retained constraint attributes.
DESELM Table of designed elements.
DVPTAB* Table family of attributes of the designed properties by internal property
identification number order.
CVALRG Matrix of initial constraint values.
PROPI Matrix of initial property values.
OPTPRMG Table of optimization parameters.
DPLDXT* Matrix family of transpose of DPLDXI.
CONSBL* Matrix family of constant property values.
DESTAB Table of design variable attributes.
XINIT Matrix of initial values of the design variables.
DPLDXI* Matrix family of coefficients in the property to independent design variable
relationship.
PLIST2* Table family of type two properties on DVPREL2 Bulk Data entries.
DEQIND Index table to DEQATN data block.
DEQATN Table of DEQATN Bulk Data entry images.
EPTTAB* Table family of designed property attributes.
DBMLIB Table of designed beam library data.
XZ Matrix containing the constant portion of the dependent to independent design
variable linking relationship.
DXDXI Matrix relating linked and independent design variables.
Main Index
DOPFS
Performs optimization of the fully stressed design
766
Output Data Blocks:
Remarks:
None.
DXDXIT Matrix transpose of DXDXI.
PBRMSD Table of arbitrary beam data.
XO Matrix of final (optimized) values of the design variables.
PROPO Matrix of final (optimized) property values.
Main Index
767 DOPR1
Preprocesses design variables and designed property values
Preprocesses design variables and designed property values.
Format:
Input Data Blocks:
DOPR1
Preprocesses design variables and designed property values
DOPR1 EDOM,EPT,DEQATN,DEQIND,GEOM2,MPT,EDT,CASECC,TOPTAB0,
TOPELE,PBRMS,BGPDT,ECT,GPECT,VELEM,CSTM,
TOMTAB,PCOMPT, GEOM3, GEOM4 /
DESTAB,XZ,DXDXI,DTB,DVPTAB*,EPTTAB*,CONSBL*,
DPLDXI*,PLIST2*,XINIT,PROPI*,DSCREN,DTOS2J*,
OPTPRM,CONS1T,DBMLIB,BCON0,BCONXI,DMATCK,DISTAB,
TOPTAB,PBRMSD,NWEDOM,NWCASE,TOPMC,
TOPMC2,TMINIT,TOPELE,TPRELE,TOPSM, TOPVOL,
DXDSXI,TOPGID,TOTVOL/
S,N,MODEPT/S,N,MODGEOM2/S,N,MODMPT/S,N,MODEDT/DPEPS/
S,N,PROTYP/S,N,DISVAR/S,N,NRANVAR/
NONLNR/OPTEXIT $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EPT Table of Bulk Data entry images related to element properties.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
MPT Table of Bulk Data entry images related to material properties.
EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.
CASECC Table of Case Control command images.
TOPTAB0 Table of topology designed properties.
TOPELE Element list for topology optimization.
PBRMS Table of intermediate arbitrary beam data.
BGPDT Basic grid point definition table.
ECT Element connectivity table.
GPECT Grid point element connection table.
VELEM Table of element lengths, areas, and volumes.
CSTM Table of coordinate system transformation matrices.
Tomtab Table of Bulk Data entries related to topometry optimization.
Main Index
DOPR1
Preprocesses design variables and designed property values
768
Output Data Blocks:
Pcompt Table containing LAM option input and expanded information from the
PCOMP Bulk Data entry.
GEOM3 Table of Bulk Data entry images related to static loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
DESTAB Table of design variable attributes.
XZ Matrix containing the constant portion of the dependent to independent design
variable linking relationship.
DXDXI Matrix relating linked and independent design variables.
DTB Table of constants from the DTABLE Bulk Data entry.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
EPTTAB* Family of tables of designed property attributes.
CONSBL* Family of matrices of constant property values.
DPLDXI* Family of matrices of coefficients in the property to independent design
variable relationship.
PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries.
XINIT Matrix of initial values of the design variables.
PROPI* Family of matrices of initial property values.
DSCREN Table of constants from the DSCREEN Bulk Data entry.
DTOS2J* Family of tables identifying independent design variables and property
OPTPRM Table of optimization parameters.
CONS1T Matrix transpose of relationship between dependent and independent design
variables.
DBMLIB Table of designed beam library data.
BCON0 Table of constant terms in the beam section constraint relationship.
BCONXI Matrix relating beam library constraints to the independent design variables.
DMATCK Table of designed material consistency check.
DISTAB Table of discrete optimization value sets.
TOPTAB Table of topology designed properties with design variable identification
numbers.
PBRMSD Table of arbitrary beam data.
NWEDOM EDOM modified for random design variables.
Main Index
769 DOPR1
Preprocesses design variables and designed property values
Parameters:
NWCASE CASECC associated with beta response.
TOPMC Topology member size control table.
TOPMC2 Topology member size control table for manufacturing constraints
TMINIT Table of initial design variable values for topology with manufacturing
constraints
TOPOLE Table of topology pole parameters (used only for topology manufacturing
constraints)
TPRELE Table of topology pole vs. element identification numbers (used only for
topology manufacturing constraints)
TOPSM Table of topological symmetric constraints.
TOPVOL Table containing topological designable element volume based on property ID.
DXDSXI Matrix relating linked and independent sizing and shape design variables.
TOPGID Table containing designable grids for topography optimization.
TOTVOL Table containing topological designable element volume based on TOPVAR
entry ID
MODEPT Output-logical-default=FALSE. Analysis model element property modification
flag. Set to TRUE indicates that the design model is overriding element properties
in the analysis model.
MODGEOM2 Output-logical-default=FALSE. Analysis model connectivity modification flag.
Set to TRUE indicates that the design model is overriding connectivity in the
analysis model.
MODMPT Output-logical-default=FALSE. Analysis model material property modification
flag. Set to TRUE indicates that the design model is overriding material properties
in the analysis model.
MODEDT Ouptut-logical-default=FALSE. Analysis model element deformation flag. Set to
true indicates that the design model is overriding element deformation properties
(e.g., values on the TRIM entry).
DPEPS Input-real-default=1.0E-4. Tolerance for design model override of analysis model
properties. See further description in the MSC Nastran Quick Reference Guide.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations, add above values.
Main Index
DOPR1
Preprocesses design variables and designed property values
770
DISVAR Output-logical-default=FALSE. Discrete optimization variable flag. Set to
TRUE if discrete optimization design variables are specified.
NRANVAR Output-integer-default=0. Number of RANDVAR Bulk Data entries.
Nonlnr Input-logical-default=FALSE. Nonlinear structural optimization job flag. Set
to true indicates that the design job is an nonlinear structural optimization job.
Optexit Input-integer-default=0 . Design optimization termination option. See the
OPTEXIT (p. 904) in the MSC Nastran Quick Reference Guide.
Main Index
771 DOPR2
Preprocesses the shape design variables and the shape basis vectors
Preprocesses the shape design variables and the shape basis vectors.
Format:
Input Data Blocks:
Output Data Blocks:
DOPR2
Preprocesses the shape design variables and the shape basis
vectors
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,
CASECC,AMLIST,DVIDS/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,
CASEP,DNODEL/
LUSET/NOUGD/PEXIST/DVGRDN $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
BASVEC Auxiliary displacement matrix.
DESTAB Table of design variable attributes.
DXDXI Matrix relating linked and independent design variables.
XINIT Matrix of initial values of the design variables.
CASECC Table of Case Control command images.
AMLIST List of auxiliary model identification numbers.
DVIDS List of shape variable identification numbers to be used for the boundary dvgrid
option.
DESGID Table of designed grid coordinate attributes.
COORDO Matrix of initial designed coordinate values at the beginning of each design
cycle.
SHPVEC Matrix of basis vectors -- coefficients relating designed grid coordinates and
design variables.
DCLDXT Matrix of coefficients in the grid to design variable relationship.
CON Matrix of constants that relates design variables and design coordinates.
DTOS4J Designed grid perturbation vector in basic coordinate system.
Main Index
DOPR2
Preprocesses the shape design variables and the shape basis vectors
772
Parameters:
Remarks:
1. BASVEC may be DBLOCATE'd or internally generated.
2. CON is an offset vector that ensures the geometry at the beginning of a design cycle is same as
that in the analysis model. It is in the basic coordinate system.
Example:
Excerpt from subDMAP DESOPT:
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,CASEXX,
AMLIST,DVIDS/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,CASEP/
LUSET/NOUGD/PEXIST/DVGRDN $
Excerpt from subDMAP PREDOM:
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,
CASEXX,,/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,CASEP/
LUSET/NOUGD $
Excerpt from subDMAP SCSHBV:
DOPR2 EDOMSX,BGPDTS,CSTMS,,DESTAB,DXDXI,XINIT,CASEXX,,/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCPS,CASEP/
LUSETS/NOUGD/PEXIST/DVGRDN $
DESVCP Global shape basis vector matrix with incorporation of DLINK relations with
extra columns for property/dummy variables.
CASEP Residual superelement Case Control table for plotting basis vectors.
DNODEL Table of designed and non-designed locations.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NOUGD Input-integer-default=-1. Flag for external input of auxiliary model
displacement matrix. If NOUGD>0, then matrix exists.
PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.
DVGRDN Input-character-default='NO'. Flag for skipping basis vector components
associated with all GRIDNs in DESVCP. If DVGRDN='YES', then
components will be skipped.
Main Index
773 DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
Preprocesses DCONSTR, DRESP1, and DRESP2 Bulk Data entries per analysis type and superelement.
Creates tables related to the design objective and a Case Control table for recovering design responses.
Format:
Input Data Blocks:
DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
DOPR3 CASE,EDOM,DTB,ECT,EPT,DESTAB,EDT,OL,DEQIND,DEQATN,
BGPDT,DVPTAB*,VIEWTB,OINT,PELSET,XINIT,FOL,DIT,DYNAM
IC/
OBJTAB,CONTAB,R1TAB,RESP12,RSP1CT,FRQRSP,CASEDS,
OINTDS,PELSETDS,DESELM,RESP3,ADRDUG,ADRDUTB,CASADJ,
MODRSP,CASEDM,RQATAB,RESP12X,RESP3X,CONTABX,OBJTABX,
ARVEC/
DMRESD/S,N,DESGLB/S,N,DESOBJ/S,N,R1CNT/S,N,R2CNT/
S,N,CNCNT/SOLAPP/SEID/S,N,EIGNFREQ/PROTYP/DSNOKD/
SHAPES/S,N,R3CNT/RGSENS/INREL/S,N,ADJFLG/S,N,TADJCOL
/
AUTOADJ/SOLADJC/S,N,NORMEV $
CASE Table of Case Control commands for the current analysis type and
superelement.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
DTB Table of constants from the DTABLE Bulk Data entry.
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
DESTAB Table of design variable attributes.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ.
DEQIND Index table to DEQATN.
DEQATN Table of DEQATN Bulk Data entry images.
BGPDT Basic grid point definition table.
DVPTAB Table of attributes of the designed properties by internal property identification
number order. Output by DOPR1.
Main Index
DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
774
Output Data Blocks:
EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.
CASECC Table of Case Control command images.
TOPTAB0 Table of topology designed properties.
TOPELE Element list for topology optimization.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
OINT p-element output control table. Contains OUTPUT Bulk Data entries. Output
by IFP.
PELSET p-element set table, contains SETS DEFINITIONS.
XINIT Matrix of initial values of the design variables.
FOL Frequency response frequency output list.
DIT Table of TABLEij Bulk Data entry images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
OBJTAB Design objective table for a given analysis type and superelement. Objective
attributes with retained response identification number.
CONTAB Table of constraint attributes.
R1TAB Table of first level (DRESP1 Bulk Data entry) attributes.
RESP12 Table of second level responses.
RSP1CT Table of the count of type 1 responses per response type per subcase in R1TAB.
FRQRSP Table of the count of type 1 frequency/time responses per response type per
frequency or time step.
CASEDS Case control table for the data recovery of design responses.
OINTDS p-element output control table for constrained elements.
PELSETDS p-element set table for constrained elements.
DESELM Table of designed elements.
RESP3 Table of third level responses.
ADRDUG Matrix of adjoint loads for the g-set.
ADRDUTB Table of adjoint load attributes.
CASADJ Case Control table associated with adjoint method.
MODRSP Table of eigenvector response counts by subcase and mode.
CASEDM Case Control table for the recovery of design responses for modes.
RQATAB Table of Rayleigh Quotient Approximation.
Main Index
775 DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
Parameters:
RESP12X RESP12 Table of second level (synthetic) responses from than one
superelement.
RESP3X Table of third level responses from more than one superelement.
CONTABX Table of constraint attributes with respect to RESP12X.
OBJTABX Design objective table for a given analysis type and superelement with respsect
to RESP12X.
ARVEC Residual vector matrix based on adjoint loads.
DMRESD Input-integer-default=-1. Design model flag. If set to -1, then the design model is
limited to the residual structure.
DESGLB Output-integer-default=0. DESGLB Case Control command set identification
number.
DESOBJ Output-integer-default=0. DESOBJ Case Control command set identification
number.
R1CNT Input/output-integer-default=0. Counter for type 1 responses in data block R1TAB.
R2CNT Input/output-integer-default=0. Counter for type 2 responses in data block
RESP12.
CNCNT Input/output-integer-default=0. Counter for constraints in CONTAB.
SOLAPP Input-character-no default. Design optimization analysis type.
SEID Input-integer-default=-1. Superelement identification number.
EIGNFREQ Output-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
DSNOKD Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling
design sensitivity analysis. Usually specified as a user parameter.
SHAPES Input-logical-no default. Shape optimization Bulk Data entry presence flag. Must
be TRUE if DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present.
R3CNT Input/output-integer-default=0. Counter for type 3 responses in the RESP3 table.
RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.
Main Index
DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
776
Remarks:
1. DOPR3 must be executed in two nested DMAP loops based on every analysis type and
superelement. See subDMAP PRESENS for an example.
2. R1CNT, R2CNT, and CNCNT are accumulations of the number of records in R1TAB, RESP12,
and CONTAB.
INREL Input-integer-default=0. Inertia relief selection flag. Usually input via user
parameter.
ADJFLG Output-integer-default=0. Adjoint sensitivity flag.
TADJCOL Output-integer-default=0. Accumulated column count for adjoint load vector, for
supporting adjoint load method for multiple superelements.
AUTOADJ Input-character-No default. Adjoint sensitivity automatic selection flag. Usually
input via user parameter.
SOLADJC Input-integer-default=0. Flag to select solving adjoint load vectors along with
applied load vectors
>=0 Yes (generate adjoint load vectors in DOPR3).
<0 No (do not generate adjoint load vectors in DOPR3).
NORMEV Output-integer-default=0. Eigenvalue normalization flag.
0 Mass normalized.
1 Maximum deflection normalized.
Main Index
777 DOPR3X
Check second and third level responses
Perform additional checks on the second level and third level design responses for all superelements.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
None.
DOPR3X
Check second and third level responses
DOPR3X RESP12XM,RESP3XM/ $
RESP12XM Merged table of second level (synthetic) responses from all superelements.
RESP3XM Merged table of third level responses from all superelements.
Main Index
DOPR4
Creates design sensitivity tables for property and/or shape variables
778
Creates design sensitivity tables for property and/or shape variables.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DOPR4
Creates design sensitivity tables for property and/or shape
variables
DOPR4 DTOS2J*,DTOS4J,DESTAB/
TABDEQ,DTOS2K*,DTOS4K/
PROTYP $
DTOS2J* Family of tables identifying independent design variables and property.
DTOS4J Designed grid perturbation vector in basic coordinate system.
DESTAB Table of design variable attributes.
TABDEQ Table of unique design variable identification numbers.
DTOS2K* Family of tables which are the same as DTOS2J* except that the dvid in each
entry refers to the position of an internal design variable identification number
in the first TABDEQ record.
DTOS4K Same as DTOS4J except that the identification number in each five-word entry
is the position of an internal design variable identification number in the first
TABDEQ record.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>
0
For combinations, add above values.
Main Index
779 DOPR5
Updates design sensitivity tables
Updates design sensitivity tables.
Format:
Input Data Blocks:
Output Data Blocks:
DOPR5
Updates design sensitivity tables
DOPR5 XINIT,EPTTAB*,PROPI*,DESTAB,DTOS2K*,DTOS4K,
TABDEQ,DELBSH,GEOM4,DESGID/
DTOS2*,DTOS4,DELBSX/
STPSCL/S,N,RGSENS/PROTYP $
XINIT Matrix of initial values of the design variables.
EPTTAB* Family of tables of designed property attributes.
PROPI* Family of matrices of initial property values.
DESTAB Table of design variable attributes.
DTOS2K* Family of tables which are the same as DTOS2J* except that the dvid in each
entry refers to the position of an internal design variable identification number
in the first TABDEQ record.
DTOS4K Same as DTOS4J except that the identification number in each five-word entry
is the position of an internal design variable identification number in the first
TABDEQ record.
TABDEQ Table of unique design variable identification numbers.
DELBSH Matrix of finite difference shape step sizes.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
DESGID Table of designed grid coordinate attributes.
DTOS2* Family of tables which are the same as DTOS2K* except that the PREF in each
entry is the product of a DPLDXI element and the corresponding design
variable value.
DTOS4 Same as DTOS4K except that the last three words in each entry contains the
product of those in DTOS4K and the shape step size.
DELBSX Updated DELBSH where the numerical zero terms are replaced by a prescribed
small value.
Main Index
DOPR5
Updates design sensitivity tables
780
Parameters:
STPSCL Input-real-default=1.0. Shape step size scaling factor.
RGSENS Output-logical-default=FALSE. Rigid element sensitivity flag.
PROTYP Input-integer-default=1. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>
0
For combinations, add above values.
Main Index
781 DOPR6
Generates tables relating to grid perturbations
Generates tables relating to grid perturbations.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DOPR6
Generates tables relating to grid perturbations
DOPR6 DTOS4,GPECT,EQEXIN,DESGID,EST,GEOM4,MIDLIS/
DGTAB,ESTDVS,TABEVS/
RSONLY/RGSENS $
DTOS4 Table relating design variable to grid perturbation.
GPECT Grid point element connection table.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
DESGID Table of designed grid coordinate attributes.
EST Element summary table.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs)
and internal baseline MIDs.
DGTAB Table relating DTOS4 records and designed grid data.
ESTDVS EST with grid design variable perturbations.
TABEVS Cross reference table between ESTDVS records and element/ design variable
identification numbers.
RSONLY Input-logical-no default. Residual structure only flag.
FALSE Superelements are specified.
TRUE Superelements are not specified.
RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.
Main Index
DOPR6
Generates tables relating to grid perturbations
782
Remarks:
1. DOPR6 prepares tables to generate new stiffness matrix, mass matrix, load vector, etc. taking into
account shape design variable perturbations, i.e., K+DELTAK, M+DELTAM etc. This is
accomplished by generating an EST for all elements which are referred to by design variables.
The generated EST is in the same ascending order as the original EST. TABEVS is a cross
reference table between the generated EST (ESTDVS) and the original EID/design variables.
2. DOPR6 also retains those designed grids which are not associated with any structural elements
but are referenced by a rigid element.
Main Index
783 DOPRAN
Preprocess RMS responses
Preprocess RMS responses in design optimization.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
DOPRAN
Preprocess RMS responses
DOPRAN DYNAMIC,DIT,OL,R1TAB,BGPDT,CASE/
RMSTAB,CFSAB,PPVR/
LUSET $
DYNAMIC Table of Bulk Data entry images related to dynamics, specifically RANDPS.
DIT Table of TABLEij Bulk Data entry images, specifically TABRND1.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list.
R1TAB Table of first level (direct) (DRESP1 Bulk Data entry) attributes.
BGPDT Basic grid point definition table.
CASE Table of Case Control commands for the current analysis type and
superelement.
RMSTAB Table of RMS responses.
CFSAB Matrix of spectral densities -- weighting factors for RMS calculations.
PPVR Partitioning vector for random responses.
LUSET Input-integer-default=-1. The number of degrees-of-freedom in the
g-set.
Main Index
DPD
Creates tables from Bulk Data entry images specified for dynamic analysis
784
Creates tables from Bulk Data entry images specified for dynamic analysis.
Format:
Input Data Blocks:
Output Data Blocks:
DPD
Creates tables from Bulk Data entry images specified for dynamic
analysis
DPD DYNAMIC,GPL,SIL,USET,UNUSED5,PG,PKYG,PBYG,PMYG,YG,
ROTORT,FRFCONST/ GPLD,SILD,USETD,TFPOOL,DLT,PSDL,
RCROSSL,NLFT,TRL,EED,EQDYN,APPLOD,ENFLODK,ENFLODB,
ENFLODM,ENFMOTN,FRFXITPP,FRFLABEL,unused,ACPOOL/
LUSET/S,N,LUSETD/S,N,NOTFL/S,N,NODLT/S,N,NOPSDL/
DATAREC/ S,N,NONLFT/S,N,NOTRL/S,N,NOEED/SORTNLFT/
S,N,NOUE/UNUSED12/SEID/FRFGEN/S,N,NOACLD $
DYNAMIC Table of Bulk Data entry images related to dynamics.
GPL External grid/scalar point identification number list.
SIL Scalar index list.
USET Degree-of-freedom set membership table for g-set.
SLT Table of static loads.
UNUSED5 Unused and may be purged.
PG Static load matrix for the g-set.
PKYG Matrix of equivalent static loads due to enforced displacement for the g-set.
PBYG Matrix of equivalent static loads due to enforced velocity for the g-set.
PMYG Matrix of equivalent static loads due to enforced acceleration for the g-set.
YG Matrix of enforced displacements or temperatures for the g-set.
ROTORT Table of rotordynamic user input for transient analysis.
FRFCONST Table containing CONNPTS set data from the FRF Case Control command in an
FRF generation job.
GPLD External grid/scalar/extra point identification number list. (GPL appended with
extra point data).
SILD Scalar index list for p-set. (SIL appended with extra point data).
Main Index
785 DPD
Creates tables from Bulk Data entry images specified for dynamic analysis
Parameters:
USETD Degree-of-freedom set membership table for p-set. (USET appended with extra
point data).
TFPOOL Table of TF Bulk Data entry images.
DLT Table of dynamic loads.
PSDL Power spectral density list.
RCROSSL Table of RCROSS Bulk Data entry images.
UNUSED7 Unused.
NLFT Nonlinear Forcing function table.
TRL Transient response list.
EED Table of eigenvalue extraction parameters.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data).
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous damping
effects
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass effects
ENFMOTN Matrix of enforced motion amplitudes
FRFXITPP P-size column matrix generated in an FRF generation job containing coded
values for rows indicating whether the DOF corresponding to that row has unit
load specified on it via an FRFXIT entry, an FRFXIT1 entry or due to its being
a connection DOF (or a combination of these).
FRFLABEL Table containing LABEL information from FRFXIT Bulk Data entries.
ACPOOL Table of ACTRIM Bulk Data entry images.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
LUSETD Output-integer-no default. The number of degrees-of-freedom in the
p-set.
NOTFL Output-integer-no default. The number of transfer function Bulk Data entries. Set
to -1 if no sets are defined.
NODLT Output-integer-no default. Set to 1 if dynamics loads Bulk Data entries are
processed, -1 otherwise. 1 also means DLT is created.
NOPSDL Output-integer-no default. Set to 1 if random analysis Bulk Data entries are
processed, -1 otherwise. 1 also means PSDL is created.
Main Index
DPD
Creates tables from Bulk Data entry images specified for dynamic analysis
786
Remarks:
1. DPD is the principal data processing module for dynamics analysis. New tables are assembled to
account for any extra points in the model and the additional displacement sets used in dynamics.
2. DYNAMIC can be purged if TFPOOL, DLT, PSDL, NLFT, TRL, and EED are also purged. SLT
and PG cannot be purged if static loads are referenced by dynamic loads via the LSEQ Bulk Data
entry.
3. USET, SIL, GPL, GPLD, and SILD may be purged if USETD, DLT, and EED are purged.
However, TRL will not contain the TIC record.
DATAREC Input-integer-default=0. Data recovery flag. If DATAREC>0, then DPD will not
perform UFM 2071 checks for DELAY and DPHASE which are not needed in data
recovery.
UNUSED6 Input-integer-default=0. Unused.
NONLFT Output-integer-no default. Set to 1 if nonlinear forcing function Bulk Data entries
are processed, -1 otherwise. 1 also means PSDL is created.
NOTRL Output-integer-no default. Set to 1 if transient time step parameter Bulk Data entries
are processed, -1 otherwise. 1 also means TRL is created.
NOEED Output-integer-no default. Set to 1 if eigenvalue extraction Bulk Data entries are
processed, -1 otherwise. 1 also means EED is created.
UNUSED10 Input-integer-no default. Unused.
NOUE Output-integer-no default. Number of extra points. Set to -1 if there are no extra
points.
UNUSED12 Input-integer-default=0. Unused.
SEID Input-integer-default=0. Superelement identification number.
FRFGEN Input-integer-default=0. FRF generation flag.
0 = Do not generate FRF information
1 = Generate FRF information
NOACLD Output-logical-default=false. Set true if ACLOAD Bulk Data entries are processed.
Main Index
787 DRMH1
Converts data recovery tables to matrices and associated directory tables
Converts data recovery tables (e.g., displacements, stresses, strains, forces, SPCforces, and MPCforces)
to matrices and associated directory tables. Similar to DRMS1 module.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. DRMH1 is a similar to the DRMS1 module except that only the linear quantities (e.g., axial stress)
are output to the matrix. However, if NULLROW=0, then null rows will be inserted for the
nonlinear quantities (e.g., margin-of-safety).
DRMH1
Converts data recovery tables to matrices and associated directory
tables
DRMH1 OFP1,OFP2,OFP3,OFP4/
TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4/
NCOL/NULLROW/TRL5T1/TRL5T2/TRL5T3/TRL5T4 $
OFPi Output table in SORT1 format usually created by the SDR2 module.
TOFPi Directory table for MOFPi.
MOFPi Matrix form of the i-th output table.
NCOL Input-integer-default=0. Number of columns (i.e.; subcases, modes, time steps or
frequencies) desired in the output matrices. By default, all data records will be
converted into the output matrices. If NCOL is less than the number of data records
in the input table, then the first NCOL records are converted and the remaining
records are ignored.
NULLROW Input-integer-default=1. Flag to insert null rows in the output matrices for nonlinear
quantities. See Remark 1.
0 Insert null rows. Compatible with DRMS1 output format.
1 Do not insert null rows. Required for DRMH3 processing.
TRL5Ti Output-integer-default=0. Specifies value for the fifth word in TOFPi's trailer.
Main Index
DRMH1
Converts data recovery tables to matrices and associated directory tables
788
2. DRMH1 will convert tables with complex numbers to a matrix. However, the matrix contains
complex numbers. As a result only the item codes specified in the real side of the plot code tables
are utilized.
3. The DRMH3 module performs the inverse operation: convert matrices into OFP tables.
Example:
In SOL 108, we wish to double the stress output in the OES1 table:
SOL 108
MALTER , ETC. DATA RECOVERY, SORT1(,-1)
DRMH1 OES1,,,/TES,MES,,,,,, $
ADD5 MES,,,,/MES2/2. $
DRMH3 TES,MES2,,,,,,,OL2,CASEDR/OES12,,,/APP1 $
OFP OES12/ $
CEND
Main Index
789 DRMH3
Partitions tables for each superelement
Converts data recovery matrices and associated directory tables (DRMH1 module outputs) to SORT1
formatted tables suitable for printing by the OFP module or processing by other modules; e.g., DDRMM
and SDR3.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DRMH3
Partitions tables for each superelement
DRMH3 TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4,
OL,CASECC/
OFP1,OFP2,OFP3,OFP4/
APP/DTM1/DTM2/DTM3/DTM4 $
TOFPi Directory table for MOFPi.
MOFPi Matrix form of the i-th output table.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ. May also be output by MODACC if truncated via the OFREQ and
OTIME Case Control commands.
CASECC Table of Case Control command images.
OFPi Output table in SORT1 format identical in format to data blocks created by the
SDR2 module.
APP Input-character-default='STATICS'. Analysis type. Allowable types are:
'STATICS' Statics
'REIG' Normal modes
'CEIGEN' Complex modes
'FREQRESP' Frequency response
Main Index
DRMH3
Partitions tables for each superelement
790
Remarks:
1. If CASECC is purged, then all input data blocks will be converted. Otherwise, the inputs will be
converted based on the output commands specified in CASECC.
2. If the number of entries in a matrix does not match the associated table, the following will occur:
If the number of rows (output quantities; e.g., stresses) does not match, a warning message will
be printed with the identification of the matrix and table name.
If the number of columns (e.g., subcases or mode) does not match, then a warning message will
be printed and the module will continue. This will allow the user to combine modal results using
any desired method into a single set of results (or more) and not be required to modify the table.
Example:
See the DRMH1, 787 module description.
'TRANRESP' Transient response
DTMi Input-integer-default=0. Mode acceleration based displacement matrix flag. If
DTMi<>0, then MOPFi is a mode acceleration based displacement matrix and,
therefore, velocities and accelerations will not be output to OFPi. For
APP='TRANRESP', MOFPi must have only one column per time step instead of
the usual three.
Main Index
791 DRMS1
Data recovery by mode superposition, Phase 1
To compute output transformation matrices for displacements, SPC forces, stresses, and element forces.
The input data blocks are the type generated by the SDR2 module and formatted for the OFP module.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. SDR2 output data blocks (OFPi) are input data blocks for this module. Module DRMS1 generates
the output transformation matrix (MOFPi) and associated directory table (TOFPi) from each of
the input data blocks.
2. There are some data in OFPi for the output transformation that may not be given linear
combination operations, such as margins of safety and principal stresses. This irrelevant data will
be eliminated from the output transformation matrix. Components that are retained in the matrix
MOFPi are indicated in the table of element stress output data description.
3. All the output transformation matrices will have as many columns as the number of modes or
loading conditions specified in PARAM, NCOL. Each column will contain all the relevant
components of GRIDs (T1, T2, etc.) or elements ( , , etc.) for all the GRIDs or elements
retained in the input data blocks.
DRMS1
Data recovery by mode superposition, Phase 1
DRMS1 OFP1,OFP2,OFP3,OFP4/
TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4/
NCOL $
OFPi Output table in SORT1 format usually created by the SDR2 module.
TOFPi Directory table for MOFPi.
MOFPi Matrix form of the i-th output table.
NCOL Input-integer-default=0. Number of columns (i.e.; subcases, modes, time steps
or frequencies) desired in the output matrices. By default, all data records will
be converted into the output matrices. If NCOL is less than the number of data
records in the input table, then the first NCOL records are converted and the
remaining records are ignored.
o
x
o
y
Main Index
DRMS1
Data recovery by mode superposition, Phase 1
792
4. Directory tables contain the mapping information as follows:
RECORD 0 - Header record, indicating.
Type of data ( , q, , or F).
Format code (real, real/imaginary or magnitude/phase).
RECORD 1 - Identification of the columns, providing
Column numbers of the associated matrix.
Natural frequencies .
RECORD 2 - Identification of the rows, providing
Type code of points or elements.
identification number number of points or elements.
Number of components of the point or element retained in the associated matrix.
Starting row number of the point or element with reference to the associated matrix. See the
OES, OEF, OUG, and OQG table descriptions in + on page 851.
Matrix trailer output, indicating the size of the associated matrix.
| o
f
n
( )
Main Index
793 DSABO
Incorporates element property design variable perturbations
Incorporates element property design variable perturbations into tables required for stiffness, mass,
damping, and load generation.
Format:
Input Data Blocks:
Output Data Blocks:
DSABO
Incorporates element property design variable perturbations
DSABO ECT,EPT,EST,DTOS2*,ETT,DIT,MPT,DMATCK,PCOMPT/
ESTDVP,MPTX,EPTX,TABEVP,MIDLIS,ESTDVM,PCOMPTX/
S,N,PROPOPT/DELTAB/PROTYP/PEXIST $
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
EST Element summary table.
DTOS2* Family of tables which are the same as DTOS2K* except that the PREF in each
entry is the product of a DPLDXI element and the corresponding design
variable value.
ETT Element temperature table.
DIT Table of TABLEij Bulk Data entry images.
MPT Table of Bulk Data entry images related to material properties.
DMATCK Table of designed material consistency check.
PCOMPT Table containing LAM option input and expanded information from the
PCOMP Bulk Data entry.
ESTDVP EST with element property design variable perturbations.
MPTX MPT with design variable perturbations.
EPTX EPT with design variable perturbations.
TABEVP Cross-reference table between ESTDVP records and element and design
variable identification numbers.
MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs)
and internal baseline MIDs.
ESTDVM EST with updated material property identification numbers.
PCOMPTX PCOMPT with design variable perturbations.
Main Index
DSABO
Incorporates element property design variable perturbations
794
Parameters:
Remarks:
1. The main purpose of module DSABO is to prepare tables which will generate a new stiffness
matrix, mass matrix, load vector, etc., while taking into account the design variable perturbations,
i.e., K + DELTAK, M + DELTAM, etc. These calculations are completed by generating an EST
for all elements which are referred to by the design variables which is in the same ascending order
as the original EST. The EPT portion of the generated EST includes all the perturbations
necessary to build K + DELTAK, M + DELTAM, etc. EMG and SSG1 use ESTDV to generate
K + DELTAK, M + DELTAM and P + DELTAP due to temperature effects. DSVG1 and DSVG2
then calculate DELTAK * u, DELTAP etc.
2. If central difference is requested then DSABO must be executed for the backward tables. For
example, in subDMAP PSLGDV, DSABO is used as follows:
DSABO ECTS,EPTS,EST,DTOS2,ETT,DIT,MPTS/
ESTDVP,MPTX,EPTX,TABEVP/
S,N,PROPOPT/DELTAB $
IF ( CDIFX='YES' ) THEN $
DELTABX=-DELTAB $
DSABO ECTS,EPTS,EST,DTOS2,ETT,DIT,MPTS/
ESTDVPB,MPTXB,EPTX,TABEVP/
S,N,PROPOPT/DELTABX $
ENDIF $ CDIFX='yes'
PROPOPT Output-integer-default=0. Property optimization flag. Set to 1 if element properties
are defined as design variables.
DELTAB Input-real-no default. Relative finite difference move parameter as specified on the
DOPTPRM Bulk Data entry and stored in the OPTPRM data block.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
PEXIST Input-logical-default=FALSE. p-element flag. Set to TRUE if
p-elements are present.
Main Index
795 DSAD
Processes tables related to design sensitivity response evaluation
Processes tables related to design sensitivity response evaluation, constraint screening and load case
deletion.
Format:
Input Data Blocks:
DSAD
Processes tables related to design sensitivity response evaluation
DSAD RSP1CT,R1TAB,RESP12,OBJTAB,CONTAB,
BLAMA,CLAMA,LAMA,DIVTAB,AUXTAB,STBTAB,
FLUTAB,OUG1DS,OES1DS,OSTR1DS,OEF1DS,
OEFITDS,OES1CDS,OSTR1CDS,OQG1DS,DSCREN,
XINIT,TABDEQ,COORDN,OL,FRL,FRQRSP,CASEDS,
CASERS,UGX,OPTPRM,DVPTAB*,PROPI*,
GPDT,DNODEL,WGTM,ONRGYDS,
GLBTABDS,GLBRSPDS,RESP3,RMSTAB,RMSVAL,
UPF,QPF,QMPF,UHF,OUGD1M,OESD1M,OSTRD1M,
OEFD1M,MODRSP,CASEDM,PHG,OGPFB1DS,OELOP1DS,
ONRGD1M,UPSDT,RQATAB,RESP12X,RESP3X,EPSSE,ESRT,
OES1AB/
R1VAL,R2VAL,RSP2R,R2VALR,CVAL,
CVALR,OBJTBR,CNTABR,R1TABR,R1VALR,
DRSTBL,FRQRPR,UGX1,AUG1,R1MAPR,
R2MAPR,CASDSN,CASDSX,DRDUG,DRDUTB,
CASADJ,LCDVEC,RR2IDR,R3VAL,R3VALR,RESP3R,RMSTABR,
RMSVALR,FRLR,FOLR,UPFM,QPFM,QMPFM,UHFM,MODRPR,
UPSDTR,RQATABR,RESP12XR,RESP3XR/
WGTS/VOLS/S,N,OBJVAL/S,N,NR1OFFST/S,N,NR2OFFST/
S,N,NCNOFFST/APP/DMRESD/SEID/DESITER/
EIGNFREQ/S,N,ADJFLG/PEXIST/MBCFLG/RGSENS/
PROTYP/AUTOADJ/FSDCYC/S,N,NR3OFFST/INREL/
S,N,TADJCOL/SEID/S,N,ACTFREQ/S,N,FREQ1/
S,N,DLOAD1/FREQ345/DISCYC/FRM $
RSP1CT Table of the count of type 1 responses per response type per subcase in R1TAB.
Output by DOPR3.
R1TAB Table of first level (DRESP1 Bulk Data entry) attributes.
RESP12 Table of second level responses.
OBJTAB Design objective table for a given analysis type and superelement. Objective
attributes with retained response identification number.
CONTAB Table of constraint attributes.
BLAMA Buckling eigenvalue summary table.
CLAMA Complex eigenvalue summary table.
Main Index
DSAD
Processes tables related to design sensitivity response evaluation
796
LAMA Normal modes eigenvalue summary table.
DIVTAB Table of aerostatic divergence data for all subcases.
AUXTAB Table of aerodynamic extra point identification numbers, displacements, labels,
type, status, position and hinge moments for all subcases.
STBTAB Table of aerostatic stability derivatives for all subcases.
FLUTAB Flutter summary table for all subcases.
OUG1DS Table of displacements in SORT1 format for design responses.
OES1DS Table of element stresses in SORT1 format for design responses.
OSTR1DS Table of element strains in SORT1 format for design responses.
OEF1DS Table of element forces, excluding non-composite elements, in SORT1 format
for design responses.
OEFITDS Table of composite element failure indices for design responses.
OES1CDS Table of composite element stresses in SORT1 format for design responses.
OSTR1CDS Table of composite element strains in SORT1 format for design responses.
OQG1DS Table of single point forces-of-constraint in SORT1 format for design
responses.
DSCREN Table of constants from the DSCREEN Bulk Data entry.
XINIT Matrix of initial values of the design variables.
TABDEQ Table of unique design variable identification numbers.
COORDN Matrix of initial or final designed coordinate values.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ.
FRL Frequency response list.
FRQRSP Table of the count of type 1 frequency/time responses per response type per
frequency or time step.
CASEDS Case Control table for the data recovery of design responses.
UGX Matrix of analysis model displacements in g-set or p-set.
OPTPRM Table of optimization parameters.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
PROPI* Family of matrices of initial property values.
BGPDT Basic grid point definition table.
DNODEL Table of designed and non-designed locations
WGTM Table of 6x6 rigid body mass matrix.
ONRGYDS Table of element strain energies in SORT1 format for design responses.
Main Index
797 DSAD
Processes tables related to design sensitivity response evaluation
GLBTABDS Global results correlation table.
GLBRSPDS Global results matrix.
RESP3 Table of third level responses.
RMSTAB Table of RMS responses.
RMSVAL Matrix of initial RMS values.
UPF Displacement matrix in p-set for frequency response.
QPF Single-point forces of constraint matrix in the p-set for frequency response.
QMPF Multipoint forces of constraint matrix in the p-set for frequency response.
UHF Modal displacement matrix in p-set for frequency response.
OUGD1M Table of displacements in SORT1 format for design responses and appended for
all normal modes solutions.
OESD1M Table of element stresses in SORT1 format for design responses and appended
for all normal modes solutions.
OSTRD1M Table of element strains in SORT1 format for design responses and appended
for all normal modes solutions.
OEFD1M Table of element forces in SORT1 format for design responses and appended
for all normal modes solutions.
MODRSP Table of eigenvector response counts by subcase and mode.
CASEDM Case Control table for the recovery of design responses for normal modes.
PHG Normal modes eigenvector matrix in the g-set.
OGPFB1DS Table of grid point forces for design responses.
OELOP1DS Table of element-oriented forces for design responses.
ONRGD1M Table of element strain energies for design responses and appended for all
normal modes solutions.
UPSDT Table of transfer function data needed for RMS calculations.
RQATAB Table of Rayleigh Quotient Approximation.
RESP12X Table of second level (synthetic) responses from than one superelement.
RESP3X Table of third level responses from more than one superelement.
EPSSE Table of epsilon and external work
ESRT Table of composite ply strength ratios
OES1AB Table of screen element stresses for arbitrary beam cross sections.
Main Index
DSAD
Processes tables related to design sensitivity response evaluation
798
Output Data Blocks:
R1VAL Matrix of initial values of the retained first level responses.
R2VAL Matrix of initial values of the retained second level responses.
RSP12R Table of retained second level responses in RESP12.
R2VALR Matrix of retained second level responses.
CVAL Matrix of constraint values.
CVALR Matrix of retained constraint values.
OBJTBR Table of design objective attributes with retained response identification
number.
CNTABR Table of retained constraint attributes.
R1TABR Table of retained first level (DRESP1 Bulk Data entry) attributes.
R1VALR Matrix of retained type one responses.
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step.
UGX1 Copy of UGX matrix with null columns in place of the deleted responses.
AUG1 Displacement matrix in g-set for aerostatic analysis.
R1MAPR Table of mapping from original first level retained responses.
R2MAPR Table of mapping from original second level retained responses.
CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcases.
CASDSX Case Control table with unneeded analysis subcase deleted.
DRDUG Matrix of adjoint loads for the g-set.
DRDUTB Table of adjoint load attributes.
CASADJ Case Control table associated with adjoint method.
LCDVEC Partitioning vector for load case deletion. The row size is the same number of
columns in UGX and ones for columns which are retained in UGX1. LCDVEC
is intended for partitioning of analysis results related to inertia relief and
SPCforces.
RR2IDR Table of retained referenced type two response identification list.
R3VAL Matrix of initial values of the retained third level responses.
R3VALR Matrix of initial values of the retained third level responses.
RESP3R Table of retained third level responses in RESP3.
RMSTABR Table of retained RMS responses in RMSTAB.
Main Index
799 DSAD
Processes tables related to design sensitivity response evaluation
Parameters:
RMSVALR Matrix of initial values of the retained RMS responses in RMSVAL.
FRLR Retained frequency response list.
FOLR Retained frequency response frequency output list.
UPFM Merged UPF.
QPFM Merged QPF.
QMPF Merged QMPF.
UHFM Merged UHF.
MODRSPR MODRSP for retained frequencies.
UPSDTR UPSDT for retained frequencies.
RQATABR RQATAB for for retained frequencies.
RESP12XR RESP12X for for retained frequencies.
RESP3XR RESP3X for retained frequencies.
WGTS Input-real-default=0.0. Total weight of analysis model.
VOLS Input-real-default=0.0. Total volume of analysis model.
OBJVAL Output-real-default=0.0. Objective value.
NR1OFFST Input/output-integer-default=0. Counter for retained type 1 responses. The value
is initialized to 1 and is incremented by the number of records in R1TABR.
NR2OFFST Input/output-integer-default=0. Counter for retained type 2 responses. The value
is initialized to 1 and is incremented by the number of records in RSP12R.
NCNOFFST Input/output-integer-default=0. Counter for retained constraints. The value is
initialized to 1 in and is incremented by the number of records in CNTABR.
APP Input-character-default=' '. Analysis type. Allowable values are:
'STATICS' Statics.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
DMRESD Input-integer-default=-1. Design model flag. If set to -1, then the design model is
limited to the residual structure.
SEID Input-integer-default=0. Superelement identification number.
DESITER Input-integer-default=0. Design optimization iteration number.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
Main Index
DSAD
Processes tables related to design sensitivity response evaluation
800
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
ADJFLG Output-integer-default=0. Adjoint sensitivity method flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
PEXIST Input-logical-default=FALSE. p-element existence flag. Set to TRUE if p-elements
are present.
MBCFLG Input-logical-default=FALSE. Multiple boundary condition in static analysis flag.
Set to TRUE if multiple boundary conditions are specified in static analysis.
RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values
AUTOADJ Input-character-no default. Adjoint sensitivity automatic selection flag. If set to
'YES', then adjoint sensitivity will be automatically selected if appropiate. Usually
input via user parameter.
FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this
is a fully stressed design cycle.
NR3OFFST Input/output-integer-default=0. Counter for retained type 3 responses. The value is
initialized to 1 and is incremented by the number of records in RESP3R.
TADJCOL Output-integer-default=0. Accumulated column count for adjoint load vector.
SEID Input-integer-default=0. Superelement identification number.
ACTFREQ Input-integer-default=0. Active frequency processing flag.
FREQ1 Output-integer-default=0. Frequency set identification number in the first
frequency subcase.
DLOAD1 Output-integer-default=0. Dynamic load set identification number in the first
frequency subcase.
FREQ345 Input-logical-default=FALSE. Flag indicating presense of FREQ3, FREQ4, and
FREQ5 Bulk Data entries.
DISCYC Input-logical-default=FALSE. Discrete design cycle flag. TRUE if this is a discrete
design cycle.
FRM Input-real-default=0.0 Fractional mass for designed structure.
Main Index
801 DSAD
Processes tables related to design sensitivity response evaluation
Remarks:
1. DSAD first extracts the response quantities that are defined as type one responses in the design
model. The type two responses are evaluated followed by the objective and any constraints
associated with either response type. The constraints and corresponding responses are screened
and load case deletion is performed.
2. DSAD is intended to be executed for each analysis type and superelement, and therefore many of
the inputs, outputs, and data blocks are qualified by superelement and/or analysis type. See
subDMAP DESCON for an example.
Main Index
DSADJ
Creates sensitivity of grid responses
802
Creates sensitivity of grid responses with respect to design variables based on the combination of adjoint
and analysis solution matrices and element sensitivity data. Applicable in frequency response or static
analysis only.
Format:
Input Data Blocks:
DSADJ
Creates sensitivity of grid responses
DSADJ XDICTDS,XELMDS,BGPDT,CSTM,XDICTX,XELMX,UGX,ADJG,
DRDUTB,DSPT1,VGDM,IMATG,XDICTB,XELMB,UGT0,ADJGT0,
DRUT0/
ADELX,UGT,ADJGT,DRUT/
NOK4GG/WTMASS/XTYPE/CDIF/COUPMASS/SHAPEOPT/
SPDM/ADJMETH/MGEFLAG $
XDICTDS Perturbed element matrix dictionary table.
XELMDS Table of perturbed element matrices.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
XDICTX Baseline element matrix dictionary table or backward perturbed element matrix
dictionary if CDIF='YES'.
XELMX Baseline element matrices or backward perturbed element matrices if
CDIF='YES'.
UGX Matrix of analysis model displacements in g-set or p-set.
ADJG Adjoint sensitivity displacement matrix in the g-set or p-set.
DRDUTB Table of adjoint load attributes.
DSPT1 Design sensitivity processing table.
VGDM Partitioning vector for sparse design model with ones where design response is
required if SPDM=-1. Also, UGX and ADJG must partitioned the ones of this
vector.
IMATG Pesudo identity g-set matrix.
XDICTB Backward perturbed element matrix dictionary if CDIF='YES'.
XELMB Backward perturbed if CDIF='YES'.
UGT0 UGT computed in a prior call to DSADJ and specified on second pass through
DSADJ.
Main Index
803 DSADJ
Creates sensitivity of grid responses
Output Data Blocks:
Parameters:
ADJGT0 ADJGT computed in a prior call to DSADJ and specified on second pass
through DSADJ.
DRUT0 DRUT computed.
ADELX Matrix of adjoint sensitivities.
UGT Transposed regular solution matrix is normally output from an initial pass
through DSADJ.
ADJGT Transposed adjoint solution matrix is normally output from an initial pass
through DSADJ.
DRUT DRDUTB sorted on solutions and is normally output from an initial pass
through DSADJ.
NOK4GG Input-integer-default=-1. Structural damping generation flag.
-1 Do not generate.
0 Generate.
WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.
XTYPE Input-integer-default=0. Type of element matrix data:
0 Stiffness
1 Damping
2 Mass
CDIF Input-character-no default. Finite difference scheme.
'YE
S'
Central
'NO' Forward
COUPMASS Input-integer-default=0. Coupled mass generation flag.
-1 Lumped
0 Coupled
SHAPEOPT Input-integer-default=0. Shape optimization flag. Set to 1 if shape optimization
is activated.
SPDM Input-integer-default=0. Sparse design model flag. If -1, then VGDM must be
supplied.
-1 Yes
0 No
Main Index
DSADJ
Creates sensitivity of grid responses
804
ADJMETH Input-integer-default=0. Triple matrix product method.
0 The program automatically selects the best of ADJMETH=1 or 2.
1 Holds the full g-size solution vector and is recommended if disk space is
limited.
2 Holds only the active solution vectors.
MGEFLAG Input/output-integer-default=0. Multiple structural damping flag. for PSHELL,
PBUSH and PBUSHT property entries.
Main Index
805 DSADX
Delete constraints for DRESP2 and DRESP3 that reference DRESP1
Performs response value computation and constraint deletion for DRESP2 and DRESP3 entries which
reference DRESP1 entries that span superelements and/or subcases.
Format:
Input Data Blocks:
DSADX
Delete constraints for DRESP2 and DRESP3 that reference
DRESP1
DSADX RSP2XM,RESP3XM,CNTABXM,OBJTBM,R1VALRG,R2VALRG,
R3VALRG,DNODEL,XINIT,COORDN,DVPTAB*,PROPI*,OPTPRM,
DSCREN,RR2IDR/
R2VALXE,R3VALXE,CVALXE,RSP2XE,RESP3XE,CNTABXE,
OBTABXE,RR2IDXE/
S,N,NR2OFFST/S,N,NR3OFFST/S,N,NCNOFFST/PROTYP/
S,N,OBJVAL $
RSP2XM Merged RSP2X with unresolved DRESP2 records.
RESP3XM Merged RESP3X with unresolved DRESP3 records.
CNTABXM Merged CNTABX associated with unresolved DRESP2 and DRESP3 records.
OBJTBM Merged OBJTBR associated with unresolved DRESP2 and DRESP3 records.
R1VALRG Matrix of initial values of the retained first level (direct) responses.
R2VALRG Matrix of initial values of the retained second level (synthetic) responses.
R3VALRG Matrix of initial values of the retained third level responses.
DNODEL Table of designed and non-designed locations.
XINIT Matrix of initial values of the design variables.
COORDN Matrix of initial or final designed coordinate values.
DVPTAB* Family of tables of attributes of the designed properties by internal property
identification number order.
PROPI* Family of matrices of initial property values.
OPTPRM Table of optimization parameters.
DSCREN Table of constants from the DSCREEN Bulk Data entry.
RR2IDR Table of retained referenced type two response identification list.
Main Index
DSADX
Delete constraints for DRESP2 and DRESP3 that reference DRESP1
806
Output Data Blocks:
Parameters:
R2VALXE R2VALRG with resolved DRESP2 records.
R3VALXE R3VALRG with resolved DRESP3 records.
CVALXE CVALRG with resolved DRESP2 and DRESP3 records.
RSP2XE RSP2RXM with resolved DRESP2 records.
RESP3XE RESP3XM with resolved DRESP3 records.
CNTABXE CNTABXM with resolved DRESP2 and DRESP3 records.
OBTABXE OBJTABM with resolved DRESP2 and DRESP3 records.
RR2IDXE RR2IDR with resolved DRESP2 and DRESP3 records.
NR2OFFST Input/output-integer-no default. Counter for retained type 2 responses. The value is
incremented by the number of records in RSP2XE.
NR3OFFST Input/output-integer-no default. Counter for retained type 3 responses. The value is
incremented by the number of records in RESP3XE.
NCNOFFST Input/output-integer-no default. Counter for retained constraints. The value is
incremented by the number of records in CNTABXE.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 Sum of above values for combinations.
OBJVAL Output-real-default=0. Objective value.
Main Index
807 DSAE
Merges tables to evaluate responses for the perturbed configuration
Merges tables for the two sets of design variables in order to evaluate responses for the perturbed
configuration for each load case and for each design variable.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remarks:
1. TABEV2 is in the ascending alphanumeric EST sort. IVEIDs are assigned to ensure that internal
element identification numbers are unique and in ascending order.
2. For purposes of computational efficiency, the sizing design variables have been split into two sets.
The first set consists of those design variables which affect the stiffness and mass matrices, e.g.,
cross-sectional area of rod, thickness of plate etc. The second set consists of those variables which
may affect the responses, but have no effect on stiffness and mass matrices, e.g., recovery points
in a beam or plate.
3. If central difference is requested then DSAE must be executed for the backward tables. For
example in subDMAP PSLGDV, DSAE is used as follows:
DSAE
Merges tables to evaluate responses for the perturbed
configuration
DSAE
(67'93(67'967$%(937$%(967$%'(4
ESTDV2,TABEV2 $
ESTDVP EST with element property design variable perturbations.
ESTDVS EST with grid design variable perturbations.
TABEVP Cross-reference table between ESTDVP records and element and design
variable identification numbers.
TABEVS Cross reference table between ESTDVS records and element and design
variable identification numbers.
TABDEQ Table of unique design variable identification numbers.
ESTDV2 Merged EST with grid and element property design variable perturbations.
TABEV2 Merged cross reference table of TABEVP and TABEVS.
Main Index
DSAE
Merges tables to evaluate responses for the perturbed configuration
808
DSAE ESTDVP,ESTDVS,TABEVP,TABEVS,TABDEQ/
ESTDV2F,TABEV2 $
IF ( CDIFX='YES' ) DSAE,
ESTDVPB,ESTDVS,TABEVP,TABEVS,TABDEQ/
ESTDV2B,TABEV2 $
Main Index
809 DSAF
Generates tables incorporating effect of retained first level responses
Generates element summary and temperature tables that incorporate the effect of retained first level
responses.
Format:
Input Data Blocks:
DSAF
Generates tables incorporating effect of retained first level
responses
DSAF R1TABR,EST,ESTDV2,TABEV2,ETT,MIDLIS,KELM,KDICT,
PTELEM,KELMDS,KDICTDS,PTELMDSX,ECT,VELEM,VELEMN,
GPECT,BGPDT/
ESTDCN,TABECN,ETTDCN,KELMDCN,KDICTDCN,PTELMDCN,
VELEMDCN,GPECTDCN/
NDVTOT/PESE $
R1TABR Table of retained first level (DRESP1 Bulk Data entry) attributes.
EST Element summary table.
ESTDV2 Merged element summary table with grid and element property design variable
perturbations.
TABEV2 Merged cross reference table of TABEVP and TABEVS.
ETT Element temperature table.
MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs)
and internal baseline MIDs.
KELM Table of element matrices for stiffness, heat conduction, differential stiffness,
or follower stiffness.
KDICT KELM dictionary table.
PTELEM Table of thermal loads in the elemental coordinate system.
KELMDS Table of perturbed element stiffness matrices. If CDIF='YES' then this is the
forward perturbed element matrix dictionary.
KDICTDS Perturbed element stiffness matrix dictionary table. If CDIF='YES' then this is
the forward perturbed element matrix dictionary.
PTELMDSX Table of thermal loads in the elemental coordinate system for the central,
forward, or backward perturbed configuration.
ECT Element connectivity table.
VELEM Table of element lengths, areas, and volumes.
VELEMN Table of element lengths, areas, and volumes for the perturbed configuration.
Main Index
DSAF
Generates tables incorporating effect of retained first level responses
810
Output Data Blocks:
Parameters:
GPECT Grid point element connection table.
BGPDT Basic grid point definition table.
ESTDCN Element summary table which incorporates combined constraints and design
variables.
TABECN Table of relationship between internal identification numbers of constraints in
ESTDCN and elements and responses in R1TABR.
ETTDCN Table of design variable and constraint internal identification numbers for the
effects of temperature.
KELMDCN Table of element matrices for stiffness, heat conduction, differential stiffness,
or follower stiffness which incorporates combined constraints and design
variables.
KDICTDCN KELM dictionary table which incorporates combined constraints and design
variables.
PTELMDCN Table of thermal loads in the elemental coordinate system which incorporates
combined constraints and design variables.
VELEMDCN Table of element lengths, areas, and volumes which incorporates combined
constraints and design variables.
GPECTDCN GPECT, which incorporates combined constraints and design variables.
NDVTOT Input-integer-default=0. Number of unique referenced design variables.
PESE Input-integer-default=0. Element strain energy flag for static analysis.
Main Index
811 DSAH
Generates data blocks required for DSAL module
Generates data blocks required for the DSAL module to compute sensitivities.
Format:
Input Data Blocks:
DSAH
Generates data blocks required for DSAL module
DSAH DRSTBL,R1TABR,CASDSN,TABECN,BLAMA*,LAMA*,OL,DIVTAB,
FRQRPR,VIEWTBDS,CASERS,CSNMB,BUG*,PHG*,GEOM2,GEOM3,
FRQRMF,DFFDNF,CASEFREQ,MODRPR,CASEDM/
DBUG,DPHG,CASEDSF,LBTAB,BDIAG,LFTAB,COGRID,COELEM,
DSEDV,OINTDSF,PELSDSF,DGEOM2,DGEOM3,DNDVPT,MXDFDN,
MXOMEG,UG1PVT,DNVVPT,LVTAB,EGVREC,LVTABI,CASEDMF,
LAMAM,LAMASH,PVSBIT1,PVSBIT2,DGSVPT,DGMVPT/
APP/DMRESD/NDVTOT/ADJFLG/SEID/DSNOKD/S,N,NNDFRQ/
S,N,NNDEGV/DPHFLG/S,N,NNDGS/S,N,NNDGM $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types. Output by DSAD.
R1TABR Table of retained first level (DRESP1 Bulk Data entry) attributes.
CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcases.
TABECN Table of relationship between internal identification numbers of constraints in
ESTDCN and elements and responses in R1TABR.
BLAMA* Family of buckling eigenvalue summary tables.
LAMA* Family of normal modes eigenvalue summary tables.
OL Transient response time output list or frequency response frequency output list.
DIVTAB Table of aerostatic divergence data for all subcases.
FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step.
VIEWTBDS View information table, contains the relationship between each
p-element and its view-elements and view-grids for the perturbed model.
CASERS Case Control table for the residual structure and a given analysis type.
CSNMB Case Control table for a given superelement and all analysis types.
BUG* Family of buckling eigenvector matrices in the g-set.
PHG* Family of normal modes eigenvector matrices in the g-set.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
Main Index
DSAH
Generates data blocks required for DSAL module
812
Output Data Blocks:
GEOM3 Table of Bulk Data entry images related to static loads.
FRQRMF FRQRPR table for frequency response.
DFFDNF Table containing the derivatives of forcing frequencies with respect to natural
frequencies.
CASEFREQ Case Control table for modal or direct frequency response analysis and based
on ANALYSIS=MFREQ or DFREQ.
MODRPR Table indicating the number of retained responses per response type per mode.
CASEDM Case Control table for the recovery of design responses for modes.
DBUG Buckling eigenvector matrix in the g-set associated with designed (active)
eigenvalues.
DPHG Normal modes eigenvector matrix in the g-set associated with designed (active)
eigenvalues.
CASEDSF Case Control table for all load cases and all design variables for the perturbed
configuration.
LBTAB Table of eigenvalues and generalized masses for retained buckling eigenvalue
responses.
BDIAG Diagonal matrix of buckling divided by buckling generalized differential
stiffness matrix.
LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses.
COGRID Correlation table between idcid/gid component for displacement responses.
COELEM Correlation table between idcid/eid/component for element responses.
DSEDV Partitioning vector for retained divergence responses.
OINTDSF p-element output control table for the perturbed configuration.
PELSDSF p-element set table for the perturbed configuration.
DGEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points for the perturbed configuration.
DGEOM3 Table of Bulk Data entry images related to static loads for the perturbed
configuration.
DNDVPT Partitioning vector to obtain the sensitivities of natural frequencies for normal
modes analysis from that of the union set.
MXDFDN Matrix of derivatives of forcing frequencies with respect to natural frequencies.
MXOMEG Matrix (diagonal) of active forcing frequencies in radians.
Main Index
813 DSAH
Generates data blocks required for DSAL module
Parameters:
UG1PVT Partitioning vector to zero out the columns at frequencies without active
response.
DNVVPT Partitioning vector to obtain the sensitivities of natural frequencies for
eigenvector optimization from that of the union set.
LVTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvector responses for all subcases.
EGVREC Table of eigenvector record for sensitivity computation.
LVTABI Table of eigenvalues and generalized masses for retained normal mode
eigenvector responses per subcase.
CASEDMF Case Control for all load-cases for all design variables for the perturbed
configuration for modes.
LAMAM Matrix (diagonal) of eigenvalues for subspace iteration.
LAMAS Matrix (diagonal) of eigenvalue shifts for subspace iteration.
PVSBIT1 Partitioning vector from all modes to subspace iteration modes.
PVSBIT2 Partitioning vector from subspace iteration modes to constrained modes.
DGSVPT Partitioning vector to obtain the sensitivities of generalized stiffness for normal
modes analysis from that of the union set.
DGMVPT Partitioning vector to obtain the sensitivities of generalized mass for normal
modes analysis from that of the union set.
APP Input-character-default=' '. Analysis type. Allowable values are:
'STATICS' Statics
'FREQRESP' Frequency response
'TRANRESP' Transient response
DMRESD Input-integer-default=0. Design model flag. If set to -1, then the design model is
limited to the residual structure.
NDVTOT Input-integer-default=0. Number of unique referenced design variables.
ADJFLG Output-integer-default=-1. Adjoint sensitivity method flag.
0
No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
SEID Input-integer-default=0. Superelement identification number.
Main Index
DSAH
Generates data blocks required for DSAL module
814
DSNOKD Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling
design sensitivity analysis. Usually specified as a user parameter.
NNDFRQ Output-integer-default=0. Number of forcing frequencies which depend upon
natural frequencies.
NNDEGV Output-integer-default=0. Number of new natural frequencies related to
eigenvector sensitivity
DPHFLG Input-integer-default=0. Flag to select Nelsons method or subspace iteration for
eigenvector sensitivites. Usually input via user parameter.
0 Nelsons method
1 Subspace iteration
NNDGS Output-integer-default=0. Number of natural frequencies related to generalized
stiffness.
NNDGM Output-integer-default=0. Number of natural frequencies related to generalized
mass.
Main Index
815 DSAJ
Generates g-set size reduced basis vectors for each design variable
Generates the g-set size reduced basis vectors for each design variable and the corresponding design
variable correlation table.
Format:
Input Data Blocks:
Output Data Blocks:
DSAJ
Generates g-set size reduced basis vectors for each design
variable
DSAJ EDOM,EQEXIN,BGPDT,CSTM,SIL,BASVEC0,CASECC,GEOM4/
DESVEC,DVIDS,CASEP,DESVECP/
LUSET $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
BASVEC0 Auxiliary displacement matrix. Optional user input.
CASECC Table of Case Control command images.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
DESVEC Basis vector matrix which consists of basis vectors generated from DVGRID
Bulk Data entries and from columns of BASVEC0 matrix. Its components are
defined in the basic coordinate system.
DVIDS List of shape variable identification numbers to be used for the boundary
DVGRID option.
CASEP Case Control table with number of basis vectors in the DESVEC as the number
of Case Control records.
DESVECP Basis vector matrix which consists of basis vectors generated from DVGRID
bulk data entries and from columns of basvec matrix its components are
expressed in the global coordinate system.
Main Index
DSAJ
Generates g-set size reduced basis vectors for each design variable
816
Parameter:
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
Main Index
817 DSAL
Generates design sensitivity coefficient matrix
Generates the design sensitivity coefficient matrix; i.e., the sensitivity coefficients for the retained set of
constraints specified in the design model for each design variable.
Format:
Input Data Blocks:
DSAL
Generates design sensitivity coefficient matrix
DSAL DRSTBL,DELWS,DELVS,DELB1,DELF1,
COGRID,COELEM,OUGDSN,OESDSN,OSTRDSN,
OEFDSN,OEFITDSN,OESCDSN,OSTRCDSN,
OQGDSN,ONRGYDSN,OGPFDSN,OELOPDSN,R1VALR,
TABDEQ,OL,DSDIV,DELX,DELS,DELFL,DELCE,
DELGS,DELGM,FRQRPR,DELBSH,DRDUTB,ADELUS,
ADELUF,R1TABR,DRMSVL,MODRPR,OUGDSNM,
OESDSNM,OSTRDSNM,OEFDSNM,ONRGDSNM,ESRTDS,
FRMDS,OES1ABDS, OARPWRDS, OAIGDSN, OUGEXAC, OVGEXAC,
OAPEXAC, R1RATIOR/
DSCM/
NDVTOT/DELTAB/EIGNFREQ/ADJFLG/SEID/
S,N,ADELRS/S,N,ADELRF/ESLOPTX/DESCYCLE/DMRESD $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
DELWS Matrix of delta weight for all design variables.
DELVS Matrix of delta volume for all design variables.
DELB1 Matrix of delta buckling load factor for all design variables.
DELF1 Matrix of delta eigenvalue for all design variables.
COGRID Correlation table between idcid/gid component for displacement responses.
COELEM Correlation table between idcid/eid/component for element responses.
OUGDSN Table of displacements in SORT1 format for design responses for the perturbed
configuration.
OESDSN Table of element stresses in SORT1 format for the perturbed configuration.
OSTRDSN Table of element strains in SORT1 format for the perturbed configuration.
OEFDSN Table of element forces, excluding non-composite elements, in SORT1 format
for the perturbed configuration.
OEFITDSN Table of composite element failure indices for the perturbed configuration.
OESCDSN Table of composite element stresses in SORT1 format for the perturbed
configuration.
Main Index
DSAL
Generates design sensitivity coefficient matrix
818
OSTRCDSN Table of composite element strains in SORT1 format for the perturbed
configuration.
OQGDSN Table of single forces-of-constraint in SORT1 format for design responses for
the perturbed configuration.
ONRGYDSN Table of element strain energies and energy densities in SORT1 format for
design responses for the perturbed configuration.
OGPFDSN Table of grid point forces for the perturbed configuration.
OELOPDSN Table of element forces on adjacent elements.
R1VALR Matrix of retained type one responses.
TABDEQ Table of unique design variable identification numbers.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list.
DSDIV Matrix of delta divergence speed for all design variables.
DELX Matrix of delta trim variable responses for all design variables.
DELS Matrix of delta stability derivative responses for all design variables.
DELFL Matrix of delta flutter responses for all design variables.
DELCE Matrix of delta complex eigenvalue for all design variables.
DELGS Matrix of delta generalized stiffnesses for all design variables.
DELGM Matrix of delta generalized masses for all design variables.
FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step.
DELBSH Matrix of finite difference shape step sizes.
DRDUTB Table of adjoint load attributes.
ADELUS Matrix of adjoint sensitivities for static analysis.
ADELUF matrix of adjoint sensitivities for frequency response.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
DRMSVL Table of the RMS response values with respect to the design variables.
MODRPR Table indicating the number of retained responses per response type per mode.
OUGDSNM Table of eigenvectors for design responses for the perturbed configuration.
OESDSNM Table of element stresses from normal modes analysis for the perturbed
configuration.
OSTRDSNM Table of element strains from normal modes analysis for the perturbed
configuration.
OEFDSNM Table of element forces from normal modes analysis for the perturbed
configuration.
Main Index
819 DSAL
Generates design sensitivity coefficient matrix
Output Data Blocks:
Parameters:
ONRGDSNM Table of element strain energies from normal modes analysis for the perturbed
configuration.
ESRTDS Stress ratio for composites for perturbed configuration (statics only).
FRMDS Sensitivity matrix for fractional mass configuration (statics only).
OES1ABDS Table of screened element stresses for arbitrary beam cross sections for the
perturbed configuration.
OARPWRDS Acoustic Power to interior or near field.
OAIGDSN Acoustic Intensity to wetted structural grid.
OUGEXAC Exterior Acoustic pressure/intensity of AFPM.
OVGEXAC Exterior Acoustic velocity of AFPM.
OAPEXAC Exterior Acoustic Power of AFPM.
R1RATIOR Ratio on responses used in ESL.
DSCM Design sensitivity coefficient matrix.
NDVTOT Input-integer-no default. Number of unique referenced design variables.
DELTAB Input-real-no default. Relative finite difference move parameter as specified on
the DOPTPRM Bulk Data entry and stored in the OPTPRM data block.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
ADJFLG Input-integer-default=0. Adjoint sensitivity method flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
SEID Input-integer-default=0. Superelement identification number.
ADELRS Output-integer-default=0. Counter for adjoint responses in static analysis.
ADELRF Output-integer-default=0. Counter for adjoint responses in frequency response
analysis.
ESLOPTX Input-integer, default=0, 0=no ESL, >0 = ES2
Main Index
DSAL
Generates design sensitivity coefficient matrix
820
Remark:
DSAL is intended to be executed for each analysis type and superelement and hence, many of the inputs,
outputs, and data blocks are qualified by superelement and/or analysis type. See subDMAP RESPSEN
for an example.
DESCYCLE Input- integer, default = 0. Current design cycle
DMRESD Input-integer-default=-1 Design model flag. If set to -1, then the design model is
limited to the residual structure.
Main Index
821 DSAM
Creates geometry for backward and forward (or central) perturbation
Creates geometry for the backward and forward (or central) perturbation.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSAM
Creates geometry for backward and forward (or central)
perturbation
DSAM DTOS4,DGTAB,BGPDT/
BGPDVP,BGPDVB/
S,N,SHAPEOPT/CDIF $
DTOS4 Table relating design variable to grid perturbation. Same as DTOS4K except
that the last three words in each entry contains the product of those in DTOS4K
and the shape step size.
DGTAB Table relating DTOS4 records and designed grid data. Correlation table of
internal grid sequence for the baseline and perturbed configuration.
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
BGPDVB Basic grid point definition table for the backward perturbed configuration.
SHAPEOPT Output-integer-default=0. Shape optimization flag. Set to 1 if shape design
variables are defined.
CDIF Input-character-no default. Finite difference scheme.
'YES' Central
'NO' Forward
Main Index
DSAN
Generates design sensitivity processing table
822
Generates design sensitivity processing table and update element temperature table.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
DSAN
Generates design sensitivity processing table
DSAN TABEV2,ETT,EST,MPT/
DSPT1,ETTDV $
TABEV2 Merged cross reference table of TABEVP and TABEVS.
ETT Element temperature table.
EST Element summary table.
MPT Table of Bulk Data entry images related to material properties.
DSPT1 Design sensitivity processing table.
ETTDV Element temperature table where the original element identification numbers
have been converted to new design variable identification numbers.
Main Index
823 DSAP
Computes an inertial or pseudo-load matrix
Computes an inertial or pseudo-load matrix according to the following summation for frequency
response and normal modes:
(4-19)
where:
or for complex eigenvalues:
(4-20)
where:
Format:
Input Data Blocks:
Output Data Block:
DSAP
Computes an inertial or pseudo-load matrix
DSAP MUX,BUX,KUX,OL,DSPT1/
PX/
APP $
MUX Matrix of mass multiplied by displacements or eigenvectors.
BUX Matrix of damping multiplied by displacement or eigenvectors.
KUX Matrix of stiffness multiplied by displacement or eigenvectors.
OL Complex or real eigenvalue summary table, or frequency response frequency
output list.
DSPT1 Design sensitivity processing table. See Remarks.
PX Inertial or pseudo-load matrix.
w
j
2
* MU
x
| | iw
j
+ * BU
x
| | | +
w
j
freq
j
* 2pi =
p
j
2
* MU
x
| | p
j
+ * BU
x
| | K | +
p
j
w
j
r
iw
j
i
+ =
Main Index
DSAP
Computes an inertial or pseudo-load matrix
824
Parameters:
Remarks:
1. The number of rows PX is equal to the number of rows in the input matrices. The number of
columns in PX is also equal to the number of columns in the input matrices unless DSPT1 is
specified, in which case the number of columns is equal to the number of columns in the input
matrices times the design variables defined in DSPT1.
2. If the number of columns in the MUX, BUX, and KUX is less than the number of frequencies in
OL then PX will be truncated accordingly.
3. Any of the inputs may be purged except for OL. If DSPT1 is specified then APP can only be equal
to 'FREQ' and the summation is repeated for each design variable and the result is called pseudo-
loads. Also, the result is the negative of the equation above.
4. The input matrices can have any number of rows. For example, the number of rows could relate
to a degree-of-freedom set.
APP Input-character-no default. Analysis type. Allowable values:
'FREQ' Frequency response
'CEIG' Complex eigenvalue
'REIG' Normal modes
Main Index
825 DSAPRT
Prints the normalized design sensitivity coefficient matrix
Prints the normalized design sensitivity coefficient matrix according to the DSAPRT Case Control
command request.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
DSAPRT
Prints the normalized design sensitivity coefficient matrix
DSAPRT CASECC,DESTAB,DSCMCOL,DSCM2,R1VALRG,R2VALRG,R3VALRG,
DSIDLBL,XINIT//
DSZERO/EIGNFREQ/XYUNIT/DESCYCLE $
CASECC Table of Case Control command images.
DESTAB Table of design variable attributes.
DSCMCOL Correlation table for normalized design sensitivity coefficient matrix.
DSCM2 Normalized design sensitivity coefficient matrix.
R1VALRG Matrix of initial values of the retained first level (direct) responses.
R2VALRG Matrix of initial values of the retained second level (synthetic) responses.
R3VALRG Matrix of initial values of the retained third level responses.
DSIDLBL Table of design response labels.
XINIT Matrix of initial values of the design variables.
DSZERO Input-real-default=0.0. Design sensitivity coefficient print threshold. If the
absolute value of the coefficient is greater than DSZERO then the coefficient will
be printed.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time)
2 Frequency (cycle/time)
XYUNIT Input-integer-default=0. Fortran unit number to which the DOM12 module writes
design optimization x-y plot data.
DESCYCLE Input-integer-default=0. Design cycle analysis counter.
Main Index
DSAR
Extracts and truncates data from the transient solution matrix
826
Extracts and truncates the displacement, velocity, acceleration, and dynamic loads from the transient
solution matrix into separate matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSAR
Extracts and truncates data from the transient solution matrix
DSAR UXT,TOL,TOL1,PXT/
UDISP,UVELO,UACCE,UXT1,PXT1/
EXTRPL/NDEL/SORTP $
UXT Solution matrix from transient response analysis.
TOL Transient response time output list consistent with columns in UXT and PXT.
TOL1 Reduced transient response time output list. Subset of time steps in TOL and
consistent with columns in outputs.
PXT Transient load matrix in the h-set (modal) or d-set for time steps in TOL.
UDISP Reduced displacement solution matrix from transient response analysis.
UVELO Reduced velocity solution matrix from transient response analysis.
UACCE Reduced acceleration solution matrix from transient response analysis.
UXT1 Reduced solution matrix from transient response analysis.
PXT1 Reduced transient response load matrix in the h-set (modal) or d-set.
EXTRPL Input-integer-default=1. Extra solution column flag. An extra column is or is not
appended to UDISP, UVELO, and UACCE accordingly:
0 Not appended.
1 From the last time step.
2 By extrapolation.
NDEL Input-integer-default=3. If NDEL is -1, an unneeded load vector is deleted for the
final time step for each design variable.
SORTP Input-integer-default=1. Transpose flag for UXT, UDISP, UVELO, UACCE, and
UXT1.
Main Index
827 DSAR
Extracts and truncates data from the transient solution matrix
Remarks:
1. PXT, UDISP, UVELO, UACCE, UXT1 and PXT1 may be purged.
2. If no truncation is desired then specify TOL for TOL1. For example,
DSAR UXT,TOL,TOL,/
UDISP,UVELO,UACCE,,/0 $
3. UXT and PXT can have any number of rows. For example, the number of rows could relate to a
degree-of-freedom set.
4. All outputs have columns which are consistent with time steps in TOL1.
1 Columns correspond to time steps.
2 Rows correspond to time steps.
Main Index
DSARLP
Calculates pseudo-displacements for calculating sensitivities of stability derivatives
828
Calculates the pseudo-displacements used in calculating the sensitivities of stability derivatives and
determines the parameters required for all of the static aeroelastic sensitivity analyses.
Format:
Input Data Blocks:
Output Data Blocks:
DSARLP
Calculates pseudo-displacements for calculating sensitivities of
stability derivatives
DSARLP DRSTBL,R1TABR,AECTRL,CASECC,EDT/
CASEA,UXU,UXR/
S,N,STFLG/S,N,TFLG/S,N,SDFLG/S,N,NSKIP/
S,N,LPFLG/S,N,MACH/S,N,Q/S,N,AEQRATIO $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
AECTRL Table of aerodynamic model's control definition.
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.
CASEA A single record (subcase) of CASECC for aerodynamic analysis.
UXU Matrix of aerodynamic extra point vectors for use in calculating the sensitivity
of unrestrained stability derivatives.
UXR Matrix of aerodynamic extra point vectors for use in calculating the sensitivity
of restrained stability derivatives.
Main Index
829 DSARLP
Calculates pseudo-displacements for calculating sensitivities of stability derivatives
Parameters:
Remark:
DSARLP performs a function for static aeroelastic sensitivity analysis that is similar to the AELOOP
module for static aeroelastic analysis.
STFLG Output-integer-no default. Flag to indicate whether the current subcase has
active static response (DISP, STRAIN,STRESS, FORCE, CSTRAIN,
CSTRESS, or CFORCE on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
TFLG Output-integer-no default. Flag to indicate whether the current subcase has
active trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
SDFLG Output-integer-no default. Flag to indicate whether the current subcase has
active stability derivative response (STABDER on the DRESP1 Bulk Data
entry). 0 indicates no response, 1 indicates an active response.
NSKIP Input/output-integer-no default. Trim subcase counter.
LPFLG Input/output-integer-default=0. Flag to indicate whether there is another Case
Control record to process. Set to -1 for the last subcase and Mach number.
MACH Output-real-no default. Mach number.
Q Output-real-no default. Dynamic pressure.
AEQRATIO Output-real-no default. Aeroelastic feedback dynamic pressure ratio.
Main Index
DSARME
Computes RMS values
830
Computes the RMS values for random response analysis in design sensitivity.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remarks:
None.
DSARME
Computes RMS values
DSARME UPDST,RMSTAB,CFSAB/
RMSVAL $
UPDST Table of transfer function data needed for RMS calculations.
RMSTAB Table of RMS responses.
CFSAB Matrix of spectral densities -- weighting factors for RMS calculations.
RMSVAL Matrix of initial RMS values.
Main Index
831 DSARSN
Calculates delta response values for trim variables and stability derivatives
Calculates and stores the delta response values for trim variables and stability derivatives.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSARSN
Calculates delta response values for trim variables and stability
derivatives
DSARSN CASEA,R1TABR,AECTRL,DUX,TR,AERO,DSTABU,DSTABR/
DELX1,DELS1/
TFLG/SDFLG/Q $
CASEA A single record (subcase) of CASECC for aerodynamic analysis.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
AECTRL Table of aerodynamic model's control definition.
DUX Matrix of aerodynamic extra point displacements for the perturbed
configuration.
TR Matrix to transform forces from the support point to the aerodynamic reference
point.
AERO Table of control information for aerodynamic analysis.
DSTABU Matrix of unrestrained perturbed dimensional stability derivatives.
DSTABR Matrix of restrained perturbed dimensional stability derivatives.
DELX1 Matrix of delta trim variable responses for all design variables for a single trim
subcase.
DELS1 Matrix of delta stability derivative responses for all design variables for a single
trim subcase.
TFLG Input-integer-no default. Flag to indicate whether the current subcase has active
trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
Main Index
DSARSN
Calculates delta response values for trim variables and stability derivatives
832
Remarks:
1. DSARSN is called inside a loop for static aeroelastic sensitivity analysis whenever TFLG or
SDFLG is greater than zero. See subDMAP SAERSENS for an example.
SDFLG Input-integer-no default. Flag to indicate whether the current subcase has active
stability derivative response (STABDER on the DRESP1 Bulk Data entry). 0
indicates no response, 1 indicates an active response.
Q Input-real-no default. Dynamic pressure.
Main Index
833 DSAW
Calculates delta-weight and/or delta-volume for each design variable
Calculates the delta-weight and/or delta-volume for each design variable.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
DSAW
Calculates delta-weight and/or delta-volume for each design
variable
DSAW DRSTBL,TABEV2,VELEM,VELEMN,R1TABR,DESTAB/
DELVS,WTCRID,WTDSCP,FRMDS/
CFDFLG $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
TABEV2 Merged cross reference table of TABEVP and TABEVS.
VELEM Table of element lengths, areas, and volumes.
VELEMN Table of element lengths, areas, and volumes for the perturbed configuration.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
DESTAB Table of design variable attributes.
DELVS Matrix of delta volume for all design variables.
WTCRID Table of retained weight responses with column and row numbers in rigid mass
matrix.
WTDSCP Partitioning vector for weight.
FRMDS Sensitivity matrix for fractional mass configuration (statics only).
CFDFLG Input-integer-default=0. Central finite difference flag. 1 means forward and -1
backward.
Main Index
DSDVRG
Computes weighting factors to calculate retained divergence response sensitivities
834
Computes the weighting factors required in the calculation of the retained divergence response
sensitivities.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
DSDVRG
Computes weighting factors to calculate retained divergence
response sensitivities
DSDVRG DSEDV,DIVTAB,PHIDRLR,PHIDLLR,QLLX/
DELDV $
DSEDV Partitioning vector for retained divergence responses.
DIVTAB Table of aerostatic divergence data for all subcases.
PHIDRL Retained right divergence eigenvector responses.
PHIDLL Retained left divergence eigenvector responses.
QLL Aerodynamic matrix for divergence analysis.
DELDV Matrix of divergence sensitivity.
Main Index
835 DSFLTE
Calculates right and left eigenvectors for a given eigenvalue
Calculates the right and left eigenvectors for a given eigenvalue that has been extracted in a flutter
analysis and has been flagged for sensitivity analysis. Selected complex scalar quantities required for
flutter sensitivity analysis are also computed.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSFLTE
Calculates right and left eigenvectors for a given eigenvalue
DSFLTE KHH,BHH,MHH,QHHL,FLUTAB,R1TABR,CASECC,CPHP,LCPHP/
CPHFL,CPHFR,VTQU/FCSENS $
KHH Generalized (modal) stiffness matrix.
BHH Generalized (modal) damping matrix.
MHH Generalized (modal) mass matrix.
QHHL Aerodynamic matrix list.
FLUTAB Flutter summary table for all subcases.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
CASECC Table of Case Control command images.
CPHP Complex eigenvector matrix in the p-set.
LCPHP Left-handed complex eigenvector matrix in the p-set.
CPHFL Left flutter eigenvector -- h-set.
CPHFR Right flutter eigenvector -- h-set.
VTQU Table of flutter sensitivity data.
FCSENS Input-integer-default=1. Flutter/complex eigenvalue sensitivity flag.
1 Flutter sensitivity.
2 Complex eigenvalue sensitivity.
Main Index
DSFLTE
Calculates right and left eigenvectors for a given eigenvalue
836
Remark:
The calculations in DSFLTE closely follow those used in module FA1 to perform the p-k method of
flutter analysis.
Main Index
837 DSFLTF
Calculates sensitivity of active flutter responses
Calculates the sensitivity of active flutter responses.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
DSFLTF
Calculates sensitivity of active flutter responses
DSFLTF VTQU,CDELK,CDELB,CDELM/DELFL/FCSENS $
CDELK Triple matrix product for flutter stiffness sensitivity.
CDELB Triple matrix product for flutter damping sensitivity.
CDELM Triple matrix product for flutter mass sensitivity.
VTQU Table of flutter sensitivity data.
DELFL Matrix of delta flutter responses for all design variables.
FCSENS Input-integer-default=1. Flutter/complex eigenvalue sensitivity flag.
1 Flutter sensitivity.
2 Complex eigenvalue sensitivity.
Main Index
DSGRDM
Produces grid list of design model
838
Preprocesses the design entries in EDOM to produce a list of grids associated with the designed elements
and design responses.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSGRDM
Produces grid list of design model
DSGRDM EDOM,EPT,GEOM2,MPT,GEOM1/
DSGRID/
S,N,AUTOSE/S,N,NUMDIV/S,N,DRATIO $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EPT Table of Bulk Data entry images related to element properties.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points
MPT Table of Bulk Data entry images related to material properties.
GEOM1 Table of Bulk Data entry images related to geometry.
DSGRID Table of identification numbers for those grid points in the design model
automatic superelement optimization feature.
AUTOSE Output-character-default=none. Automatic superelement optimization flag.
Values are 'YES' or 'NO' as specifed on DOPTPTM Bulk Data entry.
NUMDIV Output-integer-default=0. Number of domains assigned to the part of the model
which will not be designed as specifed on DOPTPTM Bulk Data entry.
DRATIO Output-real-default=0.0. Design grid ratio as specified on the DOPTPTM Bulk
Data entry.
Main Index
839 DSMA
Generates combined design sensitivity/constraint matrix
Generates the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity
Analysis only.
Format:
Format for statics:
Format for normal modes or buckling:
Input Data Blocks:
Output Data Blocks:
DSMA
Generates combined design sensitivity/constraint matrix
DSMA DSPT2,OUG1DS,OES1DS,OEF1DS,OES1CDS,OEFITDS/
DSCMR,UNUSED2/
APP $
DSMA DSPT2,OUG1DS,OES1DS,OEF1DS,OES1CDS,OEFITDS/
DSCMR,/
'STATICS' $
DSMA DSPT2,DSEGM,,,,/
DSCMR,/
MODES (or BUCKL) $
DSPT2 Old design sensitivity processor table two.
DSEGM Old design sensitivity eigenvalue gradient matrix.
OUG1DS Table of displacements in SORT1 format for design responses.
OES1DS Table of element stresses in SORT1 format for design responses.
OEF1DS Table of element forces in SORT1 format for design responses.
OES1CDS Table of composite element stresses in SORT1 format for design responses.
OEFITDS Table of composite element failure indices for design responses.
DSCMR Old combined design sensitivity/constraint matrix.
UNUSED2 Unused and may be purged.
Main Index
DSMA
Generates combined design sensitivity/constraint matrix
840
Parameters:
Remarks:
1. DSMA is applicable only to old sensitivity analysis.
2. DSPT2 may not be purged.
3. DSEGM must be present for normal modes or buckling.
4. OUG1DS, OES1DS, and OEF1DS are required only if selected by DSPT2 entries.
APP Input-character-default='STATICS'. Analysis type.
Allowable values are:
'STATICS' Statics
'BUCKL' Buckling
'MODES' Normal modes
Main Index
841 DSPRM
Sets design sensitivity parameters
Sets design sensitivity parameters based on retained responses for DMAP flow control.
Format:
Input Data Block:
Output Data Blocks:
None.
Parameters:
DSPRM
Sets design sensitivity parameters
DSPRM DRSTBL//
S,N,WGTVOL/S,N,DOBUCK/S,N,DOMODES/S,N,DOSTAT/
S,N,FAILI/S,N,CSTRES/S,N,CSTRN/S,N,DOFREQ/
S,N,DOCEIG/S,N,DOMTRAN/S,N,DODIVG/S,N,DOSAERO/
S,N,DOFLUT/S,N,DOANALY/S,N,DOSASTAT/ADJFLGG/
S,N,DOFSPCF/S,N,DOTSPCF/S,N,DOWGHT/S,N,DOESE/
S,N,DOSSPCF/S,N,DORMS/S,N,DOEIGV/S,N,DOGPF/
S,N,DOELOP/S,N,DOSTCOMP/S,N,DOFRMASS/
S,N,DOCSTRAT $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
WGTVOL Output-integer-default=0. Weight/volume retained response flag. Set to >0 if any
retained response.
1 Weight only
2 Volume only
3 Weight And volume
DOBUCK Output-integer-default=0. Buckling constraint flag. Set to >0 if any constraint.
DOMODES Output-integer-default=0. Normal modes constraint flag. Set to >0 if any
constraint.
DOSTAT Output-integer-default=0. Statics constraint flag. Set to >0 if any constraint.
FAILI Output-integer-default=0. Composite failure index constraint flag. Set to >0 if any
constraint.
CSTRES Output-integer-default=0. Composite lamina stress constraint flag. Set to >0 if any
constraint.
Main Index
DSPRM
Sets design sensitivity parameters
842
CSTRN Output-integer-default=0. Composite lamina strain constraint flag. Set to >0 if any
constraint.
DOFREQ Output-integer-default=0. Frequency response retained response flag. Set to >0 if
any retained response.
DOCEIG Output-integer-default=0. Complex eigenvalue response retained response flag. Set
to >0 if any retained response.
DOMTRAN Output-integer-default=0. Transient response retained response flag. Set to >0 if
any retained response.
DODIVG Output-integer-default=0. Divergence analysis retained response flag. Set to >0 if
any retained response.
DOSAERO Output-integer-default=0. Aerostatic trim or stability derivative retained response
flag. Set to >0 if any retained response.
DOFLUT Output-integer-default=0. Flutter analysis retained response flag. Set to >0 if any
retained response.
DOANALY Output-integer-default=0. Any analysis retained response flag. Set to >0 if any
retained response.
DOSASTAT Output-integer-default=0. Statics or aerostatic retained response flag. Set to >0 if
any retained response.
ADJFLG Input-integer-default=0. Adjoint sensitivity flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
DOFSPCF Output-integer-default=0. Frequency response retained SPCforce response flag.
Set to >0 if any retained response.
DOTSPCF Output-integer-default=0. Transient response retained SPCforce response flag. Set
to >0 if any retained response.
DOWGHT Output-integer-default=0. Weight retained response flag. Set to >0 if any retained
response.
DOESE Output-integer-default=0. Static analysis retained element strain energy response
flag. Set to >0 if any retained response.
Main Index
843 DSPRM
Sets design sensitivity parameters
Remark:
RSP1CT may be specified as input to DSPRM.
DOSSPCF Output-integer-default=0. Static analysis retained SPCforce response flag. Set to >0
if any retained response.
DORMS Output-integer-default=0. RMS response retained response flag. Set to >0 if any
retained response.
DOEIGV Output-integer-default=0. Set to >0 if any eigenvector constraints.
DOGPF Output-integer-default=0. Set to >0 if any grid point force responses.
DOELOP Output-integer-default=0. Set to >0 if any element oriented force responses.
DOSTCOMP Output-integer-default=0. Static compliance flag. Set to >0 if any static
compliance.
DOFRMASS Output-integer-default=0. Fractional mass flag. Set to >0 if any fractional mass.
DOCSTRAT Output-integer-default=0. Composite stress ratio flag. Set to >0 if any composite
stress ratio.
Main Index
DSTA
Creates tables for Old Design Sensitivity Analysis only
844
Creates tables related to the design perturbation in Old Design Sensitivity Analysis only.
Format:
Input Data Blocks:
Output Data Blocks:
DSTA
Creates tables for Old Design Sensitivity Analysis only
DSTA ECT,EPT,EST,CASECC,EDOM, ,CASECCX,ETT,
DIT,MPT/
ESTDVP,ESTDCN,CASEDS,ETTDCN,DSPT1,DSPT2,
DSROWL,DSCOLL,ETTDV,MPTC,EPTC/
APP/S,N,NOPRT/S,N,NOSAVE/S,N,NOFORT/NEIG $
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
EST Element summary table.
CASECC Table of Case Control command images. of static loads.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
UG Displacement matrix in g-set from static analysis.
LAMA Normal modes eigenvalue summary table.
BLAMA Buckling eigenvalue summary table.
CASECCX Table of Case Control command images used to generate static loads.
ETT Element temperature table.
DIT Table of TABLEij Bulk Data entry images.
MPT Table of Bulk Data entry images related to material properties.
ESTDVP EST with element property design variable perturbations.
ESTDCN Element summary table which incorporates combined constraints and design
variables.
CASEDS Case control table for the data recovery of design responses.
DSESM Design sensitivity eigenvector selection matrix -- Boolean operator to select
eigenvectors which are referenced by constraints (buckling and normal modes
only).
UG
LAMA
BLAMA
)
`
Main Index
845 DSTA
Creates tables for Old Design Sensitivity Analysis only
Parameters:
Remarks:
1. ETT, ETTDV, and ETTDC may be purged if no element temperature data exists.
2. DSTA generates the tables necessary to drive other modules that calculate design sensitivity data.
These modules include EMG, SSG1, DSVG1, DSVG2, DSVG3, SDR2, DSMAS and
LMATPRT.
ETTDCN Table of design variable and constraint internal identification numbers for the
effects of temperature.
DSPT1 Design sensitivity processing table.
DSPT2 Old Design sensitivity processor table two.
DSROWL Table of design sensitivity row labels for design sensitivity matrix, DSCMR.
DSCOLL Table of design sensitivity column labels for design sensitivity matrix,
DSCMR.
ETTDV Element temperature table where the original element identification numbers
have been converted to new design variable identification numbers.
MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2 records.
EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL
records.
APP Input-character-default='STATICS'. Analysis type.
Allowable values are:
'STATICS' Statics
'BUCKL' Buckling
'MODES' Normal modes
NOPRT Output-integer-default=0. Print flag. Set to 1 if PRINT is requested on the
SENSITY Case Control command.
NOSAVE Output-integer-default=-1. Data base store flag. Set to 0 if SAVE is requested on
the SENSITY Case Control command.
NOFORT Output-integer-default=-1. OUTPUT4 flag. Set to 0 if FORT is requested on the
SENSITY Case Control command.
NEIG Input-integer-default=0. Number of eigenvalues to keep.
0 Keep all eigenvalues.
>0 Keep first NEIG-th eigenvalues.
Main Index
DSTAP2
Creates correlation table for normalized design sensitivity coefficient matrix
846
Creates a correlation table for the normalized design sensitivity coefficient matrix.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
DSTAP2
Creates correlation table for normalized design sensitivity
coefficient matrix
DSTAP2 R1TABRG,RSP2RG,RSP3RG/
DSCMCOL,DSIDLBL,RQA/
S,N,NORQA/S,N,IFRMAS $
R1TABRG Table of attributes of the retained first level (direct) responses.
RSP2RG Table of attributes of the retained second level (synthetic) responses.
RSP3RG Table of attributes of the retained third level responses.
DSCMCOL Correlation table for normalized design sensitivity coefficient matrix.
DSIDLBL Table of design response labels.
RQA Matrix of spawned generalized stiffness and mass indices.
NORQA Output-logical-default=FALSE. Presense flag for RQA data block.
IFRMAS Output-integer-default=0. Fractional mass response type.
Main Index
847 DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis
Creates pseudo loads or scalar terms required in the sensitivity analysis.
Format:
Input Data Blocks:
DSVG1
Creates pseudo loads or scalar terms required in sensitivity
analysis
DSVG1
XDICTDS,XELMDS,BGPDT,SIL,CSTM,XDICT,XELM, ,VG,
LFTAB,DSPT1,VGDM,XDICTB,XELMB/
EGX/
NOK4GG/WTMASS/IAPP/DSVGSF/NOPSLG/COUPMASS/CDIF/
SPDM/SHAPEOPT/MGEFLAG $
XDICTDS Perturbed element matrix dictionary table. If CDIF='YES' then this is the
forward or backward perturbed element matrix dictionary.
XELMDS Table of perturbed element matrices. If CDIF='YES' then this is the forward or
backward perturbed element matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
XDICT Baseline element matrix dictionary table.
XELM Baseline element matrices.
UGX Displacement matrix in g-set. For transient response analysis, UGX could also
represent velocity or acceleration.
AGX Gravity/thermal load matrix due to volumetric changes for the central, forward,
or backward perturbed configuration.
VG Left-handed displacement matrix in g-set. Divergence and flutter analysis only.
LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses.
DSPT1 Design sensitivity processing table.
VGDM Partitioning vector for sparse design model with ones where design response is
required if SPDM=-1. Also, UGX and ADJG must partitioned the ones of this
vector.
XDICTB Backward perturbed element matrix dictionary if CDIF=YES.
XELMB Backward perturbed if CDIF=YES.
UGX
AGX
)
`
Main Index
DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis
848
Output Data Blocks:
Parameters:
EGX Pseudo-load (equilibrium variation) matrix in the g-set.
NOK4GG Input-integer-default=-1. Structural damping generation flag.
-1 Do not generate.
0 Generate.
WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.
IAPP Input-integer-default=1. Analysis type. Allowable values are:
1 Statics, aerostatic, frequency, or transient response.
2 Buckling or normal modes.
4 Flutter or divergence.
DSVGF Input-integer-default=0. Specifies scaling of solution vector by eigenvalue.
0 No scaling.
1 Scale.
NOPSLG Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load
generation is requested for the current superelement based on the SEDV Case
Control command.
COUPMASS Input-integer-default=-1. Coupled mass generation flag.
-1 Lumped.
0 Coupled.
CDIF Input-character-default=NO. Finite difference scheme. YES=Central and
Forward=NO.
SPDM Input-integer-default=0.
Sparse design model flag. If -1, then VGDM must be supplied.
-1
Yes.
0
No.
SHAPEOPT Input-integer-default=0. Shape optimization flag. Set to 1 if shape optimization
is activated.
MGEFLAG Input/output-integer-default=0. Multiple structural damping flag. for PSHELL,
PBUSH and PBUSHT property entries. See Remark 3.
Main Index
849 DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis
Remarks:
1. DSVG1 must be executed for mass, stiffness, viscous damping, and structural damping and, if
CDIF='YES', forward and backward perturbed configurations.
2. For transient analysis, DSVG1 must be invoked three times for displacement, velocity, and
acceleration which are obtained from the DSAR module.
3. If , then a null EGX matrix is generated. NOPSLG 0 =
Main Index
DSVG1P
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis
850
Creates pseudo loads or scalar terms required for p-elements in design sensitivity analysis.
Format:
Input Data Blocks:
Output Data Blocks:
DSVG1P
Creates pseudo loads or scalar terms for p-elements in design
sensitivity analysis
DSVG1P ESTDVM,ESTDV2,BGPDVP,CSTM,MPTX,DIT,DEQATN,DEQIND,
UGX,LFTAB,DSPT1,GPSNT,ESTDVB/
EGK,EGM/
COUPMASS/K6ROT/ALTSHAPE/WTMASS/NOPSLG/OPTFLG/
UNUSED7 $
ESTDVM EST with updated material property identification numbers.
ESTDV2 Merged EST with grid and element property design variable perturbations. If
CDIF='YES' then this is the forward perturbation.
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
CSTM Table of coordinate system transformation matrices.
MPTX MPT with design variable perturbations.
DIT Table of TABLEij Bulk Data entry images.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
UGX Matrix of analysis model displacements in g-set or p-set.
DSPT1 Design sensitivity processing table.
LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses.
GPSNT Grid point shell normal table.
ESTDVB Element summary table for the backward perturbed configuration. Required
only if CDIF='YES'.
EGK Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness.
EGM Pseudo-load (equilibrium variation) matrix in the g-set due to mass.
Main Index
851 DSVG1P
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis
Parameters:
Remark:
If , then a null EGX matrix is generated.
COUPMASS Input-integer-default=-1. Coupled mass generation flag.
-1 Lumped.
0 Coupled.
K6ROT Input-real-default=-1.0. Normal rotational stiffness factor for CQUAD4 and
CTRIA3 elements.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element
analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product Space
set.
WTMASS Input-real-default=-1.0. Specifies scale factor on structural mass matrix.
NOPSLG Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load generation
is requested for the current superelement based on the SEDV Case Control
command.
OPTFLG Input-integer-default=0. DSVG1P application method:
1 Statics.
2 Normal modes.
3 Acceleration load.
UNUSED7 Input-integer-default=0. Unused.
NOPSLG 0 =
Main Index
DSVG2
Generates pseudo-load matrix for equilibrium changes in thermal load
852
Generates the pseudo-load matrix which reflects equilibrium changes in the thermal load due to
variations in the design variables.
Format:
Input Data Blocks:
Output Data Block:
DSVG2
Generates pseudo-load matrix for equilibrium changes in thermal
load
DSVG2 BGPDVX,CSTM,SIL,KDICTX,CASDSN,PTELEM,
PTELMDSX, ,DSPT1/
EGTX/
PEXIST/HPFLAG $
BGPDVX Basic grid point definition table for the central, forward, or backward perturbed
configuration.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
KDICTX Baseline element stiffness matrix dictionary table for h-elements or
p-elements.
CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcases.
PTELEM Table of thermal loads in the elemental coordinate system.
PTELMDSX Table of thermal loads in the elemental coordinate system for the central,
forward, or backward perturbed configuration.
UGX Matrix of analysis model displacements in g-set or p-set.
AGX Gravity/thermal load matrix due to volumetric changes for the central, forward,
or backward perturbed configuration.
DSPT1 Design sensitivity processing table.
EGTX Pseudo-load matrix (variation in equilibrium) due to changes in the thermal
load/design variables for the central, forward, or backward perturbed
configuration.
UGX
AGX
)
`
Main Index
853 DSVG2
Generates pseudo-load matrix for equilibrium changes in thermal load
Parameters:
Remark:
CSTM and BGPDT may be purged.
PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.
HPFLAG Input-integer-default=1. Element type processing flag.
1 h-element
2 p-element
Main Index
DSVG3
Combines and appends solution matrices for Old Design Sensitivity Analysis only
854
Combines and appends the solution matrices from the analysis and pseudo-loads due to design variable
changes in Old Design Sensitivity Analysis only.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
DSVG3
Combines and appends solution matrices for Old Design
Sensitivity Analysis only
DSVG3 UG,UGDS/
UGDS1 $
UG Displacement matrix in g-set from the analysis.
UGDS Displacement matrix in g-set due to pseudo-loads.
UGDS1 Displacement matrix in g-set for the total variation.
Main Index
855 DSVGP4
Generates a perturbed multipoint constraint transformation matrix
Generates a perturbed multipoint constraint transformation matrix for rigid element shape sensitivity
analysis.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DSVGP4
Generates a perturbed multipoint constraint transformation matrix
DSVGP4 DGTAB,EQEXIN,GEOM4,RMG,GM,USET,CSTM,BPGDVP,TABDEQ/
DELTGM,DVSLIS/
LUSET/NDVTOT/S,N,RGSENS $
DGTAB Table relating DTOS4 records and designed grid data. Correlation table of
internal grid sequence for the baseline and perturbed configuration.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
RMG Multipoint constraint equation matrix.
GM Multipoint constraint transformation matrix, m-set by n-set.
USET Degree-of-freedom set membership table for g-set.
CSTM Table of coordinate system transformation matrices.
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
TABDEQ Table of unique design variable identification numbers.
DELTGM Multipoint constraint transformation matrix for the perturbed configuration.
DVSLIS List of design variables affected by shape variations.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NDVTOT Input-integer-default=0. Number of unique referenced design variables.
RGSENS Output-logical-default=FALSE. Rigid element sensitivity flag.
Main Index
DSVGP4
Generates a perturbed multipoint constraint transformation matrix
856
Remark:
Assume B is j rows by k columns. Then A must have NSMATS submatrices of size i rows by j columns
(if T=0) and C must have i rows by k columns.
Main Index
857 DSVGP5
Performs multiplication of two matrices
Performs multiplication of two matrices with one matrix having multiple submatrices and, optionally, the
addition of a third matrix to the product. For example, the default (IOPT=0 or T=0) result is:
Format:
Input Data Blocks:
Output Data Block:
Parameters:
DSVGP5
Performs multiplication of two matrices
DSVGP5 A,B,C,DVSLIS/
D/
NSMATS/T/IOPT $
A Matrix with NSMATS number of submatrices.
B Submatrix multiplier.
C Additive matrix to be added to product of A and B. Used only if IOPT=0 or 2.
DVSLIS List of design variables affected by shape variations.
D Matrix product.
NSMATS Input-integer-default=0. Number of submatrices in A.
T Input-integer-default=0. submatrix transpose flag. Applicable only when
IOPT=0.
0 No transpose of (default).
1 Transpose .
IOPT Input-integer-default=0. DSVGP5 method. T is ignored when IOPT>0.
0 (default).
1 .
2 Same as 0 except diagonal is extracted from and stored as a
column in D.
A
1
B A
2
B A
3
B .A
n
B | | C
1
C
2
C
3
.C
n
+
A
i
A
i
A
i
A
i
B C
i
+
B A
i
+
A
i
B C
i
+
Main Index
DSVGP5
Performs multiplication of two matrices
858
Remark:
Assume B is j rows by k columns. Then A must have NSMATS submatrices of size i rows by j columns
(if T=0) and C must have i rows by k columns.
Main Index
859 DTIIN
Input DTI entries to DMAP
Input tables referenced on DTI Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. The input data blocks DTI and DTINDX are output from the preface module IFP.
2. Any output data block may be purged.
Example:
Assume the Bulk Data contains three DTI tables named T1, T2, and T3. The following DMAP instruction
will create the data blocks T1 and T3.
DTIIN DTI,DTINDX/T1,T3,,,,,,,,/S,N,YEST1/S,N,YEST3 $
DTIIN
Input DTI entries to DMAP
DTIIN DTI,DTINDX/DTI1,DTI2,DTI3,DTI4,DTI5,DTI6,DTI7,
DTI8,DTI9,DTI10/PARM1/PARM2/PARM3/PARM4/PARM5/
PARM6/PARM7/PARM8/PARM9/PARM10 $
DTI Collection of tables specified on DTI Bulk Data entries (from IFP).
DTlNDX Index into DTI (from IFP).
DTIi Names that appear on field 2 of the DTI entries (i.e., the DTI table called DTI1)
will be output on data block DTI1.
PARMi Output-logical-default = FALSE. If the i-th output data block is generated then
PARMi=TRUE.
Main Index
DUMMOD1
Provides dummy module for inclusion of user written subroutines and modules
860
Provides dummy module for inclusion of user written subroutines and modules.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DUMMOD1
Provides dummy module for inclusion of user written
subroutines and modules
DUMMOD1 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/
ODB1,ODB2,ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $
IDBi Table or matrix.
ODBi Table or matrix.
IPARMi Input/output-integer-default=-1.
RPARMi Input/output-real-default=-1.0.
CHPARM Input/output-character-default='ABCDEFGH'.
RDPARM Input/output-real double precision-default=-1.D0.
CPARM Input/output-complex-default=(-1.0,-1.0).
CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0).
Main Index
861 DUMMOD2
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DUMMOD2
Provides dummy module for inclusion of user written
subroutines and modules
DUMMOD2 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/ODB1,ODB2,
ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $
IDBi Table or matrix.
ODBi Table or matrix.
IPARMi Input/output-integer-default=-1.
RPARMi Input/output-real-default=-1.0.
CHPARM Input/output-character-default='ABCDEFGH'.
RDPARM Input/output-real double precision-default=-1.D0.
CPARM Input/output-complex-default=(-1.0,-1.0).
CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0).
Main Index
DUMMOD3
Provides dummy module for inclusion of user written subroutines and modules
862
Provides dummy module for inclusion of user written subroutines and modules.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DUMMOD3
Provides dummy module for inclusion of user written
subroutines and modules
DUMMOD3 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/
ODB1,ODB2,ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $
IDBi Table of matrix.
ODBi Table of matrix.
IPARMi Input/output-integer-default=-1.
RPARMi Input/output-real-default=-1.0.
CHPARM Input/output-character-default='ABCDEFGH'.
RDPARM Input/output-real double precision-default=-1.D0.
CPARM Input/output-complex-default=(-1.0,-1.0).
CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0).
Main Index
863 DUMMOD4
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DUMMOD4
Provides dummy module for inclusion of user written
subroutines and modules
DUMMOD4 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/
ODB1,ODB2,ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $
IDBi Table of matrix.
ODBi Table of matrix.
IPARMi Input/output-integer-default=-1.
RPARMi Input/output-real-default=-1.0.
CHPARM Input/output-character-default='ABCDEFGH'.
RDPARM Input/output-real double precision-default=-1.D0.
CPARM Input/output-complex-default=(-1.0,-1.0).
CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0).
Main Index
DVIEWP
Generates view-element and view-grid information for processing p-elements
864
Generates the view-element and view-grid information for processing p-elements in design sensitivity
analysis.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
DVIEWP
Generates view-element and view-grid information for
processing
p-elements
DVIEWP CASECC,OINT,PELSET,ESTDCN,TABECN,BGPDVP,CSTM/
VIEWTBDS/
S,N,VUGNEXT/S,N,VUENEXT/VUGJUMP/VUELJUMP/
VUHEXA/VUPENTA/VUTETRA/VUQUAD4/VUTRIA3/VUBEAM/
S,N,VUEXIST $
CASECC Table of Case Control command images.
OINT p-element output control table. Contains OUTPUT and OUTRCV Bulk Data
entries.
PELSET p-element set table, contains SETS DEFINITIONS.
ESTDCN Element summary table which incorporates combined constraints and design
variables.
TABECN Table of relationship between internal identification numbers of constraints
in ESTDCN and elements and responses in R1TABR.
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
CSTM Table of coordinate system transformation matrices.
VIEWTBDS View information table, contains the relationship between each
p-element and its view-elements and view-grids for the perturbed model.
VUGNEXT Input/output-integer-default=0. Starting identification number for next view-
grid.
VUENEXT Input/output-integer-default=0. Starting identification number for next view-
element.
Main Index
865 DVIEWP
Generates view-element and view-grid information for processing p-elements
VUGJUMP Input-integer-default=1000. Delta between view-grid identification numbers.
VUELJUMP Input-integer-default=1000. Delta between view-element identification
numbers.
VUHEXA Input-character-default='VUHEXA'. Name for VUHEXA element.
VUPENTA Input-character-default='VUPENTA'. Name for VUPENTA element.
VUTETRA Input-character-default='VUTETRA'. Name for VUTETRA element.
VUQUAD4 Input-character-default='VUQUAD4'. Name for VUQUAD4 element.
VUTRIA3 Input-character-default='VUTRIA3'. Name for VUTRIA3 element.
VUBEAM Input-character-default='VUBEAM'. Name for VUBEAM element.
VUEXIST Output-logical-default=FALSE. View-element flag. Set to TRUE if view-
elements exist.
Main Index
DYNCXPNT
Adds acoustic infinite extra points to the DYNAMIC table
866
Automatically generates the extra points for acoustic infinite elements and adds them to the DYNAMIC
table.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remark:
If any of the datablocks GEOM2, EPT and DYNAMIC are purged or do not exist then no action is taken.
DYNCXPNT
Adds acoustic infinite extra points to the DYNAMIC table
DYNCXPNT GEOM2 , EPT , EDT , DYNAMIC /
DYNAMICX, IFEXPNT , VEFS /
S,N,AIXPNT $
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EPT Element property table.
EDT Table of Bulk Data entry images containing ACINFPRM Bulk Data entry.
DYNAMIC Table of Bulk Data Entries related to dynamic.s
DYNAMICX Updated DYNAMIC table.
IFEXPNT Table of infinite element extra points and association with fluid-structure grid points.
VEFS Fluid-structure partitioning vector for the e-set.
AIXPNT Output-logical-default=FALSE. Extra point generation flag. TRUE if extra
points are generated; false otherwise.
Main Index
867 EFFMASS
Computes modal effective mass
Computes the modal effective mass based on the normal modes.
Format:
Input Data Blocks:
Output Data Blocks:
EFFMASS
Computes modal effective mass
EFFMASS CASECC,MAA,PHA,LAMA,USET,BGPDT,UNUSED,CSTM,VGQ/
TEMF,EMM,DMA,MEMF,MPFEM,MEM,MEW/
SEID/WTMASS/S,N,CARDNO/SETNAM/UNUSED $
CASECC Table of Case Control command images.
MAA Mass matrix in a-set or g-set.
PHA Normal modes eigenvector matrix in the a-set or g-set.
LAMA Normal modes eigenvalue summary table.
USET Degree-of-freedom set membership table for g-set.
BGPDT Basic grid point definition table.
UNUSED Unused.
CSTM Table of coordinate system transformation matrices.
VGQ Partitioning vector which is g-set size and contains values of 1.0 at rows
corresponding to degrees-of-freedom in the q-set.
TEMF Total effective mass fraction table.
EMM Effective mass matrix.
MA Rigid body mass matrix for the a-set.
MEMF Modal effective mass fraction table.
MPFEM Modal participation factors for effective mass.
MEM Modal effective mass matrix.
MEW Modal effective weight matrix.
Main Index
EFFMASS
Computes modal effective mass
868
Parameters:
Remarks:
None.
SEID Input-integer-no default. Superelement identification number.
WTMASS Input-real-no default. Scale factor on structural mass matrix. See
Parameter Descriptions (p. 692) in the MSC Nastran Quick Reference Guide.
CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is
incremented by one for each line written to the punch file and is also written
into columns 73-80 of each line.
SETNAM Input-character-default='g'. Degree-of-freedom set name.
UNUSED Input-integer-default=0. Unused.
Main Index
869 ELFDR
Transforms grid point force balance output from GPFDR module
Transforms grid point force balance output (from GPFDR module) from the global coordinate system to
the elemental coordinate systems or to the edges of adjacent elements. Applicable to line and shell
elements only.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ELFDR
Transforms grid point force balance output from GPFDR module
ELFDR OGPFB1,GPECT,CSTM,SIL,GPL,BGPDT/
OELOF1,OELOP1/
NOELOF/NOELOP/UNUSED3 $
OGPFB1 Table of grid point forces in SORT1 format.
GPECT Grid point element connection table.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
GPL External grid/scalar point identification number list.
BGPDT Basic grid point definition table.
OELOF1 Table of element oriented forces connected to common grid points in SORT1
format.
OELOP1 Table of element-oriented forces oriented along adjacent element edge
directions and summations of these components on equivalent edges in
SORT1 format.
NOELOF Input-integer-default=0. OELOF1 generation flag.
<0 Do not generate.
0 Generate.
NOELOP Input-integer-default=0. OELOP1 generation flag.
<0 Do not generate.
0 Generate.
UNUSED3 Input-integer-default=0. Unused.
Main Index
ELTPRT
Prints element summary information
870
.
Prints information on elements.
Format:
Input Data Blocks:
Output Data Block:
ELTPRT
Prints element summary information
ELTPRT ECT,GPECT,BGPDT,NSMEST,EST,CSTM,MPT,DIT,
CASSECC,EPT,UNUSED/
VELEM/
PROUT/S,N,ERROR/WTMASS $
ECT Element connectivity table.
GPECT Grid point element connection table.
BGPDT Basic grid point definition table.
NSMEST NSM Bulk Data entries in EST format.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties for ELSUM
command.
DIT Table of TABLEij Bulk Data entry images for ELSUM command.
CASECC Table of Case Control command images.
EPT Table of Bulk Data entry images related to element properties.
UNUSED Unused and may be purged.
VELEM Table of element lengths, areas, and volumes.
Main Index
871 ELTPRT
Prints element summary information
Parameters:
Remarks:
1. ELTPRT has four output options listed below. The required data blocks are indicated in the table
below.
Option 1: A sorted list of element identification numbers and a list of duplicate element
identification numbers.
Option 2: A list of grid points with the elements that connect to each grid point. Both the element
type and element identification number are listed.
Option 3: Compute and print an element measure (length for 1-D elements; area for 2-D elements;
or volume for 3-D elements and elements of revolution). If a volume can be calculated for 1-D or
2-D elements, then it will also be printed. Create data block with element volumes.
Option 4: Compute and print element mass summary. See ELSUM Case Control command.
2. For Option 1, the output will contain the following items.
Identify all duplicate elements, e.g.,
10 ROD.
**** 10 BAR.
PROUT Input-integer-default = 0. Print control for options 1, 2, and 4 is listed in
Remark 1. This parameter is only meaningful if the input data block ECT is
specified.
For options 1 and 2, if PROUT is set to a positive integer value or to zero
(default), the output will include a list of the element types and the
identification numbers of all elements.
For option 4, if PROUT = 0 or 1, then VELEM is computed and printed. If
PROUT = 2, VELEM is computed but not printed.
ERROR Integer-output-default = 0. If duplicate element identification numbers exist,
ERROR is set to -1. This parameter is only meaningful for Option 1.
WTMASS Input-real-default=1.0. Scale factor on structural mass matrix for Option 4.
Option Data Blocks to Be Included to Activate Output Options
ECT GPECT BGPDT EST CSTM MPT DIT
CASECC
EPT
NSMEST
1
2
3
4
Main Index
ELTPRT
Prints element summary information
872
Identify each element type and the range of element identification numbers for the element type,
e.g.,
THERE ARE 10 ROD ELEMENTS. FIRST ID = 34 LAST ID = 470
Examples:
1. Duplicate element identification numbers are not allowed in the superelement solution sequences.
The following will cause the run to terminate if duplicate identification numbers exist (options 1
and 2).
ELTPRT ECT,,,,//1/S,N,ERROR $
IF (ERROR <0) EXIT $
If no duplicate identification numbers exist, the run will proceed in a normal manner.
2. Print the connection information for each grid point (option 3).
ELTPRT ,,GPECT,BGPDT,,,/ $
3. Print the measure of all elements (option 4).
ELTPRT ,,,BGPDT,,EST,CSTM/ $
Main Index
873 EMA
Assembles global g-set size matrix from elemental matrices
Assembles global g-set size matrix from elemental matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
EMA
Assembles global g-set size matrix from elemental matrices
EMA GPECT,XDICT,XELM,BGPDT,SIL,CSTM,XDICTP,XELMP/
XGG,UNUSED2/
NOK4GG/WTMASS/K4QUAL $
GPECT Grid point element connection table.
XDICT Element matrix dictionary table.
XELM Table of element matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
XDICTP Element matrix dictionary table for p-elements.
XELMP Table of element matrices for p-elements.
XGG Global matrix of g-set size.
UNUSED2 Not used and may be purged.
NOK4GG Input-integer-default=-1. Structural damping generation flag.
-1 Do not generate.
0 Generate; i.e., apply GE (on MATi entry) to stiffness.
WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.
K4QUAL Input-integer-default=' '. Qualifier name for KDICT and KELM when processing
multiple structural damping.
Main Index
EMA
Assembles global g-set size matrix from elemental matrices
874
Method:
The structural damping matrix is assembled from elements with structural damping. Structural
damping is specified in the GE field of the MATi entry.
(4-21)
where:
Remark:
EMA is used to generate stiffness (KGG), mass (MGG), damping (BGG), and structural damping
(K4GG) matrices.
=
number of elements.
=
element structural damping coefficient from MATi entries.
=
element stiffness matrix.
K
gg
4
| |
K
gg
4
| | GE
e
K
e
| |
e 1 =
NE
=
NE
GE
e
K
e
| |
Main Index
875 EMAKFR
Generates stiffness for follower forces
Generates the stiffness for follower forces due to rotational velocity and/or accelerations.
Format:
Input Data Blocks:
Output:
Parameters:
Remarks:
1. Rotational forces are derived from the RFORCE Bulk Data entry.
2. LOADFACR is applied in the following manner to compute the total load:
EMAKFR
Generates stiffness for follower forces
EMAKFR BGPDT,CSTM,SLT,MGG,CSTM0,SCSTM/
KRFGG/
LOADID/LOADIDP/SEID/LOADFACR/SYS66 $
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
SLT Table of static loads.
MGG Mass matrix in g-size.
CSTM0 Table of coordinate system transformation matrices for the residual structure.
SCSTM Table of global transformation matrices for partitioned superelements.
KRFGG Stiffness matrix due to follower rotational forces in g-set.
LOADID Input-integer-no default. Load set identification number for the current
subcase.
LOADIDP Input-integer-default=0. Load set identification number for the previous
subcase.
SEID Input-integer-default=0. Superelement identification number.
LOADFACR Input-real-default=1.0. Load factor in nonlinear static analysis. (Same as
LOADFAC except real).
SYS66 Input-integer-default=255. System cell 66 override for matrix multiply.
P
total
LOADFACR P
LOADID
1.0 LOADFACR ( ) P
LOADIDP
- + - =
Main Index
EMG
Computes elemental matrices
876
Computes elemental matrices for stiffness, differential stiffness, mass, damping, heat conduction, or heat
capacity.
Format:
Input Data Blocks:
EMG
Computes elemental matrices
EMG EST,CSTM,MPT,DIT,UNUSED5,UG,ETT,EDT,DEQATN,DEQIND,
BGPDT,GPSNT,ECTA,EPTA,EHTA,DITID,SLTNL/
S,N,NOKGG/S,N,NOMGG/S,N,NOBGG/S,N,NOK4GG/
S,N,NONLHT/COUPMASS/TEMPSID/DEFRMSID/PENFAC/
NOPNLT/LUMPD/LUMPM/MATCPX/KDGEN/TABS/
SIGMA/K6ROT/LANGLE/NOBKGG/ALTSHAPE/
PEXIST/FREQTYP/FREQVAL/FREQWA/UNSYMF/
S,N,BADMESH/S,N,MGEFLAG/LOADFACR/GNLSTN/FKQRTR $
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
UNUSED5 Unused and may be purged.
UG Displacement matrix in g-set. Required only for differential stiffness
generation.
ETT Element temperature table.
EDT Table of Bulk Data entry images related to element deformation. Required
only for differential stiffness generation.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
BGPDT Basic grid point definition table.
GPSNT Grid point shell normal table.
ECTA Secondary element connectivity table.
EPTA Secondary table of Bulk Data entry images related to element properties.
EHTA Secondary element hierarchical table.
DITID Table of identification numbers in DIT.
SLTNL SLT with follower forces for CQUADR/CTRIAR elements for both the
current and last load step.
Main Index
877 EMG
Computes elemental matrices
Output Data Blocks:
Parameters:
KELM Table of element matrices for stiffness, heat conduction, differential, or
follower stiffness.
KDICT KELM dictionary table.
MELM Table of element mass matrices.
MDICT MELM dictionary table.
BELM Table of element damping or heat capacity matrices.
BDICT BELM dictionary table.
NOKGG Input/output-integer-default=-1. KELM and KDICT generation flag.
Input:
>0 Generate.
-1 Do not generate.
Output:
>0 Generated.
-1 Not generated.
NOMGG Input/output-integer-default=-1. Same as NOKGG except for MELM and MDICT.
NOBGG Input/output-integer-default=-1. Same as NOKGG except for BELM and BDICT.
NOK4GG Input/output-integer-default=1. Structural damping generation flag. Set to -1 if a
nonzero damping constant (GE field on MATi Bulk Data entry) is not found for any
element.
NONLHT Output-integer-default=-1. Nonlinear heat transfer or differential stiffness
generation flag. Set to 1 if nonlinear heat transfer elements are detected.
On input:
>3 Compute geometric nonlinear effects.
<3 Do not compute geometric nonlinear effects.
On output:
-1 If no nonlinear material was found in a heat transfer problem.
1 Otherwise.
COUPMASS Input-integer-default=-1. Coupled mass generation flag.
-1 Lumped.
0 Coupled.
Main Index
EMG
Computes elemental matrices
878
TEMPSID Input-integer-default=-1. Temperature set identification number. Usually obtained
from the TEMPERATURE Case Control command. Required for use in stress
recovery of differential stiffness.
DEFRMID Input-integer-default=-1. Element deformation set identification number. Usually
obtained from the DEFORM Case Control command. Required for use in stress
recovery of differential stiffness.
PENFAC Input-real-default=0.0. Penalty factor for electromagnetic elements.
NOPNLT Input-integer-default=-1. Penalty function flag for electromagnetic elements.
LUMPB Input-real-default=0.0. Lumping factor for electromagnetic damping.
LUMPM Input-real-default=0.0. Lumping factor for electromagnetic mass.
MATCPX Input-integer-default=-1. Complex material properties flag for electromagnetic
elements.
KDGEN Input-integer-default=0. Differential or follower stiffness matrix generation flag.
Usually the column number in UG to use in differential stiffness matrix generation.
If KDGEN is negative then follower stiffness will be generated.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant
heat flux.
K6ROT Input-real-default=0.0. Normal rotational stiffness factor for CQUAD4 and
CTRIA3 elements.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Fimbal angle.
2 Rotation vector.
NOBKGG Input-integer-default=0. Slideline contact stiffness generation flag. Set to 1 to
generate slideline contact stiffness.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full
Product Space set.
PEXIST Input-logical-default=FALSE. p-element flag. Set to TRUE if p-elements are
present and to be processed.
FREQTYP Input-character-default=' '. Frequency dependent element processing mode:
'ESTF' Compute frequency dependent stiffness.
'ESTNF' Compute nominal frequency dependent stiffness.
FREQVAL Input-real-default=0.0. Frequency value for frequency dependent element
generation.
FREQWA Input-real-default=0.0. Parameter for electromagnetic analysis.
Main Index
879 EMG
Computes elemental matrices
Remarks:
1. CSTM may be purged. MPT may be purged only if elements which do not reference any material
data are used. The DIT may be purged only if the material properties are not temperature
dependent.
2. If either of a matrix-dictionary data block pair is purged, that particular data block pair will not be
formed.
3. MGEFLAG is set and reset accordingly:
a. On the first call to EMG, MGEFLAG has the following values and actions:
UNSYMF Input-character-default='NO'. Unsymmetric stiffness generation for slideline
contact stiffness. If set to 'YES' then stiffness matrix will be unsymmetric for
slideline contact.
BADMESH Output-logical-default=FALSE. Bad geometry was detected.
MGEFLAG Input/output-integer-default=0. Multiple structural damping flag. for PSHELL,
PBUSH and PBUSHT property entries. See Remark 3.
LOADFACR Input-real-default=1.0. Load factor in nonlinear static analysis. (Same as
LOADFAC except real).
GNLSTN Input-integer-default=0. Geometric nonlinear strain flag. Usually input by user
parameter.
0 Small strain.
1 Green strain.
FKQRTR Input-logical-default=FALSE. Follower stiffness generation flag. If TRUE,
follower stiffness will be generated. Usually based on user parameter FOLLOWK.
Input/Output Action
0 / 0 Process all elements in standard fashion.
1 / -1 Except for bush elements, process all elements in standard fashion.
For bush elements process normally but place 0.0 for GE in element
KDICT.
2 / -2 Except for shell elements, process all elements in standard fashion.
For shell elements process normally but place 0.0 for GE in element
KDICT.
3 / -3 Both 1 and 2.
Main Index
EMG
Computes elemental matrices
880
b. If MGEFLAG<>0 from the first call to EMG then execute a second call to EMG:
Input/Output Action
-1 / +1 Process only bush elements: each element stiffness is multiplied by its
coresponding GEi and 1.0 is placed for GE in elements KDICT entry.
-2 / +2 Process only shell elements: each element stiffness is multiplied by its
corresponding GEi and 1.0 is placedfor GE in elements KDICT entry.
-3 / +3 Both 1 and 2.
Main Index
881 EQUIVX
Data block name equivalence
Attaches a second name to an existing data block.
Format:
Input Data Block:
Output Data Block:
Parameter:
Remarks:
1. The main purpose of the EQUIVX is to save either storage space or l/O time or both.
2. If DBP and DBS reside on different DBsets and PARAM < 0, then a copy of DBP is made to the
DBset on which DBS resides. The equivalence flag is broken and the data blocks become
separate. These rules apply only if the secondary data block resides on a permanent DBset or DBS
is not referenced on a TYPE DB statement and its DBset is a scratch DBset. Therefore, it is
recommended that DBS is referenced on a TYPE statement and defined in the NDDL sequence
with its location assigned to the scratch DBset.
3. The following tables summarize the relationship between primary and secondary:
EQUIVX
Data block name equivalence
EQUIVX DBP/DBS/PARM $
DBP Primary data block.
DBS Secondary data block.
PARM Input-integer-default = 0. Equivalence flag. See Remark 3.
Status with PARM < 0
DBP prior to EQUIVX DBS prior to EQUIVX DBS after EQUIVX
Generated Any Equivalenced
Purged or Not Generated Any Purged and not equivalenced
Main Index
EQUIVX
Data block name equivalence
882
4. If DBS is also declared on the FILE DBS=APPEND statement then User Warning Message 81
will be issued. If the EQUIVX.../DBS statement is executed only once and is not re-executed in
the DMAP loop, then the message may be safely ignored. However, if the EQUIVX statement is
potentially re-executed then it should be replaced with the DELETE and COPY module.
For example,
FILE ESTNCH=APPEND $
EQUIVX ESTNL/ESTNCH/-1 $
should be replaced with:
FILE ESTNCH=APPEND $
DELETE /ESTNCH,,,, $
COPY ESTNL/ESTNCH $
Examples:
Data blocks A and B reside on the same DBset.
EQUIVX A/B/ALWAYS $
A and B are equivalenced.
EQUIVX A/B/NEVER $
The equivalence is broken, and B is deleted.
Status with PARM > 0
DBP prior to EQUIVX DBS prior to EQUIVX DBS after EQUIVX
Generated Not Equivalenced Unchanged
Generated Equivalenced Purged and Not Generated
Purged or Not Generated Any Unchanged
Main Index
883 ESTINDX
Creates an index, keyed by element identification number
Creates an index, keyed by element identification number, for the EST table.
Format:
Input Data Blocks:
None.
Output Data Blocks:
Parameters:
None.
Remark:
EST must be declared as an append file on the FILE statement.
ESTINDX
Creates an index, keyed by element identification number
ESTINDX /EST $
EST Element summary table.
Main Index
EXPORTLD
Creates an index, keyed by element identification number
884
Exports LOAD vectors requested by EXPORTLD Case Control command.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
EXPORTLD
Exports LOAD vectors requested by EXPORTLD Case Control command
EXPORTLD CASECC,PG,BGPDT/PG*,BGPDT*/NSKIP $
CASECC Table of Case Control command specifications.
PG Static load matrix applied to the g-set.
BGPDT Basic grid point definition table.
PG* Family of PG matrices vectors qualified by LOADID and LOADNAME. One
matrix is created per EXPORTLD request.
BGPDT* Family of BGPDT tables qualified by LOADID and LOADNAME and
associated with PG*.
NSKIP Input-integer-default=1. The record number in CASECC corresponding to
the first subcase of the current boundary condition.
Main Index
885 FA1
Prepares the modal matrices for flutter eigenvalue analysis
Prepares the modal matrices for flutter eigenvalue analysis. Also performs the eigenvalue analysis for the
KE or PK method.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
FA1
Prepares the modal matrices for flutter eigenvalue analysis
FA1 KHH,BHH,MHH,QHHL,CASECC,EDT/
FSAVE,KHH1,BHH1,MHH1,FLUTABP/
S,N,FLOOP/S,N,TSTART/S,N,NOCEAD/LPRINT/XYUNIT/VREF
$
KHH Generalized (modal) stiffness matrix.
BHH Generalized (modal) damping matrix.
MHH Generalized (modal) mass matrix.
QHHL Aerodynamic matrix list.
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
FSAVE Flutter storage save or answer table.
KHH1 Modified generalized (modal) stiffness matrix.
BHH1 Modified generalized (modal) damping matrix.
MHH1 Modified generalized (modal) mass matrix.
FLUTABP
FLOOP Input/output-integer-no default. Flutter eigenvalue analysis loop counter. Set
to zero for initial entry and incremented by one for each loop until the last
loop then set to -1.
TSTART Output-integer-no default. CPU clock time at entry to module.
Main Index
FA1
Prepares the modal matrices for flutter eigenvalue analysis
886
Remarks:
BHH may be purged for the K and PK methods. BHH is ignored for the KE method. If BHH is purged,
BHH1 may be purged for the K method.
NOCEAD Output-integer-default=0. Complex eigenvalue analysis flag. Set to 1 if
complex eigenvalue analysis needs to be performed, otherwise, set
to -1.
LPRINT Input-logical-default=TRUE. Print flag for flutter analysis.
XYUNIT Input-integer-default=0. FORTRAN unit number to which extracted khh1
values are written at each sweep point for the PKS and PKNLS methods.
VREF Input-real-no default. Flutter velocity divisor to obtain flutter indices.
Main Index
887 FA2
Collects aeroelastic flutter data
Collects aeroelastic flutter data for reduction and presentation for each loop through the configuration
parameters.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
FA2
Collects aeroelastic flutter data
FA2 CPH1,CLAMA1,FSAVE/
CPH2,CLAMA2,CASEYY,OVG,FLUTABK/
S,N,TSTART/VREF/AECONFIG/SYMXY/SYMXY/LPRINT $
CPH1 Complex eigenvector matrix for h-set in flutter analysis.
CLAMA1 Complex eigenvalue summary table in flutter analysis.
FSAVE Flutter storage save table
CPH2 Appended complex eigenvector matrix for h-set in flutter analysis.
CLAMA2 Appended complex eigenvalue summary table in flutter analysis.
CASEYY Appended Case Control table in flutter analysis.
OVG Table of aeroelastic x-y plot data for V-g or V-f curves.
FLUTABK Flutter summary table for K and KE methods.
TSTART Input/output-integer-no default. On input, TSTART is the CPU clock time at
entry to FA1. On output, set to -1 if there is insufficient time for another
DMAP loop.
VREF Input-real-no default. Flutter velocity divisor to obtain flutter indices.
AECONFIG Input-character-no default. Aerodynamic configuration.
SYMXZ Input-integer-no default. Aerodynamic z-y symmetry flag.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
LPRINT Input-logical-default=TRUE. Print flag for flutter analysis.
Main Index
FA2
Collects aeroelastic flutter data
888
Remarks:
All output data blocks are must be declared on the FILE statement with APPEND keyword in order to
append outputs from previous loops.
Main Index
889 FBODYLD
Collects aeroelastic flutter data
Filters grid point forces according to a FBODY Case Control request.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
FBODYLD
Filters grid point forces according to a FBODY Case Control request
FBODYLD EDT,BGPDT,CASECC,OGPF1,CSTM/
BGPDTFB*,PGFB*/GPFNAM $
EDT Table of Bulk Data SET1 and FRBODYi entry images
BGPDT Basic grid point definition table.
CASECC Table of Case Control specifications.
OGPFB1 Table of grid point forces. Also must be indexed
with the OFPINDEX module.
CSTM Table of coordinate system transformation matrices.
BGPDTFB* Family of BGPDT tables associated with FBLPG. One instance defines the
grids for one given freebody subsystem.
PGFB* Family of PG matrices.
GPFNAM Input-character-default="OGF". NDDL name of the OGPF1.
Main Index
FBS
Matrix forward/backward substitution
890
.
To solve the matrix equation (right-hand solution) or
(left-hand solution) using the triangular factors computed by DCMP or DECOMP. Forward-only and
backward-only of right-hand solutions can also be provided for factors of symmetric matrices (see
Remark 6).
Format:
Input Data Blocks:
Output Data Block:
Parameters:
FBS
Matrix forward/backward substitution
FBS LD,U,B/X/KSYM/SIGN/FBTYP/FBREST/UNUSED/UNCOUP $
LD Lower triangular factor/diagonal, or Cholesky factor.
U Upper triangular factor. Purged unless is unsymmetric.
B Rectangular matrix.
X Rectangular matrix having the same dimensions as .
KSYM Input-integer-default = -1. Symmetry flag.
-1 choose symmetric if is purged, otherwise unsymmetric (default).
0 matrix is unsymmetric.
1 matrix is symmetric.
2 perform left-handed solution.
SIGN Input-integer-default = 1. Sign of .
1 solve (default).
-1 solve (default).
FBTYP Input-integer-default = 0. Forward or backward pass selection.
-1 perform backward pass only.
0 perform forward and backward passes (default).
1 perform forward pass only.
FBREST Input-integer-default=0. Internal restart flag.
A | | X | | B | | = X | |
T
A | | B | |
T
=
A | |
B | |
U | |
A | |
A | |
B | |
A | | X | | B | | =
A | | X | | B | | =
Main Index
891 FBS
Matrix forward/backward substitution
Remarks:
1. FBS employs one of two methods--sparse or non-sparse--based on the decomposition method
used by DCMP or DECOMP in computing the factor matrices. For example, if sparse methods
were used to compute the factors, then FBS uses the sparse method. The default decomposition
and FBS method is sparse. There also submethods (FBSOPT<>0) which only apply to non-sparse
methods and are ignored for sparse methods. See Remark 5.
2. Nonstandard triangular factor matrix data blocks are used to improve the efficiency of the
backward substitution process.
3. Solutions with Cholesky factors will be performed if the lower triangular factor matrices are
form 10.
4. The diagonal factor of symmetric matrices is stored as the diagonal of . When using the
forward-pass only and backward-pass only options, is included in the forward pass.
5. The keyword FBSOPT (or SYSTEM(70)) on the NASTRAN statement may be used for FBS
method selection (non-sparse only). If the FBSOPT keyword is not used, the program will select
the FBS method, which results in the lower sum of CPU and I/O time.
6. The equation for forward-only solution is , and for backward-only the solution
is . Both are right-hand solutions.
7. Left-hand solutions (KSYM = 2) are available for factors of symmetric or unsymmetric matrices.
Also, the NASTRAN keyword FBSLEFT=n or SYSTEM(72)=n in the FMS section, or
PUTSYS(n,72) in the DMAP sequence, specifies the transpose flag on :
If n=0 then FBS solves .
If n=1 then FBS solves .
8. Parallel processing in this module (Method 1A only) is selected with the NASTRAN statement
keyword PARALLEL (or SYSTEM (107)). To force parallel processing, also specify NASTRAN
FBSOPT = -2, SPARSE = 0.
9. For the sparse method the B matrix must be in machine precision. See Remarks under the
DECOMP, 723 module description.
UNUSED Input-integer-default=0. Unused.
UNCOUP Input-logical-default=FALSE. Setting UNCOUP to TRUE results in a special sparse
FBS which is optimal for uncoupled systems. (Unsymmetric FBS only.)
FBSOPT Non-sparse Submethod Selection
-2 Method 1A
-1 Method 1
0 Automatic selection method based on minimum of l/O + CPU time
+1 Method 2
D | |
D | |
L | | X | | B | | =
L | |
T
X | | B | | =
B | |
L | | U | | B | |
T
=
X|
T
L | | U | | B | | =
Main Index
FBS
Matrix forward/backward substitution
892
10. See the MSC.Nastran Numerical Methods Users Guide for further details on the FBS module and
related topics.
Examples:
1. Solve where could be either symmetric or unsymmetric.
DECOMP A/LD,U, $
FBS LD,U,B/X/ $
MATPRN X// $
2. Solve assuming is symmetric (form = 6 in matrix trailer).
DECOMP A/LD,, $
FBS LD,,B/X/ $
MATPRN X// $
3. Solve where is the lower triangular factor obtained in Example 2.
FBS LD,,C/X///1 $ FORWARD PASS ONLY
4. Solve where is the lower triangular factor obtained in Example 2.
FBS LD,,C/X///-1 $ BACKWARD PASS ONLY
5. Given that and are symmetric and is also positive definite, find
where
DECOMP M/LD,,//1 $ CHOLESKY
FBS LD,,K/Y///1 $ FWD.ONLY,Y AN INTERMEDIATE RESULT
FBS LD,,Y/J/2//1 $ FWD.ONLY, LEFT-HAND
A | | X | | B | | = A | |
A | | X | | B | | = A | |
LD | | X | | C | | = LD | |
LD | |
T
X | | C | | = LD | |
M | | K | | M | |
LD | |
T
| |
1
K | | LD | |
T
M | | LD | | LD | |
T
=
Main Index
893 FILE
Data block declaration
Declares special characteristics of a data block(s).
Format:
Data Blocks:
Parameters:
Remarks:
1. FILE is a nonexecutable DMAP instruction that is used only by the DMAP compiler for
information purposes. It may appear anywhere in subDMAP. It is also a local declaration; i.e., it
must be declared in all subDMAPs where the SAVE, APPEND, or OVRWRT is needed.
2. A data block name may appear only once in all FILE statements within a subDMAP; otherwise,
the first appearance will determine all special characteristics applied to the data block.
3. The APPEND keyword should only be applied to local scratch data blocks. In other words, the
data block should not be referenced on a TYPE DB statement. It is also recommended that the
APPEND keyword not be applied to data blocks that appear as output on the EQUIVX module.
See the EQUIVX, 881 module description for further details.
Example:
1. Data block C is created only in the first pass through the loop and must be "saved" for subsequent
passes:
FILE C=SAVE $
TYPE PARM,,CS,N,R=(1.,0.) $
TYPE PARM,,I,N,COUNT=1 $
.
.
.
DO WHILE ( COUNT<=3 ) $
FILE
Data block declaration
FILE DB1=[SAVE,APPEND,OVRWRT]/DB2=[SAVE,APPEND,
OVRWRT]/... $
DBi Names of the data blocks possessing special characteristics.
SAVE Indicates data block is to be saved for possible looping in DMAP program.
APPEND Same as SAVE and also allows a module to append other data blocks to DBi
on successive passes through a DMAP loop.
OVRWRT Allows a data block to be overwritten.
Main Index
FILE
Data block declaration
894
IF ( COUNT=1 ) MPYAD A,B,/C $
.
.
.
ADD A,C/D/R $
R=R+(1.,0.) $
COUNT=COUNT+1 $
ENDDO $
2. For an example of the APPEND keyword see the APPEND, 622 module description.
Main Index
895 FORTIO
Opens or closes a FORTRAN file
Opens or closes a FORTRAN file.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
Remarks:
1. Units must be assigned a physical file name using an ASSIGN statement.
2. Errors encountered in FORTIO will not terminate the MSC Nastran execution. But IOSTAT will
return a nonzero value in the event of error(s) that terminate the request.
FORTIO
Opens or closes a FORTRAN file
FORTIO //OPERATN/UNITNO/CLOSEOPT/IOSTAT $
OPERATN Input-character-no default. FORTIO operation.
'EXISTS' Check for assigned physical file existence.
'OPEN' Open file.
'CLOSE' Close file.
UNITNO Input-integer-no default. Specifies FORTRAN unit number.
CLOSEOPT Input-integer-default=2. FORTIO close options.
1 Rewind (leaves file open, if open).
2 Close/keep (default).
3 Close/delete.
IOSTAT Output-integer-no default. FORTIO status return code.
For OPERATN='OPEN' or 'CLOSE':
0 Successful.
1 Unsuccessful.
For OPERATN='EXISTS':
0 Assigned physical file exists.
1 Assigned physical file does not exist.
Main Index
FORTIO
Opens or closes a FORTRAN file
896
Example:
Close FORTRAN unit 24:
FORTIO //'CLOSE'/24/2/S,N,IOSTAT $
Main Index
897 FRLG
Generates frequency-dependent loads or time-dependent loads
Generates frequency-dependent loads or time-dependent loads via Fourier transform for frequency
response analysis.
Format:
Input Data Blocks:
FRLG
Generates frequency-dependent loads or time-dependent loads
FRLG CASECC,USETD,DLT,FRL,GMD,GOD,DIT,PHDH,APPLOD,
ENFLODK,ENFLODB,ENFLODM,ENFMOTN,ROTRT,
UNBVEC,EQDYN,FRFXITPP,FRFLABEL,FACLV*,PACLV*/
PPF,PSF,PDF,FOL,PHF,YPF/SOLTYP/S,N,FOURIER/
S,N,APP $
CASECC Table of Case Control command images.
USETD Degree-of-freedom set membership table for p-set.
DLT Table of dynamic loads.
FRL Frequency response list.
GMD Multipoint constraint transformation matrix with extra points, m-set by ne-set.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set.
DIT Table of TABLEij Bulk Data entry images.
PHDH Transformation matrix from d-set to modal coordinates.
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous damping
effects
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass effects
ENFMOTN Matrix of enforced motion amplitudes
ROTORT Table of rotordynamic user input for transient analysis.
UNBVEC Rotor to global transformation matrix for rotordynamics.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data.)
FRFXITPP P-size column matrix generated in an FRF generation job containing coded values
for rows indicating whether the DOF corresponding to that row has unit load
specified on it via an FRFXIT entry, an FRFXIT1 entry or due to its being a
connection DOF (or a combination of these)
Main Index
FRLG
Generates frequency-dependent loads or time-dependent loads
898
Output Data Blocks:
Parameters:
Remarks:
1. CASECC, FRL, and FOL cannot be purged.
2. DLT can be purged if PP, PS, PD, and PH are purged.
3. If USETD is not purged, then PS cannot be purged if single-point constraints exist. Also, GMD
and GOD cannot be purged if multipoint constraints or omitted degrees-of-freedom exist.
4. PHDH and PH cannot be purged if SOLTYP='MODAL'.
5. DIT cannot be purged if a dynamic load references TABLEDij Bulk Data entries.
6. PS, PD, and PH can be purged if USETD is also purged.
7. If TLOAD1 or TLOAD2 Bulk entries are referenced then the loads are computed and transformed
to the frequency domain.
FRFLABEL Table containing LABEL information from FRFXIT Bulk Data entries.
FACLV Family of frequency list vector by ACLOAD statement.
PACLV Family of acoustic pressure load matrix by ACLOAD statement.
PPF Frequency response load matrix in the p-set.
PSF Frequency response load matrix in the s-set.
PDF Frequency response load matrix in the d-set.
FOL Frequency response frequency output list.
PHF Frequency response load matrix in the h-set (modal).
YPF Frequency response enforced motion matrix in the p-set.
SOLTYP Input-character-no default. Solution method.
'MODAL' Modal; i.e, compute PH.
'DIRECT' Direct; i.e, do not compute PH.
FOURIER Output-integer-default=-1. Fourier transform. Set to 1 if TLOADi Bulk Data
entries are referenced by the DLOAD set identification number in CASECC.
APP Output-character-default='FREQ'. Dynamic load type. Set to 'FREQ', if
RLOAD1 or RLOAD2 entries are referenced. Set to 'TRAN', if TLOAD1 or
TLOAD2 entries are referenced.
Main Index
899 FRLGEN
Creates frequency response list from the FREQi Bulk Data entries
Creates the frequency response list from the FREQi Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
FRLGEN
Creates frequency response list from the FREQi Bulk Data
entries
FRLGEN DYNAMIC,LAMAS,LAMAF/
FRL,FRL1,DFFDNF/
S,N,NOFRL/S,N,NOOPT/DFREQ $
DYNAMIC Table of Bulk Data entry images related to dynamics.
LAMAS Normal modes eigenvalue summary table for the structural portion of the
model.
LAMAF Normal modes eigenvalue summary table for the fluid portion of the model.
FRL Frequency response list.
FRL1 Frequency response list for the current processor if distributed processing is
requested.
DFFDNF Table containing the derivatives of forcing frequencies with respect to natural
frequencies.
Main Index
FRLGEN
Creates frequency response list from the FREQi Bulk Data entries
900
Parameters:
Remarks:
LAMAF may be purged.
NOFRL Output-integer-default=0. FRL generation flag. Set to -1 if FRL is not
generated.
NOOPT Output-integer-default=0. FRLGEN reexecution flag. Set to -1 for no
reexecution.
DFREQ Input-real-default=1.E-5. Duplicate frequency threshold. Two frequencies, f
1
and f
2
, are considered duplicates if
where and are the maximum and minimum frequencies across all
FREQi Bulk Data entries.
f
1
f
2
DFREQ * f
max
f
min
<
f
max
f
min
Main Index
901 FRQDRV
Drives loop on frequencies defined on FREQi Bulk Data entries
Drives loop on frequencies defined on FREQi Bulk Data entries and is intended for frequency-dependent
element processing.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Example:
TYPE PARM,,I,N,FRQLOOP=0 $
DO WHILE ( FRQLOOP>=0 ) $
FRQDRV CASES,FRL/FRLI/S,N,FRQLOOP/S,N,FREQVAL $
.
.
.
ENDDO $ FRQLOOP>=0
FRQDRV
Drives loop on frequencies defined on FREQi Bulk Data entries
FRQDRV CASECC,FRL/
FRLI/
S,N,FRQLOOP/S,N,FREQVAL $
CASECC Table of Case Control command images.
FRL Frequency response list.
FRLI Frequency response list for a single frequency.
FRQLOOP Input/output-integer-no default. Frequency loop counter. On input,
FRQLOOP should be initialized to 0 before the loop. On output, FRQLOOP
is incremented by one and at the last frequency, FRQLOOP is negated. For
example, if the fifth frequency is the last then FRQLOOP is output as -5.
FREQVAL Output-real-no default. Frequency value for frequency dependent element
generation.
Main Index
FRRD1
Solves for the steady-state frequency response displacement solution
902
Solves for the steady-state, modal or direct, frequency response, displacement solution using iterative or
direct methods.
Format:
Input Data Blocks:
FRRD1
Solves for the steady-state frequency response displacement
solution
FRRD1 CASECC,DIT,KXX,BXX,MXX,K4XX,PXF,FRL,FOL,EDT,
SILD,USETD,PARTVEC/
UXF,FOLT/
SOLTYP/NONCUP/ITSEPS/ITSMAX/NSKIP/FRRD1SEL/
S,N,FIRSTBAD/SETNAME/FREQDEP $
CASECC Table of Case Control command images.
DIT Table of TABLEij Bulk Data entry images.
KXX Stiffness matrix in any set. Usually h- or d-set.
BXX Viscous damping in any set. Usually h- or d-set.
MXX Mass matrix in any set. Usually h- or d-set.
K4XX Structural damping in any set. Usually h- or d-set.
FRL Frequency response list.
FOL Frequency response frequency output list.
PXF Frequency response load matrix in h-set (modal) or d-set.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
SILD Scalar index list for the p-set. Required for maximum efficiency during
symmetric decomposition and if KXX represents the d-set or a subset of the
d-set (SETNAME='D').
USETD Degree-of-freedom set membership table for the p-set. Required for
maximum efficiency during symmetric decomposition and if KXX represents
the d-set or a subset of the d-set (SETNAME='D').
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, etc. Required
for maximum efficiency during symmetric decomposition and if KXX
represents a subset of the d-set (SETNAME='D'). PARTVEC is not required
if KXX represents the h-set. See SETNAME parameter description below.
Main Index
903 FRRD1
Solves for the steady-state frequency response displacement solution
Output Data Blocks:
Parameters:
Method:
The solution for the response is performed in FRRD1 or FRRD2 (Frequency Response Solution). In the
case of a direct formulation the following equation is solved.
UXF Solution matrix from frequency response analysis in d- or h-set.
FOLT Frequency response frequency output list with first frequency truncated if
first frequency is zero. UXF is also similarly truncated.
SOLTYP Input-character-no default. Solution method.
'MODAL' Modal; usually for h-set matrices.
'DIRECT' Direct; usually for d-set matrices.
NONCUP Input-integer-no default. Algorithm selection. NONCUP=-1 requests uncoupled
algorithm if SOLTYP='MODAL' and KXX, BXX, and MXX are diagonal.
NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX,
BXX, and MXX will be ignored.
ITSEPS Input-integer-default=0. Power of ten for convergence parameter epsilon for
iterative solution method.
ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution
method.
NSKIP Input-integer-default=1. Record number of current subcase in CASECC and used
only if the SMETHOD command selects the ITER Bulk Data entry which
specifies values for the desired iteration parameters. If NSKIP=-1 then CASECC
is not required and the values are taken from the module specification of the
values.
ZFREQ Input-integer-default=0. Zero frequency truncation selection. If set to 1 then the
zero frequency, if any, will be truncated from UXF and FOL.
FIRSTBAD Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if
first frequency is truncated.
SETNAME Input-character-default='H'. Degree-of-freedom set name represented by KXX,
etc. If KXX represents, or is a subset of, the d-set, then for maximum efficiency,
the rows and columns KXX and MXX must correspond to or be a partition of the
displacement set specified by SETNAME. If KXX and MXX are a partition then
PARTVEC must also be specified.
FREQDEP Input-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE
if processing frequency-dependent elements.
Main Index
FRRD1
Solves for the steady-state frequency response displacement solution
904
Eq. 4-22
and in the case of a modal formulation, the following equation is used in:
Eq. 4-23
The arithmetic used in the solution may be real or complex and the solution procedure may be symmetric
or unsymmetric. The choice of arithmetic and solution procedure is made by the program depending on
the form of the dynamic matrices.
Remarks:
1. CASECC, FRL, FOL, and PXF cannot be purged. KXX, BXX, and MXX can be purged.
2. If SOLTYP='DIRECT', then K4XX can be used to simulate viscoelastic materials. Otherwise it
may be purged. If SOLTYP='MODAL', then K4XX is ignored and may be purged.
3. FRRD1 is similar to FRDD2 except that FRRD1 has many more efficiency improvements and
viscoelastic material processing. However, FRRD2 performs special operations with the
aerodynamic matrix list, QHHL.
4. EDT is required for the iterative solver is NSKIP>0 and the SMETHOD Case Control command
selects the ITER Bulk Data entry. Otherwise it may be purged.
M
dd
e
2
iB
dd
e K
dd
+ + | | u
d
{ } P
d
{ } =
M
hh
e
2
iB
hh
e K
hh
+ + | | u
h
{ } P
h
{ } =
Main Index
905 FRRD2
Solves for the steady-state frequency response displacement solution
Solves for the steady-state, modal or direct, frequency response, displacement solution using iterative or
direct methods.
Format:
Input Data Blocks:
FRRD2
Solves for the steady-state frequency response displacement
solution
FRRD2 KXX,BXX,MXX,QHHL,PXF,FOL,CASECC,EDT,SILD,
USETD,PARTVEC/
UXF,FOLT/
BOV/Q/MACH/NONCUP/ITSEPS/ITSMAX/SETNAME/
FRRD2SEL/S,N,FIRSTBAD $
KXX Stiffness matrix in any set. Usually h- or d-set.
BXX Viscous damping in any set. Usually h- or d-set.
MXX Mass matrix in any set. Usually h- or d-set.
QHHL Aerodynamic matrix list.
PXF Frequency response load matrix in h-set (modal) or d-set.
FOL Frequency response frequency output list.
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
SILD Scalar index list for the p-set. Required for maximum efficiency during
symmetric decomposition and if KXX represents the d-set or a subset of the
d-set (SETNAME='D').
USETD Degree-of-freedom set membership table for the p-set. Required for
maximum efficiency during symmetric decomposition and if KXX represents
the d-set or a subset of the d-set (SETNAME='D').
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, etc. Required
for maximum efficiency during symmetric decomposition and if KXX
represents a subset of the d-set (SETNAME='D'). PARTVEC is not required
if KXX represents the h-set. See SETNAME parameter description below.
Main Index
FRRD2
Solves for the steady-state frequency response displacement solution
906
Output Data Blocks:
Parameters:
Method:
FRRD2 solves the matrix equation
at a given set of frequencies, , and loads, P.
UXF Solution matrix from frequency response analysis in d- or h-set.
FOLT Frequency response frequency output list with first frequency truncated if
first frequency is zero. UXF is also similarly truncated.
BOV Input-real-no default. Conversion from frequency to reduced frequency.
Q Output-real-default=0.0. Dynamic pressure.
MACH Output-real-default=0.0. Mach number.
NONCUP Input-integer-default=-1. Algorithm selection. NONCUP=-1 requests
uncoupled algorithm if KXX, BXX, and MXX are diagonal. NONCUP=-2,
requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and
MXX will be ignored.
ITSEPS Input-integer-default=0. Power of ten for convergence parameter epsilon for
iterative solution method.
ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution
method.
SETNAME Input-character-default='H'. Degree-of-freedom set name represented by
KXX, etc. If KXX represents, or is a subset of, the d-set, then for maximum
efficiency, the rows and columns KXX and MXX must correspond to or be a
partition of the displacement set specified by SETNAME. If KXX and MXX
are a partition then PARTVEC must also be specified.
ZFREQ Input-integer-default=0. Zero frequency truncation selection. If set to 1 then
the zero frequency, if any, will be truncated from UXF and FOL.
FIRSTBAD Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE
if first frequency is truncated.
e
2
M | | ie B | | Q BOV IM Q | | | |
\
K | | Q Re Q | |
\
+ + u | | P | | =
e
i
Main Index
907 FRRD2
Solves for the steady-state frequency response displacement solution
Remarks:
1. FOL and PXF cannot be purged. KXX, BXX, MXX, and QHHL can be purged.
2. FRRD1 is similar to FRDD2 except that FRRD1 has many more efficiency improvements and
viscoelastic material processing. However, FRRD2 performs special operations with the
aerodynamic matrix list, QHHL.
3. CASECC and EDT are required for the iterative solver is NSKIP>0 and the SMETHOD Case
Control command selects the ITER Bulk Data entry. Otherwise it may be purged.
Main Index
GENTRAN
Generates a transformation matrix
908
Generates a transformation matrix that will convert the upstream boundary coordinate system to the
downstream coordinate system.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
Example:
Excerpt from subDMAP PHASE0.
DO WHILE ( NOT(RSONLY) AND LPFLG<>-1 AND SEBULK ) $
SEP2DR SLIST,EMAP//S,N,SEID/S,N,PEID/S,N,SEDWN/
S,N,LPFLG/////////SEP2CNTL//-1/S,N,PARTSE/
S,N,SETYPE/S,N,REID $
IF ( PARTSE ) THEN $
NP=SEDWN $
DBVIEW BGPDTD=BGPDTS WHERE ( PEID=NP ) $
GENTRAN
Generates a transformation matrix
GENTRAN SEMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/
MAPS/
SEID $
SEMAP Superelement map table.
BGPDTS Basic grid point definition table for the current superelement.
CSTMS Table of coordinate system transformation matrices for the current
superelement.
BGPDTD Basic grid point definition table for the downstream superelement.
CSTMD Table of coordinate system transformation matrices for the downstream
superelement.
SCSTM Table of global transformation matrices for partitioned superelements.
MAPS Superelement upstream to downstream boundary coordinate transformation
matrix.
SEID Input-integer-default=0. Superelement identification number.
Main Index
909 GENTRAN
Generates a transformation matrix
DBVIEW CSTMD =CSTMS WHERE ( PEID=NP ) $
GENTRAN EMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/
MAPS/SEID $
ENDIF $ PARTSE
ENDDO $ NOT(RSONLY) AND LPFLG<>-1 AND SEBULK
Main Index
GETCOL
Reads STATSUB Case Control command subcase identification number number
910
Reads the STATSUB Case Control command subcase identification number and converts it to the
equivalent column number in the static solution matrix.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Remarks:
If the STATSUB subcase identification number is not found in CASEBUCK then the BCKCOL is set to
1. If the subcase identification number specified by the STATSUB command is not found in CASESTAT
then a fatal message is issued.
GETCOL
Reads STATSUB Case Control command subcase identification
number number
GETCOL CASEBUCK,CASESTAT//
NSKIP/S,N,BCKCOL/S,N,PRECOL/S,N,ICCOL $
CASEBUCK Table of Case Control command images for buckling analysis.
CASESTAT Table of Case Control command images for static analysis.
NSKIP Input-integer-default=1. Subcase record number to read in CASEBUCK for
the STATSUB subcase identification number.
BCKCOL Output-integer-no default. Subcase record number in CASESTAT referenced
by the STATSUB(BUCKLE) subcase identification number. BCKCOL also
corresponds to the column number of static solution vector.
PRECOL Output-integer-default-0. Subcase record number in CASESTAT referenced
by the STATSUB(PRELOAD) subcase identification number. PRECOL also
corresponds to the column number of static solution vector.
ICCOL Output-integer-default=0. Column number of static solution matrix as
derived from the IC(STATSUB) Case Control command specification.
Main Index
911 GETMKL
Create list of Mach numbers on reduced frequency pairs
Create list of Mach numbers on reduced frequency pairs.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
GETMKL
Create list of Mach numbers on reduced frequency pairs
GETMKL EDT/MKLIST/S,N,NMK $
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
MKLIST Table of Mach number and reduced frequency pairs.
NMK Output-integer-default=0. Number of Mach number and reduced frequency
pairs.
Main Index
GI
Generates aerodynamic spline transformation matrix
912
Generates the aerodynamic spline transformation matrix.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
GI
Generates aerodynamic spline transformation matrix
GI AERO, ,BGPDT,AEBGPDT,AEUSET,AECOMP,CSTM
A,
AEGRID/
GPGK,GDGK $
AERO Table of control information for aerodynamic analysis. Output by APD.
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external
grid identification numbers.
AMSPLINE Table of aerodynamic splines for display.
BGPDT Basic grid point definition table.
AEBGPDT The basic grid point definition table with the aerodynamic degrees of freedom
added (ks-set in AEUSET).
AEUSET Aerodynamic USET table.
AECOMP Aerodynamic component definition table.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
AEGRID Basic grid point definition tables for the aerodynamic model. Output by APD
as PGPDT with qualifier MODLTYPE='AEROMESH'.
GPGK Aerodynamic transformation matrix for loads from the k-set to g-set.
GDGK Aerodynamic transformation matrix for displacements from the k-set to g-set.
SPLINE
AMSPLINE
)
`
Main Index
913 GI
Generates aerodynamic spline transformation matrix
Example:
Excerpt from subDMAP AERO0:
DBVIEW AEUSET=USET0 WHERE (MODLTYPE='AEROSTRC'
AND WILDCARD) $
DBVIEW AEBGPDT=BGPDTS WHERE (MODLTYPE='AEROSTRC'
AND WILDCARD) $
DBVIEW AEGRID=AEBGPDTS WHERE (MODLTYPE='AEROMESH')
GI
AERO,SPLINE,XBGPDT,AEBGPDT,AEUSET,AECOMP,CSTMA,AEG
RID/
GPGK0,GDGK0 $
Main Index
GIC2C
Forms splice matrix for element centroids
914
Forms a spline matrix that maps displacements measured at centroidal elemental grids of aero meshes to
the corner point (mesh connectivity) grids. This displacement map will allow visualization of
connectivity grid motion for "element centroid" based aero meshes (like DLM and ZAERO).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
GIC2C
Forms splice matrix for element centroids
GIC2D AEBOX,AEGRID,AEBGPDT*,CSTM/GDKSKS $
AEBOX Table of aerodynamic element connectivity. Output by APD as BGPDT with
qualifier MODLTYPE='AEROMESH'.
AEGRID Basic grid point definition tables for the aerodynamic model. Output by APD
as BGPDT with qualifier MODLTYPE='AEROMESH'.
AEBGPDT* Family of aerodynamic basic grid point definition tables.
CSTM Table of coordinate system transformation matrices.
GDKSKS Matrix relation of the corner to the centroidal displacements.
Main Index
915 GKAM
Assembles modal mass, damping and stiffness matrices
Assembles the modal mass, damping and stiffness matrices.
Format:
Input Data Blocks:
Output Data Blocks:
GKAM
Assembles modal mass, damping and stiffness matrices
GKAM USETD,PHA,MI,LAMA,DIT,M2DD,B2DD,K2DD,CASECC,LAMMAT
, MEMF/
MHH,BHH,KHH,PHDH,MODSELT,MODSELV,LAMASEL,BMODAL/
NOUE/LMODES/LFREQ/HFREQ/UNUSED5/UNUSED6/UNUSED7/
S,N,NONCUP/S,N,FMODE/KDAMP/FLUID/UNUSED12/APP $
USETD Degree-of-freedom set membership table for p-set.
PHA Normal modes eigenvector matrix in the a-set.
MI Modal mass matrix. See Remark 5.
LAMA Normal modes eigenvalue summary table.
DIT Table of TABLEij Bulk Data entry images.
M2DD Mass matrix contribution from the M2PP Case Control command and
reduced to the d-set.
B2DD Total damping matrix from viscous damping elements and the B2PP Case
Control command and reduced to the d-set. In transient response analysis,
B2DD may also include structural damping effects.
K2DD Stiffness matrix contribution from the K2PP Case Control command and
reduced to the d-set. In frequency response analysis, K2DD may also include
structural damping effects.
CASECC Table of Case Control command images.
LAMMAT Diagonal matrix containing eigenvalues on the diagonal. Used in lieu of the
LAMA table when present.
MEMF Modal effective mass fraction table.
BHH Generalized (modal) damping matrix.
MHH Generalized (modal) mass matrix.
KHH Generalized (modal) stiffness matrix.
PHDH Transformation from d-set to h-set (modal).
Main Index
GKAM
Assembles modal mass, damping and stiffness matrices
916
Parameters:
MODSELT Table of mode numbers selected by the combination of
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. If FLUID=TRUE, then
MODSELT is based on the MODESELECT(FLUID) Case ontrol command
and user parameters LMODESFL, LFREQFL, and HFREQFL.
MODSELV Partitioning vector equivalent of MODSELT.
LAMASEL LAMA table containing only those modes defined by MODSELT.
BMODAL Matrix of modal damping values from selected TABDMP1 Bulk Data entry
in DIT.
NOUE Input-integer-no default. The number of EXTRA points. Set to -1 if there are
no extra points.
LMODES Input-integer-no default. The number of lowest modes to use in modal
transformation. All outputs will have LMODES number of columns.
LFREQ Input-real-no default. Lower frequency limit of modes to use in modal
transformation.
HFREQ Input-real-no default. Upper frequency limit of modes to use in modal
transformation.
UNUSED5 Input-integer-no default. Unused.
UNUSED6 Input-integer-no default. Unused.
UNUSED7 Input-integer-no default. Unused.
NONCUP Output-integer-no default. If K2DD, B2DD, and M2DD are purged. then the
model is considered uncoupled and NONCUP is set to -1.
FMODE Output-integer-default=1. The lowest mode number resulting from
LMODES or LFREQ and HFREQ.
KDAMP Input-integer-default=1. Viscous modal to structural damping flag. If set to -
1, then viscous modal damping (SDAMPING Case Control command) will
be included in the stiffness matrix as structural damping.
FLUID Input-logical-default=FALSE. Fluid damping processing flag. If TRUE, then
the modal damping set identification number is obtained from the
SDAMPING(FLUID) Case Control command.
UNUSED12 Input-logical-default=FALSE. Unused.
APP Input-character-default=' '. Analysis type. Allowable values:
'FREQRESP' Frequency response.
Main Index
917 GKAM
Assembles modal mass, damping and stiffness matrices
Method:
The dynamic matrices expressed in modal coordinates are assembled in GKAM (General K Assembler-
Modal) as follows:
(4-24)
(4-25)
and
(4-26)
where, if PARAM,KDAMP = 1 (default)
If PARAM,KDAMP = -1 in complex eigenvalue analysis, modal frequency response, aerodynamic
flutter, and aeroelastic response, the viscous modal damping will be incorporated into the complex
stiffness matrix as follows:
Values of are specified on the TABDMP1 Bulk Data entry, selected by the SDAMPING Case
Control command. If KDAMP = 1 (default), the matrices and are formulated as in modal
transient response.
Remarks:
1. USETD may be purged if there are no extra points (NOUE<0).
2. PHA and LAMA cannot be purged.
3. CASECC and DIT cannot be purged if SDAMPING is specified.
4. M2DD, B2DD, K2DD, and MI may be purged.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
K
hh
| | k | | |
dh
| |
T
K
dd
2
| | |
dh
| | + =
M
hh
| | m | | |
dh
| |
T
M
dd
2
| | |
dh
| | + =
B
hh
| | b | | |
dh
| |
T
B
dd
2
| | |
dh
| | + =
m
i
modal mass =
b
i
2tf
i
g f
i
( )m
i
=
k
i
4t
2
f
i
2
m
i
=
m
i
modal mass =
b
i
0 =
k
i
1 ig f
i
( ) + | |4t
2
f
i
2
m
i
=
g f
i
( )
b | | k | |
Main Index
GKAM
Assembles modal mass, damping and stiffness matrices
918
5. LAMA may be purged as long as both MI and LAMMAT exist. Using MI and LAMMAT is
preferable to LAMA because the the values in MI and LAMMAT are in machine precision.
6. No output matrix can be purged.
7. HFREQ and LFREQ are ignored if LMODES>0.
8. See Section 9.4.10 of the MSC Nastran Reference Manual for further details.
9. If modes are not selected with HFREQ, LFREQ and LMODES parameters or the MODESELECT
command and NOUE < 0, then PHDH will be purged and a subsequent EQUIVX from PHA to
PHDH must be executed.
Main Index
919 GNFM
Computes element forces due to large displacements
Computes the element forces due to large displacements and optionally computes the elemental stiffness
matrices associated with incremental deflections.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
GNFM
Computes element forces due to large displacements
GNFM KELM,KDICT,KDELM,KDDICT,EST,CSTM,UG,BGPDT/
FG,KELM1,KDICT1/
SKPMTX/LUSET/NSKIP $
KELM Table of element matrices for stiffness.
KDICT KELM dictionary table.
KDELM Table of element matrices for differential stiffness.
KDDICT KDELM dictionary table.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
UG Displacement matrix in g-set.
BGPDT Basic grid point definition table.
FG Element forces due to large displacements.
KELM1 Table of element matrices for incremental stiffness.
KDICT1 KELM1 dictionary table.
SKPMTX Input-integer-default=0. If SKPMTX<>0, then KELM1 and KDICT1 will be
generated.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NSKIP Input-integer-default=0. Loop counter in old geometric nonlinear analysis
(SOL 4).
Main Index
GNFM
Computes element forces due to large displacements
920
Remarks:
1. FG cannot be purged.
2. KELM1 and KDICT1 may be purged if SKPMTX<>0.
Main Index
921 GP0
Modifies tables to include p-element information
Modifies geometry, connectivity, loads, and constraints tables to include p-element information and also
create edge, face, and body tables.
Format:
Input Data Blocks:
Output Data Blocks:
GP0
Modifies tables to include p-element information
GP0 CASECC,GEOM1,GEOM2,GEOM3,GEOM4,EPT,
EDT,DEQATN,DEQIND,PELSET,PVAL0/
GEOM1M,GEOM2M,GEOM2A,GEOM3M,GEOM4M,
EHT,EHTA,MEDGE,MFACE,GDNTAB,MBODY/
ALTSHAPE/UNIT1/UNIT2/S,N,PVALID/S,N,PEXIST/
GNSTART/S,N,GNMAX/GMTOL/INITAPI/PEDGEP/GNPROC $
CASECC Table of Case Control command images.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
EPT Table of Bulk Data entry images related to element properties.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
PELSET p-element set table, contains SETS DEFINITIONS. Output by PLTSET.
PVAL0 P-value table generated by the ADAPT module in previous superelement,
adaptivity cycle, or run.
GEOM1M Table of Bulk Data entry images related to geometry and updated for the
current p-level.
GEOM2M Table of Bulk Data entry images related to element connectivity and scalar
points and updated for the current p-level.
Main Index
GP0
Modifies tables to include p-element information
922
Parameters:
GEOM2A Table of secondary Bulk Data entry images related to element connectivity
and updated for the current p-level.
GEOM3M Table of Bulk Data entry images related to static and thermal loads and
updated for the current p-level.
GEOM4M Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity and updated for the current p-
level.
EHT Element hierarchical table for p-element analysis.
EHTA Secondary element hierarchical table for p-element analysis.
MEDGE Edge table for p-element analysis.
MFACE Face table for p-element analysis.
GDNTAB Table of grid points generated for p-element analysis.
MBODY Body table for p-element analysis.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the
Full Product Space set.
UNIT1 Input-integer-default=0. Fortran unit number containing edge table
information.
UNIT2 Input-integer-default=0. Fortran unit number containing face table
information.
PVALID Output-integer-default=0. P-value set identification number.
PEXIST Output-logical-default=TRUE. Set to FALSE if p-elements are not present.
GNSTART Input-integer-default=0. First grid identification number in GEOM1M.
GNMAX Output-integer-no default. Maximum grid identification number in
GEOM1M.
GMTOL Input-real-default=1.E-5. Geometric tolerance.
INITAPI Input-logical-default=TRUE. API flag.
PEDGEP Input-integer-default=0.
GNPROC Input-logical-default=TRUE. Grid-n processing flag. If set to TRUE grid-n
information is processed.
Main Index
923 GP1
Performs basic geometry processing
Performs basic geometry processing.
Format:
Input Data Blocks:
Output Data Blocks:
GP1
Performs basic geometry processing
GP1 GEOM1,GEOM2,GEOM3,GDNTAB,MEDGE,SGPDT,DYNAMIC,CASECC/
GPL,EQEXIN,GPDT,CSTM,BGPDT,SIL,VGF,GEOM3B,DYNAMICB,
VGEXF/S,N,LUSET/S,N,NOCSTM/S,N,NOPOINTS/
UNIT/UPERM/UPRMT/NUFLAG/SEID $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GDNTAB Table of grid points generated for p-element analysis.
MEDGE Edge table for p-element analysis.
SGPDT Superelement basic grid point definition table.
DYNAMIC Table of Bulk Data entry images related to dynamics.
CASECC Table of Case Control command values. Only used for SOLs 600 and 700.
GPL External grid/scalar point identification number list.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
GPDT Grid point definition table.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
VGF Fluid/structure partitioning vector with ones at the rows corresponding to
fluid degrees-of-freedom.
GEOM3B Table of Bulk Data entry images related to static and thermal loads with
DAREA entry images converted to equivalent FORCE and MOMENT entry
images.
Main Index
GP1
Performs basic geometry processing
924
Parameters:
Remarks:
1. GP1 assembles a list of all grid and scalar points and places them in internal order, computes
coordinate system transformation matrices, and transforms all grid points to the basic coordinate
system.
2. No output data block, except VGF, may be purged.
DYNAMICB Table of Bulk Data entry images related to dynamics without DAREA entry
images.
VGEXF Exterior acoustic partitioning vector with ones at the rows corresponding to
exterior acoustic degrees-of-freedom.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NOCSTM Output-integer-no default. Number of coordinate systems found in GEOM1.
Set to -1 if none are found.
NOPOINTS Output-integer-no default. Grid point flag. Set to -1 if none are found.
Otherwise, set to 1.
UNIT Input-real-default=1.0. AUNIT record factor for electromagnetic analysis.
UPERM Input-real-default=1.2566E-06. Permeability for electromagnetic analysis.
UPRMT Input-real-default=8.8542E-12. Permittivity for electromagnetic analysis.
NUFLAG Input-integer-default=10. Unit type for electromagnetic analysis.
SEID Input-integer-default=-1. Superelement identification number.
Main Index
925 GP2
Processes element connectivity
Processes element connectivity.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. EQEXIN and ECT may not be purged.
GP2
Processes element connectivity
GP2 GEOM2,EQEXIN,EPT,GEOM2A,EPTA,BGPDT,CSTM,MPT/
ECT,ECTA/
S,N,ACOUSTIC $
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
EPT Table of Bulk Data entry images related to element properties.
GEOM2A Table of secondary Bulk Data entry images related to element connectivity
and updated for the current p-level.
EPTA Secondary table of Bulk Data entry images related to element properties.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
ECT Element connectivity table.
ECTA Secondary element connectivity table.
ACOUSTIC Output-integer-default=0. Fluid-structure analysis flag.
0 No fluid elements exist.
1 Penalty or fluid acoustic elements exists.
2 Fluid/structure coupling exists.
Main Index
GP2
Processes element connectivity
926
2. ECTA may be purged if GEOM2A is purged.
Main Index
927 GP3
Processes static and thermal loads
Processes static and thermal loads.
Format:
Input Data Blocks:
Output Data Blocks:
GP3
Processes static and thermal loads
GP3 GEOM3,BGPDT,GEOM2,EDT,UGH,ESTH,BGPDTH,
CASEHEAT,MPT,PG*/
SLT,ETT/
S,N,NOLOAD/S,N,NOGRAV/S,N,NOTEMP $
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
BGPDT Basic grid point definition table.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
UGH Temperature matrix in g-set from a heat transfer analysis.
ESTH Element summary table from a heat transfer analysis.
BGPDTH Basic grid point definition table from a heat transfer analysis.
CASEHEAT Case Control table from a heat transfer analysis.
MPT Table of Bulk Data entry images related to material properties.
PG* Family of external load matrices qualified by LOADID or FBLID
SLT Table of static loads.
ETT Element temperature table.
Main Index
GP3
Processes static and thermal loads
928
Parameters:
Remarks:
1. BGPDT may not be purged.
2. SLT may be purged if there are no static loads.
3. ETT may be purged if there are no thermal loads
4. If UGH is present in structural analysis run, then GP3 will create a new temperature set based on
UGH with set identification numbers obtained from TSTRUC command in CASEHEAT.
BGPDTH is used to correlate UGH to grid points. For h-elements ESTH is not required. For p-
elements ESTH is appended to element ETT record for interpolation purposes in element decks.
Here are the DBVIEW statements that are used to define these inputs in SOLs 101-200:
CASEHEAT can come from the CASE module or DBLOCATE DATABLK=
(CASECCR/CASEHEAT) in the FMS.
NOLOAD Output-integer-no default. Static load existence flag. Set to -1 if no static
loads and SLT is not created, +1 otherwise.
NOGRAV Output-integer-no default. Gravity load existence flag. Set to -1 if no GRAV
Bulk Data entry images, +1 otherwise.
NOTEMP Output-integer-no default. Thermal load existence flag. Set to -1 if no TEMP
or TEMPD Bulk Data entry images in GEOM3 and ETT is not created, +1
otherwise.
DBVIEW UGH=UG
DBVIEW ESTH=EST
DBVIEW BGPDTH=BGPDTS
(WHERE APRCH='HEAT ' AND WILDCARD) $
(WHERE APRCH='HEAT ' ) $
(WHERE APRCH='HEAT ') $
Main Index
929 GP4
Generates the degree-of-freedom set table
Generates the degree-of-freedom set table, based on single point constraints, multipoint constraints, rigid
elements, and set membership assignment Bulk Data entries (e.g., ASET). Also generate the enforced
displacement matrix and multipoint constraint equation matrix.
Format:
Input Data Blocks:
GP4
Generates the degree-of-freedom set table
GP4 CASECC,GEOM4,EQEXIN,SIL,GPDT,BGPDT,CSTM,
MEDGE,MFACE,MBODY,GEOM2,GDNTAB,ECT,GPSNT,GEOM1/
RMG,YS0,USET0,GPSNTN/
LUSET/S,N,NOMSET/S,N,MPCF2/S,N,NOSSET/S,N,NOOSET/
S,N,NORSET/S,N,NSKIP/S,N,REPEAT/S,N,NOSET/S,N,NOL/
S,N,NOA/SEID/ALTSHAPE/SEBULK/AUTOMSET/SNORMPRT/
S,N,NEWGPSNT/ATQSET $
CASECC Table of Case Control command images.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
SIL Scalar index list.
GPDT Grid point definition table.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
MEDGE Edge table for p-element analysis.
MFACE Face table for p-element analysis.
MBODY Body table for p-element analysis.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GDNTAB Table of grid points generated for p-element analysis.
ECT GEOM2 Element connectivity table.
GPSNT Grid point shell normal table.
GEOM1 Table of Bulk Data entry images related to geometry.
Main Index
GP4
Generates the degree-of-freedom set table
930
Output Data Blocks:
RMG Multipoint constraint equation matrix.
YS0 Matrix of enforced displacements.
USET0 Degree-of-freedom set membership table for g-set.
GPSNTN Grid point shell normal table updated due to the interaction with RSSCON
elements.
Main Index
931 GP4
Generates the degree-of-freedom set table
Parameters:
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
NOMSET Output-integer-no default. Number of degrees-of-freedom in the m-set or
multipoint constraint and rigid element flag. Set to -1 if there are none.
MPCF2 Output-integer-no default. Multipoint constraint set identification number
change flag. Set to 1 if the current subcase contains a different multipoint
constraint set from the previous subcase. Set to -1 otherwise or if there are no
multipoint constraints in the current subcase.
NOSSET Output-integer-no default. Number of degrees-of-freedom in the s-set. or
single point constraint flag. Set to -1 if there are none.
NOOSET Output-integer-no default. Number of degrees-of-freedom in the o-set or
omitted degree-of-freedom flag. Set to -1 if there are none.
NORSET Output-integer-no default. Number of degrees-of-freedom in the r-set. or
supported degree-of-freedom flag. Set to -1 if there are none.
NSKIP Input/output-integer-no default. The record number in CASECC
corresponding to the first subcase of the current boundary condition.
REPEAT Output-integer-no default. Last boundary condition flag. Set to -1 at the last
boundary condition; +1 otherwise.
NOSET Output-integer-no default. Constraint, omit, and support set flag. Set to -1 if
NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-
freedom defined in the a-set (e.g., ASETi, QSETi Bulk Data entries); +1
otherwise.
NOL Output-integer-default=1. Dependent set flag. Set to -1 if all degrees-of-
freedom belong to m-set, s-set, o-set, and/or r-set; otherwise, the degrees-of-
freedom in the l-set.
NOA Output-integer-default=1. Constraint and omit set flag. Set to -1 if
NOMSET=-1, NOSSET=-1, and NOOSET=-1; otherwise the number of
degrees-of-freedom in the a-set.
SEID Input-integer-default=0. Superelement identification number.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the
Full Product Space set.
SEBULK Input-logical-default=FALSE. Partitioned superelement presence flag. Set to
TRUE if partitioned superelements are present or BEGIN SUPER is specified
for the first BEGIN BULK Case Control command.
Main Index
GP4
Generates the degree-of-freedom set table
932
Remarks:
1. YS will be purged if SPCD or SPC Bulk Data entries do not specify nonzero values for
displacement.
2. GEOM4 may be purged.
3. CSTM may be purged if no coordinate systems are used.
AUTOMSET Input-character-default=' '. Auto m-set selection flag. If YES, then the dependent
degree-of-freedom specifications on MPC and rigid element Bulk Data entries will
be rearranged to avoid exclusive dof set conflicts. Usually input by user parameter.
SNORMPRT Input-integer-default=0. Grid point shell normal print/punch flag.
0 No print or punch.
1 Punch.
2 Print only.
3 Print and punch.
NEWGPSNT Output-logical-default=FALSE. Updated shell normal table flag. If the GPSNTN
table is created (shell normal table is updated due to the interaction with RSSCON
elements), then the flag is set TRUE.
ATQSET Input-logical-default=.FALSE. Automatic q-set generation flag. If no ASET,
ASET1, QSET, or QSET1 entries are present, then all unspecified degrees of
freedom will be included in the:
a-set if AUTOQSET=.FALSE.
o-set if AUTOQSET=.TRUE.
Main Index
933 GP5
Creates table of static loads for panels in coupled fluid/structure analysis
Creates a table of static loads for panels in coupled fluid/structure analysis.
Format:
Input Data Blocks:
Output Data Blocks:
GP5
Creates table of static loads for panels in coupled fluid/structure
analysis
GP5 ECT,BGPDT,EQEXIN,EDT,SIL,CSTM/
PANSLT,EQACST,NORTAB,WETFACES,EDT1/
S,N,MPNFLG/S,N,NUMPAN/S,N,MATCH/NASOUT/GETNUMPN/
EDT1FLG/SKINOUT $
ECT Element connectivity table.
BGPDT Basic grid point definition table.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
PANSLT Panel static load table.
EQACST Equivalence table between internal fluid grid points and internal structural
grid points which lie on the fluid/structure boundary. Output by GP5.
NORTAB Table containing fluid face and the maximum of eight structural grids which
lie within the acoustic face.
WETFACES Table of wetted structure.
EDT1 EDT updated written out if user requested a panel with the entire wetted
structure skin.
Main Index
GP5
Creates table of static loads for panels in coupled fluid/structure analysis
934
Parameters:
MPNFLG Output-integer-default=0. Set to 1 if multiple panels exist.
NUMPAN Output-integer-default=1. Number of panels.
MATCH Output-integer-default=0. Type of fluid/structural mesh matching.
0 Matching mesh.
1 Non-meshing mesh.
NASOUT Input-logical-default=TRUE. Print flag for fluid/structural mesh matching
summary.
GETNUMPN Input-logical-default=FALSE. Panel static load computation flag. If TRUE then get
number of panels flag only and do not compute panel static loads.
EDT1FLG Output-integer-default=0. EDT1 creation flag.
-1 EDT1 was created.
0 EDT1 was not created.
SKINOUT Input-character-no default. Specifies location to write the fluid-structure interface
element and grid information. Usually input via user parameter or the FLSTCNT
Case Control keyword SKINOUT:
NONE Do not write.
PUNCH Punch file.
PRINT f06 file.
ALL Both punch and f06 file.
Main Index
935 GPFDR
Computes grid point forces and element strain energy
Computes grid point forces and element strain energy.
Format:
Input Data Blocks:
GPFDR
Computes grid point forces and element strain energy
GPFDR CASECC,UG,KELM,KDICT,ECT,EQEXIN,GPECT, , ,
BGPDT, ,CSTM,VELEM,PTELEM,QMG,NFDICT,FENL,
MELM,MDICT,BELM,BDICT,GEI,MATPOOL,F2J,VG,AG,EDT/
, , ,
OELQS1,OELQW1,OELQM1,OELQD1,OPACC1/
APP/TINY/XFLAG/CYCLIC/WTMASS/NDVTOT/DMIGFN/G/GFL $
CASECC Table of Case Control command images.
UG Displacement matrix in g-set.
KELM Table of element matrices for stiffness.
KDICT KELM dictionary table.
ECT Element connectivity table.
EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
GPECT Grid point element connection table.
PG Static load matrix for the g-set.
UADJ Displacement vectors from adjoint load.
QG Single-point constraint forces of constraint matrix in the g-set.
AGGZT Fluid-structural Coupling matrix.
BGPDT Basic grid point definition table.
LAMA Eigenvalue summary table for normal modes. Required for APP='REIG'.
PG
UADJ
---------------
)
`
QG
AGG2
----------------
)
`
LAMA
FOL
TOL
OLF
)
`
ONRGY1
OELSS1
------------------------
)
`
OGPFB1
OELSWI
----------------------
)
`
OEKE1
OELSM1
-----------------------
)
`
OEDE1
OELSDI
---------------------
)
`
Main Index
GPFDR
Computes grid point forces and element strain energy
936
Output Data Blocks:
FOL Frequency output list. Required for APP='FREQRESP'.
TOL Time output list. Required for APP='TRANRESP'.
OLF Nonlinear static load factor list. Required for APP='NLST'.
CSTM Table of coordinate system transformation matrices.
VELEM Table of element lengths, areas, and volumes.
PTELEM Table of thermal loads in the elemental coordinate system.
QMG Multipoint constraint forces of constraint matrix in the g-set.
NFDICT Nonlinear element energy/force index table.
FENL Element energy and forces in nonlinear matrix format.
MELM Elemental matrices for mass.
MDICT Dictionary table for MELM.
BELM Elemental matrices for damping
GEI Table of general element (GENEL) data.
BDICT Dictionary table for BELM.
MATPOOL Table of Bulk Data entry images related to DMIG Bulk Data entries.
F2J Matrix of strain energy on DMIG Bulk Data entries referenced by the K2GG Case
Control command. Must be qualified by qualifier named by DMIGFN.
VG Velocity matrix in g-set for transient analysis (unused and reserved for a future
enhancement).
AG Acceleration matrix in g-set for transient analysis (unused and reserved for a future
enhancement).
EDT Table of Bulk Data entry images related to element deformation, aerodynamics, p-
element analysis, divergence analysis, and the iterative solver. Also contains SET1
and MONITOR point entries.
UADJ Displacement vectors from adjoint load.
AGGZT Fluid-structural Coupling matrix.
ONRGY1 Table of element strain energies and energy densities.
OELSS1 Table of element sensitivity of stiffness property.
OGPFB1 Table of grid point forces.
OELSW1 Table of grid sensitivity on wetted surface.
OEKE1 Elemental kinetic energy.
OELSM1 Table of element sensitivity of mass property.
Main Index
937 GPFDR
Computes grid point forces and element strain energy
Parameters:
OEDE1 Elemental energy loss.
OELSD1 Table of element sensitivity of dynamic property.
OELQS1 Table of squared element sensitivity of stiffness property.
OELQW1 Table of squared grid sensitivity on wetted surface.
OELQM1 Table of squared element sensitivity of mass property.
OELQD1 Table of squared element sensitivity of dynamic property.
OPACC1 Table of particle acceleration on wetted surface.
APP Input-character-no default. Analysis type. Allowable types are:
'STATICS' Linear statics.
'REIG' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'NLST' Nonlinear static.
TINY Input-real-default=1.E-03. Small element strain energy value. Element strain
energies less than TINY will not be printed.
XFLAG Input-integer-default=0. Strain energy method selection. The following decimal
equivalent bit values may be summed.
0 Elemental force and strain energy is calculated according to:
1 Cross displacement. See Remark 2.
2 Strain energy is calculated according to:
4 Another way to set DIAG 30 without alters.
8 Flag to output complex grid point forces.
CYCLIC Input-logical-default=FALSE. Set to TRUE for cyclic symmetry models.
WTMASS Input-real-default=1.0. Specifies scale factor on elemental mass matrix.
NDVTOT Input-integer-default=0. Number of unique referenced design variables.
DMIGFN Input-character-default=DMIG. Qualifer name for F2J matrices.
0.5* ue | |t ke | | ue | | ue | |t pt | |
0.5* ue | |t ke | | ue | | ue | |t pt | | ( )
Main Index
GPFDR
Computes grid point forces and element strain energy
938
Remarks:
1. GPFDR creates the grid point force balance table for a user-selected set of points. This table lists
the forces acting at each selected point due to element constraints, single-point constraints, and
applied loads. Also listed is the sum total of these forces which represents the balance in an
opposite direction due to multipoint constraints, general elements, round-off errors, and other
nonlisted sources. Subtotals for element sets and element types are also provided.
2. GPFDR creates the element strain energy table for a user-selected set of elements. These selected
elements are listed by type with their strain energy, percent of total strain energy with respect to
all elements and strain energy density. The strain energy is computed by one of the following
equations:
If XFLAG=0 (default):
(4-27)
If XFLAG=1:
(4-28)
where is the displacement for the first subcase or mode and
where is the displacement for the i-th subcase or mode.
3. The strain energy density is computed by dividing the strain energy by the element volume. The
total energy is computed by summing the element strain energies of all elements for which
stiffness matrices exist. General elements are not included.
G Input-real-default=0.0. Uniform structural damping coefficient.
GFL Input-real-default=0.0. Uniform fluid damping coefficient.
W
e
1
2
--- F
e
{ }
T
u
e
{ } =
W
e
1
2
--- u
e
1
{ } K
e
T
{ } u
e
i
{ } =
u
e
1
{ }
u
e
i
{ }
Main Index
939 GPJAC
Checks element Jacobians
Checks element Jacobians.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameter:
Remark:
By default the run will terminate if bad Jacobians are detected. If system cell 213 is equal to 1 then the
run will not terminate.
GPJAC
Checks element Jacobians
GPJAC ECT,BGPDT//S,N,JACDET $
ECT Element connectivity table.
BGPDT Basic grid point definition table.
JACDET Output-integer-default=0. Bad Jacobian detection flag. Set to 1 if a bad
Jacobian is detected.
Main Index
GPSP
Performs auto-SPC operation
940
Performs auto-SPC operation; i.e., identifies and automatically constrains singularities.
Format:
Input Data Blocks:
Output Data Blocks:
GPSP
Performs auto-SPC operation
GPSP , ,USET0,SIL,GPL,YS0,GEOM4,EQEXIN,
CASECC,GPSPRT0/
USET,YS,BD3X3,RMG1,GPSPRT/
S,N,NOSSET/AUTOSPC/PRGPST/SPCGEN/EPZERO/ACON/
S,N,SING/EPPRT/S,N,NOSET/S,N,NGERR/MPCMETH/
NSKIP/S,N,DONSET/RESID/S,N,NNEWS/S,N,NNEWM $
KNN Stiffness matrix in n-set; after multipoint constraint reduction.
KGG Stiffness matrix in g-set.
KMM Stiffness matrix in m-set.
RMG Multipoint constraint equation matrix.
USET0 Degree-of-freedom set membership table for g-set.
SIL Scalar index list.
GPL External grid/scalar point identification number list.
YS0 Matrix of enforced displacements.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
CASECC Table of Case Control command images.
GPSPRT0 GPSPRT from a previous call to GPSP and required when DONSET=-1.
USET Degree-of-freedom set membership table for g-set.
YS Matrix of enforced displacements in the s-set.
KNN
KGG
)
`
KMM
RMG
)
`
Main Index
941 GPSP
Performs auto-SPC operation
BD3X3 3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel
domain decomposition.
RMG1 Updated RMG matrix when MPC option is selected on the AUTOSPC Case
Control command.
GPSPRT Table of grid point singularity created on the first call to GPSP when the MPC
option is selected on the AUTOSPC Case Control command and
DONSET=0.
Main Index
GPSP
Performs auto-SPC operation
942
Parameters:
NOSSET Output-integer-default=0. Number of degrees-of-freedom in the s-set. or
single point constraint flag. Set to -1 if there are none.
AUTOSPC Input-character-default='YES'. Automatic constraint flag. If set to 'YES', then
singularities will be constrained.
PRGPST Input-character-default='YES'. Singularity summary print flag. If set to
'YES', then the summary is printed.
SPCGEN Input-integer-default=0. SPC Bulk Data entry punch flag. If set to >0, then
singularities identified by this module are written to the PUNCH file as SPC
Bulk Data entries.
EPZERO Input-real-default=1.E-8. Singularity test parameter. Singularities greater
than EPZERO will not be constrained.
ACON Input-integer-default=0. B-set constraint flag. If ACON<0, then b-set
degrees-of-freedom will be constrained if AUTOSPC='YES'.
SING Output-integer-default=0. Singularity flag. If singularities are found, then
SING will be set to -1; otherwise +1.
EPPRT Input-real-default=0.0. Singularity print parameter. Singularities greater than
EPPRT will not be printed if PRGPST='YES'.
NOSET Input/output-integer-default=0. Constraint, omit, and support set flag. Set to
-1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no
degrees-of-freedom defined in the a-set (e.g., ASETi, QSETi Bulk Data
entries); +1 otherwise.
NGERR Output-integer-default=0. Error flag. If errors are encountered, then NGERR
is set to -1; otherwise +1.
MPCMETH Input-character-default='RG'. Multipoint constraint processing method. Also
indicates the type of matrix in the second input position: 'RG' for RMG and
'KMM' for KMM. See Remarks 2 and 3.
NSKIP Input-integer-default=0. The record number in CASECC corresponding to the first
subcase of the current boundary condition.
DONSET Input/output-integer-default=-1. Flag to execute GPSP again for automatic MPC
processing.
-1 Execute GPSP again to process the n-set stiffness matrix (KNN).
0 Do not execute GPSP again.
RESID Input-integer-default=1. Residual structure flag. -1 means residual structure. Used
only in SOLs 106 and 400.
Main Index
943 GPSP
Performs auto-SPC operation
Remarks:
1. YS0 and YS may be purged.
2. For the most reliable identification and constraint of singularities on independent degrees-of-
freedom connected multipoint constraints or rigid elements then GPSP should be executed after
MCE1 and MCE2. Then KNN and KMM should be specified for the first two inputs and 'KMM'
should be specified for MPCMETH. For example, from subDMAP SEKR0:
UPARTN USET0,KGG/KMM,,,/'G'/'M'/'N' $
MCE2 USET0,GM,KGG,,,/KNN,,, $
GPSP KNN,KMM,...
...S,N,NGERR/'KMM' $
If KMM is purged then some singular rotational independent degrees-of-freedom may not be
identified unless all rotations at a given point are independent.
3. If GPSP is executed before MCE1 and MCE2 then KGG and RMG should be specified. Also, the
default for MPCMETH should be used.
GPSP KGG,RMG,...
If RMG is purged then singular independent degrees-of-freedom connected to multipoint
constraints or rigid elements will not be identified or constrained.
4. ACON should be set to -1 if processing a superelement.
NNEWS Input/output-integer-default=0. The number of new s-set degrees-of-freedom.
NNEWM Input/output-integer-default=0. The number of new m-set degrees-of-freedom.
Main Index
GPSTR1
Computes element to grid point interpolation factors
944
Computes element to grid point interpolation factors for grid point stress computations.
Format
:
Input Data Blocks:
Output Data Block:
Parameter:
Remark:
CSTM may be purged.
GPSTR1
Computes element to grid point interpolation factors
GPSTR1 POSTCDB,BGPDT,EST,CSTM,ELSET,ESTNL,UNUSED7,CASECC/
EGPSF/
S,N,NOEGPSF $
POSTCDB Table of commands from the OUTPUT(POST) Section of Case Control.
BGPDT Basic grid point definition table.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
ELSET Table of element sets defined in OUTPUT(POST) or SETS DEFINITION
Section of Case Control.
ESTNL Nonlinear element summary table.
UNUSED7 Unused and may be purged.
CASECC Table of Case Control command images.
EGPSF Table of element to grid point interpolation factors.
NOEGPSF Output-integer-default=-1. EGPSF creation flag. Set to zero if EGPSF is
created.
Main Index
945 GPSTR2
Computes grid point stresses or strains
Computes grid point stresses or strains interpolated from element centroid stresses or strains.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
GPSTR2
Computes grid point stresses or strains
GPSTR2 CASECC,EGPSF,BGPDT,OES1,OESNLXR/
OGS1,EGPSTR/
S,N,NOOGS1/S,N,NOEGPSTR/APP/NLSTRAIN/GPSOPT $
CASECC Table of Case Control command images.
EGPSF Table of element to grid point interpolation factors.
BGPDT Basic grid point definition table.
OES1 Table of element stresses or strains in SORT1 format.
OESNLXR Table of nonlinear element stresses in SORT1 format and appended for all subcases.
OGS1 Table of grid point stresses or strains in SORT1 format.
EGPSTR Table of grid point stresses or strains for post-processing in the DBC module.
NOOGS1 Output-integer-default=-1. OGS1 creation flag. Set to 0 if OGS1 is created.
NOEGPSTR Output-integer-default=-1. EGPSTR creation flag. Set to 0 if EGPSTR is
created.
APP Input-character-default='STATICS'. Analysis type. Allowable values are:
'STATICS' Statics
'REIGEN' Normal modes
'TRANRESP' Transient response
NLSTRAIN Logical-input-default=FALSE. Nonlinear strain data recovery, otherwise flag at
word 11 of OES1 takes precedence. Set to TRUE if nonlinear strains are to be
processed.
GPSOPT Input-integer-default=0. Option bits numbered right to left
Bit Description
Main Index
GPSTR2
Computes grid point stresses or strains
946
Remarks:
1. The GPSTRESS Case Control command controls the contents of OGS1.
2. The STRFIELD Case Control command controls the contents of EGPSTR.
1 Requests that direct stresses/strains for volume always be
output. (This is an MSC.ADAMS MNF requirement).
2 Requests that principal stresses/strains for volume always be
output
3 Set device code bit in OGS1's Id record to indicate plot only for
direct stress/strain for volume
4 Set device code bit in OGS1's Id record to indicate plot only for
principal stress/strain for volume
Main Index
947 GPSTRPBX
Performs grid point stress recovery for Arbitrary Beam Cross Section.
Performs grid point stress recovery for Arbitrary Beam Cross Section.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
GPSTRPBX
Performs grid point stress recovery for Arbitrary Beam Cross
Section.
GPSTRPBX OEF1,EPT,PBRMS,PBRMSD,COELEM,EST/
OGS1AB,OES1AB/
S,N,IRECPBR/S,N,KSTATN/S,N,OP2AB $
OEF1 Table of element forces (or fluxes) in SORT1 format.
EPT Element property table
PBRMS Table of intermediate arbitrary beam data.
PBRMSD Table of arbitrary beam data.
COELEM Correlation table between IDCID/EID/component for element responses.
EST Element summary table.
OGS1AB Grid point stresses at vertices of arbitrary beam cross section
OES1AB Table of screenved elment stresses for arbitrary beam cross sections.
IRECPBR Input/output-integer-no default. PBRMS record count.
KSTATN Input/output-integer-no default. PBXSECT station count.
OP2AB Input/output-integer-default=0. Fortran unit number for OUTPUT2.
Main Index
GPWG
Computes center of mass of structure relative to a given point
948
Computes the center of mass of the structure relative to a given point and the principal inertias about the
center of gravity.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Method:
The Grid Point Weight Generator (GPWG) module calculates the masses, centers of gravity, and inertias
of the general mathematical model of the structure. The data are extracted from the matrix by
GPWG
Computes center of mass of structure relative to a given point
GPWG BGPDT,CSTM,UNUSED3,MGG,MEDGE,UNUSED6/
OGPWG/
GRDPNT/WTMASS/ALTSHAPE/SEID $
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
UNUSED3 Unused and may be purged.
MGG Mass matrix in g-size.
MEDGE Edge table for p-element analysis.
UNUSED6 Unused and may be purged.
OGPWG Grid point weight generator table in weight units.
GRDPNT Input-integer-default=-1. Reference grid point identification number. Inertias
are computed GRDPNT. If GRDPNT=-1 then the origin of the basic
coordinate system is used.
WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the
Full Product Space set.
SEID Input-integer-default=-1. Superelement identification number.
M
gg
| |
Main Index
949 GPWG
Computes center of mass of structure relative to a given point
using a rigid body transformation calculation. The transformation is defined by the global coordinate
displacements resulting from unit translations and rotations of the whole body about a reference point.
Because of the scalar mass effects, the total mass may have directional properties, and the center of
gravity may not be a unique location. This effect is shown in the output by giving each of the the three
masses its own direction and center of gravity. The inertia terms are calculated by using the directional
mass effects. The axes about which the inertial terms are calculated may not intersect. However, these
axes are those which provide uncoupled rotation and translation effects. This is the significance of the
term "center of gravity." If the structural model has been constructed using only real masses. the three
masses printed out will be equal, the center of gravity will be unique, and the axes of the inertia terms
will intersect at the center of gravity.
The actual computation proceeds in four parts:
1. Computation of the matrix: six vectors are formed that will describe the six motions about
the reference point. The matrix is formed from the vectors that describe rigid body
displacements in global coordinates in terms of the six unit displacements and rotations in basic
coordinates at the reference point
(4-29)
Method of Generation
Each grid point is considered in order. If it is a scalar point, zero is stored in each of the six
columns of . If it is a grid point,
(4-30)
is computer where is the basic coordinate of the i-th grid point given in the BGPDT table
and is the location of the reference point.
The transformation matrix to the grid point
(4-31)
is formed. GPWG calculates the 3x3 transformation matrix from the global coordinates to
basic coordinates for the grid point. The matrix
D | |
T
D | |
u
g
| | D | | u
o
| | (reference point) =
D | |
r
i
{ } R
i
{ } R
o
{ }
r
1
r
2
r
3 )
`
= =
R
i
{ }
R
o
{ }
T
r
| |
0 r
3
r
2
r
3
0 r
1
r
2
r
1
0
=
T
i
| |
Main Index
GPWG
Computes center of mass of structure relative to a given point
950
(4-32)
is computed. The rows of form the columns of . The matrix is generated a column
at a time and packed out onto a scratch file.
2. If all points were scalar point, GPWG returns; otherwise, form from .
3. is computed
(4-33)
4. Compute output quantities:
is partitioned
(4-34)
The matrix is symmetric, where the superscripts and refer to translation and rotation,
respectively.
A check is made for inconsistent scalar masses. Let
(4-35)
and
(4-36)
If , the coordinates should be rotated. Otherwise . If rotation is necessary,
the eigenvectors of , , , and are determined by the Jacobi technique. Define
(4-37)
The matrix is output. , , and are computed as follows:
(4-38)
(4-39)
(4-40)
d | |
T
i
T
T
i
T
T
r
0 T
i
T
=
d | | D | |
T
D | |
T
D | | D | |
T
M
o
| |
M
0
| | D | |
T
M
gg
| | D | | =
M
o
M
o
| |
M
t
M
tr
M
rt
M
r
t r
o E M
ij
t
( )
2
=
c E M
ij
t
( )
2
i j = =
c o 10
3
> S | | I | | =
M
t
| | e
1
e
2
e
3
S | | e
1
{ } e
2
{ } e
3
{ } , , | | =
S | | M
t
| | M
r
| | M
t r
| |
M
T
| | S | |
T
M
t
| | S | | =
M
tr
| | S | |
T
M
tr
| | S | | =
M
r
| | S | |
T
M
r
| | S | | =
Main Index
951 GPWG
Computes center of mass of structure relative to a given point
The following terms, defined in the principal axis system , , and , are calculated
and output. The mass terms are
(4-41)
(4-42)
(4-43)
The "centers of gravity" are
(4-44)
(4-45)
(4-46)
The inertias at the center of gravity relative to the principal mass axis are determined from
(4-47)
(4-48)
(4-49)
(4-50)
(4-51)
(4-52)
(4-53)
These terms form the symmetric matrix .
e
1
{ } e
2
{ } e
3
{ }
M
x
M
11
t
=
M
y
M
22
t
=
M
z
M
33
t
=
X
x
M
11
tr
M
x
--------- = Y
x
M
13
tr
M
x
------------ = Z
x
M
12
tr
M
x
--------- = , ,
X
y
M
23
tr
M
y
--------- = Y
y
M
22
tr
M
y
--------- = Z
y
M
21
tr
M
y
------------ = , ,
X
z
M
32
tr
M
z
------------ = Y
z
M
31
tr
M
z
--------- = Z
z
M
33
tr
M
z
--------- = , ,
I
11
S ( )
M
11
r
M
y
Z
y
2
M
z
Y
z
2
=
I
12
S ( )
I
21
S ( )
M
12
r
M
z
= X
z
Y
z
=
I
13
S ( )
I
31
S ( )
M
13
r
= M
y
X
y
Z
y
=
I
22
S ( )
M
22
r
M
z
X
y
2
M
x
Z
x
2
=
I
22
S ( )
M
22
r
M
z
X
z
2
M
x
Z
x
2
=
I
32
S ( )
I
23
S ( )
M
23
r
= M
x
Y
x
Z
x
=
I
33
S ( )
M
33
r
M
x
Y
x
2
M
y
X
y
2
=
I | |
Main Index
GPWG
Computes center of mass of structure relative to a given point
952
For principal inertias, eigenvalues and eigenvectors are found such that
(4-54)
where is the same as with sizes of the off-diagonal terms reversed. contains the
normalized eigenvectors (with the directions of the principal inertias), and the are the
eigenvalues. The matrices and are actually coordinate rotation matrices and show the
directions of the principal masses and inertias.
Remarks:
1. BGPDT and OGPWG cannot be purged. If MGG is purged or null, GPWG will return. CSTM
must be present if coordinate systems are used to define the location of one or more grid points.
MEDGE must be present if p-elements are present.
2. GPWG is identical to Option 7 in the VECPLOT module.
3. GPWG calculates the masses, centers of gravity, and inertias of the general mathematical model
of the structure. The data are extracted from the [Mgg] matrix by using a rigid body
transformation calculation. The transformation is defined by the global coordinate displacements
resulting from unit translations and rotations of the whole body about a reference point.
4. Because of the scalar mass effects, the total mass may have directional properties, and the center
of gravity may not be a unique location. This effect is shown in the output by giving for each of
the three masses, its own direction and center of gravity. The inertia terms are calculated by using
the directional mass effects.
The axes about which the inertia terms are calculated may not intersect. However, these axes are
those which provide uncoupled rotation and translation effects. This is the significance of the term
"center of gravity". If the structural model has been constructed using only real masses, the three
masses printed out will be equal, the center of gravity will be unique, and the axes of the inertia
terms will intersect at the center of gravity.
I
11
P
0 0
0 I
22
P
0
0 0 I
33
P
Q | |
T
I | |
Q | | =
I | |
I | | Q | |
I
ii
P
S | | Q | |
Main Index
953 GUST
Computes loads for aerodynamic analysis
Computes loads for aerodynamic analysis that are associated with aerodynamic flow.
Format:
Input Data Blocks:
Output Data Blocks:
GUST
Computes loads for aerodynamic analysis
GUST CASECC,DLT,FRL,DIT,QHJL,UNUSED6,UNUSED7,ACPT,
CSTMA,PHF,APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
PHF1,WJ,QHJK,PFP/
S,N,NOGUST/BOV/MACH/Q $
CASECC Table of Case Control command images.
DLT Table of dynamic loads.
FRL Frequency response list.
DIT Table of TABLEij Bulk Data entry images.
QHJL Aero transformation matrix between h and j sets.
UNUSED6 Unused and may be purged.
UNUSED7 Unused and may be purged.
ACPT Aerodynamic connection and property table.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set and ks-set grid points.
PHF Frequency response load matrix in the h-set (modal).
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous
damping effects
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass effects
ENFMOTN Matrix of enforced motion amplitudes
PHF1 Frequency response load matrix in the h-set (modal) combined with gust
loads.
WJ Gust matrix.
Main Index
GUST
Computes loads for aerodynamic analysis
954
Parameters:
Remarks:
1. If DIT is purged, GUST will return (setting NOGUST = - 1).
2. CSTMA may be purged.
3. Often the shape (time dependence) of the gust is unknown, except for certain statistical
information, e.g., power spectral density and RMS value. In these cases the GUST module must
create frequency-dependent loads. Sometimes the gust shape is specified as a function of time,
which will be analyzed by Fourier transform techniques. Then the frequency dependent loads are
calculated by Fourier transform.
The value of the load is calculated from the downwash distribution. The calculation involves the
aerodynamic formulation. For all methods (except strip theory) the downwash is a part of the
aerodynamic theory used in the AMG-AMP modules. The downwash is associated with the j-set,
which corresponds to the Ajj matrix. The loads are computed from the downwash using
aerodynamic matrices.
The downwash to be provided comes from a simple model of the atmosphere. The velocity is
vertical (in the z-direction of the aerodynamic coordinate system), and appears (to an observer) in
the airplane coordinates to sweep back toward the +x direction. This implies that the downwash
vector has two properties:
It is proportional to the cosine of the dihedral angle for any panel.
There is a time delay of amount X/U for the arrival at any point. (X is streamwise coordinate.)
QHJK Aero transformation matrix between h and j sets.
PFP Frequency response load matrix in the p-set combined with gust loads.
NOGUST Output-integer-no default. Gust load flag. Set to -1 if no gust loads exist;
otherwise set to 1.
BOV Input-real-default=0.0. Conversion from frequency to reduced frequency.
MACH Input-real-default=0.0. Mach number.
Q Input-real-default=0.0. Dynamic pressure.
Main Index
955 GUSTLDW
Computes downwash load due to gust
Computes downwash load due to gust.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
GUSTLDW
Computes downwash load due to gust
GUSTLDW EDT,AERO,CSTMA,MKLIST,AEBGPDT*,SKJ,LAJJT,UAJJT/
QKGUST*/
GUST2ID/S,N,QKGUSTL $
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also ontains SET1 entries.
AERO Table of control information for aerodynamic analysis.
CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +
ks-set grid points.
MKLIST MKLIST Table of Mach number and reduced frequency pairs.
AEBGPDT* Family of aerodynamic basic grid point definition tables.
SKJ Integration matrix.
LAJJT Lower triangular decomposition factor matrix of AJJT.
UAJJT Upper triangular decomposition factor matrix of AJJT.
QKGUST* Family of j-set downwashes (normal washes) matrices qualified bu reduced
frequency, mach number, and gust rotation.
GUST2ID Input-integer-no default. GUST2 Bulk Data identification number.
QKGUSTL Output-logical-default=FALSE. QKGUST* creation flag.
TRUE : QKGUST* was created.
FALSE: QKGUST* was not created.
Main Index
GYROLD
Compute the gyroscopic static loads.
956
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remark:
Determine in which subcases RGYRO and RFORCE are referenced and then make a kvector for
each subcase from the entries KGGG and the rotation vector from the RFORCE entry.
GYROLD
Compute the gyroscopic static loads.
GYROLD CASECC,CSTM,BGPDT,SLT,KGGG*/
PJR,UNUSED/
GYLDOPT/LOADID/RFORSCAL/RACCSCAL $
CASECC Table of Case Control command images.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SLT Static loads (RFORCE and LOAD entries).
KGGG* Family of gyroscopic matrices qualified by RGYRO identification number.
PJR Gyroscopic static load matrix for the g-set of the current superelement and
applied to its interior points only.
UNUSED Unused and may be unspecified.
GYLDOPT Input-integer-default=0. Static gyroscopic load generation option:
1 Compute the load for statics rotordynamics
2 Compute the coriolis matrix for dynamic analysis with static subcase
(rotordynamics in rotating coordinates).
LOADID Input-integer-default=0. Load set identification number for the current
subcase.
RFORSCAL Input-real-default=0. Scale factor for the loads defined in the RFORCE
record.
RACCSCAL Input-real-default=0. Scale factor for the RACC value in the RFORCE
record.
Main Index
957 IFP
Reads Bulk Data Section
Reads in the Bulk Data and outputs the finite element model in table form.
Format:
Input Data Block:
Output Data Blocks:
IFP
Reads Bulk Data Section
IFP BULK/
GEOM1,EPT,MPT,EDT,DIT,DYNAMIC,GEOM2,
GEOM3,GEOM4,EPTA,PCOMPT,MATPOOL,AXIC,PVT,DMI,
DMINDX,DTI,DTINDX,DEFUSET,EDOM,DEQATN,DEQIND,
CONTACT,OINT,UNUSED25/
S,N,NOGOIFP/S,N,RUNIFP3/S,N,RUNIFP4/
S,N,RUNIFP5/S,N,RUNIFP6/S,N,RUNIFP7/S,N,RUNIFP8/
S,N,RUNIFP9/SEID/S,N,RUNMEPT/S,N,RUNIFP10/
S,N,RUNIFBS2 $
BULK Table of all Bulk Data entries.
GEOM1 Table of Bulk Data entry images related to geometry.
EPT Table of Bulk Data entry images related to element properties.
MPT Table of Bulk Data entry images related to material properties.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
DIT Table of TABLEij Bulk Data entry images.
DYNAMICS Table of Bulk Data entry images related to dynamics.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
EPTA Secondary table of Bulk Data entry images related to element properties.
UNUSED11 Unused and may be purged.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
Main Index
IFP
Reads Bulk Data Section
958
Parameters:
Remarks:
1. IFP does not stop on error detection, therefore, the DMAP sequence must contain a statement to
terminate the run. For example,
IF (NOGOIFP) EXIT$
2. IFP must appear at the beginning of the DMAP sequence after the IFP1 and XSORT modules and
before any other module.
Example:
Read the Bulk Data Section and update applicable records for acoustic, hydroelastic, hyperelastic,
composite beam and shell, axisymmetric, and beam library analyses.
IFP iBULK/
AXIC Table of Bulk Data entry images related to conical shell, hydroelastic, and
acoustic cavity analysis.
PVT Table containing parameter values from PARAM Bulk Data entry images.
DMI Table of all matrices specified on DMI Bulk Data entries.
DMINDX Index into DMI.
DTI Table of all matrices specified on DTI Bulk Data entries.
DTlNDX Index into DTI.
DEFUSET Table of DEFUSET Bulk Data entry images.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
CONTACT Table of Bulk Data entries related to contact regions.
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
UNUSED25 Unused and may be purged.
NOGOIFP Logical-output-default=FALSE. Set to TRUE if an error is detected.
RUNIFPi Logical-output-default=FALSE. Set to TRUE if IFPi module execution is
required.
SEID Integer-input-default=-1. Superelement identification number.
RUNMEPT Logical-output-default=FALSE. Set to TRUE if MODEPT module execution
is required.
RUNIFBS2 Logical-output-default-FALSE. Set to TRUE if IFPBSH2 module execution
is required.
Main Index
959 IFP
Reads Bulk Data Section
GEOM1.0,EPT.0,MPT.0,IEDT,IDIT,IDYNAMIC,
GEOM2.0,GEOM3.0,GEOM4.0,EPTA,IPCOMPT.0,
MTPOL.0,IAXIC,IPVT,IDMI,IDMINDX,IDTI,IDTINDX,
DEFUSET,IEDOM,IDEQATN,IDEQIND,CONTACT,OINT,UNUSED2/
S,N,NOGOIFP/S,N,RUNIFP3/S,N,RUNIFP4/S,N,RUNIFP5/
S,N,RUNIFP6/S,N,RUNIFP7/S,N,RUNIFP8/S,N,RUNIFP9//
S,N,RUNMEPT/S,N,RUNIFP10 $
$
PVT IPVT,iCASECC/ $ RESOLVE PARAMETER VALUES SET IN CASE CONTROL
$
IF ( RUNIFP3 ) THEN $
IFP3 IAXIC/GEOM1.3,GEOM2.3,GEOM3,GEOM4.3/S,N,NOGOIFP3 $
ELSE $
EQUIVX GEOM1.0/GEOM1.3/-1 $
EQUIVX GEOM2.0/GEOM2.3/-1 $
EQUIVX GEOM3.0/iGEOM3 /-1 $
V V.0/GEOM4.3/-1 $
ENDIF $
$
IF ( RUNIFP4 ) THEN $
IFP4 IAXIC,GEOM1.3,GEOM2.3,GEOM4.3,MTPOL.0/
GEOM1.4,GEOM2.4,IGEOM4,IMATPOOL/S,N,NOGOIFP4 $
ELSE $
EQUIVX GEOM1.3 /GEOM1.4/-1 $
EQUIVX V2.3 /GEOM2.4/-1 $
EQUIVX V4.3 /iGEOM4 /-1 $
EQUIVX MTPOL.0/IMATPOOL/-1 $
ENDIF $
$
IF ( RUNIFP5 ) THEN $
IFP5 IAXIC,GEOM1.4,GEOM2.4/IGEOM1.5,IV2.5/
S,N,NOGOIFP5 $
ELSE $
EQUIVX GEOM1.4/iGEOM1.5/-1 $
EQUIVX GEOM2.4/iGEOM2.5/-1 $
ENDIF $
$
IF ( RUNIFP8 ) THEN $
IFP8 MPT.0,IDIT/MPT.8/S,N,NOGOIFP8 $
ELSE $
EQUIVX MPT.0/MPT.8/-1 $
Main Index
IFP1
Reads Case Control Section
960
Reads the Case Control Section.
Format:
Output Data Blocks:
Parameter:
Remarks:
1. IFP1 does not stop if an error is detected in the Case Control Section; therefore, the following
statement should appear after the module:
IFP1
Reads Case Control Section
IFP1 /CASECC,PCDB,XYCDB,POSTCDB,FORCE,MMCDB/
S,N,NOGOIFP1/S,N,LASTCC/S,N,BEGSUP/STEPPR $
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
XYCDB Table of x-y plotting commands.
POSTCDB Table of commands from the OUTPUT(POST) Section of Case Control.
FORCE Table of MSGSTRESS plotting commands defined under the
OUTPUT(CARDS) Section in CASE CONTROL and MSGMESH field
information.
MMCDB Table of MAXMIN(DEF) specifications.
NOGOIFP1 Logical-output-default=FALSE. Set to TRUE if an error is detected in the
Case Control Section.
LASTCC Integer-output-default=0. Set to 2 if the last auxiliary model Case Control
Section is being processed.
BEGSUP Logical-output-default=FALSE. BEGIN SUPER flag. Set to TRUE if the
first Bulk Data Section begins with BEGIN SUPER instead of BEGIN
BULK.
STEPRR Input-logical-default=FALSE. STEP Case Control command flag. Set to
TRUE if the STEP command is allowed in the current solution sequence.
QKGUSTL Output-logical-default=FALSE. QKGUST* creation flag.
TRUE : QKGUST* was created
FALSE: QKGUST* was not created
Main Index
961 IFP1
Reads Case Control Section
IF (NOGOIFP1) EXIT $
2. IFP1 may be executed only once and should appear at the beginning of the DMAP sequence
before any other module.
Example:
Read multiple Case Control Sections in a loop. Each Case Control Section is prefaced with the
AUXCASE and AUXMODEL commands. The outputs from IFP1 are to be qualified on auxiliary model
identification number.
DO WHILE ( LASTCC<>2 ) $
IFP1 /XCASECC,XPCDB,XXYCDB,XPOSTCDB,XFORCE/
S,N,NOGOIFP1/S,N,LASTCC $
PARAML XCASECC//'DTI'/1/258//S,N,AUXMID $
EQUIVX XCASECC/CASEXX/-1 $
EQUIVX XPCDB/PCDB/-1 $
EQUIVX XXYCDB/XYCDB/-1 $
EQUIVX XPOSTCDB/POSTCDB/-1 $
EQUIVX XFORCE/FORCE/-1 $
ENDDO $
Main Index
IFP3
Modifies Bulk Data entry records
962
Modifies Bulk Data entry records related to axisymmetric conical shell analysis.
Format:
Input Data Block:
Output Data Blocks:
Parameter:
Remarks:
1. IFP3 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP3 should
be checked before proceeding to the GP1 module
2. IFP3 must appear after the IFP1 and before the IFP4 modules.
3. The axisymmetric Bulk Data entry records modified by IFP3 are:
IFP3
Modifies Bulk Data entry records
IFP3 AXIC/GEOM1X,GEOM2X,GEOM3X,GEOM4X/S,N,NOGOIFP3 $
AXIC Table of Bulk Data entry images related to axisymmetric conical shell,
hydroelastic, and acoustic cavity analysis.
GEOM1X GEOM1 table related to axisymmetric conical shell analysis.
GEOM2X GEOM2 table related to axisymmetric conical shell analysis.
GEOM3X GEOM3 table related to axisymmetric conical shell analysis.
GEOM4X GEOM4 table related to axisymmetric conical shell analysis.
NOGOIFP3 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
Bulk Data
Entry Record Output Records Output Data Blocks
AXIC None None
CCONEAX CCONE GEOM2
FORCEAX FORCE GEOM3
MOMAX MOMENT GEOM3
Main Index
963 IFP3
Modifies Bulk Data entry records
4. The other Bulk Data entries recognized and processed by IFP3 are:
Example
See the example in the IFP, 957 module description.
MPCAX MPC GEOM4
OMITAX OMIT GEOM4
POINTAX MPC GEOM4
GRID GEOM1
PRESAX PLOAD GEOM3
RINGAX SPC GEOM4
GRID GEOM1
SECTAX MPC GEOM4
GRID GEOM1
SPCAX SPC GEOM4
SUPAX SUPORT GEOM4
TEMPAX TEMP GEOM3
Bulk Data
Entry Record Output Records Output Data Blocks
FORCE, GRAV, LOAD, MOMENT, TEMPD, TEMP, GRID,
MPCADD, OMIT, SEQGP, SPC, SPCADD, and SUPORT
Main Index
IFP4
Processes hydroelastic-related Bulk Data entry records
964
Processes hydroelastic-related Bulk Data entry records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. IFP4 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP4 should
be checked before proceeding to the GP1 module
2. IFP4 must appear after the IFP3 and before the IFP5 modules.
IFP4
Processes hydroelastic-related Bulk Data entry records
IFP4 AXIC,GEOM1,GEOM2,GEOM4,MATPOOL/
GEOM1X,GEOM2X,GEOM4X,MATPOOLX/S,N,NOGOIFP4 $
AXIC Table of Bulk Data entry images related to axisymmetric conical shell,
hydroelastic, and acoustic cavity analysis.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
GEOM1X GEOM1 table related to hydroelastic analysis.
GEOM2X GEOM2 table related to hydroelastic analysis.
GEOM4X GEOM3 table related to hydroelastic analysis.
MATPOOLX MATPOOL table related to hydroelastic analysis.
NOGOIFP4 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
Main Index
965 IFP4
Processes hydroelastic-related Bulk Data entry records
3. The following is a list of Bulk Data entry records generated or modified by IFP4:
Example:
See the example in the IFP, 957 module description.
Bulk Data
Entry Record Output Records Output Data Blocks
AXIF None None
BDYLIST Various MATPOOLX
CFLUID2 CFLUID2 GEOM2X
CFLUID3 CFLUID3 GEOM2X
CFLUID4 CFLUID4 GEOM2X
FLSYM Various MATPOOLX
FREEPT SPOINT GEOM2X
MPC GEOM4X
FSLIST CFSMASS GEOM2X
SPC GEOM4X
GRIDB GRID GEOM1X
PRESPT SPOINT GEOM2X
MPC GEOM4X
RINGFL GRID GEOM1X
SEQGP GEOM1X
DMIAX DMIG MATPOOLX
Main Index
IFP5
Process acoustic cavity-related Bulk Data entry records
966
Process acoustic cavity-related Bulk Data entry records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. IFP5 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP5 should
be checked before proceeding to the GP1 module.
2. IFP5 must appear after the IFP4 and before the IFP6 modules.
3. The following is a list of Bulk Data entry records generated or modified by IFP5:
IFP5
Process acoustic cavity-related Bulk Data entry records
IFP5 AXIC,GEOM1,GEOM2/
GEOM1X,GEOM2X/S,N,NOGOIFP5 $
AXIC Table of Bulk Data entry images related to axisymmetric conical shell,
hydroelastic, and acoustic cavity analysis.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
GEOM1X GEOM1 table related to acoustic cavity analysis.
GEOM2X GEOM2 table related to acoustic cavity analysis.
NOGOIFP5 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
Input Record Input Data Block Output Record Output Data Block
AXSLOT AXIC None None
CAXIF2 GEOM2 PLOTEL GEOM2X
CAXIF3 GEOM2 PLOTEL GEOM2X
Main Index
967 IFP5
Process acoustic cavity-related Bulk Data entry records
Example:
See the example in the IFP, 957 module description.
CSLOT3 GEOM2 PLOTEL GEOM2X
CSLOT4 GEOM2 PLOTEL GEOM2X
CAXIF4 GEOM2 PLOTEL GEOM2X
GRIDF AXIC GRID GEOM1X
GRIDS AXIC GRID GEOM1X
SLBDY AXIC CELAS2 GEOM2X
Input Record Input Data Block Output Record Output Data Block
Main Index
IFP6
Creates PSHELL and MAT2 Bulk Data entry records
968
Create PSHELL and MAT2 Bulk Data entry records based upon data on PCOMP and MAT8 bulk data
entry records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
IFP6
Creates PSHELL and MAT2 Bulk Data entry records
IFP6 EPT,MPT,DIT,PCOMPT/
EPTC,MPTC,PCOMPTC/v
S,N,NOGOIFP6/S,N,NOCOMP/DSFLAG $
EPT Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries.
MPT Table of Bulk Data entry images related to material properties, in particular,
MAT2 and MAT8 entries.
DIT Table of TABLEij Bulk Data entry images.
PCOMPT Table containing LAM option input from the PCOMP Bulk Data entry.
EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL
records.
MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2
records.
PCOMPTC Table containing LAM option input and expanded information from the
PCOMP Bulk Data entry.
NOGOIFP6 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
NOCOMP Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry
records are found.
DSFLAG Input-logical-default=FALSE. Design sensitivity flag. Set to TRUE for
design sensitivity job.
Main Index
969 IFP6
Creates PSHELL and MAT2 Bulk Data entry records
Remarks:
1. IFP6 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP6 should
be checked before proceeding to the GP1 module.
2. IFP6 must appear after the IFP and before the IFP7 modules.
Example:
See the example in the IFP, 957 module description.
Main Index
IFP7
Creates PBEAM Bulk Data entry records
970
Create PBEAM Bulk Data entry records based upon data on PBCOMP Bulk Data entry records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. IFP7 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP7 should
be checked before proceeding to the GP1 module.
2. IFP7 must appear after the IFP6 and before the IFP8 modules.
Example:
See the example in the IFP, 957 module description.
IFP7
Creates PBEAM Bulk Data entry records
IFP7 GEOM2,EPT,MPT,DIT/EPTX/S,N,NOGOIFP7 $
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EPT Table of Bulk Data entry images related to element properties; in particular,
PBCOMP entries.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
EPTX Copy of EPT except PBCOMP records are replaced by equivalent PBEAM
records.
NOGOIFP7 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
Main Index
971 IFP8
Creates MATHP Bulk Data entry records
Create MATHP Bulk Data entry records based upon data on the TABLES1 Bulk Data entry records for
use in hyperelastic analysis.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. IFP8 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP8 should
be checked before proceeding to the GP1 module.
2. IFP8 must appear after the IFP4 and before the IFP9 modules.
3. IFP8 modifies the MATHP Bulk Data entry records using least squares fitting of experimental
data referenced on TABLES1 Bulk Data entry records to analytically obtained solutions.
Example:
See the example in the IFP, 957 module description.
IFP8
Creates MATHP Bulk Data entry records
IFP8 MPT,DIT/MPTX/S,N,NOGOIFP8 $
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
MPTX Copy of MPT except applicable MATHP records are updated to include
referenced TABLSE1 Bulk Data entry information
NOGOIFP8 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
Main Index
IFP9
Creates PBAR and PBEAM Bulk Data entry records
972
Create PBAR and PBEAM Bulk Data entry records based upon data on PBARL and PBEAML Bulk Data
entry records.
Format:
Input Data Block:
Output Data Blocks:
Parameter:
Remarks:
1. IFP9 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP9 should
be checked before proceeding to the GP1 module.
2. IFP9 must appear after the IFP modules.
IFP9
Creates PBAR and PBEAM Bulk Data entry records
IFP9 EPT,GEOM1,EDT,GEOM2/EPTX,PBRMS/S,N,NOGOIFP9/
ARBMPS/ARBMFEM $
EPT Table of Bulk Data entry images related to element properties; in particular,
PBARL and PBEAML entries.
GEOM1 Table of Bulk Data entry images related to geometry.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EPTX Copy of EPT except PBARL and PBEAML records are replaced by
equivalent PBAR and PBEAM records
PBRMS Table of intermediate arbitrary beam data.
NOGOIFP9 Logical-output-default=FALSE. Set TRUE if an error is detected in the Bulk
Data entries.
ARBMPS Input-logical-default-FALSE.
ARBMFEM Input-logical-default-FALSE.
Main Index
973 IFP9
Creates PBAR and PBEAM Bulk Data entry records
Example:
See the example in the module description of IFP, 957.
Main Index
IFP10
Converts IFP tables for topology optimization
974
Construct new GEOM2, EPT, and MPT tables based upon data supplied by the TOPVAR
entry for topology optimization.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
IFP10
Converts IFP tables for topology optimization
IFP10 GEOM2,EPT,MPT,EDOM/
GEOM2T,EPTT,MPTT,TOPTAB,TOPELE/
S,N,NOGOIF10 $
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EPT Table of Bulk Data entry images related to element properties.
MPT Table of Bulk Data entry images related to material properties.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
GEOM2T GEOM2 updated for topology optimization.
EPTT EPT updated for topology optimization.
MPTT MPT updated for topology optimization.
TOPTAB Table containing topologically-designed properties.
TOPELE Table containing topologically-designed elements.
NOGOIF10 Output-logical-default=false. Set TRUE for an error is detected in the Bulk
Data entries.
Main Index
975 IFPINDX
Creates an IFP table index keyed by identification number
Creates an index, keyed by identification number for any IFP table.
Format:
Input Data Blocks:
None.
Output Data Blocks:
Parameters:
None.
Remarks:
1. IFPDB must be declared as an append file on the FILE statement.
2. IFPDB must contain a key word in the first word of each tuple of the ifp header word. Currently
only fixed length Bulk Data entries are supported.
IFPINDX
Creates an IFP table index keyed by identification number
IFPINDX /IFPDB $
IFPDB Any table data block output by modules IFP, IFPi, MODEPT,
MODGM2, and MODGM4.
Main Index
IFPBSH2
Check PBUSH2D references for TABLED5 and DEQATN entries
976
Check PBUSH2D references for TABLED5 and DEQATN entries.
Format:
Input Data Blocks:
Output Data Blocks:
None
Parameters:
IFPBSH2
Check PBUSH2D references for TABLED5 and DEQATN entries
IFPBSH2 EPT,DIT,DEQATN,DEQIND//S,N,NOGOIFB2 $
EPT Element property table
DIT Table of TABLEij Bulk Data entry images
DEQATN Table of DEQATN Bulk Data entry images
DEQIND Index table to DEQATN
NOGOIFB2 Output-logical-default=FALSE. Set TRUE if an error is detected in the
PBUSH2D Bulk Data entries.
Main Index
977 IFT
Performs an inverse Fourier transform
Performs an inverse Fourier transform to convert the frequency response solution matrix to the time
domain.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Purpose:
The purpose of this module is to obtain solutions versus time for frequency response for which the forces
are only known as functions of frequency.
The definition of the inverse transform is
IFT
Performs an inverse Fourier transform
IFT UXF,CASECC,TRL,FOL/
UXT,TOL/
IFTM $
UXF Solution matrix from frequency response analysis in d- or h-set.
CASECC Table of Case Control command images.
TRL Transient response list.
FOL Frequency response frequency output list.
UXT Solution matrix from transient response analysis in d- or h-set.
TOL Transient response time output list.
IFTM Input-integer-default=1. Fourier transform method.
0
Constant
1
Piecewise linear (default)
2
Cubic spline
Main Index
IFT
Performs an inverse Fourier transform
978
(4-55)
where is considered to be a known input (frequency response, and is the output (time
response). Several approximations will be used for evaluation of (4-55). A special algorithm is to be used
for equal s, which can result in savings of computation times. A special algorithm will be introduced
to provide for a cubic spline fit for between the data points.
Method:
General Approach. The integral will be expressed as a finite sum. The input data block UXF has
one row for each mode, and a column (complex) for each frequency. The output UXT will have the same
number of rows, but with these columns for each time step. Frequencies and times have been selected via
standard FREQi and TSTEP Bulk Data entries. Each row of the input matrix is transformed into a row
of the output.
The basic sume is given by
(4-56)
(4-57)
(4-58)
where:
=
1, 2,...,NTIME
=
=
the complex quantity in the i-th row and the n-th column of UHVF.
=
the second derivative, found by the method of splines.
u
i
t ( )
1
t
--- Re
0
}
u
i
e ( )e
iet
| |de =
u
e ( ) u t ( )
Ae
u
e ( )
u
i
t
m
( )
1
t
--- Re
n 1 =
NFREQ
C
mn
u
i
e
n
( ) D
mn
u
i
e
n
( ) + { }e
ie
n
t
m
| | =
u
i
t
m
( )
1
t
--- Re
n 1 =
NFREQ
ie
n
C
mn
u
i
e
n
( ) D
mn
u
i
e
n
( ) + { }e
ie
n
t
m
| | =
u
i
t
m
( )
1
t
--- Re
n 1 =
NFREQ
e
n
2
C
mn
u
i
e
n
( ) { }e
ie
n
t
m
| | =
m
e
n
2t f
n
f frequency = ( )
u
i
e
n
( )
u
i
e
n
( )
Main Index
979 IFT
Performs an inverse Fourier transform
(4-59)
(4-60)
The functions and will be discussed later.
For the first , only the second term of and is used; and, for the last , only the first term is used.
Values for and .
If the frequency data have equal s,
then the special equal frequency intervals methods are to be used. Otherwise, the general case will be
assumed. In the sum, the following assuptions can be made
For the equal , we will force to be an integer multiplf of . Define integer
, rounded up. Then replace the users by .
In the equal , is given by
=
the real quantity output on UHVT.
Re =
"Real part of." Note: for efficiency
Parameter
IFTM
General
0
(for first if
).
( first, last
).
1
function of , and
special for first, last .
2
are functions of ,
only. Special for first and last .
(See (4-57).)
See (4-57) and (4-58).
u
i
t
n
( )
ReCu ReCu Reu Imc Imu =
C
mn
e
n
e
n 1
2
--------------------------E
2
it
m
e
n
e
n 1
( ) ( ) =
e
n 1 +
e
n
2
--------------------------E
2
+ it
m
e
n 1 +
e
n
( ) ( ) +
D
mn
e
n
e
n 1
( )
3
24
--------------------------------- G it
m
e
n
e
n 1
( ) ( )
e
n 1 +
e
n
( )
3
24
----------------------------------G e
n 1 +
e
n
( ) =
E
2
G
e C D e
C D
Ae
e
n
e
n 1
( ) e
2
e
1
( ) 10
6
e
2
e
1
( ) <
Equal Ae At ,
E
2
1 = e
e 0 = E
2
1 2 = ,
E
2
1 = 1 2
D
mn
0 =
D
mn
0 =
C
m
= m
e
D
mn
0 =
C
mn
0 =
C
m
D
mn
, m
e
C
m
=
Ae e
2
t
m
2t At ( )
N 2t = At At ( ) At At 2t NAe =
Ae et
Main Index
IFT
Performs an inverse Fourier transform
980
(4-61)
A table for will be made of
(4-62)
Then
(4-63)
where
(4-64)
The table can be created with recurrence. For unequal , then
(4-65)
where the COS and SIN subroutines will be called.
The funtions and will have special formulas depending upon the size of their argument.
(4-66)
(4-67)
(4-68)
(4-69)
(4-70)
e
n
t
m
nmAet 2t
nm
N
-------
\ .
| |
= =
k 0 N 1 ( ) , =
C
k
2tk N ( ) cos =
S
k
2tk N ( ) sin =
e
ie
n
t
m
C
k
iS
k
+ =
k
Mod nm ( )
N
=
Ae
e
ie
n
t
m
e
n
t
m
( ) i e
n
t
m
( ) sin + cos =
E
2
G
E
2
iu ( )
1 u cos
1
2
--- u
2
---------------------
\ .
|
|
| |
i
u u sin
1
2
--- u
2
--------------------
\ .
|
|
| |
u u
0
> + =
= 1
u
2
3 4
----------
u
4
3 4 5 6
------------------------- + . +
\ .
| |
i
u
3
---
u
5
3 4 5
------------------
u
5
3 4.7
-------------------- + . +
\ .
| |
u u
0
< +
G iu ( ) 2E
2
iu ( ) E
4
iu ( ) =
E
4
iu ( )
u
2
2
----- 1 u cos +
u
4
24
------
---------------------------------
u
3
6
----- u u sin +
u
4
24
------
-------------------------------- u u
0
> + =
= 1
u
2
5 6
----------
u
4
5 6 7 8
------------------------- + +
\ .
| |
i
u
5
---
u
3
5 6 7
----------------- -
.5
5.9
------------ + . +
\ .
| |
u u
0
< +
Main Index
981 IFT
Performs an inverse Fourier transform
. The alternating series is continued until the last term computed is less than .
When IFTM = 2, a spline fit must be made to solve for . This will be done by a backward and forward
pass over the frequencies . The same method is used for equal or unequal . On the initializing
backward pass, compute real .
(4-71)
For each row, do a backward and forward pass. The and can be stored in the same locations.
The backward pass:
(4-72)
The forward pass:
(4-73)
Then continue for .
u
0
0.1 = 10
9
u
e Ae
A
n
n NFREQ 1 . 2 , , = ( )
N
NFREQ
0 =
A
N
e
n
e
n 1
( )
2 e
n 1 +
e
n 1
( ) e
n 1 +
e
n
( )A
n 1 +
------------------------------------------------------------------------------------------- =
B
n
u
e
n
( )
B
NFREQ
0 =
B
N
6
u
n 1 +
u
e
n 1 +
e
n
--------------------------
u
n
u
n 1
e
n
e
n 1
-------------------------
\ .
| |
e
n 1 +
e
n
( )A
n 1 +
B
n 1 +
e
n
e
n 1
--------------------------------------------------------------------------------------------------------------------------------------- =
n NFREQ 1 ( ) . 3 2 , , , =
(real and imaginary)
u
e
1
( )
6
u
2
u
e
2
e
1
------------------- e
2
e
1
( )A
2
B
2
6e
1
e
2
e
1
( ) 2 A
2
( ) +
----------------------------------------------------------------- Real Part
0 Imaginary Part
=
2 . NFREQ , ,
u
n ( ) A
n
B
n
u
n 1
( ) =
Main Index
ILMP1
Creates unit displacement matrix
982
Creates a unit displacement matrix on those DOFs that contribute to the monitored components. This
matrix will be G-set size rows by contributed DOF in columns. Also creates a CASECC table associated
with the columns of the unit displacement matrix and the g-set size column partitoning vector that mark
the contributing DOF's.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ILMP1
Creates unit displacement matrix
ILMP1 EST,BGPDT,EDT,EDT0/
CASEUNIT,UNITDISP,UNITPV,EDTM/
S,N,NCOLUNIT $
EST Element summary table.
BGPDT Basic grid point definition table.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
EDT0 Table of archived set of MONPNT2 records to be merged into EDTM.
CASEUNIT Table of Case Control parameters requesting to a unit displacements. In
addition, the monitor points will be expressed as various sets of output
depending on what is being monitored.
UNITDISP Unit displacement matrix where each row represents a unit displacement at a
degree-of-freedom. Only degrees-of-freedom which participate in the union
of all monitor points will contain a unit displacement. UNITDISP has LUSET
number of columns.
UNITPV Partitioning vector (g-set) with 1.0 at each grid where a unit displacement is
requested. (All 6 degrees-of-freedom will be assumed to contribute).
EDTM Archival of EDT containing just the monitor records.
NCOLUNIT Output-integer-default=-1. Number of unit displacement columns written. If
NCOLUNIT<=0 then none were written.
Main Index
983 ILMP2
Creates output transformation matrix
Creates the output transformation matrix for a particular OFP table type.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ILMP2
Creates output transformation matrix
ILMP2 EDT,OFP12,OFP22,OFP32/
OTMT,RLABEL/
NCOLMNP2 $
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries. Specifically, this module reads the
MONITOR2 record.
OFPi2 Output table in SORT2 format.
OTMT Transpose of the output transformation matrix. Each column of the matrix
will be associated with a single ILMP (and labeled in RLABEL). The rows
will be the partition of g-set size DOFs that are contributing (CP defined).
RLABEL Monitor point label for each column in OTMT.
NCOLMNP2 Input-integer-default=0. Number of degrees-of-freedom associated with the
MONPNT2 entries.
Main Index
ILMPGPF 984
Filters the grid point force output table according to the MONPNT3 entries down to a single monitor
point.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
ILMPGPF
ILMPGPF MP3GPF,EDT,BGPDT,CSTM,OGPFB1/
GPFMAT/
NDDLNAME $
MP3GPF Table of monitor point type-3 responses.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries. Specifically, this module reads the
MONPNT3 and SET1 records.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
OGPFB1 Table of grid point forces.
GPFMAT Matrix of monitor point force data where each column is a subcase and each
row is one component of the monitored forces.
NDDLNAME Input-character-default='OGF'. NDDL name of the OGPFB1 data block.
Main Index
985 INDXBULK
Indexes the Bulk Data table
Indexes the Bulk Data table.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remark:
1. INDXBULK only indexes the CORDij, GRID and QSETi records.
INDXBULK
Indexes the Bulk Data table
INDXBULK BULK/BULKINDX $
BULK Table of all sorted Bulk Data entries.
BULKINDX Table of all sorted Bulk Data entries with indices.
Main Index
INPUTT2
Input tables of matrices from a FORTRAN unit
986
Recovers up to five tables or matrices from a FORTRAN unit. This unit may have been written either by
a FORTRAN program or by the companion module OUTPUT2.
Format:
Output Data Blocks:
INPUTT2
Input tables of matrices from a FORTRAN unit
INPUTT2 /DB1,DB2,DB3,DB4,DB5/
ITAPE/IUNIT/LABL/
S,N,HNAME1/S,N,HNAME2/S,N,HNAME3/S,N,HNAME4/
S,N,HNAME5/S,N,DBKNT/
NDDLNAM1/NDDLNAM2/NDDLNAM3/NDDLNAM4/NDDLNAM5 $
DBi Data blocks to be input from the FORTRAN unit.
Main Index
987 INPUTT2
Input tables of matrices from a FORTRAN unit
Parameters:
ITAPE Input-integer-default = 0. ITAPE controls the status of the unit before
INPUTT2 attempts to extract any data blocks. The following controls are
available.
ITAPE Value Action
+n Skip forward n data blocks before reading.
0 Data blocks are read starting at the current position.
-1 or -11 Rewind before reading and position tape past label
(LABL), if any.
-3 or -13 Print data block names, rewind before reading, and
position tape past label, if any.
-5 or -15 Search and output first occurrence of DBi. If none are
found, then a fatal warning message is issued.
-6 or -16 Search and output final occurrence of DBi. If none are
found, then a fatal is issued.
-7 or -17 Search and output first occurrence of DBi. If none are
found, then a warning is issued.
-8 or -18 Search and output final occurrence of DBi. If none are
found, then a warning is issued.
IUNIT Input-integer-no default. IUNIT is the FORTRAN unit number from which
the data blocks are to be read. IUNIT = 0 is not recommended.
LABL Input-character-default = 'XXXXXXXX'. LABL is the label on the
FORTRAN unit. A check of the label may or may not be performed based on
the value of ITAPE as indicated in the following table.
ITAPE Value Tape Label Checked?
+n NO
0 NO
-1 YES
-3 YES
-5 YES
-6 YES
Main Index
INPUTT2
Input tables of matrices from a FORTRAN unit
988
Remarks:
1. Any or all of the output data blocks may be purged. Only nonpurged data blocks will be taken
from the tape. The data blocks will be taken sequentially from the tape starting from a position
determined by the value of the first parameter. Note that the output data block sequence A,B,,, is
the same as ,A,,B, or ,,,A,B.
2. The ASSIGN FMS statement is recommended for assigning the FORTRAN unit. Certain
FORTRAN units are reserved, see Making File Assignments (p. 88) in the MSC Nastran 2012
Installation and Operations Guide for a listing of reserved FORTRAN units.
3. Data blocks will be read from the FORTRAN unit in either binary or neutral format, depending
upon the FORM option of the ASSIGN FMS statement. If no ASSIGN FMS statement is
specified, then binary input is assumed.
4. The format of the FORTRAN binary file is given in the OUTPUT2 description
5. Factor matrices (forms 4, 5, 10, 11, 13 and 15) cannot be processed by INPUTT2.
-7 YES
-8 YES
-11 NO
-13 NO
-15 NO
-16 NO
-17 NO
-18 NO
HNAMEi Output-character-default=' '. Data block name found in the header of DBi
on the Fortran unit.
DBKNT Output-integer-default=0. Total number of data blocks found on IUNIT.
DBKNT is only computed under ITAPE= -3 or -13.
NDDLNAMi Input-character-default=blank. NDDL names corresponding to DB1 through
DB5. If DBi is a matrix, then the corresponding NDDLNAMi is 'MATRIX'.
Used only to read unformatted (binary) Fortran files created on non-native
computers.
ITAPE Value Tape Label Checked?
Main Index
989 INPUTT4
Inputs a matrix from a FORTRAN unit
Reads an ASCII or binary file from a FORTRAN unit and creates a matrix suitable for input to other
modules. OUTPUT4 module output may also be used as input.
Format:
Output Data Blocks:
Parameters:
Remarks:
1. Each matrix is read from IUNIT according to its ASSIGN FMS statement, and the BIGMAT as
shown in the remarks of the OUTPUT4 description.
INPUTT4
Inputs a matrix from a FORTRAN unit
INPUTT4 /M1,M2,M3,M4,M5/NMAT/IUNIT/ITAPE/UNUSED4/BIGMAT $
Mi Matrices
NMAT Input-integer-default=1. NMAT is the number of matrices that have been
written on the user-supplied unit. Must be less than or equal to 5.
IUNIT Input-integer-no default. The value of IUNIT is the FORTRAN unit number
on which the user-supplied matrix was written.
ITAPE Input-integer-default=-1. ITAPE controls the status of the unit before
INPUTT4 tries to extract any matrices as follows:
ITAPE Action
0 None.
-1 Rewind IUNIT before read.
-2 Rewind IUNIT at end.
-3 Both.
UNUSED4 Input-integer-default=1. Unused.
BIGMAT Input-logical-default=FALSE. BIGMAT = FALSE selects the format that
uses a string header as described under Remark 1. But, if the matrix has more
than 65535 rows, then BIGMAT will automatically be set to TRUE regardless
of the value specified.
Main Index
INPUTT4
Inputs a matrix from a FORTRAN unit
990
2. Each real or complex matrix must have been written on IUNIT according to the format below.
For example, in the nonsparse format and binary format (ASSIGN FORM=UNFORMATTED),
each matrix could be created (assumed on FORTRAN unit 8) as follows:
Record 1-four word record
WRITE(8) NCOL,NROW,NF,NTYPE
Record 2,3,etc.
WRITE(8) ICOL,IROW,NW,(X(I),I=1,NW)
If the ASCII format (ASSIGN FORM=FORMATTED) and the nonsparse format is desired, then
each matrix must be created as follows:
Record 1
WRITE(8,100) NCOL,NROW,NF,NTYPE
100 FORMAT(4I8)
Record 2, 3, etc.
WRITE(8,200) ICOL,IROW,NW,(X(I),I=1,NW)
200 FORMAT(3I8,(1P,5E16.9))
The format for X(I) above must be (1P,rEw.d),
where d is the number of digits in the fractional part, w must be greater than d+7, and r is the
integer part of 80/w.
The MSC Nastran "util" directory contains a utility subroutine called MAKIDS in a file called
mattst.f (or .for) which will write a matrix into the format suitable for INPUTT4. See Building
and Using MATTST (p. 248) in the MSC Nastran 2012 Installation and Operations Guide.
Zero terms must be explicitly present from the first nonzero in any column to the last nonzero
term unless the sparse matrix option is used.
Null columns need not be input (they will be properly handled if they are input).
3. The ASSIGN FMS statement is recommended for assigning the FORTRAN unit. Selection of a
proper value for IUNIT is machine dependent. If the ASSIGN statement is not provided, then the
format of the matrices on IUNIT is assumed to be nonsparse and binary. The ASCII format
requires an ASSIGN FMS statement with the FORM = FORMATTED option. Certain
FORTRAN units are reserved, see Making File Assignments (p. 88) in the MSC Nastran 2012
Installation and Operations Guide for a listing of reserved FORTRAN units.
4. The memory required is from the first nonzero entry in the column to the last nonzero entry.
5. Factor matrices from DECOMP and DCMP (matrix forms 4, 5, 10, 11, 13, and 15) cannot be
processed by INPUTT4.
Main Index
991 INTERR
Generates modal components of base motion from a response spectrum
Generates the modal components of base motion from a response spectrum.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
INTERR
Generates modal components of base motion from a response
spectrum
INTERR CASECC,DIT,DYNAMIC,ZETAH,FN,SPECSEL,PSI/
UHR/
CLOSE/OPTION $
CASECC Table of Case Control command images.
DIT Table of TABLEij Bulk Data entry images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
ZETAH Mass-normalized damping.
FN Matrix of natural frequencies (mass normalized stiffness).
SPECSEL Response spectra input correlation table.
PSI Modal partitioning factor matrix.
UHR Modal displacement vector for spectral analysis.
CLOSE Input-real-no default. Close natural frequency scale factor. Under the
OPTION='ABS' method, close natural frequencies will be summed if the natural
frequencies satisfy:
f
i+1 < CLOSE * fi
OPTION Input-character-no default. Response summation method for scaled response spectra
analysis only. Possible values are:
'ABS' Absolute.
'SRSS' Square root of the sum of the squares.
'NRL' Naval Research Laboratory (new).
'NRLO' Naval Research Laboratory (old).
Main Index
INTERR
Generates modal components of base motion from a response spectrum
992
Remark:
Only FN may be purged, in which case INTERR returns.
Main Index
993 ISHELL
Invokes an external program
Invokes an external program.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
ISHELL
Invokes an external program
ISHELL //PRGNAME/S,N,IRTN/NOINT/NOREAL/NOCMPX/NOCHAR/NOUN
IT/
INT1 /INT2 /INT3 /INT4 /
REAL1/REAL2/REAL3/REAL4/
CMPX1/CMPX2/CMPX3/CMPX4/
CHAR1/CHAR2/CHAR3/CHAR4/
IUNIT1/IUNIT2/IUNIT3/IUNIT4 $
PRGNAME Input-character-no default. Name of external program.
IRTN Output-integer-default=0. External program return code.
-1 indicates failure.
NOINT Input-integer-default=0. Number of integer value inputs.
NOREAL Input-integer-default=0. Number of real value inputs.
NOCMPX Input-integer-default=0. Number of complex value inputs.
NOCHAR Input-integer-default=0. Number of character value inputs.
NOUNIT Input-integer-default=0. Number of Fortran input units.
INTi Input-integers-default=0. Integer values.
REALi Input-real-default=-1.0. Real values.
CMPXi Input-complex-default=(-1.0,0.0). Complex values.
CHARi Input-character-default='NULLNULL'. Character values.
IUNITi Input-integer-default=0. Fortran unit numbers.
Main Index
ISHELL
Invokes an external program
994
Remarks:
1. The external program identified by PRGNAME will be passed arguments from MSC Nastran as
specified by the ISHELL parameters. The external program can be either a shell script or an
executable program. It can either mimic an internal module or provide any user-defined
functionality that requires access to MSC Nastran's data structures.
2. MSC Nastran remains in a "wait" state until the external program is completed.
3. OUTPUT2, OUTPUT4, INPUTT2 and INPUTT4 modules are required to pass tables and/or
matrices into the external program.
4. The name of external program must be uppercase and limited to 8 characters.
5. The unit numbers must have associated ASSIGN statements. Based on the ASSIGN statements,
the module will automatically pass the physical filenames associated with unit numbers to the
external program. These filenames are passed at the positions 31 through 34.
6. Errors encountered in ISHELL will not terminate the MSC Nastran execution. To help debug
errors in ISHELL, diagnostic messages may be requested on the nastran command line with
"symbol=MSCBGN=ishelln"; where n can be integer value 1 to 9 with 1 giving the lowest level
of verboseness and 9 giving the highest.
7. IRTN=-1 indicates a failure during invocation of PRGNAME. It is not related to errors
encountered within the invoked script or executable. For example, PRGNAME cannot be found
or does not have execute permission.
8. You will need a utility program to parse the arguments for your external program. For example,
use set -A argarray "$@" or a similar technique.
9. The FORTIO module must be used with ISHELL to OPEN and CLOSE FORTRAN units
referenced by the external program.
Example:
Invoke user executable DOITPGM:
ISHELL //'DOITPGM' $
Main Index
995 LAMX
Eigenvalue Table Editor
Modifies, creates, or converts to matrices the LAMA (real eigenvalues) and CLAMA (complex
eigenvalues) tables.
Formats:
Modify LAMA:
Create LAMA from a matrix:
Convert LAMA into a matrix:
Create CLAMA from a matrix:
Convert CLAMA into a matrix:
Generate new LAMA table based on diagonals of a stiffness and mass matrix:
Input Data Blocks:
LAMX
Eigenvalue Table Editor
LAMX EMAT, LAMA/LAMAX/NLAM/RESFLG $
LAMX FREQMASS,/LAMA/NLAM/RESFLG $
LAMX ,,LAMA/LMAT/-1/RESFLG $
LAMX CLAMMAT,/CLAMA/-1 $
LAMX ,,CLAMA/CLAMMAT/-2 $
LAMX KXX,MXX/LAMAX,LAMMAT/-3/RESFLG $
EMAT Matrix of editing parameters. See Remark 1.
LAMA Normal modes eigenvalue summary table.
FREQMASS Matrix of frequencies and generalized masses. See Remark 2.
Main Index
LAMX
Eigenvalue Table Editor
996
Output Data Blocks:
Parameters:
Remarks:
1. The EMAT matrix has three rows and one column for each mode which are used to modify the
frequency and generalized mass.
If then the frequency
CLAMA Complex eigenvalue summary table.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal.
KXX Stiffness matrix in any set. Usually generalized.
MXX Mass matrix in any set. Usually generalized.
LAMAX Modified LAMA table.
LAMA Normal modes eigenvalue summary table created from FREQMASS.
LMAT Normal modes eigenvalue summary table converted to a matrix. See Remark
3.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal.
LAMMAT Diagonal matrix with real eigenvalues on the diagonal.
NLAM Integer-input-default=0. The maximum number of modes in the output data
block LAMAX. If NLAM = 0, the number of modes in LAMAX will be the same
as that of LAMA or FREQMASS. If NLAM = -1, the matrix LMAT is produced
instead.
RESFLG Integer-input-default=0. Subheading print flag used by the OFP module for
residual vector eigenvalues.
1
Print BEFORE AUGMENTATION OF RESIDUAL VECTORS".
2
Print AFTER AUGMENTATION OF RESIDUAL VECTORS.
0
No print.
R
1j
R
2j
R
3j
3
Number of Modes
R
3j
0 >
Main Index
997 LAMX
Eigenvalue Table Editor
and generalized mass
will be extracted from LAMA and modified accordingly:
Frequency:
Fixed shift:
Fractional change:
Generalized mass:
Then eigenvalue, radians, and generalized stiffness are based on the modified frequency and
generalized mass:
radians:
eigenvalue:
generalized stiffness:
If , then mode j is not copied to LAMAX.
If , and , then mode j is copied from LAMA to LAMAX without
modification.
2. The FREQMASS matrix has three rows and one column for each mode. The first row contains
the frequencies and the third row contains the generalized masses. The second row is null. Then
eigenvalue, radians, and generalized stiffness are computed as in Remark 3.
f
j
0
m
j
0
f
j
R
ij
1.0 R
2j
+ ( )f
j
0
+ =
R
1j
shift and R
2j
1.0 = =
R
1j
0.0 and R
2j
fraction = =
m
j
R
3j
if R
3j
0 > ( )
m
j
0
if R
3
= 0 ( )
=
e
j
2tf
j
=
j
e
j
2
=
K
j
j
m
j
=
R
3j
1 =
R
1j
0 = R
2j
0 = R
3j
0 =
f
j
0.0
m
j
Number of Modes
3
Main Index
LAMX
Eigenvalue Table Editor
998
3. In the LMAT matrix each row corresponds to a mode. Each column corresponds to eigenvalue,
radians, frequency, generalized mass, and generalized stiffness.
4. Under NLAM=-3:
a. The frequency is computed:
b. KXX and MXX may be vectors.
c. If a diagonal in MXX is null then the corresponding entry in LAMA table will be null.
d. If MXX is purged then an identity matrix is assumed.
e. If KXX is purged the module returns with no output.
f. LAMAX or LAMMAT may be purged.
Examples:
1. For LAMA (real) tables:
Assume that 10 modes are defined in the LAMA table. It is now desired to modify the frequency
data of the LAMA table in the following way:
Mode(s) Desired Modification DMl Format for EMAT
1 through 3 none ---
4 multiply by 0.8 DMI,EMAT,4,2,-0.2
5 none ---
6 delete DMI,EMAT,6,3,-1.0
7 replace by 173.20 DMI,EMAT,7,1,173.20,-1.0
8 replace by 2.98 DMI,EMAT,8,3,2.98
i
e
i
f
i
M
i
k
i
Number of
Modes
5
Freq 0.5 Pi
diag (KXX)
diag (MXX)
---------------------------------- =
f
4
f
7
m
8
Main Index
999 LAMX
Eigenvalue Table Editor
The DMI header record entry is also required: DMI,EMAT,0,2,1,1,,3,10
The DMAP is:
DMIIN DMI,DMINDX/EMAT,,,,,,,,, $
LAMX EMAT,LAMA/LAMB/9 $
EQUIVX LAMB/LAMA/ALWAYS $
Create a LAMB table with f
j
= 10.0, 20,0, 30.0, 40, and m
j
= 1.0, 1.0, 1.0, 2.0.
DMI, FREQMASS, 0, 2, 1, 1, , 3, 4
DMI, FREQMASS, 1, 1, 10.0, 00, 1.0
DMI, FREQMASS, 2, 1, 20.0, 0.0, 1.0
DMI, FREQMASS, 3, 1, 30.0, 0.0, 1.0
DMI, FREQMASS, 4, 1, 40.0, 0.0, 2.0
The DMAP is:
DMIIN DMI,DMINDX/,,,,,,,,,$
LAMX FREQMASS,/LAMB $
OFP LAMB//$
Generate a matrix LMAT from a LAMA table.
The DMAP is:
LAMX, ,LAMA/LMAT/-1 $
2. For CLAMA (complex) tables:
Create a CLAMA table with eigenvalues -1.0, -1.0, -2.0, -2.0, and -3.0, +1.0.
The DMI data for CLAMMAT would be:
DMI, CLAMMAT, 0,6,3,3, ,3,3
DMI, CLAMMAT, 1,1,-1.0,-1.0
DMI, CLAMMAT, 2,2, -2.0, -2.0
DMI, CLAMMAT, 3,3, -3.0, +1.0
The DMAP is:
DMIIN DMI,DMINDX/CLAMMAT,,,,,,,,,/$
LAMX CLAMMAT,/CLAMB/-1 $
Generate a matrix CLAMMAT from a CLAMA table.
The DMAP is:
LAMX, ,CLAMA/CLAMMAT/-2 $
9 none ---
10 delete DMI,EMAT,10,3,-1.0
Mode(s) Desired Modification DMl Format for EMAT
Main Index
LANCZOS
Performs real eigenvalue analysis
1000
Performs real eigenvalue analysis on real symmetric mass and stiffness matrices using the Lanczos
method for the eigensolution and Lagrange Multiplier techniques for constraint processing. Also
designed and implemented to take advantage of distributed memory parallelism (DMP) or networked
computers.
Format:
Input Data Blocks:
Output Data Blocks:
LANCZOS
Performs real eigenvalue analysis
LANCZOS KGG,MGG,RMG,CASECC,USET,EQEXIN,SIL,DYNAMIC,INVEC/
PHG,MI,LAMA,LAMMAT,QG,QMG/
FORMAT/NEIGV/NSKIP/FLUID/EPSORTH/
SID/F1/F2/NDES/MSGLVL/
MAXSET/SHFSCL/NORM/EPSNO/NOQG/
NOQMG $
KGG Stiffness matrix in g-set.
MGG Mass matrix in g-set.
RMG Multipoint constraint equation matrix.
CASECC Table of Case Control command images.
USET Degree-of-freedom set membership table for g-set.
CSTM Table of coordinate system transformation matrices.
CASECC Table of Case Control command images.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
SIL Scalar index list.
DYNAMIC Table of Bulk Data entry images related to dynamics.
INVEC Starting vector(s).
PHG Normal modes eigenvector matrix in the g-set.
LAMA Normal modes eigenvalue summary table.
LAMMAT Diagonal matrix containing eigenvalues on the diagonal.
MI Modal mass matrix.
Main Index
1001 LANCZOS
Performs real eigenvalue analysis
Parameters:
QG Single-point constraint forces of constraint matrix in the g-set.
QMG Multipoint constraint forces of constraint matrix in the g-set.
FORMAT Input-character-no default. Problem type. Must specify 'MODES'. Buckling
problems are not supported.
NEIGV Output-integer-no default. The number of eigenvectors found. Set to -1 if none
were found.
NSKIP Input-integer-default=1. Subcase record number to read in CASECC for the
METHOD set identification number.
FLUID Input-logical-default=FALSE. METHOD command option (FLUID or
STRUCTURE). If FLUID=TRUE, the EIGRL entry is selected from
METHOD(FLUID) Case Control command.
EPSORTH Input-real-default=1.0E-10. Unused.
SID Input-integer-default=0. Alternate set identification number.
If SID=0, the set identification number is obtained from the METHOD command
in CASECC and used to select the EIGR, EIGB, or EIGRL entries in
DYNAMICS.
If SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL
is selected by this parameter value. All subsequent parameter values (METH, F1,
etc.) are ignored.
If SID<0, then both the METHOD command and all EIGR, EIGB, or EIGRL
entries are ignored and the subsequent parameter values (METH, F1, etc.) will be
used to control the eigenvalue extraction.
F1 Input-real-default=0.0. The lower frequency bound in cycles per unit time.
F2 Input-real-default=0.0. The upper frequency bound in cycles per unit time. The
default value of 0.0 indicates machine infinity.
NDES Input-integer-default=0. The number of desired eigenvalues. If the last mode is
repeated, then nDes + m (where m is the multiplicity of the last mode) solutions
are found.
MSGLVL Input-integer-default=1. The level of diagnostic output for the Lanczos method
only.
0 No output.
1 Warning and fatal messages.
2 Summary output.
3 Detailed output on cost and convergence.
Main Index
LANCZOS
Performs real eigenvalue analysis
1002
Remarks:
1. Buckling is not supported.
2. KGG and MGG must be real and symmetric.
3. INVEC may be purged.
4. QG and QMG are created only if USET is specified and NOQG and NOQMG are specified to 1.
4 More detailed output on orthogonalizations and some extra
arithmetic to check on orthogonality.
MAXSET Input-integer-default=7. Vector block size for Lanczos method only. The actual
value of block size may be reduced depending on available memory and problem
size.
SHFSCL Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL
must be greater than 0.0.
NORM Input-character-default=' '. Method for normalizing eigenvectors. By default
(or NORM='MASS'), MASS normalization is performed. NORM='MAX' selects
normalization by maximum displacement.
EPSNO Input-integer-default=-1. Number of eigensolutions to check and the quantity of
error checking output. If left at its default value, only the highest epsilon for the
first ten or NEIGV modes (whichever is less) are printed. If EPSNO is greater
than zero, the epsilons for the first EPSNO are printed.
NOQG Input-integer-default=1. Single point forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
NOQMG Input-integer-default=1. Multipoint forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
Main Index
1003 LCGEN
Expands Case Control table based on LSEQ Bulk Data entries
Expands the Case Control table based on LSEQ Bulk Data entries.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
LCGEN
Expands Case Control table based on LSEQ Bulk Data entries
LCGEN CASECC,SLT,ETT,DYNAMIC,GEOM4/
CASESX/
NSKIP/APP $
CASECC Table of Case Control command images.
SLT Table of static loads.
ETT Element temperature table.
DYNAMIC Table of Bulk Data entry images related to dynamics without DAREA entry
images. LCGEN reads the RLOADi and TLOADi records to determine
unique DAREA identification numbers.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity. LCGEN matches the SPCD and
SPC identification numbers with TLOADi and RLOADi images for possible
enforced motion.
CASESX Expanded Case Control table.
NSKIP Input-integer-default=0. Subcase record number to read in CASECC for the
LOADSET set identification number.
APP Input-character-no default. Analysis type. Specifies which records to use in creating
equivalent static loads from dynamic loads. Allowable types are:
blank Not dynamics.
'FREQRESP' Frequency response -- use RLOADi record.
Main Index
LCGEN
Expands Case Control table based on LSEQ Bulk Data entries
1004
'TRANRESP' Transient response -- use TLOADi record.
REIG Real eigenvalue analysis -- use both RLOADi and TLOADi
record.
Main Index
1005 LMATPRT
Prints combined design sensitivity/constraint matrix
Prints the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity Analysis
only.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameter:
LMATPRT
Prints combined design sensitivity/constraint matrix
LMATPRT DSCMR,DSROWL,DSCOLL//
DSZERO $
DSCMR Old combined design sensitivity/constraint matrix.
DSROWL Table of design sensitivity row labels for design sensitivity matrix, DSCMR.
DSCOLL Table of design sensitivity column labels for design sensitivity matrix,
DSCMR.
DSZERO Input-real-default=0.0. Design sensitivity coefficient print threshold. If the
absolute value of the coefficient is greater than DSZERO then the coefficient
will be printed.
Main Index
MSC Nastran DMAP Programmers Guide
Creates a FORTRAN file containing selected output normally printed by the OFP module.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
MACOFP
Creates FORTRAN file containing OFP module output
MACOFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7//
ITAPE/IUNIT/UNUSED3 $
OFPi Any table that is suitable for printing by the OFP module.
ITAPE Input-integer-default=0. FORTRAN unit positioning option.
0 No action before write.
-1 Rewind before write.
-2 A new unit is mounted before write and rewind at end.
-3 Rewind at start and end.
-4 Dismount old unit and mount new unit.
IUNIT Input-integer-default=0. FORTRAN unit number.
UNUSED3 Input-character-default='XXXXXXXX'. Unused.
Main Index
1007 MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries
Extracts data specified on the AEDW, AEPRESS and AEFORCE Bulk Data entries that reference
UXVEC, DMIJ and DMIK Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk
Data entries
MAKAEFA EDT,MATPOOL,AECTRL,AEBGPDTJ*,AEBGPDTI*,AEBGPDTK*/
AEDWIDX,UXVW,AEDW,AEIDW,AEPRSIDX,UXVP,AEPRE,
AEIPRE,AEFIDX,UXVF,AEFRC/
MACHNO/SYMXZ/SYMXY $
EDT Table of Bulk Data entry images related to aerodynamics.
MATPOOL Table of Bulk Data entry images containing DMIJ, DMIJI and DMIK entries.
AECTRL Table of aeroelastic model controls.
AEBGPDTJ* Family of basic grid point definition tables for the js-set aerodynamic degrees of
freedom.
AEBGPDTI* Family of basic grid point definition tables for the interference js-set aerodynamic
degrees of freedom.
AEBGPDTK* Family of basic grid point definition tables for the ks-set aerodynamic degrees of
freedom.
AEDWIDX Index to the AEDW tables.
UXVW Matrix of UXVEC vectors defined by the AEDW Bulk Data entries.
AEDW Matrix of downwash vectors contained on DMIJ Bulk Data entries referenced by
the AEDW entries.
AEIDW Matrix of interference downwash vectors contained on DMIJ Bulk Data entries
referenced by the AEDW entries.
AEPRSIDX Index to the AEPRESS tables.
UXVP Matrix of UXVEC vectors defined by the AEPRESS Bulk Data entries.
AEPRE Matrix of pressure vectors contained on DMIJ Bulk data entries referenced by the
AEPRESS entries.
AEIPRE Matrix of interference pressure vectors contained on DMIJ Bulk data entries
referenced by the AEPRESS entries.
Main Index
MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries
1008
Parameters:
Remarks:
None.
AEFIDX Index to the AEFORCE tables.
UXVF Matrix of UXVEC vectors defined by the AEFORCE Bulk Data entries.
AEFRC Matrix of force vectors contained on DMIK Bulk data entries referenced by the
AEFORCE entries.
MACH Input-real-no default. Mach number.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
Main Index
1009 MAKAEFS
Generates an index and associated matrices
Generates an index and the associated matrices based on the AEFORCE Bulk Data entry with
MESH='STRUCT'.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
MAKAEFS
Generates an index and associated matrices
MAKAEFS EDT,AECRTL,SLT,PG/
AEDBIDX,UXVST,PGVST,PVPERQ/
MACH/SYMXZ/SYMXY $
EDT Table of Bulk Data entry images related to aerodynamics.
AECTRL Table of aeroelastic model controls.
SLT Table of static loads.
PG Static load matrix for the g-set.
AEDBIDX Index table consisting of the triples.
UXVST Aerodynamic extra point displacement matrix.
PGVST Static load vector matrix (g-set).
PVPERQ Partitioning vector for the V columns of PGVST into those to be scaled by Q (=1)
and those that are absolute (=0).
MACH Input-real-no default. Mach number.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
Main Index
MAKAEMON
Creates hinge moment (HM) monitor points
1010
Creates hinge moment (HM) monitor points and merges with previously defined monitor points if
present. Also generates a new full vehicle (COEF) monitor point.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
MAKAEMON
Creates hinge moment (HM) monitor points
MAKAEMON AERO,EDT,AEMONOLD/
AEMONPT,MONITOR/
AECONFIG $
AERO Table of control information for aerodynamic analysis.
EDT Element deformation table. Contains aerodynamic model records, specifically
AESURF and AESURFS.
AEMONOLD Table of HM monitor points.
AEMONPT Table of aerodynamic monitor points (COEF and HM only).
MONITOR Table of structural monitor points (COEF and HM only).
AECONFIG Input-character-default='REFCSTOT'. Aerodynamic configuration.
Main Index
1011 MAKCOMP
Extracts components from EDT
Extract components from EDT and merge with previously defined components if OLDCMP is present.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
Remarks:
None.
MAKCOMP
Extracts components from EDT
MAKCOMP EDT,AECOMP,AECMPOLD/
/
MESH $
EDT Element deformation table. Contains aerodynamic model records, specifically
monitor and component input.
AECOMP Aerodynamic component definition table (CAEROi Bulk Data entries).
AECMPOLD Previously generated AECOMP.
AEROCOMP Table of aerodynamic components when MESH='AERO'.
STRUCOMP Table of structural components when MESH='STRU'.
MESH Input-character-no default. Mesh type.
AEROCOMP
STRUCOMP
)
`
Main Index
MAKENEW
Converts tables from pre-Version 69 to Version 69 (or greater) format
1012
Converts tables from their pre-Version 69 format to their Version 69 (or greater) format.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. The allowable values for NEWNAMi and OLDNAMi are:
MAKENEW
Converts tables from pre-Version 69 to Version 69 (or greater)
format
MAKENEW OLDDB1,OLDDB2,OLDDB3,OLDDB4,OLDDB5/
NEWDB1,NEWDB2,NEWDB3,NEWDB4,NEWDB5/
OLDNAM1/OLDNAM2/OLDNAM3/OLDNAM4/OLDNAM5/
NEWNAM1/NEWNAM2/NEWNAM3/NEWNAM4/NEWNAM5 $
OLDDBi Output table in pre-Version 69 format. See Remarks.
NEWDBi Input table in the current versions format. See Remarks.
OLDNAMi Input-character-default=' '. The generic name of the corresponding output;
e.g., OLDNAM3 corresponds to OLDDB3, etc. See Remarks.
NEWNAMi Input-character-default=' '. The generic name of the corresponding input table;
e.g., NEWNAM3 corresponds to NEWDB3, etc. See Remarks.
AXIC Table of axisymmetric and fluid Bulk Data entries.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
EPT Table of element properties.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
EST Element summary table.
GEOM1 Table of Bulk Data entry images related to geometry.
Main Index
1013 MAKENEW
Converts tables from pre-Version 69 to Version 69 (or greater) format
2. The inputs, outputs, and parameters can be specified in any order as long as the parameters are in
the same positions as their respective inputs or outputs. For example, the following specifications
are equivalent.
MAKENEW GEOM1,AXIC,,,/NGEOM1,NAXIC,,,/
'GEOM1'/'AXIC'///'GEOM1'/'AXIC' $
MAKENEW AXIC,GEOM1,,,/NAXIC,NGEOM1,,,/
'AXIC'/'GEOM1'///'AXIC'/'GEOM1' $
3. In order to create BGPDT, EST, and CSTM, MAKENEW requires multiple inputs. For example,
MAKENEW BGPDT,EQEXIN,SIL,GPL,/NBGPDT,,,,/
'BGPDT'/'EQEXIN'/'SIL'/'GPL'//'BGPDT' $
MAKENEW EST,EQEXIN,SIL,,,/NEST,,,,/
'EST'/'EQEXIN'/'SIL'///'EST' $
MAKENEW CSTM,EQEXIN,GPL,,,/NCSTM,,,,/
'CSTM'/'EQEXIN'/'GPL'///'CSTM' $
4. The generation of the new data organization on 32 bit platforms does not increase the precisional
values of the data items.
5. Heat transfer and p-elements in EST cannot be processed by MAKENEW.
GEOM2 Table of element connectivity.
GEOM3 Table of static loads.
GEOM4 Table of degree-of-freedom set assignments.
GPDT Grid point definition table.
GPL External grid/scalar point identification number list.
SIL Scalar index list.
Main Index
MAKEOLD
Converts tables from Version 69 (or greater) to pre-Version 69 format
1014
Converts tables from their Version 69 (or greater) format to their pre-Version 69 format.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. The allowable values for NEWNAMi and OLDNAMi are:
MAKEOLD
Converts tables from Version 69 (or greater) to pre-Version 69
format
MAKEOLD NEWDB1,NEWDB2,NEWDB3,NEWDB4,NEWDB5/
OLDDB1,OLDDB2,OLDDB3,OLDDB4,OLDDB5/
NEWNAM1/NEWNAM2/NEWNAM3/NEWNAM4/NEWNAM5/
OLDNAM1/OLDNAM2/OLDNAM3/OLDNAM4/OLDNAM5 $
NEWDBi Input table in the current versions format. See Remarks.
OLDDBi Output table in pre-Version 69 format. See Remarks.
NEWNAMi Input-character-default=' '. The generic name of the corresponding input
table; e.g., NEWNAM3 corresponds to NEWDB3, etc. See Remarks.
OLDNAMi Input-character-default=' '. The generic name of the corresponding output;
e.g., OLDNAM3 corresponds to OLDDB3, etc. See Remarks.
AXIC Table of axisymmetric and fluid Bulk Data entries.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
EPT Table of element properties.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
EST Element summary table.
GEOM1 Table of Bulk Data entry images related to geometry.
Main Index
1015 MAKEOLD
Converts tables from Version 69 (or greater) to pre-Version 69 format
2. The inputs, outputs, and parameters can be specified in any order as long as the parameters are in
the same positions as their respective inputs or outputs. For example, the following specifications
are equivalent.
MAKEOLD GEOM1,AXIC,,,/OGEOM1,OAXIC,,,/
'GEOM1'/'AXIC'///'GEOM1'/'AXIC' $
MAKEOLD AXIC,GEOM1,,,/OAXIC,OGEOM1,,,/
'AXIC'/'GEOM1'///'AXIC'/'GEOM1' $
3. If BGPDT is specified as input then MAKEOLD creates four tables BGPDT, EQEXIN, SIL, and
GPL. For example,
MAKEOLD BGPDT,,,,/OBGPDT,OEQEXIN,OSIL,OGPL,/
'BGPDT'/////'BGPDT'/'EQEXIN'/'SIL'/'GPL' $
4. Heat transfer and p-elements in EST cannot be processed by MAKEOLD.
GEOM2 Table of element connectivity.
GEOM3 Table of static loads.
GEOM4 Table of degree-of-freedom set assignments.
GPDT Grid point definition table.
GPL External grid/scalar point identification number list.
SIL Scalar index list.
Main Index
MAKETR
Generates transformation matrix for support point degrees-of-freedom
1016
Generates transformation matrix to transform forces from the support point degrees-of-freedom to the
reference point.
Format:
Input Data Blocks:
Output Data Block:
MAKETR
Generates transformation matrix for support point degrees-of-
freedom
MAKETR AERO,CSTMA,BGPDT,USET,TRX/
TR,PRBDOFS,URDDIDX,URDDUXV,TRANTR/
AUNITS $
AERO Table of control information for aerodynamic analysis.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
BGPDT Basic grid point definition table.
USET Degree-of-freedom set membership table for g-set.
TRX Acceleration selection matrix for the list of aerodynamic extra-points (6 rows
by NX columns).
TR Matrix to transform forces from the support point to the aerodynamic
reference point.
PRBDOFS Partitioning matrix to partition the "active" URDDI from the "inactive".
Active URRDI are assigned a 1.0 value and are connected to the SUPORT
degrees-of-freedom.
URDDIDX An instance of an ADBINDX that describes the acceleration entries.
URDDUXV UX vector states for the active URDDi. These are rows of TRX that are non-
null. Null rows occur either because the USER didn't define AESTAT,
URDDi, OR because the associated URDDi is invalid for this symmetry
condition (e.g., URDD1,3,5 are invalid for antisymmetric analysis).
TRANTR Transpose of TR where the number of columns of TR matches the
URDDUXV states of TRX. Both are reduced to just the active origin rigid
body degrees-of-freedom.
Main Index
1017 MAKETR
Generates transformation matrix for support point degrees-of-freedom
Parameters:
Example:
Excerpt from subDMAP AESTATRS:
DBVIEW STBGPDT=BGPDTS WHERE (MODLTYPE='STRUCTUR') $
DBVIEW STUSET=USET WHERE (MODLTYPE='STRUCTUR') $
MAKETR AERO,CSTMA,STBGPDT,STUSET/TR $
AUNITS Input-real-no default. Used to convert accelerations expressed in gravity units
to units of length per time squared.
Main Index
MAKMON
Builds table of monitor points
1018
Builds a table of monitor points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
MAKMON
Builds table of monitor points
MAKMON EDT, , /
,MONDISP,MONGRP,MP3LAB,MP3GPF/MKERRCHK
$
EDT Element deformation table. Contains aerodynamic model records, specifically
monitor and component input.
AEROCOMP Table of aerodynamic components when MESH='AERO'.
STRUCOMP Table of structural components when MESH='STRU'.
AEMONPT Table of aerodynamic monitor points.
MONITOR Table of structural monitor points.
MONDISP Monitor points table for displacements.
MONGRP Table of monitor point groups.
MP3LAB Table of monitor point type-3 labels.
MP3GPF Table of monitor point type-3 responses.
MKERRCHK Input-logical-default=FALSE. Error check flag.
TRUE: Perform check
FALSE: Do not perform check
AEROCOMP
STRUCOMP
)
`
AEROCOMP
)
`
AEMONPT
MONITOR
)
`
Main Index
1019 MASSCOMB
Adds family of mass matrices
Adds together a family of mass matricies controlled by the MASSET Bulk Data and CASECC
commands.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Example:
MASSCOMB
Adds family of mass matrices
MASSCOMB EDT,MGG*/
MGGCOMB/
MASSETID/MASSQUAL $
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries. Specifically, this module reads the
MASSINC record.
MGG* Family of MGG (g-set mass) matrices.
MGGCOMB Combined mass matrix.
MASSETID Input-integer-default=0. Identification number of the MASSSET Case
Control command.
MASSQUAL Input-character-default='MASSID'. Name of the qualifier used to qualify the
MGG*.
PARAML CASECC/'SET'/1/453//S,N,MASSSET
DBVIEW MGIN=MHH WHERE(MASSID=*) $
MASSCOMB EDT,MGIN/MHH/MASSSET $
Main Index
MATGEN
Matrix generator
1020
To generate different kinds of matrices for subsequent use in other matrix operation modules.
Format:
Input Data Block:
Output Data Block:
Parameters:
Remarks:
The operation performed by MATGEN depends on the option selected by parameter P1. The following
sections describe the corresponding operation for each P1 parameter value.
Option P1 = 1
Generate a real identity matrix.
Format:
Input Data Blocks:
None.
MATGEN
Matrix generator
MATGEN T/MAT/P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P
13 $
T Optional tabular data for use in generating the matrix.
MAT Matrix data block.
P1 Input-integer-no default. Option selection parameter as described
below.
P2 through P11 Input-integer-default=0. Provide parametric data depending on P1.
P12 Input-character-default='A'. See Option P1 = 11.
P13 Input-character-default='L'. See Option P1 = 11.
MATGEN ,/MAT/1/P2/P3/P4 $
Main Index
1021 MATGEN
Matrix generator
Output Data Block:
Parameters:
Example:
Generate a real 10 x 10 identity matrix:
MATGEN ,/I10X10/1/10 $
Option P1 = 2
Generates an identity matrix trailer.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
This option differs from P1 = 1 in that only the trailer is generated (form = 8) and the matrix is not actually
generated. Only certain DMAP modules are prepared to accept this form (e.g., MPYAD, FBS, CEAD).
P1 = 1 is the preferred option.
Example:
Generate a real 10 x 10 identity matrix trailer:
MATGEN ,/TI10X10/2/10 $
MAT Real identity matrix.
P2 Order of matrix.
P3 Skew flag. If nonzero, generate a skew-diagonal matrix.
P4 Precision (1 or 2). If zero, use machine precision.
MATGEN ,/MAT/2/P2 $
MAT Real identity matrix. See Remarks.
P2 Order of matrix.
Main Index
MATGEN
Matrix generator
1022
Option P1 = 3
Generate a data block of prescribed size.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
This option was primarily designed to generate data blocks of various sizes for data base testing. Each
data block contains two files; a short two-record descriptor file and a file with records that contain 100
words of zero.
Option P1 = 4
Generate a pattern matrix.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
MATGEN ,/DB/3/P2 $
DB Data block. See Remarks.
P2 Number of GINO blocks to be written.
MATGEN ,/MAT/4/P2/P3/P4/P5/P6/P7/P8/P9 $
MAT Pattern matrix.
P2 Number of columns.
P3 Number of rows.
Main Index
1023 MATGEN
Matrix generator
Remark:
The nonzero values in each column will be the column number.
Examples:
1. To generate a 10 x 10 diagonal matrix with the column number in each diagonal position, code:
P4 Precision.
P5 Number of values in nonzero string.
P6 Row number increment between nonzero strings after first nonzero
string (P7-1). Produces (P6-1) zeros.
P7 Row number of first nonzero value in first column. Produces (P7-1)
zero values.
P8 Row number increment to first nonzero string in second and
subsequent.
P9 Number of columns in overall pattern. Overall pattern is repeated at
column number P9+1.
P5
.
.
P6-1
P5
P7-1
P6-1
P5
P7-1
.
.
.
.
. .
.
.
. .
P5
P5
P6-1
P5
P8-1
P5
P6-1
P5
P8-1
. . .
. . .
P9
P2
P3
Main Index
MATGEN
Matrix generator
1024
MATGEN ,/DIAG/4/10/10/0/1/10/1/1/10 $
2. Generate a 12x1 partitioning (Boolean) vector with a nonzero value at every third row:
MATGEN ,/ASTRIP/4 /1 /12/ /1 /3 /3 $
3. Generate a 5x5 matrix with nonzero values in its lower triangle:
MATGEN ,/LOW/4/5 /5 / / / /2 /1 /5 $
Option P1 = 5
Generate a matrix of pseudorandom numbers. The numbers span the range 0 to 1.0, with a uniform
distribution.
Format:
MATGEN ,/MAT/5/P2/P3/P4/P5/P6 $
ASTRIP | |
0
0
1
0
0
1
0
0
1
0
0
1
=
LOW | |
0 0 0 0 0
1 0 0 0 0
1 2 0 0 0
1 2 3 0 0
1 2 3 4 0
=
Main Index
1025 MATGEN
Matrix generator
Input Data Blocks:
None.
Output Data Block:
Parameters:
Option P1 = 6
Generate a partitioning vector for use in PARTN or MERGE.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
MAT Matrix of pseudo-random numbers.
P2 Number of columns.
P3 Number of rows.
P4 Precision (1 or 2). If zero, use machine precision.
P5 Seed for random number generation. If P5 s 0, the time of day
(seconds past midnight) will be used.
P6 Output-integer-mean of all random numbers multiplied by 100,000.
MATGEN ,/CP/6/P2/P3/P4/P5/P6/P7/P8/P9/P10 $
CP Column partitioning vector.
P2 Number of rows. (Integer > 0)
P3, P5, P7, P9 Number of rows with zero coefficients. (Integer > 0)
P4, P6, P8, P10 Number of rows with unit coefficients. (Integer > 0)
Main Index
MATGEN
Matrix generator
1026
Remarks:
1. If Pi < P2, then the remaining terms contain zeros.
2. If Pi > P2, then the terms are ignored after P2.
Example:
Generate a vector of 5 unit terms followed by 7 zeros followed by two unit terms:
MATGEN ,/UPART/6/14/0/5/7/2 $
Option P1 = 7
Generate a null matrix.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
Example:
Generate a 20 row by 15 column null matrix.
MATGEN ,/N20X15/7/20/15 $
MATGEN ,/MAT/7/P2/P3/P4/P5 $
MAT Null matrix.
P2 Number of rows.
P3 Number of columns.
P4 Form; if P4 = 0 and P2 = P3, then the form will be 6 (symmetric). If P4
= 0 and P2 = P3, then the form will be 2 (rectangular).
P5 Type: if P5 = 0, the type will be the machine precision.
i 3 =
10
i 3 =
10
Main Index
1027 MATGEN
Matrix generator
Option P1 = 8
Generate a matrix from equations based on its indices. The matrix is in single precision.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
MATGEN ,/MAT/8/P2/P3/P4/P5/P6 $
MAT Matrix with element values based on its indices.
T DTI table input.
P2 = 0 Generate all terms.
Generate only diagonal terms.
P3 Number of rows.
P4 Number of columns.
P5 Number of the record in field 3 of the DTI entry used to define real coefficients.
P5 < 0 Coefficient taken from DTI trailer.
C(t1) = float (t2) all trailer items are integer.
C(t3) = float (t4) all trailer items are integer.
C(t5) = float (t6) all trailer items are integer.
P5 = 0 Data pairs from record 0 (data block header record) are interpreted as
defining
is integer; is real
P5 > 0 Data pairs from record P5 interpreted as above.
P6 Number of the record in field 3 of the DTI entry used to define imaginary coefficients
D1.
P6 < 0 No coefficients defined.
P6 > 0 Data pairs from record P6 interpreted as above where .
P7 Form of output matrix.
P7 < 0 Form chosen to be 1 or 2, depending on P3 and P4.
P7 > 0 Form set to P7.
P8 coefficient print flag.
0 =
C v
1
( ) v
2
( ) = v
1
( ) v
2
( )
D v
1
( ) v
2
( ) =
Main Index
MATGEN
Matrix generator
1028
The equation used to determine the coefficient of the (l,J)th term of the output matrix is:
The Ci terms are input on two DTI Bulk Data entries. The entry referenced by P5 generates the real part
of the term. The entry referenced by P6 generates the imaginary part of the term. The terms referenced
by P5 may be input using only the first physical entry of the DTI entry (P5 < 0). The coefficients are
defined by adjacent pairs of numbers on the DTI entry. The first number of the pair is an integer that
names the coefficient being defined. For example, a value of 9 means the C9 value is to follow. The
second number of a pair is a real number that defines the value of the coefficient. Zero coefficients need
not be defined.
Bulk Data Entry:
For ; :
MATGEN AB/Ml/8//100/200/-1 $
For :
MATGEN AB/M2/8//100/200/0 $
For ; and :
P8 = 0 Do not print coefficient lists.
Print coefficients lists C and D from the DTI input. (Print D list only if P6
> 0).
1 2 3 4 5 6 7 8 9 10
DTI AB 0 7 1 8 4
2 3.5 1 -5.2
DTI AB 1 3 0.01 4 7.9
DTI AB 2 12 -21.8 13 6.6
DTI AB 3 9 1.0
P8 0 =
MAT I J ( , )
C1 I C2 + J C3 I C4 J + + + |
C5 C6
I
C7 + p C , ( )8
I
C9 I J 1 + ( ) + +
C10 C11
I
C12 + C13
J
| 1 D1 I + | +
D2 J D3 I D4 J D5 D6
I
D7 D8
J
+ + + + +
D9 I J 1 + ( ) D10 D11
1
D12 D13
J
| + +
=
M1 I J ( , ) 4
J
= I 1 100 J , , = 1200 =
M2 I J ( , ) 3.5J 5.21 1100J 1200 = = =
M3 I J ( , ) 21.8 6.6
J
( ) 1
0.01
I
----------
7.9
J
------- +
\ .
| |
+ = I 1 100 , = J 1200 =
Main Index
1029 MATGEN
Matrix generator
MATGEN AB/M3/8//100/200/2/1 $
For ; :
MATGEN AB/HILBERT/8//10/10/3 $ 3RD RECORD
Option P1 = 9
Generate a transformation between external and internal sequence matrices for g-set size matrices.
Format:
Input Data Block:
Output Data Block:
Parameters:
Examples:
Transform a g-set size vector UGV to external sequence.
MATGEN EQEXIN/INTEXT/9//LUSET $
MPYAD INTEXT,UGV,/UGVEXT/1 $
Transform an a-set size matrix to external sequence.
VEC USET/VATOG/G/A/COMP $
MERGE KAA,,,,VATOG,/KAGG/ $0 EXPAND TO
$ G- SIZE, INTERNAL SORT
MATGEN EQEXIN/INTEXT/9/0/LUSET $
SMPYAD INTEXT,KAGG,INTEXT,,/KAAGEXT/3////1////6 $
$ (KAAGEXT) = TRANSPOSE(INTEXT)*(KAAG)*
MATGEN EQEXIN/TRANS/9/P2/P3 $
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
TRANS Transformation matrix.
T EQEXIN table output by module GP1.
P2 0 Output nontransposed factor where [UINT]=[MAT][UEXT].
1 Output transposed factor where [UEXT]=[MAT][UINT].
P3 Number of terms in g-set. The parameter LUSET, which is output by the GP1
module, contains this number in most solution sequences.
HILBERT I J ( , ) 1.0 I J 1 + ( ) = I J 1 10 , = ,
Main Index
MATGEN
Matrix generator
1030
$ (INTEXT) ITS FORM IS 6 (SYMMETRIC)
By default in SOLs 1 through 200, PARAM, OLDSEQ is -1, which means this operation is not required.
Option P1 = 10
Not used.
Option P1 = 11
Generate a rectangular matrix, driven by USET table.
Format:
Input Data Block:
Output Data Block:
Parameters:
Remark:
1. If , and one or both of the sets requested in SET1 and SET2 does not exist, then MAT is
returned purged, and P5 is returned with the value of -1. If MAT does exist, P5 is returned with
the value of 0.
MATGEN USET/MAT/11/P2/P3/////////SET1/SET2 $
USET Degree-of-freedom set membership table for g-set.
MAT Rectangular matrix based on the USET table.
T USET table output by module GP4.
P2 Input-integer-default=0. Null matrix generation option flag.
=1 Generate a null matrix P3 columns and a-set size rows.
Generate a null matrix with an identity sub-matrix based on SET1 and SET2
degree-of-freedom sets.
P3 Input-integer-default=0. Number of columns in MAT. Applies only to P2=1.
SET1 Input-character-default='A'. Degree-of-freedom set name which corresponds to the
number of rows in MAT. Applies only when .
SET2 Input-character-default='L'. Degree-of-freedom set name which corresponds to the
number of columns in MAT. Applies only when .
"" 0 =
P2 1 =
P2 1 =
P2 1 =
Main Index
1031 MATGEN
Matrix generator
Option P1 = 12
Generate a rectangular matrix of prescribed properties.
Format:
Input Data Blocks:
None.
Output Data Block:
Parameters:
Option P1 = 13
Generate a partitioning vector based on a permutation vector.
Format:
MATGEN ,/MAT/12/P2/P3/P4/P5/P6/P7/P8/P9 $
MAT Rectangular matrix.
P2 Number of columns.
P3 Number of rows.
P4 Type of elements in the matrix:
1 Real single precision.
2 Real double precision.
3 Complex single precision.
4 Complex double precision.
P5 Density of the matrix times 10000.
P6 Average string length.
P7 Total number of strings in the matrix.
P8 Number of null columns.
P9 Average bandwidth.
MATGEN CPERM/MPART/13/NEWMSIZ $
Main Index
MATGEN
Matrix generator
1032
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. The default value for parameters P2, P3, P4, P5, and P7 is zero. Therefore, in order to successfully
create the matrix, nonzero values for these parameters must be input.
2. The average string length is internally computed based on the other properties of the matrix. P6
is only used as a check. If the value computed is not the same as P6, a user warning message to
that effect is issued.
3. In order to verify the properties of the output matrix, set DIAG 8 and check the matrix trailer
information.
4. MPART is output in single precision.
CPERM Table of column permutations under KSYM=4 from DECOMP.
MPART Partitioning vector based on a permutation vector.
NEWMSIZ Input-integer. Only the first NEWMSIZ entries in CPERM are turned
on.
Main Index
1033 MATGPR
Degree-of-freedom matrix printer
Prints nonzero terms of matrices along with the external grid point and component identification numbers
corresponding to the row and column position of each term.
Formats:
1. For matrices with degrees of freedom that relate to grid or scalar points (g-set):
2. For matrices with degrees of freedom that relate to grid, scalar or extra points (p-set):
3. For matrices with degrees of freedom that relate to aerodynamic elements (ks-set):
4. Print a matrix in the format similar to DISPLACEMENT output with a user-defined column label
and page header.
Input Data Blocks:
MATGPR
Degree-of-freedom matrix printer
MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY
/F1$
MATGPR GPL,USET,SIL,MATRIX//COLNAM/ROWNAM/PRNTOPT/TIN
Y/F1$
MATGPR GPLD,USETD,SILD,MATRIX//COLNAM/ROWNAM/PRNTOPT/
TINY/F1 $
MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/
TINY/F1 $
MATGPR BGPDT*,USET*,,MATRIX//
'OFP'/ROWNAM/PRNTOPT/TINY////
LCOLLBL1/LCOLLB2/LCOLLBL3/LCOLLBL4/
RCOLLBL1/RCOLLB2/RCOLLBL3/RCOLLBL4/
HDRLBL1/HDRLBL2/HDRLBL3/HDRLBL4/
HDRLBL5/HDRLBL6/HDRLBL7/HDRLBL8/
PUNCH/S,N,CARDNO $
GPL External grid/scalar point identification number list.
GPLD External grid/scalar/extra point identification number list. (GPL
appended with extra point data).
USET Degree-of-freedom set membership table for g-set.
Main Index
MATGPR
Degree-of-freedom matrix printer
1034
Parameters:
USETD Degree-of-freedom set membership table for p-set.
SIL Scalar index list.
SILD Scalar index list for the p-set.
MATRIX Any matrix related to degrees-of-freedom.
BGPDT Basic grid point definition table.
BGPDT* Family of basic grid point definition tables for all superelements.
USET* Family of USET tables.
COLNAM Input-character-no default. Set name for columns in MATRIX or
OFP for Format number 4. See Examples 7 and 8.
ROWNAM Input-character-default = ' '. Set name for rows in MATRIX. If
ROWNAM is blank, then it defaults to COLNAM.
PRNTOPT Input-character-default = ALL. Must be one of the following values:
Option Action
NULL Only null columns will be identified.
ALL Print all nonzero terms in matrix.
ALLP Print numbers converted to magnitude/phase.
TINY Real-default = 0.0. If F1 = 0 and TINY > 0, printed output will be
provided only for those matrix terms, , that satisfy the relation
|. If F1 = 0 and TINY < 0, printed output will be provided
only for those matrix terms,
,
that satisfy the relation . If
TINY = 1.E37, MATGPR will return. If F1 is nonzero, see the
following description of F1.
F1 Real-default = 0.0. If F1 is not zero, then printed output will be
provided for only those matrix terms that satisfy or
.
LCOLLBLi Input-character-default=' '. Label with up to 32 characters to be
printed left-justified in upper left corner of each page.
RCOLLBLi Input-character-default=' '. If RCOLLBLi is blank then 'COLUMN'
will be printed. Label with up to 32 characters to be printed right-
justified in upper right corner of each page. RCOLLBLi is then
followed by column number.
a
ij
a
ij
TINY >
a
ij
a
ij
TINY s
a
ij
TINY >
a
ij
F1 >
Main Index
1035 MATGPR
Degree-of-freedom matrix printer
Remark:
The supersets formed by the union of other sets have the following definitions:
5. If the value specified for COLNAM is not one of the names shown in Remark 1, then the columns
will be labeled 1,2,3..., etc. without grid and component labels.
6. If the value specified for R is not one of the names shown in Remark 1, then the terms in each
column will be labeled 1 H, 2 H, 3 H, etc. without grid and component labels. The user must
know which sets correspond to the rows and columns of the matrix to be printed. This is usually
apparent from the DMAP name of the matrix data block.
7. When using Format 1 this module may not be scheduled until after GPSP since data blocks
generated by GPSP are required inputs. (This module may be scheduled after GP4 if USET0 is
specified for input to MATGPR instead of USET.) When using Format 2 this module may not be
scheduled until after DPD since data blocks generated by DPD are required inputs. When using
Format 3, MATGPR must be scheduled after the APD module.
8. If MATRIX is purged, no printing will be done.
9. The rows and columns of A must correspond to the order of the degrees-of-freedom defined in
GPL, USET, SIL, BGPDT, etc.; i.e., internal sequence.
HDRLBLi Input-character-default='MATRIX'(followed by matrix name). Header
with up to 64 characters to be printed and centered at the top of of each
page.
PUNCH Input-logical-default=FALSE. Punch file write control flag. (DELAY)
CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is
incremented by one for each line written to the punch file and is also
written into columns 73-80 of each line. (DELAY)
sets
mr
sb
sg
m
o
q
r
c
b
e
sa
k
t
a
d
f
fe
n
ne
g
p
supersets
l
lm
mp
s
ks
j
js
Main Index
MATGPR
Degree-of-freedom matrix printer
1036
Examples:
1. Print terms of KGG:
MATGPR BGPDT,USET,,KGG//G $
2. Print null columns of KLL:
MATGPR BGPDT,USET,,KLL//L/L/NULL $
3. Print small terms on diagonal of LOO:
DIAGONAL LOO/LOOD $
MATGPR BGPDT,USET,,LOOD//H/O//-1.E-2 $
4. Print PHIA, H columns by A rows:
Also good for any single column
MATGPR BGPDT,USET,,PHIA//H/A $
5. Print all terms of KGG outside the range of 0 through 10
7
:
MATGPR BGPDT,USET,,KGG//G/G//1.E7/0. $
6. Print aerodynamic spline matrices:
NP=SEID $
DBVIEW BGPDTF=BGPDTS WHERE (
(PEID=-1 AND MODLTYPE='AEROSTRC') OR
(PEID=NP AND MODLTYPE='STRUCTUR') ) $
DBVIEW USETFF=USET0 WHERE (
(PEID=-1 AND MODLTYPE='AEROSTRC' AND SPC=*
AND MPC=* AND SUPORT=*) OR
(PEID=NP AND MODLTYPE='STRUCTUR' AND SPC=*
AND MPC=* AND SUPORT=*) ) $
MATGPR BGPDTF,USETFF,,GPJK//'K'/'G' $
MATGPR BGPDTF,USETFF,,GDJK//'K'/'G' $
7. Print g-size matrix GCF similarly to displacement output:
MATGPR BGPDT,USET,,GCF//'ofp'/'g' $
8. Same as example 7 except modify header labeling.
MATGPR BGPDTS,USET,,GCFF//'OFP'/'G'//////
'DIRECTIO'/'N'///
////
'G R O U '/'N D C '/'H E C K '/' F O R '/
'C E S ('/' G - S E'/' T )' $
COLUMN 1
MATRIX GCF
POINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0 1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0 1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0 4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0
Main Index
1037 MATGPR
Degree-of-freedom matrix printer
DIRECTION 1
G R O U N D C H E C K F O R C E S ( G - S E T )
OINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0 1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0 1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0 4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0
Main Index
MATMOD
Matrix modification
1038
Transforms matrix or table data blocks according to one of many options into output matrix or table data
blocks.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MATMOD
Matrix modification
MATMOD I1,I2,I3,I4,I5,I6/
O1,O2/
P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P13/P14
/P15/
P16/P17/P18/P19 $
Ii Input data blocks. I1 is required; I2 through I6 may not be necessary
depending on the value P1.
Oi Output data blocks.
P1 Input-integer-no default. Option selection described in the table that follows.
P2, P3, P4 Input/output-integer-default=0. Parametric data depending on P1.
P5, P6 Input/output-real-default=0. Parametric data depending on P1.
P7 through P11 Input/output-integer-default=0. Parametric data depending on P1.
P12 Input/output-character-default=blank. Parametric data depending on P1.
P13 Input/output-character-default=' '. Parametric data depending on P1.
P14 Input/output-character-default=' '. Parametric data depending on P1.
P15 Input/output-character-default=' '. Parametric data depending on P1.
P16 Input/output-integer-default=0. Parametric data depending on P1.
P17 Input/output-real double-default=0.0D0. Parametric data depending on P1.
P18 Input/output-complex-default=(0.0,0.0). Parametric data depending on P1.
P19 Input/output-complex double-default=(0.0D0,0.0D0). Parametric data depending
on P1.
Main Index
1039 MATMOD
Matrix modification
Remark:
Each option corresponds to a different value of the first parameter, P1. The following summary table
provides descriptions of the options.
Option P1 = 1
Extract a block(s) of columns from a matrix.
Format:
Input Data Block:
Output Data Block:
Parameter:
Remarks:
1. If ENDCOL is zero then ENDCOL=STARTCOL.
2. If COLINC is zero then every column between STARTCOL and ENDCOL is extracted.
3. If ENDCOL is greater than the number of columns then ENDCOL is assumed to be equal to the
number of columns.
4. If COLINC>0 then, by default, ENDCOL is assumed to be equal to the number of columns.
Examples:
1. Extract the seventh column from A and call it A7.
MATMOD A,,,,,/A7, /1/7 $
2. Extract the third, fourth, and fifth columns from A.
MATMOD A,,,,,/A345, /1/3/3 $
MATMOD I1,,,,,/O1,O2/1/STARTCOL/ENDCOL/COLINC $
I1 Any matrix. (Real or complex).
O1 Column vector containing column P2 of I1.
O2 Matrix containing the columns discarded from I1 to create O1.
STARTCOL Input-integer. Starting column number to extract from I1.
ENDCOL Input-integer. Ending column number to extract from I1.
COLINC Input-integer. Column increment. Extract every COLINC'th column
between STARTCOL and ENDCOL.
Main Index
MATMOD
Matrix modification
1040
3. Partition A into one matrix containing the odd-numbered columns and another containing the
even-numbered columns.
MATMOD A,,,,,/ODDCOLS,EVENCOLS/1/1//2 $
or
MATMOD A,,,,,/EVENCOLS,ODDCOLS/1/2//2 $
Option P1 = 2
Filter small magnitude terms of a matrix.
Format:
Input Data Block:
Output Data Block:
Parameter:
MATMOD I1,,,,,/O1,/2/PURGE/UPLOW/TYPEF/FILTER $
I1 Any matrix. (Real or complex).
O1 Copy of I1 with terms smaller in magnitude than P5 set to 0.0.
PURGE Input-integer-default=0. If PURGE=0, and the input matrix has no nonzero terms,
then the output matrix will be purged. If , and the input matrix has
no nonzero terms then the output matrix will be null.
UPLOW Input-integer-default=0. Triangular nullification flag.
>0 All lower triangular terms in O1 are set to zero.
<0 All upper triangular terms in O1 are set to zero.
=0 No nullification.
TYPEF Input-integer-default=0. Filtering method.
0 Magnitude: O1(i,j) is set to zero when abs(I1(i,j)) < abs(FILTER).
1 Algebraic: O1(i,j) is set to zero when I1(i,j)<FILTER.
-1 Algebraic complement: O1(i,j) is set to zero when I1(i,j)>FILTER.
FILTER Input-real-default=0.0. Value of filter. Terms in I1 with an absolute magnitude
less than the absolute value of FILTER will be set to zero.
PURGE 0 =
Main Index
1041 MATMOD
Matrix modification
Remark:
If FILTER=0.0, then O1 is a copy of I1.
Examples:
1. Print terms in A smaller in magnitude than 100.0.
MATMOD A,,,,,/AFILTER,/2////100.0 $
ADD A,AFILTER/ASMALL//-1. $
MATPRN ASMALL// $
2. Print terms in the upper triangle of B that are less than -200.
MATMOD B,,,,,/BFILTER,/2//1/-1/-200. $
MATPRN B// $
Option P1 = 3
Zeros out rows and columns of a matrix according to degree of freedom component number.
Format:
Input Data Block:
Output Data Block:
Parameter:
Remark:
I1 is assumed to consist only of grid point degrees of freedom. A code of 345 simply zeros rows and
columns 3, 4, 5, 9, 10, 11, 15, 16, 17, etc. of matrix I1. Users should exercise caution when selecting this
option on a resequenced matrix.
Example:
Zero out degrees of freedom 1, 2, and 6 in stiffness matrix KGG.
MATMOD KGG,,,,,/KGG1,/3/126 $
EQUIVX KGGQ/KGG/ALWAYS $
MATMOD I1,,,,,/O1,/3/CODE $
I1 Any matrix. (Real or complex).
O1 I1 with rows and columns according to DOFs described by P2.
CODE Input-integer-default=0. Packed DOF code that identifies rows and
columns of I1 to be made null (e.g., 136 means degrees of freedom 1,
3, and 6 for each grid point will be set to zero).
Main Index
MATMOD
Matrix modification
1042
Option P1 = 4
Replicates a matrix six rows by N columns row-wise to a g-row by N-column matrix. The input matrix
is replicated for each grid point.
Format:
Form 1
Form 2
Input Data Blocks:
Output Data Block:
Parameter:
Remarks:
1. If SIL is purged, then MATMOD uses LUSET for the size of the g-set. The assumption is made
that only grids exist in the g-set. LUSET must not be zero if SIL is purged.
2. If SIL is not purged, then LUSET is ignored. I1 is inserted at the rows of every grid point. Scalar
and extra points are ignored.
Option P1 = 5
Accepts a DMI matrix six rows by six columns and output a g-row by g-column matrix where the input
matrix is inserted at the diagonal 6x6 of each grid point or output a
g-row by g-column transform matrix.
MATMOD I1,SIL,,,,/O1,/4 $
MATMOD I1,,,,,/O1,/4/LUSET $
I1 Any six-row by N-column matrix. (Real or complex).
SIL Scalar index list (SIL) table generated by the GP1 module.
O1 g-row by N-column matrix containing I1 at every grid point.
LUSET Integer-input-default=0. Used to supply the length of the g-set when
SIL is purged.
Main Index
1043 MATMOD
Matrix modification
Format:
Form 1 (Inserts 6x6 matrix along diagonal)
Form 2 (Generates specified coordinate system to basic coordinate system transformation matrix)
Form 3 (Generates a global-to-basic coordinate system transformation matrix)
Input Data Blocks:
Output Data Block:
Parameter:
Remarks:
1. If P3 = 0, this option accepts a six row by six column matrix and the SIL table. The output is a
g-size square matrix containing the 6 x 6 input matrix along the diagonal at every grid point.
Scalar and extra points contain 0.0 values.
If P3 > 0, the 6 x 6 single-precision matrix will be the transformation matrix from the coordinate
system with the coordinate ID = P3 to the basic system. If P3 points to a cylindrical or spherical
coordinate system, then the transformation location is at the origin of the P3 system. Scalar and
extra points contain 1.0.
MATMOD I1,SIL,,,,/O1,/5/LUSET/0 $
MATMOD CSTM,SIL,,,,/01,/5/LUSET/P3 $
MATMOD CSTM,SIL,BGPDT,,,/01,/5//-1 $
I1 Any six-row by six-column matrix. (Real or complex).
SIL Scalar index list table output from the GP1 module.
BGPDT Basic grid point definition table.
O1 g-row by N-column matrix containing I1 at every grid point.
LUSET Integer-input-default=0. Used to supply the length of the g-set when
SIL is purged. This parameter is valid for Forms 1 and 2 only.
P3 Integer-input-default=0. Coordinate system identification number.
Main Index
MATMOD
Matrix modification
1044
If P3 = -1, the 6 x 6 single-precision matrix will be the global-to-basic transformation for each
grid point. Scalar and extra points contain 1.0.
2. If SIL is purged, the MATMOD uses LUSET for the size of the g-set. The assumption is made
that only grids exist in the g-set. LUSET must not be zero if SIL is purged.
Examples:
Transform KGG to another coordinate system.
1. Assume TRANS to be a 6 x 6 transformation matrix and KGG was formed using only one
coordinate system (global coordinate system is the same at each grid point). Transform KGG
using TRANS.
MATMOD TRANS,SIL,,,,/TRANSG,/5 $
TRNSP TRANS/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGPRIME/3 $
2. Assume KGG was formed using coordinate system 10 as the global coordinate system for all grid
points. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,,,,/TRANSG,/5//10 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $
3. Assume KGG was formed using arbitrary coordinate systems as the global coordinate system for
each grid point. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,BGPDT,,,/TRANSG,/5//-1 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $
Transform KGGBASIC coordinate system 10.
MATMOD CSTM,SIL,,,,/TRANS10,/5//10 $
TRNSP TRANS10/TRANST10T $
SMPYAD TRANS10T,KGGBASIC,TRANS10,,,/KGG10/3 $
Option P1 = 6
Find the maximum absolute value for each row over all columns of a matrix.
Format:
Input Data Block:
MATMOD I1,,,,,/O1,/6 $
I1 Any matrix. (Real only).
Main Index
1045 MATMOD
Matrix modification
Output Data Block:
Example:
Find the maximum displacements over all loading conditions.
MATMOD UG,,,,,/UGMAX,/6 $
Option P1 = 7
Find the maximum absolute value for each column over all the rows of a matrix.
Format:
Input Data Block:
Output Data Block:
Example:
Find the maximum displacement for each loading condition.
MATMOD UG,,,,,/MAXDISP,/7 $
Option P1 = 8
Normalize matrix.
Format:
O1 Column vector with terms that represent the absolute maximum over
all columns of I1 for each row.
MATMOD I1,,,,,/O1,/7 $
I1 Any matrix. (Real only)
O1 Column vector with a term that represents the absolute maximum over
all rows of I1 for each column.
MATMOD I1,,,,,/O1,/8////S,N,NORMREAL/
S,N,NORMIMAG $
Main Index
MATMOD
Matrix modification
1046
Input Data Block:
Output Data Block:
Parameters:
Option P1 = 9
Find the maximum (absolute magnitude) value of each three columns of UHT-transient response solution
matrix. (The columns of UHT represent displacement, velocity, and acceleration for each output time
step.)
Format:
Input Data Block:
Output Data Block:
Example:
Find and output maximum transient response.
I1 Any matrix. (Real or complex)
O1 Matrix shaped like I1 with every term divided by the magnitude of the
term in I1 with the largest magnitude.
NORMREAL Output-real single precision. Set to the real part of the normalizing
factor.
NORMIMAG Output-real single precision. Set to the imaginary part of the
normalizing factor if I1 is complex.
MATMOD I1,,,,,/O1,/9 $
I1 Transient response solution matrix consisting of H rows by three
column matrices (which represent displacement, velocity, and
acceleration for each output time step) appended to form a matrix H
rows by three times the number of output time steps columns. (Real
only)
O1 H-row by three column matrix of peak displacements, velocities, and
accelerations.
u
1
{ } v
1
{ } a
1
{ } | | u
2
{ } v
2
{ } a
2
{ } | |. u
i
{ } v
i
{ } a
i
{ } | | | |
Main Index
1047 MATMOD
Matrix modification
MATMOD UHT,,,,,/UHTMAX,/9 $
DDRMM CASEXX,UHTMAX,PHIP1,,,,/OUPMAX,,,,/ $
OFP OUPMAX,,,,// $
Option P1 = 10
Convert matrix I1 into its complex conjugate.
Format:
Input Data Block:
Output Data Block:
Example:
Find the magnitude of terms of a complex vector.
MATMOD CMPLX,,,,,/CMPLXC,/10 $
ADD CMPLX,CMPLXC/CMPLXSQ///1 $
DIAGONAL CMPLXSQ/CMLPXMAG/WHOLE/0.5 $
Option P1 = 11
Form a new BGPDT (Basic Grid Point Definition Table) with grid locations that are given by I1.
Format:
Input Data Blocks:
MATMOD I1,,,,,/O1,/10 $
I1 Any matrix. (Real or complex)
O1 Matrix shaped like I1 with every term converted to its complex
conjugate.
MATMOD LOCVEC,BGPDT,,,,/BGPDTN,/11 $
LOCVEC G-size vector with values that represent grid locations in the basic
coordinate system.
BGPDT Basic grid point definition table.
Main Index
MATMOD
Matrix modification
1048
Output Data Block:
Example:
Build new BGPDT table based on the deformed state.
$ Form vector containing new grid locations in
$ basic coordinate system
VECPLOT UG,BGPDT,CSTM,,,,/
LOCVEC/0/0/3 $
$ Generate new BGPDT
MATMOD LOCVEC,BGPDT,,,,/BGPDTNEW,/11 $
Option P1 = 12
Perform simultaneous null column search on up to three matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
BGPDTN New BGPDT table with grid point locations that are displaced by
LOCVEC.
MATMOD I1,I2,I3,,,/O1,O2/12/S,N,NONULL/
NMATRIX/P4 $
I1, I2, I3 Matrices to search for simultaneous null columns. (Real or complex)
O1 Column vector which has 1.0 at those rows where all matrices selected
have null columns if P4 > 0 or non-null columns if P4 < 0.
O2 Square symmetric matrix which has 1.0 on the diagonal of those
columns where all matrices selected have null columns if P4 > 0 or
non-null if P4 < 0.
NONULL Output-integer. Set to -1 if no simultaneous null columns found;
otherwise, it is set to the number of simultaneous null columns.
NMATRIX Input-integer-default=0. Number of matrices to be included in null
column search.
P4 Input-integer-default=0. Flag to output 1.0 for null columns or non-
null columns. See 01 and 02 for descriptions.
Main Index
1049 MATMOD
Matrix modification
Remarks:
1. I2 and I3 may be purged.
2. O2 may be purged.
Example:
Search for simultaneous null columns in the g-size mass, damping, and stiffness matrices and remove
rows and columns corresponding to these columns.
Option P1 = 13
Copies any data block.
Format:
Input Data Block:
Output Data Block:
Remark:
COPY module is preferred over this option.
Option P1 = 14
Filter small magnitude terms from a matrix; more capabilities than option 2.
MATMOD I1,,,,,/O1,/13 $
I1 Any data block. (Table or matrix)
O1 Copy of I1.
MATMOD MGG,BGG,KGG,,,/PARTNULL,/12/S,N,NO
IF (NONULL > 0) THEN $
PARTN MGG,PARTNULL,/MGGNEW,,,/-1 $
EQUIVX MGGNEW/MGG/ALWAYS $
PARTN BGG,PARTNULL,/BGGNEW,,,/-1 $
EQUIVX BGGNEW/BGG/ALWAYS $
PARTN KGG,PARTNULL,/KGGNEW,,,/-1 $
EQUIVX KGGNEW/KGG/ALWAYS $
ENDIF $
Main Index
MATMOD
Matrix modification
1050
Format:
Input Data Block:
Output Data Block:
Parameters:
Remarks:
1. If FILTER = 0.0, then O1 is a copy of I1.
2. If relative filtering is desired, then FILTER must be zero (default).
3. If or RELFLT < 0, then the absolute filter technique is used.
MATMOD I1,,,,,/O1,/14/PURGE/UPLOW/STRTR/
FILTER/RELFLT/TRUNC $
I1 Matrix to be filtered. (Real or complex)
O1 I1 modified according to specifications set by parameters.
PURGE Input-integer-default=0. If PURGE = 0, and the input matrix has no
nonzero terms, then the output matrix will be purged. If
, and the input matrix has no nonzero terms then the
output matrix will be null.
UPLOW Input-integer-default=0. If UPLOW > 0, then all lower triangular terms
are set to zero. If UPLOW < 0, then all upper triangular terms are set
to zero. If UPLOW = 0, then the action of this parameter is ignored.
STRTR Input-integer-default=0. If STRTR=0, then string trailer will be
written.
FILTER Input-real single precision-default=0.0. Terms in I1 with an absolute
magnitude less than the absolute value of FILTER will be set to zero.
RELFLT Input-real single precision-default=0.0. If , then
terms of I1 are set to zero when
I1 must be square for this option
TRUNC Input-integer-default=0. If , then truncate terms of I1
accordingly
PURGE 0 =
RELFLT 0.0 =
TERM I J ( , )
TERM i i ( , ) TERM J J ( , )
-------------------------------------------------------------- RELFLT <
TRUNC 0 =
TERM I J ( , ) * 1
1
10
TRUNC
---------------------
\ .
| |
FILTER 0 =
Main Index
1051 MATMOD
Matrix modification
4. If I1 is not square and the relative filtering option is selected, then FILTER will be set to RELFLT
and the absolute filtering technique will be used. A user warning message will also be issued.
Option P1 = 15
Not implemented.
Option P1 = 16
Put matrix into DMIG format in a MATPOOL-type data block and/or generate DMIG punched output.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
MATMOD MATIN,EQEXIN,USET,,,/MATPOOLX,/16/PNDMIG/
SORTFLG/TYPOUT////////CCHAR/DMIGNAME/
ROWSETNM/COLSETNM $
MATIN Matrix to be converted to DMIG format. (Real or complex). See
Remark 1.
EQEXIN EXEQXIN table from module GP1. See Remark 7.
USET USET table from module GP4 or GPSP. See Remark 8.
MATPOOLX MATPOOL-type table data block containing MATIN in DMIG format.
See Remarks 9. and 10.
PNDMIG Input-integer-default=0. If PNDMIG is non-zero, then DMIG punched
output will be generated. See Remarks 9. and 10.
SORTFLG Input-integer-default=0. The default assumes that the rows (and
columns, if applicable) of MATIN are in external sort. If SORTFLG is
non-zero, then it is assumed that they are in internal sort. See Remark
2.
TYPOUT Input-integer-default=0. The default sets the DMIG precision to
machine precision. The default maybe overridden by specifying the
following:
1 Real single precision format
2 Real double precision format
Main Index
MATMOD
Matrix modification
1052
Remarks:
1. The form of MATIN must be either 1 (square), 6 (symmetric) or 2 (rectangular). If not, then a
warning message will be issued and MATPOOLX will not be generated.
2. If the default value of 0 for SORTFLG is used, the rows of MATIN must be of G-size. If MATIN
is square or symmetric, its columns must also be of G-size. Further, the default value of 0 for
SORTFLG also assumes that the rows and columns of MATIN are in external sort. In order to
accomplish this, it is necessary to first generate a transformation matrix via the MATGEN module
Option 9 and then employ this matrix to transform the rows and columns of MATIN from internal
sort to external sort. (This is illustrated in the Example shown below.)
3. If non-blank continuation characters are specified for CCHAR, then a maximum of 99,999 DMIG
entries can be generated for any single matrix. If this maximum number is exceeded, the program
terminates the job with a fatal error.
4. The program checks to ensure that the number of rows and columns of MATIN correspond to the
displacement sets specified (or implied) by ROWSETNM and COLSETNM. If this condition is
not satisfied, the program issues a warning message and proceeds without generating any output
from this call to the MATMOD module.
5. If the form of MATIN is either 1 (square) or 6 (symmetric), then the IFO field on the generated
DMIG entry is set to 1 or 6. If the form is 2 (rectangular), then IFO is set to 2 if a displacement
set is specified (or implied) for COLSETNM. Otherwise, IFO is set to 9. (If the form is 6, only
the terms in one triangle are output. The MTRXIN module, which converts DMIG data in
MATPOOL-type data blocks into matrices, fills in the other triangle for symmetric matrices.)
3 Complex single precision format
4 Complex double precision format
CCHAR Input-character-default=blank. Continuation characters to be used for
DMIG punched output. Only the first two characters of the non-blank
mnemonic are used for the continuation string. See Remark 3.
DMIGNAME Input-character-default=blank. The default will cause the name of the
MATIN input data block to the used for the matrix name in the DMIG
output. A non-blank name will cause that specified name to be used for
the matrix name in the DMIG output.
ROWSETNM Input-character-default=blank. The default assumes that the rows of
MATIN are of G-size. Any non-blank mnemonic specifies the
displacement set for the rows. See Remarks 4., 5. and 6.
COLSETNM Input-character-default=blank. If the form of MATIN is 1 (square) or 6
(symmetric), then the default assumes that the displacement set for the
columns is the same as that of the rows. If the form of MATIN is 2
(rectangular), then the default (or a mnemonic of H) assumes that the
columns do not represent any displacement set, but just sequential
entities. Any non-blank mnemonic other than H specifies the
displacement set for the columns. See Remarks 4., 5. and 6.
Main Index
1053 MATMOD
Matrix modification
6. The rows of the DMIG entry are always labeled with the appropriate grid/scalar IDs and
component numbers. If a displacement set is specified (or implied) for COLSETNM, then the
columns of the DMIG entry are also labeled with the appropriate grid/scalar IDs and component
numbers. Otherwise, the columns of the DMIG entry are labeled sequentially, starting with unity.
7. The EQEXIN input data block may not be purged.
8. The USET input data block may be purged if (a) the default value of 0 is used for SORTFLG or
(b) the displacement set specified (or implied) by ROWSETNM is G and the displacement set
specified (or implied) by COLSETNM is either G or the columns are just sequential entities.
9. The MATPOOLX output data block may be purged if PNDMIG is specified as non-zero and only
the DMIG punched output is desired.
10. By employing the APPEND option on a DMAP FILE statement, a single concatenated
MATPOOLX output data block may be generated from multiple calls to MATMOD Option 16.
See the following Example 2.
Example 1:
Generate DMIG punched output for the boundary stiffness matrix KAA, the boundary load matrix PA
and the matrix GMN (representing the MPC/rigid element equations) for an external superelement. The
KAA DMIG entry is to be named KAAEXTSE, the PA DMIG entry is to be named PAEXTSE and the
GMN DMIG entry is to be named GMNEXTSE.
The DMAP shown below illustrates the usage of Option 16 using input matrices in internal sort
(capability available in MSC.Nastran 2005 r2 and subsequent releases) as well as using input matrices in
external sort (only usage possible in pre-MSC.Nastran 2005 r2 releases). It can be seen that the DMAP
for the former case is much simpler and more efficient than for the latter case.
It should be pointed out here that, if the internal and external sorts are different, the DMIG output
resulting from the two scenarios shown below will appear to be different. This is because the matrix
elements will be output in different order, but their values will be the same. The DMIG output from the
two scenarios will yield identical matrices if they are used in turn by the MTRXIN module to re-generate
the matrices.
DMAP uses input matrices in internal sort (MSC.Nastran 2005 r2 and subsequent releases).
TYPE PARM,,I,N,PUNCHFLG=1 $ GENERATE DMIG PUNCHED OUTPUT
TYPE PARM,,I,N,SORTFLG=1 $ INPUT MATRICES ARE IN INTERNAL SORT
MATMODKAA,EQEXIN,USET,,,/,/16/PUNCHFLG/SORTFLG//////////
KAAEXTSE/A $
MATMODPA,EQEXIN,USET,,,/,/16/PUNCHFLG/SORTFLG//////////
PAEXTSE/A $
MATMODGMN,EQEXIN,USET,,,/,/16/PUNCHFLG/SORTFLG//////////
GMNEXTSE/M/N $
Main Index
MATMOD
Matrix modification
1054
DMAP using input matrices in external sort (pre-MSC.Nastran 2005 r2 releases).
Example 2:
Generate a single MATPOOL-type data block containing the DMIG output for the boundary stiffness
matrix KAA, the boundary mass matrix MAA, the boundary viscous damping matrix BAA and the
boundary structural damping matrix K4AA for an external superelement, with the corresponding DMIG
entry names of KAAXSE, MAAXSE, BAAXSE and K4AAXSE, respectively.
The DMAP following illustrates the usage of Option 16 to accomplish the above objective in
MSC.Nastran 2005 r2 and subsequent releases. Note that this objective could not be met in pre-
MSC.Nastran 2005 r2 releases.
TYPE PARM,,I,N,PUNCHFLG=1 $ GENERATE DMIG PUNCHED OUTPUT
$ EXPAND BOUNDARY MATRICES TO G-SIZE
UMERGE1USET,KAA,,,/KAAGG/G/A $ EXPAND ROWS AND
COLUMNS
UMERGE1USET,PA,,,/PAG/G/A//1 $ EXPAND ROWS
UMERGE1USET,GMN,,,/GMNGN/G/M//1 $ EXPAND ROWS
UMERGE1USET,GMNGN,,,/GMNGG/G/N//2 $ EXPAND COLUMNS
$ GET G-SIZE
PARAMLUSET//TRAILER/2/S,N,GSIZE $
$ GENERATE MATRIX TO TRANSFORM FROM INTERNAL SORT
$ TO EXTERNAL SORT
MATGENEQEXIN/INTEXT/9/0/GSIZE $
$ TRANSFORM MATRICES FROM INTERNAL SORT TO
$ EXTERNAL SORT WITH APPROPRIATE DESIRED NAMES
MPYADINTEXT,KAAGG,/KAAGGX/1 $
MPYADKAAGGX,INTEXT,/KAAEXTSE $
MODTRLKAAEXTSE////6 $
MPYADINTEXT,PAG,/PAEXTSE/1 $
MPYADINTEXT,GMNGG,/GMNGGX/1 $
MPYADGMNGGX,INTEXT,/GMNEXTSE $
$GENERATE DMIG FORMAT
MATMODKAAEXTSE,EQEXIN,,,,/MATPOOLK,/16/PUNCHFLG
MATMODPAEXTSE,EQEXIN,,,,/MATPOOLP,/16/PUNCHFLG
MATMODGMNEXTSE,EQEXIN,,,,/MATPOOLG,/16/PUNCHFLG
$ MATPPOLK, MATPPOLP AND MATPOOLG OUTPUT DATA BLOCKS
$ HAVE TO BE GENERATED ABOVE EVEN THOUGH ONLY DMIG
$ PUNCHED OUTPUT IS DESIRED
Main Index
1055 MATMOD
Matrix modification
DMAP for MSC.Nastran 2005 r2 (and subsequent releases):
Option P1 = 17
Generate a g-size partitioning vector from a user-defined set of grid and/or scalar points or from a
user-supplied bit position that designates one of the USET sets.
Format:
Input Data Blocks:
Output Data Block:
FILEMATPOOLA = APPEND $ PERMIT CONCATENATED OUTPUT
TYPE PARM,,I,N,SORTFLG=1 $ INPUT MATRICES ARE IN
INTERNAL SORT
MATMOD
KAA,EQEXIN,USET,,,/MATPOOLA,/16//SORTFLG//////////
KAAXSE/A $
MATMOD
MAA,EQEXIN,USET,,,/MATPOOLA,/16//SORTFLG//////////
MAAXSE/A $
MATMOD
BAA,EQEXIN,USET,,,/MATPOOLA,/16//SORTFLG//////////
BAAXSE/A $
MATMOD
K4AA,EQEXIN,USET,,,/MATPOOLA,/16//SORTFLG//////////
K4AAXSE/A $
MATMOD EQEXIN,USET,SIL,CASECC,,/CP,/17/UBIT/SETFLG/
S,N,NOCP////////SETSTR1/SETSTR2/SETSTR3/SETSTR
4 $
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
USET Degree-of-freedom set membership table for g-set.
SIL Scalar index list.
CASECC Table of Case Control command images.
CP Column partitioning vector.
Main Index
MATMOD
Matrix modification
1056
Parameters:
UBIT Input-integer-default=0. Obsolete method for set selection. For a more user-
friendly method use SETSTRi. In order to select specific sets for UBIT, add the
corresponding decimal equivalent numbers from the table below. For example, sets
R, O, and MP, UBIT=8+4+1=13. For supersets, add the decimal equivalent
numbers of the mutually exclusive sets which are contained in the superset. For
example, set S combines the SB and SG set and therefore UBIT=1024+512=1536.
The presence of any grid point degree of freedom in the associated sets causes all
degrees of freedom associated with that grid point to be given a value of 1.0 in the
output vector.
Set
Name
Decimal
Equivalent
Number
Q 4194304
LM 2097152
C 1048576
J 524288
K 262144
SA 131072
E 2048
SB 1024
SG 512
MR 16
R 8
O 4
B 2
MP 1
Main Index
1057 MATMOD
Matrix modification
Remarks:
1. None of the data blocks may be purged.
2. UBIT entry must be a legitimate value.
Example:
Generate a partitioning vector from a set of grid points defined in the Case Control Section.
The Case Control Section contains:
SET 10 = 1 THRU 50
PARTN = 10
Option P1 = 18
Insert or modify a GEOM3 table temperature record.
Format:
SETFLG Input-integer-default=0. If SETFLG = 0, then SETFLG selects a set of grid point
identification numbers of which all degrees of freedom associated with each point
will be assigned a value of 1.0 in the corresponding row of CP. If no SET command
is found, then the UBIT parameter is used.
If SETFLG>0 then the PARTN=SID Case Control command selects the SET
command.
If SETFLG<0 then absolute value of SETFLG selects the SET command.
NOCP Output-integer. NOCP will be set to -1 if the partitioning vector is null or cannot be
generated. Otherwise, it will be set to zero.
SETSTRi Input-character-default=' '. Set name string. SETSTR1 through SETSTR4 form
a single string of set name(s) and is 32 characters in length. The set names must be
separated by a plus sign, "+". For example, SETSTR1='M+R+N+SG' and
SETSTR2='+A+Q' specifies the m, r, n, sg, a, and q sets.
MATMOD EQEXIN,USET,SIL,CASECC,,/VECX,/17/128/1 $
Note: If no set had been selected in the Case Control Section, the vector VECX would have been
generated using the a-set degrees of freedom since UBIT=128.
MATMOD GEOM3,GPL,UG,,,/GEOM3T,/18/SID $
Main Index
MATMOD
Matrix modification
1058
Input Data Blocks:
Output Data Block:
Parameter:
Remarks:
1. This option should only be used in heat transfer analysis.
2. None of the data blocks may be purged.
3. Only grid temperature records (not elements) are modified.
Example:
Put data from the temperature vector UG into a record for SID = 30.
MATMOD GEOM3,GPL,UG,,,/GEOM3NEW,/18/30 $
Option P1 = 19
Extract a temperature vector from a GEOM3 table.
Format:
Input Data Blocks:
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GPL External grid/scalar point identification number list.
UG Temperature matrix in g-set.
GEOM3T GEOM3 table with new or modified temperatures.
SID Input-integer. Temperature set to be modified or added.
MATMOD GEOM3,EQEXIN,,,,/UGT,/19/SID $
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
Main Index
1059 MATMOD
Matrix modification
Output Data Block:
Parameter:
Remarks:
1. This option should only be used in heat transfer analysis.
2. None of the data blocks may be purged.
3. Only grid temperature records (not elements) are extracted.
Example:
Extract the temperature vector UGN for SID = 40.
MATMOD GEOM3,EQEXIN,,,,/UGN,/19/40 $
Option P1 = 20
Print the magnitude of the largest terms of up to six matrices.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
UGT Updated temperature matrix in g-set.
SID Input-integer. Temperature set to extract.
MATMOD I1,I2,I3,I4,I5,I6/O1,/20///PRTOPT/S,N,SUM $
I1 though I6 Any matrix. (Real or complex)
O1 Dummy output data block.
PRTOPT Specifies how the results are to be printed:
0 Print a page header identifying the output as coming from this module before
printing the results. (Default)
1 Print the results without a page header.
Main Index
MATMOD
Matrix modification
1060
Remarks:
1. Any input matrix may be purged.
2. All computations are performed in single or double precision depending on the matrix type. The
magnitudes of the largest terms and SUM are converted to single precision for output.
Option P1 = 21
Extracts the components of a factor matrix and converts them to a standard form suitable for input to any
matrix module.
Format for Sparse Factor Matrix (FORM=13):
Format for Active Column Factor Matrix (FORM=4):
Input Data Block:
Output Data Blocks:
Remarks:
1. Sparse symmetric decomposition forms the equivalent matrix representation of a symmetric
matrix.
2 Do not print anything. Results are returned in SUM (normally only used
with a single input matrix).
SUM Output-real. Sum of the absolute values of the largest terms in the input matrices.
MATMOD LD,,,,,/T,LP/21 $
MATMOD LD,,,,,/L,D/21 $
LD Lower triangular factor/diagonal matrix.
T Diagonal from sparse symmetric decomposition.
LP Lower triangular and permutation matrix appended together.
L Lower triangular matrix from symmetric decomposition.
D Diagonal matrix from symmetric decomposition.
L | |
L | |
D | |
A | | P | |
T
L | | D | | L | |
T
P | | =
Main Index
1061 MATMOD
Matrix modification
where P is a permutation matrix (row and column interchange used to improve efficiency), L, a
lower triangular matrix, and D, a tridiagonal matrix. Option 21 extracts P, L, and D and converts
them to a standard form, suitable for input to any matrix module. L and P are appended column-
wise in output D.
2. Active column symmetric decomposition forms the equivalent matrix representation of a
symmetric matrix.
where is a lower triangular matrix and is a diagonal matrix.
The diagonal matrix is stored with the lower triangular matrix in a special matrix
.
3. The input matrix LD may be single or double precision. Output matrices are the same type as input
matrix.
Example:
Extract components of sparse factor matrix LLL:
Option P1 = 22
Generate special aeroelasticity matrix with modified trailers.
Format:
Input Data Blocks:
Output Data Block:
MATMOD MKLIST,Qij,,,,/QijL,/22 $
MKLIST Table of Mach number and reduced frequency pairs.
Qij Aerodynamic matrix.
QijL Special aerodynamic matrix with modified trailers.
A | | L | | D | | L | |
T
=
L | | D | |
D | | L | |
LD | |
MATMOD LLL,,,,,/TT,LP/21 $
PARAML KLL//'TRAILER'/1/S,N,NL $
TYPE PARM,,I,N,TUNL $
TUNL = 2 * NL $
MATGEN ,/V21/6/TUNL/NL/NL $
PARTN LP,V21,/LL,,PP,/0 $
Main Index
MATMOD
Matrix modification
1062
Option P1 = 23
Determines type of eigenvalue analysis requested and optionally extracts values from the selected EIGR
or EIGRL Bulk Data entry.
Format:
Input Data Blocks:
Parameters:
Examples:
1. Determine method type on the EIGR entry:
MATMOD CASECC,DYNAMIC,,,,/,/23/S,N,METHTYP $
MATMOD CASECC,DYNAMIC,,,,/,/23/
S,N,METHTYP/S,N,LANCZOS/METHFLAGI/S,N,EIGRVALR
//
S,N,NFOUND/ICASE/S,N,EIGVALI///S,N,EIGRFLD $
CASECC Table of Case Control command images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
METHTYP Output-integer. Set to 1 if Inverse Power or Lanczos method selected; otherwise, set
to zero.
LANCZOS Output-integer. Set to -1 if Lanczos method selected; otherwise, set to zero.
METHFLAG Input-integer-default=0. METHOD ID selection flag.
>0 Search based on METHFLAG=SID.
0 Search based on METHOD(STRUCTURE)=SID.
-1 Search based on METHOD(FLUID)=SID.
-2 Search based on CMETHOD=SID
-3 Same as 0 except include EIGB in search for buckling.
EIGRVALR Output-real-default=0.0. Extracted real value from the EIGR or EIGRL entry.
NFOUND Output-integer-default=0. EIGR* entry found flag; 0 if entry was found and -1 if
entry was not found.
ICASE Input-integer-default=1. Case Control record number which contains the
METHOD command.
EIGRVALI Output-integer-default=0. Extracted integer value from the EIGR or EIGRL entry.
EIGRFLD EIGRFLD Input/output-character-default=' '. Field name of EIGR or EIGRL entry.
EIGRFLD is also an output if the field value is a character string.
Main Index
1063 MATMOD
Matrix modification
IF ( METHTYP=1 ) THEN $
MESSAGE //' LANCZOS OR SINV IS SELECTED.' $
ELSE $
MESSAGE //' GIVENS OR HOUSEHOLDER IS SELECTED.' $
ENDIF $
2. Extract the F2 field value from the EIGR entry:
MATMOD CASECC,DYNAMIC,,,,/,/23////S,N,F2///////'F2' $
3. Extract the NORM field value from the EIGR entry:
NORM='NORM' $ initialize and will change on output
MATMOD CASECC,DYNAMIC,,,,/,/23///////////S,N,NORM $
Option P1 = 24
Generate a square matrix that has a 1.0 at the intersection of every null row and null column of I1, I2, and
I3 simultaneously.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remark:
Any two input matrices may be purged.
MATMOD I1,I2,I3,,,/O1,/24/S,N,NOOUT/NMATX/S,N,NRNENC
$
I1, I2, I3 Square, commensurate matrices. (Real or complex)
O1 Square matrix that has a 1.0 at the intersection of every null row and
null column of I1, I2, and I3 simultaneously.
NOOUT Output-integer. Set to -1 if O1 is null.
NMATX Input-integer-default=1. Number of input matrices to be used for
search, starting from the first input.
NRNENC Output-integer. Set to -1 if the number of null rows does not equal the
number of null columns.
Main Index
MATMOD
Matrix modification
1064
Example:
Add a unit value to the stiffness matrix for degrees of freedom that have no associated mass, damping,
or stiffness. This is usually done to prevent potential singularities during direct transient and frequency
analyses.
MATMOD MAA,BAA,KAA,,,/KAAX,/24/S,N,NOADD/3/S,N,NRNENC $
IF (NRNENC < 0) THEN $
MESSAGE//ERROR: MATRICES ARE NOT/
SYMMETRIC $
EXIT $
ENDIF $
IF (NOADD < -1) THEN
ADD KAA,KAAX/KAANEW $
EQUIVX KAANEW/KAA/ALWAYS $
ENDIF $
Option P1 = 25
Generate vectors that have 1.0 corresponding to each null row and null column in I1, I2, and I3
simultaneously.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MATMOD I1,I2,I3,,,/O1,O2/25/S,N,NOOUT/NMATX/
S,N,NRNENC///S,N,SYM $
I1, I2, I3 Square, commensurate matrices. (Real or complex).
O1 Vector that has 1.0 corresponding to each null row in I1, I2, and I3
simultaneously. See Remark 1.
O2 Vector that has 1.0 corresponding to each null column in I1, I2, and I3
simultaneously.
NOOUT Output-integer. Set to -1 if both output vectors are null, set to zero
otherwise.
NMATX Input-integer-default=1. Number of input matrices to be used for
search, starting from the first input.
Main Index
1065 MATMOD
Matrix modification
Remarks:
1. Any two input matrices may be purged.
2. If I1, I2, and I3 are symmetric, then O2 is purged.
Example:
Remove null rows and columns from matrix A.
MATMOD A,,,,,/RPARTN,CPARTN/25/S,N,NOOUT/1////S,N,SYM $
IF (NOOUT > -1) THEN $
PARTN A,CPARTN,RPARTN/ANEW/SYM $
EQUIVX ANEW/A/ALWAYS $
ENDIF $
Option P1 = 26
Used by MSC for development testing.
Option P1 = 27
Convert a diagonal matrix (form 3) to a symmetric matrix (form 6).
Format:
Input Data Block:
Output Data Block:
Remarks:
1. Form 3 matrices are not output by any module. They are only allowed as input by the INPUTT2,
INPUTT4, and DMIIN modules.
2. The SMPYAD, MPYAD, and ADD modules will not accept form 3 matrices. The matrices should
now be converted to form 6 before use in these modules.
NRNENC Output-integer. Set to -1 if number of null rows does not equal the
number of null columns; otherwise zero.
SYM Output-integer. Set to -1 if I1, I2, and I3 are symmetric; otherwise zero.
See Remark 2.
MATMOD I1,,,,,/O1,/27 $
I1 Diagonal matrix of form 3. (Real or complex).
O1 Symmetric matrix of form 6 containing diagonal terms of I1.
Main Index
MATMOD
Matrix modification
1066
Example:
DMIIN DMI,DMINDX/A3,,,,,,,,, $
MATMOD A3,,,,,/A6,/27 $
where A3 is the DMI matrix defined by the Bulk Data entries
DMI,A3,0,3,1,1,,4,1
DMI,A3,1,2,2.0,3.0,4.0
and A6 is the matrix
Option P1 = 28
Convert the first column of a matrix to a symmetric matrix (form 6) with the terms of the first column
along the diagonal and off-diagonal terms set to zero.
Format:
Input Data Block:
Output Data Block:
Example:
MATMOD B,,,,,/BDIAG,/28 $
If B is the matrix
then BDIAG will be
MATMOD I1,,,,,/O1,/28 $
I1 Any matrix of form 1, 2, or 6. (Real or complex)
O1 Symmetric matrix (form 6) with terms of the first column of I1 along
the diagonal and off-diagonal terms set to zero.
0. 0. 0. 0.
0. 2. 0. 0.
0. 0. 3. 0.
0. 0. 0. 4.
1. 2.
3. 4.
Main Index
1067 MATMOD
Matrix modification
Option P1 = 29
Used by MSC for development testing.
Option P1 = 30
Print data blocks or a portion of data blocks as a table of hexadecimal values.
Format:
Input Data Block:
Parameters:
Option P1 = 31
Writes the bit map of a matrix to the punch file.
Format:
Input Data Block:
Output Data Block:
None.
MATMOD I1,I2,I3,I4,I5,I6/,/30/BBLK/EBLK $
Ii Any data block. (Matrix or table)
BBLK Input-integer-default=1. Beginning GINO block number.
EBLK Input-integer-default=-1. Ending GINO block number. Default value
implies the total number of blocks.
MATMOD MAT,,,,,/,/31/MAXSIZ $
MAT Any matrix.
1. 0.
0. 3.
Main Index
MATMOD
Matrix modification
1068
Parameter:
Option P1 = 32
Convert tables created by DRMH1 into DTI Bulk Data entry format and write to the punch file. Also
converts DRMH1 directory tables in DTI Bulk Data entry format into DRMH1 output table format.
Format:
Input Data Block:
Output Data Block:
Parameter:
Remark:
Table record 3 is all character and reading DTI entries will produce all numbers. Therefore CONVERT=1
will convert the DTI numbers and to character values.
Option P1 = 33
Create a single column matrix from the frequency response output list table, FOL. The frequencies are
also converted to radian units.
Format:
MAXSIZ Input-integer-default=0. Maximum size of the bit map matrix (row
and/or column).
MATMOD TXY,,,,,/TOUT,/32/CONVERT $
TXY DRMH1 directory table in DTI or table data block format.
TOUT DRMH1 directory table in table data block format or DTI format.
CONVERT Input-integer-default=0. Convert option.
0 Table data block format to DTI format.
1 DDTI to table data block format.
MATMOD FOL,,,,,/FOLMAT,/33 $
Main Index
1069 MATMOD
Matrix modification
Input Data Block:
Output Data Block:
Parameters:
None.
Option P1 = 34
Extract the real and imaginary parts of complex matrix into two real matrices.
Format:
Input Data Block:
Output Data Blocks:
Parameter:
Option P1 = 35
Sorts row term values in a selected column of the input matrix and produces a list vector and/or a Boolean
matrix that contains the indices of the sorted terms.
FOL Frequency response frequency output list.
FOLMAT Matrix of frequencies in radian units.
MATMOD CMAT,,,,,/RMAT,IMAT/34//PREC $
CMAT Complex matrix.
RMAT Matrix containing real part of CMAT.
IMAT Matrix containing imaginary part of CMAT.
PREC Input-integer-default=0. Precision of output matrices.
0 Machine-precision. (Default)
1 Single.
2 Double.
Main Index
MATMOD
Matrix modification
1070
Format:
Input Data Block:
Output Data Blocks:
Parameters:
Remark:
For complex matrices, only SORTOPT=2 or -2 is allowed.
MATMOD IM,,,,,/
SORTLIST,SORTBOOL/S,N,P1/COLNUM/S,N,PRESORT/
SORTOPT/// NKEYS $
IM Any matrix.
SORTLIST Vector consisting of the row numbers of the original positions of the
sorted terms.
SORTBOOL Square matrix containing unity at a row position in the column
associated with the sorted row terms.
P1 Input/output-integer-no default. On output, P1=-1 if the input matrix is purged or
both output data blocks are purged.
COLNUM Input-integer-default=0. Selects the column number of the input matrix that will be
sorted to produce SORTLIST and SORTBOOL. Default selects the first column.
PRESORT Output-integer-default=0 Pre-sort flag. Set to -1 if column is already sorted.
SORTOPT Input-integer-default=0. Sort option specification.
-2 Absolute value in descending order.
-1 Algebraic value in descending order.
0 Implies SORTOPT=1 if IM is real and SORTOPT=2 if IM is complex..
1 Algebraic value in ascending order.
2 Absolute value in ascending order.
NKEYS Input-integer-default=1. Duplicate value sort option specification.
1 Single key sort.
2 Double key sort to maintain original order of terms in case of duplicate terms.
Main Index
1071 MATMOD
Matrix modification
Example:
Given the input matrix, IM, generate an algebraic ascending order sort. The input matrix and its sorted
order (algebraically ascending) are:
The MATMOD call would look like:
and the output matrix LIST for NKEYS=2 would contain
For NKEYS=1, it is equally likely that the indices for equal values may be in a different order. For
example, if the MATMOD call statement were
IM =
P1=35 $
MATMOD IM,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////2 $
LIST =
P1=35 $
MATMOD IM,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////1 $
2.0
0.0
1.0
4.0
1.0
0.0
)
`
1.0
3.0
2.0
6.0
5.0
4.0
)
`
Main Index
MATMOD
Matrix modification
1072
then the output matrix LIST for NKEYS=1 could contain either
or
since there are duplicate terms (0.0's) in the input matrix column and a single key sort was used.
The Boolean square matrix contains unit values in the appropriate positions so that it can be used to create
the sorted input matrix by means of a simple matrix multiply as in:
producing the sorted IM matrix, IMS, as
LIST =
LIST =
MPYAD BOOL,IM,/IMS/1 $
IMS =
1.0
3.0
6.0
2 0 ,
5.0
4.0
)
`
1.0
3.0
2.0
6.0
5.0
4.0
)
`
2.0
1.0
0.0
0.0
1.0
4.0
)
`
Main Index
1073 MATMOD
Matrix modification
Remarks:
1. If the matrix input into this option contains more than one column and SORTBOOL is used
subsequently to operate on this matrix, all columns will have their rows re-ordered according to
the sort obtained from the column processed by the MATMOD operation. In this case, the column
that was selected during the MATMOD operation to produce the sorted ordering will be
guaranteed in sort. Other columns may or may not have their rows in sorted order.
2. The output data blocks are in machine precision, regardless of the precision of the input matrix.
3. NKEYS=2 provides a more repeatable sort in the presence of equal values in the input, at the cost
of longer run times. A test on a typical vector showed a difference of a factor of approximately
ten. If repeatability is not essential, NKEYS=1 is the preferred choice.
Option P1 = 36
Reduce the GRID record in the GEOM1 table to the entries corresponding to grid identification numbers
specified in a Case Control set.
General Format:
Format for M36OPT=0 (default):
Format for M36OPT=1: Set consistency check
Format for M36OPT=2: Generate point set from element set
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/M36OPT///ELEMSET/MSGLVL
/PCHSET $
MATMOD GEOM1,CASECC,,,,/
GEOM1R,/
36/GRIDSET/S,N,NOGEOM1 $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,/
36/GRIDSET//1///ELEMSET/MSGLVL/PCHSET $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/2///ELEMSET//PCHSET $
Main Index
MATMOD
Matrix modification
1074
Format for M36OPT=3: Generate point set from element set and grid set
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. Only the GRID record is processed and all other GEOM1 records are copied as is to GEOM1R.
2. GEOM1 must be indexed with IFPINDX module before being used as input to this MATMOD
option:
FILE GEOM1=APPEND $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/3///ELEMSET//PCHSET $
GEOM1 Table of Bulk Data entry images related to geometry and indexed by
the IFPINDX module. See Remark 2.
CASECC Table of Case Control command selections.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
BGPDT Basic grid point definition table.
GEOM1R GEOM1 table with reduced GRID record.
CASER Table of Case Control command images loaded with SET
id=GRIDSET.
GRIDSET Input-integer. SET Case Control command identification number which
contains a list grid point identification numbers.
NOGEOM1 Output-integer. Processing status flag.
+1 No grid points found matching the contents of SET=GRIDSET.
0 GRIDSET found and the contents match some grid points in GEOM1.
-1 GRIDSET found and the contents matches all grid points in GEOM1.
M36OPT Input-integer. Suboption of MATMOD Option 36.
MSGLVL Input-integer. Termination flag. See Remark 4b.
PCHSET Input-integer. Punch flag. If PCHSET=1, then the set generated will be written
to the punch file in Case Control command SET format.
Main Index
1075 MATMOD
Matrix modification
IFPINDX /GEOM1 $
MATMOD GEOM1,CASECC,,,,/GEOM1R,/36/
GRIDSET/S,N,NOGEOM1 $
3. It is recommended that GEOM1 and GEOM2 be converted by the SECONVRT module and then
used as input to MATMOD.
4. M36OPT=1 performs a consistency check of the input sets and the actions are:
a. Create a grid point set of all points connected to the elements specified in the ELEMSET Case
Control set.
b. Verify that all points in the set generated above are present in the GRIDSET Case Control set
and vice-versa. By default, a fatal message will be issued error if any point is missing. But if
MSGLVL=-1, then a warning message is issued instead.
c. GEOM1R is an optional output, but if specified and if no inconsistency is detected then
GEOM1R will be generated.
5. M36OPT=2 ensures a consistent grid point set for the input element set and the actions are:
a. Create a set in CASER of all points touched by the elements contained in the ELEMSET Case
Control set. Create a Case Control set in CASER with an id = GRIDSET.
b. Create the GEOM1R based on CASER.
6. M36OPT=3 ensures a consistent grid point set for the input element set and allows additional
points to be added to the set and the actions are:
a. Create a set in CASER of all points touched by the elements contained in the ELEMSET Case
Control set defined in CASECC.
b. Create a Case Control set in CASER of the point set generated in a.
c. Locate the GRIDSET set in CASECC and merge in the set created in a. If GRIDSET set does
not exist on CASECC, simply store the ELEMSET generated grid list as the GRIDSET set ID
in CASER. Otherwise, copy the merged GRIDSET set into CASER.
d. Create the GEOM1R based on CASER.
Option P1 = 37
Reduce the element and SPOINT records in the GEOM2 table to the entries corresponding to element or
SPOINT identification numbers specified in a Case Control set.
Format:
MATMOD GEOM2,CASECC,,,,/GEOM2R,/37/
ELEMSET/GRIDSET/S,N,NOGEOM2 $
Main Index
MATMOD
Matrix modification
1076
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. GEOM2 must be indexed with IFPINDX module before being used as input to this MATMOD
option:
FILE GEOM2=APPEND $
IFPINDX /GEOM2 $
MATMOD GEOM2,CASECC,,,,/GEOM2R,/37/
ELEMSET/GRIDSET/S,N,NOGEOM2 $
2. It is recommend that GEOM2 be converted by the SECONVRT module and then used as input to
MATMOD.
Option P1 = 38
Reduce the records in the EST table to the entries corresponding to element numbers specified in a Case
Control set.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points and indexed by the IFPINDX module. See Remark.
CASECC Table of Case Control command selections.
GEOM2R GEOM2 table with reduced element record.
ELEMSET Input-integer. SET Case Control command identification number which contains a
list element identification numbers.
GRIDSET Input-integer. SET Case Control command identification number which contains a
list SPOINT identification numbers.
NOGEOM2 Output-integer. Processing status flag.
+1 No element and SPOINTs found in GEOM2 matching the contents in
ELEMSET and GRIDSET.
0 Some elements and SPOINTs in GEOM2 were found in ELEMSET and
GRIDSET.
-1 All elements and SPOINTs in GEOM2 were found in ELEMSET and
GRIDSET.
Main Index
1077 MATMOD
Matrix modification
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. EST must be indexed with IFPINDX module before being used as input to this MATMOD option:
FILE EST=APPEND $
IFPINDX /EST $
MATMOD EST,CASECC,,,,/ESTR,/38/
ELEMSET/GRIDSET/S,N,NOEST $
Option P1 = 39
Remove and identify explicit zero terms in a matrix.
Format:
MATMOD EST,CASECC,,,,/ESTR,/38/
ELEMSET/GRIDSET/S,N,NOEST $
EST Table of Bulk Data entry images related to geometry and indexed by
the IFPINDX module.
CASECC Table of Case Control command selections.
ESTR EST table with reduced records.
ELEMSET Input-integer. SET Case Control command identification number that contains a
list element point identification numbers.
GRIDSET Input-integer. SET Case Control command identification number which contains
a list grid point identification numbers.
NOEST Output-integer. Processing status flag.
+1 No element found in EST matching the contents of ELEMSET.
0 Some elements in EST were found in ELEMSET.
-1 All elements and SPOINTs in EST were found in ELEMSET.
MATMOD I1,,,,,/O1,O2/39/S,N,NOXPLZER $
Main Index
MATMOD
Matrix modification
1078
Input Data Block:
Output Data Blocks:
Parameter:
Option P1 = 40
Replace the value of, or add a value to, a single term in a matrix.
Format:
Input Data Block:
Output Data Block:
Parameters:
I1 Any matrix.
O1 Matrix I1 with explicit zero terms removed.
O2 Matrix containing a 1.0 at the row and column, where an explicit zero
was found in I1.
NOXPLZER Output-integer. Explicit zero existence flag. Set to -1 if no explicit
zeros are found.
MATMOD I1,,,,/O1,/
40/ICOL/IROW/TYPE/REAL//NCOL/NROW/
////////REALD/CMPLX/CMPLXD $
I1 A matrix. May be purged. See NCOL.
O1 Modified I1 matrix.
ICOL Column number.
IROW Row number.
TYPE Type of value to be replaced or added.
-1 Replace current value with REAL.
-2 Replace current value with REALD.
Main Index
1079 MATMOD
Matrix modification
Example:
In matrix A, add 10.5 to the value at column 2 and row 3:
Option P1 = 41
Reorder the rows of a rectangular matrix.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
-3 Replace current value with CMPLX.
-4 Replace current value with CMPLXD.
1 Add REAL to current value.
2 Add REALD to current value.
3 Add CMPLX to current value.
4 Add CMPLXD to current value.
REAL Real single precision value.
NCOL Number of columns in O1 if I1 is purged. Default=ICOL.
NROW Number of rows in O1 if I1 is purged. Default=IROW.
REALD Real double precision value.
CMPLX Complex single precision value.
CMPLXD Complex double single precision value.
MATMOD A,,,,,/A1,/40/2/3/-1/10.5 $
MATMOD GRDRM,I1,,,,/O1,/41 $
GRDRM Permutation matrix.
I1 Rectangular matrix.
O1 Reordered rectangular matrix.
Main Index
MATMOD
Matrix modification
1080
Option P1 = 42
Permute a sparse square matrix.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Option P1 = 43
Not implemented.
Option P1 = 44
Creates EQEXIN table based on g-set partitioning vector.
Format:
Input Data Blocks:
Output Data Block:
EQEXINR EQEXIN reduced by VG.
Parameters:
None.
MATMOD GRDRM,I1,,,,/O1,/42 $
GRDRM Permutation matrix.
I1 Square matrix.
O1 Permuted matrix.
MATMOD EQEXIN,VG,,,,/EQEXINR,/44 $
EQEXIN Equivalence table between internal and external grid identification
numbers.
VG Partitioning vector with 1.0 desired degrees-of-freedom.
Main Index
1081 MATMOD
Matrix modification
Option P1 = 45
Permute matrix according to a row permutation.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
Option P1 = 46
Convert a sparse partial decomp matrix into a regular matrix datablock.
Format:
Input Data Block:
Output Data Block:
Parameter:
MATMOD I1,RPERM,,,,/O1,/45/PERMOPT $
RPERM Table of row permutations.
I1 Square matrix.
O1 Permuted matrix.
PERMOPT Input-integer. Permutation option.
1 Gather.
2 Scatter.
MATMOD KTTP,,,,,/KTTS,/46/NOOSET $
KTTP Sparse partial decomp update matrix.
KTTS KTTP converted to standard matrix format.
NOOSET Input-integer. Number of degrees-of-freedom in the o-set.
Main Index
MATMOD
Matrix modification
1082
Example:
Option P1 = 47
Perform null row search on a matrix.
Format:
Input Data Block:
Output Data Block:
Parameter:
Option P1 = 52
Convert frequency response displacement vectors to velocity or acceleration vectors.
Format:
PUTSYS(1,277) $ Force partial decomp
DCMP USET,SILS,EQEXINS,KFFX,VFO,VFOX/
LFO,KTTSP,/3///MAXRATIO/'F' $
PUTSYS(0,277) $
MATMOD KTTSP,,,,,/KTTREG,/46/NOOSET $
DIAGONAL KTTREG/KTTDIAG/'SQUARE' $
TRNSP KTTREG/KTTTRAN $
ADD5 KTTREG,KTTTRAN,KTTDIAG,,/KTT///-1.0 $
MODTRL KTT////6 $
MATMOD I1,,,,,/O1,/47///P4 $
I1 Any matrix.
O1 Column vector which has 1.0 at those rows where I1 has null rows if
P4 > 0 or non-null if P4 < 0. If I1 is purged, then O1 is purged. If I1 is
null, then O1 will be full.
P4 Input-integer-default=0. See O1.
MATMOD MATMOD I1,FOL,,,,/O1,O2/52 $
Main Index
1083 MATMOD
Matrix modification
Input Data Block:
Output Data Block:
Parameter:
Remarks:
1. Velocity vectors are computed by multiplying each term of a column of I1with corresponding .
2. Acceleration vectors are computed by multiplying each term of a column of I1with corresponding
I1 Any displacement matrix. (Real or complex).
FOL Forcing frequency list for frequency response analysis.
O1 Velocity matrix (complex).
O2 Acceleration matrix (Real or complex).
P4 Input-integer-default=0. See O1.
ie
e
2
Main Index
MATOFP
Prints matrix similar to DISPLACEMENT output
1084
Prints a matrix in the format similar to DISPLACEMENT output with a user-defined column label and
page header.
Format:
Input Data Blocks:
Output Data Blocks:
MATOFP
Prints matrix similar to DISPLACEMENT output
MATOFP MAT,BGPDT,OL,USET/
OMAT1/
APP/ROWNAM/PRNTOPT/TCODE/PUNCH/IPRINT/
LCOLLBL1/LCOLLBL2/LCOLLBL3/LCOLLBL4/
RCOLLBL1/RCOLLBL2/RCOLLBL3/RCOLLBL4/
HDRLBL1/HDRLBL2/HDRLBL3/HDRLBL4/
HDRLBL5/HDRLBL6/HDRLBL7/HDRLBL8 $
MAT Matrix (real or complex). The rows of the matrix must correspond to the g-
set DOFs.
BGPDT Basic grid point definition table.
OL List of values for column labeling on left corner of page. The contents of OL
depend on the value of APP:
APP OL
'REIGEN'
'FREQRESP'
'TRANRESP'
'CEIGEN'
'BKL1'
'NLST'
'USERLIST'
LAMA
FOL
TOL
CLAMA
BLAMA
COMB
Matrix column of user defined values
If OL is purged, then the left corner will not be labeled.
USET Degree-of-freedom set membership table for the g-set.
OMAT1 MAT converted to OFP-suitable table in SORT1 format.
Main Index
1085 MATOFP
Prints matrix similar to DISPLACEMENT output
Parameters:
APP Input-character-default='USERLIST'. Analysis type. See OL above.
ROWNAM Input-character-default = ' '. Set name for rows in MATRIX. If ROWNAM is
blank, then it defaults to COLNAM.
PRNTOPT Input-character-default = ALL. Must be one of the following values:
Option Action
NULL Only null columns will be identified.
ALL Print all nonzero terms in matrix.
ALLP Print numbers converted to magnitude/phase.
TCODE Input-integer-default=1. Table code.
PUNCH Input-logical-default=FALSE. Punch file write control flag.
IPRINT Input-integer-default=0. Print control flag.
0: print
<>0: do not print
LCOLLBLi Input-character-default=(depends on APP). Label with up to 32 characters to be
printed left-justified in upper left corner of each page. The default values
depends on APP:
APP LCOLLBLi
'TRANRESP'
'FREQRESP'
'REIGEN'
'CEIGEN'
'USERLIST'
TIME
FREQUENCY
FREQUENCY
FREQUENCY
LABEL
RCOLLBLi Input-character-default='COLUMN' (followed by column number). Label with
up to 32 characters to be printed right-justified in upper right corner of each page.
COLLBLi is then followed by column number.
HDRLBLi Input-character-default='MATRIX' (followed by matrix name). Header with up
to 64 characters to be printed and centered at the top of of each page.
Main Index
MATOFP
Prints matrix similar to DISPLACEMENT output
1086
Examples:
Example 1:
Example 2:
MATOFP GCF,BGPDT,,USET/ $
GROUND CHECK AND WEIGHT CHECK AUGUST 11, 2000
MSC.NASTRAN 8/10/00 PAGE 9
ADAPTED FROM CHECKA ALTER BY T.ROSE
DEVELOPED BY M.REYMOND AND N.TENG
COLUMN 1
MATRIX GCF
POINT ID. TYPE T1 T2 T3 R1 R2
R3
1 G .0 .0 .0 .0 .0
1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0
1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -
4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0
4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0
MATOFP GCF,BGPDTs,,USET/
OGCF1///////////
DIRECTIO/N///
G R O U /N D C H /E C K /F O R C /
E S ( G /- S E T /) $
Main Index
1087 MATOFP
Prints matrix similar to DISPLACEMENT output
GROUND CHECK AND WEIGHT CHECK AUGUST 11, 2000 MSC.NASTRAN
8/10/00 PAGE 9
ADAPTED FROM CHECKA ALTER BY T.ROSE
DEVELOPED BY M.REYMOND AND N.TENG
DIRECTION 1
G R O U N D C H E C K F O R C E S ( G - S E T )
POINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0
1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0
1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -
4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0
4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0
Main Index
MATPCH
Punches contents of matrix data blocks
1088
Punches the contents of matrix data blocks onto DMI Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Remarks:
1. The nonzero elements of each matrix are punched on double-field DMI entries as shown in the
example below. The name of the matrix is obtained from the header record of the data block.
Field 10 contains the three-character parameter value in columns 74 through 76 and an
incremented integer record count in columns 77 through 80 if nondefault values are used for the
Ni parameters.
2. Double precision matrices will be converted to single precision. Only the real part of complex
matrices will be used.
3. All matrices are output on double-field entries in single precision.
4. If Ni is specified, then Ni must be different for each corresponding input matrix. Also, the
maximum number of records that may be punched is 99999. If full square matrices are considered,
a maximum order of 629 is allowed. If matrices larger than this are desired, use the OUTPUT2 or
OUTPUT4 modules to produce a FORTRAN readable file.
MATPCH
Punches contents of matrix data blocks
MATPCH I1,I2,I3,14,I5//IVNIT/N1/N2/N3/N4/N5 $
Ii Any real matrix data block.
IVNIT Input-integer-default=0. Fortran unit number. If this parameter is
negative, an echo of the DMI Bulk Data entries generated will be
printed on the FORTRAN unit given by the absolute value of
PRINTOPT.
Ni Input-character-default=blank. Continuation entry prefix. Used to
form a unique continuation string for the DMI Bulk Data entries. For
example, if Ni=xx, then this produces continuations of the form (xx
1), (xx 2), etc. The default value causes the blank continuation option
to be used. See Remark 4 if explicit continuations are desired.
Main Index
1089 MATPCH
Punches contents of matrix data blocks
5. Only sufficiently small nonpurged data blocks will be punched onto DMI Bulk Data entries.
Example:
Let the data block MAT contain the matrix
The DMAP statement
MATPCH MAT// $
will produce the following DMI entries:
1 2 3 4 5 6 7 8 9 10
DMI MAT 0 2 1 2 5 6
DMI MAT 1 1 1.000000E 00
* 3 2.000000E 00 5 3.000000E 00
DMI* MAT 2 3 4.000000E 00
* 5.000000E 00
DMI* MAT 3 1 6.000000E 00
* 7.000000E 00 5 8.000000E 00
DMI* MAT 6 4 9.000000E 00
MAT | |
1.0 0.0 6.0 0.0 0.0 0.0
0.0 0.0 7.0 0.0 0.0 0.0
2.0 4.0 0.0 0.0 0.0 0.0
0.0 5.0 0.0 0.0 0.0 9.0
3.0 0.0 8.0 0.0 0.0 0.0
=
Main Index
MATPRN
General matrix printer
1090
Prints general matrix data blocks.
Format:
Input Data Blocks:
Parameters:
Remarks:
1. Any or all input data blocks may be purged.
2. If any data block is not a matrix, it will be printed as if it were a table.
3. MATPRN prints the row index for the term that begins each line of printout.
4. MATPRN will not print out two or more consecutive lines of zeroes, but instead will issue a
message of the form:
ROW POSITIONS xxxx THRU yyyy NOT PRINTED -- ALL = 0.0.
5. If PRTFORM is set to 'LONG' (see Example 3), most of the digits of the internal representations
will be printed. Normally, the output is truncated to five or six digits.
6. For large, sparse matrices with scattered terms, the user is advised to use either the MATPRT or
MATGPR modules.
Examples:
1. MATPRN KGG/$
2. MATPRN KGG,PL,PG,BGG,UPV//$
3. MATPRN KGG //'LONG' $
MATPRN
General matrix printer
MATPRN M1,M2,M3,M4,M5//PRTFORM $
Mi Matrix data blocks, any of which may be purged. (Real or complex).
PRTFORM Character-input-default=' '. Real number precision.
LONG 12 significant digits.
SHORT 4 significant digits.
Main Index
1091 MATPRT
Matrix printer
Prints a matrix.
Format:
Input Data Block:
Parameters:
Remark:
Each column (or row) of the matrix is broken into groups of six terms (3 terms if complex) per printed
line. If all the terms in a group are 0, the line is not printed. If the entire column (or row) is 0, it is not
printed. If the entire matrix is null, it is not printed.
Example:
Print the mass matrix:
MATPRT MGG// $
MATPRT
Matrix printer
MATPRT MATRIX//PRNTLABL/PRNTFLAG $
MATRIX Matrix data block to be printed. If [X] is purged, then nothing is done.
PRNTLABL Integer-input-default=0. Print label. If PRNTFLG=1, then the matrix is
labeled with ROW n; otherwise it is labeled with COLUMN n.
PRNTFLAG Integer-input-default=0. Print flag. If PRNTFLAG < 0, do not print
[X]; Y > 0, print [X].
Main Index
MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set
1092
Reduces a square matrix from the g-set to the a-set or p-set to the d-set. Optionally produces the s-set by
f-set partition following multipoint constraint elimination and reduction.
Format:
Input Data Blocks:
Output Data Blocks:
MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set
MATREDU
, , , /
, XSF , XSS /
S,N, $
XGG Square matrix in g-set.
XPP Square matrix in p-set.
USET Degree-of-freedom set membership table for g-set.
USETD Degree-of-freedom set membership table for p-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
GMD Multipoint constraint transformation matrix with extra points, m-set by
ne-set.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set.
XAA Reduced square matrix in a-set.
XDD Reduced square matrix in d-set.
XSF S-set by f-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction.
XSS S-set by s-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction.
XGG
XPP
)
`
USET
USETD
)
`
GM
GMD
)
`
GOA
GOD
)
`
XAA
XDD
)
`
NOXGG
NOXPP
)
`
Main Index
1093 MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set
Parameters:
Method:
The damping matrices and are reduced to the a-set by the MATREDU module which
performs the following operations:
1. Eliminate multipoint constraints
2. Eliminate single point constraints
3. Partition omitted degrees-of-freedom
4. Perform static condensation
Remarks:
1. If XGG or XPP is not symmetric, then unsymmetric formulation of reduction is used.
2. XGG or XPP may be purged, in which case MATREDU returns with NOXAA=-1 or NOXDD=-
1.
3. GM (or GMD) and GOA (or GOD) may not be purged unless their m-set and o-set degrees-of-
freedom do not exist.
NOXGG Output-integer-default=1. XGG existence flag. Set to -1 if XGG does
not exist.
NOXPP Output-integer-default=1. XPP existence flag. Set to -1 if XPP does
not exist.
B
gg
| | K
gg
4
| |
B
gg
| |
B
nn
B
nm
B
mn
B
mm
B
nn
| | G
mn
| |
T
B
mn
G
mn
B
mn
+ | | B
mn
| |
T
G
mn
| | B
nn
| | + + =
B
nn
| |
B
ff
B
fs
B
sf
B
ss
B
ff
| |
B
aa
B
ao
B
oa
B
oo
B
aa
| | G
oa
| |
T
B
oo
G
oa
B
oa
+ | | B
oa
| |
T
G
oa
| | B
aa
| | + + =
Main Index
MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set
1094
4. XSF may be purged.
5. The method of reduction is equivalent to a combination of the DMAP modules UPARTN,
UMERGE1, SMPYAD, and MCE2.
Main Index
1095 MCE1
Creates multipoint constraint transformation matrix
Creates the multipoint constraint transformation matrix.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Method:
The multipoint constraint equations, , formed in the GP4 module, are partitioned by the MCE1
module (Multipoint Constraint Eliminator -- Phase 1) as follows:
MCE1 also solves the equation
for the transformation matrix .
MCE1
Creates multipoint constraint transformation matrix
MCE1 USET,RMG,KGG/
GM $
USET Degree-of-freedom set membership table for g-set.
RMG Multipoint constraint equation matrix.
KGG Stiffness matrix in g-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
R
mg
R
mg
| |
R
mm
R
mn
=
R
mm
| | G
mn
| | R
mn
| | =
G
mn
| |
Main Index
MCE2
Performs multipoint constraint elimination and reduction
1096
Performs multipoint constraint elimination and reduction on up to four g-set size square matrices.
Format 1: For g-set matrices
Format 2: For p-set matrices
Input Data Blocks:
Output Data Blocks:
Parameters:
Method:
The MCE2 module partitions the stiffness matrix
MCE2
Performs multipoint constraint elimination and reduction
MCE2 USET,GM,XGG1,XGG2,XGG3,XGG4/
XNN1,XNN2,XNN3,XNN4 $
MCE2 USETD,GMD,XPP1,XPP2,XPP3,XPP4/
XNENE1,XNENE2,XNENE3,XNENE4/NOUE $
USET Degree-of-freedom set membership table for g-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
XGGi Square matrices in g-set.
USETD Degree-of-freedom set membership table for p-set.
GMD Multipoint constraint transformation matrix with extra points, m-set by
ne-set.
XPPi Square matrix in p-set.
XNNi Square matrices in n-set.
XNENEi Square matrix in ne-set.
NOUE Input-integer-default=-1. The number of extra points. Set to -1 if there are no extra
points. USETD and GMD must be supplied if NOUE>0.
Main Index
1097 MCE2
Performs multipoint constraint elimination and reduction
(5-74)
and performs matrix reduction
(5-75)
Remark:
Any or all of XGGi and XNNi may be purged. However, if any of XGGi is specified then the
corresponding XNNi must also be specified.
Example:
Reduce .
K
gg
| |
K
nn
K
nm
K
mn
K
mm
=
K
nn
| | G
mn
| |
T
K
mm
G
mn
K
mn
+ | | K
mn
T
G
mn
K
nn
+ | | + =
K
gg
to K
nn
Main Index
MCFRAC
Compute, sort and print modal contribution fractions
1098
Compute, sort and print modal contribution fractions.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MCFRAC
Compute, sort and print modal contribution fractions
MCFRAC CASECC,LAMA,OL,BGPDT,RPH,UH,PVMCFR,MODSELT/
OMCF1,UNUSED/
APP/FMODE $
CASECC Table of Case Control command images.
LAMA Normal modes eigenvalue summary table.
OL Complex eigenvalue summary table, transient response time output list
or frequency response frequency output list. Must be consistent with
APP.
BGPDT Basic grid point definition table.
RPH Transformation matrix from h-set to p-set. See Remark.
UH Solution matrix for the h-set (modal degrees-offreedom). Modal
displacements only in frequency response. Modal displacements,
velocities, and accelerations in transient response.
PVMCFR Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the MCFRAC
Case Control command.
MODSELT Table of mode numbers selected by the combination of
MODESELECT Case Control command and user parameters
LMODES, LFREQ, and HFREQ.
OMCF1 Table of modal contribution factors in SORT1 format.
UNUSED Unused and may be unspecified.
APP Input-character-no default. Analysis type.
'CEIGEN' Complex eigenvalues.
Main Index
1099 MCFRAC
Compute, sort and print modal contribution fractions
Remark:
If PVMCFR is specified then the number of rows in RPH must correspond to the ones and their positions
in PVMCFR.
'FREQRESP' Frequency response.
'TRANRESP' Frequency response.
FMODE Input-integer-default=0. The lowest structure mode number resulting from user
parameter input of LMODES, LFREQ, and HFREQ and also
MODESELECT(STRUCTURE) Case Control input.
Main Index
MDATA
Computes pressures for selected elements associated with virtual fluid mass
1100
Computes pressures for selected elements associated with virtual fluid mass.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Method:
1. Calculate the accelerations. This depends on the approach.
MDATA
Computes pressures for selected elements associated with
virtual fluid mass
MDATA CASECC,XYCDB,MAR,MEA,UAX,OL/
OEP/
APP/S,N,NOSORT2/FREQINDX $
CASECC Table of Case Control command images for the primary model.
XYCDB Table of x-y plotting commands.
MAR Table of virtual mass element areas.
MEA Matrix of element forces per unit motion of the a-set.
UA Displacement or eigenvector matrix in the a-set.
OEP Table of element pressures due to virtual mass in SORT1 or SORT2
format.
APP Input-character-no default. Type of analysis. Allowable values are:
'REIG' Normal modes.
'CEIG' Complex eigenvalues.
'FREQ' Frequency response.
'TRAN' Transient response.
NOSORT2 Input-integer-default=-1. Set to 1 if SORT2 format is requested.
FREQINDX Input-integer-default=0. Frequency or time step index. Selects frequency
associated with UA.
Main Index
1101 MDATA
Computes pressures for selected elements associated with virtual fluid mass
2. Compute the element forces:
3. Output selected pressures. Output may be printed (via OFP) or plotted (via XYPLOT). The
CASECC and XYCDB data blocks are scanned for all MPRES output requests. The set selection
method is the same as used in Module SDR2. The MEA data block has two work pairs (element
identification number and area) corresponding to each row of the element force vector. For each
selected element, output the pressure (force divided by area) to the OFP data block. All flags must
be set (e.g., print, punch, plot, real, phase, etc.), depending upon the MPRES request.
Remarks:
1. XYCDB nay be purged.
2. MDATA is only available for normal modes, complex modes, frequency response, and transient
response using direct methods only.
APP
Type of
Arithmetic
REIG Real
CEIG Complex
FREQ Complex
TRAN Real
u
a
U
a
e
2
u
a
e
2
from LAMA ( ) =
U
a
p
2
u
d
from CLAMA ( ) =
U
a
e
2
u
d
e from FOL ( ) =
U
a
the 3rd, 6th, 9th, etc., columns of UDVT ( ) =
f
e
M
ea
U
a
=
Main Index
MDCASE
Partitions the Case Control table
1102
Partitions the Case Control table into separate Case Control tables based on the ANALYSIS Case Control
command.
Format:
Input Data Blocks:
Output Data Blocks:
MDCASE
Partitions the Case Control table
MDCASE /
CASESTAT,CASEMODE,CASEBUCK,CASEFREQ,CASECEIG,
CASEMTRN,CASESAER,CASEDVRG,CASEFLUT,CASESMST,
CASESMEM,CASEHEAT,CASEUPSE,CASESADV,CASESNMB,
CASEXX/
S,N,STATCC/S,N,MODECC/S,N,BUCKCC/S,N,DFRQCC/
S,N,MFRQCC/S,N,DCEIGCC/S,N,MCEIGCC/S,N,MTRNCC/
S,N,SAERCC/S,N,DVRGCC/S,N,FLUTCC/S,N,SMSTCC/
S,N,SMEMCC/S,N,HEATCC/S,N,UPSECC/S,N,DESOBJ/
S,N,DESGLB/S,N,OBJSID/SEPRTN /S,N,WVFLG $
CASECC Table of Case Control command images.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization.
CASEXN CASECC created from one of the outputs in a prior call to MDCASE.
CASESTAT Case Control table for static analysis and based on
ANALYSIS=STATICS.
CASEMODE Case Control table for normal modes analysis and based on
ANALYSIS=MODES.
CASEBUCK Case Control table for buckling analysis and based on
ANALYSIS=BUCK.
CASEFREQ Case Control table for modal or direct frequency response analysis and
based on ANALYSIS=MFREQ or DFREQ.
CASECEIG Case Control table for modal or direct complex eigenvalue analysis
and based on ANALYSIS=MCEIG or DCEIG.
CASEMTRN Case Control table for modal transient analysis and based on
ANALYSIS=MTRAN.
CASECC
CASEXN
)
`
EDOM
)
`
CASECC
)
`
, ,
Main Index
1103 MDCASE
Partitions the Case Control table
Parameters:
CASESAER Case Control table for aerostatic analysis and based on
ANALYSIS=SAERO.
CASEDVRG Case Control table for aerostatic divergence analysis and based on
ANALYSIS=DIVERG.
CASEFLUT Case Control table for flutter and based on ANALYSIS=FLUTTER.
CASESMST Case Control table for structural analysis and based on
ANALYSIS=STRU.
CASESMEM Case Control table for electromagnetic analysis and based on
ANALYSIS=ELEC.
CASEHEAT Case Control table for heat transfer analysis and based on
ANALYSIS=HEAT.
CASEUPSE Case Control table for upstream superelements only.
CASESADV Combined Case Control table which includes CASESAER or
CASEDVRG.
CASESNMB Combined Case Control table which includes CASESTAT,
CASEMODE, CASEBUCK, CASESAER, CASEDVRG, and
CASEFLUT.
CASEXX Case Control table intended for Phase 1 matrix generation, assembly
and reduction.
STATCC Output-logical-default=FALSE. Static analysis subcase flag. Set to
TRUE if at least one ANALYSIS=STATICS command was found in
CASECC and CASESTAT is specified in the output list.
MODECC Output-logical-default=FALSE. Normal modes analysis subcase flag.
Set to TRUE if at least one ANALYSIS=MODES command was found
in CASECC and CASEMODE is specified in the output list.
BUCKCC Output-logical-default=FALSE. Buckling analysis subcase flag. Set to
TRUE if at least one ANALYSIS=BUCK command was found in
CASECC and CASEBUCK is specified in the output list.
DFRQCC Output-logical-default=FALSE. Direct frequency response analysis
subcase flag. Set to TRUE if at least one ANALYSIS=DFREQ
command was found in CASECC and CASEFREQ is specified in the
output list.
MFRQCC Output-logical-default=FALSE. Modal frequency response analysis
subcase flag. Set to TRUE if at least one ANALYSIS=MFREQ
command was found in CASECC and CASEFREQ is specified in the
output list.
Main Index
MDCASE
Partitions the Case Control table
1104
DCEIGCC Output-logical-default=FALSE. Direct complex eigenvalue analysis
subcase flag. Set to TRUE if at least one ANALYSIS=DCEIG
command was found in CASECC and CASECEIG is specified in the
output list.
MCEIGCC Output-logical-default=FALSE. Modal complex eigenvalue analysis
subcase flag. Set to TRUE if at least one ANALYSIS=MCEIG
command was found in CASECC and CASECEIG is specified in the
output list.
MTRNCC Output-logical-default=FALSE. Modal transient response analysis
subcase flag. Set to TRUE if at least one ANALYSIS=MTRAN
command was found in CASECC and CASEMTRN is specified in the
output list.
SAERCC Output-logical-default=FALSE. Aerostatic analysis subcase flag. Set
to TRUE if at least one ANALYSIS=SAERO command was found in
CASECC and CASESAER is specified in the output list.
DVRGCC Output-logical-default=FALSE. Aerostatic divergence analysis
subcase flag. Set to TRUE if at least one ANALYSIS=DIVERG
command was found in CASECC and CASEDVRG is specified in the
output list.
FLUTCC Output-logical-default=FALSE. Flutter analysis subcase flag. Set to
TRUE if at least one ANALYSIS=FLUTTER command was found in
CASECC and CASEFLUT is specified in the output list.
SMSTCC Output-logical-default=FALSE. Structural analysis subcase flag. Set
to TRUE if at least one ANALYSIS=STRUCT command was found in
CASECC and CASESMST is specified in the output list.
SMEMCC Output-logical-default=FALSE. Electromagnetic analysis subcase
flag. Set to TRUE if at least one ANALYSIS=ELECT command was
found in CASECC and CASESAER is specified in the output list.
HEATCC Output-logical-default=FALSE. Heat transfer analysis subcase flag.
Set to TRUE if at least one ANALYSIS=HEAT command was found
in CASECC and CASEHEAT is specified in the output list.
UPSECC Output-logical-default=FALSE. Superelement analysis subcase flag.
Set to TRUE if SUPER=ALL or SUPER>0 in CASECC. and
CASEUPSE is specified in the output list.
DESOBJ Output-integer-default=0. DESOBJ Case Control command set
identification number.
DESGLB Output-integer-default=0. DESGLB Case Control command set
identification number.
OBJSID Output-integer-default=-1. Superelement identification number
associated with DESOBJ. Set to -1 for all cases unless the user
specifies the DESOBJ command in a particular superelement subcase.
Main Index
1105 MDCASE
Partitions the Case Control table
Remarks:
1. Any output data block may be purged.
2. EDOM may be purged it WVFLG is not required.
3. CASEXX is a copy of one of the following in the order that they appear and if they exist:
CASESTAT
CASESAER
CASEDVRG
CASEMODE
CASEFREQ
CASEMTRN
CASEFLUT
SEPRTN Input-logical-default=FALSE. SUPER command processing flag. Set
to TRUE to ignore SUPER command.
WVFLG Output-integer-default=0. Weight/volume response flag. If CASECC
does not contain any subcases for statics, normal modes, or buckling
subcase then set to 1 if there is a weight or volume response specified
on the DRESP1 Bulk Data entry image in EDOM.
Main Index
MDENZO
MDACMS matrix utility
1106
Matrix utility for matrix domain automatic component mode synthesis (MDACMS).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Option MDOPT=0:
Partition KXX (or MXX or BXX) into o-set and t-set based on MDMAP and SEID. GOTMAP is an
optional output.
Format:
Option MDOPT=1:
Extracts the o-set partition of a load matrix based on MDMAP and SEID.
MDENZO
MDACMS matrix utility
MDENZO I1,I2,I3,I4,I5,I6/
O1,O2,O3/
MDOPT/IP1/IP2/SETNAM/RP1/RP2 $
Ii Input tables or matrices. The number and type of inputs required
depends on MDOPT.
Oi Output tables or matrices. The number and type of outputs required
depends on MDOPT.
MDOPT Input-integer-default=0. Option selection number as described below.
IP1 Input-integer-default=0. Parametric data depending on MDOPT.
IP2 Input-integer-default=0. Parametric data depending on MDOPT.
SETNAM Input-character-default='XXXXXXXX'. Degree-of-freedom set name.
RP1 Input-real-default=0.0. Parametric data depending on MDOPT.
RP2 Input-real-default=0.0. Parametric data depending on MDOPT.
MDENZO KXX,MDMAP,,,/KOO,KOT,GOTMAP/0/SEID $
Main Index
1107 MDENZO
MDACMS matrix utility
Format:
Option MDOPT=2:
Partition PHQ by rows into a family of PHQI qualified by MDSEID.
GOQ is used to get the size of q-set for each domain.
ORDER is used to determine the order of the domain's q-sets in PHQ
Format:
Option MDOPT=3:
Find UT (and PVEC) for SEID as SEID goes back "up the tree"
Extract UT from family UO.
Format:
P2 on input is undefined for serial execution. For DMP, P2 on input is GSEID, the "global" SEID
associatd with the current domain.
On output, P2 is YESNO.
If possible (YESNO=+1), multiply-add GOT*UT+GOQUQ, else set YESNO=-1.
If yes, the answer is placed in UOI.
MDSPARSE is used to partition down UOI (if made) to the DOFs needed for option 4.
Option MDOPT=4:
Reorder the family into the correct/original ordering. Use the gather/re-order vector in MDMAP.
Format:
MDENZO PX,MDMAP,,,/PO,,/1/SEID $
MDENZO PHQ,GOQ,ORDER,,/PHQI,,/2/NDOM $
MDENZO GOTMAP,MDMAP,GOT,UO,GOQUQ,MDSPARSE/
UT,PVEC,UOI/3/SEID/P2 $
MDENZO UOF,MDMAP,,,/PHI,,/4// $
Main Index
MDENZO
MDACMS matrix utility
1108
Option MDOPT=5:
Take the partition vector RECVEC and determine which SEIDs you need to recover and write to
RECMAP.
Format:
Option MDOPT=6:
Decide whether SEID is in RECMAP or not. If yes, OUTYN = 1 else OUTYN = .
Format:
Option MDOPT=7:
Perform matrix reduction: XTT1 = GTO*XOO*GOT
Format:
If there is sufficient memory to do multiply in-core then produce XOOGOT, XTT1 and set OUTYN to
+1.
If not possible, set OUTYN to -1 $
Both input matrices must be real and XOO must be symmetric.
This is for tip only.
Option MDOPT=8:
Perform matrix multiplications: XTTA = GTO*XOT and XTTB = XTO*GOT.
Format:
Both XOT and GOT must be real.
Set OUTYN to +1. Else set it to -1.
MDENZO RECVEC,MDMAP,,,/RECMAP,,/5// $
MDENZO RECMAP,,,,/,,/6/SEID/OUTYN/ $
MDENZO XOO,GOT,,,/XOOGOT,XTT1,/7/OUTYN/ $
MDENZO XOT,GOT,,,/XTTA,XTTB,/8/OUTYN $
Main Index
1109 MDENZO
MDACMS matrix utility
Option MDOPT=9:
Takes 4 matrices that are involved in the reduction and produces the 2 output matrices that are needed
from subDMAP MDREDMB.
Format:
OUTYN set to +1 if successful (sufficient memory).
OUTYN set to -1 if not successful (then use rest of DMAP).
This computation optimized for collectors.
Option MDOPT=10:
Take a complex load and break it into real and imaginary parts and place those side by side as real
columns in PGRI.
Format:
VEC1 is a partition vector identifying null columns of PGRI with 0.0.
VEC2 is a partition vector of the form 1 0 1 0 1 0 to idenify real and imaginary parts.
Option MDOPT=11:
Find the best GE in K4FF so that its removal will result in a sparser K4NEW = K4FF - GEBAR*KFF
Format:
GEBAR is output as an integer so that .001*GEBAR is the actual GEBAR.
RP1, RP2 are parameters to control what gets kept/thrown out.
RP1 is the ratio of new to original K4 value.
RP2 is the absolute value of the new K4 term.
Option MDOPT= 12:
Same as MDOPT=1 except PF can made into a family of PO's the family is made even if PF does not fit
in memory.
MDENZO XOO,GOT,XOT,XTTBAR,/XOOGOT,XTT,/9/OUTYN $
MDENZO PG,,,,/PGRI,VEC1,VEC2/10 $
MDENZO KFF,K4FF,,,/K4NEW,,/11/S,N,GEBAR///RP1/RP2 $
Main Index
MDENZO
MDACMS matrix utility
1110
Format:
Option MDOPT= 13 (or -13):
Take the lower triangle of KFF and mirror it so that the upper and lower triangles of KFFSYM are exact.
If -13, remove packed 0s.
Format:
Option MDOPT= 14
Make sure DOFs of the same grid stay together when compressed in PRESOL add mbkxx1 to its
transpose and send into PRESOL.
Format:
MDENZO PF,MDMAP,,,/PFAM,,/12 $
MDENZO KFF,,,,,/KFFSYM,,/13 $
MDENZO MBKXX,BGPDT,USET,VGFS,,/MBKXX1,,/14 $
Main Index
1111 MDISUTIL
Broadcasts multiple data blocks between slave and master processors
Broadcasts multiple data blocks between slave and master processors.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
MDISUTIL calls option 10 of the DISUTIL module.
MDISUTIL
Broadcasts multiple data blocks between slave and master
processors
MDISUTIL DB1,DB2,DB3,DB4,DB5,DB6,DB7,DB8,DB9,
DB10,DB11,DB12,DB13,DB14,DB15/
DBOUT1,DBOUT2,DBOUT3,DBOUT4,DBOUT5,DBOUT6,DBOU
T7,
DBOUT8,DBOUT9,DBOUT10,DBOUT11,DBOUT12,DBOUT13,
DBOUT14,DBOUT15/
SENDID/NUMDB/RECVCODE $
DBi Any data block to be broadcast from the master to the slave processors.
DBOUTi DBi received on the slave processor.
SENDID Input-integer-default=1. Sending processor identification number. Allowable values
are 1 to the number of processors.
NUMDB Input-integer-no default. Number of data blocks to broadcast.
RECVCODE Input-integer-default=1. Receiving processor identification code.
= 0 All non-sending processors are receivers.
< 0 Absolute value is the processor identification number of a single receiver.
> 0 Bit pattern of receiving processors. The bit position from right to left
corresponds to the processor identification number.
Main Index
MERGE
Matrix merge
1112
Forms a matrix from its partitions.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. MERGE is the inverse of PARTN in the sense that if [A11], [A12], [A21], [A22] were produced
by PARTN using {RP}, {CP}, FORM, SYM and TYPE from [A], MERGE will produce [A]. The
operation of MERGE is dependent upon the partitioning vectors, {CP} and {RP}, and the
symmetry flag, SYM.
MERGE
Matrix merge
MERGE A11,A21,A12,A22,CP,RP/A/SYM/TYPE/FORM $
Aij Matrix partitions. (Real or complex).
CP Column partitioning vector.
RP Row partitioning vector.
A Merged matrix from Aij.
SYM Input-integer-default=-1. SYM < 0, {CP} is used for {RP}.
, {CP} and {RP} are distinct.
TYPE Input-integer-default=0. Type of [A]. If TYPE is 0, the type of the
output matrix will be the maximum type of [A11], [A21], [A12], and
[A22].
FORM Input-integer-default=0. Form of [A]. (See Remark 3.)
SYM 0 >
A | |
A11 A12
A21 A22
Main Index
1113 MERGE
Matrix merge
Let be an m by n matrix, be an nx1 vector containing q zero elements; and be a
mx1 vector containing p zero elements. Partition will consist of all elements of for
which in the same order as they appear in . Partition will consist of
all elements of for which and in the same order as they appear in
. Partition will consist of all elements of for which and
in the same order as they appear in . The following describes the operations:
Let NC = number of nonzero terms in .
NR = number of nonzero terms in .
NROWA = number of rows in .
NCOLA = number of columns in .
Case 1: {CP} is purged and :
MERGE A11,A21,,,,RP/A/1 $
[A11] is a (NROWA-NR) by NCOLA matrix.
[A21] is a NR by NCOLA matrix.
[A12] is not written.
[A22] is not written.
Case 2: is purged and :
MERGE A11,,A12,,CP,/A/1 $
[A11] is a NROWA by (NCOLA - NC) matrix.
[A21] is not written.
[A12] is a NROWA by NC matrix.
[A22] is not written.
A | | CP { } RP { }
A11 | | A
ij
A | |
CP
j
RP
i
0.0 = = A | | A12 | |
A
ij
A | | CP
j
0.0 = RP
i
0.0 =
A | | A21 | | A
ij
A | | CP
j
0.0 = RP
i
0.0 =
A | |
CP { }
RP { }
A | |
A | |
SYM 0 >
A11
A21
A | |
RP { } SYM 0 >
A11 A12
A | |
Main Index
MERGE
Matrix merge
1114
2. [A11], [A12], [A21], and [A22] must be unique matrices.
3. When FORM = 0, a compatible matrix [A] results as shown in the following table:
4. Any or all of [A11], [A12], [A21], [A22] may be purged. When all are purged, this implies
[A] = 0.
5. Both and may not be purged.
Case 3: is purged and SYM < 0:
MERGE A11,A21,A12,A22,CP,/A $
[A11] is a (NROWA-NC) by (NCOLA-NC) matrix.
[A21] is a NC by (NCOLA -- NC) matrix.
[A12] is a (NROWA -- NR) by NC matrix.
[A22] is a NC by NC matrix.
Case 4: Neither nor are purged and :
MERGE A11,A21,A12,A22,CP,RP/A/1 $
[A11] is a (NROWA -- NR) by (NCOLA -- NC) matrix.
[A21] is a NR by (NCOLA -- NC) matrix.
[A12] is a (NROWA -- NR) by NC matrix.
[A22] is a NR by NC matrix.
Form of [A22]
Square Rectangular Symmetric
Square Square Rectangular Rectangular
Form of [A11] Rectangular Rectangular Rectangular Rectangular
Symmetric Rectangular Rectangular Symmetric
RP { }
A11 A12
A21 A22
A | |
CP { } RP { } SYM 0 >
A11 A12
A21 A22
A | |
RP { } CP { }
Main Index
1115 MERGE
Matrix merge
Examples:
1. Let A11, A12, A21, A22, {CP} and {RP} be defined as follows:
Then, the DMAP instruction
MERGE A11,A21,A12,A22,CP,RP/A/1 $
will create the real matrix:
2. If, in Example 1, the DMAP instruction was written as
MERGE A11,A12,,,CP,/A/1 $ RP,CP distinct
the input matrices would be
A11 | |
2.0
6.0
= A12 | |
1.0 3.0 4.0
5.0 7.0 8.0
=
A21 | |
10.0
= A22 | |
9.0 11.0 12.0
=
CP ( )
1.0
0.0
1.0
1.0
)
`
=
RP ( )
0.0
0.0
1.0
)
`
=
A | |
1.0 2.0 3.0 4.0
5.0 6.0 7.0 8.0
9.0 10.0 11.0 12.0
=
A11 | |
2.0
6.0
10.0
= A12 | |
1.0 3.0 4.0
5.0 7.0 8.0
9.0 11.0 12.0
=
Main Index
MERGE
Matrix merge
1116
3. If, in Example 1, the DMAP instruction was written as
MERGE A11,A21,,,,RP/A/1 $
the input matrices would be
4. If the DMAP instruction is written as
MERGE A11,A21,A12,A22,,RP/A/-1 $
and the input matrices are:
then the resulting matrix would be
A11 | |
1.0 2.0 3.0 4.0
5.0 6.0 7.0 8.0
=
A21 | |
9.0 10.0 11.0 12.0
=
A11 | |
1 2
5 6
= A12 | |
3
7
=
A21 | |
9 10
= A22 | |
11
=
A | |
1 2 3
5 6 7
9 10 11
=
Main Index
1117 MERGEOFP
Merges linear and nonlinear stress output
Merges OESL (linear element stresses from SDR2) with OESNL (nonlinear element stresses from
SDRNL).
Format:
Input Data Blocks:
Output Data Block:
Remark:
The linear and nonlinear element stress files are read concurrently. The output file is produced with the
same order of files as the input files, but where the same element name and identification number appears
on each input file, the linear element stress data block for the element will immediately precede the
nonlinear element stress data block on the output file.
MERGEOFP
Merges linear and nonlinear stress output
MERGEOFP OES1,OESNL1/OES1X $
OES1 Table of element stresses in SORT1.
OESNL1 Table of nonlinear element stresses in SORT1 format.
OES1X Table of linear and nonlinear element stresses in the SORT1 and linear
element format.
Main Index
MESSAGE
Prints messages
1118
Prints messages to the standard MSC Nastran output file.
Format:
Input Data Block:
Output Data Block:
Parameter:
Remarks:
1. Parameter inputs may be parameter names, actual values, or character strings.
2. Variable parameters must have been typed prior to this statement.
3. The number of parameters is limited only by the size of VPS.
4. The MESSAGE module normally prints to the .f06 standard MSC Nastran output file
(FORTRAN Unit 6). To have the print also appear in the Performance Summary Table
(FORTRAN Unit 4 or dayfile), DIAG 53 must be turned on by the DIAG Executive Control
Statement.
5. T1 and T2 may be purged.
6. T2 must be declared APPEND on the FILE statement if more than one MESSAGE execution is
used to write into this table.
Example:
1. Print a user information message:
MESSAGE //USER DMAP MSG/10/ERROR IN ITER. NO./COUNT $
2. Create a table of two messages and then print:
FILE TEST=APPEND $
maxint = 776705406 $
MESSAGE
Prints messages
MESSAGE T1/T2/P1/P2/.../Pn $
T1 Table created by prior executions of MESSAGE and will be printed to
the f06 file.
T2 Table to which Pi will be written instead of the f06 file.
Pi Input-default is blank. Cannot exceed 80 characters in length.
Main Index
1119 MESSAGE
Prints messages
offset = 150704034 $
message /test/' maxint ='/maxint /' offset ='/offset $
lstart = maxint - offset $
incr = offset / 39 $
message /test/' starting column ='/lstart /' incr ='/incr $
message test/ $
The following will appear in the f06 file:
^^^ MAXINT = 776705406 OFFSET = 150704034
^^^ STARTING COLUMN = 626001372 INCR = 3864206
Main Index
MGEN
Creates virtual fluid mass matrices
1120
Creates virtual fluid mass matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MGEN
Creates virtual fluid mass matrices
MGEN CASECC,MATPOOL,EST,CSTM,BGPDT/
MCHI,MLAM,GEG,MAR,MCHI2,MLAM2/
LUSET/S,N,NOMGEN/UNUSED3/WTMASS/UNUSED5 $
CASECC Table of Case Control command images.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
MCHI Matrix relating displacements to source strengths.
MLAM Matrix relating element forces to source strengths.
GEG Element displacement interpolation matrix.
MAR Table of virtual mass element areas.
MCHI2 Secondary matrix relating displacements to source strengths.
MLAM2 Secondary matrix relating element forces to source strengths.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
NOMGEN Output-integer-default=-1. Fluid mass existence flag. Set to the
MFLUID set identification number if MFLUID is specified in
CASECC.
UNUSED3 Input-real-default=0.0. Unused.
Main Index
1121 MGEN
Creates virtual fluid mass matrices
WTMASS Input-real-default=1.0. Specifies scale factor on structural mass
matrix.
UNUSED5 Input-integer-default=-1. Unused.
Main Index
MKCNTRL
Assembles a description of aerodynamic controllers sets
1122
Assembles a description of the set of aerodynamic controllers.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
None.
MKCNTRL
Assembles a description of aerodynamic controllers sets
MKCNTRL EDT,CSTMA,AEBGPDT/
AECTRL,TRX,AECSTMHG/
SYMXZ/AUNITS $
EDT Element deformation table.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
AEBGPDT Basic grid point definition table for the aerodynamic degrees-of-
freedom.
AECTRL Table of aeroelastic model controls.
TRX Boolean matrix to select accelerations from the list of aerodynamic
extra points.
AECSTMHG Table of aerodynamic coordinate system transformation matrices that
only contains the hinge moment referenced coordinates systems if not
null.
SYMXZ Input-real-no default. x-z symmetry flag.
AUNITS Input-real-no default. Used to convert accelerations expressed in
gravity units to units of length per time squared.
Main Index
1123 MKCSTMA
Merge coordinate system tables; usually tables from structural and aerodynamic models.
Merge coordinate system tables; usually tables from structural and aerodynamic models.
Format:
Input Data Block:
Output Data Block:
Parameters:
None.
MKCSTMA
Merge coordinate system tables; usually tables from
structural and aerodynamic models.
MKCSTMA CSTM1,CSTM2/CSTMM $
CSTMi Tables of coordinate system transformation matrices.
CSTMM Merged table of coordinate system transformation matrices.
Main Index
MKMNTIFP
Updates geometry, connectivity, and properties
1124
Updates geometry, connectivity, and property tables to form frames to track monitor points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MKMNTIFP
Updates geometry, connectivity, and properties
MKMNTIFP BGPDT,CSTM,MONITOR,ECT,EPT,MPT/
GEOM1X,GEOM2X,EPTX,MPTX/
YOUNGM $
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
MONITOR Structural monitor point table.
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
MPT Table of Bulk Data entry images related to material properties.
GEOM1X New GEOM1 table updated to track monitor points.
GEOM2X New GEOM2 table updated to track monitor points.
EPTX EPT updated to track monitor points.
MPTX MPT updated to track monitor points.
YOUNGM Input-real-default=0.0. Young's modulus.
Main Index
1125 MKRBVEC
Computes load summation about a given point
Builds a g-set X 6 matrix that sums forces and moments of a set of grids to a given reference point about
a given set of coordinate axes.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MKRBVEC
Computes load summation about a given point
MKRBVEC BGPDT,CSTM,AEROCOMP/
RBF/
COORID/REF1/REF2/REF3/COMPNAME/CDOM/INDDOF $
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
AEROCOMP Table of component definitions. Required only if a COMPNM is
specified.
RBF Matrix (g-set by 6) representing the geometric rigid body mode of the
points in the BGPDT about the origin of motion.
COORID Input-integer-default=0. Identification number of the coordinate system into
which VGR will be generated.
REF1 Input-real-default=0.0. Location of point in the first coordinate direction of
COORID about which moments will be computed.
REF2 Input-real-default=0.0. Location of point in the second coordinate direction of
COORID about which moments will be computed.
REF3 Input-real-default=0.0. Location of point in the third coordinate direction of
COORID about which moments will be computed.
COMPNAME Character. Name of a component defining the set of points participating in the
rigid body motion.
Main Index
MKRBVEC
Computes load summation about a given point
1126
CDOM Input-integer-default=0. Coordinate system ID of the origin of the motion.
(0=basic coordinate system).
INDDOF Integer-input-default=0. If INDDOF<>0 then CLASS=DISP path is taken using
RBE3D code with Ci=INDDOF.
Main Index
1127 MKSPLINE
Generates splines to interpolated results from structural to aero model
Generates splines to interpolated results from the structural model to the aero model.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
MKSPLINE
Generates splines to interpolated results from structural to
aero model
MKSPLINE EDT,CSTMA,AEGRID,AECOMP,ECT,AEBOX,ACOMP,SCOMP,BGPDT,
ABGPDT/SPLINE/AEROEXT $
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
AEGRID Basic grid point definition tables for the aerodynamic model.
AECOMP Aerodynamic component definition table.
ECT Element connectivity table.
AEBOX Table of aerodynamic element connectivity. Output by APD as
BGPDT with qualifier MODLTYPE='AEROMESH'.
ACOMP Aerodynamic components defined on AECOMP entries.
SCOMP Structural components defined on AECOMP entries.
BGPDT Structural Grid Points.
ABGPDT Aerodynamic Grid Points.
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with
external grid identification numbers.
AEROEXT Input, Integer, default=1.
1 = no external aerodynamics
-1 = external aerodynamics
Main Index
MKSPLINE
Generates splines to interpolated results from structural to aero model
1128
Example:
Excerpt from subDMAP PHASE0.
DBVIEW AEGRID=BGPDTS WHERE (MODLTYPE='AEROMESH' AND WILDCARD) $
MKSPLINE EDT,CSTMA,AEGRID,AECOMP/SPLINE $
Main Index
1129 MODACC
OFREQ and OTIME command processor
Removes columns in solution and load matrices based on the OTIME and OFREQ Case Control
commands.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
MODACC
OFREQ and OTIME command processor
MODACC CASECC,OL,U,P1,P2,P3/
OL1,U1,P11,P21,P31/APP/S,N,MDCEQV $
CASECC Table of Case Control command images.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list.
U Solution matrix from normal modes, complex modes, transient
response, or frequency response.
Pi Any matrix with the same number of columns as there are eigenvalues,
frequencies, or time steps in OL.
OL1 OL truncated by the OFREQ or OTIME command.
U1 U truncated by the OFREQ or OTIME command.
Pi1 Pi truncated by the OFREQ or OTIME command.
APP Character-input-default='TRAN'. Analysis type.
'REIGEN' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
MDCEQV Output-integer-default=-1. MODACC equivalence flag. If MDCEQV=-1 on
output then no output truncation occurred and a subsequent EQUIVX
statement may be used to equivalence the inputs to the outputs. Applicable
only when APP='REIG'.
Main Index
MODACC
OFREQ and OTIME command processor
1130
Remarks:
1. MODACC selects vectors based on OTIME or OFREQ commands in CASECC. If APP = 'CEIG',
the selection is based on the imaginary part of the complex eigenvalue. If APP = 'REIG', the
selection is based on the frequency .
2. Here are typical data block names and the appropriate value of APP:
3. If APP='CEIGEN', then P11 must not be purged.
4. Under APP='REIG', if there is no OMODES or OFREQ Case Control request and the number of
subcase equals the number of modes (columns in U) or the MODES Case Control command
generates a number of subcases equal to the number of modes then OL1 and U1 will not be created
and MODACC must be followed subsequent EQUIVX statement;
LAMA APP = 'REIG'
CLAMA APP = 'CEIG'
FOL APP = 'FREQ'
TOL APP = 'TRAN'
MODACC CASEM,LAMA,PHA,,,/
LAMA2,PHA1,,,/APP/S,N,MDCEQV $
EQUIVX LAMA/LAMA2/MDCEQV $
EQUIVX PHA/PHA1/MDCEQV $
f e 2t =
Main Index
1131 MODCASE
Processes POST command for f06 redirection
Process Case Control records for output data recovery and redirect output to user-specified Fortran files
instead of the f06.
Format for POSTCFLG=1:
Format for POSTCFLG=2:
Input Data Blocks:
Output Data Blocks:
Parameters:
MODCASE
Processes POST command for f06 redirection
MODCASE CASECC,/POSTCC/1//S,N,NUNIQF06 $
MODCASE CASECC,POSTCC0/CASECCP/
2/F6CNTR//S,N,F6UNIT/S,N,F6SUFFIX $
CASECC Table of Case Control command images.
POSTCC0 POSTCC computed from previous execution of MODCASE
(POSTCFLG=1).
POSTCC Table containing POST command selections CASECCP CASECC
subsetted for current selection of Fortran unit.
POSTCFLG Input-integer-default=0. POSTCC processing flag.
1 Generate POSTCC.
2 POSTCC is specifed as an input.
NUNIQF6 Output-integer-default=0., Number of unique Fortran units requested on POST
command.
F6CNTR Input-integer-default=0. Fortran unit loop counter.
F6UNIT Output-integer-default=0. Current Fortran unit number.
F6SUFFIX Output-character-default=' '. Suffix name assigned to Fortran unit physical names.
Main Index
MODENRGY
Computes modal energies
1132
Computes modal strain and kinetic energies in frequency and transient response analysis.
Format:
Input Data Blocks:
Output Data Blocks:
MODENRG
Y
Computes modal energies
MODENRGY CASECC,OL,UH,KHH,MHH,MODSELT/
TSNRGY,TKNRGY,MODSELT1,OL1,MSNRGY,MKNRGY/
APP/FMODE/UNUSED $
CASECC Table of Case Control command images.
UH Solution matrix for the h-set (modal degrees-offreedom). Modal
displacements only in frequency response. Modal displacements,
velocities, and accelerations in transient response.
OL Complex eigenvalue summary table, transient response time output list
or frequency response frequency output list. Must be consistent with
APP.
KHH Generalized (modal) stiffness matrix.
MHH Generalized (modal) mass matrix.
MODSELT Table of mode numbers selected by the combination of
MODESELECT Case Control command and user parameters
LMODES, LFREQ, and HFREQ.
TSNRGY Table of modal strain energy.
TKNRGY Table of modal kinetic energy.
MODSELT1 Subset of MODSELT as selected by the MODALSE and MODALKE
Case Control commands.
OL1 Subset of OL selected by the the MODALSE and MODALKE Case
Control commands.
MSNRGY Matrix of modal strain energy.
MKNRGY Matrix of modal kinetic energy.
Main Index
1133 MODENRGY
Computes modal energies
Parameters:
APP Input-character-no default. Analysis type.
'FREQRESP' Frequency response.
'TRANRESP' Frequency response.
FMODEv Input-integer-default=1. The lowest structure mode number resulting from user
parameter input of LMODES, LFREQ, and HFREQ and also
MODESELECT(STRUCTURE) Case Control input.
UNUSED Input-integer-default=0. Unused and may be unspecified.
Main Index
MODEPF
Computes fluid-structure mode participation factors
1134
Computes mode participation factors for fluid-structure models in frequency response analysis.
Format:
Input Data Blocks:
MODEPF
Computes fluid-structure mode participation factors
MODEPF BGPDT,USET,CASECC,EDT,ABESF*,
PHASH2,UHFS,PHDFH,MFHH,BFHH,
KFHH,FOL,ABEH*,PHDFH1,PHDFH2,
UHFF,AH,PFHF,UNUSED,PNLLST,
VGA/
GPMPF,FMPF,SMPF,PMPF,LMPF,
MPFMAP/
NOFREQ/NOLOADF/GRIDFMP/NUMPAN/PNQALNAM/
SYMFLG/MPNFLG/FLUIDMP/STRUCTMP/PANELMP/
GRIDMP/NOSASET/FILTERF/FILTERS $
BGPDT Basic grid point definition table.
USET Degree-of-freedom set membership table for g-set.
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images containing SET1 entries.
ABESF* Family of a-set size panel area matrices.
PHASH2 Structural partition (row-wise) of eigenvector matrix PHDH. Also
partitioned column-wise according to parameter STRUCTMP.
UHFS Structural partition (row-wise) of solution matrix UHF. Also
partitioned column-wise according to parameter STRUCTMP.
PHDFH Fluid partition (row-wise) of eigenvector matrix PHDH.
MFHH Fluid partition of modal mass matrix MHH.
BFHH Fluid partition of modal damping matrix BHH.
KFHH Fluid partition of modal stiffness matrix KHH.
FOL Table of forcing frequencies.
ABEH* Family of signed modally reduced area matrices
PHDFH1 Fluid partition (row-wise) of eigenvector matrix PHDH reduced to
a-set size.
PHDFH2 PHDFH1 partitioned by parameter FLUIDMP.
UHFF Fluid partition (row-wise) of solution matrix UHF. Also partitioned
column-wise according to parameter FLUIDMP.
Main Index
1135 MODEPF
Computes fluid-structure mode participation factors
Output Data Blocks:
Parameters:
AH Signed global modally reduced area matrix.
PFHF Fluid partition of frequency response modally reduced load matrix.
UNUSED Unused.
PNLLST Table of triplets defining panel names and their associated IPANEL
qualifier values.
VGA G-set size partitioning vector with values of 1.0 at the rows
corresponding to the a-set.
GPMPF Matrix of grid panel mode participation factors.
FMPF Matrix of fluid mode participation factors.
SMPF Matrix of contribution of structure to fluid mode participation factor.s
PMPF Matrix of contribution of structural panels to fluid mode participation
factors.
LMPF Matrix of fluid force to fluid mode participation factors.
MPFMAP Table describing content of mode participation factor matrices.
NOFREQ Input-integer-no default. Number of excitation frequencies.
NOLOADF Input-integer-no default. Number of load cases per frequency.
GRIDFMP Input-integer-no default. Case Control set identification number of fluid grids
that will be output:
<
0
Print matrices; if -999, print matrices for -1 (set = all).
-
1
All fluid grid a-set.
0
No fluid grid a-set.
>
0
Case Control set that contains grid list to be output.
NUMPAN Input-integer-no default. Number of panels.
PNQALNAM Input-character-default=' '. Name of qualifier for panels.
SYMFLG Input-complex-default=(1.,0.). Scale factor.
Main Index
MODEPF
Computes fluid-structure mode participation factors
1136
Remarks:
1. VGA may be purged if no diagnostic printouts are desired.
2. If STRUCTMP>0 then these are the output options:
Compute structural mode participation factors.
If MPNFLG>0 and PANELMP>-1 then compute panel mode participation factors, PMPF.
Compute load mode participation factors, LMPF.
If MPNFLG>0 and GRIDMP>-1 then compute fluid grid mode participation factors, GMPF.
MPNFLG Input-integer-no default. Panel existence flag.
FLUIDMP Input-integer-default=-1. Number of fluid modes to use in computing factors. If
FLUIDMP>0 then compute factors for the first FLUIDMP modes.
STRUCTMP Input-integer-default=-1. Number of structure modes to use computing factors.
PANELMP Input-integer-default=-1. Flag to compute panel participation factors. See
Remark 2.
GRIDMP Input-integer-default=-1. Case Control set identification number for a set of
fluid grids.
NOSASET Input-integer-default=-1. Number of degrees-of-freedom in the a-set of the
structure.
FILTERF Input-real-default=0.95. Filter for fluid factor matrices.
FILTERS Input-real-default=0.95. Filter for structure factor matrices.
Main Index
1137 MODEPOUT
Filter, sort, and printout mode participation factor matrice
Filter, sort, and printout mode participation factor matrices. Also create table data blocks suitable for XY
plots and power spectral density calculations.
Format:
Input Data Blocks:
MODEPOUT
Filter, sort, and printout mode participation factor matrice
MODEPOUT LAMAF,LAMAS,CASECC,FMPF,SMPF,
PMPF,LMPF,GMPF,MPFMAP,
MODSELTS,MODSELTF/
OFMPF2E,OFMPF2M,OSMPF2E,OSMPF2M,OPMPF2E,
OPMPF2M,OLMPF2E,OLMPF2M,OGMPF2E,OGMPF2M,
UNUSED1,UNUSED2,UNUSED3,UNUSED4,UNUSED5/
OUTFMP/OUTSMP/FMPFEPS/SMPFEPS/MPFSORT/
NOMPF2E/FMODE/FMODEF $
LAMAF Normal modes eigenvalue summary table for the fluid portion of the
model.
LAMAS Normal modes eigenvalue summary table for the structural portion of
the model.
CASECC Table of Case Control command images.
FMPF Matrix of fluid mode participation factors.
SMPF Matrix of contribution of structure to fluid mode participation factors.
PMPF Matrix of contribution of structural panels to fluid mode participation
factors
LMPF Matrix of fluid force to fluid mode participation factors.
GPMPF Matrix of grid panel mode participation factors.
MPFMAP Table describing content of mode participation factor matrices.
MODSELTS Table of mode numbers selected by the combination of the
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ.
MODSELTF Table of mode numbers selected by the combination of the
MODESELECT(FLUID) Case Control command and user parameters
LMODESFL, LFREQFL, and HFREQFL.
Main Index
MODEPOUT
Filter, sort, and printout mode participation factor matrice
1138
Output Data Blocks:
Parameters:
OFMPF2E Table of fluid mode participation factors by excitation frequencies.
OFMPF2M Table of fluid mode participation factors by normal mode.
OSMPF2E Table of structure mode participation factors by excitation frequencies.
OSMPF2M Table of structure mode participation factors by normal mode.
OPMPF2E Table of panel mode participation factors by excitation frequencies.
OPMPF2M Table of panel mode participation factors by normal mode.
OLMPF2E Table of load mode participation factors by excitation frequencies.
OLMPF2M Table of load mode participation factors by normal mode.
OGMPF2E Table of grid mode participation factors by excitation frequencies.
OGMPF2M Table of grid mode participation factors by normal mode.
UNUSEDi Unused.
OUTFMP Input-integer-default=0. Number of fluid modes to output.
OUTSMP Input-integer-default=0. Number of structure modes to output.
FMPFEPS Input-real-default=0.0. Threshold for filtering out small fluid factor magnitudes.
SMPFEPS Input-real-default=0.0. Threshold for filtering out small structure factor magnitudes.
MPFSORT Input-integer-default=11. Sort flag.
10 Sort on absolute value (magnitude).
20 Sort on real portion.
30 Sort on complex portion.
40 Sort on phase angle (must convert).
1 Descending sort.
2 Ascending sort.
NOMPF2E Input-integer-default=-1.
0 Generate.
-1 Do not generate.
FMODE Input-integer-no default. The lowest structure mode number resulting from user
parameter input of LMODES, LFREQ, and HFREQ and also
MODESELECT(STRUCTURE) Case Control input.
FMODEF Input-integer-no default. The lowest fluid mode number resulting from user
parameter input of LMODESFL, LFREQFL, and HFREQFL and also
MODESELECT(FLUID) Case Control input.
Main Index
1139 MODEPOUT
Filter, sort, and printout mode participation factor matrice
Remarks:
1. The O*MPF2E data blocks are suitable for input to the XYTRAN module.
2. The O*MPF2M data blocks are suitable for input to the RANDOM module.
Main Index
MODEPT
Updates PACABS and PACABR Bulk Data entry records
1140
Updates PACABS and PACABR Bulk Data entry records based upon data on TABLEDi Bulk Data entry
records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. MODEPT does not terminate the run if an error is detected in the Bulk Data entries. NOGOMEPT
should be checked before proceeding to the GP1 module.
2. MODEPT must appear after the IFP.
Example:
See the example in the IFP module description.
MODEPT
Updates PACABS and PACABR Bulk Data entry records
MODEPT EPT,DIT/EPTX/S,N,NOGOMEPT $
EPT Table of Bulk Data entry images related to element properties; in
particular, PACABS and PACABR entries.
DIT Table of TABLEij Bulk Data entry images.
EPTX Copy of EPT except PACABS and PACABR entries are updated with
TABLEij references.
NOGOMEPT Logical-output-default=FALSE. Set to TRUE if an error is detected in
the Bulk Data entries.
Main Index
1141 MODGDN
Updates geometry table for existence of p-elements and superelements
Updates the geometry table for the existence of p-elements and superelements.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
MODGDN
Updates geometry table for existence of p-elements and
superelements
MODGDNv GEOM1,SEMAP,MFACE,MEDGE,MBODY/
GEOM1P/
S,N,NOSEMAP $
GEOM1 Table of Bulk Data entry images related to geometry.
SEMAP Superelement map table.
MFACE Face table for p-element analysis.
MEDGE Edge table for p-element analysis.
MBODY Body table for p-element analysis.
GEOM1P Table of Bulk Data entry images related to geometry updated for
p-elements and superelements.
NOEMAP Output-integer-default=0. Superelement map table flag. Set to -1 if
SEMAP does not exist.
Main Index
MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
1142
Creates internal records in the element connectivity table based on the presence of PLPLANE and
PLSOLID Bulk Data entry records. Internal records are also created from fluid elements defined on the
PSOLID Bulk Data entry.
Format:
Input Data Blocks:
Output Data Block:
MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
MODGM2 EPT,GEOM2,GEOM1,GEOM4,BGPDT,CSTM,MPT/
GEOM2X,GEOM1X,GEOM2DCW,EPTX,MPTX/
S,N,ACFLAG/OSWPPT/OSWELM/S,N,NSWPPT/
S,N,NSWELM/S,N,SWEXIST/S,N,NOGOMGM2/
S,N,RGDEXIST/RIGID/ORIGID/S,N,NLRIGID/
LMFACT/PENFN/NONLNR/CWRANDEL/CWDIAGP/
CFRANDEL/CFDIAGP/S,N,NOEPT/S,N,NOMPT/SOFFSET/
CSRANDEL/CSDIAGP $
EPT Table containing element properties Bulk Data entry records.
GEOM2 Table containing element connectivity Bulk Data entry records.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
GEOM2X GEOM2 table related to axisymetric conical shell, hydroelastic,
acoustic cavity, and spot weld element analysis.
GEOM1X GEOM1 table related to axisymmetric conical shell, hydroelastic,
acoustic cavity, and spot weld element analysis.
GEOM2DCW GEOM2 table containing the deleted CWELD elements.
EPTX Copy of EPT updated for converted CSHEAR elements.
MPTX Copy of MPT updated for converted CSHEAR elements.
Main Index
1143 MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
Parameter:
ACFLAG Integer-output-default=0. ACFLAG>0 indicates fluid elements:
0 No fluid elements.
1 Fluid elements.
2 Fluid/structure coupling.
OSWPPT Input-integer-default=0. Offset for spot weld projection point identification
numbers.
OSWELM Input-integer-default=0. Offset for spot weld element identification
numbers.
NSWPPT Output-integer-default=0. Current spot weld projection point identification
number.
NSWELM Output-integer-default=0. Current spot weld element identification number.
SWEXIST Output-logical-no default. Spot weld element existence flag. Set to TRUE
if spot weld elements exist.
NOGOMGM2 Output-logical-no default. MODGM2 module error return flag. Set to
TRUE if an error is found.
RGDEXIST Output-logical-default=FALSE. Flag, if TRUE, indicates there are rigid
elements that need further processing in MODGM4.
RIGID Input-character-default= . Sub-method type for the combined Lagrange
and elimination method, LAGR, LGEL, or LNEI. Usually input by
user parameter.
ORIGID Input-integer-default=0. Offset for rigid element Lagrange multiplier
identification numbers. Usually input by user parameter.
NLRIGID Output-integer-default=0. Nonlinear rigid element flag. Overrides system
cell 377.
< 0 No nonlinear rigid element exists and use linear elimination.
= 0 Nonlinear rigid elements exist and the Lagrange multiplier method is
used to obtain the solution.
> 0 Nonlinear rigid elements exist and the eliminaton method is used to
obtain the solution.
LMFACT Input-real-default=0.0. Lagrange multiplier scale factor Usually input by
user parameter and overrides system cell 374.
PENFN Input-real-default=0.0. Lagrange multiplier penalty function. Usually input
by user parameter and overrides system cell 375.
NONLNR Input-logical-default=FALSE. Nonlinear solution sequence flag. Set to
TRUE if nonlinear solution sequence is being executed.
Main Index
MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
1144
Remarks:
1. MODGM2 must appear after the IFP.
2. The following GEOM2 Bulk Data entry records are replaced by the internal records in GEOM2X:
CWRANDEL Input-real-default=0.0. Rate (percentage) at which CWELD elements are
removed from the model. Usually input by user parameter.
CWDIAGP Input-character-default= . Flag, if YES, to write diagonistics of CWELD
element deletion. Usually input by user parameter.
CFRANDEL Input-real-default=0.0. Rate (percentage) at which CFAST elements are
removed from the model. Usually input by user parameter.
CFDIAGP Input-character-default=' '. Flag, if YES, to write diagonstics of CFAST
element deletion. Usually input by user parameter.
NOEPT Output-integer-default=-1. EPTX generation flag.
0 Generated
-1 Not generated
NOMPT Output-integer-default=-1. MPTX generation flag.
0 Generated
-1 Not generated
SOFFSET Input-real-default=100. Stiffness ratio for equivalent CBEAM generated
for the offsets.
CSRANDEL Input-real-default=0.0. Rate (percentage) at which CWSEAM elements are
removed from the model. Usually input by user parameter.
CSDIAGP Input-character-default=' '. Flag, if YES, to write diagnostics of CWSEAM
element deletion. Usually input by user parameter
GEOM2
Record
GEOM2X Record
Fluid Hyperelastic
CQUAD4 n/a QUAD4FD
CQUAD8 n/a QUAD8FD
CTRIA3 n/a TRIA3FD
CTRIA6 n/a TRIA3FD
CQUAD n/a QUADFD
CTRIAX n/a TRIAXFD
CQUADX n/a QUADXFD
CHEXA HEXPR HEXAFD
Main Index
1145 MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
Example:
See the example in the IFP module description.
CPENTA PENPR PENTAFD
CTETRA TETPR TETRAFD
GEOM2
Record
GEOM2X Record
Fluid Hyperelastic
Main Index
MODGM4
Reads SPCs and SPCDs and generates unique SPC and SPCD records
1146
Reads the SPCs and SPCDs that were defined by GMBC, GMSPC, SPC, SPC1, or SPCD Bulk Data
entries and generates the unique SPC and SPCD records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MODGM4
Reads SPCs and SPCDs and generates unique SPC and
SPCD records
MODGM4 CASECC,GEOM2M,GEOM4M,DEQATN,DEQIND,DIT,BGPDTM,
EPT/
GEOM4P/
GNSTART/S,N,MODGM4/ALTSHAPE/S,N,NSWELM/SWEXIST
/
RGDEXIST $
CASECC Table of Case Control command images.
GEOM2M Table of Bulk Data entry images related to element connectivity and
scalar points and updated for the current p-level.
GEOM4M Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity and updated for
the current p-level.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DIT Table of TABLEij Bulk Data entry images.
BGPDTM Basic grid point definition table and updated for the current p-level.
EPT Table containing element properties Bulk Data entry records.
GEOM4P Table of Bulk Data entry images related to constraints, updated for the
constraints applied by GMBC, GMSPC, SPC, SPC1, or SPCD Bulk
Data entries.
GNSTART Input-integer-default=0. First grid identification number in GEOM1M.
MODGM4 Output-logical-default=FALSE. GEOM4P update flag. Set to TRUE if
GEOM4M is updated.
Main Index
1147 MODGM4
Reads SPCs and SPCDs and generates unique SPC and SPCD records
ALTSHAPE Input-integer-no default. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1
selects the Full Product Space set.
NSWELM Output-integer-default=0. Current spot weld element identification
number.
SWEXIST Input-logical-default=FALSE. Spot weld element existence flag. Set to
TRUE if spot weld elements exist.
RGDEXIST Input-logical-default=FALSE. Flag, if TRUE, indicates there re rigid
elements that need further processing in MODGM4.
Main Index
MODQSET
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
1148
Augments GEOM1, GEOM2 and GEOM4 records with q-set degrees-of-freedom definition to account
for the component modes computed for all superelements.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
MODQSET
Augments GEOM1, GEOM2 and GEOM4 with q-set
definitions
MODQSET GEOM1,GEOM2,GEOM4/
GEOM1W,GEOM2W,GEOM4W/
NOQSETT/QSETREC/QSETID $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
GEOM1W GEOM1 augmented with dummy GRID entries to represent the fluid
superelement modes.
GEOM2W GEOM2 augmented with SPOINT entries to represent all of the non-
fluid superelement component modes.
GEOM4W GEOM4 augmented with dummy SEQSET1 entries to represent the
fluid superelement modes and QSET1 for all other non-fluid
superelement component modes.
NOQSETT Input-integer-default=0. Total number of component modes computed for all
superelements including the residual structure.
NOQSETF Input-integer-default=0. Number of component modes in the fluid superelement.
QSETREC Input-integer-default=0. Records to use in defining the q-set degrees-of-freedom:
>=0: No records are written
=-1: SENQSET record to GEOM1W
Main Index
1149 MODQSET
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
=-2: SPOINT record to GEOM2W and QSET1 record to GEOM4W
QSETID Input-integer-default=0. Starting q-set identification number for QSETREC=-2.
Main Index
MODTRK
Reorders eigenvalues and eigenvectors to be consistent with previous design cycle
1150
Compares the mode set of the current design cycle with those of the previous design cycle, identifies or
tracks these modes, and reorders the eigenvalues and eigenvectors to be consistent with the previous
design cycle.
Format:
Input Data Blocks:
Output Data Blocks:
MODTRK
Reorders eigenvalues and eigenvectors to be consistent
with previous design cycle
MODTRK CASECC,EDOM,R1TABR,LAMA,MGG,MAA,PHG,PHA,PHGREF
,
PHAREF/MTRAK,LAMA1,PHG1,PHA1,PHGREF1,PHAREF1/
DESCYCLE/S,N,NOTRACK $
CASECC Table of Case Control command images.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry)
attributes.
LAMA Normal modes eigenvalue summary table.
MGG Mass matrix in g-size.
MAA Mass matrix in a-set.
PHG Normal modes eigenvector matrix in the g-set.
PHA Normal modes eigenvector matrix in the a-set.
PHGREF Designed normal modes eigenvector matrix in the g-set from the prior
design cycle output of MODTRK.
PHAREF Designed normal modes eigenvector matrix in the a-set from the prior
design cycle output of MODTRK.
MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to
the new mode numbering.
LAMA1 Normal modes eigenvalue summary table updated for mode tracking.
PHG1 Normal modes eigenvector matrix in the g-set updated for mode
tracking.
Main Index
1151 MODTRK
Reorders eigenvalues and eigenvectors to be consistent with previous design cycle
Parameters:
Remarks:
MODTRK prints a report on mode switching activity for the current design cycle and punches out
updated DRESP1 Bulk Data entries that correspond to the new mode positions.
Example:
Excerpt from subDMAP FEA:
DESITERP=DESITER-1 $
DBVIEW PHAREF0=PHAREF WHERE (DESITER=DESITERP) $
DBVIEW PHGREF0=PHGREF WHERE (DESITER=DESITERP) $
MODTRK CASEM,EDOM,LAMAS,MGG,MAA,PHG,PHSA,PHGREF0,PHAREF0/
MTRAKS,NEWLAMA,NEWPHG,NEWPHA,PHGREF,PHAREF/
DESCYCLE/S,N,NOTRACK $
PHA1 Normal modes eigenvector matrix in the a-set updated for mode
tracking.
PHGREF1 Designed normal modes eigenvector matrix in the g-set updated for
mode tracking.
PHAREF1 Designed normal modes eigenvector matrix in the a-set updated for
mode tracking.
DESCYCLE Input-integer-no default. Design cycle analysis counter.
NOTRACK Output-logical-default=FALSE. Mode tracking success flag. Set to
TRUE if mode tracking was successful.
Main Index
MODTRL
Modify trailer
1152
Modify data block trailer data.
Format:
Input Data Block:
Parameters:
Remarks:
1. Negative parameters are ignored. Nonnegative parameters cause the corresponding word of the
data block trailer to be replaced by the value of the parameter.
2. MODTRL should be scheduled immediately after the functional module that generates the data
block. For example:
ADD I1,I2/O1 $
MODTRL O1////6 $
EQUIVX Ol/O2/ALWAYS $
3. If MODTRL is used to increase the number of columns in a matrix, then the resulting matrix is
unusable in most modules, including MATPRN and ADD.
4. The correspondence between the parameters and the content of a matrix trailer is as follows:
For matrices, P4 and P6 must be -1 or unspecified. See Examples 2 and 3.
5. For table trailer contents, see Data Blocks (Ch. 2).
MODTRL
Modify trailer
MODTRL DB//P1/P2/P3/P4/P5/P6 $
DB Data block with trailer that is to be modified.
Pi Input-integer-default=-1. New value for i-th trailer word. See Remark
4.
Parameter Matrix Trailer
P1 Number of columns
P2 Number of rows
P3 Form
P5 Number of nonzero words
Main Index
1153 MODTRL
Modify trailer
Examples:
1. To make KAA symmetric (form=6) (MPYAD will label it square (form=1)):
MPYAD GO,KOA,KAAB/KAA/1 $
MODTRL KAA////6/ $
2. In order to change the precision of a matrix, use ADD5. If the new precision does not match the
machine precision specify PUTSYS (newprecision,55) before ADD5. For example, on a double-
word machine:
Single to double
$''6,1*/('28%/(
Double to single
3876<6
$'''28%/(6,1*/(
3876<6
3. In order to change the type (complex or real) of a matrix, use ADD to convert real to complex and
MATMOD(34) for complex to real. For example,
Real to complex
$''5($/&03/;
Complex to real
0$702'&03/;5($/
Main Index
MODUG
Modifies UG vector to incorporate displacements of piercing points for connector elements
1154
Computes displacements of piercing points for connector elements and incorporates them into the
modified UG vector.
Format:
Input Data Block:
Output Data Block:
Parameters:
MODUG
Modifies UG vector to incorporate displacements of piercing points
for connector elements
MODUG UG,BGPDT,EST,CSTM,GPECT,USET,CASECC/
OUG/S,N,MDUG $
UG Displacement vector.
BGPDT Basic grid point definition table.
EST Element summary table.
CSTM Coordinate system transformation table.
GPECT Grid point element connection table.
USET Set definition table.
CASECC Case control command table.
OUG Modified displacement vector.
MDUG Output, Logical, default=FALSE. Modification flag. Set to TRUE if
UG is updated.
Main Index
1155 MODUSET
Modifies the degree-of-freedom set membership table (USET)
Modifies the degree-of-freedom set membership table (USET).
Format:
Input Data Blocks:
Output Data Block:
MODUSET
Modifies the degree-of-freedom set membership table
(USET)
MODUSET EDITVEC,USET/
USETM/
USETOP/MAJOR/SET0/SET1/USETADD/UNUSED6/UNUSED7
$
EDITVEC Vector with zeros in rows to be removed under USETOP='FILTER' or
USETOP=NEWMSET or USETOP=REPLACE. See Remark 1.
USET Degree-of-freedom set membership table for g-set.
USETM Modified degree-of-freedom set membership table for g-set.
Main Index
MODUSET
Modifies the degree-of-freedom set membership table (USET)
1156
Parameters:
Remark:
1. EDITVEC may be purged if and and
.
USETOP Input-character-default='UNION'. Name of desired operation.
USETOP Operation
UNION Combine SET0 and SET1 into MAJOR.
COMP0 Form SET0 from compelement of MAJOR and SET1.
COMP1 Form SET1 from compelement of MAJOR and SET0.
DELETE Remove degrees-of-freedom from MAJOR.
TURNON Add degrees-of-freedom from MAJOR.
COPY Copy degrees-of-freedom from SET0 to MAJOR.
EXPAND Extend uset length by USETADD.
MOVE Move SET0 degrees-of-freedom to MAJOR.
FILTER Remove degrees-of-freedom from USET that correspond to zero rows
in EDITVEC.
NEWMSET Rewrite the m-set according to partition vector EDITVEC. USETADD
is the new m-set size.
REPLACE Replace degrees-of-freedom set of MAJOR by SET0 corresponding to
1.0 rows in EDITVEC.
MAJOR Input-character-default='U3'. Name of the major set. The major set
must be larger then the subsets defined by SET0 and SET1.
SET0 Input-character-default='U2'. Name of the "zeros" subset of MAJOR.
SET1 Input-character-default='U1'. Name of the "ones" subset of MAJOR.
USETADD Input-integer-default=1. USET length extension. If
USETOP='EXPAND' or USETOP=NEWMSET then extend the size
of the USET by this amount.
UNUSED6 Input-integer-default=0. Unused.
UNUSED7 Input-integer-default=0. Unused.
USETOP 'FILTER' = USETOP 'NEWMSET' =
USETOP 'REPLACE' =
Main Index
1157 MODUSET
Modifies the degree-of-freedom set membership table (USET)
Examples:
1. Scalar degrees-of-freedom 1 through 5 will be defined in the u1-set and u3-set and scalar degrees-
of-freedom 6 through 10 in the u2-set and u3-set.
SOL ...
COMPILE ...
ALTER ...
MODUSET ,,USET/USET1 $
CEND
BEGIN BULK
SPOINT,1,THRU,10
USET1,U1,0,1,THRU,5
USET1,U3,0,6,THRU,10
2. The u1-set will be empty. The u2-set will contain the a-set and the u3-set will contain the f-set.
MODUSET ,,USET/VSET/'COMP0'/'F' /'U1'/'A' $
MODUSET ,,VSET/WSET/'COMP1'/'F' / /'U2' $
MODUSET ,,WSET/XSET/'UNION'/'U3'/'U1'/'U2' $
3. The following alter puts all degrees-of-freedom automatically constrained by GPSP into the sg-
set.
COMPILE SEKR0
ALTER 'GPSP'(,-1) $ BEFORE GPSP
$ MOVE DOF IN SET SB INTO SET U3
MODUSET, ,USET0/VSET/'MOVE'/'U3'/'SB'/ $
EQUIVX VSET/USET0/ALWAYS $
MESSAGE //'SB SET SHOULD NOW BE EMPTY - CHECK BELOW'/ $
TABPRT USET0,EQEXINS//'USET'/11
ALTER 'GPSP' $ AFTER GPSP
MESSAGE //'SB SET SHOULD NOW BE ONLY AUTOSPC DOF - CHECK BELOW'/
$
TABPRT USET,EQEXINS//'USET'/11
$ MOVE CURRENT SB (ALL FROM AUTOSPC) INTO SG
MODUSET, ,USET/VSET1/'MOVE'/'SG'/'SB'/ $
MESSAGE //'SB SET SHOULD NOW BE EMPTY,SG SHOULD BE PS + AUTOSPC'/
$
TABPRT VSET1,EQEXINS//'USET'/11
$ NOW MOVE SET U3 BACK INTO SB
MODUSET, ,VSET1/VSET2/'MOVE'/'SB'/'U3'/ $
EQUIVX VSET2/USET/ALWAYS $
MESSAGE //'SB SET SHOULD NOW BE ONLY SPC DOF'/
' SG SHOULD BE PS + AUTOSPC'/ $
TABPRT USET,EQEXINS//'USET'/11 $
Main Index
MONVEC
Forms monitor point rigid body vectors
1158
Forms rigid body vectors for monitor points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
MONVEC
Forms monitor point rigid body vectors
MONVEC
AEMONPT Table of aerodynamic monitor points.
MONITOR Table of structural monitor points.
AEROCOMP Table of aerodynamic components when MESH='AERO'.
STRUCOMP Table of structural components when MESH='STRU'.
AEBGPDT Basic grid point definition table for the aerodynamic degrees-of-
freedom.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
SRKS Matrix of monitor point rigid body vectors.
AEMONPT
MONITOR
)
`
SRKS $
,
AEROCOMP
STRUCOMP
)
`
,
AEBGPDT
,
CSTMA /
Main Index
1159 MONVEC3
Process type 3 monitor points
Process type 3 monitor points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
MONVEC3
Process type 3 monitor points
MONVEC3 MP3LAB,STRUCOMP,BGPDT,CSTM,KDICT/
KDICT3*,MN3VEC* $
MP3LAB Table of monitor point type 3 labels.
STRUCOMP Table of structural components when MESH='STRU'.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
KDICT KELM dictionary table.
KDICT3* Family of KDICT tables; one for each MONPNT3 entry.
MN3VEC* Family OF monitor point vectors; one for each MONPNT3 entry.
Main Index
MPP
Prints monitor point results
1160
Prints monitor point results for either trim subcase or for any one UXDAT instance or for any one
UXDAT instance by interpolation of the UXV.
Format:
Input Data Blocks:
MPP
Prints monitor point results
MPP AECTRL,UXDAT, , , ,MPE
U,
MPSIR,MPSRP,MP2S,MPSERP,UXV,INDX//
MACH/Q/AECONFIG/SYMXY/SYMXZ/MESH $
AECTRL Table of aeroelastic model controls.
UXDAT Table of aerodynamic extra point identification numbers,
displacements, labels, type, status, position and hinge moments.
MONITOR Monitor point table
AEMONPT Aerodynamic monitor point table
MPSR Rigid aerodynamic loads on structural monitor points at trim
(excluding inertial loads and static applied loads).
MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim.
MPSER Elastic restrained loads on structural monitor points at trim (excluding
inertial loads and static applied loads).
MPAER Elastic restrained loads on aerodynamic monitor points at trim.
MPEU Elastic unrestrained loads on monitor points either at trim or across
ADB/AEDB.
MPSIR Inertial loads on structural monitor points at trim.
MPSRP Rigid loads on structural monitor points due to static applied loads.
MP2S Table of MONPNT2 responses at trim
MPSERP Elastic restrained loads on structural monitor points due to static
applied loads.
UXV Control state matrix for ADB or AEDB.
ADBINDX Index of ADB or AEDB.
MONITOR
AEMONPT
)
`
MPSR
MPAR
)
`
MPSER
MPAER
)
`
Main Index
1161 MPP
Prints monitor point results
Output Data Blocks:
None.
Parameters:
Examples:
1. Print structural monitor point loads at trim.
2. Print aerodynamic monitor point loads at trim.
MACH Input-real-no default. Mach number.
Q Input-real-no default. Dynamic pressure.
AECONFIG Input-character-no default. Aerodynamic configuration.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
MESH Input-character-no default. Mesh type.
MPP AECTRL,UXDAT,MONITOR,MPSR,MPSER,,MPSIR,MPSRP,MPSERP,,//
MACH/Q/AECONFIG/SYMXY/SYMXZ/'STRUCT' $
MPP AECTRL,UXDAT,AEMONPT,MPAR,MPAER,,,,,,//
MACH/Q/AECONFIG/SYMXY/SYMXZ/'AERO' $
Main Index
MPPTRAN
Prints monitor point data for frequency response aeroelasticity
1162
Prints monitor point data for frequency response aeroelasticity.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
MPPTRAN
Prints monitor point data for frequency response aeroelasticity
MPPTRAN CASECC,MPDB,OL,MAT1,MAT2,MAT3,MAT4//MATTYPE/MO
NTYPE $
CASECC Table of Case Control specifications
MPDB Table of monitor point information
OL Transient response time output list or frequency response frequency
output list.
MATi Input matrices. See MATTYPE.
MATTYPE Input-character-default= . Input matrix type flag.
Value Input Matrix Description
MONDSP1 X1=Displacement matrix
X2 thru X4 are ignored and may be purged.
MONPNT1 X1=Inertia loads matrix
X2=External Loads matrix
X3=Flexible Increments matrix
X4=Rigid Gust loads matrix
MONTYPE Input-character-default= . Monitor point type.
STRUCTUR Structural monitor points
AERODYNA Aerodynamic monitor points
Main Index
1163 MPPTRAN
Prints monitor point data for frequency response aeroelasticity
Remarks:
None.
Main Index
MPYAD
Matrix multiply and add
1164
Perform the multiplication of two matrices and optionally, the addition of a third matrix to the product.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
MPYAD
Matrix multiply and add
MPYAD A,B,C/X/
T/SIGNAB/SIGNC/PREC/FORM/DODMP/DMPYIN/DMPYOUT
$
A Left-hand matrix in the matrix product.
B Right-hand matrix in the matrix product.
C Matrix to be added to the product.
X Matrix product.
T Integer-input-default = 0. Transpose flag.
T = 1, perform
T = 0, perform
T = 2, perform where is the complex conjugate of A.
Only meaningful when A is complex.
T = 3, perform where is the complex conjugate of A.
Only meaningful when A is complex.
SIGNAB Integer-input-default = 1. Sign of product flag.
SIGNAB = +1, perform
SIGNAB = -1, perform
X | | A | |
T
B | | C | | =
A | |
T
B | |
A | | B | |
A | | B | | A | |
A | |
T
B | | A | |
A | | B | |
A | | B | |
Main Index
1165 MPYAD
Matrix multiply and add
Remarks:
1. If no matrix is to be added, must be purged. may be Form 3.
2. and may be the same data block, but both must be different from .
3. If or ] is purged, and is purged, then [X] is purged. may not be Form 3.
4. If and/or is purged, but exists, the purged matrices are equivalent to null matrices,
and [X] will be output.
5. may not be purged.
6. If the precision of the computer is double precision and B is single precision, and Methods 1, 2,
3 are deselected, then PREC must be set equal to 1.
SIGNC
Integer-input-default = 1. Sign of flag.
SIGNC = +1, add
SIGNC = -1, subtract
PREC Integer-input-default = 0. Precision.
PREC = 1, element of will be output in single precision.
PREC = 2, elements of will be output in double precision.
PREC = 0, elements of will be output in the precision of the
computer.
FORM
Integer-input-default = 0. Form of .
FORM = 0, form of will be 1 (square) or 2 (rectangular).
DODMP Input-integer-default=0. Distributed memory parallel flag.
0: compute in serial (default)
1: compute in distributed memory parallel method 1
2: compute in distributed memory parallel method 1
DMPYIN Input-logical-default=TRUE. For DODMP>0, broadcast flag to input
matrices from master processor to slave processor(s).
DMPYOUT Input-logical-default=TRUE. For DODMP>0, broadcast flag to X
matrix from slave processor(s) to master processor.
C | |
C | |
C | |
X | |
X | |
X | |
X | |
X | |
C | | A | |
A | | B | | C | |
A | | B | | C | | A | |
A | | B | | C | |
X | |
Main Index
MPYAD
Matrix multiply and add
1166
7. The MPYAD keyword (or SYSTEM(66)) and the SPARSE keyword (or SYSTEM(126)) on the
NASTRAN statement is used for MPYAD method deselection. (The SPARSE keyword is
described in Remark 11.) The Deselection Values in the table below are used to deselect or disable
a single method or several methods. If MPYAD=0 and SPARSE=1, which are the defaults, then
the method that results in the lowest CPU and I/O time will be selected. If all transpose methods
are deselected, then T must be equal to zero (default). If all nontranspose methods are deselected,
then T must be equal to 1.
For methods 2, 3, and 4, a combination of methods is selected by subtracting the sum of their
Deselection Values from 255. For example, NASTRAN MPYAD = 243 (which is obtained from
255-(4+8)) selects only Methods 2 Transpose and Nontranspose.
Method
Storage
Technique
MPYAD Keyword
Deselection Value
1 Nontranspose 1 1
1 Transpose 1 2
2 Nontranspose --- 4
2 Transpose --- 8
3 Nontranspose --- 16
3 Transpose --- 32
4 Nontranspose --- 64
4 Transpose --- 128
1 Nontranspose A 256
1 Nontranspose B 512
1 Nontranspose C 1024
1 Nontranspose D 2048
1 Nontranspose E 4096
1 Nontranspose F 8192
1 Transpose A 16384
1 Transpose B 32768
1 Transpose C 65536
1 Transpose D 131072
Main Index
1167 MPYAD
Matrix multiply and add
For Method 1 Submethods (storage techniques), a combination of methods is selected
accordingly. First sum their Deselection Values and then add 1, if Nontranspose, and/or 2, if
Transpose. This total is then subtracted from 262143. See examples below.
8. As an alternative to the deselection procedure described above, the MPYAD keyword value may
be set to select a single method while deselecting all other methods and submethods. To select a
single method, add 1048576 to the selection value of the desired method shown in the table below.
For example, if Method 1 Nontranspose Storage Submethod C is desired, then MPYAD =
1048586; computed from 1048576 + 10.
Example 1: If only Method l Nontranspose with storage techniques D, E, and F are
desired, then NASTRAN MPYAD=247806 (which is obtained from
262143-(2048 + 4096 + 8192 + 1)).
Example 2: If Method 2 is also desired in Example 1, then NASTRAN
MPYAD=247794 (which is obtained from 262143-(2048 + 4096 + 8192 +
8 + 4 + 1)).
Method
Storage
Submethod
Selection
Value
1 Nontranspose 1 0
1 Transpose 1 1
2 Nontranspose --- 2
2 Transpose --- 3
3 Nontranspose --- 4
3 Transpose --- 5
4 Nontranspose --- 6
4 Transpose --- 7
1 Nontranspose A 8
1 Nontranspose B 9
1 Nontranspose C 10
1 Nontranspose D 11
1 Nontranspose E 12
1 Nontranspose F 13
1 Transpose A 14
1 Transpose B 15
1 Transpose C 16
1 Transpose D 17
Main Index
MPYAD
Matrix multiply and add
1168
If a Storage Submethod under Method 1 is selected in this manner, then a printout of timing
estimates for the other submethods may be requested by adding 3145728 to the selection value
above. Using the previous example, MPYAD = 3145738, computed from 3145728 + 10.
9. Sparse methods are deselected or selected by the SPARSE keyword (or SYSTEM(126)) on the
NASTRAN statement. The default SPARSE = 1 causes the automatic selection of sparse methods
if their CPU and I/O estimates are lower than those estimated for the methods in Remark 7. If the
sparse method is not desired, then specify SPARSE = 0 or 6.
In order to select or force one or both methods below, then add l to its value(s) below.
Note that if SPARSE = 2, 3, 4, 5, or 7, then all methods in Remark 2 are turned off or deselected,
and the MPYAD keyword must be equal to zero.
The SPARSE keyword is also used for sparse method selection within all modules which
perform matrix decomposition and forward-backward substitution; e.g., DCMP, DECOMP, FBS,
and SOLVE.
10. The diagonal matrix format (FORM = 3) for input matrices is not supported for the transpose
option (T = 1), and will cause an ILLEGAL INPUT fatal message. [A] can be transposed with
the TRNSP module.
11. Parallel processing in this module (Methods 1 Nontranspose Storage E and Transpose Storage C
only) is selected with the NASTRAN statement keyword PARALLEL (or SYSTEM(107)) which
is set to the number of parallel processors (default = 0). To force parallel processing, the MPYAD
keyword must be set to one of the following values:
Examples:
1.
Sparse Method SPARSE Keyword Value
Nontranspose 2
Transpose 4
Example 1: To force the sparse nontranspose method, then specify SPARSE =
3, computed from 1 + 2.
Example 2: To force the sparse methods, then specify SPARSE = 7, computed
from 1 + 2 + 4.
MPYAD Keyword Storage Technique
1048592 Transpose C
1048588 Nontranspose E
192512 Both
X | | A | | B | | C | | + =
Main Index
1169 MPYAD
Matrix multiply and add
MPYAD A,B,C/X $
2.
MPYAD A,B,C/X/1//-1 $
3.
MPYAD A,B,/X//-1 $
X | | A | |
T
B | | C | | =
X | | A | | B | | =
Main Index
MRGCOMP
Merges two existing aerodynamic or structural component tables
1170
Merges two existing aerodynamic or structural component tables.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
Remark:
Duplicate component names will cause a fatal message to be issued unless COMPRPLC is true.
MRGCOMP
Merges two existing aerodynamic or structural component
tables
MRGCOMP COMP1,COMP2/
COMP/
COMPRPLC $
COMPi Table of aerodynamic or structural components.
COMP Merged table of components.
COMPRPLC Input-logical-default=FALSE. If TRUE then components with
duplicate names will be copied from COMP1 into COMP.
Main Index
1171 MRGCSTM
Merges families of coordinate system defintion tables (CSTM)
Merges families of coordinate system defintion tables (CSTM).
Format:
Input Data Blocks:
Output Data Block:
Parameter:
Remark:
None.
MRGCSTM
Merges families of coordinate system defintion tables
(CSTM)
MRGCSTM CSTM1*,CSTM2*,CSTM3*,CSTM4*,CSTM5*/
CSTMX/S,N,NOCSTMX $
CSTMi* Family of CSTM tables.
CSTMX Merged table of CSTMi.
NOCSTMX Output-integer-default=0. CSTMX creation flag.
0 CSTMX not created
1 CSTMX created
Main Index
MRGMON
Merges two monitor point tables
1172
Merges two monitor point tables and optionally output their associated matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
L
Remarks:
1. Duplicate monitor points will cause a fatal message to be issued unless MONRPLC is true.
2. SZR1, SZR2, and SZR may be purged.
3. SZR is created only if both SZR1 and SZR2 exist.
MRGMON
Merges two monitor point tables
MRGMON MON1,MON2,SZR1,SZR2/
MON,SZR/
MONRPLC $
MONi Monitor tables.
SZRi Associated monitor matrices.
MON Merged monitor table.
SZR Merged monitor matrices.
MONRPLC Input-logical-default=FALSE. If TRUE, then components with
duplicate names will be copied from MON1 into MON.
Main Index
1173 MSGHAN
Passes message number for processing by MSGPOP API
Passes the message number of a message for processing by the MSGPOP API.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
MSGHAN
Passes message number for processing by MSGPOP API
MSGHAN //MSGNUM/MSGINP1/MSGINP2/S,N,MSGOUT $
MSGNUM Input-integer-default=0. Message number.
MSGINP1 Input-integer-default=0. Optional integer input.
MSGINP2 Input-integer-default=0. Optional integer input.
MSGOUT Output-integer-default=0. Optional integer output.
Main Index
MSGSTRES
Computes data based on fields generated by MSGMESH
1174
Computes grid point stresses, maximum and minimum stresses, and stress contour plots based on fields
generated by MSGMESH.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
MSGSTRES
Computes data based on fields generated by MSGMESH
MSGSTRES FORCE,OES1X//
S,N,PLTNUM/NOMSGSTR $
FORCE Table of MSGSTRESS plotting commands defined under the
OUTPUT(CARDS) Section in CASE CONTROL and MSGMESH
field information.
OES1 Table of element stresses or strains in SORT1 format.
PLTNUM Input/output-integer-default=0. Plot frame counter.
NOMSGSTR Input-integer-default=0. MSGSTRES execution flag. Set to -1 if
MSGSTRES execution is not desired.
Main Index
1175 MTRXIN
Converts DMIG entries to matrices
Converts matrices input on DMIG Bulk Data entries to matrix data blocks.
Format:
Form 1 -- Simplified (CASECC is purged).
Form 2 -- Case Control Command Selection of stiffness, mass, and damping (or square) matrices
(IOPT=1 for K2GG, etc., and IOPT=0 for K2PP, etc., and TF).
Form 3 -- Case Control Command selection of load (or rectangular) matrix (IOPT=2).
MTRXIN
Converts DMIG entries to matrices
MTRXIN
,,MATPOOL, ,,/
NAME1,NAME2,NAME3,NAME4,NAME5/
/S,N,NONAME1/S,N,NONAME2/S,N,NONAME3
/
S,N,NONAME4/S,N,NONAME5 $
MTRXIN
CASECC,MATPOOL, ,, /
,K42GG,A2GG /
/S,N,NOK2/S,N,NOM2/S,N,NOB2/S,N,NOK4
2/
S,N,NOA2/ $
MTRXIN CASECC,MATPOOL,EQEXIN,,/
P2G,,,,/
LUSET/S,N,NOP2G/////2 $
EQEXIN
EQDYN
)
`
LUSET
LUSETD
)
`
EQEXIN
EQDYN
)
`
TFPOOL
)
`
K2GG,M2GG,B2GG
K2PP,M2PP,B2PP
)
`
LUSET
LUSETD
)
`
1
0
)
`
Main Index
MTRXIN
Converts DMIG entries to matrices
1176
Form 4 -- Selection of DMIK, DMIJ and DMIJI by data block names MATKi, MATJi, and MATJIi.
Form 5 -- Selection of stiffness, mass, damping, and loads (or square) matrices by MATNAMi, etc. input
parameter values (IOPT=10 through 12).
MTRXIN ,,MATPOOL, ,, /
, , ,, /
/S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/// $
MTRXIN CASECC,MATPOOL, ,, /
, ,
, , /
/S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/
S,N,NOMAT4/S,N,NOMAT5/ /
MATNAM1/MATNAM2/MATNAM3/MATNAM4/MATNAM5/
NFEXIT/MATID1/MATID2/MATID3/MATID4/M
ATID5 $
AEBGPDTK
AEBGPDTJ
AEBGPDTI
)
`
MATK1
MATJ1
MATI1
)
`
MATK2
MATJ2
MATI2
)
`
MATK3
MATJ3
MATI3
)
`
S,N,LKSET
S,N,LJSET
S,N,LISET
)
`
3
4
5
)
`
EQDYN
EQEXIN
EQEXIN
)
`
TFPOOL
)
`
MATP1
MATG1
RMATG
)
`
MATP2
MATG2
)
`
MATP3
MATG3
)
`
MATP4
MATG4
)
`
MATP5
MATG5
)
`
LUSETD
LUSET
LUSET
)
`
10
11
12
)
`
TFLID
)
`
Main Index
1177 MTRXIN
Converts DMIG entries to matrices
Form 6 -- Selection of DMIK, DMIJ, and DMIJI matrices by the MATNAMi input parameter values
(IOPT=13 through 15).
Input Data Blocks:
Output Data Blocks:
MTRXIN ,,MATPOOL, ,,/
, , ,,/
/S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/
// /
MATNAM1/MATNAM2/MATNAM3 $
CASECC Table of Case Control command images.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data).
TFPOOL Table of TF Bulk Data entry images.
AEBGPDTK Basic grid point definition table for the aerodynamic ks-set degrees of
freedom.
AEBGPDTJ Basic grid point definition table for the aerodynamic js-set degrees of
freedom.
AEBGPDTI Basic grid point definition table for the aerodynamic js-set interference
degrees of freedom
NAMEi Matrices defined on DMIG Bulk Data entries.
K2GG, etc. Matrices defined on DMIG Bulk Data entries and referenced by the
K2GG, M2GG, B2GG, K2PP, M2PP, B2PP, or P2G Case Control
commands.
AEBGPDTK
AEBGPDTJ
AEBGPDTI
)
`
MATK1
MATJ1
MATI1
)
`
MATK2
MATJ2
MATI2
)
`
MATK3
MATJ3
MATJ3
)
`
S,N,LKSET
S,N,LJSET
S,N,LISET
)
`
13
14
15
)
`
Main Index
MTRXIN
Converts DMIG entries to matrices
1178
Parameters:
MATPi Matrices defined on DMIG Bulk Data entries and intended for the
p-set.
MATGi Matrices defined on DMIG Bulk Data entries and intended for the g-
set.
RMATG Rectangular matrix defined on DMIG Bulk Data entries and may have
an arbitrary number of columns but g-set rows, similar to P2G.
MATKi Matrices defined on DMIK Bulk Data entries.
MATJi Matrices defined on DMIJ Bulk Data entries.
MATIi Matrices defined on DMIJI Bulk Data entries.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
LUSETD Input-integer-no default. The number of degrees-of-freedom in the
p-set.
NONAMEi Output-integer-default=-1. NAMEi generation flag. Set to +1 if NAMEi is
generated; -1 otherwise.
NOK2, etc. Output-integer-default=-1. K2GG, etc. generation flag. Set to +1 if K2GG, etc. is
generated; -1 otherwise.
IOPT Input-integer-default=0. Case Control command selection flag.
0 No Case Control command selection (see Form 1) or K2GG, etc., and TFL
Case Control command selection (see Form 2).
1 K2GG, etc. Case Control command selection (see Form 2).
3 P2G Case Control command selection (see Form 3).
3 DMIK selection by output data block name (see Form 4).
4 DMIJ selection by output data block name (see Form 4).
5 DMIJI selection by output data block name (see Form 4).
10 K2PP, M2PP, and B2PP selection by input parameter value (see Form 5).
11 K2GG, M2GG, and B2GG selection by input parameter value (see Form 5).
12 P2G selection by input parameter value (see Form 5).
13 DMIK selection by input parameter value (see Form 6).
14 DMIJ selection by input parameter value (see Form 6).
15 DMIJI selection by input parameter value (see Form 6).
LKSET,
LJSET,
LISET
Output-integer-default=0. Size of ks-set, js-set, and inteference
js-set extracted from the AEBGPTK, AEBGPDTJ and AEBGPDTI tables.
Main Index
1179 MTRXIN
Converts DMIG entries to matrices
Remarks:
1. Any output data block may be purged.
2. Form 1 is used to input matrices from DMIG entries named in the DMAP statement output
section. No Case Control commands are required.
3. Forms 2 and 3 are used to select the matrices with Case Control commands: K2GG, M2GG,
B2GG, K2PP, M2PP, B2PP, or P2G. -2GG matrices are of dimension g by g. -2PP matrices
are of dimension p by p. The P2G matrix has g-rows, with the number of columns determined by
the several methods used to input rectangular matrices described on the DMIG entry.
4. If the output data blocks are specified on a CALL statement and the DMIIN module is specified
in the subDMAP referenced by the CALL statement, then the data block name specified on the
CALL statement must be the same as the name specified on the DMIIN module.
Examples:
1. Assume the Bulk Data contains two DMIG matrices, named M1 and M2, which reference grid
and/or scalar points only. The following set of DMAP instructions will generate these two
matrices in matrix format, multiply them together and print the result.
MTRXIN ,,MATPOOL,EQEXIN,,/Ml,M2,/LUSET/S,N,NOMl/S,N,NOM2$
IF (NOM1 > -1 AND NOM2 > -1) THEN $
MPYAD M1,M2,/PRODUCT $
MATPRN PRODUCT//$
ENDIF $
2. Assume the Bulk Data contains two DMIG matrices, MASS and STIFF, which reference grid
and/or scalar points only. The following Case Control and DMAP instructions will generate these
two matrices in matrix format and add them to the structural mass and stiffness.
Case Control:
M2GG = MASS
K2GG = STIFF
DMAP instructions:
MTRXIN CASECC,MATPOOL,EQEXIN,,/STIFF,MASS,/
LUSET/S,N,NOSTIFF/S,N,NOMASS//1 $
IF (NOSTIFF > -1) THEN $
NOMATi Output-integer-default=1. Generation flag. Set to +1 if MAT* is generated; -1
otherwise.
MATNAMi Input-character-default=' '. Matrix name found on DMIG, DMIJ, DMIK, and
DMIJI Bulk Data entries.
TFLID Input-integer-default=0. Transfer function set identification number. TFLID is
ignored if IOPT=3, 4, 5, 13, 14, or 15.
NFEXIT Input-logical-default=TRUE. Termination flag. If FALSE do not issue User Fatal
Message 2070 and do not terminate the module if the matrix is not found.
MATIDXi Input-integer-default=-1. Index to the current name in the SET containing the
DMIG names.
Main Index
MTRXIN
Converts DMIG entries to matrices
1180
ADD KGG,STIFF/KGGNEW $
EQUIVX KGGNEW/KGG/ALWAYS $
ENDIF $
IF (NOMASS > -1) THEN $
ADD MGG,MASS/MGGNEW $
EQUIVX MGGNEW/MGG/ALWAYS $
ENDIF
Main Index
1181 NASSETS
Combines all element sets for MSGMESH, and sets defined on SET1
Combines all element sets defined in Case Control, including OUTPUT(PLOT) sections, for
MSGMESH, and sets defined on SET1 Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
NASSETS
Combines all element sets for MSGMESH, and sets defined
on SET1
NASSETS CASECC,ELSET,EDT/
SET/
MESHSET $
CASECC Table of Case Control command images.
ELSET Table of element sets defined in OUTPUT(POST) or SETS
DEFINITION Section of Case Control.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
SET Table of combined sets.
MESHSET Input-integer-default=0. MSGMESH set processing flag. If nonzero,
then combine mesh sets defined in the MSGMESH punch file.
Main Index
NDINTERP
Nonlinear interpolator
1182
Nonlinear interpolator.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NDINTERP
Nonlinear interpolator
NDINTERP CONTVXV,CONTVX/
IFACT,CONTDIF/
NSUPD/MINNUSE/MAXNUSE/STOL $
CONTVXV Assemblage of all controller vectors (NX rows by NV columns).
CONTVX Controller vector used to interpolate UXV (NX rows).
IFACT Interpolation factor vector (NV rows).
CONTVDIF Derivative interpolation factor matrix (NV rows by NX columns).
NSUPD Input-integer-default=2. Number of states to use per dimension.
MINNUSE Input-integer-default=1. Absolute minimum number of states to use
for the interpolation.
MAXNUSE Input-integer-default=9999999. Absolute maximum number of states
to use for the interpolation.
STOL Input-real-default=1.E-02. State matching tolerance.
Main Index
1183 NEWUSET
Creates USET table for matrix-based ACMS
Creates a USET table for the matrix-based ACMS (automatic component mode synthesis) method.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NEWUSET
Creates USET table for matrix-based ACMS
NEWUSET COLOR,USET,SIL/USETN/SEID $
COLOR Coloring array. Number of rows corresponds to size of MATi. The i-th
entry corresponds to the superelement identification number (tip
superelement or collector or 0 (residual) to which the i-th degree-of-
freedom belongs.
USET Degree-of-freedom set membership table for g-set.
SIL Scalar index list.
USETN USET with updated set membership.
SEID Input-integer-default=0. Superelement identification number.
Main Index
NLCOMB
Consolidates tables related to nonlinear elements and applied loads
1184
Consolidates tables related to nonlinear elements and applied loads for the current nonlinear analysis
iteration.
Format:
Input Data Blocks:
NLCOMB
Consolidates tables related to nonlinear elements and
applied loads
NLCOMB CASECC,ESTNL,KDICTNL,BKDICT,ETT,PTELEM0,PTELEM
,UNUSED8,
MPT,EQEXIN,SLT,DLT,BGPDT,APPLOD,DYNAMIC/
ELDATA, ,GPTT1/
NSKIP/LSTEP/LINC/STATIC/LGDISP/OSTEP/NEWSTEP/T
STATIC/ $
CASECC Table of Case Control command images.
EST Element summary table containing geometric and/or material
nonlinear elements.
KDICTNL KELMNL dictionary table.
BKDICT BKELM dictionary table.
ETT Element temperature table.
PTELEM0 Table of thermal loads in the elemental coordinate system from prior
subcase.
PTELEM Table of thermal loads in the elemental coordinate system for the
current subcase.
UNUSED8 Not used and may be purged.
MPT Table of Bulk Data entry images related to material properties.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
SLT Table of static loads.
DLT Table of dynamic loads.
BGPDT Basic grid point definition table.
SLT1
DLT1
)
`
Main Index
1185 NLCOMB
Consolidates tables related to nonlinear elements and applied loads
Output Data Blocks:
Parameters:
APPLOD Matrix of applied load amplitudes
DYNAMIC Table of Bulk Data entry images related to dynamics.
ELDATA Table of combined nonlinear information data.
SLT1 Table of static loads updated for nonlinear analysis.
DLT1 Table of dynamic loads updated for nonlinear analysis.
GPTT1 Table of grid point temperatures (for transient analysis only).
NSKIP Input-integer-no default. Subcase record number to read in CASECC.
LSTEP Input-integer-no default. Load step. The current iteration step at the subcase level
for static solutions.
LINC Input-integer-no default. Number of load increments for this subcase.
STATIC Input-integer-default=0. Static analysis flag. Set to zero for static analysis and one
for dynamic analysis.
LGDISP Input-integer-default=0. Large displacement flag. Set to 1 for large displacement
analysis.
OSTEP Input-integer-default=0. Restart step number.
NEWSTEP Input-integer-no default. STEP case flag.
-1 Not a new STEP case.
1 New STEP case.
0 Cold start from the first SUBCASE, first STEP case and TIME=0.0.
TSTATIC Input-integer-default=0. Static analysis flag. Set to 1 to ignore inertia and damping
forces.
Main Index
NLHARM
Computes forces and derivatives of forces in Fourier space
1186
Computes forces and derivatives of forces in Fourier space.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NLHARM
Computes forces and derivatives of forces in Fourier space
NLHARM HUDI,MFCDISP,MFCVELO,NLPART,NLFTAB,UNUSED6,DIT
/
HPNLDIX,HDFDDIX,UNUSED3/
DFFLAG/UVAFLAG/UNUSED3/UNUSED4/DELTA/FREQ/UNUS
ED7 $
HUDI Matrix of size dimension NLD*NN where NLD is the number of
nonlinear degrees-of-freedom in the d-set and NN = 2*NHARM + 1 =
number of Fourier coefficients requested.
MFCDISP Matrix of size NNxM where NN is defined above and M is NN + E and
E is the number of extra evaluation points to reduce aliasing.
MFCVELO Same as MFCDISP above but its size is(NN-1)xM and its used to
compute the time domain velocity given the Fourier coefficients.
NLPART Partition vector created by ROTRUTL option that identifies the
nonlinear subset of the d-set.
NLFTAB Table created by ROTRUTL option 8 used to describe all nonlinear
applied loads
UNUSED6 Unused and may be purged.
DIT Table of TABLEij Bulk Data entry images.
HPNLDIX Matrix of the Fourier components of the forces
HDFDDIX Matrix derivative HPNLDIX with size NG*NN by NG*NN
UNUSED3 Unused and may be purged.
DFFLAG Input-integer-default=0. HDFDDIX compute flag.
>-1 Compute DFDX
-1 Do not compute DFDX
Main Index
1187 NLHARM
Computes forces and derivatives of forces in Fourier space
UVAFLAG Input-integer-default=0. UVA nonlinear flag.
UNUSED3 Input-integer-default=0. Unused and may be left blank.
UNUSED4 Input-integer-default=0. Unused and may be left blank.
DELTA Input-real-default=0.0. Centered difference in computing HDFDDIX.
FREQ Input-real-default=0.0. Frequency value on NLFREQ/NLFREQ1 records.
UNUSED7 Input-integer-default=0. Unused and may be left blank.
Main Index
NLICLOOP
Prepares data for the NLIC run in SOL 400
1188
Prepares data for the NLIC run in SOL 400.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
NLICLOOP
Prepares data for the NLIC run in SOL 400
NLICLOOP CASECC,NLRSMP//STPPRV/S,N,ICLOOP $
CASECC Table of Case Control command selections.
NLRSMAP Nonlinear restart map from the restart step.
STPPRV Input-integer-default=0. The previous step identification number.
ICLOOP Output-integer-default=0. The output time step at the restart point:
=0 Cannot find initial condition's restart point.
<0 Continue from the last STEP case.
Main Index
1189 NLITER
Computes nonlinear analysis solution matrices and tables
Computes nonlinear analysis solution matrices and tables. Applicable to static structural or steady state
heat transfer analysis.
Format:
Input Data Blocks:
NLITER
Computes nonlinear analysis solution matrices and tables
NLITER CASECC ,CNVTST ,PLMAT ,YSMAT ,KAAL ,
ELDATA ,KELMNL ,LLLT ,GM ,MPT ,
DIT ,MGG ,SLT1 ,CSTM ,BGPDT ,
SIL ,USET ,RDEST ,RECM ,KGGNL ,
ULLT ,GPSNT ,EDT ,DITID ,DEQIND ,
DEQATN ,FENL ,EPT ,PCOMPT ,SLTNL /
UGNI ,FGNL ,ESTNLH ,CIDATA ,QNV ,
FFGH ,MUGNI ,MESTNL ,DUGNI ,BTOPCNV ,
BTOPSTF ,FENL1 ,MDUGNI ,MDPSINI/
S,N,LOADFAC/S,N,CONV/S,N,RSTEP/S,N,NEWP/S,N,NE
WK/
S,N,POUTF/S,N,NSKIP/LGDISP/S,N,NLFLAG/S,N,ITER
ID/
S,N,KMATUP/S,N,LSTEP/S,N,KTIME/S,N,SOLCUR/TABS
/
S,N,KFLAG/S,N,NBIS/NORADMAT/S,N,LASTCNMU/SIGMA
/
S,N,ARCLG/S,N,ARCSIGN/S,N,TWODIV/LANGLE/S,N,IT
OPT/
S,N,ITSEPS/ITSMAX/S,N,PLSIZE/IPAD /IEXT /
S,N,ADPCON/PBCONT/S,N,NBCONT/GPFORCE/GNLSTN /
UNUSED/K6ROT $
CASECC Table of Case Control command images.
CNVTST Convergence test matrix.
PLMAT Initial and final load matrices for subcase.
YSMAT Initial and final enforced displacement matrices.
KAAL Element stiffness matrix for linear elements only reduced to a-set.
ELDATA Table of combined nonlinear information data.
KELMNL Table of element matrices for stiffness for nonlinear elements.
LLLT Lower triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
GM Multipoint constraint transformation matrix, m-set by n-set.
MPT Table of Bulk Data entry images related to material properties.
Main Index
NLITER
Computes nonlinear analysis solution matrices and tables
1190
Output Data Blocks:
DIT Table of TABLEij Bulk Data entry images.
MGG Radiation matrix in g-size.
SLT1 Table of static loads updated for nonlinear analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
USET Degree-of-freedom set membership table for g-set.
RDEST Radiation element summary table.
RECM Radiation exchange coefficient matrix.
KGGNL Stiffness matrix in g-set for material nonlinear elements only.
ULLT Upper triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
GPSNT Grid point shell normal table.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
DITID Table of identification numbers in DIT.
DEQIND Index table to DEQATN data block.
DEQATN Table of DEQATN Bulk Data entry images.
FENL Strain energy and grid point force at every element from the previous
load step in nonlinear matrix format.
EPT Table of Bulk Data entry images related to element properties.
PCOMPT Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry.
SLTNL SLT with follower forces for CQUADR/CTRIAR elements for both
the current and last load step.
UGNI Displacement matrix at converged step in the g-set.
FGNL Nonlinear element force matrix from the last iteration.
ESTNLH Nonlinear element summary table at converged step.
CIDATA Miscellaneous data for controlled increment method.
QNV Quasi-Newton sweeping vectors.
FFGH Follower force for OLOAD output.
MUGNI Displacement matrix for stiffness update.
Main Index
1191 NLITER
Computes nonlinear analysis solution matrices and tables
Parameters:
MESTNL Nonlinear element summary table at current step.
DUGNI Incremental displacement matrix between the last two converged
steps.
BTOPOCNV Updated contact regions input information table.
BTOPOSTF Updated contact regions topological information table.
FENL1 Strain energy and grid point force at every element at the current load
step in nonlinear matrix format.
MDUGNI Matrix of incremental displacements with respect to the last converged
step (UI - U0), to be used for LANGLE=3 or for the new
CQUADR/CTRIAR elements.
MDPSINI Table of incremental rotation parameters with respect to the last
converged step to be used for LANGLE=3.
LOADFAC Input/output-complex-no default. Load factor. The real part is the load factor
for the current iteration, having a fractional value between 0 and 1.
CONV Input/output-integer-default=0. Nonlinear analysis convergence flag.
On input:
0 Initialization.
On output:
-1 Convergence has not been achieved.
1 Convergence has been achieved.
RSTEP Input/output-integer-default=0. Controlled increments counter.
NEWP Input/output-integer-default=1. New subcase flag.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
NEWK Output-integer-default=1. Stiffness update flag.
-1 Do not update stiffness.
1 Update stiffness.
2 Update stiffness, the solution is diverging and MAXBIS has been reached.
POUTF Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate
output is not requested.
Main Index
NLITER
Computes nonlinear analysis solution matrices and tables
1192
NSKIP Input/output-integer-no default.
On input: Subcase record number to read in CASECC.
On output: Set to -2 if run is to be fatally terminated.
LGDISP Input-integer-no default. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
NLFLAG Output-integer-default=0.
ITERID Input/output-integer-no default. Nonlinear analysis iteration count.
KMATUP Input/output-integer-default=1. Stiffness matrix update count within the
increment.
LSTEP Input/output-integer-default=0. Load step. The current iteration step at the
subcase level for static solutions.
KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive then
KTIME is the time remaining at the start of the stiffness update. If negative, no
stiffness update was done since the last exit from NLITER. KTIME still holds
the negative of the stiffness update time from the last stiffness update.
SOLCUR Input/output-integer-default=0. Nonlinear loop identification number.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
KFLAG Input/output-integer-default=1. Stiffness update flag. Set to -1 to update
stiffness before starting bisection. It reflects the NEWK and CONV status at the
last converged solution or stiffness update. See Remark 6.
NBIS Input/output-integer-default=0. Current bisection counter.
NORADMAT Input-integer-default=0. Radiation flag.
-2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
LASTCNMU Input/output-real-default=0.0. Last converged value of the arc-length load
factor.
SIGMA Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute
radiant heat flux.
ARCLG Input/output-real-default=1.0. The arc length at the last converged step.
Main Index
1193 NLITER
Computes nonlinear analysis solution matrices and tables
ARCSGN Input/output-integer-default=1. The sign of PDD P at the beginning of the
subcase. This is used in restarts in the post-buckling region.
TWODIV Input/output-integer-default=0. Nonlinear analysis divergence flag.
0 No previous divergence on this load step.
1 One previous divergence on this load step.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Rotation vector.
ITOPT Input-integer-default=0. Preconditioner method for iterative solver. See the
SOLVIT, 1428 module description.
ITSEPS Input/output-integer-default=0. Power of ten for convergence parameter epsilon
for iterative solution method. On output, set to 0 for convergence and 1 for no
convergence.
ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution
method.
PLSIZE Input/output-integer-default=0. Size of the load matrix. Compared to the size of
load matrix in the previous subcase in order to detect boundary condition
changes in the current subcase. Boundary condition changes are not allowed in
the arc-length method.
IPAD Input-integer-default=0. Padding level for reduced incomplete Cholesky
factorization. See the SOLVIT, 1428 module description.
IEXT Input-integer-default=0. Extraction level for reduced incomplete Coolest
factorization. See the SOLVIT, 1428 module description.
ADPCON Input-real-default=0.0. Contact penalty value. Scale factor for adjusting penalty
values on restart. Update penalty values if positive.
PBCONT Input-integer-default=0. Slideline contact flag.
NBCONT Output-integer-default=0. Number of bisections due to slideline contact.
GPFORCE Input-integer-default=-1. The number of columns in FENL. If GPFORCE less
than or equal to zero then no GPFORCE or ESE command is present.
GNLSTN Input-integer-default=0. Geometric nonlinear strain flag. Usually input by user
parameter.
0 Small strain.
1 Green strain.
UNUSED Input-integer-default=0. Unused.
K6ROT Input-real-default=0.0. Normal rotational stiffness factor for CQUAD4 and
CTRIA3 elements.
Main Index
NLITER
Computes nonlinear analysis solution matrices and tables
1194
Remarks:
1. NLITER updates the displacement vector for as many iterations as are necessary to attain an
equilibrium between the applied loads and the forces. NLITER calculates nonlinear forces and
follower forces which are used to obtain new displacements until a converged solution is found,
or a new stiffness matrix is necessary, or a bisection of the load step is necessary.
2. KGGNL is needed for the reduced incomplete Cholesky factorization in the iterative solver only.
Otherwise it may be purged.
3. MGG, RDEST, RECM are only required for heat transfer analysis. Otherwise they may be
purged.
4. ULLT is required only for unsymmetric stiffness. Otherwise it may be purged.
5. TABS is required for creep analysis.
6. KFLAG is further explained below:
-1 Solution had converged, but no stiffness update had been made or solution had
not converged, and a stiffness matrix update had been made. A new stiffness
matrix is required before starting bisection.
1 Solution had converged and a stiffness update had been made. No new stiffness
matrix is required before starting bisection.
Main Index
1195 NLRSLOOP
Prepare data for nonlinear restarts.
Prepare data for nonlinear restarts.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NLRSLOOP
Prepare data for nonlinear restarts.
NLRSLOOP CASECC,NLRSMAP0/
NLRSMAP/RSSUBC/RSSTEP/RSTIME/
S,N,SOLCURR/S,N,STEPCUR/S,N,SUBCUR/
S,N,STEPCURL/S,N,STIMER/S,N,NSKIPR/
S,N,SOLPREL/S,N,LOOPIDL/S,N,NEWSTEP/
S,N,STIMES $
CASECC Table of Case Control command images.
NLRSMAP0 Nonlinear restart map from the previous run.
NLRSMAP Nonlinear restart map from the restart step.
RSSUBC Input-integer-no default. Identification nunber of the previously executed subcase.
RSSTEP Input-integer-no default. Identification nunber of the previously executed step.
RSTIME Input-real-no default. Load factor (or time) of a previously executed load increment
in static analysis (or time step in transient analysis).
SOLCURR Output-integer-no default. Identification number of the output time step at the restart
point.
STEPCUR Output-integer-no default. Identification number of the STEP case at the restart
point.
SUBCUR Output-integer-no default. Identification number of the SUBCASE at the restart
point.
STEPCURL Output-integer-no default. Identification number of the previous STEP case from
the restart point.
STIMER Output-real-no default. Load factor (or time) at the restart point.
NSKIPR Output-integer-no default. Total STEP cases in previous subcases from the restart
point.
Main Index
NLRSLOOP
Prepare data for nonlinear restarts.
1196
SOLPREL Output-integer-no default. Last SOLCUR in the previous STEP case.
LOOPIDL Output-integer-no default. Last output loop identification number.
NEWSTEP Output-integer-no default. STEP case flag.
-1 Not a new STEP case.
1 New STEP case.
0 Cold start from the first SUBCASE, first STEP case and TIME=0.0.
STIMES Output-real-no default. Start time of the current STEP case.
Main Index
1197 NLRSMAP
Creates the nonlinear restart map
Creates the nonlinear restart map.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NLRSMAP
Creates the nonlinear restart map
NLRSMAP CASEXX,NLRSMAP0/
NLRSMAP/UNUSED/UNUSED/
STIMER/SOLCURR/STEPCUR/SUBCUR/
NSKIPR/SOLPREL/NEWSTEP/STIMES $
CASEXX Subset of CASECC for current STEP case.
NLRSMAP0 Nonlinear restart map from the previous run.
NLRSMAP Nonlinear restart map from the restart step augmented with the current
output time step.
UNUSED Input-integer-no default. Unused and may be unspecified.
STIMER Input-real-no default. Load factor (or time) at the restart point.
SOLCURR Input-integer-no default. Identification number of the output time step at the restart
point.
STEPCUR Input-integer-no default. Identification number of the STEP case at the restart point.
SUBCUR Input-integer-no default. Identification number of the SUBCASE at the restart
point.
NSKIPR Input-integer-no default. Total STEP cases in previous subcases from the restart
point.
SOLPREL Input-integer-no default. Last SOLCUR in the previous STEP case.
NEWSTEP Input-integer-no default. STEP case flag.
-1 Not a new STEP case.
1 New STEP case.
0 Cold start from the first SUBCASE, first STEP case and time=0.0.
STIMES Input-real-no default. Start time of the current STEP case.
Main Index
NLSOLV
Solves nonlinear static and transient response
1198
Solves nonlinear static and transient response with an adaptive time increment for a given iteration.
Format:
Input Data Blocks:
NLSOLV
Solves nonlinear static and transient response
NLSOLV CASEXX ,PPN ,YS ,ELDATA ,KELMNL ,
KPP ,GMNE ,MPT ,DIT ,KFEFE ,
DLT1 ,CSTM ,BGPDT ,SIL ,USETD ,
BFEFE ,MFEFE ,NLFT ,RDEST ,RECM ,
BPP ,GPSNT ,DITID ,DEQIND ,DEQATN ,
MPP ,MBSP ,MBFEP ,MMP ,GMFE ,
GMS ,RSPTQS ,RMPTQM ,GEOM4 ,KTPP ,
YVELO ,YACCE ,GPTT1 ,EPT ,TMLDS ,
ROTORT ,BGPP* ,KVCPP* /
UPN ,IFS ,ESTNLH ,IFP ,OESNL ,
PPL ,TEL ,MUPVNL ,MESTNL ,BTOPCNV ,
BTOPSTF ,OESNLB1 ,FMV ,QPV ,DUPV ,
RPV ,GEOM4CN ,KFRIC ,UNUSED1 ,UNUSED2 ,
UNUSED3 ,UNUSED4 ,LTF ,UTF ,PNLT ,
IFST ,PPLT ,UPNT ,FMVT ,ESTNL0 ,
MESTNL0 ,UPNL0 ,FENL1 /
KRATIO /S,N,CONV/S,N,STIME/S,N,NEWS/S,N,NEWK/
S,N,OLDDT/S,N,NSTEP/LGDISP/S,N,CONSEC/S,N,ITER
ID/
ITIME0
/S,N,KTIME/S,N,LASTUP/S,N,NOGONL/S,N,NBIS/
MAXLP /TSTATIC /LANGLE /NDAMP /TABS /
SIGMA /NORADMAT
/S,N,ADPCON/PBCONT/S,N,NBCONT/
CONT3D
/S,N,MNEWK/S,N,NLOFLAG/NLATYPE/FKSYMFAC/
RSTFLG /NLPACK /GPFORCE /GNLSTN /MSCHG /
K6ROT /WTMASS /TSTATIC $
CASEXX Subset of CASECC for current STEP case.
PPN Applied load vectors for nonlinear analysis in the p-set.
YS Matrix of enforced displacements.
ELDATA Table of combined nonlinear information data.
KELMNL Table of element matrices for stiffness for nonlinear elements.
KPP Stiffness matrix for the p-set, linear elements only.
GMNE Multipoint constraint transformation matrix, m-set by ne-set.
Main Index
1199 NLSOLV
Solves nonlinear static and transient response
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
KFEFE Tangential stiffness in fe-set.
DLT1 Table of dynamic loads updated for nonlinear analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
USETD Degree-of-freedom set membership table for the p-set.
BFEFE Damping matrix in the fe-set (or nonlinear tangential heat capacitance
matrix) for both linear and nonlinear elements in the fe-set.
MFEFE Mass (or radiation) matrix for the fe-set.
NLFT Nonlinear Forcing function table.
RDEST Radiation element summary table.
RECM Radiation exchange coefficient matrix.
BPP Damping (or heat capacitance) matrix for the p-set for linear elements
only.
GPSNT Grid point shell normal table.
DITID Table of identification numbers in DIT.
DEQIND Index table to DEQATN.
DEQATN Table of DEQATN Bulk Data entry images.
MPP Mass matrix in the p-set.
MBSP Updated mass matrix (s-set).
MBFEP Updated mass matrix (fe-set by p-set).
MMP Mass matrix (m-set by p-set).
GMS Multipoint constraint transformation matrix, m-set by s-set.
RSPTQS Matrix of updated initial SPCforces.
RMPTQM Matrix of updated initial MPCforces.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
KTPP Tangential Stiffness of p-set.
YVELO Matrix of enforced velocities.
YACCE Matrix of enforced accelerations.
GPTT1 Table of grid point temperatures (for transient analysis only).
EPT Table of Bulk Data entry images related to element properties.
TMLD Table of loads for nonlinear transient analysis.
Main Index
NLSOLV
Solves nonlinear static and transient response
1200
Output Data Blocks:
ROTORT Table of rotordynamics user input for transient analysis.
BGPP* Family of coriolis matrices - p-set.
KCVPP* Family of gyroscopic matrices - p-set.
UPN Solution matrix from nonlinear analysis in the p-set.
IFS Matrix of nonlinear element forces at constrained points at the output
time steps.
ESTNLH Nonlinear element summary table at converged step.
IFP Matrix of element forces at the previous time step.
OESNL1 Table of nonlinear element stresses in SORT1 format.
PPL Nonlinear load (applied and NOLINi) matrix appended from each
output time step.
TEL Transient response time output list appended from each subcase.
MUPN Solution matrix from nonlinear response analysis in the p-set for
matrix update.
MESTNL Nonlinear element summary table for matrix update.
BTOPOCNV Updated contact regions input information table.
BTOPOSTF Updated contact regions topological information table.
OESNLB1 Table of slideline contact element stresses in SORT1 format.
FMV Nonlinear element forces at m-set.
QPV Nonlinear constraint forces.
DUPV Displacment increment at the final iteration before exit.
RPV Load matrix (two columns) at the final iteration before exit.
GEOM4CN Updated constraints for 3D contact.
KFRIC Frictional stiffness for 3D contact.
UNUSEDi Unused and may be unspecified.
LTF Lower triangular file of the solution matrix UPN.
UTF Upper triangular file of the solution matrix UPN.
PNLT Nonlinear load matrix appended from each output time step (for
transient analysis only).
IFST Matrix of nonlinear element forces at constrained points at the output
time steps (for transient analysis only).
PPLT Nonlinear load (applied and NOLINi) matrix appended appended from
each output time step (for transient analysis only).
Main Index
1201 NLSOLV
Solves nonlinear static and transient response
UPNT Solution matrix from nonlinear analysis appended from each output
time step (for transient analysis only).
FMVT Nonlinear element forces at m-set appended from each output time
step (for transient analysis only).
ESTNL0 Nonlinear element summary table from previous time step.
MESTNL0 Initial nonlinear element summary table at each STEPcase.
UPNL0 Initial solution matrix from nonlinear analysis at each STEPcase.
FENL1 Matrix of strain energy and grid point force at every element at the last
converged load step
Main Index
NLSOLV
Solves nonlinear static and transient response
1202
Parameters:
KRATIO Input/output-complex-default=(1.,0.). Stiffness ratio to be used for time step
adjustment.
CONV Input/output-integer-default=0. Nonlinear analysis convergence flag. On input:
0 Initialization.
On output:
-1 Convergence has not been achieved.
1 convergence has been achieved.
STIME Input/output-real-default=0.0. On inital input, starting time step and on output,
accumulated time used for restarts.
NEWS Output-integer-default=0. New STEP case flag.
-1 Current STEP case has not been completed.
1 Current STEP case has been completed.
NEWK Input/output-integer-default=0. Stiffness update flag.
-1 Do not update stiffness.
>0 Update stiffness and represents the number of consecutive time steps
which have shown divergence. If this number reaches 5, the solution
process is terminated.
OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration
or time step to be used after the matrix update or subcase switch.
NSTEP Input/output-integer-default=0. Current time step position for the current STEP
case, set to 0 at the beginning of the STEP case.
LGDISP Input-integer-default=0. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
CONSEC Input/output-integer-default=0. A composite number equal to 10*(value of
NSTEP the last time MAXBIS was reached) + (the number of consecutive time
steps which have reached MAXBIS). If CONSEC=5, then solution process is
terminated.
ITERID Input/output-integer-default=0. Nonlinear analysis iteration count.
ITIME0 Input-real-default=0.0. Initial time step at the beginning of a current STEP case.
KTIME Input/output-integer-default=0. CPU time remaining. If KTIME is positive then
KTIME is the time remaining at the start of the stiffness update. If negative, no
stiffness update was done since the last exit from NLITER. KTIME still holds the
negative of the stiffness update time from the last stiffness update.
Main Index
1203 NLSOLV
Solves nonlinear static and transient response
LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update
at:
> Previous converged solution.
< At an intermediate iteration of the current time step.
=1 At the last iteration.
NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to
terminate.
NBIS Input/output-integer-default=0. Current bisection counter.
MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration
and the material subincrement processes.
TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and
damping forces.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Left rotation vector.
3 Right rotation vector.
NDAMP Input-real-default=0.0. Numerical damping.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant
heat flux.
NORADMAT Input-integer-default=0. Radiation flag.
-2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
ADPCON Input-real-default=1.0. Contact penalty value. Scale factor for adjusting penalty
values on restart. Update penalty values if positive.
PBCONT Input-integer-default=0. Slideline contact flag.
NBCONT Input/output-integer-default=0. Number of bisections due to slideline contact.
CONT3D Input-integer-default=-1. 3D contact flag.
<0 No.
>-0 Yes.
MNEWK Input/output-integer-default=1. Matrix update flag for 3D contact.
Main Index
NLSOLV
Solves nonlinear static and transient response
1204
NLOFLAG Input/output-integer-default=0. Output control flag.
On input:
<0 Print the title lines for iteration message and/or print the output-only
information before exiting.
>=0 Do not print the title lines for iteration message.
On output--output exit:
=0 No
>=1 Yes
NLATYPE Input-character-default=' '. Type of nonlinear analysis.
'NLTR' Nonlinear transient
'NLST' Nonlinear statics
'LNST' Linear statics
FKSYMFAC Input-real-default=1.0. Follower stiffness symmetry actor tolerance. Usually
input by user parameter.
RSTFLG Input-integer-default=-1. Restart flag.
<=0 Cold start
= 1 Restart
NLPACK Input-integer-default=-1. Nonlinear transient analysis append flag.
<=0 Append all output time steps together in each STEPcase before processing
the output procedure.
> 0 Append the value of NLPACK output time steps together in each
STEPcase before output procedure.
GPFORCE Input-integer-no default. The number of columns in FENL. If GPFORCE less
than or equal to zero then no GPFORCE or ESE command is present.
GNLSTN Input-integer-no default. Geometric nonlinear strain flag. Usually input by user
parameter.
0 Small strain
1 Green strain
MSCHG Input-integer-default=-1. Boundary condition change flag.
WTMASS Input-real-default=1.0. Scale factor on structural mass matrix.
TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and
damping forces.
Main Index
1205 NLTRD
Computes transient nonlinear analysis solution matrices and tables
Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural
analysis only.
Format:
Input Data Blocks:
NLTRD
Computes transient nonlinear analysis solution matrices
and tables
NLTRD CASECC,MESTNL,PDT,YS,KRDD,
ELDATA,KELMNL,LAM1DD,GM,MPT,
DIT,UAM1DD,DLT1,CSTM,BGPDT,
SIL,USETD,AM2,AM3,NLFT,
KSGG,DITID/
ULNT,IFG,ESTNLH,IFD,OESNL1,
PNL,TEL/
BETA/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/
S,N,OLDDT/S,N,NSTEP/LGDISP/S,N,CONSEC/S,N,ITER
ID/
S,N,MU/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/
S,N,NOTIME/MAXLP/UNUSED17/UNUSE18/UNUSE19/
TABS/LANGLE $
CASECC Table of Case Control command images.
MESTNL Nonlinear element summary table at current step.
PDT Dynamic load vectors for transient analysis in the d-set.
YS Matrix of enforced displacements or temperatures.
KRDD Combined linear and material nonlinear stiffness matrix in the d-set.
ELDATA Table of combined nonlinear information data.
KELMNL Table of element matrices for stiffness for nonlinear elements.
LAM1DD Lower triangular factor of the dynamic tangential matrix in the d-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
UAM1DD Upper triangular factor of the dynamic tangential matrix in the d-set.
DLT1 Table of dynamic loads updated for nonlinear analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
Main Index
NLTRD
Computes transient nonlinear analysis solution matrices and tables
1206
Output Data Blocks:
Parameters:
USETD Degree-of-freedom set membership table for the p-set.
AM2 Damping matrix in the d-set for linear elements multiplied by the
negative of the time step delta.
AM3 Combined mass and damping matrix multiplied the square of the
reciprocal of the time step delta and the reciprocal of twice the time
step delta, respectively.
NLFT Nonlinear Forcing function table.
KSGG S-set by f-set matrix and s-set by s-set partitions of the material
nonlinear stiffness matrix and expanded to g-set size.
DITID Table of identification numbers in DIT.
ULNT Solution matrix from nonlinear transient response analysis in the d-set.
IFG Matrix of nonlinear element forces for the g-set at the output time
steps.
ESTNLH Nonlinear element summary table at converged step.
IFD Matrix of nonlinear element forces at constrained points at the output
time steps.
OESNL1 Table of nonlinear element stresses in SORT1 format.
PNL Nonlinear load matrix appended from each output time step.
TEL Transient response time output list appended from each subcase.
BETA Input-complex-default=(.33333,0.0). Integration parameter.
CONV Input/output-integer-default=1. Nonlinear analysis convergence flag.
On input:
0 Initialization.
On output:
-1 Convergence has not been achieved.
1 Convergence has been achieved.
STIME Input/output-real-default=0.0. On initial input, starting time step and on output,
accumulated time used for restarts.
NEWP Output-integer-default=1. New subcase flag.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
Main Index
1207 NLTRD
Computes transient nonlinear analysis solution matrices and tables
NEWK Input/output-integer-default=1. Stiffness update flag.
-1 Do not update stiffness.
>0 Update stiffness and represents the number of consecutive time steps which
have shown divergence. If this number reaches 5, the solution process is
terminated.
OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration
or time step to be used after the matrix update or subcase switch.
NSTEP Input/output-integer-default=0. Current time step position for subcase, set to 0 at
the beginning of the subcase.
LGDISP Input-integer-no default. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
CONSEC Input/output-integer-default=0. A composite number equal to 10*(value of
NSTEP the last time MAXBIS was reached) + (the number of consecutive time
steps which have reached MAXBIS). If CONSEC=5, then solution process is
terminated.
ITERID Input/output-integer-no default. Nonlinear analysis iteration count.
MU Input/output-real-default=0.0. The magnitude of the last g-set displacement
matrix.
KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive then
KTIME is the time remaining at the start of the stiffness update. If negative, no
stiffness update was done since the last exit from NLITER. KTIME still holds the
negative of the stiffness update time from the last stiffness update.
LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update.
Set to 0 if the stiffness update is performed due to the CGAP element during the
iteration.
NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to
terminate.
NOTIME Output-integer-default=0. Time out flag. Set to 1 if there is no time left for further
iterations but enough time to perform data recovery.
MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration
and the material subincrement processes.
UNUSED17 Input-integer-default=0. Unused.
UNUSED18 Input-integer-default=0. Unused.
UNUSED19 Input-integer-default=0. Unused.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
Main Index
NLTRD
Computes transient nonlinear analysis solution matrices and tables
1208
Remarks:
1. NLTRD supports only METHOD="AUTO" and "TSTEP" on the TSTEPNL Bulk Data entry.
NLTRD2 supports only METHOD="ADAPT".
2. NLTRD does not support heat transfer, slideline contact, or shell normals. Use NLTRD2.
3. ULNT contains only displacement and velocity vectors at converged time steps during the direct
integration. However, upon completion of the subcase it also contains acceleration for the output
time steps.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Rotation vector.
Main Index
1209 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural or
transient heat transfer analysis.
Format:
Input Data Blocks:
NLTRD2
Computes transient nonlinear analysis solution matrices
and tables
NLTRD2 CASECC,PDT,YS,ELDATA,KELMNL,
KDD,GM,MPT,DIT,KBDD,
DLT1,CSTM,BGPDT,SIL,USETD,
BRDD,MDD,NLFT,RDEST,RECM,
BDD,GPSNT,DITID,DEQIND,DEQATN,
ROTORT,BGDD*,KCVDD*,TMLD,UNUSED1,UNUSED2,RDG,P
SFL/ ULNT,IFS,ESTNLH,IFD,OESNL1,
PNL,TEL,MULNT,MESTNL,BTOPCNV,
BTOPSTF,OESNLB1,MPTTC,LTF,UTF/
KRATIO/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/
S,N,OLDDT/S,N,NSTEP/LGDISP
/S,N,CONSEC/S,N,ITERID/
ITIME/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/S,N,NBI
S/ MAXLP/TSTATIC/LANGLE/NDAMP/TABS/
SIGMA/NORADMAT/S,N,ADPCON/PBCONT/
S,N,NBCONT/FKSYMFAC/WTMASS/NOUDCMP $
CASECC Table of Case Control command images.
PDT Dynamic load vectors for transient analysis in the d-set.
YS Matrix of enforced displacements or temperatures.
ELDATA Table of combined nonlinear information data.
KELMNL Table of element matrices for stiffness for nonlinear elements.
KDD Stiffness matrix for the d-set, linear elements only.
GM Multipoint constraint transformation matrix, m-set by n-set.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
KBDD Tangential stiffness in d-set.
DLT1 Table of dynamic loads updated for nonlinear analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
Main Index
NLTRD2
Computes transient nonlinear analysis solution matrices and tables
1210
Output Data Blocks:
USETD Degree-of-freedom set membership table for the p-set.
BRDD Damping matrix in the d-set for linear elements only or heat
capacitance matrix for both linear and nonlinear elements in the d-set.
MDD Mass (or radiation) matrix for the d-set
NLFT Nonlinear Forcing function table.
RDEST Radiation element summary table.
RECM Radiation exchange coefficient matrix.
BDD Damping (or heat capacitance) matrix for the d-set for linear elements
only.
GPSNT Grid point shell normal table.
DITID Table of identification numbers in DIT.
DEQIND Index table to DEQATN data block.
DEQATN Table of DEQATN Bulk Data entry images.
ROTORT Table of rotordynamics user input for transient analysis.
BGDD* Family of coriolis matrices.
KCVDD* Family of gyroscopic matrices.
TMLD Table of loads for nonlinear transient analysis.
UNUSED1 Unused and may be unspecified.
UNUSED2 Unused and may be unspecified.
RDG Reduction matrix from g-set to d-set (transposed).
PSFL Loads due to enforced motion on linear elements in nonlinear transient
analysis.
ULNT Solution matrix from nonlinear transient response analysis in the d-set.
IFS Matrix of nonlinear element forces at constrained points at the output
time steps.
ESTNLH Nonlinear element summary table at converged step.
IFD Matrix of nonlinear element forces at constrained points at the output
time steps.
OESNL1 Table of nonlinear element stresses in SORT1 format.
PNL Nonlinear load matrix appended from each output time step.
TEL Transient response time output list appended from each subcase.
MULNT Solution matrix from nonlinear transient response analysis in the d-set
from the previous subcase.
Main Index
1211 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
Parameters:
MESTNL Nonlinear element summary table at current step.
BTOPOCNV Updated contact regions input information table.
BTOPOSTF Updated contact regions topological information table.
OESNLB1 Table of slideline contact element stresses in SORT1 format.
MPTTC MPT table updated for thermal control mechanisms.
LTF Lower triangular file of the solution matrix ULNT.
UTF Upper triangular file of the solution matrix ULNT.
KRATIO Input/output-complex-default=(1.,0.). Stiffness ratio to be used for time step
adjustment.
CONV Input/output-integer-default=1. Nonlinear analysis convergence flag.
On input:
0 Initialization.
On output:
-1 Convergence has not been achieved.
1 Convergence has been achieved.
STIME Input/output-real-default=0.0. On initial input, starting time step and on output,
accumulated time used for restarts.
NEWP Output-integer-default=1. New subcase flag.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
NEWK Input/output-integer-default=1. Stiffness update flag.
-1 Do not update stiffness.
>0 Update stiffness and represents the number of consecutive time steps which
have shown divergence. If this number reaches 5, the solution process is
terminated.
OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration
or time step to be used after the matrix update or subcase switch.
NSTEP Input/output-integer-default=0. Current time step position for subcase, set to 0 at
the beginning of the subcase.
LGDISP Input-integer-no default. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
Main Index
NLTRD2
Computes transient nonlinear analysis solution matrices and tables
1212
CONSEC Input/output-integer-default=0. A composite number equal to 10*(value of
NSTEP the last time MAXBIS was reached) + (the number of consecutive time
steps which have reached MAXBIS). If CONSEC=5, then solution process is
terminated.
ITERID Input/output-integer-no default. Nonlinear analysis iteration count.
ITIME Input-real-default=0.0. Initial time step at the beginning of a subcase.
KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive then
KTIME is the time remaining at the start of the stiffness update. If negative, no
stiffness update was done since the last exit from NLITER. KTIME still holds the
negative of the stiffness update time from the last stiffness update.
LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update.
Set to 0 if the stiffness update is performed due to the CGAP element during the
iteration.
NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to
terminate.
NBIS Input/output-integer-default=0. Current bisection counter.
MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration
and the material subincrement processes.
TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and
damping forces.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Rotation vector.
NDAMP Input-real-default=0.0. Numerical damping.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute radiant
heat flux.
NORADMAT Input-integer-default=0. Radiation flag.
-2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
ADPCON Input-real-default=0.0. Contact penalty value. Scale factor for adjusting penalty
values on restart. Update penalty values if positive.
PBCONT Input-integer-default=0. Slideline contact flag.
Main Index
1213 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
Remarks:
1. NLTRD2 utilizes an automatic method of time integration to compute solutions to nonlinear
transient problems (METHOD="ADAPT" on the TSTEPNL Bulk Data entry). NLTRD2
performs the time increment and the vector iteration steps until convergence has been attained.
NLTRD2 uses line search and quasi-Newton vector techniques when appropriate.
2. NLTRD2 supports only METHOD="ADAPT". NLTRD supports only METHOD="AUTO" and
"TSTEP" on the TSTEPNL Bulk Data entry.
3. ULNT contains only displacement and velocity vectors at converged time steps during the direct
integration. However, upon completion of the subcase it also contains acceleration for the output
time steps. For thermal analysis, the displacements, velocity and accelerations are temperature,
enthalpy, and the enthalpy time derivative.
NBCONT Input/output-integer-default=0. Number of bisections due to slideline contact.
FKSYMFAC Input-real-default=0.0. Follower stiffness symmetry factor tolerance. Usually
input by user parameter.
WTMASS Input-real-default=0.0. Scale factor on structural mass matrix.
NOUDCMP Input-integer-default=-1. Solution matrix decomposition flag. Usually input by
user parameter.
-1 Solution matrix will be decomposed.
1 Solution matrix will not be decomposed.
Main Index
NLTRLG
Produces time independent load vector
1214
Produces time independent components of the nonlinear transient load vector.
Format:
Input Data Blocks:
NLTRLG
Produces time independent load vector
NLTRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,GM
D,GOD,
PHDH,EST,MPT,APPLOD,ENFLODK,ENFLODB,ENFLODM,EN
FMOTN/
PDT,TMLD,DLT1/TABS $
CASECC Table of Case Control command images.
USETD Degree-of-freedom set membership table for p-set.
DLT Table of dynamic loads.
SLT Table of static loads.
BGPDT Basic grid point definition table.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
TRL Transient response list.
DIT Table of TABLEij Bulk Data entry images.
GMD Multipoint constraint transformation matrix with extra points, m-set by
ne-set.
GOD Omitted degree-of-freedom transformation matrix with extra points, o-
set by d-set.
PHDH Transformation matrix from d-set to h-set (modal).
EST Element summary table.
MPT Table of Bulk Data entry images related to material properties.
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness
effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous
damping effects
Main Index
1215 NLTRLG
Produces time independent load vector
Output Data Blocks:
Parameter:
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass
effects
ENFMOTN Matrix of enforced motion amplitudes
PDT Transient response load matrix in the d-set for output time steps.
TMLD Table of loads for nonlinear transient analysis.
DLT1 Table of dynamic loads updated for nonlinear analysis.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
Main Index
NORM
Normalize a matrix
1216
To normalize a matrix, each column by its largest element or compute the square root of the sum of the
squares for each row of a matrix (SRSS).
Format:
Input Data Block:
Output Data Block:
Parameters:
Remarks:
1. If IOPT=1 then ANORM is the same as A except each column has been normalized by its
maximum absolute value.
2. If IOPT=2 then ANORM is a column vector where the i-th row is the sum of the magnitudes of
the terms in the i-th row of A.
NORM
Normalize a matrix
NORM A/ANORM/S,N,NCOL/S,N,NROW/S,N,XNORM/IOPT/
S,N,XNORMD/PRTSWM $
A Any matrix (real or complex).
ANORM Normalized matrix.
NCOL Number of columns in A.
NROW Integer-output-default=0. Number of rows in A.
XNORM Real-output-default=0.0. Maximum absolute normalizing value over all columns.
IOPT Integer-input-default=1. Normalization option.
1 Normalize by largest element.
2 Compute SRSS.
XNORMD Real double precision-output-default=0.D0. Same as XNORM except in double
precision.
PRTSWM Logical-input-default=TRUE. If PRTSUM=FALSE, System Warning Message
6991 is suppressed. This message is printed when the maximum term exceeds the
single precision limit for the machine type. When it is TRUE the message is printed.
Main Index
1217 NORM
Normalize a matrix
Examples:
1. Normalize PHIG so that the maximum deflection is 1.0 (or -1.0):
NORM PHIG/PHIG1 $
2. Compute complex eigenvectors that have been normalized such that the product
produces a square matrix with off-diagonal terms of computational zero, and
complex diagonal terms whose magnitude is unity.
TRNSP CPHG/CPHGT $
NORM CPHGT/CX2////2 $
MATMOD CX2,,,,,/INORM22,/28 $ DIAGONALIZE
DIAGONAL INORM22/NORM22/'WHOLE'/-1.0 $ INVERT
MPYAD CPHG,NORM22,/CPHGNORM $ NORMALIZE
MPYAD CPHGNORM,CPHGNORM,/N22/1 $ SHOULD BE IDENTITY IN
MAGNITUDE
DIAGONAL N22/N22MAG/'WHOLE'/1.0 $ FIND MAGNITUDES
CPHG | |
T
CPHG | |
Main Index
NSMEPT
Modifies element properties
1218
Modifies element properties table from the NSML and NSML1 records.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
NSMEPT
Modifies element properties
NSMEPT ECT,EPT,BGPDT/NEWEPT/S,N,NEWEPT $
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
BGPDT Basic grid point definition table.
NEWEPT EPT updated from the NSML and NSML1 records.
NEWEPT Output-integer-default=0. NEWEPT creation flag.
0 No.
-1 Yes.
Main Index
1219 OFP
Output file processor
To output (print or punch) data blocks prepared by other modules in user-oriented, self-explanatory
formats.
Format:
Input Data Blocks:
Output Data Blocks:
None.
OFP
Output file processor
OFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,
CSTM,BGPDTVU,ERROR1,DEQATN,DEQIND,DIT,UNUSED//
UNUSED/ODCODE/PVALID/OCID $
OFPi Output table suitable for processing by the OFP module. See Remark
2.
CSTM Table of coordinate system transformation matrices.
EHT Element hierarchical table for p-element analysis.
BGPDTVU Basic grid point definition table for a superelement and related to
geometry with view-grids added.
ERROR1 Error-estimate table updated for current superelement or adaptivity
loop.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DIT Table of TABLEDi Bulk Data entry images.
UNUSED Unused and may be left unspecified.
Main Index
OFP
Output file processor
1220
Parameters:
Remarks:
1. Any or all data blocks may be purged.
2. DMAP modules READ (LAMA, OEIGS, LAMX, CLAMX), CEAD (CLAMA and OCEIGS),
and LAMX (LAMB) are matrix operation modules that prepare OFP formatted data blocks.
Modules SDR2, SDR3, VDR, ADR, CURV, DDRMM, DRMH3, ELFDR, GPFDR, GPWG,
LAMX, MDATA, SDRCOMP, SDRX, and SDRHT also prepare OFP formatted data blocks.
3. Parameter ODCODE is not honored by data blocks LAMA, OEIGS, LAMX, CLAMA, and
OGPWG, which are created by READ, CEAD, LAMX, and GPWG.
4. CSTM, EHT, BGPDTVU, and ERROR1 are required if p-elements are specified and only for data
recovery; i.e., displacement, stress, strain, etc.
UNUSED Input/output-integer-default=0. Unused and may be left unspecified.
ODCODE Input-integer-default=-1. Output device code override. See Remark 4. ODCODE
overrides the code stored in the DBi's according to the following table:
ODCODE Output Directed to:
1 Print
2 Plot
3 Print and Plot
4 Punch
5 Print and Punch
6 Plot and Punch
7 Print, Plot, and Punch
PVALID Input-integer-default=0. p-element adaptivity loop identification number.
OCID Input-integer-default=0. Print flag for coordinate system identification number
in grid point output. The following bits in OCID are set to 1 based on user output
requests.
1 Displacements.
2 Applied loads.
3 Apcforces and mpcforces.
7 Eigenvectors.
10 Velocities.
11 Accelerations.
Main Index
1221 OFP
Output file processor
5. CSTM, DEQATN, DEQIND, and DIT are required if the CORD3G Bulk Data entry is present
and only for element data recovery; i.e., displacement, stress, strain, etc.
Example:
Print the OUG1 table from the SDR2 module:
OFP OUG1/ $
Main Index
OPTGP0
p-element analysis preprocessor
1222
Preprocesses the input design optimization shape basis vectors for p-element analysis.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
OPTGP0
p-element analysis preprocessor
OPTGP0 GEOM1M,GEOM2M,MEDGE,EDOM,UNUSED5,UNUSED6,UNUSE
D7,
DEQATN,DEQIND/
EDOMM/
DELG $
GEOM1M Table of Bulk Data entry images related to geometry and updated for
the current p-level.
GEOM2M Table of Bulk Data entry images related to element connectivity and
scalar points and updated for the current p-level.
MEDGE Edge table for p-element analysis.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization.
UNUSED5 Unused and may be purged.
UNUSED6 Unused and may be purged.
UNUSED7 Unused and may be purged.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
EDOMM Table of Bulk Data entries related to design sensitivity and
optimization updated for p-element analysis.
DELG Input-real-default=0.1. Scale factor on perturbed length.
Main Index
1223 OPTGP0
p-element analysis preprocessor
Remark:
OPTGP0 preprocesses the shape basis vectors defined at the p-element geometry level for both the
GMCURV or POINT option and generates DVGRID entry images at the grid-n points (a point on an
FEEDGE, FEFACE or FEBODY entity with variable number of degrees-of-freedom).
Main Index
ORTHOG
Generates orthonormal set of vectors
1224
Generates an orthonormal set of vectors from a given set of vectors. For example, orthogonalize with
respect to an identity matrix or mass matrix.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ORTHOG
Generates orthonormal set of vectors
ORTHOG A,M/
Q,R/
ORTHOPT/ORTHCON/S,N,ORTHEPS/ORTHREPT/ORTHTOL $
A Rectangular matrix of m columns (vectors) by n rows to be
orthogonalized where m<n.
M Weighting matrix: symmetric and positive definite.
Q Rectangular matrix of orthogonalized vectors.
R Rectangular matrix whose m by m upper triangle contains an
intermediate factor of the process.
ORTHOPT Input-integer-default=1. Orthogonalization method.
1 and M is purged, then perform Householder Orthogonalization.
2 or M is not purged, then perform Matrix Modified Gram-Schmidt method.
If ORTHOPT=2 and M is purged then an identity matrix will be created for
M.
ORTHCON Input-integer-default=1. Matrix Modified Gram-Schmidt termination flag or
Householder partitioning vector generation flag.
For Householder:
0 R contains the upper triangular matrix.
1 R contains the partitioning vector.
For Matrix Modified Gram-Schmidt termination:
0 Exit the program if M is not at least a positive semi-definite matrix.
R is not used and may be purged.
Main Index
1225 ORTHOG
Generates orthonormal set of vectors
Remark:
1. ORTHOG generates an orthonormal set of vectors from a given set of vectors [A] such that:
and if ] is not given:
or if is not given:
where is an identity matrix.
2. ORTHOG cannot orthogonalize complex matrices. If a complex matrix is input then a fatal
message is issued. SubDMAP ONORM can orthogonalize complex matrices which is described
under "General Enhancements for Orthogonalizing Complex Vectors" on page 149 of the
MSC.Nastran 2004 Release Guide.
1 Let and continue if is not at least a positive semi-definite
matrix. contains the partitioning vector
ORTHEPS Output-real-no default. Level of orthogonality. ORTHEPS is the largest lower
triangular term of the matrix R and is computed with the Householder method.
ORTHREPT Input-real-default=0.707. Matrix Modified Gram-Schmidt algorithm repeat flag.
The default is approximately the square root of 0.5.
ORTHTOL Input-real-default=0.0. Linear dependence tolerance. By default, ORTHTOL is
set to the square root of the minimum machine value.
R
ii
R
i i
= M
R
Q | |
A | | Q | | R | | =
M | | Q | |
T
M | | Q | | I | | =
M | | Q | |
T
Q | | I | | =
I | |
Main Index
OUTADF
Output Frequency Response Result to ADF Format File
1226
Output the frequency response functions and participation factors to ADF format file.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. This module support the output table block of OUGx, OSMPF1, OAFMPF1, OASMPF1,
OAPMPF1, OAPPF1, OAGPF1 and OSPPF1 (TCODE=1, 10, 11 and 61 to 67).
2. OFPi may be purged.
3. If CASECC is purged, all supported result data in OFPi will output.
4. See the parameter POSTADF for the other information.
OUTADF
Output Frequency Response Result to ADF Format File
OUTADF OFP1,OFP2,OFP3,OFP4,OFP5,UNITS,BGPDT,CASECC//IPRINT $
OFPi Output table suitable for processing. See Remark 2.
UNITS Table of units. Usually input by the user via DTI Bulk Data entries.
BGPDT Basic grid point definition table.
CASECC Table of Case Control command images. See Remark 3.
None
IPRINT Input-integer-default=0. Message print control flag. If IPRINT<>0, then the
detailed output message is printed; 0, otherwise.
Main Index
1227 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
Constructs partitioning vectors to be used in sparse load reduction and sparse data recovery.
Format:
Input Data Blocks:
OUTPRT
Constructs sparse load reduction and sparse data recovery
partitioning vectors
OUTPRT CASECC,ECT,BGPDT,SIL,XYCDB,DYNAMIC,MATPOOL,PG,
VGFD,
CASEDS,TABEVP,TABEVS,MMCDB,OINT,PELSET,EDT/
PVGRID,PVSPC,PVMPC,PVLOAD,PVMCFR/
S,N,SDRMETH/NOSE/SDROVR/SDRDENS/ADPTINDX/ADPTE
XIT $
CASECC Table of Case Control command images.
ECT Element connectivity table.
BGPDT Basic grid point definition table.
SIL Scalar index list.
XYCDB Table of x-y plotting commands.
DYNAMIC Table of Bulk Data entry images related to dynamics.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries.
PG Static load matrix applied to the g-set.
VGFD Partitioning vector with ones at rows corresponding to degrees-of-freedom
connected to frequency-dependent elements.
CASEDS Case control table for the data recovery of design responses.
TABEVP Cross-reference table between ESTDVP records and element and design variable
identification numbers.
TABEVS Cross reference table between ESTDVS records and element and design variable
identification numbers.
MMCDB Table of MAXMIN(DEF) specifications.
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
PELSET p-element set table, contains SETS DEFINITIONS.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics, p-
element analysis, divergence analysis, and the iterative solver. This module is
processes MONPNT3 and SET1 records only.
Main Index
OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
1228
Output Data Blocks:
Parameters:
PVGRID Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the following
Case Control commands:
DISPLACEMENT, VELOCITY, ACCELERATION, FORCE,
STRESS, STRAIN, SPCFORCE, MPCFORCE, MPRES, GPFORCE,
ESE, EKE, EDE, GPKE.
PVSPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the SPCFORCE
Case Control command.
PVMPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the MPCFORCE
Case Control command.
PVLOAD Partitioning vector with ones at rows corresponding to degrees-of-
freedom at which static and dynamic loads are applied.
PVMCFR Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
MCFRACTION Case Control command.
SDRMETH Output-integer-no default. Data recovery method flag:
-1 Sparse data recovery.
0 Full (or standard) data recovery.
1 No data recovery is requested or required.
NOSE Input-integer-default=0.
Set to -1 if there are no superelements; 0 otherwise. Superelement presence
flag.
SDROVR Input-character-default='AUTO'. Override for data recovery method flag,
SDR:
AUTO Choose full or sparse data recovery based on SDRDENS.
FULL Choose full data recovery.
SPARSE Choose sparse data recovery.
SDRDENS Input-integer-default=0. Sparse data recovery ceiling density. If the density of
PVGRID is greater than SDRDENS divided by 100, then choose full data
recovery.
Main Index
1229 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
ADPTINDX Input-integer-default=-1. P-version analysis adaptivity index.
ADPTEXIT Input-logical-default=FALSE. Set to TRUE if this is the final adaptivity loop.
Main Index
OUTPUT2
Output a table or matrix into a FORTRAN readable file
1230
Writes a table or matrix data block(s) onto a binary or "compressed ASCII" (or neutral) file for user
postprocessing or for subsequent input (via INPUTT2) into another MSC Nastran run.
Format:
Input Data Blocks:
Parameters:
OUTPUT2
Output a table or matrix into a FORTRAN readable file
OUTPUT2 DB1,DB2,DB3,DB4,DB5,CASECC//
ITAPE/IUNIT/LABL/MAXR/
NDDLNAM1/NDDLNAM2/NDDLNAM3/NDDLNAM4/NDDLNAM5/
HNAME1/HNAME2/HNAME3/HNAME4/HNAME5/PROCID $
DBi Any data block (table or matrix) name to be output. DBi cannot be a
factor matrix (forms 4, 5, 10, 11, 13, and 15). Any or all of the input
data blocks may be purged.
CASECC Table of Case Control command images, specifically for POST
command processing.
ITAPE Input-integer-default=0. ITAPE is used to select the file positioning option as
follows:
+n Skip forward n data blocks before writing (only used if file has no label).
0 Data blocks are written starting at the current position. If this is the first
use, no label is written.
-1 Rewind IUNIT before writing and label file.
-3 Rewind IUNIT, print data block names and then write after the last data
block on IUNIT (file must have a label).
-9 Write a final EOF on IUNIT (must be used before -3 option and as last
I/O use of unit) then rewind IUNIT.
IUNIT Input-integer-no default. IUNIT is the FORTRAN unit number on which the
data blocks are to be written. IUNIT=0 is not recommended. See Remark 7.
LABL Input-character-default = 'XXXXXXXX'. LABL is used for file identification.
The label is written only if ITAPE=-1 and is checked only if ITAPE=-3.
MAXR Input-integer-default=2 * BUFFSIZE words. Maximum physical record size.
(See Remarks.)
Main Index
1231 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Remarks:
1. A data block (table or matrix) consists of logical records:
In matrices, each column is contained in one logical record. Each record begins with the row
position of the first nonzero term in the column followed by the first through the last nonzero
term in the column.
In tables, the contents of logical records vary according to the table but are described in Data
Blocks (Ch. 2).
2. The FORTRAN binary file consists of physical records of data from the data block and KEYs that
are provided to assist in the reading of the file. Each physical record of data is separated by one-
word records called KEYs. The KEYs will indicate one of the following depending on its location
in the binary file:
3. The End-of-Data (EOD) follows the last end-of-file (data block) written to the binary file.
4. If possible, each logical record of the data block will be written to one physical record of the
FORTRAN binary file. However, the length of a logical record may exceed the maximum length
of a physical record (see MAXR parameter). If this occurs, then the logical record will span more
than one physical record. In other words, the logical record will be written to the first physical
record followed by a positive KEY record, which indicates a continuation of the logical record
and the length of the subsequent second physical record.
5. The OUTPUT4 module performs similar operations on matrices, but not tables. It is simpler to
use and is the recommended method for matrix output.
6. Tables and matrices may be processed as sequential data blocks.
NDDLNAMi Input-character-default=blank. NDDL names corresponding to DB1 through
DB5. If DBi is a matrix, then the corresponding NDDLNAMi is 'MATRIX'.
(See Remarks.)
HNAMEi Output-character-default= . Data block name to written into the header for
DBi on the FORTRAN unit.
PROCID Input-integer-default=1. Processor ID which is authorized to write to IUNIT.
Used only in distributed memory parallel (DMP) runs.
KEY Description
>0
The length of the next physical record. It may also indicate the start of a new
logical record.
0 End-of-File (data block) (EOF) or End-of-Data (EOD).
<0
End-of-Logical record (EOR) or a null column. The absolute value indicates
the logical record number.
Main Index
OUTPUT2
Output a table or matrix into a FORTRAN readable file
1232
7. The ASSIGN (p. 42) in the MSC Nastran Quick Reference Guide FMS statement is recommended
for assigning the FORTRAN unit. Selection of a proper value for IUNIT is machine dependent.
Refer to the Making File Assignments (p. 88) in the MSC Nastran 2012 Installation and
Operations Guide.
8. No physical record will exceed the value specified by the parameter MAXR which has a default
that is two times BUFFSIZE words. Furthermore, the value specified for MAXR should not
exceed the maximum allowable record size for the receiving disk device. See the Keywords and
Environment Variables (p. 45) in the MSC Nastran 2012 Installation and Operations Guide for
the maximum allowable values.
9. When the neutral format option is selected via FORM=FORMATTED on the ASSIGN FMS
statement (associated with OUTPUT2 parameter IUNIT), then MAXR and NDDLNAMi are
interpreted as follows:
The following is a partial list of the table data block names available for OUTPUT2 neutral file
formatting. For a more complete list see the NDDL.
In addition, all matrices defined with a TYPE DB, may also be neutral formatted. If a matrix is
not an NDDL data block, then the NDDLNAMi='MATRIX' should be used. For example, to write
the matrix MYMATRIX use
OUTPUT2 MYMATRIX,,,,//ITAPE/IUNIT/LABL/MAXR/'MATRIX' $
MAXR Represents the maximum physical record size (in words) on the target
machine(s) for the machine binary-formatted file after it has been
converted from neutral to binary via the MSC-supplied conversion
utility RCOUT2.
NDDLNAMi Correlates the DMAP data block name with the corresponding NDDL-
defined name. If this parameter is left blank, then the corresponding
DMAP name (DB1 through DB5) is assumed to be the NDDL-defined
name.
AXIC GEOM1 GPLS OEIGS OESNL2 OQG2
CASES GEOM1Q LAMA OEP OESNLX OSTR1
CLAMA GEOM2 MATPOOL OES1 OGPWG OSTR2
CSTMS GEOM2S MPT OES1C OGS1 OUGV1
DIT GEOM3 MPTS OES1X OPG1 OUGV2
DYNAMICS GEOM3S OEF1 OES1X1 OPG2 PSDF
EPT GEOM4 OEF1X OES2 OPNL1 PVT
EPTS GEOM4S OEF2 OESNL1 OQG1 USET
FOL GPDTS
Main Index
1233 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Note and the neutral format is a machine-neutral format that allows the transfer of the OUTPUT2-
generated files between different machine types. See RCOUT2 (p. 223) in the MSC Nastran 2012
Installation and Operations Guide for a discussion of this transfer process and the MSC-supplied
conversion utility RCOUT2.
10. The following formats describe each physical record. Note that the following formats depend on
the value of system cell 403 (NASTRAN statement keyword OP2NEW).
Format for Table and Matrix Labels (written only if ITAPE=-1)
Physical
Record
Number Length Contents Description
1 1 KEY = 3
2 KEY
Date (3 words, month-day-year) --
integer
3 1 KEY = 7
4 KEY
NASTRAN Header (7 words*,
Character-A4)
One Logical Record
*Word 1 = NAST, Word 2 = RAN, Word 3 = FORT, Word 4 = TAP, Word 5 = EID, Word 6 = COD,
Word 7 = E
5 1 KEY = 2
6 KEY
LABEL (2 words, Character-A4 =
LABL)
If OP2NEW = 0:
7 1 KEY = -1 (EOR)
8 1 KEY = 0 (EOF) End of Label
If OP2NEW = 1:
7 1 KEY = 3
8 KEY
Nastran Program Version (3 words,
Major, Minor, Round, Character A4)
9 1 KEY = -1 (EOR)
10 1 KEY = 0 (EOF)
Main Index
OUTPUT2
Output a table or matrix into a FORTRAN readable file
1234
Format for Tables and Matrices if OP2NEW = 0
SYM 0 >
A | |
A11 A12
SYM 0 <
A | |
A11 A12
A21 A22
SYM 0 >
A | |
A11 A12
A21 A22
Main Index
1269 PARTN
Matrix partition
2. Any or all output data blocks may be purged.
3. If [A] is purged, PARTN will cause all output data blocks to be purged.
4. If {CP} is purged, [A] is partitioned as follows:
5. If {RP} is purged and , [A] is partitioned as follows:
6. If {RP} is purged and , [A] is partitioned as follows:
where {CP} is used as both the row and column partitioner.
7. {RP} and {CP} cannot both be purged.
8.
Let [A] be an m by n matrix, {CP} be an nx1 vector containing q zero elements; and {RP} be a
mx1 vector containing p zero elements.
Partition [A11] will consist of all elements Aij of [A] for which CPj = RPi = 0.0 in the same order
as they appear in [A].
Partition [A12] will consist of all elements Aij of [A] for which and RPi = 0.0 in the
same order as they appear in [A].
Partition [A21] will consist of all elements Aij of [A] for which CPj = 0.0 and in the
same order as they appear in [A].
9. The default action for F11, F21, F12, and F22 allows the program to automatically select the
appropriate form.
Examples:
1. Let [A], {CP} and {RP} be defined as follows:
A | |
A11
A21
SYM 0 >
SYM 0 <
A | |
A11 A12
A21 A22
A | |
A11 A12
A21 A22
CPj 0.0 =
RPi 0.0 =
A | |
1.0 2.0 3.0 4.0
5.0 6.0 7.0 8.0
9.0 10.0 11.0 12.0
=
Main Index
PARTN
Matrix partition
1270
Then, the DMAP instruction
PARTN A,CP,RP/A11,A21,A12,A22/1 $
will create the real matrices:
2. If, in Example 1, the DMAP instruction was written as
PARTN A,CP,/A11,A21,A12,A22/1 $ RP,CP distinct
the resulting matrices would be
3. If, in Example 1, the DMAP instruction was written as
PARTN A, ,RP/A11,A21,A12,A22/1 $
CP { }
1.0
0.0
1.0
1.0
)
`
=
RP { }
0.0
0.0
1.0
=
A11 | |
2.0
6.0
F11 2 = , = A12 | |
1.0 3.0 4.0
5.0 7.0 8.0
F12 2 = , =
A21 | |
10.0
F11 2 = , = A22 | |
9.0 11.0 12.0
F22 2 = , =
A11 | |
2.0
6.0
10.0
= A12 | |
1.0 3.0 4.0
5.0 7.0 8.0
9.0 11.0 12.0
=
A21 | | purged = A22 | | purged =
Main Index
1271 PARTN
Matrix partition
the resulting matrices would be
4. If and the DMAP instruction was written as
PARTN A,RP,/A11,A21,A12,A22/-1 $
then the resulting partitions would be
A11 | |
1.0 2.0 3.0 4.0
5.0 6.0 7.0 8.0
=
A12 | | purged =
A21 | |
9.0 10.0 11.0 12.0
=
A22 | | purged =
A | |
1 2 3
5 6 7
9 10 11
=
1 2 3
5 6 7
9 10 11
A11 A12
A21 A22
Main Index
PCOMB
Combines static loads from upstream superelements
1272
Combines static loads from upstream superelements and the residual structure based on the CLOAD Bulk
Data entry.
Format:
Input Data Blocks:
Output Data Blocks
:
Parameters:
PCOMB
Combines static loads from upstream superelements
PCOMB CASECC,EDT,SLT,PGUP,PJ/
CVECT,PG1/
NSKIP/S,N,NVECT/MODE $
CASECC Table of Case Control command images.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
SLT Table of static loads.
PGUP Static load matrix for the g-set and in the residual structure due to static
loads in upstream superelements only.
PJ Static load matrix for the g-set of the residual structure and applied to
its interior points only.
CVECT Load combination factor matrix.
PG1 Combined static load matrix for the g-set and in the residual structure.
NSKIP Input-integer-default=0. Subcase record number to read in CASECC.
NVECT Output-integer-default=0. Number of columns in CVECT and PG1.
MODE Input-character-no default. Boundary condition change ignore flag. See Remark
2.
NONLINEAR Ignore boundary condition changes.
STATICS Do not ignore boundary condition changes.
Main Index
1273 PCOMB
Combines static loads from upstream superelements
Remarks:
1. Any input data block except CASEXX may be purged.
2. If MODE='STATICS' all records of CASECC, beginning at the NSKIP-th record, are processed
until a boundary change occurs.
Main Index
PCOPY
Tests parallel copy
1274
Tests parallel copy in a parallel GINO environment on a multiprocessing machine.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remark:
PCOPY is a reserved for MSC development purposes and should not be used.
PCOPY
Tests parallel copy
PCOPY INDB/
OUTDB1,OUTDB2,OUTDB3,OUTDB4,OUTDB5,OUTDB6,OUTD
B7,
OUTDB8/
PCOPY1/PCOPY2 $
INDB Any table or matrix.
OUTDBi Copies of INDB.
PCOPY1 Input-integer-default=-1. Execute parallel copy flag.
<
0
Perform copy.
>
0
Do not perform copy.
PCOPY2 Input-integer-default=1. Parallel copy method.
>
0
Perform standard copy using CPYFIL.
<
0
Perform copy using single buffer for input and output.
Main Index
1275 PFCALC
Participation factors for structure and acoustic applications
Computes the modal contribution factors (MCF) for the structure or the modal participation factors for
the fluid based upon PFMODE, PFPANEL and PFGRID Case Control commands.
Format:
Input Data Blocks:
PFCALC
Participation factors for structure and acoustic applications
PFCALC CASECC,BGPDT,OL,RXS,UXFS,LAMAS,LAMAF,UXFF,MFXX,BFXX,KF
XX,PNLLST,RWXS,RXF,AXX,AXW,VGW,ABEH*,
PFXF,UBRS,UBRF,UBWS,APXW*,MSXX,BSXX,KSXX,PXS,
UBWF,APYW*, QFRQV*,QSXX*,QFXX*,QAXX*,QABEH*,QABEF*,
QABES*,QAXW*/ SMPF,SMPFD,OSMPF1,AFMPF,AFMPFD,OAFMPF1,
ASMPF,ASMPFD, OASMPF1,APMPF1,APMPFD,OAPMPF1,APPF,
APPFD,OAPPF1,AGPF, AGPFD,OAGPF1,SPPF,SPPFD,OSPPF1/
FS/APP/SOLTYPS/SOLTYPF/NOACTRM $
CASECC Table of Case Control command selections.
BGPDT Basic grid point definition table.
OL Complex or real eigenvalue summary table, transientresponse time output list or
frequency responsefrequency output list.
RXS Transformation matrix from h-set or d-set to physical responseson the structure.
Only contains the rows corresponding to those selected on the PF* Case Control
command.
UXFS Solution matrix from dynamic analysis in d- or h-set on the structure.
LAMAS Normal modes eigenvalue summary table for the structural portion of the model.
LAMAS Normal modes eigenvalue summary table for the fluid portion of the model.
UXFF Solution matrix from dynamic analysis in d- or h-set on the fluid.
MFXX Fluid mass matrix in the h-set or d-set.
BFXX Fluid damping matrix in the h-set or d-set.
KFXX Fluid stiffness matrix in the h-set or d-set.
PNLLST Table of triplets defining panel names and their associated IPANEL qualifier values.
RWXS Transformation matrix of structure relating displacements of wetted surface to
solution set results.
RXF Transformation matrix of fluid relating displacements at response degrees-of-
freedom to solution set results.
AXX Fluid-structure coupling matrix in the h-set or d-set.
Main Index
PFCALC
Participation factors for structure and acoustic applications
1276
Output Data Blocks:
AXW Fluid-structure coupling matrix with columns corresponding to degrees-of-freedom
of the wetted surface only.
VGW G-set size partitioning vector with non-zero values at rows corresponding to
structural degrees-of-freedom of the wetted surface.
ABEH* Family of signed modally reduced area matrices.
PFXF Matrix of fluid loads in the h-set or d-set.
UBRS Contribution of the base motion to the displacements at the response degrees of
freedom
UBRF Contribution of the base motion to the pressure at the response degrees of freedom
UBWS Contribution of the base motion to the displacements of the wetted surface on
structure
APXW* Family of panel fluid-structure coupling matrices (family of panel axw matrices for
fluid response)
MSXX Structure mass matrix in the h-set or d-set.
BSXX Structure damping matrix in the h-set or d-set.
KSXX Structure stiffness matrix in the h-set or d-set.
PXS Matrix of structural loads in the h-set or d-set.
UBWF Contribution of the base motion to the displacements of the wetted surface on fluid.
APYW* Family of panel fluid-structure coupling matrix with columns corresponding to
degree-of-freedom of the wetted surface only for structure response.
QFRQV* Family of frequency vectors of ACTRIM.
QSXX* Family of ACTRIM matrices on structure domain.
QFXX* Family of ACTRIM matrices on fluid domain.
QAXX* Family of ACTRIM matrices on fluid-structure coupling domain.
QABEH* Family of ACTRIM panel fluid-structure coupling matrices.
QABEF* Family of ACTRIM contribution of the base motion to the displacements of the
wetted surface on fluid.
QABES* Family of ACTRIM contribution of the base motion to the displacements of the
wetted surface on structure.
QAXW* Family of ACTRIM fluid-structure coupling matrix with columns corresponding to
degree-of-freedom of the wetted surface only.
SMPF Matrix of structural modal participation factors.
SMPFD SMPF dictionary table.
Main Index
1277 PFCALC
Participation factors for structure and acoustic applications
Parameters:
Remarks:
1. The response degrees-of-freedoms are the degrees-of-freedoms of which the participation factors
are requested (setdof on right-hand side of PFMODE, PFPANEL and PFGRID commands).
OSMPF1 Table of structural modal participation factors in SORT1 format.
AFMPF Matrix of acoustic fluid modal participation factors.
AFMPFD AFMPF dictionary table.
OAFMPF1 Table of acoustic fluid modal participation factors in SORT1 format.
4ASMPF Matrix of acoustic structural modal participation factors.
ASMFPD ASMPF dictionary table.
OASMPF1 Table of acoustic structural modal participation in SORT1 format.
APMPF Matrix of acoustic panel modal participation factors.
APMPFD APMPF dictionary table.
OAPMPF1 Table of acoustic panel modal participation factor in SORT1 format.
APPF Matrix of acoustic panel participation factors.
APPFD APPF dictionary table.
OAPPF1 Table of acoustic panel participation in SORT1 format.
AGPF Matrix of normalized acoustic grid participation factors.
AGPFD AGPF dictionary table.
OAGPF1 Table of normalized acoustic grid participation factors in SORT1 format.
SPPF Matrix of structure panel participation factors.
SPPFD SPPF dictionary table.
OSPPF1 Table of structure panel participation in SORT1 format.
FS Input-logical-default=TRUE. Fluid-structure existence flag.
APP Input-character-default='XXXXXXXX'. Analysis type.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalue
SOLTYPS Input-character-default='XXXXXXXX'. Solution method for the structure:
'MODAL', 'DIRECT' or 'NONE'
SOLTYPF Input-character-default='XXXXXXXX'. Solution method for the fluid: 'MODAL',
'DIRECT' or 'NONE'
NOACTRM Input-integer-default=0. Number of ACTRIMs selected.
Main Index
PFCALC
Participation factors for structure and acoustic applications
1278
2. Acoustic and structural modal participation factors are supported in modal frequency response
(SOL 111), modal transient response (SOL 112) and modal complex eigenvalue analysis (SOL
110)
3. Acoustic panel and grid participation factors are supported in a coupled modal or direct frequency
response analysis (SOL 108 and SOL 111).
4. All other acoustic participation factors are supported in a coupled modal frequency response
analysis (SOL 111) only.
Main Index
1279 PFOFP
Output File Processor for Participation Factors
To output (print or punch) data blocks prepared by PFMODE, PFPANEL and PFGRID.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Remarks:
1. Any of the data blocks may be purged.
PFOFP
Output File Processor for Participation Factors
PFOFP OFP1,OFP2,OFP3,OFP4,OFP5//ODCODE/APP $
OFPi Output table suitable for processing by PFCALC module. See Remark 1.
None
ODCODE Input-integer-default=-1. Output device code override. ODCODE overrides the
code stored in the DBi's according to the following table:
ODCODE Output Directed to:
1 Print
2 Plot
4 Punch
5 Print and Punch
APP Input-Integer-default=''. Analysis type.
FREQRESP Frequency response.
TRANRESP Transient response.
Main Index
PLOT
Creates a table of plot instructions
1280
Creates a table of plot instructions for undeformed and deformed shapes and then writes the table to
Fortran unit 14.
Format:
Input Data Blocks:
Output Data Blocks:
PLOT
Creates a table of plot instructions
PLOT PLTPAR,GPSETS,ELSET,CASECC,BGPDT,
, , , /
PLOTMSG/
NGP/LUSET/JPLOT/DEFORMED/S,N,PLTNUM $
PLTPAR Table of plot parameters and plot control.
GPSETS Table of grid point sets related to the element plot sets.
ELSET Table of element plot set connections.
CASECC Table of Case Control command images.
BGPDT Basic grid point definition table.
PUGS Matrix of translational displacements in static analysis.
USET Degree-of-freedom set membership table for g-set.
PUGD Matrix of translational displacements in dynamic analysis.
ECT Element connectivity table.
GPECT Grid point element connection table.
OES1 Table of element stresses or strains in SORT1 format.
PLOTMSG Table of user informational messages generated during the plot
process.
PUGS
USET
)
`
PUGD
ECT
)
`
GPECT
)
`
OES1
)
`
Main Index
1281 PLOT
Creates a table of plot instructions
Parameters:
Remarks:
1. If GPECT, OES1, PUGS, and PUGD are purged then only undeformed shapes may be drawn.
2. If either PUGS or PUGD is purged, that type of deformed shape will not be drawn.
3. If GPECT or OES1 are purged, contour plots or outlines will not be drawn.
4. The plot instructions are written to Fortran unit 14.
5. If USET and ECT are input, then the plot will label the grid points with numbers indicating the
degrees-of-freedom constrained to zero. For example, a label of 126 indicates the grid is
constrained in the first and second translational and third rotational degrees-of-freedom. Also, the
elements will be labeled with their property identification numbers. These features are only
available in undeformed plotting only.
NGP Input-integer-no default. Number of grid points and scalar points in the structure.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set. If LUSET=0 then its value will be extracted from the trailer of BGPDT.
JPLOT Input-integer-no default. Number of element plot sets. Set to -1 if there are none.
DEFORMED Input-integer-default=1. Deformed plot request flag.
1 Plot undeformed shapes.
-1 Plot deformed shapes.
PLTNUM Input/output-integer-default=0. Plot frame counter.
Main Index
PLTHBDY
Supports plotting of CHBDYi elements
1282
Updates the geometry and connectivity tables to support plotting of CHBDYi elements.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
PLTHBDY
Supports plotting of CHBDYi elements
PLTHBDY GEOM2,ECT,EPT,BGPDT,CSTM/
PECT,PBGPDT/
S,N,NHBDY/MESH $
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
ECT Element connectivity table.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
PECT Element connectivity table updated to support plotting CHBDYi
elements.
PBGPDT Basic grid point definition table updated to support plotting CHBDYi
elements.
NHBDY Output-integer-no default. Number of CHBDYi elements. Set to -1 if
none exist.
MESH Input-character-no default. Shading summary print flag. Set to 'YES' to
print summary; 'NO' otherwise.
Main Index
1283 PLTSET
Generates element sets for plotting
Generates element sets for plotting.
Format:
Input Data Blocks:
Output Data Blocks:
PLTSET
Generates element sets for plotting
PLTSET
/
3/6(706*3/73$5*36(76 /
S,N,NGP/S,N,JPLOT/ECTYPE $
PCDB Table of model (undeformed and deformed) plotting commands.
POSTCDB Table of commands from the OUTPUT(POST) Section of Case
Control.
BGPDT Basic grid point definition table.
PBGPDT Basic grid point definition table updated to support plotting CHBDYi
elements.
ECT Element connectivity table.
PECT Element connectivity table updated to support plotting CHBDYi
elements.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
PLSETMSG Table of user informational messages generated during the definition
of element plot sets.
PLTPAR Table of plot parameters and plot control.
GPSETS Table of grid point sets related to the element plot sets.
PCDB
PBGPDT
BGPDT
)
`
PECT
ECT
)
`
, ,
POSTCDB GEOM2 , ,
)
`
ELSET
PELSET
)
`
Main Index
PLTSET
Generates element sets for plotting
1284
Parameters:
Remark:
PCDB may be purged if ECTYPE>0.
Examples:
1. For p-elements in subDMAP IFPS1, ELSET is required by GP0.
PLTSET POSTCDB,,GEOM2/X1,X2,X3,ELSET/0/0/1 $
2. For undeformed plotting in subDMAP SEPLOT:
PLTSET PCDB,PBGPDT,PECT/
PLTMSG,PLTPAR,GPSETS,ELSETS/
S,N,NSILS/S,N,JPLOT $
ELSET Table of element plot set connections.
PELSET p-element set table, contains SETS DEFINITIONS.
NGP Output-integer-no default. Number of grid points and scalar points in the structure.
JPLOT Output-integer-no default. Number of element plot sets. Set to -1 if there are none.
ECTYPE Input-integer-default=0. Type of element connectivity input and plot set output:
0 ECT and ELSET.
1 GEOM2 and ELSET.
2 ECT and PELSET.
Main Index
1285 PNCHGRP
For multi-level DMP, changes the active group set from a parent to a child group or from a child to a
parent group.
Format:
Input Data Blocks:
None.
Output Blocks:
None.
Parameters:
Remarks:
1. If a processor does not belong to any of the groups associated with TOLABEL then IBELONG
will be zero and PNCHGRP will not change the parallel processing environment for that
processor. If a processor does belong to a group associated with TOLABEL, then IBELONG will
be one.
2. PNCHGRP can only change groups from a parent to a child or from child to a parent.
3. PNCHGRP redefines system cell 231 (NPROCS) and system cell 265 (the processor ID) to be
their local values within the new group.
PNCHGRP
For multi-level DMP, changes the active group set from a
parent to a child group or from a child to a parent group.
PNCHGRP //FROMLABL/TOLABEL/IBELONG $
FROMLABL Input-character-no default. The label associated with the present group
set.
TOLABEL Input-character-no default. The label associated with the new group
set.
IBELONG Input-integer-default=1. A zero value of this parameter indicates that
the processor does not belong to any of the subgroups associated with
the TOLABEL label.
Main Index
PNMKGRP
For multi-level DMP; creates a set consisting of one or more (sub)groups.
1286
For multi-level DMP; creates a set consisting of one or more (sub)groups.
Format:
Input Data Blocks:
None.
Output Blocks:
None.
Parameters:
PNMKGRP
For multi-level DMP; creates a set consisting of one or more
(sub)groups.
PNMKGRP //PLABEL/NSUBGP/GRPSIZ/PIDINI/
INCPID/INCGRP/GPLABEL $
PLABEL Input-character-default=WORLD. The label associated with the
parent group set.
NSUBGP Input-integer-default=1. The number of subgroups to create in the new
set.
GRPSZ Input-integer-default=1. The number of processors in each subgroup.
PIDINI Input-integer-default=1. The first processor id of the parent group
which will be included in the first new subgroup.
INCPID Input-integer-default=1. The stride from one processor identification
number of the parent group which is included in a given subgroup, to
the next processor identification number of the parent group which is
included in the same group.
INCGRP Input-integer-default=1. The stride from the first processor
identification number of the parent group that is included in a given
subgroup, to the processor identification number of the parent group
that corresponds to the first processor identification number that is
included in the next subgroup.
GPLABEL Input-character-no default. The label associated with the new set of
subgroups.
Main Index
1287 PNMKGRP
For multi-level DMP; creates a set consisting of one or more (sub)groups.
Remarks:
1. The parent group set identified by the first parameter must be the active group when the child
group set is created. The default active group is the WORLD group. A child group is made active
using the PNCHGRP module.
2. If there are more than one groups (NSUBGP > 1), then all the groups must have the same number
of processors.
Examples:
1. From the world group of 20 processors, create a set of 5 subgroups with processor identification
numbers {1,2,3,4}, {5,6,7,8}, {9,10,11,12}, {13,14,15,16}, {17,18,19,20}:
2. From the world group of 20 processors, create a set of 5 subgroups with processor identification
numbers {1,6,11,16}, {2,7,12,17}, {3,8,13,18}, {4,9,14,19}, {5,10,15,20}:
3. From the world group of 20 processors, create a set 1 subgroup with processor identification
numbers {1,5,9,13,17}:
PNMKGRP //world/5/4/1/1/4/mygroup1
PNMKGRP //world/5/4/1/5/1/mygroup2
PNMKGRP //world/1/5/1/4//masters1
Main Index
PRESOL
Prepares special tables for the distributed parallel solution
1288
Prepares special tables for the distributed parallel solution using the domain decomposition method.
Format under PRSLOPT=0:
Format under PRSLOPT=1:
Format under PRSLOPT=2:
Format under PRSLOPT=3:
Input Data Blocks:
PRESOL
Prepares special tables for the distributed parallel solution
PRESOL GEQMAP,USET,SIL,PARFIL,PFA,PJXL/
EQMAP,GAPAR,,PFA1,/
NOFSETL/S,N,PRSLOPT/PARTMETH/NMATDOM $
PRESOL MAT1,MAT2,,,,/
QMAPD,GAPAR,PARTF,LOCALP,GRDRM//
S,N,PRSLOPT/PARTMETH $
PRESOL MAT1,MAT2,EQMAPD0,,,/
AT1N,MAT2N,,,//
S,N,PRSLOPT
PRESOL MAT1,MAT2,,,,/
COLOR,,,,//
S,N,PRSLOPT/PARTMETH/NMATDOM $
GEQMAP Table of grid based local equation map indicating which grid resides
on which processors/partitions for domain decomposition.
USET Degree-of-freedom set membership table for g-set.
SIL Scalar index list.
MAT1 Square symmetric matrix 1 to be paritioned.
MAT2 Square symmetric matrix 2 to be paritioned.
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees-of-freedom that are locally constrained.
PFA Static load matrix with partial boundary loads in the a-set.
Main Index
1289 PRESOL
Prepares special tables for the distributed parallel solution
Output Data Blocks:
Parameters:
PJXL Static load matrix for boundary load contribution from the residual
structure.
EQMAPD0 EQMAPD from a prior call to PRESOL.
EQMAP Table of degree-of-freedom global-to-local maps for domain
decomposition.
GAPAR Partitioning vector which is used to partition the local a-set
displacements from the global a-set displacements. It contains a 1 at
each row which does not have a contribution from the current
processor and zero if it does.
PARTVEC1 Updated PARTVEC indicating for all constraints; local and boundary.
PFA1 Updated PFA with complete boundary loads.
EQMAPD Similar to EQMAP but on a degree-of-freedom basis.
MAT1N Local filtered matrix 1.
MAT2N Local filtered matrix 2.
GRDRM Permutation matrix.
COLOR Coloring array. Number of rows corresponds to size of MATi. The i-th
entry corresponds to the uperelement identification number (tip
superelement or collector or 0 (residual)) to which the i-th degree-of-
freedom belongs.
UNUSEDi Input-integer-default=0. Unused and may be unspecified.
PRSLOPT Input/output-integer-default=0. PRESOL Processing option. On input the following
options are available.
0 Prepare for partial and distributed decomposition.
1 Partition the matrices into as many domains as there are processors. All
outputs are created.
2 It is assumed that PRESOL has been called before with PRSLOPT=1. Under
PRSLOPT=2, local a-set terms are filtered out of local matrices that are kept
on other processors.
3 Partition the matrices into NMATDOM domains. PARTMETH
automatically uses MSCMLV (PARTMETH=11), because Extreme
(PARTMETH=9) is not available for this option. Only one output is created,
COLOR. On output for PRSLOPT>0, if any error occurs then PRSLOPT is
negated.
Main Index
PRESOL
Prepares special tables for the distributed parallel solution
1290
PARTMETH Input-integer-default=0. PRESOL partitioning method.
9 Extreme.
11 MSCMLV.
NMATDOM Input-integer-default=0. Number of matrix domains into which the matrices are
divided. NMATDOM is used only with PRSLOPT=3 and must be a power of 2. The
default will be set to the number of processors.
Main Index
1291 PROJVER
Set or query project identification numbers
Set or query project and version identification numbers on the database.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
PROJVER
Set or query project identification numbers
PROJVER //PRJVEROP/S,N,PROJNO/S,N,VERSION/S,N,EXISTS $
PRJVEROP Input-character-no default. Operation name.
'GET' Get current project and version.
'NEXT' Get next non-deleted project and version.
'SET' Set current project and version.
'LAST' Get the last (bottom) project and version.
'RESTART' Get restart project and version.
PROJNO Input/output-integer-no default. Project number.
VERSION Input/output-integer-no default. Version number.
EXISTS Output-character-no default. Project and version status.
'EXISTS' If project and version exists.
'DELETED' If project and version is deleted.
'NONE' If project and version never existed.
Main Index
PRTMSG
Prints plotting information messages
1292
Prints user information messages related to plot set definition and plotting.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameter:
PRTMSG
Prints plotting information messages
PRTMSG 35'06*
PLOTMSG Table of user informational messages generated during the plot
process.
PLSETMSG Table of user informational messages generated during the definition
of element plot sets.
PDRMSG Input-integer-default=1. Message print flag. Set to 0 to suppress
printout.
PLOTMSG
PLSETMSG
)
`
Main Index
1293 PRTPARM
Parameter and DMAP message printer
Prints non-NDDL parameter values and DMAP messages. For NDDL parameters (see TYPE statement),
use the MESSAGE statement.
Format:
Input Data Blocks:
None.
Output Data Blocks:
None.
Parameters:
Remarks:
1. As a parameter printer, use PRTPOPT = 0. There are two options:
If PNAME is equal to a parameter name enclosed by quotation marks, then the value of that
parameter in the subDMAP identified by SUBDMAP is printed. PNAME must be a non-NDDL
parameter (see TYPE statement).
Example:
3573$50/86(7
If PNAME = 'XXXXXXXX' then the values of all variable and constant parameters in the
Variable Parameter Table of the subDMAP identified by SUBDMAP are printed.
Examples:
3573$508QVRUWHG
3573$506RUWHG
PRTPARM
Parameter and DMAP message printer
PRTPARM //PRTPOPT/PNAME/PRTPSORT/SUBDMAP $
PRTPOPT Input-integer-default=0. PRTPOPT=0 requests the print of a single
parameter value or all parameter values. PRTPOPT>0 requests the
print of diagnostic messages 4401 through 4425.
PNAME Input-character-default = 'XXXXXXXX'. Name of a parameter
enclosed by single quotation marks. See Remark 1.
PRTPSORT Input-integer-default=0. If PRTPSORT=1, then parameters will be
sorted alphabetically.
SUBDMAP Input-character-default=blank. The name of a subDMAP.
Main Index
PRTPARM
Parameter and DMAP message printer
1294
If no value is entered for SUBDMAP, the parameter value or values (depending on PNAME) will
be for the current subDMAP. Otherwise, the value or values will be for the subDMAP identified
by SUBDMAP.
2. As a DMAP message printer, parameter PRTPOPT is nonzero.
3. Meaningless values of PRTPOPT, PNAME, and SUBDMAP will result in diagnostic messages
from PRTPARM.
Main Index
1295 PURGEX
Explicit data block purge
Flags a data block as empty.
Format:
Output Data Blocks:
Parameter:
Remark:
PURGEX is an executive operation module intended for restart purposes only. If at execution time a data
block has been previously output from a module, then any existing data will be deleted and the data block
will be marked as empty. If the data block has not been previously output from a module, it will simply
be marked as empty. A purged data block is equivalent to a data block not generated with the exception
that the NES "remembers" for restart purposes that it has been previously output. If no restart is involved,
purge is entirely equivalent to a data block not generated.
Example:
Flag data block MGGX as empty so as to avoid execution of EMA module on restart.
PURGEX/MGGX,,,,/NOMGGX $
PURGEX
Explicit data block purge
PURGEX /DB1,DB2,DB3,DB4,DB5/PARM $
DBi Any data block.
PARM Input-integer-default=0.
<0 The data blocks are deleted and marked empty.
<0 No action is taken.
Main Index
PVT
Sets parameter values
1296
Sets parameter values from Case Control and/or Bulk Data Sections.
Format:
Input Data Blocks:
Output Data Block:
Parameter
:
Remarks:
1. The PVT module is primarily used to resolve parameter values specified in the Case Control and
Bulk Data Sections. These parameters must have Y authorization.
2. Either one or both input data blocks may be purged. If the input data block is purged, the user input
parameter settings will not contain parameters from the input. If both input data blocks are purged,
and LOADFLT is FALSE, then no values are entered.
3. The output data block may be purged. The PVT module will always internally update the user
input parameters. The output data block is primarily used for restart purposes.
First, the default parameters are added if requested.
Second, the PVT user input parameters from the Bulk Data Section are set.
Third, the CASECC user input parameters from Case Control above the subcase level override
any settings of Bulk Data parameters of the same name. Any additional Case Control above the
subcase level parameters are set.
PVT
Sets parameter values
PVT PVT,CASECC/PVTS/LOADFLT $
PVT Parameter value table from IFP module. (Bulk Data PARAM entries)
CASECC Table of Case Control Command images.
PVTS Parameter Variable Table from Case Control merged with the Bulk
Data input parameters.
LOADFLT Logical-input-default=TRUE. If LOADFLT = TRUE then all
parameters that appear in the Parameter Defaults Table, but do not
appear in the PVT or CASECC data block, are added to the PVTS data
block. See Remark 4.
Main Index
1297 PVT
Sets parameter values
Fourth, the CASECC user input parameters for the current subcase override any settings of Bulk
Data parameters or above subcase level parameters of the same name. Any additional current
subcase parameters are set.
4. The Parameter Defaults Table is an internal table that contains the default value for all parameters
resolved between the Case Control, Bulk Data, NDDL, and the main and current subDMAP.
Main Index
RANDOM
Computes functions from frequency response data
1298
Computes power spectral density functions and autocorrelation functions from frequency response data.
Format:
Input Data Blocks:
RANDOM
Computes functions from frequency response data
RANDOM XYCDB,DIT,PSDL,OUG2,OPG2,OQG2,OES2,OEF2,CASECC,
OSTR2,OQMG2,RCROSSL,OFMPF2M,OSMPF2M,OLMPF2M,OPMPF2M,
OGPMPF2M,OVG2,OAG2, CSIG,CEPS,CFAI,CSRS/
PSDF,AUTO,
OUGPSD2,OUGATO2,OUGRMS1,OUGNO1,OUGCRM2,
OPGPSD2,OPGATO2,OPGRMS1,OPGNO1,OPGCRM2,
OQGPSD2,OQGATO2,OQGRMS1,OQGNO1,OQGCRM2,
OEFPSD2,OEFATO2,OEFRMS1,OEFNO1,OEFCRM2,
OEEPSD2,OEEATO2,OEERMS1,OEENO1,OEECRM2,
OQMPSD2,OQMATO2,OQMRMS1,OQMNO1,OQMCRM2,
OCPSDF,OCCORF,
OVGPSD2,OVGATO2,OVGRMS1,OVGNO1,OVGCRM2,
OAGPSD2,OAGATO2,OAGRMS1,OAGNO1,OAGCRM2,
OCSPSD2,OCSATO2,OCSRMS2,OCSNO2,OCSCRM2,
OCAPSD2,OCAATO2,OCARMS2,OCANO2,OCACRM2,
OCFPSD2,OCFATO2,OCFRMS2,OCFNO2,OCFCRM2,
OCRPSD2,OCRATO2,OCRRMS2,OCRNO2,OCRCRM2 /
S,N,NORAND/RMSINT/DVAFLAG $
XYCDB Table of x-y plotting commands.
DIT Table of TABLEij Bulk Data entry images.
PSDL Power spectral density list.
OUG2 Table of displacements in SORT2 format.
OPG2 Table of applied loads in SORT2 format.
OQG2 Table of single point forces of constraint in SORT2 format.
OES2 Table of element stresses or strains in SORT2 format.
OEF2 Table of element forces in SORT2 format.
CASECC Table of Case Control command images.
OSTR2 Table of element strains in SORT2 format.
OQMG2 Table of multipoint forces of constraint in SORT2 format.
RCROSSL Table of RCROSS Bulk Data entry images.
OFMPF2M Table of fluid modal participation factors by natural modes in SORT2 format.
OSMPF2M Table of structural modal participation factors by natural modes in SORT2 format.
Main Index
1299 RANDOM
Computes functions from frequency response data
Output Data Blocks:
OLMPF2M Table of load modal participation factors by natural modes in SORT2 format.
OPMPF2M Table of panel modal participation factors by natural modes in SORT2 format.
OGPMPF2M Table of panel grid modal participation factors by natural modes in SORT2 format.
OVG2 Table of velocities in SORT2 format.
OAG2 Table of accelerations in SORT2 format.
CSIG Table of lamina stresses in SORT2 format.
CEPS Table of lamina strains in SORT2 format.
CFAI Table of lamina failure indices in SORT2 format.
CSRS Table of lamina strength ratios in SORT2 format.
PSDF Power spectral density table.
AUTO Autocorrelation function table.
OUGPSD2 Table of displacements in SORT2 format for the PSD function.
OUGATO2 Table of displacements in SORT2 format for the autocorrelation function.
OUGRMS1 Table of displacements in SORT1 format for the RMS function.
OUGNO1 Table of displacements in SORT1 format for the NO function.
OUGCRM2 Table of displacements in SORT2 format for the cross correlation function.
OPGPSD2 Table of applied loads in SORT2 format for the PSD function.
OPGATO2 Table of applied loads in SORT2 format for the autocorrelation function.
OPGRMS1 Table of applied loads in SORT1 format for the RMS function.
OPGNO1 Table of applied loads in SORT1 format for the NO function.
OPGCRM2 Table of applied loads in SORT2 format for the cross correlation function.
OQGPSD2 Table of single point forces of constraint in SORT2 format for the PSD function.
OQGATO2 Table of single point forces of constraint in SORT2 format for the autocorrelation
function.
OQGRMS1 Table of single point forces of constraint in SORT1 format for the RMS function.
OQGNO1 Table of single point forces of constraint in SORT1 format for the NO function.
OQGCRM2 Table of single point forces of constraint in SORT2 format for the cross correlation.
OESPSD2 Table of element stresses in SORT2 format for the PSD function.
OESATO2 Table of element stresses in SORT2 format for the autocorrelation function.
OESRMS1 Table of element stresses in SORT1 format for the RMS function.
OESNO2 Table of element stresses in SORT2 format for the NO function.
Main Index
RANDOM
Computes functions from frequency response data
1300
OESCRM2 Table of element stresses in SORT2 format for the cross correlation function.
OCSPSD2 Table of lamina stresses in SORT2 format for the PSD function.
OCSATO2 Table of lamina stresses in SORT2 format for the autocorrelation function.
OCSRMS1 Table of lamina stresses in SORT1 format for the RMS function.
OCSNO2 Table of lamina stresses in SORT2 format for the NO function.
OCSCRM2 Table of lamina stresses in SORT2 format for the cross correlation function.
OCAPSD2 Table of lamina strains in SORT2 format for the PSD function.
OCAATO2 Table of lamina strains in SORT2 format for the autocorrelation function.
OCARMS1 Table of lamina strains in SORT1 format for the RMS function.
OCANO2 Table of lamina strains in SORT2 format for the NO function.
OCACRM2 Table of lamina strains in SORT2 format for the cross correlation function.
OCFPSD2 Table of failure indices in SORT2 format for the PSD function.
OCFATO2 Table of failure indices in SORT2 format for the autocorrelation function.
OCFRMS1 Table of failure indices in SORT1 format for the RMS function.
OCFNO2 Table of failure indices in SORT2 format for the NO function.
OCFCRM2 Table of failure indices in SORT2 format for the cross correlation function.
OCRPSD2 Table of strength ratios format for the PSD function.
OCRATO2 Table of strength ratios in SORT2 format for the autocorrelation function.
OCRRMS1 Table of strength ratios in SORT1 format for the RMS function.
OCRNO2 Table of strength ratios in SORT2 format for the NO function.
OCRCRM2 Table of strength ratios in SORT2 format for the cross correlation function.
OEFPSD2 Table of element forces in SORT2 format for the PSD function.
OEFATO2 Table of element forces in SORT2 format for the autocorrelation function.
OEFRMS1 Table of element forces in SORT1 format for the RMS function.
OEFNO1 Table of element forces in SORT1 format for the NO function.
OEFCRM2 Table of element forces in SORT2 format for the cross correlation function.
OEEPSD2 Table of element strains in SORT2 format for the PSD function.
OEEATO2 Table of element strains in SORT2 format for the autocorrelation function.
OEERMS1 Table of element strains in SORT1 format for the RMS function.
OEENO1 Table of element strains in SORT1 format for the NO function.
OEECRM2 Table of element strains in SORT2 format for the cross correlation function.
OQMPSD2 Table of multipoint forces of constraint in SORT2 format for the PSD function.
OQMATO2 Table of multipoint forces of constraint in SORT2 format for the autocorrelation
function.
Main Index
1301 RANDOM
Computes functions from frequency response data
OQMRMS1 Table of multipoint forces of constraint in SORT1 format for the RMS function.
OQMNO1 Table of multipoint forces of constraint in SORT1 format for the NO function.
OQMCRM2 Table of multipoint forces of constraint in SORT2 format for the cross correlation
function.
OCPSDF Output table of cross-power-spectral-density functions.
OCCORF Output table of cross-correlation functions.
OVGPSD2 Table of velocities in SORT2 format for the PSD function.
OVGATO2 Table of velocities in SORT2 format for the autocorrelation function.
OVGRMS1 Table of velocities in SORT1 format for the RMS function.
OVGNO1 Table of velocities in SORT1 format for the NO function.
OVGCRM2 Table of velocities in SORT2 format for the cross correlation function.
OAGPSD2 Table of accelerations in SORT2 format for the PSD function.
OAGATO2 Table of accelerations in SORT2 format for the autocorrelation function.
OAGRMS1 Table of accelerations in SORT1 format for the RMS function.
OAGNO1 Table of accelerations in SORT1 format for the NO function.
OAGCRM2 Table of accelerations in SORT2 format for the cross correlation function.
OCSPSD2 Table of lamina stresses in SORT2 format for the PSD function.
OCSATO2 Table of lamina stresses in SORT2 format for the autocorrelation function.
OCSRMS1 Table of lamina stresses in SORT1 format for the RMS function.
OCSNO2 Table of lamina stresses in SORT2 format for the NO function.
OCSCRM2 Table of lamina stresses in SORT2 format for the cross correlation function.
OCAPSD2 Table of lamina strains in SORT2 format for the PSD function.
OCAATO2 Table of lamina strains in SORT2 format for the autocorrelation function.
OCARMS1 Table of lamina strains in SORT1 format for the RMS function.
OCANO2 Table of lamina strains in SORT2 format for the NO function.
OCACRM2 Table of lamina strains in SORT2 format for the cross correlation function.
OCFPSD2 Table of failure indices in SORT2 format for the PSD function.
OCFATO2 Table of failure indices in SORT2 format for the autocorrelation function.
OCFRMS1 Table of failure indices in SORT1 format for the RMS function.
OCFNO2 Table of failure indices in SORT2 format for the NO function.
OCFCRM2 Table of failure indices in SORT2 format for the cross correlation function.
OCRPSD2 Table of strength ratios format for the PSD function.
OCRATO2 Table of strength ratios in SORT2 format for the autocorrelation function.
OCRRMS1 Table of strength ratios in SORT1 format for the RMS function.
Main Index
RANDOM
Computes functions from frequency response data
1302
Parameters:
Method:
Overview
The Random Analysis Module calculates power spectral density functions, autocorrelation functions and
mean deviations for selected displacements, loads, forces of single-point constraint, and element forces
and stresses.
Module Initialization
1. The XYCDB must be present or RANDOM returns.
2. A set of RANDPS Bulk Data entries from PSDL must be selected in CASECC or RANDOM
returns.
3. The frequency list is extracted from the first non-empty data file.
4. The RANDPS Bulk Data entry defines the function
(5-22)
where:
The power spectral density for gust turbulence can also be supplied on a TABRNDG entry.
OCRNO2 Table of strength ratios in SORT2 format for the NO function.
OCRCRM2 Table of strength ratios in SORT2 format for the cross correlation function.
NORAND Output-integer-default=-1. Set to -1 if no random analysis is requested; 0
otherwise.
RMSINT Input-character-default='LINEAR'. Power-spectral-density function
interpolation option. A log-log option may be selected with
RMSINT='LOGLOG'.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations are
contained in separate data blocks and any associated outputs follow suit.
-1 Velocities and acceleratons are contained in OUG2.
1 Velocities and acceleratons are contained in OVG2 and OAG2.
=
subcase ID of the excited load set.
=
subcase ID of the applied load set .
=
complex number such that if , then must be 0.0.
=
table identification number of a TABRND1 Bulk Data entry that defines
, a power spectral density as a tabular function of frequency.
S
ab
f ( ) x iy + ( )F
K
f ( ) =
a
b a b s ( )
x y , a b = y
K
F f ( )
Main Index
1303 RANDOM
Computes functions from frequency response data
(5-23)
where , , , , and are user-supplied data and .
If on any RANDPS entry, the equations are called coupled; otherwise, they are called
uncoupled.
The following eight steps are accomplished:
a. The XYCDB is read for a list of requested points.
b. Compute at each load change.
c. Read in the data from the SORT2 data block and compute
(5-24)
where is the response of the j-th point at frequency .
d. These are summed over all loads to form the power spectral density function
(5-25)
where runs over all subcase identification numbers on the RANDPS entries.
e. When all subcases for the points have been processed, the mean response is calculated for
each point :
(5-26)
where = number of frequencies.
The mean response is output with both the PSDF and the autocorrelation function.
The zero positive crossing is also computed and output with the mean response . is
defined by
(5-27)
The number of zero crossings with positive slope per unit time is a weighted average
frequence equal to the square root of the ratio of the integral of the PSD times frequency
squared to the integral of the PSD.
The integral in the denominator is already calculted and is related to the "mean square
response"
S
ab
f ( ) W
g
22L
U
------
1 2 p 1 + ( ) kwL U ( )
2
+
1 kwL U ( )
2
+ | |
p 3 2 +
-------------------------------------------------------- =
W
g
2
L U p k W 2tf =
a b =
S
aa
f ( )
S
ja
f ( ) U
j
f ( )
2
S
aa
f ( ) =
U
j
f ( ) f
S
ja
f ( ) S
ja
f ( )
a
=
a
q
j
j
1
2
--- S
j
f
i
( ) S
j
f
i 1 +
( ) + ( ) | | f
i 1 +
f
i
( )
i 1 =
N 1
N
N
0
q
j
N
0
1
2t
------ w
2
S
J
w ( ) w d S
J
w ( ) w d
0
}
Main Index
RANDOM
Computes functions from frequency response data
1304
(5-28)
thus the numerator must be integrated. Compute
(5-29)
Note that if and are 1.0, the sum for would become the formula for . Then
is the quantity to be output.
f. If PSDF for point is requested, one identification number and data record are written on the
PSDF data block.
g. If an autocorrelation function is requested for point , the are transformed to the time
domain to give the autocorrelation function:
(5-30)
where:
(5-31)
=
index of the frequencies.
=
highest frequency.
=
is defined by
q
j
2
R
j
0 ( ) S
j
f ( ) f d
0
}
= =
r
j
2
f
2
S
j
f ( ) f d
0
}
=
r
j
1
2
--- oS
j
f
i
( ) |S
j
f
i 1 +
( ) + | | f
i 1 +
f
i
( )
i 1 =
N 1
=
o 3f
i
2
2f
i
f
i 1 +
f
i 1 +
2
+ + ( ) 6 =
| f
i
2
2f
i
f
i 1 +
3f
i 1 +
2
+ + ( ) 6 =
o | r
j
q
j
N
0
r
j
q
j
=
j
j S
j
f ( )
R
j
t
m
( )
1
4t
2
t
m
2
---------------
S
j
f
i 1 +
( ) S
j
f
i
( )
f
i 1 +
f
i
-------------------------------------- 2tt
m
f
i 1 +
( ) cos 2tt
m
f
i
( ) cos | |
i 1 =
N 1
=
+
1
2tt
m
------------- S
j
f 1 + ( ) 2tt
m
f
i 1 +
( ) sin S
j
f
i
( ) 2tt
m
f
i
( ) sin | |
)
`
i
N
t
m
t
m
t
0
m
M
----- t
max
t
0
( ) + =
Main Index
1305 RANDOM
Computes functions from frequency response data
where:
all of which are defined on a RANDT1 Bulk Data entry. Note that if, in (5-30), , then
The Coupled Case
The following six steps are accomplished:
1. A list of unique subcase identification numbers are extracted from the RANDPS entries.
2. The XYCDB is read for a list of requested points.
3. For each RANDPS entry is looked up for all , For each point is computed:
(5-32)
where denotes the value of point for subcase .
The bar over the third factor in (5-32) denotes the complex conjugate. These are summed
over all entries to form :
(5-33)
Note that , the complex conjugate.
4. The mean response and autocorrelation functions are computed as in (5-30), (5-31), and .
Remarks:
1. RANDOM calculates power spectral density functions, autocorrelation functions and mean
deviations for selected displacements, loads, forces of single-point constraints, and element forces
and stresses.
2. DIT cannot be purged if PSDL references TABLEDi records in DIT.
=
starting time lag.
=
number of time lag intervals.
=
maximum time lag
t
0
M
t
max
0 t
0
t
m
< < ( )
t
m
0 =
r t
m
( ) q
j
2
=
S
j
1
f ( ) f S
j
1
f ( )
S
j
1
f ( ) H
ja
f ( )S
ab
f ( )H
jb
f ( ) =
H
j a
f ( ) j a
S
j
1
f ( )
S
j
f ( )
S
j
f ( ) H
ja
f ( )H
jb
f ( )
b
=
S
ba
S
ab
=
Main Index
RBMG3
Computes rigid body information
1306
Computes the rigid body transformation matrix, rigid body error ratio, and strain energy matrix.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Remarks:
1. The rigid body transformation matrix is computed from:
(5-34)
2. The rigid body error ratio, e, is computed from:
(5-35)
RBMG3
Computes rigid body information
RBMG3 LLL,ULL,KLR,KRR/
DM $
LLL Lower triangular factor/diagonal for the l-set from KLL.
ULL Upper triangular factor/diagonal for the l-set from KLL.
KLR Stiffness matrix partition (l-set by r-set) from KTT.
KRR Stiffness matrix partition (r-set by r-set) from KTT.
DM Rigid body transformation matrix for the r-set to the l-set.
DM
K
ll
1
K
lr
=
K
rr
K
lr
T
DM
+
K
rr
-----------------------------------------------------
Note: The absolute value is the square root of the sum of the squares (this is not a
determinant). The strain energy matrix for the rigid body modes is computed.
Main Index
1307 RBMG3
Computes rigid body information
(5-36)
3. ULL may be purged if KLL is symmetric.
DM
T
K
ll
DM
K
rr
+
Main Index
RBMG4
Computes rigid body mass matrix
1308
Computes the rigid body mass matrix.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remark:
The rigid body mass matrix is computed from:
(5-37)
RBMG4
Computes rigid body mass matrix
RBMG4 DM,MLL,MLR,MRR/
MR $
DM Rigid body transformation matrix for the r-set to the l-set.
MLL Mass matrix reduced to the l-set.
MLR Mass matrix partition (l-set by r-set) from MTT.
MRR Mass matrix partition (r-set by r-set) from MTT.
MR Rigid body mass matrix (r-set by r-set).
MR
M
rr
=
DM
T
M
lr
M
l r
T
DM DM
T
M
l l
DM
+ + +
Main Index
1309 READ
Extracts real symmetric system eigenvalues
Extracts eigenvaules from a real symmetric system.
To solve the following equations for eigenvalues and their associated eigenvectors:
(5-38)
(5-39)
Format:
Input Data Blocks:
READ
Extracts real symmetric system eigenvalues
READ KAA,MAA,MR,DAR,DYNAMIC,USET,CASECC,
PARTVEC,SIL, , ,
, /
LAMA,PHA,MI,OEIGS,LAMMAT,OUTVEC/
FORMAT/S,N,NEIGV/NSKIP/FLUID/SETNAME/SID/METH/
F1/F2/NE/ND/MSGLVL/MAXSET/SHFSCL/NORM/PRTSUM/
MAXRATIO/MDLGDEF $
KAA K matrix in (5-38).
MAA M matrix in (5-38) or K
d
matrix in (5-39).
MR Rigid body mass matrix
DAR Rigid body transformation matrix.
DYNAMIC Eigenvalue Extraction Data (output by IFP module).
USET Degree-of-freedom set membership table.
CASECC Case Control Data Table (selects EIGR, EIGRL, or EIGB entries,
output by IFP module).
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees of freedom which were eliminated in the partition to obtain
KAA and MAA. Required for maximum efficiency. See SETNAME
parameter description below.
K | | M | | ( ) u { } 0 for vibration analysis =
K | | K
d
| | ( ) u { } 0 for buckling analysis =
VACOMP
SPCCOL
)
`
INVEC
EQMAP
)
`
LLL
VFO1
)
`
EQEXIN
)
`
GAPAR
)
`
Main Index
READ
Extracts real symmetric system eigenvalues
1310
SIL Scalar index list. Required for maximum efficiency.
VACOMP Partitioning vector of size of a-set with a value of 1.0 at the rows
corresponding to r-set degrees-of-freedom. The USET table may be
specified here as well. If VACOMP is purged and DAR does not have
the same number of rows as KAA, then the partitioning vector will be
determined from the size of MR.
SPCCOL Local f-size partitioning vector with 1.0 for the local boundary's s-set
degrees-of-freedom. Required only for geometric domain decomp.
INVEC Starting vector(s) for Lanczos method only.
EQMAP Table of degree-of-freedom global-to-local maps for domain
decomposition. Required only for geometric domain decomp.
LLL Lower triangular factor from decomposition of KAA. Use to enhance
shift logic for buckling eigenvalue extraction.
VFO1 VFO zero-partition by SPCCOL. VFO is the local f-size partitioning
vector with 6 values of 1.0 for every grid in the local residual. Required
only for geometric domain decomp.
EQEXIN Equivalence between external and internal grid identification numbers.
Required for maximum efficiency.
GAPAR Partitioning vector which is used to partition the local a-set
displacements from the global a-set displacements. It contains a 1 at
each row which does not have a contribution from the current
processor and zero if it does. Required only for geometric domain
decomp.
Main Index
1311 READ
Extracts real symmetric system eigenvalues
Output Data Blocks:
Parameters:
LAMA Normal modes eigenvalue summary table.
PHA Normal modes eigenvector matrix in the a-set.
OEIGS Real eigenvalue extraction report.
MI Modal mass matrix.
LAMMAT Diagonal matrix containing eigenvalues on the diagonal.
OUTVEC Last vector block (Lanczos only).
FORMAT Input-Character-no default. If , READ will solve a
buckling problem, i.e., using EIGB Bulk Data. But it is the
DMAP writers responsibility to multiply by -1 before entering the
READ module.
NEIGV Output-integer-no default. NEIGV is the number of eigenvectors found.
0 No eigenvectors found.
>0 NEIGV eigenvectors found.
<0 NEIGV eigenvectors found but there was an error encountered
during the extraction.
NSKIP Input-integer-default=1. The method used by READ is taken from the NSKIP
record of CASECC.
FLUID Input-logical-default=FALSE. If FLUID = TRUE, then the EIGRL or EIGR entry
is selected from METHOD(FLUID) Case Control command.
SETNAME Input-character-default='A'. For maximum efficiency, the rows and columns KXX
and MXX must correspond to or be a partition of the displacement set specified by
SETNAME. If KAA and MAA are a partition then PARTVEC must be specified.
FORMAT 'MODES' =
K | | K
d
| | + ( )
K
d
Main Index
READ
Extracts real symmetric system eigenvalues
1312
SID Input-integer-default=0. Alternate set identification number.
If SID=0, the set identification number is obtained from the METHOD command
in CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMIC.
If SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL is
selected by this parameter value. All subsequent parameter values (METH, F1,
etc.) are ignored.
If SID=-1, then both the METHOD command and all EIGR, EIGB, or EIGRL
entries are ignored and the subsequent parameter values (METH, F1, etc.) will be
used to control the eigenvalue extraction.
If SID=-2, then take action similar to SID=0 except fields on the Case Control
selection of EIGR/EIGRL may be overridden by parameters F1 through NORM
described below.
METH Input-character-default='LAN'. If SID<0, then METH specifies the method of
eigenvalue extraction.
LAN Lanczos.
INV Inverse power.
SINV Inverse power with Sturm sequence.
GIV Givens (tridiagonalization).
MGIV Modified Givens.
HOU Householder.
MHOU Modified Householder.
AGIV Automatic selection of GIV or MGIV.
AHOU Automatic selection of HOU or MHOU.
F1 Input-real-default=0.0. The lower frequency bound.
F2 Input-real-default=0.0. The upper frequency bound. The default value of 0.0
indicates machine infinity.
NE Input-integer-default=20. The number of estimated eigenvalues for non-Lanczos
methods only. For the Lanczos method, NE is the problem size which the QL
Householder method is used.
Note: NE default changed from 0 to 20.
ND Input-integer-default=0. The number of desired eigenvalues.
Main Index
1313 READ
Extracts real symmetric system eigenvalues
Remarks:
1. In the solution sequences the eigensolution control parameters are selected by the METHOD or
METHOD(FLUID) command which are defined in the CASECC data block and selects a EIGR
or EIGRL Bulk Data entry record defined in the DYNAMIC or EED data block. EED is a subset
of and interchangeable with the DYNAMIC for this application. There are alternate formats as
shown below where the Case Control commands and/or the EIGR or EIGRL Bulk Data entries
are replaced with optional parameters SID, METH, F1, etc.
SID=0 -- DYNAMIC and CASECC data blocks must be specified. METHOD command and
EIGR, or EIGRL, entries must be specified in the input file.
5($'.$$0$$'<1$0,&&$6(&&
LAMA,PHA,MI,OEIGS,/
FORMAT/S,N,NEIGV $
SID>0 -- Only DYNAMIC data block must be specified. The EIGR or EIGRL entry is selected
by the SID parameter. The CASECC data block may be purged and is ignored.
5($'.$$0$$'<1$0,&
LAMA,PHA,MI,OEIGS,/
MSGLVL Input-integer-default=0. The level of diagnostic output for the Lanczos method
only.
0 No output.
1 Warning and fatal messages.
2 Summary output.
3 Setailed output on cost and convergence.
4 Setailed output on orthogonalization.
MAXSET Input-integer-default=0. Vector block size for Lanczos method only.
SHFSCL Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL
must be greater than 0.0.
NORM Input-character-default=' '. Method for normalizing eigenvectors. By default (or
NORM='MASS'), MASS normalization is performed. NORM='MAX' selects
normalization by maximum displacement.
PRTSUM Inpput-logical-default=TRUE. Lanczos eigenvalue summary print flag.
MAXRATIO Input-real-default=1.0E7. Minimum value of factor diagonal ratio which causes
termination of decomposition.
MDLGDEF Input-integer-default=8000. Minimum number of degrees-of-freedom that activates
special ACMS DECOMP/FBS method in READ module for buckling problems
(FORMAT<>"MODES").
Main Index
READ
Extracts real symmetric system eigenvalues
1314
FORMAT/S,N,NEIGV////SID $
SID<0 -- DYNAMIC and CASECC are not required. SID=-1 and METH through NORM
parameters are specified. For more detailed information on parameters F1 through NORM,
please refer to the descriptions of Bulk Data entries EIGR, 1807 and EIGRL (p. 1811) in the MSC
Nastran Quick Reference Guide. The CASECC and DYNAMIC data blocks may be purged and
are ignored.
5($'.$$0$$
LAMA,PHA,MI,OEIGS,/
FORMAT/S,N,NEIGV////-1//
F1/F2/NE/ND/MSGLVL/MAXSET/SHFSCL/NORM $
2. In the READ module, the most memory-intensive part of the calculations is involved with
symbolic decomposition of the mass or shifted stiffness matrix. Two methods of internal
resequencing are available. When the USET, SIL, EQEXIN, and PARTVEC data blocks and
SETNAME parameter are available, the resequencing is done in a grid point basis. These data
blocks allow correlation of row numbers in the a-set with grid point numbers. When any of these
data blocks are missing the resequencing is done on a degree-of-freedom basis, potentially 6 times
larger in size and requiring the square of this quantity for memory. The grid point option requires
less memory and is appreciably faster than the degree-of-freedom option.
3. In all eigensolution methods READ will calculate rigid body modes accurately without the
presence of SUPORTi entries in the Bulk Data Section. The SUPORTi entries define the r-set, the
reference set for rigid body modes. If all of the input blocks associated with the r-set are input
properly, the static shapes input in the DAR data block are used to compute rigid body modes. If
the calculated frequencies associated with these modes are small numbers, they are reset to binary
zero.
Modern r-set introduced in Version 70.5:
DXR has the same number of rows as KXX and both are partitioned from DAR and KAA using
PARTVEC. DAR is the motion of the a-set variables due to unit motion of each r-set point,
successively, as calculated by static analysis and ignoring mass effects. Linear combinations of
these shapes are used for rigid body mode shapes that are orthogonal with respect to the mass
matrix.
5($'.;;0;;05';5'<1$0,&86(7&$6(&&3$579(&6,/
,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
Obsolete r-set processing as in Version 70:
Main Index
1315 READ
Extracts real symmetric system eigenvalues
DMX and VACOMP are used for special r-set processing based on the r-set rows being added to
DMX in the READ module. DMX is partitioned from DM in the way KXX is partitioned from
KAA. In other words, the same degrees-of-freedom are partitioned for both KXX and DMX. The
modern method uses DAR instead, with the r-set rows included in DAR.
5($'.;;0;;05'0;'<1$0,&86(7&$6(&&3$579(&6,/
VACOMP,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
Use of this obsolete format is no longer recommended, and provisions for it may be removed
from the code in a future version. Refer to old documentation for a description of this obsolete
form.
4. For the Lanczos and INV methods KAA may be indefinite and MAA must be at least positive
semidefinite. For the unmodified tridiagonal methods (for example, HOU) KAA may be
indefinite, but MAA must be non-singular. For the modified and auto tridiagonal methods (for
example, MHOU and AHOU) MAA may be singular when [KAA + lambda*MAA] is non-
singular. Lambda is an internally calculated shift. The matrix sum will be singular or approach
singularity only when the system contains massless mechanisms. A shaft model made with bar
elements using point masses is an example of a system with a massless mechanism. The torsion
DOFs are not constrained to ground, and the point masses provide no rotary inertia. See the
MODERS subDMAP for the auto-omit DMAP steps used to remove rows and columns with null
mass for the tridiagonal methods. This makes the modified methods more efficient, and removes
some (but not all) possible causes of singularity in the mass matrix.
5. For the Lanczos and Sturm Inverse methods, LAMA and PHA may also be input if the APPEND
mode is being used.
6. LAMA and OElGS are suitable for OFP output.
7. MI may not be purged.
8. Parallel processing in this module (Householder method only) is selected with the NASTRAN
statement keyword PARALLEL (or SYSTEM(107)), see the <emphasis>MSC Nastran Quick
Reference Guide, Section 1.
9. If an r-set is present and special processing of rigid body modes is desired then it is recommended
that DAR have the same number of rows as KAA. If not, then either MR, USET, or VACOMP
should be specified.
10. For more detailed information on parameters F1 through NORM, please refer to the descriptions
of the EIGR and EIGRL Bulk Data entries in the <emphasis>MSC Nastran Quick Reference
Guide.
11. For the Lanczos method:
By default, the Lanczos method uses sparse matrix methods. To use regular matrix methods
specify SPARSE = 1 on the NASTRAN statement or specify PUTSYS (126,1) just prior to the
READ module.
Main Index
READ
Extracts real symmetric system eigenvalues
1316
In vibration analysis MAA must be positive semidefinite. In buckling analysis, KAA must be
positive semidefinite. For either type of analysis, the other input matrix may be indefinite.
Performance-enhancing options may be requested on system cells 193 through198. Use the
NASTRAN statement or the PUTSYS DMAP statement. See the MSC.Nastran Numerical
Methods Users Guide.
The Lanczos method was updated in Version 70.5 with several enhancements related to shift
logic. However, if the Lanczos method in Version 70 is desired then specify NASTRAN
SYSTEM(273)=1 in the File Management Section or PUTSYS(1,273) in the DMAP before the
READ module.
For maximum efficiency in the Lanczos method, it is recommended that USET, SIL, and
EQEXIN data blocks and SETNAME parameter are specified. If the size of KAA is not the same
as the size of the set indicated by SETNAME, then PARTVEC should also be specified.
12. If SID=-2, then NE is used to modify the ND parameter. ND is modified accordingly:
ND*(1+NE/100)
13. For the Lanczos (METH='LAN') and Householder (METH='HOU', 'MHOU', and 'AHOU')
methods, if the problem can fit into memory then a "QL" Householder eigensolution will be
performed. If the problem cannot fit in memory then the old method is used because the "QL"
method does not have spill capability.
The criterion for switching from the requested method to the "QL" method is controlled system
cell 359 and the NE parameter. The default value for system cell 359 is 1 which means:
if METH='LAN' is requested, the program wil automatically switch to AHOU when the size of
the problem less than or equal to NE.
if METH='HOU', 'MHOU', and 'AHOU' then the program will automatically switch to the "QL"
solution if the problem will fit in memory.
Examples:
1. Suppose the user has a matrix for which he or she wishes to extract eigenvalues via the
classical equation . Presuming is input via DMI Bulk Data entries and
there is an EIGR or EIGRL Bulk Data entry that is selected in Case Control (METHOD), the
following DMAP sequence will be sufficient:
PARAML A//TRAILER/1/S,N,NCOLA $
MATGEN ,/IDEN/1/NCOLA $
READ A,IDEN,,,DYNAMICS,,CASECC,,,,,,,,/LAMA,VECTOR,MI,
OEIGS,/MODES/S,N,NEIGS/1 $
OFP LAMA,OEIGS//$
IF(NEIGS>-1) MATPRN VECTOR// $
2. Suppose that the user wishes to now calculate 5 modes of the equation [[A] - lambda [I]]{phi} =
0 in a subDMAP where the DYNAMICS and CASECC data blocks are not available:
$ GENERATE IDEN AS SHOWN IN THE PRIOR EXAMPLE
READ A,IDEN,,,,,,,,,,,,,/LAMA,VECTOR,MI,
OEIGS/'MODES'/S,N,NEIGS////-1////5 $
OFP LAMA,OEIGS//$
IF (NEIGS > -1) MATPRN VECTOR// $
A | |
A I | | u { } 0 = A | |
Main Index
1317 RESMOD
Perform linear algebra functions to support residual vector calculations
Format:
Input Data Block:
Output Data Block:
Parameters:
Option P1 = 'ATBC'
Performs the matrix multiplication if is present; otherwise.
RESMOD
Perform linear algebra functions to support residual vector
calculations
RESMOD I1,I2,I3,I4,I5/
O1,O2,O3,O4,O5/
P1/P2/P3/P4/P5/P6 $
Ii Input data blocks. I1 is required. The presence of I2 through I5
depends on P1.
Oi
Output data blocks. The presence of Oi depends on P1.
P1 Input-character-no default. Option selection described in the table below.
P1 Description
'ATBC' Performs the matrix multiplication [I1]
T
[I2][I3] if [I3] is present;
[I1] [I2][I1] otherwise.
'MPART' Partitions stiffness, mass, and eigenvector matrices based on mass
content
'LININD' Find linearly independent and dependent vectors of a matrix
'LDSWEEP' Sweeps "modal" loads for load vectors
'USWEEP' Sweeps a matrix for small vectors
P2,P3,P4 Input-integer-default=0. Integer parametric data depending on P1.
P5,P6 Input-real-default=0.0. Real parametric data depending on P1.
I1 | |
T
I2 | | I3 | | I3 | | I1 | |
T
I2 | | I1 | |
Main Index
RESMOD
Perform linear algebra functions to support residual vector calculations
1318
Format:
Input Data Block:
Output Data Block:
Remark:
[I2] is assumed to be symmetric.
Example:
Compute the product
Option P1 = 'MPART'
Partitions stiffness, mass, and eigenvector matrices based on mass content.
Format:
Input Data Blocks:
RESMOD I1,I2,I3,,/O1,,,,/'ATBC' $
Ii Matrix data block.
O1 Matrix product.
RESMOD A,B,C,,/D,,,,/'ATBC' $
RESMOD PHI,K,M,,/PHI0,K0,PHI1,M1,K1/
'MPART'////ZROSTIFF/ZROMASS $
PHI Eigenvector matrix.
K Stiffness matrix associated with PHI.
M Mass matrix associated with PHI.
PHI0 Massless eigenvectors.
K0 Stiffness associated with PHI0.
PHI1 Eigenvectors which contain mass.
D | | A | |
T
= B | | C | |
Main Index
1319 RESMOD
Perform linear algebra functions to support residual vector calculations
Parameters:
Remarks:
1. PHI, K, and M must be real.
2. If ZROSTIFF is null then 1.E-08 will be assumed.
3. If ZROMASS is null then 1.E-16 will be assumed.
Option P1 = 'LININD'
Partitions a matrix into linearly independent and dependent sets.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. If ZROVEC is null then 1.E-06 is used.
2. If M is purged then an identity matrix is assumed.
3. and should satisfy the following conditions:
M1 Mass associated with PHI1.
K1 Stiffness associated with PHI1.
ZROSTIFF Input. Null stiffness filter criteria.
ZROMASS Input. Null mass filter criteria.
RESMOD U,M,,,/U0,U1,,,/'LININD'////ZROVEC $
U Any real matrix.
M Mass matrix associated with U.
U0 Linearly dependent vector set from U.
U1 Linearly independent vector set from U.
ZROVEC Input. Null filter criteria.
U0 | | U1 | |
Main Index
RESMOD
Perform linear algebra functions to support residual vector calculations
1320
= computational zeros
4. U and M must be real.
Option P1 = 'LDSWEEP'
Sweeps modal loads for load vectors.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
Remarks:
1. The filtered load vectors are:
2. LD, PHI, MXX, and MQQ must be real.
Option P1 = 'USWEEP'
Sweeps a matrix for small vectors.
Format:
RESMOD LD,PHI,MXX,MQQ,/LDIND,,,,/
'LDSWEEP'/NORMFLG $
LD Load matrix
PHI Eigenvector matrix
MXX Mass matrix, physical degrees of freedom.
MQQ Mass matrix, modal degrees of freedom.
LDIND Filtered load vectors.
NORMFLG Input. Normalization flag. Set to -1 to unit normalize load vectors.
RESMOD U,PHI,MXX,MQQ,/UIND,,,,/'USWEEP'/NORMFLG $
I0 | |
T
M | | U0 | |
U1 | |
T
M | | U1 | | 0.0 >
LDIND | | LD | | M | | PHI | | PHI | |
T
M | | PHI | | ( )
1
PHI | |
T
LD | | =
Main Index
1321 RESMOD
Perform linear algebra functions to support residual vector calculations
Input Data Blocks:
Output Data Block:
Parameter:
Remarks:
1. The filtered vectors are:
2. U, PHI, MXX, and MQQ must be real.
U A set of vectors.
PHI Modal vectors.
MXX Mass matrix, physical degrees of freedom.
MQQ Mass matrix, modal degrees of freedom.
UIND Filtered vectors.
NORMFLG Input. Normalization flag. Set to -1 to unit normalize input vectors.
UIND | | U | | PHI | | MQQ | | PHI | |
T
( )
1
+ =
Main Index
RESTART
Data block comparison
1322
Compares two data blocks and invokes dependencies.
Format:
Input Data Blocks:
Output Data Block:
RESTART
Data block comparison
RESTART DB1,DB2,DLSTIN/DLSTOUT/
INVOKE/SPEXP/DPEXP/NDDLNAM/PRTUNIT $
DBi Data blocks to be compared.
DLSTIN A list of data blocks and the associated pathnames. DLSTIN was built as
DLSTOUT during prior executions of the RESTART module. DLSTIN is used to
invoke the same restart dependencies, but with different qualifiers, as done during
previous RESTART comparisons.
DLSTOUT A list of data blocks and associated pathnames defined from DB1 that were deleted
during this execution of the RESTART module. If DLSTOUT is designated as an
APPEND file, then DLSTOUT contains the list of data blocks deleted (or marked
for deletion during this) from prior executions of the module.
Main Index
1323 RESTART
Data block comparison
Parameters:
Remarks:
1. Any or all input data blocks may be purged.
2. If DLSTIN is not purged, the DB1 and DB2 must be purged.
3. If DBI and DB2 are not purged, the DLSTIN must be purged.
4. If INVOKE = TRUE then RESTART also deletes data blocks according to the data dependencies
(see DEPEN (Ch. 3)). Only data blocks with the current values of qualifiers for the path given by
DBi are deleted. If the paths of DBi and the path of the data block to be deleted differ, then all
intersecting qualifiers use the current value and the remaining nonintersecting qualifiers use the
wildcard (*) to determine deletion.
Example:
In this example, GEOM1 and GEOM2 are compared to the restart versions defined in the DBVIEW
statement. Changes are marked within the HIST file. Deletions are performed after SEID is set.
FILE HIST=APPEND $
PROJVER //RESTART/S,N,RESPRJ/S,N,RESVER/S,N,EXIST $
DBVIEW GEOM1R = GEOM1 (WHERE VERSION=RESVER) $
DBVIEW GEOM2R = GEOM2 (WHERE VERSION=RESVER) $
RESTART GEOM1,GEOM1R,/HIST/ $
INVOKE Input-logical-default=FALSE. If INVOKE = TRUE then restart deletions are
performed. If INVOKE = FALSE (default) then no deletions are performed, but
data blocks are marked within DLSTOUT.
SPEXP Input-integer-default=6. Single-precision tolerance exponent. Two single-precision
numbers x and y are considered equal if
DBEXP Input-logical-default=12. Double-precision tolerance component. Two double-
precision numbers, x and y are considered equal if
NDDLNAM Input-character-default=' '. NDDL is the name of the DATABLK statement to
use for a description in the comparison that overrides the name of DB1.
PRTUNIT Input-integer-default=0. Fortran unit flag to print differences betwee DB1 and
DB2.
=0 Print to f04.
<>0 Print to f06.
x y 10
SPEXP
<
x y 10
DBEXP
<
Main Index
RESTART
Data block comparison
1324
RESTART GEOM2,GEOM2R,/HIST/ $
SEID = SEDWN $
RESTART,,,HIST//TRUE $
Main Index
1325 RMDUPBLK
Removes duplicate records from the Bulk Data
Removes duplicate records from the Bulk Data.
Format:
Input Data Blocks:
None.
Output Data Blocks:
Parameters:
Remarks:
1. BULK is both and input and output data block and therefore must be declared as an append file
on the FILE statement. For example:
2. The actions taken by this module and tolerance for defining duplicate real numbers are both
specified in system cell 402:
3. Only the CORD2C, CORD2R, CORD2S, and GRID Bulk Data entries are checked and
candidates for deletion.
RMDUPBLK
Removes duplicate records from the Bulk Data
RMDUPBLK /BULK/S,N,NEWBULK $
BULK Table of all sorted Bulk Data entries.
NEWBULK Output-logical-default=FALSE. NEWBULK creation flag.
FALSE No
TRUE Yes
FILE IBULK=APPEND $
RMDUPBLK /IBULK $
< 0.0 Nothing is done and no entries are deleted.
> 0.0 Tolerance checking will be done to determine if the entries are deletable.
= 0.0 No tolerance checks will be performed; only physically identical records will be
deleted.
Main Index
RMG2
Processes radiation exchange coefficients
1326
Processes radiation exchange coefficients to produce temperature heat flux transfer matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
RMG2
Processes radiation exchange coefficients
RMG2 EST,MPOOL,MUGNI,KGGNL,MPT,DIT,BGPDT,SIL,USET/
RDEST,RECM,RGG,KGGNL1/
TABS/SIGMA/S,N,NORADMAT/LUSET $
EST Element summary table.
MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images
MUGNI Temperature matrix for stiffness update.
KGGNL Conduction matrix in g-set for material nonlinear elements only.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
BGPDT Basic grid point definition table.
SIL Scalar index list.
USET Degree-of-freedom set membership table for g-set.
RDEST Radiation element summary table.
RECM Radiation exchange coefficient matrix.
RGG Radiation transfer matrix in the g-set.
KGGNL1 Conduction matrix in g-set for material nonlinear elements only and
updated for radiation.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute
radiant heat flux.
NORADMAT Input/output-integer-default=-1. Radiation flag.
Main Index
1327 RMG2
Processes radiation exchange coefficients
Remark:
If KGGNL is not purged then LUSET is determined from KGGNL.
2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
Main Index
ROTOR
Process rotordynamics Bulk Data input
1328
Process rotordynamics Bulk Data input.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ROTOR
Process rotordynamics Bulk Data input
ROTOR BGPDT,DYNAMIC,DIT,CSTM,VDA,EDOM/
ROTOR,ROTORT/
CONFAC/APP/ROTPRNT/ROTTFLG $
BGPDT Basic grid point definition table.
DYNAMIC Table of Bulk Data entry images related to dynamics.
DIT Table of TABLEij Bulk Data entry images.
CSTM Table of coordinate system transformation matrices.
VDA Partitioning vector--d-set size--with 1.0's at extra point degrees-of-
freedom. May be purged if no extra points are specified.
EDOM Table of Bulk Data entries that contain the DDVAL entries referenced
by RSPINR records in DYNAMIC.
ROTOR Table of rotordynamic parameters.
ROTORT Table of rotordynamics user input for transient analysis.
CONFAC Input-real-default=1.0E-5.
APP Input-character-default='XXXXXXXX'. Analysis type.
'CEIGEN' Complex eigenvalues.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'STATICS' Statics.
ROTPRNT Input-integer-default=1. Rotor summary print flag.
<>0 Print.
=0 Do not print.
Main Index
1329 ROTOR
Process rotordynamics Bulk Data input
ROTTFLG Input-integer-default=0. Rotordynamics transient solution sequence flag for
extra point processing.
1: SOL 400
0: SOL 129
Main Index
ROTRDR1
Creates coriolis and circulation matrices
1330
Creates coriolis and circulation matrices based on rotordynamics user input and also drives DMAP rotor
loop.
Format:
Input Data Blocks:
Output Data Blocks:
ROTRDR1
Creates coriolis and circulation matrices
ROTRDR1 BGPDT,CSTM,ROTOR,MG6,ROTORT/
BCGG,TI,VGROT/
S,N,RECNUM/S,N,ROTORID/CONFAC/WTMASS/
S,N,METHSID/S,N,SDAMPSID/S,N,KDAMP/APP/ROTPRNT
$
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
ROTOR Table of rotordynamics user input.
MG6
ROTORT Table of rotordynamics user input for transient analysis.
BCGG
TI
VGROT
Main Index
1331 ROTRDR1
Creates coriolis and circulation matrices
Parameters:
RECNUM Input/output-integer-default=1.
ROTORID Input/output-integer-default=0.
CONFAC Input-real-default=1.0E-5.
WTMASS Input-real-default=0.0. Scale factor on structural mass matrix.
METHSID Output-integer-default=0. Eigenvalue extraction entry set
identification number.
SDAMPSID Output-integer-default=0. Modal damping (TABDMP1) entry set
identification number.
KDAMP Output-integer-default=0. Viscous modal to structural damping flag. If set to -1,
then viscous modal damping (SDAMPING Case Control command) will be
included in the stiffness matrix as structural damping:
1 Yes
2 No
APP Input-character-default='XXXXXXXX'. Analysis type.
'CEIGEN' Complex eigenvalues.
'FREQRESP' Frequency response.
''TRANRESP' Transient response.
'STATICS' Statics.
<>0 Print.
=0 Do not print.
Main Index
ROTRDR2
Set parameters for rotordynamic looping
1332
Set parameters for rotordynamic looping.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
ROTRDR2
Set parameters for rotordynamic looping
ROTRDR2 //
S,N,RECNUM/APP/ /S,N,ROTORID/S,N,SYNFLAG/
/ /S,N,GR/S,N,RAVG/
S,N,ALPHAR1/S,N,ALPHAR2 $
CASECC Table of Case Control command images.
DIT Table of TABLEi, entry images.
ROTOR
ROTORT
RECNUM Input/output-integer-default=1.
APP Input-character-default=' '.
FREQ Input-real-default=0.0.
TIME Input-real-default=0.0.
ROTORID Output-integer-default=0.
SYNFLAG Output-integer-default=0.
RSCALE0 Output-real-default=0.0.
OMEGA Output-real-default=0.0.
CASECC
DIT
)
`
ROTOR
ROTORT
)
`
FREQ
TIME
)
`
S,N,RSCALE0
S,N,OMEGA
)
`
S,N,RSCALE1
S,N,OMEGADOT
)
`
Main Index
1333 ROTRDR2
Set parameters for rotordynamic looping
RSCALE1 Output-real-default=0.0.
OMEGADOT Output-real-default=0.0.
GR Output-real-default=0.0.
RAVG Output-real-default=0.0.
ALPHAR1 Output-real-default=0.0. Rayleigh damping coefficient for the rotor.
ALPHAR2 Output-real-default=0.0. Rayleigh damping coefficient for the rotor.
Main Index
ROTRUTL
Perform various utilities for rotordynamics processing.
1334
Format:
Input Data Block:
Output Data Block:
Parameters:
Option IOPT = 1
Format:
Input Data Blocks
ROTRUTL
Perform various utilities for rotordynamics processing.
ROTRUTL I1,I2,I3,I4,I5,I6/
O1,O2,O2/
P1/P2/P3/P4/P5/P6 $
Ii Input data blocks. I1 is required. The presence of I2 through I5 depends
on P1.
Oi Output data blocks. The presence of Oi depends on P1.
P1 Input-integer-default=0. Option selection described in below.
P2 Input-integer-default=0. Integer parametric data depending on P1.
P3 Input-real-default=0.0. Real parametric data depending on P1.
P4 Input-integer-default=0. Integer parametric data depending on P1.
P5 Input-character-default=blank. Character parametric data depending
on P1.
P6 Input-integer-default=0. Integer parametric data depending on P1.
ROTRUTL FINRL,BGPDT,,,,/MINRL,,/1 $
FINRL G-set by 6 matrix of inertial forces due to unit accelerations in 6
directions.
BGPDT Basic grid point definition table.
Main Index
1335 ROTRUTL
Perform various utilities for rotordynamics processing.
Output Data Block:
Option IOPT = 2
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Option IOPT = 3
Format:
Input Data Blocks:
MINRL G-set square mass matrix that would produce these forces where
MINRL is block diagonal with 3x3 blocks.
ROTRUTL CASECC,DYNAMIC,,,,/
NHFRL,NHOUT,/2/S,N,NHARM/S,N,NHSUBFAC/S,N,NLHI
C $
CASECC Table of Case Control command selections.
DYNAMIC Table of Bulk Data Entries related to dynamics. NLHARM, NLFREQ,
NLFREQ1, and NLHOUT records are read.
NHFRL Frequency response list similar to FRL.
NHOUT
NHARM Output.
NHSUBFAC Output.
NLHIC Ouptut.
ROTRUTL CASECC,ROTOR,,,,/ROTORX,,/3//SPEED $
CASECC Table of Case Control command selections. Read RGYRO selection.
ROTOR Table of rotordynamics user input.
Main Index
ROTRUTL
Perform various utilities for rotordynamics processing.
1336
Output Data Block:
Parameter:
Option IOPT = 4
Format:
Input Data Block:
Output Data Block:
Parameters:
Option IOPT = 5
Format:
Input Data Block:
ROTORX Updated ROTOR so that the referenced RGYRO record reads
"ASYNC" and "FREQ" and SPEED is also written to the RGYRO
record.
SPEED Input. Speed.
ROTRUTL EPT,,,,,/EPTX,,/4/PID/DDVALUE/FID/ITYPE $
EPT Element property table.
EPTX Element property table updated with Campbell parameters.
PID Input. Property or material identification number.
DDVAL Input. Campbell parameter.
FID Input. Campbell parameter.
ITYPE Input. Campbell parameter.
ROTRUTL ROTOR,,,,/,,/5/IRGYRO//S,N,REFROTR $
ROTOR Table of rotordynamics user input.
Main Index
1337 ROTRUTL
Perform various utilities for rotordynamics processing.
Output Data Blocks:
None.
Parameters:
Remark:
If the ROTOR table does not exist REFROTR is output as 0 (zero). If IRGYRO is not found in ROTOR
then REFROTR is set to -1.
Option IOPT = 6
Format:
Input Data Block:
Output Data Block:
Parameters:
Option IOPT = 7
Add ROTORG entries into DYNAMIC based on the SEPART and SEROT .
Format:
IRGYRO Input. RGYRO record identification number.
REFROTR Output. Reference rotor ID on the RGYRO.
ROTRUTL DYNAMIC,,,,,/SEROT,,/6/S,N,NROTOR//S,N,NROTORS
E $
DYNAMIC Table of Bulk Data Entries related to dynamics.
SEROT Table of Bulk Data entries related to dynamics.
NROTOR Output. Number of ROTOR entries.
NROTORSE Output. Number of ROTORSE entries.
ROTRUTL DYNAMIC,SEPART,SEROT,BGPDT,,/DYNAMICX,,/7 $
Main Index
ROTRUTL
Perform various utilities for rotordynamics processing.
1338
Input Data Block:
Output Data Block:
Parameters:
None.
Option IOPT = 8
Processes forces for nonlinear harmonic response
Format:
Input Data Blocks:
Output Data Blocks:
DYNAMIC Table of Bulk Data Entries related to dynamics.
SEPART Partitioning vector.
SEROT Table of Bulk Data Entries related to dynamics.
BGPDT Basic grid point definition table.
DYNAMICX DYNAMIC updated with SEPART and SEROT data.
ROTRUTL DYNAMIC,CASECC,BGPDT,EVEC,USETD,DIT/
NLFTAB,NLPART,/8/S,N,UVAFLAG $
DYNAMIC Table of Bulk Data Entries related to dynamics.
CASECC Table of Case Control command selections.
BGPDT Basic grid point definition table.
EVEC D-set partitioning vector indicating extra point locations.
USETD Degree-of-freedom set membership table for p-set.
DIT Table of TABLEij Bulk Data entry images.
NLFTAB Nonlinear data from NLRGAP, NLRSFD, NOLINi records.
NLPART Nonlinear forces degrees-of-freedom for d-set.
Main Index
1339 ROTRUTL
Perform various utilities for rotordynamics processing.
Parameter:
Option IOPT = 9 or -9
Format:
Input Data Block:
Output Data Block:
Parameters:
Option IOPT = 10
Format:
Input Data Blocks:
None.
UVAFLAG Output. Bit pattern indication force term association with U (disp),
V(vel) or A (acce).
ROTRUTL U,,,,,/UAVG,,/9/NHARM/FREQ/CONDIV//ISUBFAC $
U Solution matrix in d-set.
UAVG Converged solution matrix of Fourier components.
NHARM Input.
FREQ Input.
CONDIV Input.
ISUBFAC Input.
ROTRUTL ,,,,,/MFCDISP,MFCVELO,/10/NHARM//NHPLUS $
Main Index
ROTRUTL
Perform various utilities for rotordynamics processing.
1340
Output Data Blocks:
Parameters:
Option IOPT = 11
Format:
Input Data Blocks:
Output Data Blocks:
Option IOPT = 12
Convert U (fourier components of d-set) into TIC records to be used in a transient response analysis
MFCDISP Matrix of cosines and sines to convert Fourier coefficients to time
domain displacements.
MFCVELO Matrix of cosines and sines to convert Fourier coefficients to time
domain velocities.
NHARM Input.
NHPLUS Input.
ROTRUTL U,PTVEC,MFCDISP,MFCVELO,,/UT,VT,/11 $
U Solution matrix.
PTVEC Partitioning vector.
MFCDISP Matrix of cosines and sines to convert Fourier coefficients to time
domain displacements.
MFCVELO Matrix of cosines and sines to convert Fourier coefficients to time
domain velocities.
UT Matrix of displacements in time but only for the degrees-of-freedom
specified in PTVEC.
VT Matrix of velocities in time but only for the degrees-of-freedom
specified in PTVEC.
Main Index
1341 ROTRUTL
Perform various utilities for rotordynamics processing.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Option IOPT = 13
Format:
Input Data Block:
Output Data Blocks:
None.
Parameters:
ROTRUTL DYNAMIC,BGPDT,EVEC,U,,/,,/12/TICID/FREQ/NHARM
$
DYNAMIC Table of Bulk Data Entries related to dynamics.
BGPDT Basic grid point definition table
EVEC D-set partitioning vector indicating extra point locations
U Solution matrix.
TICID Input.
FREQ Input.
NHARM Input.
ROTRUTL DIT,,,,,/,,/13/SDAMP/S,N,TR/S,N,INFOR $
DIT Table of TABLEij Bulk Data entry images.
SDAMP Input.
TR Output.
INFOR Output.
Main Index
ROTRUTL
Perform various utilities for rotordynamics processing.
1342
Option IOPT = 14
Determine convergence and line search in nonlinear harmonic response analysis.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
ROTRUTL RESU0,RESU1,,,,/HISTAB,,/14/S,N,ICODE/NLHTOL $
RESU0 Iterate matrix before DECOMP/FBS (= Au-P-F(u))
RESU1 Iterate matrix after DECOMP/FBS with 0.0 < LAMC <= 1.0
HISTAB
ICODE Output. Convergence code.
NLHTOL Input. Convergence tolerance.
Main Index
1343 RSPEC
Converts transient response motion for plotting
Converts transient response motion to response spectra output suitable for plotting.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Example:
Excerpt from subDMAP SEDRCVR:
DO WHILE ( RECORD<>-1 ) $
RSPEC FRL,OUGV2,SPSEL/OXRESP/S,N,RECORD $
IF ( RECORD>=0 ) THEN $
IF ( RSPRINT>=0 ) OFP OXRESP//S,N,CARDNO $
XYTRAN XYCDBDR,OXRESP,,,,/XYPLTSS/'RSPEC'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOXYPLT/TABID $
IF ( NOXYPLT>=0 ) XYPLOT XYPLTSS// $
RSPEC
Converts transient response motion for plotting
RSPEC FRL,OUG2,SPSEL,OVG2/
OXRESP/
S,N,SPSELREC/DVAFLAG $
FRL Frequency response list.
OUG2 Table of displacements in SORT1 format from transient response
analysis.
SPSEL Table of response spectra generation correlation selections.
OVG2 Table of velocities in SORT2 format.
OXRESP Table of response spectra in SORT2 format.
SPSELREC Input/output-integer-default=0. Last record number processed in SPSEL. Set to -
1 when processing last record.
DVAFLAG Input-integer-default=-1. Flag indicating velocities are contained in separate data
blocks and any associated outputs follow suit.
-1 Velocities are contained in OUG2.
1 Velocities are contained in OVG2
Main Index
RSPEC
Converts transient response motion for plotting
1344
ENDIF $ RECORD>=0
ENDDO $ RECORD<>-1
Main Index
1345 SCALAR
Matrix element extractor
Extracts a specified element from a matrix for use as a parameter.
Format:
Input Data Block:
Output Data Blocks:
None.
Parameters:
Remarks:
1. If the input is purged, the module returns with a VALUE = (0.,0.).
2. See also PARAML A//DMI option.
3. Prior to Version 2001, VALUED was a single precision parameter. To convert an old DMAP that
uses the pre-Version 2001format, see Example 2.
4. If IROW (or ICOL) is greater than the umber of rows (or columns) in A then IROW or (ICOL)
will reset to -1 and CDVALUE remains unchanged from its value prior to calling SCALAR.
Examples:
1. Extract the matrix element in row 1 and column 2 of matrix A and assigns it to the parameter
VALUE.
SCALAR A//1/2/S,N,VALUE $
2. Convert a pre-Version 2001 SCALAR module call to the current version.
SCALAR A//1/2/S,N,CDVALUE $
$ Add following statements
SCALAR
Matrix element extractor
SCALAR A//S,N,NROW/S,N,NCOL/S,N,VALUED $
A Any matrix (real or complex).
IROW Input/output-integer-default=1. Row number of element to be
extracted from [A]. See Remark 4.
ICOL Input/output-integer-default=1. Column number of element. See
Remark 4.
VALUED Output-complex double precision-default=(0.D0,0.D0). Contents of
element at IROW-th row and ICOL-th column in matrix [A].
Main Index
SCALAR
Matrix element extractor
1346
TYPE PARM,,CS,N,CSVALUE $
CSVALUE = SINGL(CDVALUE) $
3. Read the values from a matrix V of unknown length into a parameter.
TYPE PARM,,I,N,II $ LOOP COUNTER
TYPE PARM,,I,N,VI=1 $ SELECTS COLUMN TO SEARCH
DO WHILE (II>=0) $ STOP WHEN II NEGATIVE
II = II + 1 $
SCALAR V//1/S,N,II/S,N,VI $ II RESET TO -II WHEN AT END OF
MATRIX.
IF (II>0) MESSAGE //'INDEX'/II/'VALUE'/VI $
ENDDO $
Main Index
1347 SDP
Calculates nondimensional stability and control derivatives
Calculates and prints the nondimensional stability and control derivatives and the intercepts of the quasi-
steady stability derivatives.
Format:
Input Data Blocks:
SDP
Calculates nondimensional stability and control derivatives
SDP CASEA,AECTRL,AERO,CSTMA,EDT,
AEDBUXV,AEMONPT,MONITOR,MPARV,MPAERV,MPAEUV,
MPSRV,MPSERV,MPSIERV,MPSEUV,MPSIEUV,UXTRIM,AED
BINDX,PRBDOFS/
STBDER,UXDIFV/
MACH/Q/AECONFIG/SYMXY/SYMXZ/LPRINT $
CASEA A single record (subcase) of CASECC for aerodynamic analysis.
AECTRL Table of aerodynamic model's control definition.
AERO Table of control information for aerodynamic analysis.
CSTMA Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points.
EDT Element deformation table. Contains aerodynamic model records.
AEDBUXV Matrix of vehicle states.
AEMONPT Aerodynamic monitor points.
MONITOR Structural monitor points.
MPARV Rigid monitor point loads on aerodynamic model.
MPAERV Elastic restrained monitor point loads on aerodynamic model.
MPAEUV Elastic unrestrained monitor point loads on aerodynamic model.
MPSRV Rigid splined monitor point loads on structural model.
MPSERV Elastic restrained monitor point loads on structural model.
MPSIRV Inertial restrained monitor point loads on structural model.
MPSEUV Elastic unrestrained monitor point loads on structural model.
MPSIUV Inertial unrestrained monitor point loads on structural model.
UXTRIM UX vector at trim.
Main Index
SDP
Calculates nondimensional stability and control derivatives
1348
Output Data Block:
Parameters:
Remark:
Each stability derivative has four forms based on:
The aerodynamic model without any consideration of the structural model.
The aerodynamics after they have been transferred to the structure but before any elastic effects
are computed.
The aerodynamics after they have been transferred to the structure and elastic deformations have
been included. It is assumed that the model is restrained at the support points for this derivative.
The aerodynamics after they have been transferred to the structure and elastic deformations have
been included. Movement of the supported degrees of freedom is included in this derivative.
AEDBINDX Aeroelastic database index for monitor point data.
PRBDOFS Partitioning matrix to partition the "active" URDDI from the
"inactive". Active URRDI are assigned a 1.0 value and are connected
to the SUPORT degrees-of-freedom.
STBDER Table of aerostatic stability derivatives for a single subcase.
UXDIFV Derivative interpolation factors matrix at UX = UXREF.
MACH Input-real-default=no default. Mach number.
Q Input-real-default=no default. Dynamic pressure.
AECONFIG Input-character-no default. Aerodynamic configuration.
SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.
SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.
LPRINT Input-logical-default=TRUE. Print flag for stability derivatives.
Main Index
1349 SDR1
Computes solution and single-point forces
Computes and appends the solution (displacements, velocities, acceleration) and single-point forces of
constraint at the g-set for each boundary condition. Also appends applied loads.
Format:
Input Data Blocks:
Output Data Blocks:
SDR1
Computes solution and single-point forces
SDR1 USET,PG,UL,UOO,YS,GOA,GM,PS,KFS,KSS,QR,KGG/
UG,PGT,QG/
NSKIP/APP/NOQG $
USET Degree-of-freedom set membership table for g-set.
PG Static load matrix applied to the g-set.
UL Displacement matrix in l-set.
UOO Displacement matrix in o-set due to applied loads on the o-set with the
a-set fixed (set to zero).
YS Matrix of enforced displacements or temperatures.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
PS Static load matrix partitioned to the s-set.
KFS Stiffness matrix partition (f-set by s-set) from KNN.
KSS Stiffness matrix partition (s-set by s-set) from KNN.
QR Matrix of determinate support forces.
KGG Stiffness matrix in g-set which is used to compute the Lagrange
multiplers.
UG Displacement matrix in the g-set appended for all boundary conditions.
PGT Static load matrix applied to the g-set appended for all boundary
conditions.
QG Single-point constraint forces of constraint matrix in the g-set
appended for all boundary conditions.
Main Index
SDR1
Computes solution and single-point forces
1350
Parameters:
Method:
Static Analysis
In the case of static analysis, SDR1 recovers dependent displacements
(5-40)
(5-41)
where
(5-42)
Enforced displacements are combined with
(5-43)
NSKIP Input-integer-no default. The first subcase of the current boundary condition.
APP Input-character-no default. Analysis type.
Allowable values:
'STATICS' Statics.
'REIG' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
'MMREIG' Normal modes for matrix method.
'BKL0' Pre-buckling (statics).
'BKL1' Buckling.
'DYNAMIC' Dynamics.
NOQG Input-integer-default=0. Single point forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
u
l
u
r )
`
u
a
{ }
u
a
u
o )
`
u
f
{ }
u
o
{ } G
oa
t
| | u
a
{ } u
o
o
{ } + =
u
f
u
f
Y
s )
`
u
n
{ }
Main Index
1351 SDR1
Computes solution and single-point forces
(5-44)
where
(5-45)
and recovers single point forces of constraint
(5-46)
Eigenvalue Analysis
In the case of eigenvalue analysis SDR1 recovers dependent components of the eigenvectors
(5-47)
(5-48)
(5-49)
(1)
(5-50)
and single-point forces of constraint
(5-51)
If PARAM,DYNSPCF,NEW (default) then the single-point forces are computed as follows:
(5-52)
Remarks:
1. If NSKIP is greater than 1 and the outputs are declared APPEND on the FILE statement than the
outputs will be appended to outputs from prior executions of SDR1.
2. PG, YS, QR, and PS may be purged.
u
n
u
m )
`
u
g
{ }
u
m
{ } G
mn
| | u
n
{ } =
q
s
{ } K
fs
| |
T
u
f
| | K
ss
| | Y
s
{ } P
s
{ } + =
|
o
{ } G
oa
| | |
a
{ } =
|
a
|
o
-----
)
`
|
f
{ } =
|
f
|
s
-----
)
`
|
n
{ } =
|
m
{ } G
mn
| | |
n
{ } =
|
n
|
m
------
)
`
|
g
{ } =
q
s
{ } K
fs
| |
T
|
f
{ } =
q
s
{ } K
sf
| | e
2
M
sf
| | | | |
f
{ } =
Main Index
SDR1
Computes solution and single-point forces
1352
3. If PG is present, PGT must be present.
4. UOO must be present if the o-set exists and APP is equal to 'STATICS' or 'BLK0'.
5. GM must be present if the m-set exists.
6. KFS must be present if the s-set exists and QG is present.
7. KSS must be present if YS is present, the s-set exists, and QG is present.
8. UOO, KSS and YS are ignored if APP is not equal to 'STATICS' or 'BLK0'.
9. See Section 9.4.11 of the MSC Nastran Reference Manual for further discussion of the matrix
operations in SDR1.
10. SDR1 can also process matrices with extra points.
Main Index
1353 SDR2
Creates data recovery output tables
Creates tables based on output requests for forces of single-point and multipoint forces of constraint,
applied loads, displacements, velocities, accelerations, element stresses, element strains, and element
forces. These output tables are suitable for printing, plotting, and various other postprocessing.
Format:
Input Data Blocks:
SDR2
Creates data recovery output tables
SDR2 CASECC, CSTM ,MPT ,DIT , ,
, ETT ,OL ,BGPDT ,PG ,
QG ,UG ,EST ,XYCDB ,OINT ,
PELSET ,VIEWTB ,GPSNT ,DEQATN ,DEQIND ,
DITID ,PCOMPT ,GPKE ,EDT ,VG ,
AG ,QMG ,MMCDB /
OPG ,OQG ,OUG ,OES ,OEF ,
PUG ,OVG ,OAG ,OQMG ,OGPKE1 ,
OSTR ,OMM /
APP /S,N,SORTFLAG/NOCOMP/ACOUSTIC/DVAFLAG/
HTFLOW /GPF /ACOUT /PREFDB /TABS /
SIGMA /ADPTINDX/ADPTEXIT/BSKIP /W3 /
W4 /LANGLE /OMID /G /S,N,OCID $
CASECC Table of Case Control command images.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers. See Remark 5.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data.)
SIL Scalar index list.
SILD Scalar index list for the p-set. See Remark 5.
ETT Element temperature table.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list.
BGPDT Basic grid point definition table.
EQEXIN
EQDYN
)
`
SIL
SILD
)
`
Main Index
SDR2
Creates data recovery output tables
1354
Output Data Blocks:
PG Static load matrix applied to the g-set.
QG Single-point (or mutipoint-QMG) constraint forces of constraint
matrix in the g-set.
UG Displacement matrix in g-set. For the DSVG1 module and transient
analysis, UG can also represent velocity or acceleration.
EST Element summary table.
XYCDB Table of x-y plotting commands.
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
PELSET p-element set table, contains SETS DEFINITIONS. Output by
PLTSET.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
GPSNT Grid point shell normal table.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DITID Table of identification numbers in DIT.
PCOMPT Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry.
GPKE Matrix of grid point kinetic energies.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
VG Velocity matrix in g-set.
AG Acceleration matrix in g-set.
QMG Multipoint constraint forces of constraint matrix in the g-set.
MMCDB Table of MAXMIN(DEF) specifications.
OPG Table of applied loads in SORT1 or SORT2 format.
OQG Table of single forces-of-constraint in SORT1 or SORT2 format.
OUG Table of displacements in SORT1 or SORT2 format.
OES Table of element stresses in SORT1 or SORT2 format.
OEF Table of element forces in SORT1 or SORT2 format.
PUG Matrix of translational displacements for plotting purposes.
OVG Table of velocities in SORT1 or SORT2 format.
Main Index
1355 SDR2
Creates data recovery output tables
Parameters:
OAG Table of accelerations in SORT1 or SORT2 format.
OQMG Table of multipoint forces-of-constraint in SORT1 or SORT2 format.
OGPKE1 Table of grid point kinetic energies in SORT1 format.
OSTR Table of element strains in SORT1 or SORT2 format.
OMM Table of maximum/minimum in SORT1 or SORT2 format
APP Input-character-no default. Analysis type. Allowable values:
'STATICS' Statics.
'REIGEN' Normal modes.
'FREQRESP' Fequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
'MMREIG' Normal modes for matrix method.
'BKL0' Pre-buckling (statics).
'BKL1' Buckling.
'NLST' Nonlinear statics.
'GNST' Geometric nonlinear statics.
SORTFLAG Input/Output-Default=1. SORT1/SORT2 format flag.
If 1 on input then:
The columns of UG, QG, and QMG correspond to frequencies, time steps,
or eigenvalues, etc., depending on APP and output will be in SORT2 format
Then on output:
set to 1 if (1) SORT2 format is requested or XYCDB exists, or (2)
APP=TRANRESP with no SORT1 requests; -1 otherwise.
If 2 on input then:
The rows of UG, QG, and QMG correspond to frequencies, time steps, or
eigenvalues, etc., depending on APP and output will be in SORT2 format.
If APP = TRANRESP then UG, VG, and AG must be input separately.
Then on output:
set to -1 if XYCDB does not exist and (1) SORT1 format is requested or (2)
APP<>TRANRESP with no SORT2 requests; 1 otherwise.
NOCOMP Input-Integer-Default=1.
0 Compute stresses for all elements.
Main Index
SDR2
Creates data recovery output tables
1356
1 Compute stresses for non-composite elements only.
2 Compute element forces and strain curvatures ofr
composite elements in the set referenced by STRESS=sid.
3 Compute element forces and strain curvatures ofr
composite elements using the set referenced by STRAIN=sid.
ACOUSTIC Input-integer-default=0. Fluid-structure analysis flag. If set to 2 then acoustic
pressure is computed for fluid elements.
0 No fluid elements exist.
1 Penalty or fluid acoustic elements exists.
2 Fluid/structure coupling exists.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations will
be output in separate data blocks.
-1 Velocities and acceleratons are contained in OUG.
1 Velocities and acceleratons are contained in OVG and OAG.
HTFLOW Input-integer-default=-1. Heat flow output flag.
-1 Do not compute heat flow.
1 Compute heat flow.
GPF Input-integer-default=-1. Parameter for electromagnetic analysis.
ACOUT Input-character-default='PEAK'. Type of acoustic pressure output in fluid-
structural analysis.
'RMS' Root-mean-square.
'PEAK' Peak.
PREFDB Input-real-default=1.0. Peak pressure reference for pressure level in units of dB
or dBA.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute
radiant heat flux.
ADPTINDX Input-integer-default=-1. P-version analysis adaptivity index.
ADPTEXIT Output-logical-default=FALSE. Set to TRUE if this is the final
BSKIP Input-logical-default=TRUE. Pre-buckling subcase skip flag. If TRUE, then
skip the first subcase in CASECC.
W3 Input-real-default=0. Scale factor denominator for including stiffness in viscous
damping for transient analysis. Usually input by user parameter.
W4 Input-real-default=0. Scale factor denominator for including non-uniform
structural damping in viscous damping for transient analysis. Usually input by
user parameter.
Main Index
1357 SDR2
Creates data recovery output tables
Remarks:
1. Any output may be purged.
2. CSTM may be purged if no coordinate systems are referenced, or if stresses and/or forces are not
requested.
3. MPT and EST may be purged if there are no requests for element stresses, strains, or forces.
4. DIT may be purged if no stress or force requests are present or if no temperature dependent
materials are referenced.
5. SDR2 can also process p-set matrices (UP, QP, and PP instead of UG, QG, and PG) as long as
EQDYN and SILD are specified. Otherwise, SILD may be purged.
6. ETT may be purged if no thermal loading exists, or there are no requests for stresses or forces.
7. EDT may be purged if there are no element requests for forces or stresses, or if there are no
enforced element deformations in the problem.
8. BGPDT may be purged if all displacement (global) coordinate systems are in the basic coordinate
system and if there are no requests for element stresses, strains, or forces exist. However, PUG
will not be computed.
9. LAMA or CLAMA may not be purged if an eigenvalue or frequency response problem exists.
10. EQEXIN and XYCDB may be purged.
11. If SORT2 format is desired for the outputs then the parameter SORTFLAG must be set to 2 and
the input data blocks UG, QG, and QMG must be in their transposed form.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Rotation vector.
OMID Input-character-default='NO' Material output coordinate system flag. If
OMID='YES' then stresses, strains, and forces are output in the material
coordinate system of CQUAD4, CTRIA3, CQUAD8, and CTRIA6 elements.
G Input-real-default=0. Uniform structural damping coefficient. Usually input by
user parameter.
OCID Output-integer-default=0. Print flag for coordinate system identification number
in grid point output. The following bits in OCID are set to 1 based on user output
requests.
1 Displacements.
2 Applied loads.
3 spcforces and mpcforces.
7 Eigenvectors.
10 Velocities.
11 Accelerations.
Main Index
SDR3
Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format
1358
Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Remark:
The SORT1 format created by modules like SDR2 is sorted accordingly:
element type
subcase ( or time step, frequency, etc.
element identification number
But the SORT1 format which has been reordered from SORT2 inputs by SDR3 is sorted accordingly:
subcase ( or time step, frequency, etc.
element type
element identification number
SDR3
Converts tables in SORT1 (or SORT2) format to SORT2 (or
SORT1) format
SDR3 OFP1,OFP2,OFP3,OFP4,OFP5,OFP6/
OFP1X,OFP2X,OFP3X,OFP4X,OFP5X,OFP6X $
OFPi Output table in SORT1 (or SORT2) format.
OFPiX Output table in SORT2 (or SORT1) format.
Main Index
1359 SDRCOMP
Calculates laminar stresses
Calculates laminar stresses, or strains, and failure indices in composite elements.
Format:
Input Data Blocks:
Output Data Blocks:
SDRCOMP
Calculates laminar stresses
SDRCOMP CASECC,MPT,EPT,ETT,EST,OES1A,OEF1A,DIT,BGPDT,PCOMPT/
OES1C,OEFIT,OEF1AA,OPLYSR,OGPLYSS,OGPLYFI,OGPSR/
STRNFLG/DESOPT/LOADFAC/SRCOMPS/APPFLAG/SRTFLAG
CASECC Table of Case Control command images.
MPT Table of Bulk Data entry images related to material properties.
EPT Table of Bulk Data entry images related to element properties.
ETT Element temperature table.
EST Element summary table.
OES1A Table of element strain/curvatures in SORT1 format for the composite
elements only.
OEF1A Table of element forces in SORT1 format for the composite elements
only.
DIT Table of TABLEij Bulk Data entry images.
BGPDT Basic grid point definition table.
PCOMPT Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry.
OES1C Table of composite element stresses or strains in SORT1 format.
OEFIT Table of composite element failure indices.
OEF1AA Table of element forces in SORT1 format for the non-composite
elements only.
OPLYSR Table of ply strength ratios.
OGPLYSS Table of global ply stresses/strains.
OGPLYFI Table of global ply failure indices.
OGPSR Table of global ply strength ratios.
Main Index
SDRCOMP
Calculates laminar stresses
1360
Parameters:
Remarks:
1. ETT may be purged. However temperature effects will not be included.
2. OEF1AA may be purged if DESOPT=0.
3. LOADFACR is only required for including its value in the header record of OES1C for nonlinear
static analysis. This is necessary for proper processing by the DBC module.
LSTRN Input-integer-default=0. Laminar strain flag.
0 Compute laminar stresses.
1 Compute laminar strains.
DESOPT Input-integer-default=0. Non-composite element force flag. If set to 1, then the
non-composite element forces are extracted form OEF1A and copied to
OEF1AA.
LOADFACR Input-real-default=0.0. Load factor in nonlinear static analysis.
SRCOMPS Input-character-default=NO. Flag to request output of table of ply strength
ratios (OPLYSR).
APPFLAG Input-character-default='STATICS'. Approach flag to indicate the type of
analysis, viz.STATICS, FREQRESP, TRANRESP etc.
SORTFLAG Input-integer-default=0. Flag to indicate whether SORT1 ( <= 0 ) or
SORT2 ( >0 )
Main Index
1361 SDRHT
Combines heat flow for CHBDYi elements with heat flux of other elements
Combines the heat flow for the CHBDYi elements with the heat flux for other elements.
Format:
Input Data Blocks:
SDRHT
Combines heat flow for CHBDYi elements with heat flux of
other elements
SDRHT UG,OEF1,SLT,EST,DIT,RDEST,RECM,DLT,OEFNL1,MPT,
BGPDT,
CSTM,SIL,USET,CASECC,OESNLH,APPLOD/
HOEF1,HOES1/
TABS/SIGMA/NORADMAT $
UG Temperature matrix in g-set.
OEF1 Table of element fluxes in SORT1 format.
SLT Table of static loads.
EST Element summary table.
DIT Table of TABLEij Bulk Data entry images.
RDEST Radiation element summary table.
RECM Radiation exchange coefficient matrix.
DLT Table of dynamic loads.
OEFNL1 Table of nonlinear element fluxes in SORT1 format.
MPT Table of Bulk Data entry images related to material properties.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
USET Degree-of-freedom set membership table for g-set.
CASECC Table of Case Control command images.
OESNLH Table of element heat flow in SORT1 format for nonlinear elements
APPLOD Matrix of applied load amplitudes
Main Index
SDRHT
Combines heat flow for CHBDYi elements with heat flux of other elements
1362
Output Data Block:
Parameters:
Remarks:
1. For linear steady state heat transfer, OEF1 is also specified for OEFNL1 and RDEST, RECM, and
DLT may be purged.
SDRHT UG,OEF1,SLT,EST,DIT,,,,
OEF1,MPTS,BGPDTS,CSTMS,SILS,USET,CASECC/
HOEF1/TABS/SIGMA/-1 $
2. In transient heat transfer UG also contains the enthalpy.
HOEF1 Table of element fluxes in SORT1 format updated for CHBDYi
elements.
HOES1 Table of element heat flow in SORT1 format combined for linear and
nonlinear elements.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute
radiant heat flux.
NORADMAT Input-integer-default=-1. Radiation flag.
-2 No radiation.
-1 Initial radiation (default).
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
HOES1
Main Index
1363 SDRNL
Performs stress data recovery for nonlinear elements
Performs the stress data recovery for nonlinear elements.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SDRNL
Performs stress data recovery for nonlinear elements
SDRNL CASECC,ESTNL,ELDATA,UNUSED4,UNUSED5,UNUSED6,UN
USED7,
CSTM,UGNI,BGPDT/
OESNL1,OESNLB1,UNUSED3/
NLTYPE/UNUSED2/UNUSED3/NSKIP/LINC/UNUSED6/UNUS
ED7/
UNUSED8 $
CASECC Table of Case Control command images.
ESTNL Nonlinear element summary table.
ELDATA Table of combined nonlinear information data.
UNUSED4 Unused and may be purged.
UNUSED5 Unused and may be purged.
UNUSED6 Unused and may be purged.
UNUSED7 Unused and may be purged.
CSTM Table of coordinate system transformation matrices.
UGNI Displacement matrix at converged step in the g-set.
BGPDT Basic grid point definition table.
OESNL1 Table of nonlinear element stresses in SORT1 format.
OESNLB1 Table of slideline contact element stresses in SORT1 format.
UNUSED3 Unused and may be purged.
NLTYPE Input-integer-no default. Nonlinear analysis type.
0 Statics.
1 Transient response.
Main Index
SDRNL
Performs stress data recovery for nonlinear elements
1364
UNUSED2 Input-integer-no default. Unused.
UNUSED3 Input-integer-no default. Unused.
NSKIP Input-integer-no default. Subcase record number to read in CASECC.
LINC Input-integer-no default. Number of load increments for this subcase.
UNUSED6 Input-integer-default=0.0. Unused.
UNUSED7 Input-integer-default=0.0. Unused.
UNUSED8 Input-integer-default=0.0. Unused.
Main Index
1365 SDRP
Computes data for p-elements
Computes displacements, element forces, element stresses, and element strains of
p-elements at the view-grid points and merges with corresponding output for
h-elements.
Format:
Input Data Blocks:
SDRP
Computes data for p-elements
SDRP CASECC,EST,VIEWTB,UG,OUG1,
OES1,OSTR1,OEF1,DEQATN,DEQIND,
DIT,MPT,MPT,CSTM,ETT,OINT,
PELSET,BGPDT,BGPDT,OL,GPSNT,ERROR1,
RSQUERY,OVG1,OAG1/
OUG1VU,OES1VU,OEE1VU,OEF1VU,STATDATA,
RSLTSTAT,RSLTDATA,GLBTAB,GLBRSP,
OVG1VU,OAG1VU/
ADPTEXIT/ALTSHAPE/APP/SDRPOPT/PVALID/
DESCYCLE/ADPTINDX/ODESMAX/OADPMAX/SEID/
DVAFLAG $
CASECC Table of Case Control command images.
EST Element summary table.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
UG Displacement matrix in g-set. For the DSVG1 module and transient
analysis, UG can also represent velocity or acceleration.
OUG1 Table of displacements in SORT1 format.
OES1 Table of element stresses in SORT1 format.
OSTR1 Table of element strains in SORT1 format.
OEF1 Table of element forces in SORT1 format.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
DIT Table of TABLEij Bulk Data entry images.
MPT Table of Bulk Data entry images related to material properties.
CSTM Table of coordinate system transformation matrices.
ETT Element temperature table.
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
Main Index
SDRP
Computes data for p-elements
1366
Output Data Blocks:
PELSET p-element set table, contains SETS DEFINITIONS.
BGPDT Basic grid point definition table.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list.
GPSNT Grid point shell normal table.
ERROR1 Error-estimate table updated for current superelement or adaptivity
loop.
RSQUERY Table of results state query.
OVG1 Table of velocities in SORT1 format.
OAG1 Table of accelerations in SORT1 format.
OUG1VU Table of displacements in SORT1 format for view grids.
OES1VU Table of element stresses in SORT1 format for view elements.
OSTR1VU Table of element strains in SORT1 format for view elements.
OEF1VU Table of element forces in SORT1 format for view elements.
STATDATA Table of state information when system cell 297=1.
RSTLSTAT Table of result-state information when system cell 297=2.
RSLTDATA Table of actual results data when system cell 297=3.
GLBTAB Table of global responses when system cell 297=-1.
GLBRSP Matrix of global responses when system cell 297=-1.
OVG1VU Table of velocities in SORT1 format for view grids.
OAG1VU Table of accelerations in SORT1 format for view grids.
Main Index
1367 SDRP
Computes data for p-elements
Parameters:
Remarks:
ADPTEXIT Input-logical-no default. Set to TRUE if this is the final adaptivity loop.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element
analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.
APP Input-character-no default. Analysis type. Allowable values:
'STATICS' Statics.
'REIGEN' Normal modes.
'FREQ' Frequency response.
'TRANSNT' Transient response.
'CEIGEN' Complex eigenvalues.
SDRPOPT Input-character-no default. Principal stress/strain computation selection:
'SDRP' Compute in SDRP.
'OFP' Compute in OFP.
PVALID Input-integer-no default. p-value set identification number.
DESCYCLE Input-integer-no default. Design cycle analysis counter.
ADPTINDX Input-integer-no default. p-version analysis adaptivity index.
ODESMAX Input-integer-no default. Total number of design cycles performed.
OADPMAX Input-integer-no default. Total number of adaptivity cycles performed.
SEID Input-integer-no default. Superelement identification number.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations will be
output in separate data blocks.
-1 Velocities and acceleratons are contained in OUG.
1 Velocities and acceleratons are contained in OVG and OAG.
1. If disk space is critical then SDRPOPT may set to 'OFP' to delay computation of principal stresses
and strains to the OFP module.
2. The scope of SDRP processing depends on the value system cell 297:
0 Traditional NASTRAN data recovery.
1,2,3 On-the-fly data recovery (MSC.Optima, MSC.Ultima).
-1 Global Response (i.e. find min/max values of certain data recovery quantities).
Main Index
SDRX
Modifies CBAR, CBEAM and CBEND element results
1368
Modifies CBAR, CBEAM and CBEND element forces, stresses, and strains due to CBARAO and
PLOAD1 Bulk Data entries. Also computes intermediate station output. Applicable to static and normal
modes analysis only.
Format:
Input Data Blocks:
Output Data Blocks:
SDRX
Modifies CBAR, CBEAM and CBEND element results
SDRX CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,
BGPDT,OSTR1/
OEF1X,OES1X,OSTR1X/
S,N,NOXOUT $
CASECC Table of Case Control command images.
OEF1 Table of element forces in SORT1 format.
OES1 Table of element stresses in SORT1 format.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
BGPDT Basic grid point definition table.
OSTR1 Table of element strains in SORT1 format.
OEF1X Table of displacements in SORT1 format for view grids.
OES1X Table of element stresses in SORT1 format updated for PLOAD1 loads
and intermediate station output.
OSTR1X Table of element strains in SORT1 format augmented with strains for
1-D elements.
Main Index
1369 SDRX
Modifies CBAR, CBEAM and CBEND element results
Parameter:
Example:
Excerpt from subDMAP SEDRCVR:
SDRX
CASEDR,OEF1,OES1,GEOM2S,GEOM3S,EST,CSTMS,MPTS,DIT,BGPDTS,OSTR1/
OEF1X,OES1X,OSTR1X/S,N,NOXOUT $
EQUIVX OEF1/OEF1X/NOXOUT $
EQUIVX OES1/OES1X/NOXOUT $
EQUIVX OSTR1/OSTR1X/NOXOUT $
NOXOUT Output-integer-no default. SDRX update flag.
0 OEF1X, OES1X, and OSTR1X are updated.
-1 OEF1X, OES1X, and OSTR1X are not updated.
Main Index
SDRXD
Modifies CBAR, CBEAM and CBEND element results
1370
Modifies CBAR, CBEAM and CBEND element forces, stresses, and strains due to CBARAO and
PLOAD1 Bulk Data entries. Also computes intermediate station output. Applies to transient and
frequency response analysis only.
Format:
Input Data Blocks:
Output Data Blocks:
SDRXD
Modifies CBAR, CBEAM and CBEND element results
SDRXD CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,
UG,DLT,OL,BGPDT,OSTR1/
OEF1X,OES1X,OSTR1X/
S,N,NOXOUT/APP/COUPMASS $
CASECC Table of Case Control command images.
OEF1 Table of element forces in SORT1 format.
OES1 Table of element stresses in SORT1 format.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
EST Element summary table.
CSTM Table of coordinate system transformation matrices.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
UG Displacement matrix in g-set.
DLT Table of dynamic loads.
OL Transient response time output list or frequency response frequency
output list.
BGPDT Basic grid point definition table.
OSTR1 Table of element strains in SORT1 format.
OEF1X Table of displacements in SORT1 format for view grids.
Main Index
1371 SDRXD
Modifies CBAR, CBEAM and CBEND element results
Parameters:
Example:
SDRX CASEDR,OEF1,OES1,GEOM2S,GEOM3S,EST,CSTMS,MPTS,
DIT,BGPDTS,OSTR1/
OEF1X,OES1X,OSTR1X/S,N,NOXOUT $
EQUIVX OEF1/OEF1X/NOXOUT $
EQUIVX OES1/OES1X/NOXOUT $
EQUIVX OSTR1/OSTR1X/NOXOUT $
OES1X Table of element stresses in SORT1 format updated for PLOAD1 loads
and intermediate station output.
OSTR1X Table of element strains in SORT1 format augmented with strains for
1-D elements.
NOXOUT Output-integer-no default. SDRX update flag.
0 OEF1X, OES1X, and OSTR1X are updated.
-1 OEF1X, OES1X, and OSTR1X are not updated.
APP Input-character-no default. Analysis type. Allowable values:
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
COUPMASS Input-integer-default=-1. Coupled mass generation flag.
-1 Lumped.
0 Coupled.
Main Index
SDSA
Partitions design model to superelements
1372
Partitions the design model (i.e., the design optimization Bulk Data entries) to superelements.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SDSA
Partitions design model to superelements
SDSA EDOM,EPTS,EQEXINS,SEMAP,MPTS,SGPDTS/
EDOMS/
SEID/PEID/S,N,OBJSID/DESOBJ/S,N,DESVAR/
S,N,DRESP/S,N,TWGTFL/S,N,TVOLFL $
EDOM Table of Bulk Data entries related to design sensitivity and
optimization.
EPTS Table of Bulk Data entry images related to element properties for the
superelement specified by SEID.
EQEXINS Equivalence table between external and internal grid/scalar
identification numbers for the superelement specified by SEID.
SEMAP Superelement map table.
MPTS Table of Bulk Data entry images related to material properties for the
current superelement.
SGPDTS Superelement basic grid point definition table for the current
superelement.
EDOMS Table of Bulk Data entries related to design sensitivity and
optimization for the superelement specified by SEID.
SEID Input-integer-default=0. Superelement identification number.
PEID Input-integer-default=0. Primary superelement identification number.
OBJSID Output-integer-default=-1. Superelement identification number
associated with DESOBJ. Set to -1 for all cases unless the user
specifies the DESOBJ command in a particular superelement subcase.
DESOBJ Input-integer-default=0. DESOBJ Case Control command set
identification number.
Main Index
1373 SDSA
Partitions design model to superelements
Remark:
SDSA is intended to be executed in a superelement DMAP loop driven by SEP2DR. See subDMAP
DESINIT for an example.
DESVAR Output-integer-default=0. Retained DVPRELi or DVGRID entry flag
for superelement SEID. Set to -1 if there are retained design variable
perturbations.
DRESP Output-integer-default=0. Retained DRESP1 entry flag for
superelement SEID. Set to -1 if there are retained design responses.
TWGTFL Output-integer-default=0. Total weight flag.
TVOLFL Output-integer-default=0. Total volume flag.
Main Index
SDSB
Generates superelement processing list
1374
Generates the superelement processing list to direct the pseudo-load and response sensitivity
calculations.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Example:
Excerpt from subDMAP DESINIT:
DBVIEW EDOMF=EDOMS WHERE (wildcard) $
SDSB
Generates superelement processing list
SDSB SLIST,EDOM*,CASECC,UNUSED4,UNUSED5/
DSLIST/
S,N,DMRESD/S,N,NOSEDV/S,N,NOSERESP $
CASECC Table of Case Control command images.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
EDOM* Family of EDOM tables for all superelements.
UNUSED4 Unused and may be purged.
UNUSED5 Unused and may be purged.
DSLIST Superelement processing list to direct the pseudo-load and response
sensitivity calculations.
DMRESD Output-integer-default=-1. Design model flag. If set to -1, then the
design model is limited to the residual structure.
NOSEDV Output-integer-default=0. Pseudo-load generation flag based on the
SEDV Case Control command. Set to -1 if pseudo-loads are not
requested for any superelement.
NOSERESP Output-integer-default=0. Response sensitivity calculation flag based
on the SERESP Case Control command. Set to -1 if response
sensitivities are not requested for any superelement.
Main Index
1375 SDSB
Generates superelement processing list
IF ( NOT(RSONLY) AND NOEDOM>0
) SDSB SLIST,EDOMF,CASEXX,,/DSLIST/S,N,DMRESD/
S,N,NOSEDV/S,N,NOSERESP $
Main Index
SDSC
Prints correlation table for normalized design sensitivity coefficient matrix
1376
Prints the correlation table for normalized design sensitivity coefficient matrix.
Format:
Input Data Block:
Output Data Blocks:
None.
Parameters:
SDSC
Prints correlation table for normalized design sensitivity
coefficient matrix
SDSC DSCMCOL//
OBJSID/DESOBJ/UNUSED3/EIGNFREQ $
DSCMCOL Correlation table for normalized design sensitivity coefficient matrix.
OBJSID Input-integer-default=0. Superelement identification number associated with
DESOBJ. Set to -1 for all cases unless the user specifies the DESOBJ command in a
particular superelement subcase.
DESOBJ Input-integer-default=0. DESOBJ Case Control command set identification number.
UNUSED3 Input-integer-default=1. Unused.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
Main Index
1377 SECONVRT
Modifies Bulk Data entry records
Modifies those Bulk Data entry records which define coordinate systems, orientation vectors, and load
vectors by grid point identification number; e.g., CORD1j to CORD2j, FORCEi to FORCE, MOMENTi
to MOMENT, replace GO on CBAR, CBEAM, CBEND, CBUSH and CGAP with X1, X2, X3.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remark:
1. System cell 350 controls execution of the SECONVRT module.
SECONVRT
Modifies Bulk Data entry records
SECONVRT BGPDT,GEOM1,GEOM2,GEOM3/
GEOM1N,GEOM2N,GEOM3N $
BGPDT Basic grid point definition table.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GEOM1N Modified GEOM1 with CORD1j records converted to CORD2j
records.
GEOM2N Modified GEOM2 with GO replaced by X1, X2, and X3 on CBAR,
CBEAM, CBEND, CBUSH and CGAP records.
GEOM3N Modified GEOM3 with FORCEi and MOMENTi records converted to
FORCE and MOMENT records.
-1 No converson.
0 Convert and echo all converted entries in the f06.
>0 Convert and echo the first n converted entries in the f06 where n is the value of system cell
350.
Main Index
SEDR
Partitions tables for superelements
1378
Partitions the solution matrix, Case Control and Plot Control tables for each superelement.
Format:
Input Data Blocks:
Output Data Blocks:
SEDR
Partitions tables for superelements
SEDR SEMAP,CASECC,PCDB,DRLIST,XYCDB,SLT,ETT,
MAPS*,UGD,BGPDTD,GDNTAB,VGD,AGD/
UA,CASEDR,PCDBDR,XYCDBDR,VA,AA/
APP/SEID/S,N,NOUP/S,N,NOSORT1/S,N,NOUG/
S,N,NOOUT/S,N,NOPLOT/S,N,NOXYPLOT/QUALNAM/NCUL
/
SORTP $
SEMAP Superelement map table.
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
DRLIST Superelement processing list for data recovery.
XYCDB Table of x-y plotting commands.
SLT Table of static loads.
ETT Element temperature table.
MAPS* Family of MAPS (superelement upstream to downstream boundary
coordinate system, secondary (mirror, identical, and repeated), and
release transformation matrix).
UGD Displacement matrix in g-set for the downstream superelement.
BGPDT Basic grid point definition table.
GDNTAB Table of grid points generated for p-element analysis.
VGD Velocity matrix in g-set for the downstream superelement.
AGD Acceleration matrix in g-set for the downstream superelement.
UA Solution matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID).
CASEDR Table of Case Control command images for the superelement
(identification number equal to output value of SEID).
Main Index
1379 SEDR
Partitions tables for superelements
Parameters:
PCDBDR Table of model (undeformed and deformed) plotting commands for the
superelement (identification number equal to output value of SEID).
XYCDBDR Table of x-y plotting commands for a superelement (identification
number equal to output value of SEID).
VA Velocity matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID).
AA Acceleration matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID).
APP Input-character-no default. Analysis type. Allowable values:
'STATICS' Statics.
Not statics.
SEID Input-integer-default=0. Superelement identification number.
NOUP Output-integer-default=0. Upstream superelement flag. Set to -1 if there are
no superelements connected upstream from the current superelement.
NOSORT1 Output-integer-default=0. SORT1 format flag. Set to -1 if SORT1 format is
not requested for current superelement.
NOUG Output-integer-default=0. UG presence flag. Set to -1 if UG already exists
for the current superelement.
NOOUT Output-integer-default=0. Output request flag. Set to -1 if no output requests
are specified for the current superelement.
NOPLOT Output-integer-default=0. Plot request flag. Set to -1 if no deformed plot
requests are specified for the current superelement.
NOXYPLOT Output-integer-default=0. X-Y plot request flag. Set to -1 if no x-y plot
requests are specified for the current superelement.
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in selecting
MAPS.
NCUL Input-integer-no default. Number of columns desired in the solution matrix
for the residual structure. Usually determined by the PARAML module.
SORTP Input-integer-default=1. Transpose flag for UGD, VGD, and AGD.
1 Columns correspond to time steps or frequencies.
2 Rows correspond to time steps or frequencies.
'STATICS' =
Main Index
SEDRDR
Drives superelement data recovery loop
1380
Drives superelement data recovery loop.
Format:
Input Data Blocks:
Output Data Blocks:
None.
SEDRDR
Drives superelement data recovery loop
SEDRDR DRLIST,SEMAP//
S,N,LASTSE/S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,NODR/
NOSE/S,N,SETYPE/S,N,RSEID/S,N,SCNDRY/S,N,EXTRN/
SEDRCNTL/NOPGHD $
DRLIST Superelement processing list for data recovery.
SEMAP Superelement map table.
Main Index
1381 SEDRDR
Drives superelement data recovery loop
Parameters:
LASTSE Output-integer-default=0. Last superelement flag. Set to -1 if the current
superelement is the last to process.
SEID Input/output-integer-default=0. Superelement identification number and
initialization flag.
On input:
-1 Initialization.
-2 Same as -1 except do not print UIM 7321.
>0 Previous superelement identification number.
On output:
>0 Current superelement identification number.
PEID Output-integer-default=0. Primary superelement identification number.
SEDWN Output-integer-default=0. Downstream superelement identification number.
NODR Output-integer-default=0. Data recovery request flag. Set to -1 if there is no
data recovery requested for any superelement.
NOSE Input-integer-default=0. Superelement presence flag. Set to -1 if there are no
superelements.
SETYPE Output-character-default=' '. Superelement type as specified on the
SEBULK Bulk Data entry.
'REPEAT' Repeated.
'MIRROR' Mirror.
'COLLTR' Collector.
'EXTRNA' External.
'PRIMARY' Primary.
RSEID Output-integer-default=0. Repeated superelement identification number as
specified on the SEBULK Bulk Data entry.
SCNDRY Output-integer-default=0. Secondary (identical or mirror) superelement flag.
Set to -1 if superelement is defined by the CSUPER Bulk Data entry with
PEID>0.
EXTRN Output-integer-default=0. External superelement flag. Set to -1 if superelement
is defined by the CSUPER Bulk Data entry with PEID=0.
SEDRCNTL Input-character-default=' '. Processing list selection.
Main Index
SEDRDR
Drives superelement data recovery loop
1382
Remark:
SEDRDR processes each superelement, specified in DRLIST, in the order of data recovery; i.e.,
downstream to upstream or residual structure to tip superelements.
Example:
Compose a DMAP loop to process all superelements starting at the residual structure and ending with the
tips.
PARAML SEMAP//'PRES'////S,N,NOSE $
LPFLG=0 $ INITIALIZE
DO WHILE ( LPFLG>=0 ) $
IF ( NOSE<0 ) THEN $
LPFLG=-1 $
ELSE $
SEDRDR DRLIST//
S,N,LPFLG/S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,NODR $
ENDIF $
.
.
.
ENDDO $
' ' All superelements will be processed (default).
'CURR' Only the superelement specified by SEID parameter will be
processed.
NOPGHD Input-integer-default=0. Page header superelement label print control.
0 Print page header and UIM 7321.
-1 Do not print page header and UIM 7321.
-2 Same as -1 and do not print .f04 label.
-3 Same as -2 and do not print superelement label in SUBTITLE line of
page header.
Main Index
1383 SEEFMBND
Generates band information for EFM
Generates the partitioning vectors and band information for energy flow modeling (EFM).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SEEFMBND
Generates band information for EFM
SEEFMBND CASECC,DYNAMIC,DIT,LAMA,EFMDMP/
BANDPV,BANDLIST/EFMMASS $
CASECC Table of Case Control command images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
DIT Table of TABLEij Bulk Data entry images.
LAMA Normal modes eigenvalue summary table.
EFMDMP Table containing mass values, damping loss factors and frequency-
dependent damping criteria for all superelements for which energy
flow modeling calculations are to be performed.
BANDPV Matrix of partitioning vectors for all non-trivial bands.
BANDLIST Table of mode information for all bands.
EFMMASS Input-real-no default. Total mass for all superelements for which energy flow
modeling calculations are to be performed.
Main Index
SEEFMCLF
Calculates EFM values for a band
1384
For energy flow modeling (EFM), calculates for the current band: total modal energy for each subsystem,
energy influence coefficients for rain-on-the-roof excitation, average power input, energy factors matrix,
and coupling loss factors.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SEEFMCLF
Calculates EFM values for a band
SEEFMCLF DIT,EFMLIST,EFMDMP,BANDLIST,BANDPV,MQE*/
ENEMAT,APIMAT,EFMMA,SCLFMAT,CLFMAT/
IBAND/EFMMASS/QUALNAM/EFMDIAG $
DIT Table of TABLEij Bulk Data entry images.
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
EFMDMP Table containing mass values, damping loss factors and frequency-
dependent damping criteria for all superelements for which energy
flow modeling calculations are to be performed.
BANDLIST Table of mode information for all bands.
BANDPV Matrix of partitioning vectors for all non-trivial bands.
MQE* Family of superelement modal mass matrices.
ENEMAT Matrix of modal energy.
APIMAT Diagonal matrix of average power input values.
EFMMAT Matrix of energy factors.
SCLFMAT Matrix of simple coupling loss factors.
CLFMAT Matrix of coupling loss factors.
IBAND Input-integer-no default. Current band indentification number.
EFMMASS Input-real-no default. Total mass for all superelements for which energy flow
modeling calculations are to be performed.
Main Index
1385 SEEFMCLF
Calculates EFM values for a band
QUALNAM Input-character-default=' '. Name of qualifier to be used in selecting MQE
matrices.
EFMDIAG Input-integer-default=0. EFM diagnostic printout flag.
Main Index
SEEFMDMP
Generates parameters for EMF
1386
Generates mass values, damping loss factors, and frequency-dependent damping criteria for energy flow
modeling (EFM).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SEEFMDMP
Generates parameters for EMF
SEEFMDMP CASECC,DYNAMIC,EFMLIST,OGPWG*/
EFMMCOL,EFMDMP/
S,N,EFMMASS/QUALNAM $
CASECC Table of Case Control command images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
OGPWG* Family of superelement grid point weight generator tables.
EFMMCOL Column matrix of EFM superelement mass values.
EFMDMP Table containing mass values, damping loss factors and frequency-
dependent damping criteria for all superelements for which energy
flow modeling calculations are to be performed.
EFMMASS Output-real-no default. Total mass for all superelements for which energy flow
modeling calculations are to be performed.
QUALNAM Input-character-default=' '. Name of qualifier to be used in selecting MQE
matrices.
Main Index
1387 SEEFMLST
Generates superelement list for EFM
Generates list of superelements for which energy flow modeling (EFM) calculations are to be performed.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
SEEFMLST
Generates superelement list for EFM
SEEFMLST CASECC,GEOM1,SLIST/EFMLIST $
CASECC Table of Case Control command images.
GEOM1 Table of Bulk Data entry images related to geometry.
SLIST Superelement processing list for matrix generation, assembly, and
reduction.
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
Main Index
SEEFMNOR
Generates partitioning vector and shell normals for EFM
1388
Generats the partitioning vector for extracting the grid point translational DOFs from all the DOF in the
superelement as well as to generate a matrix of superelement grid point shell normal vectors.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remark:
GPSNT and SNORMM may be purged if only PVGT is desired.
SEEFMNOR
Generates partitioning vector and shell normals for EFM
SEEFMNOR BGPDT,USET,GPSNT/
PVGT,SNORMM $
BGPDT Basic grid point definition table.
USET Degree-of-freedom set membership table for g-set.
GPSNT Grid point shell normal table.
PVGT Partitioning vector for extracting the grid point translational DOFs.
SNORMM Matrix of superelement grid point shell normal vectors.
Main Index
1389 SEEFMOUT
Print output from the Energy Flow Modeling (EFM) analysis
Print output from the Energy Flow Modeling (EFM) analysis.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
None.
SEEFMOUT
Print output from the Energy Flow Modeling (EFM) analysis
SEEFMOUT EFMLIST,EFMASMTT,EXCITEFX,BANDLIST,
MNRGYMTF,APIMATT,RESMATFT/ $
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
EFMASMTT Matrix of mass values for all EFM superelements.
EXCITEFX Matrix of power or force input for all EFM superelements.
BANDLIST Table of mode information for all bands.
MNRGYMTF Matrix of modal energy values for all EFM superelements for all
bands.
APIMATT Matrix of average power input per unit force for all EFM
superelements for all bands.
RESMATFT Matrix of average velocity respons for all EFM superelements for all
bands.
Main Index
SEEFMXIT
Computes superelement power for EFM
1390
Computes superelement power and force input values for energy flow modeling (EFM).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
SEEFMXIT
Computes superelement power for EFM
SEEFMXIT CASECC,DYNAMIC,EFMLIST/EXCITP,EXCITF $
CASECC Table of Case Control command images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
EXCITP Matrix of EFM superelement power input values.
EXCITF Matrix of EFM superelement force input values.
Main Index
1391 SELA
Assembles static load matrices from upstream superelements
Assembles static load matrices from upstream superelements into the current superelement.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SELA
Assembles static load matrices from upstream
superelements
SELA PJ,SLIST,SEMAP,BGPDTS,PA*,MAPS*,GDNTAB/
PG/
SEID/QUALNAM/S,N,LDSEQ/S,N,NOPG/PRTUIM $
PJ Static load matrix for the g-set of the current superelement and applied
to its interior points only.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
SEMAP Superelement map table.
BGPDTS Basic grid point definition table for the current superelement.
PA* Family of static load matrices (PA) applied on the boundary (a-set) of
all upstream superelements.
MAPS* Family of MAPS (superelement upstream to downstream boundary
coordinate system, secondary (mirror, identical, and repeated), and
release transformation matrix).
GDNTAB Table of grid points generated for p-element analysis.
PG Static load matrix for the g-set of the current superelement including
loads from upstream superelements.
SEID Input-integer-default=0. Superelement identification number.
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in
selecting MAPS and PA.
LDSEQ Input/output-integer-default=0. PG column number. On input, last
column number of PG on previous SELA execution. On output, last
column number of PG on current execution.
Main Index
SELA
Assembles static load matrices from upstream superelements
1392
Remark:
PJ may be purged.
Example:
DBVIEW PAUP = PA WHERE (SEID=* and PEID=*) $
DBVIEW MAPUP = MAPS WHERE (SEID=* and PEID=*) $
SELA PJ,SLIST,EMAP,BGPDTS,PAUP,MAPUP,GDNTAB/
PG/
SEID/'SEID'/0/S,N,NOPG $
EQUIVX PJ/PG/NOPG $
NOPG Output-integer-default=0. Upstream load presence flag. Set to -1 if
there are no loads due to upstream superelements.
PRTUIM Input-logical-default=TRUE. UIM 4570 print control flag in SELA
module.
Main Index
1393 SEMA
Assembles square symmetric matrices from upstream superelements
Assembles square symmetric matrices (e.g., stiffness, mass, damping) from upstream superelements into
the current superelement.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SEMA
Assembles square symmetric matrices from upstream
superelements
SEMA BGPDTS,SLIST,SEMAP,XJJ,XAA*,MAPS*,GDNTAB/
XGG/
SEID/LUSETS/QUALNAM/UPFM $
BGPDTS Basic grid point definition table for the current superelement.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
SEMAP Superelement map table.
XJJ Square matrix for the g-set of the current superelement and applied to
its interior points only.
XAA* Family of reduced square matrices in a-set pertaining to the upstream
superelements.
MAPS* Family of MAPS (superelement upstream to downstream boundary
coordinate system, secondary (mirror, identical, and repeated), and
release transformation matrix).
GDNTAB Table of grid points generated for p-element analysis.
XGG Square matrix in g-set including contributions from upstream
superelements.
SEID Input-integer-default=0. Superelement identification number.
LUSETS Input-integer-default=0. The number of degrees-of-freedom in the
g-set of the current superelement.
Main Index
SEMA
Assembles square symmetric matrices from upstream superelements
1394
Remark:
XJJ may be purged.
Example:
Assemble stiffness matrix KGG and exit if there are missing upstream stiffness matrices.
DBVIEW KAAUP = KAA WHERE (SEID=* AND PEID=* and WILDCARD) $
DBVIEW MAPUP = MAPS WHERE (SEID=* AND PEID=*) $
SEMA BGPDTS,SLIST,SEMAP,KJJ,KAAUP,MAPUP,GDNTAB/
KGG/
SEID/LUSETS/'SEID'/-1 $
IF ( NOGO=-1 ) EXIT $
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in
selecting MAPS and PA.
UPFM Input-integer-default=0. UFM 4252 print flag. Set to -1 to print UFM
4252 and set NOGO=-1 if there are missing upstream boundary
matrices.
Main Index
1395 SEP1
Constructs superelement map table
Constructs the superelement map table.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SEP1
Constructs superelement map table
SEP1 GEOM1,GEOM2,GEOM4,EQEXIN,BGPDT,CSTM,CASECC,SET
REE/
SEMAP,SCSTM/
S,N,NOSE/CONFAC/LST2REC $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
CASECC Table of Case Control command images.
SETREE Superelement tree table usually input via the DTI,SETREE Bulk Data
entry.
SEMAP Superelement map table.
SCSTM Table of global transformation matrices for superelements.
NOSE Output-integer=default=0. Superelement presence flag. Set to -1 if
there are no superelements.
Main Index
SEP1
Constructs superelement map table
1396
Remarks:
1. SEP1 is the initial superelement processor. It builds the superelement map table which defines the
relationships between grid points and superelements. The map includes the superelement type
(primary, secondary, mirror image, etc.), the exterior grid points, the structural and rigid elements,
and for certain secondary superelements, sequencing information.
2. SEP1 only supports superelements defined by the SESET Bulk Data entry, CSUPER Bulk Data
entry or on the SEID field on the GRID Bulk Data entry; i.e., grid-list superelements. SEP1X is a
more recently developed module intended for superelements defined in separate Bulk Data
Sections; i.e., partitioned superelements.
CONFAC Input-integer-default=1.E-5. Image superelement congruence
tolerance for the location of boundary grid points and displacement
coordinate systems.
LST2REC Input-integer-default=TRUE. Last two records write flag. Set to TRUE
to write last two records.
Main Index
1397 SEP1X
Constructs superelement map table
Constructs the superelement map table and "corrects" the grid point locations at RSSCON element
connections. The format has not changed but the SEP1XOVR parameter is now an output parameter
which must be passed into SEP2X. Also additional options are available in SEP1XOVR.
Format:
Input Data Blocks:
Output Data Blocks:
SEP1X
Constructs superelement map table
SEP1X SELIST,GEOM1*,GEOM2*,GEOM4*,SETREE,SGPDTS*,BND
FIL/
SEMAP,SGPDT,SCSTM/
S,N,NOSE/CONFAC/QUALNAM/QUALVAL/S,N,RSFLAG/
NQSET/EXTNAME/S,N,SEP1XOVR/NQMAX/SEBULK/TOLRSC
/
S,N,SWCHECK/ATQSET/S,N,RUNSEP2X $
SELIST Table containing the list of partitioned superelements defined in
separate Bulk Data Sections.
GEOM1* Family of GEOM1 tables for all partitioned superelements defined in
separate Bulk Data Sections.
GEOM2* Family of GEOM2 tables for all partitioned superelements defined in
separate Bulk Data Sections.
GEOM4* Family of GEOM4 tables for all partitioned superelements defined in
separate Bulk Data Sections.
SETREE Superelement tree table usually input via the DTI,SETREE Bulk Data
entry.
SGPDTS* Family of SGPDTS tables created in previous runs.
BNDFIL Table containing the local and global boundary grids in the order given
by extreme for domain decomposition.
SEMAP Superelement map table.
SGPDT Global superelement basic grid point definition table including
RSSCON grid point location corrections.
SCSTM Table of global transformation matrices for partitioned superelements.
Main Index
SEP1X
Constructs superelement map table
1398
Parameters:
NOSE Output-integer=default=0. Superelement presence flag. Set to -1 if there are no
superelements. Set to number of superelements if superelements exist.
CONFAC Input-real-default=1.E-5. Image superelement congruence tolerance for the
location of boundary grid points and displacement coordinate systems.
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in selecting
GEOM1, GEOM2, GEOM4, and SGPDT.
QUALVAL Input-integer-default=-1. QUALNAM value assigned to the main Bulk Data
Section.
RSFLAG Output-logical-default=FALSE. Main Bulk Data superelement presence flag. Set
to TRUE if superelements are defined in the main Bulk Data Section.
NQSET Input-integer-default=0. Number of automatic q-set degrees-of-freedom (auto-q-
set). Each superelement will have NQSET number of q-set degrees-of-freedom.
EXTNAME Input-character-default='XEID'. Name of the qualifier used to identify External
Superelements. Note linkage to the SEBULK data entry.
SEP1XOVR Input-integer-default=0. Over-ride bits for module processing. See Remark 3.
Bit(s) Value(s) Description
1-3 1-5 Override Search Algorithm Selection.
4 8
Disable Automatic Main Bulk Scalar Linkages via
internal SECONCT entries.
5 16 Print RSSCON old/new locations.
6 32 Print Boundary Search Sequence.
7 64 SEP1X "Diag 30" Debugging Output.
8 128
Auto-SET in Residual place in OSET when other sets
present in the Residual.
9 256 CHKRUN flag for spot welds.
10 512 CHKRUN=2 flag for spot welds.
NQMAX Input-integer-default=3000. Maximum number of auto-q-set's allowed per
partitioned superelement. See NQSET.
SEBULK Input-logical-default=FALSE. Partitioned superelement presence flag. Set to
TRUE if partitioned superelements are present or BEGIN SUPER is specified for
the first BEGIN BULK Case Control command. If TRUE then superelement
processing is to be performed. Otherwise, only the RSSCON element corrections
are performed.
TOLRSC Input-real-default=1.0E-4. RSSCON element alignment tolerance factor.
SWCHECK Output-logical-default=FALSE. Spot weld check exit flag indicating that bit 256
is on in CHKRUN.
Main Index
1399 SEP1X
Constructs superelement map table
Example:
1. Excerpt from subDMAP PHASE0:
DBVIEW GEOM1F=GEOM1QS WHERE ( PEID<>0 ) $
DBVIEW GEOM2F=GEOM2QS WHERE ( PEID<>0 ) $
DBVIEW GEOM4F=GEOM4QS WHERE ( PEID<>0 ) $
DBVIEW SGPDTF=SGPDTS WHERE ( PEID<>0 ) $
OVRIDE = SEP1XOVR $
SEP1X SELIST,GEOM1F,GEOM2F,GEOM4F,SETREE,SGPDTF,BNDFIL/
EMAP,SGPDT,SCSTM/
S,N,NOSE/CONFAC/'PEID'//S,N,PARTRS/NQSET/'XEID'/
S,N,OVRIDE//SEBULK/TOLRSC/S,N,SWCHECK/ATQSET/
S,N,XSEP2X $
2. Perform RSSCON correction only. Excerpt from subDMAP SOL1:
SEP1X ,,GEOM1q,GEOM2,GEOM4,,/
EMAP,SGPDT,SCSTM/
S,N,NOSE/CONFAC/' '//S,N,PARTRS/NQSET/'XEID'///
false/TOLRSC $
3. The SEP1X module checks the residual part and bit 8 on the SEP1XOVR parameter to determine
a-set membership at the residual level. The default action is to place all upstream q-set in the a-
set in the residual when any ASETi, BSETi, CSETi, QSETi or OMITi records are detected in the
residual based upon user specifications. Otherwise, SEP1X changes the SEP1XOVR parameter
to indicate to SEP2X not to generate ASET records for the q-set boundary dofs and then let the
left-over logic of GP4 assign to a-set or o-set. Note that the user can set bit 8 to indicate that no
ASET records will be created. The current SEP2X rule for user set specifications is to copy the
supplied record from the main GEOM4 to the residual's GEOM4S.
ATQSET Input-logical-default=FALSE. Automatic q-set generation flag. If TRUE,
automatic q-set will not be generated here but in the MODQSET module.
RUNSEP2X Output-logical-default=FALSE. Flag to run SEP2X. Set to TRUE for models that
contain certain types of weld elements.
Main Index
SEP2
Partitions tables for each superelement
1400
Partitions tables for each superelement.
Format:
Input Data Blocks:
Output Data Blocks:
SEP2
Partitions tables for each superelement
SEP2 GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,
SLIST,SEMAP,CASES,DYNAMIC,GPSNT/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,UNUSED8,UNUSED9,DYNAMICS,GPSNTS/
SEID/METHCMRS
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
EPT Table of Bulk Data entry images related to element properties.
MPT Table of Bulk Data entry images related to material properties.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
SEMAP Superelement map table.
CASES Table of Case Control commands for the current superelement.
DYNAMIC Table of Bulk Data entry images related to dynamics.
GPSNT Grid point shell normal table.
GEOM1S Table of Bulk Data entry images related to geometry for the current
superelement.
GEOM2S Table of Bulk Data entry images related to element connectivity and
scalar points for the current superelement.
GEOM3S Table of Bulk Data entry images related to static and thermal loads for
the current superelement.
Main Index
1401 SEP2
Partitions tables for each superelement
Parameters:
GEOM4S Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity for the current
superelement.
EPTS Table of Bulk Data entry images related to element properties for the
current superelement.
MPTS Table of Bulk Data entry images related to material properties for the
current superelement.
MAPS Superelement boundary transformation matrix for secondary
superelements (mirror, identical, and repeated), boundary
resequencing and releases.
UNUSED8 Unused and may be purged.
UNUSED9 Unused and may be purged.
DYNAMICS Table of Bulk Data entry images related to dynamics for the current
superelement.
GPSNTS Grid point shell normal table for the current superelement.
SEID Input-integer-default=0. Superelement identification number.
METHCMRS Input-integer-default=0. Residual structure METHOD set
identification (SID) override. METHCMRS>0 overrides SID value
specified in CASES.
Main Index
SEP2CT
Partitions Case Control and Plot Control tables for each superelement
1402
Partitions the Case Control and Plot Control tables for each superelement.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SEP2CT
Partitions Case Control and Plot Control tables for each
superelement
SEP2CT SLIST,CASECC,PCDB,UNUSED4,XYCDB/
CASES,PCDBS,XYCDBS/
APP/SEID $
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
UNUSED4 Unused and may be purged.
XYCDB Table of x-y plotting commands.
CASES Table of Case Control command images for the current superelement
(identification number equal to output value of SEID).
PCDBS Table of model (undeformed and deformed) plotting commands for the
current superelement (identification number equal to output value of
SEID).
XYCDBS Table of x-y plotting commands for the current superelement
(identification number equal to output value of SEID).
APP Input-character-no default. Analysis type. Allowable values:
'STATICS' Statics.
Not statics.
SEID Input-integer-default=0. Superelement identification number.
'STATICS' =
Main Index
1403 SEP2DR
Drives superelement generation, assembly, and reduction loop
Drives the superelement generation, assembly, and reduction loop. Also drives the pseudo-load
generation loop.
Format:
Input Data Blocks:
Output Data Blocks:
None.
SEP2DR
Drives superelement generation, assembly, and reduction loop
SEP2DR
,6(0$3
S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,LASTSE/S,N,NOM
AT/
S,N,NOASM/S,N,NOLOAD/S,N,NOLASM/S,N,NOUP/S,N,S
CNDRY/
S,N,EXTRN/S,N,NOMR/SEP2CNTL/S,N,NOPSLG/NOPGHD/
S,N,PARTSE/S,N,SETYPE/S,N,RSEID/NSENQSET $
SEMAP Superelement map table.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
DSLIST Superelement processing list to direct the pseudo-load and response
sensitivity calculations.
SLIST
DSLIST
)
`
Main Index
SEP2DR
Drives superelement generation, assembly, and reduction loop
1404
Parameters:
SEID Input/output-integer-default=0. Superele ment identification number and
initialization flag.
On input:
-1 Initialization
-2 Same as -1 except do not print UIM 7321
>0 Previous superelement identification number
On output:
>0 Current superelement identification number
PEID Output-integer-default=0. Primary superelement identification number.
SEDWN Input-output-integer-default=0. Downstream superelement identification
number. SEDWN is input if CNTL <> 'SEDWN' and output if CNTL =
'SEDWN'.
LASTSE Output-integer-default=0. Last superelement flag. Set to -1 if the current
superelement is the last to process.
NOMAT Output-integer-default=0. Matrix generation flag. Set to -1 if no matrix
generation is requested for the current superelement based on the SEMG or
SEALL Case Control commands.
NOASM Output-integer-default=0. Matrix assembly flag. Set to -1 if no matrix assembly
and reduction is requested for the current superelement based on the SEKR or
SEALL Case Control commands.
NOLOAD Output-integer-default=0. Load generation flag. Set to -1 if no load generation is
requested for the current superelement based on the SELG or SEALL Case
Control commands.
NOLASM Output-integer-default=0. Load assembly flag. Set to -1 if no load assembly and
reduction is requested for the current superelement based on the SELR or SEALL
Case Control commands.
NOUP Output-integer-default=0. Upstream superelement flag. Set to -1 if there are no
superelements connected upstream from the current superelement.
SCNDRY Output-integer-default=0. Secondary (identical or mirror) superelement flag. Set
to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0.
EXTRN Output-integer-default=0. External superelement flag. Set to -1 if superelement
is defined by the CSUPER Bulk Data entry with PEID=0.
NOMR Output-integer-default=0. Mass and damping assembly flag. Set to -1 if no mass
and damping assembly and reduction is requested for the current superelement
based on the SEMR or SEALL Case Control commands.
Main Index
1405 SEP2DR
Drives superelement generation, assembly, and reduction loop
SEP2CNTL Input-character-default='SLIST'. Processing list selection.
'ALL' All superelements will be processed.
'PSLGDV' Only superelements specified on the SEDV Case Control
commands.
'DSLIST' Only superelements specified on the SERESP Case Control
commands.
'PSLDSL' Union of superelements specified on the SEDV and SERESP
commands.
'SLIST' Only superelements specified on the SEALL, SEMG, SEKR,
SELG, SELR, or SEMR Case Control commands.
'SEDWN' All superelements that have SEDWN as their downstream
superelement.
'CURR' Only the superelement specified by SEID parameter will be
processed.
NOPSLG Output-integer-default=0. Pseudo-load generation flag. Set to -1 if no load
generation is requested for the current superelement based on the SEDV or
SERESP Case Control commands.
NOPGHD Input-integer-default=0. Page header and eject flag.
0 Print page header in f06 and label in f04.
-1 Do not print page header in f06.
-2 Do not print page header in f06 and label in f04
PARTSE Output-logical-default=FALSE. Partitioned superelement flag. Set to TRUE if the
current superelement is a partitioned superelement.
SETYPE Output-character-default=' '. Superelement type as specified on the SEBULK
Bulk Data entry.
'REPEAT' Repeated.
'MIRROR' Mirror.
'COLLTR' Collector.
'EXTRNA' External a-set.
'EXTRNG' External g-set.
'PRIMARY' Primary.
Main Index
SEP2DR
Drives superelement generation, assembly, and reduction loop
1406
Remarks:
1. SEP2DR processes each superelement, specified in SLIST or DSLIST, in the order of matrix
generation; i.e., upstream to downstream or tip superelements to the residual structure.
2. If SEP2CNTL='PSLGDV' or 'DSLIST' then DSLIST must be specified as the first input;
otherwise, 'SLIST' is specified.
Example:
Compose a DMAP loop to process all superelements starting at the tips and ending with the residual
structure.
PARAML SEMAP//'PRES'////S,N,NOSE $
LPFLG=0 $ INITIALIZE
DO WHILE ( LPFLG<>-1 ) $
IF ( NOSE<0 ) THEN $
LPFLG=-1 $
ELSE $
SEP2DR SLIST,SEMAP//S,N,SEID/S,N,PEID//S,N,LPFLG/
////////'ALL'//-1 $
ENDIF $
.
.
.
ENDDO $
RSEID Output-integer-default=0. Repeated superelement identification number as specified
on the SEBULK Bulk Data entry.
NSENQSET Output-integer-default=0. Number of SENQSET degrees-of-freedom allocated to
the current superelement.
Main Index
1407 SEP2X
Partitions tables for each superelement
Partitions tables for each superelement.
Format:
Input Data Blocks:
SEP2X
Partitions tables for each superelement
SEP2X GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,SLIST,SEMAP,CA
SES,
DYNAMIC,UNUSED11,SGPDT,SCSTM,MATPOOL/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,SGPDTS,UNUSED9,DYNAMICS,MATPOOLS,UNUSED12
/
SEID/METHCMRS/SEP1XOVR $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
EPT Table of Bulk Data entry images related to element properties.
MPT Table of Bulk Data entry images related to material properties.
SLIST Superelement processing list to matrix generation, assembly, and
reduction.
SEMAP Superelement map table.
CASES Table of Case Control commands for the current superelement.
DYNAMIC Table of Bulk Data entry images related to dynamics.
UNUSED11 Unused and may be purged.
SGPDT Superelement basic grid point definition table.
SCSTM Table of global transformation matrices for partitioned superelements.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
Main Index
SEP2X
Partitions tables for each superelement
1408
Output Data Blocks:
Parameters:
GEOM1S Table of Bulk Data entry images related to geometry for the current
superelement.
GEOM2S Table of Bulk Data entry images related to element connectivity and
scalar points for the current superelement.
GEOM3S Table of Bulk Data entry images related to static and thermal loads for
the current superelement.
GEOM4S Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity for the current
superelement.
EPTS Table of Bulk Data entry images related to element properties for the
current superelement.
MPTS Table of Bulk Data entry images related to material properties for the
current superelement.
MAPS Superelement boundary transformation matrix for secondary
superelements (mirror, identical, and repeated), boundary
resequencing and releases.
SGPDTS Superelement basic grid point definition table for the current
superelement.
UNUSED9 Unused and may be purged.
DYNAMICS Table of Bulk Data entry images related to dynamics for the current
superelement.
MATPOOLS MATPOOL table for the current superelement.
UNUSED12 Unused and may be purged.
SEID Input-integer-default=0. Superelement identification number.
METHCMRS Input-integer-default=0. Residual structure METHOD set
identification (SID) override. METHCMRS>0 overrides SID value
specified in CASES.
SEP1XOVR Input-integer-default=0. Over-ride bits for module processing and
computed in SEP1X. Checks bit 8 to determine upstream q-set
processing in the residual. See Remark 3 under the SEP1X module
description.
Main Index
1409 SEP3
Examines Case Control and determines superelement processing
Examines Case Control and determines which superelements are to be processed for generation,
assembly, and reduction of stiffness, mass, and damping, and load matrices.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SEP3
Examines Case Control and determines superelement
processing
SEP3 CASECC,EMAP/
SLIST/
S,N,NOSECOM/S,N,SEID/NOSE/S,N,NOMAT/S,N,NOASM/
S,N,NOLOAD/S,N,NOLASM/S,N,NOMR/UNUSED9 $
CASECC Table of Case Control command images.
SEMAP Superelement map table.
SLIST Superelement processing list for matrix generation, assembly, and
reduction.
NOSECOM Output-integer-default=0. Superelement Case Control command flag.
Set to -1 if there are no SEALL, SEMG, SEKR, SELG, SELR, or
SEMR commands specified in CASECC.
SEID Output-integer-default=0. Initialization flag. If there are
superelements, then SEID is set to -1 to initialize SEP2DR; otherwise
0.
NOSE Input-integer=default=0. Superelement presence flag. Set to -1 if there
are no superelements.
NOMAT Output-integer-default=0. Matrix generation flag. If there are no
superelements, NOMAT is set to -1 if no SEMG and no SEALL Case
Control commands are specified.
NOASM Output-integer-default=0. Matrix assembly flag. If there are no
superelements, then NOASM is set to -1 if no SEKR and no SEALL
Case Control commands are specified.
Main Index
SEP3
Examines Case Control and determines superelement processing
1410
Remark:
If there are no superelements, then SLIST is not created and may be purged.
NOLOAD Output-integer-default=0. Load generation flag. If there are no
superelements, then NOLOAD is set to -1 if no SELG and no SEALL
Case Control commands are specified.
NOLASM Output-integer-default=0. Load assembly flag. If there are no
superelements, then NOLASM is set to -1 if no SELR and no SEALL
Case Control commands are specified.
NOMR Output-integer-default=0. Mass and damping assembly flag. If there
are no superelements, then NOMR is set to -1 if no SEMR and no
SEALL Case Control commands are specified.
UNUSED9 Input-integer-default=0. Unused.
Main Index
1411 SEP4
Examines table and data base information for superelement processing
Examines the Case Control and Plot Control tables, queries the data base for existing solution matrices,
and determines which superelements are to be processed for data recovery.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SEP4
Examines table and data base information for superelement
processing
SEP4 CASECC,PCDB,EMAP,XYCDB,UG*,PUG*,QG*,MMCDB/
DRLIST/
UNUSED1/QUALNAM/S,N,NODR/S,N,SEID/S,N,NOSEPLOT/
SEP4CNTL $
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
SEMAP Superelement map table.
XYCDB Table of x-y plotting commands.
UG* Family of displacement matrices in g-set for all superelements.
PUG* Family of matrices of translational displacements for all
superelements.
QG* Family of single-point constraint forces of constraint matrices in the
g-set for all superelements.
MMCDB Table of MAXMIN(DEF) specifications.
DRLIST Superelement processing list for data recovery.
UNUSED1 Input-character-no default. Specify ' '.
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in selecting UG,
PUG, and QG.
NODR Output-integer-default=0. Data recovery request flag. Set to -1 if there is no data
recovery requested for any superelement.
SEID Input-integer-default=0. Initialization flag. If there are superelements, then SEID
is set to -1 to initialize SEDRDR; otherwise 0.
Main Index
SEP4
Examines table and data base information for superelement processing
1412
Example:
DBVIEW UGF =UG WHERE (WILDCARD) $
DBVIEW PUGF=PUG WHERE (WILDCARD) $
DBVIEW QGF =QG WHERE (WILDCARD) $
SEP4 CASECC,PCDB,EMAP,XYCDB,UGF,PUGF,QGF/
DRLIST/
' '//S,N,NODRALL/S,N,SEID/S,N,NOUPL $
NOSEPLOT Output-integer-default=0. SEPLOT or SEUPPLOT request flag. Set to
-1 if there are no SEPLOT or SEUPPLOT commands specified in the
OUTPUT(PLOT) Section.
SEP4CNTL Output-integer-default=' '. Processing list selection.
'ALL' All superelements will be processed
Only superelements specified on the SEDR Case Control command
'ALL' =
Main Index
1413 SEPLOT
Assembles plot displacement matrices for superelements
Assembles plot displacement matrices for superelements based on the SEPLOT and SEUPPLOT
commands.
Format:
Input Data Blocks:
Output Data Blocks:
SEPLOT
Assembles plot displacement matrices for superelements
SEPLOT PCDB,SEMAP,SCSTM,BGPDT*,ECT*,PUG*/
BGPDTX,PUGX,PLSETMSG,PLTPAR,GPSETS,ELSET/
QUALNAM/QUALNAMP/S,N,PLTCNT/S,N,NGP/S,N,JPLOT
$
PCDB Table of model (undeformed and deformed) plotting commands.
SEMAP Superelement map table.
SCSTM Table of global transformation matrices for partitioned superelements.
BGPDT* Family of basic grid point definition tables for all superelements.
ECT* Family of element connectivity tables for all superelements.
PUG* Family of matrices of translational displacements for all
superelements.
BGPDTX BGPDT assembled for superelements defined on the SEPLOT or
SEUPPLOT command.
PUGX PUG assembled for superelements defined on the SEPLOT or
SEUPPLOT command.
PLSETMSG Table of user informational messages generated during the definition
of element plot sets.
PLTPAR Table of plot parameters and plot control.
GPSETS Table of grid point sets related to the element plot sets.
ELSET Table of element plot set connections.
Main Index
SEPLOT
Assembles plot displacement matrices for superelements
1414
Parameters:
Example:
Excerpt from subDMAP SUPER3:
DBVIEW BGPDTF=BGPDTS WHERE (PEID=* AND MODLTYPE='STRUCTUR') $
DBVIEW ECTF=ECTS WHERE (PEID=* AND MODLTYPE='STRUCTUR') $
DO WHILE ( PLTCNT>-1 ) $
SEPLOT PCDB,EMAP,scstm,BGPDTF,ECTF,PUGF/
BGPDTX,PUGX,PLTXY,PLTPARY,GPSETSY,ELTSETSY/
'PEID'/'SEID'/S,N,PLTCNT/S,N,NSILS/S,N,JPLOT $
PRTMSG PLTXY//PDRMSG $
IF ( JPLOT>=0 ) THEN $
PLOT PLTPARY,GPSETSY,ELTSETSY,CASECC,BGPDTX,
PUGX,PUGX,gpect,oes1x/
PLOTY2/NSILS/0/JPLOT/-1/S,N,PFILE $
PRTMSG PLOTY2//PDRMSG $
ENDIF $ JPLOT>=0
ENDDO $ PLTCNT>-1
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in selecting BGPDT
and ECT.
QUALNAMP Input-character-default='PEID'. Name of qualifier to be used in selecting PUG.
PLTCNT Input/output-integer-no default. SEPLOT (or SEUPPLOT) command counter.
On input:
0 Initialization.
On output:
>0 Current SEPLOT (or SEUPPLOT) command.
NGP Output-integer-no default. Number of grid points and scalar points in the
BGPDTX.
JPLOT Output-integer-no default. Number of element plot sets. Set to -1 if there are
none.
Main Index
1415 SEPR1
Builds a list of partitioned superelement Bulk Data Sections
Builds a list of partitioned superelement Bulk Data Sections.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
Example:
Excerpt from subDMAP IFPL:
DBVIEW IBULKSF = IBULK WHERE (SEID>0 AND PEID=*) $
SEPR1 IBULKSF/SELIST//S,N,SELIST $
SEPR1
Builds a list of partitioned superelement Bulk Data Sections
SEPR1 BULK*/
SELIST/
QUALNAM/S,N,SEFLAG $
BULK* Family of partitioned superelement Bulk Data Sections
SELIST List of partitioned superelement identification numbers.
QUALNAM Input-character-default='SEID'. Name of qualifier to be used in
selecting BULK.
SEFLAG Output-logical-default=FALSE. Set to TRUE if partitioned
superelements are present.
Main Index
SEQP
Resequencing processor
1416
Generates SEQGP entries or a mapping matrix for use in resequencing matrices for efficient matrix
decomposition.
Format 1: Geometry Table input
Format 2: Matrix input
Input Data Blocks:
SEQP
Resequencing processor
SEQP GEOM1,GEOM2,GEOM4,EPT,MATPOOL,DYNAMIC,CASECC/
GEOM1Q,TIMSIZ,GEQMAP,BNDFIL,SPCPART,LGPART,GEO
M2X,
GEOM4X/
SEQOUT/SEQMETH//SUPER/FACTOR/
MPCFLG/START/MSGLVL/PEXIST/PSEQOPT/S,N,NTIPS/A
PP/
S,N,ZCOLLCT/S,N,TIPSCOL/ACMS/S,N,FLUIDSE/ATQSE
T/ PARTMEM $
SEQP MAT,GPL,USET,SIL/SEQMAP,,,,,/
SEQOUT/SEQMETH/SETNAME $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
GEOM4 Table of Bulk Data entry images related to constraints,
degree-of-freedom membership, and rigid element connectivity.
EPT Table of Bulk Data entry images related to element properties.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries. Required
for DMIG and virtual mass partitioning with domain solver
ACMS='YES'.
DYNAMIC Table of Bulk Data entry images related to dynamics. Grid points on
DPHASE, DELAY, TIC, and DAREA records will be assigned to the
residual structure if ACMS='YES'.
CASECC Table of Case Control command images. Required for MFLUID set
identification number.
MAT Matrix. Must be square and symmetric.
GPL External grid/scalar point identification number list.
Main Index
1417 SEQP
Resequencing processor
Output Data Blocks:
USET Degree-of-freedom set membership table for g-set.
SIL Scalar index list.
GEOM1Q Same as GEOM1 except SEQGP Bulk Data entry records have been
added and any pre-existing SEQGP records are removed.
TIMSIZ Table of CPU and disk space estimation parameters.
GEQMAP Table of grid based local equation map indicating which grid resides
on which processors/partitions for domain decomposition.
BNDFIL Table containing the local and global boundary grids in the order given
by extreme for domain decomposition.
SPCPART Partitioning vector for domain decomposition.
SEQMAP Mapping matrix for resequencing.
LGPART Same as SPCPART except it includes disjoint grid points.
GEOM2X GEOM2 table augmented with fluid data and SPOINTS if
ACMS='YES'.
GEOM4X GEOM4 table augmented with new RBE1 and RBE2 records (because
all RBE1 and RBE2 elements are split so that each one contains only
one m-set grid) for ACMS='YES'. Also augmented with SEQSET1
records for ACMS='YES'.
Main Index
SEQP
Resequencing processor
1418
Parameters:
SEQOUT Input-integer-default=0. Output options:
0 No output.
1 Print a formatted table of the internal versus external grid identification
number.
2 Write the SEQGP entries to the punch file (.pch).
3 Combines 1 and 2.
SEQMETH Input/output-integer-default=3. Resequencing method:
-1 No resequencing is performed.
1 Active/passive.
2 Band.
3 For the active/passive and the band options select the option giving the lowest
RMS value of the active columns for each group of grid points. (Default)
4 Wavefront (Levy).
5 Gibbs-King. See Remark 4.
6 Automatic nested dissection. See Remark 4.
7 Multiple Minimum Degree of Freedom. See Remarks 3 and 4.
8 Semiautomatic selection. See Remark 5.
On output SEQMETH is set to -1 if new sequence results in a lower decomposition
time estimate. Otherwise it is set to 0.
SETNAME Input-character-default='G'. Degree-of-freedom set name corresponding to the size
of MAT (Format 2 only).
SUPER Input-integer-default=0. Selects coupled or uncoupled sequencing or special
handling of multipoint constraints.
FACTOR Input-integer-default=0. Factor in the computation of the sequenced identification
number (SEQID) on the SEQGP. See Remark 7.
MPCFLG Input-integer-default=0. Controls whether the grid point connectivity created by
multipoint constraint Bulk Data entries (MPC, MPCADD, and MPCAX and the
rigid element entries; e.g., RBAR) is considered during resequencing.
-1 Do not consider.
0 Consider. (Default)
>0 Consider only the MPC, MPCADD, and MPCAX entries with a set
identification number equal to this parameter's value as well as the of the rigid
element entries.
START Input-integer-default=0. The number of the grid points at the beginning of the input
sequence. See Remark 8.
Main Index
1419 SEQP
Resequencing processor
MSGLVL Input-integer-default=0. Diagnostic output flag.
0 No.
>0 Yes.
PEXIST Input-logical-default=FALSE. If set to TRUE then it specifies the existence of
p-elements.
PSEQOPT Input-character-default=' '. Specifies append (default) or insert option for p-
elements. See Remark 9.
NTIPS Input/output-integer-default=0. The number of domains (tip superelements to be
created automatically when ACMS='YES'. If NTIPS=0, then the number of
domains will be set equal to the number of processors.
APP Input-character-default=' '. Analysis type. Allowable values:
'STATICS' Statics.
'REIGEN' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
ZCOLLCT Input/output-integer-default=-1. The absolute value is the number of collectors in
the last level of a multilevel tree (see ACMS='YES). If ZCOLLCT<0, then a single
final collector will be added.
TIPSCOL Input/output-integer-default=-1. The number of tip superelements upstream of
each downstream collector superelement. See ACMS='YES'.
ACMS Input-character-default=' '. Automatic component mode synthesis flag. If
ACMS='YES', then the model will be automatically partitioned into superelements
according to NTIPS, TIPSCOL, and ZCOLLCT.
FLUIDSE Output-integer-default=0. Fluid superelement identification number. Set to a value
greater than zero if ACMS='YES' and fluid elements are present.
ATQSET Input-logical-default=FALSE. Q-set generation flag for ACMS=YES.
FALSE Generate a fixed number of q-set dofs for each domain.
TRUE Generate a single q-set dof for the residual structure and the fluid
superelement. Usually set indirectly by user parameter.
PARTMEM Input-integer-default=0. Partitioning memory allocation control.
Main Index
SEQP
Resequencing processor
1420
Remarks:
1. In the geometry table option, SEQP generates SEQGP Bulk Data entries to be appended to the in
the GEOM1 data block and/or written to the punch file.
2. In the matrix option, GPL, USET, and SIL are required for SEQOUT>0 and may be purged if
SEQOUT=0.
3. SEQMETH=7 is recommended for sparse decomposition and sparse forward-backward
substitution only. The assembly of stiffness, mass, and damping matrices by the EMA module
may be less efficient under this option. Also, if there is insufficient memory available to perform
sparse decomposition, then regular decomposition will be performed and regular decomposition
is inefficient under this option.
4. SEQMETH=5, 6, or 7, resequencing will be performed even if the CPU estimate is higher than
for no resequencing.
5. For SEQMETH=8, the estimates will be computed for two sequencing methods that are suitable
for the decomposition method selected by the PARALLEL and SPARSE keywords on the
NASTRAN statement and select the sequencing method with the lowest estimate. The following
table shows the suitable methods for each decomposition method.
6. Description of SUPER:
If PARAM,SUPER=0, all grid points from the connection table that are not part of the group
currently being processed are deleted. This option provides for sequencing only the interior
points of a superelement. If any superelements are present, the residual structure is not
resequenced. If all of the grid points are in the residual structure, they are resequenced.
If PARAM,SUPER=0 or 1, all grid points in the connection table are considered. This option
provides for the recognition of passive columns.
If PARAM,SUPER=2, then all points that are connected to multipoint constraints (via MPC
entries) or rigid elements (e.g., the RBAR entry) are placed in a special group at the end of the
sequence. This option also forces SEQMETH=6 and may not be selected with other values of
SEQMETH. This option is intended primarily for models that have many active columns due to
MPCs or rigid elements; e.g., a model with disjoint structures connected only by MPCs or rigid
elements. See Matrix decomposition with extended diagnostics (Ch. 3) in the MSC.Nastran
Numerical Methods Users Guide for a further discussion of sequencing operations.
7. FACTOR is used as follows:
SEQID = FACTOR * GRP + SEQ
where SEQ generated sequence number and GRP group sequence number.
Decomposition Method
Suitable
SEQMETH
non-sparse and non-parallel 1 and 4
parallel 2 and 5
sparse 6 and 7
Main Index
1421 SEQP
Resequencing processor
If GRP=0, use GRP(MAX)+1 where GRP(MAX) is the largest group sequence number
previously processed.
8. START specifies the input sequence will be the sorted order of the grid point numbers including
the effect of any SEQGP entries input by the user. A single SEQGP entry can be input to select
the starting point for the new sequence. Otherwise, the first point of lowest connectivity will be
used as the starting point
9. PSEQOPT has the following values and actions:
PSEQOPT='APPEND'. The list of all p-element grids at the bottom after all the regular grids.
APPEND is intended for p-element analysis with p-version preconditioning, i.e., SEQMETH =
5, 6 or 7.
PSEQOPT='INSERT'. Insert the p-element grids in appropriate locations immediately after the
regular grid point to which they are associated which is the default in p-element analysis.
INSERT is intended for p-element analysis without p-version preconditioning, i.e., SEQMETH
= -1, 1, 2, 3 or 4.
Example:
The following example will generate a mapping matrix (SEQMAP) to resequence the matrix KAA. The
following SMPYAD module will resequence the rows and columns of KAA. Following the
decomposition of the resequenced matrix (KAAX), the MPYAD will resequence the right-hand side (PA)
and FBS will perform the forward/backward substitution on the resequenced right-hand side (PAX). The
final MPYAD operation will return the solution (UAX) to the original sequence (UA).
SEQP KAA,,,/SEQMAP,//METHOD $
SMPYAD SEQMAP,KAA,SEQMAP,,,/KAAX/3////1////6 $
DECOMP KAAX/LAA,/ $
MPYAD SEQMAP,PA,/PAX/1 $
FBS LAA,, PAX/UAX/ $
MPYAD SEQMAP,UAX,/UA/ $
Main Index
SHPCAS
Appends primary models case control based on boundary shapes
1422
Appends the primary model's case control based on auxiliary or geometric model loads (boundary
shapes) and construct a vector for partitioning the primary model's solution matrices that correspond to
the boundary shapes.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
SHPCAS
Appends primary models case control based on boundary
shapes
SHPCAS CASECC,YGBNDR/
CASECC1,CVEC $
CASECC Table of Case Control command images for the primary model.
YGBNDR Boundary shape matrices appended for all auxiliary or geometric
models.
CASECC1 Primary model Case Control table appended with extra subcases to
account for the boundary shapes.
CVEC Partitioning vector for separating the primary model solutions from
boundary shape induced solutions.
Main Index
1423 SMA3
Assembles global stiffness based on general elements in GENEL Bulk Data entry
Assembles the global stiffness based on general elements as defined on the GENEL Bulk Data entry and
optionally adding to stiffness from regular elements.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remark:
KGG may be purged.
SMA3
Assembles global stiffness based on general elements in
GENEL Bulk Data entry
SMA3 GEI,KGG/
KGG1/
LUSET/NOGENL/NOSIMP $
GEI Table of general element data.
KGG Stiffness matrix in g-set with general elements.
KGG1 Matrix. The type (complex or real and single or double precision) of
[X] is the maximum of the types of [A], [B], o, and |. The size of [X]
is the size of [A] if [A] is present. Otherwise, it is the size of [B].
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
NOGENL Input-integer-no default. The number of general elements.
NOSIMP Input-integer-no default. The number of simple elements. Set to -1 if
there are no elements.
Main Index
SMPYAD
Matrix series multiply and add
1424
Multiplies a series of matrices together:
Format:
Input Data Blocks:
Output Data Block:
Parameters:
Remarks:
1. Except for the final product, all intermediate matrix products are compute in machine precision.
SMPYAD
Matrix series multiply and add
SMPYAD A,B,C,D,E,F/
X/
NMAT/SIGNP/SIGNF/PREC/TA/TB/TC/TD/FORM
A, B, C, D, E Matrices multiplied from left to right. (Real or complex).
F Matrix to be added to the above product. (Real or complex).
X Resultant matrix.
NMAT Integer-input-no default. Number of matrices involved in the product;
i.e., [A][B][C][D][E].
SIGNP Integer-input-default=1. Sign of the product matrix (i.e., [A] [B] [C]
[D] [E]): -1 for minus.
SIGNF Integer-input-default=1. Sign of the matrix. [F], to be added to the
product matrix: -1 for minus.
PREC Integer-input-default=0. Output precision of the final result: 0 for
choose proper precision, 1 for single precision, 2 for double precision.
TA, TB, TC, TD Integer-input-default=0. Transpose indicators for the [A] [B] [C] and
[D] matrices: 1 if transposed matrix to be used in the product, 0 if
untransposed. The last nonpurged matrix must be untransposed.
FORM Integer-input-default=0. Form of the X matrix. If FORM is zero, the
form of [X] will be 1 if the result is square, 2 otherwise. If [X] is known
to be symmetric from physical principles, FORM may be set to 6.
X | | A | | B | | C | | D | | E | | F | | =
Main Index
1425 SMPYAD
Matrix series multiply and add
2. The matrices are postmultiplied together from right to left; i.e., the first product calculated is the
product of matrix n-1 and matrix n. This implies that all purged inputs must be to the right. If the
transpose flag is set for the last unpurged matrix, it is ignored without warning.
3. If the input matrices are incommensurate (for example, if the number of columns in A is not equal
to the number of rows in B) or incompatible, then the User Fatal Message 5423 ATTEMPT TO
MULTIPLY INCOMPATIBLE MATRICES is issued.
4. The method used by this module is the same as for the MPYAD module except in case of a triple
product, where and are symmetric and and ; i.e.,
], then a method that is more efficient than two equivalent MPYAD
operations will be employed. See Example 3. However, two equivalent MPYAD operations will
be selected automatically if two MPYADS are more efficient. (Two MPYADs can be forced by
setting system cell 129 to 1, with PUTSYS(1,129) specified just before the SMPYAD module.)
5. If any of the matrices involved in the product do not exist, then the module does not create any
output.
Examples:
1. Compute .
SMPYAD A,B,C,,,F/X/3/1/-1/0/0/1 $
2. Compute [Z].
SMPYAD U,V,W,X,Y,/Z/5/-1/0/0/1/1/1/1 $
3. Compute .
SMPYAD PHI,MAA,PHI, ,,/X/3////1////6 $
B | | F | | A | | C | | = TA 1 =
X | | A | |
T
B | | A | | F | | =
X | | A | | B | |
T
C | | F | | =
Z | | U | |
T
V | |
T
W | |
T
X | |
T
Y | | =
| | |
T
M | | | | |
Main Index
SOLVE
Linear system solver
1426
Solves the matrix equation or the left-hand solution .
Format:
Input Data Blocks:
Output Data Block:
Parameters:
SOLVE
Linear system solver
SOLVE A,B,SIL,USET,PARTVEC/
X/
SYM/SIGN/SETNAME $
A Square, symmetric or unsymmetric, matrix (real or complex).
B Rectangular matrix (real or complex).
SIL Scalar index list.
USET Degree-of-freedom set membership table.
PARTVEC Partitioning vector which is specified when A and B are the zero-th
partitions of the set specified by SETNAME.
X Rectangular matrix. See Remark 1.
SYM Input integer default = 0 selects solution method.
0 Use either symmetric or unsymmetric method consistent with symmetric or
unsymmetric .
1 Use symmetric method.
-1 Use unsymmetric method.
2 Solve left-hand solution for .
3 Compute inverse of . See Remark 2.
SIGN Input integer default = 1. Sign of right-hand side flag.
1 Solve .
-1 Solve .
SETNAME Input-character-default = H. Degree-of-freedom set name corresponding to A
and B.
A | | X | | B | | = X | |
T
A | | B | |
T
=
A | |
X | |
T
A | |
A | | X | | B | | =
A | | X | | B | | =
Main Index
1427 SOLVE
Linear system solver
Remarks:
1. is a rectangular matrix with the same dimensions as and the maximum type of and
.
2. If SYM = 3, then is ignored.
If and is purged, then will be purged; or if is a null matrix, then will
be a null matrix.
3. By default, the SOLVE module uses sparse matrix methods. See Remark 1 under the DECOMP
module description.
4. Parallel processing in this module (Method 1A only) is selected with the NASTRAN statement
keyword PARALLEL (or SYSTEM (107)). To force parallel processing, also specify
NASTRAN FBSOPT = -2 SPARSE = 0.
5. Data blocks USET, SIL, and PARTVEC and parameter SETNAME are required for the most
efficient method of decomposition. PARTVEC is only required if A is not the same size as
SETNAME.
Examples:
1. Solve a system of equations .
SOLVE A,P,,,/X/ $
2. Invert .
SOLVE A,,,,/AINV/3 $
3. Solve .
SOLVE A,P,,,/X/2 $
X | | B | | A | |
B | |
B | |
SYM 3 = B | | X | | B | | X | |
A | | X | | P | | =
A | |
X | |
T
A | | P | |
T
=
Main Index
SOLVIT
Iterative solver
1428
Solves the matrix equation ] for using a preconditioned conjugate gradient method.
Format for Non-p-version Analysis:
Format for p-version Analysis:
Input Data Blocks:
SOLVIT
Iterative solver
SOLVIT A,B,XS,PC,USET,KGG,GM,SIL,EQEXIN,EDT,CASECC,EQ
MAP,
BGPDT,CSTM,PG,YS,KDICT,KELM,EST,MPT,DIT/
X,R,PC1,EPSSE/
SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/
NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID
EBSOPT/CVMEM/CASPIV/SET $
SOLVIT A,B,XS,PS,USET,USET0,SIL0,SIL,EQEXIN,EDT,CASEC
C,
EQMAP,,,,,,,,,/
X,R,PG,EPSSE/
SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/
NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID $
A Square matrix (real or complex, symmetric or unsymmetric).
B Rectangular matrix (real or complex), the right-hand side.
XS Optional starting vector, same type as B (may be purged).
PC Optional stepwise preconditioner, same type as A (may be purged).
USET Degree-of-freedom set membership table. See Remark 3.
KGG Stiffness matrix -- g-set. See Remark 3.
GM Multipoint constraint transformation matrix. See Remark 3.
USET0 USET table from previous adaptivity index in p-version analysis.
SIL Scalar index list.
SIL0 SIL table from previous adaptivity index in p-version analysis.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers. Required for p-version preconditioning only.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver.
A | | X | | B | | = X | |
Main Index
1429 SOLVIT
Iterative solver
Output Data Blocks:
CASECC Table of Case Control command images. Required if SMETHOD Case
Control command is used and NSIP=-1.
EQMAP Table of degree-of-freedom global-to-local maps for domain
decomposition.
BGPDT Basic grid point definition table. Only used for element based solver
methods.
CSTM Table of coordinate system transportation matrices. Only used for
element based solver methods.
PG Static load matrix applied to the g-set. Only used for the element based
solver methods.
YS Matrix of enforced displacements. Only used for element based solver
methods.
KDICT KELM dictionary table. Only used for element based solver methods.
KELM Table of element matrices for stiffness. Only used for element based
solver methods.
EST Element summary table. Only used for element based solver methods.
MPT Material property table. Only used for element based solver methods.
DIT Table of TABLEij Bulk Data entry images. Only used for element
based solver methods.
X Solution matrix. Rectangular matrix having the same dimensions and
type as .
R Residual matrix. Rectangular matrix having the same dimensions and
type as , the residual .
PC1 Updated stepwise preconditioner matrix. See Remark 6.
EPSSE Table of epsilon and external work.
B | |
B | | R | | B | | A | | X | | =
Main Index
SOLVIT
Iterative solver
1430
Parameters:
SIGN Input-integer-default = 0. Sign flag for .
0 +
1 -
ITSOPT Input-integer-default = 0. Preconditioner flag.
0 Choose optimal method based on type of problem:
ITSOPT Type of problem
6 p-version and real and .
10 complex [ and/or .
11 non p-version and real and .
1 Jacobi preconditioning (default) for real, complex, symmetric and
unsymmetric A.
2 Incomplete Cholesky preconditioning or user-given preconditioner.
3 Reduced incomplete Cholesky preconditioning. preconditioner (available for
real symmetric A only).
4 User supplied for real, complex, symmetric A.
5 Incomplete geometric, Jacobi hierarchic for real symmetric A.
6 Complete geometric, Jacobi hierarchic for real symmetric A.
7 Complete geometric, incomplete hierarchic for real symmetric A.
10 Block incomplete Cholesky for well-conditioned real symmetric A (default
for real A).
11 Block incomplete Cholesky for well-conditioned complex symmetric A
(default for complex A).
<0 Same as above with diagonal scaling.
ITSEPS Input-real-default = 1.0E-6. Convergence parameter epsilon.
ITSMAX Input-integer-default = 0. Maximum number of iterations. The default value
implies N/4 (N = dimension of [A]).
IPAD Input-integer-default = 0 (see table below). Padding level for reduced or block
incomplete Cholesky factorization (0, 1, 2, ...). See Remarks 1 and 2.
IPAD Method ITSOPT
Model
type
Type of
0 reduced incomplete Cholesky 3 all real
2 block incomplete Cholesky 10,11 3-D real
B | |
B | |
B | |
A | | B | |
A | | B | |
A | | B | |
A | |
Main Index
1431 SOLVIT
Iterative solver
3 block incomplete Cholesky 10,11 2-D or
mixed
real
5 block incomplete Cholesky 10,11 all complex
IEXT Input-integer-default = 0. Extraction level in reduced or block
incomplete Cholesky factorization. See Remarks 1 and 2.
IEXT Reduced Block
0 0 solid bodies, no rigid elements. Requires USET and SIL.
1 1 shells only. Heuristic block structure. (Default)
2 2 mixed including rigid elements. Not applicable.
ADPTINDX Input-integer-default=0. P-version analysis adaptivity index. See Remark 7.
NSKIP Input-integer-default=1. Record number of current subcase in CASECC and used
only if the SMETHOD command selects the ITER Bulk Data entry which
specifies values for the desired iteration parameters. If NSKIP=-1 then CASECC
is not required and the values are taken from the module specification of the
values.
MSGLVL Input-integer-default=0. Message level output.
0 minimal; i.e., UIM 6447 (default).
1 UIM 6447, convergence ratios, and residual norms.
PREFONLY Input-integer-default=0. Preface execution only. If set to -1 then SOLVIT
is terminated after the preface information is computed and printed.
ITSERR Output-integer-default=0. Iterative solver return code.
1 No convergence.
2 Insufficent memory.
SEID Input-integer-default=0. Superelement identification number.
EBSOPT Input-integer-default=0. Element-based solver option.
=-2 Determine whether element-based solver is selected for use.
=-1 Determine whether any element-based solver restrictions have been
violated.
>0 A combination of bit values used to select solver options as follows:
IPAD Method ITSOPT
Model
type
Type of
A | |
Main Index
SOLVIT
Iterative solver
1432
Remarks:
1. If ITSOPT = 3, the IPAD level is recommended to be 0, 1, or 2 (IEXT = 0) and should be increased
when IEXT is increased.
2. The amount of memory needed for ITSOPT = 3, 10, and 11 increases with the increase of the
parameters IPAD and IEXT.
3. For ITSOPT = 1 or 2, the input data blocks USET, KGG, and GM may be purged. For
ITSOPT = 3, USET must be specified. KGG and GM are necessary only if IEXT = 2.
4. If the message *** USER FATAL MESSAGE 6288 (SITDRV): UNABLE TO CONVERGE
WITH ITERATIVE METHOD is issued, then results will still be printed but may be inaccurate.
5. The system cell SYSTEM (69) is equivalent to the SOLVE keyword and controls some special
options for the module:
Bit Value Option
0 0 Run solver with all defaults.
1 1 Use CASI solver.
2 2 Use VKI solver.
3 4 Reserved.
4 8 Reserved.
5 16 Reserved.
6 32 Reserved.
7 64 Use open core for solver memory.
8 128 Generate intermediate diagnostics.
9 256 Use alternate pcg method.
10 512 Reduce I/O (CASI solver only).
11 1024 Adapt PCG (CASI solver only).
12 2048 Do not use implicit elements (CASI solver only)
CVMEM Input-integer-default=16000. CASI virtual memory. Available if heap is used.
CASPIV Input-real-default-1.0E-10. Pivot threshold for CASI PCG factorization.
SET Input - character, default = "H" = dof set for the input matrices. Used in identifying dof
when a problem occurs.
Main Index
1433 SOLVIT
Iterative solver
6. If data block PC1 is specified, the CPU time will increase slightly.
7. If SOLVIT is to be used for p-element analysis and ADPTINDX>1, then XS and PC must be the
solution matrix and pre-conditioner from the previous adaptivity p-level. Also, the USET and SIL
from the previous p-level are specified for U and KGG and the USET and SIL from the current
p-level are specified for GM and SIL.
8. For frequency response analysis with ITSOPT=10 or 11 (block incomplete Cholesky), IEXT=0
is not available and IEXT=1 is used automatically.
Examples:
1. Solve with Jacobi pre-conditioning with convergence established at 1.E-4 and
maximum allowed iterations at 55 specified for the module parameters.
SOLVIT A,B,,,,,,,,,/X,,//1/1.E-4////-1 $
2. Same as 1 except parameters are obtained from the SMETHOD command and ITER entry.
SOLVIT A,B,,,,,,,,EDT,CASECC,,,,,,,,,,/X,, $
3. Same as 2 except for p-version analysis.
DBVIEW SIL0 = SILS (WHERE PVALID=PVALOLD) $
DBVIEW UL0 = UL (WHERE PVALID=PVALOLD) $
DBVIEW USET0 = USET (WHERE PVALID=PVALOLD) $
DBVIEW PRECON0 = PRECON (WHERE PVALID=PVALOLD) $
SOLVIT KLL,PLI,UL0,PRECON0,USET,USET0,SIL0,SILS,
EQEXINS,EDT,CASES/
UL,RUL,PRECON///////ADPTINDX/NSKIP $
SOLVE Action
2 Suppresses the user information message at each iteration.
8 Use alternative convergence criterion (less conservative than default).
A | | X | | B | | =
Main Index
SSG1
Computes static load matrix
1434
Computes the static load matrix based on static loads, thermal loads, and enforced deformation loads or
heat transfer loads. Also the generates acceleration matrix due to inertial loads for design sensitivity
analysis.
Format:
Input Data Blocks:
SSG1
Computes static load matrix
SSG1 SLT,BGPDT,CSTM,MEDGE,EST,MPT,ETT,EDT,MGG,CASEC
C,
DIT,UG,DEQATN,DEQIND,GPSNT,CSTM0,SCSTM,GEOM4,E
STL,
SLTNL0,KGG,USET/
, PTELEM,SLTH,SLTNL,PGRV/
LUSET/NSKIP/DSENS/APP/ALTSHAPE/TABS/SEID/
COMBMETH/LGDISP/NONLNR/OGRAV $
SLT Table of static loads.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
MEDGE Edge table for p-element analysis.
EST Element summary table.
MPT Table of Bulk Data entry images related to material properties.
ETT Element temperature table.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries.
MGG Mass or radiation matrix in g-set.
CASECC Table of Case Control command images.
DIT Table of TABLEij Bulk Data entry images.
UG Displacement matrix in g-set.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
GPSNT Grid point shell normal table.
PG
AG
)
`
Main Index
1435 SSG1
Computes static load matrix
Output Data Blocks:
CSTM0 Table of coordinate system transformation matrices for the residual
structure.
SCSTM Table of global transformation matrices for partitioned superelements.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity. Required for
selected SPCD existence checks.
ESTL Linear element summary table.
SLTNL0 SLTNL from a prior execution of SSG1.
KGG Stiffness matrix in g-set.
USET0 Degree-of-freedom set membership table for g-set.
KGG Stiffness matrix in g-set.
USET Degree-of-freedom set membership table for g-set.
PG Static load matrix applied to the g-set.
AG Acceleration matrix due to inertial loads in the g-set. See DSENS.
PTELEM Table of thermal loads in the elemental coordinate system.
SLTH Table of static loads updated for heat transfer analysis.
SLTNL SLT with follower forces for CQUADR/CTRIAR elements for both
the current and last load step.
PGRV Static load matrix applied to the g-set but due to gravity loads only.
Main Index
SSG1
Computes static load matrix
1436
Parameters:
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set
NSKIP Input-integer-default=1. The record number in CASECC corresponding to the first
subcase of the current boundary condition.
DSENS Input-integer-default=-1. Acceleration matrix creation flag. Set to 1 to generate AG,
accelerations due to inertial loads.
APP Input-character-default='STATICS'. Analysis type.
'STATICS' Generate loads for current boundary condition only.
'BUCK' Generate loads for first subcase only.
'NLST' Generate loads for nonlinear static or steady state heat transfer
analysis.
'ALL' Generate loads for all subcases.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in
p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full
Product Space set.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SEID Input-integer-default=0. Superelement identification number.
COMBMETH Input-integer-default=0 Combine method selection.
0 Automatic.
1 Single term.
2 Scaled column.
3 Multiple/add kernels.
<0 Same as above with diagnostic print.
LGDISP Input-Integer-default=-1. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
NONLNR Input-logical-default=FALSE. Nonlinear solution sequence flag. Set to TRUE if
nonlinear solution sequence is being executed.
OGRAV Input-integer-default=-1. PGRV output flag.
>0 Compute PGRV.
<0 Do not compute PGRV.
Main Index
1437 SSG1
Computes static load matrix
Remarks:
1. One static load is built for each CASECC record starting with NSKIP + 1 as long as the boundary
conditions are constant. IF , it is set to zero.
2. In SLTH the heat transfer loads REFERENCING ELEMENTS (QVOL, QBDY1, QBDY2,
QBDY3 and QVECT Bulk Data entries) have been converted to applied load factors and
connected grid points.
3. SLT and BGPDT cannot be purged if external static loads or LOAD Bulk Data entries are selected
in CASECC.
4. CSTM cannot be purged if any grid point or load references a coordinate system other than basic.
5. EST and MPT cannot be purged if thermal or element deformation loads are selected.
6. ETT cannot be purged if thermal loads are applied.
7. EDT cannot be purged if element deformation loads are selected.
8. MGG cannot be purged if GRAV or RFORCE loads are applied.
9. DIT cannot be purged if temperature-dependent materials are present.
10. UG may be purged, but geometric nonlinear effects will be ignored.
11. PTELEM may be purged.
12. CSTM0 and SCSTM are required to support the MB=-1 on the GRAV and RFORCE Bulk Data
entries.
SKIP 0 s
Main Index
SSG2
Reduces static load and enforced displacement matrices
1438
Reduces the static load and enforced displacement matrices.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Method:
The constraints are applied to the static load vectors by SSG2 (Static Solution Generator -- Phase 2) in
subDMAP SELR as follows:
SSG2
Reduces static load and enforced displacement matrices
SSG2 USET,GM,YS,KFS,GOA,DM,PG,KGG/
QR,PO,PS,PA,PL $
USET Degree-of-freedom set membership table for g-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
YS Matrix of enforced displacements or temperatures.
KFS Stiffness matrix partition (f-set by s-set) from KNN.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
DM Rigid body transformation matrix for the r-set to the l-set.
PG Static load matrix applied to the g-set.
KGG Stiffness matrix in g-set, for computation of thermal load for nonlinear
rigid elements using elimination method.
QR Matrix of determinate support forces.
PO Static load matrix partitioned to the o-set.
PS Static load matrix partitioned to the s-set.
PA Static load matrix reduced to the a-set.
PL Static load matrix reduced to the l-set.
Main Index
1439 SSG2
Reduces static load and enforced displacement matrices
(5-53)
(5-54)
(5-55)
(5-56)
(5-57)
(5-58)
If PARAM,ALTRED,YES is specified, the diagonal extracted from
If PARAM,ALTRED,YES is specified, the diagonal extracted from
and the reduced load matrix is computed from
(5-59)
where is obtained on a forward pass from the equation
(5-60)
for PARAM,ALTRED,NO.
Remarks:
1. GM cannot be purged if the m-set is present.
2. DM cannot be purged if the r-set and l-set are present.
3. PO cannot be purged if the o-set is present.
4. PS cannot be purged if the s-set is present.
5. QR and PL may be purged.
6. If there is no m-set, s-set, o-set, or r-set. then no outputs are produced.
7. If QR or PS are computed to be null then QR or PS will be purged.
8. If there is no r-set and PL is specified then PA will be copied to PL.
P
g
{ }
P
n
P
m
)
`
=
P
n
{ } P
n
{ } G
mn
| |
T
P
m
{ } + =
P
n
{ }
P
f
P
s
)
`
=
P
f
{ } P
f
{ } K
fs
| | Y
s
{ } =
P
f
{ }
P
a
P
o
)
`
=
P
a
{ } P
a
{ } G
oa
| |
T
P
o
{ } + =
L
oo
| | D
oo
| |
L
oo
| | D
oo
| |
P
a
{ } P
a
{ } L
ao
| | D
oo
| | u
o
x
| | =
u
o
x
{ }
L
oo
D
oo
| | u
o
x
{ } P
o
{ } =
Main Index
SSG2
Reduces static load and enforced displacement matrices
1440
9. If KFS or YS is purged then the outputs will not include the effect of enforced displacements.
Main Index
1441 SSG3
Computes static solutions
Computes the static solutions.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
SSG3
Computes static solutions
SSG3 LLL,UNUSED2,KLL,PL,LOO,UNUSED6,KOO,PO,LSEQ/
UL,UO,RUL,RUO,EPSSE/
NOOSET/UNUSED2/NSKIP/S,N,EPSI/S,N,EXTWORK/SEID
$
LLL Lower triangular factor/diagonal for the l-set from KLL.
UNUSED2 Unused and may be purged.
KLL Stiffness matrix reduced to the l-set.
PL Static load matrix reduced to the l-set.
LOO Lower triangular factor/diagonal for the o-set from KOO.
UNUSED6 Unused and may be purged.
KOO Stiffness matrix partitioned to the o-set from KFF.
PO Static load matrix partitioned to the o-set.
LSEQ Resequencing matrix based on internal resequencing of KLL in
DCMP.
UL Displacement matrix in l-set.
UO Displacement matrix in o-set.
RUL Residual matrix for the l-set.
RUO Residual matrix for the o-set.
EPSSE Table of epsilon and external work.
NOOSET Input-integer-no default. Number of degrees-of-freedom in the o-set or
omitted degree-of-freedom flag. Set to -1 if there are none.
UNUSED2 Input-integer-no default. Not used but specify 0.
Main Index
SSG3
Computes static solutions
1442
Method:
The SSG3 module (Static Solution Generation -- Phase 3) solves the equation
(5-61)
for , the displacements of the omitted coordinates.
SSG3 also calculates the residual vector, , and the residual vector error ratio, , for the omitted
coordinates
(5-62)
(5-63)
Except for round-off error, the error ratio should be zero. Large values of these error ratios usually
indicate singularities in the stiffness matrix. The residual load vector, RUOV, may be output by use of
PARAM,IRES,1.
The quantity
(5-64)
is calculated by the SSG3 module and printed under the heading External Work. This component of
strain energy includes effects of thermal loads, element deformations, and enforced displacements that
may be subtracted later in the solution process. For example, an enforced displacement that causes zero
strain will result in external work.
Remarks:
1. KLL may be purged if RUL is purged.
2. LOO, PO and UO may be purged if NOOSET<0.
3. KOO may be purged if NOOSET<0 or RUO is purged.
4. LLL or LOO may be purged.
NSKIP Input-integer-default=1. The record number in CASECC
corresponding to the first subcase of the current boundary condition.
EPSI Output-integer-default=1. Static solution error ratio flag. Set to -1 if the
error ratio is greater than 1.E-3.
EXTWORK Output-real-default=0.0. External work.
SEID Input-integer-default=0. Superelement identification number.
K
oo
| | u
o
o
{ } P
o
{ } =
u
o
o
{ }
oP
o
c
o
oP
o
{ } K
oo
| | u
o
o
{ } P
o
{ } =
c
o
u
o
o
{ }
T
oP
o
{ }
P
o
{ }
T
u
o
o
{ }
------------------------------- =
c
o
1 2 P
o
{ }
T
u
o
{ }
Main Index
1443 SSG3
Computes static solutions
5. PO or PL may be purged.
6. RUL and RUO may be purged.
Main Index
SSG4
Updates static loads with inertial loads
1444
Updates the static loads with inertial loads.
Format:
Input Data Blocks:
Output Data Blocks:
Parameter:
Remarks:
1. SSG4 computes rigid body accelerations based on the reactions on the fictitious supports. The
inertia loads on the structure are proportional to these accelerations.
SSG4
Updates static loads with inertial loads
SSG4 PL,QR,PO,MR,MLR,DM,MLL,MOO,MOA,GOA,USET/
PLI,POI/
NOOSET $
PL Static load matrix reduced to the l-set.
QR Matrix of determinate support forces.
PO Static load matrix partitioned to the o-set.
MR Rigid body mass matrix (r-set by r-set).
MLR Mass matrix partition (l-set by r-set) from MTT.
DM Rigid body transformation matrix for the r-set to the l-set.
MLL Mass matrix reduced to the l-set.
MOO Mass matrix partitioned to the o-set from KFF.
MOA Mass matrix partition (o-set by a-set) from MFF.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
USET Degree-of-freedom set membership table for g-set.
PLI Static load matrix with inertial loads and reduced to the l-set.
POI Static load matrix with inertial loads and reduced to the o-set.
NOOSET Input-integer-no default. Number of degrees-of-freedom in the o-set or
omitted degree-of-freedom flag. Set to -1 if there are none.
Main Index
1445 SSG4
Updates static loads with inertial loads
2. All input and output matrices must be present if their corresponding degree-of-freedom set is
present. If PLI is purged, then PL, MLR, and MLL may be purged.
Main Index
ST2DYN
Transforms IFP data from nonlinear static to transient analysis
1446
Transforms CASECC and several IFP data blocks from the nonlinear static analysis format to nonlinear
transient response format.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
ST2DYN
Transforms IFP data from nonlinear static to transient
analysis
ST2DYN CASECC,MPT,DYNAMIC,GEOM3,DIT,GEOM4/
CASENT,MPTNT,DYNAMNT,GEOM3NT,DITNT/
S,N,NBNLST/S,N,NBLSEQ $
CASECC Table of Case Control command images.
MPT Table of Bulk Data entry images related to material properties.
DYNAMIC Table of Bulk Data entry images related to dynamics.
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
DIT Table of TABLEij Bulk Data entry images.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity.
CASENT CASECC transformed for nonlinear transient response analysis.
MPTNT MPT transformed for nonlinear transient response analysis.
DYNAMNT DYNAMIC transformed for nonlinear transient response analysis.
GEOM3NT GEOM3 transformed for nonlinear transient response analysis.
DITNT DIT transformed for nonlinear transient response analysis.
NBNLST Output-integer-default=0. Number of nonlinear static records.
NBLSEQ Output-integer-default=0. Number of new LSEQ entries created.
Main Index
1447 STATICS
Performs static analysis on real symmetric stiffness matrix
Performs static analysis on real symmetric stiffness matrix using the iterative or direct methods for the
solution and Lagrange Multiplier techniques for constraint processing. Also designed and implemented
to take advantage of distributed memory parallelism (DMP) or networked computers.
Format:
Input Data Blocks:
Output Data Blocks:
STATICS
Performs static analysis on real symmetric stiffness matrix
STATICS KGG,PG,YS,RMG,CASECC,USET,EQEXIN,SIL,PC,XS,EDT
/
UG,PC1,RUG,QG,QMG/
STATOPT/SIGN/ITSOPT/ITSMAX/ITSEPSR/
NSKIP/NOSPC/NOQMG/EPSNUM $
KGG Stiffness matrix in g-set.
PG Static load matrix applied to the g-set.
YS Matrix of enforced displacements.
RMG Multipoint constraint equation matrix.
CASECC Table of Case Control command images.
USET Degree-of-freedom set membership table for g-set.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
SIL Scalar index list.
XS Optional starting vector, same as PG.
PC Optional stepwise preconditioner, same as KGG.
EDT Table which contains ITER Bulk Data entries. Required for NSKIP=-
1 only.
UG Displacement matrix in g-set.
PC1 Updated stepwise preconditioner matrix.
RUG Residual matrix for the g-set.
QG Single-point constraint forces of constraint matrix in the g-set.
QMG Multipoint constraint forces of constraint matrix in the g-set.
Main Index
STATICS
Performs static analysis on real symmetric stiffness matrix
1448
Parameters:
Remarks:
1. See the SOLVIT, 1428 module for further discussion related to the iterative method.
2. PC, XS, PC1, and RUG may be purged.
3. CASECC and EDT may be purged if NSKIP=-1.
4. ITSOPT, ITSMAX, and ITSEPSR are ignored if NSKIP>0.
STATOPT Input-character-no default. Static solution method.
'DRCT' Direct.
'ITER' Iterative.
SIGN Input-integer-default=1. Sign of right hand side matrix, PG.
1 Positive.
-1 Negative.
ITSOPT Input-integer-default=1. Preconditioner flag. See the SOLVIT, 1428 module.
ITSMAX Input-integer-default=1. Maximum number of iterations for iterative solution
method.
ITSEPSR Input-real-default=1.E-6. Convergence parameter epsilon for iterative solution
method.
NSKIP Input-integer-default=1. Record number of current subcase in CASECC and
used only if the SMETHOD command selects the ITER Bulk Data entry which
specifies values for the desired iteration parameters. If NSKIP=-1 then
CASECC and EDT are not required and the values are taken ITSOPT,
ITSMAX, and ITSEPSR.
NOQG Input-integer-default=1. Single-point forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
NOQMG Input-integer-default=1. Multipoint forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
EPSNO Input-integer-default=-1. Number of solutions to check and the quantity of
error checking output. If left at its default value, only the highest epsilon for the
first ten solutions (whichever is less) are printed. If EPSNO is greater than zero,
the epsilons for the first EPSNO are printed.
Main Index
1449 STDCON
Calculate stress discontinuities across elements and grid points
Calculate stress discontinuities across elements and grid points.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
STDCON
Calculate stress discontinuities across elements and grid
points
STDCON CASECC,EGPSF,EQEXIN,OES1,EGPSTR,ECT/
OEDS1,OGDS1,ELDCT,GPDCT/
S,N,NOEDS1/S,N,NOGDS1/S,N,NOELDCT/S,N,NOGDCT/A
PP $
CASECC Table of Case Control command images.
EGPSF Table of element to grid point interpolation factors.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
GPL External grid/scalar point identification number list.
OES1 Table of element stresses or strains in SORT1 format.
EGPSTR Table of grid point stresses or strains for post-processing in the DBC
module.
ECT Element connectivity table.
OEDS1 Table of element stress discontinuities.
OGDS1 Table of grid point stress discontinuities.
ELDCT Table of element stress discontinuities for post-processing in the DBC
module.
GPDCT Table of grid point stress discontinuities for post-processing in the
DBC module.
NOEDS1 Output-integer-default=-1. OEDS1 generation flag. Set to 0 if OEDS1 is
generated.
NOGDS1 Output-integer-default=-1. OGDS1 generation flag. Set to 0 if OGDS1 is
generated.
Main Index
STDCON
Calculate stress discontinuities across elements and grid points
1450
NOELDCT Output-integer-default=-1. ELDCT generation flag. Set to 0 if ELDCT is
generated.
NOGPDCT Output-integer-default=-1. GPDCT generation flag. Set to 0 if GPDCT is
generated.
APP Input-character-default='STATICS. Analysis type. Allowable values:
'STATICS' Statics.
'REIGEN' Normal modes.
Main Index
1451 STRSORT
Filters and sorts element data recovery tables
Filters and sorts element data recovery tables (e.g., stresses, strains, and forces).
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
STRSORT
Filters and sorts element data recovery tables
STRSORT OFPE,INDTA/
OFPES/
NUMOUT/BIGER/SRTOPT/SRTELTYP/SRTTYP $
OFPE Element data recovery table in SORT1 or SORT2 format.
INDTA Table of element stress/strain or force item code overrides.
OFPES Filtered and sorted element data recovery table.
NUMOUT Input-integer-default=-1. Output element quantity flag.
>0 Number of element quantities per element type to be output.
0 Output all quantities for elements in a group if the absolute value of one or
more elements is greater than BIGER.
-1 Output sorted quantities with absolute value greater than BIGER.
-2 Output filtered quantities with absolute value greater than BIGER.
BIGER Input-real-default=0.0. Minimum absolute value of element quantity to be output.
SRTOPT Input-integer-default=0. Filter/sort option based on NUMOUT and BIGER.
0 Maximum magnitude.
1 Minimum magnitude.
2 Maximum algebraic.
3 Minimum algebraic.
SRTELTYP Input-integer-default=0. Element type to be filtered and sorted. By default, all
element types will be filtered and sorted.
SRTTYP Input-integer-default=0. Item code 1 sort flag. Set to 1 to perform an integer sort on
item code 1 which is usually an integer quantity.
Main Index
STRSORT
Filters and sorts element data recovery tables
1452
Remarks:
1. For further discussion see the DTI,INDTA and PARAM,S1 descriptions in the <emphasis>MSC
Nastran Quick Reference Guide.
2. SRTTYP=1 is used primarily to sort slideline element output by slave grid point identification
number.
Main Index
1453 TA1
Combines element data into tables
Combines all of the element data (geometry, connection, and properties) into a table(s) convenient for
generation of the element matrices (stiffness, mass, etc.) and output quantities (stress, force, etc.).
Format:
Input Data Blocks:
Output Data Blocks:
TA1
Combines element data into tables
TA1 MPT,ECT,EPT,BGPDT,SIL,ETT,CSTM,DIT,ECTA,EHT,N2M/
EST,ESTNL,GEI,GPECT,ESTL,VGFD,DITID,NFDICT,ESTNSM/
LUSET/S,N,NOESTL/S,N,NOSIMP/NOSUP/S,N,NOGENL/SEID/
LGDISP/NLAYERS/S,N,FREQDEP/PSHLDAMP/
S,N,MGEFLAG/NSMSID/xESTM/MultiPhy/LGDISPU/Texist $
MPT Table of Bulk Data entry images related to material properties.
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
BGPDT Basic grid point definition table.
SIL Scalar index list.
ETT Element temperature table.
CSTM Table of coordinate system transformation matrices.
DIT Table of TABLEij Bulk Data entry images.
ECTA Secondary element connectivity table.
EHT Element hierarchical table for p-element analysis.
N2M Nastran-2-Marc element-type conversion table
EST Element summary table.
ESTNL Nonlinear element summary table.
GEI Table of general element data.
GPECT Grid point element connection table.
ESTL Linear element summary table.
VGFD Partitioning vector with ones at rows corresponding to degrees-of-freedom
connected to frequency-dependent elements.
DITID Table of identification numbers in DIT.
Main Index
TA1
Combines element data into tables
1454
Parameters:
NFDICT Nonlinear element energy/force index table.
ESTNSM NON-STRUCTURAL MASS ELEMENT SUMMARY TABLE
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
NOESTL Output-integer-no default. ESTL generation output flag. Set to 1 if ESTL is
generated; -1 otherwise.
NOSIMP Output-integer-no default. The number of elements exclusive of general elements.
Set to -1 if there are no simple elements.
NOSUP Input-integer-no default. Element summary table request flag.
1 Generate EST only (usually for linear analysis).
2 Form EST, ESTNL and ESTL (usually for nonlinear analysis).
NOGENL Output-integer-no default. The number of general elements.
Set to -1 if there are no general elements.
SEID Input-integer-no default. Superelement identification number.
LGDISP Input-integer-default=1. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
NLAYERS Input-integer-default=6. Number of layers to integrate through the thickness of
CQUAD4 and CTRIA3 elements in nonlinear analysis.
FREQDEP Output-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE
if frequency-dependent elements are present.
PSHLDAMP Input-character-default=SAME. Structural damping default flag for MID2,
MID3, and MID4 on the PSHELL entry. Usually input by user parameter.
= 'SAME' Structural damping properties for MID2, MID3, and MID4 are
assumed to be the same as MID1.
<>'SAME' Each MIDi may have its own structural damping properties.
Main Index
1455 TA1
Combines element data into tables
Remarks:
1. MPT, ESTL, and ESTNL may be purged if NOSUP=1.
2. ECTA and EHT may be purged if p-elements or interface elements are not present.
3. GEI, ESTL, ESTNL, and DITID may be purged as long as EST is purged.
4. VGFD may be purged.
5. DITID may be purged as long as DIT is purged.
6. MGEFLAG is set on output according to the following conditions and the new value is used on
input to EMG.
MGEFLAG Output-integer-default=0. Multiple structural damping flag for PSHELL and
PBUSH property entries. See Remark 6.
0 All PSHELL entries have uniform GE values across MIDi or the user
parameter SHLDAMP=SAME has been specified. Also all of the PBUSH
and PBUSHT entries have uniform values for Gi and TGEIDi.
1 CBUSH elements require special handling.
2 Shell elements require special handling.
3 Both 1 and 2.
NSMSID Input-integer-default=0. Set identification number from the NSM Case Control
command.
XESTM Input, logical, default=FALSE. Set to True to create ESTM instead of EST.
MultiPhy Input, Integer, default=0. Flag for Multi-Physics
LGDISPU Input, Integer, default=0. Large Displacement flag input by user
Texist Input, Integer, default=0. Temperature Load flag determined by checking CASECC
a. PSHELL If SHLDAMP= SAME, then MIDi fields on the PSHELL entry will be
searched and the referenced MATi entries will be compared. If any are
different MGEFLAG is set to 2.
b. PBUSH Check the GE2 through GE6 values and if they are not uniform with respect
to GE1 exist then MGEFLAG is set to 1.
c. PBUSHT Check the TGEID2 through TGEID6 values and if they are not uniform
with respect to TGEID1 exist then MGEFLAG is set to 1.
d. If both a. and b. or c., then set MGEFLAG to 3.
Main Index
TA1M
Map bulk data to advanced nonlinear data structures
1456
Maps material, geometry, nodal and element information from bulk data-blocks into advanced nonlinear
data structures used for SOL400
Format:
Input Data Blocks:
Output Data Blocks:
TA1M
Map bulk data to advanced nonlinear data structures
TA1M MPTS, EPTS , BGPDTS, ETT, CSTMS, DIT, ESTM, ECTS,GPDM
MCHK,PCOMPT,EDTS,CONTACT,ESTNL,GPECT,HRMSP/ ESTMG,
GRPSTM, MTSTM, MTSTM1, MTSTM2, MTSTM3, MTSTM4, MMTX,
MMTXR, MMTX1, NLVECM, VCCTM, GCOMM, GPECTH / LUSETS/
LGDISP0/ NLAYERX /FOLLOWK/ COMPMATT/ COUPMASS/
S,N,ICHKRESX/ S,N,XGPECT/K6ROT $
MPTS Material Property Table
EPTS Element Property Table
BGPDTS Basic Grid Point Data
ETT Element Temperature Table
CSTMS Coordinate Systems
DIT Dynamic Table Input
ESTM Advanced Non-Linear Element Summary Table
ECTS Element Connectivity Table
GPDM Grid Ponit Data for Advanced Nonlinear Elements
PCOMPT Supplemental table for PCOMP and PCOMPG entries
EDTS EDT Table, used to get SET3 card
CONTACT Table of bulk data images related to contact
ESTNL Non-Linear Element summary table
GPECT Grid point connectivity
HRMSP Internal grid/scalar information for Herrmann or Heat shell element (with
Linear/Quadratic) nodal temperature
ESTMG Element Summary Table for Advanced Nonlinear Elements : follows ESTM
GRPSTM Group Summary Table for Advanced Nonlinear Elements
Main Index
1457 TA1M
Map bulk data to advanced nonlinear data structures
Parameters:
Remarks:
1. TA1M is used in SOL 400 to map bulk data blocks into data structures for advanced nonlinear
elements. The nonlinear elements are triggered by the supplemental property cards PSLDN1,
PSHLN1, PSHLN2, PRODN1, PBARN1, PBEMN1 and PSHEARN.
MTSTM ummary table contains offset data for advanced nonlinear elements and MATM
(advanced composites) data
MTSTM1,
MTSTM2,
MTSTM3,
MTSTM4
Material summary table contains pointers, sizing and control parameters for
materials associated with the advanced nonlinear elements
MMTX,
MMTX1
Element Data Tables for advanced nonlinear elements
NLVECM Non-Linear Vector Data including nodal temperatures, coordinate systems, tables,
orientations, beam section data
VCCTM Virtual Crack Closure Technique Data Table
GCOMM Global Common Block Data Table
GPECTH updated GPECT for Herrmann and Heat Shell Elements
LUSETS Input-Integer. Length of the problem set vector.
LGDISP0 Input-Integer, Large Displacement Flag
NLAYERX Input-Integer, Number of Layers for Shells
FOLLOWK Input-Integer, follower force stiffness parameter
COMPMATT Input-Integer, composite smear parameter
COUPMASS Input-Integer, lumped matrix parameter
XGPECT Output-Integer, flag to indicate updated GPECT (herrmann or heat shell)
K6ROTX Input-Integer, rotational stiffness parameter for shells
Main Index
TABEDIT
Performs editing operations on table data blocks
1458
Edits an existing table data block according to user-input directives. String-formatted records are
generally not acceptable. Three types of editing operations are possible:
1. Delete, add, or replace entire records. New records come from the IFP module or from user input.
2. Delete, add, or replace word strings to a specified record. New data come from user input.
3. Merge-edit two records of fixed-length word groups such as would be generated by IFP.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
TABEDIT
Performs editing operations on table data blocks
TABEDIT TOLD,CONTROL,TA,TB,TC/TNEW/
MSGLVL/DUPWG/UNUSED3/UNUSED4 $
TOLD Table data block to be edited. May not be purged, and in general,
contain string-formatted records.
CONTROL Table data block containing directives that control the editing process
as described under Remarks (it will usually come from DTI input). If
CONTROL is purged, TNEW will be copied from TOLD.
TA,TB,TC Secondary tables to be merged into TOLD. May be purged.
TNEW Updated table data block from the edit process. May not be purged.
MSGLVL Input-integer-default=0. Print activity option.
<0 Print information messages and trace editing process.
=0 Print information messages only.
>0 No print activity will occur.
DUPWG Input-integer-default=0. Duplicate word group option and applicable only to
the Merge-Edit option.
=0 Duplicate word groups will be dropped from TOLD.
=1 Duplicate word groups will be added after TOLD version.
Main Index
1459 TABEDIT
Performs editing operations on table data blocks
Remarks:
1. The input data block CONTROL contains the directives that control the activity of the editing
process. One record of CONTROL contains one directive of the form:
dir (,parameters)
where dir is one of the directive codes from the table below and parameters represents the
parametric values that vary with the directive.
UNUSED3 Input-integer-default=0. Unused.
UNUSED4 Input-integer-default=0. Unused.
TABEDIT Directives
Directive Remarks
ER End Record-Edit processing by copying rest of TOLD to TNEW. This
directive is optional.
QR, i Quit Record-Edit processing by copying rest of TOLD onto TNEW
through record i and exiting.
DR, i or DR ,i ,j Delete Record i (or records i through j) from TOLD after copying up to
record i.
IR, i Insert Records from TOLD after copying up to record i.
CR, i, options Correct Record i (after copying up to record i) by deleting, adding or
replacing word groups according to the options as described in Remark 2.
KRA,n
KRB,n
KRC,n
Kopy n Records from TA, TB, or TC onto TNEW.
SRA,n
SRB,n
SRC,n
Skip n Records forward on TA, TB, or TC. Used to position secondary
data block TA, TB, or TC for a subsequent KR* operation.
MEA,i,n
MEB,i,n
MEC,i,n
Merge-Edit the next record on TA, TB, or TC into record i according to
IFP specifications for fixed-length word groups of length n.
INT Interrogate TOLD for number of records and number of words in each
record. Also print the first three words of each record.
Main Index
TABEDIT
Performs editing operations on table data blocks
1460
2. The CR directive requires at least one subdirective from the table below:
3. TABEDIT copies the name of the input data block to the output data block. Since the name is part
of record 0, it can also be changed by TABEDIT commands.
Examples:
Let GEOM1 generated by a previous run have a third record consisting of the five GRID entries.
GRID,10,0,0.0,0.0,0.0,0,3456,0
GRID,20,0,1.0,1.0,0.0,0,3456,0
GRID,30,0,2.0,2.5,0.0,0,3456,0
GRID,40,0,3.0,3.0,0.0,0,3456,0
GRID,50,0,4.0,4.0,0.0,0,3456,0
CR Subdirectives
Sub-Directive Remarks
QW, i Quit after copying Word i. Record specified by CR directive is copied
through word i and the rest of the record is ignored.
DW, i, j, n,
n words
Delete Words i through j of the record specified by the CR directive and
replace by the n words that follows on the CR directive record.
IW, i, n,
n words
Insert after Word i of the record specified by the CR directive the n words
that follow on the CR directive record.
KWA,n
KWB,n
KWC,n
Kopy n Words from TA, TB, or TC onto TNEW.
SWA,n
SWB,n
SWC,n
skip n words forward on TA, TB, or TC. Used to position secondary data
block TA, TB or TC for a subsequent KW* operation.
AWA,n
AWB,n
AWC,n
Append n Words from TA, TB, or TC onto TNEW after copying the rest of
the record specified by the CR directive.
KRA,n
KRB,n
KRC,n
Kopy the Remaining contents of the current record from TA, TB, or TC
onto TNEW.
ARA
ARB
ARC
Append the Remaining contents of the current record from TA, TB, or TC
onto TNEW after copying the rest of the record specified by the CR
directive.
Main Index
1461 TABEDIT
Performs editing operations on table data blocks
A printout of GEOM1 using the TABPRT module (with OPT3=1) will show the following for record 1:
1. Note that the GRID entry for grid point 30 has an error in the y-location coordinate, which should
be 2.0 instead of 2.5. Make this correction without going through the conventional XSORT-IFP
process by using TABEDIT. Assume GEOM1 was saved on a user tape on the previous run as
GEOM1C.
DTIIN DTI,DTINDX/CONTROL,,,,,,,,, $
INPUTT2 /GEOM1C,,,,/-1 $
TABEDIT GEOM1C,CONTROL,,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END$
CEND
BEGIN BULK
DTI,CONTROL,1,CR,1,DW,23,23,1
,2.0
DTI,CONTROL,2,ER,ENDREC
ENDDATA
2. Repeat Example 1, assuming GEOM1 was saved on a previous run, by using record substitution.
DTIIN DTI,DTINDX/CON,,,,,,,,, $
TABEDIT XGEOM1,CON,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
TABLE GEOM1
RECORD NO. 0 HEADER
NAME NAME
1) GEOM 1
END
OF 2 WORD RECORD.
RECORD NO. 1 GRID
H1 H2 H3 ID CP X1 X2
X3 CD PS
1) 4501 45 1120001 10 0 0.00000E+00 0.00000E+00
0.00000E+00 0 3456
SEID ID CP X1 X2 X3 CD
PS SEID ID
11) 0 20 0 1.00000E+00 1.00000E+00 0.00000E+00 0
3456 0 30
CP X1 X2 X3 CD PS SEID
ID CP X1
21) 0 2.00000E+00 2.50000E+00 0.00000E+00 0 3456 0
40 0 3.00000E+00
X2 X3 CD PS SEID ID CP
X1 X2 X3
31) 3.00000E+00 0.00000E+00 0 3456 0 50 0
4.00000E+00 4.00000E+00 0.00000E+00
CD PS SEID
41) 0 3456 0
END
OF 43 WORD RECORD.
RECORD NO. 2
END OF FILE
TRAILER WORD1 = 0 WORD2 = 0 WORD3 = 8 WORD4 = 0 WORD5 = 0 WORD6 =
Main Index
TABEDIT
Performs editing operations on table data blocks
1462
CEND
BEGIN BULK
DTI,CON,1,DR,1,ENDREC
DTI,CON,2,KRA,1,ENDREC
(all GRID entries, including the correction)
ENDDATA
3. Repeat Example 2 by using word substitution.
DTIIN DTI,DTINDX/CON,,,,,,,,, $
TABEDIT XGEOM1,CON,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
CEND
BEGIN BULK
DTI,CON,1,CR,1,DW,20,26,0
,SWA,3,KWA,7
GRID,30,0,2.0,2.0,0,3456,0
ENDDATA
4. Repeat Example 1, assuming GEOM1 was written onto a user file during the previous run, by
using the merge-edit feature.
DTIIN DTI,DTINDX/C,,,,,,,,, $
INPUTT2 GEOM1OLD,,,,/-1 $
TABEDIT GEOM1OLD,C,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
CEND
BEGIN BULK
DTI,C,1,MEA,1,8,ENDREC
GRID,30,0,2.0,2.0,0.0,0,3456,0
ENDDATA
Main Index
1463 TABPRT
Formatted table printer
Formatted print of selected table data blocks.
Format 1:
Format 2: (KEY=USET)
g-set
p-set
ks-set
Format 3: (KEY=SEMAP)
Input Data Blocks:
TABPRT
Formatted table printer
TABPRT TABLE//KEY/OPT1//OPT3 $
TABPRT USET,BGPDT//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
or
TABPRT USET,EQEXIN,SIL//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
TABPRT USETD,EQDYN,SILD//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
TABPRT AEUSET,AEBGPDT//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
TABPRT SEMAP,ESTDATA,TIMSIZ,SGPDT//
SEMAP/OPT1/OPT2 $
TABLE Table data block.
USET Degree-of-freedom set membership table for g-set.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
Main Index
TABPRT
Formatted table printer
1464
Parameters:
Format 1:
There are two table print options controlled by OPT3.
If OPT3=0 (default);
TABPRT TABLE//KEY/OPT1 $
then format statements built into TABPRT are used to print TABLE, as selected by KEY. These formats
are limited to only those values of KEY listed in the table below.
SIL Scalar index list.
BGPDT Basic grid point definition table.
USETD Degree-of-freedom set membership table for p-set.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers.
SILD Scalar index list for p-set.
AEUSET Degree-of-freedom set membership table for ks-set.
AEBGPDT Basic grid point definition table for the ks-set.
ESTDATA Table of superelement estimation data overrides.
TIMSIZ Table of CPU and disk space estimation parameters.
SGPDT Superelement basic grid point definition table.
KEY Input-character-default=FINDIT. Identifies the generic name of the
data block.
OPTi Input-integer-default=0. Print control parameters.
SETSTRi See Format 2.
OPT1 Input-integer-integer-default=0.
OPT1=0 No blank lines between entries.
One blank line between each entry.
Input-integer-default=0. Set selection flag for the row sort (OPT1=0 or 10).
OPT 0 =
TABLE KEY TABLE KEY TABLE KEY
BGPDT BDPDT ETT ETT GPTT GPTT
CSTM CSTM GPDT GPDT SEMAP SEMAP
Main Index
1465 TABPRT
Formatted table printer
If ;
TABPRT TABLE//NDDLNAME/OPT1//OPT3 $
then the printout is identical to the TABPT module printout with the addition on NDDL item name labels
appearing above each value. NDDLNAME must be any data block name listed on the DATABLK
statement in the NDDL sequence. If NDDLNAME is not found in the NDDL sequence, then the printout
will contain no item name labels.
EQDYN EQEXIN GPL GPL any FINDIT
EQEXIN EQEXIN GPLD GPLD USET USET
OPT3 Input-integer-default=0. If OPT3=0, then the table is printed in a format similar to
the TABPT module with the following options:
1 Print with labels defined under the DATABLK statement for data block name
specified for parameter KEY.
2 Same as OPT3=1 and any data with an undefined format will be printed as
"???".
3 Same as OPT3=2 except only print records with undefined formats.
-1 Print without labels.
OPT3 0 =
Main Index
TABPRT
Formatted table printer
1466
Format 2: (KEY=USET):
OPT1 Input-integer-default=0.
Controls the tabular printout of the degree of freedom sets.
Sequence Print USETPRT
None None(default) -1
Row sort only 0
Internal Column sort only 1
Row and column sort 2
Row sort only 10
External Column sort only 11
Row and column sort 12
The degrees of freedom can be listed in ascending order according to their internal
or external sequence number, but not both. The external sequence number is the grid,
scalar, or extra point identification number. The internal sequence number is the
number assigned after resequencing.
For a given sequence there are two types of tables that may be printed: row sort and
column sort. For row sort, a table is printed for each set selected by USETSEL. Here
is an example of row sort (USETPRT = 0 or 10):
U S E T D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , R O
W S O R T )
A DISPLACEMENT SET
-1- -2- -3- -4- -5- -6- -7- -8- -
9- -10-
1= 2-1 2-2
Main Index
1467 TABPRT
Formatted table printer
For column sort, a single table is printed for the following sets: SB, SG,
L, A, F, N, G, R, O, S, M, E. Here is an example of column sort
(USETPRT = 1 or 11):
U S E T D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , C O L U
M N S O R T )
EXT GP. DOF INT DOF INT GP. SB SG L A F N G R O S
M E
-------------------------------------------------------------------------------------------
-------------
1 - 1 1- 1 G 1 1 1 1
- 2 2- 2 2 2 2
- 3 3- 1 3 3 3
- 4 4- 2 4 4 4
- 5 5- 3 5 5 5
- 6 6- 4 6 6 6
OPT2 Input-integer-default = 0. Specifies the sets that will be printed in the
row sort (OPT1 = 0 or 10). In order to select specific sets to be printed,
you must sum their corresponding decimal equivalent numbers. For
example, sets A, L, and R are selected with OPT2 = 128+256+8 = 392.
OPT2 Sets printed
-1 All sets in the following table.
0 Mutually exclusive sets only, as shown in the table below.
>0
Selected sets according to the sum of their decimal equivalent numbers in the
following table.
Set
Name
Decimal
Equivalent
Number
Set
Name
Decimal
Equivalent
Number
Q 4194304 SB 1024
LM 2097152 SG 512
C 1048576 MR 16
J 524288 R 8
K 262144 O 4
Main Index
TABPRT
Formatted table printer
1468
Format 3 (KEY = 'SEMAP'
SA 131072 B 2
E 2048 MP 1
SETSTRi Input-character-default=' '. Set name string for the row sort (OPT1 = 0 or
10). SETSTR1 through SETSTR4 form a single string of set name(s) and is 32
characters in length. For example, SETSTR1='M R N SG' and SETSTR2='A Q'
specifies the m, r, n, sg, a, and q sets be printed.
OPT1 Input-integer-default = 0.
If OPT2=0, 2, 3, or 5, OPT1 chooses a subset of record 2 for printing as follows:
OPT1 Value Selection within Record 2
0 All parts (GRID list and summaries of GRID list).
1 Only GRID List.
2 Only Summaries of GRID List.
-g
GRID List for Pattern Starting with Entry GRID identification number
= G (if any).
10X+0
10X+2
Same as 0 or 2 but with Summary List.
Selection based on X.
X = 0, 1, 3, 5, or 7 -- 1st Summary (sorted by 1st GRID).
X = 0, 2, 3, 6, or 7 -- 2nd Summary (sorted by count).
X = 0, 4, 5, 6, or 7 -- 3rd Summary (sorted by superelement).
100+X List all point IDs for any unique connection list produced by X.
200+X
Same as 100+X except that additional pure interior points will not be
listed.
300+X
Same as 200+X except that additional nonresidual points will not be
listed.
400+X Same as 100+X except that additional scalar points will not be listed.
Set
Name
Decimal
Equivalent
Number
Set
Name
Decimal
Equivalent
Number
Main Index
1469 TABPRT
Formatted table printer
If OPT2=4, OPT1 chooses CSUPER entry as follows:
Remarks:
1. If OPT2 = 4, then CSUPER entries are written on the punch file according to OPT1. Field 2
(SEID) is selected by OPT1. Field 3 will be 0. All other data fields contain the sorted list of grid
points for either the selected superelement (OPT1 > 0) or the residual structure ( ).
Continuation mnemonics are generated in the form +xxxxyyy where xxxx is the left-adjusted
SEID and yyy is a right-adjusted record count. Two examples are shown below.
500+X Same as 200+X except that additional scalar points will not be listed.
600+X Same as 300+X except that additional scalar points will not be listed.
OPT1 Value Selection within Record 2
OPT1 Value Meaning
>0
Write CSUPER Bulk Data entries for superelement OPT1.
Write CSUPER Bulk Data entries for residual structure but give SEID = -
OPT1.
0 s
OPT2 Integer-default = 0. Print/punch selection as follows:
OPT2 Value Meaning of Selection
-1 No output (1, 2 and a record for each superelement).
0
Print contents of all records (1, 2 and a record for each superelement) of
SEMAP except last two.
1 Print only Record 1 contents.
2
Print contents of Records 1 (except for OPT1 < 0) and 2 (see OPT1 for
selection options within Record 2).
3
Print contents of Records 1, 2 and a record for each superelement giving a
list of internal points, a list of external points, a list of elements, and
estimation data for the superelement. The third part of each superelement
record (containing the lists of primary superelement points to which a
secondary superelement is connected) is omitted.
4 Punch CSUPER entries according to OPT1 (see Remarks).
5
Print only Records 1 (except for OPT1 < 0), 2 (see OPT1 for selection
options within Record 2), and estimation data for each superelement.
OPT1 0 s
Main Index
TABPRT
Formatted table printer
1470
TABPRT EMAP//SEMAP/1/4 $
TABPRT EMAP//SEMAP/-100/4 $
2. If OPT2 = 0,3 or 5 and TIMSIZ is supplied, then TABPRT will produce an estimation printout
for each superelement except the residual structure. The equations used along with the
semiempirical constants are printed as well as dominant CPU time estimates, space estimates, and
wall clock estimates. The user is cautioned that these estimates will be valid only for large
superelements and should be adjusted for anomalous characteristics.
Estimate totals are also provided at the end of the SEMAP printout. If ESTDATA is also supplied,
then the constants of the estimating equations are adjusted. This technique is described on the
Bulk Data entry DTI,ESTDATA.
3. Under Format 1, the generic data block name is used, but the actual DMAP name for the same or
equivalent information is also acceptable. For example, in the superelement solution sequence
data blocks BGPDTS, CSTMS, EQEXINS, and GPLS are created and may be printed with
TABPRT. If FINDIT (default) is specified, the KEY will be taken from the header of the data
block.
Examples:
1. Print coordinate system transformation matrix table.
TABPRT CSTM//CSTM $
2. Print grid point list table.
TABPRT GPL//GPL $
3. Print basic grid point definition table.
TABPRT BGPDT// $
4. Print GEOM3X table with labels taken from DATABLK statement in the NDDL.
TABPRT GEOM3X//GEOM3///1 $
5. Print USET list for g-set and s-set in internal order using row sort.
TABPRT USET,BGPDT//USET/0/18 $
6. Print USET for the mutually exclusive sets in internal order using column sort.
TABPRT USET,BGPDT//USET/1 $
7. Print all SEMAP information except the grid list and secondary superelement boundary
sequencing list.
TABPRT EMAP//SEMAP/2/3 $
1 2 3 4 5 6 7 8 9 10
CSUPER
1 0 11 13 14
CSUPER
100 0 1 3 4 11 13 14
21 24 31 34 51 53 54 61
64 71 74 230 330 630 730
Main Index
1471 TABPRT
Formatted table printer
8. Punch CSUPER entries for the residual structure with SEID field set to 100.
TABPRT EMAP//SEMAP/-100/4 $
9. Print only estimation data for all superelements.
TABPRT EMAP,,TIMSIZ//SEMAP/-99999999/5 $
Main Index
TABPT
Table printer
1472
Prints table or matrix data blocks.
Format:
Input Data Blocks:
Output Data Blocks:
None.
Parameters:
Remarks:
1. Each input data block is treated as a table and its contents are printed on the system output file via
a prescribed format. Each word of the table is identified by the module as to type (real, character,
integer) and an appropriate format is used (10 items per line).
2. The trailer data items for the table are also printed.
3. A warning message is issued if all TABi do not exist.
4. TABPT may be used to print matrices.
5. TABPT may occasionally misidentify real numbers or character values. The TABPRT module
with will properly identify real numbers and character values.
6. The TABPRT module with will also print tables like TABPT with labels above each
item.
Examples:
TABPT GEOM1/ $
TABPT GEOM1,GEOM2,GEOM3,GEOM4/ $
TABPT
Table printer
TABPT TAB1,TAB2,TAB3,TAB4,TAB5//PRTFORM/UNUSED $
TABi Data block name.
PRTFORM Character-input-default-' '. Real number print precision.
LONG 12 significant digits.
SHORT 4 significant digits.
UNUSED Input-logical-default=TRUE.
OPT3 0 =
OPT3 0 =
Main Index
1473 TAFF
Creates tables for follower force stiffness
Creates tables for follower force stiffness.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
TAFF
Creates tables for follower force stiffness
TAFF SLT,BGPDT/
ESTF,GPECTF/
LUSET/LOADID/LOADIDP/LOADFACR/NBLOCK $
SLT Table of static loads.
BGPDT Basic grid point definition table.
ESTF Element summary table for follower force stiffness.
GPECTF Grid point element connection table for follower force stiffness.
LUSET Input-integer-default=0. The number of degrees-of-freedom in the
g-set.
LOADID Input-integer-default=0. Load set identification number for the current
subcase.
LOADIDP Input-integer-default=0. Load set identification number for the
previous subcase.
LOADFACR Input-real-default=0.0. Load factor in nonlinear static analysis.
NBLOCK Input-integer-default=10. Number of spill blocks to form if out-of-
memory algorithm is used.
Main Index
TAHT
Adds records to element summary and grid point element connection table
1474
Adds to the element summary table and the grid point element connection table appropriate records for
loads with control nodes on QVOL, QVECT, and QBDY3 Bulk Data entries.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
TAHT
Adds records to element summary and grid point element
connection table
TAHT
(376,/(671/*3(&7',7
ESTNL1,GPECT1/
LUSET/S,N,NOSIMP/LSETID/RSTIME $
SLTH Table of static loads updated for heat transfer analysis.
DLTH Table of dynamic loads updated for heat transfer analysis.
EPT Table of Bulk Data entry images related to element properties.
SIL Scalar index list.
ESTNL Nonlinear element summary table.
GPECT Grid point element connection table.
DIT Table of TABLEij Bulk Data entry images.
ESTNL1 Nonlinear element summary table updated for heat transfer analysis.
GPECT1 Grid point element connection table for heat transfer analysis.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
NOSIMP Output-integer-no default. The number of elements exclusive of
general elements. Set to -1 if there are no simple elements.
LOADID Input-integer-no default. Load set identification number for the current
subcase.
STIME Input-real-default=0.0. On initial input, starting time step and on
output, accumulated time used for restarts.
SLTH
DLTH
)
`
Main Index
1475 TAHT
Adds records to element summary and grid point element connection table
Remark:
DIT may be purged if DLTH does not reference tables in DIT.
Main Index
TASNP1
Computes the shell normal vectors on a superelement's boundary
1476
Computes the shell normal vectors on a superelement's boundary.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Remark:
TASNP1 is intended to be executed for each superelement if partitioned superelements are present.
TASNP1
Computes the shell normal vectors on a superelement's
boundary
TASNP1 BGPDTS,GPECTS,GEOM1S,CSTMS/
SNORMS $
BGPDTS Basic grid point definition table for a superelement.
GPECTS Grid point element connection table for a superelement.
GEOM1S Table of Bulk Data entry images related to geometry for a
superelement.
CSTMS Table of coordinate system transformation matrices for a
superelement.
SNORMS Table of shell normal vectors on a superelement's boundary.
Main Index
1477 TASNP2
Computes grid point shell normal vectors at superelement boundaries
Computes the grid point shell normal vectors and if superelements are present then process shell normals
at superelement boundaries.
Format Without or Ignoring Superelements:
Format for Superelement:
Input Data Blocks:
Output Data Blocks:
TASNP2
Computes grid point shell normal vectors at superelement
boundaries
TASNP2 BGPDT,GPECT,GEOM1,CSTM,SEMAP,SCSTM,SNORM*/
GPSNT/
SNORM/SNORMPRT/-1/ /EFMFLG $
TASNP2 BGPDTS,GPECTS,GEOM1S,CSTMS,SEMAP,SCSTM,SNORM*/
GPSNTS/
SNORM/SNORMPRT/SEID/QUALNAM $
BGPDT Basic grid point definition table.
BGPDTS Basic grid point definition table for a superelement.
GPECT Grid point element connection table.
GPECTS Grid point element connection table for a superelement.
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM1S Table of Bulk Data entry images related to geometry for a
superelement.
CSTM Table of coordinate system transformation matrices.
CSTMS Table of coordinate system transformation matrices for a
superelement.
SEMAP Superelement map table.
SCSTM Table of global transformation matrices for partitioned superelements.
SNORM* Family of shell normal vectors at superelement boundaries.
GPSNT Grid point shell normal table.
GPSNTS Grid point shell normal table for a superelement.
Main Index
TASNP2
Computes grid point shell normal vectors at superelement boundaries
1478
Parameters:
Remark:
If there are partitioned superelements present then TASNP1 needs to be executed for all superelements.
Then in a separate superelement loop TASNP2 is executed for all superelements.
SNORM Input-real-no default. Maximum angle between grid point normal and shell normal.
If angle is less than SNORM then grid point normal will be computed.
SNORMPRT Input-integer-no default. Grid point shell normal print/punch flag.
0 No print or punch
1 Punch
2 Print only
3 Print and punch
SEID Input-character-no default. Superelement identification number.
QUALNAM Input-integer-no default. Name of qualifier to be used in selecting SNORMS.
EFMFLG Input-integer-default=0. Processing flag for how shell normals are computed on
superelement boundary points.
0 Compute the average all of the shell normals
1 Compute the resultant of all of shell normals
Main Index
1479 TIMETEST
Provide timing data
Provides timing data for various unit operations that may be used to compare and evaluate computer and
compiler performance.
TIMETEST
Provide timing data
Main Index
TIMETEST
Provide timing data
1480
Format:
Option 1: I/O timing
Option 2: Arithmetic timing
Option 3: Matrix timing
Option 4: Kernel timing
Option 5: MPYAD timing for CASE=1
MPYAD timing CASE=2 (new)
Option 6: KERNBD generation
Option 7: Sparse kernel timing
Option 8: Element timing
TIMETEST TIMTS,A,B,C/TOUT,/N/M/T/OPT/CASE $
TIMETEST ,,,,/,/N/M/T/2/CASE $
TIMETEST ,,,,/,/N/M/T/2/CASE $
TIMETEST TIMTS3,,,/T3OUT,/N/M/T/3 $
TIMETEST TIMTS4,,,/T4OUT,/N/M/T/4 $
TIMETEST TIMTS5,,,/TOUT5,/N/5/1 $
TIMETEST TIMTS5,A,B,C/TOUT5,/N/M/T/5/2 $
TIMETEST T3OUT,T4OUT,T7OUT,T8OUT/TOUT6,/ / /
/6/CASE $
TIMETEST TIMTS3,,,,/TOUT7,/N/M/ /7 $
TIMETEST TIMTS8,,,/TOUT8,/ / / /8/CASE $
Main Index
1481 TIMETEST
Provide timing data
Input Data Blocks:
TIMTS3 Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
DTI
TIMT
S3
IREC CASE M N P
CASE =
Record number (null records are ignored so records may be numbered by
tens for convenience in making changes) IREC.
CASE =
L normal case definition.
K indicates last case to be used in least squares solution for timing
constants.
Note: If no case value of K is found by the time the 10th case value is read then the 10th
case is treated as the last case to be used in the least squares solution for timing
constants.)
M =
Number of terms in inner loop.
N =
Number of terms in outer loop.
P =
Number of times kernel is called.
TIMTS4 Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
DTI
TIMT
S4
IREC CASE
ROW
S
COLS DENS STRL
IREC Record number (null records are ignored so records may be numbered by
tens for convenience in making in making changes).
CASE A normal case definition.
B indicates last case to be used in least squares solution for timing
constants.
Note: If no case value of B is found by the time the 10th case value is read, then the
10th case is treated as the last case to be used in the least squares solution for
timing constants.
Main Index
TIMETEST
Provide timing data
1482
ROWS Number of rows the matrix is to have.
COLS Number of columns the matrix is to have.
DENS Density to be used in building the matrix.
STRL String length to be used in building the matrix.
TIMTS5 (for CASE=1 only) Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
DTI
TIMT
S5
IREC CASE ROWS COLS DENS TYPE STRL
TIMTS5 (for both cases) Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
DTI
TIMT
S5
IREC CASE T CORE
METHO
D
IREC Record number (null records are ignored so records may be numbered by
tens for convenience in making in making changes).
CASE CASE normal case definition.
END indicates last case to be used.
Note: The T, CORE, and METHOD field are not filled in when this form of the case
is used.
T Value to be used.
CORE Size of the core to be used.
METHOD Method to be used.
TlMTS8 Element generation and assembly timing.
Main Index
1483 TIMETEST
Provide timing data
Output Data Blocks:
TOUT, TOUTi Timing results.
N Options 1 and 2: n* - Default = 50. External loop index.
Options 3, 4, and 5: Scale Factor.
Negative value means scale down.
Value 0 or 1 means do not change.
Positive value means scale up.
Options 6 and 8: Not used.
M Options 1 and 2: m* - Default = 200. Internal loop index.
Options 3, 4, and 7: Size -- Contains the size of various needed arrays.
(Recommended value range: 128 to 1024).
(e.g., Workstation machines: 128.
Low-End Minicomputer (VAX): 256.
High-End Minicomputer (CONVEX): 512.
Super Computer (CRAY): 1024).
Options 5, 6, and 8: Not used.
T Options 1 and 2: Default = 2. Data item type (1 = RSP, 2 = RDP, 3 = CSP, 4 = CDP).
Options 3-8: Not used.
OPT All Options: Type of timing data required.
1 Input/Output Operations. (Default) (old).
2 Arithmetic Operations (old)
3 Matrix Timing Operations. (new)
4 Kernel Timing Operations. (new)
5 MPYAD Timing Operations CASE = 1 (new) (uses data in DTI file).
MPYAD Timing Operations CASE = 2 (new) (uses data defined by
remaining arguments).
6 KERNDB Data Block Generation. (new)
7 Sparse Kernel Timing. (new)
8 Element Timing. (new)
CASE Options 1 and 2: Default = 0. Code indicating which unit operations are to be tested.
If OPT = 1, then CASE means:
1 WRITE
2 READ
4 READ BACKWARDS
8 BLDPK
16 INTPK
32 PACK
Main Index
TIMETEST
Provide timing data
1484
64 UNPACK
128 PUTSTR
256 GETSTR
If OPT = 2, then CASE means:
1 RSP
2 RDP
4 CSP
8 CDP
Options 3 and 4: Not used.
Option 5: If CASE = 1, then use the DTI table.
If CASE = 2, then use the data defined by the remaining arguments.
Option 6: Number of elements.
Option 7: Not used.
Option 8: If CASE = 0, then the T8OUT data block is initialized.
If CASE = 1,then record the cumulated CPU time on the T8OUT data block. Set
CASE = 1 before executing the EMG module.
If CASE = 2, then record the cumulated CPU time on the T8OUT data block. Set
CASE = 2 after executing the EMA module.
Main Index
1485 TOLAPP
Appends nonlinear data and Case Control for data recovery
Appends nonlinear output time or load factor lists and Case Control for data recovery.
Format:
Format for nonlinear transient analysis (TOLAPPF=0):
Format for nonlinear statics analysis (TOLAPPF=1):
Input Data Blocks:
Output Data Blocks:
Parameters:
TOLAPP
Appends nonlinear data and Case Control for data recovery
TOLAPP CASEXX,MPT,TEL/
TOL,,TOL1/
TOLAPPF/NSOUT $
TOLAPP CASECC,MPT,ESTNL/
OLF,CASECCR,/
TOLAPPF//S,N,NSKIP/S,N,NEWP/S,N,POUTF $
CASECC Table of Case Control command images.
CASEXX Subset of CASECC for current loop.
MPT Table of Bulk Data entry images related to material properties.
TEL Transient response time output list appended from each subcase.
ESTNL Nonlinear element summary table.
TOL Transient response time output list for all subcases.
OLF Nonlinear load factors for all subcases.
TOL1 Transient response time output list for the current subcase.
CASECCR Table of Case Control command images for data recovery.
TOLAPPF Input-integer-no default. Nonlinear analysis type:
0 Nonlinear transient.
1 Nonlinear statics.
Main Index
TOLAPP
Appends nonlinear data and Case Control for data recovery
1486
Remarks:
1. If TOLAPPF=0, TOLAPP reads the time values from TEL, takes every NSOUT-th one, and
appends these to TOL. The last time value from TEL is appended regardless of the value of
NSOUT. If NSOUT>0 then a maximum of NSOUT time values are written to TOL.
2. If TOLAPPF=1, TOLAPP reads a record from CASEXX, modifies it, and appends it to
CASECCR. If output has been requested (INTOUT field on the NLPARM Bulk Data entry) for
this load factor TOLAPP appends the current load factor from ESTNL to OLF.
NSOUT Input-integer-default=0. Number of time steps to output. By default all time
steps are output.
NSKIP Input/output-integer-default=1. CASECC record counter or nonlinear
transient loop identification number.
NEWP Input/output-integer-default=1. New subcase flag.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
POUTF Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate
output is not requested.
Main Index
1487 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Solves for the modal or direct, transient response, displacement, velocity, and acceleration solution.
Format:
Input Data Blocks:
TRD1
Solves for modal/direct, transient, displacement, velocity,
and acceleration solution
TRD1 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,SILD,USETD
,
PARTVEC,PXT0,ROTORT,BGDD*,KCVDD*,RDG,PXTDV,PDX
DVO/
UXT,PNL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/SETNAME/
NSOLT,NOTRLDFM/WTMASS $
CASECC Table of Case Control command images.
TRL Transient response list.
NLFT Nonlinear Forcing function table.
DIT Table of TABLEij Bulk Data entry images.
KXX Stiffness matrix in any set. Usually h- or d-set.
BXX Viscous damping in any set. Usually h- or d-set.
MXX Mass matrix in any set. Usually h- or d-set.
PXT Transient response load matrix in h-set (modal) or d-set.
SILD Scalar index list for the p-set. Required for maximum efficiency during
symmetric decomposition and if KXX represents the d-set or a subset
of the d-set (SETNAME='D').
USETD Degree-of-freedom set membership table for the p-set. Required for
maximum efficiency during symmetric decomposition and if KXX
represents the d-set or a subset of the d-set (SETNAME='D').
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees of freedom which were eliminated in the partition to obtain
KXX, etc. Required for maximum efficiency during symmetric
decomposition and if KXX represents a subset of the d-set
(SETNAME='D'). PARTVEC is not required if KXX represents the h-
set. See SETNAME parameter description below.
PXT0 PXT from a cold start run.
ROTORT Table of rotordynamics user input for transient analysis.
Main Index
TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1488
Output Data Blocks:
BGDD* Family of coriolis matrices.
KCVDD* Family of gyroscopic matrices.
RDG Reduction matrix from g-set to d-set (transposed).
PDXDVO PDXDVD from a cold start run.
PXTDV Transient response load matrix in h-set (modal) or d-set combined
from two executions of TRLG: one with DVFLAG=0 and the other of
DVFLAG=1.
UXT Solution matrix from transient response analysis in d- or h-set.
PNL Nonlinear load matrix appended from each output time step.
Main Index
1489 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Parameters:
Method:
The solution for the response is performed in TRD1 (Transient Response Solution). In the case of a direct
formulation the following equation is integrated over the time periods specified via the TSTEP Bulk Data
entry:
(5-65)
in order to determine the displacement velocity and acceleration response.
SOLTYP Input-character-no default. Solution method.
'MODAL' Usually for h-set matrices
'DIRECT' Usually for d-set matrices
'IC' Initial conditions for nonlinear transient analysis
NOUE Input-integer-no default. Number of extra points.
Set to -1 if there are no extra points.
NONCUP Input-integer-default=0. Algorithm selection. NONCUP=-1 requests
uncoupled algorithm if SOLTYP='MODAL' and KXX, BXX, and MXX are
diagonal. NONCUP=-2, requests uncoupled algorithm and off-diagonal terms
of KXX, BXX, and MXX will be ignored.
NCOL Input/output-integer-default=0. Number of time steps in the solution matrix
UXT prior to execution of TRD1.
FAC3 Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step
increment.
SETNAME Input-character-default='H'. Degree-of-freedom set name represented by KXX,
etc. If KXX represents, or is a subset of, the d-set, then for maximum efficiency,
the rows and columns KXX and MXX must correspond to or be a partition of
the displacement set specified by SETNAME. If KXX and MXX are a partition
then PARTVEC must also be specified.
NSOLT Input-integer-default=0. Column number in solution of previous from which
the integration in a restart run.
NOTRLDFM Input-integer-default=0. Fatal message flag when there the loads are null. See Remark
3.
0 Issue fatal message.
>0 Do no issue fatal message.
WTMASS Input-real-default=0.0. Scale factor on structural mass matrix.
M
dd
p
2
B
dd
p K
dd
x
+ + | | u
d
{ } P
d
{ } P
d
nl
{ } + =
Main Index
TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1490
In the case of a modal formulation
(5-66)
Solution of the Coupled Equations
The matrix
(5-67)
is formed and decomposed. The matrix
(5-68)
is formed and saved. The matrix
(5-69)
is formed and saved.
The solution loops then proceed until a time step change occurs. The initial conditions are brought in and
the starting equation
(5-70)
is solved for , where is the starting displacement vector;
(5-71)
is the starting velocity vector;
(5-72)
is the nonlinear load calculated from ; and
(5-73)
M
hh
p
2
B
hh
p K
hh
+ + | | u
h
{ } P
h
{ } P
h
nl
{ } + =
D | |
1
At
2
-------- M | |
1
2At
--------- B | |
1
3
--- K | | + +
\ .
| |
=
C | |
2
At
2
-------- M | |
1
3
--- K | |
\ .
| |
=
E | |
1
At
2
-------- M | |
1
2At
--------- B | |
1
3
--- K | | +
\ .
| |
=
D | | u
1
{ }
1
3
--- P
1
1
P
0
1
P
1
+ + { } N
0
{ } C | | u
0
{ } E | | u
1
1
{ } + + + =
u
1
{ } u
0
{ }
u
1
1
{ } u
0
{ } u
0
{ }At =
u
0
{ }
P
0
1
{ } K | | u
0
{ } B | | u
0
{ } + =
N
0
{ } u
0
{ }
P
1
1
{ } K | | u
1
1
{ } B | | u
0
{ } P
0
1
{ } At K | | u
0
{ } = + =
Main Index
1491 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Note that the load computed at is never used but is replaced by . through are
now computed from the general equation:
(5-74)
If nonlinear loads are selected, they are evaluated directly at the solution points for a time step by the
following process. NOLIN1 loads are computed as
(5-75)
where:
NOLIN2 loads are computed as
(5-76)
where , , , and are as in NOLIN1 loads.
NOLIN3 loads are computed as
(5-77)
NOLIN4 loads are computed as
(5-78)
The NOLIN5 loads are computed as
=
the user-selected table
=
the loaded solution point
=
the deflecting point
=
the previously computed displacement or velocity at point
u 0 = P
0
1
{ } u
2
{ } u
n
{ }
D | | U
I 2 +
{ }
1
3
--- p
I
p
I 1 +
p
I 2 +
+ + { } N
I 1 +
{ } C | | u
I 1 +
{ } E | | u
i
{ } + + + =
P
i
t ( ) ST u
j
t ( ) ( ) =
T
i
j
u
j
j
P
i
t ( ) Su
j
t ( )u
k
t ( ) =
i j u k
P
i
t ( )
S u
j
t ( ) { }A if u
j
t ( ) 0 >
0 if u
j
t ( ) 0 <
=
P
i
t ( )
S u
i
t ( ) { }A if u
i
t ( ) 0 <
0 if u
i
t ( ) 0 >
=
Main Index
TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1492
(5-79)
where and are from the NOLIN5 cards and
The load is applied to all points at and the load is applied to all points at .
The user specifies the set of times at which data are to be saved. If the current time is an output time, the
displacement vector for time is output.
The velocity vector given by
(5-80)
is output.
The acceleration vector is given by
(5-81)
is output.
If the time step is scheduled to change at from to , the displacement for time has been
calculated. , , and are saved along with . The matrices are formed and
decomposed as in (5-67), (5-68) and (5-69) for .
(5-82) is used for computing ,
(5-82)
The vectors and in (5-82) are calculated as follows. Define
=
the Stefan-Boltzmann constant
TABS
=
the module parameter (to TRHT)
=
the average temperature for the points at Area A
=
the average temperature for the points for Area B
P
ga
t ( )
P
gb
t ( )
)
`
A
a
F
ab
F
ab
A
b
A
a
F
ab
1 o
a
( )
F
ab
1 o
a
( ) A
b
1
oE
a
A
a
U
a
TABS + ( )
4
oE
b
A
b
U
b
TABS + ( )
4
)
`
=
A
a
A
b
F
ab
E
a
E
b
o
a
, , , , , o
b
o
U
a
U
b
P
ga
A P
gb
B
t t
i
=
u
i
{ }
1
2At
--------- u
i 1 +
{ } u
i 1
{ } | | =
u
i
{ }
1
At
1
2
-------- u
i 1 +
{ } u
i 1
{ } 2 u
i
{ } + | | =
t
i 1 +
At
1
At
2
i 1 +
u
i 1
{ } u
i
{ } u
i 1 +
{ } P
i 1 +
{ }
At At
2
=
u
i 2 +
{ }
D | | u
i 2 +
{ }
1
3
--- P
i
1
P
i 1 +
P
i 2 +
+ + { } N
i 1 +
{ } C | | u
i 1 +
{ } E | | u
i
1
{ } + + + =
P
i
1
{ } u
i
1
{ }
Main Index
1493 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
(5-83)
(5-84)
(5-85)
then
(5-86)
(5-87)
If the continue mode is set, TRD1 will extract the displacement , velocity , and acceleration
from the column number specified by NOL. (the first displacement of the continued run) is computed
as follows:
(5-88)
where
(5-89)
(5-90)
(5-91)
(5-92)
Solution of Uncoupled Modal Equation
If the method of matrix formulation is modal and no transfer functions or direct input matrices are used,
the equations may be solved in a more accurate, more direct manner. The diagonal terms of MHH, BHH,
u
i 1 +
{ }
1
At
1
-------- u
i 1 +
{ } u
i
{ } ( ) =
u
i 1 +
{ }
1
At
1
2
-------- u
i 1 +
{ } 2 u
i
{ } u
i 1
{ } + ( ) =
u
i
1
{ } u
i 1 +
{ } u
i 1 +
{ }At
2
=
u
i
1
{ } u
i 1 +
{ } At
2
u
i 1 +
{ }
At
2
2
2
-------- u
i 1 +
{ } + =
P
i
1
{ } M | | u
i 1 +
{ } B | | u
i
1
{ } K | | u
i
1
{ } + + =
u
n
( ) u
n
( ) u
n
( )
u
1
D | | u
i
{ }
1
3
--- P
1
1
P
0
P
1
+ + { } P
0
{ } C | | u
n
{ } E | | u
1
1
{ } + + + =
P
0
{ } K | | u
n
{ } B | | u
n
{ } M | | u
n
{ } + + =
u
1
1
{ } u
n
{ } At u
n
{ }
At
2
2
-------- u
n
{ } + =
u
1
1
{ } u
n
{ } u
n
{ }At =
P
1
1
{ } M | | u
n
{ } B | | u
1
1
{ } K { } u
1
1
{ } + + =
Main Index
TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1494
and KHH are stored. The following data are necessary to solve the transient behavior of a modal
coordinate .
(5-93)
(5-94)
(5-95)
The following coefficients are generated for each distinct time increment. There are four cases (
and the subscript i is implied.)
1. If (underdamped):
(5-96)
(5-97)
(5-98)
(5-99)
=
modal mass of mode (MHH)
=
modal damping coefficient (BHH)
=
modal stiffness (KHH)
=
time of the j-th time step
=
time increment after the j-th time
=
applied load on coordinate i at the j-th time
i
( )
m
i
b
i
k
i
e
oi
k
i
m
i
( )
1 2
=
|
i
b
i
2m
i
--------- =
e
i
2
e
oi
2
|
2
=
t
j
h
j
f
ij
c 10
5
=
e
o
2
|
2
c + >
F e
|h
eh
|
e
---- eh sin + cos =
G
1
e
----e eh sin =
A
1
hke
---------- e
|h e
2
|
2
e
o
2
------------------
\ .
|
| |
|h eh sin
2e|
e
o
2
----------- he +
\ .
|
| |
eh cos
2|e
e
o
2
----------- +
)
`
=
B
1
hke
---------- e
|h e
2
|
2
e
o
2
------------------
\ .
|
| |
eh sin
2e|
e
o
2
----------- eh cos + eh
2|e
e
o
2
----------- +
)
`
=
Main Index
1495 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
(5-100)
(5-101)
(5-102)
(5-103)
2. If (critically damped):
(1)
(5-104)
(5-105)
(5-106)
(5-107)
(5-108)
(5-109)
(5-110)
3. If (over damped):
(5-111)
(5-112)
F'
e
o
2
e
---------e
|h
eh sin =
G' e
|h
eh
|
e
---- cos eh sin
\ .
| |
=
A'
1
hke
---------- e
|h
| he
o
2
+ ( ) mh sin e eh cos + { } e | | =
B'
1
hke
---------- e
|h
| eh sin e eh cos + ( ) e + | | =
e
o
2
|
2
+ c <
F e
|h
1 |h + ( ) =
G he
|h
=
A
1
hk
------
2
|
---
1
|
---e
|h
2 2h| h
2
|
2
+ + ( ) =
B
1
hk|
--------- 2 |h e
|h
2 h| + ( ) + | | =
F' |
2
he
|h
=
G' e
|h
1 |h + ( ) =
A'
1
hk
------ e
|h
1 h| h
2
|
2
+ + ( ) 1 | | =
B'
1
hk
------ 1 e
|h
|h 1 + ( ) | | =
e
o
2
|
2
c <
F e
|h
eh cosh
|
e
---- eh sinh +
\ .
| |
=
G
1
e
----e
eh
eh sinh =
Main Index
TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1496
(5-113)
(5-114)
(5-115)
(5-116)
(5-117)
(5-118)
4. If (undamped):
(5-119)
(5-120)
(5-121)
(5-122)
(5-123)
(5-124)
(5-125)
(5-126)
The equations for each displacement, velocity, and acceleration in terms of the applied loads and previous
displacement and velocity are:
(5-127)
(5-128)
A
1
hke
---------- e
|h e
2
|
2
+
e
o
2
------------------ h|
\ .
|
| |
eh
2e|
e
o
2
----------- he +
\ .
|
| |
sinh e cosh h
2e|
e
o
2
----------- +
)
`
=
B
1
hke
---------- e
|h e
2
|
2
+
e
o
2
------------------ eh
2e|
e
o
2
----------- eh cosh + + sinh eh
2|e
e
o
2
----------- +
)
`
=
F'
e
o
2
e
------ e
|h
eh sinh =
G' e
|h
eh
|
e
---- cosh eh sinh
\ .
| |
=
A'
1
hke
---------- e
|h
| he
o
2
+ ( ) eh e + sinh e cosh h { } e | | =
B'
1
hke
---------- e
|h
| eh e + sinh eh cosh ( ) e + | | =
e
o
| = c s
F 1 =
G H =
A h
2
3m ( ) =
B h
2
6m ( ) =
F' 0 =
G' 1 =
A' h 2m ( ) =
B' h 2m ( ) =
i j 1 + ,
F
i
i j ,
G
i
i j ,
A
i
f
i j ,
B
i
f
i j 1 + ,
+ + + =
i j 1 + ,
F'
i
i j ,
G'
i
i j ,
A'
i
f
i j ,
B'
i
f
i j 1 + ,
+ + + =
Main Index
1497 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
(5-129)
Remarks:
1. NLFT and PNLD1 cannot be purged if nonlinear loads are selected in CASEXX.
2. NCOL>0 indicates a restart.
3. By default, if all of the following quantities are null:
a. Nonlinear loads.
b. Initial conditions.
c. Applied loads.
d. Equivalent loads due to enforced motion then UFM 3046 is issued. The fatal termination may
be avoided by specifying NOTRLDFM=1. This is needed in the relative enforced motion
formulation.
i j 1 + ,
P
i j 1 + ,
m
1
---------------
b
i
i j 1 + ,
m
1
-------------------
K
i
i j 1 + ,
m
i
-------------------- =
Main Index
TRD2
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1498
.
Solves for the modal or direct, transient response, displacement, velocity, and acceleration solution for
design optimization.
Format:
Input Data Blocks:
TRD2
Solves for modal/direct, transient, displacement, velocity,
and acceleration solution
TRD2 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,DSPT1,SILD
,
USETD,PARTVEC/
UXT,PNL,TOL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/TRD2OPT/SETNA
ME $
CASECC Table of Case Control command images.
TRL Transient response list.
NLFT Nonlinear Forcing function table.
DIT Table of TABLEij Bulk Data entry images.
KXX Stiffness matrix in any set. Usually h- or d-set.
BXX Viscous damping in any set. Usually h- or d-set.
MXX Mass matrix in any set. Usually h- or d-set.
PXT Transient response load matrix in h-set (modal) or d-set.
DSPT1 Design sensitivity processing table.
SILD Scalar index list for the p-set. Required for maximum efficiency during
symmetric decomposition and if KXX represents the d-set or a subset
of the d-set (SETNAME='D').
USETD Degree-of-freedom set membership table for the p-set. Required for
maximum efficiency during symmetric decomposition and if KXX
represents the d-set or a subset of the d-set (SETNAME='D').
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees of freedom which were eliminated in the partition to obtain
KXX, etc. Required for maximum efficiency during symmetric
decomposition and if KXX represents a subset of the d-set
(SETNAME='D'). PARTVEC is not required if KXX represents the h-
set. See SETNAME parameter description below.
Main Index
1499 TRD2
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Output Data Blocks:
Parameters:
Remarks:
1. TRD2 is intended for design optimization.
2. NLFT and PNLD1 cannot be purged if nonlinear loads are selected in CASEXX.
3. NCOL>0 indicates a restart.
UXT Solution matrix from transient response analysis in d- or h-set.
PNL Nonlinear load matrix appended from each output time step.
TOL Transient response time output list.
SOLTYP Input-character-no default. Solution method.
'MODAL' Modal; usually for h-set matrices
'DIRECT' Direct; usually for d-set matrices
'IC' Initial conditions for nonlinear transient analysis
NOUE Input-integer-no default. Number of extra points. Set to -1 if there are no extra
points.
NONCUP Input-integer-default=0. Algorithm selection. NONCUP=-1 requests uncoupled
algorithm if SOLTYP='MODAL' and KXX, BXX, and MXX are diagonal.
NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX,
and MXX will be ignored.
NCOL Input/output-integer-default=0. Number of time steps in the solution matrix UXT
prior to execution of TRD1.
FAC3 Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step
increment.
TRD2OPT Input-integer-default=1. TRD2 output option.
1 Output based on TSTEP Bulk Data entry
2 Output based on every time step
SETNAME Input-character-default='H'. Degree-of-freedom set name represented by KXX,
etc. If KXX represents, or is a subset of, the d-set, then for maximum efficiency,
the rows and columns KXX and MXX must correspond to or be a partition of
the displacement set specified by SETNAME. If KXX and MXX are a partition
then PARTVEC must also be specified.
Main Index
TRLG
Generates applied loads in transient analysis
1500
Generates applied loads in transient analysis.
Format:
Input Data Blocks:
TRLG
Generates applied loads in transient analysis
TRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,
, , ,EST,MPT,MGG, ,
APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
, , , , ,TOL,DLTH,
YPT,YPO,TOLR/
S,N,NOSET/S,N,PDEPDO/IMETHOD/STIME/BETA/
S,N,FAC1/S,N,FAC2/S,N,FAC3/TOUT/TABS/
STIME/S,N,NCOLT/S,N,NSOLT/DVFLAG $
CASECC Table of Case Control command images.
USETD Degree-of-freedom set membership table for p-set.
DLT Table of dynamic loads.
SLT Table of static loads.
BGPDT Basic grid point definition table.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
TRL Transient response list.
DIT Table of TABLEij Bulk Data entry images.
GMD Multipoint constraint transformation matrix with extra points, m-set by
ne-set.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set.
PHDH Transformation matrix from d-set to h-set (modal).
RPX Reduction matrix from p-set to h-set (modal) or d-set.
EST Element summary table.
GMD
)
`
GOD
)
`
PHDH
RPX
)
`
V01P
)
`
PPT
PPT )
`
PST
)
`
PDT
)
`
PDT1
)
`
PHT
PXT )
`
Main Index
1501 TRLG
Generates applied loads in transient analysis
Output Data Blocks:
Parameters:
MPT Table of Bulk Data entry images related to material properties.
MGG Mass or radiation matrix in g-size.
V01P Partitioning vector for sparse load reduction.
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness
effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous
damping effects
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass
effects
ENFMOTN Matrix of enforced motion amplitudes
PPT Transient response load matrix in the p-set for output time steps.
PST Transient response load matrix in the s-set for output time steps.
PDT Transient response load matrix in the d-set for output time steps.
PDT1 Transient response load matrix in the d-set for all time steps.
PHT Transient response load matrix in the h-set (modal) for all time steps.
PXT Transient response load matrix in the h-set (modal) or d-set for all time
steps only when RPX is input and TOUT=2.
TOL Transient response time output list.
DLTH Table of dynamic loads updated for heat transfer analysis.
YPT Transient response enforced motion matrix in the p-set.
YPO Transient response enforced motion matrix in the p-set and for the
output time steps.
TOLR Updated TOL table for restarts requested by user parameter
STIME>0.0.
NOSET Output-integer-default=-1. Constraint, omit, and support set flag. Set to -1 if
NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-
freedom defined in the a-set (e.g., ASETi, QSETi Bulk Data entries); +1 otherwise
PDEPDO Output-integer-default=-1. Skip factor flag. See NOi on TSTEP Bulk Data entry.
0 Skip factor is >1.
-1 Skip factor is 1.
Main Index
TRLG
Generates applied loads in transient analysis
1502
Remarks:
1. PPT, PST, PDT, PDT1, PHT, PXT, and DLTH may be purged except in the following cases:
If TOUT<2 and PST, PDT, and PDT1 are specified then PPT must be present. Also, GMD must
be present if the m-set exists and GOD must be present if the o-set exists. If PHT is specified then
PHDH must be present.
IMETHOD Input-integer-default=0. Nonlinear transient analysis flag.
0 Linear analysis.
-1 AUTO or TSTEP method (NLTRD module).
2 ADAPT method (NLTRD2 module).
STIME Input-real-default=0.0. Accumulated time used for restarts.
BETA Input-complex-default=(.33333,0.0). Integration parameter.
FAC1 Output-complex-default=(0.0,0.0). Square of the reciprocal of the time step
increment. Imaginary part is always zero.
FAC2 Output-complex-default=(0.0,0.0). Reciprocal of twice the time step increment.
Imaginary part is always zero.
FAC3 Output-complex-default=(0.0,0.0). Negative of the reciprocal of the time step
increment. Imaginary part is always zero.
TOUT Input-integer-default=-1. Processing flag.
<
1
Use NOi on TSTEP Bulk Data entry.
1 All time steps.
2 Same as <1 except RPX is input.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
STIME Input-real-default=0.0 Starting time step if the run is a restart. Usually input by a
user parameter.
NCOLT Output-integer-default=0. Column number in output of previous run from which
the integration is to be continued.
NSOLT Output-integer-default=0. Column number in solution of previous run that
corresponds to NCOL.
DVFLAG Input-integer-default=0. Enforced motion processing flag for both the large mass
and direct methods of specification.
=
0
Process only applied loads and excitations due to enforced accelerations
(default)
>
0
Process only excitations due to enforced displacements and velocities.
Main Index
1503 TRLG
Generates applied loads in transient analysis
If TOUT=2 and PXT is specified then PPT, RPX, and V01P must be present. GMD, GOD, PST,
PDT, and PDT1 may be purged.
2. MGG and MPT may be purged if there are no GRAV or RFORCE and PLOAD1 records in SLT,
respectively or SLT is purged.
3. DLTH and SLT may be purged.
4. If LSEQ entries exist, then SLT should be purged in order to avoid doubling of the LSEQ loads.
Main Index
TRNSP
Matrix transpose
1504
Computes .
Format:
Input Data Block:
Output Data Block:
Remarks:
1. Transposition of matrices for matrix multiplications can also be requested with the transpose
option in MPYAD and SMPYAD.
2. If is purged, will be purged.
TRNSP
Matrix transpose
TRNSP A/X $
A Matrix .
X Matrix transpose of .
X | | A | |
T
=
A | |
A | |
A | | X | |
Main Index
1505 TYPE
Declares NDDL data blocks, qualifiers, and parameters.
The TYPE DMAP statement performs three different functions, depending on its format:
1. Identifies NDDL data blocks.
2. Specifies the type and authorization of NDDL parameters, qualifiers, and location parameters.
3. Specifies the type and authorization of local parameters.
The TYPE statement is a nonexecutable statement, but must appear before any NDDL data block,
parameter, qualifier, or location parameter; or any local parameter that relies on the TYPE statement to
identify its type and authorization.
The TYPE statement has the following formats:
Formats:
1. Data blocks:
7<3('%GEOLVW
2. NDDL parameters, qualifiers and location parameters:
7<3(3$501''/SW\SH SUPOLVW
3. Local parameters:
7<3(3$50SW\SH SUPOLVW >GHIDXOW@
TYPE
Declares NDDL data blocks, qualifiers, and parameters.
N
Y
N
Y
Main Index
TYPE
Declares NDDL data blocks, qualifiers, and parameters.
1506
Describers:
Remarks:
1. Within any subDMAP, parameters are typed at first occurrence in either a TYPE statement or a
DMAP module. Parameters occurring in Assignment(=) statements must be defined in a previous
DMAP module or TYPE statement.
2. A TYPE statement is required for a parameter if it appears first in one of the following
instructions:
dblist A list of NDDL data blocks. Each data block must be separated by a
comma or a space.
ptype Parameter type. Possible parameter types are as follows:
Description ptype
integer I
real single precision RS
real double precision RD
complex single precision CS
complex double precision CD
character CHARi, where i = 1-80
logical LOGICAL
N, Y Parameter authorization. Y allows user input of the parameter value via
the PARAM Bulk Data entry or Case Control command. N disallows
PARAM input. If neither N nor Y is specified, then authorization or
user override of the parameters contained in the prmlist are determined
at DMAP compilation time by the parameters first appearance in a
DMAP Module.
prmlist A list of parameters. Each parameter must be separated by a comma or
a space.
default In Format 3 only, parameters may be assigned a default value. This
value overrides the MPL default value if any. Character values must be
enclosed in single quotation marks.
NDDL Keyword that identifies parameters or qualifiers defined in the NDDL.
Main Index
1507 TYPE
Declares NDDL data blocks, qualifiers, and parameters.
CALL
MESSAGE
Assignment
Conditional (IF and DO WHILE)
DBVlEW module (WHERE clause if its not a qualifier)
3. Default values for NDDL parameters and qualifiers are specified on the PARAM and QUAL
NDDL statements and, if specified on the TYPE statement, result in a warning message.
4. With the exception of parameters declared as QUALifiers through the QUAL NDDL statement,
all NDDL parameters are stored immediately in the database on completion of a DMAP
assignment statement or the module S option.
5. As described under CALL DMAP statement, the (S,) option to save control and QUALifier
parameters is necessary to facilitate parallel and recursive processing.
6. Only the ptype is used on the TYPE PARM for parameters passed through a subDMAP argument
list. Also, default values are ignored.
7. It is recommended that all TYPE statements in a SUBDMAP appear immediately after the
SUBDMAP statement.
8. If NDDL data blocks passed through a SUBDMAP argument list are referenced on a TYPE DB
statement, then a fatal error will occur.
9. If data blocks not defined in the NDDL appear in a TYPE DB statement, then a fatal error will
occur.
10. If the parameter type and authorization specified on a TYPE statement do not match those
specified in a DMAP module, then a fatal error will occur.
11. If the parameter type specified on a TYPE statement does not match the type required by a DMAP
module, then a fatal error will occur.
12. Character parameters which appear on TYPE statements and also module instructions must be
defined with ptype CHAR8. For example:
TYPE PARM,,CHAR8,N,MAJOR,SETJ,COMP='COMP' $
MAJOR='G' $
SETJ='A' $
VEC USET/VGACOMP1/MAJOR/SETJ/COMP $
Use of other lengths, such as CHAR4, results in fatal termination.
Examples:
The following TYPE PARM statements show how parameters are typed in a subDMAP. Note the use of
comments.
$
$ QUALS
TYPE PARM,NDDL,I,Y,MODEL,SOLlD,SElD,BASE $
$ IFP PARAMETERS
TYPE PARM,NDDL,I,Y,ERROR,NOTRED,ASING,MODACC,FIXEDB,
BAILOUT $
TYPE PARM,NDDL,RS,,MAXRATIO $
Main Index
TYPE
Declares NDDL data blocks, qualifiers, and parameters.
1508
$ LOCAL PARAMETERS PASSED IN OR OUT
TYPE PARM,,I,,GO,NOSSET,NOOSET,UNSYM=6,NORC,NOQSET,
DONOGO,LOOPERR,NOTSET,ERRNO,RESlD,ACON,NOASM,
NORSET,NOLSET $
$ LOCAL PARAMETERS TO THIS SUB DMAP
TYPE PARM,,I, ,NOKFF,QNOTNULL,NOKQQl $
TYPE PARM,,CHAR8,N,APP,F=F $
$
A typical TYPE DB statement is as follows:
TYPE DB A,B,C,D,
U,V,W,X,Y,Z $
Main Index
1509 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
Solves both linear and quadratic real unsymmetric eigenvalue problems.
Format:
Input Data Blocks:
Output Data Blocks:
UEIGL
Solves both linear and quadratic real unsymmetric
eigenvalue problems
UEIGL KXX,QXX,MXX,DYNAMIC,CASECC,SVEC,BP,APL,APU/
PHX,ULAMA,PHXL,XORTH,LAMMAT,CLAMMAT,LAMA/
S,N,NEIGV/SID/F1/F2/ND/EPS $
KXX Stiffness matrix in any set.
QXX Aerodynamic matrix in any set for the linear unsymmetric
eigensolution.
MXX Mass matrix in any set for the quadratic unsymmetric eigensolution.
DYNAMIC Table of Bulk Data entry images related to dynamics.
CASECC Table of Case Control command images.
SVEC Starting "random" eigenvector matrix.
BP Null space B matrix.
APL Lower triangular factor of null space A matrix.
APU Upper triangular factor of null space A matrix.
PHX Right eigenvector matrix for real eigenvalues only.
ULAMA Unsymmetric eigenvalue summary table.
PHXL Left eigenvector matrix for real eigenvalues only.
XORTH Cross-orthogonality matrix.
LAMMAT Diagonal matrix with real eigenvalues on the diagonal.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal.
LAMA Normal modes eigenvalue summary table.
Main Index
UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
1510
Parameters:
Remarks:
1. In certain MSC Nastran applications the eigenvalue problem presented contains real,
unsymmetric matrices. One such application, the direct structural acoustic problem is formulated
as:
where the stiffness and mass matrices are both real unsymmetric, containing coupled blocks of
structural and fluid matrices. Another case of unsymmetric but real eigenvalue problem is given
in the aeroelastic divergence solution posed as:
where is the structural stiffness matrix, real, symmetric positive definite, however, the
divergence matrix is real, unsymmetric.
2. The left-handed solutions of the two problems presented before are:
for acoustics and
NEIGV Output-integer-no default. The number of eigenvectors found. Set to -
1 if none were found.
SID Input-integer-default=0. Alternate set identification number.
If SID=0, the set identification number is obtained from the
UMETHOD command in CASECC and used to select the EIGUL
Bulk Data entry in DYNAMIC.
If SID>0, then UMETHOD command is ignored and the EIGUL entry
is selected by this parameter's value. All subsequent parameter values
(F1, F2, etc.) are ignored.
If SID<0, then both the UMETHOD command and all EIGUL entries
are ignored and the subsequent parameter values (F1, F2, etc.) will be
used to control the eigenvalue extraction.
F1 Input-real-default=0.0. The lower frequency/eigenvalue bound.
F2 Input-real-default=0.0. The upper frequency/eigenvalue bound. The
default value of 0.0 indicates machine infinity.
ND Input-integer-default=0. The number of desired eigenvalues.
EPS Input-real-default=0.0. Convergence criterion. By default EPS will be
set to N/10000 where N is the size of KXX, etc.
K
aa
2
M
aa
+ | || 0 =
K
ll
Q
ll
+ | || 0 =
K
ll
Q
l l
T
K
aa
2
M
aa
+ ( ) 0 =
Main Index
1511 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
for aeroelastic divergence.
Based on the physical principals of above problems, the eigenvectors are real and the eigenvalues
are either real (aeroelastic divergence) or pure imaginary (acoustics).
3. QXX is required if MXX is purged and vice versa.
4. XORTH, CLAMMAT, SVEC, BP, APL and, APU may be purged.
T
K
ll
Q
ll
+ ( ) 0 =
Main Index
UGVADD
Adds two displacement vectors when direct addition would yield erroneous results
1512
Adds two displacement vectors when direct addition based on small angle theory would yield erroneous
results. For old geometric nonlinear analysis only.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
Remarks:
1. SIL may not be purged.
2. If either UGNI or DUGNI is null, the addition will be done directly.
3. UGVADD is used only in SOL 4.
UGVADD
Adds two displacement vectors when direct addition would
yield erroneous results
UGVADD UGNI,DUGNI,SIL/
UGNT $
UGNI Displacement matrix at converged step in the g-set.
DUGNI Incremental displacement matrix between the last two converged
steps.
SIL Scalar index list.
UGNT Total displacement matrix in the g-set.
Main Index
1513 UMERGE
Merges two matrices based on USET
Merge two matrices with the same number of columns and with the rows based on degrees-of-freedom
sets defined in the USET table into a single matrix.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
UMERGE
Merges two matrices based on USET
UMERGE USET,A11,A21/A/MAJOR/SET1/SET2 $
USET USET table output from module GP4 or GPSP (or USETD table from
DPD for dynamics or AEUSET table from APD for aerodynamics).
Aij Matrix partitions.
A Assembled matrix.
MAJOR Character-input-no default. Major degree-of-freedom set name. See
Remarks.
SETi Character-input-default='COMP'. Subset degree-of-freedom names.
See Remarks.
A11
A21
A | |
Main Index
UMERGE
Merges two matrices based on USET
1514
Remarks:
1. The supersets formed by the union of other sets have the following definitions.
2. SET1 or SET2, but not both, may be set to 'COMP' (or blank) which means that one set is the
complement of the other. For example, if MAJOR='G', SET1='A', and SET2='COMP' (or blank)
then SET2 is assumed to be those degrees-of-freedom in the g-set that are not in the a-set.
3. If SET1 and SET2 are unique subsets of MAJOR but their union does not comprise all of the
degrees-of-freedom in the MAJOR set, then the SET2 partition is assumed to be SET2='COMP'.
For example, if MAJOR='G', SET1='A', and SET2='S' then SET2 is assumed to be 'COMP' (See
Remark 2) and not just the s-set.
4. The set names MAJOR, SET1, and SET2, may specify a combination of set names separated by
a plus (+) or minus (-) character. The plus (+) character indicates a union and the minus (-)
character an exclusion. For example, 'a-b+m' indicates the a-set without the b-set and then this
resultant set is then unioned with the m-set.
5. USET and A may not be purged.
6. A11 or A21 may be purged, in which case, they are assumed to be null.
Examples:
To merge four matrices into a single matrix based on degrees-of-freedom sets.
1. Append PHO to PHA.
a. UMERGE USET,PHA,PHO/PHF/'F'/'A' $
b. UMERGE USET,PHO,PHA/PHF/'F'//'O' $
sets
mr
sb
sg
m
o
q
r
c
b
e
sa
k
t
a
d
f
fe
n
ne
g
p
supersets
l
lm
mp
s
ks
j
js
Main Index
1515 UMERGE
Merges two matrices based on USET
2. Expand PHA to g-set size.
a. UMERGE USET,PHA,/PHG/'G'/'A' $
b. UMERGE USET,,PHA/PHG/'G'//'A' $
3. Expand PHRC with rows corresponding to the r and c-set to the union of the t, o, and m-sets.
a. UMERGE USET,PHRC,/PHTOM/'T+O+M'/'R+C' $
Main Index
UMERGE1
Merges up to four matrices based on USET
1516
Format:
Input Data Blocks:
Output Data Block:
Parameters:
UMERGE1
Merges up to four matrices based on USET
UMERGE1 USET,A11,A21,A12,A22/A/MAJOR/SET1/SET2/IOPT $
USET USET table output from module GP4 or GPSP (or USETD table from
DPD for dynamics or AEUSET table from APD for aerodynamics).
Aij Matrix partitions with rows and columns that correspond to degrees-
of-freedom in the USET table.
A Assembled matrix.
MAJOR Character-input-no default. Major degree-of-freedom set name. See
Remarks.
SETi Character-input-default='COMP'. Subset degree-of-freedom names.
See Remarks.
IOPT Integer-input-default = 0. IOPT chooses between square and
rectangular.
IOPT = 0 IOPT = 1 IOPT = 2
A11 A12
A21 A22
A | |
A11
A21
A | |
A11 A12
A | |
Main Index
1517 UMERGE1
Merges up to four matrices based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
2. SET1 or SET2, but not both, may be set to 'COMP' (or blank) which means that one set is the
complement of the other. For example, if MAJOR='G', SET1='A', and SET2='COMP' (or blank)
then SET2 is assumed to be those degrees-of-freedom in the g-set that are not in the a-set.
3. If SET1 and SET2 are unique subsets of MAJOR but their union does not comprise all of the
degrees-of-freedom in the MAJOR set, then the SET2 partition is assumed to be SET2='COMP'.
For example, if MAJOR='G', SET1='A', and SET2='S' then SET2 is assumed to be 'COMP' (See
Remark 2) and not just the s-set.
4. The set names MAJOR, SET1, and SET2, may specify a combination of set names separated by
a plus (+) or minus (-) character. The plus (+) character indicates a union and the minus (-)
character an exclusion. For example, 'a-b+m' indicates the a-set without the b-set and then this
resultant set is then unioned with the m-set.
5. USET and A may not be purged.
6. If an input matrix is purged, then it is assumed to be null.
Examples:
1. Merge submatrices of KFF.
a. UMERGE1 USET,KAA,KOA,KAO,KOO/KFF/'F'/'A' $
b. UMERGE1 USET,KAA,KOA,KAO,KOO/KFF/'F'//'O' $
c. UMERGE1 USET,KOO,KAO,KOA,KAA/KFF/'F'/'O' $
sets
mr
sb
sg
m
o
q
r
c
b
e
sa
k
t
a
d
f
fe
n
ne
g
p
supersets
l
lm
mp
s
ks
j
js
Main Index
UMERGE1
Merges up to four matrices based on USET
1518
2. Expand PHRC, with rows corresponding to the union of the r and c-set, to PHTOM, with rows
corresponding to the union of the t, o, and m-sets.
a. UMERGE1 USET,PHRC,,,/PHTOM/'T+O+M'/'R+C'//1 $
Main Index
1519 UPARTN
Partitions a matrix based on USET
Partition matrix based on degrees of freedom defined in the USET table.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
UPARTN
Partitions a matrix based on USET
UPARTN USET,A/A11,A21,A12,A22/MAJOR/SET1/SET2/IOPT $
USET USET table output from module GP4 or GPSP (or USETD table from
DPD for dynamics or AEUSET table from APD for aerodynamics).
A Any matrix with rows or columns that correspond to
degrees-of-freedom in the USET table.
Aij Matrix partitions
MAJOR Character-input-no default. Major degree-of-freedom set name. See
Remarks.
SETi Character-input-default='COMP'. Subset degree-of-freedom names.
See Remarks.
IOPT Integer-input-default = 0. IOPT chooses between a symmetric partition
and a vector partition. A vector partition is performed if IOPT = 1 or 2.
IOPT = 0 IOPT = 1 IOPT = 2
A | |
A11 A12
A21 A22
A | |
A11
A21
A | |
A11 A12
Main Index
UPARTN
Partitions a matrix based on USET
1520
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
2. SET1 or SET2, but not both, may be set to 'COMP' (or blank) which means that one set is the
complement of the other. For example, if MAJOR='G', SET1='A', and SET2='COMP' (or blank)
then SET2 is assumed to be those degrees-of-freedom in the g-set that are not in the a-set.
3. If SET1 and SET2 are unique subsets of MAJOR but their union does not comprise all of the
degrees-of-freedom in the MAJOR set, then the SET2 partition is assumed to be SET2='COMP'.
For example, if MAJOR='G', SET1='A', and SET2='S' then SET2 is assumed to be 'COMP' (See
Remark 2) and not just the s-set.
4. The set names MAJOR, SET1, and SET2, may specify a combination of set names separated by
a plus (+) or minus (-) character. The plus (+) character indicates a union and the minus (-)
character an exclusion. For example, 'a-b+m' indicates the a-set without the b-set and then this
resultant set is then unioned with the m-set.
5. USET may not be purged.
6. A may be purged, in which case UPARTN will simply return, causing the output matrices to be
purged.
7. Any or all output data block(s) may be purged.
Examples:
1. Partition KFF into its submatrices.
a. UPARTN USET,KFF/KAA,KOA,KAO,KOO/'F'/'A' $
b. UPARTN USET,KFF/KAA,KOA,KAO,KOO/'F'//'O' $
c. UPARTN USET,KFF/KOO,KAO,KOA,KAA/'F'/'O' $
sets
mr
sb
sg
m
o
q
r
c
b
e
sa
k
t
a
d
f
fe
n
ne
g
p
supersets
l
lm
mp
s
ks
j
js
Main Index
1521 UPARTN
Partitions a matrix based on USET
2. Extract PHRC, with rows corresponding to the union of the r and c-set, from PHTOM, with
rows corresponding to the union of the t, o, and m-sets.
a. UPARTNUSET,PHTOM/PHRC,,/'T+O+M'/'R+C'//1 $
3. Partition [KGG] into the q-set and its complement, columns only:
a. UPARTN USET,KGG/KGQ,,KGCOMP,/G/Q//2 $
K
gg
| |
K
gq
K
gcomp
Main Index
UREDUC
Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
1522
Reduces rectangular matrices of displacements or loads from the p-set (or g-set) to the d- and/or h-set.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
None.
Remarks:
1. If PHDH is purged PH will not be output.
UREDUC
Reduces rectangular matrices from p-set (or g-set) to d-
and/or h-set
UREDUC
, ,
XD,XH,XS $
XP Rectangular matrix of displacements or loads in the p-set
XG Rectangular matrix of displacements or loads in the g-set
USETD Degree-of-freedom set membership table for p-set.
USET Degree-of-freedom set membership table for g-set.
GMD Multipoint constraint transformation matrix with extra points, m-set by
ne-set.
GM Multipoint constraint transformation matrix, m-set by n-set.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
PHDH Transformation matrix from d-set to h-set (modal).
PHA Normal modes eigenvector matrix in the a-set.
XD Rectangular matrix of displacements or loads in the p-set.
XH Rectangular matrix of displacements or loads in the h-set (modal).
XS Rectangular matrix of displacements or loads in the s-set.
XP
XG
)
`
USETD
USET
)
`
GMD
GM
)
`
GOD
GOA
)
`
PHDH
PHA
)
`
Main Index
1523 UREDUC
Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
2. GM (or GMD) and GOA (or GOD) may not be purged unless their m-set and
o-set degrees-of-freedom do not exist.
3. The method of reduction is equivalent to a combination of the DMAP modules UPARTN,
UMERGE1, MPYAD, and MCE2.
Main Index
VDR
Creates tables based on solution set output requests
1524
Creates tables based on solution set output requests for displacements, velocities, accelerations, and
nonlinear loads.
Format:
Input Data Blocks:
VDR
Creates tables based on solution set output requests
VDR
&$6(&&, 8;<2/;<&'%31/02
'6(/7
OUXY1,OPNL1/
APP/SOLTYP/S,N,NOSORT2S/S,N,NOSOUT/S,N,NOSDR2/
FMODE/S,N,NOSORT2 $
CASECC Table of Case Control command images.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data).
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
USETD Degree-of-freedom set membership table for p-set.
USET Degree-of-freedom set membership table for g-set.
UXY Solution matrix from dynamic analysis (transient, frequency, normal
or complex modes) in the d- or h-set.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list.
XYCDB Table of x-y plotting commands.
PNL Nonlinear load matrix appended from each output time step.
MODSELT Table of mode numbers selected by the combination of
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. If FLUID=TRUE, then
MODSELT is based on the MODESELECT(FLUID) Case Control
command and user parameters LMODESFL, LFREQFL, and
HFREQFL.
EQDYN
EQEXIN
)
`
USETD
USET
)
`
Main Index
1525 VDR
Creates tables based on solution set output requests
Output Data Blocks:
Parameters:
Remarks:
1. PP may be purged only if UDV is purged.
2. PNL, XYCDB, OUXY1, and OPNL1 may be purged.
OUXY1 Table of displacements in SORT1 format for h-set or d-set.
OPNL1 Table of nonlinear loads in SORT1 format for the h-set or d-set.
APP Input-character-no default. Analysis type. Allowable values:
'REIGEN' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
SOLTYP Input-character-no default. Solution method.
'MODAL' Modal.
'DIRECT' Direct.
NOSORT2S Output-integer-no default. Solution set SORT2 format flag. Set to 1 if SORT2
format or x-y plotting is requested for the solution set; -1 otherwise.
NOSOUT Output-integer-default=0. Solution set (d- or h-set) output flag. Set to 1 if any
solution set output is requested; -1 otherwise.
NOSDR2 Output-integer-no default. Physical set (g-set) output flag. Set to 1 if any
physical set output is requested in CASECC or XYCDB; -1 otherwise.
FMODE Input-integer-no default. The lowest mode number resulting from LMODES or
LFREQ and HFREQ.
NOSORT2 Output-integer-default=0. Physical set SORT2 format flag. Set to 1 if SORT2
format is requested or XYCDB is present; -1 otherwise.
Main Index
VEC
Creates partitioning vector based on USET
1526
To create a partitioning vector based on degree-of-freedom sets. The vector may be used by the MERGE
and PARTN modules.
Format:
Input Data Block:
Output Data Block:
Parameters:
VEC
Creates partitioning vector based on USET
VEC USET/CP/MAJOR/SET1/SET2/UNUSED4/SET3 $
USET USET table output from module GP4 or GPSP (or USETD table from
DPD for dynamics or AEUSET table from APD for aerodynamics).
CP Partitioning vector.
MAJOR Character-input-no default. Major degree-of-freedom set name. See
Remarks.
SETi Character-input-default='COMP'. Subset degree-of-freedom names.
See Remarks.
UNUSED4 Integer-input-default=0. Unused and may be unspecified.
SET3 Character-input-default=' '.
Main Index
1527 VEC
Creates partitioning vector based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
2. If MAJOR = 'BITID', then SET1 and SET2 are ignored and the set name specified for SET3
corresponds to the zeros in CP and MAJOR corresponds to G or P for USET and USETD,
respectively. Those degrees-of-freedom not in SET3 correspond to ones in CP.
3. If SET1 (or SET2, but not both) is set to 'COMP' (or left blank) then SET1 (or SET2) is assumed
to be the complement of SET2 (or SET1).
4. The set names MAJOR, SET1, and SET2, may specify a combination of set names separated by
a plus (+) or minus (-) character. The plus (+) character indicates a union and the minus (-)
character an exclusion. For example, 'a-b+m' indicates the a-set without the b-set and then this
resultant set is then unioned with the m-set.
5. USET may not be purged.
Examples:
1. To partition into a- and o-set based matrices, use
VEC USET/V/'F'/'O' $
PARTN KFF,V,/KOO,KAO,KOA,KAA $
Note that the same thing can be done in one step by
UPARTN USET,KFF/KOO,KAO,KOA,KAA/'F'/'O' $
2. Example 1 could be accomplished by
VEC USET/V/'F'/'O' $
or
VEC USET/V/'F'/'A' $
3. Example 1 could also be accomplished by
sets
mr
sb
sg
m
o
q
r
c
b
e
sa
k
t
a
d
f
fe
n
ne
g
p
supersets
l
lm
mp
s
ks
j
js
K
ff
| |
Main Index
VEC
Creates partitioning vector based on USET
1528
VEC USET/V/'BITID'////'A' $
Main Index
1529 VECPLOT
Transforms, searches, and computes resultants of matrices
Performs utility functions on g-set size matrices, including computation of resultants, transformation
from one coordinate system to another, and generation of rigid body matrices.
Format:
Format for IOPT=11:
Input Data Blocks:
VECPLOT
Transforms, searches, and computes resultants of matrices
VECPLOT XG,BGPDT,SCSTM,CSTM,CASECC, ,
MEDGE,X66P,VGQ,RBF/
XOUT,RESMAX,HEADCNTL,X66/
S,N,GRDPNT/COORID/IOPT/TITLE1/TITLE2/TITLE3/
ALTSHAPE/WTMASS/SEID/SETNAM/RBFAIL $
VECPLOT PGRES,BGPDT,,,CASECC,,,QGRES,QMGRES/
XOUT,,,,/GRDPNT//11 $
XG Any matrix with rows corresponding to the g-set or p-set in the global
coordinate system. An example is a displacement or load matrix.
BGPDT Basic grid point definition table.
SCSTM Table of global transformation matrices for partitioned superelements.
CSTM Table of coordinate system transformation matrices.
CASECC Table of Case Control command images.
LAMA Normal modes eigenvalue summary table.
USET Degree-of-freedom set membership table for g-set.
MEDGE Edge table for p-element analysis.
X66P Previous output of X66, usually at g-set. Used by IOPT=9, when
setnam<>'g', as a baseline to compare against the non-g-set results in
X66.
VGQ Partitioning vector with values of 1.0 at rows corresponding to
degrees-of-freedom in the q-set.
RBF Rigid body force matrix.
PGRES Same as RESMAX output in a prior execution of VECPLOT when PG
is input for XG and IOPT=1 or 8.
LAMA
USET
)
`
Main Index
VECPLOT
Transforms, searches, and computes resultants of matrices
1530
Output Data Block:
Parameters:
QGRES Same as RESMAX output in a prior execution of VECPLOT when QG
is input for XG and IOPT=1 or 8.
QMGRES Same as RESMAX output in a prior execution of VECPLOT when
QMG is input for XG and IOPT=1 or 8.
XOUT Output matrix or table as described in Remark 1.
RESMAX Resultant or maxima matrix that is printed out with IOPT=1 or 5.
HEADCNTL List of integer codes for header print control in the DISUTIL module
under IOPT=1 or 5.
X66 Triple-product of XG with rigid body modes for IOPT=9 or 10.
GRDPNT Input/output-integer-default=0. Identification number of the grid point
about which resultant moments will be computed. If GRDPNT = 0 or
the grid point does not exist, then the origin of the basic coordinate
system will be used and GRDPNT=-1 will be output from the module.
COORID Input-integer-default=-1. Identification number of the coordinate
system into which XG will be transformed. The default (-1 or 0)
indicates the basic coordinate system. Used only with IOPT = 1 and 5.
IOPT Input-integer-default=-1. Output option. See Remark 1.
IOPT=9 is intended for processing of the WEIGHTCHECK Case
Control command. Similar to IOPT=7 except:
XG is a mass matrix:
1) Allows other sets.
2) Compares X66 (for non-g-set) with X66p.
IOPT=10 is intended for processing of the GROUNDCHECK Case
Control command. Similar to IOPT=7 except:
XG is a stiffness matrix:
1) Allows other sets.
2) Prints UIM indicating strain energy in each rigid body direction.
TITLEi Input-character. Title which appears above the printed output. See
Remark 1.
TITLE1 default = 'VECTOR'
TITLE2 default = 'RESULTAN'
TITLE3 default = 'T'
Main Index
1531 VECPLOT
Transforms, searches, and computes resultants of matrices
Remarks:
1. The table below describes the contents of XOUT and the printed output for each IOPT.
ALTSHAPE Input-integer-default=0. Set of displacement functions in p-element
analysis. See Parameters (p. 691) in the MSC Nastran Quick
Reference Guide.
WTMASS Input-real-default=1.0. Scale factor on structural mass matrix. Used
only in IOPT=7. See Parameters (p. 691) in the MSC Nastran Quick
Reference Guide.
SEID Input-integer-default=-1. Superelement identification number.
SETNAM Input-character-default='g'. Degree-of-freedom set name used by
IOPT=9 and 10.
RBFAIL Output-logical-default='false'. Set to TRUE if grounding check does
not pass strain energy threshold used by IOPT=10.
IOPT Contents of XOUT Printed Output
<0
Displacement vector file suitable for input to the
PLOT module.
None.
1
XG converted to the coordinate system specified by
COORID.
Resultants of the input
vectors about GRDPNT in
the basic coordinate system.
2
Same as IOPT=1 and for each grid point,
and
,
where and are the translations and rotations of
XG.
Same as IOPT = 1.
3
XG is converted to the basic coordinate system.
Then the coordinate locations (x, y, z) in BGPDT
converted to a matrix and translated by XG:
where , , are the translations of XG in the
basic coordinate system. BGPDT contains the
location of each grid point in the basic coordinate
system. COORID is ignored.
None.
u'
x
u'
y
u'
x
u'
y
u'
z
0 = = = = =
u'
z
u
x
u
y
u
z
u
x
u
y
u
z
+ + + + + =
u
i
u
i
x' u
x
x + =
y' u
y
y + =
z' u
z
z + =
u
x
u
y
u
z
Main Index
VECPLOT
Transforms, searches, and computes resultants of matrices
1532
4
A six rows by g-column rigid body matrix where
each row represents the motion, in the global
coordinate system, of all grid points due to the unit
motion of the grid point listed on
PARAM,GRDPNT. Grid point GRDPNT is given a
unit translation or rotation in each direction of the
basic coordinate system. XOUT represents the rigid
body modes of the structure with no mechanisms.
The motion is output in the global coordinate
system. XG and COORID are ignored.
None.
5 Same as IOPT=1.
6
A g-row by 6-column rigid body matrix where each
column represents the motion of all grid points due
to a unit motion of an r-set degrees of freedom (see
SUPORTi Bulk Data entries).
None.
where [XOUT4] is the rigid body matrix generated
under PLOTFORM = 4, and is the
partition of corresponding to the six
r-set degrees of freedom defined in the USET table.
There must be six and only six r-set degrees of
freedom which completely describe the six rigid
body modes. The r-set degrees of freedom may be
defined on more than one grid point. If the r-set
degrees of freedom belong to a single grid point,
then the result is the same as IOPT=4, except that the
unit motions of the grid point listed on PARAM,
GRDPNT are in its global, rather than basic
coordinate system.
7
Grid point weight generator summary table suitable
for printing by the OFP module. Same as GPWG
module.
None.
8
Same as IOPT=1. Same as IOPT=1 except
output includes
contributions from each
direction.
9 Same as IOPT=7. None.
IOPT Contents of XOUT Printed Output
XOUT | | XOUT4 | |
T
DRR
1
| | =
DRR | |
XOUT4 | |
Main Index
1533 VECPLOT
Transforms, searches, and computes resultants of matrices
2. If displacement coordinate systems exist, or COORID = 0, then CSTM may not be purged and
SCSTM may not be purged if partitioned superelements are present.
3. CASECC and LAMA may be purged.
4. BGPDT and XOUT may not be purged.
5. XG may be purged if IOPT=3, 4, or 6.
6. MEDGE may be purged if p-elements are not present.
7. USET may be purged except for IOPT=6, 9, and 10.
8. IOPT=11 processes, but does not require, the EQUILIBRIUM Case Control command and
requires the previous executions of VECPLOT to compute resultants of PG, QG, and QMG with
IOPT=1 or 8. It is assumed that the resultants, PGRES, QGRES, and QMGRES were computed
with the same value of GRDPNT.
Examples:
1. Convert a displacement vector in a global coordinate system that is cylindrical to the basic system,
and print it.
VECPLOT UG,BGPDT,SCSTM,CSTM,,,,/UGBASIC/0/0/1 $
MATGPR BGPDT,USET,,UGBASIC//H/G $
2. Given a free-free model with no mechanisms, compute its rigid body modes in the global and
basic coordinate systems.
VECPLOT ,,BGPDT,SCSTM,CSTM,,,,/RBGLOBAL///4 $
TRNSP RBGLOBAL/RBT $
VECPLOT RBT,BGPDT,,CSTM,,,,/RBBASIC///1 $
3. Convert a load matrix to the basic coordinate system, and print out the maximum load at any grid
point for each load vector.
VECPLOT PG,BGPDT,SCSTM,CSTM,,,,/PGBASIC//0/5 $
MATPRN PG,PGBASIC//$
10
Same as IOPT=7. User Information Message
7570, which shows
grounding check strain
energies and pass/fail report.
11
A table suitable for processing by OFP. The table
consists of a single line for each type of force
resultants (OLOADs, SPCForces, and MPCForces)
present as well as a line that represents the total sum
of the force resultants. The results are summed about
the grid point specified in the EQUILIBRIUIM Case
Control command if specified.
None.
IOPT Contents of XOUT Printed Output
Main Index
VIEW
Computes heat transfer radiation view factors
1534
Computes heat transfer radiation view factors.
Format:
Input Data Blocks:
Output Data Block:
Parameters:
None.
VIEW
Computes heat transfer radiation view factors
VIEW EST,BGPDT,EQEXIN,EPT,EDT,MATPOOL/
MPOOL $
EST Element summary table.
BGPDT Basic grid point definition table.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
EPT Table of Bulk Data entry images related to element properties.
EDT Table of Bulk Data entry images related to element deformation.
Required only for differential stiffness generation.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images.
Main Index
1535 VIEWP
Generates geometry tables for view mesh in p-element data recovery
Generates geometry tables for the view mesh in p-element data recovery.
Format:
Input Data Blocks:
VIEWP
Generates geometry tables for view mesh in p-element data
recovery
VIEWP GEOM1,GEOM2,EST,CASECC,OINT,EDT,EPT,
PELSET,BGPDT,EQEXIN,CSTM,PVAL0/
ELEMVOL,GEOM1VU,GEOM2VU,VIEWTB/
S,N,VUGNEXT/S,N,VUENEXT/VUGJUMP/VUELJUMP/
VUHEXA/VUPENTA/VUTETRA/VUQUAD4/VUTRIA3/VUBEAM/
S,N,VUEXIST $
GEOM1 Table of Bulk Data entry images related to geometry.
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points.
EST Element summary table.
CASECC Table of Case Control command images.
OINT p-element output control table.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver.
EPT Table of Bulk Data entry images related to element properties.
PELSET p-element set table, contains SETS DEFINITIONS.
BGPDT Basic grid point definition table.
EQEXIN Equivalence table between external and internal grid/scalar
identification numbers.
CSTM Table of coordinate system transformation matrices.
PVAL0 p-value table generated by the ADAPT module in a previous run or
superelement.
Main Index
VIEWP
Generates geometry tables for view mesh in p-element data recovery
1536
Output Data Blocks:
Parameters:
ELEMVOL Element volume table, contains p-element volumes and the p-value
dependencies of each p-element grid, edge, face and body.
GEOM1VU Table of Bulk Data entry images related to geometry with view-grids
added.
GEOM2VU Table of Bulk Data entry images related to element connectivity and
scalar points p-elements removed and view-elements added.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
VUGNEXT Input/output-integer-default=0. Starting identification number for next
view-grid.
VUENEXT Input/output-integer-default=0. Starting identification number for next
view-element.
VUGJUMP Input-integer-default=100. Delta between view-grid identification
numbers.
VUELJUMP Input-integer-default=100. Delta between view-element identification
numbers.
VUHEXA Input-character-default='VUHEXA'. Name for VUHEXA element.
VUPENTA Input-character-default='VUPENTA'. Name for VUPENTA element.
VUTETRA Input-character-default='VUTETRA'. Name for VUTETRA element.
VUQUAD4 Input-character-default='VUQUAD4'. Name for VUQUAD4 element.
VUTRIA3 Input-character-default='VUTRIA3'. Name for VUTRIA3 element.
VUBEAM Input-character-default='VUBEAM'. Name for VUBEAM element.
VUEXIST Output-logical-default=FALSE. View-element flag. Set to TRUE if
view-elements exist.
Main Index
1537 WEIGHT
Calculates model's volume and/or weight
Calculates the model's volume and/or weight.
Format:
Input Data Blocks:
Output Data Blocks:
Parameters:
WEIGHT
Calculates model's volume and/or weight
WEIGHT VELEM,EST,MPT,DIT,OPTPRM,OGPWG,DESTAB,XINIT/
WMID,WGTM/
WGTVOL/S,N,VOLS/S,N,FRMS/SEID/DOFRMASS $
VELEM Table of element lengths, areas, and volumes.
EST Element summary table.
MPT Table of Bulk Data entry images related to material properties.
DIT Table of TABLEij Bulk Data entry images.
OPTPRM Table of optimization parameters.
OGPWG Grid point weight generator table in weight units.
DESTAB Table of design variable attributes.
XINIT Matrix of initial values of the design variables.
WMID Table of weight as a function of material identification number.
WGTM Table of the 6x6 rigid body mass matrix.
WGTVOL Input-integer-default=0. Weight/volume retained response flag. Set to >0 if any
retained response.
1 Weight only.
2 Volume only.
3 Weight And volume.
VOLS Output-real-default=0.0. Total volume of analysis model.
SEID Input-integer-default=0. Superelement identification number.
FRMASS Output-real-default=0.0. Fractional mass of designed structure.
Main Index
WEIGHT
Calculates model's volume and/or weight
1538
SEID Input-integer-default=0. Superelement identification number.
DOFRMASS Input-integer-default=0. Fractional mass flag.
Main Index
1539 XSORT
Reads and sorts Bulk Data Section
Reads and sorts the Bulk Data Section.
Format:
Input Data Blocks:
Output Data Block:
Parameter:
XSORT
Reads and sorts Bulk Data Section
XSORT FORCE,BULKOLD/
BULK,UBULK/
S,N,NOGOXSRT/S,N,QUALNAM/S,N,NEXTID/S,N,LASTBU
LK/
S,N,EQVBLK $
FORCE Table of MSGSTRESS plotting commands.
BULKOLD Bulk table from a prior run, to be merged into BULK.
UBULK Table of all unsorted Bulk Data entries.
BULK Table of all Bulk Data entries.
UBULK Table of all unsorted Bulk Data entries.
NOGOXSRT Logical-output-default=FALSE. Set to TRUE an error is detected in
the Bulk Data.
QUALNAM Output-character-default=' '. Keyword which appears on the
BEGIN BULK command of the next Bulk Data Section; usually
SUPER or AUXMODEL.
NEXTID Input/output-integer-default=0. Identification number which appears
on the BEGIN BULK command of the next Bulk Data Section; usually
indicates superelement or auxiliary model identification number.
Main Index
XSORT
Reads and sorts Bulk Data Section
1540
Remarks:
1. XSORT does not stop on error detection; therefore, the following statement should appear after
the module:
IF (NOGOXSRT) EXIT $
2. If BULKOLD is purged or empty, then the current Bulk Data is sorted and copied into BULK.
3. XSORT must be specified after the IFP1 module.
Examples:
1. Read the Bulk Data Section in a cold start.
XSORT ,,/IBULK/S,N,NOGOXSRT $
2. Read multiple Bulk Data Sections in a loop and cold start. Each Bulk Data Section is prefaced
with BEGIN SUPER=SEID and qualified by SEID.
DO WHILE ( NOT LASTBULK ) $
XSORT ,,/IBULK/
S,N,NOGOXSRT//S,N,NEXTID/S,N,LASTBULK $
SEID=NEXTID $
ENDDO $
LASTBULK Output-logical-default=FALSE. Flag to indicate the current Bulk Data
Section is the last section in the input file.
EQVBLK Input/output-logical-default=FALSE. Copy/equivalence flag of
BULKOLD to BULK. If on input EQVBLK=FALSE, and no new
Bulk Data then copy BULKOLD to BULK. If on input and output
EQVBLK=TRUE and no new Bulk Data, then BULKOLD must be be
equivalenced to BULK in a subsequent EQUIVX statement. If there
are any new Bulk Data then EQVBLK will be set to FALSE on output.
Main Index
1541 XYPLOT
Writes plot information to plot file (.plt)
Writes plot information to the plot file (.plt).
Format:
Input Data Blocks:
Output Data Block:
None.
Parameters:
None.
XYPLOT
Writes plot information to plot file (.plt)
XYPLOT XYPLOT// $
XYPLOT Table of x-y plot control values.
Main Index
XYTRAN
Creates table of plot instructions for x-y plots
1542
Creates a table of plot instructions for x-y plots.
Format for SDR2 Outputs:
Format for RPSEC Output:
Format for MODEPOUT Outputs:
Format for VDR Outputs:
XYTRAN
Creates table of plot instructions for x-y plots
XYTRAN XYCDB,OPG2,OQG2,OUG2,OES2,OEF2,OSTR2,OQMG2,
OVG2,OAG2,OESC2,OSTC2,OEFC2,OSRC2/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID/DVAFLAG $
XYTRAN XYCDB,OXRESP,,,,,,,,/
XYPOLT/
RSPEC/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
XYTRAN XYCDB, , ,
, ,,,,/XYPLOT/
/PSET/XYSET/S,N,PLTNUM/UNUSED/
S,N,NOXYPLOT/S,N,TABID $
XYTRAN XYCDB,OUXY2,OPNL2,,,,,,,/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
OFMPF2M
OFMPF2E
)
`
OSMPF2M
OSMPF2E
)
`
OPMPF2M
OPMPF2E
)
`
OLMPF2M
OLMPF2E
)
`
OGPMF2M
OGPMPF2E
)
`
MODE
RESP
)
`
Main Index
1543 XYTRAN
Creates table of plot instructions for x-y plots
Format for RANDOM Outputs:
Input Data Blocks:
Output Data Block:
XYTRAN XYCDB,PSDF,AUTO,,,,,,,/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
XYCDB Table of x-y plotting commands.
PSDF Power spectral density table.
AUTO Autocorrelation function table.
OVG Table of aeroelastic x-y plot data for V-g or V-f curves.
OXRESP Table of response spectra in SORT2 format.
OVG2 Table of velocities in SORT2 format.
OAG2 Table of accelerations in SORT2 format.
OESC2 Table of lamina stresses in SORT2 format.
OSTC2 Table of lamina strains in SORT2 format.
OEFC2 Table of failure indices in SORT2 format.
OSRC2 Table of strength ratios in SORT2 format.
OUXY2 Table of displacements in SORT2 format for h-set or d-set.
OPNL2 Table of nonlinear loads in SORT2 format for the h-set or d-set.
OFMPF2M Table of fluid mode participation factors by normal mode.
OFMPF2E Table of fluid mode participation factors by excitation frequencies.
OSMPF2M Table of structure mode participation factors by normal mode.
OSMPF2E Table of structure mode participation factors by excitation frequencies.
OPMPF2M Table of panel mode participation factors by normal mode.
OPMPF2E Table of panel mode participation factors by excitation frequencies.
OLMPF2M Table of load mode participation factors by normal mode.
OLMPF2E Table of load mode participation factors by excitation frequencies.
OGMPF2M Table of grid mode participation factors by normal mode.
OGMPF2E Table of grid mode participation factors by excitation frequencies.
XYPLOT Table of x-y plot control values.
Main Index
XYTRAN
Creates table of plot instructions for x-y plots
1544
Parameters:
APP Input-character-default='TRANRESP'. Analysis type. Allowable values are:
'REIGEN' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
'VG' Aeroelastic V-g or V-f data.
'CONTACT' Slideline contact.
'RAND' or
RANDOM
Process all random results excluding acoustic modal RANDOM
participation factor outputs from MODEPOUT.
RANDSDVA Process only VDR module outputs which are requested with the
SDISP, SVELO , SACCEL Case Control commands.
RANDOMS Process all random results except VDR outputs.
RANDMPF Process only MODEPOUT outputs.
'SET1' Abscissa points are specified on SET1Bulk Data entries
'RSPEC' Response spectra.
XYSET Input-character-default='SOL'. Degree-of-freedom set type.
'SOL' Solution set (d-set or h-set).
'DSET' d-set.
'HSET' h-set.
'PSET' p-set.
PLTNUM Input/output-integer-default=0. Plot frame counter.
UNUSED Unused.
NOXYPLOT Output-integer-default=1. Set to 1 if XYPLOT is created; -1 otherwise.
TABID Input/output-integer-default=0. TABLED1 punch flag. If IDTAB is greater than
zero, all requests for XYPUNCH will produce TABLED1 Bulk Data entries for the
curve. The table identification number will start at TABID and increase by one for
each table punched.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations are contained
in separate data blocks and any associated outputs follow suit.
-1 Velocities and acceleratons are contained in OUG2
1 Velocities and acceleratons are contained in OVG2 and OAG2
Main Index
1545 XYTRAN
Creates table of plot instructions for x-y plots
Remarks:
1. OFPi2 may be element stresses, displacements, element forces, single-point forces of constraint,
applied loads, slideline contact stresses, nonlinear loads in p-set,
h-set, or d-set.
2. OFPi2 may be specified in any order.
3. If APP='RAND' then PSDF and AUTO must be specified.
4. If APP='RSPEC' then OXRESP must be specified.
5. If APP='VG' then OVG must be specified.
Examples:
1. Modal frequency response solution set (h-set) output:
XYTRAN XYCDB,OUDVC2,,,,/XYPLTFA/'FREQ'/'HSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLT $
2. Direct transient response physical set (p-set) output:
XYTRAN XYCDB,OPP2,OQP2,OUPV2,OES2,OEF2/XYPLTT/'TRAN'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLT $
3. Random response output:
XYTRAN XYCDB,PSDF,AUTO,,,/XYPLTR/'RAND'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLTR $
4. Response spectra output:
XYTRAN XYCDB,OXRESP,,,,/XYPLTSS/'RSPEC'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP/S,N,TABID $
5. Aerodynamic V-g curve output:
XYTRAN XYCDB,OVG,,,,/XYPLTCE/'VG'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP $
6. Grid point output; i.e., grid points on the abscissa:
XYTRAN
XYCDB,OPG2X,OQG2X,OUG2X,OES2X,OEF2X/XYPLTT/'SET1'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP $
7. Slideline contact output:
XYTRAN XYCDBS,OESNLBP2,,,,/XYPLTB1/'CONT'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOXYP $
Main Index
Glossary
MSC Nastran DMAP Programmers Guide
Glossary
Parameter Glossary
Main Index
1547 Glossary
Data Block Glossary
Data Block Glossary
The Data Block Glossary lists the names and a brief description of all data blocks shown in the module
descriptions in Detailed Descriptions of DMAP Modules and Statements, 589. If the data block is
described in Data Block Descriptions, 66, then the generic name is also shown. Naming conventions
appear at the end of the glossary.
Chapter 4
Name
Chapter 2
Name Description
A Square matrix to be decomposed by DCMP, DECOMP, SOLVE, and
SOLVIT. Rectangular matrix to be processed by the DIAGONAL
and SCALAR modules. Rectangular matrix formed from partitions.
Output by MERGE, UMERGE, and UMERGE1. Rectangular
matrix to be used in MPYAD and SMPYAD module product.
Rectangular matrix to be used in NORM module.
AA Acceleration matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID). Output by
SEDR.
AAP Sparse partial reduced matrix in update matrix format when
KSYM=3. Output by DCMP.
ABESF* Family of a-set size panel area matrices.
ACPT Aerodynamic connection and property table. Output by APD.
ADBINDX Table of the aerodynamic database contents. (one entry for each of
the NV instances created). Output by ADG.
ADELUF Matrix of adjoint sensitivities for frequency response.
ADELUS Matrix of adjoint sensitivities for static analysis.
ADELX Matrix of adjoint sensitivities. Output by DSADJ.
ADJG Adjoint sensitivity displacement matrix in the g-set or
p-set.
ADJGT Transposed adjoint solution matrix specified on first pass through
DSADJ. Output by DSADJ.
ADJGT0 ADJGT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
ADRDUG Matrix of adjoint loads for the g-set. Output by DOPR3.
ADRDUTB Table of adjoint load attributes. Output by DOPR3.
AEBGPDT* BGPDT Family of aerodynamic basic grid point definition tables. Output by
APD.
AEBGPDTI Basic grid point definition table for the aerodynamic js-set
interference degrees-of-freedom.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1548
AEBGPDTI* Family of basic grid point definition tables for the interference js-set
aerodynamic degrees-of-freedom.
AEBGPDTJ Basic grid point definition table for the aerodynamic js-set degrees-
of-freedom.
AEBGPDTJ* Family of basic grid point definition tables for the js-set
aerodynamic degrees-of-freedom.
AEBGPDTK Basic grid point definition table for the aerodynamic ks-set degrees-
of-freedom.
AEBGPDTK* Family of basic grid point definition tables for the ks-set
aerodynamic degrees-of-freedom.
AEBOX Table of aerodynamic element connectivity. Output by APD as
BGPDT with qualifier MODLTYPE='AEROMESH'.
AECMPOLD Previously generated AECOMP.
AECOMP Aerodynamic component definition table. Output by APD.
AECSTMHG Table of aerodynamic coordinate system transformation matrices
that only contains the hinge moment referenced coordinates systems
if not null. Output by MKCNTRL.
AECTRL Table of aerodynamic model's control definition. Output by ADG.
AEDBIDX Index table consisting of the triples. Output by MAKAEFS.
AEDBINDX Aeroelastic database index for monitor point data.
AEDBUXV Matrix of vehicle states.
AEDW Matrix of downwash vectors contained on DMIJ Bulk Data entries
referenced by the AEDW entries. Output by MAKAEFA.
AEDWIDX Index to the AEDW tables. Output by MAKAEFA.
AEECT* GEOM2 Family of aerodynamic element connection tables. Output by APD.
AEFIDX Index to the AEFORCE tables. Output by MAKAEFA.
AEFRC Matrix of force vectors contained on DMIK Bulk data entries
referenced by the AEFORCE entries. Output by MAKAEFA.
AEGRID BGPDT Basic grid point definition tables for the aerodynamic model. Output
by APD as BGPDT with qualifier MODLTYPE='AEROMESH'.
AEIDW Matrix of interference downwash vectors contained on DMIJ Bulk
Data entries referenced by the AEDW entries. Output by
MAKAEFA.
AEIPRE Matrix of interference pressure vectors contained on DMIJ Bulk data
entries referenced by the AEPRESS entries. Output by MAKAEFA.
AEMONOLD Table of HM monitor points.
Chapter 4
Name
Chapter 2
Name Description
Main Index
1549 Glossary
Data Block Glossary
AEMONPT Aerodynamic monitor point table. Output by MAKAEMON and
MAKMON.
AEPRE Matrix of pressure vectors contained on DMIJ Bulk data entries
referenced by the AEPRESS entries. Output by MAKAEFA.
AEPRSIDX Index to the AEPRESS tables. Output by MAKAEFA.
AERO Table of control information for aerodynamic analysis. Output by
APD.
AEROCOMP Table of aerodynamic components when MESH='AERO'. Output by
MAKCOMP.
AEUSET* USET Family of aerodynamic USET tables. Output by APD.
AG Acceleration matrix in g-set.
AGD Acceleration matrix in g-set for the downstream superelement.
AGG Fluid/structure coupling matrix at all points or for a structural panel.
Output by GP5.
AGX Gravity/thermal load matrix due to volumetric changes for the
central, forward, or backward perturbed configuration. Output by
SSG1.
AH Signed global modally reduced area matrix
Aij Matrix partitions. Output by PARTN and UPARTN.
AJJT Aerodynamic influence matrix. Output by AMG.
AM2 Damping matrix in the d-set for linear elements multiplied by the
negative of the time step delta
AM3 Combined mass and damping matrix multiplied the square of the
reciprocal of the time step delta and the reciprocal of twice the time
step delta, respectively.
AMLIST List of auxiliary model identification numbers. Output by AXMPR1.
AMSPLINE Table of aerodynamic splines for display. Converted from forces and
pressures computed on AEBGPDT grid points, (box centroidal
points) to AEGRID grid points (box corner points). Output by APD.
ANORM Normalized matrix. Output by NORM.
APART Partitioning vector for panel coupling matrix when
PNLPTV=TRUE.
APIMAT Diagonal matrix of average power input values. Output by
SEEFMCLF.
APIMATT Matrix of average power input per unit force for all EFM
superelements for all bands.
Chapter 4
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1550
APL Lower triangular factor of null space A matrix.
APPLOD Matrix of applied load amplitudes. Output by DPD.
APU Upper triangular factor of null space A matrix.
ARVEC Residual vector matrix based on adjoint loads. Output by DOPR3.
AUG1 Displacement matrix in g-set for aerostatic analysis. Output by
DSAD.
AUTO Autocorrelation function table. Output by RANDOM.
AUXTAB Table of aerodynamic extra point identification numbers,
displacements, labels, type, status, position and hinge moments for
all subcases.
AXIC Table of Bulk Data entry images related to conical shell, hydro
elastic, and acoustic cavity analysis. Output by IFP.
Chapter 3
Name
Chapter 2
Name Description
B Output matrix from the DIAGONAL module. Right hand side of a
system of equations input to the FBS, SOLVE, and SOLVIT
modules. Rectangular matrix to be used in MPYAD and SMPYAD
module product.
B2DD Total damping matrix from viscous damping elements and the B2PP
Case Control command and reduced to the d-set. In transient
response analysis, B2DD may also include structural damping
effects.
B2GG Matrix defined on DMIG Bulk Data entries and referenced by the
B2GG Case Control command. Output by MTRXIN.
B2PP Matrix defined on DMIG Bulk Data entries and referenced by the
B2PP Case Control command. Output by MTRXIN.
BAA Viscous damping matrix in a-set or d-set.
BACK Transformation matrix from cyclic to physical components.
Required in static and pre-buckling analysis only. Output by
CYCLIC1.
BANDLIST Table of mode information for all bands. Output by SEEFMBND.
BANDPV Matrix of partitioning vectors for all non-trivial bands. Output by
SEEFMBND.
BASVEC Auxiliary displacement matrix.
BASVEC0 Auxiliary displacement matrix. Optional user input.
Chapter 4
Name
Chapter 2
Name Description
Main Index
1551 Glossary
Data Block Glossary
BCON0 Table of constant terms in the beam section constraint relationship.
Output by DOPR1.
BCONXI Matrix relating beam library constraints to the independent design
variables. Output by DOPR1.
BCONXT Matrix transpose of BCONXI.
BD3X3 3x3 diagonal strip for boundary degrees-of-freedom from KGG for
parallel domain decomposition. Output by GPSP.
BDD Damping (or heat capacitance) matrix for the d-set for linear
elements only.
BDIAG Diagonal matrix of buckling divided by buckling generalized
differential stiffness matrix. Output by DSAH.
BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format.
Output by BMG.
BDICT KDICT BELM dictionary table. Output by EMG.
BELM KELM Table of element damping or heat capacity matrices. Output by
EMG.
BFEFE Damping matrix in the fe-set (or nonlinear tangential heat
capacitance matrix) for both linear and nonlinear elements in the fe-
set.
BFHH Fluid partition of modal damping matrix BHH.
BGDD* Family of coriolis matrices.
BGPDT* BGPDT Family of basic grid point definition tables (BGPDT) qualified by
LOADID and LOADNAME and associated with PG*. Output by
EXPORTLD.
BGPDT BGPDT Basic grid point definition table. Output by GP1.
BGPDTD BGPDT Basic grid point definition table for a downstream superelement.
BGPDTFB* Family of BGPDT tables associated with FBLPG. One instance
defines the grids for one given freebody subsystem. Output by
FBDODYLD.
BGPDTM BGPDT Basic grid point definition table and updated for the current p-level.
Output by GP1 with GEOM1M and GEOM2M as inputs.
BGPDTN BGPDT New BGPDT table based on displaced grid locations. Output by
MATMOD option 11.
BGPDTS BGPDT Basic grid point definition table for a superelement. Output by GP1.
BGPDTX BGPDT BGPDT assembled for superelements defined on the SEPLOT or
SEUPPLOT command. Output by SEPLOT.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1552
BGPDVB BGPDT Basic grid point definition table for the backward perturbed
configuration. Output by DSAM.
BGPDVP BGPDT Basic grid point definition table for the forward (or central)
perturbed configuration. Output by DSAM.
BGPDVX BGPDT Basic grid point definition table for the central, forward, or
backward perturbed configuration. Output by DSAM.
BGPECT GEOM2 Boundary grid point element connection table. Output by BGP.
BGPP* Family of coriolis matrices - p-set.
BHH Generalized (modal) damping matrix
BHH1 Modified generalized (modal) damping matrix. Output by FA1.
BKDICT KDICT BKELM dictionary table.
BKK Viscous damping matrix in cyclic components. Output by
CYCLIC3.
BLAMA LAMA Buckling eigenvalue summary table. Output by READ.
BLAMA* LAMA Family of buckling eigenvalue summary tables.
BMODAL Matrix of modal damping values from selected TABDMP1 Bulk
Data entry in DIT. Output by GKAM.
BNDFIL Table containing the local and global boundary grids in the order
given by extreme for domain decomposition. Output by SEQP.
BP Null space B matrix.
BPP Damping (or heat capacitance) matrix for the p-set for linear
elements only.
BRDD Damping matrix in the d-set for linear elements only or heat
capacitance matrix for both linear and nonlinear elements in the d-
set.
BTOPO Contact regions topological information table. Output by BGP.
BTOPOCNV Updated contact regions input information table. Output by
NLITER, NLSOLV, and NLTRD2.
BTOPOSTF Updated contact regions topological information table. Output by
NLITER, NLSOLV, and NLTRD2.
BULKINDX Table of all sorted Bulk Data entries with indices. Output by
INDXBULK.
BXX Viscous damping matrix in any set. Usually h-set or d-set in CEAD,
FRRD1, FRRD2, TRD1, and TRD2.
BUG* Family of buckling eigenvector matrices in the g-set
Chapter 3
Name
Chapter 2
Name Description
Main Index
1553 Glossary
Data Block Glossary
BUX Matrix of damping multiplied by displacement or eigenvectors.
BULK Table of all Bulk Data entries. Output by XSORT and RMDUPBLK.
BULK* Family of auxiliary model or superelement Bulk Data sections.
BULKOLD BULK table from a prior run.
Chapter 3
Name
Chapter 2
Name Description
C Rectangular matrix to be used in MPYAD module addition and
SMPYAD module product.
CASADJ CASECC Case Control table associated with adjoint method. Output by
DSAD.
CASDSN CASECC Case Control table with unneeded analysis subcase(s) deleted,
excluding static aeroelastic subcases. Output by DSAD.
CASDSX CASECC Case Control table with unneeded analysis subcase deleted
CASE CASECC Table of Case Control commands for the current analysis type and
superelement.
CASEA CASECC A single record (subcase) of CASECC for aerodynamic analysis.
Output by AELOOP.
CASEBK CASECC Case Control table for cyclic data recovery. One record for every
column in BACK. Required in static and pre-buckling analysis only.
Output by CYCLIC1.
CASEBUCK CASECC Case Control table for buckling analysis and based on
ANALYSIS=BUCK. Output by MDCASE.
CASECC CASECC Table of Case Control command images. Output by IFP1.
CASECC* CASECC Family of auxiliary model Case Control tables.
CASECC1 CASECC Primary model Case Control table appended with extra subcases to
account for the boundary shapes. Output by SHPCAS.
CASECCP Selected records of CASECC assigned to local processor. Output by
DMPCASE.
CASECCU CASECC Table of Case Control command images originally output by IFP1.
Used when first CASECC is replaced by one of the CASECC
outputs from a prior call to MDCASE.
CASECCBO CASECC Updated CASECC for contact region data recovery operations.
Output by BGCASO.
CASECCP CASECC subsetted for current selection of Fortran unit. Output by
MODCASE.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1554
CASECCR CASECC Table of Case Control command images for data recovery. Output by
TOLAPP.
CASECEIG CASECC Case Control table for modal or direct complex eigenvalue analysis
and based on ANALYSIS=MCEIG or DCEIG. Output by
MDCASE.
CASEDM CASECC Case Control table for the recovery of design responses for modes.
CASEDMF CASECC Case Control for all load-cases for all design variables for the
perturbed configuration for modes. Output by DSAH.
CASEDR CASECC Table of Case Control command images for the superelement
(identification number equal to output value of SEID). Output by
SEDR.
CASEDS CASECC Case control table for the data recovery of design responses. Output
by DOPR3 and DSTA.
CASEDSF CASECC Case Control table for all load cases and all design variables for the
perturbed configuration. Output by DSAH.
CASEDVRG CASECC Case Control table for aerostatic divergence analysis and based on
ANALYSIS=DIVERG. Output by MDCASE.
CASEFLUT CASECC Case Control table for flutter and based on ANALYSIS=FLUTTER.
Output by MDCASE.
CASEFR CASECC Updated Case Control table for static loads generation and solution
in cyclic symmetry analysis. One record for every distinct load set
identification number. Output by CYCLIC1.
CASEFREQ CASECC Case Control table for modal or direct frequency response analysis
and based on ANALYSIS=MFREQ or DFREQ. Output by
MDCASE.
CASEHEAT CASECC Case Control table for heat transfer analysis and based on
ANALYSIS=HEAT. Output by MDCASE.
CASEMODE CASECC Case Control table for normal modes analysis and based on
ANALYSIS=MODES. Output by MDCASE.
CASEMTRN CASECC Case Control table for modal transient analysis and based on
ANALYSIS=MTRAN. Output by MDCASE.
CASENT CASECC CASECC transformed for nonlinear transient response analysis.
Output by ST2DYN.
CASEP CASECC Residual superelement Case Control table for plotting basis vectors.
Output by DOPR2. Case Control table with number of basis vectors
in the DESVEC as the number of Case Control records. Output by
DSAJ.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1555 Glossary
Data Block Glossary
CASER Table of Case Control command images loaded with SET
id=GRIDSET. Output by MATMOD option 36.
CASERS CASECC Case Control table for the residual structure and a given analysis
type.
CASES CASECC Table of Case Control command images for the current
superelement (identification number equal to output value of SEID).
Output by SEP2CT.
CASESADV CASECC Combined Case Control table which includes CASESAER or
CASEDVRG. Output by MDCASE.
CASESAER CASECC Case Control table for aerostatic analysis and based on
ANALYSIS=SAERO. Output by MDCASE.
CASESMEM CASECC Case Control table for electromagnetic analysis and based on
ANALYSIS=ELEC. Output by MDCASE.
CASESMST CASECC Case Control table for structural analysis and based on
ANALYSIS=STRU. Output by MDCASE.
CASESNMB CASECC Combined Case Control table which includes CASESTAT,
CASEMODE, CASEBUCK, CASESAER, CASEDVRG, and
CASEFLUT. Output by MDCASE.
CASESTAT CASECC Case Control table for static analysis and based on
ANALYSIS=STATICS. Output by MDCASE.
CASESX CASECC Expanded Case Control table. Output by LCGEN.
CASEUNIT Table of Case Control parameters requesting to a unit displacements.
In addition, the monitor points will be expressed as various sets of
output depending on what is being monitored. Output by ILMP1.
CASEUPSE CASECC Case Control table for upstream superelements only. Output by
MDCASE.
CASEVEC CASECC Table of Case Control command images with the PARTN command
referencing all of auxiliary model's grid identification numbers.
Output by AXMPR2.
CASEXX CASECC Subset of CASECC for current loop. Output by CASE.
CASEYY CASECC Appended Case Control table in flutter analysis. Output by FA2.
CCPOS Table of Case Control record locations. Output by AELOOP and
AEMODEL.
CCPOS1 Table of Case Control record locations. Output by AELOOP and
AEMODEL.
CDELB Triple matrix product for flutter damping sensitivity
CDELK Triple matrix product for flutter stiffness sensitivity
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1556
CDELM Triple matrix product for flutter mass sensitivity
CFSAB Matrix of spectral densities--weighting factors for RMS
calculations. Output by DOPRAN.
CIDATA Miscellaneous data for controlled increment method. Output by
NLITER.
CLAMA LAMA Complex eigenvalue summary table. Output by CEAD.
CLAMA1 LAMA Complex eigenvalue summary table in flutter analysis. Output by
CEAD.
CLAMA2 LAMA Appended complex eigenvalue summary table in flutter analysis.
Output by FA2.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal. Output
by CEAD, LAMX, and UEIGL.
CLFMAT Matrix of coupling loss factors. Output by SEEFMCLF.
CMAT Complex matrix.
CMBXPHG Matrix of component modes transformed to the basic coordinate
system and row-ordered in external grid id sequence.
CMLAMA Component modal eigenvalue summary table.
CMSEQ Table of (strain, kinetic, or damping) energy in all components.
Output by CMSENGY.
CMSQE Matrix of (strain, kinetic, or damping) energy in the component.
CMSTEQ Table of (strain, kinetic, or damping) energy in all components.
Output by CMSENGY.
CMSTQE Matrix of (strain, kinetic, or damping) energy in the component.
CNTABR CONTAB Table of retained constraint attributes. Output by DSAD.
CNTABRG CONTAB Table of retained constraint attributes.
CNTABXE CNTABXM with resolved DRESP2 and DRESP3 records. Output
by DSADX.
CNTABXM Merged CNTABX associated with unresolved DRESP2 and
DRESP3 records.
CNVTST Convergence test matrix.
CONTABX Table of constraint attributes with respect to RESP12X.
COELEM Correlation table between idcid/eid/component for element
responses. Output by DSAH.
COGRID Correlation table between idcid/gid component for displacement
responses. Output by DSAH.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1557 Glossary
Data Block Glossary
COLOR Coloring array. Number of rows corresponds to size of MAT. The i-
th entry corresponds to the superelement identification number (tip
superelement or collector or 0 (residual)) to which the i-th degree-
of-freedom. belongs. Output by PRESOL.
COMP Merged table of components. Output by MRGCOMP.
COMPi Table of aerodynamic or structural components
CON Matrix of constants that relates design variables and design
coordinates. Output by DOPR2.
CONS1T Matrix transpose of relationship between dependent and
independent design variables. Output by DOPR1.
CONSBL Matrix of constant property values. Output by DOPR1.
CONSBL* Family of matrices of constant property values. Output by DOPR1.
CONTAB CONTAB Table of constraint attributes. Output by DOPR3.
CONTACT Table of Bulk Data entries related to contact regions. Output by IFP.
CONTROL Table of editing directives for the TABEDIT module.
CONTVDIF Derivative interpolation factor matrix (NV rows by NX columns).
Output by NDINTERP.
CONTVX Controller vector used to interpolate UXV (NX rows)
CONTVXV Assemblage of all controller vectors (NX rows by NV columns)
COORD Matrix of initial or final designed coordinate values, COORDO or
COORDN.
COORDN Updated (optimized) COORDO. Output by DOM11.
COORDO Matrix of initial designed coordinate values at the beginning of each
design cycle. Output by DOPR2.
CP Column partitioning vector. Output by VEC and MATMOD option
17.
CPERM Table of column permutations under KSYM=4. Output by
DECOMP.
CPH1 Complex eigenvector matrix for h-set in flutter analysis. Output by
CEAD.
CPH2 Appended complex eigenvector matrix for h-set in flutter analysis.
Output by FA2.
CPHFL Left flutter eigenvector - h-set. Output by DSFLTE.
CPHP Complex eigenvector matrix in the p-set.
CPHFR Left flutter eigenvector - h-set. Output by DSFLTE.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1558
CPHX Complex eigenvector matrix in the d-set or h-set. Output by CEAD.
CPHL Complex eigenvector matrix in the l-set. Output by CEAD.
CSNMB CASECC Case Control table for a given superelement and all analysis types.
CSTM CSTM Table of coordinate system transformation matrices. Output by GP1.
CSTMi CSTM Tables of coordinate system transformation matrices; either
aerodynamic or structural.
CSTMi* Family of CSTM tables.
CSTM0 CSTM Table of coordinate system transformation matrices for the residual
structure.
CSTMA CSTM Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points. Output by APD.
CSTMD CSTM Table of coordinate system transformation matrices for a
downstream superelement.
CSTMM CSTM Merged table of coordinate system transformation matrices. Output
by MKCSTMA.
CSTMS CSTM Table of coordinate system transformation matrices for a
superelement.
CSTMX Merged table of CSTMi. Output by MRGCSTM.
CVAL Matrix of constraint values, CVALO or CVALRG.
CVALO Matrix of final (optimized) constraint values. Output by DOM9.
CVAL Matrix of retained constraint values. Output by DSAD.
CVALR Matrix of retained constraint values. Output by DSAD.
CVALRG Matrix of initial constraint values.
CVALXE CVALRG with resolved DRESP2 and DRESP3 records Output by
DSADX.
CVEC Partitioning vector for separating the primary model solutions from
boundary shape induced solutions. Output by SHPCAS.
CVECT Load combination factor matrix. Output by PCOMB.
CYCD Table of constraints in harmonic components. Output by CYCLIC2.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1559 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
D Rectangular matrix to be used in SMPYAD module product.
Diagonal matrix extracted from LD. Output by MATMOD option
21.
D1JE Real part of downwash matrix due to extra points.
D1JK Real part of downwash matrix. Output by AMG.
D2JE Imaginary part of downwash matrix due to extra points.
D2JK Imaginary part of downwash matrix. Output by AMG.
DAR Rigid body transformation matrix for the r-set to the
a-set. Formed from the merge of DM and an l-set size identity matrix.
DBCOPT DBCOPT Design optimization history table for post-processing. Output by
DOM12.
DB Data block.
DBi Data block to be processed by the DBC, INPUTT2, and OUTPUT2
modules. Data blocks to be compared in the RESTART module. Data
block declared on the FILE statement. Data block to be purged by
PURGEX module. Any data block to be broadcast from the master
to the slave processors.
DBMLIB Table of designed beam library data. Output by DOPR1.
DBNAME Data block for 'NAME' option of PARAML module. Output by
PARAML.
DBOUTi DBi received on the slave processor. Output by MDISUTIL.
DBP Primary data block.
DBS Secondary data block. Output by EQUIVX.
DBUG Buckling eigenvector matrix in the g-set associated with designed
(active) eigenvalues. Output by DSAH.
DCLDXT Matrix of coefficients in the grid to design variable relationship.
Output by DOPR2.
DCPHL Complex eigenvectors associated with the divergence eigenvalues
extracted from the real part of eigenvectors associated with the
divergence eigenvalues. Output by CEAD.
DEFUSET Table of DEFUSET Bulk Data entry images. Output by IFP.
DELB1 Matrix of delta buckling load factor for all design variables.
DELBSH Matrix of finite difference shape step sizes.
DELBSX Updated DELBSH where the numerical zero terms are replaced by a
prescribed small value. Output by DOPR5.
DELCE Matrix of delta complex eigenvalue for all design variables
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1560
DELDV Matrix of divergence sensitivity. Output by DSDVRG.
DELF1 Matrix of delta eigenvalue for all design variables.
DELFL Matrix of delta flutter responses for all design variables. Output by
DSFLTF.
DELGM Matrix of delta generalized masses for all design variables.
DELGS Matrix of delta generalized stiffnesses for all design variables.
DELS Matrix of delta stability derivative responses for all design variables.
DELS1 Matrix of delta stability derivative responses for all design variables
for a single trim subcase. Output by DSARSN.
DELTGM Multipoint constraint transformation matrix for the perturbed
configuration. Output by DSVGP4.
DELVS Matrix of delta volume for all design variables. Output by DSAW.
DELWS Matrix of delta weight for all design variables. Output by DSAW.
DELX Matrix of delta trim variable responses for all design variables.
DELX1 Matrix of delta trim variable responses for all design variables for a
single trim subcase. Output by DSARSN.
DEQATN Table of DEQATN Bulk Data entry images. Output by IFP.
DEQIND Index table to DEQATN data block. Output by IFP.
DESELM Table of designed elements. Output by DOPR3.
DESGID Table of designed grid coordinate attributes. Output by DOPR2.
DESNEW Update table of design variable attributes. Output by DOM12.
DESTAB DESTAB Table of design variable attributes. Output by DOPR1.
DESVCP Global shape basis vector matrix with incorporation of DLINK
relations with extra columns for property/dummy variables. Output
by DOPR2.
DESVEC Basis vector matrix which consists of basis vectors generated from
DVGRID Bulk Data entries and from columns of BASVEC0 matrix.
Its components are defined in the basic coordinate system.
DESVECP Basis vector matrix which consists of basis vectors generated from
DVGRID bulk data entries and from columns of BASVEC0 matrix
its components are expressed in the global coordinate system.
DFFDNF Table containing the derivatives of forcing frequencies with respect
to natural frequencies. Output by FRLGEN.
DGEOM2 GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points for the perturbed configuration. Output by DSAH.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1561 Glossary
Data Block Glossary
DGEOM3 GEOM3 Table of Bulk Data entry images related to static loads for the
perturbed configuration. Output by DSAH.
DGMVPT Partitioning vector to obtain the sensitivities of generalized mass for
normal modes analysis from that of the union set. Output by DSAH.
DGSVPT Partitioning vector to obtain the sensitivities of generalized stiffness
for normal modes analysis from that of the union set. Output by
DSAH.
DGTAB Table relating DTOS4 records and designed grid data. Correlation
table of internal grid sequence for the baseline and perturbed
configuration. Output by DOPR6.
DISTAB Table of discrete optimization value sets. Output by DOPR1.
DIT DIT Table of TABLEij Bulk Data entry images. Output by IFP.
DITID Table of identification numbers in DIT. Output by TA1.
DITNT DIT transformed for nonlinear transient response analysis. Output by
ST2DYN.
DIVDAT Table of divergence data. Output by DIVERG.
DIVTAB Table of aerostatic divergence data for all subcases.
DJX Downwash matrix. Downwash at the j-point due to the x
aerodynamic extra point. Output by ADG.
DLCPHL Left-handed complex eigenvectors associated with the divergence
eigenvalues extracted from the real part of left-handed eigenvectors
associated with the divergence eigenvalues. Output by DIVERG.
DLSTIN List of data blocks and their paths. Output in a previous execution of
RESTART.
DLSTOUT List of data blocks and their paths. Output by RESTART.
DLT Table of dynamic loads. Output by DPD.
DLT1 Table of dynamic loads updated for nonlinear analysis. Output by
NLCOMB and NLTRLG.
DLTH Table of dynamic loads updated for heat transfer analysis. Output by
TRLG.
DM Rigid body transformation matrix for the r-set to the
l-set. Output by RBMG3.
DMATCK Table of designed material consistency check. Output by DOPR1.
DMI Table of all matrices specified on DMI Bulk Data entries. Output by
IFP.
DMIi Matrix data blocks created from DMI. Output by DMIIN.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1562
DMINDX Index into DMI. Output by IFP.
DNODEL Table of designed and non-designed locations. Output by DOPR2.
DNVVPT Partitioning vector to obtain the sensitivities of natural frequencies
for eigenvector optimization from that of the union set. Output by
DSAH.
DPHG Normal modes eigenvector matrix in the g-set associated with
designed (active) eigenvalues. Output by DSAH.
DPLDXI Matrix of coefficients in the property to independent design variable
relationship. Output by DOPR1.
DPLDXI* Family of matrices of coefficients in the property to independent
design variable relationship. Output by DOPR1.
DPLDXT Matrix transpose of DPLDXI.
DRDUG Matrix of adjoint loads for the g-set. Output by DSAD.
DRDUGM Modified matrix of adjoint loads. Output by ADJMOD.
DRDUTB Table of adjoint load attributes. Output by DSAD.
DRDUTBM Modified table of adjoint load attributes. Output by ADJMOD.
DRLIST Superelement processing list for data recovery. Output by SEP4.
DRMSVL Table of the RMS response values with respect to the design
variables. Output by DSAMRG.
DRSTBL Table containing the number of retained responses for each subcase
for each of the response types. Output by DSAD.
DRSTBLG Table containing the number of retained responses for each subcase
for each of the response types.
DRUT Processed version of DRDUTB specified on first pass through
DSADJ. Output by DSADJ.
DRUT0 DRUT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
DSCM Design sensitivity coefficient matrix. Output by DSAL.
DSCM2 Normalized design sensitivity coefficient matrix. Output by DOM6.
DSCMCOL DCSMCOL Correlation table for normalized design sensitivity coefficient
matrix. Output by DSTAP2.
DSCMG Unnormalized design sensitivity matrix.
DSCMR Old combined design sensitivity/constraint matrix. Output by
DSMA.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1563 Glossary
Data Block Glossary
DSCOLL Table of design sensitivity column labels for design sensitivity
matrix, DSCMR. Output by DSTA.
DSCREN Table of constants from the DSCREEN Bulk Data entry. Output by
DOPR1.
DSDIV Matrix of delta divergence speed for all design variables.
DSEDV Partitioning vector for retained divergence responses. Output by
DSAH.
DSEGM Old design sensitivity eigenvalue gradient matrix.
DSESM Design sensitivity eigenvector selection matrix - Boolean operator to
select eigenvectors which are referenced by constraints (buckling
and normal modes only). Output by DSTA.
DSGRID Table of identification numbers for those grid points in the design
model automatic superelement optimization feature. Output by
DSGRDM.
DSIDLBL Table of design response labels. Output by DSTAP2.
DSLIST Superelement processing list to direct the pseudo-load and response
sensitivity calculations. Output by SDSB.
DSPT1 Design sensitivity processing table. Output by DSAN and DSTA.
DSPT2 Old Design sensitivity processor table two. Output by DSTA.
DSROWL Table of design sensitivity row labels for design sensitivity matrix,
DSCMR. Output by DSTA.
DSTABR Matrix of restrained perturbed dimensional stability derivatives.
DSTABU Matrix of unrestrained perturbed dimensional stability derivatives.
DTB Table of constants from the DTABLE Bulk Data entry. Output by
DOPR1.
DTI Table of all matrices specified on DTI Bulk Data entries. Output by
IFP.
DTIi Table data blocks created from DTI. Output by DTIIN.
DTINDX Index into DTI. Output by IFP.
DTOS2 Design variable/property cross reference table. Same as DTOS2K
except that the PREF in each entry is the product of a DPLDXI
element and the corresponding design variable value. Output by
DOPR5.
DTOS2* Family of tables which are the same as DTOS2K* except that the
PREF in each entry is the product of a DPLDXI element and the
corresponding design variable value. Output by DOPR5.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1564
DTOS2J Table identifying independent design variables and property values.
Output by DOPR1.
DTOS2J* Family of tables identifying independent design variables and
property. Output by DOPR1.
DTOS2K Same as DTOS2J except that the dvid in each entry refers to the
position of an internal design variable identification number in the
first TABDEQ record. Output by DOPR4.
DTOS2K* Family of tables which are the same as DTOS2J* except that the dvid
in each entry refers to the position of an internal design variable
identification number in the first TABDEQ record. Output by
DOPR4.
DTOS4 Table relating design variable to grid perturbation. Same as DTOS4K
except that the last three words in each entry contains the product of
those in DTOS4K and the shape step size. Output by DOPR5.
DTOS4J Designed grid perturbation vector in basic coordinate system. Output
by DOPR2.
DTOS4K Same as DTOS4J except that the identification number in each five-
word entry is the position of an internal design variable identification
number in the first TABDEQ record. Output by DOPR4.
DUGNI Incremental displacement matrix between the last two converged
steps. Output by NLITER.
DUPV Displacment increment at the final iteration before exit. Output by
NLSOLV.
DUX Matrix of aerodynamic extra point displacements for the perturbed
configuration. Output by ASG.
DVIDS List of shape variable identification numbers to be used for the
boundary DVGRID option. Output by DSAJ.
DVPTAB DVPTAB Table of attributes of the designed properties by internal property
identification number order. Output by DOPR1.
DVPTAB* DVPTAB Family of tables of attributes of the designed properties by internal
property identification number order. Output by DOPR1.
DVSLIS List of design variables affected by shape variations. Output by
DSVGP4.
DXDXI Matrix relating linked and independent design variables. Output by
DOPR1.
DXDXIT Matrix transpose of DXDXI.
DYNAMIC DYNAMIC Table of Bulk Data entry images related to dynamics. Output by IFP.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1565 Glossary
Data Block Glossary
DYNAMICB Table of Bulk Data entry images related to dynamics without
DAREA entry images. Output by GP1.
DYNAMICS DYNAMIC Table of Bulk Data entry images related to dynamics for the current
superelement. Output by SEP2 and SEP2X.
DYNAMNT DYNAMIC transformed for nonlinear transient response analysis.
Output by ST2DYN.
Chapter 3
Name
Chapter 2
Name Description
E Rectangular matrix to be used in SMPYAD module product.
ECT GEOM2 Element connectivity table. Output by GP2.
ECT* GEOM2 Family of element connectivity tables for all superelements.
ECTA GEOM2 Secondary element connectivity table. Output by GP2.
EDITVEC Vector with zeros in rows to be removed under usetop='filter'.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization. Output by IFP.
EDOM* Family of EDOM tables for all superelements.
EDOMM Table of Bulk Data entries related to design sensitivity and
optimization updated for p-element analysis. Output by OPTGP0.
EDOMS Table of Bulk Data entries related to design sensitivity and
optimization for a superelement. Output by SDSA.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries. Output by IFP.
EDT0 Table of archived set of MONPNT2 records to be merged into
EDTM.
EDTM Archival of EDT containing just the monitor records. Output by
ILMP1.
EED DYNAMIC Table of eigenvalue extraction parameters. Output by DPD.
EFMASMTT Matrix of mass values for all EFM superelements
EFMMCOL Column matrix of EFM superelement mass values. Output by
SEEFMDMP.
EFMDMP Table containing mass values, damping loss factors and frequency-
dependent damping criteria for all superelements for which energy
flow modeling calculations are to be performed. Output by
SEEFMDMP.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1566
EFMLIST Table containing list of superelements for which energy flow
modeling calculations are to be performed. Output by SEEFMLST.
EFMMAT Matrix of energy factors. Output by SEEFMCLF.
EGK Pseudo-load (equilibrium variation) matrix in the g-set due to
stiffness. Output by DSVG1P.
EGM Pseudo-load (equilibrium variation) matrix in the g-set due to mass.
Output by DSVG1P.
EGPSF EGPSF Table of element to grid point interpolation factors. Output by
GPSTR1.
EGPSTR EGPSTR Table of grid point stresses or strains for post-processing in the DBC
module. Output by GPSTR2.
EGTX Pseudo-load matrix (variation in equilibrium) due to changes in the
thermal load/design variables for the central, forward, or backward
perturbed configuration. Output by DSVG2.
EGVREC Table of eigenvector record for sensitivity computation. Output by
DSAH.
EGX Pseudo-load (equilibrium variation) matrix in the g-set due to
stiffness, mass, viscous damping or structural damping. Output by
DSVG1P.
EHT Element hierarchical table for p-element analysis. Output by GP0.
EHTA Secondary element hierarchical table. Output by GP0.
ELDATA Table of combined nonlinear information data. Output by
NLCOMB.
ELDCT ELDCT Table of element stress discontinuities for post-processing in the
DBC module. Output by STDCON.
ELEMVOL Element volume table, contains p-element volumes and the p-value
dependencies of each p-element grid, edge, face and body. Output
by VIEWP.
ELSET Table of element sets defined in OUTPUT(POST), SETS
DEFINITION, or OUTPUT(PLOT) sections of Case Control.
Output by PLTSET and SEPLOT.
EMAT Matrix of editing parameters.
EMM Effective mass matrix. Output by EFFMAS.
ENEMAT Matrix of modal energy. Output by SEEFMCLF.
ENFLODB Matrix of equivalent enforced motion load amplitudes due to
viscous damping effects. Output by DPD.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1567 Glossary
Data Block Glossary
ENFLODK Matrix of equivalent enforced motion load amplitudes due to
stiffness effects. Output by DPD.
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass
effects. Output by DPD.
ENFMOTN Matrix of enforced motion amplitudes. Output by DPD.
EPSSE Table of epsilon and external work. Output by SSG3, SOLVIT, and
DISUTIL.
EPT EPT Table of Bulk Data entry images related to element properties.
Output by IFP and IFP6.
EPTT EPT updated for topology optimization. Output by IFP10.
EPTA EPT Secondary table of Bulk Data entry images related to element
properties.
EPTC EPT Copy of EPT except PCOMP records are replaced by equivalent
PSHELL records. Output by IFP6, CMPZPR, and DSTA.
EPTN EPT Updated (optimized) EPT. Output by DOM11.
EPTS EPT Table of Bulk Data entry images related to element properties for a
superelement. Output by SEP2 and SEP2X.
EPTTAB EPT Table of designed property attributes. Output by DOPR1.
EPTTAB* EPT Family of tables of designed property attributes. Output by DOPR1.
EPTX EPT EPT with design variable perturbations. Output by DSABO. Copy
of EPT except PBCOMP records are replaced by equivalent
PBEAM records. Output by IFP7. Copy of EPT except PBARL and
PBEAML records are replaced by equivalent PBAR and PBEAM
records. Output by IFP9. Copy of EPT except PACABS and
PACABR entries are updated with TABLEij references.
Output by MKMNTIFP: EPT updated to track monitor points
Output by MODGM2: Copy of EPT updated for converted
CSHEAR elements.
EQACST Equivalence table between internal fluid grid points and internal
structural grid points which lie on the fluid/structure boundary.
Output by GP5.
EQDYN EQEXIN Equivalence table between external and internal grid/scalar/extra
point identification numbers. (EQEXIN appended with extra point
data). Output by DPD.
EQEXIN EQEXIN Equivalence table between external and internal grid/scalar
identification numbers. OUTPUT by GP1.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1568
EQEXINS EQEXIN Equivalence table between external and internal grid/scalar
identification numbers for a superelement. Output by SEP2 and
SEP2X.
EQMAP Table of degree-of-freedom global-to-local maps for domain
decomposition. Output by PRESOL.
EQMAPD Similar to EQMAP but on a degree-of-freedom basis. Output by
PRESOL.
EQMAPD0 EQMAPD from a prior call to PRESOL.
ERHM Matrix of dimensional unsplined restrained elastic hinge moment
data
ERROR0 ERROR Error estimate table generated by ADAPT module in previous
superelement or adaptivity loop.
ERROR1 ERROR Error-estimate table updated for current superelement or adaptivity
loop. Output by ADAPT.
EST Element summary table. Output by TA1.
ESTDATA Table of superelement estimation data overrides. Output by DTIIN.
ESTL Linear element summary table. Output by TA1.
ESTDCN Element summary table which incorporates combined constraints
and design variables. Output by DSAF and DSTA.
ESTDV2 Merged EST with grid and element property design variable
perturbations. If CDIF='YES' then this is the forward perturbation.
Output by DSAE.
ESTDVB Element summary table for the backward perturbed configuration.
Required only if CDIF='YES'.
ESTDVM EST EST with updated material property identification numbers. Output
by DSABO.
ESTDVP EST with element property design variable perturbations. Output by
DSABO and DSTA.
ESTDVS EST with grid design variable perturbations. Output by DOPR6.
ESTF Element summary table for follower force stiffness. Output by
TAFF.
ESTNL Nonlinear element summary table. Output by TA1.
ESTNL1 Nonlinear element summary table updated for heat transfer analysis.
Output by TAHT.
ESTNL0 Nonlinear element summary table from previous time step. Output
by NLSOLV.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1569 Glossary
Data Block Glossary
ESTNLH Nonlinear element summary table at converged step. Output by
NLITER, NLTRD, NLTRD2, and NLSOLV.
ESTR EST table with reduced records. Output by MATMOD option 38.
ETT Element temperature table. Output by GP3.
ETTDCN Table of design variable and constraint internal identification
numbers for the effects of temperature. Output by DSAF and DSTA.
ETTDV Element temperature table where the original element identification
numbers have been converted to new design variable identification
numbers. Output by DSAN and DSTA.
EUHM Matrix of dimensional unsplined unrestrained elastic hinge moment
data.
EXCITEFX Matrix of power or force input for all EFM superelements
EXCITF Matrix of EFM superelement force input values. Output by
SEEFMXIT.
EXCITP Matrix of EFM superelement power input values. Output by
SEEFMXIT.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1570
Chapter 3
Name
Chapter 2
Name Description
F Rectangular matrix to be used in SMPYAD module addition.
F2J Matrix of strain energy on DMIG Bulk Data entries referenced by
the K2GG Case Control command. Must be qualified by qualifier
named by DMIGFN.
FENL Strain energy and grid point force at every element from the previous
load step in nonlinear matrix format.
FENL1 Strain energy and grid point force at every element at the current load
step in nonlinear matrix format. Output by NLITER.
FFAJ Matrix of pressures at aerodynamic boxes.
FFGH Follower force for OLOAD output. Output by NLITER.
FG Element forces due to large displacements. Output by GNFM.
FGNL Nonlinear element force matrix from the last iteration. Output by
NLITER.
FLUTAB Flutter summary table for all subcases.
FLUTABK Flutter summary table for K and KE methods. Output by FA2.
FLUTABP Flutter summary table for all methods except K and KE. Output by
FA1.
FMPF Matrix of fluid mode participation factors. Output by MODEPF.
FMV Nonlinear element forces at m-set. Output by NLSOLV.
FMVT Nonlinear element forces at m-set appended from each output time
step (for transient analysis only). Output by NLSOLV.
FN Matrix of natural frequencies (mass normalized stiffness).
FOL FOL Frequency response frequency output list. Output by FRLG.
FOL1 FOL Frequency response frequency output list truncated by the OFREQ
Case Control command. Output by MODACC.
FOLMAT Matrix of frequencies in radian units. Output by MATMOD Option
33.
FOLR Retained frequency response frequency output list. Output by
DSAD.
FOLT FOL Frequency response frequency output list with first frequency
truncated if first frequency is zero. UXF is also similarly truncated.
Output by FRRD1 or FRRD2.
FORCE Table of MSGSTRESS plotting commands defined under the
OUTPUT(CARDS) section in CASE CONTROL and MSGMESH
field information. Output by IFP1.
Main Index
1571 Glossary
Data Block Glossary
FORE Transformation matrix from physical to cyclic components. Output
by CYCLIC1.
FREQMASS Matrix of frequencies and generalized masses.
FRL Frequency response list. Output by FRLGEN.
FRL1 Frequency response list for the current processor if distributed
processing is requested. Output by FRLGEN.
FRLI Frequency response list for a single frequency. Output by FRQDRV.
FRLR Retained frequency response list. Output by DSAD.
FRMDS Sensitivity matrix for fractional mass configuration (statics only).
Output by DSAW.
FRQRMF FRQRPR table for frequency response.
FRQRSP Table of the count of type 1 frequency/time responses per response
type per frequency or time step. Output by DOPR3.
FRQRPR Table containing the number of first level (direct) retained responses
per response type and per frequency or time step. Output by DSAD.
FRQRPRG Table containing the number of first level (direct) retained responses
per response type and per frequency or time step.
FSAVE Flutter storage save or answer table. Output by FA1.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1572
Chapter 3
Name
Chapter 2
Name Description
GAMMAD Complex double precision. This is the scalar multiplier for [C].
GAPAR Partitioning vector which is used to partition the local
a-set displacements from the global a-set displacements. It contains
a 1 at each row that does not have a contribution from the current
processor and zero if it does. Required only for geometric domain
decomp.
GC Transformations matrix between symmetric (cosine) components
and solution set components. Output by CYCLIC3.
GDGK Aerodynamic transformation matrix for displacements from the k-
set to g-set. Output by GI.
GDKI Aerodynamic transformation matrix for displacements from the k-
set to h-set.
GDKSKS Matrix relation of the corner to the centroidal displacements. Output
by GIC2C.
GDNTAB Table of grid points generated for p-element analysis. Output by
GP0.
GEG Element displacement interpolation matrix. Output by MGEN.
GEI Table of general element data. Output by TA1.
GEOM1 GEOM1 Table of Bulk Data entry images related to geometry. Output by IFP.
GEOM1* GEOM1 Family of GEOM1 tables for all partitioned superelements defined
in separate Bulk Data sections.
GEOM1A GEOM1 Table of Bulk Data entry images related to geometry and assigned to
an auxiliary model. Output by IFP.
GEOM1C GEOM1 Table of Bulk Data entry images related to geometry and merged
from GEOM1 and GEOM1A. Output by AXMPR2.
GEOM1EX GEOM1 GEOM1 table containing records which define an external
superelement. Specifically, it contains CORD1j, CORD2j, EXTRN,
and GRID Bulk Data records. Output by BDRYINFO.
GEOM1M GEOM1 Table of Bulk Data entry images related to geometry and updated for
the current p-level. Output by GP0.
GEOM1N GEOM1 Updated (optimized) GEOM1. Output by DOM11. Modified
GEOM1 with CORD1j records converted to CORD2j records.
Output by SECONVRT.
GEOM1P GEOM1 Table of Bulk Data entry images related to geometry updated for p-
elements and superelements. Output by MODGDN.
Main Index
1573 Glossary
Data Block Glossary
GEOM1Q GEOM1 Same as GEOM1 except SEQGP Bulk Data entry records have been
added and any pre-existing SEQGP records are removed. Output by
SEQP.
GEOM1R GEOM1 GEOM1 table with reduced GRID record. Output by MATMOD
option 36.
GEOM1S GEOM1 Table of Bulk Data entry images related to geometry for the current
superelement. Output by SEP2 and SEP2X.
GEOM1VU GEOM1 Table of Bulk Data entry images related to geometry with view-grids
added. Output by VIEWP.
GEOM1W GEOM2 GEOM1 augmented with dummy GRID entries to represent the fluid
superelement modes. Output by MODQSET.
GEOM1X GEOM1 GEOM1 table related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis. Output by IFP3, IFP4, and IFP5.
GEOM1 table related to axisymmetric conical shell, hydroelastic,
acoustic cavity, and spot weld element analysis. Output by
MODGM2.
Output by MKMNTIFP: New GEOM1 table updated to track
monitor points
GEOM2 GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points. Output by IFP.
GEOM2* GEOM2 Family of GEOM2 tables for all partitioned superelements defined
in separate Bulk Data sections.
GEOM2A GEOM2 Table of secondary Bulk Data entry images related to element
connectivity and updated for the current p-level. Output by GP0.
GEOM2DCW GEOM2 GEOM2 table containing the deleted CWELD elements. Output by
MODGM2.
GEOM2EX GEOM2 GEOM2 table containing records which define an external
superelement. Specifically, it PLOTEL and SPOINT Bulk Data
records. Output by BDRYINFO.
GEOM2M GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points and updated for the current p-level. Output by GP0.
GEOM2N GEOM2 Updated (optimized) GEOM2. Output by DOM11. Modified
GEOM2 with GO replaced by X1, X2, and X3 on CBAR, CBEAM,
CBEND, CBUSH and CGAP records. Output by SECONVRT.
GEOM2R GEOM2 GEOM2 table with reduced element record. Output by MATMOD
option 37.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1574
GEOM2S GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points for the current superelement. Output by SEP2 and
SEP2X.
GEOM2T GEOM2 GEOM2 updated for topology optimization. Output by IFP10.
GEOM2VU GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points p-elements removed and view-elements added. Output
by VIEWP.
GEOM2W GEOM2 GEOM2 augmented with SPOINT entries to represent all of the non-
fluid superelement component modes. Output by MODQSET.
GEOM2X GEOM2 GEOM2 table related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis. Output by IFP3, IFP4, and IFP5.
GEOM2 table augmented with fluid data and SPOINTS if
ACMS='YES'. Output by SEQP.
GEOM3 GEOM3 Table of Bulk Data entry images related to static and thermal loads.
Output by IFP.
GEOM3B GEOM3 Table of Bulk Data entry images related to static and thermal loads
with DAREA entry images converted to equivalent FORCE and
MOMENT entry images. Output by GP1.
GEOM3M GEOM3 Table of Bulk Data entry images related to static and thermal loads
and updated for the current p-level. Output by GP0.
GEOM3N GEOM3 Updated GEOM3 for cyclic symmetry analysis. Output by
CYCLIC1. Modified GEOM3 with FORCEi and MOMENTi
records converted to FORCE and MOMENT records. Output by
SECONVRT.
GEOM3NT GEOM3 GEOM3 transformed for nonlinear transient response analysis.
Output by ST2DYN.
GEOM3S GEOM3 Table of Bulk Data entry images related to static and thermal loads
for the current superelement. Output by SEP2 and SEP2X.
GEOM3T GEOM3 GEOM3 table with new or modified temperatures. Output by
MATMOD option 18.
GEOM3X GEOM3 GEOM3 table related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis. Output by IFP3.
GEOM4 GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity. Output by IFP.
GEOM4* GEOM4 Family of GEOM4 tables for all partitioned superelements defined
in separate Bulk Data sections.
GEOM4CN GEOM4 Updated constraints for 3D contact. Output by NLSOLV.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1575 Glossary
Data Block Glossary
GEOM4EX GEOM4 GEOM4 table containing records which define an external
superelement. Specifically, ASETi and QSETi Bulk Data records.
Output by BDRYINFO.
GEOM4M GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity and updated for
the current p-level. Output by GP0.
GEOM4P GEOM4 Table of Bulk Data entry images related to constraints and updated
for the constraints applied by GMBC, GMSPC, SPC, SPC1, or
SPCD Bulk Data entries. Output by MODGM4.
GEOM4S GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity for the current
superelement. Output by SEP2 and SEP2X.
GEOM4W GEOM4 GEOM4 augmented with dummy SEQSET1 entries to represent the
fluid superelement modes and QSET1 for all other non-fluid
superelement component modes. Output by MODQSET.
GEOM4X GEOM4 GEOM4 table related to axisymmetric conical shell and hydroelastic
Output by IFP3 and IFP4. GEOM4 table augmented with new RBE1
and RBE2 records (because all RBE1 and RBE2 elements are split
so that each one contains only one m-set grid) for ACMS='YES'.
Also augmented with SEQSET1 records for ACMS='YES'. Output
by SEQP.
GETNUMPN Logical. Panel static load computation flag. If TRUE then get
number of panels flag only and do not compute panel static loads.
GEQMAP Table of grid based local equation map indicating which grid resides
on which processors/partitions for domain decomposition. Output
by SEQP.
GLBRSP Matrix of global responses when system cell 297=-1. Output by
SDRP.
GLBRSPDS Global results matrix
GLBTAB Table of global responses when system cell 297=-1. Output by
SDRP.
GLBTABDS Global results correlation table
GLERR Table of global error estimates from previous iteration. Output by
ADAPT.
GLERR1 Table of global error estimates for current iteration. Output by
ADAPT.
GM Multipoint constraint transformation matrix, m-set by
n-set. Output by MCE1.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1576
GMD Multipoint constraint transformation matrix with extra points, m-set
by ne-set. Output by UMERGE1.
GMNE Multipoint constraint transformation matrix, m-set by ne-set.
GMS Multipoint constraint transformation matrix, m-set by s-set.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
Output by FBS.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set. Output by UMERGE1.
GPDCT Table of grid point stress discontinuities for post-processing in the
DBC module. Output by STDCON.
GPDT GPDT Grid point definition table. Output by GP1.
GPECT Grid point element connection table. Output by TA1.
GPECT1 Grid point element connection table for heat transfer analysis.
Output by TAHT.
GPECTDCN GPECT which incorporates combined constraints and design
variables. Output by DSAF.
GPECTF Grid point element connection table for follower force stiffness.
Output by TAFF.
GPFLBL Labels for GPFMAT rows. Output by ILMPGPF.
GPFMAT Matrix of monitor point force data where each column is a subcase
and each row is one component of the monitored forces. Output by
ILMPGPF.
GPFORCE Integer. The number of columns in FENL. If GPFORCE less than or
equal to zero then no GPFORCE or ESE command is present.
GPGK Aerodynamic transformation matrix for loads from the k-set to g-set.
Output by GI.
GPKH Aerodynamic transformation matrix for loads from the k-set to h-set.
GPIK Aerodynamic transformation matrix for loads from the h-set to k-set.
GPKE Matrix of grid point kinetic energies.
GPL GPL External grid/scalar point identification number list. Output by GP1.
GPLD External grid/scalar/extra point identification number list. (GPL
appended with extra point data). Output by DPD.
GPMPF Matrix of grid panel mode participation factors. Output by
MODEPF.
GPSETS Table of grid point sets related to the element plot sets. Output by
PLTSET and SEPLOT.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1577 Glossary
Data Block Glossary
GPSNT Grid point shell normal table. Output by TASNP2.
GPSNTN Grid point shell normal table updated due to the interaction with
RSSCON elements. Output by GP4.
GPSNTS Grid point shell normal table for the current superelement. Output by
SEP2 and TASNP2.
GPSPRT Table of grid point singularity created on the first call to GPSP when
the MPC option is selected on the AUTOSPC Case Control
command and DONSET=0. Output by GPSP.
GPSPRT0 GPSPRT from a previous call to GPSP and required when
DONSET=-1.
GPTT1 Table of grid point temperatures (for transient analysis only). Output
by NLCOMB.
GRIDFMP Integer. Case Control set identification number of fluid grids that
will be output.
GRIDMP Integer. Case Control set identification number for a set of fluid
grids.
GRIDSET Integer. SET Case Control command identification number which
contains a list grid point identification numbers.
GRDRM Permutation matrix. Output by PRESOL.
GS Transformation matrix between symmetric (sine) components and
solution set components. Output by CYCLIC3.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1578
Chapter 3
Name
Chapter 2
Name Description
HARM Table of harmonic indices. Output by CYCLIC1.
HDRLBLi Character. Header with up to 64 characters to be printed and centered
at the top of each page.
HEADCNTL List of integer codes for header print control in the DISUTIL module
under VECPLOT options IOPT=1 or 5. Output by VECPLOT.
HIS HIS Table of design iteration history.
HISADD HIS Table of design iteration history for current design cycle. Output by
DOM12.
HMKT Matrix used to compute hinge moments for each AESURF entry.
Output by ADG.
HOEF1 OEF Table of element fluxes in SORT1 format updated for CHBDYi
elements. Output by SDRHT.
HOES1 Table of element heat flow in SORT1 format combined for linear
and nonlinear elements. Output by SDRHT.
Main Index
1579 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
Ii Inputs to MATMOD and MATPCH module.
IEF OEF Table of element forces due to unit modal displacement in SORT1 or
SORT2 format. Output by SDR2 or SDR3.
IES OES Table of element stresses or strains due to unit modal displacement
in SORT1 or SORT2 format. Output by SDR2 or SDR3.
IFACT Interpolation factor vector (NV rows). Output by NDINTERP.
IFD Matrix of nonlinear element forces at constrained points at the output
time steps. Output by NLTRD and NLTRD2.
IFG Matrix of nonlinear element forces for the g-set at the output time
steps. Output by NLTRD.
IFP Matrix of element forces at the previous time step. Output by
NLSOLV.
IFPDB Table data block with IFP module table attributes.
IFS Matrix of total element forces and their rate of change. Output by
NLTRD2 and NLSOLV.
IFST Matrix of nonlinear element forces at constrained points at the output
time steps (for transient analysis only). Output by NLSOLV.
IMAT Matrix containing imaginary part of CMAT. Output by MATMOD
option 34.
IMATG Pesudo identity g-set matrix.
INDTA Table of element stress/strain or force item code overrides.
INVEC Starting vector(s).
IQG OQG Table of single point forces of constraint due to unit modal
displacement in SORT1 or SORT2 format. Output by SDR2 or
SDR3.
IUG OUG Table of displacements due to unit modal displacement in SORT1 or
SORT2 format. Output by SDR2 or SDR3.
IUNITSOL Integer. If IUNITSOL=0, then trim solution is being supplied. If
IUNITSOL>0, then IUNITSOL'th unit solution is being supplied.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1580
Chapter 3
Name
Chapter 2
Name Description
K2DD Stiffness matrix contribution from the K2PP Case Control command
and reduced to the d-set. In frequency response analysis, K2DD may
also include structural damping effects.
K2GG Matrix defined on DMIG Bulk Data entries and referenced by the
K2GG Case Control command. Output by MTRXIN.
K2PP Matrix defined on DMIG Bulk Data entries and referenced by the
K2PP Case Control command. Output by MTRXIN.
K4AA Structural damping matrix in a-set or d-set.
K4KK Structural damping matrix in cyclic components. Output by
CYCLIC3.
K4XX Structural damping matrix in any set. Usually h-set or
d-set in FRRD1.
KAA Stiffness matrix in a-set or d-set.
KAAL Element stiffness matrix for linear elements only reduced to a-set.
KBDD Tangential stiffness in d-set.
KCVDD* Family of gyroscopic matrices.
KCVPP* Family of gyroscopic matrices - p-set.
KDD Stiffness matrix for the d-set, linear elements only.
KDDICT KDICT KDELM dictionary table. Output by EMG.
KDELM KELM Table of element matrices for differential stiffness. Output by EMG.
KDICT KDICT KELM dictionary table. Output by EMG.
KDICT1 KDICT KELM1 dictionary table. Output by GNFM.
KDICTDCN KELM dictionary table. which incorporates combined constraints
and design variables. Output by DSAF.
KDICTDS Perturbed element stiffness matrix dictionary table. If CDIF='YES'
then this is the forward perturbed element matrix dictionary. Output
by EMG.
KDICTNL KDICT KELMNL dictionary table. Output by EMG.
KDICTX KDICT Baseline element stiffness matrix dictionary table for
h-elements or p-elements. Output by EMG.
KELM KELM Table of element matrices for stiffness, heat conduction, differential
stiffness, or follower stiffness. Output by EMG.
KELM1 KELM Table of element matrices for incremental stiffness. Output by
GNFM.
Main Index
1581 Glossary
Data Block Glossary
KELMDCN KELM Table of element matrices for stiffness, heat conduction, differential
stiffness, or follower stiffness which incorporates combined
constraints and design variables. Output by DSAF.
KELMDS KELM Table of perturbed element stiffness matrices. If CDIF='YES' then
this is the forward perturbed element matrix dictionary. Output by
EMG.
KELMNL KELM Table of element matrices for stiffness for nonlinear elements.
KFEFE Tangential stiffness in fe-set.
KFHH Fluid partition of modal stiffness matrix KHH.
KFRIC Frictional stiffness for 3D contact. Output by NLSOLV.
KFS Stiffness matrix partition (f-set by s-set) from KNN.
KGG Stiffness matrix in g-set.
KGG1 Stiffness matrix in g-set with general elements. Output by SMA3.
KGGNL Stiffness (or heat conduction) matrix in g-set for material nonlinear
elements only.
KGGNL1 Conduction matrix in g-set for material nonlinear elements only and
updated for radiation. Output by RMG2.
KGGT Total structural stiffness matrix in g-size (sum of linear, nonlinear
and differential matrices).
KHH Generalized (modal) stiffness matrix.
KHH1 Modified generalized (modal) stiffness matrix. Output by FA1.
KKK Stiffness matrix in cyclic components. Output by CYCLIC3.
KLL Stiffness matrix reduced to the l-set.
KLR Stiffness matrix partition (l-set by r-set) from KTT.
KMM Stiffness matrix in m-set (partition of KGG).
KNN Stiffness matrix in n-set; after multipoint constraint reduction.
KOO Stiffness matrix partitioned to the o-set from KFF.
KPP Stiffness matrix for the p-set, linear elements only.
KRDD Combined linear and material nonlinear stiffness matrix in the d-set.
KRFGG Stiffness matrix due to follower rotational forces in g-set. Output by
EMAKFR.
KRR Stiffness matrix partition (r-set by r-set) from KTT.
KRZX Matrix of restrained dimensional elastic derivatives.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1582
KSAZX Matrix of dimensional rigid stability derivatives that includes the
effect of splines.
KSGG S-set by f-set matrix and s-set by s-set partitions of the material
nonlinear stiffness matrix and expanded to g-set size.
KSS Stiffness matrix partition (s-set by s-set) from KNN.
KTPP Tangential Stiffness of p-set.
KTTP Sparse partial decomp update matrix.
KTTS KTTP converted to standard matrix format. Output by MATMOD
option 46.
KUX Matrix of stiffness multiplied by displacement or eigenvectors.
KVAL Table of harmonic indices for analysis. Output by CYCLIC1.
KXWAA Stiffness matrix for the a-set, row-ordered in external grid id
sequence and divided by WTMASS.
KXX Stiffness matrix in any set. Usually v-set in READ. Usually h-set or
d-set in CEAD, FRRD1, FRRD2, TRD1, and TRD2.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1583 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
L Lower triangular decomposition factor. Output by MATMOD option
21.
LAJJT Lower triangular decomposition factor matrix of AJJT.
LAM1DD Lower triangular factor of the dynamic tangential matrix in the d-set.
LAMA LAMA Normal modes eigenvalue summary table. Output by READ,
LANCZOS, MODACC, and UEIGL.
LAMA* LAMA Family of normal modes eigenvalue summary tables.
LAMA1 LAMA Normal modes eigenvalue summary table updated for mode
tracking. Output by MODTRK.
LAMAF LAMA Normal modes eigenvalue summary table for the fluid portion of the
model.
LAMAM Matrix (diagonal) of eigenvalues for subspace iteration. Output by
DSAH.
LAMAS LAMA Normal modes eigenvalue summary table for the structural portion
of the model. Matrix (diagonal) of eigenvalue shifts for subspace
iteration. Output by DSAH.
LAMASEL LAMA table containing only those modes defined by MODSELT.
Output by GKAM.
LAMAX LAMA Modified LAMA table. Output by LAMX.
LAMMAT Diagonal matrix containing eigenvalues on the diagonal. Output by
READ, LANCZOS, and UEIGL.
LAO Sparse partial decomposition factor when KSYM=3. Output by
DCMP.
LBTAB Table of eigenvalues and generalized masses for retained buckling
eigenvalue responses. Output by DSAH.
LCDVEC Partitioning vector for load case deletion. The row size is the same
number of columns in UGX and ones for columns which are retained
in UGX1. LCDVEC is intended for partitioning of analysis results
related to inertia relief and SPCforces. Output by DSAD.
LCOLLBLi Character. Label with up to 32 characters to be printed left-justified
in upper left corner of each page.
LCPHL Left-handed complex eigenvector matrix in the l-set. Output by
CEAD.
LCPHP Left-handed complex eigenvector matrix in the p-set.
LCPHX Left-handed complex eigenvector matrix in the d-set or h-set. Output
by CEAD.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1584
LD Lower triangular factor/diagonal. Output by DECOMP and DCMP.
LFTAB Table of eigenvalues and generalized masses for retained normal
mode eigenvalue responses. Output by DSAH.
LGPART Same as SPCPART except LGPART includes grid points not
connected to any element. Output by SEQP.
LISET Integer. Size of interference js-set extracted from the AEBGPTI
table. Output by MTRXIN.
LJSET Integer. Size of js-set extracted from the AEBGPTJ table. Output by
MTRXIN.
LKSET Integer. Size of ks-set extracted from the AEBGPTK table. Output
by MTRXIN.
LLL Lower triangular factor/diagonal for the l-set from KLL.
LLLT Lower triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
LMAT Normal modes eigenvalue summary table converted to a matrix.
Output by LAMX.
LMTROWS Integer. Number of Lagrange Multipliers appended to the A matrix.
These rows are excluded from the internal reordering in the DCMP
module.
LMPF Matrix of fluid force to fluid mode participation factors. Output by
MODEPF.
LOCVEC Vector containing grid locations in the basic coordinate system.
LOO Lower triangular factor/diagonal for the o-set from KOO. Output by
DCMP.
LSCM Schur complement matrix based on internal partitioning of A.
Output by DCMP.
LSEQ Resequencing matrix based on internal resequencing of KLL.
Output by DCMP and DECOMP.
LTF Lower triangular file of the solution matrix ULNT. Output by
NLTRD2 and NLSOLV.
LVTAB Table of eigenvalues and generalized masses for retained normal
mode eigenvector responses for all subcases. Output by DSAH.
LVTABI Table of eigenvalues and generalized masses for retained normal
mode eigenvector responses per subcase. Output by DSAH.
LXX Lower triangular factor/diagonal of shifted stiffness matrix.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1585 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
M2DD Mass matrix contribution from the M2PP Case Control command
and reduced to the d-set.
M2GG Matrix defined on DMIG Bulk Data entries and referenced by the
M2GG Case Control command. Output by MTRXIN.
M2PP Matrix defined on DMIG Bulk Data entries and referenced by the
M2PP Case Control command. Output by MTRXIN.
M9I Table of the nine mass invariants. Output by ADAMSMNF.
MA Rigid body mass matrix for the a-set. Output by EFFMAS.
MAA Mass matrix in a-set or d-set.
MABXWGG Mass matrix for the a-set, expanded to g-set, transformed to the basic
coordinate system, row-ordered in external grid identification
number sequence, and divided by WTMASS.
MAPS Superelement upstream to downstream boundary coordinate system
transformation matrix output by GENTRAN. Superelement
boundary transformation matrix for secondary superelements
(mirror, identical, and repeated), boundary resequencing and
releases output by SEP2 and SEP2X.
MAPS* Family of MAPS (superelement upstream to downstream boundary
coordinate system, secondary (mirror, identical, and repeated), and
release transformation matrix).
MAR Table of virtual mass element areas. Output by MGEN.
MAT Matrix. Output by MATGEN.
MATi Input matrices.
MAT1 Square symmetric matrix 1 to be partitioned.
MAT1N Local filtered matrix 1. Output by PRESOL.
MAT2 Square symmetric matrix 2 to be partitioned.
MAT2N Local filtered matrix 2. Output by PRESOL.
MATIi Matrices defined on DMIJI Bulk Data entries. Output by MTRXIN.
MATGi Matrices defined on DMIG Bulk Data entries and intended for the g-
set. Output by MTRXIN.
MATJi Matrices defined on DMIJ Bulk Data entries. Output by MTRXIN.
MATKi Matrices defined on DMIK Bulk Data entries. Output by MTRXIN.
MATNAMi Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI
Bulk Data entries.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1586
MATPi Matrices defined on DMIG Bulk Data entries and intended for the p-
set. Output by MTRXIN.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary,
heat transfer radiation, virtual mass, DMIG, and DMIAX entries.
Output by IFP and IFP4.
MATPOOLS MATPOOL table for the current superelement. Output by SEP2X.
MATPOOLX MATPOOL table related to hydroelastic analysis. Output by IFP4.
MATS Any matrix on slave processors.
MATM Any matrix on master processor. Output by DISUTIL.
MBODY Body table for p-element analysis. Output by GP0.
MBSP Updated mass matrix (s-set)
MCEIGCC Logical. Modal complex eigenvalue analysis subcase flag. Set to
TRUE if at least one ANALYSIS=MCEIG command was found in
CASECC and CASECEIG is specified in the output list. Output by
MDCASE.
MCHI Matrix relating displacements to source strengths. Output by
MGEN.
MCHI2 Secondary matrix relating displacements to source strengths. Output
by MGEN.
MDD Mass (or radiation) matrix for the d-set
MDICT MELM dictionary table. Output by EMG.
MDUGNI Matrix of incremental displacements with respect to the last
converged step (UI - U0), to be used for LANGLE=3 or for the new
CQUADR/CTRIAR elements. Output by NLITER.
MEA Matrix of element forces per unit motion of the a-set.
MEDGE Edge table for p-element analysis. Output by GP0.
MEF Matrix form of element force output table. Output by DRMH1 and
DRMS1.
MEM Modal effective mass matrix. Output by EFFMAS.
MEMF Modal effective mass fraction table. Output by EFFMAS.
MES Matrix form of element stress or strain output table. Output by
DRMH1 and DRMS1.
MELM KELM Table of element mass matrices. Output by EMG.
MESH Mesh type for aerodynamic or structural components: 'AERO' or
'STRU'.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1587 Glossary
Data Block Glossary
MESTNL Nonlinear element summary table at current step. Output by
NLITER, NLSOLV, and NLTRD2.
MESTNL0 Initial nonlinear element summary table at each STEPcase. Output
by NLSOLV.
MEW Modal effective weight matrix. Output by EFFMAS.
MFACE Face table for p-element analysis. Output by GP0.
MFEFE Mass (or radiation) matrix for the fe-set.
MFHH Fluid partition of modal mass matrix MHH.
MGG Mass or radiation matrix in g-size.
MGG* Family of MGG (g-set mass) matrices.
MGGCOMB Combined mass matrix. Output by MASSCOMB.
MHH Generalized (modal) mass matrix
MHH1 Modified generalized (modal) mass matrix. Output by FA1.
MI Modal mass matrix. Output by READ and LANCZOS.
Mi Matrix data block. Output by INPUTT4 and input to MATPRN and
OUTPUT4.
MIDLIS Table of pairs of user-supplied material property identification
numbers (MIDs) and internal baseline MIDs. Output by DSABO.
MKK Mass matrix in cyclic components. Output by CYCLIC3.
MKLIST Table of Mach number and reduced frequency pairs. Output by
GETMKL.
MKNRGY Matrix of modal kinetic energy. Output by MODENRGY.
MLAM Matrix relating element forces to source strengths. Output by
MGEN.
MLAM2 Secondary matrix relating element forces to source strengths. Output
by MGEN.
MLL Mass matrix reduced to the l-set.
MLR Mass matrix partition (l-set by r-set) from MTT.
MMCDB Table of MAXMIN(DEF) specifications. Output by IFP1.
MMP Mass matrix (m-set by p-set)
MNRGYMTF Matrix of modal energy values for all EFM superelements for all
bands.
MOA Mass matrix partition (o-set by a-set) from MFF.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1588
MODRPR Table indicating the number of initial responses per response type
per mode. Output by DSAD.
MODRPRG Table indicating the number of retained responses per response type
per mode.
MODRSP Table of eigenvector response counts by subcase and mode. Output
by DOPR3.
MODRSPR MODRSP for retained frequencies. Output by DSAD.
MODSELT Table of mode numbers selected by the combination of
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. If FLUID=TRUE,
then MODSELT is based on the MODESELECT(FLUID) Case
Control command and user parameters LMODESFL, LFREQFL,
and HFREQFL. Output by GKAM.
MODSELT1 Subset of MODSELT as selected by the MODALSE and
MODALKE Case Control commands. Output by MODENRGY.
MODSELTF Table of mode numbers selected by the combination of the
MODESELECT(FLUID) Case Control command and user
parameters LMODESFL, LFREQFL, and HFREQFL. Output by
GKAM.
MODSELTS Table of mode numbers selected by the combination of the
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. Output by GKAM.
MODSELV Partitioning vector equivalent of MODSELT. Output by GKAM.
MOFPi Matrix form of the i-th output table. Output by DRMH1 and
DRMS1.
MON Merged monitor table. Output by MRGMON.
MONi Monitor tables
MONDISP Monitor points table for displacements. Output by MAKMON.
MONITOR Structural monitor point table. Output by MAKAEMON and
MAKMON.
MOO Mass matrix partitioned to the o-set from KFF.
MP2S Table of MONPNT2 responses at trim.
MPAER Elastic restrained loads on aerodynamic monitor points at trim.
MPAERP Total elastic restrained loads on aerodynamic monitor points at trim
due to static applied loads.
MPAERV Elastic restrained monitor point loads on aerodynamic model
Chapter 3
Name
Chapter 2
Name Description
Main Index
1589 Glossary
Data Block Glossary
MPAEUV Elastic unrestrained monitor point loads on aerodynamic model
MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim.
MPART Partitioning vector based on a permutation vector. Output by
MATGEN option 13.
MPARV Rigid monitor point loads on aerodynamic model
MPFEM Modal participation factors for effective mass. Output by EFFMAS.
MPFMAP Table describing content of mode participation factor matrices.
Output by MODEPF.
MPJN2O Mapping matrix to map j-set data from new order to old order.
Output by APD.
MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry
images. Output by VDR.
MPP Mass matrix in the p-set
MPSER Elastic restrained loads on structural monitor points at trim
(excluding inertial loads and static applied loads).
MPSERP Elastic restrained loads on structural monitor points due to static
applied loads.
MPSERV Elastic restrained monitor point loads on structural model
MPSEUV Elastic unrestrained monitor point loads on structural model
MPSIR Inertial loads on structural monitor points at trim.
MPSIRV Inertial restrained monitor point loads on structural model
MPSIUV Inertial unrestrained monitor point loads on structural model
MPSR Rigid aerodynamic loads on structural monitor points at trim
(excluding inertial loads and static applied loads).
MPSRP Rigid loads on structural monitor points due to static applied loads.
MPSRV Rigid splined monitor point loads on structural model
MPT MPT Table of Bulk Data entry images related to material properties.
Output by IFP and IFP6.
MPTC MPT Copy of MPT except MAT8 records are replaced by equivalent
MAT2 records. Output by IFP6, CMPZPR, and DSTA.
MPTN MPT Updated (optimized) MPT. Output by DOM11.
MPTNT MPT MPT transformed for nonlinear transient response analysis. Output
by ST2DYN.
MPTS MPT Table of Bulk Data entry images related to material properties for the
current superelement. Output by SEP2 and SEP2X.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1590
MPTT MPT MPT updated for topology optimization. Output by IFP10.
MPTTC MPT MPT table updated for thermal control mechanisms. Output by
NLTRD2.
MPTX MPT MPT with design variable perturbations. Output by DSABO. Copy
of MPT except MATHP records are updated to include referenced
TABLES1 Bulk Data entry information. Output by IFP8.
Output by MKMNTIFP: MPT updated to track monitor points
Output by MODGM2: Copy of MPT updated for converted
CSHEAR elements.
MQE* Family of superelement modal mass matrices.
MQG Matrix form of single or multipoint forces-of-constraint output table.
Output by DRMH1 and DRMS1.
MR Rigid body mass matrix (r-set by r-set). Output by RBMG4.
MRR Stiffness matrix partition (r-set by r-set) from MTT.
MSNRGY Matrix of modal strain energy. Output by MODENRGY.
MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to
the new mode numbering. Output by MODTRK.
MUG Matrix form of displacement output table. Output by DRMH1 and
DRMS1.
MUGNI Displacement (or temperature) matrix for stiffness (or heat
conduction) update. Output by NLITER.
MULNT Solution matrix from nonlinear transient response analysis in the d-
set from the previous subcase. Output by NLTRD2.
MUPN Solution matrix from nonlinear response analysis in the p-set for
matrix update. Output by NLSOLV.
MUX Matrix of mass multiplied by displacements or eigenvectors.
MXWAA Mass matrix for the a-set, row-ordered in external grid id sequence
and divided by WTMASS.
MXX Mass matrix in any set. Usually v-set in READ. Usually h-set or d-
set in CEAD, FRRD1, FRRD2, TRD1, and TRD2.
MZZ Generalized mass matrix based on PHZ.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1591 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
NAMEi Matrices defined on DMIG Bulk Data entries. Output by MTRXIN.
NEWDBi Input table in Version 69 (or greater) format. Output by MAKENEW.
NEWEPT EPT updated from the NSML and NSML1 records. Output by
NSMEPT.
NFDICT Nonlinear element energy/force index table. Output by TA1.
NLFT Nonlinear Forcing function table. Output by DPD.
NLRSMAP Nonlinear restart map from the restart step. Output by NLRSLOOP.
NLRSMAP0 NLRSMAP from the previous run.
NORTAB Table containing fluid face and the maximum of eight structural
grids which lie within the acoustic face. Output by GP5.
NSMEST NSM Bulk Data entries in EST format. Output by TA1.
NWCASE CASECC associated with beta response. Output by DOPR1.
NWEDOM EDOM modified for random design variables. Output by DOPR1.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1592
Chapter 3
Name
Chapter 2
Name Description
OAG OUG Table of accelerations in SORT1 or SORT2 format. Output by SDR2.
OAG1VU OUG Table of accelerations in SORT1 format for view grids. Output by
SDRP.
OAG2 OUG Table of accelerations in SORT2 format. Output by SDR3.
OAGATO2 OUG Table of accelerations in SORT2 format for the autocorrelation
function. Output by RANDOM.
OAGCRM2 OUG Table of accelerations in SORT2 format for the cross correlation
function. Output by RANDOM.
OAGNO2 OUG Table of accelerations in SORT2 format for the NO function. Output
by RANDOM.
OAGPSD2 OUG Table of accelerations in SORT2 format for the PSD function.
Output by RANDOM.
OAGRMS2 OUG Table of accelerations in SORT2 format for the RMS function.
Output by RANDOM.
OBJTAB OBJTAB Design objective table for a given analysis type and superelement.
Objective attributes with retained response identification number.
Output by DOPR3.
OBJTABX Design objective table for a given analysis type and superelement
with respsect to RESP12X. Output by DOPR3.
OBJTBG OBJTAB Design objective table. Objective attributes with retained response
identification number.
OBJTBM Merged OBJTBR associated with unresolved DRESP2 and DRESP3
records
OBJTBR OBJTAB Table of design objective attributes with retained response
identification number. Output by DSAD.
OBTABXE OBJTABM with resolved DRESP2 and DRESP3 records. Output by
DSADX.
OCCORF Output table of cross-correlation functions. Output by RANDOM.
OCEIG Complex eigenvalue extraction report. Output by CEAD.
OCPSDF Output table of cross-power-spectral-density functions. Output by
RANDOM.
OEDE1 OEE Elemental energy loss. Output by GPFDR.
OEDS1 OES Table of element stress discontinuities. Output by STDCON.
OEEATO2 OEE Table of element strains in SORT2 format for the autocorrelation
function. Output by RANDOM.
Main Index
1593 Glossary
Data Block Glossary
OEECRM2 OEE Table of element strains in SORT2 format for the cross correlation
function. Output by RANDOM.
OEENO2 OEE Table of element strains in SORT2 format for the NO function.
Output by RANDOM.
OEEPSD2 OEE Table of element strains in SORT2 format for the PSD function.
Output by RANDOM.
OEERMS2 OEE Table of element strains in SORT2 format for the RMS function.
Output by RANDOM.
OEF OEF Table of element forces in SORT1 or SORT2 format. Output by
DDRMM.
OEF1 OEF Table of element forces (or fluxes) in SORT1 format. Output by
SDR2 or DRMH3.
OEF1A OEF Table of element forces in SORT1 format for the composite elements
only. Output by SDR2.
OEF1AA OEF Table of element forces in SORT1 format for the non-composite
elements only. Output by SDRCOMP.
OEF1DS OEF Table of element forces, excluding non-composite elements, in
SORT1 format for design responses.
OEF1VU OEF Table of element forces in SORT1 format for view elements. Output
by SDRP.
OEF1X OEF Table of element forces in SORT1 format updated for PLOAD1
loads and intermediate station output. Output by SDRX and
SDRXD.
OEF2 OEF Table of element forces in SORT2 format.
OEFATO2 OEF Table of element forces in SORT2 format for the autocorrelation
function. Output by RANDOM.
OEFCRM2 OEF Table of element forces in SORT2 format for the cross correlation
function. Output by RANDOM.
OEFD1M OEF Table of element forces in SORT1 format for design responses and
appended for all normal modes solutions.
OEFDSN OEF Table of element forces, excluding non-composite elements, in
SORT1 format for the perturbed configuration.
OEFDSNM OEF Table of element forces from normal modes analysis for the
perturbed configuration.
OEFIT OEF Table of composite element failure indices. Output by SDRCOMP.
OEFITDS OEF Table of composite element failure indices for design responses.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1594
OEFITDSN OEF Table of composite element failure indices for the perturbed
configuration.
OEFNL1 OEF Table of nonlinear element fluxes in SORT1 format. Output by
SDR2.
OEFNO2 OEF Table of element forces in SORT2 format for the NO function.
Output by RANDOM.
OEFPSD2 OEF Table of element forces in SORT2 format for the PSD function.
Output by RANDOM.
OEFRMS2 OEF Table of element forces in SORT2 format for the RMS function.
Output by RANDOM.
OEIG Real eigenvalue extraction report. Output by READ.
OEKE1 Elemental kinetic energy. Output by GPFDR.
OELOPDSN Table of element forces on adjacent elements.
OELOP1DS Table of element-oriented forces for design responses.
OEP Table of element pressures due to virtual mass in SORT1 or SORT2
format. Output by MDATA.
OES OES Table of element stresses or strains in SORT1 or SORT2 format.
Output by DDRMM.
OES1 OES Table of element stresses or strains in SORT1 format. Output by
SDR2 or DRMH3. OES1A Table of element strain/curvatures in
SORT1 format for the composite elements only. Output by SDR2.
OES1C OES Table of composite element stresses or strains in SORT1 format.
Output by SDRCOMP.
OES1CDS OES Table of composite element stresses in SORT1 format for design
responses.
OES1DS OES Table of element stresses in SORT1 format for design responses.
OES1M OES Element stress or strain table in SORT1 format in the element's
material coordinate system defined on the MAT1 entry. Output by
CURV.
OES1G OES Grid point stress or strain table in SORT1 format and interpolated
from the centroidal stress table, OES1M. Output by CURV.
OES1VU OES Table of element stresses in SORT1 format for view elements.
Output by SDRP.
OES1X OES Table of element stresses in SORT1 format updated for PLOAD1
loads and intermediate station output. Output by SDRX and
SDRXD. Table of linear and nonlinear element stresses in SORT1
and linear element format. Output by MERGEOFP.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1595 Glossary
Data Block Glossary
OES2 OES Table of element stresses or strains in SORT2 format.
OES2GX OES Table of grid point stresses in SORT2 format. Output by
CURVPLOT.
OESATO2 OES Table of element stresses in SORT2 format for the autocorrelation
function. Output by RANDOM.
OESCDSN OES Table of composite element stresses in SORT1 format for the
perturbed configuration.
OESCRM2 Table of element stresses in SORT2 format for the cross correlation
function. Output by RANDOM.
OESD1M Table of element stresses in SORT1 format for design responses and
appended for all normal modes solutions.
OESDSN OES Table of element stresses in SORT1 format for the perturbed
configuration
OESDSNM Table of element stresses from normal modes analysis for the
perturbed configuration
OESNL1 OES Table of nonlinear element stresses in SORT1 format. Output by
NLTRD, NLTRD2, NLSOLV, and SDRNL.
OESNLB1 OES Table of slideline contact element stresses in SORT1 format. Output
by NLTRD2, NLSOLV, and SDRNL.
OESNLH Table of element heat flow in SORT1 format for nonlinear elements.
OESNLXR OES Table of nonlinear element stresses in SORT1 format and appended
for all subcases (OESNLX from SDRNL).
OESNO2 OES Table of element stresses in SORT2 format for the NO function.
Output by RANDOM.
OESPSD2 OES Table of element stresses in SORT2 format for the PSD function.
Output by RANDOM.
OESRMS2 OES Table of element stresses in SORT2 format for the RMS function.
Output by RANDOM.
OFMPF2M Table of fluid modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OFPE Element data recovery table in SORT1 or SORT2 format.
OFPES Filtered and sorted element data recovery table. Output by
STRSORT.
OFPi Output table suitable for processing by the OFP module.
OFPi1 Output table in SORT1 format usually created by, but not limited to,
the SDR2 module.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1596
OFPi2 Output table in SORT2 format.
OFPiX Output table in SORT2 or SORT1 format. Output by SDR3.
OGDS1 Table of grid point stress discontinuities. Output by STDCON.
OGPFB1 OGF Table of grid point forces. Output by GPFDR.
OGPFB1DS OGF Table of grid point forces for design responses.
OGPFDSN OGF Table of grid point forces for the perturbed configuration.
OGPKE1 Table of grid point kinetic energies in SORT1 format. Output by
SDR2.
OGPLYFI Table of global ply failure indices. Output by SDRCOMP.
OGPLYSS Table of global ply stresses/strains. Output by SDRCOMP.
OGPMPF2M Table of panel grid modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OGPSR Table of global ply strength ratios. Output by SDRCOMP.
OGPWG Grid point weight generator table in weight units. Output by GPWG
or VECPLOT (option 7).
OGPWG* Family of superelement grid point weight generator tables
OGPWGBW Grid point weight generator table transformed to the basic coordinate
system divided by WTMASS.
OGS1 OGS Table of grid point stresses or strains in SORT1 format. Output by
GPSTR2.
OGSTR1 OGS Table of grid point strains in SORT1 format.
Oi Outputs of MATMOD module.
OINT p-element output control table. Contains OUTPUT Bulk Data
entries. Output by IFP.
OINTDS p-element output control table for constrained elements. Output by
DOPR3.
OINTDSF p-element output control table for the perturbed configuration.
Output by DSAH.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list. Output by
CEAD, READ, TRLG, and FRLG.
OL1 In MODACC, OL truncated by the OFREQ or OTIME Case Control
command. In MODENRGY, subset of OL selected by the
MODALSE and MODALKE Case Control commands. Output by
MODACC and MODENRGY.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1597 Glossary
Data Block Glossary
OLDDBi Output table in pre-Version 69 format. Output by MAKEOLD.
OLF Nonlinear static load factor list.
OLMPF2M Table of load modal participation factors by natural modes in SORT2
format. Output by RANDOM.
OMAT1 MAT in OFP-suitable table in SORT1 format. Output by MATOFP.
OMCF1 Table of modal contribution factors in SORT1 format. Output by
MCFRAC.
OMM Table of maximum/minimum in SORT1 or SORT2 format. Output
by SDR2.
ONRGD1M OEE Table of element strain energies for design responses and appended
for all normal modes solutions.
ONRGDSNM OEE Table of element strain energies from normal modes analysis for the
perturbed configuration.
ONRGY1 OEE Table of element strain energies and energy densities. Output by
GPFDR.
ONRGYDS OEE Table of element strain energies in SORT1 format for design
responses. Output by GPFDR.
ONRGYDSN OEE Table of element strain energies and energy densities in SORT1
format for design responses for the perturbed configuration.
OPG1 OPG Table of applied loads in SORT1 format. Output by SDR2.
OPG2 OPG Table of applied loads in SORT2 format.
OPG2X OPG Table of applied loads in SORT2 format. Output by CURVPLOT.
OPGATO2 OPG Table of applied loads in SORT2 format for the autocorrelation
function. Output by RANDOM.
OPGCRM2 OPG Table of applied loads in SORT2 format for the cross correlation
function. Output by RANDOM.
OPGNO2 OPG Table of applied loads in SORT2 format for the NO function. Output
by RANDOM.
OPGPSD2 OPG Table of applied loads in SORT2 format for the PSD function.
Output by RANDOM.
OPGRMS2 OPG Table of applied loads in SORT2 format for the RMS function.
Output by RANDOM.
OPLYSR Table of ply strength ratios. Output by SDRCOMP.
OPMPF2M Table of panel modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1598
OPNL1 Table of nonlinear loads in SORT1 format for the h-set or d-set.
Output by VDR.
OPTPRM OPTPRM Table of optimization parameters.
OPTPRMG OPTPRM Table of optimization parameters.
OPTNEW Updated table of optimization parameters. Output by DOM12.
OQG OQG Table of single or multipoint forces-of-constraint in SORT1 or
SORT2 format. Output by DDRMM.
OQG1 OQG Table of single or multipoint forces-of-constraint in SORT1 format.
Output by SDR2 or DRMH3.
OQG1DS OQG Table of single point forces-of-constraint in SORT1 format for
design responses.
OQG2 OQG Table of single point forces of constraint in SORT2 format.
OQG2X OQG Table of single point forces of constraint in SORT2 format. Output
by CURVPLOT.
OQGATO2 OQG Table of single point forces of constraint in SORT2 format for the
autocorrelation function. Output by RANDOM.
OQGCRM2 OQG Table of single point forces of constraint in SORT2 format for the
cross correlation. Output by RANDOM.
OQGDSN OQG Table of single forces-of-constraint in SORT1 format for design
responses for the perturbed configuration.
OQGNO2 OQG Table of single point forces of constraint in SORT2 format for the
NO function. Output by RANDOM.
OQGPSD2 OQG Table of single point forces of constraint in SORT2 format for the
PSD function. Output by RANDOM.
OQGRMS2 OQG Table of single point forces of constraint in SORT2 format for the
RMS function. Output by RANDOM.
OQMATO2 OQG Table of multipoint forces of constraint in SORT2 format for the
autocorrelation function. Output by RANDOM.
OQMCRM2 OQG Table of multipoint forces of constraint in SORT2 format for the
cross correlation function. Output by RANDOM.
OQMG OQG Table of multipoint forces-of-constraint in SORT1 or SORT2 format.
Output by SDR2.
OQMG2 OQG Table of multipoint forces of constraint in SORT2 format.
OQMNO2 OQG Table of multipoint forces of constraint in SORT2 format for the NO
function. Output by RANDOM.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1599 Glossary
Data Block Glossary
OQMPSD2 OQG Table of multipoint forces of constraint in SORT2 format for the
PSD function. Output by RANDOM.
OQMRMS2 OQG Table of multipoint forces of constraint in SORT2 format for the
RMS function. Output by RANDOM.
OSMPF2M Table of structural modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OSTR OES Table of element stresses in SORT1 or SORT2 format. Output by
SDR2.
OSTR1CDS OEE Table of composite element strains in SORT1 format for design
responses.
OSTR1DS OEE Table of element strains in SORT1 format for design responses.
OSTR1G OEE Table of grid point strains in SORT1 format. Output by CURV.
OSTR1VU OEE Table of element strains in SORT1 format for view elements. Output
by SDRP.
OSTR1X OES Table of element strains in SORT1 format augmented with strains for
1-D elements. Output by SDRX and SDRXD.
OSTR2 OEE Table of element strains in SORT2 format.
OSTR2GX OEE Table of grid point strains in SORT2 format. Output by CURVPLOT.
OSTRCDSN OEE Table of composite element strains in SORT1 format for the
perturbed configuration.
OSTRD1M OES Table of element strains in SORT1 format for design responses and
appended for all normal modes solutions.
OSTRDSN OEE Table of element strains in SORT1 format for the perturbed
configuration
OSTRDSNM OES Table of element strains from normal modes analysis for the
perturbed configuration.
OTMT Transpose of the output transformation matrix. Each column of the
matrix will be associated with a single ILMP (and labeled in
RLABEL). The rows will be the partition of g-set size dofs which are
contributing (CP defined). Ouptut by ILMP2.
OUG OUG Table of displacements in SORT1 or SORT2 format. Output by
DDRMM.
OUG1 OUG Table of displacements in SORT1 format. Output by SDR2 or
DRMH3.
OUG1DS OUG Table of displacements in SORT1 format for design responses.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1600
OUG1VU OUG Table of displacements in SORT1 format for view grids. Output by
SDRP.
OUG2 OUG Table of displacements in SORT2 format.
OUG2X OUG Table of displacements in SORT2 format. Output by CURVPLOT.
OUGATO2 OUG Table of displacements in SORT2 format for the autocorrelation
function. Output by RANDOM.
OUGCRM2 OUG Table of displacements in SORT2 format for the cross correlation
function. Output by RANDOM.
OUGD1M OUG Table of displacements in SORT1 format for design responses and
appended for all normal modes solutions.
OUGDSN OUG Table of displacements in SORT1 format for design responses for the
perturbed configuration.
OUGDSNM OUG Table of eigenvectors for design responses for the perturbed
configuration.
OUGNO2 OUG Table of displacements in SORT2 format for the NO function.
Output by RANDOM.
OUGPSD2 OUG Table of displacements in SORT2 format for the PSD function.
Output by RANDOM.
OUGRMS2 OUG Table of displacements in SORT2 format for the RMS function.
Output by RANDOM.
OUTVEC Last vector block (Lanczos only). Output by READ.
OUXY1 OUG Table of displacements in SORT1 format for h-set or
d-set. Output by VDR.
OVG Table of aeroelastic x-y plot data for V-g or V-f curves. Output by
FA2.
OVG OUG Table of velocities in SORT1 or SORT2 format. Output by SDR2.
OVG1VU Table of velocities in SORT1 format for view grids. Output by
SDRP.
OVG2 Table of velocities in SORT2 format.
OVGATO2 Table of velocities in SORT2 format for the autocorrelation function.
Output by RANDOM.
OVGCRM2 Table of velocities in SORT2 format for the cross correlation
function. Output by RANDOM.
OVGNO2 Table of velocities in SORT2 format for the NO function. Output by
RANDOM.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1601 Glossary
Data Block Glossary
OVGPSD2 Table of velocities in SORT2 format for the PSD function Output by
RANDOM.
OVGRMS2 Table of velocities in SORT2 format for the RMS function. Output
by RANDOM.
OXRESP Table of response spectra in SORT2 format. Output by RSPEC.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1602
Chapter 3
Name
Chapter 2
Name Description
P2G Matrix defined on DMIG Bulk Data entries and referenced by the
P2G Case Control command. Output by MTRXIN.
PA Static load matrix reduced to the a-set. Output by SSG2.
PA* Family of static load matrices (PA) applied on the boundary (a-set)
of all upstream superelements.
PAK Aerodynamic forces at aerodynamic boxes.
PANSLT Panel static load table. Output by GP5.
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees-of-freedom which were eliminated in the partition to obtain
KXX, etc. Required for maximum efficiency during symmetric
decomposition and if KXX represents a subset of the
d-set (SETNAME='D'). PARTVEC is not required if KXX
represents the h-set. See SETNAME parameter description below.
PBGPDT BGPDT Basic grid point definition table updated to support plotting
CHBDYi elements. Output by PLTHBDY.
PBRMS Table of intermediate arbitrary beam data. Output by IFP9.
PBRMSD Table of arbitrary beam data. Output by DOPR1.
PBRMSN Updated (optimized) PBRMSD. Output by DOM11.
PBYG Matrix of equivalent static loads due to enforced velocity for the g-
set.
PC Optional stepwise preconditioner in SOLVIT and STATICS, same as
A and KGG respectively.
PC1 Updated stepwise preconditioner matrix. Output by SOLVIT and
STATICS.
PCDB Table of model (undeformed and deformed) plotting commands.
Output by IFP1.
PCDBS Table of model (undeformed and deformed) plotting commands for
the current superelement (identification number equal to output
value of SEID). Output by SEP2CT.
PCDBDR Table of model (undeformed and deformed) plotting commands for
the superelement (identification number equal to output value of
SEID). Output by SEDR.
PCOMPT Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry.
PCOMPTC Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry. Output by IFP6.
Main Index
1603 Glossary
Data Block Glossary
PCOMPTX PCOMPT with design variable perturbations. Output by DSABO.
PD Dynamic load matrix for the d-set.
PD1 Equivalent load vector for mode acceleration computations for the
a-set. Output by DDR2.
PDF Frequency response load matrix in the d-set. Output by FRLG.
PDT Transient response load matrix in the d-set for output time steps.
Output by TRLG and NLTRLG.
PDT1 Transient response load matrix in the d-set for all time steps. Output
by TRLG.
PECT Element connectivity table updated to support plotting CHBDYi
elements. Output by PLTHBDY.
PELSDSF p-element set table for the perturbed configuration. Output by
DSAH.
PELSET p-element set table, contains SETS DEFINITIONS. Output by
PLTSET.
PELSETDS p-element set table for constrained elements. Output by DOPR3.
PFHF Fluid partition of frequency response modally reduced load matrix.
PFP Frequency response load matrix in the p-set combined with gust
loads. Output by GUST.
PG Static load matrix applied to the g-set. In superelement analysis and
output by SELA, PG includes the loads from upstream
superelements. Output by SSG1 and SELA.
PG* Family of PG matrices vectors qualified by LOADID and
LOADNAME. One matrix is created per EXPORTLD request.
Output by EXPORTLD.
PG1 Combined static load matrix for the g-set and in the residual
structure. Output by PCOMB.
PGFB* Family of PG matrices. Output by FBDODYLD.
PGG Force matrix in g-set for all processors (global). Output by
DISUTIL.
PGRV Static load matrix applied to the g-set but due to gravity loads only.
Output by SSG1.
PGT Static load matrix applied to the g-set appended for all boundary
conditions. Output by SDR1.
PGUP Static load matrix for the g-set and in the residual structure due to
static loads in upstream superelements only.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1604
PGVST Static load vector matrix (g-set). Output by MAKAEFS.
PHA Normal modes eigenvector matrix in the a-set. Output by READ.
PHA1 Normal modes eigenvector matrix in the a-set updated for mode
tracking. Output by MODTRK.
PHAREF1 Designed normal modes eigenvector matrix in the a-set updated for
mode tracking. Output by MODTRK.
PHASH2 Structural partition (row-wise) of eigenvector matrix PHDH. Also
partitioned column-wise according to parameter STRUCTMP.
PHDFH Fluid partition (row-wise) of eigenvector matrix PHDH.
PHDH Transformation matrix from d-set to h-set (modal). Output by
GKAM.
PHF Frequency response load matrix in the h-set (modal). Output by
FRLG.
PHF1 Frequency response load matrix in the h-set (modal) combined with
gust loads. Output by GUST.
PHG Normal modes eigenvector matrix in the g-set. Output by READ and
LANCZOS.
PHG* Family of normal modes eigenvector matrices in the
g-set.
PHG1 Normal modes eigenvector matrix in the g-set updated for mode
tracking. Output by MODTRK.
PHGREF Designed normal modes eigenvector matrix in the g-set from the
prior design cycle output of MODTRK. Output by MODTRK.
PHGREF1 Designed normal modes eigenvector matrix in the g-set updated for
mode tracking. Output by MODTRK.
PHIDLL Retained left divergence eigenvector responses.
PHIDRL Retained right divergence eigenvector responses.
PHT Transient response load matrix in the h-set (modal) for all time steps.
Output by TRLG.
PHX Right eigenvector matrix for real eigenvalues only. Output by
UEIGL.
PHXL Left eigenvector matrix for real eigenvalues only. Output by UEIGL.
PHZ Generalized degree-of-freedom transformation matrix. Output by
DYNREDU.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1605 Glossary
Data Block Glossary
PIj Any matrix with the same number of columns as there are
eigenvalues, frequencies, or time steps in OL. The rows of the
matrix may correspond to any degree-of-freedom set size.
PIj1 PIj truncated by the OFREQ or OTIME Case Control command.
Output by MODACC.
PJ Static load matrix for the g-set of the current superelement and
applied to its interior points only.
PKF Matrix of k-set forces per frequency.
PKYG Matrix of equivalent static loads due to enforced displacement for
the g-set.
PL Static load matrix reduced to the l-set. Output by SSG2.
PLI Static load matrix with inertial loads and reduced to the l-set. Output
by SSG4.
PLIST2 Table of type two properties on DVPREL2 Bulk Data entries.
Output by DOPR1.
PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data
entries. Output by DOPR1.
PLMAT Initial and final load matrices for subcase.
PLOTMSG Table of user informational messages generated during the plot
process. Output by PLOT.
PLSETMSG Table of user informational messages generated during the
definition of element plot sets. Output by PLTSET and SEPLOT.
PLTPAR Table of plot parameters and plot control. Output by PLTSET and
SEPLOT.
PMPF Matrix of contribution of structural panels to fluid mode
participation factors. Output by MODEPF.
PMYG Matrix of equivalent static loads due to enforced acceleration for the
g-set.
PNL Nonlinear load matrix appended from each output time step. Output
by NLTRD, NLTRD2, TRD1, and TRD2.
PNLLST Table of triplets defining panel names and their associated IPANEL
qualifier values
PNLT Nonlinear load matrix appended from each output time step. (for
transient analysis only). Output by NLSOLV.
PO Static load matrix partitioned to the o-set. Output by SSG2.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1606
POI Static load matrix with inertial loads and reduced to the o-set. Output
by SSG4.
POSTCC Table containing POST command selections. Output by
MODCASE.
POSTCC0 POSTCC computed from previous execution of MODCASE
(POSTCFLG=1)
POSTCDB Table of commands from the OUTPUT(POST) section of Case
Control. Output by IFP1.
PPF Frequency response load matrix in the p-set. Output by FRLG.
PPL Nonlinear load (applied and NOLINi) matrix appended from each
output time step. Output by NLSOLV.
PPLT Nonlinear load (applied and NOLINi) matrix appended appended
from each output time step (for transient analysis only). Output by
NLSOLV.
PPN Applied load vectors for nonlinear analysis in the p-set.
PPT Transient response load matrix in the p-set for output time steps.
Output by TRLG.
PVPERQ Partitioning vector for the V columns of PGVST into those to be
scaled by Q (=1) and those that are absolute (=0). Output by
MAKAEFS.
PPVR Partitioning vector for random responses. Output by DOPRAN.
PRBDOFS Partitioning matrix to partition the "active" URDDI from the
"inactive". Active URRDI are assigned a 1.0 value and are
connected to the SUPORT degrees-of-freedom. Output by
MAKETR.
PROPI Matrix of initial property values. Output by DOPR1.
PROPI* Family of matrices of initial property values. Output by DOPR1.
PROPO Matrix of final (optimized) property values. Output by DOM9.
PS Static load matrix partitioned to the s-set. Output by SSG2.
PSDF Power spectral density table. Output by RANDOM.
PSDL Power spectral density list. Output by DPD.
PSF Frequency response load matrix in the s-set. Output by FRLG.
PSFL Loads due to enforced motion on linear elements in nonlinear
transient analysis.
PSI Modal partitioning factor matrix.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1607 Glossary
Data Block Glossary
PST Transient response load matrix in the s-set for output time steps.
Output by TRLG.
PTELEM Table of thermal loads in the elemental coordinate system. Output by
SSG1.
PTELEM0 Table of thermal loads in the elemental coordinate system from prior
subcase. Output by SSG1.
PTELMDCN Table of thermal loads in the elemental coordinate system which
incorporates combined constraints and design variables. Output by
DSAF.
PTELMDSX Table of thermal loads in the elemental coordinate system for the
central, forward, or backward perturbed configuration. Output by
SSG1.
PUG Matrix of translational displacements. Output by SDR2.
PUG* Family of matrices of translational displacements for all
superelements.
PUGD Matrix of translational displacements in dynamic analysis. Output
by SDR2.
PUGS Matrix of translational displacements in static analysis. Output by
SDR2.
PUGX PUG assembled for superelements defined on the SEPLOT or
SEUPPLOT command. Output by SEPLOT.
PVAL0 P-value table generated by the ADAPT module in previous
superelement, adaptivity cycle, or run.
PVAL1 P-value table updated for current superelement or adaptivity loop.
Output by ADAPT.
PVEC Partitioning vector for supported degrees-of-freedom specified on
CYSUP Bulk Data entry. Output by CYCLIC3.
PVGRID Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the following
Case Control commands: DISPLACEMENT, VELOCITY,
ACCELERATION, FORCE, STRESS, STRAIN, SPCFORCE,
MPCFORCE, MPRES, GPFORCE, ESE, EKE, EDE, GPKE.
Output by OUTPRT.
PVGT Partitioning vector for extracting the grid point translational DOFs.
Output by SEEFMNOR.
PVLOAD Partitioning vector with ones at rows corresponding to degrees-of-
freedom at which static and dynamic loads are applied. Output by
OUTPRT.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1608
PVMCFR Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
MCFRACTION Case Control command. Output by OUTPRT.
PVMPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
MPCFORCE Case Control command. Output by OUTPRT.
PVSBIT1 Partitioning vector from all modes to subspace iteration modes.
Output by DSAH.
PVSBIT2 Partitioning vector from subspace iteration modes to constrained
modes. Output by DSAH.
PVSPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
SPCFORCE Case Control command. Output by OUTPRT.
PVT Table containing parameter values from PARAM Bulk Data entry
images. Output by IFP.
PVTS Table containing parameter values which are resolved from values
in PVT, CASECC, and, optionally, the NDDL. Output by PVT.
PX Inertial or pseudo-load matrix. Output by DSAP.
PXA Matrix of modally reduced static loads.
PXF Frequency response load matrix in h-set (modal) or d-set.
PXT Transient response load matrix in the h-set (modal) or
d-set. Output by TRLG.
PXTDV Transient response load matrix in h-set (modal) or d-set combined
from two executions of TRLG: one with DVFLAG=0 and the other
of DVFLAG=1.
PXT1 Reduced transient response load matrix analysis. Output by DSAR.
PZ Reduced aerostatic loads matrix.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1609 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
QG Single-point constraint forces of constraint matrix in the g-set.
Output by LANCZOS, STATICS, and SDR1.
QHH Aerodynamic matrix of size h- by h-set. Output by AMP.
QHHL Aerodynamic matrix list
QHJ Aerodynamic matrix of size h- by j-set. Output by AMP.
QHJK Aero transformation matrix between h and j sets. Output by GUST.
QHJL Aero transformation matrix between h and j sets.
QKGUST* Family of j-set downwashes (normal washes) matrices qualified by
reduced frequency, mach number, and gust rotation.
QKH Aerodynamic matrix of size k- by h-set. Output by AMP.
QKHL Aero transformation matrix between h and k sets.
QLL Aerodynamic matrix for divergence analysis.
QMG Multipoint constraint forces of constraint matrix in the
g-set. Output by LANCZOS and STATICS.
QMPF Multipoint forces of constraint matrix in the p-set for frequency
response.
QMPFM Merged QMPF. Output by DSAD.
QNV Quasi-Newton sweeping vectors. Output by NLITER.
QPF Single-point forces of constraint matrix in the p-set for frequency
response.
QPFM Merged QPF. Output by DSAD.
QPV Nonlinear constraint forces. Output by NLSOLV.
QR Matrix of determinate support forces. Output by SSG2.
QXX Aerodynamic matrix in any set.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1610
Chapter 3
Name
Chapter 2
Name Description
R Residual matrix. Output by SOLVIT.
R1MAPR R1MAP Table of mapping from original first level (direct) retained
responses. Output by DSAD.
R1TAB Table of first level (direct) (DRESP1 Bulk Data entry) attributes.
Output by DOPR3.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry)
attributes. Output by DSAD.
R1TABRG Table of attributes of the retained first level (direct) responses.
R1VAL Matrix of initial values of the retained first level (direct) responses.
Output by DSAD.
R1VALO Matrix of final (optimized) values of the retained first level (direct)
responses. Output by DOM9.
R1VALR Matrix of retained type one responses. Output by DSAD.
R1VALRG Matrix of initial values of the retained first level (direct) responses.
R2MAPR Table of mapping from original second level (synthetic) retained
responses. Output by DSAD.
R2VAL Matrix of initial values of the retained second level (synthetic)
responses. Output by DSAD.
R2VALO Matrix of final (optimized) values of the second level (synthetic)
responses. Output by DOM9.
R2VALR Matrix of retained second level (synthetic) responses.
R2VALRG Matrix of initial values of the retained second level (synthetic)
responses.
R2VALXE R2VALRG with resolved DRESP2 records. Output by DSADX.
R3VAL Matrix of initial values of the retained third level responses. Output
by DSAD.
R3VALO Matrix of final values of the third level responses. Output by DOM9.
R3VALR Matrix of initial values of the retained third level responses. Output
by DSAD.
R3VALRG Matrix of initial values of the retained third level responses.
R3VALXE R3VALRG with resolved DRESP3 records. Output by DSADX.
RBF Rigid body force matrix. Output by VECPLOT and MKRBVEC.
RCROSSL Table of RCROSS Bulk Data entry images. Output by DPD.
RDEST Radiation element summary table. Output by RMG2.
Main Index
1611 Glossary
Data Block Glossary
RECM Radiation exchange coefficient matrix. Output by RMG2.
RDG Reduction matrix from g-set to d-set (transposed).
RESMATFT Matrix of average velocity response for all EFM superelements for
all bands.
RESMAX Resultant or maxima matrix. Output by VECPLOT.
RESMAX0 Resultant or maxima matrix for residual structure. Output by
VECPLOT.
RESP12X RESP12 Table of second level (synthetic) responses from than one
superelement. Output by DOPR3.
RESP12XM Merged table of second level (synthetic) responses from all
superelements.
RESP12XR RESP12X for retained frequencies. Output by DSAD.
RESP3 Table of third level responses. Output by DOPR3.
RESP3R Table of retained third level responses in RESP3. Output by DSAD.
RESP3X Table of third level responses from more than one superelement.
Output by DOPR3.
RESP3XE RESP3XM with resolved DRESP3 records. Output by DSADX.
RESP3XM Merged table of third level responses from all superelements.
RESP3XR RESP3X for retained frequencies. Output by DSAD.
RESP12 RESP12 Table of second level (synthetic) responses. Output by DOPR3.
RGG Radiation transfer matrix in the g-set. Output by RMG2.
RHMCF Matrix of dimensional rigid unsplined hinge moment data
RLABEL Monitor point label for each column in OTMT. Ouptut by ILMP2.
RMAT Matrix containing real part of CMAT. Output by MATMOD option
34.
RMATG Rectangular matrix defined on DMIG Bulk Data entries and may
have an arbitrary number of columns but g-set rows, similar to P2G.
Output by MTRXIN.
RMG Multipoint constraint equation matrix. Output by GP4.
RMG1 Updated RMG matrix when MPC option is selected on the
AUTOSPC Case Control command. Output by GPSP.
RMPTQM Matrix of updated initial MPCforces.
RMSTAB Table of RMS responses. Output by DOPRAN.
RMSTABR Table of retained RMS responses in RMSTAB. Output by DSAD.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1612
RMSTBR Table of retained RMS responses.
RMSVAL Matrix of initial RMS values. Output by DSARME.
RMSVALR Matrix of initial values of the retained RMS responses in RMSVAL.
Output by DSAD.
RMSVLR Matrix of retained RMS values.
ROTORT Table of rotordynamics user input for transient analysis. Output by
ROTOR module.
RP Row partitioning vector.
RPERM Table of row permutations under KSYM=4. Output by DECOMP.
RPH Transformation matrix from h-set to p-set.
RPV Load matrix (two columns) at the final iteration before exit.
RPX Reduction matrix from p-set to h-set (modal) or d-set.
RQA Matrix of spawned generalized stiffness and mass indices. Output by
DSTAP2.
RQATAB Table of Rayleigh Quotient Approximation. Output by DOPR3.
RQATABR Table of Rayleigh Quotient Approximation for retained eigenvalues.
RQATABRG Total table of Rayleigh Quotient Approximation for retained
eigenvalues.
RR2IDR Table of retained referenced type two response identification list.
Output by DSAD.
RR2IDXE RR2IDR with resolved DRESP2 and DRESP3 records. Output by
DSADX.
RSLTDATA Table of actual results data when system cell 297=3. Output by
SDRP.
RSLTSTAT Table of result-state information when system cell 297=2. Output by
SDRP.
RSP12R RESP12 Table of retained second level (synthetic) responses in RESP12.
Output by DSAD.
RSP1CT Table of the count of type 1 responses per response type per subcase
in R1TAB. Output by DOPR3.
RSP2RG RESP12 Table of attributes of the retained second level (synthetic) responses.
RSP2XE RSP2RXM with resolved DRESP2 records. Output by DSADX.
RSP2XM Merged RSP2X with unresolved DRESP2 records
RSP3RG Table of attributes of the retained third level responses.
RSPTQS Matrix of updated initial SPCforces.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1613 Glossary
Data Block Glossary
RSQUERY Table of results state query.
RSTAB Matrix of dimensional rigid stability derivatives generated directly
from the aerodynamic model.
RUG Residual matrix for the g-set. Output by STATICS.
RUL Residual matrix for the l-set. Output by SSG3.
RUO Residual matrix for the o-set. Output by SSG3.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1614
Chapter 3
Name
Chapter 2
Name Description
SCLFMAT Matrix of simple coupling loss factors. Output by SEEFMCLF.
SCSTM Table of global transformation matrices for partitioned
superelements. Output by SEP1 and SEP1X.
SELIST Table containing the list of partitioned superelements defined in
separate Bulk Data sections. Output by SEPR1.
SEMAP SEMAP Superelement map table. Output by SEP1 or SEP1X.
SEQMAP Mapping matrix for resequencing. Output by SEQP.
SET SET Table of combined sets. Output by NASSETS.
SETREE Superelement tree table usually input via the DTI,SETREE Bulk
Data entry.
SGPDT Superelement basic grid point definition table. Output by SEP1X.
SGPDTS Superelement basic grid point definition table for the current
superelement. Output by SEP2X.
SGPDTS* Family of SGPDTS tables created in previous runs.
SHPVEC Matrix of basis vectors - coefficients relating designed grid
coordinates and design variables. Output by DOPR2.
SIL Scalar index list. Output by GP1.
SIL0 SIL table from a previous adaptivity index in p-version analysis.
SILD Scalar index list for the p-set. Output by DPD.
SKJ Integration matrix. Output by AMG.
SLIST Superelement processing list to matrix generation, assembly, and
reduction. Output by SEP3.
SLT Table of static loads. Output by GP3.
SLTF Table of static loads with follower forces only. Output by DLT2SLT.
SLT1 Table of static loads updated for nonlinear analysis. Output by
NLCOMB.
SLTH Table of static loads updated for heat transfer analysis. Output by
SSG1.
SLTNL SLT with follower forces for CQUADR/CTRIAR elements for both
the current and last load step. Output by SSG1.
SLTNL0 SLTNL from a prior execution of SSG1.
SMPF Matrix of contribution of structure to fluid mode participation
factors. Output by MODEPF.
SNORM* Family of shell normal vectors at superelement boundaries.
Main Index
1615 Glossary
Data Block Glossary
SNORMM Matrix of superelement grid point shell normal vectors. Output by
SEEFMNOR.
SNORMS Table of shell normal vectors on a superelement's boundary. Output
by TASNP1.
SORTBOOL Square matrix containing unity at a row position in the column
associated with the sorted row terms. Output by MATMOD option
35.
SORTLIST Vector consisting of the row numbers of the original positions of the
sorted terms. Output by MATMOD option 35.
SPCCOL Local f-size partitioning vector with 1.0 for the local boundary's s-
set degrees-of-freedom. Required only for geometric domain
decomp.
SPCPART Partitioning vector for domain decomposition. Output by SEQP.
SPECSEL Response spectra input correlation table.
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with
external grid identification numbers. Output by MKSPLINE.
SPSEL Table of response spectra generation correlation selections.
SRKS Matrix of monitor point rigid body vectors. Output by MONVEC.
SRKT Matrix used to sum the forces and moments acting on the k-set
degrees-of-freedom to the reference point. Output by ADG.
STATDATA Table of state information when system cell 297=1. Output by SDRP.
STBDER Table of aerostatic stability derivatives for a single subcase. Output
by SDP.
STBTAB Table of aerostatic stability derivatives for all subcases.
STRUCOMP Table of structural components when MESH='STRU'. Output by
MAKCOMP.
SVEC Starting "random" eigenvector matrix.
SYSE Matrix of (strain or kinetic) energy in the residual structure a-set.
SZR Merged monitor matrices. Output by MRGMON.
SZRi Associated monitor matrices
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1616
Chapter 3
Name
Chapter 2
Name Description
T Table information to support MATGEN module options. Diagonal
from symmetric decomposition. Output by MATMOD option 21.
TA Secondary table to be merged into TOLD to form TNEW.
TAB Table.
TABi Tables.
TABDEQ Table of unique design variable identification numbers. Output by
DOPR4.
TABECN Table of relationship between internal identification numbers of
constraints in ESTDCN and elements and responses in R1TABR.
Output by DSAF.
TABEVP Cross-reference table between ESTDVP records and element and
design variable identification numbers. Output by DSABO.
TABEVS Cross reference table between ESTDVS records and element and
design variable identification numbers. Output by DOPR6.
TABEV2 Merged cross reference table of TABEVP and TABEVS. Output by
DSAE.
TB Secondary table to be merged into TOLD to form TNEW.
TC Secondary table to be merged into TOLD to form TNEW.
TEF Directory table for MEF. Output by DRMH1 and DRMS1.
TEL Transient response time output list appended from each subcase.
Output by NLTRD, NLSOLV, and NLTRD2.
TEMF Total effective mass fraction table. Output by EFFMAS.
TES Directory table for MES. Output by DRMH1 and DRMS1.
TFPOOL Table of TF Bulk Data entry images. Output by DPD.
TIMSIZ Table of CPU and disk space estimation parameters. Output by
SEQP.
TKNRGY Table of modal kinetic energy. Output by MODENRGY.
TMINIT Table of initial design variable values for topology with
manufacturing constraints. Output by DOPR1.
TMLD Table of loads for nonlinear transient analysis. Output by NLTRLG.
TNEW Table data block to be edited by TABEDIT.
TOFPi Directory table for MOFPi. Output by DRMH1 and DRMS1.
TOL TOL Transient response time output list. Output by IFT, TOLAPP, TRD2
and TRLG.
Main Index
1617 Glossary
Data Block Glossary
TOL1 TOL Transient response time output list reduced by the OTIME Case
Control command or for the current nonlinear transient subcase.
Output by MODACC and TOLAPP.
TOLD Table data block to be edited by TABEDIT.
TOLR Updated TOL in restarts requested by user parameter STIME>0.0.
Output by TRLG.
TOPELE Element list for topology optimization. Output by IFP10.
TOPMC Topology member size control table. Output by DOPR1.
TOPMC2 Topology member size control table for manufacturing constraints.
Output by DOPR1.
TOPOLE Table of topology pole parameters (used only for topology
manufacturing constraints). Output by DOPR1.
TOPTAB Table of topology designed properties with design variable
identification numbers. Output by DOPR1.
TOPTAB0 Table of topology designed properties. Output by IFP10.
TOUT DRMH1 directory table in table data block or DTI format.
TPRELE Table of topology pole vs. element ids (used only for topology
manufacturing constraints). Output by DOPR1.
TQG Directory table for MQG. Output by DRMH1 and DRMS1.
TR Matrix to transform forces from the support point to the
aerodynamic reference point. Output by MAKETR.
TRANTR Transpose of TR where the number of columns of TR matches the
URDDUXV states of TRX. Both are reduced to just the active origin
rigid body degrees-of-freedom. Output by MAKETR.
TRL Transient response list. Output by DPD.
TRX Boolean matrix to select accelerations from the list of aerodynamic
extra points. Output by ADG.
TSNRGY Table of modal strain energy. Output by MODENRGY.
TUG Directory table for MUG. Output by DRMH1 and DRMS1.
TXY DRMH1 directory table in DTI or table data block format. Output by
DRMH1.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1618
Chapter 3
Name
Chapter 2
Name Description
U Upper triangular factor. Output by DECOMP and DCMP.
UA Displacement or eigenvector matrix in the a-set or solution matrix on
the boundary (a-set) of the superelement (identification number
equal to output value of SEID).
UACCE Reduced acceleration solution matrix from transient response
analysis. Output by DSAR.
UAJJT Upper triangular decomposition factor matrix of AJJT.
UAM1DD Upper triangular factor of the dynamic tangential matrix in the d-set.
UBULK Table of all unsorted Bulk Data entries. Output by XSORT.
UD Solution matrix for the d-set. Displacements only in frequency
response. Displacements, velocities, and accelerations in transient
response.
UD1 Improved solution matrix for the d-set. Output by DDR2.
UDISP Reduced displacement solution matrix from transient response
analysis. Output by DSAR.
UE Improved solution matrix for the e-set (extra points). Output by
DDR2.
UG Displacement matrix in g-set. For the DSVG1 module and transient
analysis, UG can also represent velocity or acceleration. Output by
SDR1 and STATICS. Velocity matrix in g-set.
UGD Displacement matrix in g-set for the downstream superelement.
UGDS Displacement matrix in g-set due to pseudo-loads.
UGDS1 Displacement matrix in g-set for the total variation. Output by
DSVG3.
UGG Displacement matrix in g-set for all processors (global). Output by
DISUTIL.
UGNI Displacement matrix at converged step in the g-set. Output by
NLITER.
UGNT Total displacement matrix in the g-set. Output by UGVADD.
UGT Updated temperature matrix in g-set. Output by MATMOD option
19. Transposed regular solution matrix specified on first pass
through DSADJ. Output by DSADJ.
UGT0 UGT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
UGX Matrix of analysis model displacements in g-set or p-set.
Main Index
1619 Glossary
Data Block Glossary
UGX1 Copy of UGX matrix with null columns in place of the deleted
responses. Output by DSAD.
UH Solution matrix for the h-set (modal degrees-of-freedom). Modal
displacements only in frequency response. Modal displacements,
velocities, and accelerations in transient response.
UHF Modal displacement matrix in p-set for frequency response.
UHFF Fluid partition (row-wise) of solution matrix UHF. Also partitioned
column-wise according to parameter FLUIDMP.
UHFM Merged UHF. Output by DSAD.
UHFS Structural partition (row-wise) of solution matrix UHF. Also
partitioned column-wise according to parameter STRUCTMP.
UHR Modal displacement vector for spectral analysis. Output by
INTERR.
UI Solution matrix where the columns correspond to eigenvalues,
frequencies, or time steps in OL. The rows of the matrix may
correspond to any degree-of-freedom set size.
UI1 UI truncated by the OFREQ or OTIME. Case Control command.
Output by MODACC.
UL Displacement matrix in l-set. Output by SSG3.
ULAMA Unsymmetric eigenvalue summary table. Output by UEIGL.
ULL Upper triangular factor for the l-set from KLL.
ULLT Upper triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
ULNT Solution matrix from nonlinear transient response analysis in the d-
set. Output by NLTRD and NLTRD2.
UNITDISP Unit displacement matrix where each row represents a unit
displacement at a degree-of-freedom. Only degrees-of-freedom
which participate in the union of all monitor points will contain a
unit displacement. UNITDISP has LUSET number of columns.
Output by ILMP1.
UNITPV Partitioning vector (g-set) with 1.0 at each grid where a unit
displacement is requested. (All 6 degrees-of- freedom will be
assumed to contribute). Output by ILMP1.
UNITS Table of units. Usually input by the user via DTI Bulk Data entries.
UO Displacement matrix in o-set. Output by SSG3.
UOO Displacement matrix in o-set due to applied loads on the o-set with
the a-set fixed (set to zero).
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1620
UPF Displacement matrix in p-set for frequency response.
UPFM Merged UPF. Output by DSAD.
UPNL0 Initial solution matrix from nonlinear analysis at each STEPcase.
Output by NLSOLV.
UPNT Solution matrix from nonlinear analysis appended from each output
time step (for transient analysis only). Output by NLSOLV.
UPSDT Table of transfer function data needed for RMS calculations.
UPSDTR UPSDT for retained frequencies. Output by DSAD.
URDDIDX An instance of an ADBINDX that describes the acceleration entries.
Output by MAKETR.
URDDUXV UX vector states for the active URDDi. These are rows of TRX that
are non-null. Null rows occur either because the USER didn't define
AESTAT, URDDi, OR because the associated URDDi is invalid for
this symmetry condition (e.g., URDD1,3,5 are invalid for
antisymmetric analysis). Output by MAKETR.
USET USET Degree-of-freedom set membership table for g-set. Output by GPSP.
USET0 USET Degree-of-freedom set membership table for g-set usually prior to
Auto-SPC update in GPSP. Output by GP4. USET table from a
previous adaptivity index in
p-version analysis.
USET1 USET USET updated with constraints from upstream superelements.
Output by BNDSPC.
USETD USET Degree-of-freedom set membership table for p-set. Output by DPD.
USETM USET Modified degree-of-freedom set membership table for g-set. Output
by MODUSET.
USETN USET with updated set membership. Output by NEWUSET.
UTF Upper triangular file of the solution matrix ULNT. Output by
NLTRD2 and NLSOLV.
UVELO Reduced velocity solution matrix from transient response analysis.
Output by DSAR.
UX Matrix of aerodynamic extra point displacements. Output by ASG.
UXDAT Table of aerodynamic extra point identification numbers,
displacements, labels, type, status, position and hinge moments.
Output by ASG.
UXDIFV Derivative interpolation factors matrix at UX = UXREF. Output by
ASG and SDP.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1621 Glossary
Data Block Glossary
UXF Solution matrix from frequency response analysis in
d- or h-set. Output by FRRD1 or FRRD2.
UXR Matrix of aerodynamic extra point vectors for use in calculating the
sensitivity of restrained stability derivatives. Output by DSARLP.
UXT Solution matrix from transient response analysis in d- or h-set.
Output by TRD1, TRD2, and IFT.
UXT1 Reduced solution matrix from transient response analysis. Output by
DSAR.
UXTRIM UX vector at trim.
UXU Matrix of aerodynamic extra point vectors for use in calculating the
sensitivity of unrestrained stability derivatives. Output by DSARLP.
UXV Control state matrix for ADB or AEDB
UXVBRL Controller state matrix for WJVBRL downwash vectors. UXVBRL
has NX rows and NV columns. Output by ADG.
UXVF Matrix of UXVEC vectors defined by the AEFORCE Bulk Data
entries. Output by MAKAEFA.
UXVP Matrix of UXVEC vectors defined by the AEPRESS Bulk Data
entries. Output by MAKAEFA.
UXVST Aerodynamic extra point displacement matrix. Output by
MAKAEFS.
UXVW Matrix of UXVEC vectors defined by the AEDW Bulk Data entries.
Output by MAKAEFA.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1622
Chapter 3
Name
Chapter 2
Name Description
V01P Partitioning vector for sparse load reduction.
VA Velocity matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID). Output by
SEDR.
VDA Partitioning vector--d-set size--with 1.0s at extra point dofs. May be
purged if no extra points are specified. Output by VEC.
VDXC Partitioning vector with 1.0 at rows corresponding to null columns
in KDD, BDD, and MDD.
VDXR Partitioning vector with 1.0 at rows corresponding to null rows in
KDD, BDD, and MDD.
VELEM Table of element lengths, areas, and volumes. Output by ELTPRT.
VELEMDCN Table of element lengths, areas, and volumes which incorporates
combined constraints and design variables. Output by DSAF.
VELEMN Table of element lengths, areas, and volumes for the perturbed
configuration. Output by ELTPRT.
VFO1 VFO zero-partition by SPCCOL. VFO is the local f-size partitioning
vector with 6 values of 1.0 for every grid in the local residual.
Required only for geometric domain decomp.
VG Left-handed displacement matrix in g-set. Divergence and flutter
analysis only. Velocity matrix in g-set.
VGA G-set size partitioning vector with values of 1.0 at the rows
corresponding to the a-set.
VGD Velocity matrix in g-set for the downstream superelement.
VGDM Partitioning vector for sparse design model with ones where design
response is required if SPDM=-1. Output by OUTPRT.
VGF Fluid/structure partitioning vector with ones at the rows
corresponding to fluid degrees-of-freedom. Output by GP1.
VGFD Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to frequency-dependent elements. Output by
TA1.
VGA G-set size partitioning vector with values of 1.0 at the rows
corresponding to the a-set.
VGQ Partitioning vector with values of 1.0 at rows corresponding to
degrees-of-freedom in the q-set.
VIEWTB VIEWTB View information table, contains the relationship between each p-
element and its view-elements and view-grids. Output by VIEWP.
Main Index
1623 Glossary
Data Block Glossary
VIEWTBDS VIEWTB View information table, contains the relationship between each p-
element and its view-elements and view-grids for the perturbed
model. Output by DVIEWP.
VTQU Table of flutter sensitivity data. Output by DSFLTE.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1624
Chapter 3
Name
Chapter 2
Name Description
WETFACES Table of wetted structure element and face identification numbers
found for each individual open fluid face.
WGTM Table of 6x6 rigid body mass matrix. Output by WEIGHT.
WJ Gust matrix. Output by GUST.
WMID Table of weight as a function of material identification number.
Output by WEIGHT.
WRJVBRL Downwash matrix (NJ rows by NV columns). Downwash at the j-
points due to the linear, angle/rate rigid body aerodynamic extra-
points and linear control surfaces. Output by ADG.
WSKJF Weighted integration matrix.
WTCRID Table of retained weight responses with column and row numbers in
rigid mass matrix. Output by DSAW.
WTDSCP Partitioning vector for weight. Output by DSAW.
Main Index
1625 Glossary
Data Block Glossary
Chapter 3
Name
Chapter 2
Name Description
X Solution of the equation [A][X]=[B]. Output by FBS, SOLVE, and
SOLVIT. Matrix product. Output by MPYAD and SMPYAD. Matrix
transpose. Output by TRNSP.
X66 Triple-product of XG with rigid body modes for IOPT=9 or 10.
Output by VECPLOT.
X66P Previous output of X66, usually at g-set. Used by IOPT=9, when
setnam<>'g', as a baseline to compare against the non-g-set results in
X66.
XAA Reduced square matrix in a-set. Output by MATREDU.
XAA* Family of reduced square matrices in a-set pertaining to the upstream
superelements.
XD Rectangular matrix of displacements or loads in the p-set. Output by
UREDUC.
XDD Reduced square matrix in d-set. Output by MATREDU.
XDICT KDICT Baseline element matrix dictionary table.
XDICTB Backward perturbed element matrix dictionary if CDIF='YES'.
XDICTDS KDICT Perturbed element matrix dictionary table. If CDIF='YES' then this
is the forward or backward perturbed element matrix dictionary.
XDICTX KDICT Baseline element matrix dictionary table or backward perturbed
element matrix dictionary if CDIF='YES'.
XELM KELM Baseline element matrices. Output by EMG.
XELMB Backward perturbed element matrices if CDIF='YES'
XELMDS KELM Table of perturbed element matrices. If CDIF='YES' then this is the
forward or backward perturbed element matrix dictionary.
XELMX KELM Baseline element matrices or backward perturbed element matrices
if CDIF='YES'.
XG Rectangular matrix of displacements or loads in the
g-set.
XGG Square matrix in g-set. In superelement analysis, XGG includes
contributions from upstream superelements. Output by EMA and
SEMA.
XGGi Square matrices in g-set. Output by EMA and SEMA.
XH Rectangular matrix of displacements or loads in the h-set (modal).
Output by UREDUC.
XINIT Matrix of initial values of the design variables. Output by DOPR1.
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1626
XJJ Square matrix for the g-set of the current superelement and applied
to its interior points only.
XNENEi Square matrix in ne-set. Output by MCE2.
XNNi Square matrices in n-set. Output by MCE2.
XO Matrix of final (optimized) values of the design variables.
XORTH Cross-orthogonality matrix. Output by CEAD and UEIGL.
XOUT Resultant to table output. Output by VECPLOT.
XP Rectangular matrix of displacements or loads in the p-set
XPP Square matrix in p-set.
XPPi Square matrix in p-set.
XS Optional starting vector, same type as B and PG in SOLVIT and
STATICS, respectively. Rectangular matrix of displacements or
loads in the s-set. Output by UREDUC.
XSF S-set by f-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction. Output by MATREDU.
XSS S-set by s-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction. Output by MATREDU.
XYCDB Table of x-y plotting commands. Output by IFP1.
XYCDBDR Table of x-y plotting commands for a superelement (identification
number equal to output value of SEID). Output by SEDR.
XYCDBS Table of x-y plotting commands for the current superelement
(identification number equal to output value of SEID). Output by
SEP2CT.
XYPLOT Table of x-y plot control values. Output by XYTRAN.
XZ Matrix containing the constant portion of the dependent to
independent design variable linking relationship. Output by DOPR1.
Chapter 3
Name
Chapter 2
Name Description
YACCE Matrix of enforced accelerations.
YGBNDR Boundary shape matrices appended for all auxiliary or geometric
models.
YPF Frequency response enforced motion matrix in the p-set. Output by
FRLG.
Chapter 3
Name
Chapter 2
Name Description
Main Index
1627 Glossary
Data Block Glossary
YPO Transient response enforced motion matrix in the p-set and for the
output time steps. Output by TRLG.
YPT Transient response enforced motion matrix in the p-set. Output by
TRLG.
YS Matrix of enforced displacements or temperatures. Output by GPSP.
YS0 Matrix of enforced displacements temperatures usually prior to
Auto-SPC update in GPSP. Output by GP4.
YS1 YS updated with enforced displacements from upstream
superelements. Output by BNDSPC.
YSD Accumulated matrix of enforced displacements from upstream
superelements.
YSD1 YSD updated with enforced displacements from upstream and
current superelements to be passed to downstream superelements.
Output by BNDSPC.
YSMAT Initial and final enforced displacement matrices.
YVELO Matrix of enforced velocities.
Chapter 3
Name
Chapter 2
Name Description
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1628
Data Block Naming Conventions
Stiffness, Damping, and Mass:
Superelements:
Loads and Solutions:
Chapter 3
Name
Chapter 2
Name Description
ZETAH Mass-normalized damping.
Z1ZX Matrix of unrestrained dimensional elastic derivatives
ZZX Reduced aerostatic solution matrix.
K_____ Stiffness
KD____ Differential stiffness
B_____ Viscous damping
K4____ Structural damping (See GE field on MATi entries)
__2DD Stiffness in dynamic formulation
M____ Mass
___JJ Stiffness, damping, and mass matrices without upstream superelement
contributions. Exception: __AJJ_ is the aerodynamic influence matrix.
L__, U__ Lower and upper triangular decomposition factors
Note: Some of the above names may be prefixed with a "C" to indicate a complex matrix.
CM____ Superelement (component) modes
_____S Assigned only to SEP2 and GP1 module outputs
__LIST Superelement processing list; for example, SLIST, DRLIST, and DSLIST
MAPS Superelement boundary grid map
SEMAP Superelement map
A_____ Aeroelastic or aerostatic
B_____ Buckling
Main Index
1629 Glossary
Data Block Glossary
Solutions:
Loads:
C_____ Complex modes
CY____ Cyclic symmetry
F_____ Flutter
_____F Frequency response
_____T Transient response
___NL_ Nonlinear static or transient response; for example, USETNL, ESTNL and
OESNLX
_____NI Nonlinear static or transient response generated in a nonlinear loop.
___PH__ Eigensolution
PH____ Normal modes eigenvector matrix; for example, PHG (g-set) and PHA(a-set)
CPH___ Complex modes eigenvector matrix; for example, CPHD (d-set) and CPHL (l-set).
BPH___ Buckling eigenvector matrix; for example, BPHA (a-set)
___U___ Static and dynamics (except eigen-) solution; for example, CYUG is the cyclic
static solution g-set
___Q___ Single point forces of constraint in statics and dynamics solution; for example, QG,
QPT, and CYQG. Also aerodynamic matrices; for example, QHH, QKHL, and
QLL
___QM__ Multipoint forces of constraint in statics and dynamics solution; for example,
QMG, QMPT, and CYQMG
CMPH___ Component modes eigenvector matrices.
__LAMA Eigenvalue summary table; for example, LAMA, BLAMA (buckling), CLAMA
(complex), and CMLAMA (component modes)
__UH__ Dynamic solution at modal degrees-of-freedom; for example, AUHF is the
Aeroelastic solution h-set
__OL__ Dynamic output list; for example, FOL (frequency) and TOL (transient).
___NT__ Nonlinear transient response; for example, UPNT and ULNTH
_____N Nonlinear static solution appended for all loops; for example, UGN and QGN
P_____ Dynamic and static loads
Y___ Enforced displacement
PA Static loads a-set
PJ Static loads g-set (no upstream loads)
Main Index
MSC Nastran DMAP Programmers Guide
Data Block Glossary
1630
Solution Output Tables:
Miscellaneous:
PG Static loads g-set
PP____ Dynamic loads p-set
PH____ Dynamic loads h-set
__PPF_ Dynamic loads p-set, frequency response
__PPT_ Dynamic loads p-set, transient response
__UH__ Dynamic solution at modal degrees-of-freedom
__UG__ Static solution g-set; for example, UGN is the nonlinear solution at the g-set.
__UL__ Static or dynamic solution l-set; for example, ULN is the nonlinear solution at the
g-set.
__UP__ Dynamic solution p-set; for example, UPN is the nonlinear transient solution at the
p-set.
O__ES__ Element stresses (STRESS=n)
O__GPS__ Grid point stresses (GPSTRESS=n)
O__GPF__ Grid point forces (GPFORCE=n)
O__NRG__ Element strain energy (ESE=n)
O__EF__ Element forces (FORCE=n)
O__EE__ Element strains (STRAIN=n)
O__STR__ Element strains (STRAIN=n)
O__UG__ Static solution (DISP=n)
O__UP__ Dynamic solution (DISP=n)
O__QG__ Static spcforces (SPCF=n)
O__QMG_ Static mpcforces (MPCF=n)
O__QP__ Dynamic spcforces (SPCF=n)
O_____1 Sort 1 format
O_____2 Sort 2 format
__CASE__ Case Control section tables; for example, Outputs from IFP1, SEP2 and SEDRDR
are CASECC, CASES, and CASEDR.
___CDB_ Control data blocks from the OUTPUT(XY_____), OUTPUT(PLOT), and
OUTPUT(POST) sections; for example, Outputs from IFP1, SEP2, and SEDRDR
are POSTCDB, PCDBS, and PCDBDR.
Main Index
1631 Glossary
Data Block Glossary
Inconsistent Names:
GEOM__ Table of Bulk Data entry images related to geometry, connectivity, static loads,
and degree-of-freedom set membership.
USET__ Degree-of-freedom set; for example, USET0 (from GP4), USET (from GPSP),
and USETD (from DPD).
_GPDT_ Grid point definition tables; for example, BGPDT and GPDT.
CSTM_ Coordinate Systems Transformation matrix tables; for example, CSTM, CSTMS,
CSTMA
O_____ Solution output tables; for example, OCYES1 is cyclic statics, element stresses,
and Sort 1. OCPHQP1 is complex modes, SPCForces, and Sort 1. OUG2 is statics,
displacements, and Sort 2.
_EST__ Element summary table; for example, Outputs from TA1 are named EST and
ESTL. Output from NLITER and NLTRD is named ESTNL.
_DICT_ Dictionary table for element stiffness, mass, etc.; for example, KDICT (linear),
KDDICT (differential), KDICTNL (material nonlinear), MDICT (mass)
_ELM_ Element stiffness, mass, etc.; for example, KELM (linear), KDELM (differential),
MELM (mass)
_____1 MODACC module outputs. (OTIME and OFREQ); for example, ULF1, FOL1
_____1X SDRX and SDRXD module outputs; for example, OES1X, OEF1X
BUG Buckling eigenvector matrix; should be renamed to BPHG.
GM Transformation between m-set and n-set; should be renamed to GMN.
POS Static loads on the o-set; should be renamed to PO.
PSS Static loads on the s-set; should be renamed to PS.
DM Transformation between l-set and r-set; should be renamed to DLR.
MR Rigid body mass matrix (r-set by r-set); should be renamed to MRR.
MRR Stiffness matrix partition (r-set by r-set) from MTT; should be renamed to MRR1.
__V__ Obsolete designation indicating "vector"; for example, OUGV1, UGVS, UHVF.
__PHI__ Obsolete designation indicating eigensolution; for example, PHIDH (should be
PHDH)
PHDH Transformation from d-set to h-set; should be renamed to PHD.
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1632
Parameter Glossary
The parameter Glossary lists the names and a brief description of all parameters shown in the module
descriptions in Detailed Descriptions of DMAP Modules and Statements, 589. Naming conventions
appear at the end of the glossary.
Name Type and Description
AADJCOL Integer. On input, summation of columns in DRDUG for all previously processed
superelements. On output, summation of columns in DRDUG including current
superelement. Output by ADJMOD.
ACMS Character. Automatic Component Mode Synthesis flag. If ACMS='YES', then the
model will be automatically partitioned into superelements according to NTIPS,
TIPSCOL, AND ZCOLLCT.
ACON Integer. B-set constraint flag. If ACON<0, then b-set degrees-of-freedom will be
constrained if AUTOSPC='YES'.
ACOUSTIC Integer. Fluid-structure analysis flag. Output by GP2.
0
No fluid elements exist
1
Penalty or fluid acoustic elements exist
2
Fluid/structure coupling exists
ACOUT Character. Type of acoustic pressure output in fluid-structural analysis.
'RMS' Root-mean-square
'PEAK' Peak
ACTFREQ Integer. Active frequency processing flag. Output by DSAD.
ADELRF Integer. Counter for adjoint responses in frequency response analysis. Output by
DSAL.
ADELRS Integer. Counter for adjoint responses in static analysis. Output by DSAL.
ADJFLG Integer. Adjoint sensitivity flag. Output by DSAD.
0
No adjoint sensitivity
1
Adjoint sensitivity for static analysis
2
Adjoint sensitivity for frequency response analysis
ADJMETH Integer. Triple matrix product method in DSADJ.
0
the program automatically selects the best of ADJMETH=1 or 2.
1
holds the full g-size solution vector and is recommended if disk space is
limited
Main Index
1633 Glossary
Parameter Glossary
2
holds only the active solution vectors
ADPCON Real. Scale factor for adjusting penalty values on restart. Update penalty values if
positive.
ADPTEXIT Logical. Set to TRUE if this is the final adaptivity loop. Output by ADAPT.
ADPTINDX Integer. P-version analysis adaptivity index.
AECONFIG Character. Aerodynamic configuration. Output by AEMODEL.
AEQRATIO Real. Aeroelastic feedback dynamic pressure ratio. Output by AELOOP and
DSARLP.
AERTYP Character. Aerodynamic analysis type:
'STATICS' Aerostatic
'DYNAMICS' Flutter and aeroelastic
'STADYN' All aerodynamic analysis types
ALPHAD Complex double precision. This is the scalar multiplier for [A].
ALPHAJ Real. Real part of shift point Aj for pre-Version 70.5 Lanczos method.
ALTSHAPE Integer. Set of displacement functions in p-element analysis.
0
MacNeal set
1
Full product space set
AMLFLG Logical. Set to TRUE if AMLIST if generated. Output by AXMPR1.
APP Character. Analysis type.
Output by FRLG. Dynamic load type.
Set to 'FREQ', if RLOAD1 or RLOAD2 entries are referenced.
Set to 'TRAN', if TLOAD1 or TLOAD2 entries are referenced.
ARCLG Real. The arc length at the last converged step. Output by NLITER.
ARCSGN Integer. The sign of PDD P at the beginning of the subcase. This is used in restarts
in the post-buckling region. Output by NLITER.
ASMUNIT Integer. Fortran unit number for the .asm file to be generated if the ASMBULK
option is specified on the EXTSEOUT Case Control command.
ATQSET Logical. Q-set generation flag for ACMS=YES.
FALSE generate a fixed number of q-set DOFs for each domain
TRUE generate a single q-set DOF for the residual structure and
the fluid superelement. Usually set indirectly by user
parameter.
In G4:
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1634
If no ASET, ASET1, QSET, and QSET1 entries are present, then all
unspecified degrees of freedom will be included in the:
a-set if AUTOQSET=.FALSE.
o-set if AUTOQSET=.TRUE.
In SEP1X:
Automatic q-set generation flag. If .TRUE., automatic q-set will not be
generated here but in the MODQSET module.
AUNIT Logical. If TRUE then unit solutions are assumed.
AUNITS Real. Used to convert accelerations expressed in gravity units to units of length per
time squared.
AUTOADJ Character. Adjoint sensitivity automatic selection flag. If set to 'YES', then adjoint
sensitivity will be automatically selected if appropriate. Usually input via user
parameter.
AUTOMSET Character. Auto m-set selection flag. If YES, then the dependent degree-of-freedom
specifications on MPC and rigid element Bulk Data entries will be rearranged to
avoid exclusive DOF set conflicts. Usually input by user parameter.
AUTOSE Character. Automatic superelement optimization flag. Values are 'YES' or 'NO' as
specifed on DOPTPTM Bulk Data entry. Output by DSGRDM.
AUTOSPC Character. Automatic constraint flag. If set to 'YES', then singularities will be
constrained.
AUXMFL Logical. Auxiliary model loop control flag. Output by AXMDRV. Set to FALSE
when processing the last auxiliary model.
AUXMID Integer. Auxiliary model identification number. Output by AXMDRV.
BADMESH Logical. Bad geometry was detected.
BAILOUT Integer. Decomposition maximum ratio exit flag.
BC Integer. BC Case Control command set identification number specified in the 257-
th word of the NSKIP-th record of CASECC.
BCFLAG Logical. Set to FALSE at the last boundary condition.
BCKCOL Integer. Subcase record number in CASESTAT referenced by the
STATSUB(BUCKLE) subcase identification number. BCKCOL also corresponds to
the column number of static solution vector. Output by GETCOL.
BCLBL Integer. f06 file page header control.
-1
Clear page header
0
Initialize page header without page eject
1
Initialize page header with page eject
Name Type and Description
Main Index
1635 Glossary
Parameter Glossary
BEGSUP BEGIN SUPER flag. Set to TRUE if BEGIN SUPER is specified for the first Bulk
Data section. Output by IFP1.
BETA Complex. Integration parameter.
BETAD Complex double precision. This is the scalar multiplier for [B].
BIGER Real. Minimum absolute value of element quantity to be output.
BIGMAT Logical. Big matrix (>65535 rows) format flag.
BITID Integer. Bit position of a degree-of-freedom set.
BOV Real. Conversion from frequency to reduced frequency. Value calculated by
REFC/(2.*VELOCITY). Output by APD.
BOXIDF Integer. Box corner point identification flag. Output by APD.
0
Points have unique identification numbers starting with the aerodynamic
component identification number.
-1
Points identification numbers are incremented by 1, to avoid an overlap if
they were started with the aerodynamic component identification
numbers. No display of the corner points is possible.
BSKIP Logical. Pre-buckling subcase skip flag. If TRUE, the skip first subcase in
CASECC.
BTBRS Real. Parameter for electromagnetic analysis.
BUCKCC Logical. Buckling analysis subcase flag. Set to TRUE if at least one
ANALYSIS=BUCK command was found in CASECC and CASEBUCK is
specified in the output list. Output by MDCASE.
BULKFGi Integer. Bulk Data entry record existence flag. Set to -1 if Bulk Data entry record
exists. Output by PARAML.
BULKNMi Integer. Bulk Data entry name.
CARDNO Integer. Punch file line counter. CARDNO is incremented by one for each line
written to the punch file and is also written into columns 73-80 of each line. Output
by XYTRAN.
CASCOMi Character. Case Control command names.
CASEID Integer. Subcase identification number for SOL 400. Output by CASE.
CCSET Integer. Case Control set identification number which specifies a set of grids to be
used for the N1,N2... list of the COARSEN option. (Reserved for possible future
implementation).
CFDFLG Integer. Central finite difference flag.
1
Forward
-1
Backward
CDIF Character. Finite difference scheme.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1636
'YES' Central
Forward
'NO'
CDOM Integer. Coordinate system ID of the origin of the motion.(0=basic coordinate
system).
CFDIAGP Character. Flag, if YES, to write diagonstics of CFAST element deletion. Usually
input by user parameter.
CFRANDEL Real. Rate (percentage) at which CFAST elements are removed from the model.
Usually input by user parameter.
CHAR Character. Character value of table element. Output by PARAML.
CHAR2 Character. Character value of table element concatenated from the values in the
WRDNUM and WRDNUM-th position. Output by PARAML.
APPEND module: Character value in the same record as CHAR1 and following
CHAR1.
CHARi Character. Character value for PRGNAME.
CHOLSKY Integer. Cholesky decomposition flag.
CLOSE Real. Close natural frequency scale factor. Under the OPTION='ABS' method, close
natural frequencies will be summed if the natural frequencies satisfy:
CLOSEOPT Integer. FORTIO close options.
1
Rewind (leaves file open, if open)
2
Close/keep (default)
3
Close/delete
CMDEREQ Integer. Component modal damping energy request flag. -1 means no and 0 means
yes. Output by CMSENGY.
CMEOUT Integer. Module processing flag.
-2
Query the Case Control CMSENERGY request
-1
Print/punch accumulated results
0
Integer. Compute results tables for the current superelement.
CMERTYPE Type of response of input matrices.
1
free vibrations
2
modal frequency
3
modal transient
CMETYPE Integer. Type of energy of input matrices.
Name Type and Description
f
i 1 +
CLOSE f
i
<
Main Index
1637 Glossary
Parameter Glossary
1
strain energy
2
kinetic energy
3
damping energy
CMFREREQ Integer. Component modal forced response energy request flag. -1 means no and 0
yes. Output by CMSENGY.
CMFVEREQ Integer. Component modal free vibration energy request flag. -1 means no and 0 yes.
Output by CMSENGY.
CMKEREQ Integer. Component modal kinetic energy request flag. -1 means no and 0 yes.
Output by CMSENGY.
CMPX Complex. Complex value in the next record.
CMPXD Complex double precision. Complex double precision value in the next record.
CMPXi Complex. Complex value for PRGNAME.
CMSEREQ Integer. Component modal strain energy request flag. -1 means no and 0 yes. Output
by CMSENGY.
CNCNT Integer. Counter for constraints in CONTAB. Output by DOPR3.
CNVFLG Integer. Design optimization convergence flag. Output by DOM12.
0
No convergence is achieved
1
Soft convergence is achieved
2
Hard convergence is achieved
COLADJ Integer. Number of columns of DRDUG for the current superelement.
COLINC Integer. Column increment. Extract every COLINC'th column between STARTCOL
and ENDCOL.
COLNAM Character. Degree-of-freedom set name for labeling matrix rows MATGPR output.
COLNUM Integer. Selects the column number of the input matrix that will be sorted to produce
SORTLIST and SORTBOOL. Default selects the first column.
COMBMETH Integer. Combine method selection in SSG1 module.
0
Automatic
1
Single term
2
Scaled column
3
Multiple/add kernels
< 0
Same as above with diagnostic print
COMPNAME Character. Name of a component defining the set of points participating in the rigid
body motion.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1638
COMPRPLC Logical. If TRUE then components with duplicate names will be copied from
COMP1 into COMP.
CONFAC Integer. Image superelement congruence tolerance for the location of boundary grid
points and displacement coordinate systems.
CONSEC Integer. A composite number equal to 10*(value of NSTEP the last time MAXBIS
was reached) + (the number of consecutive time steps which have reached
MAXBIS). If CONSEC=5, then solution process is terminated. Output by NLTRD,
NLSOLV, and NLTRD2.
CONT3D Integer. 3D contact flag.
< 0 No
>-1 Yes
CONV Integer. Nonlinear analysis convergence flag. Output by NLITER, NLSOLV,
NLTRD, and NLTRD2.
On input:
0 Initialization
On output:
-1 Convergence has not been achieved
1 Convergence has been achieved.
COORID Integer. Coordinate system identification number.
COUPMASS Integer. Coupled mass generation flag.
-1 Lumped
0 Coupled
CP Integer. DBC module control parameter. Output by DBC.
CRTPOS Integer. CCPOS1 creation flag.
>0 Create CCPOS1
<=0 Do not create CCPOS1
CSDIAGP Character. Flag, if YES, to write diagonstics of CWSEAM element deletion.
Usually input by user parameter.
CSRANDEL Real. Rate (percentage) at which CWSEAM elements are removed from the model.
Usually input by user parameter.
CSTRN Integer. Composite lamina strain constraint flag. Set to >0 if any constraint. Output
by DSPRM.
CSTRES Integer. Composite lamina stress constraint flag. Set to >0 if any constraint. Output
by DSPRM.
CTYPE Character. Cyclic symmetry type as specified on CYSYM Bulk Data entry. Output
by CYCLIC1.
Name Type and Description
Main Index
1639 Glossary
Parameter Glossary
'ROT' Rotational
'AXI' Axisymmetric
'DIH' Dihedral
CVTYP Integer. Type of convergence test.
1
Soft convergence is to be checked
2
Hard convergence is to be checked
3
Final iteration histories are to be printed
CWDIAGP Character. CWELD deletion diagnostic flag. YES means print. diagonistics.
Usually input by user parameter.
CWRANDEL Real. Rate (percentage) at which CWELD elements are removed from the model.
Usually input by user parameter.
CYCLIC Logical or integer. Set to TRUE or -1 for cyclic symmetry models.
DATAREC Integer. Data recovery flag. If DATAREC>0, then DPD will not perform UFM 2071
checks for DELAY and DPHASE which are not need in data recovery.
DBCPATH Integer. Dummy variable parameter to allow passing of qualifiers from the
NASTRAN database to the DBC database.
DBKNT Integer. Total number of data blocks found on IUNIT. DBKNT is only computed
under ITAPE= -3 or -13. Output by INPUTT2.
DCEIGCC Logical. Direct complex eigenvalue analysis subcase flag. Set to TRUE if at least
one ANALYSIS=DCEIG command was found in CASECC and CASECEIG is
specified in the output list. Output by MDCASE.
DEBUG Integer. Passive column logic control flag in DCMP and DECOMP.
DECOMP Integer. DCMP and DECOMP module error termination flag.
DEFORMED Integer. Deformed plot request flag.
1 Plot undeformed shapes
-1 Plot deformed shapes
DEFRMID Integer. Element deformation set identification number. Usually obtained from the
DEFORM Case Control command. Required for use in stress recovery of
differential stiffness.
DELG Real. Scale factor on perturbed length.
DELTAB Real. Relative finite difference move parameter as specified on the DOPTPRM Bulk
Data entry and stored in the OPTPRM data block.
DELTAD Complex double precision. This is the scalar multiplier for [D].
DESCYCLE Integer. Design cycle analysis counter or flag.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1640
DESGLB Integer. DESGLB Case Control command set identification number. Output by
DOPR3 and MDCASE.
DESITER Integer. Design optimization iteration number.
DESMAX Integer. Maximum allowed design optimization iteration number.
DESOBJ Integer. DESOBJ Case Control command set identification number. Output by
DOPR3 and MDCASE.
DESOPT Integer. Non-composite element force flag. If set to 1, then the non-composite
element forces are extracted for68m OEF1A and copied to OEF1AA.
DESPCH Integer. Punch control for updated DESVAR, DREPS1 and GRID Bulk Data entries.
See DESPCH (p. 718) in the MSC Nastran Quick Reference Guide.
DESVAR Integer. Retained DVPRELi or DVGRID entry flag for superelement SEID. Set to -
1 if there are retained design variable perturbations. Output by SDSA.
DET Complex. Scaled value of the determinant of a matrix. Output by DCMP and
DECOMP.
DETER Complex. Shift value. Output by DYCNTRL.
DFREQ Real. Duplicate frequency threshold. Two frequencies, and , are considered
duplicates if
where and are the maximum and minimum frequencies across all
FREQi Bulk Data entries.
DFRQCC Logical. Direct frequency response analysis subcase flag. Set to TRUE if at least one
ANALYSIS=DFREQ command was found in CASECC and CASEFREQ is
specified in the output list. Output by MDCASE.
DIGITS Integer. Number of digits for the fractional part of values written by the OUTPUT4
module.
DISCYC Logical. Discrete design cycle flag. TRUE if this is a discrete design cycle.
DISMETH Integer. Method of processing in DISUTIL module.
DISVAR Logical. Discrete optimization variable flag. Set to TRUE if discrete optimization
design variables are specified. Output by DOPR1.
DLOAD1 Integer. Dynamic load set identification number in the first frequency subcase.
Output by DSAD.
DMIGFN Character. Qualifier name for F2J matrices.
DMPYIN Logical. For DODMP>0, broadcast flag to input matrices from master processor to
slave processor(s).
DMPYOUT Logical. For DODMP>0, broadcast flag to X matrix from slave processor(s) to
master processor.
Name Type and Description
f
1
f
2
f
1
f
2
DFREQ < f
max
f
mi n
f
max
f
mi n
Main Index
1641 Glossary
Parameter Glossary
DODMP Integer. Distributed memory parallel flag.
0 Compute in serial (default)
1 Compute in distributed memory parallel method 1
2 Compute in distributed memory parallel method 1
DMRESD Integer. Design model flag. If set to -1, then the design model is limited to the
residual structure. Output by SDSB.
DOANALY Integer. Any analysis retained response flag. Set to >0 if any retained response.
Output by DSPRM.
DOBUCK Integer. Buckling constraint flag. Set to >0 if any constraint. Output by DSPRM.
DOCEIG Integer. Complex eigenvalue response retained response flag. Set to >0 if any
retained response.
DOCSTRAT Integer. Composite stress ratio flag. Set to >0 if any composite stress ratio. Output
by DSPRM.
DOEIGV Integer. Set to >0 if any eigenvector constraints. Output by DSPRM.
DOELOP Integer. Set to >0 if any element oriented force responses. Output by DSPRM.
DODIVG Integer. Divergence analysis retained response flag. Set to >0 if any retained
response. Output by DSPRM.
DOESE Integer. Static analysis retained element strain energy response flag. Set to >0 if any
retained response. Output by DSPRM.
DOFLUT Integer. Flutter analysis retained response flag. Set to >0 if any retained response.
Output by DSPRM.
DOFREQ Integer. Frequency response retained response flag. Set to >0 if any retained
response. Output by DSPRM.
DOFRMASS Integer. Fractional mass flag. Set to >0 if any fractional mass. Output by DSPRM.
DOFSPC Integer. Frequency response retained SPCforce response flag. Set to >0 if any
retained response. Output by DSPRM.
DOGPF Integer. Set to >0 if any grid point force responses. Output by DSPRM.
DOMODES Integer. Normal modes constraint flag. Set to >0 if any constraint. Output by
DSPRM.
DOMTRAN Integer. Transient response retained response flag. Set to >0 if any retained response.
Output by DSPRM.
DONSET Integer. Flag to execute GPSP again for automatic MPC processing. Output by
GPSP.
-1 Execute GPSP again to process the n-set stiffness matrix (KNN).
0 Do not execute GPSP again.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1642
DOPT Integer. Scaling method between grid points on the abscissa for the CURVPLOT
module.
DORMS Integer. RMS response retained response flag. Set to >0 if any retained response.
DOSAERO Integer. Aerostatic trim or stability derivative retained response flag. Set to >0 if any
retained response. Output by DSPRM.
DOSASTAT Integer. Statics or aerostatic retained response flag. Set to >0 if any retained
response. Output by DSPRM.
DOSSPCF Integer. Static analysis retained SPCforce response flag. Set to >0 if any retained
response. Output by DSPRM.
DOSTAT Integer. Statics constraint flag. Set to >0 if any constraint. Output by DSPRM.
DOSTCOMP Integer. Static compliance flag. Set to >0 if any static compliance. Output by
DSPRM.
DOTSPC Integer. Transient response retained SPCforce response flag. Set to >0 if any retained
response. Output by DSPRM.
DOWGHT Integer. Weight retained response flag. Set to >0 if any retained response. Output by
DSPRM.
DPEPS Real. Tolerance for design model override of analysis model properties. See further
description in Parameters (p. 691) in the MSC Nastran Quick Reference Guide.
DPHFLG Integer. Flag to select Nelsons method or subspace iteration for eigenvector
sensitivities. Usually input via user parameter.
0 Nelsons method
1 Subspace iteration
DRATIO Real. Design grid ratio as specified on the DOPTPTM Bulk Data entry. Output by
DSGRDM.
DRESP Integer. Retained DRESP1 entry flag for superelement SEID. Set to -1 if there are
retained design responses. Output by SDSA.
DSAPRT Logical. DSAPRT Case Control command print flag.
DSENS Integer. Acceleration matrix creation flag. Set to 1 to generate AG, accelerations due
to inertial loads.
DSFLAG Logical. Design sensitivity flag. Set to TRUE for design sensitivity job.
DSNOKD Real. Scale factor on the differential stiffness matrix in buckling design sensitivity
analysis. Usually specified as a user parameter.
DSVGF Integer. Specifies scaling of solution vector by eigenvalue.
0 No scaling
1 Scale
Name Type and Description
Main Index
1643 Glossary
Parameter Glossary
DSZERO Real. Design sensitivity coefficient print threshold. If the absolute value of the
coefficient is greater than DSZERO then the coefficient will be printed.
DTMi Integer. Mode acceleration based displacement matrix flag. If DTMi<>0, then
MOPFi is a mode acceleration based displacement matrix and, therefore, velocities
and accelerations will not be output to OFPi. For APP='TRANRESP', MOFPi must
have only one column per time step instead of the usual three.
DUPWG Integer. Duplicate word group option in the TABEDIT module.
DVAFLAG Integer. Flag indicating velocities and accelerations are contained in separate data
blocks and any associated outputs follow suit.
-1 Velocities and accelerations are contained in OUGi.
1 Velocities and accelerations are contained in OVGi and OAGi.
DVFLAG Integer. Enforced motion processing flag for both the large mass and direct
methods of specification.
= 0 Process only applied loads and excitations due to enforced accelerations.
> 0 Process only excitations due to enforced displacements and velocities.
DVGRDN Character. Flag for skipping basis vector components associated with all GRIDNs in
DESVCP. If DVGRDN='YES', then components will be skipped.
DVRGCC Logical. Aerostatic divergence analysis subcase flag. Set to TRUE if at least one
ANALYSIS=DIVERG command was found in CASECC and CASEDVRG is
specified in the output list. Output by MDCASE.
EIGNFREQ Integer. Eigenvalue/frequency response type flag. Output by DOPR3.
1 Eigenvalue (radian/time)
2 Frequency (cycle/time)
ECTYPE Integer. Type of element connectivity input and plot set output:
0 ECT and ELSET
1 GEOM2 and ELSET
2 ECT and PELSET
EDT1FLG Integer. EDT1 creation flag. Output by GP5.
-1 EDT1 was created.
0 EDT1 was not created.
EFMDIAG Integer. EFM diagnostic printout flag.
EFMFLG Integer. Processing flag for how shell normals are computed on superelement
boundary points.
0 Compute the average all of the shell normals
1 Compute the resultant of all of shell normals
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1644
EFMMASS Real. Total mass for all superelements for which energy flow modeling calculations
are to be performed. Output by SEEFMDMP.
EIGRFLD Character. Field name of EIGR or EIGRL entry. EIGRFLD is also an output if the
field value is a character string. Output by MATMOD option 23.
EIGRVALI Integer. Extracted integer value from the EIGR or EIGRL entry. Output by
MATMOD option 23.
EIGRVALR Real. Extracted real value from the EIGR or EIGRL entry. Output by MATMOD
option 23.
ELEMSET Integer. SET Case Control command identification number that contains a list
element point identification numbers.
ENDCOL Integer. Ending column number to extract from I1.
EPPRT Real. Singularity print parameter. Singularities greater than EPPRT will not be
printed if PRGPST='YES'.
EPS Real. Convergence criterion. By default EPS will be set to N/10000 where N is the
size of KXX, etc.
EPSBIG Real. Large number for tuning.
EPSI Integer. Static solution error ratio flag. Set to -1 if the error ratio is greater than 1.E-
3. Output by SSG3 and DISUTIL.
EPSLND Complex double precision. This is the scalar multiplier for [E].
EPSMALC Real. Small number for tuning.
EPSNO Integer. Number of eigensolutions to check and the quantity of error checking
output. If left at its default value, only the highest epsilon for the first ten or NEIGV
modes (whichever is less) are printed. If EPSNO is greater than zero, the epsilons
for the first EPSNO are printed.
EPZERO Real. Singularity test parameter. Singularities greater than EPZERO will not be
constrained.
EQVBLK Logical. Copy/equivalence flag of BULKOLD to BULK. If on input
EQVBLK=FALSE, and no new Bulk Data then copy BULKOLD to BULK. If on
input and output EQVBLK=TRUE and no new Bulk Data, then BULKOLD must be
equivalenced to BULK in a subsequent EQUIVX statement. If there are any new
Bulk Data then EQVBLK will be set to FALSE on output. xsort.
ERR Integer. Excessive factor diagonal ratio flag. Output by DCMP and DECOMP.
ERROR Integer. Duplicate element identification flag. Output by ELTPRT.
EXISTS Character. Project and version status. Output by PROJVER.
'EXISTS' If project and version exists
'DELETED' If project and version is deleted
'NONE' If project and version never existed
Name Type and Description
Main Index
1645 Glossary
Parameter Glossary
EXTNAME Character. Name of the qualifier used to identify External Superelements. Note
linkage to the SEBULK data entry.
EXTRN Integer. External superelement flag. Set to -1 if superelement is defined by the
CSUPER Bulk Data entry with PEID=0. Output by SEP2DR and SEDRDR.
EXTWORK Real. External work. Output by SSG3.
F1 Real. The lower frequency bound in cycles per unit time in READ and UEIGL.
Tolerance for treating small values as zero during decomposition in DCMP and
DECOMP. Maximum value to print in MATGPR output.
F2 Real. The upper frequency bound in cycles per unit time in READ and UEIGL. The
default value of 0.0 indicates machine infinity.
F6CNTR Integer. Fortran unit loop counter.
F6SUFFIX Character. Suffix name assigned to Fortran unit physicalvnames. Output by
MODCASE.
F6UNIT Integer. Current Fortran unit number. Output by MODCASE.
FAC1 Complex. Square of the reciprocal of the time step increment. Imaginary part is
always zero. Output by TRLG.
FAC2 Complex. Reciprocal of twice the time step increment. Imaginary part is always
zero. Output by TRLG.
FAC3 Complex. Negative of the reciprocal of the time step increment. Imaginary part is
always zero. Output by TRLG.
FACTOR Integer. Factor in the computation of the sequenced identification number (SEQID)
in the SEQP module.
FAILI Integer. Composite failure index constraint flag. Set to >0 if any constraint. Output
by DSPRM.
FBREST Integer. Internal restart flag.
FBTYP Integer. Forward or backward pass selection.
FCSENS Integer. Flutter/complex eigenvalue sensitivity flag.
Fij Integer. Form of output matrix partitions.
FILTERF Real. Filter for fluid factor matrices.
FILTERS Real. Filter for structure factor matrices.
FIRSTBA Logical. Zero frequency truncation flag. Set to TRUE if first frequency is truncated.
Output by FRRD1 or FRRD2.
FKQRTR Logical. Follower stiffness generation flag. If TRUE, follower stiffness will be
generated. Usually based on user parameter FOLLOWK.
FKSYMFAC Real. Follower stiffness symmetry factor tolerance. Usually input by user parameter.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1646
FLOOP Integer. Flutter eigenvalue analysis loop counter. Set to zero for initial entry and
incremented by one for each loop until the last loop then set to -1. Output by FA1.
FLUID Logical. Fluid processing flag.
GKAM If TRUE, then modal damping set identification number is
obtained from the SDAMPING(FLUID) Case Control
command.
READ and
LANCZOS
METHOD command option (FLUID or STRUCTURE). If
FLUID=TRUE, the EIGRL entry is selected from
METHOD(FLUID) Case Control command.
FLUIDMP Integer. Number of fluid modes to use in computing factors. If FLUIDMP>0 then
compute factors for the first FLUIDMP modes.
FLUIDSE Integer. Fluid superelement identification number. Set to a value greater than zero if
ACMS='YES' and fluid elements are present. Output by SEQP.
FLUTCC Logical. Flutter analysis subcase flag. Set to TRUE if at least one
ANALYSIS=FLUTTER command was found in CASECC and CASEFLUT is
specified in the output list.
FMODE Integer. The lowest structure mode number resulting from user parameter input of
LMODES, LFREQ, and HFREQ and also MODESELECT(STRUCTURE) Case
Control input. Output by GKAM.
FMODEF Integer. The lowest fluid mode number resulting from user parameter input of
LMODESFL, LFREQFL, and HFREQFL and also MODESELECT(FLUID) Case
Control input. Output by GKAM.
FMPFEPS Real. Threshold for filtering out small fluid factor magnitudes.
FORM Integer. Form of output matrix.
FORMAT Character. Eigenvalue problem type. Must specify 'MODES'. Buckling problems are
not supported.
FOUND Integer. Integer value search flag. Set to -1 if integer value is found by PARAML.
Output by PARAML.
FOURIER Integer. Fourier transform. Set to 1 if TLOADi Bulk Data entries are referenced by
the DLOAD set identification number in CASECC. Output by FRLG.
FREQ1 Integer. Frequency set identification number in the first frequency subcase. Output
by DSAD.
FREQ345 Logical. Flag indicating presence of FREQ3, FREQ4, and FREQ5 Bulk Data
entries.
FREQDEP Logical. Frequency-dependent element flag. Set to TRUE if frequency-dependent
elements are present or to be processed. Output by TA1.
FREQINDX Integer. Frequency or time step index. Selects frequency associated with UA.
FREQTYP Character. Frequency dependent element processing mode:
Name Type and Description
Main Index
1647 Glossary
Parameter Glossary
'ESTF' Compute frequency dependent stiffness
'ESTNF' Compute nominal frequency dependent stiffness
FREQVAL Real. Frequency value for frequency dependent element generation. Output by
FRQDRV.
FREQWA Real. Parameter for electromagnetic analysis.
FRM Real. Fractional mass for designed structure.
FRMASS Real. Fractional mass of designed structure.
FROMLABL Character. The label associated with the present group set.
FRQLOOP Integer. Frequency loop counter. On input, FRQLOOP should be initialized to 0
before the loop. On output, FRQLOOP is incremented by one and at the last
frequency, FRQLOOP is negated. For example, if the fifth frequency is the last then
FRQLOOP is output as -5. Output by FRQDRV.
FSDCYC Logical. Fully stressed design cycle flag. Set to TRUE if this is a fully stressed
design cycle.
G Real. Uniform structural damping coefficient. Usually input by user parameter.
GAMMAD Complex double precision. This is the scalar multiplier for [C].
GDRTYP Character. Solution type.
DIRECT NOYSET is obtained from DYNRED Bulk Data entry
ODAL NOYSET is estimated
GEOMU Integer. Fortran unit number to which the DBC module writes geometric
information.
GETNUMPN Logical. Panel static load computation flag. If TRUE then get number of panels flag
only and do not compute panel static loads.
GMAFLG Integer. Test control flag for changes in the set identification numbers specified for
the SDAMPING, K2PP, M2PP, B2PP, and TFL commands.
GNLSTN Integer. Geometric nonlinear strain flag. Usually input by user parameter.
0 Small strain
1 Green strain
GPF Integer. Parameter for electromagnetic analysis.
GPFNAM Character. NDDL name of the OGPF1.
GPFORCE Integer. The number of columns in FENL. If GPFORCE less than or equal to zero
then no GPFORCE or ESE command is present.
GPLABEL Character. The label associated with the new set of subgroups.
GPSOPT Integer. GPSTR2 output option bits numbered right to left.
Bit Description
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1648
1 Requests that direct stresses/strains for volume always be output. (This is
an MSC.ADAMS MNF requirement).
2 Requests that principal stresses/strains for volume always be output
3 Set device code bit in OGS1s Id record to indicate plot only for direct
stress/strain for volume
4 Set device code bit in OGS1s Id record to indicate plot only for principal
stress/strain for volume.
GRDPNT Integer. Reference grid point identification number. Inertias are computed
GRDPNT. If GRDPNT=-1 then the origin of the basic coordinate system is used.
Output by VECPLOT.
GRIDFMP Integer. Case Control set identification number of fluid grids that will be output.
GRIDMP Integer. Case Control set identification number for a set of fluid grids.
GRIDSET Integer. SET Case Control command identification number which contains a list grid
point identification numbers.
GRPSZ Integer. The number of processors in each subgroup.
GUSTAERO Integer. QHJ computed only if GUSTAERO<0.
GUST2ID Integer. GUST2 Bulk Data identification number.
HDRLBLi Character. Header with up to 64 characters to be printed and centered at the top of
each page.
HEATCC Logical. Heat transfer analysis subcase flag. Set to TRUE if at least one
ANALYSIS=HEAT command was found in CASECC and CASEHEAT is specified
in the output list. Output by MDCASE.
HFREQ Real. Upper frequency limit of modes to use in modal transformation.
HINDEX Integer. Harmonic index.
HNAMEi Character. For INPUTT2, HNAMEi is the data block name found in the header of
DBi on the Fortran unit. For OUTPUT2, HNAMEi is data block name to written into
the header for DBi on the Fortran unit. Output by INPUTT2.
HPFLAG Integer. Element type processing flag.
1
h-element
2
p-element
IAPP Integer. Analysis type. Allowable values are:
1
Statics, aerostatic, frequency, or transient response
2
Buckling or normal modes
3
Flutter or divergence
IBAND Integer. Current band identification number.
Name Type and Description
Main Index
1649 Glossary
Parameter Glossary
IBLK Integer. Initial block size.
ICCOL Integer. Column number of static solution matrix as derived from the IC(STATSUB)
Case Control command specification. Output by GETCOL.
ICOL Integer. Column number of a matrix element.
IEXT Integer. Extraction level for reduced incomplete Cholesky factorization. See the
SOLVIT, 1428 module description.
IFRMAS Integer. Fractional mass response type.
IFTM Integer. Fourier transform method.
0 Constant
1 Piecewise linear (default)
2 Cubic spline
IMACHNO Integer. Mach number (MACH) multiplied by 1000 and specified as an integer.
IMAG Real. Imaginary part of matrix or table element. Output by PARAML.
IMETHOD Integer. Nonlinear transient analysis flag. Input and output by CASE.
IBELONG Integer. A zero value of this parameter indicates that the processor does not belong
to any of the subgroups associated with the TOLABEL label.
INCGRP Input. The stride from the first processor identification number of the parent group
which is included in a given subgroup, to the processor identification number of the
parent group which corresponds to he first processor identification number which is
included in the next subgroup.
INCPID Integer. The stride from one processor identification number of the parent group that
is included in a given subgroup, to the next processor identification number of the
parent group which is included in the same group.
INDDOF Integer. If INDDOF<>0 then CLASS=DISP path is taken using RBE3D code with
Ci=INDDOF
INTGR Integer. Integer value of table element. Output by PARAML.
INTi Integer. Integer value for PRGNAME.
INVA Integer. Inversion flag of A. In INVA=-1 then invert A.
INVOKE Logical. Restart deletion invocaton flag.
IOPT Integer. LOADSET Case Control command processing flag. If IOPT=0, then the
LOADSET command is ignored and all LSEQ entries will be used to expand
CASECC. If IOPT=1, then only those LSEQ entries selected by the LOADSET
command will be used. Integer. Case Control command selection flag for the
MTRXIN module.
Integer. Normalization method.
Integer. Matrix partition or merge option.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1650
Integer. VECPLOT module output option.
IOSTAT Integer. FORTIO status return code. Output by FORTIO. For OPERATN='OPEN' or
'CLOSE':
0 Successful
1 Unsuccessful
For OPERATN='EXISTS':
0 Assigned physical file exists
1 Assigned physical file does not exist
IP1 Integer. Parametric data depending on MDOPT.
IP2 Integer. Parametric data depending on MDOPT.
IPAD Integer. Padding level for reduced incomplete Cholesky factorization. See the
SOLVIT, 1428 module description.
IPANEL Integer. The number of records to skip to get the required data in the PANSLT table.
IROW Integer. Row number of a matrix element. Output by PARAML.
IRTN Integer. External program return code. Output by ISHELL.
ISENS Integer. Set to 1 if a sensitivity analysis is to be performed in the ASG module.
ISKIP Integer. Counter to update penalty values in BGP; updates on first pass and no
update later.
ISOFLG Integer. Parameter for electromagnetic analysis.
ITAPE Integer. MACOFP module Fortran unit positioning option.
0 No action before write
-1 Rewind before write
-1 A new unit is mounted before write and rewind at end
-3 Rewind at start and end
-4 Dismount old unit and mount new unit
INPUTT2/OUTPUT2 module Fortran unit positioning option.
+n Skip forward n data blocks before reading/writing
0 No action before reading/writing
-1 Rewind before reading/writing
-3 Print data blocks and then rewind before reading/writing
-9 Write a final EOF (OUTPUT2 only)
INPUTT4/OUTPUT4 module Fortran unit positioning option.
0 No action before reading/writing
-1 Rewind before reading/writing
Name Type and Description
Main Index
1651 Glossary
Parameter Glossary
-2 Rewind after reading/writing
-3 Rewind before and after reading/writing
ITERID Integer. Nonlinear analysis iteration count. Output by NLITER, NLSOLV, and
NLTRD2.
ITIME Real. Time instant at which the dynamic loads are evaluated and converted to static
loads.
ITIME0 Real. Initial time step at the beginning of a current STEP case.
ITOPT Integer. Preconditioner method for iterative solver. See the SOLVIT, 1428 module
description.
ITSEPS Integer. Power of ten for convergence parameter epsilon for iterative solution
method. On output, set to 0 for convergence and 1 for no convergence.
ITSEPSR Real. Convergence parameter epsilon for iterative solution method.
ITSERR Integer. Iterative solver return code. Output by SOLVIT.
1 No convergence
2 Insufficient memory
ITSMAX Integer. Maximum number of iterations for iterative solution method.
ITSOPT Integer. Preconditioner flag for STATICS and SOLVIT module.
IUNIT Integer. Fortran unit number.
IUNITi Integer. Fortran unit number.
IUNITSOL Integer. If IUNITSOL=0, then trim solution is being supplied. If IUNITSOL>0, then
IUNITSOL'th unit solution is being supplied.
IVALUE Integer. Integer value to search for in a table.
JPLOT Integer. Number of element plot sets. Set to -1 if there are none. Output by PLTSET
and SEPLOT.
K6ROT Real. Normal rotational stiffness factor for CQUAD4 and CTRIA3 elements.
KBAR Real. Reduced frequency.
KDAMP Integer. Viscous modal to structural damping flag. If set to -1, then viscous modal
damping (SDAMPING Case Control command) will be included in the stiffness
matrix as structural damping.
KDGEN Integer. Differential stiffness matrix generation flag. Usually the column number in
UG to use in differential stiffness matrix generation.
KEY Character. Generic or NDDL name of a data block.
KFLAG Integer. Stiffness update flag. Set to -1 to update stiffness before starting bisection.
It reflects the NEWK and CONV status at the last converged solution or stiffness
update. Output by NLITER.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1652
KGTH Integer. Set to -1 if all harmonic identification numbers (in analysis set) have been
processed. Output by CYCLIC3.
KMATUP Integer. Stiffness matrix update count within the increment. Output by NLITER.
KRATIO Complex. Stiffness ratio to be used for time step adjustment. Output by NLTRD2
and NLSOLV.
KSTEP Integer. Frequency of solve in complex eigenvalue analysis.
KSYM Integer. Symmetric decomposition flag. Output by DCMP and DECOMP.
KTIME Real. CPU time remaining. If KTIME is positive then KTIME is the time remaining
at the start of the stiffness update. If negative, no stiffness update was done since the
last exit from NLITER. KTIME still holds the negative of the stiffness update time
from the last stiffness update. Output by NLITER, NLSOLV, NLTRD, and
NLTRD2.
LABL Character. Label on the Fortran unit identified by IUNIT.
LANGLE Integer. Large rotation calculation method:
1 Gimbal angle
2 Rotation vector
LASTBULK Logical. Flag to indicate the current Bulk Data section is the last section in the input
file. Output by XSORT.
LASTCC Integer. Last auxiliary model Case Control section flag. Output by IFP1.
LASTCNMU Real. Last converged value of the arc-length load factor. Output by NLITER.
LASTSE Integer. Last superelement flag. Set to -1 if the current superelement is the last to
process. Output by SEP2DR and SEDRDR.
LASTUPD Integer. The time step number of the last stiffness update. Set to 0 if the stiffness
update is performed due to the CGAP element during the iteration. Output by
NLTRD and NLTRD2.
LCOLLBLi Character. Label with up to 32 characters to be printed left-justified in upper left
corner of each page.
LDSEQ Integer. PG column number. On input, last column number of PG on previous SELA
execution. On output, last column number of PG on current execution. Output by
SELA.
LFREQ Real. Lower frequency limit of modes to use in modal transformation.
LGDISP Integer. Large displacement and follower force flag.
-1 No large displacement and follower force effects will be considered.
1 Large displacement and follower force effects will be considered.
2 Only large displacement effects will be considered.
Name Type and Description
Main Index
1653 Glossary
Parameter Glossary
LINC Integer. Number of load increments for this subcase.
LISET Integer. Size of interference js-set extracted from the AEBGPTI table. Output by
MTRXIN.
LJSET Integer. Size of js-set extracted from the AEBGPTJ table. Output by MTRXIN.
LKSET Integer. Size of ks-set extracted from the AEBGPTK table. Output by MTRXIN.
LMFACT Real. Lagrange multiplier scale factor. Usually input by user parameter and
overrides system cell 374.
LMODES Integer. The number of lowest modes to use in modal transformation. All outputs
will have LMODES number of columns.
LMTROWS Integer. Number of Lagrange Multipliers appended to the A matrix. These rows are
excluded from the internal reordering in the DCMP module.
LOAD Integer. LOAD Case Control command set identification number specified in the
fourth word of the NSKIP-th record of CASECC.
LOADFAC Complex. Load factor. The real part is the load factor for the current iteration, having
a fractional value between 0 and 1. Output by NLITER.
LOADFACR Real. Load factor in nonlinear static analysis. (Same as LOADFAC except real).
LOADID Integer. Load set identification number for the current subcase.
LOADIDF Integer. Load set identification number of the newly created static load set of
follower forces. Output by DLT2SLT.
LOADIDP Integer. Load set identification number for the previous subcase.
LOADU Integer. Fortran unit number to which the DBC module writes static load
information.
LOOPIDL Output-integer. Last output loop identification number. Output by NLRSLOOP.
LPFLG Integer. Flag to indicate whether there is another CASEA record to process. Set to -
1 for the last subcase and Mach number. Output by AELOOP and DSARLP.
LPRINT Logical. Print flag for divergence analysis (DIVERG), flutter analysis (FA1), and
stability derivatives (SDP).
LSEQ Integer. LOADSET Case Control command set identification number specified in
the 205-th word of the NSKIP-th record of CASECC.
LST2REC Integer. Last two records write flag. Set to TRUE to write last two records.
LSTEP Integer. Load step. The current iteration step at the subcase level for static solutions.
LSTRN Integer. Laminar strain flag.
0 Compute laminar stresses
1 Compute laminar strains
LUMPB Real. Lumping factor for electromagnetic damping.
LUMPM Real. Lumping factor for electromagnetic mass.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1654
LUSET Integer. The number of degrees-of-freedom in the g-set. Output by GP1 or
PARAML.
LUSETD Integer. The number of degrees-of-freedom in the p-set. Output by DPD.
LUSETS Integer. The number of degrees-of-freedom in the g-set of the current superelement.
Output by GP1.
M36OPT Integer. Suboption of MATMOD Option 36.
MACH Real. Mach number. Output by AELOOP and DSARLP.
MACH0 Real. Previously processed Mach number. Output by AMG.
MAJOR Character. Name of the major degree-of-freedom set.
MASSQUAL Character. Name of the qualifier used to qualify the MGG*.
MASSETID Integer. Identification number of the MASSSET Case Control command.
MATCH Integer. Type of fluid/structural mesh matching. Output by GP5.
0 Matching mesh
1 Non-matching mesh
MATCPX Integer. Complex material properties flag for electromagnetic elements.
MATIDXi Integer. Index to the current name in the SET containing the DMIG names.
MATNAMi Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI Bulk Data
entries.
MATTYPE Character. Input matrix type flag.
Value Input Matrix Description
MONDSP1 X1=Displacement matrix X2 thru X4 are ignored and may
be purged
MONPNT1 X1=Inertia loads matrix
X2=External Loads matrix
X3=Flexible Increments matrix
X4=Rigid Gust loads matrix
MAXBLK Integer. Maximum block size.
MAXLP Integer. Maximum limit allowed for element relaxation iteration and the material
subincrement processes.
MAXNUSE Integer. Absolute maximum number of states to use for the interpolation.
MAXR Integer. Maximum physical record size.
MAXRAT Real. Maximum value of factor diagonal ratio. Output by DECOMP.
MAXRATIO Real. Minimum value of factor diagonal ratio which causes termination of
decomposition.
Name Type and Description
Main Index
1655 Glossary
Parameter Glossary
MAXSET Integer. Vector block size for Lanczos method only. The actual value of block size
may be reduced depending on available memory and problem size.
MBCFLG Logical. Multiple boundary condition in static analysis flag. Set to TRUE if multiple
boundary conditions are specified in static analysis.
MCEIGCC Logical. Modal complex eigenvalue analysis subcase flag. Set to TRUE if at least
one ANALYSIS=MCEIG command was found in CASECC and CASECEIG is
specified in the output list. Output by MDCASE.
MDCEQV Integer. MODACC equivalence flag. If MDCEQV=-1 on output then no output
truncation occurred and a subsequent EQUIVX statement may be used to
equivalence the inputs to the outputs. Output by MODACC.
MDLGDEF Integer. Minimum number of dofs which activates special ACMS DECOMP/FBS
method in READ module for buckling problems (FORMAT<>"MODES").
MDOPT Integer. Option selection number as described below.
MDTRKFLG Integer. Mode tracking status flag.
0 Mode tracking was successful
1 Mode tracking was unsuccessful
MESH Character. Shading summary print flag. Set to 'YES' to print summary; 'NO'
otherwise. Mesh type for aerodynamic or structural components: 'AERO' or 'STRU'.
MESHSET Integer. MSGMESH set processing flag. If nonzero, then combine mesh sets defined
in the MSGMESH punch file.
METH Character. Method of real eigenvalue extraction.
METHCMRS Integer. Residual structure METHOD set identification (SID) override.
METHCMRS>0 overrides SID value specified in CASES.
METRIK Integer. Parameter for electromagnetic analysis.
MINDIAG Real. Norm of the minimum diagonal term in U. Output by DCMP and DECOMP.
MFACT Complex. Scale factor for hydroelastic boundary mass matrix. Output by BMG.
MFLG Integer. Flag to indicate whether there is another Mach number to process in the
current subcase. Set to 0 for the last Mach number in the subcase. Output by
AELOOP.
MGEFLAG Integer. Multiple structural damping flag for PSHELL, PBUSH, and PBUSHT
property entries. Output by TA1 and EMG.
MINNUSE Integer. Absolute minimum number of states to use for the interpolation.
MINVAR Character. Type of coupling for output of nine mass invariants, M9I:
CONSTANT 1, 2, 6 AND 7 only
PARTIAL All except 5 and 9
FULL All
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1656
NONE None
MFRQCC Logical. Modal frequency response analysis subcase flag. Set to TRUE if at least one
ANALYSIS=MFREQ command was found in CASECC and CASEFREQ is
specified in the output list. Output by MDCASE.
MKERRCHK Logical. MAKMON error check flag.
TRUE Perform check
FALSE Do not perform check
MNEWK Integer. Matrix update flag for 3D contact. MNEWK < 0 means no and MNEWK >
0 means yes. Output by NLSOLV.
MNFOUT Character. Output control of modal neutral file and nine mass invariants, M9I:
MNF Modal neutral file only
NINEMAI M9I only
BOTH Modal neutral file and M9I
MODE Character. Boundary condition change ignore flag.
'NONLINEAR'Ignore boundary condition changes
'STATICS'Do not ignore boundary condition changes
MODECC Logical. Normal modes analysis subcase flag. Set to TRUE if at least one
ANALYSIS=MODES command was found in CASECC and CASEMODE is
specified in the output list. Output by MDCASE.
MODEPT Logical. Analysis model element property modification flag. Set to TRUE indicates
that the design model is overriding element properties in the analysis model. Output
by DOPR1.
MODETRAK Integer. Mode tracking request flag.
0 Mode tracking was not requested.
>0 Mode tracking is requested.
MODGEOM2 Logical. Analysis model connectivity modification flag. Set to TRUE indicates that
the design model is overriding connectivity in the analysis model. Output by
DOPR1.
MODGM4 Logical. GEOM4P update flag. Set to TRUE if GEOM4M is updated. Output by
MODGM4.
MODMPT Logical. Analysis model material property modification flag. Set to TRUE indicates
that the design model is overriding material properties in the analysis model. Output
by DOPR1.
MONRPLC Logical. If TRUE then components with duplicate names will be copied from
MON1 into MON.
MONTYPE Character. Monitor point type.
Name Type and Description
Main Index
1657 Glossary
Parameter Glossary
STRUCTURAL Structural monitor points
AERODYNAMIC Aerodynamic monitor points
MPC Integer. MPC Case Control command set identification number specified in the
second word of the NSKIP-th record of CASECC.
MPCF2 Integer. Multipoint constraint set identification number change flag. Set to 1 if the
current subcase contains a different multipoint constraint set from the previous
subcase. Set to -1, otherwise, or if there are no multipoint constraints in the current
subcase. Output by GP4.
MPCFLG Integer. Controls whether the grid point connectivity created by multipoint
constraint Bulk Data entries (MPC, MPCADD, and MPCAX and the rigid element
entries; e.g., RBAR) is considered during resequencing.
MPCMETH Character. Multipoint constraint processing method. Also indicates the type of
matrix in the second input position: 'RG' for RMG and 'KMM' for KMM.
MPFSORT Integer. Sort flag. A value in the first table is added to a value in the second table.
MPNFLG Integer. Set to 1 if multiple panels exist. Output by GP5.
MSCHG Integer. Boundary condition change flag in. In nonlinear static analysis only. Output
by CASE.
MSGINP1 Integer. Optional integer input.
MSGINP2 Integer. Optional integer input.
MSGLVL Integer. The level of diagnostic output for the Lanczos method only.
0 No output
1 Warning and fatal messages
2 Summary output
3 Detailed output on cost and convergence
4 More detailed output on orthogonalizations and some extra arithmetic to
check on orthogonality
Integer. Diagnostic output flag in the SEQP module.
0 No
1 Yes
Integer. Diagnostic output flag in the SOLVIT module.
0 Minimal; i.e, UIM 6447
1 UIM 6447, convergence ratios, and residual norms
Integer. Diagnostic output flag in the TABEDIT module.
MSGNUM Integer. Message number.
MSGOUT Integer. Optional integer output. Output by MSGHAN.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1658
MTRNCC Logical. Modal transient response analysis subcase flag. Set to TRUE if at least one
ANALYSIS=MTRAN command was found in CASECC and CASEMTRN is
specified in the output list. Output by MDCASE.
MU Real. The magnitude of the last g-set displacement matrix. Output by NLTRD.
NAME Character. Name of a data block. Output by PARAML.
NASOUT Logical. Print flag for fluid/structural mesh matching summary.
NBCONT Integer. Number of bisections due to slideline contact. Output by NLITER,
NLSOLV, and NLTRD2.
NBIS Integer. Current bisection counter. Output by NLITER, NLSOLV, and NLTRD2.
NBLOCK Integer. Number of spill blocks to form if out of memory algorithm is used.
NBLSEQ Integer. Number of new LSEQ entries created. Output by ST2DYN.
NBNLST Integer. Number of nonlinear static records. Output by T2DYN.
NBRCHG Integer. Number of negative terms on the diagonal. Output by DCMP and DECOMP.
NBSORT2 Integer. Contact region output sort format flag. Output by BGCASO.
1 If SORT2 format is requested for printing
2 If x-y plotting is requested
NCASE Integer.
NCNOFFST Integer. Counter for retained constraints. The value is initialized to 1 in and is
incremented by the number of records in CNTABR. Output by DSAD and DSADX.
NCOL Integer. Number of columns (i.e.; subcases, modes, time steps or frequencies)
desired in the output matrices. By default, all data records will be converted into the
output matrices. If NCOL is less than the number of data records in the input table,
then the first NCOL records are converted and the remaining records are ignored.
Output by TRD1 and TRD2. Integer. Number of columns. Output by NORM.
NCOLMNP2 Integer. Number of degrees-of-freedom associated with the MONPNT2 entries.
NCOLT Integer. Column number in output of previous run from which the integration is to
be continued. Output by TRLG.
NCUL Integer. Number of columns desired in the solution matrix for the residual structure.
Usually determined by the PARAML module.
ND Integer. The number of desired eigenvalues.
ND1 Integer. The number of desired eigenvalues in first complex region.
NDAMP Real. Numerical damping.
NDDLNAME Character. NDDL name of the OGPFB1 data block.
NDDLNAMi Character. NDDL name of the DBi-th data block.
NDES Integer. The number of desired eigenvalues. If the last mode is repeated, then nDes
+ m (where m is the multiplicity of the last mode) solutions are found.
Name Type and Description
Main Index
1659 Glossary
Parameter Glossary
NDJ Integer. The number of desired eigenvalues in j-th complex region. for pre-Version
70.5 Lanczos method.
NDVTOT Integer. Number of unique referenced design variables.
NE Integer. Number of estimated eigenvalues. Integer. The number of estimated
eigenvalues for non-Lanczos methods only. For the Lanczos method, NE is the
problem size which the QL Householder method is used.
NEIG Integer. Number of eigenvalues to keep.
0 Keep all eigenvalues
>0 Keep first NEIG-th eigenvalues
NEIGV Integer. The number of eigenvectors found. Set to -1 if none were found. Output by
CEAD, READ, LANCZOS, and UEIGL.
NEWBULK Output-logical-default=FALSE. NEWBULK creation flag. FALSE means no and
TRUE yes. Output by RMDUPBLK.
NEWCASE Integer. CASECCBO output flag. Set to 1 if CASSECBO is generated. Output by
BGCASO.
NEWEPT Integer. NEWEPT creation flag. 0 means no and -1 yes. Output by NSMEPT.
NEWGPSNT Logical. Updated shell normal table flag. If the GPSNTN table is created (shell
normal table is updated due to the interaction with RSSCON elements), then the flag
is set TRUE. Output by GP4.
NEWK Integer. Stiffness update flag. Output by NLITER, NLSOLV, NLTRD, and
NLTRD2.
-1 Do not update stiffness.
1 Update stiffness.
2 Update stiffness, the solution is diverging and MAXBIS has been reached.
NEWMSIZ Integer. Only the first NEWMSIZ entries in CPERM are turned on.
NEWNAMi Character. The generic name of the corresponding input table; e.g., NEWNAM3
corresponds to NEWDB3, etc.
NEWP Integer. New subcase flag. Output by NLITER, NLTRD, NLTRD2, and TOLAPP.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
NEWS Integer. New STEP case flag.
-1 Current STEP case has not been completed.
1 Current STEP case has been completed.
NEWSTEP Integer. STEP case flag. Output by NLRSLOOP.
-1 Not a new STEP case
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1660
1 New STEP case
0 Cold start from the first SUBCASE, first STEP case and TIME=0.0
NEXTID Integer. Identification number which appears on the BEGIN BULK command of the
next Bulk Data section; usually superelement or auxiliary model identification
number. Output by XSORT.
NFEXIT Logical. Termination flag. If FALSE do not issue User Fatal Message 2070 and do
not terminate the module if the matrix is not found.
NFREQ Integer. Number of frequencies for frequency response analysis. Output by
CYCLIC1.
NGERR Integer. Error flag. If errors are encountered, then NGERR is set to -1; otherwise +1.
Output by GPSP.
NGP Integer. Number of grid points and scalar points in the structure. Output by PLTSET
and SEPLOT.
NHBDY Integer. Number of CHBDYi elements. Set to -1 if none exist. Output by PLTHBDY.
Ni Character. Continuation entry prefix.
NINPTPS Integer. Approximate number of surrounding independent element interpolation
points to be considered when interpolating at a grid point for a given material
coordinate system.
NJ Integer. Number of degrees-of-freedom in j-set degrees-of-freedom. Output by
APD.
NK Integer. Number of degrees-of-freedom in k-set degrees-of-freedom. Output by
APD.
NKEYS Integer. Duplicate value sort option specification.
NLAM Integer. Number modes to create in LAMAX.
NLATYPE Character. Type of nonlinear analysis.
NLTR Nonlinear transient
NLST Nonlinear statics
LNST Linear statics
NLAYERS Integer. Number of layers to integrate through the thickness of CQUAD4 and
CTRIA3 elements in nonlinear analysis.
NLFLAG Integer. Output by NLITER.
NLOADS Integer. The number of subcase records contiguous with respect to the MPC and SPC
command in the first subcase of the current boundary condition.
NLOFLAG Integer. Output control flag. Output by NLSOLV.
On input:
Name Type and Description
Main Index
1661 Glossary
Parameter Glossary
< 0 Print the title lines for iteration message and/or print the output-only
information before exiting.
> 0 Do not print the title lines for iteration message.
On output--output exit:
= 0 No
> 1 Yes
NLPACK Integer. Nonlinear transient analysis append flag.
<=0 Append all output time steps together in each STEPcase before processing
the output procedure
> 0 Append the value of NLPACK output time steps together in each
STEPcase before output procedure
NLRIGID Integer. Nonlinear rigid element flag. Overrides system cell 377. Output by
MODGM2.
< 0 No nonlinear rigid element exists; use linear elimination.
= 0 Nonlinear rigid elements exist and the Lagrange multiplier method is used
to obtain the solution.
> 0 Nonlinear rigid elements exist and the elimination method is used to
obtain the solution.
NLSTRAIN Logical. Nonlinear strain data recovery, otherwise flag at word 11 of OES1 takes
precedence. Set to TRUE if nonlinear strains are to be processed.
NLTYPE Integer. Nonlinear analysis type.
0 Statics
1 Transient response
NMASS Integer.
NMAT Integer. Number of matrices.
NMATDOM Integer. Number of matrix domains into which the matrices are divided.
NMATDOM is used only with PRSLOPT=3 and must be a power of 2. The default
will be set to the number of processors.
NMK Integer. Number of Mach number and reduced frequency pairs. Output by
GETMKL.
NNDEGV Integer. Number of new natural frequencies related to eigenvector sensitivity.
Output by DSAH.
NNDFRQ Integer. Number of forcing frequencies which depend upon natural frequencies.
NNDGM Integer. Number of natural frequencies related to generalized mass. Output by
DSAH.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1662
NNDGS Integer. Number of natural frequencies related to generalized stiffness. Output by
DSAH.
NNEWM Integer. The number of new m-set degrees-of-freedom. Output by GPSP.
NNEWS Integer. The number of new s-set degrees-of-freedom. Output by GPSP.
NOA Integer. Constraint and omit set flag. Set to -1 if NOMSET=-1, NOSSET=-1, and
NOOSET=-1; otherwise the number of degrees-of-freedom in the a-set. Output by
GP4 and GPSP.
NOABFL Integer. Matrix ABFL existence flag; 0 if ABFL exists and -1 otherwise. Output by
BMG.
NOASET Integer. The number of degrees-of-freedom in the a-set.
NOASM Integer. Matrix assembly flag. Set to -1 if no matrix assembly and reduction is
requested for the current superelement based on the SEKR or SEALL Case Control
commands. Output by SEP2DR and SEP3.
NOCSTMX Integer. CSTMX creation flag. Output by MRGCSTM.
0 CSTMX not created
1 CSTMX created
NOB2 Integer. B2GG or B2PP generation flag. Set to +1 if B2GG or B2PP is generated; -
1 otherwise. Output by MTRXIN.
NOBGG Integer. Same as NOKGG except for BELM and BDICT. Output by EMG.
NOBKGG Integer. Slideline contact stiffness generation flag. Set to 1 to generate slideline
contact stiffness.
NOBSET0 Integer. Number of null columns in PHZ in front of non-null columns. Output by
DYNREDU.
NOCEAD Integer. Complex eigenvalue analysis flag. Set to 1 if complex eigenvalue analysis
needs to be performed, otherwise, set to -1. Output by FA1.
NOCHAR Integer. Number of character value inputs.
NOCMPX Integer. Number of complex value inputs.
NOCOMP Integer. Composite stress/strain flag.
-5 Forces of composites in STRAIN=sid
-2 Forces of composites in STRESS=sid
-1 Stresses for all elements (same as 0 except in DMAP)
0 Stresses for all elements
1 Stresses for non-composites only
2 Strain/curvature and forces of composites in STRESS=sid
3 Strains for all elements and MPCForces
Name Type and Description
Main Index
1663 Glossary
Parameter Glossary
4 Strains for non-composites only
5 Strain/curvature of composites in STRAIN=sid
NODLT Integer. Set to 1 if dynamics loads Bulk Data entries are processed, -1 otherwise. 1
also means DLT is created. Output by DPD.
NODR Integer. Data recovery request flag. Set to -1 if there is no data recovery requested
for any superelement. Output by SEDRDR and SEP4.
NOEDS1 Integer. OEDS1 generation flag. Set to 0 if OEDS1 is generated. Output by
STDCON.
NOEED Integer. Set to 1 if eigenvalue extraction Bulk Data entries are processed, -1
otherwise. 1 also means EED is created. Output by DPD.
NOEGPSF Integer. EGPSF creation flag. Set to zero if EGPSF is created.
NOEGPSTR Integer. EGPSTR creation flag. Set to 0 if EGPSTR is created. Output by GPSTR2.
NOELDCT Integer. ELDCT generation flag. Set to 0 if ELDCT is generated. Output by
STDCON.
NOEPT Integer. EPTX generation flag. Output by MODGM2.
0 generated
-1 not generated
NOEST Integer. Processing status flag. Output by MATMOD option 38.
NOESTL Integer. ESTL generation output flag. Set to 1 if ESTL is generated; -1 otherwise.
Output by TA1.
NOFORT Integer. OUTPUT4 flag. Set to 0 if FORT is requested on the SENSITY Case
Control command. Output by DSTA.
NOFREQ Integer. Number of excitation frequencies.
NOFRL Integer. FRL generation flag. Set to -1 if FRL is not generated. Output by FRLGEN.
NOGDS1 Integer. OGDS1 generation flag. Set to 0 if OGDS1 is generated. Output by
STDCON.
NOGEOM1 Integer. Processing status flag. Output by MATMOD option 36.
NOGEOM2 Integer. Processing status flag. Output by MATMOD option 37.
NOGEOM3 Integer. GEOM3N creation flag. Set to 1 if GEOM3N is created, otherwise set to -
1. Output by CYCLIC1.
NOGENL Integer. The number of general elements. Set to -1 if there are no general elements.
NOGOIFP Logical. IFP module error return flag. Set to TRUE if an error was detected. Output
by IFP.
NOGOIFPi Logical. IFPi module error return flag. Set to TRUE if an error was detected. Output
by IFPi.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1664
NOGOMEPT Logical. MODEPT module error return flag. Set to TRUE if an error was detected.
Output by MODEPT.
NOGOMGM2 Logical. MODGM2 module error return flag. Set to TRUE if an error is found.
Output by MODGM2.
NOGONL Integer. Nonlinear "no-go" flag. Set to +1 to continue or -1 to terminate. Output by
NLTRD2 and NLSOLV.
NOGOXSRT Logical. XSORT module error return flag. Set to TRUE if an error was detected.
Output by XSORT.
NOGPDCT Integer. GPDCT generation flag. Set to 0 if GPDCT is generated. Output by
STDCON.
NOGRAV Integer. Gravity load existence flag. Set to -1 if no GRAV Bulk Data entry images,
+1 otherwise. Output by GP3.
NOGUST Integer. Gust load flag. Set to -1 if no gust loads exist; otherwise set to 1. Output by
GUST.
NOINT Integer. Number of integer value inputs for PRGNAME.
NOK2 Integer. K2GG or K2PP generation flag. Set to +1 if K2GG or K2PP is generated; -
1 otherwise. Output by MTRXIN.
NOK4GG Integer. Differential stiffness or structural damping generation flag. Output by EMG.
On input:
>3 Compute geometric nonlinear effects
<3 Do not compute geometric nonlinear effects
On output:
1 If structural damping coefficient (GE) is detected on material property
Bulk Data entry records
-1 Otherwise
NOKGG Integer. KELM and KDICT generation flag. Output by EMG.
On input:
0 Generate
-1 Do not generate
On output:
0 Generated
-1 Not generated
NOKBFL Integer. Matrix KBFL existence flag; 0 if KBFL exists and -1 otherwise. Output by
BMG.
NOKVAL Integer. Set to -1 if the value of HINDEX (K) is not in the analysis set of harmonic
identification numbers. Output by CYCLIC3.
Name Type and Description
Main Index
1665 Glossary
Parameter Glossary
NOL Integer. Dependent set flag. Set to -1 if all degrees-of-freedom belong to m-set, s-set,
o-set, and/or r-set; otherwise, the degrees-of-freedom in the l-set. Output by GP4.
NOLASM Integer. Load assembly flag. Set to -1 if no load assembly and reduction is requested
for the current superelement based on the SELR or SEALL Case Control commands.
Output by SEP2DR and SEP3.
NOLOAD Integer. Static load existence flag. Set to -1 if no static loads and SLT is not created,
+1 otherwise. Output by GP3.
NOLOADF Integer. Number of load cases per excitation frequency.
NOLOOP Integer. Looping test flag. Output by CASE.
NOM2 Integer. M2GG or M2PP generation flag. Set to +1 if M2GG or M2PP is generated;
-1 otherwise. Output by MTRXIN.
NOMAT Integer. Matrix generation flag. Set to -1 if no matrix generation is requested for the
current superelement based on the SEMG or SEALL Case Control commands.
Output by SEP2DR and SEP3.
NOMATi Integer. Generation flag. Set to +1 if MAT* is generated; 1 otherwise. Output by
MTRXIN.
NOMGEN Integer. Fluid mass existence flag. Set to the MFLUID set identification number if
MFLUID is specified in CASECC. Output by MGEN.
NOMGG Integer. Same as NOKGG except for MELM and MDICT. Output by EMG.
NOMPF2E Integer. Flag to generate O*MPF2E data blocks.
NOMPT Integer. MPTX generation flag. Output by MODGM2.
0 generated
-1 not generated
NOMR Integer. Mass and damping assembly flag. Set to -1 if no mass and damping
assembly and reduction is requested for the current superelement based on the
SEMR or SEALL Case Control commands. Output by SEP2DR and SEP3.
NOMSET Integer. Number of degrees-of-freedom in the m-set or multipoint constraint and
rigid element flag. Set to -1 if there are none. Output by GP4 or PARAML.
NOMSGSTR Integer. MSGSTRES execution flag. Set to -1 if MSGSTRES execution is not
desired.
NONAMEi Integer. NAMEi generation flag. Set to +1 if NAMEi is generated; -1 otherwise.
Output by MTRXIN.
NONCUP Integer. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if
SOLTYP='MODAL' and KXX, BXX, and MXX are diagonal. NONCUP=-2,
requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX will
be ignored. GKAM: If K2DD, B2DD, and M2dd are purged. then the model is
considered uncoupled and NONCUP is set to -1.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1666
NONLFT Integer. Set to 1 if nonlinear forcing function Bulk Data entries are processed, -1
otherwise. 1 also means PSDL is created. Output by DPD.
NONLHT Integer. Nonlinear heat transfer flag. Set to -1 if nonlinear heat transfer elements are
detected. Output by EMG.
NONLNR Logical. Nonlinear solution sequence flag. Set to TRUE if nonlinear solution
sequence is being executed.
NOOGS1 Integer. OGS1 creation flag. Set to 0 if OGS1 is created. Output by GPSTR2.
NOOPT Integer. FRLGEN reexecution flag. Set to -1 for no reexecution. Output by
FRLGEN.
NOOSET Integer. Number of degrees-of-freedom in the o-set or omitted degree-of-freedom
flag. Set to -1 if there are none. Output by GP4 or PARAML.
NOOUT Integer. Output request flag. Set to -1 if no output requests are specified for the
current superelement. Output by SEDR.
NOP2G Integer. P2G generation flag. Set to +1 if P2G is generated; -1 otherwise. Output by
MTRXIN.
NOPG Integer. Upstream load presence flag. Set to -1 if there are no loads due to upstream
superelements. Output by SELA.
NOPGHD Integer. Page header and eject flag.
0 Print page header in f06 and label in f04.
-1 Do not print page header in f06.
-2 Do not print page header in f06 and label in f04.
NOPLOT Integer. Plot request flag. Set to -1 if no deformed plot requests are specified for the
current superelement. Output by SEDR.
NOPNLT Integer. Penalty function flag for electromagnetic elements.
NOPRT Integer. Print flag. Set to 1 if PRINT is requested on the SENSITY Case Control
command. Output by DSTA.
NOPSDL Integer. Set to 1 if random analysis Bulk Data entries are processed,
-1 otherwise. 1 also means PSDL is created. Output by DPD.
NOPSLG Integer. Pseudo-load generation flag. Set to -1 if no load generation is requested for
the current superelement based on the SEDV or SERESP Case Control commands.
Output by SEP2DR.
NOQG Integer. Single point forces of constraint matrix creation flag. Default of 1 requests
computation of the forces. Specify -1 to request no computation.
NOQMG Integer. Multipoint forces of constraint matrix creation flag. Default of 1 requests
computation of the forces. Specify -1 to request no computation.
NOQSET Integer. Number of degrees-of-freedom in the q-set.
NOQSETF Integer. Number of component modes in the fluid superelement.
Name Type and Description
Main Index
1667 Glossary
Parameter Glossary
NOQSETT Integer. Total number of component modes computed for all superelements
including the residual structure.
NORADMAT Integer. Radiation flag. Output by RMG2.
-2 No radiation
-1 Initial radiation
1 Single band radiation with constant emissivity
2 Radiation with temperature dependent emissivity
3 Multiple band radiation with constant emissivity
NORAND Integer. Set to -1 if no random analysis is requested; 0 otherwise. Output by
RANDOM.
NOREAL Integer. Number of real value inputs.
NORM Character. Method for normalizing eigenvectors. By default (or NORM='MASS'),
MASS normalization is performed. NORM='MAX' selects normalization by
maximum displacement.
NORMEV Integer. Eigenvalue normalization flag. Output by DOPR3.
0 Mass normalized
1 Maximum deflection normalized
NORQA Logical. Presence flag for RQA data block. Output by DSTAP2.
NORSET Integer. Number of degrees-of-freedom in the r-set. or supported degree-of-freedom
flag. Set to -1 if there are none. Output by GP4 or PARAML.
NOSASET Integer. Number of degrees-of-freedom in the a-set of the structure.
NOSAVE Integer. Data base store flag. Set to 0 if SAVE is requested on the SENSITY Case
Control command. Output by DSTA.
NOSDR2 Integer. Physical set (g-set) output flag. Set to 1 if any physical set output is
requested in CASECC or XYCDB; -1 otherwise. Output by VDR.
NOSE Integer. Superelement presence flag. Set to -1 if there are no superelements; 0
otherwise. In SEP1X only, set to number of superelements if superelements exist.
Output by SEP1 and SEP1X.
NOSECOM Integer. Superelement Case Control command flag. Set to -1 if there are no SEALL,
SEMG, SEKR, SELG, SELR, or SEMR commands specified in CASECC. Output
by SEP3.
NOSEDV Integer. Pseudo-load generation flag based on the SEDV Case Control command.
Set to -1 if pseudo-loads are not requested for any superelement. Output by SDSB.
NOSEPLOT Integer. SEPLOT or SEUPPLOT request flag. Set to -1 if there are no SEPLOT or
SEUPPLOT commands specified in the OUTPUT(PLOT) section. Output by SEP4.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1668
NOSERESP Integer. Response sensitivity calculation flag based on the SERESP Case Control
command. Set to -1 if response sensitivities are not requested for any superelement.
Output by SDSB.
NOSET Integer. Constraint, omit, and support set flag. Set to -1 if
NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-
freedom defined in the a-set (e.g., ASETi, QSETi Bulk Data entries); +1 otherwise.
Output by GP4, GPSP, and TRLG.
NOSETi Integer. Degree-of-freedom set existence flag. Set to positive integer if set i exists.
Output by PARAML.
NOSIMP Integer. The number of elements exclusive of general elements. Set to -1 if there are
no simple elements. Output by TA1 and TAHT.
NOSORT1 Integer. SORT1 format flag. Set to -1 if SORT1 format is not requested for current
superelement. Output by SEDR.
NOSORT2 Integer. SORT2 format flag. Set to 1 if SORT2 format is requested. Output by
MDATA, SDR2, and VDR.
NOSORT2S Integer. Solution set SORT2 format flag. Set to 1 if SORT2 format or
x-y plotting is requested for the solution set; -1 otherwise. Output by VDR.
NOSOUT Integer. Solution set (d- or h-set) output flag. Set to 1 if any solution set output is
requested; -1 otherwise. Output by VDR.
NOSSET Integer. Number of degrees-of-freedom in the s-set. or single point constraint flag.
Set to -1 if there are none. Output by GP4 or PARAML.
NOSUP Integer. Element summary table request flag.
1 Generate EST only (usually for linear analysis).
2 Form EST, ESTNL and ESTL (usually for nonlinear analysis).
NOTEMP Integer. Thermal load existence flag. Set to -1 if no TEMP or TEMPD Bulk Data
entry images in GEOM3 and ETT is not created, +1 otherwise. Output by GP3.
NOTFL Integer. The number of transfer function Bulk Data entries. Set to -1 if no sets are
defined. Output by DPD.
NOTIME Integer. Time out flag. Set to 1 if there is no time left for further iterations but enough
time to perform data recovery. Output by NLTRD.
NOTRACK Logical. Mode tracking success flag. Set to TRUE if mode tracking was successful.
Output by MODTRK.
NOTRL Integer. Set to 1 if transient time step parameter Bulk Data entries are processed, -1
otherwise. 1 also means TRL is created. Output by DPD.
NOUDCMP Integer. Solution matrix decomposition flag. Usually input by user parameter.
-1 Solution matrix will be decomposed.
1 Solution matrix will not be decomposed
Name Type and Description
Main Index
1669 Glossary
Parameter Glossary
NOUE Integer. The number of extra points. Set to -1 if there are no extra points. Output by
DPD or PARAML.
NOUG Integer. UG presence flag. Set to -1 if UG already exists for the current
superelement. Output by SEDR.
NOUGD Integer. Flag for external input of auxiliary model displacement matrix. If
NOUGD>0, then matrix exists.
NOUNIT Integer. Number of Fortran input units.
NOUP Integer. Upstream superelement flag. Set to -1 if there are no superelements
connected upstream from the current superelement. Output by SEP2DR and SEDR.
NOXGG Integer. XGG existence flag. Set to -1 if XGG does not exist. Output by MATREDU.
NOXOUT Integer. SDRX update flag. Output by SDRX and SDRXD.
0 OEF1X, OES1X, and OSTR1X are updated
-1 OEF1X, OES1X, and OSTR1X are not updated
NOXPLZER Integer. Explicit zero existence flag. Set to -1 if no explicit zeros are found. Output
by MATMOD option 39.
NOXPP Integer. XPP existence flag. Set to -1 if XPP does not exist. Output by MATREDU.
NOXYPLOT Integer. X-Y plot request flag. Set to -1 if no x-y plot requests are specified for the
current superelement. Output by SEDR and XYTRAN.
NOYSET Integer. Number of generalized degrees-of-freedom with non-null columns in PHZ.
NOZSET Integer. Number of generalized degrees-of-freedom. Also number of columns in
PHZ.
NPROC Integer. Total number of processors.
NQMAX Integer. Maximum number of auto-q-set's allowed per partitioned superelement. See
NQSET.
NQSET Integer. Number of automatic q-set degrees-of-freedom (auto-q-set). Each
superelement will have NQSET number of q-set degrees-of-freedom.
NR1OFFST Integer. Counter for retained type 1 responses. The value is initialized to 1 and is
incremented by the number of records in R1TABR. Output by DSAD.
NR2OFFST Integer. Counter for retained type 2 responses. The value is initialized to 1 and is
incremented by the number of records in RSP12R. Output by DSAD and DSADX.
NR3OFFST Integer. Counter for retained type 3 responses. The value is initialized to 1 and is
incremented by the number of records in RESP3R. Output by DSAD and DSADX.
NRANVAR Integer. Number of RANDVAR Bulk Data entries processed. Output by DOPR1.
NROW Integer. Number of rows. Output by NORM.
NSEG Integer. Number of cyclic segments as specified on CYSYM Bulk Data entry.
Output by CYCLIC1.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1670
NSENQSET Integer. Number of SENQSET degrees-of-freedom allocated to the current
superelement.
NSKIP Integer. Record number in CASECC with special meanings in the following
applications. Output by GP4, CASE, and BCDR. GP4, BCDR, and SDR1: The first
subcase of the current boundary condition.
CASE The first subcase of the current boundary condition
(nonlinear statics only) or current FREQ, K2PP, M2PP,
B2PP, TFL, or SDAMP condition (frequency response or
complex eigenvalue analysis).
AELOOP Trim subcase counter.
DSARLP Trim subcase counter.
FRRD1 and SOLVIT Record number of current subcase in CASECC and used
only if the SMETHOD command selects the ITER Bulk
Data entry which specifies values for the desired iteration
parameters. If NSKIP=-1 then CASECC is not required and
the values are taken from the module specification of the
values.
GETCOL Subcase record number to read in CASEBUCK for the
STATSUB subcase identification number.
GNFM Loop counter in old geometric nonlinear analysis (SOL 4).
READ and
LANCZOS
Subcase record number to read in CASECC for the
METHOD set identification number.
LCGEN Subcase record number to read in CASECC for the
LOADSET set identification number.
NLCOMB,
PCOMB, and SDRNL
Subcase record number to read in CASECC.
NLITER and
TOLAPP
On input: Subcase record number to read in CASECC. On
output: Set to -2 if run is to be terminated.
NSKIPR Output-integer. Total STEP cases in previous subcases from the restart point. Output
by NLRSLOOP.
NSMSID Integer. Set identification number from the NSM Case Control command.
NSOLT Integer. Column number in solution of previous run that corresponds to NCOL.
Output by TRLG.
NSOUT Integer. Number of time steps to output. By default all time steps are output.
NSTEP Integer. Current time step position for subcase, set to 0 at the beginning of the
subcase. Output by NLTRD and NLTRD2.
NSUBGP Integer. The number of subgroups to create in the new set.
Name Type and Description
Main Index
1671 Glossary
Parameter Glossary
NSWELM Integer. Current spot weld element identification number. Output by MODGM2 and
MODGM4.
NSWPPT Integer. Current spot weld projection point identification number.
NTIPS Integer. The number of domains (tip superelements to be created automatically when
ACMS='YES'. If NTIPS=0, then the number of domains will be set equal to the
number of processors. Output by SEQP.
NULLMAT Integer. Null matrix flag. Set to -1 if MAT is null.
NULLROW Integer. Flag to insert null rows in the output matrices for nonlinear quantities.
0 Insert null rows, which is compatible with DRMS1 output format
NUMDB Integer. Number of data blocks to broadcast.
NUMDIV Integer. Number of domains assigned to the part of the model which will not be
designed as specifed on DOPTPTM Bulk Data entry. Output by DSGRDM.
1 Do not insert null rows, which is required for DRMH3 processing
NUMHDOF Integer. The number of modes.
NUMOUT Integer. Output element quantity flag.
>0 Number of element quantities per element type to be output
0 Output all quantities for elements in a group if the absolute value of one
or more elements is greater than BIGER.
-1 Output sorted quantities with absolute value greater than BIGER.
-2 Output filtered quantities with absolute value greater than BIGER.
NUNIQF6 Integer. Number of unique Fortran units requested on POST command. Output by
MODCASE.
NUMPAN Integer. Number of panels. Output by GP5.
NVECT Integer. Number of columns in CVECT and PG1. Output by PCOMB.
NX Integer. Number of extra aerodynamic degrees-of-freedom. Output by ADG.
OADPMAX Integer. Total number of adaptivity cycles performed.
OBJIN Real. Initial objective value.
OBJOUT Real. Final objective value. Output by DOM9.
OBJSID Integer. Superelement identification number associated with DESOBJ. Set to -1 for
all cases unless the user specifies the DESOBJ command in a particular
superelement subcase. Output by MDCASE.
OBJVAL Real. Objective value. Output by DSAD and DSADX.
OCID Integer. Print flag for coordinate system identification number in grid point output.
The following bits in OCID are set to 1 based on user output requests.
1 displacements
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1672
2 applied loads
3 spcforces and mpcforces
7 eigenvectors
10 velocities
11 accelerations
Output by SDR2.
ODESMAX Integer. Total number of design cycles performed.
OG Integer. CURV module's grid point processing flag. If set to 0, then grid point
stresses or strains are computed.
OGRAV Integer. PGRV output flag.
> 0 Compute PGRV
<=0 Do not compute PGRV.
OGSTR1 Table of grid point strains in SORT1 format.
OLDDT Real. Time step increment used in the previous iteration or time step to be used after
the matrix update or subcase switch. Output by NLTRD, NLSOLV, and NLTRD2.
OLDNAMi Character. The generic name of the corresponding output; e.g., OLDNAM3
corresponds to OLDDB3, etc.
OMEGAJ Real. Imaginary part of shift point Aj for pre-Version 70.5 Lanczos method.
OMID Character. Material output coordinate system flag. If OMID='YES' then stresses,
strains, and forces are output in the material coordinate system of CQUAD4,
CTRIA3, CQUAD8, and CTRIA6 elements.
OPERATN Character. FORTIO operation.
'EXISTS' Check for assigned physical file existence
'OPEN' Open file
'CLOSE' Close file
OPT Character. DIAGONAL module processing option.
'COLUMN' Extract diagonal to a column matrix and raise all elements
to POWER
'SQUARE' Extract diagonal to a square matrix and raise all elements to
POWER
'WHOLE' Raise all elements to POWER
OPTi Integer. Print control parameters in the TABPRT module.
OPTEXIT Integer. Design optimization termination option. See the OPTEXIT (p. 904) in the
MSC Nastran Quick Reference Guide.
Name Type and Description
Main Index
1673 Glossary
Parameter Glossary
OPTFLG Integer. DSVG1P application method:
1 Statics
2 Normal modes
3 Ncceleration load
OPTION Character. Response summation method for scaled response spectra analysis.
Possible values are:
'ABS' Absolute
SRSS' Square root of the sum of the squares
'NRL' Naval Research Laboratory (new)
'NRLO' Naval Research Laboratory (old)
ORIGDT Real. Original delta-t for SOL 400. Output by CASE.
ORIGID Integer. Offset for rigid element Lagrange multiplier identification numbers. Usually
input by user parameter.
OSTEP Integer. Restart step number.
OSWELM Integer. Offset for spot weld element identification numbers.
OSWPPT Integer. Offset for spot weld projection point identification numbers.
OUTFMP Integer. Number of fluid modes to output.
OUTGS1 Character. Output control of OGS1 to modal neutral file.
OUTGSTR1 Character. Output control of OGSTR1 to modal neutral file.
OUTOPT Integer. CURV module's output option.
OUTSMP Integer. Number of structure modes to output.
OVRWRT Character. DBC database overwrite flag.
PANAME Character. The name of the panel whose coupling matrix is created. Output by
ACMG.
PANELMP Integer. Flag to compute panel participation factors.
PARCOMi Character. Names of user PARAMeters to be processed under the APP=COMM
option along with the CASCOMi names.
PARM Integer. Equivalence flag on the EQUIVX module. Purge flag on the PURGEX
module.
PARMi Logical. Output data block presence flag. Output by DMIIN and DTIIN.
PARTMETH Integer. PRESOL partitioning method.
9 Extreme
11 MSCMLV
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1674
PARTSE Logical. Partitioned superelement flag. Set to TRUE if the current superelement is a
partitioned superelement. Output by SEP2DR.
PATH Character. Direction of cyclic transformation:
'FORE' Forward (analysis)
'BACK' Backward (data recovery)
PBCONT Integer. Slideline contact flag.
PCHSET Integer. Punch flag. If PCHSET=1, then the set generated will be written to the
punch file in Case Control command SET format.
PDEPDO Integer. Skip factor flag. See NOi on TSTEP Bulk Data entry. Output by TRLG.
0 Skip factor is >1.
-1 Skip factor is 1.
PEID Integer. Primary superelement identification number. Output by SEP2DR and
SEDRDR.
PENFAC Real. Penalty factor for electromagnetic elements.
PENFN Real. Lagrange multiplier penalty function. Usually input by user parameter and
overrides system cell 375.
PEXIST Logical. Set to TRUE if p-elements are present.
Pi Character. Generic name of the data block DBi to be processed by the DBC module.
Integer. Inputs to the MATGEN, MATMOD, and PARAML module. Any type.
Inputs to MESSAGE module.
PIDINI Integer. The first processor identification number of the parent group which will be
included in the first new subgroup.
PLABEL Character. The label associated with the parent group set.
PLSIZE Integer. Size of the load matrix. Compared to the size of load matrix in the previous
subcase in order to detect boundary condition changes in the current subcase.
Boundary condition changes are not allowed in the arc-length method. Output by
NLITER.
PLTCNT Integer. SEPLOT (or SEUPPLOT) command counter. Output by SEPLOT.
On input:
0 Initialization
On output:
>0 Current SEPLOT (or SEUPPLOT) command
PLTNUM Output. Plot frame counter. Output by PLOT, MSGSTRES, and XYTRAN.
PNLPTV Logical. Panel participation/partition vector flag. If TRUE, then generate a
partitioning vector APART which may be used to partition the g-set size coupling
matrix to obtain the panel's coupling matrix.
Name Type and Description
Main Index
1675 Glossary
Parameter Glossary
PNQALNAM Character. Name of qualifier for panels.
POSTCFLG Integer. POSTCC processing flag.
1 Generate POSTCC
2 POSTCC is specifed as an input
POSTU Integer. Fortran unit number to which the DBC module writes data recovery
information.
POUTF Integer. Intermediate output flag. Set to -1 if intermediate output is not requested.
Output by NLITER and TOLAPP.
POWER Integer. Power of 10 to be multiplied by DET in DCMP and DECOMP. Exponent to
which the real part of each element in A is raised in the DIAGONAL module.
PREC Integer. Precision of output matrix.
0 Machine-precision
1 Single
2 Double
PRECOL Integer. Subcase record number in CASESTAT referenced by the
STATSUB(PRELOAD) subcase identification number. PRECOL also corresponds
to the column number of static solution vector. Output by GETCOL. In
ADAMSMNF, PRECOL is the column number of preload vector in PXA and if
PREOL<=0 then there is no preload.
PREFDB Real. Peak pressure reference for pressure level in units of dB or dBA.
PREFONLY Integer. Preface execution only flag in SOLVIT module.
PRESORT Integer. Pre-sort flag. Set to -1 if column is already sorted. Output by MATMOD
option 35.
PRGNAME Character. Name of external program called by ISHELL module.
PRGPST Character. Singularity summary print flag. If set to 'YES', then the summary is
printed.
PRNTOPT Character. MATGPR module print options.
PRJVEROP Character. Operation name.
'GET' Get current project and version
'NEXT' Get next non-deleted project and version
'SET' Set current project and version
'LAST' Get the last (bottom) project and version
'RESTART' Get restart project and version
PROCID Integer. Local processor ID.
PROGRAM Character. DBC database format flag.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1676
'XL' MSC.Patram
'GRASP' MSC.Access
PROJ Integer. Project number. Output by PROJVER.
PROPOPT Integer. Property optimization flag. Set to 1 if element properties are defined as
design variables. Output by DSABO.
PROPTN Integer. In order to support a pre-Version 68 capability, if
PROPTN=-1 then an EPT data block which is based on the values and the property
to design variable relations will be produced.
PROTYP Integer. Designed property type code. Output by DOPR1.
1 DVPRELi entries exist
2 DVCRELi entries exist
4 DVMRELi entries exist
>0 For combinations add above values
PROUT Integer. Print control for the ELTPRT module.
PRSLOPT Integer. PRESOL Processing option. Output by PRESOL.
PRTOPT Specifies how the results are to be printed:
0 Print a page header identifying the output as coming from this module
before printing the results.
1 Print the results without a page header.
2 Do not print anything. Results are returned in SUM (normally only used
with a single input matrix).
PRTSWM Logical. UWM 6991 print control flag in NORM module.
PRTUIM Logical. UIM 4570 print control flag in SELA module.
PSEQOPT Character. p-element append flag. Specifies append (default) or insert option for p-
elements in the SEQP module.
PSETID Integer. Plot set identification number in GPSETS and ELSET record. If GPSET or
ELSET is not found then it is set identification number defined in CASECC which
specifies a collection of GPSETS and ELSET set IDS which in turn DEFINE a set
of nodes and elements to MSC.Adams:
-1 All grids and element plot sets present in GPSET and ELSET sets.
0 None; no plot set is used to restrict element and grid output; all grids and
elements will be output >0 : All grids and element plot sets present in
SET=PSETID.
PSHLDAMP Character. Structural damping default flag for MID2, MID3, and MID4 on the
PSHELL entry. Usually input by user parameter.
Name Type and Description
Main Index
1677 Glossary
Parameter Glossary
= SAME Structural damping properties for MID2, MID3, and MID4
are assumed to be the same as MID1.
<>SAME Each MIDi may have its own structural damping
properties.
PVALNEW Integer. New p-value set identification number. Output by ADAPT.
QKGUSTL Logical. QKGUST* creation flag. Output by GUSTLDW.
TRUE QKGUST* was created.
FALSE QKGUST* was not created.
Q Real. Dynamic pressure. Output by AELOOP and DSARLP.
QSETID Integer. Starting q-set identification number for QSETREC=-2.
QSETREC Integer. Records to use in defining the q-set degrees-of-freedom:
>=0 No records are written.
=-1 SENQSET record to GEOM1W
=-2 SPOINT record to GEOM2W and QSET1 record to GEOM4W
QUALNAM Character. Name of qualifier to be varied when selecting MAPS from MAPS* in
SEMA, SELA, and SEDR modules. Character. Keyword which appears on the
BEGIN BULK command of the next Bulk Data section; usually AUXMODEL or
SEID. Output by XSORT.
QUALNAMP Character. Name of qualifier to be used in selecting PUG.
QUALVAL Integer. QUALNAM value assigned to the Main Bulk Data section.
R1CNT Integer. Counter for type 1 responses in data block R1TAB. Output by DOPR3.
R2CNT Integer. Counter for type 2 responses in data block RESP12. Output by DOPR3.
R3CNT Integer. Counter for type 3 responses in the RESP3 table. Output by DOPR3.
RBFAIL Logical. Set to TRUE if grounding check does not pass strain energy threshold used
by IOPT=10. Output by VEPCLOT.
RCOLLBLi Character. If RCOLLBLi is blank then 'COLUMN' will be printed. Label with up to
32 characters to be printed right-justified in upper right corner of each page.
RCOLLBLi is then followed by column number.
RCONFIG Character. Configuration name for rigid aero. Output by AELOOP.
REACT Integer. For zero-th and first harmonic, set to -1 if no support degrees-of-freedom;
+1 if support degrees-of-freedom exist. For harmonics greater than 1, REACT is
always -1. Output by CYCLIC3.
REAL Real. Real part of matrix or table element. Output by PARAML.
REALD Real double precision. Real value in the next record.
REALi Real. Real value for PRGNAME.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1678
RECNUM Integer. Record number of table element. Output by PARAML.
RECVCODE Integer. Receiving processor identification code.
= 0 All non-sending processors are receivers
< 0 Absolute value is the processor identification number of a single receiver
> 0 Bit pattern of receiving processors. The bit position from right to left
corresponds to the processor identification number.
REFC Real. Output by PARAML of AERO data block.
REFi Real. Location of point in the i-th coordinate direction of COORID about which
moments will be computed.
REPEAT Integer. Last boundary condition flag. Set to -1 at the last boundary condition; +1
otherwise. Output by GP4.
RESFLG Integer. Residual vector eigenvalue subheading print flag to be used by the OFP
module.
RESID Integer. Residual structure flag. -1 means residual structure. Used only in SOLs 106
and 400.
RESPi Character. Response type.
RESTYP Integer. Optimization results flag.
RGDEXIST Logical. Flag, if TRUE, indicates there are rigid elements that need further
processing in MODGM4.
RGSENS Logical. Rigid element sensitivity flag. Output by DOPR5 or DSVGP4.
RIGID Character. Sub-method type for the combined Lagrange and elimination method,
LAGR, LGEL, or LNEI. Usually input by user parameter. Output by
MODGM2.
ROWNAM Character. Degree-of-freedom set name for labeling matrix rows in MATGPR
output.
RP1 Real. Parametric data depending on MDOPT.
RP2 Real. Parametric data depending on MDOPT.
RSEID Integer. Repeated superelement identification number as specified on the SEBULK
Bulk Data entry. Output by SEP2DR and SEDRDR.
RSFLAG Logical. Main Bulk Data superelement presence flag. Set to TRUE if superelements
are defined in the main Bulk Data section. Output by SEP1X.
RSSTEP Integer. Identification number of the previously executed step.
RSSUBC Integer. Identification number of the previously executed subcase.
RSTEP Integer. Controlled increments counter. Output by NLITER.
RSTFLG Integer. Restart flag.
<=0 cold start
Name Type and Description
Main Index
1679 Glossary
Parameter Glossary
= 1 restart
RSTIME Real. Load factor (or time) of a previously executed load increment in static analysis
(or time step in transient analysis).
RUNIFPi Logical. IFPi module execution flag. Set to TRUE if IFPi module execution is
required. Output by IFP.
RUNMEPT Logical. MODEPT module execution flag. Set to TRUE if MODEPT module
execution is required. Output by IFP.
SAERCC Logical. Aerostatic analysis subcase flag. Set to TRUE if at least one
ANALYSIS=SAERO command was found in CASECC and CASESAER is
specified in the output list. Output by MDCASE.
SCNDRY Integer. Secondary (identical or mirror) superelement flag. Set to -1 if superelement
is defined by the CSUPER Bulk Data entry with PEID>0. Output by SEP2DR and
SEDRDR.
SDFLG Integer. Flag to indicate whether the current subcase has active stability derivative
response (STABDER on the DRESP1 Bulk Data entry). 0 indicates no response, 1
indicates an active response. Output by DSARLP.
SDRDENS Integer. Sparse data recovery ceiling density. If the density of PVGRID is greater
than SDRDENS divided by 100, then choose full data recovery.
SDRMETH Integer. Data recovery method flag. Output by OUTPRT.
SDROVR Character. Override for data recovery method flag.
SDRPOPT Character. Principal stress/strain computation selection:
'SDRP' Compute in SDRP
'OFP' Compute in OFP
SEBULK Logical. Partitioned superelement presence flag. Set to TRUE if partitioned
superelements are present or BEGIN SUPER is specified for the first BEGIN BULK
Case Control command.
SEDRCNTL Character. Processing list selection.
' ' All superelements will be processed (default).
'CURR' Only the superelement specified by SEID parameter will be processed.
SEDWN Integer. Downstream superelement identification number. Output by SEP2DR and
SEDRDR.
SEFLAG Logical. Set to TRUE if partitioned superelements are present. Output by SEPR1.
SEID Integer. Superelement identification number. On output from SEP3 and SEP4, SEID
is an initialization flag; i.e., if there are superelements, then SEID is set to -1 to
initialize SEP2DR and SEDRDR; otherwise 0. Output by SEP2DR, SEDRDR,
SEP3, and SEP4.
Name Type and Description
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1680
SENDID Integer. Sending processor identification number. Allowable values are 1 to the
number of processors.
SEP1XOVR Integer. Over-ride bits for module processing.
Bit(s) Value(s) Description
1-3 1-5 Override Search Algorithm Selection.
4 8 Disable Automatic Main Bulk Scalar
Linkages via internal SECONCT entries.
5 16 Print RSCON old/new locations.
6 32 Print Boundary Search Sequence.
7 64 SEP1X "Diag 30" Debugging Output.
8 128 Auto-SET in Residual place in OSET when other sets
present in the Residual.
9 256 CHKRUN flag for spot welds
10 512 CHKRUN=2 flag for spot welds
SEP2CNTL Character. Processing selection.
'ALL' All superelements will be processed
'PSLGDV' Only superelements specified on the SEDV Case Control
commands
'DSLIST' Only superelements specified on the SERESP Case Control
commands
'SLIST' Only superelements specified on the SEALL, SEMG, SEKR,
SELG, SELR, or SEMR Case Control commands.
'SEDWN' All superelements that have SEDWN as their downstream
superelement.
'CURR' Only the superelement specified by SEID parameter will be processed.
SEP4CNTL Integer. Processing list selection.
'ALL' All superelements will be processed
<>'ALL' Only superelements specified on SEDR Case Control command
SEPRTN Logical. SUPER command processing flag. Set to TRUE to ignore SUPER command.
SEQMETH Integer. Resequencing method.
SEQOUT Integer. SEQP module output options.
Name Type and Description
Main Index
1681 Glossary
Parameter Glossary
SETi Character. Degree-of-freedom set name.
SETKNTR Integer. Pointer to desired member in set; e.g., 1 means first member in set, 2 means
second member, etc. If the set is exhausted then SETKNTR is reset to -1. Output by
PARAML SET option.
SETNAM Character. Degree-of-freedom set name used by IOPT=9 and 10.
SETNAME Character. Degree-of-freedom set name. SOLVIT, DCMP, READ: For maximum
efficiency, the rows and columns of the input matrices must correspond to or be a
partition of the degree-of-freedom specified by SETNAME.
SEQP Specifies size of MAT in SEQP module.
SETYPE Character. Superelement type as specified on the SEBULK Bulk Data entry. Output
by SEP2DR and SEDRDR.
'REPEAT' Repeated
'MIRROR' Mirror
'COLLTR' Collector
'EXTRNA' External
'PRIMARY' Primary
SHAPEOPT Integer. Shape optimization flag. Set to 1 if shape optimization is activated. Output by
DSAM.
SHAPES Logical. Shape optimization Bulk Data entry presence flag. Must be TRUE if
DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present.
SHFSCL Real. Estimate of the first flexible natural frequency. SHFSCL must be greater than
0.0.
SID Integer. Alternate set identification number. If SID=0, the set identification number is
obtained from the METHOD command in CASECC and used to select the EIGR,
EIGB, or EIGRL entries in DYNAMIC. Similarly for CMETHOD and EIGC. If
SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL is
selected by this parameter value. All subsequent parameter values (METH, F1, etc.)
are ignored. Similarly for CMETHOD and EIGC for Lanczos method only. If SID<0,
then both the METHOD command and all EIGR, EIGB, or EIGRL entries are ignored
and the subsequent parameter values (METH, F1, etc.) will be used to control the
eigenvalue extraction. Similarly for CMETHOD and EIGC for Lanczos method only.
SIGMA Real The Stefan-Boltzmann constant. Used to compute radiant heat flux.
SIGN Integer. Sign of right hand side matrix, PG in STATICS or B in SOLVIT.
1Positive
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1682
-1Negative
SIGNAB Integer. Sign of matrix product in MPYAD.
1Positive
-1Negative
SIGNP Integer. Sign of matrix product in SMPYAD.
1Positive
-1Negative
SIGNC Integer. Sign of matrix addition in MPYAD.
1Positive
-1Negative
SIGNF Integer. Sign of matrix addition in SMPYAD.
1Positive
-1Negative
SING Integer. Singularity flag. If singularities are found, then SING will be set to -1;
otherwise +1. Output by DCMP and DECOMP.
SKPMTX Integer. If SKPMTX<>0, then KELM1 and KDICT1 will be generated.
SMEMCC Logical. Electromagnetic analysis subcase flag. Set to TRUE if at least one
ANALYSIS=ELECT command was found in CASECC and CASESAER is specified
in the output list. Output by MDCASE.
SMPFEPS Real. Threshold for filtering out small structure factor magnitudes.
SMSTCC Logical. Structural analysis subcase flag. Set to TRUE if at least one
ANALYSIS=STRUCT command was found in CASECC and CASESMST is
specified in the output list. Output by MDCASE.
SNORM Real. Maximum angle between grid point normal and shell normal. If angle is less
than SNORM then grid point normal will be computed.
SNORMPRT Integer. Grid point shell normal print/punch flag.
0No print or punch
1Punch
2Print only
3Print and punch
SOFFSET Real. Stiffness ratio for equivalent CBEAM generated for the offsets.
Main Index
1683 Glossary
Parameter Glossary
SOLADJC Integer. Flag to select solving adjoint load vectors along with applied load vectors
> 0Yes (generate adjoint load vectors in DOPR3)
< 0No (do not generate adjoint load vectors in DOPR3)
Usually input via user parameter.
SOLAPP Character. Design optimization analysis type.
SOLCUR Integer. Nonlinear loop identification number.
SOLCURR Integer. Identification number of the output time step at the restart point. Output by
NLRSLOOP.
SOLPREL Integer. Last SOLCUR in the previous STEP case. Output by NLRSLOOP.
SOLTYP Character. Solution method.
'MODAL' Modal
SORTFLAG Integer. SORT1/SORT2 format flag. Output by SDR2.
SORTNLFT Logical. Sort flag for NLFT records. Usually set to TRUE in nonlinear solution
sequences to improve numerical conditioning.
SORTOPT Integer. Sort option specification.
'DIRECT' Direct
SORTP Integer. Transpose flag for displacements, velocities and acceleration matrix inputs
and outputs.
1columns correspond to time steps
2rows correspond to time steps
SPC Integer. SPC Case Control command set identification number specified in the third
word of the NSKIP-th record of CASECC.
SPCGEN Integer. SPC Bulk Data entry punch flag. If set to >0, then singularities identified by
this module are written to the PUNCH file as SPC Bulk Data entries.
SPDM Integer. Sparse design model flag. Output by OUTPRT. If -1, then VGDM must be
supplied.
-1Yes
0No
SPSELREC Output. Last record number processed in SPSEL. Set to -1 when processing last
record. Output by RSPEC.
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1684
SRCOMPS Character. Flag to request output of table of ply strength ratios (OESRT). Usually
input by user parameter.
SRTELTYP Integer. Element type to be filtered and sorted. By default, all element types will be
filtered and sorted.
SRTOPT Integer. Filter/sort option based on NUMOUT and BIGER.
0Maximum magnitude
1Minimum magnitude
2Maximum algebraic
3Minimum algebraic
SRTTYP Integer. Item code 1 sort flag. Set to 1 to perform an integer sort on item code 1 which
is usually an integer quantity.
START Integer. Number of the grid points at the beginning of the input sequence in the SEQP
module.
STARTCOL Integer. Starting column number to extract from I1.
STATCC Logical. Static analysis subcase flag. Set to TRUE if at least one
ANALYSIS=STATICS command was found in CASECC and CASESTAT is
specified in the output list. Output by MDCASE.
STATIC Integer. Static analysis flag. Set to zero for static analysis and one for dynamic
analysis.
STATOPT Character. Static solution method.
'DRCT' Direct
'ITER' Iterative.
STATSUB Integer. STATSUB Case Control command set identification number specified in the
256-th word of the NSKIP-th record of CASECC.
STEPCUR Integer. Identification number of the STEP case at the restart point. Output by
NLRSLOOP.
STEPCURL Integer. Identification number of the previous STEP case from the restart point.
Output by NLRSLOOP.
STEPRR Logical. STEP Case Control command flag. Set to TRUE if the STEP command is
allowed in the current solution sequence.
STFLG Integer. Flag to indicate whether the current subcase has active static response (DISP,
STRAIN,STRESS, FORCE, CSTRAIN, CSTRESS, or CFORCE on the DRESP1
Bulk Data entry). 0 indicates no response, 1 indicates an active response. Output by
DSARLP.
Main Index
1685 Glossary
Parameter Glossary
STIME Real. On initial input, starting time step and on output, accumulated time used for
restarts. Output by NLTRD, NLSOLV, and NLTRD2.
STIMER Real. Load factor (or time) at the restart point. Output by NLRSLOOP.
STIMES Real. Start time of the current STEP case. Output by NLRSLOOP.
STOL Real. State matching tolerance.
STPSCL Real. Shape step size scaling factor.
STRUCTMP Integer. Number of structure modes to use computing factors.
SUBCUR Integer. Identification number of the SUBCASE at the restart point. Output by
NLRSLOOP.
SUPAERO Character. Method for supersonic aero; 'ZONA' or 'CPM'.
SUPER Integer. Selects coupled or uncoupled sequencing or special handling of multipoint
constraints in the SEQP module.
SUPORT Integer. SUPORT Case Control command set identification number specified in the
255-th word of the NSKIP-th record of CASECC.
SWCHECK Logical. Spot weld check exit flag indicating that bit 256 is on in CHKRUN. Output
by SEP1X.
SWEXIST Logical. Spot weld element existence flag. Set to TRUE if spot weld elements exist.
Output by MODGM2.
SYM Integer. Symmetric partition or merge flag.
0Symmetric; i.e., CP is used for RP
<>0Asymmetric; i.e., CP and RP are distinct
SYMFLG Complex. Scale factor.
SYMXY Integer. Aerodynamic x-y symmetry flag. Output by AEMODEL.
SYMXZ Integer. Aerodynamic z-y symmetry flag. Output by AEMODEL.
SYS66 Integer. System cell 66 override for matrix multiply.
T Integer. Transpose flag for first matrix input to MPYAD.
1Transpose
0Do not transpose
TABID Integer. TABLED1 punch flag. If IDTAB is greater than zero, all requests for
XYPUNCH will produce TABLED1 Bulk Data entries for the curve. The table
identification number will start at TABID and increase by one for each table punched.
Output by XYTRAN.
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1686
TABS Real. Absolute temperature conversion. For example, set to 273.16 when specifying
temperatures in Celsius or 459.69 in Fahrenheit.
TADJCOL Integer. Accumulated column count for adjoint load vector, for supporting adjoint
load method for multiple superelements. Output by DOPR3 and DSAD.
TCOLADJ Integer. Total number of columns of DRDUG for all superelements.
TEMPSID Integer. Temperature set identification number. Usually obtained from the
TEMPERATURE Case Control command. Required for use in stress recovery of
differential stiffness.
TESTNEG Integer. Load increment method flag in nonlinear static analysis. Output by CASE.
TFLG Integer. Flag to indicate whether the current subcase has active trim responses (TRIM
on the DRESP1 Bulk Data entry). 0 indicates no response, 1 indicates an active
response. Output by DSARLP.
TFLID Integer. Transfer function set identification number. TFLID is ignored if IOPT=3, 4,
5, 13, 14, or 15.
THRESH Integer. Exponent of 10 which defines the pivoting threshold for unsymmetric
decomposition.
Ti Integer. Transpose flag for first four matrices input to SMPYAD.
1Transpose
0Do not transpose
2Perform [A][B] where [A] is the complex conjugate of A. Only meaningful
when A is complex.
3Perform [A] [B] where [A] is the complex conjugate of A. Only meaningful
when [A] is complex.
TINY Real. Small element strain energy value. Element strain energies less than TINY will
not be printed.
TIPSCOL Integer. The number of tip superelements upstream of each downstream collector
superelement. See ACMS='YES'. Output by SEQP.
TITLEi Character. Titles for VECPLOT module printed output.
TOLABEL Character. The label associated with the new group set.
TOLAPPF Integer. Nonlinear analysis type:
1Nonlinear transient
0Nonlinear statics
TOLRSC Real. RSSCON element alignment tolerance factor.
Main Index
1687 Glossary
Parameter Glossary
TOTALK Integer. Total number of harmonics. Output by CYCLIC1.
TOUT Integer. TRLG processing flag.
<1Use NOi on TSTEP Bulk Data entry
1All time steps
2Same as <1 except RPX is input
TRD2OPT Integer. TRD2 output option.
1Output based on TSTEP Bulk Data entry
2Output based on every time step
TRL5Ti Integer. Specifies value for the fifth word in TOFPi's trailer.
TSTART Integer. CPU clock time at entry to FA1. Output by FA1 and FA2. On output from
FA2, set to -1 if there is insufficient time for another DMAP loop.
TSTATIC Integer. Static analysis flag. Set to 1 to ignore inertia and damping forces.
TVALUE Integer. Trailer value. Output by PARAML and SCALAR.
TVOLFL Integer. Total volume flag. Output by SDSA.
TWGTFL Integer. Total weight flag. Output by SDSA.
TWODIV Output. Nonlinear analysis divergence flag.
0No previous divergence on this load step.
1One previous divergence on this load step.
TYPE Integer. Type of output matrix.
UNCOUP Logical. Setting UNCOUP to TRUE results in a special sparse FBS which is optimal
for uncoupled systems. (Unsymmetric FBS only.)
UNITNO Integer. Specifies FORTRAN unit number.
UNSYMF Character. Unsymmetric stiffness generation for slideline contact stiffness. If set to
'YES' then stiffness matrix will be unsymmetric for slideline contact.
UPFM Integer. UFM 4252 print flag. Set to -1 to print UFM 4252 and set NOGO=-1 if there
are missing upstream boundary matrices.
UPSECC Logical. Superelement analysis subcase flag. Set to TRUE if SUPER=ALL or
SUPER>0 in CASECC. and CASEUPSE is specified in the output list. Output by
MDCASE.
USETBIT Integer. Decimal equivalent of bit position of a degree-of-freedom set. Output by
PARAML.
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1688
USETADD Integer. USET length extension. Extend the size of the USET by this amount.
USETOP Character. Name of desired operation.
VALUED Complex double precision. Contents of element at IROW-th row and ICOL-th column
in matrix [A]. Output by SCALAR.
VERS Integer. Version number. Output by PROJVER.
VOLS Real. Total volume of analysis model. Output by WEIGHT.
VREF Real. Flutter velocity divisor to obtain flutter indices.
VUBEAM Character. Name for VUBEAM element.
VUELJUMP Integer. Delta between view-element identification numbers.
VUENEXT Integer. Starting identification number for next view-element. Output by DVIEWP
and VIEWP.
VUEXIST Logical. View-element flag. Set to TRUE if view-elements exist. Output by DVIEWP
and VIEWP.
VUGJUMP Integer. Delta between view-grid identification numbers.
VUGNEXT Integer. Starting identification number for next view-grid. Output by DVIEWP and
VIEWP.
VUHEXA Character. Name for VUHEXA element.
VUPENTA Character. Name for VUPENTA element.
VUQUAD4 Character. Name for VUQUAD4 element.
VUTETRA Character. Name for VUTETRA element.
VUTRIA3 Character. Name for VUTRIA3 element.
W3 Real. Scale factor denominator for including stiffness in viscous damping for transient
analysis. Usually input by user parameter.
W4 Real. Scale factor denominator for including non-uniform structural damping in
viscous damping for transient analysis. Usually input by user parameter.
WGTS Real. Total weight of analysis model. Output by WEIGHT.
WGTVOL Integer. Weight/volume retained response flag. Set to >0 if any retained response.
Output by DSPRM.
WRDNUM Integer. Word number of table element. Output by PARAML.
WTMASS Real. Scale factor on structural mass matrix.
Main Index
1689 Glossary
Parameter Glossary
WVFLG Integer. Weight/volume response flag. If CASECC does not contain any subcases for
statics, normal modes, or buckling subcase then set to 1 if there is a weight or volume
response specified on the DRESP1 Bulk Data entry image in EDOM. Output by
MDCASE.
XFLAG Integer. Strain energy method selection.
0Elemental force
1Cross displacement
XNORM Real. Maximum absolute normalizing value over all columns. Output by NORM.
XNORMD Real-double precision. Same as XNORM except in double precision.
XTYPE Integer. Type of element matrix data:
0Stiffness
1Damping
2Mass
XYSET Character. Degree-of-freedom set type.
'SOL' Solution set (d-set or h-set)
'DSET' d-set
'HSET' h-set
'PSET' p-set
XYUNIT Integer. FORTRAN unit number to which the DOM12 module writes design
optimization x-y plot data.
YOUNGM Real. Young's modulus.
Main Index
MSC Nastran DMAP Programmers Guide
Parameter Glossary
1690
Parameter Naming Conventions
ZCOLLCT Integer. The absolute value is the number of collectors in the last level of a
multilevel tree (see ACMS='YES). If ZCOLLCT<0, then a single final collector
will be added. Output by SEQP.
ZFREQ Integer. Zero frequency truncation selection. If set to 1 then the zero frequency, if
any, will be truncated from UXF and FOL.
LUSET "Length of USET"; i.e., number of degrees-of-freedom in the
g-set. For example, LUSETD (d-set), LUSETS (superelement) Sometimes, and
more rightly, called NOGSET.
NO__SET Number of degrees-of-freedom in the __-set (=-1 if none)
NORC Set to -1 if there is no c-set and no r-set.
NO_____ "no" _____ (e.g.; no data block) exists or can be found
ALWAYS Initialized and always assumed to be -1
NEVER Initialized and always assumed to be 0
NP Local usage or dummy
NOGO Hidden parameter set by module (no "S,N,NOGO" on module call) Must be trapped
immediately.
Main Index
MSC.Fatigue Quick Start Guide
I ndex
MSC Nastran DMAP Programmers Guide
A
Arithmetic operators, 9
C
Character operator (&), 9
D
Data block
automatic deletion of, 38
basic definition of, 2
local, definition of, 14
permanent, definition of, 14
rules for, 38
scratch, definition of, 14
states of, 14
DATABLK NDDL statement, 563, 564
DBset, 13
DEPEN NDDL statement, 573
DMAP
general rules, 3
last time used (LTU) instruction, 38
output from previous module" rule, 37
DMAP control statements
conditional branching, 30
DO WHILE DMAP statement, 33
looping, 32
DMAP modules
basic definition, 2
description summary, by category, 580
detailed descriptions of,, see also specific
module name
list of, by category, 580
obsolete, 588
DO WHILE DMAP statement, 33
E
Errors, see also user errors
Executive modules
description summary, 587
list of, 581
Expressions and operators
arithmetic operators, 9
character operator (&), 9
logical operators, 10
relational operators, 9
F
File management statements, 2
Functions, intrinsic, 19
L
Logical operators, 10
M
MATPRN DMAP module, 1089
Matrix modules
description summary, 585
list of, 580
Matrix trailer, 12
N
NDDL (Nastran Data Definition Language)
basic definition of, 2
DATABLK NDDL statement, 564
DEPEN NDDL statement, 573
PARAM NDDL statement, 575
PATH NDDL statement, 577
purpose of, 562
QUAL NDDL statement, 578
summary of statements, 562
syntax of descriptions, 563
O
Obsolete modules, list of, 588
OFP DMAP module, 1219
Main Index
MSC Nastran DMAP Programmers Guide
ii
Operators,, see also expressions and operators
OUTPUT2 DMAP module, 1230
OUTPUT4 DMAP module, 1241
P
PARAM NDDL statement, 575
Parameters
basic definition of, 2
PATH NDDL statement, 577
Preface modules, 39
PRTPARM DMAP module, 1271
Q
QUAL NDDL statement, 578
R
Relational operators, 9
S
SCRATCH data block
automatic deletion of, 38
special rules for, 38
SOLution 100, 39
Solution sequences, definition of, 2
SubDMAP
DBFETCH, 41
DBMGR, 41
DBSTORE, 41
U
Upward compatibility in Version 68,, see also
V68 DMAP changes
User errors, processing of, 40
User fatal message 1126,, see also DMAP
output from previous module" rule
Utility modules
description summary, 586
list of, 581
Main Index