MD Nastran 2006 DMAP Programmer's Guide
MD Nastran 2006 DMAP Programmer's Guide
Michael Reymond
Main Index
Corporate
MSC.Software Corporation
2 MacArthur Place
Santa Ana, CA 92707 USA
Telephone: (800) 345-2078
Fax: (714) 784-4056
Europe
MSC.Software GmbH
Am Moosfeld 13
81829 Munich, Germany
Telephone: (49) (89) 43 19 87 0
Fax: (49) (89) 43 61 71 6
Asia Pacific
MSC Software Japan Ltd.
Shinjuku First West 8F
23-7 Nishi Shinjuku
1-Chome, Shinjyku-Ku
Tokyo 160-0023, JAPAN
Telephone: (03)-6911-1200
Fax: (03)-6911-1201
Worldwide Web
www.mscsoftware.com
Disclaimer
MSC.Software Corporation reserves the right to make changes in specifications and other information
contained in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes
only, and are not intended to be exhaustive or to apply to any particular engineering problem or design.
MSC.Software Corporation assumes no liability or responsibility to any person or company for direct or
indirect damages resulting from the use of any information contained herein.
User Documentation: Copyright 2006 MSC.Software Corporation. Printed in U.S.A. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any
reproduction or distribution of this document, in whole or in part, without the prior written consent of
MSC.Software Corporation is prohibited.
This software may contain certain third-party software that is protected by copyright and licensed from
MSC.Software suppliers.
MSC, MSC., MD, MSC.Dytran, MSC.Marc, MSC.Nastran, MD Nastran, MSC.Patran, the MSC.Software
corporate logo, and Simulating Reality are trademarks or registered trademarks of the MSC.Software
Corporation in the United States and/or other countries.
NASTRAN is a registered trademark of NASA. PAMCRASH is a trademark or registered trademark of ESI
Group. SAMCEF is a trademark or registered trademark of Samtech SA. LS-DYNA is a trademark or
registered trademark of Livermore Software Technology Corporation. ANSYS is a registered trademark of
SAS IP, Inc., a wholly owned subsidiary of ANSYS Inc. ABAQUS is a registered trademark of ABAQUS Inc.
All other brand names, product names or trademarks belong to their respective owners.
NA*V2005R3*Z*DMAP*Z*DC-PROG
Main Index
C O N T E N T S
MD Nastran 2006 DMAP Programmer’s Guide
Table of Contents
Preface ■ About This Book, x
■ List of Nastran Books, xi
■ Technical Support, xii
■ Internet Resources, xv
1
Direct Matrix ■ Introduction, 2
Abstraction ■ The Nastran DMAP Language, 3
■ Parameters, 4
❑ Constant Parameters, 5
❑ Variable Parameters, 6
❑ Expressions and Operators, 9
■ Data Blocks, 13
❑ Table Trailers, 13
❑ Matrix Trailers, 13
❑ Data Block Type and Status, 15
■ Instructions, 16
❑ Modules, 16
❑ Statements, 19
2
Data Blocks ■ Introduction, 48
■ Matrix Data Blocks, 49
Main Index
■ Table Data Blocks, 51
❑ IFP Tables, 51
❑ IFP Table Header Words and Trailer Bits, 51
❑ OFP Tables, 53
❑ Table_code, 56
■ Table Descriptions, 71
■ Data Block Descriptions, 72
- BGPDT, 72 - GEOM301, 308
- BGPDT68, 74 - GEOM4, 309
- CASECC, 75 - GEOM4705, 340
- CLAMA, 99 - GPDT68, 341
- CONTAB, 101 - GPL, 343
- CSTM, 102 - HIS, 344
- CSTM68, 104 - KDICT, 345
- DBCOPT, 111 - LAMA, 348
- DESTAB, 114 - MPT, 350
- DIT, 115 - OBJTAB, 368
- DSCMCOL, 120 - OEE, 369
- DVPTAB, 131 - OEF, 374
- DYNAMIC, 133 - OES, 439
- EGPSF, 152 - OGF, 585
- EGPSTR, 157 - OGS, 591
- ELDCT, 160 - OPG, 598
- EPT, 163 - OPTPRM, 603
- EPT01, 208 - OQG, 605
- EQEXIN, 211 - OUG, 611
- ERROR, 213 - R1MAP, 623
- FOL, 215 - R1TAB, 624
- GEOM1, 216 - RESP12, 632
- GEOM168, 231 - SEMAP, 636
- GEOM2, 234 - SET, 641
- GEOM201, 284 - TOL, 642
- GEOM3, 292 - VIEWTB, 643
■ Data Block Glossary, 648
❑ Data Block Naming Conventions, 756
3
NASTRAN Data ■ NDDL Summary, 834
Definition ■ Detailed Description of NDDL Statements, 835
Language (NDDL)
- DATABLK, 836
- DEPEN, 845
- PARAM, 847
- PATH, 849
- QUAL, 850
Main Index
4
DMAP Modules ■ DMAP Module and Statement List, 852
and Statements ❑ Matrix Modules, 852
❑ Utility Modules, 852
❑ Executive Modules and Statements, 853
❑ Miscellaneous Modules and Statements, 853
Main Index
- DOPR3, 1052 - EMG, 1159
- DOPR3X, 1056 - EQUIVX, 1164
- DOPR4, 1057 - ESTINDX, 1166
- DOPR5, 1058 - EXPORTLD, 1167
- DOPR6, 1060 - FA1, 1168
- DOPRAN, 1062 - FA2, 1170
- DPD, 1063 - FBODYLD, 1172
- DRMH1, 1066 - FBS, 1173
- DRMH3, 1068 - FILE, 1177
- DRMS1, 1070 - FORTIO, 1179
- DSABO, 1072 - FRLG, 1181
- DSAD, 1074 - FRLGEN, 1183
- DSADJ, 1082 - FRQDRV, 1185
- DSADX, 1085 - FRRD1, 1186
- DSAE, 1087 - FRRD2, 1189
- DSAF, 1089 - GENTRAN, 1192
- DSAH, 1091 - GETCOL, 1194
- DSAJ, 1095 - GETMKL, 1195
- DSAL, 1097 - GI, 1196
- DSAM, 1101 - GIC2C, 1198
- DSAN, 1102 - GKAM, 1199
- DSAP, 1103 - GNFM, 1203
- DSAPRT, 1105 - GP0, 1205
- DSAR, 1107 - GP1, 1208
- DSARLP, 1109 - GP2, 1210
- DSARME, 1111 - GP3, 1212
- DSARSN, 1112 - GP4, 1214
- DSAW, 1114 - GP5, 1217
- DSDVRG, 1115 - GPFDR, 1219
- DSFLTE, 1116 - GPJAC, 1223
- DSFLTF, 1118 - GPSP, 1224
- DSGRDM, 1119 - GPSTR1, 1228
- DSMA, 1120 - GPSTR2, 1229
- DSPRM, 1122 - GPSTRPBX, 1231
- DSTA, 1125 - GPWG, 1232
- DSTAP2, 1128 - GUST, 1238
- DSVG1, 1129 - GUSTLDW, 1241
- DSVG1P, 1132 - GYROLD, 1242
- DSVG2, 1134 - IFP, 1244
- DSVG3, 1136 - IFP1, 1248
- DSVGP4, 1137 - IFP3, 1250
- DSVGP5, 1139 - IFP4, 1252
- DTIIN, 1141 - IFP5, 1254
- DUMMOD1, 1142 - IFP6, 1256
- DUMMOD2, 1143 - IFP7, 1258
- DUMMOD3, 1144 - IFP8, 1259
- DUMMOD4, 1145 - IFP9, 1260
- DVIEWP, 1146 - IFP10, 1262
- DYNCXPNT, 1148 - IFPINDX, 1263
- EFFMASS, 1149 - IFPBSH2, 1264
- ELFDR, 1151 - IFT, 1265
- ELTPRT, 1152 - ILMP1, 1270
- EMA, 1155 - ILMP2, 1271
- EMAKFR, 1157 - ILMPGPF, 1272
Main Index
- INDXBULK, 1273 - MODTRL, 1437
- INPUTT2, 1274 - MODUSET, 1439
- INPUTT4, 1277 - MONVEC, 1442
- INTERR, 1280 - MONVEC3, 1443
- ISHELL, 1282 - MPP, 1444
- LAMX, 1284 - MPPTRAN, 1446
- LANCZOS, 1290 - MPYAD, 1447
- LCGEN, 1293 - MRGCOMP, 1453
- LMATPRT, 1295 - MRGCSTM, 1454
- MACOFP, 1296 - MRGMON, 1455
- MAKAEFA, 1297 - MSGHAN, 1456
- MAKAEFS, 1299 - MSGSTRES, 1457
- MAKAEMON, 1300 - MTRXIN, 1458
- MAKCOMP, 1301 - NASSETS, 1464
- MAKENEW, 1302 - NDINTERP, 1465
- MAKEOLD, 1304 - NEWUSET, 1466
- MAKETR, 1306 - NLCOMB, 1467
- MAKMON, 1308 - NLHARM, 1469
- MASSCOMB, 1309 - NLICLOOP, 1471
- MATGEN, 1310 - NLITER, 1472
- MATGPR, 1323 - NLRSLOOP, 1479
- MATMOD, 1328 - NLRSMAP, 1481
- MATOFP, 1374 - NLSOLV, 1483
- MATPCH, 1377 - NLTRD, 1491
- MATPRN, 1379 - NLTRD2, 1495
- MATPRT, 1380 - NLTRLG, 1501
- MATREDU, 1381 - NORM, 1503
- MCE1, 1384 - NSMEPT, 1505
- MCE2, 1385 - OFP, 1506
- MCFRAC, 1387 - OPTGP0, 1509
- MDATA, 1389 - ORTHOG, 1510
- MDCASE, 1391 - OUTPRT, 1512
- MDENZO, 1395 - OUTPUT2, 1515
- MDISUTIL, 1400 - OUTPUT4, 1528
- MERGE, 1401 - PARAML, 1534
- MERGEOFP, 1405 - PARTN, 1553
- MESSAGE, 1406 - PCOMB, 1558
- MGEN, 1408 - PCOPY, 1560
- MKCNTRL, 1409 - PFCALC, 1561
- MKCSTMA, 1410 - PLOT, 1564
- MKMNTIFP, 1411 - PLTHBDY, 1566
- MKRBVEC, 1412 - PLTSET, 1567
- MKSPLINE, 1413 - PNCHGRP, 1569
- MODACC, 1414 - PNMKGRP, 1570
- MODCASE, 1416 - PRESOL, 1572
- MODENRGY, 1417 - PROJVER, 1575
- MODEPF, 1419 - PRTMSG, 1576
- MODEPOUT, 1422 - PRTPARM, 1577
- MODEPT, 1425 - PURGEX, 1579
- MODGDN, 1426 - PVT, 1580
- MODGM2, 1427 - RANDOM, 1582
- MODGM4, 1431 - RBMG3, 1590
- MODQSET, 1433 - RBMG4, 1592
- MODTRK, 1435 - READ, 1593
Main Index
- RESMOD, 1602 - SSG4, 1732
- RESTART, 1607 - ST2DYN, 1734
- RMDUPBLK, 1609 - STATICS, 1735
- RMG2, 1610 - STDCON, 1738
- ROTOR, 1612 - STRSORT, 1740
- ROTRDR1, 1614 - TA1, 1742
- ROTRDR2, 1616 - TABEDIT, 1745
- ROTRUTL, 1618 - TABPRT, 1750
- RSPEC, 1626 - TABPT, 1758
- SCALAR, 1627 - TAFF, 1759
- SDP, 1629 - TAHT, 1760
- SDR1, 1631 - TASNP1, 1762
- SDR2, 1635 - TASNP2, 1763
- SDR3, 1641 - TIMETEST, 1765
- SDRCOMP, 1642 - TOLAPP, 1770
- SDRHT, 1644 - TRD1, 1772
- SDRNL, 1646 - TRD2, 1782
- SDRP, 1648 - TRLG, 1784
- SDRX, 1652 - TRNSP, 1788
- SDRXD, 1654 - TYPE, 1789
- SDSA, 1656 - UEIGL, 1792
- SDSB, 1658 - UGVADD, 1795
- SDSC, 1660 - UMERGE, 1796
- SECONVRT, 1661 - UMERGE1, 1799
- SEDR, 1663 - UPARTN, 1802
- SEDRDR, 1666 - UREDUC, 1805
- SEEFMBND, 1669 - VDR, 1807
- SEEFMCLF, 1670 - VEC, 1809
- SEEFMDMP, 1672 - VECPLOT, 1812
- SEEFMLST, 1673 - VIEW, 1818
- SEEFMNOR, 1674 - VIEWP, 1819
- SEEFMOUT, 1675 - WEIGHT, 1821
- SEEFMXIT, 1676 - XSORT, 1823
- SELA, 1677 - XYPLOT, 1825
- SEMA, 1679 - XYTRAN, 1826
- SEP1, 1681
- SEP1X, 1683
- SEP2, 1687
- SEP2CT, 1689
- SEP2DR, 1690
- SEP2X, 1694
- SEP3, 1696
- SEP4, 1698
- SEPLOT, 1700
- SEPR1, 1702
- SEQP, 1703
- SHPCAS, 1710
- SMA3, 1711
- SMPYAD, 1712
- SOLVE, 1714
- SOLVIT, 1716
- SSG1, 1722
- SSG2, 1726
- SSG3, 1729
Main Index
MD Nastran 2006 DMAP Programmer’s Guide
Preface
Main Index
x
Main Index
Preface xi
Reference Books
❏ Quick Reference Guide
❏ DMAP Programmer’s Guide
❏ Reference Manual
User’s Guides
❏ Getting Started
❏ Linear Static Analysis
❏ Basic Dynamic Analysis
❏ Advanced Dynamic Analysis
❏ Design Sensitivity and Optimization
❏ Thermal Analysis
❏ Numerical Methods
❏ Implicit Nonlinear (SOL 600)
❏ Explicit Nonlinear (SOL 700)
❏ Aeroelastic Analysis
❏ Superelement
❏ User Modifiable
❏ Toolkit
Main Index
xii
Technical Support
For help with installing or using an MSC.Software product, contact your local
technical support services. Our technical support provides the following services:
• Resolution of installation problems
• Advice on specific analysis capabilities
• Advice on modeling techniques
• Resolution of specific analysis problems (e.g., fatal messages)
• Verification of code error.
If you have concerns about an analysis, we suggest that you contact us at an early
stage.
You can reach technical support services on the web, by telephone, or e-mail:
Email Send a detailed description of the problem to the email address below that
corresponds to the product you are using. You should receive an acknowledgement
Main Index
Preface xiii
that your message was received, followed by an email from one of our Technical
Support Engineers.
Training
The MSC Institute of Technology is the world's largest global supplier of
CAD/CAM/CAE/PDM training products and services for the product design,
analysis and manufacturing market. We offer over 100 courses through a global
network of education centers. The Institute is uniquely positioned to optimize your
investment in design and simulation software tools.
Our industry experienced expert staff is available to customize our course offerings to
meet your unique training requirements. For the most effective training, The Institute
also offers many of our courses at our customer's facilities.
The MSC Institute of Technology is located at:
2 MacArthur Place
Santa Ana, CA 92707
Phone: (800) 732-7211
Fax: (714) 784-4028
The Institute maintains state-of-the-art classroom facilities and individual computer
graphics laboratories at training centers throughout the world. All of our courses
emphasize hands-on computer laboratory work to facility skills development.
We specialize in customized training based on our evaluation of your design and
simulation processes, which yields courses that are geared to your business.
In addition to traditional instructor-led classes, we also offer video and DVD courses,
interactive multimedia training, web-based training, and a specialized instructor's
program.
Main Index
xiv
Main Index
Preface xv
Internet Resources
MSC.Software (www.mscsoftware.com)
MSC.Software corporate site with information on the latest events, products and
services for the CAD/CAE/CAM marketplace.
Engineering-e.com (www.engineering-e.com)
Engineering-e.com is the first virtual marketplace where clients can find engineering
expertise, and engineers can find the goods and services they need to do their job
CATIASOURCE (plm.mscsoftware.com)
Your SOURCE for Total Product Lifecycle Management Solutions.
Main Index
xvi
Main Index
MD Nastran 2006 DMAP Programmer’s GuideMSC/PATRAN User’s Guide
CHAPTER
Direct Matrix Abstraction
1
■ Introduction
■ The MSC.Nastran DMAP Language
■ Parameters
■ Data Blocks
■ Instructions
■ “Output from a Previous Module” Rule
Main Index
2
1.1 Introduction
MD Nastran DMAP (Direct Matrix Abstraction Program) is a high-level language
with its own compiler and grammatical rules. This section provides a summary
description of the MD Nastran DMAP language, rules, and syntax.
A DMAP program consists of a series of functional blocks called “modules,” each of
which has a unique name and a specific function. Modules are executed sequentially;
branching and looping operations are performed by DMAP control statements.
Modules communicate through the MD Nastran Executive System (NES) via logical
collections of data called “data blocks” and “parameters.”
Data blocks come in two distinct forms: “matrices” that obey the rules of matrix
algebra, and “tables” that represent a convenient collection of data items. Data blocks
are given arbitrary names (mnemonic names are recommended) and have header and
trailer information defining their characteristics.
Parameters are scalar items used for specifying control, operation, or system
characteristics. Modules can use “input parameters,” “output parameters,” or both.
Input parameters affect the internal operation of the modules. Output parameters are
used to control DMAP logic and/or to pass scalar information to subsequent modules.
Data blocks and parameters can be written onto either scratch or permanent physical
files. When the normal MD Nastran execution is completed, data blocks and
parameters written to scratch files are erased, and those written to the permanent
physical file are available for future use. The NDDL (MD Nastran Data Definition
Language) designates whether a data block is scratch or permanent. A detailed
description of the NDDL statements can be found in “NASTRAN Data Definition
Language (NDDL)” on page 833.
MD Nastran provides the user with a variety of prewritten solution sequences. These
solution sequences consist of a series of DMAP statements. MD Nastran allows the
user to modify prewritten solution sequences or to write his or her own solution
sequences using DMAP. The compilation, linkage, and execution of a DMAP program
is specified by executive control statements in the input file. The creation of and access
to databases is specified by file management statements also contained in the input
file. File management statements are described in the “File Management Statements”
in Chapter 2 of the MD Nastran Quick Reference Guide.
Main Index
CHAPTER 1 3
Direct Matrix Abstraction
Main Index
4
1.3 Parameters
Parameters can be either constants, variables, or expressions and can represent one of
several types:
Also, the real and complex types are either single or double precision. The following
table indicates the storage units required as a function of data type. One storage unit
is the basic word size on a computer. Typically, a word is 32 bits long on a short-word
computer and 64 bits on a long-word computer.
No. of
Type
words
Integer 1
Real single precision 1
Real double precision 2
Complex single precision 2
Complex double precision 4
Logical 1
Character 1 to 20
Main Index
CHAPTER 1 5
Direct Matrix Abstraction
Constant Parameters
A constant represents a fixed value and is a number (integer, real, or complex), logical,
or character string.
Integer Constants
An integer constant is a whole number with no decimal point. Its form is
snn
where:
s is optional if the sign is positive (+). A minus sign must be used to indicate a negative
integer constant. The absolute value of an integer constant cannot be greater than
31
2 – 1 = 214748367.
Real Constants
A real constant is a whole number with a decimal point that can be followed by a
decimal fraction and/or a decimal exponent. The complete form is:
s is optional if the sign is positive (+). A minus sign (-) indicates a negative real
constant or negative exponent. D is required to specify double precision. E is optional
if no exponent is required and the constant is single precision. However, if either E or
D is specified, then an integer must follow, even if the exponent is 0.
Only the leftmost 14 digits in nn.dd are used by MD Nastran. Leading zeros are
ignored in counting the leftmost 14 digits.
Main Index
6
Complex Constants
A complex constant is a pair of real constants separated by a comma and enclosed in
parentheses. The first real constant represents the real part of the complex number,
and the second real constant represents the imaginary part.
Logical Constants
A logical constant is specified as TRUE or FALSE.
Character Constants
A character constant is a string of 1 through 80 characters that may have embedded
blanks. A character constant must also be enclosed by right hand single quotation
marks.
Variable Parameters
A variable parameter is represented by a symbolic name, and its value may change
during the DMAP execution. The name of a variable parameter does not have to be
unique with respect to symbolic names for modules, data blocks, subDMAPs, or
LABELs. The name of a variable parameter cannot be NOT, AND, XOR, OR, or EQV.
Variable parameters can have their attributes (type, authorization, and default) set
explicitly with a TYPE DMAP statement or implicitly by a module. (Variable
parameters that are saved on the database must also be designated as NDDL
parameters in the TYPE DMAP statement). Variable parameters that are not specified
with a TYPE DMAP statement use the attributes from the DMAP instruction where
the parameter first appears.
All variable parameters that are used as input to a DMAP instruction must be
initialized on a TYPE statement or previously defined in one or more of the following:
Main Index
CHAPTER 1 7
Direct Matrix Abstraction
Main Index
8
Initial values for variable parameters can be specified using the PARAM Bulk Data
entry or the PARAM Case Control command.
Parameter values from the Bulk Data Section are brought into the DMAP sequence via
the IFP module. Parameter values from case control are brought into the DMAP
sequence via the PVT module. The PVT module reads the case control PARAM
commands and resolves parameter values specified in both the Case Control and Bulk
Data Sections.
Main Index
CHAPTER 1 9
Direct Matrix Abstraction
/V,Y,param_name/
/S,Y,param_name/
/V,N,param_name/
/C,Y,param_name/
/C,N,param_name/
For example, the following sequence is recommended for setting the TYPE
of ALPHA:
TYPE PARM,,CS,Y,ALPHA=(1.,1.) $
TYPE PARM,,CS,N,ALPHAX $
.
.
.
ALPHAX=ALPHA $
IF( FLAG ) ALPHAX=CMPLX(BETA,GAMMA) $
.
.
.
ADD A,B/C/ALPHAX $
Main Index
10
Arithmetic Operators
The allowable arithmetic operations are shown in the table below in the order of
execution precedence. Parentheses are used to change the order of precedence.
Operations within parentheses are performed first, with the usual order of precedence
being maintained within the parentheses.
In general, mixed mode expressions are not supported. For example, to compute
A=B*C, where A and B are complex, but C is real, it is necessary to convert C to a
complex number: A=B*CMPLX (C), where CMPLX is described under “Intrinsic
Functions” in this section.
Character Operator
The only character operation is concatenation. Its form is shown below.
Main Index
CHAPTER 1 11
Direct Matrix Abstraction
Relational Operators
Relational operators are used to compare two expressions. The result of the
comparison is a logical TRUE or FALSE. When arithmetic and relational operators are
combined in one expression, the arithmetic operations are performed first. The table
below shows the allowable relational operators.
Logical Operators
Logical operators perform tests on multiple relations or Boolean operations. A logical
operator returns a result that is either TRUE or FALSE. The outcome of a logical
operation is determined as shown in the table below. These outcomes are listed in
order of precedence. Parentheses are used to change the order of precedence.
Operations within parentheses are performed first, with the usual order of precedence
being maintained within the parentheses.
Operator X Y Output
NOT TRUE n/a FALSE
FALSE n/a TRUE
X AND Y TRUE TRUE TRUE
TRUE FALSE FALSE
FALSE TRUE FALSE
FALSE FALSE FALSE
X OR Y TRUE TRUE TRUE
TRUE FALSE TRUE
FALSE TRUE TRUE
FALSE FALSE FALSE
Main Index
12
Operator X Y Output
X XOR Y TRUE TRUE FALSE
TRUE FALSE TRUE
FALSE TRUE TRUE
FALSE FALSE FALSE
X EQV Y TRUE TRUE TRUE
TRUE FALSE FALSE
FALSE TRUE FALSE
FALSE FALSE TRUE
Main Index
CHAPTER 1 13
Direct Matrix Abstraction
Table Trailers
In tables, the trailer record contains six words. The contents vary among the tables
and are described in “Data Blocks” on page 47 at the end of the table’s description.
Table trailers are printed when DIAG 15 is specified in the Executive Control or
DIAGON(15) is specified in the DMAP sequence.
Matrix Trailers
In matrices the characteristics of a matrix are described in a twelve-word matrix
trailer. Matrix trailers are printed when DIAG 8 is present in the Executive Control
Section DIAGON(8) or is specified in the DMAP sequence. The contents of a matrix
trailer are as follows:
Word Contents
1 Number of columns in matrix
2 Number of rows in matrix
3 Form of the matrix (square, rectangular, etc.)
4 Type of matrix (real, complex, etc.)
5 Largest number of nonzero words among all
columns
6 Density of the matrix multiplied by 10000
Main Index
14
Word Contents
7 Size in blocks
8 Maximum string length over all strings
9 Number of strings
10 Average bandwidth
11 Maximum bandwidth
12 Number of null columns
Form Meaning
1 Square
2 Rectangular
3 Diagonal
4 Lower triangular factor
5 Upper triangular factor
6 Symmetric
8 Identity
9 Pseudoidentity
10 Cholesky factor
11 Trapezoidal factor
13 Sparse lower triangular factor
15 Sparse upper triangular factor
Type Meaning
1 Real, single precision
2 Real, double precision
3 Complex, single precision
4 Complex, double precision
Main Index
CHAPTER 1 15
Direct Matrix Abstraction
At any point during a DMAP execution a data block is in one of the three following
states:
Permanent blocks can have all states: generated, not generated, and empty. Empty
data blocks are created when a module is executed, but no data is actually generated
for the data block. For example, the ADD module has two inputs; if both inputs do not
exist (not generated), then the output is empty or purged. Empty data blocks are
required to support automatic restarts. A permanent data block can be explicitly
purged with the PURGEX statement. Permanent data blocks can be deleted from the
database with the DELETE statement.
Scratch data blocks can have only two states: generated and not generated. These data
blocks can be deleted with the DELETE or PURGEX statements.
Main Index
16
1.5 Instructions
A DMAP instruction can be classified as either a module or a statement. A module is
similar to a "macro" function and, in general, processes data blocks as input and/or
output. A module may also have parameters as input and/or output. A statement is
any instruction that is not a module and that does not operate on data blocks.
Modules
A module instruction has the following form: the name of the module followed by a
comma [,] and a list of input data block names separated by commas, a slash [/], a list
of output data block names separated by commas, a slash, and a list of parameter
(variable names or constants) separated by slashes:
module_name , input_data_block_list /
output_data_block_list /
parameter_list $
The dollar sign [$] is required to terminate the module instruction. The modules are
described in “Detailed Descriptions of DMAP Modules and Statements” on
page 860. Most modules have a prescribed number of inputs, outputs, and
parameters, which are defined in the Module Property List (MPL). The MPL is an
internal MD Nastran table that prescribes the exact format of all modules--the number
of input and output data block lists and the number, type, and default of the
parameters in the parameter list. The MPL can be listed by specifying DIAG 31 in the
Executive Control Section. The position of the data block and parameter names is
critical to the proper execution of the module.
Below is an example using the MPYAD module, which performs the following matrix
operation:
[D] = SIGNAB*[A][B] + SIGNC*[C]
or
Main Index
CHAPTER 1 17
Direct Matrix Abstraction
where A, B, and C, represent the input data block names, D represents the output data
block name, and T, SIGNAB, SIGNC, PREC, and FORM represent the parameter
names.
The MPL listing for the MPYAD and PARAML modules appears below:
Listing 1-1 Module Properties List
M O D U L E
P R O P E R T I E S L I S T
- - - - - - - P A R A M E T E R S - - - - - - - -
MPLID NWDS WD1 MOD-NAME TYP IN OUT SCR TOT ID TYP P DEFAULT (IF ANY) W1-W2 FLG
104 17 1594 MPYAD 1 3 1 1 5
1. INT 1601 0 1
2. INT 1603 1 2
3. INT 1605 1 3
4. INT 1607 0 4
5. INT 1609 0 5
The MPL listing contains useful information under the following column headers:
Header Description
MOD-NAME Module name
IN Number of input data blocks
OUT Number of output data blocks
ID Parameter position
TYP type of parameter:
INT - integer
RSP - real single precision
RDP - real double precision
CSP - complex single precision
CDP - complex double precision
BCD - character
LOG - logical
DEFAULT Default value of parameter
The other column headers are less important to the DMAP programmer.
Main Index
18
Some or all data blocks and parameters can be left unspecified (or purged), according
to the module description in “Detailed Descriptions of DMAP Modules and
Statements” on page 860. If a parameter is unspecified, then the default value is
assumed and obtained from the MPL. For example,
MPYAD A , B , / D $
According to the MPYAD module description, if C is unspecified, then only the matrix
multiplication of A and B is performed. Also, by default, T=0 and therefore A is not
transposed. SIGNAB and SIGNC parameters are defaulted to 1 resulting in:
[D] = [A][B]
However, if no default is defined in the MPL, then a constant or variable parameter
must be specified for the first parameter. For example,
-- NO DEFAULT --
on the PARAML module indicates there is no default value for the first parameter.
The first comma after the module name can be omitted as long as the first input data
block name is specified. For example, the ELTPRT module has the following format:
ELTPRT ECT,GPECT,BGPDT,UNUSED4,EST,CSTM,MPT,DIT,CASECC/
VELEM/PROUT/S,N,ERROR $
To obtain a printout of the elements connected to each grid point, only GPECT and
BGPDTS need to be specified; however, a comma must also be specified after the
module name:
ELTPRT , ,GPECT,BGPDTS,,,,,,/ $
ELTPRT , ,GPECT,BGPDTS,,,,,,/ $
• Input only
• Input and output
• Output only
Each module has its own rules for parameter specification, as described in “Detailed
Descriptions of DMAP Modules and Statements” on page 860. If a parameter is
specified as input, then either a constant or variable can be specified. Note that
character strings or variables specified for parameters are limited to eight characters
in length.
Main Index
CHAPTER 1 19
Direct Matrix Abstraction
For example, the first parameter of the ADD module specifies a scalar multiplier of
1+2i on the first input matrix:
ADD A , B / C / (1.,2.) $
or ALPHA:
ADD A , B / C / ALPHA $
If a parameter is to be used as both input and output, or output only, then a variable
name must be specified and preceded by S, N,. For example, on the PARAML module,
the fourth parameter, TERM, is an output parameter:
PARAML A // 'DMI' / 4 / 7 / S, N, TERM $
TERM is the value of matrix A at column 4 and row 7, which will be returned by the
PARAM module for later use in the DMAP program. If the S,N prefix is omitted, then
TERM is assumed to be input only, no fatal message is issued, and the TERM value is
incorrect.
Statements
A statement is any instruction that is not a module and that typically does not produce
output data blocks from input data blocks or parameters. Another distinction is that a
statement has no definition in the MPL (Module Property List). The different types of
statements are:
• Assignment (=)
• Function
• Control
• Declarative
• Data Base Function
Assignment Statement
The assignment statement evaluates an expression and assigns the resulting value to
a variable parameter. This statement has the following form:
v = e $
where v is a variable parameter name, and e is an expression. The dollar sign [$] is
required to terminate the statement. Assignment statements are arithmetic, logical, or
character, depending on the type of the variable parameter. The type of the variable
and the expression must be the same. In other words, no mixed mode specification is
allowed.
Main Index
20
Type conversions can be performed with the INT, REAL, CMPLX, ITOL, and LTOI
DMAP functions.
For character assignment statements, if the length of the expression does not match the
size of the variable, the expression is adjusted as follows:
• If the expression is shorter than the variable, the expression is padded with
enough blanks on the right before the assignment takes place to make the
sizes equal.
• If the expression is longer than the variable, characters on the right are
truncated to make the sizes the same.
Function Statement
Functions can only appear within an arithmetic or logical expression; they cannot be
referenced within module or CALL statements. Execution of the function causes the
evaluation of the function and returns a value to the referencing expression. Some
functions, however, may appear as a DMAP statement without appearing in an
arithmetic or logical expression. These functions are DIAGON, DIAGOFF, NOOP,
PUTSYS, PUTDIAG, RDIAGOFF, and RDIAGON.
The type of the value returned from a function is dependent on the type of the
argument(s) supplied, in addition to the functional operation. In general, the precision
(single, double) and form (integer, real, complex) of the result returned by the function
carries at least as much information as the arguments supplied. For example,
ACOS(X) is typed as follows:
X ACOS(X)
I RS
RS RS
RD RD
CS CS
CD CD
Main Index
CHAPTER 1 21
Direct Matrix Abstraction
Abbreviation Type
I Integer
R, RS, or RD Real
C, CS, or CD Complex
A Character
L Logical
Argument Type
Format Definition Result
to Result Type
ACOS ( x ) arccosine –1
cos ( x ) where
I and R to C
– 1 ≤ x ≤ 1 , if x is I or R C to C
x≥1 C to C
For real and integer arguments, values less than 1 result in errors.
ASIN ( x ) arcsin –1
sin ( x ) where
I and R to R
– 1 ≤ x ≤ 1 , if x is I or R C to C
C to C
ATAN ( x ) arctangent –1
tan (x)
I and R to R
C to C
C to C
Main Index
22
Argument Type
Format Definition Result
to Result Type
If both arguments are zero, then the result is zero.
If x1 and x2 are real and:
x1 = 0 and x2 > 0 , then the result is 0.
x1 = 0 and x2 < 0 , then the result is π.
x1 > 0 and x2 = 0 , then the result is π ⁄ 2 .
x1 < 0 and x2 = 0 , then the result is – π ⁄ 2 .
– 1 ≤ x ≤ 1 , if x is I or R C to C
The function takes the processor collating sequence equivalent (e.g., ASCII or
EBCDIC) of a character and converts it to the character value. The integer value
( number of bits per character )
must be within the range 1 to n – 1 , where n = 2 .
Main Index
CHAPTER 1 23
Direct Matrix Abstraction
Argument Type
Format Definition Result
to Result Type
For real arguments if one value is specified, the result is (value, 0). The precision
of the complex number is dependent on the precision of the argument; i.e.,
integer and real single values create complex single results, and real double
values create complex double results.
For complex arguments only one value can be specified. The result is the value
and type of the argument.
Integer, real single, and real double values are allowed with two arguments
only. The results are complex double if either or both arguments are real double.
The results are complex single if neither argument is real double.
Integer and real single values are converted to real double values.
Real double values are not changed.
Complex single values are converted to complex double values.
Complex double values are not changed.
Main Index
24
Argument Type
Format Definition Result
to Result Type
Mixed arguments are allowed, but function result depends solely on type of
first argument. The second argument is converted to the type of the first
argument prior to application of the function.
Mixed arguments are allowed. The result is complex double, if either or both
arguments are complex single. If neither argument is complex single, the result
is real double.
The result is TRUE if both arguments are negative, zero, or positive, FALSE
otherwise.
EXP ( x ) exponential
e
x I,R to R, C to C
The value extracted has the same type (I, RS, RD ...) as x.
The value x must be a variable parameter.
In order to obtain the value for later use in the DMAP, specify x = GETSYS(x,y).
Please see “PUTSYS, GETSYS” on page 31.
Main Index
CHAPTER 1 25
Direct Matrix Abstraction
Argument Type
Format Definition Result
to Result Type
For integer arguments, the result is zero. Results are single precision real.
For real arguments, the result is zero. Resultant precision is the same as the
argument.
For complex numbers, the result is the imaginary component, with precision
equal to that of the argument.
The result is FALSE if the first argument is negative and the second is positive
or zero. The result is true otherwise.
The result is zero if the second string is not found in the first string.
Main Index
26
Argument Type
Format Definition Result
to Result Type
Both arguments must be character strings. For arguments of the same length,
the results are TRUE if the strings satisfy the lexical comparison, and FALSE
otherwise.
For strings of different lengths, the shorter string is padded with blanks on the
right to the same size. The strings are then compared as equal length strings.
For integer and real arguments, values less than or equal to 0 result in errors.
For complex arguments the value of (0.,0.) results in an error.
For integer and real arguments, values less than or equal to 0 result in errors.
For complex arguments the value of (0.,0.) results in an error.
Main Index
CHAPTER 1 27
Direct Matrix Abstraction
Argument Type
Format Definition Result
to Result Type
The argument list must have at least two arguments and can have up to the
system limit (100) of arguments.
Mixed argument types are allowed. Complex argument types are not allowed.
The results are integer if all arguments are integer, real single if at least one
argument is real single and no arguments are real double, and real double if at
least one argument is real double.
The argument list must have at least two arguments and may have up to the
system limit (100) of arguments.
Mixed argument types are allowed. Complex argument types not allowed.
The results are integer if all arguments are integer, real single if at least one
argument is real single and no arguments are real double, and real double if at
least one argument is real double.
The results are integer only if both arguments are integer, real single if at least
one argument is real single and neither argument is real double, and real double
if at least one argument is real double.
x2 must not be equal to 0.
The result is TRUE if the signs of the arguments are different, FALSE otherwise.
NORMAL ( x ) normalize 2 2 C to R
a +b
if x = a + ib
Main Index
28
Argument Type
Format Definition Result
to Result Type
NUMGT(x1,x2) greater than TRUE, if x1 > x2 I,R,C to L
FALSE, if x1 ≤ x2
Main Index
CHAPTER 1 29
Direct Matrix Abstraction
Argument Type
Format Definition Result
to Result Type
RAND(x) random number x = seed if x>0 I,R to R
generator Use last RAND(x) as
seed if x=0. If x<0
use wall clock as seed.
Integer, real single, and complex single arguments return real single values.
Real double and complex double arguments return real double values.
Complex arguments return the real component.
Returns the CPU time remaining to the nearest hundredth of a second. Time
remaining is found by subtracting the current CPU time from the value on the
TIME execution control statement.
Main Index
30
Argument Type
Format Definition Result
to Result Type
SPROD(x1,x2) single prec product x1 ∗ x2 RD to RS, CD to CS
The results are real single if both arguments are real double and complex single
if at least one of the arguments is complex double.
Returns the remaining CPU time in integer seconds. Time remaining is found by
subtracting the current CPU time from the value on the TIME executive control
statement.
Returns VPS word length of argument. Constant for all types, except character
data that ranges from 1-20.
PUTDIAG, GETDIAG
In the PUTDIAG and GETDIAG examples below, DVALUE is an integer whose 32 bits
from left to right represent 32 DIAG values.
DVALUE=GETDIAG(DWORD) $
PUTDIAG(DVALUE,DWORD) $
Main Index
CHAPTER 1 31
Direct Matrix Abstraction
DWORD=1 represents the 1st through 32nd DIAG settings and DWORD=2, the 33rd
through 64th DIAG settings. GETDIAG and PUTDIAG are best used in pairs. For
example, to turn on DIAG 8 temporarily and then restore the original DIAG 8 setting,
the following sequence may be used:
TYPE PARM,,I,,DIAG32 $
DIAG32=GETDIAG(1) $
DIAGON(8) $ DIAG 8 WILL BE ON HERE REGARDLESS OF SETTING IN
$ EXEC. CONTROL
.
.
.
PUTDIAG(DIAG32,1) $ RESTORE DIAGs TO THEIR ORIGINAL VALUE
PUTSYS, GETSYS
System cell values may be set and recovered via the PUTSYS and GETSYS DMAP
functions. See “nastran Command and NASTRAN Statement” in Chapter 1 of the
MD Nastran Quick Reference Guide for a description of various system cells. System
cells 253 through 262 are reserved for the DMAP writer. This permits the DMAP
writer to pass parameter values in via the NASTRAN statement or between
subDMAPs.
For example,
NASTRAN SYSTEM(253)=4
SOL MYDMAP
COMPILE MYDMAP
SUBDMAP MYDMAP $
TYPE PARM,,I,N,NP $
.
.
.
IF ( GETSYS(NP,253)<>4 ) THEN $
.
.
.
ENDIF $
Control Statement
The MD Nastran DMAP language contains control statements that perform
conditional branching and looping similar to those found in the FORTRAN
programming language.
The control statements are:
Main Index
32
Conditional Execution IF
Unconditional Branching JUMP and LABEL
Conditional Branching IF( )THEN, ELSE IF( )THEN, ELSE,
and ENDIF
Looping DO WHILE and ENDDO
Calling SubDMAP Operations SUBDMAP, CALL, and RETURN
Suspension HALT
Termination EXIT and END
In other words, if the logical expression is true, then the instruction is executed.
Instruction is any DMAP module or statement, except a control statement or the FILE,
DBVIEW, TYPE and SUBDMAP statements. Examples include:
IF ( NOGOA=-1 ) ADD GOAT,GOAQ/GOA $
IF ( ERRFLAG<0 ) CALL ERROR //S,GO/ERROR $
IF ( A AND B ) X=2*Y $
where n is character string, up to eight alphanumeric characters in length, and the first
character must be alphabetic.
JUMP and LABEL can be used to jump out of a DO WHILE loop or IF( )THEN block,
but JUMP and LABEL cannot be used to jump into a DO WHILE loop or IF( )THEN
block.
Main Index
CHAPTER 1 33
Direct Matrix Abstraction
1. IF(expression)THEN $
.
. DMAP executed if expression is TRUE
.
ENDIF $
2. IF(expression)THEN $
.
. DMAP executed if expression is TRUE
.
ELSE $
.
. DMAP executed if expression is FALSE
.
ENDIF $
3. IF(expression 1)THEN $
.
. DMAP executed if expression 1 is TRUE
.
ELSE IF(expression 2)THEN $
.
. DMAP executed if expression 1 is FALSE
. and expression 2 is TRUE
ELSE IF(expression n)THEN $
.
. DMAP executed if expression 1 through expression
. n-1 are FALSE and expression n is TRUE
ELSE $
.
. DMAP executed if expression 1 through expression
. n are FALSE
ENDIF $
The expressions in the above examples are relational and/or logical operations that
result in a logical output of either TRUE or FALSE. The allowable relational operators
are discussed under “Expressions and Operators” on page 9.
Main Index
34
The expression in the above example is a relational and/or logical operation that
results in a logical output of either TRUE or FALSE. The allowable relational and
logical operators are discussed under “Expressions and Operators” on page 9. There
is no limit to the allowable number of DO WHILE statements.
Scratch NDDL and local blocks (see page 15), which are first referenced and created
inside a DO WHILE loop, are automatically deleted at the end of the loop (see page
39). The FILE statement with the APPEND or SAVE keyword may be specified to
override the automatic deletion in order to "save" a scratch data block for subsequent
passes through the DO WHILE loop. See the APPEND and FILE statement
descriptions in “DMAP Modules and Statements” on page 851 for examples.
Main Index
CHAPTER 1 35
Direct Matrix Abstraction
Main Index
36
Example
sol prtmat
compile prtmat list
subdmap prtmat $
$
type db, zuzr01 $
$
halt $
matprn zuzr01 // $
$
end $
diag 8
cent
begin bulk
end data
DMAP execution will be stopped when the HALT statement is reached. Now the
client program will place data block ZUZR01 into the database. Subsequently, DMAP
execution is resumed, and the MATPRN module will print data block ZUZR01.
Main Index
CHAPTER 1 37
Direct Matrix Abstraction
END $
If ERROR is true, the EXIT statement is used to terminate the subDMAP. The END
statement is required and must be the last statement in the subDMAP.
Declarative Statement
The declarative statements are TYPE, DBVIEW, and FILE. See “DMAP Modules and
Statements” in Chapter 4 for a description and ““Output from a Previous Module”
Rule” on page 38 and “Automatic Deletion of Scratch Data Blocks” on page 39 for
related discussion.
Main Index
38
Main Index
CHAPTER 1 39
Direct Matrix Abstraction
• For a scratch data block specified before a loop and last used inside the loop,
the LTU is extended to the bottom of the loop (e.g, ENDDO), meaning that
the data block is deleted when the loop is exited. If the data block is Scratch
NDDL, the entire family is deleted, regardless of the current qualifier values.
• For a local data block created inside a DMAP loop and last used after the
loop, the data block is deleted after the next execution of the top of the loop,
e.g., DO WHILE, even though the data block’s LTU is located after the loop
(i.e., when the loop is exited). Thus, the last generated data block can be used
after the loop exits.
• For a scratch data block created and last used inside a DMAP loop, the FILE
statement with the SAVE keyword extends the data block’s original LTU to
the bottom of the loop; otherwise, the data block is deleted at the original
LTU within the loop.
• For a Scratch NDDL data block used in a DBVIEW statement, the data block
is deleted at the LTU of the view name or the data block name, whichever is
last.
DlAG 57 prints the LTU information of all data blocks and a message indicating when
they are deleted.
Main Index
40
1. SOL 100
COMPILE USERDMAP
ALTER 2
2. If matrices or tables are to be input with DMI or DTI Bulk Data entries, the
DMIIN or DTIIN modules must be specified by the DMAP writer. For example,
the following DMAP statements generate matrices A, B, C, D, and E and tables
TA, TB, TC, TD, and TE:
DMIIN DMI,DMINDX/A,B,C,D,E,,,,,/ $
DTIIN DIT,DTINDX/TA,TB,TC,TD,TE,,,,,/ $
Data block names A, B, C, D, E, TA, TB, TC, TD, and TE can now be referenced in
subsequent DMAP statements.
3. The DMAP writer’s DMAP sequence can now be inserted.
4. TYPE statements that reference data blocks or parameters defined in the NDDL
of the structured solution sequences (SOLutions 101 through 200) can also be
inserted.
Main Index
CHAPTER 1 41
Direct Matrix Abstraction
The GEOM2S file contains element connectivity data. If the GP2 module detects errors
in this data, it will set NOGO to -1.
Modules that presently have this option include:
DCMP MGEN
DECOMP MTRXIN
DYCNTRL SEDR
EMG SELA
GP2 SEMA
GP3 SSG1
GP4 TA1
LCGEN
Main Index
42
Main Index
CHAPTER 1 43
Direct Matrix Abstraction
.
END $
CEND
A listing of these subDMAPs and the subDMAPs that they call (DBSTOR and
FNAME) can be obtained with the following input file:
COMPILE DBFETCH REF LIST
COMPILE DBSTORE REF LIST
COMPILE DBFTCH REF LIST
COMPILE DBSTOR REF LIST
COMPILE FNAME REF LIST
COMPILE DBMGR REF LIST
CEND
Main Index
44
Main Index
CHAPTER 1 45
Direct Matrix Abstraction
If a qualifier in a where-expr is not a qualifier in the path of a specified item, then the
where-expr is set to FALSE. If the where-expr does not contain a specification for all
qualifiers in the path of an item, then the unspecified qualifiers will be wildcarded
(i.e., quali=*, all values will be selected). The default values of qualifiers, PROJECT,
VERSION, and DBSET are described under the statement in which the WHERE clause
is specified.
If where-expr is to be used on a DBVIEW statement to define an output data block
from a module, then the following restrictions apply:
• The only operator allowed between qualifier assignments is the ";", for
example, WHERE (SEID=10; PEID=20).
• Only one data block can be specified by the DBVIEW statement (families are
not supported for output data blocks).
• PROJECT, PROJNO, VERSION where-expr modifier "WILDCARD" and the
use of qualifier_name=* are not allowed in the where-expr.
Examples of the WHERE clause are:
1. Select all items in the database for all superelements except 10 and 30 from
Version 1.
WHERE (VERSION=1 AND SEID>0 AND NOT(SEID=10 OR SEID=30))
2. Select all entries in database on DBSET=DBALL from all projects and
versions.
WHERE(PROJECT=PROJECT AND VERSlON>0 AND DBSET=’DBALL’)
The CONVERT clause modifies project- and version-ID, DBset-name (see “INIT” on
page 95 of the MD Nastran Quick Reference Guide statement), and qualifier values of
items selected by the WHERE clause on the DBEQUIV statements. It contains one or
more assignment statements separated by semicolons. The format of CONVERT
clause is:
CONVERT(PROJECT=project-expr; VERSION=version-expr; ,
DBSET=DBset-expr;quali=qual-expri[;...])
The PROJECT and VERSION statements modify the project-identification number(see
“PROJ” on page 101 of the MD Nastran Quick Reference Guide statement) and version-
ID. The DBSET statement modifies the DBset-name. The value of quali will be
replaced by qual-expri for selected items that have quali in their path. qual-expri is
any valid expression (see “Expressions and Operators” on page 9 containing
constants or any qualifier name defined in the path of the item. If qual-expri contains
names of qualifiers not in the path of the selected item, then a fatal message is issued.
Main Index
46
Main Index
MD Nastran 2006 DMAP Programmer’s Guide
CHAPTER
Data Blocks
2
■ Introduction
■ Matrix Data Blocks
■ Table Data Blocks
■ Table Descriptions
■ Data Block Descriptions
■ Data Block Glossary
■ Parameter Glossary
Main Index
48
2.1 Introduction
Data block descriptions are provided for all matrices and tables that are currently
processed by the OUTPUT2 and DBC modules in the MD Nastran solution sequences
with PARAM,POST.
Main Index
49
In transient response analysis, the columns of the solution matrix U_T correspond to
"time step triplets". The first column in the triplet represents displacement, then
velocity and acceleration. The triplet is then repeated for each time step. For example,
if there are 10 time steps, then U_T will have 30 columns. If multiple TSTEP command
subcases are requested, then there will be a separate solution matrix for each subcase.
Main Index
50
The columns of the dynamic load, MPCForce, and SPCForce matrices; P_T, QM_T,
and Q_T, correspond to time step and, using the example above, they will each have
10 columns.
In frequency response analysis, the columns of the dynamic load, MPCForce,
SPCForce, and solution matrices (P_F, QM_F, Q_F, and U_F), correspond to forcing
frequency. If multiple dynamic load (DLOAD) subcases are requested with NFREQ
number of forcing frequencies, the first NFREQ columns represent the first DLOAD
subcase and NFREQ frequencies, the second NFREQ columns the second subcase, etc.
For example, if an analysis is performed with four forcing frequencies and three
DLOAD subcases, then the solution matrix will have 12 columns in which the first
four columns correspond to all forcing frequencies in the first subcase. If multiple
FREQUENCY command subcases are requested, then there will be a separate solution
matrix for each subcase. For a description of matrix trailers, see “Data Blocks” on
page 13.
Main Index
51
• IFP tables
• OFP tables
• Element types
See “Table Descriptions” on page 71.
IFP Tables
The IFP module processes the Bulk Data Section and creates data blocks that contain
images of each Bulk Data entry. Then the modules IFP2 through IFP9, MODEPT,
MODGM2, GP0, SEQP, and MODGM4 create pseudo-images based on the presence
of elements used in hydroelastic, axisymmetric, laminated composite, composite
beam, acoustic, hyperelastic, beam library and p-version analyses. For example, the
IFP6 module converts PCOMP and MAT8 images to MAT2 and PSHELL pseudo-
images. All of the tables produced by these modules are also called "IFP Tables". In
an IFP Table, there is one record written for each image type present in, or derived
from, the Bulk Data Section and that record contains all of the images for that type. If
the image type is not present, then no record is written.
There are a total of 176 trailer bits. The first 96 trailer bits correspond to bit positions 1
through 16, numbered from the right, in each trailer word and beginning with trailer
word 1. The second 80 trailer bits correspond to bit positions 17 through 32, numbered
from the right, in each trailer word and beginning with trailer word 1. The table below
shows that correspondence between a trailer bit and its word and bit location in the
trailer.
Main Index
52
Location in Trailer
Trailer Bit
Word Position
1 -- 16 1 16 -- 1
17 -- 32 2 16 -- 1
33 -- 48 3 16 -- 1
49 -- 64 4 16 -- 1
65 -- 80 5 16 -- 1
81 -- 96 6 16 -- 1
97 -- 112 1 32 -- 17
113 -- 128 2 32 -- 17
129 -- 144 3 32 -- 17
145 -- 160 4 32 -- 17
161 -- 176 5 32 -- 17
For example, the GRID record in the GEOM1 data block is assigned to trailer bit 45
that corresponds to the 4th bit position, numbered from the right, in trailer word 3.
Based on the trailer bit, the following FORTRAN statements may be used to determine
the corresponding trailer word and bit position:
WORD = MOD(TBIT-1,96)/16 + 1
BIT = 16*(1+TBIT/97) -- MOD(TBIT-1,16)
where TBIT = trailer bit from second word of header record
WORD = trailer word
BIT = trailer word bit position numbered from the right
and all variables are defined as integers.
Main Index
53
OFP Tables
Header Record
The header record of all OFP tables contains codes that indicate how the output
should be labeled, formatted, and printed.
Approach_Code
Approach_code indicates analysis type and device type(s).
Main Index
54
Type Description
1 Statics
2 Normal modes or buckling (real eigenvalues)
3 Differential stiffness 0 (obsolete)
4 Differential stiffness 1 (obsolete)
5 Frequency
6 Transient
7 Pre-buckling
8 Post-buckling
9 Complex eigenvalues
10 Nonlinear statics
11 Geometric nonlinear statics
Bit Description
1 Print
2 Plot
3 Punch
Main Index
55
Examples:
Approach_code Description
61 Print transient response results
15 Print and punch statics results
106 Plot and punch nonlinear statics results
Main Index
56
Table_code
Table_code indicates basic table content (displacements, stresses, etc.), data format
(Real or complex), and sort type (SORT1 or SORT2).
1. MOD(table_code,1000) indicates table content; e.g., displacements, stresses,
etc.
Chapter
Type Description
2 Name
1 OUG Displacement vector
2 OPG Load vector
3 OQG SPCforce vector
4 OEF Element force (or flux)
5 OES Element stress(or strain)
6 LAMA Eigenvalue summary
7 OUG Eigenvector
8 none Grid point singularity table (obsolete)
9 OEIGS Eigenvalue analysis summary
10 OUG Velocity vector
11 OUG Acceleration vector
12 OPG Nonlinear force vector
13 OGPWG Grid point weight generator
14 OUG Eigenvector (solution set)
15 OUG Displacement vector (solution set)
16 OUG Velocity vector (solution set)
17 OUG Acceleration vector (solution set)
18 OEE Element strain energy
19 OGF Grid point force balance
20 OES Stresses at grid points (from the CURV module)
21 OES Strain/curvature at grid points
22 OELOF1 Element internal forces and moments
Main Index
57
Chapter
Type Description
2 Name
23 OELOP1 Summation of element oriented forces on
adjacent elements
24 OEP Element pressures
25 OEF Composite failure indices
26 OGS Grid point stresses (surface)
27 OGS Grid point stresses (volume -- direct)
28 OGS Grid point stresses (volume -- principal)
29 OGS Element stress discontinuities (surface)
30 OGS Element stress discontinuities (volume -- direct)
31 OGS Element stress discontinuities (volume --
principal)
32 OGS Grid point stress discontinuities (surface)
33 OGS Grid point stress discontinuities (volume --
direct)
34 OGS Grid point stress discontinuities (volume --
principal)
35 OGS Grid point stresses (plane strain)
36 OEE Element kinetic energy
37 OEE Element energy loss
38 OMM MAXMIN summary
39 OQG MPC forces
40 OGPKE Grip point kinetic energy
2. Data format, sort type and random type is extracted from the bit pattern
equal to table_code/1000. Bits numbered from the right are:
Bit Description
1 SORT2 (on) flag
2 Complex (on) flag
3 Random (on) flag
Main Index
58
table_code Description
4 Real force in SORT1
5 Real stress/strain in SORT1
1005 Complex stress/strain in SORT1
2010 Real velocities in SORT2
3005 Complex stress/strain in SORT2
5003 Random SPCforces in SORT2
Foremat_code
Format_code is somewhat redundant and may conflict with table_code. In regards to
real or complex, table_code/1000 always overrides format_code and if table_code
indicates complex data, then format_code is used to distinguish between
real/imaginary and magnitude/phase output.
Stress_code
In the OES data block description, word 11 (stress_code) of the header record
determines the following:
Main Index
59
Bit Description
1 Hencky von Mises (on) flag
2 Strain (on) flag
3 Strain/curvature (on) flag
4 Same as bit 2
5 Material coordinate system (on) flag
Main Index
60
Coordinate
Value On bits Description
System
0 00000 Stress maximum shear or octahedral
1 00001 Stress von Mises
10 01010 Strain curvature maximum shear or
Element octahedral
11 01011 Strain curvature von Mises
14 01110 Strain fiber maimum shear or octahedral
15 01111 Strain fiber von Mises
16 10000 Stress maximum shear or octahedral
17 10001 Stress von Mises
26 11010 Strain curvature maximum shear or
Material octahedral
27 11011 Strain curvature von Mises
30 11110 Strain fiber maimum shear or octahedral
31 11111 Strain fiber von Mises
Main Index
61
Element Type
Some tables reference an element type number; for example, EST, KDICT, OES, and
EGPSF. The element type numbers are unique across all tables but do not necessarily
appear in all tables. Some element types are pseudo-elements for data recovery
purposes only; e.g., see types 85 through 98, 100, 144, and 201 through 223.
Main Index
62
Main Index
63
Main Index
64
Main Index
65
Main Index
66
Main Index
67
Main Index
68
Main Index
69
Main Index
70
Main Index
71
Main Index
72 BGPDT
Basic grid point definition table
Contains a list of all grid points in internal sort, with (for grid points) their x, y, z
locations in the basic coordinate system along with a displacement coordinate system
identification number.
Record 0 -- HEADER
Record 1 -- DATA
Record 2 -- XIDMAP
Main Index
BGPDT 73
Basic grid point definition table
Record 3 -- BIDMAP
Record 4 -- NORMAL
Record 5 -- TRAILER
Notes:
1. For partitioned superelements the locations are in the superelement’s basic
coordinate system. In other words, each partitioned superelement has its
own basic coordinate system.
2. Scaler points are identified by CID=-1 and XCOORD = YCOORD =
ZCOORD = 0.
3. If WORD2, number of boundary grids, is zero, then record BIDMAP does not
exist and XIDMAP will be used.
Main Index
74 BGPDT68
Basic grid point definition table (Pre-Version 69)
Contains a list of all grid points in internal sort, with (for grid points) their x, y, z
locations in the basic coordinate system along with a displacement coordinate system
identification number.
Record 0 -- HEADER
Record 1 -- DATA
Record 2 -- TRAILER
Note:
1. Scaler points are identified by CID = -1 and XCOORD = YCOORD =
ZCOORD = 0.
Main Index
CASECC 75
Case Control information
Record 0 -- HEADER
Record 1 -- Repeat
Main Index
76 CASECC
Case Control information
Main Index
CASECC 77
Case Control information
Main Index
78 CASECC
Case Control information
Main Index
CASECC 79
Case Control information
Main Index
80 CASECC
Case Control information
Main Index
CASECC 81
Case Control information
Main Index
82 CASECC
Case Control information
Main Index
CASECC 83
Case Control information
Main Index
84 CASECC
Case Control information
Main Index
CASECC 85
Case Control information
Main Index
86 CASECC
Case Control information
Main Index
CASECC 87
Case Control information
Main Index
88 CASECC
Case Control information
Main Index
CASECC 89
Case Control information
Main Index
90 CASECC
Case Control information
Main Index
CASECC 91
Case Control information
Main Index
92 CASECC
Case Control information
Main Index
CASECC 93
Case Control information
Main Index
94 CASECC
Case Control information
Main Index
CASECC 95
Case Control information
Main Index
96 CASECC
Case Control information
Record 2 -- TRAILER
Notes:
1. Possible values for output media (___MEDIA) are:
• 1 = print
• 2 = plot
• 4 = punch
and their sums; e.g., 3 indicates print and plot.
2. Possible values for SORT1 output format (___FMT) are:
Main Index
CASECC 97
Case Control information
• 1 = real
• 2 = real/imaginary
• 3 = magnitude/phase
For SORT2, the same values are negative.
3. Possible values for SYMFLG are:
• 0 = no symmetry
• -1 = REPCASE and
• N = number of SYMSEQ or SUBSEQ coefficients
4. Possible values for DSAPRT are:
• 1 = Print (default)
• 0 = No print
5. Possible values for DSASTORE are:
• 1 = Store on data base and
• 0 = Don't store on data base (default)
6. Possible values for DSAOUTPT are:
• 1 = Store via OUTPUT2 and
• 0 = Don't store via OUTPUT2 (default)
7. Possible values for AXSYMSET are:
• 1 = Sine
• 2 = Cosine or fluid
8. Possible values for the SECMDFLG are:
• 0 = at least one of SEMG, SEKR, SEMR, SELG, SELR or SEALL is
specified
• -1 = none are specified
9. DSAFINAL=-1 means the last iteration.
10. DSASETID=-1 means the all design sensitivities.
11. RANDBIT contains bit pairs for the selection of PSDF and ATOC beginning
with left handed bits 1 and 2 for DISP and continuing with VELO, ACCE,
OLOAD, SPCF, STRESS, FORCE, STRAIN, and MPCF Case Control
commands for bits 3 through 18. The bit pair value of "00" means none, "01"
means ATOC, "10" means PSDF, and "11" means RALL.
Main Index
98 CASECC
Case Control information
Main Index
CLAMA 99
Complex eigenvalue summary table
Record 0 -- HEADER
Record 1 -- OFPID
Record 2 -- LAMA
Repeats for each eigenvalue.
Main Index
100 CLAMA
Complex eigenvalue summary table
Record 3 -- TRAILER
Main Index
CONTAB 101
Design constraint table
Contains a record for each design constraint. Records are sorted by the internal
constraint identification number.
Record 0 -- HEADER
Record 2 -- TRAILER
Main Index
102 CSTM
Coordinate system transformation matrices table
Record 0 -- HEADER
Record 1 -- IDENT
Record 2 -- REALDATA
Record 3 -- INTDATA
Record 4 -- TRAILER
Main Index
CSTM 103
Coordinate system transformation matrices table
Notes:
1. Coordinate system type as specified in IDENT:TYPE and by bit numbers
numbered right to left in TRAILER:WORD3:
1 = rectangular
2 = cylindrical
3 = spherical
4 = convective -- defined on a GMCURV+GMSURF pair
5 = convective -- defined on a GMSURF
6 = convective -- defined on a FEEDGE+FEFACE pair
7 = convective -- defined on a FEFACE
8 = general -- sequence of rotational angles on CORD3G entry
2. REALDATA is intended for IDENT:TYPE’s 1, 2, and 3 and contains real data
similar to CSTM68.
3. INTDATA is intended for IDENT:TYPE’s 4 through 8 and contains
GMCURV, etc. Identification numbers similar to CSTM68. XYZi data found
in CSTM68 are converted to grid entry indices into BGPDT.
Main Index
104 CSTM68
Coordinate system transformation matrices table
(Pre-Version 69)
The transformation is from global to basic.
Record 0 -- HEADER
Record 1 -- HEADER
Main Index
CSTM68 105
Coordinate system transformation matrices table
Main Index
106 CSTM68
Coordinate system transformation matrices table
Main Index
CSTM68 107
Coordinate system transformation matrices table
Main Index
108 CSTM68
Coordinate system transformation matrices table
Main Index
CSTM68 109
Coordinate system transformation matrices table
Main Index
110 CSTM68
Coordinate system transformation matrices table
Record 2 -- TRAILER
Notes:
1. Coordinate system type:
1 = rectangular
2 = cylindrical
3 = spherical
4 = convective coordinate system defined on a GMCURV+GMSURF pair
5 = convective coordinate system defined on a GMSURF
6 = convective coordinate system defined on a FEEDGE+FEFACE pair
7 = convective coordinate system defined on a FEFACE
Main Index
DBCOPT 111
Design optimization history table for postprocessing
Record 0 -- HEADER
Record 1 -- EXACT
Record 2 -- APPRX
Record 3 -- MAXIM
Record 4 -- DVIDS
Main Index
112 DBCOPT
Design optimization history table for postprocessing
Record 5 -- INITV
Record 7 -- DVLABEL
Record 8 -- TRAILER
Main Index
DBCOPT 113
Design optimization history table for postprocessing
Notes:
1. Convergence criterion:
1 = Hard convergence
2 = Soft convergence
3 = Compromise
4 = Maximum design cycles reached
Main Index
114 DESTAB
Design variable attributes
Record 0 -- HEADER
Record 1 -- Repeat
Record 2 -- TRAILER
Note:
1. Independent design variables are given first in ascending IDVID followed by
dependent design variables in ascending IDVID order.
Main Index
DIT 115
Direct input tables
Record 0 -- HEADER
Record 1 -- GUST(1005,10,174)
Record 2 -- TABDMP1(15,21,162)
Record 3 -- TABLE3D(4000,40,460)
Main Index
116 DIT
Direct input tables
Record 4 -- TABLED1(1105,11,133)
Record 5 -- TABLED2(1205,12,134)
Main Index
DIT 117
Direct input tables
Record 6 -- TABLED3(1305,13,140)
Record 7 -- TABLED4(1405,14,141)
Record 8 -- TABLEDR(4201,42,648)
Main Index
118 DIT
Direct input tables
Record 9 -- TABLEM1(105,1,93)
Same as record TABLED1 description (page 116).
Record 10 -- TABLEM2(205,2,94)
Same as record TABLED2 description (page 116).
Record 11 -- TABLEM3(305,3,95)
Same as record TABLED3 description (page 118).
Record 12 -- TABLEM4(405,4,96)
Same as record TABLED4 description (page 117).
Record 13 -- TABLES1(3105,31,97)
Record 13 -- TABLEST(1905,19,178)
Main Index
DIT 119
Direct input tables
Record 14 -- TABRND1(55,25,191)
Record 15 -- TABRNDG(56,26,303)
Power spectral density for gust loads in aeroelastic analysis.
Record 16 -- TRAILER
Notes:
1. Type of interpolation (CODEX and CODEY):
0 = linear
1 = log
Main Index
120 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 121
Design sensitivity parameters
Main Index
122 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 123
Design sensitivity parameters
Main Index
124 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 125
Design sensitivity parameters
Main Index
126 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 127
Design sensitivity parameters
Main Index
128 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 129
Design sensitivity parameters
Record 3 -- TRAILER
Notes:
1. Record 1 contains NR1 * 9 words.
2. Record 2 contains NR2 * 6 words.
Main Index
130 DSCMCOL
Design sensitivity parameters
Main Index
DVPTAB 131
Designed property table
Record 0 -- HEADER
Record 1 -- Repeat
By ascending internal property identification number order. Type one properties are
first and type two follow.
Record 2 -- TRAILER
Main Index
132 DVPTAB
Designed property table
Note:
1. There are as many records as there are designed properties. (NPROP =
NENT1 + NENT2).
Main Index
DYNAMIC 133
Table of Bulk Data entry images related to dynamics
Record 0 -- HEADER
Record 1 -- ACSRCE(5307,53,379)
Record 2 -- DAREA(27,17,182)
Scale factor for dynamic loads.
Main Index
134 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 3 -- DELAY(37,18,183)
Record 4 -- DLOAD(57,5,123)
Linear combination of dynamic loads.
Record 5 -- DPHASE(77,19,184)
Phase lead parameter in dynamic loading.
Main Index
DYNAMIC 135
Table of Bulk Data entry images related to dynamics
Record 6 -- DYNRED(4807,48,306)
Record 7 -- EIGB(107,1,86)
Main Index
136 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 8 -- EIGC(207,2,87)
Main Index
DYNAMIC 137
Table of Bulk Data entry images related to dynamics
Record 9 -- EIGP(257,4,158)
Record 11 -- EIGRL(308,8,348)
Main Index
138 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 12 -- EPOINT(707,7,124)
Record 13 -- FREQ(1307,13,126)
Main Index
DYNAMIC 139
Table of Bulk Data entry images related to dynamics
Record 14 -- FREQ1(1007,10,125)
Record 15 -- FREQ2(1107,11,166)
Record 16 -- FREQ3(1407,14,39)
Record 17 -- FREQ4(1507,15,40)
Main Index
140 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 18 -- FREQ5(1607,16,41)
Record 19 -- NLRSFD(3807,38,505)
Main Index
DYNAMIC 141
Table of Bulk Data entry images related to dynamics
Record 20 -- NOLIN1(3107,31,127)
Record 21 -- NOLIN2(3207,32,128)
Main Index
142 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 22 -- NOLIN3(3307,33,129)
Record 23 -- NOLIN4(3407,34,130)
Main Index
DYNAMIC 143
Table of Bulk Data entry images related to dynamics
Record 24 -- RANDPS(2107,21,195)
Record 25 -- RANDT1(2207,22,196)
Record 26 -- RLOAD1(5107,51,131)
Main Index
144 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 27 -- RLOAD2(5207,52,132)
Record 28 -- RGYRO(10701,107,117)
Main Index
DYNAMIC 145
Table of Bulk Data entry images related to dynamics
Record 29 -- ROTORG(10801,108,242)
Record 30 -- RSPINR(10901,109,260)
Main Index
146 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 31 -- RSPINT(11001,110,310)
Record 32 -- SEQEP(5707,57,135)
Record 33 -- TF(6207,62,136)
Main Index
DYNAMIC 147
Table of Bulk Data entry images related to dynamics
Record 34 -- TIC(6607,66,137)
Record 35 -- TIC(11601,116,655)
Main Index
148 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 36 -- TIC3(11601,116,655)
Main Index
DYNAMIC 149
Table of Bulk Data entry images related to dynamics
Record 37 -- TLOAD1(7107,71,138)
Record 38 -- TLOAD2(7207,72,139)
Main Index
150 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 39 -- TSTEP(8307,83,142)
Record 40 -- UNBALNC(11101,111,368)
Main Index
DYNAMIC 151
Table of Bulk Data entry images related to dynamics
Record 41 -- TRAILER
Main Index
152 EGPSF
Table of element to grid point surface interpolation factors
Contains surface and volume data and element stress factors for each grid point in that
surface or volume.
Record 0 -- HEADER
Record 1 -- IDENT
Record 2 -- DATA
Main Index
EGPSF 153
Table of element to grid point surface interpolation factors
Main Index
154 EGPSF
Table of element to grid point surface interpolation factors
Record 3 -- TRAILER
Notes:
1. Records IDENT and DATA are repeated for each surface and volume.
2. In FLAG for volumes, connectivity refers to grid point position on
connection entry and identity flag will be 1 if TOE is an identity matrix.
Main Index
EGPSF 155
Table of element to grid point surface interpolation factors
Main Index
156 EGPSF
Table of element to grid point surface interpolation factors
Main Index
EGPSTR 157
Element grid point stress table
Record 0 -- HEADER
Record 1 -- Repeat
See “EGPSF” on page 152 for a description of surface and volume definition data.
Main Index
158 EGPSTR
Element grid point stress table
Main Index
EGPSTR 159
Element grid point stress table
Record 2 -- TRAILER
Notes:
1. NF is based on the value of FIBRE and whether strain/curvature or stresses
are being processed.
If strain/curvature and FIBRE = 4 then NF=1
If strain/curvature and FIBRE <> 4 then NF=2
If stress FIBRE=1, 2, or 4 then NF=1
If stress FIBRE=0, 3, 5, 6, or, 7 then NF=3
3. The element identification number is 0 unless more than one grid stress was
output for a given grid point. In that case the element identification number
defines the connected element for the given grid point stress.
Main Index
160 ELDCT
Element stress discontinuity table
Record 0 -- HEADER
Record 1 -- Repeat
See “EGPSF” on page 152 for a description of surface and volume definition data.
Main Index
ELDCT 161
Element stress discontinuity table
Record 2 -- TRAILER
Main Index
162 ELDCT
Element stress discontinuity table
Notes:
1. NF is based on the value of FIBRE and whether strain/curvature or stresses
are being processed.
If strain/curvature and FIBRE = 4 then NF=1
If strain/curvature and FIBRE <> 4 then NF=2
If stress FIBRE=1, 2, or 4 then NF=1
If stress FIBRE=0, 3, 5, 6, or, 7 then NF=3
Main Index
EPT 163
Element property table
Record 0 -- HEADER
Word Name Type Description
1 SID I Set identification number
2 PROP CHAR4
3 TYPE CHAR4 Set of property or elements
4 ORIGIN I Entry origin
ORIGIN =0 NSM Bulk Data entry
5 ID I Property or element identification
number
6 VALUE RS Nonstructural mass value
Words 5 through 6 repeat until End of Record
ORIGIN =2 NSML Bulk Data entry
5 ID I Property or element identification
number
6 VALUE RS Nonstructural mass value
Words 5 through 6 repeat until End of Record
End ORIGIN
Record 1 -- HGSUPPR(13901,139,654)
Main Index
164 EPT
Element property table
Record 2 -- NSM(3201,32,55)
Record 3 -- NSM1(3301,33,56)
7 ID I
Word 7 repeats until End of Record
SPECOPT =2 All
7 ALL(2) CHAR4
Main Index
EPT 165
Element property table
Main Index
166 EPT
Element property table
Record 4 -- NSML1(3601,36,62)
Main Index
EPT 167
Element property table
Record 5 -- NSMADD(3401,34,57)
Record 6R -- NSML(3501,35,58)
Record 7 -- NSML1(3601,36,62)
Main Index
168 EPT
Element property table
Main Index
EPT 169
Element property table
Main Index
170 EPT
Element property table
Main Index
EPT 171
Element property table
Record 12 -- PBARL(9102,91,52)
Record 13 -- PBCOMP(5403,55,349)
Main Index
172 EPT
Element property table
Main Index
EPT 173
Element property table
Main Index
174 EPT
Element property table
Main Index
EPT 175
Element property table
Main Index
176 EPT
Element property table
Main Index
EPT 177
Element property table
Main Index
178 EPT
Element property table
Main Index
EPT 179
Element property table
Record 14 -- PBEAM(5402,54,262)
Main Index
180 EPT
Element property table
Main Index
EPT 181
Element property table
Record 15 -- PBEAML(9202,92,53)
Record 16 -- PBEND(2502,25,248)
Main Index
182 EPT
Element property table
Main Index
EPT 183
Element property table
Record 17 -- PBMSECT(13301,133,509)
Main Index
184 EPT
Element property table
Main Index
EPT 185
Element property table
Main Index
186 EPT
Element property table
Record 18 -- PBRSECT(13201,132,513)
Main Index
EPT 187
Element property table
Main Index
188 EPT
Element property table
Record 19 -- PBUSH(1402,14,37)
Main Index
EPT 189
Element property table
Record 20 -- PBUSH1D(3101,31,219)
Main Index
190 EPT
Element property table
Main Index
EPT 191
Element property table
Record 21 -- PBUSHT(702,7,38)
Record 22 -- PCOMP(2706,27,287)
Main Index
192 EPT
Element property table
Record 23 -- PCOMPA(13100,131,547)
Main Index
EPT 193
Element property table
Record 24 -- PCONEAX(152,19,147)
Record 25 -- PCONV(11001,110,411)
Main Index
194 EPT
Element property table
Record 26 -- PCONVM(2902,29,420)
Record 27 -- PDAMP(202,2,45)
Record 28 -- PDAMPT(1202,12,33)
Main Index
EPT 195
Element property table
Record 29 -- PDAMP5(8702,87,412)
Record 30 -- PDUM1(6102,61,116)
Record 31 -- PDUM2(6202,62,117)
Record 32 -- PDUM3(6302,63,118)
Record 33 -- PDUM4(6402,64,159)
Record 34 -- PDUM5(6502,65,160)
Main Index
196 EPT
Element property table
Record 35 -- PDUM6(6602,66,161
)
Record 36 -- PDUM7(6702,67,163)
Record 37 -- PDUM8(6802,68,164)
Record 38 -- PDUM9(6902,69,165)
Record 39 -- PELAS(302,3,46)
Main Index
EPT 197
Element property table
Record 40 - PFAST(13501,135,510)
Record 41 -- PELAST(1302,13,34)
Main Index
198 EPT
Element property table
Record 42 -- PGAP(2102,21,121)
Record 43 -- PHBDY(2802,28,236)
Main Index
EPT 199
Element property table
Record 44 -- PINTC(12001,120,480)
Record 45 -- PINTS(12101,121,484)
Record 46 -- PLPLANE(4606,46,375)
Record 47 -- PLSOLID(4706,47,376)
Main Index
200 EPT
Element property table
Record 48 -- PMASS(402,4,44)
Record 49 -- PROD(902,9,29)
Record 50 -- PSHEAR(1002,10,42)
Main Index
EPT 201
Element property table
Record 51 -- PSHELL(2302,23,283)
Record 52 -- PSOLID(2402,24,281)
Main Index
202 EPT
Element property table
Record 53 -- PSOLIDL(7602,76,370)
Record 54 -- PTRIA6(6202,62,117)
Record 55 -- PTSHELL(13801,138,645)
Main Index
EPT 203
Element property table
Record 56 -- PTUBE(1602,16,30)
This record is slightly unstructured: OD2 is only written out if heat transfer.
Main Index
204 EPT
Element property table
Record 58 -- PVAL(10201,102,400)
Main Index
EPT 205
Element property table
Record 60 -- PWELD(11801,118,560)
Record 61 -- PWSEAM(13701,137,638)
Main Index
206 EPT
Element property table
Record 62 -- VIEW(2606,26,289)
Record 63 -- VIEW3D(3002,30,415)
Main Index
EPT 207
Element property table
Record 64 -- TRAILER
Main Index
208 EPT01
Element property table for MSC.Nastran Version 2001
Note: EPT01 is identical in format and content to EPT except for the following
records.
Record 0 – PBUSH(1402,14,37)
Record 1 – PBUSHT(702,7,38)
Main Index
EPT01 209
Element property table for MSC.Nastran Version 2001
Record 2 -- PTSHELL(13801,138,645)
Record 3 - PWSEAM(13701,137,638)
Main Index
210 EPT01
Element property table for MSC.Nastran Version 2001
Main Index
EQEXIN 211
Equivalence between external and internal grid/scalar numbers
Record 0 -- HEADER
Record 1 -- EXT2INT
Contains pairs of external grid and scalar identification numbers and internal
numbers in external sort.
Record 2 -- EXT2SIL
Contains pairs of external grid and scalar numbers and coded SIL numbers in external
sort.
Record 3 -- TRAILER
Main Index
212 EQEXIN
Equivalence between external and internal grid/scalar numbers
Note:
1. In TENXSIL, SIL number (scalar index value) is the degree-of-freedom
counter and in this context represents the first degree-of-freedom of the grid
or scalar point. Code represents the type of point:
For example, if there are three grid points in the model, then the three SIL
numbers are 1, 7, and 13 and the TENXSIL numbers are 11, 71, and 131.
Main Index
ERROR 213
Table of p-element error tolerances
Record 0 -- HEADER
Record 1 -- ERROR
Record 2 -- TRAILER
Main Index
214 ERROR
Table of p-element error tolerances
Note:
1. WHYCAS is composed of bits for internal use only. Bits include values for
ERRTOL,SIGTOL,EPSTOL,ERRGRD,ERRELM.
Main Index
FOL 215
Frequency response frequency output list
Record 0 -- HEADER
Record 1 -- TRAILER
Main Index
216 GEOM1
Table of Bulk Data entry images related to geometry
Record 0 -- HEADER
Record 1 -- CORD1C(1701,17,6)
Record 2 -- CORD1R(1801,18,5)
Main Index
GEOM1 217
Table of Bulk Data entry images related to geometry
Record 3 -- CORD1S(1901,19,7)
Record 4 -- CORD2C(2001,20,9)
Main Index
218 GEOM1
Table of Bulk Data entry images related to geometry
Record 5 -- CORD2R(2101,21,8)
Record 6 -- CORD2S(2201,22,10)
Main Index
GEOM1 219
Table of Bulk Data entry images related to geometry
Record 7 -- CORD3R(14301,143,651)
Record 8 -- CSUPER(2301,23,304)
Record 9 -- CSUPEXT(5501,55,297)
Main Index
220 GEOM1
Table of Bulk Data entry images related to geometry
Record 10 -- EXTRN(1627,16,463)
Record 11 -- FEEDGE(6101,61,388)
Record 12 -- GMCURV(6601,66,392)
Main Index
GEOM1 221
Table of Bulk Data entry images related to geometry
Record 13 -- FEFACE(6201,62,389)
Record 14 -- POINT(6001,60,377)
Record 15 -- GMSURF(10101,101,394)
Main Index
222 GEOM1
Table of Bulk Data entry images related to geometry
Record 16 -- GMCORD(6401,64,402)
Record 17 -- GRID(4501,45,1)
Main Index
GEOM1 223
Table of Bulk Data entry images related to geometry
Record 18 -- SEBNDRY(1527,15,466)
Record 19 -- SEBULK(1427,14,465)
Record 20 -- SECONCT(427,4,453)
Main Index
224 GEOM1
Table of Bulk Data entry images related to geometry
Record 21 -- SEELT(7902,79,302)
Record 22 -- SEEXCLD(527,72,454)
Record 23 -- SELABEL(1027,10,459)
Main Index
GEOM1 225
Table of Bulk Data entry images related to geometry
Record 24 -- SELOC(827,8,457)
Record 25 -- SEMPLN(927,9,458)
Main Index
226 GEOM1
Table of Bulk Data entry images related to geometry
Record 26 -- SENQSET(1327,13,464)
Record 27 -- SEQGP(5301,53,4)
Record 28 -- SEQSEP(5401,54,305)
Record 29 -- SESET(5601,56,296)
Main Index
GEOM1 227
Table of Bulk Data entry images related to geometry
Record 30 -- SETREE(1227,12,462)
Record 31 -- SNORM(5678,71,475)
Record 32 -- CSUPER1(5701,57,323)
This record is obsolete and will be removed eventually.
Main Index
228 GEOM1
Table of Bulk Data entry images related to geometry
Record 33 -- SUPUP(5801,58,324)
This record is obsolete and will be removed eventually.
Record 34 -- SWLDPRM(14101,141,403)
Main Index
GEOM1 229
Table of Bulk Data entry images related to geometry
Record 35 -- TRAILER
Notes:
1. CSUPER1 and CSUPUP records are only recognized by IFP module and will
be removed eventually.
2. ADUMi records are not written. Rather, the contents are coded and stored in
words 45 thru 54 of the system cell common block.
3. There is no record for the GRDSET entry. Rather, the GRID record is
modified accordingly.
4. When GEOM1 is an alias for GEOM1VU, view grids are appended to the
GRID record. The starting view grid identification number is controlled by
system cell 180.
Main Index
230 GEOM1
Table of Bulk Data entry images related to geometry
On the SEBULK entry, the allowable values for superelement type are 1=PRIMARY
2=COLLECTOR 3=IDENTICAL 4=REPEATED 5=EXTERNAL 6=MIRROR.
Main Index
GEOM168 231
Table of Bulk Data entry images related to geometry for MSC.Nastran Version 68
GEOM168 Table of Bulk Data entry images related to geometry for MSC.Nastran
Version 68
GEOM168 is identical in format and content to GEOM1 except for the following
records.
Record 0 -- CORD2C(2001,20,9)
Main Index
232 GEOM168
Table of Bulk Data entry images related to geometry for MSC.Nastran Version 68
Record 1 -- CORD2R(2101,21,8)
Word Name Type Description
1 CID I Coordinate system identification number
2 ONE I Constant 1
3 TWO I Constant 2
4 RID I Reference coordinate system
identification number
5 A1 RS Location of A in coordinate 1 of RID
6 A2 RS Location of A in coordinate 2 of RID
7 A3 RS Location of A in coordinate 3 of RID
8 B1 RS Location of B in coordinate 1 of RID
9 B2 RS Location of B in coordinate 2 of RID
10 B3 RS Location of B in coordinate 3 of RID
11 C1 RS Location of C in coordinate 1 of RID
12 C2 RS Location of C in coordinate 2 of RID
13 C3 RS Location of C in coordinate 3 of RID
Record 2 -- CORD2S(2201,22,10)
Word Name Type Description
1 CID I Coordinate system identification number
2 SIXTY5 I Constant 65
3 EIGHT I Constant 8
4 RID I Reference coordinate system
identification number
5 A1 RS Location of A in coordinate 1 of RID
6 A2 RS Location of A in coordinate 2 of RID
7 A3 RS Location of A in coordinate 3 of RID
8 B1 RS Location of B in coordinate 1 of RID
9 B2 RS Location of B in coordinate 2 of RID
10 B3 RS Location of B in coordinate 3 of RID
Main Index
GEOM168 233
Table of Bulk Data entry images related to geometry for MSC.Nastran Version 68
Record 3 -- GRID(4501,45,1)
Record 4 -- POINT(6001,60,377)
Word Name Type Description
1 ID I Point identification number
2 CID I Coordinate system identification number
3 X1 RS Location of the point in coordinate 1 of
CID
4 X2 RS Location of the point in coordinate 2 of
CID
5 X3 RS Location of the point in coordinate 3 of
CID
Main Index
234 GEOM2
Table of Bulk Data entries related to element connectivity
Record 0 -- HEADER
Record 1 -- AEROQ4(2002,20,0)
Record 2 -- AEROT3(1801,18,0)
Main Index
GEOM2 235
Table of Bulk Data entries related to element connectivity
Record 4 -- CAABSF(2708,27,59)
Record 5 -- CAXIF2(2108,21,224)
Record 6 -- CAXIF3(2208,22,225)
Main Index
236 GEOM2
Table of Bulk Data entries related to element connectivity
Record 7 -- CAXIF4(2308,23,226)
Record 8 -- CBAR(2408,24,180)
Main Index
GEOM2 237
Table of Bulk Data entries related to element connectivity
Record 9 -- CBARAO(4001,40,275)
Main Index
238 GEOM2
Table of Bulk Data entries related to element connectivity
Record 10 -- CBEAM(5408,54,261)
Main Index
GEOM2 239
Table of Bulk Data entries related to element connectivity
Record 11 -- CBEAMP(11401,114,9016)
Main Index
240 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 241
Table of Bulk Data entries related to element connectivity
Record 12 -- CBEND(4601,46,298)
Main Index
242 GEOM2
Table of Bulk Data entries related to element connectivity
Record 13 -- CBUSH(2608,26,60)
Main Index
GEOM2 243
Table of Bulk Data entries related to element connectivity
Record 14 -- CBUSH1D(5608,56,218)
Main Index
244 GEOM2
Table of Bulk Data entries related to element connectivity
Record 15 -- CCONE(2315,23,0)
Record 16 -- CDAMP1(201,2,69)
Record 17 -- CDAMP2(301,3,70)
Main Index
GEOM2 245
Table of Bulk Data entries related to element connectivity
Record 18 -- CDAMP3(401,4,71)
Record 19 -- CDAMP4(501,5,72)
Record 20 -- CDAMP5(10608,106,404)
Record 21 -- CDUM2(6208,62,108)
Record 22 -- CDUM3(6308,63,109)
Main Index
246 GEOM2
Table of Bulk Data entries related to element connectivity
Record 23 -- CDUM4(6408,64,110)
Record 24 -- CDUM5(6508,65,111)
Record 25 -- CDUM6(6608,66,112)
Record 26 -- CDUM7(6708,67,113)
Record 27 -- CDUM8(6808,68,114)
Record 28 -- CDUM9(6908,69,115)
Main Index
GEOM2 247
Table of Bulk Data entries related to element connectivity
Record 29 -- CELAS1(601,6,73)
Record 30 -- CELAS2(701,7,74)
Record 31 -- CELAS3(801,8,75)
Main Index
248 GEOM2
Table of Bulk Data entries related to element connectivity
Record 32 -- CELAS4(901,9,76)
Record 33 -- CFAST(9801,98,506)
Main Index
GEOM2 249
Table of Bulk Data entries related to element connectivity
Record 34 -- CFASTP(9301,93,607)
Main Index
250 GEOM2
Table of Bulk Data entries related to element connectivity
Record 35 -- CFLUID2(8515,85,0)
Record 36 -- CFLUID3(8615,86,0)
Record 37 -- CFLUID4(8715,87,0)
Main Index
GEOM2 251
Table of Bulk Data entries related to element connectivity
Record 38 -- CINT(7701,77,8881)
Main Index
252 GEOM2
Table of Bulk Data entries related to element connectivity
Record 39 -- CGAP(1908,19,104)
Main Index
GEOM2 253
Table of Bulk Data entries related to element connectivity
Record 40 -- CHACAB(8100,81,381)
Record 41 -- CHACBR(8200,82,383)
Record 42 -- CHBDYE(8308,83,405)
Main Index
254 GEOM2
Table of Bulk Data entries related to element connectivity
Record 43 -- CHBDYG(10808,108,406)
Record 44 -- CHBDYP(10908,109,407)
Main Index
GEOM2 255
Table of Bulk Data entries related to element connectivity
Record 45 -- CHEXA(7308,73,253)
Record 46 -- CHEXA20F(16300,163,9999)
Same as record CHEXA description.
Record 47 -- CHEXAFD(14000,140,9990)
Same as record CHEXA description.
Record 48 -- CHEXAL(7908,79,369)
Main Index
256 GEOM2
Table of Bulk Data entries related to element connectivity
Record 49 -- CHEXP(12001,120,9011)
Record 50 -- CHEXPR(7409,74,9991)
Same as record CHEXA description.
Record 51 -- CMASS1(1001,10,65)
Record 52 -- CMASS2(1101,11,66)
Main Index
GEOM2 257
Table of Bulk Data entries related to element connectivity
Record 53 -- CMASS3(1201,12,67)
Record 54 -- CMASS4(1301,13,68)
Record 55 -- CMFREE(2508,25,0)
Record 56 -- CONM1(1401,14,63)
Main Index
258 GEOM2
Table of Bulk Data entries related to element connectivity
Record 57 -- CONM2(1501,15,64)
Main Index
GEOM2 259
Table of Bulk Data entries related to element connectivity
Record 58 -- CONROD(1601,16,47)
Record 59 -- CONV(12701,127,408)
Record 60 -- CONVM(8908,89,422)
Main Index
260 GEOM2
Table of Bulk Data entries related to element connectivity
Record 61 -- CPENP(12101,121,9012)
Record 62 -- CPENTA(4108,41,280)
Record 63 -- CPENPR(7509,75,9992)
Same as record CPENTA description.
Record 64 -- CPENT15F(16500,165,9999)
Same as record CPENTA description.
Main Index
GEOM2 261
Table of Bulk Data entries related to element connectivity
Record 65 -- CPENT6FD(16000,160,9999)
Same as record CPENTA description.
Record 66 -- CQDX4FD(17000,170,9999)
Record 67 -- CQDX9FD(17100,171,9999)
Same as record CQDX4FD description.
Record 68 -- CQUAD(9108,91,507)
Record 69 -- CQUAD4(2958,51,177)
Main Index
262 GEOM2
Table of Bulk Data entries related to element connectivity
Record 70 -- CQUAD4FD(13900,139,9989)
Same as record CQUAD description.
Record 71 -- CQUAD8(4701,47,326)
Record 72 -- CQUAD9FD(16400,164,9999)
Main Index
GEOM2 263
Table of Bulk Data entries related to element connectivity
Record 73 -- CQUADP(11101,111,9014)
Record 74 -- CQUADR(8009,80,367)
Same as record CQUAD4 description.
Record 75 -- CQUADX(9008,90,508)
Same as record CQUAD description.
Record 76 -- CRBAR(14700,147,6662)
Main Index
264 GEOM2
Table of Bulk Data entries related to element connectivity
Record 77 -- CRBE1(17300,173,6664)
Main Index
GEOM2 265
Table of Bulk Data entries related to element connectivity
Record 78 -- CRBE3(17200,172,6663)
Main Index
266 GEOM2
Table of Bulk Data entries related to element connectivity
Record 79 -- CRJOINT(11000,110,6667)
Record 80 -- CROD(3001,30,48)
Record 81 -- CRROD(12600,126,6661)
Main Index
GEOM2 267
Table of Bulk Data entries related to element connectivity
Record 82 -- CSEAM(13801,138,570)
Word Name Type Description
1 EID I Element identification number
2 PID I Property ID
3 NSIL I Number of non zero sils
4 PRJTOL RS Projection tolerance
5 AVGTHK RS Half the ave thick of shell A and B
6 GS I Starting grid id
7 GE I Ending grid id
8 PCID I Coor. sys. id for the projection
direction,-1 element
9 IECT(32) I sill numbers of upper and lower patches
41 XYZS(3) RS Coord of GS
44 XYZE(3) RS Coord of GE
47 T1S(3) RS T1S vector of the element tangent coord.
sys.
50 T1E(3) RS T1E vector of the element tangent coord.
sys.
53 T2S(3) RS T2S vector of the element tangent coord.
sys.
56 T2E(3) RS T2E vector of the element tangent coord.
sys.
59 NSEQ(24) I Node sequence table of the upper and
lower shells
Record 83 -- CSHEAR(3101,31,61)
Main Index
268 GEOM2
Table of Bulk Data entries related to element connectivity
Record 84 -- CSLOT3(4408,44,227)
Record 86 -- CTETP(12201,122,9013)
Main Index
GEOM2 269
Table of Bulk Data entries related to element connectivity
Record 87 -- CTETRA(5508,55,217)
Record 88 -- CTETPR(7609,76,9993)
Same as record CTETRA description.
Record 89 -- CTETR10F(16600,166,9999)
Same as record CTETRA description.
Record 90 -- CTETR4FD(16100,161,9999)
Same as record CTETRA description.
Record 91 -- CTQUAD(14801,148,643)
Main Index
270 GEOM2
Table of Bulk Data entries related to element connectivity
Record 92 -- CTTRIA(14901,149,644)
Record 93 -- CTRIA3(5959,59,282)
Record 94 -- CTRIA3FD(16200,162,9999)
Main Index
GEOM2 271
Table of Bulk Data entries related to element connectivity
Record 95 -- CTRIA6(4801,48,327)
Record 96 -- CTRIA6FD(16700,167,9999)
Same as record CTRIA3FD description.
Record 97 -- CTRIAP(11301,113,9015)
Main Index
272 GEOM2
Table of Bulk Data entries related to element connectivity
Record 98 -- CTRIAR(9200,92,385)
Same as record CTRIA3 description.
Record 99 -- CTRIAX(10108,101,512)
Main Index
GEOM2 273
Table of Bulk Data entries related to element connectivity
Main Index
274 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 275
Table of Bulk Data entries related to element connectivity
Main Index
276 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 277
Table of Bulk Data entries related to element connectivity
Main Index
278 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 279
Table of Bulk Data entries related to element connectivity
Main Index
280 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 281
Table of Bulk Data entries related to element connectivity
Main Index
282 GEOM2
Table of Bulk Data entries related to element connectivity
Notes:
1. Records appear in ascending internal element identification number.
2. When the ECT is an alias for the GEOM2VU block the third word of the
header record in:
Main Index
GEOM2 283
Table of Bulk Data entries related to element connectivity
Main Index
284 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Table of Bulk Data entries related to element connectivity for MSC.Nastran Version
2001.
Note: GEOM201 is identical in format and content to GEOM2 except for the
following records.
Record 6 – CBAR(2408,24,180)
Main Index
GEOM201 285
Table of Bulk Data entries related to V2001 element connectivity
Record 8 – CBEAM(5408,54,261)
Main Index
286 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 65 – CQUAD4(2958,51,177)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(4) I Grid point identification numbers of
connection points
Main Index
GEOM201 287
Table of Bulk Data entries related to V2001 element connectivity
Record 67 – CQUAD8(4701,47,326)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(8) I Grid point identification numbers of
connection points
11 T(4) RS Membrane thickness of element at grid
points
15 THETA RS Material property orientation angle or
coordinate system identification number
16 ZOFFS RS Offset from the surface of grid points
reference plane
Main Index
288 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 69 – CQUADP(11101,111,9014)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(17) I Internal indices of connection points
20 UNDEF(7 ) none
27 INORM I Flag for normals
28 THETA RS Material property orientation angle or
coordinate system identification number
29 ZOFFS RS Offset from the surface of grid points
reference plane
30 UNDEF(2 ) none
32 T(4) RS Membrane thickness of element at grid
points
Record 73 -- CRBE1(17300,173,6664)
Main Index
GEOM201 289
Table of Bulk Data entries related to V2001 element connectivity
Record 74 -- CRBE3(17200,172,6663)
Main Index
290 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 81 – CTRIA3(5959,59,282)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(3) I Grid point identification numbers of
connection points
6 THETA RS Material property orientation angle or
coordinate system identification numbers
7 ZOFFS RS Offset from the surface of grid points
reference plane
8 UNDEF(3 ) none
11 T(3) RS Membrane thickness of element at grid
points
Main Index
GEOM201 291
Table of Bulk Data entries related to V2001 element connectivity
Record 83 – CTRIA6(4801,48,327)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(6) I Grid point identification numbers of
connection points
9 THETA RS Material property orientation angle or
coordinate system identification number
10 ZOFFS RS Offset from the surface of grid points
reference plane
11 T(3) RS Membrane thickness of element at grid
points
Record 85 – CTRIAP(11301,113,9015)
Word Name Type Description
1 EID I Element identification number
2 PID I Property identification number
3 G(11) I Internal indices of grid points
14 UNDEF(3 ) none
17 THETA RS Material property orientation angle or
coordinate system identification number
18 UNDEF none
19 ZOFFS RS Offset from the surface of grid points
reference plane
20 UNDEF(2 ) none
22 T(3) RS Membrane thickness of element at grid
points
Main Index
292 GEOM3
Table of Bulk Data entry images related to static and thermal loads
GEOM3 Table of Bulk Data entry images related to static and thermal loads
Record 0 -- HEADER
Record 1 -- ACCEL(11302,113,600)
Record 2 -- ACCEL1(11402,114,601)
Main Index
GEOM3 293
Table of Bulk Data entry images related to static and thermal loads
Record 3 -- FORCE(4201,42,18)
Record 4 -- FORCE1(4001,40,20)
Record 5 -- FORCE2(4101,41,22)
Record 6 -- GMLOAD(6309,63,391)
Main Index
294 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Main Index
GEOM3 295
Table of Bulk Data entry images related to static and thermal loads
Record 7 -- GRAV(4401,44,26)
Record 8 -- LOAD(4551,61,84)
Main Index
296 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 9 -- LOADCYH(3709,37,331)
Record 10 -- LOADCYN(3809,38,332)
Record 11 -- LOADCYT(3909,39,333)
Main Index
GEOM3 297
Table of Bulk Data entry images related to static and thermal loads
Record 12 -- LSEQ(3609,36,188)
Record 13 -- MOMENT(4801,48,19)
Record 14 -- MOMENT1(4601,46,21)
Record 15 -- MOMENT2(4701,47,23)
Main Index
298 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 16 -- PLOAD(5101,51,24)
Record 17 -- PLOAD1(6909,69,198)
Record 18 -- PLOAD2(6802,68,199)
Record 19 -- PLOAD3(7109,71,255)
Main Index
GEOM3 299
Table of Bulk Data entry images related to static and thermal loads
Record 20 -- PLOAD4(7209,72,299)
Record 21 -- PLOADX(7001,70,278)
This record is obsolete.
Record 22 -- PLOADX1(7309,73,351)
Main Index
300 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 23 -- PRESAX(5215,52,154)
Record 24 -- QBDY1(4509,45,239)
Record 25 -- QBDY2(4909,49,240)
Main Index
GEOM3 301
Table of Bulk Data entry images related to static and thermal loads
Record 26 -- QBDY3(2109,21,414)
Record 27 -- QHBDY(4309,43,233)
Record 28 -- QVECT(2209,22,241)
Main Index
302 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 29 -- QVOL(2309,23,416)
Record 30 -- RFORCE(5509,55,190)
Record 31 -- SLOAD(5401,54,25)
Main Index
GEOM3 303
Table of Bulk Data entry images related to static and thermal loads
Record 32 -- TEMP(5701,57,27)
Record 33 -- TEMPD(5641,65,98)
Record 34 -- TEMPEST(11109,111,424)
Record 35 -- TEMPF(6209,62,390)
Record 36 -- TEMPIC(11209,112,425)
Main Index
304 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 37 -- TEMPP1(8109,81,201)
Record 38 -- TEMPP2(8209,82,202)
This record is obsolete.
Record 39 -- TEMPP3(8309,83,203)
This record is obsolete.
Main Index
GEOM3 305
Table of Bulk Data entry images related to static and thermal loads
Record 40 -- TEMPRB(8409,84,204)
Record 41 -- PFACE(6409,64,9032)
This record is created by the GP0 module and not by the user.
Main Index
306 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 42 -- PEDGE(6609,66,9031)
This record is created by the GP0 module and not by the user.
Main Index
GEOM3 307
Table of Bulk Data entry images related to static and thermal loads
Record 43 -- TRAILER
Main Index
308 GEOM301
Table of Bulk Data entry images related to static and thermal loads
GEOM301 Table of Bulk Data entry images related to static and thermal loads
Table of Bulk Data entry images related to static and thermal loads for MSC.Nastran
Version 2001.
Note: GEOM301 is identical in format and content to GEOM3 except for the
following records.
Record 18 -- PLOAD4(7209,72,299)
Main Index
GEOM4 309
Table of Bulk Data entry images related to constraints
Record 0 -- HEADER
Record 1 -- ASET(5561,76,215)
Record 2 -- ASET1(5571,77,216)
Main Index
310 GEOM4
Table of Bulk Data entry images related to constraints
Record 3 -- BNDGRID(10200,102,473)
Record 4 -- BSET(110,1,311)
Record 5 -- BSET1(210,2,312)
Record 6 -- CSET(310,3,313)
Main Index
GEOM4 311
Table of Bulk Data entry images related to constraints
Record 7 -- CSET1(410,4,314)
Record 8 -- CYAX(1510,15,328)
Record 9 -- CYJOIN(5210,52,257)
Main Index
312 GEOM4
Table of Bulk Data entry images related to constraints
Record 10 -- CYSUP(1610,16,329)
Record 11 -- CYSYM(1710,17,330)
Record 12 -- EGENDT(8801,88,9022)
Main Index
GEOM4 313
Table of Bulk Data entry images related to constraints
Record 13 -- FCENDT(9001,90,9024)
Main Index
314 GEOM4
Table of Bulk Data entry images related to constraints
Main Index
GEOM4 315
Table of Bulk Data entry images related to constraints
Record 14 -- GMBC(8001,80,395)
Main Index
316 GEOM4
Table of Bulk Data entry images related to constraints
Record 15 -- GMSPC(7801,78,393)
Record 16 -- MPC(4901,49,17)
Record 17 -- MPCADD(4891,60,83)
Main Index
GEOM4 317
Table of Bulk Data entry images related to constraints
Record 18 -- OMIT(5001,50,15)
Record 19 -- OMIT1(4951,63,92)
Record 20 -- QSET(510,5,315)
Main Index
318 GEOM4
Table of Bulk Data entry images related to constraints
Record 21 -- QSET1(610,6,316)
Record 22 -- RBAR(6601,66,292)
Main Index
GEOM4 319
Table of Bulk Data entry images related to constraints
Record 23 -- RBE1(6801,68,294)
Record 24 -- RBE2(6901,69,295)
Main Index
320 GEOM4
Table of Bulk Data entry images related to constraints
Record 25 -- RBE3(7101,71,187)
Record 26 -- RBJOINT(14201,142,652)
Main Index
GEOM4 321
Table of Bulk Data entry images related to constraints
Record 27 -- -- RBJSTIF(14301,143,653)
Main Index
322 GEOM4
Table of Bulk Data entry images related to constraints
Main Index
GEOM4 323
Table of Bulk Data entry images related to constraints
Main Index
324 GEOM4
Table of Bulk Data entry images related to constraints
Main Index
GEOM4 325
Table of Bulk Data entry images related to constraints
Main Index
326 GEOM4
Table of Bulk Data entry images related to constraints
Record 28 -- RELEASE(1310,13,247)
Main Index
GEOM4 327
Table of Bulk Data entry images related to constraints
Record 29 -- RPNOM(14101,141,640)
Record 30 -- RROD(6501,65,291)
Main Index
328 GEOM4
Table of Bulk Data entry images related to constraints
Record 31 -- RSPLINE(7001,70,186
)
Record 32 -- RSSCON(7201,72,398)
Main Index
GEOM4 329
Table of Bulk Data entry images related to constraints
Record 33 -- RTRPLT(6701,67,293)
Main Index
330 GEOM4
Table of Bulk Data entry images related to constraints
Record 34 -- RWELD(11901,119,561)
Record 35 -- SEBSET(710,7,317)
Record 36 -- SEBSET1(810,8,318)
Main Index
GEOM4 331
Table of Bulk Data entry images related to constraints
Record 37 -- SECSET(910,9,319)
Record 38 -- SECSET1(1010,10,320)
Main Index
332 GEOM4
Table of Bulk Data entry images related to constraints
Record 39 -- SEQSET(1110,11,321)
Record 40 -- SEQSET1(1210,12,322)
Record 41 -- SESUP(1410,14,325)
Main Index
GEOM4 333
Table of Bulk Data entry images related to constraints
Record 42 -- SEUSET(1810,18,334)
Record 43 -- SEUSET1(1910,19,335)
Record 44 -- SPC(5501,55,16)
Main Index
334 GEOM4
Table of Bulk Data entry images related to constraints
Record 45 -- SPC1(5481,58,12)
Record 46 -- SPCADD(5491,59,13)
Record 47 -- SPCD(5110,51,256)
Main Index
GEOM4 335
Table of Bulk Data entry images related to constraints
Record 48 -- SPCDE(8701,87,9021)
Record 49 -- SPCDF(8901,89,9023)
Record 50 -- SPCDG(9701,97,9030)
Main Index
336 GEOM4
Table of Bulk Data entry images related to constraints
Record 51 -- SPCE(9301,93,9027)
Record 52 -- SPCEB(9101,91,9025)
Record 53 -- SPCF(9401,94,9028)
Record 54 -- SPCFB(9201,92,9026)
Main Index
GEOM4 337
Table of Bulk Data entry images related to constraints
Record 55 -- SPCGB(9601,96,9029)
Record 56 -- SPCGRID(8601,86,9031)
Record 57 -- SPCOFF(6110,61,343)
Record 58 -- SPCOFF1(6210,62,344)
Main Index
338 GEOM4
Table of Bulk Data entry images related to constraints
Record 59 -- SUPORT(5601,56,14)
Record 60 -- SUPORT1(10100,101,472)
Record 61 -- TEMPBC(11309,113,426)
Main Index
GEOM4 339
Table of Bulk Data entry images related to constraints
Record 62 -- USET(2010,20,193)
Record 63 -- USET1(2110,21,194)
Record 64 -- TRAILER
Main Index
340 GEOM4705
Table of Bulk Data entry images related to constraints for MSC.Nastran Version 70.5
Note: GEOM4705 is identical in format and content to GEOM4 except for the
following records.
Record 16 -- MPC(4901,49,17)
Word Name Type Description
1 SID I Set identification number
2 G I Grid point identification number
3 C I Component number
4 A RS Coefficient
5 GI I Grid point identification number
6 CI I Component number
7 AI RS Coefficient
Words 5 through 7 repeat until (-1,-1,-1) occurs
Record 41 - SPC(5501,55,16)
Record 44 - SPCD(5110,51,256)
Main Index
GPDT68 341
Grid point definition table (Pre-Version 69)
Contains a list of all grid points and scalar points in internal sort, with (for grid points)
their x, y, z locations in the location coordinate system along with a location and
displacement coordinate system identification number, and constraint information.
Record 0 -- HEADER
Record 1 -- POINT
Record 2 -- TRAILER
Notes:
1. Scalar points are identified by CP=-1 and words X1 through PS are zero.
Main Index
342 GPDT68
Grid point definition table (Pre-Version 69)
2. See the description of the “GRID” on page 1624 of the MD Nastran Quick
Reference Guide Bulk Data entry constraint code, PS.
3. For fluid grid points CD=-1.
Main Index
GPL 343
Grid point list
Record 0 -- HEADER
Record 1 -- GRID
Contains a list of external grid and scalar identification numbers in internal sort.
Record 2 -- GRIDSIL
Contains pairs of external grid and scalar identification numbers and sequence
numbers in internal sort.
Record 3 -- TRAILER
Note:
1. SEQNO, sequence number, may be overridden by the SEQGP Bulk Data
entry.
Main Index
344 HIS
Table of design iteration history
Record 0 -- HEADER
Record 1 -- Repeat
Record 2 -- TRAILER
Notes:
1. For soft convergence, the final objective and constraint values are those
obtained from DOM9.
2. For hard convergence, they are obtained from a re-analysis.
3. The design variable values are identical for soft and hard convergence and
are repeated for consistency.
Main Index
KDICT 345
Element stiffness dictionary table
Each record defines an element in terms of its connection data and address pointers
into the corresponding element matrix in the KELM data block.
Record 0 -- HEADER
Record 1 -- Repeat
Repeats for each element type.
Main Index
346 KDICT
Element stiffness dictionary table
Record 2 -- TRAILER
Notes:
1. FORM=3 indicates the element stiffness matrix is defined in the global
coordinate system.
Main Index
KDICT 347
Element stiffness dictionary table
Main Index
348 LAMA
Normal modes or buckling eigenvalue summary table
Record 0 -- HEADER
Record 2 -- LAMA
Repeats for each eigenvalue.
Main Index
LAMA 349
Normal modes or buckling eigenvalue summary table
Record 3 -- TRAILER
Main Index
350 MPT
Table of Bulk Data entry images related to material properties
Record 0 -- HEADER
Record 1 -- CREEP(1003,10,245)
Record 2 -- MAT1(103,1,77)
Main Index
MPT 351
Table of Bulk Data entry images related to material properties
Record 3 -- MAT2(203,2,78)
Record 4 -- MAT3(1403,14,122)
Main Index
352 MPT
Table of Bulk Data entry images related to material properties
Record 5 -- MAT4(2103,21,234)
Main Index
MPT 353
Table of Bulk Data entry images related to material properties
Record 6 -- MAT5(2203,22,235)
Record 7 -- MAT8(2503,25,288)
Main Index
354 MPT
Table of Bulk Data entry images related to material properties
Record 8 -- MAT9(2603,26,300)
Record 9 -- MAT10(2801,28,365)
Main Index
MPT 355
Table of Bulk Data entry images related to material properties
Record 10 -- MAT11(2903,29,371)
This record is not currently used.
Main Index
356 MPT
Table of Bulk Data entry images related to material properties
Record 11 -- MATHP(4506,45,374)
Main Index
MPT 357
Table of Bulk Data entry images related to material properties
Main Index
358 MPT
Table of Bulk Data entry images related to material properties
Record 12 -- MATS1(503,5,90)
Main Index
MPT 359
Table of Bulk Data entry images related to material properties
Record 13 -- MATT1(703,7,91)
Record 14 -- MATT2(803,8,102)
Record 15 -- MATT3(1503,15,189)
Record 16 -- MATT4(2303,23,237)
Main Index
360 MPT
Table of Bulk Data entry images related to material properties
Record 17 -- MATT5(2403,24,238)
Record 18 -- MATT8(903,9,336)
This record is not currently used.
Record 19 -- MATT9(2703,27,301)
Main Index
MPT 361
Table of Bulk Data entry images related to material properties
Record 20 -- -- MBOLT(12600,126,646)
Record 21 -- MBOLTUS(12800,128,650)
Main Index
362 MPT
Table of Bulk Data entry images related to material properties
Record 22 -- -- MSTACK(12700,127,649)
Main Index
MPT 363
Table of Bulk Data entry images related to material properties
Main Index
364 MPT
Table of Bulk Data entry images related to material properties
Record 24 -- RADBND(9002,90,410)
Record 25 -- RADM(8802,88,413)
Record 26 -- RADMT(8902,89,423)
Record 27 -- NLPARM(3003,30,286)
Main Index
MPT 365
Table of Bulk Data entry images related to material properties
Record 28 -- NLPCI(3104,32,350)
Main Index
366 MPT
Table of Bulk Data entry images related to material properties
Record 29 -- TSTEPNL(3103,31,337)
Main Index
MPT 367
Table of Bulk Data entry images related to material properties
Record 30 -- TRAILER
Main Index
368 OBJTAB
Design objective table
OBJTAB is defined for a given analysis type and superelement and contains objective
attributes with retained response identification numbers.
Record 0 -- HEADER
Record 1 -- HEADER
Record 2 -- TRAILER
Main Index
OEE 369
Output element energy (strain, kinetic, loss)
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
370 OEE
Output element energy (strain, kinetic, loss)
Main Index
OEE 371
Output element energy (strain, kinetic, loss)
Record 2 -- DATA
Main Index
372 OEE
Output element energy (strain, kinetic, loss)
Main Index
OEE 373
Output element energy (strain, kinetic, loss)
Record 3 -- TRAILER
Notes:
1. Records are repeated for each element type having at least one element
requested for output. They are also repeated for each subcase.
2. Device code:
1 = print
2 = plot
4 = punch
5 = print and punch, etc.
3. Approach code:
1 = statics
2 = reigen
3=ds0
4 = ds1
5 = freq
6 = tran
7 = bkl0
8 = bkl1
9 = ceigen
10 = pla
4. Nonexistent element energy densities are flagged by integer '-1' in the field.
Main Index
374 OEF
Table of element forces
Also contains composite failure indices and a analysis types (real and complex) and
SORT1 and SORT2 formats.
Record 0 -- HEADER
Record 1 -- DATA
Record 2 -- IDENT
Main Index
OEF 375
Table of element forces
Main Index
376 OEF
Table of element forces
Record 3 -- DATA
Main Index
OEF 377
Table of element forces
Main Index
378 OEF
Table of element forces
Main Index
OEF 379
Table of element forces
Main Index
380 OEF
Table of element forces
Main Index
OEF 381
Table of element forces
Main Index
382 OEF
Table of element forces
Main Index
OEF 383
Table of element forces
Main Index
384 OEF
Table of element forces
Main Index
OEF 385
Table of element forces
Main Index
386 OEF
Table of element forces
Main Index
OEF 387
Table of element forces
Main Index
388 OEF
Table of element forces
Main Index
OEF 389
Table of element forces
Main Index
390 OEF
Table of element forces
Main Index
OEF 391
Table of element forces
Main Index
392 OEF
Table of element forces
Main Index
OEF 393
Table of element forces
Main Index
394 OEF
Table of element forces
Main Index
OEF 395
Table of element forces
Main Index
396 OEF
Table of element forces
Main Index
OEF 397
Table of element forces
Main Index
398 OEF
Table of element forces
Main Index
OEF 399
Table of element forces
Main Index
400 OEF
Table of element forces
Main Index
OEF 401
Table of element forces
Main Index
402 OEF
Table of element forces
Main Index
OEF 403
Table of element forces
Main Index
404 OEF
Table of element forces
Main Index
OEF 405
Table of element forces
Main Index
406 OEF
Table of element forces
Main Index
OEF 407
Table of element forces
Main Index
408 OEF
Table of element forces
Main Index
OEF 409
Table of element forces
Main Index
410 OEF
Table of element forces
Main Index
OEF 411
Table of element forces
Main Index
412 OEF
Table of element forces
Main Index
OEF 413
Table of element forces
Main Index
414 OEF
Table of element forces
Main Index
OEF 415
Table of element forces
Main Index
416 OEF
Table of element forces
Main Index
OEF 417
Table of element forces
Main Index
418 OEF
Table of element forces
Main Index
OEF 419
Table of element forces
Main Index
420 OEF
Table of element forces
Main Index
OEF 421
Table of element forces
Main Index
422 OEF
Table of element forces
Main Index
OEF 423
Table of element forces
Main Index
424 OEF
Table of element forces
Main Index
OEF 425
Table of element forces
Main Index
426 OEF
Table of element forces
Main Index
OEF 427
Table of element forces
Main Index
428 OEF
Table of element forces
Main Index
OEF 429
Table of element forces
Main Index
430 OEF
Table of element forces
Main Index
OEF 431
Table of element forces
Main Index
432 OEF
Table of element forces
Main Index
OEF 433
Table of element forces
Main Index
434 OEF
Table of element forces
Main Index
OEF 435
Table of element forces
Main Index
436 OEF
Table of element forces
Record 4 -- TRAILER
Main Index
OEF 437
Table of element forces
Notes:
1. The RECORD=IDENT and DATA pair is repeated for each subcase.
2. For CDAMPi and CVISC elements, force output is only available in
frequency response.
3. For composite elements, ELTYPEs 95 through 98, OEF contains composite
failure indices and the DATA record is repeated for each ply as well as each
element. Also, EID=-1, then OFP module prints a blank line.
Main Index
Main Index
OES 439
Table of element stresses or strains
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
440 OES
Table of element stresses or strains
Main Index
OES 441
Table of element stresses or strains
Record 2 -- DATA
Main Index
442 OES
Table of element stresses or strains
Main Index
OES 443
Table of element stresses or strains
Main Index
444 OES
Table of element stresses or strains
Main Index
OES 445
Table of element stresses or strains
Main Index
446 OES
Table of element stresses or strains
Main Index
OES 447
Table of element stresses or strains
Main Index
448 OES
Table of element stresses or strains
Main Index
OES 449
Table of element stresses or strains
Main Index
450 OES
Table of element stresses or strains
Main Index
OES 451
Table of element stresses or strains
Main Index
452 OES
Table of element stresses or strains
Main Index
OES 453
Table of element stresses or strains
Main Index
454 OES
Table of element stresses or strains
Main Index
OES 455
Table of element stresses or strains
Main Index
456 OES
Table of element stresses or strains
Main Index
OES 457
Table of element stresses or strains
Main Index
458 OES
Table of element stresses or strains
Main Index
OES 459
Table of element stresses or strains
Main Index
460 OES
Table of element stresses or strains
Main Index
OES 461
Table of element stresses or strains
Main Index
462 OES
Table of element stresses or strains
Main Index
OES 463
Table of element stresses or strains
Main Index
464 OES
Table of element stresses or strains
Main Index
OES 465
Table of element stresses or strains
Main Index
466 OES
Table of element stresses or strains
Main Index
OES 467
Table of element stresses or strains
Main Index
468 OES
Table of element stresses or strains
Main Index
OES 469
Table of element stresses or strains
Main Index
470 OES
Table of element stresses or strains
Main Index
OES 471
Table of element stresses or strains
Main Index
472 OES
Table of element stresses or strains
Main Index
OES 473
Table of element stresses or strains
Main Index
474 OES
Table of element stresses or strains
Main Index
OES 475
Table of element stresses or strains
Main Index
476 OES
Table of element stresses or strains
Main Index
OES 477
Table of element stresses or strains
Main Index
478 OES
Table of element stresses or strains
Main Index
OES 479
Table of element stresses or strains
Main Index
480 OES
Table of element stresses or strains
Main Index
OES 481
Table of element stresses or strains
Main Index
482 OES
Table of element stresses or strains
Main Index
OES 483
Table of element stresses or strains
Main Index
484 OES
Table of element stresses or strains
Main Index
OES 485
Table of element stresses or strains
Main Index
486 OES
Table of element stresses or strains
Main Index
OES 487
Table of element stresses or strains
Main Index
488 OES
Table of element stresses or strains
Main Index
OES 489
Table of element stresses or strains
Main Index
490 OES
Table of element stresses or strains
Main Index
OES 491
Table of element stresses or strains
Main Index
492 OES
Table of element stresses or strains
Main Index
OES 493
Table of element stresses or strains
Main Index
494 OES
Table of element stresses or strains
Main Index
OES 495
Table of element stresses or strains
Main Index
496 OES
Table of element stresses or strains
Main Index
OES 497
Table of element stresses or strains
Main Index
498 OES
Table of element stresses or strains
Main Index
OES 499
Table of element stresses or strains
Main Index
500 OES
Table of element stresses or strains
Main Index
OES 501
Table of element stresses or strains
Main Index
502 OES
Table of element stresses or strains
Main Index
OES 503
Table of element stresses or strains
Main Index
504 OES
Table of element stresses or strains
Main Index
OES 505
Table of element stresses or strains
Main Index
506 OES
Table of element stresses or strains
Main Index
OES 507
Table of element stresses or strains
Main Index
508 OES
Table of element stresses or strains
Main Index
OES 509
Table of element stresses or strains
Main Index
510 OES
Table of element stresses or strains
Main Index
OES 511
Table of element stresses or strains
Main Index
512 OES
Table of element stresses or strains
Main Index
OES 513
Table of element stresses or strains
Main Index
514 OES
Table of element stresses or strains
Main Index
OES 515
Table of element stresses or strains
Main Index
516 OES
Table of element stresses or strains
Main Index
OES 517
Table of element stresses or strains
Main Index
518 OES
Table of element stresses or strains
Main Index
OES 519
Table of element stresses or strains
Main Index
520 OES
Table of element stresses or strains
Main Index
OES 521
Table of element stresses or strains
Main Index
522 OES
Table of element stresses or strains
Main Index
OES 523
Table of element stresses or strains
Main Index
524 OES
Table of element stresses or strains
Main Index
OES 525
Table of element stresses or strains
Main Index
526 OES
Table of element stresses or strains
Main Index
OES 527
Table of element stresses or strains
Main Index
528 OES
Table of element stresses or strains
Main Index
OES 529
Table of element stresses or strains
Main Index
530 OES
Table of element stresses or strains
Main Index
OES 531
Table of element stresses or strains
Main Index
532 OES
Table of element stresses or strains
Main Index
OES 533
Table of element stresses or strains
Main Index
534 OES
Table of element stresses or strains
Main Index
OES 535
Table of element stresses or strains
Main Index
536 OES
Table of element stresses or strains
Main Index
OES 537
Table of element stresses or strains
Main Index
538 OES
Table of element stresses or strains
Main Index
OES 539
Table of element stresses or strains
Main Index
540 OES
Table of element stresses or strains
Main Index
OES 541
Table of element stresses or strains
Main Index
542 OES
Table of element stresses or strains
Main Index
OES 543
Table of element stresses or strains
Main Index
544 OES
Table of element stresses or strains
Main Index
OES 545
Table of element stresses or strains
Main Index
546 OES
Table of element stresses or strains
Main Index
OES 547
Table of element stresses or strains
Main Index
548 OES
Table of element stresses or strains
Main Index
OES 549
Table of element stresses or strains
Main Index
550 OES
Table of element stresses or strains
Main Index
OES 551
Table of element stresses or strains
Main Index
552 OES
Table of element stresses or strains
Main Index
OES 553
Table of element stresses or strains
Main Index
554 OES
Table of element stresses or strains
Main Index
OES 555
Table of element stresses or strains
Main Index
556 OES
Table of element stresses or strains
Main Index
OES 557
Table of element stresses or strains
Main Index
558 OES
Table of element stresses or strains
Main Index
OES 559
Table of element stresses or strains
Main Index
560 OES
Table of element stresses or strains
Main Index
OES 561
Table of element stresses or strains
Main Index
562 OES
Table of element stresses or strains
Main Index
OES 563
Table of element stresses or strains
Main Index
564 OES
Table of element stresses or strains
Main Index
OES 565
Table of element stresses or strains
Main Index
566 OES
Table of element stresses or strains
Main Index
OES 567
Table of element stresses or strains
Main Index
568 OES
Table of element stresses or strains
Main Index
OES 569
Table of element stresses or strains
Main Index
570 OES
Table of element stresses or strains
Main Index
OES 571
Table of element stresses or strains
Main Index
572 OES
Table of element stresses or strains
Main Index
OES 573
Table of element stresses or strains
Main Index
574 OES
Table of element stresses or strains
Main Index
OES 575
Table of element stresses or strains
Main Index
576 OES
Table of element stresses or strains
Main Index
OES 577
Table of element stresses or strains
Main Index
578 OES
Table of element stresses or strains
Main Index
OES 579
Table of element stresses or strains
Main Index
580 OES
Table of element stresses or strains
Main Index
OES 581
Table of element stresses or strains
Main Index
582 OES
Table of element stresses or strains
Main Index
OES 583
Table of element stresses or strains
Main Index
584 OES
Table of element stresses or strains
Record 3 -- TRAILER
Notes:
1. For CBEAM (2) Item codes are given for end A. Addition of the quantity (K-1) 10
to the item code points to the same information for other stations, where K is the
station number. K=11 for end B and 2-10 for intermediate stations.
2. For CTRIA6 (53) The stresses are repeated for each of the stress points within
each element. For CHEX8 there are 9 stress points for each element. For CHEX20
there are 9 plus (the number of nondeleted mid-side nodes) stress points for each
element.
3. For QUAD8 (64) For corner grids, real , add 17I to items 3 through 19, where I =
1,2,3,4 (87 total words). For corner grids, real/imaginary add 15I to items 3
through 19, where I = 1,2,3,4 (77 total words).
Main Index
OGF 585
Table of grid point forces
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
586 OGF
Table of grid point forces
Main Index
OGF 587
Table of grid point forces
Record 2 -- DATA
Main Index
588 OGF
Table of grid point forces
Main Index
OGF 589
Table of grid point forces
Record 3 -- TRAILER
Notes:
1. Records repeat for each subcase having any output requests.
2. Device code:
1 = print
2 = plot
4 = punch
5 = print, and punch, etc.
3. Approach code:
1 = statics
Main Index
590 OGF
Table of grid point forces
2 = reigen
3 = ds0
4 = ds1
5 = freq
6 = bkl0
7 = bkl1
8 = ceigen
9 = pla
Main Index
OGS 591
Table of grid point stresses/strains or discontinuities
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
592 OGS
Table of grid point stresses/strains or discontinuities
Record 2 -- DATA
Main Index
OGS 593
Table of grid point stresses/strains or discontinuities
Main Index
594 OGS
Table of grid point stresses/strains or discontinuities
Main Index
OGS 595
Table of grid point stresses/strains or discontinuities
Main Index
596 OGS
Table of grid point stresses/strains or discontinuities
Record 3 -- TRAILER
Notes:
1. Records repeat for each surface or volume.
2. Record 2 is the same format for stress (SCODE=0) or strain (SCODE=1).
Main Index
OGS 597
Table of grid point stresses/strains or discontinuities
Main Index
598 OPG
Table of applied loads
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
OPG 599
Table of applied loads
Main Index
600 OPG
Table of applied loads
Record 2 -- DATA
Main Index
OPG 601
Table of applied loads
Main Index
602 OPG
Table of applied loads
Record 3 -- TRAILER
Main Index
OPTPRM 603
Table of optimization parameters
Record 0 -- HEADER
Record 1 -- PARAMS
Main Index
604 OPTPRM
Table of optimization parameters
Record 2 -- TRAILER
Main Index
OQG 605
Table of single or multipoint constraint forces
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
606 OQG
Table of single or multipoint constraint forces
Main Index
OQG 607
Table of single or multipoint constraint forces
Record 2 -- DATA
Main Index
608 OQG
Table of single or multipoint constraint forces
Main Index
OQG 609
Table of single or multipoint constraint forces
Main Index
610 OQG
Table of single or multipoint constraint forces
Record 3 -- TRAILER
Main Index
OUG 611
Table of displacements, velocities, accelerations
Also, temperatures for heat transfer and sound pressure levels for acoustic analyses.
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 0 -- HEADER
Record 1 -- IDENT
Main Index
612 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 613
Table of displacements, velocities, accelerations
Record 2 -- DATA
Main Index
614 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 615
Table of displacements, velocities, accelerations
Main Index
616 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 617
Table of displacements, velocities, accelerations
Main Index
618 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 619
Table of displacements, velocities, accelerations
Main Index
620 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 621
Table of displacements, velocities, accelerations
Main Index
622 OUG
Table of displacements, velocities, accelerations
Record 3 -- TRAILER
Main Index
R1MAP 623
Table of mapping from original first level
Record 0 -- HEADER
Record 1 -- RESPONSE
Record 2 -- TRAILER
Main Index
624 R1TAB
Table of type one response attributes
Record 0 -- HEADER
Record 1 -- Repeat
Main Index
R1TAB 625
Table of type one response attributes
Main Index
626 R1TAB
Table of type one response attributes
Main Index
R1TAB 627
Table of type one response attributes
Main Index
628 R1TAB
Table of type one response attributes
Main Index
R1TAB 629
Table of type one response attributes
Main Index
630 R1TAB
Table of type one response attributes
Main Index
R1TAB 631
Table of type one response attributes
Record 2 -- TRAILER
Notes:
1. Table is in IRID order and is the order in which responses are to be
generated.
2. TYFLG currently has no meaning. The intent was to use this attribute to
identify responses that should always be retained in DSAD. However, this
option is not currently supported.
Main Index
632 RESP12
Table of second level (synthetic) responses
Record 0 -- HEADER
Main Index
RESP12 633
Table of second level (synthetic) responses
Main Index
634 RESP12
Table of second level (synthetic) responses
Main Index
RESP12 635
Table of second level (synthetic) responses
Record 2 -- TRAILER
Notes:
1. EQPOS = 12 + ND + NC + NR + 2*NCORD + NPROP + NCEQ 1.NCC is
equal to 2*NCRD.
2. Pointer FRT1 is equal to ND+NCT+12, pointer FRCD is equal to
FRT1+NCEQ, pointer FRCEQ is equal to FRCD + 2 * NCRD, pointer EQPOS
is equal to FRCEQ + NCEQ.
Main Index
636 SEMAP
Superelement Definition Table (Map)
Record 0 -- HEADER
Record 1 -- DEFINE
Repeated for each superelement according to process order.
Main Index
SEMAP 637
Superelement Definition Table (Map)
Record 2 -- MAP
Repeated for each superelement according to process order and contains LENTRY
words per grid point.
Record 3 -- INFO
Repeated for each superelement according to process order.
Main Index
638 SEMAP
Superelement Definition Table (Map)
Record 4 -- TRAILER
Notes:
1. SEID=0 implies residual.
2. This table is UNSTRUCTURED. The reason is that each of the records repeat
for each superelement.
The low order (right to left) 10 bits in TYPEBIT are set as follows:
Bit Position: Meaning
0 9 8 7 6 5 4 3 2 1
------------------- -------
0 0 0 0 0 0 0 0 0 0 Primary
1 . . . . . . . . . Partitioned
. 1 . . . . . . . . Reflect Z
. . 1 . . . . . . . Reflect Y
. . . 1 . . . . . . Reflect X
. . . . 1 . . . . . Repeated
. . . . . 1 . . . . Collector
. . . . . . 1 . . . External
. . . . . . . 1 . . Mirror
. . . . . . . . 1 . Identical
. . . . . . . . . 1 Apply mapping transform
Main Index
SEMAP 639
Superelement Definition Table (Map)
ln ( max ( NBRSE,1 ) )
IDBITS = int --------------------------------------------------- + 1.01
ln 2
Main Index
640 SEMAP
Superelement Definition Table (Map)
Main Index
SET 641
Table of combined sets
Record 0 -- HEADER
Record 1 -- (*)
Record 2 -- TRAILER
Notes:
1. TYPE: 0=unknown, 1=grid, 2=element, 3=grid pairs
2. SETORIG: 1=Case Control section, 2=plot section, 3=SET1 Bulk Data entries,
4=MSGMESH input
Main Index
642 TOL
Transient response time step output list
Record 0 -- HEADER
Record 1 -- TRAILER
Main Index
VIEWTB 643
View information table
Contains the relationship between each p-element and its view-elements and view-
grids.
Record 0 -- HEADER
Record 1 -- BEAMP(10500,105,14)
Main Index
644 VIEWTB
View information table
Record 2 -- HEXAP(14100,141,18)
Record 3 -- PENTAP(14200,142,16)
Main Index
VIEWTB 645
View information table
Record 4 -- QUADP(10300,103,16)
Main Index
646 VIEWTB
View information table
Record 5 -- TETRAP(14300,143,14)
Record 6 -- TRIAP(10400,104,15)
Main Index
VIEWTB 647
View information table
Record 7 -- TRAILER
Notes:
1. For each of the 3 word headers: The first number is element type * 100; the
second number is element type; and the third number is the number of
words per element.
2. Items indicated as from field ’XXX’ refer to the OUTRCV Bulk Data entry.
Main Index
CHAPTER 2 648
Data Blocks
Chapter 4 Chapter 2
Description
Name Name
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.
Main Index
649 CHAPTER 2
Data Blocks
Chapter 4 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 650
Data Blocks
Chapter 4 Chapter 2
Description
Name Name
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.
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.
Main Index
651 CHAPTER 2
Data Blocks
Chapter 4 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 652
Data Blocks
Chapter 4 Chapter 2
Description
Name Name
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.
Main Index
653 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 654
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
655 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
BGPDTX BGPDT BGPDT assembled for superelements defined on the
SEPLOT or SEUPPLOT command. Output by SEPLOT.
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.
Main Index
CHAPTER 2 656
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
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.
Main Index
657 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 658
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
659 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 660
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
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.
Main Index
661 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 662
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
663 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 664
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
665 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 666
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
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.
Main Index
667 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
DGEOM3 GEOM3 Table of Bulk Data entry images related to static loads for
the perturbed configuration. Output by DSAH.
Main Index
CHAPTER 2 668
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
669 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 670
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
671 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 672
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
673 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 674
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
675 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 676
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
677 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 678
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
679 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 680
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
681 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 682
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
683 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 684
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
685 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 686
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
687 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
GEOM4CN GEOM4 Updated constraints for 3D contact. Output by NLSOLV.
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.
Main Index
CHAPTER 2 688
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
689 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 690
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
691 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
CHAPTER 2 692
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
693 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
CHAPTER 2 694
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
695 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 696
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
697 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 698
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
699 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 700
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
701 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 702
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
703 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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'.
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.
Main Index
CHAPTER 2 704
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
705 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 706
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
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
Main Index
707 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 708
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
709 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
CHAPTER 2 710
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
711 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 712
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
713 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 714
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
OFPi2 Output table in SORT2 format.
Main Index
715 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 716
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
717 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 718
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
719 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 720
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
OUG1 OUG Table of displacements in SORT1 format. Output by
SDR2 or DRMH3.
OUG1DS OUG Table of displacements in SORT1 format for design
responses.
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.
Main Index
721 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 722
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
723 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 724
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
725 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 726
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
727 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 728
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
729 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 730
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
731 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
CHAPTER 2 732
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
733 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 734
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
735 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
Main Index
CHAPTER 2 736
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
RSP3RG Table of attributes of the retained third level responses.
RSPTQS Matrix of updated initial SPCforces.
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.
Main Index
737 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 738
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
739 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
Main Index
CHAPTER 2 740
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
741 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 742
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
743 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 744
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
745 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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).
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.
Main Index
CHAPTER 2 746
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
747 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 748
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.0’s 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.
Main Index
749 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
CHAPTER 2 750
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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
751 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 752
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
753 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
Main Index
CHAPTER 2 754
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
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.
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.
Main Index
755 CHAPTER 2
Data Blocks
Chapter 3 Chapter 2
Description
Name Name
ZETAH Mass-normalized damping.
Z1ZX Matrix of unrestrained dimensional elastic derivatives
ZZX Reduced aerostatic solution matrix.
Main Index
CHAPTER 2 756
Data Blocks
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.
Superelements:
Main Index
757 CHAPTER 2
Data Blocks
Solutions:
___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
Loads:
Main Index
CHAPTER 2 758
Data Blocks
Main Index
759 CHAPTER 2
Data Blocks
Miscellaneous:
__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.
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
Inconsistent Names:
Main Index
CHAPTER 2 760
Data Blocks
Main Index
761 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 762
Data Blocks
Main Index
763 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 764
Data Blocks
Main Index
765 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 766
Data Blocks
Main Index
767 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 768
Data Blocks
Main Index
769 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 770
Data Blocks
where f max and fmin are the maximum and minimum frequencies
across all FREQi Bulk Data entries.
Main Index
771 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 772
Data Blocks
Main Index
773 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 774
Data Blocks
Main Index
775 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 776
Data Blocks
Main Index
777 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 778
Data Blocks
Main Index
779 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 780
Data Blocks
Main Index
781 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 782
Data Blocks
Main Index
783 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 784
Data Blocks
Main Index
785 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 786
Data Blocks
Main Index
787 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 788
Data Blocks
Main Index
789 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 790
Data Blocks
Main Index
791 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 792
Data Blocks
Main Index
793 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 794
Data Blocks
Main Index
795 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 796
Data Blocks
Main Index
797 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 798
Data Blocks
Main Index
799 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 800
Data Blocks
Main Index
801 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 802
Data Blocks
Main Index
803 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 804
Data Blocks
Main Index
805 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 806
Data Blocks
Main Index
807 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 808
Data Blocks
Main Index
809 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 810
Data Blocks
Main Index
811 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 812
Data Blocks
Main Index
813 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 814
Data Blocks
Main Index
815 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 816
Data Blocks
Main Index
817 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 818
Data Blocks
Main Index
819 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 820
Data Blocks
Main Index
821 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 822
Data Blocks
Main Index
823 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 824
Data Blocks
Main Index
825 CHAPTER 2
Data Blocks
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.
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.
Main Index
CHAPTER 2 826
Data Blocks
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.
0 Symmetric; i.e., CP is used for RP
<>0 Asymmetric; 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.
1 Transpose
0 Do 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.
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.
Main Index
827 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 828
Data Blocks
Main Index
829 CHAPTER 2
Data Blocks
Main Index
CHAPTER 2 830
Data Blocks
2 Mass
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
831 CHAPTER 2
Data Blocks
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.
Main Index
832 CHAPTER 2
Data Blocks
Main Index
MD Nastran 2006 DMAP Programmer’s Guide
CHAPTER
NASTRAN Data Definition Language
3 (NDDL)
■ NDDL Summary
■ Detailed Description of NDDL Statements
Main Index
834
DATABLK Define a data block’s name, path, and location and describe its
contents.
DEPEN Define a data block, parameter, or virtual parameter to be dependent
upon other data block(s), parameter(s) or virtual parameter(s).
PARAM Define a parameter’s name, type, path, location, and default value.
PATH List the QUALifiers to be used in accessing the data block or
parameter via the NDDL.
QUAL Define a qualifier’s name, type and default value
Main Index
835
Main Index
836 DATABLK
Describes data blocks used for NDDL access
A data block is a collection of matrix columns or table records and may be broken
down into the following entities:
1. Record (or column) is a group of items and/or entries.
2. Entry is a group of items and/or entries within a record.
3. Item is a single scalar quantity; such as an integer, real number, complex number,
character string, or logical.
Format:
DATABLK,db_name,PATH=pathname,LOCATION=loc_param,
MATRIX
UNSTRUCTURED
SAMEAS,sname
TYPE = TABLE [ ( style ) ] EOF
db_description
KDICT
KELM
where:
style = the db_description has special rules. Only TABLE(OFP) and
TABLE(CASE) are allowed.
SAMEAS = the db_description on another DATABLK, sname statement.
db_description = one or more record descriptions providing a word-by-word
description of each record in which each word (or item) is
assigned a name and type.
(*) rec_description
RECORD , , EOR
= rec_name [ ( h1 [ ,h2 [ ,h3 ] ] ) ] SAMEAS, srec_name
where:
RECORD(*) = rec_description defines all records. It can only be specified once
following RECORD=HEADER.
RECORD = rec_name[(h1[,h2[,h3]]] assigns a name to the record and may
optionally indicate that the record begins with one to three integers
called header words. This format may be specified more than once.
Only a few data blocks have this type of record; such as IFP module
output data blocks.
Main Index
DATABLK 837
Describes data blocks used for NDDL access
rec_description contains one or more of the following record components that may be
repeated and in any order:
rep_count
item_name , item_type,
C
UNDEF, rep_count,
where:
rep_count = the number of times the item is repeated. The default is zero.
C = item_name is referenced by BACK in an either_component or COUNT
in an entry_component
• item_type is:
Main Index
838 DATABLK
Describes data blocks used for NDDL access
n
COUNT =
item_name
ENDENTRY,
EOR
WITH,
( end_value1,end_value2,… )
where:
rec_component = partial record description or item_component.
COUNT = the number of times the entry occurs in the record. item_name
specifies the name of an item in the record whose value will
specify the number of occurrences and n specifies a constant
integer value for the number of occurrences.
SAMEAS = an entry description specified on another ENTRY=sentry_name.
end_valuei = numeric value(s) that identifies the end of repeating ENTRY...
ENDENTRY grouping.
If EOR = specified then no more rec_components follow in the record and
RECORD or EOF must follow.
ENDENTRY = required and terminates the entry_components.
Main Index
DATABLK 839
Describes data blocks used for NDDL access
AHEAD
EITHER, ( item_name [ ,func_code ] ) = item_val1,
BACK
rec_component1,
[ OR , item_val2,
rec_component2,]
OR, item_valn,
[ rec_component]
[OR,
rec_component(n+1)]
ENDEITH,
where:
AHEAD or BACK = an item defined elsewhere in the record.
OR = the beginning of an optional description of the
item=item_valn.
The last OR component does not have to be followed by an
item_val.
ENDEITH = required and terminates the either_component.
Keywords:
Main Index
840 DATABLK
Describes data blocks used for NDDL access
Variables:
db_name Data block name; 1 through 8 characters in length. The first
character must be alphabetic. The following characters can be used
for datablock-names: A through Z and 0 through 9.
pathname Name of the path, which is also referenced on a PATH statement.
loc_param Variable character parameter name with a value that is the DBset
name. See the PARAM NDDL statement and the INlT FMS
statement.
rec_name Record name. Optional.
entry_name Entry name. Optional.
item_name Item name. Item_name may have an integer argument and would
then take the form: item_name(i) where i is an explicit integer
value.
item_vali Item value.
Remarks:
1. In general, the data block completely describes all possible records of a data block.
At any given instance, some or even all of the records that comprise the
description may not physically exist in any given data block.
Main Index
DATABLK 841
Describes data blocks used for NDDL access
2. For UNDEF items, DEPENdencies are not checked and for transfer of data
between machine types they are considered integer zero.
Examples:
1. The simplest DATABLK statement might be of the form:
DATABLK,INDATA,PATH=DMS,LOCATION=DBDN,EOF
A more complex specification of a DATABLK statement is of the form:
DATABLK,GEOM4S,TYPE=TABLE,PATH=PEIDI,LOCATION=IFPX,SAMEAS,
GEOM4,EOF
In the above statement, SAMEAS,GEOM4 specifies that GEOM4S has the same
data block description specified under the DATABLK,GEOM4 statement.
2. Consider the following:
DATABLK ,EQEXIN,TYPE=TABLE,PATH=PEIDI,LOCATION=IFPX,
RECORD=HEADER,NAME(2),CHAR4,EOR,
RECORD=EXT2INT,
GRIDID,I,INTERNAL,I,
EOR,
RECORD=EXT2SIL,
GRIDID,I,TENXSIL,I,EOR,EOF
The NAME(2) above represents a two word item with each word four characters
in length. The RECORD=EXT2INT gives this particular record the record-name
EXT2INT. In the record named EXT2INT there are two integer items called
GRIDID and INTERNAL. These two groups are repeated until the EOR is
encountered.
A simple ENTRY ... ENDENTRY grouping is:
RECORD=MAT9(2603,26,300),
MID,I,
ENTRY=GEES,
G(21),RS,
ENDENTRY,
RHO,RS,...,
EOR,
In the above example it was found convenient to group the Gs into an ENTRY-
ENDENTRY group called GEES. The group contains 21 entries. The group items
can be accessed as a whole group or as individual members. Also note the
(2603,26,300) entry. Internally, for many records, MD Nastran sees not the record
name e.g., MAT9, but rather the describer e.g.,(2603,26,300).
Another example of an ENTRY ... ENDENTRY group is as follows:
RECORD=CYJOIN(5210,52,257),
SIDE,I,C,I,
ENTRY,
G1,I,
Main Index
842 DATABLK
Describes data blocks used for NDDL access
ENDENTRY,WITH,-1,
EOR,
In this example the ENTRY ... ENDENTRY group in the CYJOIN record consists
of an indefinite number of G1 data-items. When the value -1 (which is physically
part of the record) is encountered, repetition of the ENTRY ... ENDENTRY group
will stop. Another similar example is of the form:
RECORD=MPC(4901,49,17),
SID,I,...,
ENTRY,
G1,I,C1,I,A1,RS,
ENDENTRY,WITH,(-1,-1,-1),EOR,
In the above MPC record, the group G1, C1, A1, repeats until -1 -1 -1 is
encountered in the record. A complex example of ENTRY ... ENDENTRY groups
is shown next.
RECORD=RBE3(7101,71,187),
EID,I,REFGRID,I,REFC,I,
ENTRY,
WT1,RS,C1,I,
ENTRY,
G1,I,
ENDENTRY,WITH,-1,
ENDENTRY,WITH,-2,
ENTRY,
GM1,I,CM1,I,
ENDENTRY,WITH,-3,
EOR,
In this example, an ENTRY ... ENDENTRY group is shown nested within another
ENTRY ... ENDENTRY group. If an ENTRY .. ENDENTRY group appears in
another ENTRY ... ENDENTRY group, it must be entirely contained in the
particular group. The outer ENTRY ... ENDENTRY group of this example uses
the ElTHER,OR clause to select the ENDENTRY statement. In this particular
example, the inner ENTRY ... ENDENTRY group is terminated by -1. The outer
ENTRY ... ENDENTRY group is terminated when a -2 is encountered. If a -2 is
encountered, another ENTRY ... ENDENTRY group terminating with -3 is
executed. If -3 is encountered the outer loop terminates. The record is
continuously repeated in this fashion until the EOR is encountered.
The next example uses EITHER,OR clauses to select one of several possible table
formats including an ENTRY ... ENDENTRY grouping.
RECORD=RELEASE(1310,13,247),
SEID,I,C,I,
EITHER,0,
ENTRY,
G1,I,
ENDENTRY,WITH,-1,
Main Index
DATABLK 843
Describes data blocks used for NDDL access
OR,1,
G1,I,G2,I,
OR,-1
ENDEITH,
EOR,
The RELEASE record represents three possible forms of the Bulk Data entry
RELEASE. The ENTRY ... ENDENTRY group represents an open-ended list of
grid point identifiers terminated by -1. The first OR represents a “THRU” option
while the second OR represents a “ALL” option.
Another use of the SAMEAS clause is as follows:
,...,
ENTRY=SOLDSP,SAMEAS,NONLIN,ENDENTRY,
This statement says that SOLDSP entry has an identical group structure to an
ENTRY=NONLIN grouping, which is in the same data block and comes
physically before the SOLDSP entry.
The COUNT = n is shown in the next example:
,...,
RECORD=PBEAM,(5402,54,262)
PID,I,MID,I,N,I,CCF,I,X,I,
ENTRY=SECTIONS,
S0,I,XXB,RS,A,RS,I1,RS,I2,RS,I12,RS,J,RS,NSM,RS,
C1 ,RS,C2,RS,D1,RS,D2,RS,E1,RS,E2,RS,F1,RS,F2,RS,
ENDENTRY,COUNT=11,
K1,RS, ... , N2B,RS,
EOR, ...
The STATIONS entry is to be repeated 10 times in addition to the entry explicitly
described. Thus there are 11 such entries.
The next example shows the use of COUNT = item-id and WITH,EOR
,...,
UNUSED(67),I,
LSEM(C),I,
ENTRY,
COEF,RS,
ENDENTRY,COUNT=LSEM,
ENTRY=SETS,
SETID,I,
LSET(C),I,
ENTRY,
SET,I,
ENDENTRY,COUNT=LSET,
ENDENTRY,WITH,EOR,EOF
The number of data items in COEFF is LSEM.
Main Index
844 DATABLK
Describes data blocks used for NDDL access
The entry SETS represents an ENTRY ... ENDENTRY group, which ends when an
EOR is reached. SET contains LSET data items for each repetition through the
ENTRY ... ENDENTRY group.
The next example shows a use of UNDEF, length.
RECORD=CCONE(2315,23,0),
EID,I,PID,I,
UNDEF,18,
EOR,
Here UNDEF,18 says that the next 18 items in the table are undefined. Neither,
the item-name or data-type are defined.
The next example shows the use of AHEAD(item-name).
RECORD=CBAR(2408,24,180),
EID,I,PID,I,GA,I,GB,I,
EITHER,AHEAD(F)=1,
X1 ,RS,X2,RS,X3,RS,F,I
OR,2,
GO,I,UNDEF,2,F,I,
ENDEITH, ...
In this example, AHEAD(F) says read F, which is required to be integer, to
determine the appropriate description.N
Main Index
DEPEN 845
Specifies the dependence of a data block or parameter
Format:
dep_db_name ( DB ) indep_db_namei ( DB )
DEPEN
dep_param_name ( P ) ⁄ indep_param_namei ( DB ) [ : desc_loc ] [ ,… ]
dep_virtual_name ( VP ) indep_virtual_namei ( VP )
Variables:
Remarks:
1. des_loc is specified in order to isolate the independent data. In other words, the
dependency is limited to a specific record, entry, and/or item. For example,
DEPEN A/B $ delete A if any item in B changes
DEPEN A/B:C $ delete A only if record C changes
DEPEN A/B:C:D $ delete A only if entry D of record C
changes
DEPEN A/B:C:D:E $ delete A only if item E in entry D
of record C changes
2. If record_name, entry_name or item_name is not defined in the DATABLK
description, then leave these fields blank but specify the colon.
Main Index
846 DEPEN
Specifies the dependence of a data block or parameter
Examples:
1. EPTS example:
DEPEN EPTS TYPE=TABLE PATH=PEIDI LOCATION=IFPX,
SAMEAS,EPT,EOF
DATABLK EPT TYPE=TABLE PATH=IFPI LOCATION=IFPX,
RECORD=PBAR(52,20,181)
PID,I,MID,I,A,RS,I1,RS,I2,RS,J,RS,NSM,RS,FE,RS,C1,RS,C2,RS,D1,RS,D2,RS
,E1,TS,E2,RS,F1,RS,F2,K1,RS,K2,RS,I12,RS,EOR,
RECORD=PBEAM(5402,54,262),
PID,I,MID,I,NI,CCF,I,X,RS,
ENTRY=SECTIONS,
SO,RS,XXB,RS,A,RS,I1,RS,I2,RS,I12,RS,
J,RS,NSM,RS,C1,RS,C2,RS,D1,RS,D2,RS,E1,RS,
E2,RS,F1,RS,R2,RS,ENDENTRY,COUNT=11,
K1,TS,K2,RS,S1,RS,S2,RS,NSIA,RS,NSIB,RS,CWA,RS,
CWB,RS,M1A,RS,M2A,RS,M1B,RS,M2B,RS,
N1A,RS,N1B,RS,N2A,RS,N2B,RS,EOR,
DEPEN EPTSK(VP)/EPTS:PBAR::PID,EPTS:PBAR::MID,
EPTS:PBAR::A,
.
.
.
EPTS:PBEAM:SECTIONS:A,EPTS:PBEAM:SECTIONS:I1,EPTS:PBEAM:SECTIONS:I2,
2. GEOM1S example:
DATABLK GEOM1S TYPE=TABLE PATH=PEID LOCATION=IFPX,
SAMEAS,GEOM1,EOF
DATABLK GEOM1 TYPE=TABLE PATH=IFP LOCATION=IFPX,
RECORD=HEADER,NAME(2),CHAR4,EOR,
.
.
RECORD=GRID(4501,45,1),
ID,I,CP,I,X1,RS,X2,RS,X3,RS,CD,I,PS,I,SEID,I,EOR,
.
.
RECORD=SEQGP(5301,53,4),
ID,I,SEQID,I,EOR,
.
.
EOF
DEPEN NODES(VP)/GEOM1S:GRID::ID,GEOM1S:GRID::CP,
GEOM1S:GRID:::X1,GEOM1S:GRID::X2,GEOM1S:GRID::X3,
GEOM1S:GRID::CD $
DEPEN GPLS / NODES(VP,SNODES(VP) $
DEPEN LUSETS(P) /GPLS,GEOM1S:SEQGP $
PARA
Main Index
PARAM 847
Defines parameters requiring a path and/or dbset location
Format:
Variables:
Description data-type
Integer I
Real single precision RS
Real double precision RD
Complex single precision CS
Complex double CD
precision
Character CHARi, where i = 1
through 80
Logical LOGICAL
path-name The logical name of the hierarchical structure. Refer to the PATH
statement.
dbset-name The variable character parameter name with a value that
corresponds to a DBset name. Its default value must be defined on
another PARAM NDDL statement and cannot be blank.
Main Index
848 PARAM
Defines parameters requiring a path and/or dbset location
Remarks:
1. The TYPE DMAP statement may not override the default set with this statement.
Any default value set with the TYPE DMAP statement is ignored.
2. DBset-name parameters in LOCATION must be assigned to MASTER.
3. Character values must be enclosed in single quotation marks.
Examples:
PARAM,POST=0,TYPE=I,PATH=DMS,LOCATION=DBDN
PARAM,WTMASS=1.0,TYPE=RS,PATH=DMS,LOCATION=DBUP
PARAM,CM1=(1.0,0.0),TYPE=CS,LOCATION=DBDN
PARAM,MESH=’NO’,TYPE=CHAR8,PATH=DMS,LOCATION=DBUP
PARAM,DBUP=’DBALL’,TYPE=CHAR8,PATH=DMS,
LOCATION=MASTER
PARAM,DBDN=’DBALL’,TYPE=CHAR8,PATH=DMS,
LOCATION=MASTER
Main Index
PATH 849
Defines a list of qualifiers for reference on DATABLK/PARAM NDDL statements
Defines a list of qualifiers for reference on the DATABLK and PARAM NDDL
statements.
Format:
Variables:
path-name Name of the path; 1 through 8 characters in length. The first character
must be alphabetic. The following characters can be used for
path-names: A through Z and 0 through 9. The path-name may be
referenced on one or more DATABLK and/or PARAM statements
with PATH=path-name.
qual-namei A list of qualifiers that are defined on QUAL NDDL statements.
Example:
The path DMSL specifies qualifiers MODEL, SEID, and LID.
PATH DMSL MODEL,SEID,LID $
Main Index
850 QUAL
Defines qualifiers referenced on PATH NDDL statement
Format:
QUAL(qtype) qual-name1=default-value1
qual-name2=default-value2,...
Variables:
Description qtype
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
Remarks:
1. qual-namei may be referenced on one or more PATH NDDL statements.
2. The TYPE,PARM,NDDL DMAP statement must be used to declare the qualifier
in the subDMAP.
3. Qualifiers may be modified in the subDMAP in the same manner as variable
parameters.
Example:
The following statement defines integer qualifiers MODEL, SEID, SOLID, and BASE
and their defaults.
QUAL(I) MODEL=0,SEID=0,SOLID=0,BASE=1
Main Index
MD Nastran 2006 DMAP Programmer’s Guide+
CHAPTER
DMAP Modules and Statements
4
■ DMAP Module and Statement List
■ DMAP Module and Statement Description Summary
■ Detailed Descriptions of DMAP Modules and Statements
Main Index
852
Matrix Modules
ADD MERGE SOLVE
ADD5 MPYAD SOLVIT
CEAD NORM TRNSP
DCMP PARTN UMERGE
DECOMP READ UMERGE1
DIAGONAL RESMOD UPARTN
FBS SMPYAD
Utility Modules
APPEND LAMX PARAML
COPY MATGEN PRTPARM
DBC MATGPR PVT
DBDICT MATMOD RESTART
DMIIN MATOFP RMDUPBLK
DRMS1 MATPCH SCALAR
DTIIN MATPRN SEQP
ELTPRT MATPRT TABEDIT
IFP MODTRL TABPRT
IFP1, . . . IFP10 MTRXIN TABPT
IFPBSH2 OFP VEC
INPUTT2 OUTPUT2 VECPLOT
INPUTT4 OUTPUT4 XSORT
Main Index
853
Main Index
854
Main Index
855
Matrix Modules
Module Basic Operation
ADD [X ] = α[A ] ⊕ β[B]
CEAD 2
Solves for p and { φ } in ( [ M ]p + [ B ] p + [ K ] ) { φ } = { 0 }
DECOMP,DCMP [A ] → [ L] [U]
DIAGONAL
[ A ] → a P or [ A ] → a P
ii ij
FBS –1
[ X ] = ±( [ L ][ U ] ) [ B ]
MERGE
[ A ] → A11 A12
A21 A22
MPYAD T
[ X ] = ± [ A ] [ B ] ± [ C ] or [ X ] = ± [ A ] [ B ] ± [ C ]
PARTN
[ A ] ← A11 A12
A21 A22
SOLVE, SOLVIT –1
[ X ] = ± [ A ] [ B ] or ± [ A ]
–1
UMERGE PHIA
{ PHIF } ← ---------------
PHIO
Main Index
856
UPARTN
K jj K jl Pj
[ K ii ] ← or { P i } → -----
K lj K ll Pl
Utility Modules
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 Converts the output from the XSORT module into several tables.
through IFP9
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).
Main Index
857
Main Index
858
DMAP Module or
Alternate Method or Modules
Statement
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
Main Index
859
DMAP Module or
Alternate Method or Modules
Statement
TASN TASNP2
Main Index
860
Main Index
ACMG 861
Computes fluid/structure coupling matrix
Computes the coupling matrix for fluid/structure interface at all points or only points
on a given structural panel.
ACMG PANSLT,BGPDT,CSTM,SIL,ECT,EQACST,NORTAB,EQEXIN,EDT/
AGG
/
APART
LUSET/MPNFLG/NUMPAN/S,N,PANAME/IPANEL/MATCH/
PNLPTV $
Main Index
862 ACMG
Computes fluid/structure coupling matrix
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:
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
ACMG 863
Computes fluid/structure coupling matrix
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
864 ADAMSMNF
Generate files for MSC.Adams
Format:
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.
Main Index
ADAMSMNF 865
Generate files for MSC.Adams
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.
BAAEA Modal damping matrix.
OGS1P Table of grid point stresses due to preload.
OGSTR1P Table of grid point strains due to preload.
Parameters:
Main Index
866 ADAMSMNF
Generate files for MSC.Adams
Remarks:
1. The invariants can be output to the MNF file only if MINVAR<>'NONE'.
Main Index
ADAMSRBM 867
Calculates rigid body motion based on MSC.ADAMS results
Format:
ADAMSRBM RBH,UGX,CSTM,BGPDT/URGB/APP $
Parameters:
Main Index
868 ADAPT
Performs and prints error estimate for current p-values
Performs and prints error estimate for current p-values and generates a new set of
p-values for next adaptivity loop.
Format:
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 $
Main Index
ADAPT 869
Performs and prints error estimate for current p-values
OINT p-element output control table. Contains OUTPUT Bulk Data entries.
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.
Parameters:
Main Index
870 ADAPT
Performs and prints error estimate for current p-values
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.
Example:
Set up ADAPT module for superelement analysis.
Main Index
ADD 871
Matrix add
Format:
ADD A,B/X/ALPHA/BETA/IOPT $
X Matrix
Parameters:
IOPT Operation
0 + , add
1 * , multiply
A ij or B ij = 0, then X ij =
2 ÷ , divide
= αA ij if B ij = 0
3 x ij
= βB ij if B ij ≠ 0
Remarks:
1. [ A ] and/or [ B ] 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.
Main Index
872 ADD
Matrix add
1 2 5 + = 8 10 5
7 8
3 4 6 3 4 6
or
1 2 5
7 8 + = 8 10
3 4 6
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 [ A ] with terms of:
ADD A,B/X///3 $
Main Index
ADD5 873
Matrix add
Format:
ADD5 A,B,C,D,E/
X/
ALPHA/BETA/GAMMA/DELTA/EPSLN/
ALPHAD/BETAD/GAMMAD/DELTAD/EPSLND $
X Matrix
Parameters:
Main Index
874 ADD5
Matrix add
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 [ X ] 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 [ X ] 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 $
Main Index
ADD5 875
Matrix add
Main Index
876 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:
ADG AECTRL,CSTMA,AERO,AECOMP,W2GJ,ACPT/
UXVBRL,WJVBRL,ADBINDX/
NJ/NK/SYMXZ $
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).
Parameters:
Main Index
ADG 877
Calculates the downwash matrix
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
878 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:
ADJMOD DRDUTB,DRDUG,ADRDUTB/
DRDUTBM,DRDUGM/
S,N,AADJCOL/COLADJ/TCOLADJ/APP $
Parameters:
Main Index
ADR 879
Builds a matrix of aerodynamic forces
Builds a matrix of aerodynamic forces per frequency for each aerodynamic point
based on the AEROF Case Control command.
Format:
ADR UH,CASECC,QKHL,OL,AEBGPDT,AEUSET/
PKF/
BOV/MACH/APP/AECONFIG/SYMXY/SYMXZ $
Parameters:
Main Index
880 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:
Main Index
AELOOP 881
Aerodynamic loop driver
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:
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 $
Parameters:
Main Index
882 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.
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 883
Aerodynamic loop driver
Main Index
884 AEMODEL
Aerodynamic model loop driver
Format:
AEMODEL CASECC,EDT,CCPOS/
CCPOS1
S,N,NSKIP/S,N,LPFLG/S,N,AECONFIG/S,N,SYMXY/
S,N,SYMXZ/CRTPOS $
Parameters:
Main Index
AFPMP 885
Field point mesh data recovery
Format:
Main Index
886 AFPMP
Field point mesh data recovery
Parameters:
Main Index
AIEMGA 887
Acoustic infinite element matrix generation and assembly
Format:
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.
Main Index
888 AIEMGA
Acoustic infinite element matrix generation and assembly
Parameters:
Main Index
AMG 889
Builds aerodynamic influence matrix
Format:
AMG MKLIST,ACPT/
AJJT,SKJ,D1JK,D2JK/
NK/NJ/SYMXZ/SYMXY/REFC/S,N,MACH0/MACHNO/
KBAR/APP/SUPAERO $
Parameters:
Main Index
890 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:
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 891
Generates modal aerodynamic matrices
Format:
AMP AJJT,WSKJF,D1JK,D2JK,GDKI,GPIK,GPKH,D1JE,D2JE,
MKLIST,LAJJT,UAJJT/
QHH,QKH,QHJ/
NUMHDOF/NOUE/GUSTAERO/MACH/KBAR $
Parameters:
Main Index
892 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.
Main Index
APD 893
Generates aerodynamic geometry tables
Format:
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 $
Main Index
894 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.
Main Index
APPEND 895
Concatenate two data blocks
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:
Format:
APPEND IN1,IN2/OUT/IOPT/NULL1/NULL2/
REAL/REALD/CMPX/CMPXD/CHAR1/CHAR2 $
OUT Output data block corresponding to first pair of input data blocks.
Parameters:
Main Index
896 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. Both inputs must be of the same type matrix.
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 of the parameters written is reversed. For example, IOPT=-20
causes CHAR to be written first, then NULL2.
Main Index
APPEND 897
Concatenate two data blocks
Examples:
1. Generate a matrix [ U ] whose five columns are a vector { U s } 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 $
Main Index
898 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:
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 $
Main Index
ASDR 899
Prints the extra point aerodynamic displacements
Parameters:
Main Index
900 ASG
Computes the aerodynamic extra point displacements
Format:
ASG CASEA,AEMONPT,MONITOR,MPAERV,MPSERV,MPSIR,AEDBUXV,
MPSERP,MPAERP,AECTRL,EDT,PRBDOFS,DIT,AEDBINDX/
UX,UXDAT,UXDIFV/SYMXZ/ISENS $
Main Index
ASG 901
Computes the aerodynamic extra point displacements
Parameter:
Remarks:
1. TR, KRZX, DIT, ERHM, and UXDAT may be purged if ISENS=1.
2. ASG solves the following equation for UX:
ZZX PZ
IP UX = Y
AEL O
Main Index
902 AXMDRV
Loop driver for auxiliary model processing
Format:
AXMDRV AMLIST//S,N,AUXMID/S,N,AUXMFL $
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 $
Main Index
AXMPR1 903
Builds a list of auxiliary model Bulk Data Sections
Format:
AXMPR1 CASECC*,BULK*/
AMLIST/
S,N,AMLFLG $
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 $
Main Index
904 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:
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.
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.
Main Index
BCDR 905
Drives a boundary condition loop
Drives a DMAP loop based on the boundary condition Case Control commands SPC
and MPC.
Format:
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 $
Parameters:
Main Index
906 BCDR
Drives a boundary condition loop
Main Index
BDRYINFO 907
Generates geometry and connectivity information
Format:
BDRYINFO CASECC,GEOM1,GEOM2,BGPDT,USET,BULK,BULKINDX/
GEOM1EX,GEOM2EX,GEOM4EX,CASEEX/
MTRXFLAG/DMIGSFIX $
Main Index
908 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 909
Updates Case Control table for contact
Updates Case Control table for contact region data recovery operations.
Format:
BGCASO CONTACT,BTOPO,CASECC,XYCDB/
CASECCBO/
S,N,NEWCASE/S,N,NBSORT2 $
Parameters:
Main Index
910 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:
BGP CSTM,SIL,KGGT/
BTOPO,BGPECT/
ADPCON/ISKIP $
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 $
COPY BTOPSTF/BTOPCNV/-1/1 $
Main Index
BMG 911
Generates hydroelastic boundary matrices
Format:
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.
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,/
LUSETD/NOABFL/NOKBFL/0 $
Main Index
912 BNDSPC
Processes constraints on superelement boundaries
Format:
BNDSPC SEMAP,USET,BGPDT,YS,YSD/
USET1,YS1/
SEID/NLOADS $
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.
Main Index
BNDSPC 913
Processes constraints on superelement boundaries
2. YS cannot be purged.
Example:
Excerpt from subDMAP PHASE0 with BNDSPC in a superelement and boundary
condition loop.
Main Index
914 CAMPREP
Creates list of DDVAL entry values for Campbell looping
Format:
CAMPREP CASECC,DYNAMIC,EDOM/
CAMPDD/
S,N,CAMPPARM/S,N,CAMPTYPE/S,N,CAMPID/
S,N,CAMPFID/S,N,CAMPNAME/S,N,NCAMPVAL $
Parameters:
Main Index
CAMPREP 915
Creates list of DDVAL entry values for Campbell looping
Main Index
916 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:
PSDL
CASE CASECC, /
MPT
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 $
Parameters:
Main Index
CASE 917
Dynamic analysis case control loop driver
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.
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.
Main Index
918 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.
Main Index
CASE 919
Dynamic analysis case control loop driver
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.
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
920 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
CASE CASECC,/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.
CASE CASECC,/CASEBC/'COMM'/S,N,NSKIP/
//////'MPC'/'SPC'/'SUPO' $
Main Index
CEAD 921
Complex, unsymmetric eigenvalue analysis or singular value decomposition
Given that [ M ] , [ B ] and [ K ] are mass, damping, and stiffness, solve the equation:
2
( [ M ]p + [ B ]p + [ K ] ) { φ } = 0 Eq. 4-3
or
T 2
{ φ L } ( [ M ]p + [ B ]p + [ K ] ) = { 0 } (Lanczos only) Eq. 4-4
for the eigenvalues p and the associated right eigenvectors { φ } or left eigenvectors
{ φL } .
T
[U][S][V ] = K
where U and V are square matrices of orthogonal functions, and S has non-zero terms
along the diagonal of its left-most partition.
Format:
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.
Main Index
922 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
Parameters:
Main Index
CEAD 923
Complex, unsymmetric eigenvalue analysis or singular value decomposition
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 [ K dd ] ,
[ M dd ] , and [ B dd ] to form [ K xx
d ] , [ M d ] , and [ B d ] .
xx xx
In the case of a direct formulation CEAD extracts the eigenvalues from the following
equation.
[ M xx
d p2 + B d p + K d ]{ u d } = 0
xx xx x Eq. 4-5
[ M hh p 2 + B hh p + K hh ] { u h } = 0 Eq. 4-6
CEAD also normalizes the eigenvectors according to one of the following user
requests:
Main Index
924 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
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.
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
2
[ KDD ] [ CPHX ] + [ BDD ] [ CPHX ] [ CLAMMAT ] + [ MDD ] [ CPHX ] [ CLAMMAT ] = 0
and
T T 2 T
[ LCPHX ] [ KDD ] + [ CLAMMAT ] [ LCPHX ] [ BDD ] + [ CLAMMAT ] [ LCPHX ] [ KDD ] = 0
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
T
[Y] [X]
T
V is the transpose of the complex conjugate of V . The terms of S are always
positive or zero (non-negative), and real. The terms of S 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 K real,
symmetric, and positive semi-definite U = V , and S is the matrix of roots of
[ K – λ*I ]*φ = 0
Main Index
CEAD 925
Complex, unsymmetric eigenvalue analysis or singular value decomposition
The roots and vectors are sequenced inversely from the MD Nastran
convention. Singular Value Decomposition is a standard mathematical
technique with well-defined properties. Both U and V may be purged and
CEAD will execute faster if they are are purged. The input matrix K must fit
into memory because there is no spill capability. The singular value
decomposition uses the format shown in the Example 2. Although S 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
A – U*S*V' = 0
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
926 CMPZPR
Generates Bulk Data entry images based on PCOMP and MAT8
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:
CMPZPR EPT,MPT,DIT,PCOMPT/
EPTC,MPTC/
S,N,NOCOMP $
Parameter:
Remarks:
1. CMPZPR is functionally equivalent to module IFP6.
Main Index
CMPZPR 927
Generates Bulk Data entry images based on PCOMP and MAT8
Main Index
928 CMSENGY
Compute component modal energies
Compute component modal strain and kinetic energies with respect to normal modes
and forced response analysis.
Format:
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 $
Main Index
CMSENGY 929
Compute component modal energies
Parameters:
Main Index
930 CMSENGY
Compute component modal energies
Main Index
COPY 931
Explicit data block copy
Format:
COPY DBI/DBO/PARM/BLOCK $
Parameters:
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.
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 $
Main Index
932 CURV
Transforms elemental centroid stresses (or strains)
Format:
CURV OES1,MPT,CSTM,EST,BGPDT/
OES1M,OES1G/
OUTOPT/OG/NINTPTS $
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.
Parameters:
Main Index
CURV 933
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” on page 670 of the MD Nastran Quick
Reference Guide.
Main Index
934 CURVPLOT
Converts grid point output tables
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:
CURVPLOT EQEXIN,BGPDT,EDT,XYCDB,OPG1,OQG1,OUG1,OES1G,OSTR1G/
OPG2X,OQG2X,OUG2X,OES2GX,OSTR2GX/
DOPT $
Main Index
CURVPLOT 935
Converts grid point output tables
Parameter:
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/ $
Main Index
936 CYCLIC1
Generates cyclic symmetry tables and transformation matrices
Generates transformation matrices and modifies Case Control and static loads for
cyclic symmetry analysis.
Format:
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 $
Main Index
CYCLIC1 937
Generates cyclic symmetry tables and transformation matrices
Parameters:
Remark:
CYCLIC1 generates equivalent GRAV and RFORCE Bulk Data entry images in
harmonic components.
Main Index
938 CYCLIC2
Processes degrees-of-freedom
Format:
CYCLIC2 GEOM4,EQEXIN,USET/
CYCD/
NSEG/CTYPE $
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.
Main Index
CYCLIC2 939
Processes degrees-of-freedom
Main Index
940 CYCLIC3
Forms cyclic matrices
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:
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 $
Parameters:
Main Index
CYCLIC3 941
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.
Main Index
942 CYCLIC4
Transforms cyclic components of load vectors or displacements
Format:
PAC
CYCLIC4 HARM,GC,GS, PHK ,LAMA,CASEBK,BACK/
UK
PK
PHX ,LAMA1,CASEBK1,BACK1/
UX
PATH/HINDEX/APP/S,N,NFREQ/TOTALK $
Main Index
CYCLIC4 943
Transforms cyclic components of load vectors or displacements
Parameters:
Examples:
1. Static analysis:
FILE UX=APPEND $
PARAML KVAL//'TRAILER'/1/S,N,NKVAL $ NUMBER OF ANALYSIS HARMONICS
Main Index
944 CYCLIC4
Transforms cyclic components of load vectors or displacements
CYCLIC4 HARM,GC,GS,CYPHA,CYLAMA,CASEBK,BACK/
Main Index
CYCLIC4 945
Transforms cyclic components of load vectors or displacements
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 $
ENDDO $ HINDEX<=KMAX
MPYAD CYPHX,BACK1,/CYPHA1 $
Main Index
946 DBC
Database converter for model generation and results processing
Format:
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 $
Parameters:
Main Index
DBC 947
Database converter for model generation and results processing
Main Index
948 DBC
Database converter for model generation and results processing
Remarks:
1. Data block name table:
Generic
Chapter 2 Stored on
Name Description
Names Unit
(P1-P20)
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
Main Index
DBC 949
Database converter for model generation and results processing
Generic
Chapter 2 Stored on
Name Description
Names Unit
(P1-P20)
DBCOPT DBCOPT POSTU Design optimization history table
for
DESTAB DESTAB POSTU Table of design variable attributes
DIT DIT GEOMU/ Table of TABLEij Bulk Data entry
POSTU 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
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/ Table of Bulk Data entry images
LOADU related to constraints, degree-of-
freedom membership and rigid
element connectivity
Main Index
950 DBC
Database converter for model generation and results processing
Generic
Chapter 2 Stored on
Name Description
Names Unit
(P1-P20)
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/ External grid/scalar point
POSTU 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/ POSTU Real or complex eigenvalue
CLAMA 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
OEKE ONRGY1 POSTU Table of element kinetic energies
OES OES POSTU Table of element stresses or strains
in SORT1 or SORT2 format
Main Index
DBC 951
Database converter for model generation and results processing
Generic
Chapter 2 Stored on
Name Description
Names Unit
(P1-P20)
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
Main Index
952 DBC
Database converter for model generation and results processing
Generic
Chapter 2 Stored on
Name Description
Names Unit
(P1-P20)
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
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/ View information table, contains
POSTU the relationship between each p-
element and its view-elements
and view-grids
Main Index
DBC 953
Database converter for model generation and results processing
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
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.
Main Index
954 DBC
Database converter for model generation and results processing
TYPE PARM,,I,Y,DBCDIAG=0,GEOMUNIT,LOADUNIT,POSTUNIT $
TYPE PARM,,CHAR8,Y,PROGRAM=’XL’ $
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. Note: ECTS, GEOM1S, and EQEXINS are
repeated here in case the above call was not executed, as in a data recovery
restart.
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/
APP//GEOMU/LOADU/POSTU/DBCDIAG/
PROGRAM/ $
Main Index
DBDELETE 955
Deletes NDDL data blocks and parameters
Deletes NDDL data blocks and parameters. An optional WHERE clause may be
specified for a more selective deletion.
Format:
*
DATABLK =
( datablk – list )
DBDELETE [ WHERE ( where – expr ) ] $
*
PARAM =
( param – list )
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 $
Main Index
956 DBDELETE
Deletes NDDL data blocks and parameters
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 DATABLK=KAA WHERE(SPC=10 AND WILDCARD) $
Note: WILDCARD applies only to qualifiers and not colnames like
PROJECT, PROJECT, VERSION, CDATE, etc.
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
DBDICT 957
Prints database directory tables
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 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.
Main Index
958 DBDICT
Prints database directory tables
DATABLK *
=
DATABLK ( LOCAL ) ( datablk-list )
PARAM *
DBDICT = WHERE(where-expr),
PARAM ( LOCAL ) ( param-list )
PROJVERS
QUALCURR
QUALIFIERS
SELECT(colname[- ‘ col-label’]. . . ),
FORMAT (FWIDTH = w [.d] DWIDTH = w [.d] AWIDTH = a IWIDTH = i,
LWIDTH = k COLSPACE = c VALUE = w,
colname = col-width, . . .),
A , … ,
SORT colname =
D
RIGHT
LABEL page - title‘ CENTER
LEFT
Describers:
Main Index
DBDICT 959
Prints database directory tables
Main Index
960 DBDICT
Prints database directory tables
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.
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, Print justification of the page title.
CENTER, LEFT
Remarks:
1. DBDICT prints seven different tables according to a default or user-defined
format. The tables are:
See
Describer Description Default Page-Title
Remark
DATABLK Data blocks described NDDL DATABLOCKS 2
by a NDDL DATABLK
statement.
PARAM Parameters described NDDL PARAMETERS 3
by a NDDL PARAM
statement.
QUALCURR Current Qualifiers and CURRENT 4
their values. QUALIFIERS
QUALIFIERS Qualifiers and their QUALIFIERS 5
values for each key
number.
DATABLK Data blocks not LOCAL 6
(LOCAL) described by a NDDL DATABLOCKS
DATABLK statement.
Main Index
DBDICT 961
Prints database directory tables
See
Describer Description Default Page-Title
Remark
PARAM(LOCAL) Parameters not LOCAL PARAMETERS 7
described by a NDDL
PARAM statement.
PROJVERS Project-Version. PROJECT-VERSION 8
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
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:
Main Index
962 DBDICT
Prints database directory tables
* * * * D I C T I O N A R Y P R I N T * * * *
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
The table below gives the allowable colnames along with a description that may be
specified in the FORMAT, SELECT, and SORT describers.
Default
Column Default
column Description
name column label
width
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
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
Main Index
DBDICT 963
Prints database directory tables
Default
Column Default
column Description
name column label
width
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
Main Index
964 DBDICT
Prints database directory tables
SELECT(NAME,DATABASE,DBSET,PROJNO=’PROJ’,VERSION=’VERS’,CDATE,CTIME,
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:
* * * * D I C T I O N A R Y P R I N T * * * *
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
The table below gives the allowable colnames along with a description that
may be specified in the FORMAT, SELECT, and SORT describers.
Table 4-2 DBDICT PARAM Colnames
Default Default
Column
column column Description
name
width label
PROJECT 40 PROJECT NAME Project name defined by
PROJECT statement
PROJNO 5 PROJ Project number associated
with PROJECT
VERSION 4 VERS Version number
Main Index
DBDICT 965
Prints database directory tables
Default Default
Column
column column Description
name
width label
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
Main Index
966 DBDICT
Prints database directory tables
-----------------------------------------------------------------------------------------------------------
336 ’ ’ 0
0 ’ ’
0 0 -1
0 0 0
Column Default
Default column label Description
name column width
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
Main Index
DBDICT 967
Prints database directory tables
5. The default print of the current qualifier values table is obtained by:
DBDICT QUALCURR
and is equivalent to:
DBDICT QUALCURR SELECT(QUALALL),
FORMAT(AWIDTH=8,IWIDTH=5,LWIDTH=1,COLSPACE=2),
LABEL=(’CURRENT QUALIFIERS’ CENTER)
and looks like:
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 24
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.
Default Default
Column
column column Description
name
width label
qual-name See Note qualifier name Qualifier name
QUALAL See Note qualifier name All qualifiers
L
QUALSET See Note qualifier name Pre-defined subset of all
qualifiers
Main Index
968 DBDICT
Prints database directory tables
* * * * D I C T I O N A R Y P R I N T * * * *
EXECUTION OF DMAP STATEMENT NUMBER 23
Default Default
Column
column column Description
name
width label
NAME 8 NAME Parameter name
SUBDMAP 8 SUBDMA SubDMAP name
P
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
Main Index
DBDICT 969
Prints database directory tables
Default Default
Column
column column Description
name
width label
TRAILER 8 TRLi All 10 trailer words
EXTNAME 8 EXTNAM Extended name
E
* * * * D I C T I O N A R Y P R I N T * * * *
The table below gives the allowable colnames along with a description that
may be specified in the FORMAT, SELECT, and SORT describers.
Main Index
970 DBDICT
Prints database directory tables
Default Default
Column
column column Description
name
width label
NAME 8 NAME Parameter name
SUBDMAP 8 SUBDMAP SubDMAP name
VALUE 40 VALUE Parameter name
* * * * 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
The table below gives the allowable colnames along with a description that
may be specified in the FORMAT, SELECT, and SORT describers.
Main Index
DBDICT 971
Prints database directory tables
Default Default
Column
column column Description
name
width label
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 Creation Date
DATE
CTIME 13 CREATION Creation Time
TIME
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:
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) $
Main Index
972 DBDICT
Prints database directory tables
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 973
Equivalences (or copies) NDDL data blocks and parameters
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:
*
DATABLK =
(datablk-list)
DBEQUIV [ WHERE (where-expr) ] ,
*
PARAM =
(param-list)
CONVERT (convert-expr) [ OVRWRT RESTART ] $
Describers:
Main Index
974 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) $
Main Index
DBEQUIV 975
Equivalences (or copies) NDDL data blocks and parameters
Note: WILDCARD applies only to qualifiers and not colnames like PROJECT,
PROJNO, VERSION, CDATE, etc.
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
976 SubDMAP DBFETCH
Fetch data blocks stored by DBSTORE
Format:
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.
Main Index
SubDMAP DBFETCH 977
Fetch data blocks stored by DBSTORE
Example:
Fetch data block named A (name flag = 1 drops the character E) and assign local name
as EA.
CALL DBFETCH /EA,,,,/1/1/1/0/S,EXIST $
Main Index
978 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
Performs functions on items stored on the database with this subDMAP and CALL
DBSTORE.
Format:
CALL DBMGR //OPT/P2/P3/P4/P5/P6/DB1/DB2/DB3/DB4/DB5 $
Format:
CALL DBMGR //2/0/0/0/0/0/
’ ’/’ ’/’ ’/’ ’/’ ’ $
Parameters:
None.
2. Data block deletion. Deletes up to five data block(s) previously stored with
CALL DBSTORE.
Format:
Parameters:
3. Data block equivalence. Assign up to four alias names to one to four data blocks.
Main Index
SubDMAP DBMGR 979
Functions on data blocks stored by DBSTORE
Format:
Parameters:
4. Data block rename. Rename and/or modify the qualifier values of a data block
previously stored with CALL DBSTORE.
Format:
Parameters:
Main Index
980 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
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:
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.
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.
Main Index
SubDMAP DBMGR 981
Functions on data blocks stored by DBSTORE
Main Index
982 DBSTATUS
Checks status of up to ten data blocks
Format:
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 $
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.
Main Index
SubDMAP DBSTORE 983
Stores data blocks on the database
Stores user-specified data blocks on the database. Data blocks can only be retrieved by
CALL DBFETCH.
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. 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.
Main Index
984 SubDMAP DBSTORE
Stores data blocks on the database
Examples:
1. Store data block B on dbset DB100:
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 ( K +
λ i M ] [ X ] = [ B ] , where K, B, and M are input via DMI Bulk Data entries and
( λ i , 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
Main Index
DBVIEW 985
Creates virtual datalock
Creates virtual data block (or view) from one or more data blocks.
Format:
DBVIEW view-name = data-block WHERE (where-expr) $
(WHERE where-expr)
Describers:
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” on page 44 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).
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.
Main Index
986 DBVIEW
Creates virtual datalock
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.
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).
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).
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) $
Main Index
DBVIEW 987
Creates virtual datalock
Main Index
988 DCMP
Matrix decomposition with extended diagnostics
Decompose a square matrix [ A ] into upper and lower triangular factors [ U ] and [ L ]
and diagonal matrix [ D ] . DCMP is identical to DECOMP, but also provides extended
diagnostics.
[ A ] = [ L ] [ U ] for unsymmetric [ A ]
T
[A ] = [L ][D ][L ] for symmetric [ A ]
Format:
DCMP DUSET,SIL,EQEXIN,A,PARTVEC,EQMAP/
LD U LSEQ
, , /
LAO AAP LSCM
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 $
Main Index
DCMP 989
Matrix decomposition with extended diagnostics
Parameters:
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).
Main Index
990 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.
Main Index
DCMP 991
Matrix decomposition with extended diagnostics
A oo A oa L oo D oo T LT
L oo
A = = ao
A ao A aa L ao I A aa I
where
T
A aa = A aa – L ao D oo L ao
Example:
Inspect the numerical conditioning of the
m
M aa
Main Index
992 DCMP
Matrix decomposition with extended diagnostics
Main Index
DDR2 993
Computes displacements due to mode acceleration
Format:
DDR2 USETD,UD,PD,KDD,BDD,MDD,OL,UNUSED,LLL,DM/
UD1,UE,PD1/
APP/NOUE/UNUSED1/UNUSED2 $
Parameters:
Main Index
994 DDR2
Computes displacements due to mode acceleration
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:
a 2 2
{ P d } = { P d } – { K dd } { u d } – [ B dd ] { u· d } – [ M dd ] { u·· d } Eq. 4-7
For a transient analysis problem { u d } , { u· d } , and { u·· d } are given explicitly. For
frequency response analysis,
{ u· d } = iω { u d } Eq. 4-8
2
{ u·· d } = – ω { u d } Eq. 4-9
where ω is the forcing frequency and { u d } is the complex response vector. ω comes
from PPF. The vector { P ad } 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:
a
a Pa
{ Pd } → ------ Eq. 4-10
Pe
Main Index
DDR2 995
Computes displacements due to mode acceleration
a
ua
{ u d } → ----- Eq. 4-11
ue
{ ue }
is placed in data block UEVF. Subroutines CALCV and SSG2A perform this
calculation. If supports are present, then:
a Pl
{ P l } → ----- Eq. 4-12
Pr
ul
{ u a } → ----- Eq. 4-13
Pr
Solve for { u aa } :
T a a
[ L ll ] [ L ll ] { u l } = { P l } Eq. 4-14
a
a { ul } + [ D ] { ur }
{ ua } = ------------------------------------------- Eq. 4-15
ur
otherwise,
a
{ ua } = { u al }
Subroutine SDR1B performs this calculation. If extra points are present, then:
a
a ua
{ ud } ← ----- Eq. 4-16
ue
Note:
If the problem type is transient, { u ad } must be merged with { u· d } and { u·· d } .
Main Index
996 DDRMM
Performs matrix method data recovery
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:
DDRMM CASECC,UH,OL,IUG,IQG,IES,IEF,XYCDB/
OUG,OQG,OES,OEF,UNUSED5,OVG,OAG/
OPTION/NOCOMP/PEXIST/ACOUSTIC/ACOUT/PREFDB/SEID/
DVAFLAG $
Main Index
DDRMM 997
Performs matrix method data recovery
Parameters:
Main Index
998 DDRMM
Performs matrix method data recovery
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
1 1
[ Output Matrix ] = [ Data Matrix ] ⋅ [ Solution Matrix ] Eq. 4-17
If the modal solutions input to the module are SORT2, the equation is
2 T 2
[ Output Matrix ] = [ Solution Matrix ] ⋅ [ Data Matrix ] Eq. 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 Eq. 4-17 and Eq. 4-18, the solution matrix contains one solution vector (column) of
size h (= number of eigenvalues used) for each time or frequency step. Thus,
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,
1
[ Data Matrix ] is of size Rows ⋅ Columns
where:
Rows = Σ components of all points or elements requested.
Columns = number of time or frequency steps being output.
2 1 T 2 1 T
[ Output Matrix ] = [ Output Matrix ] [ Output Matrix ] = [ Output Matrix ]
Main Index
DDRMM 999
Performs matrix method data recovery
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).
Main Index
1000 DECOMP
Matrix decomposition
To decompose a square matrix [A] into upper and lower triangular factors [U] and [L]
and diagonal matrix [D].
[ A ] = [ L ] [ U ] for unsymmetric [ A ]
T
[A] = [L ][ D ][L ] for symmetric [ A ]
Format:
DECOMP A/
LSEQ
LD,U, ,RPERM /
CPERM
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 $
Parameters:
KSYM Input/output-integer-default=-1.
1 Use standard decomposition.
0 Use unsymmetric decomposition.
Main Index
DECOMP 1001
Matrix decomposition
Main Index
1002 DECOMP
Matrix decomposition
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).
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 User’s 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 10 THRESH .
THRESH = -2 is recommended for indefinite matrices because
accuracy is improved even though execution time is increased.
Remarks:
1. By default, the DECOMP module uses sparse matrix methods. See the
MSC.Nastran Numerical Methods User’s 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.
Main Index
DECOMP 1003
Matrix decomposition
d. NASTRAN statement system cell 166 selects options for the sparse
method.
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.
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].
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:
Main Index
1004 DECOMP
Matrix decomposition
Examples:
1. Solve [ A ] [ X ] = [ B ] .
DECOMP A/L,U,/ $
FBS L,U,B/X/ $
MATPRN X// $
2. Form [ K ] = [ G ] T [ A ] [ G ] .
–1
K aa = K aa – K ao K oo K oa
Main Index
DELETE 1005
Deletes data blocks
Format:
DELETE /DB1,DB2,DB3,DB4,DB5 $
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” on page 38.
Example:
DELETE /A,B,C,, $
Main Index
1006 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:
DIAGONAL A/B/OPT/POWER $
Parameters:
Main Index
DIAGONAL 1007
Extracts diagonal from matrix or raises matrix to a power
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.
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
2 2
( a +b )
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 10 –3 .
DIAGONAL LOO/LOOD/’COLUMN’/1. $
DIAGONAL KOO/KOOD $
ADD LOOD,KOOD/LOVERK///2 $
MATMOD LOVERK,,,,/BIGLOVRK,/2////1.E-3 $
Main Index
1008 DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
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’ $
Main Index
DISDCMP 1009
Performs distributed decomposition
Format:
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 $
Parameters:
Main Index
1010 DISDCMP
Performs distributed decomposition
Main Index
DISFBS 1011
Performs distributed forward-backward substitution
Format:
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.
Parameters:
Remarks:
1. LBB and DSFDSC may be purged.
Main Index
1012 DISOFPM
Collects and merges OFP data blocks
Format:
DISOFPM OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8/
OFP1M,OFP2M,OFP3M,OFP4M,OFP5M,OFP6M,OFP7M,OFP8M/
MAXBUFF $
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.
Main Index
DISOFPS 1013
Sends OFP data blocks
Sends OFP data blocks from the slave processors to the master processor.
Format:
DISOFPS OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8 $
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.
Main Index
1014 DISOPT
Performs appropriate discrete optimization problems
Format:
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 $
Main Index
DISOPT 1015
Performs appropriate discrete optimization problems
Main Index
1016 DISOPT
Performs appropriate discrete optimization problems
Parameters:
Remarks:
None.
Main Index
DISPARM 1017
Broadcasts parameter values between slave and master processors
Broadcasts parameter values between slave and master processors for parallel
processing.
Format:
DISPARM //SENDID/RECVCODE/
S,N,INT/S,N,REAL/S,N,CMPX/S,N,CHAR/
S,N,REALD/S,N,CMPXD/S,N,LOG $
Parameters:
Main Index
1018 DISUTIL
Broadcasts data blocks between slave and master processors
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:
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 $
DISUTIL MATS,,,////-8, 8, or 9 $
DISUTIL DB,,,/DBOUT/SENDID/RECVCODE/10 $
Main Index
DISUTIL 1019
Broadcasts data blocks between slave and master processors
Main Index
1020 DISUTIL
Broadcasts data blocks between slave and master processors
Parameters:
Main Index
DISUTIL 1021
Broadcasts data blocks between slave and master processors
Remarks:
1. All executions of DISUTIL must be synchronized across all processors.
2. EPSSE may be purged. EPSSE contains:
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
1022 DIVERG
Performs aerostatic divergence analysis
Format:
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.
Parameters:
Main Index
DIVERG 1023
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
1024 DLT2SLT
Converts DLT to SLT
Converts a DLT formatted table to an SLT formatted tablewith follower forces only.
Format:
DLT2SLT DLT1,DIT/SLTF/ITIME/S,N,LOADIDF $
Parameters:
Main Index
DMPCASE 1025
Splits Case Control across multiple processors
Format:
DMPCASE CASECC/CASECCP/NPROC/PROCID/NMASS/NCASE $
Parameters:
Remarks:
None.
Main Index
1026 DMIIN
Inputs DMI entries to DMAP
Format:
DMIIN DMI,DMINDX/DMI1,DMI2,DMI3,DMI4,DMI5,DMI6,DMI7,
DMI8,DMI9,DMI10/PARM1/PARM2/PARM3/PARM4/PARM5/
PARM6/PARM7/PARM8/PARM9/PARM10 $
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.
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 $
Main Index
DOM10 1027
Prints initial and final results for design optimization
In design optimization, prints the initial and final results for the approximate
optimization problem.
Format:
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 $
Main Index
1028 DOM10
Prints initial and final results for design optimization
DRSTBLG Table containing the number of retained responses for each subcase for
each of the response types.
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.
Parameters:
Main Index
DOM10 1029
Prints initial and final results for design optimization
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.
RESTYP Input-integer-default=0. Optimization results flag.
0 Approximate model.
1 Exact analysis for fully stessed 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 $
Main Index
1030 DOM11
Updates geometry and element properties in design optimization
Format:
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 $
Main Index
DOM11 1031
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,/
Main Index
1032 DOM11
Updates geometry and element properties in design optimization
EPTNNX,COORDN,/0 $
Final:
DOM11 EPT,EPTTAB,PROPO,XO,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,GEOM1/
EPTN,COORDN,GEOM1N/DESCYCLE $
Main Index
DOM12 1033
Performs soft and hard convergence checks in design optimization
Format:
DOM12 XINIT,XO,CVAL,PROPI*,PROPO*,OPTPRM,HIS,
DESTAB,GEOM1N,COORDO,EDOM,MTRAK,EPT,GEOM2,MPT,
EPTTAB*,DVPTAB*,XVALP,GEOM1P,
R1TABRG,R1VALRG,RSP2RG,R2VALRG,PCOMPT,UBULK,TOPELE,
PBRMSN,OBJTBG,CVALA,CVALP/
HISADD,OPTNEW,DBCOPT,DESNEW/
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 $
Main Index
1034 DOM12
Performs soft and hard convergence checks in design optimization
Parameters:
Main Index
DOM12 1035
Performs soft and hard convergence checks in design optimization
Main Index
1036 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.
Main Index
DOM12 1037
Performs soft and hard convergence checks in design optimization
Examples:
MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ/DSAPRT/
PROTYP///FSDCYC/OBJAPPX/OBJINIT/S,N,REJECT/0/
TREGION $
APPEND HISADD,/HISX/2 $
equivx HISX/HIS/-1 $
Main Index
1038 DOM12
Performs soft and hard convergence checks in design optimization
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 $
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 1039
Calculates sensitivity of all retained constraints
Format:
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 $
Main Index
1040 DOM6
Calculates sensitivity of all retained constraints
Parameters:
Main Index
DOM9 1041
Performs the approximate optimization problem
Format:
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 $
Main Index
1042 DOM9
Performs the approximate optimization problem
Main Index
DOM9 1043
Performs the approximate optimization problem
Parameters:
Main Index
1044 DOM9
Performs the approximate optimization problem
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
DOPFS 1045
Performs optimization of the fully stressed design
Format:
DOPFS R1TABRG,CNTABRG,DESELM,DVPTAB*,CVALRG,
PROPI,OPTPRMG,DPLDXT*,CONSBL*,DESTAB,
XINIT,DPLDXI*,PLIST2*,DEQIND,DEQATN,
EPTTAB*,DBMLIB,XZ,DXDXI,DXDXIT,PBRMSD/
XO,PROPO $
Main Index
1046 DOPFS
Performs optimization of the fully stressed design
Remarks:
None.
Main Index
DOPR1 1047
Preprocesses design variables and designed property values
Format:
DOPR1 EDOM,EPT,DEQATN,DEQIND,GEOM2,MPT,EDT,CASECC,TOPTAB0,
TOPELE,PBRMS,BGPDT,ECT,GPECT,VELEM,CSTM/
DESTAB,XZ,DXDXI,DTB,DVPTAB*,EPTTAB*,CONSBL*,
DPLDXI*,PLIST2*,XINIT,PRO*PI*,DSCREN,DTOS2J*,
OPTPRM,CONS1T,DBMLIB,BCON0,BCONXI,DMATCK,DISTAB,
TOPTAB,PBRMSD,NWEDOM,NWCASE,TOPMC,
TOPMC2,TMINIT,TOPELE,TPRELE,TOPSM/
S,N,MODEPT/S,N,MODGEOM2/S,N,MODMPT/DPEPS/
S,N,PROTYP/S,N,DISVAR/S,N,NRANVAR $
Main Index
1048 DOPR1
Preprocesses design variables and designed property values
Main Index
DOPR1 1049
Preprocesses design variables and designed property values
Parameters:
Main Index
1050 DOPR2
Preprocesses the shape design variables and the shape basis vectors
DOPR2 Preprocesses the shape design variables and the shape basis vectors
Preprocesses the shape design variables and the shape basis vectors.
Format:
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,
CASECC,AMLIST,DVIDS/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,
CASEP,DNODEL/
LUSET/NOUGD/PEXIST/DVGRDN $
Main Index
DOPR2 1051
Preprocesses the shape design variables and the shape basis vectors
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 $
Main Index
1052 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:
DOPR3 CASE,EDOM,DTB,ECT,EPT,DESTAB,EDT,OL,DEQIND,DEQATN,
BGPDT,DVPTAB*,VIEWTB,OINT,PELSET,XINIT,FOL,DIT,DYNAMIC/
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.
Main Index
DOPR3 1053
Preprocesses DCONSTR, DRESP1, and DRESP2
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.
Main Index
1054 DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
Parameters:
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.
Main Index
DOPR3 1055
Preprocesses DCONSTR, DRESP1, and DRESP2
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.
Main Index
1056 DOPR3X
Check second and third level responses
Perform additional checks on the second level and third level design responses for all
superelements.
Format:
DOPR3X RESP12XM,RESP3XM/ $
Parameters:
None.
Main Index
DOPR4 1057
Creates design sensitivity tables for property and/or shape variables
DOPR4 Creates design sensitivity tables for property and/or shape variables
Format:
DOPR4 DTOS2J*,DTOS4J,DESTAB/
TABDEQ,DTOS2K*,DTOS4K/
PROTYP $
Parameters:
Main Index
1058 DOPR5
Updates design sensitivity tables
Format:
DOPR5 XINIT,EPTTAB*,PROPI*,DESTAB,DTOS2K*,DTOS4K,
TABDEQ,DELBSH,GEOM4,DESGID/
DTOS2*,DTOS4,DELBSX/
STPSCL/S,N,RGSENS/PROTYP $
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 1059
Updates design sensitivity tables
Parameters:
Main Index
1060 DOPR6
Generates tables relating to grid perturbations
Format:
DOPR6 DTOS4,GPECT,EQEXIN,DESGID,EST,GEOM4,MIDLIS/
DGTAB,ESTDVS,TABEVS/
RSONLY/RGSENS $
Parameters:
Main Index
DOPR6 1061
Generates tables relating to grid perturbations
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
1062 DOPRAN
Preprocess RMS responses
Format:
DOPRAN DYNAMIC,DIT,OL,R1TAB,BGPDT,CASE/
RMSTAB,CFSAB,PPVR/
LUSET $
Parameters:
Remarks:
None.
Main Index
DPD 1063
Creates tables from Bulk Data entry images specified for dynamic analysis
DPD Creates tables from Bulk Data entry images specified for dynamic
analysis
Creates tables from Bulk Data entry images specified for dynamic analysis.
Format:
DPD DYNAMIC,GPL,SIL,USET,UNUSED5,PG,PKYG,PBYG,PMYG,YG/
GPLD,SILD,USETD,TFPOOL,DLT,PSDL,RCROSSL,NLFT,TRL,
EED,EQDYN,APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
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 $
Main Index
1064 DPD
Creates tables from Bulk Data entry images specified for dynamic analysis
Parameters:
Main Index
DPD 1065
Creates tables from Bulk Data entry images specified for dynamic analysis
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.
Main Index
1066 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:
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.
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).
Main Index
DRMH1 1067
Converts data recovery tables to matrices and associated directory 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
1068 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:
DRMH3 TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4,
OL,CASECC/
OFP1,OFP2,OFP3,OFP4/
APP/DTM1/DTM2/DTM3/DTM4 $
OFPi Output table in SORT1 format identical in format to data blocks created
by the SDR2 module.
Parameters:
Main Index
DRMH3 1069
Partitions tables for each superelement
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” on page 1066 module description.
Main Index
1070 DRMS1
Data recovery by mode superposition, Phase 1
Format:
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.
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.
Main Index
DRMS1 1071
Data recovery by mode superposition, Phase 1
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 ( σ x , σ y , etc.) for all the GRIDs or elements retained in the input data
blocks.
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 ( fn ) .
• 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.
Main Index
1072 DSABO
Incorporates element property design variable perturbations
Incorporates element property design variable perturbations into tables required for
stiffness, mass, damping, and load generation.
Format:
DSABO ECT,EPT,EST,DTOS2*,ETT,DIT,MPT,DMATCK,PCOMPT/
ESTDVP,MPTX,EPTX,TABEVP,MIDLIS,ESTDVM,PCOMPTX/
S,N,PROPOPT/DELTAB/PROTYP/PEXIST $
Main Index
DSABO 1073
Incorporates element property design variable perturbations
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'
Main Index
1074 DSAD
Processes tables related to design sensitivity response evaluation
Format:
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.
Main Index
DSAD 1075
Processes tables related to design sensitivity response evaluation
Main Index
1076 DSAD
Processes tables related to design sensitivity response evaluation
Main Index
DSAD 1077
Processes tables related to design sensitivity response evaluation
Main Index
1078 DSAD
Processes tables related to design sensitivity response evaluation
Main Index
DSAD 1079
Processes tables related to design sensitivity response evaluation
Parameters:
Main Index
1080 DSAD
Processes tables related to design sensitivity response evaluation
Main Index
DSAD 1081
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
1082 DSADJ
Creates sensitivity of grid responses
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:
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 $
Main Index
DSADJ 1083
Creates sensitivity of grid responses
Parameters:
Main Index
1084 DSADJ
Creates sensitivity of grid responses
Main Index
DSADX 1085
Delete constraints for DRESP2 and DRESP3 that reference DRESP1
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:
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 $
Main Index
1086 DSADX
Delete constraints for DRESP2 and DRESP3 that reference DRESP1
Parameters:
Main Index
DSAE 1087
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:
DSAE ESTDVP,ESTDVS,TABEVP,TABEVS,TABDEQ/
ESTDV2,TABEV2 $
ESTDV2 Merged EST with grid and element property design variable
perturbations.
TABEV2 Merged cross reference table of TABEVP and TABEVS.
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.
Main Index
1088 DSAE
Merges tables to evaluate responses for the perturbed configuration
Main Index
DSAF 1089
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:
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.
Main Index
1090 DSAF
Generates tables incorporating effect of retained first level responses
VELEMN Table of element lengths, areas, and volumes for the perturbed
configuration.
GPECT Grid point element connection table.
BGPDT Basic grid point definition table.
Parameters:
Main Index
DSAH 1091
Generates data blocks required for DSAL module
Generates data blocks required for the DSAL module to compute sensitivities.
Format:
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.
Main Index
1092 DSAH
Generates data blocks required for DSAL module
Main Index
DSAH 1093
Generates data blocks required for DSAL module
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.
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.
Parameters:
Main Index
1094 DSAH
Generates data blocks required for DSAL module
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.
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 Nelson’s method or subspace
iteration for eigenvector sensitivites. Usually input via user parameter.
0 Nelson’s 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
DSAJ 1095
Generates g-set size reduced basis vectors for each design variable
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:
DSAJ EDOM,EQEXIN,BGPDT,CSTM,SIL,BASVEC0,CASECC,GEOM4/
DESVEC,DVIDS,CASEP,DESVECP/
LUSET $
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
1096 DSAJ
Generates g-set size reduced basis vectors for each design variable
Parameter:
Main Index
DSAL 1097
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:
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/
DSCM/
NDVTOT/DELTAB/EIGNFREQ/ADJFLG/SEID/
S,N,ADELRS/S,N,ADELRF $
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.
Main Index
1098 DSAL
Generates design sensitivity coefficient matrix
Main Index
DSAL 1099
Generates design sensitivity coefficient matrix
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.
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.
Parameters:
Main Index
1100 DSAL
Generates design sensitivity coefficient matrix
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.
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.
Main Index
DSAM 1101
Creates geometry for backward and forward (or central) perturbation
DSAM Creates geometry for backward and forward (or central) perturbation
Creates geometry for the backward and forward (or central) perturbation.
Format:
DSAM DTOS4,DGTAB,BGPDT/
BGPDVP,BGPDVB/
S,N,SHAPEOPT/CDIF $
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
BGPDVB Basic grid point definition table for the backward perturbed
configuration.
Parameters:
Main Index
1102 DSAN
Generates design sensitivity processing table
Generates design sensitivity processing table and update element temperature table.
Format:
DSAN TABEV2,ETT,EST,MPT/
DSPT1,ETTDV $
Parameters:
None.
Main Index
DSAP 1103
Computes an inertial or pseudo-load matrix
nfreq
2
∑ – w j * [ MU x ] + iw j * [ BU x ] + [ KU x ] Eq. 4-19
j = 1
where:
w j = freq j * 2pi
nfreq
2
∑ p j * [ MU x ] + p j * [ BU x ] + [ KU x ] Eq. 4-20
j = 1
where:
r i
p j = w j + iw j
Format:
DSAP MUX,BUX,KUX,OL,DSPT1/
PX/
APP $
Main Index
1104 DSAP
Computes an inertial or pseudo-load matrix
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.
Main Index
DSAPRT 1105
Prints the normalized design sensitivity coefficient matrix
Prints the normalized design sensitivity coefficient matrix according to the DSAPRT
Case Control command request.
Format:
DSAPRT CASECC,DESTAB,DSCMCOL,DSCM2,R1VALRG,R2VALRG,R3VALRG,
DSIDLBL,XINIT//
DSZERO/EIGNFREQ/XYUNIT/DESCYCLE $
Parameters:
Main Index
1106 DSAPRT
Prints the normalized design sensitivity coefficient matrix
Main Index
DSAR 1107
Extracts and truncates data from the transient solution matrix
DSAR Extracts and truncates data from the transient solution matrix
Extracts and truncates the displacement, velocity, acceleration, and dynamic loads
from the transient solution matrix into separate matrices.
Format:
DSAR UXT,TOL,TOL1,PXT/
UDISP,UVELO,UACCE,UXT1,PXT1/
EXTRPL/NDEL/SORTP $
Parameters:
Main Index
1108 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.
Main Index
DSARLP 1109
Calculates pseudo-displacements for calculating sensitivities of stability derivatives
Format:
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.
Main Index
1110 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.
Main Index
DSARME 1111
Computes RMS values
Format:
DSARME UPDST,RMSTAB,CFSAB/
RMSVAL $
Parameters:
None.
Remarks:
None.
Main Index
1112 DSARSN
Calculates delta response values for trim variables and stability derivatives
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:
DSARSN CASEA,R1TABR,AECTRL,DUX,TR,AERO,DSTABU,DSTABR/
DELX1,DELS1/
TFLG/SDFLG/Q $
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.
Main Index
DSARSN 1113
Calculates delta response values for trim variables and stability derivatives
Parameters:
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.
Main Index
1114 DSAW
Calculates delta-weight and/or delta-volume for each design variable
Format:
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.
Parameter:
Main Index
DSDVRG 1115
Computes weighting factors to calculate retained divergence response sensitivities
Computes the weighting factors required in the calculation of the retained divergence
response sensitivities.
Format:
DSDVRG DSEDV,DIVTAB,PHIDRLR,PHIDLLR,QLLX/
DELDV $
Parameters:
None.
Main Index
1116 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:
DSFLTE KHH,BHH,MHH,QHHL,FLUTAB,R1TABR,CASECC,CPHP,LCPHP/
CPHFL,CPHFR,VTQU/FCSENS $
Parameters:
Main Index
DSFLTE 1117
Calculates right and left eigenvectors for a given eigenvalue
Remark:
The calculations in DSFLTE closely follow those used in module FA1 to perform the
p-k method of flutter analysis.
Main Index
1118 DSFLTF
Calculates sensitivity of active flutter responses
Format:
DSFLTF VTQU,CDELK,CDELB,CDELM/DELFL/FCSENS $
Parameters:
Main Index
DSGRDM 1119
Produces grid list of design model
Format:
DSGRDM EDOM,EPT,GEOM2,MPT,GEOM1/
DSGRID/
S,N,AUTOSE/S,N,NUMDIV/S,N,DRATIO $
DSGRID Table of identification numbers for those grid points in the design
model automatic superelement optimization feature.
Parameters:
Main Index
1120 DSMA
Generates combined design sensitivity/constraint matrix
Format:
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’) $
Main Index
DSMA 1121
Generates combined design sensitivity/constraint matrix
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.
Main Index
1122 DSPRM
Sets design sensitivity parameters
Sets design sensitivity parameters based on retained responses for DMAP flow
control.
Format:
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.
Parameters:
Main Index
DSPRM 1123
Sets design sensitivity parameters
Main Index
1124 DSPRM
Sets design sensitivity parameters
Remark:
RSP1CT may be specified as input to DSPRM.
Main Index
DSTA 1125
Creates tables for Old Design Sensitivity Analysis only
Creates tables related to the design perturbation in Old Design Sensitivity Analysis
only.
Format:
UG
DSTA ECT,EPT,EST,CASECC,EDOM, LAMA ,CASECCX,ETT,
BLAMA
DIT,MPT/
ESTDVP,ESTDCN,CASEDS,ETTDCN,DSPT1,DSPT2,
DSROWL,DSCOLL,ETTDV,MPTC,EPTC/
APP/S,N,NOPRT/S,N,NOSAVE/S,N,NOFORT/NEIG $
Main Index
1126 DSTA
Creates tables for Old Design Sensitivity Analysis only
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).
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.
Parameters:
Main Index
DSTA 1127
Creates tables for Old Design Sensitivity Analysis only
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.
Main Index
1128 DSTAP2
Creates correlation table for normalized design sensitivity coefficient matrix
Creates a correlation table for the normalized design sensitivity coefficient matrix.
Format:
DSTAP2 R1TABRG,RSP2RG,RSP3RG/
DSCMCOL,DSIDLBL,RQA/
S,N,NORQA/S,N,IFRMAS $
Parameter:
Main Index
DSVG1 1129
Creates pseudo loads or scalar terms required in sensitivity analysis
Format:
UGX
DSVG1 XDICTDS,XELMDS,BGPDT,SIL,CSTM,XDICT,XELM, ,VG,
LFTAB,DSPT1,VGDM,XDICTB,XELMB/ AGX
EGX/
NOK4GG/WTMASS/IAPP/DSVGSF/NOPSLG/COUPMASS/CDIF/
SPDM/SHAPEOPT/MGEFLAG $
Main Index
1130 DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis
Parameters:
Main Index
DSVG1 1131
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 NOPSLG ≠ 0 , then a null EGX matrix is generated.
Main Index
1132 DSVG1P
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis
Creates pseudo loads or scalar terms required for p-elements in design sensitivity
analysis.
Format:
DSVG1P ESTDVM,ESTDV2,BGPDVP,CSTM,MPTX,DIT,DEQATN,DEQIND,
UGX,LFTAB,DSPT1,GPSNT,ESTDVB/
EGK,EGM/
COUPMASS/K6ROT/ALTSHAPE/WTMASS/NOPSLG/OPTFLG/
UNUSED7 $
Main Index
DSVG1P 1133
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis
Parameters:
Remark:
If NOPSLG ≠ 0 , then a null EGX matrix is generated.
Main Index
1134 DSVG2
Generates pseudo-load matrix for equilibrium changes in thermal load
Generates the pseudo-load matrix which reflects equilibrium changes in the thermal
load due to variations in the design variables.
Format:
DSVG2 BGPDVX,CSTM,SIL,KDICTX,CASDSN,PTELEM,
UGX
PTELMDSX, ,DSPT1/
AGX
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.
Main Index
DSVG2 1135
Generates pseudo-load matrix for equilibrium changes in thermal load
Parameters:
Remark:
CSTM and BGPDT may be purged.
Main Index
1136 DSVG3
Combines and appends solution matrices for Old Design Sensitivity Analysis only
DSVG3 Combines and appends solution matrices for Old Design Sensitivity
Analysis only
Combines and appends the solution matrices from the analysis and pseudo-loads due
to design variable changes in Old Design Sensitivity Analysis only.
Format:
DSVG3 UG,UGDS/
UGDS1 $
Parameters:
None.
Main Index
DSVGP4 1137
Generates a perturbed multipoint constraint transformation matrix
Format:
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.
Parameters:
Main Index
1138 DSVGP4
Generates a perturbed multipoint constraint transformation matrix
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
DSVGP5 1139
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:
[ A 1 ⋅ B A 2 ⋅ B A 3 ⋅ B …A n ⋅ B ] + C 1 C 2 C 3 …C n
Format:
DSVGP5 A,B,C,DVSLIS/
D/
NSMATS/T/IOPT $
D Matrix product.
Parameters:
1 Transpose A i .
Main Index
1140 DSVGP5
Performs multiplication of two matrices
1 B + Ai .
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
DTIIN 1141
Input DTI entries to DMAP
Format:
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.
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 $
Main Index
1142 DUMMOD1
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
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 $
Parameters:
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
DUMMOD2 1143
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
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 $
Parameters:
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
1144 DUMMOD3
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
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 $
Parameters:
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
DUMMOD4 1145
Provides dummy module for inclusion of user written subroutines and modules
Provides dummy module for inclusion of user written subroutines and modules.
Format:
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 $
Parameters:
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
1146 DVIEWP
Generates view-element and view-grid information for processing p-elements
Format:
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 $
Parameters:
Main Index
DVIEWP 1147
Generates view-element and view-grid information for processing p-elements
Main Index
1148 DYNCXPNT
Adds acoustic infinite extra points to the DYNAMIC table
Format:
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
Parameters:
Remark:
If any of the datablocks GEOM2, EPT and DYNAMIC are purged or do not exist then
no action is taken.
Main Index
EFFMASS 1149
Computes modal effective mass
Format:
EFFMASS CASECC,MAA,PHA,LAMA,USET,BGPDT,UNUSED,CSTM,VGQ/
TEMF,EMM,DMA,MEMF,MPFEM,MEM,MEW/
SEID/WTMASS/S,N,CARDNO/SETNAM/UNUSED $
Main Index
1150 EFFMASS
Computes modal effective mass
Parameters:
Remarks:
None.
Main Index
ELFDR 1151
Transforms grid point force balance output from GPFDR module
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:
ELFDR OGPFB1,GPECT,CSTM,SIL,GPL,BGPDT/
OELOF1,OELOP1/
NOELOF/NOELOP/UNUSED3 $
Parameters:
Main Index
1152 ELTPRT
Prints element summary information
Format:
ELTPRT ECT,GPECT,BGPDT,NSMEST,EST,CSTM,MPT,DIT,
CASSECC,EPT,UNUSED/
VELEM/
PROUT/S,N,ERROR/WTMASS $
Main Index
ELTPRT 1153
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.
1
2
3
4
Main Index
1154 ELTPRT
Prints element summary information
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
EMA 1155
Assembles global g-set size matrix from elemental matrices
Format:
EMA GPECT,XDICT,XELM,BGPDT,SIL,CSTM,XDICTP,XELMP/
XGG,UNUSED2/
NOK4GG/WTMASS/K4QUAL $
Parameters:
Method:
The structural damping matrix [ K 4gg ] is assembled from elements with structural
damping. Structural damping is specified in the GE field of the MATi entry.
Main Index
1156 EMA
Assembles global g-set size matrix from elemental matrices
NE
4
[ K gg ] = ∑ GE e [ K e ] Eq. 4-21
e = 1
where:
NE = number of elements.
GE e = element structural damping coefficient from MATi entries.
Remark:
EMA is used to generate stiffness (KGG), mass (MGG), damping (BGG), and
structural damping (K4GG) matrices.
Main Index
EMAKFR 1157
Generates stiffness for follower forces
Format:
EMAKFR BGPDT,CSTM,SLT,MGG,CSTM0,SCSTM/
KRFGG/
LOADID/LOADIDP/SEID/LOADFACR/SYS66 $
Output:
Parameters:
Main Index
1158 EMAKFR
Generates stiffness for follower forces
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:
P total = LOADFACR • P LOADID + ( 1.0 – LOADFACR ) • P LOADIDP
Main Index
EMG 1159
Computes elemental matrices
Computes elemental matrices for stiffness, differential stiffness, mass, damping, heat
conduction, or heat capacity.
Format:
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 $
Main Index
1160 EMG
Computes elemental matrices
Parameters:
Main Index
EMG 1161
Computes elemental matrices
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.
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.
Main Index
1162 EMG
Computes elemental matrices
Main Index
EMG 1163
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:
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.
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 element’s KDICT entry.
-2 / +2 Process only shell elements: each element stiffness is
multiplied by its corresponding GEi and 1.0 is
placedfor GE in element’s KDICT entry.
-3 / +3 Both 1 and 2.
Main Index
1164 EQUIVX
Data block name equivalence
Format:
EQUIVX DBP/DBS/PARM $
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:
Main Index
EQUIVX 1165
Data block name equivalence
Examples:
Data blocks A and B reside on the same DBset.
EQUIVX A/B/ALWAYS $
Main Index
1166 ESTINDX
Creates an index, keyed by element identification number
Format:
ESTINDX /EST $
Parameters:
None.
Remark:
EST must be declared as an append file on the FILE statement.
Main Index
EXPORTLD 1167
Creates an index, keyed by element identification number
Format:
EXPORTLD CASECC,PG,BGPDT/PG*,BGPDT*/NSKIP $
Parameters:
Remarks:
None.
Main Index
1168 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:
FA1 KHH,BHH,MHH,QHHL,CASECC,EDT/
FSAVE,KHH1,BHH1,MHH1,FLUTABP/
S,N,FLOOP/S,N,TSTART/S,N,NOCEAD/LPRINT/XYUNIT/VREF $
Parameters:
Main Index
FA1 1169
Prepares the modal matrices for flutter eigenvalue analysis
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.
Main Index
1170 FA2
Collects aeroelastic flutter data
Collects aeroelastic flutter data for reduction and presentation for each loop through
the configuration parameters.
Format:
FA2 CPH1,CLAMA1,FSAVE/
CPH2,CLAMA2,CASEYY,OVG,FLUTABK/
S,N,TSTART/VREF/AECONFIG/SYMXY/SYMXY/LPRINT $
Parameters:
Main Index
FA2 1171
Collects aeroelastic flutter data
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
1172 FBODYLD
Collects aeroelastic flutter data
FBODYLD Filters grid point forces according to a FBODY Case Control request
Filters grid point forces according to a FBODY Case Control request.
Format:
FBODYLD EDT,BGPDT,CASECC,OGPF1,CSTM/
BGPDTFB*,PGFB*/GPFNAM $
BGPDTFB* Family of BGPDT tables associated with FBLPG. One instance defines
the grids for one given freebody subsystem.
PGFB* Family of PG matrices.
Parameters:
Remarks:
None.
Main Index
FBS 1173
Matrix forward/backward substitution
Format:
FBS LD,U,B/X/KSYM/SIGN/FBTYP/FBREST/UNUSED/UNCOUP $
Parameters:
Main Index
1174 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 [ D ] .
When using the forward-pass only and backward-pass only options, [ D ] 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.
Main Index
FBS 1175
Matrix forward/backward substitution
Examples:
1. Solve [ A ] [ X ] = [ B ] where [ A ] could be either symmetric or unsymmetric.
DECOMP A/LD,U, $
FBS LD,U,B/X/ $
MATPRN X// $
T
4. Solve [ LD ] [ X ] = [ C ] where [ LD ] is the lower triangular factor obtained
in Example 2.
FBS LD,,C/X///-1 $ BACKWARD PASS ONLY
5. Given that [ M ] and [ K ] are symmetric and [ M ] is also positive definite, find
T –1 T
[ [ LD ] ] [ K ] [ LD ]
where
Main Index
1176 FBS
Matrix forward/backward substitution
T
[ M ] = [ LD ] [ LD ]
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
Main Index
FILE 1177
Data block declaration
Format:
FILE DB1=[SAVE,APPEND,OVRWRT]/DB2=[SAVE,APPEND,
OVRWRT]/... $
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” on page 1164 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 $
Main Index
1178 FILE
Data block declaration
.
.
.
DO WHILE ( COUNT<=3 ) $
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” on page 895
module description.
Main Index
FORTIO 1179
Opens or closes a FORTRAN file
Format:
FORTIO //OPERATN/UNITNO/CLOSEOPT/IOSTAT $
Parameters:
Remarks:
1. Units must be assigned a physical file name using an ASSIGN statement.
Main Index
1180 FORTIO
Opens or closes a FORTRAN file
Example:
Close FORTRAN unit 24:
FORTIO //'CLOSE'/24/2/S,N,IOSTAT $
Main Index
FRLG 1181
Generates frequency-dependent loads or time-dependent loads
Format:
FRLG CASECC,USETD,DLT,FRL,GMD,GOD,DIT,PHDH,
APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
PPF,PSF,PDF,FOL,PHF,YPF/
SOLTYP/S,N,FOURIER/S,N,APP $
Main Index
1182 FRLG
Generates frequency-dependent loads or time-dependent loads
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.
Main Index
FRLGEN 1183
Creates frequency response list from the FREQi Bulk Data entries
FRLGEN Creates frequency response list from the FREQi Bulk Data entries
Creates the frequency response list from the FREQi Bulk Data entries.
Format:
FRLGEN DYNAMIC,LAMAS,LAMAF/
FRL,FRL1,DFFDNF/
S,N,NOFRL/S,N,NOOPT/DFREQ $
Main Index
1184 FRLGEN
Creates frequency response list from the FREQi Bulk Data entries
Parameters:
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, f1 and f2, are considered duplicates if
where f max and f min are the maximum and minimum frequencies across
all FREQi Bulk Data entries.
Remarks:
LAMAF may be purged.
Main Index
FRQDRV 1185
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:
FRQDRV CASECC,FRL/
FRLI/
S,N,FRQLOOP/S,N,FREQVAL $
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
Main Index
1186 FRRD1
Solves for the steady-state frequency response displacement solution
Format:
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 $
Main Index
FRRD1 1187
Solves for the steady-state frequency response displacement solution
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.
Parameters:
Main Index
1188 FRRD1
Solves for the steady-state frequency response displacement solution
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.
[ – M dd ω 2 + iB dd ω + K dd ] { u d } = { P d } Eq. 4-22
and in the case of a modal formulation, the following equation is used in:
[ – M hh ω 2 + iB hh ω + K hh ] { u h } = { P h } 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.
Main Index
FRRD2 1189
Solves for the steady-state frequency response displacement solution
Format:
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 $
Main Index
1190 FRRD2
Solves for the steady-state frequency response displacement solution
Parameters:
Method:
FRRD2 solves the matrix equation
\
2
– ω [ M ] + iω [ [ B ] – Q ⋅ BOV ⋅ IM [ Q ] ] + [ K ] – Q ⋅ Re [ Q ] [u] = [P]
\
Main Index
FRRD2 1191
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
1192 GENTRAN
Generates a transformation matrix
Format:
GENTRAN SEMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/
MAPS/
SEID $
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 ) $
DBVIEW CSTMD =CSTMS WHERE ( PEID=NP ) $
GENTRAN EMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/
Main Index
GENTRAN 1193
Generates a transformation matrix
MAPS/SEID $
ENDIF $ PARTSE
ENDDO $ NOT(RSONLY) AND LPFLG<>-1 AND SEBULK
Main Index
1194 GETCOL
Reads STATSUB Case Control command subcase identification number number
Reads the STATSUB Case Control command subcase identification number and
converts it to the equivalent column number in the static solution matrix.
Format:
GETCOL CASEBUCK,CASESTAT//
NSKIP/S,N,BCKCOL/S,N,PRECOL/S,N,ICCOL $
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.
Main Index
GETMKL 1195
Create list of Mach numbers on reduced frequency pairs
Format:
GETMKL EDT/MKLIST/S,N,NMK $
Parameters:
Main Index
1196 GI
Generates aerodynamic spline transformation matrix
Format:
SPLINE
GI AERO, ,BGPDT,AEBGPDT,AEUSET,AECOMP,CSTMA,
AMSPLINE
AEGRID/
GPGK,GDGK $
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.
Parameters:
None.
Example:
Excerpt from subDMAP AERO0:
Main Index
GI 1197
Generates aerodynamic spline transformation matrix
Main Index
1198 GIC2C
Forms splice matrix for element centroids
Format:
GIC2D AEBOX,AEGRID,AEBGPDT*,CSTM/GDKSKS $
Parameters:
None.
Main Index
GKAM 1199
Assembles modal mass, damping and stiffness matrices
Format:
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 $
Main Index
1200 GKAM
Assembles modal mass, damping and stiffness matrices
Parameters:
Main Index
GKAM 1201
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:
T
[ K hh ] = [ k ] + [ φ dh ] [ K dd
2 ][ φ ]
dh Eq. 4-24
T
[ M hh ] = [ m ] + [ φ dh ] [ M dd
2 ][φ ]
dh Eq. 4-25
and
T
[ B hh ] = [ b ] + [ φ dh ] [ B dd
2 ][φ ]
dh Eq. 4-26
m i = modal mass
b i = 2πf i g ( f i )m i
k i = 4π 2 f i2 m i
Main Index
1202 GKAM
Assembles modal mass, damping and stiffness matrices
m i = modal mass
bi = 0
k i = [ 1 + ig ( f i ) ]4π 2 f i2 m i
Values of g ( f i ) are specified on the TABDMP1 Bulk Data entry, selected by the
SDAMPING Case Control command. If KDAMP = 1 (default), the matrices [ b ] and
[ k ] 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.
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 MD 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
GNFM 1203
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:
GNFM KELM,KDICT,KDELM,KDDICT,EST,CSTM,UG,BGPDT/
FG,KELM1,KDICT1/
SKPMTX/LUSET/NSKIP $
Parameters:
Main Index
1204 GNFM
Computes element forces due to large displacements
Remarks:
1. FG cannot be purged.
2. KELM1 and KDICT1 may be purged if SKPMTX<>0.
Main Index
GP0 1205
Modifies tables to include p-element information
Format:
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 $
Main Index
1206 GP0
Modifies tables to include p-element information
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.
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.
Parameters:
Main Index
GP0 1207
Modifies tables to include p-element information
Main Index
1208 GP1
Performs basic geometry processing
Format:
GP1 GEOM1,GEOM2,GEOM3,GDNTAB,MEDGE,SGPDT,DYNAMIC,CASECC/
GPL,EQEXIN,GPDT,CSTM,BGPDT,SIL,VGF,GEOM3B,DYNAMICB/
S,N,LUSET/S,N,NOCSTM/S,N,NOPOINTS/
UNIT/UPERM/UPRMT/NUFLAG/SEID $
Main Index
GP1 1209
Performs basic geometry processing
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.
DYNAMICB Table of Bulk Data entry images related to dynamics without DAREA
entry images.
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.
Main Index
1210 GP2
Processes element connectivity
Format:
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.
Parameter:
Main Index
GP2 1211
Processes element connectivity
Remarks:
1. EQEXIN and ECT may not be purged.
2. ECTA may be purged if GEOM2A is purged.
Main Index
1212 GP3
Processes static and thermal loads
Format:
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
Parameters:
Main Index
GP3 1213
Processes static and thermal loads
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:
Main Index
1214 GP4
Generates the degree-of-freedom set table
Format:
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 $
Main Index
GP4 1215
Generates the degree-of-freedom set table
Parameters:
Main Index
1216 GP4
Generates the degree-of-freedom set table
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.
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.
Main Index
GP5 1217
Creates table of static loads for panels in coupled fluid/structure analysis
Format:
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 $
Main Index
1218 GP5
Creates table of static loads for panels in coupled fluid/structure analysis
Parameters:
Main Index
GPFDR 1219
Computes grid point forces and element strain energy
Format:
GPFDR CASECC,UG,KELM,KDICT,ECT,EQEXIN,GPECT,PG,QG,
LAMA
FOL
BGPDT, ,CSTM,VELEM,PTELEM,QMG,NFDICT,FENL,
TOL
OLF
MELM,MDICT,BELM,BDICT,GEI,MATPOOL,F2J,VG,AG,EDT/
ONRGY1,OGPFB1,OEKE1,OEDE1/
APP/TINY/XFLAG/CYCLIC/WTMASS/NDVTOT/DMIGFN $
Main Index
1220 GPFDR
Computes grid point forces and element strain energy
Parameters:
Main Index
GPFDR 1221
Computes grid point forces and element strain energy
0.5* [ ue ]t [ ke ] [ ue ] – [ ue ]t [ pt ]
1 Cross displacement. See Remark 2.
2 Strain energy is calculated according to:
0.5* ( [ ue ]t [ ke ] [ ue ] – [ ue ]t [ pt ] )
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.
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:
Main Index
1222 GPFDR
Computes grid point forces and element strain energy
If XFLAG=0 (default):
1 T
W e = --- { F e } { u e } Eq. 4-27
2
If XFLAG=1:
1 1 T i
W e = --- u e K e u e Eq. 4-28
2
where u 1e is the displacement for the first subcase or mode and
where u ie 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.
Main Index
GPJAC 1223
Checks element Jacobians
Format:
GPJAC ECT,BGPDT//S,N,JACDET $
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.
Main Index
1224 GPSP
Performs auto-SPC operation
Format:
KNN KMM
GPSP , ,USET0,SIL,GPL,YS0,GEOM4,EQEXIN,
KGG RMG
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 $
Main Index
GPSP 1225
Performs auto-SPC operation
Parameters:
Main Index
1226 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,...
Main Index
GPSP 1227
Performs auto-SPC operation
Main Index
1228 GPSTR1
Computes element to grid point interpolation factors
Computes element to grid point interpolation factors for grid point stress
computations.
Format
:
GPSTR1 POSTCDB,BGPDT,EST,CSTM,ELSET,ESTNL,UNUSED7,CASECC/
EGPSF/
S,N,NOEGPSF $
Parameter:
Remark:
CSTM may be purged.
Main Index
GPSTR2 1229
Computes grid point stresses or strains
Computes grid point stresses or strains interpolated from element centroid stresses or
strains.
Format:
GPSTR2 CASECC,EGPSF,BGPDT,OES1,OESNLXR/
OGS1,EGPSTR/
S,N,NOOGS1/S,N,NOEGPSTR/APP/NLSTRAIN/GPSOPT $
Parameters:
Main Index
1230 GPSTR2
Computes grid point stresses or strains
Remarks:
1. The GPSTRESS Case Control command controls the contents of OGS1.
2. The STRFIELD Case Control command controls the contents of EGPSTR.
Main Index
GPSTRPBX 1231
Performs grid point stress recovery for Arbitrary Beam Cross Section.
GPSTRPBX Performs grid point stress recovery for Arbitrary Beam Cross
Section.
Performs grid point stress recovery for Arbitrary Beam Cross Section.
Format:
GPSTRPBX OEF1,EPT,PBRMS,PBRMSD,COELEM,EST/
OGS1AB,OES1AB/
S,N,IRECPBR/S,N,KSTATN/S,N,OP2AB $
Parameters:
Main Index
1232 GPWG
Computes center of mass of structure relative to a given point
Computes the center of mass of the structure relative to a given point and the principal
inertias about the center of gravity.
Format:
GPWG BGPDT,CSTM,UNUSED3,MGG,MEDGE,UNUSED6/
OGPWG/
GRDPNT/WTMASS/ALTSHAPE/SEID $
Parameters:
Main Index
GPWG 1233
Computes center of mass of structure relative to a given point
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 [ M gg ] 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.
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 [ D ]T matrix: six vectors are formed that will describe the
six motions about the reference point. The matrix [ D ] 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
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 [ D ] . If it is a grid point,
r1
{ ri } = { Ri } – { Ro } = r2 Eq. 4-30
r3
is computer where { R i } is the basic coordinate of the i-th grid point given in
the BGPDT table and { R o } is the location of the reference point.
The transformation matrix to the grid point
Main Index
1234 GPWG
Computes center of mass of structure relative to a given point
0 r3 –r2
[ Tr ] = –r3 0 r1 Eq. 4-31
r2 –r1 0
T T
Ti Ti Tr
[d] = Eq. 4-32
T
0 Ti
T
[ M 0 ] = [ D ] [ M gg ] [ D ] Eq. 4-33
t tr
[ Mo ] ⇒ M M Eq. 4-34
rt r
M M
t 2
δ = Σ ( M ij ) Eq. 4-35
and
t 2
ε = Σ ( M ij ) i ≠ j Eq. 4-36
Main Index
GPWG 1235
Computes center of mass of structure relative to a given point
[ S ] = [ { e 1 }, { e 2 }, { e 3 } ] Eq. 4-37
T T t
[M ] = [S] [M ][S] Eq. 4-38
tr T tr
[M ] = [ S] [M ][ S] Eq. 4-39
r T r
[M ] = [S] [M ][S] Eq. 4-40
The following terms, defined in the principal axis system { e 1 } , { e 2 } , and
{ e 3 } , are calculated and output. The mass terms are
t
M x = M 11 Eq. 4-41
t
M y = M 22 Eq. 4-42
t
M z = M 33 Eq. 4-43
tr tr tr
M 11 – M 13 M 12
X x = ----------, Y x = -------------, Z x = ---------- Eq. 4-44
Mx Mx Mx
tr tr tr
M 23 M 22 – M 21
X y = ----------, Y y = ---------- , Z y = ------------- Eq. 4-45
My My My
tr tr tr
– M 32 M 31 M 33
X z = ------------- , Y z = ---------- , Z z = ---------- Eq. 4-46
Mz Mz Mz
The inertias at the center of gravity relative to the principal mass axis are
determined from
(S) r 2 2
I 11 = M 11 – M y Z y – M z Y z Eq. 4-47
(S) (S) r
I 12 = I 21 = – M 12 – M z X z Y z Eq. 4-48
Main Index
1236 GPWG
Computes center of mass of structure relative to a given point
(S) (S) r
I 13 = I 31 = – M 13 – M y X y Z y Eq. 4-49
(S) r 2 2
I 22 = M 22 – M z X y – M x Z x Eq. 4-50
(S) r 2 2
I 22 = M 22 – M z X z – M x Z x Eq. 4-51
(S) (S) r
I 32 = I 23 = – M 23 – M x Y x Z Eq. 4-52
x
(S) r 2 2
I 33 = M 33 – M x Y x – M y X y Eq. 4-53
P
I 11 0 0
T
P
0 I 22 0 = [ Q ] [ I˜ ] [ Q ] Eq. 4-54
P
0 0 I 33
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.
Main Index
GPWG 1237
Computes center of mass of structure relative to a given 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.
Main Index
1238 GUST
Computes loads for aerodynamic analysis
Computes loads for aerodynamic analysis that are associated with aerodynamic flow.
Format:
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 $
Main Index
GUST 1239
Computes loads for aerodynamic analysis
PHF1 Frequency response load matrix in the h-set (modal) combined with
gust loads.
WJ Gust matrix.
QHJK Aero transformation matrix between h and j sets.
PFP Frequency response load matrix in the p-set combined with gust loads.
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:
Main Index
1240 GUST
Computes loads for aerodynamic analysis
Main Index
GUSTLDW 1241
Computes downwash load due to gust
Format:
GUSTLDW EDT,AERO,CSTMA,MKLIST,AEBGPDT*,SKJ,LAJJT,UAJJT/
QKGUST*/
GUST2ID/S,N,QKGUSTL $
Parameters:
Main Index
1242 GYROLD
Compute the gyroscopic static loads.
Format:
GYROLD CASECC,CSTM,BGPDT,SLT,KGGG*/
PJR,UNUSED/
GYLDOPT/LOADID/RFORSCAL/RACCSCAL $
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.
Parameters:
Main Index
GYROLD 1243
Compute the gyroscopic static loads.
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.
Main Index
1244 IFP
Reads Bulk Data Section
Reads in the Bulk Data and outputs the finite element model in table form.
Format:
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 $
Main Index
IFP 1245
Reads Bulk Data Section
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat
transfer radiation, virtual mass, DMIG, and DMIAX entries.
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.
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$
Main Index
1246 IFP
Reads Bulk Data Section
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/
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 $
Main Index
IFP 1247
Reads Bulk Data Section
$
IF ( RUNIFP8 ) THEN $
IFP8 MPT.0,IDIT/MPT.8/S,N,NOGOIFP8 $
ELSE $
EQUIVX MPT.0/MPT.8/-1 $
Main Index
1248 IFP1
Reads Case Control Section
Format:
IFP1 /CASECC,PCDB,XYCDB,POSTCDB,FORCE,MMCDB/
S,N,NOGOIFP1/S,N,LASTCC/S,N,BEGSUP/STEPPR $
Parameter:
Main Index
IFP1 1249
Reads Case Control Section
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:
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
1250 IFP3
Modifies Bulk Data entry records
Modifies Bulk Data entry records related to axisymmetric conical shell analysis.
Format:
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.
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:
Bulk Data
Output Records Output Data Blocks
Entry Record
AXIC None None
CCONEAX CCONE GEOM2
FORCEAX FORCE GEOM3
MOMAX MOMENT GEOM3
MPCAX MPC GEOM4
Main Index
IFP3 1251
Modifies Bulk Data entry records
Bulk Data
Output Records Output Data Blocks
Entry Record
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
4. The other Bulk Data entries recognized and processed by IFP3 are:
FORCE, GRAV, LOAD, MOMENT, TEMPD, TEMP, GRID,
MPCADD, OMIT, SEQGP, SPC, SPCADD, and SUPORT
Example
See the example in the “IFP” on page 1244 module description.
Main Index
1252 IFP4
Processes hydroelastic-related Bulk Data entry records
Format:
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.
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.
3. The following is a list of Bulk Data entry records generated or modified by
IFP4:
Main Index
IFP4 1253
Processes hydroelastic-related Bulk Data entry records
Bulk Data
Output Records Output Data Blocks
Entry Record
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
Example:
See the example in the “IFP” on page 1244 module description.
Main Index
1254 IFP5
Process acoustic cavity-related Bulk Data entry records
Format:
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.
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:
Main Index
IFP5 1255
Process acoustic cavity-related Bulk Data entry records
Example:
See the example in the “IFP” on page 1244 module description.
Main Index
1256 IFP6
Creates PSHELL and MAT2 Bulk Data entry records
Create PSHELL and MAT2 Bulk Data entry records based upon data on PCOMP and
MAT8 bulk data entry records.
Format:
IFP6 EPT,MPT,DIT,PCOMPT/
EPTC,MPTC,PCOMPTC/
S,N,NOGOIFP6/S,N,NOCOMP/DSFLAG $
Parameter:
Main Index
IFP6 1257
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” on page 1244 module description.
Main Index
1258 IFP7
Creates PBEAM Bulk Data entry records
Create PBEAM Bulk Data entry records based upon data on PBCOMP Bulk Data entry
records.
Format:
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.
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” on page 1244 module description.
Main Index
IFP8 1259
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:
IFP8 MPT,DIT/MPTX/S,N,NOGOIFP8 $
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” on page 1244 module description.
Main Index
1260 IFP9
Creates PBAR and PBEAM Bulk Data entry records
Create PBAR and PBEAM Bulk Data entry records based upon data on PBARL and
PBEAML Bulk Data entry records.
Format:
IFP9 EPT,GEOM1,EDT,GEOM2/EPTX,PBRMS/S,N,NOGOIFP9/
ARBMPS/ARBMFEM $
EPTX Copy of EPT except PBARL and PBEAML records are replaced by
equivalent PBAR and PBEAM records
PBRMS Table of intermediate arbitrary beam data.
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.
Main Index
IFP9 1261
Creates PBAR and PBEAM Bulk Data entry records
Example:
See the example in the module description of “IFP” on page 1244.
Main Index
1262 IFP10
Converts IFP tables for topology optimization
Construct new GEOM2, EPT, and MPT tables based upon data supplied by the
TOPVAR entry for topology optimization.
Format:
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.
Parameter:
Main Index
IFPINDX 1263
Creates an IFP table index keyed by identification number
Format:
IFPINDX /IFPDB $
IFPDB Any table data block output by modules IFP, IFPi, MODEPT,
MODGM2, and MODGM4.
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.
Main Index
1264 IFPBSH2
Check PBUSH2D references for TABLED5 and DEQATN entries
Format:
IFPBSH2 EPT,DIT,DEQATN,DEQIND//S,N,NOGOIFB2 $
Parameters:
Main Index
IFT 1265
Performs an inverse Fourier transform
Format:
IFT UXF,CASECC,TRL,FOL/
UXT,TOL/
IFTM $
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
∞
1 iωt
u i ( t ) = --- ∫ Re [ ũ i ( ω )e ]dω Eq. 4-55
π
0
Main Index
1266 IFT
Performs an inverse Fourier transform
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
NFREQ
1 ·· iω n t m
u i ( t m ) = ---
π ∑ Re C mn ⋅ ũ i ( ω n ) + D mn ⋅ ũ i ( ω n ) e
Eq. 4-56
n = 1
NFREQ
iω t
1 n m
u· i ( t m ) = ---
π ∑ Re iω n { C mn ⋅ ũ i ( ω n ) + D mn ⋅ ũ i ( ω n ) }e Eq. 4-57
n = 1
NFREQ
iω n t m
1 2
u·· i ( t m ) = ---
π ∑ Re – ω n { C mn ⋅ ũ i ( ω n ) }e Eq. 4-58
n = 1
where:
m = 1, 2,...,NTIME
ωn = 2π f ( f = frequency )
n
ũ i ( ω n ) = the complex quantity in the i-th row and the n-th column of UHVF.
Main Index
IFT 1267
Performs an inverse Fourier transform
ωn – ωn – 1 ω n + 1 – ωn
C mn = --------------------------E 2 ( – it m ( ω n – ω n – 1 ) ) + --------------------------- E 2 ( + itm ( ω n + 1 – ω n ) ) Eq. 4-59
2 2
3 3
( ωn – ωn – 1 ) ( ωn + 1 – ω n )
D mn = – ---------------------------------- G ( – itm ( ω n – ω n – 1 ) ) – ---------------------------------- G ( ω n + 1 – ω n ) Eq. 4-60
24 24
–6
( ω n – ω n – 1 ) – ( ω 2 – ω 1 ) < 10 ( ω2 – ω1 )
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
ω = 0, E 2 = 1 ⁄ 2 ). D mn = 0 ).
1 D mn = 0 D mn = 0
C m = function of m , and
special for first, last ω .
2 C mn = 0 C m = (See Eq. 4-57.)
ω n t m = nm∆ωt = 2π -------
nm
Eq. 4-61
N
Main Index
1268 IFT
Performs an inverse Fourier transform
C k = cos ( 2πk ⁄ N )
Eq. 4-62
S k = sin ( 2πk ⁄ N )
Then
iω t
n m
e = C k + iS k Eq. 4-63
where
Mod ( nm )
k = Eq. 4-64
N
iω n t m
e = cos ( ω n t m ) + i sin ( ω n t m ) Eq. 4-65
1 – cos θ θ – sin θ
E 2 ( iθ ) = ----------------------- + i ---------------------- θ ≥ θ 0 Eq. 4-66
1 2 1 2
--- θ --- θ
2 2
2 4 5 5
θ θ θ θ θ
= 1 – ---------- + ------------------------- – + … + i --- – ------------------ + -------------------- – + … θ < θ 0 Eq. 4-67
3⋅4 3⋅4⋅5⋅6 3 3 ⋅ 4 ⋅ 5 3 ⋅ 4…7
G ( iθ ) = 2E 2 ( iθ ) – E 4 ( iθ ) Eq. 4-68
2 3
θ θ
----- – 1 + cos θ ----- – θ + sin θ
2 6
E 4 ( iθ ) = ------------------------------------- + ------------------------------------- θ ≥ θ 0 Eq. 4-69
4 4
θ θ
------ ------
24 24
2 4 3
θ θ θ θ
= 1 – ---------- + ------------------------- – + + i --- – ------------------ + ------------ – + … θ < θ 0
.5
5 5 ⋅ 6 ⋅ 7 5…9
Eq. 4-70
5⋅6 5⋅6⋅7⋅8
θ 0 = 0.1 . The alternating series is continued until the last term computed is less than
–9
10 .
Main Index
IFT 1269
Performs an inverse Fourier transform
··
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
A n ( n = NFREQ – 1, …, 2 ) .
N NFREQ = 0
( ωn – ωn – 1 )
A N = ----------------------------------------------------------------------------------------------------------- Eq. 4-71
2 ( ω n + 1 – ω n – 1 ) – ( ω n + 1 – ω n )A n + 1
··
For each row, do a backward and forward pass. The B n and ũ ( ω n ) can be stored in the
same locations. The backward pass:
B NFREQ = 0
ũ n + 1 – ũ n ũ n – ũ n – 1
6 ------------------------------ – ------------------------------ – ( ω n + 1 – ω n )A n + 1 ⋅ B n + 1
ω n + 1 – ω n ω n – ω n – 1 Eq. 4-72
B N = ---------------------------------------------------------------------------------------------------------------------------------------------------------------
ωn – ωn – 1
n = ( NFREQ – 1 ), …, 3, 2
(real and imaginary)
ũ 2 – ũ 1
6 --------------------- – ( ω 2 – ω 1 )A 2 B 2
·· ω2 – ω1
ũ ( ω 1 ) = ------------------------------------------------------------------------- Real Part Eq. 4-73
6ω 1 + ( ω 2 – ω 1 ) ( 2 – A 2 )
0 Imaginary Part
·· ··
ũ ( n ) = A n ( B n – ũ n – 1 )
Main Index
1270 ILMP1
Creates unit displacement matrix
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:
ILMP1 EST,BGPDT,EDT,EDT0/
CASEUNIT,UNITDISP,UNITPV,EDTM/
S,N,NCOLUNIT $
Parameters:
Main Index
ILMP2 1271
Creates output transformation matrix
Creates the output transformation matrix for a particular OFP table type.
Format:
ILMP2 EDT,OFP12,OFP22,OFP32/
OTMT,RLABEL/
NCOLMNP2 $
Parameters:
Main Index
1272 ILMPGPF
ILMPGPF
Filters the grid point force output table according to the MONPNT3 entries down to a
single monitor point.
Format:
ILMPGPF MP3GPF,EDT,BGPDT,CSTM,OGPFB1/
GPFMAT/
NDDLNAME $
GPFMAT Matrix of monitor point force data where each column is a subcase and
each row is one component of the monitored forces.
Parameter:
Main Index
INDXBULK 1273
Indexes the Bulk Data table
Format:
INDXBULK BULK/BULKINDX $
Parameters:
None.
Remark:
1. INDXBULK only indexes the CORDij, GRID and QSETi records.
Main Index
1274 INPUTT2
Input tables of matrices from a FORTRAN unit
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:
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 $
Parameters:
ITAPE
Action
Value
+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.
Main Index
INPUTT2 1275
Input tables of matrices from a FORTRAN unit
ITAPE
Action
Value
-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.
ITAPE
Tape Label Checked?
Value
+n NO
0 NO
-1 YES
-3 YES
-5 YES
-6 YES
-7 YES
-8 YES
-11 NO
-13 NO
-15 NO
-16 NO
-17 NO
-18 NO
Main Index
1276 INPUTT2
Input tables of matrices from a FORTRAN unit
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”
on page 110 of the MD Nastran 2006 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.
Main Index
INPUTT4 1277
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:
INPUTT4 /M1,M2,M3,M4,M5/NMAT/IUNIT/ITAPE/UNUSED4/BIGMAT $
Mi Matrices
Parameters:
ITAPE Action
0 None.
-1 Rewind IUNIT before read.
-2 Rewind IUNIT at end.
-3 Both.
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.
2. Each real or complex matrix must have been written on IUNIT according to
the format below.
Main Index
• 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 MD 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” on
page 269 of the MD Nastran 2006 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” on page 110
of the MD Nastran 2006 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.
Main Index
5. Factor matrices from DECOMP and DCMP (matrix forms 4, 5, 10, 11, 13, and
15) cannot be processed by INPUTT4.
Main Index
INTERR Generates modal components of base motion from a response spectrum
Format:
INTERR CASECC,DIT,DYNAMIC,ZETAH,FN,SPECSEL,PSI/
UHR/
CLOSE/OPTION $
Parameters:
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:
fi+1 < CLOSE * fi
Main Index
Remark:
Only FN may be purged, in which case INTERR returns.
Main Index
ISHELL Invokes an external program
Format:
ISHELL //PRGNAME/S,N,IRTN/NOINT/NOREAL/NOCMPX/NOCHAR/NOUNIT/
INT1 /INT2 /INT3 /INT4 /
REAL1/REAL2/REAL3/REAL4/
CMPX1/CMPX2/CMPX3/CMPX4/
CHAR1/CHAR2/CHAR3/CHAR4/
IUNIT1/IUNIT2/IUNIT3/IUNIT4 $
Parameters:
Main Index
Remarks:
1. The external program identified by PRGNAME will be passed arguments
from MD 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 MD Nastran's data structures.
2. MD 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 MD Nastran execution.
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
LAMX Eigenvalue Table Editor
Modifies, creates, or converts to matrices the LAMA (real eigenvalues) and CLAMA
(complex eigenvalues) tables.
Formats:
Modify LAMA:
LAMX FREQMASS,/LAMA/NLAM/RESFLG $
LAMX ,,LAMA/LMAT/-1/RESFLG $
LAMX CLAMMAT,/CLAMA/-1 $
LAMX ,,CLAMA/CLAMMAT/-2 $
Generate new LAMA table based on diagonals of a stiffness and mass matrix:
LAMX KXX,MXX/LAMAX,LAMMAT/-3/RESFLG $
Main Index
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.
Number of Modes
R 1j
R 2j 3
R 3j
0
m
j
Main Index
will be extracted from LAMA and modified accordingly:
0
• Frequency: f j = R ij + ( 1.0 + R 2j )f
j
R ( if R > 0 )
3j 3j
• Generalized mass: m j = 0
m j ( if R 3 = 0 )
eigenvalue: λ j = ω 2j
generalized stiffness: K j = λ j m j
• If R3j = – 1 , then mode j is not copied to LAMAX.
• If R1j = 0 , R 2j = 0
and R 3j = 0 , 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.
Number of Modes
fj
0.0 3
mj
Main Index
5
λi ωi f i Mi ki
·
Number of
·
Modes
·
·
4. Under NLAM=-3:
a. The frequency is computed:
diag (KXX)
Freq = 0.5 Pi -----------------------------------
diag (MXX)
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:
Desired
Mode(s) DMl Format for EMAT
Modification
1 through 3 none ---
4 multiply f 4 by 0.8 DMI,EMAT,4,2,-0.2
5 none ---
6 delete DMI,EMAT,6,3,-1.0
7 replace f 7 by DMI,EMAT,7,1,173.20,-1.0
173.20
Main Index
Desired
Mode(s) DMl Format for EMAT
Modification
8 replace m 8 by 2.98 DMI,EMAT,8,3,2.98
9 none ---
10 delete DMI,EMAT,10,3,-1.0
Main Index
• Generate a matrix CLAMMAT from a CLAMA table.
The DMAP is:
LAMX, ,CLAMA/CLAMMAT/-2 $
Main Index
LANCZOS Performs real eigenvalue analysis
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:
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 $
Main Index
QG Single-point constraint forces of constraint matrix in the g-set.
QMG Multipoint constraint forces of constraint matrix in the g-set.
Parameters:
Main Index
2 Summary output.
3 Detailed output on cost and convergence.
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.
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.
Main Index
LCGEN Expands Case Control table based on LSEQ Bulk Data entries
Expands the Case Control table based on LSEQ Bulk Data entries.
Format:
LCGEN CASECC,SLT,ETT,DYNAMIC,GEOM4/
CASESX/
NSKIP/APP $
Parameters:
Main Index
'TRANRESP' Transient response -- use TLOADi record.
‘REIG’ Real eigenvalue analysis -- use both RLOADi and
TLOADi record.
Main Index
LMATPRT Prints combined design sensitivity/constraint matrix
Format:
LMATPRT DSCMR,DSROWL,DSCOLL//
DSZERO $
Parameter:
Main Index
1296 MACOFP
Creates FORTRAN file containing OFP module output
Creates a FORTRAN file containing selected output normally printed by the OFP
module.
Format:
MACOFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7//
ITAPE/IUNIT/UNUSED3 $
OFPi Any table that is suitable for printing by the OFP module.
Parameters:
Main Index
MAKAEFA 1297
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:
MAKAEFA EDT,MATPOOL,AECTRL,AEBGPDTJ*,AEBGPDTI*,AEBGPDTK*/
AEDWIDX,UXVW,AEDW,AEIDW,AEPRSIDX,UXVP,AEPRE,
AEIPRE,AEFIDX,UXVF,AEFRC/
MACHNO/SYMXZ/SYMXY $
Main Index
1298 MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries
Parameters:
Remarks:
None.
Main Index
MAKAEFS 1299
Generates an index and associated matrices
Generates an index and the associated matrices based on the AEFORCE Bulk Data
entry with MESH='STRUCT'.
Format:
MAKAEFS EDT,AECRTL,SLT,PG/
AEDBIDX,UXVST,PGVST,PVPERQ/
MACH/SYMXZ/SYMXY $
Parameters:
Remarks:
None.
Main Index
1300 MAKAEMON
Creates hinge moment (HM) monitor points
Format:
MAKAEMON AERO,EDT,AEMONOLD/
AEMONPT,MONITOR/
AECONFIG $
Parameters:
Remarks:
None.
Main Index
MAKCOMP 1301
Extracts components from EDT
Format:
MAKCOMP EDT,AECOMP,AECMPOLD/
AEROCOMP
/
STRUCOMP
MESH $
Parameters:
Remarks:
None.
Remarks:
None.
Main Index
1302 MAKENEW
Converts tables from pre-Version 69 to Version 69 (or greater) format
Converts tables from their pre-Version 69 format to their Version 69 (or greater)
format.
Format:
MAKENEW OLDDB1,OLDDB2,OLDDB3,OLDDB4,OLDDB5/
NEWDB1,NEWDB2,NEWDB3,NEWDB4,NEWDB5/
OLDNAM1/OLDNAM2/OLDNAM3/OLDNAM4/OLDNAM5
NEWNAM1/NEWNAM2/NEWNAM3/NEWNAM4/NEWNAM5 $
Parameters:
Remarks:
Main Index
MAKENEW 1303
Converts tables from pre-Version 69 to Version 69 (or greater) format
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.
Main Index
1304 MAKEOLD
Converts tables from Version 69 (or greater) to pre-Version 69 format
Converts tables from their Version 69 (or greater) format to their pre-Version 69
format.
Format:
MAKEOLD NEWDB1,NEWDB2,NEWDB3,NEWDB4,NEWDB5/
OLDDB1,OLDDB2,OLDDB3,OLDDB4,OLDDB5/
NEWNAM1/NEWNAM2/NEWNAM3/NEWNAM4/NEWNAM5/
OLDNAM1/OLDNAM2/OLDNAM3/OLDNAM4/OLDNAM5 $
Parameters:
Remarks:
1. The allowable values for NEWNAMi and OLDNAMi are:
Main Index
MAKEOLD 1305
Converts tables from Version 69 (or greater) to pre-Version 69 format
MAKEOLD AXIC,GEOM1,,,/OAXIC,OGEOM1,,,/
'AXIC'/'GEOM1'///'AXIC'/'GEOM1' $
Main Index
1306 MAKETR
Generates transformation matrix for support point degrees-of-freedom
Generates transformation matrix to transform forces from the support point degrees-
of-freedom to the reference point.
Format:
MAKETR AERO,CSTMA,BGPDT,USET,TRX/
TR,PRBDOFS,URDDIDX,URDDUXV,TRANTR/
AUNITS $
Main Index
MAKETR 1307
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 $
Main Index
1308 MAKMON
Builds table of monitor points
Format:
AEROCOMP
MAKMON EDT, , /
STRUCOMP AEROCOMP
AEMONPT
,MONDISP,MONGRP,MP3LAB,MP3GPF/MKERRCHK $
MONITOR
Parameter:
Main Index
MASSCOMB 1309
Adds family of mass matrices
Adds together a family of mass matricies controlled by the MASSET Bulk Data and
CASECC commands.
Format:
MASSCOMB EDT,MGG*/
MGGCOMB/
MASSETID/MASSQUAL $
Parameters:
Example:
PARAML CASECC/'SET'/1/453//S,N,MASSSET
DBVIEW MGIN=MHH WHERE(MASSID=*) $
MASSCOMB EDT,MGIN/MHH/MASSSET $
Main Index
1310 MATGEN
Matrix generator
To generate different kinds of matrices for subsequent use in other matrix operation
modules.
Format:
MATGEN T/MAT/P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P13 $
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:
MATGEN ,/MAT/1/P2/P3/P4 $
Main Index
MATGEN 1311
Matrix generator
Parameters:
P2 Order of matrix.
P3 Skew flag. If nonzero, generate a skew-diagonal matrix.
P4 Precision (1 or 2). If zero, use machine precision.
Example:
Generate a real 10 x 10 identity matrix:
MATGEN ,/I10X10/1/10 $
Option P1 = 2
Generates an identity matrix trailer.
Format:
MATGEN ,/MAT/2/P2 $
Parameters:
P2 Order of matrix.
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 $
Main Index
1312 MATGEN
Matrix generator
Option P1 = 3
Generate a data block of prescribed size.
Format:
MATGEN ,/DB/3/P2 $
Parameters:
Option P1 = 4
Generate a pattern matrix.
Format:
MATGEN ,/MAT/4/P2/P3/P4/P5/P6/P7/P8/P9 $
Parameters:
P2 Number of columns.
P3 Number of rows.
P4 Precision.
P5 Number of values in nonzero string.
Main Index
MATGEN 1313
Matrix generator
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.
P9
P7-1 P7-1
P8-1 P8-1
P5 P5
P5 ... P5
.
.
P3 P6-1 P6-1
P6-1 P6-1
P5 P5
...
P5 P5 .
. .
. .
. .
.
. .
Remark:
{ P2
Examples:
1. To generate a 10 x 10 diagonal matrix with the column number in each
diagonal position, code:
MATGEN ,/DIAG/4/10/10/0/1/10/1/1/10 $
Main Index
1314 MATGEN
Matrix generator
0
0
1
0
0
[ ASTRIP ] = 1
0
0
1
0
0
1
3. Generate a 5x5 matrix with nonzero values in its lower triangle:
MATGEN ,/LOW/4/5 /5 / / / /2 /1 /5 $
0 0 0 0 0
1 0 0 0 0
[ LOW ] = 1 2 0 0 0
1 2 3 0 0
1 2 3 4 0
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 $
Main Index
MATGEN 1315
Matrix generator
Parameters:
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 ≤ 0, the time of day (seconds past
midnight) will be used.
P6 Output-integer-mean of all random numbers multiplied by 100,000.
Option P1 = 6
Generate a partitioning vector for use in PARTN or MERGE.
Format:
MATGEN ,/CP/6/P2/P3/P4/P5/P6/P7/P8/P9/P10 $
None.
Parameters:
P2 Number of rows.
P3, P5, P7, P9 Number of rows with zero coefficients.
P4, P6, P8, P10 Number of rows with unit coefficients.
Remarks:
10
1. If ∑ Pi < P2, then the remaining terms contain zeros.
i=3
10
2. If ∑ Pi > P2, then the terms are ignored after P2.
i=3
Main Index
1316 MATGEN
Matrix generator
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:
MATGEN ,/MAT/7/P2/P3/P4/P5 $
Parameters:
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.
Example:
Generate a 20 row by 15 column null matrix.
MATGEN ,/N20X15/7/20/15 $
Option P1 = 8
Generate a matrix from equations based on its indices. The matrix is in single
precision.
Format:
MATGEN ,/MAT/8/P2/P3/P4/P5/P6 $
Main Index
MATGEN 1317
Matrix generator
Parameters:
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
C ( ν1 ) = ( ν2 ) ( ν1 ) is integer; ( ν2 ) is real
Main Index
1318 MATGEN
Matrix generator
The equation used to determine the coefficient of the (l,J)th term of the output matrix
is:
AT (I,J) = [ C1 ⋅ I + C2 ⋅ J + C3 ⁄ I + C4 ⁄ J +
I I
C5 ⋅ C6 + C7 ⋅ ( p, C )8 + C9 ⁄ ( I + J – 1 ) +
–I –J
C10 ⋅ C11 + C12 ⋅ C13 ]+ – 1 [ D1 ⋅ I +
I J
D2 ⋅ J + D3 ⁄ I + D4 ⁄ J + D5 ⋅ D6 + D7 ⋅ D8 +
–1 –J
D9 ⁄ ( I + J – 1 ) + D10 ⋅ D11 + D12 ⋅ D13 ]
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.
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 3 9 1.0
MATGEN AB/M3/8//100/200/2/1 $
For HILBERT (I,J) = 1.0 ⁄ ( I + J – 1 ) ; I, J = 1, 10 :
MATGEN AB/HILBERT/8//10/10/3 $ 3RD RECORD
Main Index
MATGEN 1319
Matrix generator
Option P1 = 9
Generate a transformation between external and internal sequence matrices for g-set
size matrices.
Format:
MATGEN EQEXIN/TRANS/9/P2/P3 $
Parameters:
Examples:
Transform a g-set size vector UGV to external sequence.
MATGEN EQEXIN/INTEXT/9//LUSET $
MPYAD INTEXT,UGV,/UGVEXT/1 $
By default in SOLs 1 through 200, PARAM, OLDSEQ is -1, which means this operation
is not required.
Main Index
1320 MATGEN
Matrix generator
Option P1 = 10
Not used.
Option P1 = 11
Generate a rectangular matrix, driven by USET table.
Format:
MATGEN USET/MAT/11/P2/P3/////////SET1/SET2 $
Parameters:
Remark:
1. If P2 ≠ 1 , 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.
Main Index
MATGEN 1321
Matrix generator
Option P1 = 12
Generate a rectangular matrix of prescribed properties.
Format:
MATGEN ,/MAT/12/P2/P3/P4/P5/P6/P7/P8/P9 $
Parameters:
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.
Option P1 = 13
Generate a partitioning vector based on a permutation vector.
Format:
MATGEN CPERM/MPART/13/NEWMSIZ $
Main Index
1322 MATGEN
Matrix generator
Parameters:
NEWMSIZ Input-integer. Only the first NEWMSIZ entries in CPERM are turned
on.
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.
Main Index
MATGPR 1323
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):
MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1$
MATGPR GPL,USET,SIL,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1$
2. For matrices with degrees of freedom that relate to grid, scalar or extra points
(p-set):
MATGPR GPLD,USETD,SILD,MATRIX//COLNAM/ROWNAM/PRNTOPT/
TINY/F1 $
3. For matrices with degrees of freedom that relate to aerodynamic elements
(ks-set):
MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/
TINY/F1 $
4. Print a matrix in the format similar to DISPLACEMENT output with a user-
defined column label and page header.
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 $
Main Index
1324 MATGPR
Degree-of-freedom matrix printer
Parameters:
Option Action
NULL Only null columns will be identified.
ALL Print all nonzero terms in matrix.
ALLP Print numbers converted to
magnitude/phase.
Main Index
MATGPR 1325
Degree-of-freedom matrix printer
Remark:
The supersets formed by the union of other sets have the following definitions:
sets supersets
mp
mr m
sb s
sg
o
q g
ne p
r n
c a d f fe
t
b l
lm
e
k ks
sa
j js
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.
Main Index
1326 MATGPR
Degree-of-freedom matrix printer
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.
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 107:
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' $
Main Index
MATGPR 1327
Degree-of-freedom matrix printer
COLUMN 1
MATRIX GCF
DIRECTION 1
G R O U N D C H E C K F O R C E S ( G - S E T )
Main Index
1328 MATMOD
Matrix modification
Transforms matrix or table data blocks according to one of many options into output
matrix or table data blocks.
Format:
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 $
Parameters:
Main Index
MATMOD 1329
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:
MATMOD I1,,,,,/O1,O2/1/STARTCOL/ENDCOL/COLINC $
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.
Main Index
1330 MATMOD
Matrix modification
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 $
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:
MATMOD I1,,,,,/O1,/2/PURGE/UPLOW/TYPEF/FILTER $
Parameter:
Main Index
MATMOD 1331
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:
MATMOD I1,,,,,/O1,/3/CODE $
Parameter:
Main Index
1332 MATMOD
Matrix modification
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 $
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
MATMOD I1,SIL,,,,/O1,/4 $
Form 2
MATMOD I1,,,,,/O1,/4/LUSET $
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.
Main Index
MATMOD 1333
Matrix modification
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.
Format:
Form 1 (Inserts 6x6 matrix along diagonal)
MATMOD I1,SIL,,,,/O1,/5/LUSET/0 $
MATMOD CSTM,SIL,,,,/01,/5/LUSET/P3 $
Form 3 (Generates a global-to-basic coordinate system transformation matrix)
MATMOD CSTM,SIL,BGPDT,,,/01,/5//-1 $
Parameter:
Main Index
1334 MATMOD
Matrix modification
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.
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 $
Main Index
MATMOD 1335
Matrix modification
Option P1 = 6
Find the maximum absolute value for each row over all columns of a matrix.
Format:
MATMOD I1,,,,,/O1,/6 $
O1 Column vector with terms that represent the absolute maximum over
all columns of I1 for each row.
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:
MATMOD I1,,,,,/O1,/7 $
O1 Column vector with a term that represents the absolute maximum over
all rows of I1 for each column.
Example:
Find the maximum displacement for each loading condition.
MATMOD UG,,,,,/MAXDISP,/7 $
Main Index
1336 MATMOD
Matrix modification
Option P1 = 8
Normalize matrix.
Format:
MATMOD I1,,,,,/O1,/8////S,N,NORMREAL/
S,N,NORMIMAG $
Parameters:
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.
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:
MATMOD I1,,,,,/O1,/9 $
Main Index
MATMOD 1337
Matrix modification
Example:
Find and output maximum transient response.
MATMOD UHT,,,,,/UHTMAX,/9 $
DDRMM CASEXX,UHTMAX,PHIP1,,,,/OUPMAX,,,,/ $
OFP OUPMAX,,,,// $
Option P1 = 10
Convert matrix I1 into its complex conjugate.
Format:
MATMOD I1,,,,,/O1,/10 $
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:
MATMOD LOCVEC,BGPDT,,,,/BGPDTN,/11 $
Main Index
1338 MATMOD
Matrix modification
LOCVEC G-size vector with values that represent grid locations in the basic
coordinate system.
BGPDT Basic grid point definition table.
BGPDTN New BGPDT table with grid point locations that are displaced by
LOCVEC.
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:
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)
Main Index
MATMOD 1339
Matrix modification
Parameters:
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.
MATMOD MGG,BGG,KGG,,,/PARTNULL,/12/S,N,NONULL/3 $
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 $
Option P1 = 13
Copies any data block.
Format:
MATMOD I1,,,,,/O1,/13 $
Main Index
1340 MATMOD
Matrix modification
O1 Copy of I1.
Remark:
COPY module is preferred over this option.
Option P1 = 14
Filter small magnitude terms from a matrix; more capabilities than option 2.
Format:
MATMOD I1,,,,,/O1,/14/PURGE/UPLOW/STRTR/
FILTER/RELFLT/TRUNC $
Parameters:
Main Index
MATMOD 1341
Matrix modification
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 FILTER ≠ 0 or RELFLT < 0, then the absolute filter technique is used.
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:
MATMOD MATIN,EQEXIN,USET,,,/MATPOOLX,/16/PNDMIG/
SORTFLG/TYPOUT////////CCHAR/DMIGNAME/
ROWSETNM/COLSETNM $
Main Index
1342 MATMOD
Matrix modification
Parameters:
Main Index
MATMOD 1343
Matrix modification
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.)
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.
Main Index
1344 MATMOD
Matrix modification
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).
Main Index
MATMOD 1345
Matrix modification
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.
Main Index
1346 MATMOD
Matrix modification
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:
MATMOD EQEXIN,USET,SIL,CASECC,,/CP,/17/UBIT/SETFLG/
S,N,NOCP////////SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
Main Index
MATMOD 1347
Matrix modification
Parameters:
Main Index
1348 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.
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.
The Case Control Section contains:
SET 10 = 1 THRU 50
PARTN = 10
Option P1 = 18
Insert or modify a GEOM3 table temperature record.
Format:
MATMOD GEOM3,GPL,UG,,,/GEOM3T,/18/SID $
Main Index
MATMOD 1349
Matrix modification
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.
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:
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
1350 MATMOD
Matrix modification
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:
MATMOD I1,I2,I3,I4,I5,I6/O1,/20///PRTOPT/S,N,SUM $
Parameter:
Main Index
MATMOD 1351
Matrix modification
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.
MATMOD LD,,,,,/T,LP/21 $
MATMOD LD,,,,,/L,D/21 $
Remarks:
1. Sparse symmetric decomposition forms the equivalent matrix representation
of a symmetric matrix.
T T
[A ] = [P ] [L][D ][ L] [P]
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.
Main Index
1352 MATMOD
Matrix modification
T
[A] = [L][D][L]
where [ L ] is a lower triangular matrix and [ D ] is a diagonal matrix.
The diagonal matrix [ D ] is stored with the lower triangular matrix [ L ] in a
special matrix [ LD ] .
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:
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 $
Option P1 = 22
Generate special aeroelasticity matrix with modified trailers.
Format:
MATMOD MKLIST,Qij,,,,/QijL,/22 $
Option P1 = 23
Determines type of eigenvalue analysis requested and optionally extracts values from
the selected EIGR or EIGRL Bulk Data entry.
Main Index
MATMOD 1353
Matrix modification
Format:
MATMOD CASECC,DYNAMIC,,,,/,/23/
S,N,METHTYP/S,N,LANCZOS/METHFLAGI/S,N,EIGRVALR//
S,N,NFOUND/ICASE/S,N,EIGVALI///S,N,EIGRFLD $
Parameters:
Examples:
1. Determine method type on the EIGR entry:
Main Index
1354 MATMOD
Matrix modification
MATMOD CASECC,DYNAMIC,,,,/,/23/S,N,METHTYP $
IF ( METHTYP=1 ) THEN $
MESSAGE //' LANCZOS OR SINV IS SELECTED.' $
ELSE $
MESSAGE //' GIVENS OR HOUSEHOLDER IS SELECTED.' $
ENDIF $
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:
MATMOD I1,I2,I3,,,/O1,/24/S,N,NOOUT/NMATX/S,N,NRNENC $
O1 Square matrix that has a 1.0 at the intersection of every null row and
null column of I1, I2, and I3 simultaneously.
Parameters:
Remark:
Any two input matrices may be purged.
Main Index
MATMOD 1355
Matrix modification
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:
MATMOD I1,I2,I3,,,/O1,O2/25/S,N,NOOUT/NMATX/
S,N,NRNENC///S,N,SYM $
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.
Parameters:
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
1356 MATMOD
Matrix modification
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.
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:
MATMOD I1,,,,,/O1,/27 $
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.
Main Index
MATMOD 1357
Matrix modification
Example:
DMIIN DMI,DMINDX/A3,,,,,,,,, $
MATMOD A3,,,,,/A6,/27 $
0. 0. 0. 0.
0. 2. 0. 0.
0. 0. 3. 0.
0. 0. 0. 4.
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:
MATMOD I1,,,,,/O1,/28 $
O1 Symmetric matrix (form 6) with terms of the first column of I1 along the
diagonal and off-diagonal terms set to zero.
Example:
MATMOD B,,,,,/BDIAG,/28 $
If B is the matrix
1. 2.
3. 4.
Main Index
1358 MATMOD
Matrix modification
1. 0.
0. 3.
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:
MATMOD I1,I2,I3,I4,I5,I6/,/30/BBLK/EBLK $
Parameters:
Option P1 = 31
Writes the bit map of a matrix to the punch file.
Format:
MATMOD MAT,,,,,/,/31/MAXSIZ $
Parameter:
Main Index
MATMOD 1359
Matrix modification
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:
MATMOD TXY,,,,,/TOUT,/32/CONVERT $
TOUT DRMH1 directory table in table data block format or DTI format.
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:
MATMOD FOL,,,,,/FOLMAT,/33 $
Main Index
1360 MATMOD
Matrix modification
Parameters:
None.
Option P1 = 34
Extract the real and imaginary parts of complex matrix into two real matrices.
Format:
MATMOD CMAT,,,,,/RMAT,IMAT/34//PREC $
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.
Format:
MATMOD IM,,,,,/
SORTLIST,SORTBOOL/S,N,P1/COLNUM/S,N,PRESORT/
SORTOPT/// NKEYS $
IM Any matrix.
Main Index
MATMOD 1361
Matrix modification
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.
Parameters:
Remark:
For complex matrices, only SORTOPT=2 or -2 is allowed.
Example:
Given the input matrix, IM, generate an algebraic ascending order sort. The input
matrix and its sorted order (algebraically ascending) are:
Main Index
1362 MATMOD
Matrix modification
– 2.0
0.0
IM = – 1.0
4.0
1.0
0.0
P1=35 $
MATMOD IM,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////2 $
1.0
3.0
2.0
LIST =
6.0
5.0
4.0
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
P1=35 $
MATMOD IM,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////1 $
then the output matrix LIST for NKEYS=1 could contain either
1.0
3.0
6.0
LIST =
2, 0
5.0
4.0
or
Main Index
MATMOD 1363
Matrix modification
1.0
3.0
2.0
LIST =
6.0
5.0
4.0
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:
MPYAD BOOL,IM,/IMS/1 $
producing the sorted IM matrix, IMS, as
– 2.0
– 1.0
0.0
IMS =
0.0
1.0
4.0
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.
Main Index
1364 MATMOD
Matrix modification
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:
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASECCR/
36/GRIDSET/S,N,NOGEOM1/M36OPT///ELEMSET/MSGLVL/PCHSET $
MATMOD GEOM1,CASECC,,,,/
GEOM1R,/
36/GRIDSET/S,N,NOGEOM1 $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
,/
36/GRIDSET//1///ELEMSET/MSGLVL/PCHSET $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/2///ELEMSET//PCHSET $
Format for M36OPT=3: Generate point set from element set and grid set
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.
Main Index
MATMOD 1365
Matrix modification
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 $
IFPINDX /GEOM1 $
MATMOD GEOM1,CASECC,,,,/GEOM1R,/36/
GRIDSET/S,N,NOGEOM1 $
3. We recommend 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 point set of all points touched by the elements contained in the
ELEMSET Case Control set.
b. Verify that all points in the set generated above are present in the
GRIDSET Case Control set. 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.
Main Index
1366 MATMOD
Matrix modification
c. Verify that all points in GRIDSET are present in the set generated in a.
Issue a warning message for points in GRIDSET that are not present.
d. If no inconsistency is detected and GEOM1R is specified then run
M36OPT=0 also.
5. M36OPT=2 ensures a consistent point set for the input element set and the
actions are:
a. Create a point set of all points touched by the elements contained in the
ELEMSET Case Control set. Create a Case Control set with an id =
GRIDSET. Load the ELEMSET set and the GRIDSET set into CASER.
b. Using the CASER as input, run M36OPT=0 to create the GEOM1R.
6. M36OPT=3 ensures a consistent point set for the input element set and
allows additional points to be added to the set and the actions are:
a. Create a point set of all points touched by the elements contained in the
ELEMSET Case Control set.
b. Copy the ELEMSET to CASER. Create a Case Control set of the point set
generated in a.
c. Locate the GRIDSET set in CASECC and merge the set created in a. into
it. If GRIDSET set does not exist on CASECC, simply store the OELMSET
generated grid list as the GRIDSET set ID on output data block #2,
CASECCN. Otherwise, copy the merged gridset set to the aCASECCN
output data block.
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 $
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points and indexed by the IPRINDX module. See Remark.
CASECC Table of Case Control command selections.
Main Index
MATMOD 1367
Matrix modification
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. We 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.
Format:
MATMOD EST,CASECC,,,,/ESTR,/38/
ELEMSET/GRIDSET/S,N,NOEST $
Main Index
1368 MATMOD
Matrix modification
EST Table of Bulk Data entry images related to geometry and indexed by
the IFPINDX module. See Remark.
CASECC Table of Case Control command selections.
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 $
2. We recommend that GEOM2 be converted by the SECONVRT module and
then used as input to MATMOD.
Option P1 = 39
Remove and identify explicit zero terms in a matrix.
Format:
MATMOD I1,,,,,/O1,O2/39/S,N,NOXPLZER $
Main Index
MATMOD 1369
Matrix modification
I1 Any matrix.
Parameter:
Option P1 = 40
Replace the value of, or add a value to, a single term in a matrix.
Format:
MATMOD I1,,,,/O1,/
40/ICOL/IROW/TYPE/REAL//NCOL/NROW/
////////REALD/CMPLX/CMPLXD $
O1 Modified I1 matrix.
Parameters:
Main Index
1370 MATMOD
Matrix modification
Example:
In matrix A, add 10.5 to the value at column 2 and row 3:
MATMOD A,,,,,/A1,/40/2/3/-1/10.5 $
Option P1 = 41
Reorder the rows of a rectangular matrix.
Format:
MATMOD GRDRM,I1,,,,/O1,/41 $
Parameters:
None.
Option P1 = 42
Permute a sparse square matrix.
Main Index
MATMOD 1371
Matrix modification
Format:
MATMOD GRDRM,I1,,,,/O1,/42 $
Parameters:
None.
Option P1 = 43
Not implemented.
Option P1 = 44
Creates EQEXIN table based on g-set partitioning vector.
Format:
MATMOD EQEXIN,VG,,,,/EQEXINR,/44 $
Parameters:
None.
Option P1 = 45
Permute matrix according to a row permutation.
Main Index
1372 MATMOD
Matrix modification
Format:
MATMOD I1,RPERM,,,,/O1,/45/PERMOPT $
O1 Permuted matrix.
Parameter:
Option P1 = 46
Convert a sparse partial decomp matrix into a regular matrix datablock.
Format:
MATMOD KTTP,,,,,/KTTS,/46/NOOSET $
Parameter:
Example:
Main Index
MATMOD 1373
Matrix modification
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 $
Option P1 = 47
Perform null row search on a matrix.
Format:
MATMOD I1,,,,,/O1,/47 $
I1 Any matrix.
O1 Column vector which has 1.0 at those rows I1 has null rows. If I1 is the
O1 is purged. If I1 is null, then O1 will be full.
Main Index
1374 MATOFP
Prints matrix similar to DISPLACEMENT output
Format:
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' LAMA
'FREQRESP' FOL
'TRANRESP' TOL
'CEIGEN' CLAMA
'BKL1' BLAMA
'NLST' COMB
'USERLIST' 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.
Main Index
MATOFP 1375
Prints matrix similar to DISPLACEMENT output
Parameters:
Main Index
1376 MATOFP
Prints matrix similar to DISPLACEMENT output
Examples:
Example 1:
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
Example 2:
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 ’/’)’ $
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 )
Main Index
MATPCH 1377
Punches contents of matrix data blocks
Punches the contents of matrix data blocks onto DMI Bulk Data entries.
Format:
MATPCH I1,I2,I3,14,I5//IVNIT/N1/N2/N3/N4/N5 $
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.
Main Index
1378 MATPCH
Punches contents of matrix data blocks
Example:
Let the data block MAT contain the matrix
1 2 3 4 5 6 7 8 9 10
DMI MAT 0 2 1 2 5 6
* 3 2.000000E 00 5 3.000000E 00
* 5.000000E 00
* 7.000000E 00 5 8.000000E 00
Main Index
MATPRN 1379
General matrix printer
Format:
MATPRN M1,M2,M3,M4,M5//PRTFORM $
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 DIAG 30 is set by the DIAGON function before MATPRN (see Example 3),
and turned off after MATPRN, 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//$
Main Index
1380 MATPRT
Matrix printer
Prints a matrix.
Format:
MATPRT MATRIX//PRNTLABL/PRNTFLAG $
MATRIX Matrix data block to be printed. If [X] is purged, then nothing is done.
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// $
Main Index
MATREDU 1381
Reduces square matrix from g-set to a-set or p-set to d-set
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:
XAA
, XSF , XSS /
XDD
NOXGG
S,N, $
NOXPP
Main Index
1382 MATREDU
Reduces square matrix from g-set to a-set or p-set to 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.
Parameters:
Method:
The damping matrices [ B gg ] and [ K gg
4 ] are reduced to the a-set by the MATREDU
B nn B nm
[ B gg ] ⇒
B mn B mm
T T
[ B nn ] = [ G mn ] [ B mn G mn + B mn ] + [ B mn ] [ G mn ] + [ B nn ]
B ff B fs
[ B nn ] ⇒
B sf B ss
B aa B ao
[ B ff ] ⇒
B oa B oo
T T
[ B aa ] = [ G oa ] [ B oo G oa + B oa ] + [ B oa ] [ G oa ] + [ B aa ]
Main Index
MATREDU 1383
Reduces square matrix from g-set to a-set or p-set to d-set
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.
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
1384 MCE1
Creates multipoint constraint transformation matrix
Format:
MCE1 USET,RMG,KGG/
GM $
Parameters:
None.
Method:
The multipoint constraint equations, R mg , formed in the GP4 module, are partitioned
by the MCE1 module (Multipoint Constraint Eliminator -- Phase 1) as follows:
[ R mg ] = R mm R mn
[ R mm ] [ G mn ] = – [ R mn ]
Main Index
MCE2 1385
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 $
Parameters:
Method:
The MCE2 module partitions the stiffness matrix
Main Index
1386 MCE2
Performs multipoint constraint elimination and reduction
K nn K nm
[ K gg ] = Eq. 4-20
K mn K mm
T T
[ K nn ] = [ G mn ] [ K mm G mn + K mn ] + [ K mn G mn + K nn ] Eq. 4-21
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 to K nn .
Main Index
MCFRAC 1387
Compute, sort and print modal contribution fractions
Format:
MCFRAC CASECC,LAMA,OL,BGPDT,RPH,UH,PVMCFR,MODSELT/
OMCF1,UNUSED/
APP/FMODE $
Parameters:
Main Index
1388 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.
Main Index
MDATA 1389
Computes pressures for selected elements associated with virtual fluid mass
MDATA Computes pressures for selected elements associated with virtual fluid
mass
Computes pressures for selected elements associated with virtual fluid mass.
Format:
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.
Parameters:
Main Index
1390 MDATA
Computes pressures for selected elements associated with virtual fluid mass
Method:
1. Calculate the accelerations. This depends on the approach.
Type of
APP Arithmetic ua
2 2
REIG Real U a = – ω u a ( ω from LAMA )
CEIG Complex 2
U a = p u d ( ρ from CLAMA )
FREQ Complex 2
U a = – ω u d ( ω from FOL )
f e = M ea U a
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.
Main Index
MDCASE 1391
Partitions the Case Control table
Partitions the Case Control table into separate Case Control tables based on the
ANALYSIS Case Control command.
Format:
CASECC EDOM
MDCASE , , /
CASEXN CASECC
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 $
Main Index
1392 MDCASE
Partitions the Case Control table
Parameters:
Main Index
MDCASE 1393
Partitions the Case Control table
Main Index
1394 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
Main Index
MDENZO 1395
MDACMS matrix utility
Format:
MDENZO I1,I2,I3,I4,I5,I6/
O1,O2,O3/
MDOPT/IP1/IP2/SETNAM/RP1/RP2 $
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:
MDENZO KXX,MDMAP,,,/KOO,KOT,GOTMAP/0/SEID $
Option MDOPT=1:
Extracts the o-set partition of a load matrix based on MDMAP and SEID.
Main Index
1396 MDENZO
MDACMS matrix utility
Format:
MDENZO PX,MDMAP,,,/PO,,/1/SEID $
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:
MDENZO PHQ,GOQ,ORDER,,/PHQI,,/2/NDOM $
Option MDOPT=3:
Find UT (and PVEC) for SEID as SEID goes back "up the tree"
Extract UT from family UO.
Format:
MDENZO GOTMAP,MDMAP,GOT,UO,GOQUQ,MDSPARSE/
UT,PVEC,UOI/3/SEID/P2 $
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 UOF,MDMAP,,,/PHI,,/4// $
Main Index
MDENZO 1397
MDACMS matrix utility
Option MDOPT=5:
Take the partition vector RECVEC and determine which SEIDs you need to recover
and write to RECMAP.
Format:
MDENZO RECVEC,MDMAP,,,/RECMAP,,/5// $
Option MDOPT=6:
Decide whether SEID is in RECMAP or not. If yes, OUTYN = 1 else OUTYN = .
Format:
MDENZO RECMAP,,,,/,,/6/SEID/OUTYN/ $
Option MDOPT=7:
Perform matrix reduction: XTT1 = GTO*XOO*GOT
Format:
MDENZO XOO,GOT,,,/XOOGOT,XTT1,/7/OUTYN/ $
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:
MDENZO XOT,GOT,,,/XTTA,XTTB,/8/OUTYN $
Both XOT and GOT must be real.
Set OUTYN to +1. Else set it to -1.
Main Index
1398 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:
MDENZO XOO,GOT,XOT,XTTBAR,/XOOGOT,XTT,/9/OUTYN $
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:
MDENZO PG,,,,/PGRI,VEC1,VEC2/10 $
Option MDOPT=11:
Find the best GE in K4FF so that its removal will result in a sparser K4NEW = K4FF -
GEBAR*KFF
Format:
MDENZO KFF,K4FF,,,/K4NEW,,/11/S,N,GEBAR///RP1/RP2 $
Main Index
MDENZO 1399
MDACMS matrix utility
Format:
MDENZO PF,MDMAP,,,/PFAM,,/12 $
Format:
MDENZO KFF,,,,,/KFFSYM,,/13 $
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 MBKXX,BGPDT,USET,VGFS,,/MBKXX1,,/14 $
Main Index
1400 MDISUTIL
Broadcasts multiple data blocks between slave and master processors
Format:
MDISUTIL DB1,DB2,DB3,DB4,DB5,DB6,DB7,DB8,DB9,
DB10,DB11,DB12,DB13,DB14,DB15/
DBOUT1,DBOUT2,DBOUT3,DBOUT4,DBOUT5,DBOUT6,DBOUT7,
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.
Parameters:
Remarks:
MDISUTIL calls option 10 of the DISUTIL module.
Main Index
MERGE 1401
Matrix merge
Format:
MERGE A11,A21,A12,A22,CP,RP/A/SYM/TYPE/FORM $
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.
Main Index
1402 MERGE
Matrix merge
A ij of [ A ] for which CPj ≠ 0.0 and RP i = 0.0 in the same order as they appear
in [ A ] . Partition [ A21 ] will consist of all elements A ij of [ A ] for which CPj = 0.0
and RPi ≠ 0.0 in the same order as they appear in [ A ] . The following describes
the operations:
Main Index
MERGE 1403
Matrix merge
4. Any or all of [A11], [A12], [A21], [A22] may be purged. When all are purged,
this implies [A] = 0.
5. Both { RP } and { CP } may not be purged.
Examples:
1. Let A11, A12, A21, A22, {CP} and {RP} be defined as follows:
1.0
0.0
( CP ) =
1.0
1.0
0.0
( RP ) = 0.0
1.0
Main Index
1404 MERGE
Matrix merge
[ A11 ] = 1 2 [ A12 ] = 3
5 6 7
[ A21 ] = 9 10 [ A22 ] = 11
1 2 3
[A] = 5 6 7
9 10 11
Main Index
MERGEOFP 1405
Merges linear and nonlinear stress output
Merges OESL (linear element stresses from SDR2) with OESNL (nonlinear element
stresses from SDRNL).
Format:
MERGEOFP OES1,OESNL1/OES1X $
OES1X Table of linear and nonlinear element stresses in the SORT1 and linear
element format.
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.
Main Index
1406 MESSAGE
Prints messages
Format:
MESSAGE T1/T2/P1/P2/.../Pn $
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 MD 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 $
offset = 150704034 $
Main Index
MESSAGE 1407
Prints messages
Main Index
1408 MGEN
Creates virtual fluid mass matrices
Format:
MGEN CASECC,MATPOOL,EST,CSTM,BGPDT/
MCHI,MLAM,GEG,MAR,MCHI2,MLAM2/
LUSET/S,N,NOMGEN/UNUSED3/WTMASS/UNUSED5 $
Parameters:
Main Index
MKCNTRL 1409
Assembles a description of aerodynamic controllers sets
Format:
MKCNTRL EDT,CSTMA,AEBGPDT/
AECTRL,TRX,AECSTMHG/
SYMXZ/AUNITS $
Parameters:
Remarks:
None.
Main Index
1410 MKCSTMA
Merge coordinate system tables; usually tables from structural and aerodynamic
Merge coordinate system tables; usually tables from structural and aerodynamic
models.
Format:
MKCSTMA CSTM1,CSTM2/CSTMM $
Parameters:
None.
Main Index
MKMNTIFP 1411
Updates geometry, connectivity, and properties
Format:
MKMNTIFP BGPDT,CSTM,MONITOR,ECT,EPT,MPT/
GEOM1X,GEOM2X,EPTX,MPTX/
YOUNGM $
Parameters:
Main Index
1412 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:
MKRBVEC BGPDT,CSTM,AEROCOMP/
RBF/
COORID/REF1/REF2/REF3/COMPNAME/CDOM/INDDOF $
RBF Matrix (g-set by 6) representing the geometric rigid body mode of the
points in the BGPDT about the origin of motion.
Parameters:
Main Index
MKSPLINE 1413
Generates splines to interpolated results from structural to aero model
Generates splines to interpolated results from the structural model to the aero model.
Format:
MKSPLINE EDT,CSTMA,AEGRID,AECOMP,ECT,AEBOX/
SPLINE $
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with
external grid identification numbers.
Parameters:
None.
Example:
Excerpt from subDMAP PHASE0.
DBVIEW AEGRID=BGPDTS WHERE (MODLTYPE='AEROMESH' AND WILDCARD) $
MKSPLINE EDT,CSTMA,AEGRID,AECOMP/SPLINE $
Main Index
1414 MODACC
OFREQ and OTIME command processor
Removes columns in solution and load matrices based on the OTIME and OFREQ
Case Control commands.
Format:
MODACC CASECC,OL,U,P1,P2,P3/
OL1,U1,P11,P21,P31/APP/S,N,MDCEQV $
Parameter:
Main Index
MODACC 1415
OFREQ and OTIME command processor
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
f = ω ⁄ 2π .
2. Here are typical data block names and the appropriate value of APP:
MODACC CASEM,LAMA,PHA,,,/
LAMA2,PHA1,,,/APP/S,N,MDCEQV $
EQUIVX LAMA/LAMA2/MDCEQV $
EQUIVX PHA/PHA1/MDCEQV $
Main Index
1416 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 $
Parameters:
Main Index
MODENRGY 1417
Computes modal energies
Format:
MODENRGY CASECC,OL,UH,KHH,MHH,MODSELT/
TSNRGY,TKNRGY,MODSELT1,OL1,MSNRGY,MKNRGY/
APP/FMODE/UNUSED $
Main Index
1418 MODENRGY
Computes modal energies
Parameters:
Main Index
MODEPF 1419
Computes fluid-structure mode participation factors
Format:
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 $
Main Index
1420 MODEPF
Computes fluid-structure mode participation factors
Parameters:
Main Index
MODEPF 1421
Computes fluid-structure mode participation factors
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.
Main Index
1422 MODEPOUT
Filter, sort, and printout mode participation factor matrice
Format:
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 1423
Filter, sort, and printout mode participation factor matrice
Parameters:
Main Index
1424 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 1425
Updates PACABS and PACABR Bulk Data entry records
Updates PACABS and PACABR Bulk Data entry records based upon data on
TABLEDi Bulk Data entry records.
Format:
MODEPT EPT,DIT/EPTX/S,N,NOGOMEPT $
EPTX Copy of EPT except PACABS and PACABR entries are updated with
TABLEij references.
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.
Main Index
1426 MODGDN
Updates geometry table for existence of p-elements and superelements
Updates the geometry table for the existence of p-elements and superelements.
Format:
MODGDN GEOM1,SEMAP,MFACE,MEDGE,MBODY/
GEOM1P/
S,N,NOSEMAP $
GEOM1P Table of Bulk Data entry images related to geometry updated for
p-elements and superelements.
Parameter:
Main Index
MODGM2 1427
Create table entries for PLPLANE and PLSOLID Bulk Data
MODGM2 Create table entries for PLPLANE and PLSOLID Bulk Data
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:
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 $
Main Index
1428 MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
Parameter:
Main Index
MODGM2 1429
Create table entries for PLPLANE and PLSOLID Bulk Data
Remarks:
1. MODGM2 must appear after the IFP.
2. The following GEOM2 Bulk Data entry records are replaced by the internal
records in GEOM2X:
Main Index
1430 MODGM2
Create table entries for PLPLANE and PLSOLID Bulk Data
Example:
See the example in the IFP module description.
Main Index
MODGM4 1431
Reads SPCs and SPCDs and generates unique SPC and SPCD records
MODGM4 Reads SPCs and SPCDs and generates unique SPC and SPCD
records
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:
MODGM4 CASECC,GEOM2M,GEOM4M,DEQATN,DEQIND,DIT,BGPDTM,EPT/
GEOM4P/
GNSTART/S,N,MODGM4/ALTSHAPE/S,N,NSWELM/SWEXIST/
RGDEXIST $
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.
Parameters:
Main Index
1432 MODGM4
Reads SPCs and SPCDs and generates unique SPC and SPCD records
Main Index
MODQSET 1433
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
Format:
MODQSET GEOM1,GEOM2,GEOM4/
GEOM1W,GEOM2W,GEOM4W/
NOQSETT/QSETREC/QSETID $
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.
Parameters:
Main Index
1434 MODQSET
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
Main Index
MODTRK 1435
Reorders eigenvalues and eigenvectors to be consistent with previous design cycle
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:
MODTRK CASECC,EDOM,R1TABR,LAMA,MGG,MAA,PHG,PHA,PHGREF,
PHAREF/MTRAK,LAMA1,PHG1,PHA1,PHGREF1,PHAREF1/
DESCYCLE/S,N,NOTRACK $
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
1436 MODTRK
Reorders eigenvalues and eigenvectors to be consistent with previous design cycle
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.
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 $
Main Index
MODTRL 1437
Modify trailer
Format:
MODTRL DB//P1/P2/P3/P4/P5/P6 $
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:
Main Index
1438 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
ADD5 SINGLE,,,,/DOUBLE $
• Double to single
PUTSYS(1,55) $
ADD5 DOUBLE,,,,/SINGLE $
PUTSYS(2,55) $
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
ADD REAL,/CMPLX//(0.,1.) $
• Complex to real
MATMOD CMPLX,,,,,/REAL,/34 $
Main Index
MODUSET 1439
Modifies the degree-of-freedom set membership table (USET)
Format:
MODUSET EDITVEC,USET/
USETM/
USETOP/MAJOR/SET0/SET1/USETADD/UNUSED6/UNUSED7 $
Parameters:
Main Index
1440 MODUSET
Modifies the degree-of-freedom set membership table (USET)
Remark:
1. EDITVEC may be purged if USETOP ≠ ′FILTER′ .
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'/
Main Index
MODUSET 1441
Modifies the degree-of-freedom set membership table (USET)
Main Index
1442 MONVEC
Forms monitor point rigid body vectors
Format:
Parameters:
None.
Main Index
MONVEC3 1443
Process type 3 monitor points
Format:
MONVEC3 MP3LAB,STRUCOMP,BGPDT,CSTM,KDICT/
KDICT3*,MN3VEC* $
Parameters:
None.
Main Index
1444 MPP
Prints monitor point results
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:
MPSIR,MPSRP,MP2S,MPSERP,UXV,INDX//
MACH/Q/AECONFIG/SYMXY/SYMXZ/MESH $
Main Index
MPP 1445
Prints monitor point results
Parameters:
Examples:
1. Print structural monitor point loads at trim.
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
1446 MPPTRAN
Prints monitor point data for frequency response aeroelasticity
Format:
MPPTRAN CASECC,MPDB,OL,MAT1,MAT2,MAT3,MAT4//MATTYPE/MONTYPE $
Parameters:
Remarks:
None.
Main Index
MPYAD 1447
Matrix multiply and add
Perform the multiplication of two matrices and optionally, the addition of a third
matrix to the product.
T
[ X ] = ±[ A ] [ B ] ±[ C ]
Format:
MPYAD A,B,C/X/
T/SIGNAB/SIGNC/PREC/FORM/DODMP/DMPYIN/DMPYOUT $
X Matrix product.
Parameters:
T = 0, perform [ A ] [ B ]
Main Index
1448 MPYAD
Matrix multiply and add
Remarks:
1. If no matrix is to be added, [ C ] must be purged. [ A ] may be Form 3.
2. [ A ] and [ B ] may be the same data block, but both must be different from [ C ] .
3. If [ A ] or [ B ] ] is purged, and [ C ] is purged, then [X] is purged. [ A ] may not be
Form 3.
4. If [ A ] and/or [ B ] is purged, but [ C ] exists, the purged matrices are
equivalent to null matrices, and [X] will be output.
5. [ X ] 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.
Main Index
MPYAD 1449
Matrix multiply and add
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.
MPYAD
Storage Keyword
Method
Technique 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
1450 MPYAD
Matrix multiply and add
Storage Selection
Method
Submethod 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
Main Index
MPYAD 1451
Matrix multiply and add
Storage Selection
Method
Submethod Value
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
1452 MPYAD
Matrix multiply and add
• 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:
MPYAD Storage
Keyword Technique
1048592 Transpose C
1048588 Nontranspose E
192512 Both
Examples:
1. [ X ] = [ A ] ( [ B ] + [ C ] )
MPYAD A,B,C/X/ $
T
2. [ X ] = [ A ] [ B ] – [ C ]
MPYAD A,B,C/X/1//-1/ $
3. [ X ] = – [ A ] [ B ]
MPYAD A,B,/X//-1 $
Main Index
MRGCOMP 1453
Merges two existing aerodynamic or structural component tables
Format:
MRGCOMP COMP1,COMP2/
COMP/
COMPRPLC $
Parameter:
Remark:
Duplicate component names will cause a fatal message to be issued unless
COMPRPLC is true.
Main Index
1454 MRGCSTM
Merges families of coordinate system defintion tables (CSTM)
Format:
MRGCSTM CSTM1*,CSTM2*,CSTM3*,CSTM4*,CSTM5*/
CSTMX/S,N,NOCSTMX $
Parameter:
Remark:
None.
Main Index
MRGMON 1455
Merges two monitor point tables
Format:
MRGMON MON1,MON2,SZR1,SZR2/
MON,SZR/
MONRPLC $
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.
Main Index
1456 MSGHAN
Passes message number for processing by MSGPOP API
Passes the message number of a message for processing by the MSGPOP API.
Format:
MSGHAN //MSGNUM/MSGINP1/MSGINP2/S,N,MSGOUT $
Parameters:
Main Index
MSGSTRES 1457
Computes data based on fields generated by MSGMESH
Computes grid point stresses, maximum and minimum stresses, and stress contour
plots based on fields generated by MSGMESH.
Format:
MSGSTRES FORCE,OES1X//
S,N,PLTNUM/NOMSGSTR $
Parameters:
Main Index
1458 MTRXIN
Converts DMIG entries to matrices
Converts matrices input o DMIG Bulk Data entries to matrix data blocks.
Format:
Form 1 -- Simplified (CASECC is purged).
EQEXIN
,,MATPOOL, ,,/
EQDYN
MTRXIN
NAME1,NAME2,NAME3,NAME4,NAME5/
LUSET
/S,N,NONAME1/S,N,NONAME2/S,N,NONAME3/
LUSETD
S,N,NONAME4/S,N,NONAME5 $
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).
EQEXIN
MTRXIN CASECC,MATPOOL, ,, /
EQDYN TFPOOL
K2GG,M2GG,B2GG
,K42GG,A2GG /
K2PP,M2PP,B2PP
LUSET
/S,N,NOK2/S,N,NOM2/S,N,NOB2/S,N,NOK42/
LUSETD
1
S,N,NOA2/ $
0
Form 3 -- Case Control Command selection of load (or rectangular) matrix (IOPT=2).
MTRXIN CASECC,MATPOOL,EQEXIN,,/
P2G,,,,/
LUSET/S,N,NOP2G/////2 $
Form 4 -- Selection of DMIK, DMIJ and DMIJI by data block names MATKi, MATJi,
and MATJIi.
Main Index
MTRXIN 1459
Converts DMIG entries to matrices
AEBGPDTK
MTRXIN ,,MATPOOL, AEBGPDTJ ,, /
AEBGPDTI
S,N,LKSET 3
S,N,LJSET /S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/// 4 $
S,N,LISET 5
Form 5 -- Selection of stiffness, mass, damping, and loads (or square) matrices by
MATNAMi, etc. input parameter values (IOPT=10 through 12).
EQDYN TFPOOL
MTRXIN CASECC,MATPOOL, EQEXIN ,, /
EQEXIN
LUSETD
LUSET /S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/
LUSET 10
S,N,NOMAT4/S,N,NOMAT5/ 11 /
12
MATNAM1/MATNAM2/MATNAM3/MATNAM4/MATNAM5/
TFLID
NFEXIT/MATID1/MATID2/MATID3/MATID4/MATID5 $
Form 6 -- Selection of DMIK, DMIJ, and DMIJI matrices by the MATNAMi input
parameter values (IOPT=13 through 15).
Main Index
1460 MTRXIN
Converts DMIG entries to matrices
AEBGPDTK
MTRXI ,,MATPOOL, AEBGPDTJ ,,/
N AEBGPDTI
MATK1 MATK2 MATK3
MATJ1 , MATJ2 , MATJ3 ,,/
MATI1 MATI2 MATJ3
S,N,LKSET 13
S,N,LJSET /S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/// 14 /
S,N,LISET 15
MATNAM1/MATNAM2/MATNAM3 $
Main Index
MTRXIN 1461
Converts DMIG entries to matrices
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.
Parameters:
Main Index
1462 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 $
Main Index
MTRXIN 1463
Converts DMIG entries to matrices
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 $
ADD KGG,STIFF/KGGNEW $
EQUIVX KGGNEW/KGG/ALWAYS $
ENDIF $
IF (NOMASS > -1) THEN $
ADD MGG,MASS/MGGNEW $
EQUIVX MGGNEW/MGG/ALWAYS $
ENDIF
Main Index
1464 NASSETS
Combines all element sets for MSGMESH, and sets defined on SET1
NASSETS Combines all element sets for MSGMESH, and sets defined on SET1
Format:
NASSETS CASECC,ELSET,EDT/
SET/
MESHSET $
Parameter:
Main Index
NDINTERP 1465
Nonlinear interpolator
Nonlinear interpolator.
Format:
NDINTERP CONTVXV,CONTVX/
IFACT,CONTDIF/
NSUPD/MINNUSE/MAXNUSE/STOL $
Parameters:
Main Index
1466 NEWUSET
Creates USET table for matrix-based ACMS
Creates a USET table for the matrix-based ACMS (automatic component mode
synthesis) method.
Format:
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.
Parameters:
Main Index
NLCOMB 1467
Consolidates tables related to nonlinear elements and applied loads
Consolidates tables related to nonlinear elements and applied loads for the current
nonlinear analysis iteration.
Format:
NLCOMB CASECC,ESTNL,KDICTNL,BKDICT,ETT,PTELEM0,PTELEM,UNUSED8,
MPT,EQEXIN,SLT,DLT,BGPDT,APPLOD,DYNAMIC/
SLT1
ELDATA, ,GPTT1/
DLT1
NSKIP/LSTEP/LINC/STATIC/LGDISP/OSTEP/NEWSTEP/TSTATIC/ $
Main Index
1468 NLCOMB
Consolidates tables related to nonlinear elements and applied loads
Parameters:
Main Index
NLHARM 1469
Computes forces and derivatives of forces in Fourier space
Format:
NLHARM HUDI,MFCDISP,MFCVELO,NLPART,NLFTAB,UNUSED6,DIT/
HPNLDIX,HDFDDIX,UNUSED3/
DFFLAG/UVAFLAG/UNUSED3/UNUSED4/DELTA/FREQ/UNUSED7 $
Parameters:
Main Index
1470 NLHARM
Computes forces and derivatives of forces in Fourier space
Main Index
NLICLOOP 1471
Prepares data for the NLIC run in SOL 400
Format:
NLICLOOP CASECC,NLRSMP//STPPRV/S,N,ICLOOP $
Parameters:
Main Index
1472 NLITER
Computes nonlinear analysis solution matrices and tables
Format:
Main Index
NLITER 1473
Computes nonlinear analysis solution matrices and tables
Main Index
1474 NLITER
Computes nonlinear analysis solution matrices and tables
Parameters:
Main Index
NLITER 1475
Computes nonlinear analysis solution matrices and tables
Main Index
1476 NLITER
Computes nonlinear analysis solution matrices and tables
Main Index
NLITER 1477
Computes nonlinear analysis solution matrices and tables
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.
Main Index
1478 NLITER
Computes nonlinear analysis solution matrices and tables
Main Index
NLRSLOOP 1479
Prepare data for nonlinear restarts.
Format:
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 $
Parameters:
Main Index
1480 NLRSLOOP
Prepare data for nonlinear restarts.
Main Index
NLRSMAP 1481
Creates the nonlinear restart map
Format:
NLRSMAP CASEXX,NLRSMAP0/
NLRSMAP/UNUSED/UNUSED/
STIMER/SOLCURR/STEPCUR/SUBCUR/
NSKIPR/SOLPREL/NEWSTEP/STIMES $
NLRSMAP Nonlinear restart map from the restart step augmented with the
current output time step.
Parameters:
Main Index
1482 NLRSMAP
Creates the nonlinear restart map
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 1483
Solves nonlinear static and transient response
Solves nonlinear static and transient response with an adaptive time increment for a
given iteration.
Format:
Main Index
1484 NLSOLV
Solves nonlinear static and transient response
Main Index
NLSOLV 1485
Solves nonlinear static and transient response
Main Index
1486 NLSOLV
Solves nonlinear static and transient response
Parameters:
Main Index
NLSOLV 1487
Solves nonlinear static and transient response
Main Index
1488 NLSOLV
Solves nonlinear static and transient response
Main Index
NLSOLV 1489
Solves nonlinear static and transient response
<0 No.
>-0 Yes.
MNEWK Input/output-integer-default=1. Matrix update flag for 3D contact.
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
Main Index
1490 NLSOLV
Solves nonlinear static and transient response
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
NLTRD 1491
Computes transient nonlinear analysis solution matrices and tables
Format:
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,ITERID/
S,N,MU/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/
S,N,NOTIME/MAXLP/UNUSED17/UNUSE18/UNUSE19/
TABS/LANGLE $
Main Index
1492 NLTRD
Computes transient nonlinear analysis solution matrices and tables
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.
Parameters:
Main Index
NLTRD 1493
Computes transient nonlinear analysis solution matrices and tables
Main Index
1494 NLTRD
Computes transient nonlinear analysis solution matrices and tables
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.
Main Index
NLTRD2 1495
Computes transient nonlinear analysis solution matrices and tables
Format:
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,PSFL/
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,NBIS/
MAXLP/TSTATIC/LANGLE/NDAMP/TABS/
SIGMA/NORADMAT/S,N,ADPCON/PBCONT/
S,N,NBCONT/FKSYMFAC/WTMASS/NOUDCMP $
Main Index
1496 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
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.
Main Index
NLTRD2 1497
Computes transient nonlinear analysis solution matrices and tables
Parameters:
Main Index
1498 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
Main Index
NLTRD2 1499
Computes transient nonlinear analysis solution matrices and tables
Main Index
1500 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.
Main Index
NLTRLG 1501
Produces time independent load vector
Format:
NLTRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,GMD,GOD,
PHDH,EST,MPT,APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
PDT,TMLD,DLT1/TABS $
Main Index
1502 NLTRLG
Produces time independent load vector
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.
Parameter:
Main Index
NORM 1503
Normalize a matrix
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:
NORM A/ANORM/S,N,NCOL/S,N,NROW/S,N,XNORM/IOPT/
S,N,XNORMD/PRTSWM $
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.
Main Index
1504 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 [ CPHG ] T [ CPHG ] 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
Main Index
NSMEPT 1505
Modifies element properties
Format:
NSMEPT ECT,EPT,BGPDT/NEWEPT/S,N,NEWEPT $
Parameters:
Main Index
1506 OFP
Output file processor
Format:
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.
Parameters:
Main Index
OFP 1507
Output file processor
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.
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.
Main Index
1508 OFP
Output file processor
Example:
Print the OUG1 table from the SDR2 module:
OFP OUG1/ $
Main Index
OPTGP0 1509
p-element analysis preprocessor
Preprocesses the input design optimization shape basis vectors for p-element analysis.
Format:
OPTGP0 GEOM1M,GEOM2M,MEDGE,EDOM,UNUSED5,UNUSED6,UNUSED7,
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.
Parameter:
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
1510 ORTHOG
Generates orthonormal set of vectors
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:
ORTHOG A,M/
Q,R/
ORTHOPT/ORTHCON/S,N,ORTHEPS/ORTHREPT/ORTHTOL $
Parameters:
Main Index
ORTHOG 1511
Generates orthonormal set of vectors
Remark:
1. ORTHOG generates an orthonormal set of vectors [ Q ] from a given set of vectors
[A] such that:
[A ] = [Q ][R ]
Main Index
1512 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
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:
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/ADPTEXIT $
Main Index
OUTPRT 1513
Constructs sparse load reduction and sparse data recovery partitioning vectors
Parameters:
Main Index
1514 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
Main Index
OUTPUT2 1515
Output a table or matrix into a FORTRAN readable file
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 MD Nastran run.
Format:
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.
Parameters:
Main Index
1516 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” in Chapter 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:
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.
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
Main Index
OUTPUT2 1517
Output a table or matrix into a FORTRAN readable file
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.
7. The “ASSIGN” on page 43 of the MD 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” on page 110 of the MD Nastran 2006 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” on page 288 of the MD
Nastran 2006 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:
Main Index
1518 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record Length Contents Description
Number
1 1 KEY = 3
2 KEY Date (3 words, month-day-year)
-- integer
3 1 KEY = 7
4 KEY NASTRAN Header (7 words*, One Logical Record
Character-A4)
*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
Main Index
OUTPUT2 1519
Output a table or matrix into a FORTRAN readable file
Physical
Record Length Contents Description
Number
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)
Physical
Record Length Contents Description
Number
9 1 KEY = 2
10 KEY Data Block Name (2 words, Header: Logical.
Character-A4) Record1 of Data Block
11 1 KEY = -1 (EOR)
12 1 KEY = 7
13 KEY NASTRAN Trailer (7 words, Trailer: Logical
integer) Record 2 of Data Block
14 1 KEY = -2 (EOR)
15 1 KEY = 1 (Start new logical record)
16 1 KEY = 0
Main Index
1520 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record Length Contents Description
Number
17 1 KEY = 2. Logical Record
18 KEY Data Block Name (2 words, 3 of Data Block
Character-A4) and data (if any)
19 1 KEY=-3 (EOR).
Physical
Record Length Contents Description
Number
11 1 KEY = 2
12 KEY Data Block Name (2 words, Header: Logical.
Character-A4) Record1 of Data Block
13 1 KEY = 3
14 KEY Nastran Program Version (3
words, Major, Minor, Round,
Character A4)
15 1 KEY = -1 (EOR)
16 1 KEY = 7
17 KEY NASTRAN Trailer (7 words, Trailer: Logical
integer) Record 2 of Data Block
18 1 KEY = -2 (EOR)
19 1 KEY = 1 (Start new logical record)
20 1 KEY = 0
21 1 KEY = 2. Logical Record
22 KEY Data Block Name (2 words, 3 of Data Block
Character-A4) and data (if any)
23 1 KEY=-3 (EOR).
Main Index
OUTPUT2 1521
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number
Length Contents Description
OP2NEW
0 1
20 24 1 KEY=1 (Start new logical record) Logical Record
4 of Table
21 25 KEY Next Logical Record Type=0 for
table record
22 26 1 KEY > 0
23 27 KEY Data
24 28 1 KEY < 0 (EOR)***
25 29 1 KEY = 1 (Start new logical record) Logical Record
5 of Table
26 30 KEY Next Logical Record Type = 0
27 31 1 KEY > 0
28 32 KEY Data
29 33 1 KEY < 0 (EOR)**
. . Repeat Physical Records 25-29 (or Additional
29-33) for Additional Records in Records of
. .
Table Table
. .
n-7 1 KEY = 1 (Start new logical record) Last Logical
Record of
n-6 KEY Next Logical Record Type = 0
Table
n-5 1 KEY > 0
n-4 KEY Data
n-3 1 KEY < 0 (EOR)**
n-2 1 KEY = 1 (Start new logical record) If Last “Next
Logical Record
n-1 KEY Next Logical Record Type = 0
Type" = 0, then
n 1 KEY = 0 (EOF) End-of-Table
* *If more data exists for the column or logical record, then KEY>0 and the physical
records 22, 23, and 24 (or 26, 27, and 28) will be repeated as many times as necessary
to complete the column or logical record.
Main Index
1522 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number
Length Contents Description
OP2NEW
0 1
20 24 1 KEY=1 (Start new logical record)
21 25 KEY Next Logical Record Type Logical Record 4
1 : matrix column (string records) of Matrix=first
2 : factor matrix column
3 : factor matrix
22 26 1 KEY > 0 Number of non-zero First Column
terms in next string in word unit First String
Record
23 27 KEY+1 First non-zero row, followed by
non-zero terms
24 28 1 KEY > 0 Number of non-zero First Column
terms in next string in word unit Second String
Record
25 29 KEY+1 First non-zero row, followed by
non-zero terms.
Repeat String Records 22-23 for
Additional Strings in Column
n-2 1 KEY > 0 Number of non-zero First Column
terms in next string in word unit Last String
Record
n-1 KEY+1 First non-zero row, followed by
non-zero terms.
n 1 KEY<0 (EOR) End of First
Column
Repeat Column/String Records
20 through n for additional
columns in matrix if a column is
null there is no String Record for
that column
Main Index
OUTPUT2 1523
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number
Length Contents Description
OP2NEW
0 1
n 1 KEY=1 (Start new logical record) Null Column
Main Index
1524 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record Length Contents Description
Number
n+1 KEY Next Logical Record Type
(See Record 21 above)
n+2 1 KEY<0 (EOR) End of Null
Column
m-5 1 KEY > 0 Number of non-zero Last Column Last
terms in next string in word unit String Record
m-4 KEY+1 First non-zero row, followed by
non-zero terms
m-3 1 KEY<0 End of Last
Column
m-2 1 KEY=1 (Start new logical
record)TD>
m-1 KEY Next Logical Record type=0 If Last "Next
Logical Record
Type" = 0
m 1 KEY = 0 (EOF) End of Matrix
Physical
Record Length Contents Description
Number
n+1 1 If No Data Blocks Follow, KEY = 0 End-of-Data
(EOD)
11. OUTPUT2 files may be read using three utility subroutines provided in the
utility ("util") directory; see “Building and Using TABTST” on page 273 of
the MD Nastran 2006 Installation and Operations Guide.
Main Index
OUTPUT2 1525
Output a table or matrix into a FORTRAN readable file
These routines in a file called tabtst.f (or.for). These routines are coded in
machine-independent FORTRAN.
Major benefits that result in using this standard interface are:
• Easier initial usage of OUTPUT2. Most users make several errors while
becoming familiar with the formats.
• User code is not burdened/concerned with physical record boundaries.
• Data can be processed in logical groups rather than in a "blast" read mode.
Major limitations include:
• Matrices cannot be processed in this manner.
• Multiple FORTRAN units cannot be simultaneously processed.
• BACKSPACE operations are not permitted.
Following are descriptions and use of the three OUTPUT2 service routines.
Entry
Description
Point
IOPEN Initializes an OUTPUT2 file and read the label (MD Nastran).
Format:
CALL IOPEN(IUN,L)
where IUN = An input integer which specifies the unit number to be
read.
L = An output two-word array (2A4) containing the label written on
the unit (L comes from the third parameter in the DMAP call).
Method:
IOPEN rewinds IUN and reads in the data, title, and label. The keys are
checked. A key check failure results in the message IOPEN BAD KEYX
= XXXX.
Main Index
1526 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Entry
Description
Point
IHEADR Processes the data block name and trailer.
Format:
CALL IHEADR(IUN,NAM,T)
where IUN = As described in IOPEN.
NAM = An output two-word array (2A4) containing the data block
trailer in words two through seven. Word one contains the location in
the DMAP call (101,102, etc.)
Method:
IHEADR reads the name and trailer. It checks KEY lengths. It also
skips the data block header (which unfortunately may contain data for
some/few data blocks). IHEADR must be called for each data block
either immediately after IOPEN or after IREAD signifies an end-of-file.
12. Starting with MSC.Nastran 2004 the OUTPUT2 file transport format has
been enhanced to better delineate the content to allow external applications
to identify version and stride values for IFP class datablocks. The new MD
Nastran keyword for either the NASTRAN statement or RC file inclusion is
OP2NEW and is linked to system cell 403. This is an integer value with a
default of one (1), indicating that the new transport format is used. A value
of zero (0) removes all version information and IFP locate word changes
from the transport file. Modification for version occurs both in the Label
Record and within the Data Block Name record. For more details, see
“Modifications to OUTPUT2 (INPUTT2) Transport Formats” on page 570
of the MSC.Nastran 2004 Release Guide and this guide.
Main Index
OUTPUT2 1527
Output a table or matrix into a FORTRAN readable file
Entry
Description
Point
IREAD Supplies data to the calling program in a logical (as opposed to a
physical) manner.
Format:
CALL IREAD(IUN,ARRY,NARY,IMETH,NT,IRTN)
where IUN is as described in IOPEN.
ARRY is the array into which a record is transmitted.
NARY is an integer input that requests the number of words to be
transmitted. If NARY is zero, no words will be transmitted. If NARY is
negative, the words will be skipped but not transmitted. If (NARY is
greater than the number of words remaining, the remaining words are
processed (skipped or transmitted) and NT is set to this number and
IRTN is set to 1.
IMETH is an integer input that specifies how to proceed through the
logical record. If IMETH = 0, the current logical record is continuously
processed until an end-of-record return (IRTN =1) is given. If IMETH
= 1, the remaining data (if any) at the conclusion of IREAD, in the
current logical record, is skipped.
NT is an integer output value which contains the number of words
transmitted or skipped if IRTN is 1 on return from IREAD.
IRTN is an integer output value which indicates the status on return
from IREAD.
IRTN = 0 Normal return.
IRTN = 1 End of logical record hit while trying to process NARY
words.
IRTN = 2 End-of-file hit for this data block.
Method:
OUTPUT2 physical records are read into a buffer area. These records
are, at most, 2 * BUFFSIZE words long. The current position is
maintained and data is transmitted (or skipped) from the buffer to the
ARRY array. If the MD Nastran logical record spans several physical
FORTRAN records these are transparent (no end-of-record returns) to
the user.
Main Index
1528 OUTPUT4
Output matrices onto a FORTRAN readable file
Format:
OUTPUT4 M1,M2,M3,M4,M5//ITAPE/IUNIT/UNUSED3/BIGMAT/DIGITS $
Mi Matrices. Mi cannot be a factor matrix (forms 4, 5, 10, 11, 13, and 15).
Parameters:
ITAPE Input-integer-default = -1. ITAPE controls the status of the unit before
OUTPUT4 starts to write any matrices as follows:
ITAPE ACTION
0 None.
-1 Rewind IUNIT before Write.
-2 End File and Rewind IUNIT after Write.
-3 Both.
IUNIT Input-integer-no default. The absolute value of IUNIT is the FORTRAN
unit number on which the matrices will be written. If IUNIT is
negative, the sparse output option will be used, which means only
nonzero items in the matrix are written to the unit. IUNIT = 0 is not
recommended. See Remark 1.
UNUSED3 Input-integer-default=1. Unused.
Main Index
OUTPUT4 1529
Output matrices onto a FORTRAN readable file
Remarks:
1. Each matrix will be written on IUNIT as follows:
• Record 1:
Word
Type Meaning
Number
1 Integer Number of columns (NCOL).
2 Integer Number of rows (NR, if BIGMAT=TRUE
then NR < 0).
3 Integer Form of matrix (NF). See Remark 11.
4 Integer Type of matrix (NTYPE). See Remark 11.
5 and 6 Character Name of matrix (2A4 format).
7 Character If ASCII format, then this is the FORTRAN
format specification based on DIGITS
parameter value. If binary format, then this is
blank.
Main Index
1530 OUTPUT4
Output matrices onto a FORTRAN readable file
• Records 2, 3, 4, etc. for nonsparse and binary format, (IUNIT > 0 and binary
format) and repeated for each nonzero column, i=ICOL through NCOL.
Word
Type Meaning
Number
1 Integer Column number (ICOL).
2 Integer Row position of first nonzero term (IROW).
3 Integer Number of words in the column (NW). See
Remark 3.
4 through Real or Column element values, single or double
(NW+3) Complex precision.
• Records 2, 3, 4, etc. for nonsparse and ASCII format, (IUNIT > 0), are
repeated for each nonzero column, ICOL through NCOL. Records 3, 4, etc.,
are also repeated for each group of r values (see DIGITS parameter).
Record Word
Type Meaning
Number Number
2 1 Integer Column number
(ICOL).
2 Integer Row position of first
nonzero term (IROW).
3 Integer Number of words in the
column (NW). See
Remark 3.
3, 4, etc. 1 through NW Real or Column element values,
Complex single or double
precision.
• Records 2, 3, 4, etc. for sparse, binary, and string header format (IUNIT < 0,
and BIGMAT = FALSE).
Word
Type Meaning
Number
1 Integer Column number (ICOL).
2 Integer Zero.
Main Index
OUTPUT4 1531
Output matrices onto a FORTRAN readable file
Word
Type Meaning
Number
3 Integer Number of words in the column (NW). See
Remark 3.
4 through Integer String header (IS)*.
(NW+3)
Real or A string of nonzero values, single or double
Complex precision.
*IS = IROW + 65536(L + 1) where IROW is the row position of the first term
in the string and L is the length of the string, see Remark 3. For example, a
string of six words (see Remark 3) beginning in row 4 has IS=458756. L and
IROW may be derived from IS by:
L = INT(IS/65536) - 1
IROW = IS - 65536(L + 1)
• Records 2, 3, 4, etc. for sparse, binary, and regular string format (IUNIT < 0,
and BIGMAT = TRUE).
Word
Type Meaning
Number
1 Integer Column number (ICOL).
2 Integer Zero.
3 Integer Number of words in the column
(NW). See Remark 3.
4 through Integer Length of string, L, plus 1. See Repeated
(NW+3) Remark 3. for each
string.
Integer Row position of first term in
string (IROW).
Real or A string of nonzero values, single
complex or double precision.
• Records 2, 3, 4, etc. for sparse, ASCII, and string header format (IUNIT < 0,
and BIGMAT = FALSE) are repeated for each nonzero column. Records 3
and 4 are repeated for each string, and record 4 is also repeated for each
group of r values (see DIGITS parameter).
Main Index
1532 OUTPUT4
Output matrices onto a FORTRAN readable file
Record Word
Type Meaning
Number Number
2 1 Integer Column number (ICOL).
2 Integer Zero.
3 Integer Number of words in the
column (NW). See Remark 3.
3 1 Integer String header (IS)*.
4 1 through NW Real or A string of nonzero values,
Complex single or double precision.
• Records 2, 3, 4, etc. for sparse, ASCII, and regular string format (IUNIT < 0,
and BIGMAT = TRUE) are repeated for each nonzero column. Records 3 and
4 are repeated for each string and record 4 is also repeated for each group of
r values (see DIGITS parameter).
Record Word
Type Meaning
Number Number
2 1 Integer Column number (ICOL).
2 Integer Zero.
3 Integer Number of words in the
column (NW). See Remark 3.
3 1 Integer Length of string, L, plus 1.
See Remark 3.
2 Integer Row position of first term in
string (IROW).
4 1 through NW Real or A string of nonzero values,
Complex single or double precision.
2. A record with the last column number plus +1 and at least one value in the
next record will be written on IUNIT.
3. The number of words in the column, NW (or string, L), is the number of
elements in the column (or string) times the number of words per type.
Number of words per type is given in the table below. For example, a column
with seven real double precision elements is 14 words long.
Main Index
OUTPUT4 1533
Output matrices onto a FORTRAN readable file
Number of
Type
Words
1 -- Real single precision 1
2 -- Real double precision 2
3 -- Complex single precision 2
4 -- Complex double precision 4
Main Index
1534 PARAML
Sets parameters from a data block
Format:
PARAML DB/DBNAME/P1/S,N,P2/S,N,P3/S,N,P4/S,N,P5/S,N,P6/
S,N,SET1/S,N,F1/S,N,SET2/S,N,F2/
S,N,SET3/S,N,F3/S,N,SET4/S,N,F4/
S,N,SET5/S,N,F5/S,N,SET6/S,N,F6/
S,N,SET7/S,N,F7/S,N,SET8/S,N,F8/
S,N,SET9/S,N,F9/S,N,SET10/S,N,F10/
S,N,SET11/S,N,F11/S,N,SET12/S,N,F12 $
DBNAME Any data block. Used only when P1 = ‘NAME’; otherwise DBname
must not be specified.
Parameters:
Main Index
PARAML 1535
Sets parameters from a data block
Option P1 = ‘BULK’
Check for the presence of Bulk Data entry records by examining the trailer bits of its
IFP module related table.
Format:
PARAML IFPDB//'BULK'//////
BULKNM1/S,N,BULKFG1/BULKNM2/S,N,BULKFG2/
BULKNM3/S,N,BULKFG3/BULKNM4/S,N,BULKFG4/
BULKNM5/S,N,BULKFG5/BULKNM6/S,N,BULKFG6/
BULKNM7/S,N,BULKFG7/BULKNM8/S,N,BULKFG8/
BULKNM9/S,N,BULKFG9/BULKNM10/S,N,BULKFG10/
BULKNM11/S,N,BULKFG11/BULKNM12/S,N,BULKFG12 $
IFPDB Table with trailer bits indicating existence of Bulk Data entry records.
Parameters:
Remark:
To determine which table contains BULKNMi, see “Data Blocks” in Chapter 2.
Example:
Check for the presence of the rigid elements.
PARAML GEOM4//'BULK'//////'RBE1'/S,N,RBE1/'RBE2'/S,N,RBE2/
'RBE3'/S,N,RBE3/'RROD'/S,N,RROD/'RBAR'/S,N,RBAR/
'RTRPLT'/S,N,RTRPLT/'RSPLINE'/S,N,RSPLINE $
Formats:
Extract the computer’s vendor name:
PARAML //’COMPVEND’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Main Index
1536 PARAML
Sets parameters from a data block
PARAML //’COMPMODL’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Extract the computer’s operating system:
Parameter:
:
Remarks:
1. The CHARi values may be best displayed with:
MESSAGE //CHAR1/CHAR2/CHAR3/CHAR4 $
Option P1 = ‘DMI’
Extract an element from a matrix.
Format:
PARAML MAT//’DMI’/ICOL/IROW/S,N,REAL/
S,N,NROW/S,N,IMAG $
Main Index
PARAML 1537
Sets parameters from a data block
Parameters:
Remark:
1. If IROW is greater than the number of rows in the matrix, then NROW will
be set to the number of rows and REAL and IMAG will be set to zero.
Example:
Obtain the value in column 6, row 11 of matrix KGG and save in parameter TERM.
PARAML KGG//’DMI’/6/11/S,N,TERM/S,N,NOKGG $
Option P1 = ‘DTI’
Extract a real, integer, complex, or character value from a table.
Format:
PARAML TAB//’DTI’/S,N,RECNUM/S,N,WRDNUM/
S,N,REAL/S,N,INTGR/S,N,IMAG/S,N,CHAR/
S,N,RECNEW//S,N,INTNEW $
Parameters:
Main Index
1538 PARAML
Sets parameters from a data block
Remark:
1. If RECNUM is greater than the number of records in table, then RECNUM is
set to -1. All other parameters remain unchanged.
2. If WRDNUM is greater than the number of words in RECNUM record, then
WRDNUM is set to -1. All other parameters remain unchanged.
3. If RECNUM = -1, then the WRDNUM-th word in all records will be scanned
for a nonzero value. If any exist, then INTGR will be set to -1.
4. If RECNUM = -2, then all records will be scanned for changes in the value of
the WRDNUM-th word. If the value changes then INTGR will be set to -1.
Examples:
1. Extract the frequencies from FRL.
TYPE PARM,,I,,KNT $
TYPE PARM,,LOGI,,LPFLG=TRUE $
DO WHILE ( LPFLG ) $
KNT=KNT+1 $
PARAML FRL//'DTI'/1/S,N,KNT/S,N,FREQ $
IF ( KNT>-1 ) THEN $
MESSAGE //' FREQ='/FREQ $
.
.
.
ELSE
LPFLG=FALSE $
ENDIF $
ENDDO $
2. Test for an SPCFORCE Case Control command in any subcase. According to
“Data Blocks” in Chapter 2, SPCFORCE requests are declared in word 135
of the CASECC data block.
PARAML CASECC//’DT1’/-1/135//S,N,SPCREQ $
Option P1 = ‘DTI2’
Extract double precision load factor stored in two consecutive words of the ESTNL
data block and truncate to single precision.
Main Index
PARAML 1539
Sets parameters from a data block
Format:
PARAML ESTNL//'DTI2'/S,N,RECNUM/S,N,WRDNUM/S,N,REAL $
Parameters:
Remarks:
1. This option is so far only applicable to the load factor stored in the ESTNL
data block.
2. If RECNUM is greater than the number of records in table, then RECNUM is
set to -1. All other parameters remain unchanged.
3. If WRDNUM is greater than the number of words in RECNUM record, then
WRDNUM is set to -1. All other parameters remain unchanged.
Example:
Extract load factor in words 5 and 6 of the header record.
PARAML ESTNL//'DTI2'/0/5/S,N,FACT $ LOAD FACTOR
Option P1 = ‘DTI2C’
Extract character value stored in two consecutive words.
Format:
PARAML TAB//'DTI2C'/S,N,RECNUM/S,N,WRDNUM//
S,N,INTGR//S,N,CHAR2 $
Main Index
1540 PARAML
Sets parameters from a data block
Parameters:
Remarks:
1. If RECNUM is greater than the number of records in table, then RECNUM is
set to -1. All other parameters remain unchanged.
2. If WRDNUM is greater than the number of words in the RECNUM-th
record, then WRDNUM is set to -1. All other parameters remain unchanged.
3. If RECNUM = -1, then the WRDNUM-th word in all records will be scanned
for a nonzero value. If any exist, then INTGR will be set to -1.
4. If RECNUM = -2, then all records will be scanned for changes in the value in
the WRDNUM-th word. If the value changes, then INTGR will be set to -1.
Example:
Extract the K2PP Case Control DMIG name specification words 139 and 140 of the
Case Control data block.
PARAML CASECC//'DTI2C'/1/139////S,N,K2PP $
Option P1 = ‘IMATCH’
Search for a specific integer value in a table record.
Format:
PARAML TAB//'IMATCH'/RECNUM/IVALUE/S,N,FOUND $
Parameter:
Main Index
PARAML 1541
Sets parameters from a data block
Example:
Search for value of HINDEX in record 1 of KVAL table.
HINDEX = HINDEX +1 $
PARAML KVAL//'IMATCH'/HINDEX//S,N,NOKVAL $
Option P1 = ‘NAME’
Return the name and purge status of a data block.
Format:
PARAML /DBNAME/'NAME'////S,N,NODB//S,N,NAME $
Parameters:
NODB Output-integer. Set to -1 if the data block is purged, and +1 if the data
block is present.
NAME Output-character. Name of the data block. Set to blank if data block is
purged.
Remarks:
1. This option is useful for checking to see if the data block is purged on the
CALL statement(s) in the calling subDMAP(s).
2. If DBNAME is specified on the SUBDMAP statement, then NAME is the
name appearing on the corresponding CALL statement. This process is
repeated until the DBNAME no longer appears on a SUBDMAP statement.
Example:
Check the name and purge status of the MAA matrix.
PARAML /MAA/'NAME'////S,N,NOMAA//S,N,MAANAM $
Option P1 = ‘NULL’
Test for a null matrix.
Main Index
1542 PARAML
Sets parameters from a data block
Format:
PARAML MAT//'NULL'//S,N,FULLMAT//S,N,NULLMAT $
Parameters:
Example:
Determine if data block PG is null.
PARAML PG//'NULL'////S,N,NOPG $
Option P1='PARAM'
Check for the presence of a parameter PVT table.
Format:
PARAML PVT//'PARAM'/////
PARAM1/S,N,NOPARM1/PARAM2/S,N,NOPARM2/
PARAM3/S,N,NOPARM3/PARAM4/S,N,NOPARM4/
PARAM5/S,N,NOPARM5/PARAM6/S,N,NOPARM6/
PARAM7/S,N,NOPARM7/PARAM8/S,N,NOPARM8/
PARAM9/S,N,NOPARM9/PARAM10/S,N,NOPARM10/
PARAM11/S,N,NOPARM11/PARAM12/S,N,NOPARM12 $
Parameters:
Main Index
PARAML 1543
Sets parameters from a data block
Remark:
1. The PVT table is output by the IFP and PVT modules.
Example:
Check for the presence of PARAM,AUTOSPC.
PARAML PVT//'PARAM'//////'AUTOSPC'/S,N,NOAUTOSP $
Option P1 = ‘PRESENCE’
Test for the presence (existence) of a data block.
Format:
PARAML DB//'PRESENCE'////S,N,NODB $
Parameter:
Remark:
See “DBSTATUS” on page 982 module description for alternative options.
Example:
Test for the existence of the KGG data block.
PARAML KGG//'PRESENCE'////S,N,NOKGG $
Option P1='SET'
Extract elements of a SET defined in Case Control.
Format:
PARAML CASECC//'SET'/S,N,RECNUM/S,N,WRDNUM/S,N,REAL/
S,N,INTGR//S,N,CHAR/S,N,SETKNTR $
Main Index
1544 PARAML
Sets parameters from a data block
Parameters:
Example:
Extract the members of the sample Case Control command:
K2GG=MATA MATB MATC
(Word 338 in CASECC contains the internal set identification number for K2GG.)
PARAML CASECC//'SET'/1/338////S,N,MATNAM/S,N,SETKNTR $
Option P1=’TABDEL’
Delete a group of words in a record, the trailing portion of a record, or the entire
record in a table.
Format:
PARAML TABIN/TABOUT/’TABDEL’/
RECNUM/WORDNUM//NWORDS $
Main Index
PARAML 1545
Sets parameters from a data block
Parameters:
Remark:
1. The usage implies that the use of WORDNUM=0 and WORDNUM=-1 will
both result in the deletion of the entire record number RECNUM.)
PARAML TABIN/TABOUT/’TABINSR’//
RECNUM/WORDNUM/REAL $
PARAML TABIN/TABOUT/’TABINSI’//
RECNUM/WORDNUM//INTEG $
Main Index
1546 PARAML
Sets parameters from a data block
PARAML TABIN/TABOUT/’TABINSC’/
RECNUM/WORDNUM////CHAR $
PARAML TABIN/TABOUT/’TABINS2C’/
RECNUM/WORDNUM////CHAR $
Parameters:
Main Index
PARAML 1547
Sets parameters from a data block
PARAML TABIN/TABOUT/’TABREPR’/
RECNUM/WORDNUM/REAL $
PARAML TABIN/TABOUT/’TABREPI’/
RECNUM/WORDNUM//INTEG $
PARAML TABIN/TABOUT/’TABREPC’/
RECNUM/WORDNUM////CHAR $
PARAML TABIN/TABOUT/’TABREP2C’/
RECNUM/WORDNUM////CHAR $
Parameters:
Main Index
1548 PARAML
Sets parameters from a data block
Remarks:
1. It is the programmer’s responsibility to ensure that the type of word that is
being replaced is the same as the type of word that is replacing it. The
program does not check for this condition.
Option P1 = ‘TRAILER’
Extract a value from the trailer of a data block.
Format:
PARAML DB//'TRAILER'/WRDNUM/S,N,TVALUE/S,N,REAL/
S,N,USETBIT/SETNAME $
Parameter:
Remarks:
1. Meaning of TVALUE:
Main Index
PARAML 1549
Sets parameters from a data block
Examples:
1. Extract the second word of the trailer from the SILS table and save in
LUSETS:
PARAML SILS/'TRAILER'/2/S,N,LUSETS//S,N,NOSILS $
2. Check for the presence of single-point constraints (s-set):
PARAML USET//’TRAILER’////S,N,SINGLE//’S’ $
Option P1 = ‘USET’
Search for a specific integer value in a table record.
Main Index
1550 PARAML
Sets parameters from a data block
Format:
PARAML USET//'USET'/////
SET1/S,N,NOSET1/SET2/S,N,NOSET2/
SET3/S,N,NOSET3/SET4/S,N,NOSET4/
SET5/S,N,NOSET5/SET6/S,N,NOSET6/
SET7/S,N,NOSET7/SET8/S,N,NOSET8/
SET9/S,N,NOSET9/SET10/S,N,NOSET10/
SET11/S,N,NOSET11/SET12/S,N,NOSET12 $
Parameter:
Remark:
See TRAILER option for allowable set names.
Example:
Check for the existence of multipoint constraints (MPCs), rigid elements, and
single-point constraints (SPCs).
PARAML USET//’USET’//////’M’/S,N,NOMSET/’S’/S,N,NOSSET $
Formats:
Extract the program version id number; e.g., ‘2004.0.0’:
PARAML //’VERSID’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Extract the program version label 1; e.g., ‘MD Nastran -- Tier 2’:
PARAML //’VERSID1’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Main Index
PARAML 1551
Sets parameters from a data block
PARAML //’VERSID2’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Extract the program version label 3; e.g., ‘Evalulation System’:
PARAML //’VERSID3’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Extract the program version label 4:
PARAML //’VERSID4’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Extract the program build date:
PARAML //’VERSDATE’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Parameter:
Remarks:
1. The CHARi values may be best displayed with:
MESSAGE //CHAR1/CHAR2/CHAR3/CHAR4 $
Option P1='XYCDB'
Check for the presence of a response types specified on xy plotting commands:
XYPAPLOT, XYPEAK, XYPLOT, XYPRINT and XYPUNCH.
Main Index
1552 PARAML
Sets parameters from a data block
Format:
PARAML XYCDB//'XYCDB'/////
RESP1/S,N,NORESP1/RESP2/S,N,NORESP2/
RESP3/S,N,NORESP3/RESP4/S,N,NORESP4/
RESP5/S,N,NORESP5/RESP6/S,N,NORESP6/
RESP7/S,N,NORESP7/RESP8/S,N,NORESP8/
RESP9/S,N,NORESP9/RESP10/S,N,NORESP10/
RESP11/S,N,NORESP11/RESP12/S,N,NORESP12 $
Parameters:
See “X-Y PLOT Commands” on page 580 of the MSC.Nastran Quick Reference Guide for
a description of the types.
Example:
Check for the presence of the MPCF response type.
PARAML XYCDBS//'XYCDB'//////'MPCF'/S,N,NOMPCF $
Main Index
PARTN 1553
Matrix partition
CP
A11 A12 = 0
[ A ] → RP
A21 A22 ≠ 0
= 0 "" ≠ 0
Format:
PARTN A,CP,RP/A11,A21,A12,A22/SYM/TYPE/Fll/F2l/F12/F22 $
A Matrix to be partitioned.
RP Row partitioning vector -- single precision column vector.
CP Column partitioning vector -- single precision column vector.
Parameters:
Remarks:
1. The operation of PARTN is dependent upon the partitioning vectors, CP and
RP, and the symmetry flag, SYM. The following describes the operations:
Main Index
1554 PARTN
Matrix partition
[A] → A11
A21
Main Index
PARTN 1555
Matrix partition
8. [ A ] → A11 A12
A21 A22
Examples:
1. Let [A], {CP} and {RP} be defined as follows:
1.0
0.0
{ CP } =
1.0
1.0
Main Index
1556 PARTN
Matrix partition
0.0
{ RP } = 0.0
1.0
[ A12 ] = purged
[ A11 ] = 1.0 2.0 3.0 4.0
5.0 6.0 7.0 8.0
1 2 3
4. If [ A ] = 5 6 7 and the DMAP instruction was written as
9 10 11
PARTN A,RP,/A11,A21,A12,A22/-1 $
Main Index
PARTN 1557
Matrix partition
1 2 3
A11 A12
5 6 7 →
A21 A22
9 10 11
Main Index
1558 PCOMB
Combines static loads from upstream superelements
Combines static loads from upstream superelements and the residual structure based
on the CLOAD Bulk Data entry.
Format:
PCOMB CASECC,EDT,SLT,PGUP,PJ/
CVECT,PG1/
NSKIP/S,N,NVECT/MODE $
Parameters:
Remarks:
1. Any input data block except CASEXX may be purged.
Main Index
PCOMB 1559
Combines static loads from upstream superelements
Main Index
1560 PCOPY
Tests parallel copy
Format:
PCOPY INDB/
OUTDB1,OUTDB2,OUTDB3,OUTDB4,OUTDB5,OUTDB6,OUTDB7,
OUTDB8/
PCOPY1/PCOPY2 $
Parameters:
Remark:
PCOPY is a reserved for MSC development purposes and should not be used.
Main Index
PFCALC 1561
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:
Main Index
1562 PFCALC
Participation factors for structure and acoustic applications
Main Index
PFCALC 1563
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).
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
1564 PLOT
Creates a table of plot instructions
Creates a table of plot instructions for undeformed and deformed shapes and then
writes the table to Fortran unit 14.
Format:
PLOT PLTPAR,GPSETS,ELSET,CASECC,BGPDT,
Main Index
PLOT 1565
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.
Main Index
1566 PLTHBDY
Supports plotting of CHBDYi elements
Format:
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.
Parameters:
Main Index
PLTSET 1567
Generates element sets for plotting
Format:
PBGPDT PECT
PLTSET PCDB, ,
BGPDT ECT /
POSTCDB, , GEOM2
ELSET
PLSETMSG,PLTPAR,GPSETS, /
PELSET
S,N,NGP/S,N,JPLOT/ECTYPE $
Main Index
1568 PLTSET
Generates element sets for plotting
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 $
Main Index
PNCHGRP 1569
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:
PNCHGRP //FROMLABL/TOLABEL/IBELONG $
Output Blocks:
None.
Parameters:
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.
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.
Main Index
1570 PNMKGRP
For multi-level DMP; creates a set consisting of one or more (sub)groups.
Format:
PNMKGRP //PLABEL/NSUBGP/GRPSIZ/PIDINI/
INCPID/INCGRP/GPLABEL $
Output Blocks:
None.
Parameters:
Main Index
PNMKGRP 1571
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}:
PNMKGRP //’world’/5/4/1/1/4/’mygroup1’
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}:
PNMKGRP //’world’/5/4/1/5/1/’mygroup2’
3. From the world group of 20 processors, create a set 1 subgroup with processor
identification numbers {1,5,9,13,17}:
PNMKGRP //’world’/1/5/1/4//’masters1’
Main Index
1572 PRESOL
Prepares special tables for the distributed parallel solution
Prepares special tables for the distributed parallel solution using the domain
decomposition method.
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
PRESOL 1573
Prepares special tables for the distributed parallel solution
PJXL Static load matrix for boundary load contribution from the residual
structure.
EQMAPD0 EQMAPD from a prior call to PRESOL.
Parameters:
Main Index
1574 PRESOL
Prepares special tables for the distributed parallel solution
Main Index
PROJVER 1575
Set or query project identification numbers
Format:
PROJVER //PRJVEROP/S,N,PROJNO/S,N,VERSION/S,N,EXISTS $
Parameters:
Main Index
1576 PRTMSG
Prints plotting information messages
Prints user information messages related to plot set definition and plotting.
Format:
PLOTMSG
PRTMSG //PRDMSG $
PLSETMSG
Parameter:
Main Index
PRTPARM 1577
Parameter and DMAP message printer
Prints non-NDDL parameter values and DMAP messages. For NDDL parameters (see
TYPE statement), use the MESSAGE statement.
Format:
PRTPARM //PRTPOPT/PNAME/PRTPSORT/SUBDMAP $
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:
PRTPARM //0/'LUSET' $
Main Index
1578 PRTPARM
Parameter and DMAP message printer
Examples:
PRTPARM // $ Unsorted
PRTPARM ////1 $ Sorted
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
PURGEX 1579
Explicit data block purge
Format:
PURGEX /DB1,DB2,DB3,DB4,DB5/PARM $
Parameter:
PARM Input-integer-default=0.
<0 The data blocks are deleted and marked empty.
<0 No action is taken.
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 $
Main Index
1580 PVT
Sets parameter values
Sets parameter values from Case Control and/or Bulk Data Sections.
Format:
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.
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.
Main Index
PVT 1581
Sets parameter values
• 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.
• 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
1582 RANDOM
Computes functions from frequency response data
Format:
RANDOM XYCDB,DIT,PSDL,OUG2,OPG2,OQG2,OES2,OEF2,CASECC,
OSTR2,OQMG2,RCROSSL,OFMPF2M,OSMPF2M,OLMPF2M,OPMPF2M,
OGPMPF2M,OVG2,OAG2/
PSDF,AUTO,
OUGPSD2,OUGATO2,OUGRMS1,OUGNO1,OUGCRM2,
OPGPSD2,OPGATO2,OPGRMS1,OPGNO1,OPGCRM2,
OQGPSD2,OQGATO2,OQGRMS1,OQGNO1,OQGCRM2,
OESPSD2,OESATO2,OESRMS1,OESNO1,OESCRM2,
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/
S,N,NORAND/RMSINT/DVAFLAG $
Main Index
RANDOM 1583
Computes functions from frequency response data
Main Index
1584 RANDOM
Computes functions from frequency response data
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.
OESCRM2 Table of element stresses 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.
OQMRMS1 Table of multipoint forces of constraint in SORT1 format for the RMS
function.
Main Index
RANDOM 1585
Computes functions from frequency response data
Parameters:
Main Index
1586 RANDOM
Computes functions from frequency response data
Method:
Overview
S ab ( f ) = ( x + iy )F K ( f ) Eq. 4-22
where:
a = subcase ID of the excited load set.
b = subcase ID of the applied load set ( a ≤ b ) .
x, y = complex number such that if a = b , then y must be 0.0.
K = table identification number of a TABRND1 Bulk Data
entry that defines F ( f ) , a power spectral density as a
tabular function of frequency.
The power spectral density for gust turbulence can also be supplied on a
TABRNDG entry.
2
2 2L 1 + 2 ( p + 1 ) ( kwL ⁄ U )
S ab ( f ) = W g ------ ---------------------------------------------------------------- Eq. 4-23
U 2 p+3⁄2
[ 1 + ( kwL ⁄ U ) ]
Main Index
RANDOM 1587
Computes functions from frequency response data
2
S ja ( f ) = U j ( f ) S aa ( f ) Eq. 4-24
d. These are summed over all loads to form the power spectral density
function
S ja ( f ) = ∑ S ja ( f ) Eq. 4-25
a
N–1
1 1 ⁄ 2
q j = --- ∑ [ ( S j ( f i ) + S j ( f i + 1 ) ) ] ( f i + 1 – f i ) Eq. 4-26
2
i = 1
where N = number of frequencies.
The mean response is output with both the PSDF and the autocorrelation
function.
The zero crossing N 0 is also computed and output with the mean
response q j . N 0 is defined by
∞ ∞
2
N0 = ∫w S J ( w ) dw ⁄ ∫ ( w ) dw Eq. 4-27
0 0
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"
∞
2
qj = Rj ( 0 ) = ∫ Sj ( f ) df Eq. 4-28
0
Main Index
1588 RANDOM
Computes functions from frequency response data
2 2
rj = ∫f S j ( f ) df
0
1⁄2
N–1
1
r j = --- ∑ [ S j ( f i ) + S j ( f i + 1 ) ] ( f i + 1 – f i ) Eq. 4-29
2
i = 1
2 2
α = ( 3f i + 2f i f i + 1 + f i + 1 ) ⁄ 6
2 2
β ( )⁄
Note that if α and β are 1.0, the sum for r j would become the formula
for q j . Then N 0 = r j ⁄ q j is the quantity to be output.
where:
i = index of the frequencies.
N = highest frequency.
τm = is defined by
m
τ m = τ 0 + ----- ( τ max – τ 0 ) Eq. 4-31
M
where:
τ0 = starting time lag.
Main Index
RANDOM 1589
Computes functions from frequency response data
all of which are defined on a RANDT1 Bulk Data entry. Note that if, in
Eq. 4-30, τ m = 0 , then
2
r ( τm ) = qj Eq. 4-32
1
S j ( f ) = H ja ( f )S ab ( f )H jb ( f ) Eq. 4-33
Sj ( f ) = ∑ ∑ H ja ( f )H jb ( f ) Eq. 4-34
a b
Note that S ba = S ab , the complex conjugate.
4. The mean response and autocorrelation functions are computed as in Eq. 4-
30, Eq. 4-31, and Eq. 4-32.
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.
Main Index
1590 RBMG3
Computes rigid body information
Computes the rigid body transformation matrix, rigid body error ratio, and strain
energy matrix.
Format:
RBMG3 LLL,ULL,KLR,KRR/
DM $
Parameters:
None.
Remarks:
1. The rigid body transformation matrix is computed from:
–1
DM = – K ll K lr Eq. 4-35
T
K rr + K lr DM
------------------------------------------------------------------ Eq. 4-36
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
RBMG3 1591
Computes rigid body information
T
DM K ll DM + K rr Eq. 4-37
Main Index
1592 RBMG4
Computes rigid body mass matrix
Format:
RBMG4 DM,MLL,MLR,MRR/
MR $
Parameters:
None.
Remark:
The rigid body mass matrix is computed from:
T T T
MR = M rr + DM M lr + M lr DM + DM M ll DM Eq. 4-38
Main Index
READ 1593
Extracts real symmetric system eigenvalues
d
( [ K ] – λ [ K ] ) { u } = 0 for buckling analysis Eq. 4-40
Format:
READ KAA,MAA,MR,DAR,DYNAMIC,USET,CASECC,
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 $
Main Index
1594 READ
Extracts real symmetric system eigenvalues
Main Index
READ 1595
Extracts real symmetric system eigenvalues
Parameters:
Main Index
1596 READ
Extracts real symmetric system eigenvalues
Main Index
READ 1597
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.
READ KAA,MAA,,,DYNAMIC,,CASECC,,,,/
Main Index
1598 READ
Extracts real symmetric system eigenvalues
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.
READ KAA,MAA,,,DYNAMIC,,,,,,/
LAMA,PHA,MI,OEIGS,/
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” on page 1517 and “EIGRL” on page 1522 of the MD Nastran
Quick Reference Guide. The CASECC and DYNAMIC data blocks may be
purged and are ignored.
READ KAA,MAA,,,,,,,,,/
LAMA,PHA,MI,OEIGS,/
FORMAT/S,N,NEIGV////-1//
F1/F2/NE/ND/MSGLVL/MAXSET/SHFSCL/NORM $
Main Index
READ 1599
Extracts real symmetric system eigenvalues
READ KXX,MXX,MR,DXR,DYNAMIC,USET,CASECC,PARTVEC,SIL,
,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
READ KXX,MXX,MR,DMX,DYNAMIC,USET,CASECC,PARTVEC,SIL,
VACOMP,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
Main Index
1600 READ
Extracts real symmetric system eigenvalues
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 MD 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 MD
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.
• 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 User’s 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.
Main Index
READ 1601
Extracts real symmetric system eigenvalues
Examples:
1. Suppose the user has a matrix [ A ] for which he or she wishes to extract
eigenvalues via the classical equation [ A – λI ] { u } = 0 . Presuming [ A ] 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// $
Main Index
1602 RESMOD
Perform linear algebra functions to support residual vector calculations
Format:
RESMOD I1,I2,I3,I4,I5/
O1,O2,O3,O4,O5/
P1/P2/P3/P4/P5/P6 $
Parameters:
Option P1 = 'ATBC'
T T
Performs the matrix multiplication [ I1 ] [ I2 ] [ I3 ] if [ I3 ] is present; [ I1 ] [ I2 ] [ I1 ]
otherwise.
Main Index
RESMOD 1603
Perform linear algebra functions to support residual vector calculations.
Format:
RESMOD I1,I2,I3,,/O1,,,,/'ATBC' $
O1 Matrix product.
Remark:
[I2] is assumed to be symmetric.
Example:
T
Compute the product [ D ] = [ A ] [ B ] [ C ]
RESMOD A,B,C,,/D,,,,/'ATBC' $
Option P1 = 'MPART'
Partitions stiffness, mass, and eigenvector matrices based on mass content.
Format:
RESMOD PHI,K,M,,/PHI0,K0,PHI1,M1,K1/
'MPART'////ZROSTIFF/ZROMASS $
Main Index
1604 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:
RESMOD U,M,,,/U0,U1,,,/'LININD'////ZROVEC $
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. [ U0 ] and [ U1 ] should satisfy the following conditions:
T
[ I0 ] [ M ] [ U0 ] = computational zeros
T
[ U1 ] [ M ] [ U1 ] > 0.0
4. U and M must be real.
Main Index
RESMOD 1605
Perform linear algebra functions to support residual vector calculations.
Option P1 = 'LDSWEEP'
Sweeps modal loads for load 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.
Parameter:
Remarks:
1. The filtered load vectors are:
T –1 T
[ LDIND ] = [ LD ] – [ M ] [ PHI ] ⋅ ( [ PHI ] [ M ] [ PHI ] ) ⋅ [ PHI ] [ LD ]
2. LD, PHI, MXX, and MQQ must be real.
Option P1 = 'USWEEP'
Sweeps a matrix for small vectors.
Format:
RESMOD U,PHI,MXX,MQQ,/UIND,,,,/'USWEEP'/NORMFLG $
U A set of vectors.
PHI Modal vectors.
Main Index
1606 RESMOD
Perform linear algebra functions to support residual vector calculations.
Parameter:
Remarks:
1. The filtered vectors are:
T –1
[ UIND ] = [ U ] + – ( [ PHI ] [ MQQ ] [ PHI ] )
2. U, PHI, MXX, and MQQ must be real.
Main Index
RESTART 1607
Data block comparison
Format:
RESTART DB1,DB2,DLSTIN/DLSTOUT/
INVOKE/SPEXP/DPEXP/NDDLNAM/PRTUNIT $
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.
Parameters:
– SPEXP
x – y < 10
DBEXP Input-logical-default=12. Double-precision tolerance component. Two
double-precision numbers, x and y are considered equal if
– DBEXP
x – y < 10
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.
Main Index
1608 RESTART
Data block comparison
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” in Chapter 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/ $
RESTART GEOM2,GEOM2R,/HIST/ $
SEID = SEDWN $
RESTART,,,HIST//TRUE $
Main Index
RMDUPBLK 1609
Removes duplicate records from the Bulk Data
Format:
RMDUPBLK /BULK/S,N,NEWBULK $
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:
FILE IBULK=APPEND $
RMDUPBLK /IBULK $
2. The actions taken by this module and tolerance for defining duplicate real
numbers are both specified in system cell 402:
Main Index
1610 RMG2
Processes radiation exchange coefficients
Format:
RMG2 EST,MPOOL,MUGNI,KGGNL,MPT,DIT,BGPDT,SIL,USET/
RDEST,RECM,RGG,KGGNL1/
TABS/SIGMA/S,N,NORADMAT/LUSET $
Parameters:
Main Index
RMG2 1611
Processes radiation exchange coefficients
Remark:
If KGGNL is not purged then LUSET is determined from KGGNL.
Main Index
1612 ROTOR
Process rotordynamics Bulk Data input
Format:
ROTOR BGPDT,DYNAMIC,DIT,CSTM,VDA,EDOM/
ROTOR,ROTORT/
CONFAC/APP/ROTPRNT/ROTTFLG $
Parameters:
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
ROTOR 1613
Process rotordynamics Bulk Data input
Main Index
1614 ROTRDR1
Creates coriolis and circulation matrices
Creates coriolis and circulation matrices based on rotordynamics user input and also
drives DMAP rotor loop.
Format:
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 $
BCGG
TI
VGROT
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.
Main Index
ROTRDR1 1615
Creates coriolis and circulation matrices
Main Index
1616 ROTRDR2
Set parameters for rotordynamic looping
Format:
CASECC ROTOR
ROTRDR2 //
DIT ROTORT
FREQ
S,N,RECNUM/APP/ /S,N,ROTORID/S,N,SYNFLAG/
TIME
S,N,RSCALE0 S,N,RSCALE1
/ /S,N,GR/S,N,RAVG/
S,N,OMEGA S,N,OMEGADOT
S,N,ALPHAR1/S,N,ALPHAR2 $
Parameters:
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.
Main Index
ROTRDR2 1617
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
1618 ROTRUTL
Perform various utilities for rotordynamics processing.
Format:
ROTRUTL I1,I2,I3,I4,I5,I6/
O1,O2,O2/
P1/P2/P3/P4/P5/P6 $
Parameters:
Option IOPT = 1
Format:
ROTRUTL FINRL,BGPDT,,,,/MINRL,,/1 $
Main Index
ROTRUTL 1619
Perform various utilities for rotordynamics processing.
MINRL G-set square mass matrix that would produce these forces where
MINRL is block diagonal with 3x3 blocks.
Option IOPT = 2
Format:
ROTRUTL CASECC,DYNAMIC,,,,/
NHFRL,NHOUT,/2/S,N,NHARM/S,N,NHSUBFAC/S,N,NLHIC $
Parameters:
NHARM Output.
NHSUBFAC Output.
NLHIC Ouptut.
Option IOPT = 3
Format:
ROTRUTL CASECC,ROTOR,,,,/ROTORX,,/3//SPEED $
Main Index
1620 ROTRUTL
Perform various utilities for rotordynamics processing.
Parameter:
Option IOPT = 4
Format:
ROTRUTL EPT,,,,,/EPTX,,/4/PID/DDVALUE/FID/ITYPE $
Parameters:
Option IOPT = 5
Format:
ROTRUTL ROTOR,,,,/,,/5/IRGYRO//S,N,REFROTR $
Main Index
ROTRUTL 1621
Perform various utilities for rotordynamics processing.
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:
ROTRUTL DYNAMIC,,,,,/SEROT,,/6/S,N,NROTOR//S,N,NROTORSE $
Parameters:
Option IOPT = 7
Add ROTORG entries into DYNAMIC based on the SEPART and SEROT .
Format:
ROTRUTL DYNAMIC,SEPART,SEROT,BGPDT,,/DYNAMICX,,/7 $
Main Index
1622 ROTRUTL
Perform various utilities for rotordynamics processing.
Parameters:
None.
Option IOPT = 8
Processes forces for nonlinear harmonic response
Format:
ROTRUTL DYNAMIC,CASECC,BGPDT,EVEC,USETD,DIT/
NLFTAB,NLPART,/8/S,N,UVAFLAG $
Parameter:
UVAFLAG Output. Bit pattern indication force term association with U (disp),
V(vel) or A (acce).
Option IOPT = 9 or -9
Format:
ROTRUTL U,,,,,/UAVG,,/9/NHARM/FREQ/CONDIV//ISUBFAC $
Main Index
ROTRUTL 1623
Perform various utilities for rotordynamics processing.
Parameters:
NHARM Input.
FREQ Input.
CONDIV Input.
ISUBFAC Input.
Option IOPT = 10
Format:
ROTRUTL ,,,,,/MFCDISP,MFCVELO,/10/NHARM//NHPLUS $
Parameters:
NHARM Input.
NHPLUS Input.
Option IOPT = 11
Format:
ROTRUTL U,PTVEC,MFCDISP,MFCVELO,,/UT,VT,/11 $
Main Index
1624 ROTRUTL
Perform various utilities for rotordynamics processing.
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.
Option IOPT = 12
Convert U (fourier components of d-set) into TIC records to be used in a transient
response analysis
Format:
ROTRUTL DYNAMIC,BGPDT,EVEC,U,,/,,/12/TICID/FREQ/NHARM $
Parameters:
TICID Input.
FREQ Input.
NHARM Input.
Main Index
ROTRUTL 1625
Perform various utilities for rotordynamics processing.
Option IOPT = 13
Format:
ROTRUTL DIT,,,,,/,,/13/SDAMP/S,N,TR/S,N,INFOR $
Parameters:
SDAMP Input.
TR Output.
INFOR Output.
Option IOPT = 14
Determine convergence and line search in nonlinear harmonic response analysis.
Format:
ROTRUTL RESU0,RESU1,,,,/HISTAB,,/14/S,N,ICODE/NLHTOL $
HISTAB
Parameters:
Main Index
1626 RSPEC
Converts transient response motion for plotting
Converts transient response motion to response spectra output suitable for plotting.
Format:
RSPEC FRL,OUG2,SPSEL,OVG2/
OXRESP/
S,N,SPSELREC/DVAFLAG $
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// $
ENDIF $ RECORD>=0
ENDDO $ RECORD<>-1
Main Index
SCALAR 1627
Matrix element extractor
Format:
SCALAR A//S,N,NROW/S,N,NCOL/S,N,VALUED $
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
Main Index
1628 SCALAR
Matrix element extractor
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
SDP 1629
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:
SDP CASEA,AECTRL,AERO,CSTMA,EDT,
AEDBUXV,AEMONPT,MONITOR,MPARV,MPAERV,MPAEUV,
MPSRV,MPSERV,MPSIERV,MPSEUV,MPSIEUV,UXTRIM,AEDBINDX,
PRBDOFS/
STBDER,UXDIFV/
MACH/Q/AECONFIG/SYMXY/SYMXZ/LPRINT $
Main Index
1630 SDP
Calculates nondimensional stability and control derivatives
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.
Main Index
SDR1 1631
Computes solution and single-point forces
Format:
SDR1 USET,PG,UL,UOO,YS,GOA,GM,PS,KFS,KSS,QR,KGG/
UG,PGT,QG/
NSKIP/APP/NOQG $
Main Index
1632 SDR1
Computes solution and single-point forces
Parameters:
Method:
Static Analysis
ul
⇒ { ua } Eq. 4-41
ur
ua
⇒ { uf } Eq. 4-42
uo
where
{ u o } = [ G oa
t ]{ u } + { u o }
a o Eq. 4-43
Main Index
SDR1 1633
Computes solution and single-point forces
uf
⇒ { un } Eq. 4-44
Ys
un
⇒ { ug } Eq. 4-45
um
where
{ u m } = [ G mn ] { u n } Eq. 4-46
T
{ q s } = [ K fs ] [ u f ] + [ K ss ] { Y s } – { P s } Eq. 4-47
Eigenvalue Analysis
In the case of eigenvalue analysis SDR1 recovers dependent components of the
eigenvectors
{ φ o } = [ G oa ] { φ a } Eq. 4-48
φa
----- = { φf } Eq. 4-49
φo
φf
- = { φn }
---- Eq. 4-50
φs
{ φ m } = [ G mn ] { φ n } Eq. 4-51
φn
- = { φg }
------ Eq. 4-52
φm
T
{ q s } = [ K fs ] { φ f } Eq. 4-53
Main Index
1634 SDR1
Computes solution and single-point forces
{ q s } = [ [ K sf ] – ω 2 [ M sf ] ] { φ f } Eq. 4-54
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.
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 MD Nastran Reference Manual for further discussion
of the matrix operations in SDR1.
10. SDR1 can also process matrices with extra points.
Main Index
SDR2 1635
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:
EQEXIN
SDR2 CASECC, CSTM ,MPT ,DIT , ,
EQDYN
SIL
, ETT ,OL ,BGPDT ,PG ,
SILD
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 $
Main Index
1636 SDR2
Creates data recovery output tables
Main Index
SDR2 1637
Creates data recovery output tables
Parameters:
Main Index
1638 SDR2
Creates data recovery output tables
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.
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.
Main Index
SDR2 1639
Creates data recovery output tables
Main Index
1640 SDR2
Creates data recovery output tables
2 Applied loads.
3 spcforces and mpcforces.
7 Eigenvectors.
10 Velocities.
11 Accelerations.
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.
Main Index
SDR3 1641
Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format
SDR3 Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1)
format
Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format.
Format:
SDR3 OFP1,OFP2,OFP3,OFP4,OFP5,OFP6/
OFP1X,OFP2X,OFP3X,OFP4X,OFP5X,OFP6X $
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
Main Index
1642 SDRCOMP
Calculates laminar stresses
Format:
SDRCOMP CASECC,MPT,EPT,ETT,EST,OES1A,OEF1A,DIT,BGPDT,PCOMPT/
OES1C,OEFIT,OEF1AA,OPLYSR,OGPLYSS,OGPLYFI,OGPSR/
STRNFLG/DESOPT/LOADFAC/SRCOMPS $
Main Index
SDRCOMP 1643
Calculates laminar stresses
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.
Main Index
1644 SDRHT
Combines heat flow for CHBDYi elements with heat flux of other elements
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:
SDRHT UG,OEF1,SLT,EST,DIT,RDEST,RECM,DLT,OEFNL1,MPT,BGPDT,
CSTM,SIL,USET,CASECC,OESNLH,APPLOAD/
HOEF1,HOES1/
TABS/SIGMA/NORADMAT $
Main Index
SDRHT 1645
Combines heat flow for CHBDYi elements with heat flux of other elements
Parameters:
HOES1
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.
Main Index
1646 SDRNL
Performs stress data recovery for nonlinear elements
Format:
SDRNL CASECC,ESTNL,ELDATA,UNUSED4,UNUSED5,UNUSED6,UNUSED7,
CSTM,UGNI,BGPDT/
OESNL1,OESNLB1,UNUSED3/
NLTYPE/UNUSED2/UNUSED3/NSKIP/LINC/UNUSED6/UNUSED7/
UNUSED8 $
Parameters:
Main Index
SDRNL 1647
Performs stress data recovery for nonlinear elements
Main Index
1648 SDRP
Computes data for p-elements
Format:
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 $
Main Index
SDRP 1649
Computes data for p-elements
Main Index
1650 SDRP
Computes data for p-elements
Parameters:
Main Index
SDRP 1651
Computes data for p-elements
Remarks:
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
1652 SDRX
Modifies CBAR, CBEAM and CBEND element results
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:
SDRX CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,BGPDT,
OSTR1/
OEF1X,OES1X,OSTR1X/
S,N,NOXOUT $
Main Index
SDRX 1653
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 $
Main Index
1654 SDRXD
Modifies CBAR, CBEAM and CBEND element results
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:
SDRXD CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,
UG,DLT,OL,BGPDT,OSTR1/
OEF1X,OES1X,OSTR1X/
S,N,NOXOUT/APP/COUPMASS $
Main Index
SDRXD 1655
Modifies CBAR, CBEAM and CBEND element results
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.
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 $
Main Index
1656 SDSA
Partitions design model to superelements
Partitions the design model (i.e., the design optimization Bulk Data entries) to
superelements.
Format:
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 $
Parameters:
Main Index
SDSA 1657
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.
Main Index
1658 SDSB
Generates superelement processing list
Generates the superelement processing list to direct the pseudo-load and response
sensitivity calculations.
Format:
SDSB SLIST,EDOM*,CASECC,UNUSED4,UNUSED5/
DSLIST/
S,N,DMRESD/S,N,NOSEDV/S,N,NOSERESP $
Parameters:
Main Index
SDSB 1659
Generates superelement processing list
Example:
Excerpt from subDMAP DESINIT:
DBVIEW EDOMF=EDOMS WHERE (wildcard) $
IF ( NOT(RSONLY) AND NOEDOM>0
) SDSB SLIST,EDOMF,CASEXX,,/DSLIST/S,N,DMRESD/
S,N,NOSEDV/S,N,NOSERESP $
Main Index
1660 SDSC
Prints correlation table for normalized design sensitivity coefficient matrix
Prints the correlation table for normalized design sensitivity coefficient matrix.
Format:
SDSC DSCMCOL//
OBJSID/DESOBJ/UNUSED3/EIGNFREQ $
None.
Parameters:
Main Index
SECONVRT 1661
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:
SECONVRT BGPDT,GEOM1,GEOM2,GEOM3/
GEOM1N,GEOM2N,GEOM3N $
Parameters:
None.
Remark:
1. System cell 350 controls execution of the SECONVRT module.
-1 No converson.
Main Index
1662 SECONVRT
Modifies Bulk Data entry records
Main Index
SEDR 1663
Partitions tables for superelements
Partitions the solution matrix, Case Control and Plot Control tables for each
superelement.
Format:
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 $
Main Index
1664 SEDR
Partitions tables for superelements
Parameters:
Main Index
SEDR 1665
Partitions tables for superelements
Main Index
1666 SEDRDR
Drives superelement data recovery loop
Format:
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 $
Parameters:
Main Index
SEDRDR 1667
Drives superelement data recovery loop
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.
Main Index
1668 SEDRDR
Drives superelement data recovery loop
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 $
Main Index
SEEFMBND 1669
Generates band information for EFM
Format:
SEEFMBND CASECC,DYNAMIC,DIT,LAMA,EFMDMP/
BANDPV,BANDLIST/EFMMASS $
Parameters:
EFMMASS Input-real-no default. Total mass for all superelements for which
energy flow modeling calculations are to be performed.
Main Index
1670 SEEFMCLF
Calculates EFM values for a band
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:
SEEFMCLF DIT,EFMLIST,EFMDMP,BANDLIST,BANDPV,MQE*/
ENEMAT,APIMAT,EFMMA,SCLFMAT,CLFMAT/
IBAND/EFMMASS/QUALNAM/EFMDIAG $
Parameters:
Main Index
SEEFMCLF 1671
Calculates EFM values for a band
Main Index
1672 SEEFMDMP
Generates parameters for EMF
Format:
SEEFMDMP CASECC,DYNAMIC,EFMLIST,OGPWG*/
EFMMCOL,EFMDMP/
S,N,EFMMASS/QUALNAM $
Parameters:
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
SEEFMLST 1673
Generates superelement list for EFM
Generates list of superelements for which energy flow modeling (EFM) calculations
are to be performed.
Format:
SEEFMLST CASECC,GEOM1,SLIST/EFMLIST $
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
Parameters:
None.
Main Index
1674 SEEFMNOR
Generates partitioning vector and shell normals for EFM
Format:
SEEFMNOR BGPDT,USET,GPSNT/
PVGT,SNORMM $
PVGT Partitioning vector for extracting the grid point translational DOFs.
SNORMM Matrix of superelement grid point shell normal vectors.
Parameters:
None.
Remark:
GPSNT and SNORMM may be purged if only PVGT is desired.
Main Index
SEEFMOUT 1675
Print output from the Energy Flow Modeling (EFM) analysis
SEEFMOUT Print output from the Energy Flow Modeling (EFM) analysis
Print output from the Energy Flow Modeling (EFM) analysis.
Format:
SEEFMOUT EFMLIST,EFMASMTT,EXCITEFX,BANDLIST,
MNRGYMTF,APIMATT,RESMATFT/ $
Parameters:
None.
Main Index
1676 SEEFMXIT
Computes superelement power for EFM
Computes superelement power and force input values for energy flow modeling
(EFM).
Format:
SEEFMXIT CASECC,DYNAMIC,EFMLIST/EXCITP,EXCITF $
Parameters:
None.
Main Index
SELA 1677
Assembles static load matrices from upstream superelements
Assembles static load matrices from upstream superelements into the current
superelement.
Format:
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.
Parameters:
Main Index
1678 SELA
Assembles static load matrices from upstream superelements
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 $
Main Index
SEMA 1679
Assembles square symmetric matrices from upstream superelements
Assembles square symmetric matrices (e.g., stiffness, mass, damping) from upstream
superelements into the current superelement.
Format:
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.
Parameters:
Main Index
1680 SEMA
Assembles square symmetric matrices from upstream superelements
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 $
Main Index
SEP1 1681
Constructs superelement map table
Format:
SEP1 GEOM1,GEOM2,GEOM4,EQEXIN,BGPDT,CSTM,CASECC,SETREE/
SEMAP,SCSTM/
S,N,NOSE/CONFAC/LST2REC $
Parameters:
Main Index
1682 SEP1
Constructs superelement map table
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.
Main Index
SEP1X 1683
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:
SEP1X SELIST,GEOM1*,GEOM2*,GEOM4*,SETREE,SGPDTS*,BNDFIL/
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 $
Main Index
1684 SEP1X
Constructs superelement map table
Parameters:
Main Index
SEP1X 1685
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.
Main Index
1686 SEP1X
Constructs superelement map table
Main Index
SEP2 1687
Partitions tables for each superelement
Format:
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
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
1688 SEP2
Partitions tables for each superelement
Parameters:
Main Index
SEP2CT 1689
Partitions Case Control and Plot Control tables for each superelement
SEP2CT Partitions Case Control and Plot Control tables for each superelement
Partitions the Case Control and Plot Control tables for each superelement.
Format:
SEP2CT SLIST,CASECC,PCDB,UNUSED4,XYCDB/
CASES,PCDBS,XYCDBS/
APP/SEID $
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).
Parameters:
Main Index
1690 SEP2DR
Drives superelement generation, assembly, and reduction loop
Drives the superelement generation, assembly, and reduction loop. Also drives the
pseudo-load generation loop.
Format:
SLIST
SEP2DR ,SEMAP/
DSLIST
S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,LASTSE/S,N,NOMAT/
S,N,NOASM/S,N,NOLOAD/S,N,NOLASM/S,N,NOUP/S,N,SCNDRY/
S,N,EXTRN/S,N,NOMR/SEP2CNTL/S,N,NOPSLG/NOPGHD/
S,N,PARTSE/S,N,SETYPE/S,N,RSEID/NSENQSET $
Parameters:
Main Index
SEP2DR 1691
Drives superelement generation, assembly, and reduction loop
Main Index
1692 SEP2DR
Drives superelement generation, assembly, and reduction loop
Main Index
SEP2DR 1693
Drives superelement generation, assembly, and reduction loop
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 $
Main Index
1694 SEP2X
Partitions tables for each superelement
Format:
SEP2X GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,SLIST,SEMAP,CASES,
DYNAMIC,UNUSED11,SGPDT,SCSTM,MATPOOL/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,SGPDTS,UNUSED9,DYNAMICS,MATPOOLS,UNUSED12/
SEID/METHCMRS/SEP1XOVR $
Main Index
SEP2X 1695
Partitions tables for each superelement
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.
Parameters:
Main Index
1696 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:
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 $
Parameters:
Main Index
SEP3 1697
Examines Case Control and determines superelement processing
Remark:
If there are no superelements, then SLIST is not created and may be purged.
Main Index
1698 SEP4
Examines table and data base information for superelement processing
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:
SEP4 CASECC,PCDB,EMAP,XYCDB,UG*,PUG*,QG*,MMCDB/
DRLIST/
UNUSED1/QUALNAM/S,N,NODR/S,N,SEID/S,N,NOSEPLOT/
SEP4CNTL $
Parameters:
Main Index
SEP4 1699
Examines table and data base information for superelement processing
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 $
Main Index
1700 SEPLOT
Assembles plot displacement matrices for superelements
Assembles plot displacement matrices for superelements based on the SEPLOT and
SEUPPLOT commands.
Format:
SEPLOT PCDB,SEMAP,SCSTM,BGPDT*,ECT*,PUG*/
BGPDTX,PUGX,PLSETMSG,PLTPAR,GPSETS,ELSET/
QUALNAM/QUALNAMP/S,N,PLTCNT/S,N,NGP/S,N,JPLOT $
Main Index
SEPLOT 1701
Assembles plot displacement matrices for superelements
Parameters:
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.
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
Main Index
1702 SEPR1
Builds a list of partitioned superelement Bulk Data Sections
Format:
SEPR1 BULK*/
SELIST/
QUALNAM/S,N,SEFLAG $
Parameters:
Example:
Excerpt from subDMAP IFPL:
DBVIEW IBULKSF = IBULK WHERE (SEID>0 AND PEID=*) $
SEPR1 IBULKSF/SELIST//S,N,SELIST $
Main Index
SEQP 1703
Resequencing processor
Generates SEQGP entries or a mapping matrix for use in resequencing matrices for
efficient matrix decomposition.
SEQP GEOM1,GEOM2,GEOM4,EPT,MATPOOL,DYNAMIC,CASECC/
GEOM1Q,TIMSIZ,GEQMAP,BNDFIL,SPCPART,LGPART,GEOM2X,
GEOM4X/
SEQOUT/SEQMETH//SUPER/FACTOR/
MPCFLG/START/MSGLVL/PEXIST/PSEQOPT/S,N,NTIPS/APP/
S,N,ZCOLLCT/S,N,TIPSCOL/ACMS/S,N,FLUIDSE/ATQSET/
PARTMEM $
SEQP MAT,GPL,USET,SIL/SEQMAP,,,,,/
SEQOUT/SEQMETH/SETNAME $
Main Index
1704 SEQP
Resequencing processor
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 1705
Resequencing processor
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.
Main Index
1706 SEQP
Resequencing processor
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.
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'.
Main Index
SEQP 1707
Resequencing processor
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.
Suitable
Decomposition Method
SEQMETH
non-sparse and non-parallel 1 and 4
parallel 2 and 5
sparse 6 and 7
Main Index
1708 SEQP
Resequencing processor
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” in Chapter 3
of the MSC.Nastran Numerical Methods User’s 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.
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.
Main Index
SEQP 1709
Resequencing processor
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
1710 SHPCAS
Appends primary model’s case control based on boundary shapes
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:
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.
Parameters:
None.
Main Index
SMA3 1711
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:
SMA3 GEI,KGG/
KGG1/
LUSET/NOGENL/NOSIMP $
KGG1 Matrix. The type (complex or real and single or double precision) of [X]
is the maximum of the types of [A], [B], α, and β. The size of [X] is the
size of [A] if [A] is present. Otherwise, it is the size of [B].
Parameters:
Remark:
KGG may be purged.
Main Index
1712 SMPYAD
Matrix series multiply and add
[ X ] = ±[ A ] [ B ] [ C ] [ D ] [ E ] ±[ F ]
Format:
SMPYAD A,B,C,D,E,F/
X/
NMAT/SIGNP/SIGNF/PREC/TA/TB/TC/TD/FORM
X Resultant matrix.
Parameters:
Remarks:
1. Except for the final product, all intermediate matrix products are compute in
machine precision.
Main Index
SMPYAD 1713
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 [ B ] and [ F ] are symmetric and
T
[ A ] = [ C ] and TA = 1 ; i.e., [ X ] = [ A ] [ B ] [ A ] ± [ F ] ], 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 [ X ] = [ A ] [ B ]T [ C ] – [ F ] .
SMPYAD A,B,C,,,F/X/3/1/-1/0/0/1 $
2. Compute [ Z ] = – [ U ]T [ V ]T [ W ]T [ X ] T [ Y ] [Z].
SMPYAD U,V,W,X,Y,/Z/5/-1/0/0/1/1/1/1 $
3. Compute [ φ ] T [ M ] [ φ ] .
SMPYAD PHI,MAA,PHI, ,,/X/3////1////6 $
Main Index
1714 SOLVE
Linear system solver
Format:
SOLVE A,B,SIL,USET,PARTVEC/
X/
SYM/SIGN/SETNAME $
Parameters:
Main Index
SOLVE 1715
Linear system solver
Remarks:
1. [ X ] is a rectangular matrix with the same dimensions as [ B ] and the
maximum type of [ A ] and [ B ] .
2. If SYM = 3, then [ B ] is ignored.
If SYM ≠ 3 and [ B ] is purged, then [ X ] will be purged; or if [ B ] is a null matrix,
then [ X ] 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 [ A ] [ X ] = [ P ] .
SOLVE A,P,,,/X/ $
2. Invert [ A ] .
SOLVE A,,,,/AINV/3 $
3. Solve [ X ] T [ A ] = [ P ] T .
SOLVE A,P,,,/X/2 $
Main Index
1716 SOLVIT
Iterative solver
SOLVIT A,B,XS,PC,USET,KGG,GM,SIL,EQEXIN,EDT,CASECC,EQMAP,
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 $
SOLVIT A,B,XS,PS,USET,USET0,SIL0,SIL,EQEXIN,EDT,CASECC,
EQMAP,,,,,,,,,/
X,R,PG,EPSSE/
SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/
NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID $
Main Index
SOLVIT 1717
Iterative solver
Parameters:
Main Index
1718 SOLVIT
Iterative solver
Model Type of
IPAD Method ITSOPT
type [A]
Main Index
SOLVIT 1719
Iterative solver
Model Type of
IPAD Method ITSOPT
type [A]
Main Index
1720 SOLVIT
Iterative solver
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.
Main Index
SOLVIT 1721
Iterative solver
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:
SOLVE Action
2 Suppresses the user information message at each iteration.
8 Use alternative convergence criterion (less conservative
than default).
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 [ A ] [ X ] = [ B ] 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 $
Main Index
1722 SSG1
Computes static load matrix
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:
SSG1 SLT,BGPDT,CSTM,MEDGE,EST,MPT,ETT,EDT,MGG,CASECC,
DIT,UG,DEQATN,DEQIND,GPSNT,CSTM0,SCSTM,GEOM4,ESTL,
SLTNL0,KGG,USET/
PG
, PTELEM,SLTH,SLTNL,PGRV/
AG
LUSET/NSKIP/DSENS/APP/ALTSHAPE/TABS/SEID/
COMBMETH/LGDISP/NONLNR/OGRAV $
Main Index
SSG1 1723
Computes static load matrix
Parameters:
Main Index
1724 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 SKIP ≤ 0 , it is set to zero.
Main Index
SSG1 1725
Computes static load matrix
Main Index
1726 SSG2
Reduces static load and enforced displacement matrices
Format:
SSG2 USET,GM,YS,KFS,GOA,DM,PG,KGG/
QR,PO,PS,PA,PL $
Parameters:
None.
Method:
The constraints are applied to the static load vectors by SSG2 (Static Solution
Generator -- Phase 2) in subDMAP SELR as follows:
Main Index
SSG2 1727
Reduces static load and enforced displacement matrices
Pn
{ Pg } = Eq. 4-55
Pm
T
{ P n } = { P n } + [ G mn ] { P m } Eq. 4-56
Pf
{ Pn } = Eq. 4-57
Ps
{ P f } = { P f } – [ K fs ] { Y s } Eq. 4-58
Pa
{ Pf } = Eq. 4-59
Po
T
{ P a } = { P a } + [ G oa ] { P o } Eq. 4-60
{ P a } = { P a } – [ L ao ] [ D oo ] [ u ox ] Eq. 4-61
[ L oo D oo ] { u ox } = { P o } Eq. 4-62
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.
Main Index
1728 SSG2
Reduces static load and enforced displacement matrices
Main Index
SSG3 1729
Computes static solutions
Format:
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 $
Parameters:
Main Index
1730 SSG3
Computes static solutions
Method:
The SSG3 module (Static Solution Generation -- Phase 3) solves the equation
[ K oo ] { u oo } = { P o } Eq. 4-63
{ δP o } = [ K oo ] { u oo } – { P o } Eq. 4-64
T
{ u oo } { δP o }
ε o = ---------------------------------- Eq. 4-65
T
{ P o } { u oo }
Except for round-off error, the error ratio ε o 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
T
1 ⁄ 2 { Po } { uo } Eq. 4-66
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.
Main Index
SSG3 1731
Computes static solutions
5. PO or PL may be purged.
6. RUL and RUO may be purged.
Main Index
1732 SSG4
Updates static loads with inertial loads
Format:
SSG4 PL,QR,PO,MR,MLR,DM,MLL,MOO,MOA,GOA,USET/
PLI,POI/
NOOSET $
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.
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.
Main Index
SSG4 1733
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
1734 ST2DYN
Transforms IFP data from nonlinear static to transient analysis
Transforms CASECC and several IFP data blocks from the nonlinear static analysis
format to nonlinear transient response format.
Format:
ST2DYN CASECC,MPT,DYNAMIC,GEOM3,DIT,GEOM4/
CASENT,MPTNT,DYNAMNT,GEOM3NT,DITNT/
S,N,NBNLST/S,N,NBLSEQ $
Parameters:
Main Index
STATICS 1735
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:
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 $
Main Index
1736 STATICS
Performs static analysis on real symmetric stiffness matrix
Parameters:
Remarks:
1. See the “SOLVIT” on page 1716 module for further discussion related to the
iterative method.
2. PC, XS, PC1, and RUG may be purged.
Main Index
STATICS 1737
Performs static analysis on real symmetric stiffness matrix
Main Index
1738 STDCON
Calculate stress discontinuities across elements and grid points
Format:
STDCON CASECC,EGPSF,EQEXIN,OES1,EGPSTR,ECT/
OEDS1,OGDS1,ELDCT,GPDCT/
S,N,NOEDS1/S,N,NOGDS1/S,N,NOELDCT/S,N,NOGDCT/APP $
Parameters:
Main Index
STDCON 1739
Calculate stress discontinuities across elements and grid points
Main Index
1740 STRSORT
Filters and sorts element data recovery tables
Filters and sorts element data recovery tables (e.g., stresses, strains, and forces).
Format:
STRSORT OFPE,INDTA/
OFPES/
NUMOUT/BIGER/SRTOPT/SRTELTYP/SRTTYP $
Parameters:
Main Index
STRSORT 1741
Filters and sorts element data recovery tables
Remarks:
1. For further discussion see the DTI,INDTA and PARAM,S1 descriptions in
the MD Nastran Quick Reference Guide.
2. SRTTYP=1 is used primarily to sort slideline element output by slave grid
point identification number.
Main Index
1742 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:
TA1 MPT,ECT,EPT,BGPDT,SIL,ETT,CSTM,DIT,ECTA,EHT/
EST,ESTNL,GEI,GPECT,ESTL,VGFD,DITID,NFDICT/
LUSET/S,N,NOESTL/S,N,NOSIMP/NOSUP/S,N,NOGENL/SEID/
LGDISP/NLAYERS/S,N,FREQDEP/PSHLDAMP/
S,N,MGEFLAG/NSMSID $
Main Index
TA1 1743
Combines element data into tables
Parameters:
Main Index
1744 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.
Main Index
TABEDIT 1745
Performs editing operations on table data blocks
Format:
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.
Parameters:
Main Index
1746 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.
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 Kopy n Records from TA, TB, or TC onto TNEW.
KRB,n
KRC,n
SRA,n Skip n Records forward on TA, TB, or TC. Used to
SRB,n position secondary data block TA, TB, or TC for a
SRC,n subsequent KR* operation.
MEA,i,n Merge-Edit the next record on TA, TB, or TC into
MEB,i,n record i according to IFP specifications for
MEC,i,n fixed-length word groups of length n.
Main Index
TABEDIT 1747
Performs editing operations on table data blocks
TABEDIT Directives
Directive Remarks
INT Interrogate TOLD for number of records and number
of words in each record. Also print the first three
words of each record.
2. The CR directive requires at least one subdirective from the table below:
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, Delete Words i through j of the record specified by the
n words CR directive and replace by the n words that follows
on the CR directive record.
IW, i, n, Insert after Word i of the record specified by the CR
n words directive the n words that follow on the CR directive
record.
KWA,n Kopy n Words from TA, TB, or TC onto TNEW.
KWB,n
KWC,n
SWA,n skip n words forward on TA, TB, or TC. Used to
SWB,n position secondary data block TA, TB or TC for a
SWC,n subsequent KW* operation.
AWA,n Append n Words from TA, TB, or TC onto TNEW after
AWB,n copying the rest of the record specified by the CR
AWC,n directive.
KRA,n Kopy the Remaining contents of the current record
KRB,n from TA, TB, or TC onto TNEW.
KRC,n
ARA Append the Remaining contents of the current record
ARB from TA, TB, or TC onto TNEW after copying the rest
ARC of the record specified by the CR directive.
Main Index
1748 TABEDIT
Performs editing operations on table data blocks
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
A printout of GEOM1 using the TABPRT module (with OPT3=1) will show the
following for record 1:
TABLE GEOM1
RECORD NO. 2
END OF FILE
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
Main Index
TABEDIT 1749
Performs editing operations on table data blocks
Main Index
1750 TABPRT
Formatted table printer
Format 1:
TABPRT TABLE//KEY/OPT1//OPT3 $
Format 2: (KEY=’USET’)
g-set
TABPRT USET,BGPDT//’USET’/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
or
TABPRT USET,EQEXIN,SIL//’USET’/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
p-set
TABPRT USETD,EQDYN,SILD//’USET’/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
ks-set
TABPRT AEUSET,AEBGPDT//’USET’/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $
Format 3: (KEY=’SEMAP’)
TABPRT SEMAP,ESTDATA,TIMSIZ,SGPDT//
’SEMAP’/OPT1/OPT2 $
Main Index
TABPRT 1751
Formatted table printer
Parameters:
Format 1:
OPT1 Input-integer-integer-default=0.
OPT1=0 No blank lines between entries.
OPT ≠ 0 One blank line between each entry.
Input-integer-default=0. Set selection flag for the row sort (OPT1=0
or 10).
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.
Main Index
1752 TABPRT
Formatted table printer
If OPT3 ≠ 0 ;
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.
Format 2: (KEY=’USET’):
OPT1 Input-integer-default=0.
Controls the tabular printout of the degree of freedom sets.
Main Index
TABPRT 1753
Formatted table printer
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
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 )
Main Index
1754 TABPRT
Formatted table printer
Decimal Decimal
Set Set
Equivalent Equivalent
Name Name
Number Number
Q 4194304 SB 1024
LM 2097152 SG 512
C 1048576 MR 16
J 524288 R 8
K 262144 O 4
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:
Main Index
TABPRT 1755
Formatted table printer
OPT1
Meaning
Value
>0 Write CSUPER Bulk Data entries for superelement
OPT1.
≤0 Write CSUPER Bulk Data entries for residual structure
but give SEID = - OPT1.
OPT2
Meaning of Selection
Value
-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).
Main Index
1756 TABPRT
Formatted table printer
OPT2
Meaning of Selection
Value
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.
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 ( OPT1 ≤ 0 ). 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.
TABPRT EMAP//’SEMAP’/1/4 $
TABPRT EMAP//’SEMAP’/-100/4 $
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
Main Index
TABPRT 1757
Formatted table printer
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 $
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
1758 TABPT
Table printer
Format:
TABPT TAB1,TAB2,TAB3,TAB4,TAB5//PRTFORM/UNUSED $
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 OPT3 ≠ 0 will properly identify real numbers and
character values.
6. The TABPRT module with OPT3 ≠ 0 will also print tables like TABPT with
labels above each item.
Examples:
TABPT GEOM1/ $
TABPT GEOM1,GEOM2,GEOM3,GEOM4/ $
Main Index
TAFF 1759
Creates tables for follower force stiffness
Format:
TAFF SLT,BGPDT/
ESTF,GPECTF/
LUSET/LOADID/LOADIDP/LOADFACR/NBLOCK $
Parameters:
Main Index
1760 TAHT
Adds records to element summary and grid point element connection table
TAHT Adds records to element summary and grid point element connection
table
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:
SLTH
TAHT ,EPT,SIL,ESTNL,GPECT,DIT/
DLTH
ESTNL1,GPECT1/
LUSET/S,N,NOSIMP/LSETID/RSTIME $
ESTNL1 Nonlinear element summary table updated for heat transfer analysis.
GPECT1 Grid point element connection table for heat transfer analysis.
Parameters:
Main Index
TAHT 1761
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
1762 TASNP1
Computes the shell normal vectors on a superelement's boundary
Format:
TASNP1 BGPDTS,GPECTS,GEOM1S,CSTMS/
SNORMS $
Parameters:
None.
Remark:
TASNP1 is intended to be executed for each superelement if partitioned
superelements are present.
Main Index
TASNP2 1763
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.
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 $
Main Index
1764 TASNP2
Computes grid point shell normal vectors at superelement boundaries
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.
Main Index
TIMETEST 1765
Provide timing data
Provides timing data for various unit operations that may be used to compare and
evaluate computer and compiler performance.
Format:
TIMETEST TIMTS,A,B,C/TOUT,/N/M/T/OPT/CASE $
Main Index
1766 TIMETEST
Provide timing data
1 2 3 4 5 6 7 8 9 10
DTI TIMTS3 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.)
1 2 3 4 5 6 7 8 9 10
DTI TIMTS4 IREC CASE ROWS COLS DENS STRL
Main Index
TIMETEST 1767
Provide timing data
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.
TIMTS5 (for CASE=1 only) Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
DTI TIMTS5 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 TIMTS5 IREC CASE T CORE METHOD
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
1768 TIMETEST
Provide timing data
Main Index
TIMETEST 1769
Provide timing data
1 WRITE
2 READ
4 READ BACKWARDS
8 BLDPK
16 INTPK
32 PACK
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
1770 TOLAPP
Appends nonlinear data and Case Control for data recovery
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):
TOLAPP CASEXX,MPT,TEL/
TOL,,TOL1/
TOLAPPF/NSOUT $
TOLAPP CASECC,MPT,ESTNL/
OLF,CASECCR,/
TOLAPPF//S,N,NSKIP/S,N,NEWP/S,N,POUTF $
Parameters:
Main Index
TOLAPP 1771
Appends nonlinear data and Case Control for data recovery
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.
Main Index
1772 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:
TRD1 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,SILD,USETD,
PARTVEC,PXT0,ROTORT,BGDD*,KCVDD*,RDG,PXTDV,PDXDVO/
UXT,PNL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/SETNAME/
NSOLT,NOTRLDFM/WTMASS $
Main Index
TRD1 1773
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Parameters:
Main Index
1774 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
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:
[ M dd p 2 + B dd p + K dd
x ] { u } = { P } + { P nl }
d d d Eq. 4-67
[ C ] = -------- [ M ] – --- [ K ]
2 1
Eq. 4-70
2 3
∆t
Main Index
TRD1 1775
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1 1 1 1
[ D ] { u 1 } = --- P – 1 + P 0 + P 1 + { N 0 } + [ C ] { u 0 } + [ E ] u – 1 Eq. 4-72
3
1
u – 1 = { u 0 } – { u· 0 }∆t Eq. 4-73
{ P 01 } = [ K ] { u 0 } + [ B ] { u· 0 } Eq. 4-74
1
[ D ] { U I + 2 } = --- { p I + p I + 1 + p I + 2 } + { N I + 1 } + [ C ] { u I + 1 } + [ E ] { u i } Eq. 4-76
3
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
P i ( t ) = ST ( u j ( t ) ) Eq. 4-77
where:
Main Index
1776 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
P i ( t ) = Su j ( t )u k ( t ) Eq. 4-78
S { u j ( t ) }A if u j ( t ) > 0
Pi ( t ) = Eq. 4-79
0 if u j ( t ) < 0
– S { – u i ( t ) }A if u i ( t ) < 0
Pi ( t ) = Eq. 4-80
0 if u i ( t ) > 0
–1 4
P ga ( t ) A a – F ab Aa – F ab ( 1 – α a ) σE a A a ( U a + TABS )
= – Eq. 4-81
P gb ( t ) – F ab A b – F ab ( 1 – α a ) Ab σE A ( U + TABS ) 4
b b b
The load P ga is applied to all points at A and the load P gb is applied to all points at B .
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 t = t i is output.
Main Index
TRD1 1777
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1
{ u· i } = --------- [ { u i + 1 } – { u i – 1 } ] Eq. 4-82
2∆t
is output.
The acceleration vector is given by
1
{ u· i } = -------- [ { u i + 1 } + { u i – 1 } – 2 { u i } ] Eq. 4-83
2
∆t 1
is output.
If the time step is scheduled to change at t i + 1 from ∆t 1 to ∆t 2 , the displacement for time
i + 1 has been calculated. { u i – 1 } , { u i } , and { u i + 1 } are saved along with { P i + 1 } . The
matrices are formed and decomposed as in Eq. 4-69, Eq. 4-70 and Eq. 4-71 for ∆t = ∆t 2 .
Eq. 4-84 is used for computing { u i + 2 } ,
1
[ D ] { u i + 2 } = --- { P i1 + P i + 1 + P i + 2 } + { N i + 1 } + [ C ] { u i + 1 } + [ E ] { u i1 } Eq. 4-84
3
1
{ u· i + 1 } = -------- ( { u i + 1 } – { u i } ) Eq. 4-85
∆t 1
1
{ u·· i + 1 } = -------- ( { u i + 1 } – 2 { u i } + { u i – 1 } ) Eq. 4-86
2
∆t 1
then
∆t 22
{ u i1 } = { u i + 1 } – ∆t 2 { u· i + 1 } + --------- { u·· i + 1 } Eq. 4-88
2
If the continue mode is set, TRD1 will extract the displacement ( u n ) , velocity ( u· n ) , and
acceleration ( u·· n ) from the column number specified by NOL. u 1 (the first
displacement of the continued run) is computed as follows:
Main Index
1778 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1
[ D ] { u i } = --- { P –11 + P 0 + P 1 } + { P 0 } + [ C ] { u n } + [ E ] { u –11 } Eq. 4-90
3
where
2
∆t
{ u –11 } = { u n } – ∆t { u· n } + -------- { u·· n } Eq. 4-92
2
1⁄2
ω oi = ( k i ⁄ m i ) Eq. 4-95
bi
β i = --------- Eq. 4-96
2m i
2 2 2
ωi = ω oi – β Eq. 4-97
Main Index
TRD1 1779
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
The following coefficients are generated for each distinct time increment. There are
four cases ( ε = 10 –5 and the subscript i is implied.)
1. If ω 2o > β2 + ε (underdamped):
– βh β
F = e cos ωh + ---- sin ωh Eq. 4-98
ω
1
G = ---- e sin ωh Eq. 4-99
ω
1 – βh ω – β 2ωβ
2 2
2βω
A = ---------- e - – βh sin ωh – ----------
------------------- 2
- + hω cos ωh + ----------- Eq. 4-100
2
hkω ω2 ω ωo
o o
2 2
1 – βh ω – β 2ωβ 2βω
B = ---------- e - sin ωh + ----------- cos ωh + ωh – -----------
– ------------------- Eq. 4-101
2 2 2
hkω ωo ωo ωo
2
– ω o – βh
F' = ---------- e sin ωh Eq. 4-102
ω
–β h β
G' = e cos ωh – ---- sin ωh Eq. 4-103
ω
1 – βh 2
A' = ---------- e
hkω ( β + hω o ) sin mh + ω cos ωh – ω Eq. 4-104
1 –β h
B' = ---------- [ – e ( β sin ωh + ω cos ωh ) + ω ] Eq. 4-105
hkω
2. If ω2o + β 2 < ε (critically damped):
– βh
F = e ( 1 + βh ) Eq. 4-106
– βh
G = he Eq. 4-107
1 2 1 – βh 2 2
A = ------ --- – --- e ( 2 + 2hβ + h β ) Eq. 4-108
hk β β
1 –β h
B = ---------- [ – 2 + βh – e ( 2 + hβ ) ] Eq. 4-109
hkβ
Main Index
1780 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
2 – βh
F' = β he Eq. 4-110
– βh
G' = e ( 1 + βh ) Eq. 4-111
1 – βh 2 2
A' = ------ [ e ( 1 + hβ + h β ) – 1 ] Eq. 4-112
hk
1 – βh
B' = ------ [ 1 – e ( βh + 1 ) ] Eq. 4-113
hk
3. If ω 2o < β2 – ε (over damped):
– βh β
F = e cosh ωh + ---- sinh ωh Eq. 4-114
ω
1 – ωh
G = ---- e sinh ωh Eq. 4-115
ω
1 –βh ω + β 2ωβ
2 2
2ωβ
A = ---------- e - – hβ sinh ωh – ----------- + hω cosh ω h + -----------
– ------------------ Eq. 4-116
2 2 2
hkω ωo ωo ωo
2 2
1 – βh ω + β 2ωβ 2βω
B = ---------- e – --------------------
2
sinh ωh + ----------
2
- + cosh ωh + ωh – -----------
2
Eq. 4-117
hkω ωo ωo ωo
2
ω o – βh
F' = – ------ e sinh ωh Eq. 4-118
ω
– βh β
G' = e cosh ωh – ---- sinh ωh Eq. 4-119
ω
1 – βh 2
A' = ---------- e ( β + hω o ) sinh ωh + ω cosh ω h – ω Eq. 4-120
hkω
1 – βh
B' = ---------- [ e ( β sinh ωh + ω cosh ωh ) + ω ] Eq. 4-121
hkω
4. If ωo = β ≤ ε (undamped):
F = 1 Eq. 4-122
G = H Eq. 4-123
Main Index
TRD1 1781
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
2
A = h ⁄ ( 3m ) Eq. 4-124
2
B = h ⁄ ( 6m ) Eq. 4-125
The equations for each displacement, velocity, and acceleration in terms of the applied
loads and previous displacement and velocity are:
ξ i, j + 1 = F i ξ i, j + G i ξ i, j + A i f i, j + B i f i, j + 1 Eq. 4-130
·
·· P i, j + 1 b i ξ i, j + 1 K i ξ i, j + 1
ξ i, j + 1 = ------------------ – ----------------------- – ------------------------ Eq. 4-132
m1 m1 mi
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.
Main Index
1782 TRD2
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Solves for the modal or direct, transient response, displacement, velocity, and
acceleration solution for design optimization.
Format:
TRD2 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,DSPT1,SILD,
USETD,PARTVEC/
UXT,PNL,TOL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/TRD2OPT/SETNAME $
Main Index
TRD2 1783
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
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.
Main Index
1784 TRLG
Generates applied loads in transient analysis
Format:
TRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,
GMD GOD PHDH
, , ,EST,MPT,MGG, ,
RPX V01P
APPLOD,ENFLODK,ENFLODB,ENFLODM,ENFMOTN/
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 $
Main Index
TRLG 1785
Generates applied loads in transient analysis
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.
Main Index
1786 TRLG
Generates applied loads in transient analysis
Parameters:
Main Index
TRLG 1787
Generates applied loads in transient analysis
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.
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
1788 TRNSP
Matrix transpose
Computes [ X ] = [ A ] T .
Format:
TRNSP A/X $
Remarks:
1. Transposition of matrices for matrix multiplications can also be requested
with the transpose option in MPYAD and SMPYAD.
2. If [ A ] is purged, [ X ] will be purged.
Main Index
TYPE 1789
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:
TYPE DB, dblist $
2. NDDL parameters, qualifiers and location parameters:
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
Main Index
1790 TYPE
Declares NDDL data blocks, qualifiers, and parameters.
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:
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.
Main Index
TYPE 1791
Declares NDDL data blocks, qualifiers, and parameters.
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 $
$ 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
1792 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
UEIGL Solves both linear and quadratic real unsymmetric eigenvalue problems
Format:
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 $
Main Index
UEIGL 1793
Solves both linear and quadratic real unsymmetric eigenvalue problems
Parameters:
Remarks:
1. In certain MD Nastran applications the eigenvalue problem presented
contains real, unsymmetric matrices. One such application, the direct
structural acoustic problem is formulated as:
2
[ K aa + λ M aa ]φ = 0
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:
[ K ll + λQ ll ]φ = 0
Main Index
1794 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
T 2
ψ ( K aa + λ M aa ) = 0
T
ψ ( K ll + λQ ll ) = 0
Main Index
UGVADD 1795
Adds two displacement vectors when direct addition would yield erroneous results
UGVADD Adds two displacement vectors when direct addition would yield
erroneous results
Adds two displacement vectors when direct addition based on small angle theory
would yield erroneous results. For old geometric nonlinear analysis only.
Format:
UGVADD UGNI,DUGNI,SIL/
UGNT $
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.
Main Index
1796 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.
A11 → [ A ]
A21
Format:
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.
Parameters:
Remarks:
1. The supersets formed by the union of other sets have the following
definitions.
Main Index
UMERGE 1797
Merges two matrices based on USET
sets supersets
mp
mr m
sb s
sg
o
q g
ne p
r n
c a d f fe
t
b l
lm
e
k ks
sa
j js
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.
Main Index
1798 UMERGE
Merges two matrices based on USET
Main Index
UMERGE1 1799
Merges up to four matrices based on USET
Format:
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.
Parameters:
Remarks:
1. The supersets formed by the union of other sets have the following
definitions:
Main Index
1800 UMERGE1
Merges up to four matrices based on USET
sets supersets
mp
mr m
sb s
sg
o
q g
ne p
r n
c a d f fe
t
b l
lm
e
k ks
sa
j js
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:
Main Index
UMERGE1 1801
Merges up to four matrices based on USET
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
1802 UPARTN
Partitions a matrix based on USET
Format:
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.
Parameters:
Remarks:
1. The supersets formed by the union of other sets have the following
definitions:
Main Index
UPARTN 1803
Partitions a matrix based on USET
sets supersets
mp
mr m
sb s
sg
o
q g
ne p
r n
c a d f fe
t
b l
lm
e
k ks
sa
j js
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:
Main Index
1804 UPARTN
Partitions a matrix based on USET
c. UPARTN USET,KFF/KOO,KAO,KOA,KAA/'F'/'O' $
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. UPARTN USET,PHTOM/PHRC,,/'T+O+M'/'R+C'//1 $
3. Partition [KGG] into the q-set and its complement, columns only:
[ K gg ] ⇒ K gq K gcomp
a. UPARTN USET,KGG/KGQ,,KGCOMP,/’G’/’Q’//2 $
Main Index
UREDUC 1805
Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
UREDUC Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
Reduces rectangular matrices of displacements or loads from the p-set (or g-set) to the
d- and/or h-set.
Format:
Parameters:
None.
Main Index
1806 UREDUC
Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
Remarks:
1. If PHDH is purged PH will not be output.
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 1807
Creates tables based on solution set output requests
Creates tables based on solution set output requests for displacements, velocities,
accelerations, and nonlinear loads.
Format:
EQDYN USETD
VDR CASECC, , ,UXY,OL,XYCDB,PNL,MODSELT/
EQEXIN USET
OUXY1,OPNL1/
APP/SOLTYP/S,N,NOSORT2S/S,N,NOSOUT/S,N,NOSDR2/
FMODE/S,N,NOSORT2 $
Main Index
1808 VDR
Creates tables based on solution set output requests
Parameters:
Remarks:
1. PP may be purged only if UDV is purged.
2. PNL, XYCDB, OUXY1, and OPNL1 may be purged.
Main Index
VEC 1809
Creates partitioning vector based on USET
Format:
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.
Parameters:
Remarks:
1. The supersets formed by the union of other sets have the following
definitions:
Main Index
1810 VEC
Creates partitioning vector based on USET
sets supersets
mp
mr m
sb s
sg
o
q g
ne p
r n
c a d f fe
t
b l
lm
e
k ks
sa
j js
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 [ K ff ] 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' $
Main Index
VEC 1811
Creates partitioning vector based on USET
Main Index
1812 VECPLOT
Transforms, searches, and computes resultants of matrices
Format:
LAMA
VECPLOT XG,BGPDT,SCSTM,CSTM,CASECC, ,
USET
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.
Main Index
VECPLOT 1813
Transforms, searches, and computes resultants of matrices
Parameters:
Main Index
1814 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.
u' z = u x + u y + u z + θ x + θ y + θ z ,
Main Index
VECPLOT 1815
Transforms, searches, and computes resultants of matrices
y' = u y + y
z' = u z + z
where u x , u y , u z 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.
4 A six rows by g-column rigid body matrix None.
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.
5 Same as IOPT=1.
6 A g-row by 6-column rigid body matrix where None.
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).
T –1
[ XOUT ] = [ XOUT4 ] [ DRR ]
Main Index
1816 VECPLOT
Transforms, searches, and computes resultants of matrices
Main Index
VECPLOT 1817
Transforms, searches, and computes resultants of matrices
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//$
Main Index
1818 VIEW
Computes heat transfer radiation view factors
Format:
VIEW EST,BGPDT,EQEXIN,EPT,EDT,MATPOOL/
MPOOL $
MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images.
Parameters:
None.
Main Index
VIEWP 1819
Generates geometry tables for view mesh in p-element data recovery
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:
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 $
Main Index
1820 VIEWP
Generates geometry tables for view mesh in p-element data recovery
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.
Parameters:
Main Index
WEIGHT 1821
Calculates model's volume and/or weight
Format:
WEIGHT VELEM,EST,MPT,DIT,OPTPRM,OGPWG,DESTAB,XINIT/
WMID,WGTM/
WGTVOL/S,N,VOLS/S,N,FRMS/SEID/DOFRMASS $
Parameters:
Main Index
1822 WEIGHT
Calculates model's volume and/or weight
Main Index
XSORT 1823
Reads and sorts Bulk Data Section
Format:
XSORT FORCE,BULKOLD/
BULK,UBULK/
S,N,NOGOXSRT/S,N,QUALNAM/S,N,NEXTID/S,N,LASTBULK/
S,N,EQVBLK $
Parameter:
Main Index
1824 XSORT
Reads and sorts Bulk Data Section
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 $
Main Index
XYPLOT 1825
Writes plot information to plot file (.plt)
Format:
XYPLOT XYPLOT// $
Parameters:
None.
Main Index
1826 XYTRAN
Creates table of plot instructions for x-y plots
XYTRAN XYCDB,OPG2,OQG2,OUG2,OES2,OEF2,OSTR2,OQMG2,
OVG2,OAG2/
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 $
‘MODE’
/’PSET’/XYSET/S,N,PLTNUM/UNUSED/
‘RESP’
S,N,NOXYPLOT/S,N,TABID $
XYTRAN XYCDB,OUXY2,OPNL2,,,,,,,/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
Main Index
XYTRAN 1827
Creates table of plot instructions for x-y plots
XYTRAN XYCDB,PSDF,AUTO,,,,,,,/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
Main Index
1828 XYTRAN
Creates table of plot instructions for x-y plots
Parameters:
Main Index
XYTRAN 1829
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 $
Main Index
1830 XYTRAN
Creates table of plot instructions for x-y plots
Main Index
1831
I N D E X
MD Nastran 2006 DMAP Programmer’s Guide
MD Nastran
2006 DMAP
Programmer’s
Guide
A list of, 853
Expressions and operators
Arithmetic operators, 10 arithmetic operators, 10
character operator (&), 10
logical operators, 11
C relational operators, 11
Character operator (&), 10
F
D File management statements, 2
Data block Functions, intrinsic, 20
automatic deletion of, 39
basic definition of, 2
local, definition of, 15 L
permanent, definition of, 15 Logical operators, 11
rules for, 39
scratch, definition of, 15
states of, 15 M
DATABLK NDDL statement, 835, 836
MATPRN DMAP module, 1378
DBset, 15 Matrix modules
DEPEN NDDL statement, 845
description summary, 855
DMAP list of, 852
general rules, 3
Matrix trailer, 13
last time used (LTU) instruction, 39
output from previous module" rule, 38
DMAP control statements
conditional branching, 31
N
NDDL (Nastran Data Definition Language)
DO WHILE DMAP statement, 34
looping, 33 basic definition of, 2
DATABLK NDDL statement, 836
DMAP modules
basic definition, 2 DEPEN NDDL statement, 845
PARAM NDDL statement, 847
description summary, by category, 852
detailed descriptions of,, see also specific PATH NDDL statement, 849
purpose of, 834
module name
list of, by category, 852 QUAL NDDL statement, 850
summary of statements, 834
obsolete, 858
DO WHILE DMAP statement, 34 syntax of descriptions, 835
Main Index
E O
Obsolete modules, list of, 858
Errors, see also user errors
Executive modules OFP DMAP module, 1506
Operators,, see also expressions and
description summary, 858
1832 INDEX
operators
OUTPUT2 DMAP module, 1515
OUTPUT4 DMAP module, 1528
P
PARAM NDDL statement, 847
Parameters
basic definition of, 2
PATH NDDL statement, 849
Preface modules, 40
PRTPARM DMAP module, 1557
Q
QUAL NDDL statement, 850
R
Relational operators, 11
S
SCRATCH data block
automatic deletion of, 39
special rules for, 39
SOLution 100, 40
Solution sequences, definition of, 2
SubDMAP
DBFETCH, 42
DBMGR, 42
DBSTORE, 42
U
Upward compatibility in Version 68,, see
also V68 DMAP changes
User errors, processing of, 41
User fatal message 1126,, see also DMAP
output from previous module" rule
Utility modules
description summary, 856
list of, 852
Index
Main Index