Professional Documents
Culture Documents
Main Index
Corporate Europe Asia Pacific
MSC.Software Corporation MSC.Software GmbH Asia Pacific
2 MacArthur Place Am Moosfeld 13 MSC.Software Japan Ltd.
Santa Ana, CA 92707 81829 Munich Shinjuku First West 8F
Telephone: (800) 345-2078 GERMANY 23-7 Nishi Shinjuku
FAX: (714) 784-4056 Telephone: (49) (89) 43 19 87 0 1-Chome, Shinjuku-Ku
Fax: (49) (89) 43 61 71 6 Tokyo 160-0023, JAPAN
Telephone: 0120-924-832 (toll
free, Japan only)
Mobile phone: 03-6911-1222
Fax: (81) (3)-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 2011 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. PCGLSS 6.0, Copyright © 1992-2005, Computational Applications and System
Integration Inc. All rights reserved. PCGLSS 6.0 is licensed from Computational Applications and System
Integration Inc. METIS is copyrighted by the regents of the University of Minnesota. A copy of the METIS product
documentation is included with this installation. Please see "A Fast and High Quality Multilevel Scheme for
Partitioning Irregular Graphs". George Karypis and Vipin Kumar. SIAM Journal on Scientific Computing, Vol. 20,
No. 1, pp. 359-392, 1999.
MSC, MD, Dytran, Marc, MSC Nastran, MD Nastran, Patran, the MSC.Software corporate logo, OpenFSI 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. Revision 0. July 15, 2010
Main Index
C O N T E N T S
MSC Nastran DMAP Programmer’s Guide
Table of Contents
Table of Contents
Preface About This Book, viii
List of MSC Nastran Books, ix
Technical Support, x
1
Direct Matrix Introduction, 2
Abstraction
The MSC Nastran DMAP Language, 3
Parameters, 4
Constant Parameters, 4
Variable Parameters, 6
Expressions and Operators, 8
Data Blocks, 12
Table Trailers, 12
Matrix Trailers, 12
Data Block Type and Status, 13
Instructions, 15
Modules, 15
Statements, 18
“Output from a Previous Module” Rule, 37
Automatic Deletion of Scratch Data Blocks, 38
Preface Modules and SOLution 100, 39
Processing of User Errors, 40
SubDMAPs DBMGR, DBSTORE, and DBFETCH, 41
WHERE and CONVERT Clauses, 43
2
Data Blocks Introduction, 46
Matrix Data Blocks, 47
Main Index
Table Data Blocks, 49
IFP Tables, 49
IFP Table Header Words and Trailer Bits, 49
OFP Tables, 50
Table_code, 52
Table Descriptions, 65
Data Block Descriptions, 66
- BGPDT, 66 - GEOM301, 270
- BGPDT68, 68 - GEOM4, 271
- CASECC, 69 - GEOM4705, 299
- CLAMA, 88 - GPDT68, 300
- CONTAB, 90 - GPL, 302
- CSTM, 91 - HIS, 303
- CSTM68, 93 - KDICT, 304
- DBCOPT, 99 - LAMA, 306
- DESTAB, 101 - MPT, 308
- DIT, 102 - OBJTAB, 324
- DSCMCOL, 107 - OEE, 325
- DVPTAB, 116 - OEF, 329
- DYNAMIC, 117 - OES, 381
- EGPSF, 133 - OGF, 505
- EGPSTR, 137 - OGS, 510
- ELDCT, 140 - OPG, 516
- EPT, 142 - OPTPRM, 521
- EPT01, 179 - OQG, 523
- EQEXIN, 181 - OUG, 528
- ERROR, 183 - R1MAP, 538
- FOL, 184 - R1TAB, 539
- GEOM1, 185 - RESP12, 546
- GEOM168, 198 - SEMAP, 550
- GEOM2, 201 - SET, 554
- GEOM201, 246 - TOL, 555
- GEOM3, 255 - VIEWTB, 556
3
Nastran Data NDDL Summary, 562
Definition Language
Detailed Description of NDDL Statements, 563
(NDDL)
- DATABLK, 564 - PATH, 577
- DEPEN, 573 - QUAL, 578
- PARAM, 575
4
DMAP Modules and DMAP Module and Statement List, 580
Statements Matrix Modules, 580
Main Index
Utility Modules, 581
Executive Modules and Statements, 581
Miscellaneous Modules and Statements, 582
DMAP Module and Statement Description Summary, 585
Matrix Modules, 585
Utility Modules, 586
Executive Modules and Statements, 587
Obsolete Modules and Statements, 588
Detailed Descriptions of DMAP Modules and Statements, 589
- ACMG, 589 - DBDELETE, 682
- ADAMSMNF, 592 - DBDICT, 684
- ADAMSRBM, 595 - DBEQUIV, 698
- ADAPT, 596 - SubDMAP DBFETCH, 701
- ADD, 599 - SubDMAP DBMGR, 703
- ADD5, 601 - DBSTATUS, 707
- ADG, 603 - SubDMAP DBSTORE, 708
- ADJMOD, 605 - DBVIEW, 710
- ADR, 606 - DCMP, 713
- AELOOP, 608 - DDR2, 717
- AEMODEL, 611 - DDRMM, 720
- AFPMP, 612 - DECOMP, 723
- AIEMGA, 614 - DELETE, 728
- AMG, 616 - DIAGONAL, 729
- AMP, 618 - DISDCMP, 731
- APD, 620 - DISFBS, 733
- APPEND, 622 - DISOFPM, 734
- ASDR, 625 - DISOFPS, 735
- ASG, 627 - DISOPT, 736
- AXMDRV, 629 - DISPARM, 739
- AXMPR1, 630 - DISUTIL, 740
- AXMPR2, 631 - DIVERG, 744
- BCDR, 632 - DLT2SLT, 746
- BDRYINFO, 634 - DMPCASE, 747
- BGCASO, 636 - DMIIN, 748
- BGP, 637 - DOM10, 749
- BMG, 639 - DOM11, 752
- BNDSPC, 641 - DOM12, 754
- CAMPREP, 643 - DOM6, 760
- CASE, 645 - DOM9, 762
- CEAD, 650 - DOPFS, 765
- CMPZPR, 655 - DOPR1, 767
- CMSENGY, 656 - DOPR2, 771
- COPY, 659 - DOPR3, 773
- CURV, 660 - DOPR3X, 777
- CURVPLOT, 662 - DOPR4, 778
- CYCLIC1, 664 - DOPR5, 779
- CYCLIC2, 666 - DOPR6, 781
- CYCLIC3, 668 - DOPRAN, 783
- CYCLIC4, 670 - DPD, 784
- DBC, 674 - DRMH1, 787
Main Index
- DRMH3, 789 - FBODYLD, 889
- DRMS1, 791 - FBS, 890
- DSABO, 793 - FILE, 893
- DSAD, 795 - FORTIO, 895
- DSADJ, 802 - FRLG, 897
- DSADX, 805 - FRLGEN, 899
- DSAE, 807 - FRQDRV, 901
- DSAF, 809 - FRRD1, 902
- DSAH, 811 - FRRD2, 905
- DSAJ, 815 - GENTRAN, 908
- DSAL, 817 - GETCOL, 910
- DSAM, 821 - GETMKL, 911
- DSAN, 822 - GI, 912
- DSAP, 823 - GIC2C, 914
- DSAPRT, 825 - GKAM, 915
- DSAR, 826 - GNFM, 919
- DSARLP, 828 - GP0, 921
- DSARME, 830 - GP1, 923
- DSARSN, 831 - GP2, 925
- DSAW, 833 - GP3, 927
- DSDVRG, 834 - GP4, 929
- DSFLTE, 835 - GP5, 933
- DSFLTF, 837 - GPFDR, 935
- DSGRDM, 838 - GPJAC, 939
- DSMA, 839 - GPSP, 940
- DSPRM, 841 - GPSTR1, 944
- DSTA, 844 - GPSTR2, 945
- DSTAP2, 846 - GPSTRPBX, 947
- DSVG1, 847 - GPWG, 948
- DSVG1P, 850 - GUST, 953
- DSVG2, 852 - GUSTLDW, 955
- DSVG3, 854 - GYROLD, 956
- DSVGP4, 855 - IFP, 957
- DSVGP5, 857 - IFP1, 960
- DTIIN, 859 - IFP3, 962
- DUMMOD1, 860 - IFP4, 964
- DUMMOD2, 861 - IFP5, 966
- DUMMOD3, 862 - IFP6, 968
- DUMMOD4, 863 - IFP7, 970
- DVIEWP, 864 - IFP8, 971
- DYNCXPNT, 866 - IFP9, 972
- EFFMASS, 867 - IFP10, 974
- ELFDR, 869 - IFPINDX, 975
- ELTPRT, 870 - IFPBSH2, 976
- EMA, 873 - IFT, 977
- EMAKFR, 875 - ILMP1, 982
- EMG, 876 - ILMP2, 983
- EQUIVX, 881 - ILMPGPF, 984
- ESTINDX, 883 - INDXBULK, 985
- EXPORTLD, 884 - INPUTT2, 986
- FA1, 885 - INPUTT4, 989
- FA2, 887 - INTERR, 991
Main Index
- ISHELL, 993 - MODUSET, 1155
- LAMX, 995 - MONVEC, 1158
- LANCZOS, 1000 - MONVEC3, 1159
- LCGEN, 1003 - MPP, 1160
- LMATPRT, 1005 - MPPTRAN, 1162
- MACOFP, 1006 - MPYAD, 1164
- MAKAEFA, 1007 - MRGCOMP, 1170
- MAKAEFS, 1009 - MRGCSTM, 1171
- MAKAEMON, 1010 - MRGMON, 1172
- MAKCOMP, 1011 - MSGHAN, 1173
- MAKENEW, 1012 - MSGSTRES, 1174
- MAKEOLD, 1014 - MTRXIN, 1175
- MAKETR, 1016 - NASSETS, 1181
- MAKMON, 1018 - NDINTERP, 1182
- MASSCOMB, 1019 - NEWUSET, 1183
- MATGEN, 1020 - NLCOMB, 1184
- MATGPR, 1033 - NLHARM, 1186
- MATMOD, 1038 - NLICLOOP, 1188
- MATOFP, 1084 - NLITER, 1189
- MATPCH, 1088 - NLRSLOOP, 1195
- MATPRN, 1090 - NLRSMAP, 1197
- MATPRT, 1091 - NLSOLV, 1198
- MATREDU, 1092 - NLTRD, 1205
- MCE1, 1095 - NLTRD2, 1209
- MCE2, 1096 - NLTRLG, 1214
- MCFRAC, 1098 - NORM, 1216
- MDATA, 1100 - NSMEPT, 1218
- MDCASE, 1102 - OFP, 1219
- MDENZO, 1106 - OPTGP0, 1222
- MDISUTIL, 1111 - ORTHOG, 1224
- MERGE, 1112 - OUTADF, 1226
- MERGEOFP, 1117 - OUTPRT, 1227
- MESSAGE, 1118 - OUTPUT2, 1230
- MGEN, 1120 - OUTPUT4, 1241
- MKCNTRL, 1122 - PARAML, 1247
- MKCSTMA, 1123 - PARTN, 1267
- MKMNTIFP, 1124 - PCOMB, 1272
- MKRBVEC, 1125 - PCOPY, 1274
- MKSPLINE, 1127 - PFCALC, 1275
- MODACC, 1129 - PFOFP, 1279
- MODCASE, 1131 - PLOT, 1280
- MODENRGY, 1132 - PLTHBDY, 1282
- MODEPF, 1134 - PLTSET, 1283
- MODEPOUT, 1137 - PNCHGRP, 1285
- MODEPT, 1140 - PNMKGRP, 1286
- MODGDN, 1141 - PRESOL, 1288
- MODGM2, 1142 - PROJVER, 1291
- MODGM4, 1146 - PRTMSG, 1292
- MODQSET, 1148 - PRTPARM, 1293
- MODTRK, 1150 - PURGEX, 1295
- MODTRL, 1152 - PVT, 1296
- MODUG, 1154 - RANDOM, 1298
Main Index
- RBMG3, 1306 - SEPR1, 1415
- RBMG4, 1308 - SEQP, 1416
- READ, 1309 - SHPCAS, 1422
- RESMOD, 1317 - SMA3, 1423
- RESTART, 1322 - SMPYAD, 1424
- RMDUPBLK, 1325 - SOLVE, 1426
- RMG2, 1326 - SOLVIT, 1428
- ROTOR, 1328 - SSG1, 1434
- ROTRDR1, 1330 - SSG2, 1438
- ROTRDR2, 1332 - SSG3, 1441
- ROTRUTL, 1334 - SSG4, 1444
- RSPEC, 1343 - ST2DYN, 1446
- SCALAR, 1345 - STATICS, 1447
- SDP, 1347 - STDCON, 1449
- SDR1, 1349 - STRSORT, 1451
- SDR2, 1353 - TA1, 1453
- SDR3, 1358 - TA1M, 1456
- SDRCOMP, 1359 - TABEDIT, 1458
- SDRHT, 1361 - TABPRT, 1463
- SDRNL, 1363 - TABPT, 1472
- SDRP, 1365 - TAFF, 1473
- SDRX, 1368 - TAHT, 1474
- SDRXD, 1370 - TASNP1, 1476
- SDSA, 1372 - TASNP2, 1477
- SDSB, 1374 - TIMETEST, 1479
- SDSC, 1376 - TOLAPP, 1485
- SECONVRT, 1377 - TRD1, 1487
- SEDR, 1378 - TRD2, 1498
- SEDRDR, 1380 - TRLG, 1500
- SEEFMBND, 1383 - TRNSP, 1504
- SEEFMCLF, 1384 - TYPE, 1505
- SEEFMDMP, 1386 - UEIGL, 1509
- SEEFMLST, 1387 - UGVADD, 1512
- SEEFMNOR, 1388 - UMERGE, 1513
- SEEFMOUT, 1389 - UMERGE1, 1516
- SEEFMXIT, 1390 - UPARTN, 1519
- SELA, 1391 - UREDUC, 1522
- SEMA, 1393 - VDR, 1524
- SEP1, 1395 - VEC, 1526
- SEP1X, 1397 - VECPLOT, 1529
- SEP2, 1400 - VIEW, 1534
- SEP2CT, 1402 - VIEWP, 1535
- SEP2DR, 1403 - WEIGHT, 1537
- SEP2X, 1407 - XSORT, 1539
- SEP3, 1409 - XYPLOT, 1541
- SEP4, 1411 - XYTRAN, 1542
- SEPLOT, 1413
Glossary Data Block Glossary, 1547
Data Block Naming Conventions, 1628
Parameter Glossary, 1632
Parameter Naming Conventions, 1690
Main Index
Preface
DMAP Programmer’s Guide
Preface
About This Book
List of MSC Nastran Books
Technical Support
Main Index
viii DMAP Programmer’s Guide
About This Book
Main Index
Preface ix
List of MSC Nastran Books
User’s Guides
• Getting Started
• Linear Static Analysis
• Dynamic Analysis
• MSC Nastran Demonstration Problems
• Thermal Analysis
• Superelements
• Design Sensitivity and Optimization
• Implicit Nonlinear (SOL 600)
• Explicit Nonlinear (SOL 700)
• Aeroelastic Analysis
• User Defined Services
• EFEA User’s Guide
• EFEA Tutorial
• EBEA User’s Guide
Main Index
x DMAP Programmer’s Guide
Technical Support
Technical Support
For technical support phone numbers and contact information, please visit:
http://www.mscsoftware.com/Contents/Services/Technical-Support/Contact-Technical-Support.aspx
Support Online. The Support Center provides technical articles, frequently asked questions and
documentation from a single location.
Main Index
Chapter 1: Direct Matrix Abstraction
DMAP Programmer’s Guide
Introduction
The MSC Nastran DMAP Language
Data Blocks
Instructions
“Output from a Previous Module” Rule
Automatic Deletion of Scratch Data Blocks
Preface Modules and SOLution 100
Processing of User Errors
SubDMAPs DBMGR, DBSTORE, and DBFETCH
WHERE and CONVERT Clauses
Main Index
2 DMAP Programmer’s Guide
Introduction
Introduction
MSC 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 MSC 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 MSC 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 MSC 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 (MSC
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), 561.
MSC Nastran provides the user with a variety of prewritten solution sequences. These solution sequences
consist of a series of DMAP statements. MSC 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 (Ch. 2) in the MSC Nastran
Quick Reference Guide.
Main Index
Chapter 1: Direct Matrix Abstraction 3
The MSC Nastran DMAP Language
Main Index
4 DMAP Programmer’s Guide
Parameters
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.
Constant Parameters
A constant represents a fixed value and is a number (integer, real, or complex), logical, or character
string.
Main Index
Chapter 1: Direct Matrix Abstraction 5
Parameters
Integer Constants
An integer constant is a whole number with no decimal point. Its form is
snn
where:
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:
where:
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 MSC Nastran. Leading zeros are ignored in counting the
leftmost 14 digits.
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.
Main Index
6 DMAP Programmer’s Guide
Parameters
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:
• Assignment (=) statement output
• DMAP module output with "S,N" prefix
• CALL statement output with "S," prefix
• SUBDMAP statement parameter list
If one or more of the above is not satisfied, then User Fatal Message 439 will be issued during DMAP
compilation.
Main Index
Chapter 1: Direct Matrix Abstraction 7
Parameters
5. Default value from the NDDL, if the NDDL keyword is specified on the TYPE DMAP statement.
Parameters listed in the NDDL always have a default value of zero, blank, or FALSE, unless a
value is explicitly given in the PARAM NDDL statement.
Determining the current value of a variable parameter is also summarized in the following table.
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
8 DMAP Programmer’s Guide
Parameters
• If the parameter's value is to be specified in the Case Control or Bulk Data Section, then type the
parameter near the top of the DMAP sequence:
TYPE PARM,,type,Y,param_name $
• If the parameter's default value is defined on the NDDL PARAM statement and you wish to use
the NDDL default value, then type the parameter near the top of the DMAP sequence:
TYPE PARM,NDDL,type,Y,param_name $
• If the desired default value differs from the MPL default, then specify the parameter and the
default value on a TYPE statement:
TYPE PARM,,type,Y,param_name=default_value $
• Specify in module instructions, as needed, "/param_name/" or "/S,N,param_name/"
• Do not use the following obsolete parameter prefix specifications in module instructions:
/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
Chapter 1: Direct Matrix Abstraction 9
Parameters
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.
Sample
Operator Operation Expressions Interpreted As
-,+ Negative or Positive X-Y X(-Y)
immediately preceded
by exponentiation
** Exponentiation -X**Y -(X**Y)
-,+ Negative or Positive -X - Y (-X) - Y
*,/ Multiplication or Division X*Y+Z (X*Y)+Z
+,- Addition or Subtraction X+Y X+Y
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.
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.
Main Index
10 DMAP Programmer’s Guide
Parameters
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
X XOR Y TRUE TRUE FALSE
TRUE FALSE TRUE
FALSE TRUE TRUE
FALSE FALSE FALSE
Main Index
Chapter 1: Direct Matrix Abstraction 11
Parameters
Operator X Y Output
X EQV Y TRUE TRUE TRUE
TRUE FALSE FALSE
FALSE TRUE FALSE
FALSE FALSE TRUE
Main Index
12 DMAP Programmer’s Guide
Data Blocks
Data Blocks
A data block is a table or matrix represented by a symbolic name. All data blocks are comprised of
records. Each record can contain a variable number of words.
The first record ("Record 0") is called the header record, of which the first two words (when
concatenated) form the name of the data block. The third and subsequent words are not usually used.
The subsequent records are sometimes called "data records." For tables the data record can contain a
mixture of any type of data; i.e, real, integer, complex, character, etc. For matrices the data record
corresponds to the nonzero values in the column of the matrix; e.g., record 3 corresponds to the nonzero
values in column 3.
The last record is called the trailer record and contains summary information about the table or matrix.
More detailed descriptions of a data block’s records are appear in Data Blocks, 45.
Table Trailers
In tables, the trailer record contains six words. The contents vary among the tables and are described in
Data Blocks, 45 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
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
Main Index
Chapter 1: Direct Matrix Abstraction 13
Data Blocks
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
14 DMAP Programmer’s Guide
Data Blocks
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
Chapter 1: Direct Matrix Abstraction 15
Instructions
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, 589. 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
MSC 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
[D] = SIGNAB*[A]T[B] + SIGNC*[C]
where [A], [B], [C] and [D] represent matrices, and SIGNAB and SIGNC represent the sign to be applied
to the product and additive matrices, respectively.
The format of the MPYAD module is:
MPYAD , A , B , C / D / T / SIGNAB / SIGNC / PREC / FORM $
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:
Main Index
16 DMAP Programmer’s Guide
Instructions
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.
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, 589. If a parameter is
unspecified, then the default value is assumed and obtained from the MPL. For example,
MPYAD A , B , / D $
Main Index
Chapter 1: Direct Matrix Abstraction 17
Instructions
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,,,,,,/ $
Each module has its own rules for parameter specification, as described in Detailed Descriptions of DMAP
Modules and Statements, 589. 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.
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:
Main Index
18 DMAP Programmer’s Guide
Instructions
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.
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.
Main Index
Chapter 1: Direct Matrix Abstraction 19
Instructions
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
Abbreviation Type
I Integer
R, RS, or RD Real
C, CS, or CD Complex
A Character
L Logical
Main Index
20 DMAP Programmer’s Guide
Instructions
Argument Type
Format Definition Result to Result Type
ABS x absolute value x if x is I or R I to I
2 2
a +b x, if x = a + ib
R and C to R
ACOS x arccosine –1
cos x where I and R to C
– 1 x 1 , if x is I or R
C to C
The result is computed in radians.
ACOSH x hyperbolic arccosine cosh (x)
–1 I and R to R
x1
C to C
For real and integer arguments, values less than 1 result in errors.
ANDL x y numeric AND TRUE if x 0 and y 0 I, R, and C to L
FALSE otherwise
ASIN x arcsin –1
sin x where I and R to R
– 1 x 1 , if x is I or R
C to C
The result is computed in radians.
ASINH x hyperbolic sine sinh (x)
–1 I and R to R
C to C
ATAN x arctangent –1
tan (x) I and R to R
C to C
The result is computed in radians.
ATAN2 x1 x2 arctangent of quotient –1
tan (x1 x2) I and R to R
C to C
Main Index
Chapter 1: Direct Matrix Abstraction 21
Instructions
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 .
If x1 and x2 are complex x1 = a + bi and x2 = c + di and:
a = b = 0 and (sign of c ) = (sign of d ), then the result is 0.
a = b = 0 and sign of c sign of d , then the result is .
(sign of a ) = (sign of b ) and c = d = 0 , then the result is 2 .
sign of a sign of b and c = d = 0 , then the result is – 2 .
ATANH x hyperbolic arctangent –1
tanh x where I and R to R
– 1 x 1 , if x is I or R
C to C
ATANH2 (x1,x2) hyperbolic arctangent –1
tanh x1 x2 I and R to R
of quotient
C to C
For real arguments, the following must be true: x1 x2 and x2 0 .
If x1 and x2 are complex ( x1 = a + bi and x2 = c + di ) and:
a = b = 0 and (sign of c ) = (sign of d ), then the result is 0.
a = b = 0 and sign of c sign of d , then the result is .
(sign of a ) = (sign of b ) and c = d = 0 , then the result is 2 .
sign of a sign of b and c = d = 0 , then the result is – 2 .
CHAR x character value See note below. I to A
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 must be within the range 1 to n – 1 , where
number of bits per character
n = 2 .
CLEN c character length Character string length in A to I
multiples of 4
CLOCK( ) CPU time in sec. since I
job started
Main Index
22 DMAP Programmer’s Guide
Instructions
Argument Type
Format Definition Result to Result Type
CMPLX a b convert to complex a + ib See below
x, if complex
CMPLX x x + i0 , otherwise
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.
CONCAT1(a1,a2) full word concatenation a1 & a2 A to A
CONCAT2(a1,a2) concatenation a1 & a2 A to A
Any trailing blanks of a1 are compressed to a single blank before a2 is
concatenated.
CONCAT3(a1,a2) concatenation a1 & a2 A to A
The result is argument 1, with trailing blanks removed and argument 2
concatenated together.
CONJG x complex a – ib is conjugate to C to C
conjugate a + ib
Main Index
Chapter 1: Direct Matrix Abstraction 23
Instructions
Argument Type
Format Definition Result to Result Type
DIM (x1,x2) positive difference x1 - MIN(x1,x2) I to I, R to R
C not allowed
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.
DLABLANK x remove all blanks ’AB’ = DLABLANK(’A A to A
(collapse string) B’)
DLXBLANK x replace multiple blanks ’AB’ = DLXBLANK(’A A to A
with blank (compress B’)
string)
DPROD(x1,x2) double product x1 x2 I to RD, R to RD
C to CD
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.
EQVL (x,y) numeric equivalence I,R,C to L
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
Main Index
24 DMAP Programmer’s Guide
Instructions
Argument Type
Format Definition Result to Result Type
IMAG x imaginary part b, for x = a + ib I,R,C to R
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.
IMPL (x,y) numeric implication I,R,C to L
The result is FALSE if the first argument is negative and the second is
positive or zero. The result is true otherwise.
INDEX (a1,a2) start position of a2 in 2 = INDEX(’ABC’,’B’) A to I
a1
The result is zero if the second string is not found in the first string.
INDEXSTR start position of a2 A,I to I
(a1,a2 x1 x2) from x1 to x2 in a1
Arguments 1 and 2 must be character strings.
Arguments 3 and 4 must be numeric values. Prior to use as substring
subscripts, both arguments are converted to integers and checked for
range of 1 to 80.
If the lower string subscript is less than 1, it is changed to 1. If the
upper string subscript is greater than 80, it is changed to 80.
The larger string subscript value becomes the upper substring
subscript.
The result is zero if the second string is not found in the substring of
the first string.
INT x type to I largest integer in abs x I,R,C to I
with sign of x
For complex arguments the function is applied to the real component.
ITOL x type to L TRUE, if x 0 I,R to L
FALSE, if x 0
LEQ (a1,a2) lexical TRUE, if a1 = a2 A to L
equality FALSE otherwise
LGE (a1,a2) lexical greater TRUE, if a1 a2 A to L
than or equal to FALSE, if a1 a2
Main Index
Chapter 1: Direct Matrix Abstraction 25
Instructions
Argument Type
Format Definition Result to Result Type
LGT (a1,a2) lexical greater TRUE, if a1 a2 A to L
than FALSE, if a1 a2
LLE (a1,a2) lexical less TRUE, if a1 a2 A to L
than or equal FALSE otherwise
LLT (a1,a2) lexical less TRUE, if a1 a2 A to L
than FALSE otherwise
LNE (a1,a2) lexical not TRUE, if a1 a2 A to L
equal to FALSE otherwise
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.
LOG x natural logarithm log e x I,R to R, C to C
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.
LOG10 x Common logarithm log 10 x I,R to R, C to C
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.
LOGX (x1,x2) base x logarithm log 1 x2 I,R to R C to C
The first argument is the base of the logarithm.
The second argument is the number for which the logarithm must be
determined.
If the first argument is negative or 0, natural logarithms are assumed.
If the first argument is 1, common logarithms are assumed. If the first
argument is positive and not equal to 1, this value is used as the
logarithm base.
LTOI x type to I -1, if x is TRUE L to I
+1, if x is FALSE
MCGETSYS (x,y) MODCOM get I output
The value of y ranges from 1 to 10.
Returns the value of system cell 70 + y . The command is similar in
operation to GETSYS (x,70 + y) .
MCPUTSYS (x,y) MODCOM put I output
Main Index
26 DMAP Programmer’s Guide
Instructions
Argument Type
Format Definition Result to Result Type
The value of y ranges from 1 to 10.
Returns the value of system cell 70 + y . The command is similar in
operation to PUTSYS (x,70 + y) .
MAX( x1 , x2 ,...) choosing the largest max(x1,x2,...) I to I, R to R
argument
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.
MIN(x1,x2,...) choosing the smallest min(x1,x2,...) I to I, R to R
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.
MOD(x1,x2) remainder x1 – x2 INT(x1 x2) I to I, R to R
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.
NEQVL(X,Y) numeric I,R,C to L
nonequivalence
The result is TRUE if the signs of the arguments are different, FALSE
otherwise.
NINT x type to I with Round-off INT x + 0.5 , if x 0 I,R,C to I
INT x – 0.5 , if x 0
For complex arguments the function is applied to the real component.
NOOP() no-operation returns TRUE logical output
no input
Main Index
Chapter 1: Direct Matrix Abstraction 27
Instructions
Argument Type
Format Definition Result to Result Type
NORMAL x normalize 2 2 C to R
a +b
if x = a + ib
NOTL x numeric not FALSE if x 0 I,R,C to L
TRUE otherwise
NUMEQ (x1,x2) equality TRUE, if x1 = x2 I,R,C to L
FALSE otherwise
NUMGE (x1,x2) greater than or TRUE if x1 x2 I,R,C to L
equal to FALSE, if x1 x2
NUMGT(x1,x2) greater than TRUE, if x1 x2 I,R,C to L
FALSE, if x1 x2
NUMLE(x1,x2) less than or equal to TRUE if x1 x2 I,R,C to L
FALSE otherwise
NUMLT(x1,x2) less than TRUE, if x1 x2 I,R,C to L
FALSE otherwise
NUMNE(x1,x2) not equal to TRUE, if x1 x2 I,R,C to L
FALSE otherwise
ORL(x1,x2) numeric or TRUE, if x1 <0 or x2 < 0 I,R,C to L
FALSE otherwise
PI(x) multiples of pi x I,R to R, C to C
Main Index
28 DMAP Programmer’s Guide
Instructions
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.
Result precision determined by argument precision. Real double
arguments return real double results. Integer and real single
arguments return real single results.
If the argument is greater than 0, calculate new random seed value,
based on this value, before generating random number. Provides
reproducible random sequence.
If the argument equals 0, generate new random number from last
random number generated.
If the argument is less than 0, calculate new random seed value, based
on this value and current wall clock time, before generating random
number. Provides nonreproducible random sequence.
RDIAGON(x,y) turns on DIAG TRUE if x>0, and y<65 I to L
over range x to y FALSE otherwise
The function turns on the DIAGs within the range x,y.
The value of TRUE is returned if the operation was successful.
REAL(x) Type to R real(x) I,R to R, C to R
a, if x=a+ib
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.
RTIMTOGO() remaining CPU time returns R
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.
SETCORE(x) set core Initialize all words in I,RS,L
memory to the value x
SIGN(x1,x2) transfer of sign x1 , if x2 0 I to I, R to R
– x1 , if x2 0
Resultant type determined by first argument.
SIN(x) sine sin(x) I,R to R, C to C
The angles are given in radians.
Main Index
Chapter 1: Direct Matrix Abstraction 29
Instructions
Argument Type
Format Definition Result to Result Type
SINH(x) hyperbolic sine sinh(x) I,R to R, C to C
The angles are given in radians.
SNGL(x) convert to single I,R to RS, C to
CS
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.
SQRT(x) square root x I,R to R, C to C
If the value of integer or real arguments is less than 0, then an error
results.
For complex arguments the principal square root is returned. That is,
the first component is always greater than or equal to 0.
SUBSTRIN substring SUBSTRIN x1,x2 may be I, R
(A,x1,x2) ABC 2 3 BC or C
Return substring of first argument with length of ABS(x2-x1)+1.
Arguments 2 and 3 must be numeric values. Prior to use as substring
subscripts, both arguments are converted to integers and checked for
range of 1 to 80. If the lower string subscript is less than 1, it is changed
to 1. If the upper string subscript is greater than 80, it is changed to 80.
The larger string subscript value becomes the upper substring
subscript.
TAN(x) tangent tan(x) I,R to R, C to C
TANH(x) hyperbolic tangent tanh(x) I,R to R, C to C
TIMETOGO() remaining CPU Time returns I
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.
WLEN(x) VPS word length Returns VPS word length A,I,R,C,L to I
of argument
Returns VPS word length of argument. Constant for all types, except
character data that ranges from 1-20.
XORL(x1,x2) numeric exclusive OR TRUE, if x1 or x2 <0 I,R,C to L
FALSE otherwise
Main Index
30 DMAP Programmer’s Guide
Instructions
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) $
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 (Ch. 1) in the MSC 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 MSC 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
Chapter 1: Direct Matrix Abstraction 31
Instructions
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
Main Index
32 DMAP Programmer’s Guide
Instructions
1. IF(expression)THEN $
ENDIF $
2. IF(expression)THEN $
ELSE $
ENDIF $
3. IF(expression 1)THEN $
ELSE $
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, 8.
Main Index
Chapter 1: Direct Matrix Abstraction 33
Instructions
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, 8. There is no limit to the allowable number of DO WHILE statements.
Scratch NDDL and local blocks (see page 13), which are first referenced and created inside a DO
WHILE loop, are automatically deleted at the end of the loop (see page 38). 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, 579 for examples.
Main Index
34 DMAP Programmer’s Guide
Instructions
statement is not specified in the subDMAP, all DMAP execution is terminated at the END statement
(discussed in the next section).
Below is an example using the SUBDMAP, CALL, and RETURN statements. The main subDMAP is
called MAIN and contains two calls to subDMAP TEST. In the first CALL to subDMAP TEST, the
second input and output data blocks are marked as ",," and are not generated. The value of Q1 is returned
as computed in TEST. In both CALL statements, the value of P2 is returned from TEST. Although Q3
may have changed in subDMAP TEST, Q3’s value is not returned to MAIN. In the second call a constant
value of 0 is specified for P1.
SUBDMAP MAIN $ Main SUBDMAP
TYPE PARM,,I,N,Q1=5 $
TYPE PARM,,I,N,P1,P2,P3,Q3 $
.
.
.
CALL TEST A,,C/D,,F/P1/S,P2/S,Q1 $
.
.
.
CALL TEST A,B,C/I,J,K/0/S,P2/Q3 $
.
.
.
END $
Main Index
Chapter 1: Direct Matrix Abstraction 35
Instructions
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
36 DMAP Programmer’s Guide
Instructions
Declarative Statement
The declarative statements are TYPE, DBVIEW, and FILE. See DMAP Modules and Statements (Ch. 4)
for a description and “Output from a Previous Module” Rule, 37 and Automatic Deletion of Scratch Data
Blocks, 38 for related discussion.
Main Index
Chapter 1: Direct Matrix Abstraction 37
“Output from a Previous Module” Rule
Main Index
38 DMAP Programmer’s Guide
Automatic Deletion of Scratch Data Blocks
Main Index
Chapter 1: Direct Matrix Abstraction 39
Preface Modules and SOLution 100
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:
DMIINDMI,DMINDX/A,B,C,D,E,,,,,/ $
DTIINDIT,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
40 DMAP Programmer’s Guide
Processing of User Errors
DCMP MGEN
DECOMP MTRXIN
DYCNTRL SEDR
EMG SELA
GP2 SEMA
GP3 SSG1
GP4 TA1
LCGEN
Main Index
Chapter 1: Direct Matrix Abstraction 41
SubDMAPs DBMGR, DBSTORE, and DBFETCH
DIAG 47 can be specified in the Executive Control Section to print diagnostics related to these
operations.
These subDMAPs are stored in the delivery database and do not have to be compiled by the user if they
are being used in any MSC Nastran solution sequences. For example:
SOL 101
DIAG 47
COMPILE SEDRCVR
ALTER ’AFTER ELEMENT STRESS’
CALL DBSTORE OES1,,,,//0/SEID/’ ’/0 $
CEND
These subDMAPs are also used in a user’s solution sequence.
SOL MYDMAP
COMPILE MYDMAP
SUBDMAP MYDMAP $
.
.
.
CALL DBSTORE A,,,,//0/1/’ ’/0 $
.
.
.
END $
CEND
Main Index
42 DMAP Programmer’s Guide
SubDMAPs DBMGR, DBSTORE, and DBFETCH
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
Chapter 1: Direct Matrix Abstraction 43
WHERE and CONVERT Clauses
Main Index
44 DMAP Programmer’s Guide
WHERE and CONVERT Clauses
• 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 (p. 89) in the MSC
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 (p. 94) in
the MSC 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, 8 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. If project-expr and/or version-expr produces a project-
or version-identification numberthat does not exist, then one will be created. Also, all version-lDs less
than version-expr that do not exist will be created; but they will be “empty.”
Examples of the CONVERT clause are:
1. Set qualifiers SEID, PEID, and SPC to constants 10, 20, 102 respectively.
CONVERT(SEID=10;PEID=20;SPC=102)
If more than one value of a qualifier is found for an item by the WHERE clause, then each value
is processed in qual-expri to define the new qualifier value for each of the selected items. In the
example below, if the original values of PEID were 1, 2, and 3, then the new values for the SElD
qualifier will be 2, 4, and 6.
2. Set all values of qualifier SElD to be twice the value of the PEID qualifier.
CONVERT(SElD=2*PElD)
Main Index
Chapter 2: Data Blocks
MSC Nastran DMAP Programmer’s Guide
2 Data Blocks
Introduction
Matrix Data Blocks
Table Data Blocks
Table Descriptions
Data Block Descriptions
Main Index
46 MSC Nastran DMAP Programmer’s Guide
Introduction
Introduction
Data block descriptions are provided for all matrices and tables that are currently processed by the
OUTPUT2 and DBC modules in the MSC Nastran solution sequences with PARAM,POST.
Main Index
Chapter 2: Data Blocks 47
Matrix Data Blocks
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. 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
Main Index
48 MSC Nastran DMAP Programmer’s Guide
Matrix Data Blocks
there will be a separate solution matrix for each subcase. For a description of matrix trailers, see Data
Blocks, 12.
Main Index
Chapter 2: Data Blocks 49
Table Data Blocks
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.
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
Main Index
50 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Location in Trailer
Trailer Bit Word Position
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.
OFP Tables
Header Record
The header record of all OFP tables contains codes that indicate how the output should be labeled,
formatted, and printed.
2 = Yes and 0 = No
14 q4cstr CQUAD4 corner output stress option
21 metrik Electromagnetic units code (1 thru 6 or 10, default=10)
Main Index
Chapter 2: Data Blocks 51
Table Data Blocks
Approach_Code
Approach_code indicates analysis type and device type(s).
1. Analysis type is equal to approach_code/10 indicates:
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
2. Device type(s) are extracted from the bit pattern equal to MOD(approach_code,10). The bits
numbered from the right are:
Bit Description
1 Print
Main Index
52 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Bit Description
2 Plot
3 Punch
Examples:
Approach_code Description
61 Print transient response results
15 Print and punch statics results
106 Plot and punch nonlinear statics results
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 2
Type Name Description
1 OUG Displacement vector
2 OPG Load vector
3 OQG SPCforce vector
4 OEF Element force (or flux)
5 OES Element stress(or strain)
Main Index
Chapter 2: Data Blocks 53
Table Data Blocks
Chapter 2
Type Name Description
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
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
Main Index
54 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Chapter 2
Type Name Description
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 Complex (on) flag
2 SORT2 (on) flag
3 Random (on) flag
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
Main Index
Chapter 2: Data Blocks 55
Table Data Blocks
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:
• Octahedral (or maximum shear) or Hencky-von Mises
• Stress or strain
• If the strain is curvature or fibre
• If the strain or stress is in the material coordinate system
Stress_code is a bit pattern and the bits numbered from the right are:
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
56 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Coordinate
Value On bits System Description
0 00000 Element Stress maximum shear or octahedral
1 00001 Stress von Mises
10 01010 Strain curvature maximum shear or octahedral
11 01011 Strain curvature von Mises
14 01110 Strain fiber maimum shear or octahedral
15 01111 Strain fiber von Mises
16 10000 Material Stress maximum shear or octahedral
17 10001 Stress von Mises
26 11010 Strain curvature maximum shear or octahedral
27 11011 Strain curvature von Mises
30 11110 Strain fiber maimum shear or octahedral
31 11111 Strain fiber von Mises
Main Index
Chapter 2: Data Blocks 57
Table Data Blocks
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
58 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Main Index
Chapter 2: Data Blocks 59
Table Data Blocks
Main Index
60 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Main Index
Chapter 2: Data Blocks 61
Table Data Blocks
Main Index
62 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Main Index
Chapter 2: Data Blocks 63
Table Data Blocks
Main Index
64 MSC Nastran DMAP Programmer’s Guide
Table Data Blocks
Main Index
Chapter 2: Data Blocks 65
Table Descriptions
Table Descriptions
Table descriptions are arranged alphabetically by the generic name of the data block. A data block
description may encompass descriptions of several data blocks from different modules; for example, the
OES data block description describes data blocks OES1, OES2, OESNL, OSTR1, and OES1C, which are
output by the SDR2, SDR3, SDRNL, and SDRCOMP modules. The generic name of a data block also
appears in the Data Block Glossary, 1547 at the end of DMAP Modules and Statements (Ch. 4).
Main Index
66 BGPDT
Data Block Descriptions
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 67
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
68 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 69
Case Control information
Record 0 -- HEADER
Record 1 -- Repeat
Main Index
70 CASECC
Case Control information
Main Index
CASECC 71
Case Control information
Main Index
72 CASECC
Case Control information
Main Index
CASECC 73
Case Control information
Main Index
74 CASECC
Case Control information
Main Index
CASECC 75
Case Control information
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
Record 2 -- TRAILER
Main Index
86 CASECC
Case Control information
Main Index
CASECC 87
Case Control information
Main Index
88 CLAMA
Complex eigenvalue summary table
Record 0 -- HEADER
Record 1 -- OFPID
Record 2 -- LAMA
Repeats for each eigenvalue.
Record 3 -- TRAILER
Main Index
CLAMA 89
Complex eigenvalue summary table
Main Index
90 CONTAB
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
CSTM 91
Coordinate system transformation matrices table
Record 0 -- HEADER
Record 1 -- IDENT
Record 2 -- REALDATA
Record 3 -- INTDATA
Record 4 -- TRAILER
Main Index
92 CSTM
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
CSTM68 93
Coordinate system transformation matrices table
(Pre-Version 69)
The transformation is from global to basic.
Record 0 -- HEADER
Record 1 -- HEADER
Main Index
94 CSTM68
Coordinate system transformation matrices table
Main Index
CSTM68 95
Coordinate system transformation matrices table
Main Index
96 CSTM68
Coordinate system transformation matrices table
Main Index
CSTM68 97
Coordinate system transformation matrices table
Main Index
98 CSTM68
Coordinate system transformation matrices table
Record 2 -- TRAILER
Main Index
DBCOPT 99
Design optimization history table for postprocessing
Record 0 -- HEADER
Record 1 -- EXACT
Record 2 -- APPRX
Record 3 -- MAXIM
Record 4 -- DVIDS
Record 5 -- INITV
Main Index
100 DBCOPT
Design optimization history table for postprocessing
Record 7 -- DVLABEL
Record 8 -- TRAILER
Main Index
DESTAB 101
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
102 DIT
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
DIT 103
Direct input tables
Record 4 -- TABLED1(1105,11,133)
Record 5 -- TABLED2(1205,12,134)
Record 6 -- TABLED3(1305,13,140)
Main Index
104 DIT
Direct input tables
Record 7 -- TABLED4(1405,14,141)
Record 8 -- TABLEDR(4201,42,648)
Record 9 -- TABLEM1(105,1,93)
Same as record TABLED1 description (page 103).
Record 10 -- TABLEM2(205,2,94)
Same as record TABLED2 description (page 103).
Record 11 -- TABLEM3(305,3,95)
Same as record TABLED3 description (page 104).
Record 12 -- TABLEM4(405,4,96)
Same as record TABLED4 description (page 104).
Main Index
DIT 105
Direct input tables
Record 13 -- TABLES1(3105,31,97)
Record 13 -- TABLEST(1905,19,178)
Record 14 -- TABRND1(55,25,191)
Record 15 -- TABRNDG(56,26,303)
Power spectral density for gust loads in aeroelastic analysis.
Main Index
106 DIT
Direct input tables
Record 16 -- TRAILER
Main Index
DSCMCOL 107
Design sensitivity parameters
Record 0 -- HEADER
Main Index
108 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 109
Design sensitivity parameters
Main Index
110 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 111
Design sensitivity parameters
Main Index
112 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 113
Design sensitivity parameters
Main Index
114 DSCMCOL
Design sensitivity parameters
Main Index
DSCMCOL 115
Design sensitivity parameters
Record 3 -- TRAILER
Main Index
116 DVPTAB
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
Note: 1. There are as many records as there are designed properties. (NPROP = NENT1 +
NENT2).
Main Index
DYNAMIC 117
Table of Bulk Data entry images related to dynamics
Record 0 -- HEADER
Record 1 -- ACSRCE(5307,53,379)
Power versus frequency for a simple acoustic source.
Record 2 -- DAREA(27,17,182)
Scale factor for dynamic loads.
Record 3 -- DELAY(37,18,183)
Main Index
118 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 4 -- DLOAD(57,5,123)
Linear combination of dynamic loads.
Record 5 -- DPHASE(77,19,184)
Phase lead parameter in dynamic loading.
Record 6 -- DYNRED(4807,48,306)
Main Index
DYNAMIC 119
Table of Bulk Data entry images related to dynamics
Record 7 -- EIGB(107,1,86)
Record 8 -- EIGC(207,2,87)
Main Index
120 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 9 -- EIGP(257,4,158)
Record 10 -- EIGR(307,3,85)
Main Index
DYNAMIC 121
Table of Bulk Data entry images related to dynamics
Record 11 -- EIGRL(308,8,348)
Record 12 -- EPOINT(707,7,124)
Record 13 -- FREQ(1307,13,126)
Record 14 -- FREQ1(1007,10,125)
Main Index
122 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 15 -- FREQ2(1107,11,166)
Record 16 -- FREQ3(1407,14,39)
Record 17 -- FREQ4(1507,15,40)
Record 18 -- FREQ5(1607,16,41)
Main Index
DYNAMIC 123
Table of Bulk Data entry images related to dynamics
Record 19 -- NLRSFD(3807,38,505)
Record 20 -- NOLIN1(3107,31,127)
Main Index
124 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 21 -- NOLIN2(3207,32,128)
Record 22 -- NOLIN3(3307,33,129)
Record 23 -- NOLIN4(3407,34,130)
Main Index
DYNAMIC 125
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
126 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 27 -- RLOAD2(5207,52,132)
Record 28 -- RGYRO(10701,107,117)
Record 29 -- ROTORG(10801,108,242)
Main Index
DYNAMIC 127
Table of Bulk Data entry images related to dynamics
Record 30 -- RSPINR(10901,109,260)
Record 31 -- RSPINT(11001,110,310)
Main Index
128 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 32 -- SEQEP(5707,57,135)
Record 33 -- TF(6207,62,136)
Record 34 -- TIC(6607,66,137)
Record 35 -- TIC(11601,116,655)
Main Index
DYNAMIC 129
Table of Bulk Data entry images related to dynamics
Record 36 -- TIC3(11601,116,655)
Main Index
130 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 37 -- TLOAD1(7107,71,138)
Record 38 -- TLOAD2(7207,72,139)
Main Index
DYNAMIC 131
Table of Bulk Data entry images related to dynamics
Record 39 -- TSTEP(8307,83,142)
Record 40 -- UNBALNC(11101,111,368)
Main Index
132 DYNAMIC
Table of Bulk Data entry images related to dynamics
Record 41 -- TRAILER
Main Index
EGPSF 133
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
134 EGPSF
Table of element to grid point surface interpolation factors
Main Index
EGPSF 135
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.
3. Possible values for items in RECORD=DATA are
Main Index
136 EGPSF
Table of element to grid point surface interpolation factors
Main Index
EGPSTR 137
Element grid point stress table
Record 0 -- HEADER
Record 1 -- Repeat
See EGPSF, 133 for a description of surface and volume definition data.
Main Index
138 EGPSTR
Element grid point stress table
Record 2 -- TRAILER
Main Index
EGPSTR 139
Element grid point stress table
Notes: 1. NF is based on the value of FIBRE and whether strain/curvature or stresses are
being processed.
2. SUBVEC and TSEIG may have the following values:
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
140 ELDCT
Element stress discontinuity table
Record 0 -- HEADER
Record 1 -- Repeat
See EGPSF, 133 for a description of surface and volume definition data.
Main Index
ELDCT 141
Element stress discontinuity 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
Main Index
142 EPT
Element property table
Record 0 -- HEADER
Record 1 -- HGSUPPR(13901,139,654)
Main Index
EPT 143
Element property table
Record 2 -- NSM(3201,32,55)
Record 3 -- NSM1(3301,33,56)
7 ID I
8 THRU(2) CHAR4
10 ID I
8 THRU(2) CHAR4
Main Index
144 EPT
Element property table
11 BY(2) CHAR4
13 N I
8 THRU(2) CHAR4
10 ID I
8 THRU(2) CHAR4
10 ID I
11 BY(2) CHAR4
13 N I
Main Index
EPT 145
Element property table
Record 4 -- NSML1(3601,36,62)
Main Index
146 EPT
Element property table
Record 5 -- NSMADD(3401,34,57)
Record 6 R -- NSML(3501,35,58)
Record 7 -- NSML1(3601,36,62)
Main Index
EPT 147
Element property table
Main Index
148 EPT
Element property table
Main Index
EPT 149
Element property table
Record 12 -- PBARL(9102,91,52)
Record 13 -- PBCOMP(5403,55,349)
Main Index
150 EPT
Element property table
Main Index
EPT 151
Element property table
Main Index
152 EPT
Element property table
Main Index
EPT 153
Element property table
Main Index
154 EPT
Element property table
Main Index
EPT 155
Element property table
Record 14 -- PBEAM(5402,54,262)
Main Index
156 EPT
Element property table
Main Index
EPT 157
Element property table
Record 15 -- PBEAML(9202,92,53)
Record 16 -- PBEND(2502,25,248)
Main Index
158 EPT
Element property table
Record 17 -- PBMSECT(13301,133,509)
Main Index
EPT 159
Element property table
Main Index
160 EPT
Element property table
End SPECOPT
Words 38 through max repeat NUMTHI times
End FORM
43 OHEIGHT RS Overall Station Height
44 OWIDTH RS Overall Station Width
Words 6 through max repeat NUMSTAT times
Record 18 -- PBRSECT(13201,132,513)
Main Index
EPT 161
Element property table
Main Index
162 EPT
Element property table
End SPECOPT
Words 33 through max repeat NUMTHI times
End FORM
38 OHEIGHT RS Overall Heighth
39 OWIDTH RS Overall Width
Record 19 -- PBUSH(1402,14,37)
Main Index
EPT 163
Element property table
Record 20 -- PBUSH1D(3101,31,219)
Main Index
164 EPT
Element property table
Record 21 -- PBUSHT(702,7,38)
Main Index
EPT 165
Element property table
Record 22 -- PCOMP(2706,27,287)
Record 23 -- PCOMPA(13100,131,547)
Main Index
166 EPT
Element property table
Record 24 -- PCONEAX(152,19,147)
Record 25 -- PCONV(11001,110,411)
Main Index
EPT 167
Element property table
Record 26 -- PCONVM(2902,29,420)
Record 27 -- PDAMP(202,2,45)
Record 28 -- PDAMPT(1202,12,33)
Record 29 -- PDAMP5(8702,87,412)
Main Index
168 EPT
Element property table
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)
Record 35 -- PDUM6(6602,66,161
)
Main Index
EPT 169
Element property table
Record 36 -- PDUM7(6702,67,163)
Record 37 -- PDUM8(6802,68,164)
Record 38 -- PDUM9(6902,69,165)
Record 39 -- PELAS(302,3,46)
Record 40 - PFAST(13501,135,510)
Main Index
170 EPT
Element property table
Record 41 -- PELAST(1302,13,34)
Record 42 -- PGAP(2102,21,121)
Main Index
EPT 171
Element property table
Record 43 -- PHBDY(2802,28,236)
Record 44 -- PINTC(12001,120,480)
Record 45 -- PINTS(12101,121,484)
Record 46 -- PLPLANE(4606,46,375)
Main Index
172 EPT
Element property table
Record 47 -- PLSOLID(4706,47,376)
Record 48 -- PMASS(402,4,44)
Record 49 -- PROD(902,9,29)
Record 50 -- PSHEAR(1002,10,42)
Main Index
EPT 173
Element property table
Record 51 -- PSHELL(2302,23,283)
Record 52 -- PSOLID(2402,24,281)
Main Index
174 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 175
Element property table
Record 56 -- PTUBE(1602,16,30)
This record is slightly unstructured: OD2 is only written out if heat transfer.
Record 57 -- PSET(10301,103,399)
Record 58 -- PVAL(10201,102,400)
Main Index
176 EPT
Element property table
Record 59 -- PVISC(1802,18,31)
Record 60 -- PWELD(11801,118,560)
Record 61 -- PWSEAM(13701,137,638)
Main Index
EPT 177
Element property table
Record 62 -- VIEW(2606,26,289)
Record 63 -- VIEW3D(3002,30,415)
Main Index
178 EPT
Element property table
Record 64 -- TRAILER
Main Index
EPT01 179
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
180 EPT01
Element property table for MSC.Nastran Version 2001
Record 2 -- PTSHELL(13801,138,645)
Record 3 - PWSEAM(13701,137,638)
Main Index
EQEXIN 181
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
182 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 183
Table of p-element error tolerances
Record 0 -- HEADER
Record 1 -- ERROR
Record 2 -- TRAILER
Note: 1. WHYCAS is composed of bits for internal use only. Bits include values for
ERRTOL,SIGTOL,EPSTOL,ERRGRD,ERRELM.
Main Index
184 FOL
Frequency response frequency output list
Record 0 -- HEADER
Record 1 -- TRAILER
Main Index
GEOM1 185
Table of Bulk Data entry images related to geometry
Record 0 -- HEADER
Record 1 -- CORD1C(1701,17,6)
Record 2 -- CORD1R(1801,18,5)
Record 3 -- CORD1S(1901,19,7)
Main Index
186 GEOM1
Table of Bulk Data entry images related to geometry
Record 4 -- CORD2C(2001,20,9)
Record 5 -- CORD2R(2101,21,8)
Main Index
GEOM1 187
Table of Bulk Data entry images related to geometry
Record 6 -- CORD2S(2201,22,10)
Record 7 -- CORD3R(14301,143,651)
Record 8 -- CSUPER(2301,23,304)
Main Index
188 GEOM1
Table of Bulk Data entry images related to geometry
Record 9 -- CSUPEXT(5501,55,297)
Record 10 -- EXTRN(1627,16,463)
Record 11 -- FEEDGE(6101,61,388)
Main Index
GEOM1 189
Table of Bulk Data entry images related to geometry
Record 12 -- GMCURV(6601,66,392)
Record 13 -- FEFACE(6201,62,389)
Record 14 -- POINT(6001,60,377)
Main Index
190 GEOM1
Table of Bulk Data entry images related to geometry
Record 15 -- GMSURF(10101,101,394)
Record 16 -- GMCORD(6401,64,402)
Record 17 -- GRID(4501,45,1)
Main Index
GEOM1 191
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
192 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)
Record 24 -- SELOC(827,8,457)
Main Index
GEOM1 193
Table of Bulk Data entry images related to geometry
Record 25 -- SEMPLN(927,9,458)
Record 26 -- SENQSET(1327,13,464)
Record 27 -- SEQGP(5301,53,4)
Main Index
194 GEOM1
Table of Bulk Data entry images related to geometry
Record 28 -- SEQSEP(5401,54,305)
Record 29 -- SESET(5601,56,296)
Record 30 -- SETREE(1227,12,462)
Record 31 -- SNORM(5678,71,475)
Main Index
GEOM1 195
Table of Bulk Data entry images related to geometry
Record 32 -- CSUPER1(5701,57,323)
This record is obsolete and will be removed eventually.
Record 33 -- SUPUP(5801,58,324)
This record is obsolete and will be removed eventually.
Main Index
196 GEOM1
Table of Bulk Data entry images related to geometry
Record 34 -- SWLDPRM(14101,141,403)
Record 35 -- TRAILER
Main Index
GEOM1 197
Table of Bulk Data entry images related to geometry
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.
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
198 GEOM168
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
GEOM168 199
Table of Bulk Data entry images related to geometry for MSC.Nastran Version 68
Record 1 -- CORD2R(2101,21,8)
Record 2 -- CORD2S(2201,22,10)
Main Index
200 GEOM168
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)
Main Index
DMAP Programmer’s Guide
GEOM2 also contains information on scalar points. ECT is identical in format to GEOM2 except all grid
and scalar point external identification numbers are replaced by internal numbers. Also, ECT does not
contain SPOINT records.
Record 1 -- HEADER
Record 2 -- AEROQ4(2002,20,0)
Record 3 -- AEROT3(1801,18,0)
Record 4 -- BEAMAERO(1701,17,0)
Main Index
202 GEOM2
Table of Bulk Data entries related to element connectivity
Record 5 -- CAABSF(2708,27,59)
Record 6 -- CAXIF2(2108,21,224)
Record 7 -- CAXIF3(2208,22,225)
Record 8 -- CAXIF4(2308,23,226)
Main Index
GEOM2 203
Table of Bulk Data entries related to element connectivity
Record 9 -- CBAR(2408,24,180)
Main Index
204 GEOM2
Table of Bulk Data entries related to element connectivity
Record 10 -- CBARAO(4001,40,275)
Record 11 -- CBEAM(5408,54,261)
Main Index
GEOM2 205
Table of Bulk Data entries related to element connectivity
Main Index
206 GEOM2
Table of Bulk Data entries related to element connectivity
Record 12 -- CBEAMP(11401,114,9016)
Main Index
GEOM2 207
Table of Bulk Data entries related to element connectivity
Record 13 -- CBEND(4601,46,298)
Main Index
208 GEOM2
Table of Bulk Data entries related to element connectivity
Record 14 -- CBUSH(2608,26,60)
Main Index
GEOM2 209
Table of Bulk Data entries related to element connectivity
Record 15 -- CBUSH1D(5608,56,218)
Record 16 -- CCONE(2315,23,0)
Record 17 -- CDAMP1(201,2,69)
Main Index
210 GEOM2
Table of Bulk Data entries related to element connectivity
Record 18 -- CDAMP2(301,3,70)
Record 19 -- CDAMP3(401,4,71)
Record 20 -- CDAMP4(501,5,72)
Record 21 -- CDAMP5(10608,106,404)
Main Index
GEOM2 211
Table of Bulk Data entries related to element connectivity
Record 22 -- CDUM2(6208,62,108)
Record 23 -- CDUM3(6308,63,109)
Record 24 -- CDUM4(6408,64,110)
Record 25 -- CDUM5(6508,65,111)
Record 26 -- CDUM6(6608,66,112)
Main Index
212 GEOM2
Table of Bulk Data entries related to element connectivity
Record 27 -- CDUM7(6708,67,113)
Record 28 -- CDUM8(6808,68,114)
Record 29 -- CDUM9(6908,69,115)
Record 30 -- CELAS1(601,6,73)
Record 31 -- CELAS2(701,7,74)
Main Index
GEOM2 213
Table of Bulk Data entries related to element connectivity
Record 32 -- CELAS3(801,8,75)
Record 33 -- CELAS4(901,9,76)
Record 34 -- CFAST(9801,98,506)
Main Index
214 GEOM2
Table of Bulk Data entries related to element connectivity
20 UNDEF(5 ) none
20 UNDEF(5 ) none
End FORMAT
25 TAVG RS Average shell thickness
26 UNDEF(2 ) none
Record 35 -- CFASTP(9301,93,607)
Main Index
GEOM2 215
Table of Bulk Data entries related to element connectivity
Record 36 -- CFLUID2(8515,85,0)
Record 37 -- CFLUID3(8615,86,0)
Record 38 -- CFLUID4(8715,87,0)
Main Index
216 GEOM2
Table of Bulk Data entries related to element connectivity
Record 39 -- CINT(7701,77,8881)
Record 40 -- CGAP(1908,19,104)
Main Index
GEOM2 217
Table of Bulk Data entries related to element connectivity
Record 41 -- CHACAB(8100,81,381)
Main Index
218 GEOM2
Table of Bulk Data entries related to element connectivity
Record 42 -- CHACBR(8200,82,383)
Record 43 -- CHBDYE(8308,83,405)
Record 44 -- CHBDYG(10808,108,406)
Main Index
GEOM2 219
Table of Bulk Data entries related to element connectivity
Record 45 -- CHBDYP(10908,109,407)
Main Index
220 GEOM2
Table of Bulk Data entries related to element connectivity
Record 46 -- CHEXA(7308,73,253)
Record 47 -- CHEXA20F(16300,163,9999)
Same as record CHEXA description.
Record 48 -- CHEXAFD(14000,140,9990)
Same as record CHEXA description.
Record 49 -- CHEXAL(7908,79,369)
Record 50 -- CHEXP(12001,120,9011)
Record 51 -- CHEXPR(7409,74,9991)
Same as record CHEXA description.
Main Index
GEOM2 221
Table of Bulk Data entries related to element connectivity
Record 52 -- CMASS1(1001,10,65)
Record 53 -- CMASS2(1101,11,66)
Record 54 -- CMASS3(1201,12,67)
Record 55 -- CMASS4(1301,13,68)
Main Index
222 GEOM2
Table of Bulk Data entries related to element connectivity
Record 56 -- CMFREE(2508,25,0)
Record 57 -- CONM1(1401,14,63)
Record 58 -- CONM2(1501,15,64)
Main Index
GEOM2 223
Table of Bulk Data entries related to element connectivity
Record 59 -- CONROD(1601,16,47)
Record 60 -- CONV(12701,127,408)
Record 61 -- CONVM(8908,89,422)
Main Index
224 GEOM2
Table of Bulk Data entries related to element connectivity
Record 62 -- CPENP(12101,121,9012)
Record 63 -- CPENTA(4108,41,280)
Record 64 -- CPENPR(7509,75,9992)
Same as record CPENTA description.
Record 65 -- CPENT15F(16500,165,9999)
Same as record CPENTA description.
Record 66 -- CPENT6FD(16000,160,9999)
Same as record CPENTA description.
Main Index
GEOM2 225
Table of Bulk Data entries related to element connectivity
Record 67 -- CQDX4FD(17000,170,9999)
Record 68 -- CQDX9FD(17100,171,9999)
Same as record CQDX4FD description.
Record 69 -- CQUAD(9108,91,507)
Record 70 -- CQUAD4(2958,51,177)
Record 71 -- CQUAD4FD(13900,139,9989)
Same as record CQUAD description.
Main Index
226 GEOM2
Table of Bulk Data entries related to element connectivity
Record 72 -- CQUAD8(4701,47,326)
Record 73 -- CQUAD9FD(16400,164,9999)
Record 74 -- CQUADP(11101,111,9014)
Main Index
GEOM2 227
Table of Bulk Data entries related to element connectivity
Record 75 -- CQUADR(8009,80,367)
Same as record CQUAD4 description.
Record 76 -- CQUADX(9008,90,508)
Same as record CQUAD description.
Record 77 -- CRBAR(14700,147,6662)
Record 78 -- CRBE1(17300,173,6664)
Main Index
228 GEOM2
Table of Bulk Data entries related to element connectivity
Record 79 -- CRBE3(17200,172,6663)
Main Index
GEOM2 229
Table of Bulk Data entries related to element connectivity
Record 80 -- CRJOINT(11000,110,6667)
Record 81 -- CROD(3001,30,48)
Record 82 -- CRROD(12600,126,6661)
Main Index
230 GEOM2
Table of Bulk Data entries related to element connectivity
Record 83 -- CSEAM(13801,138,570)
Main Index
GEOM2 231
Table of Bulk Data entries related to element connectivity
Record 84 -- CSHEAR(3101,31,61)
Record 85 -- CSLOT3(4408,44,227)
Record 86 R -- CSLOT4(4508,45,228)
Record 87 -- CTETP(12201,122,9013)
Main Index
232 GEOM2
Table of Bulk Data entries related to element connectivity
Record 88 -- CTETRA(5508,55,217)
Record 89 -- CTETPR(7609,76,9993)
Same as record CTETRA description.
Record 90 -- CTETR10F(16600,166,9999)
Same as record CTETRA description.
Record 91 -- CTETR4FD(16100,161,9999)
Same as record CTETRA description.
Record 92 -- CTQUAD(14801,148,643)
Record 93 -- CTTRIA(14901,149,644)
Main Index
GEOM2 233
Table of Bulk Data entries related to element connectivity
Record 94 -- CTRIA3(5959,59,282)
Record 95 -- CTRIA3FD(16200,162,9999)
Record 96 -- CTRIA6(4801,48,327)
Main Index
234 GEOM2
Table of Bulk Data entries related to element connectivity
Record 97 -- CTRIA6FD(16700,167,9999)
Same as record CTRIA3FD description.
Record 98 -- CTRIAP(11301,113,9015)
Record 99 -- CTRIAR(9200,92,385)
Same as record CTRIA3 description.
Main Index
GEOM2 235
Table of Bulk Data entries related to element connectivity
Main Index
236 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 237
Table of Bulk Data entries related to element connectivity
Main Index
238 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 239
Table of Bulk Data entries related to element connectivity
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
Main Index
242 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 243
Table of Bulk Data entries related to element connectivity
Main Index
244 GEOM2
Table of Bulk Data entries related to element connectivity
Main Index
GEOM2 245
Table of Bulk Data entries related to element connectivity
Main Index
246 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 247
Table of Bulk Data entries related to V2001 element connectivity
Main Index
248 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 8 – CBEAM(5408,54,261)
Main Index
GEOM201 249
Table of Bulk Data entries related to V2001 element connectivity
Main Index
250 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 65 – CQUAD4(2958,51,177)
Record 67 – CQUAD8(4701,47,326)
Record 69 – CQUADP(11101,111,9014)
Main Index
GEOM201 251
Table of Bulk Data entries related to V2001 element connectivity
Record 73 -- CRBE1(17300,173,6664)
Main Index
252 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Record 74 -- CRBE3(17200,172,6663)
Main Index
GEOM201 253
Table of Bulk Data entries related to V2001 element connectivity
Record 81 – CTRIA3(5959,59,282)
Record 83 – CTRIA6(4801,48,327)
Record 85 – CTRIAP(11301,113,9015)
Main Index
254 GEOM201
Table of Bulk Data entries related to V2001 element connectivity
Main Index
GEOM3 255
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 1 -- HEADER
Record 2 -- ACCEL(11302,113,600)
Record 3 -- ACCEL1(11402,114,601)
Main Index
256 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 4 -- FORCE(4201,42,18)
Record 5 -- FORCE1(4001,40,20)
Record 6 -- FORCE2(4101,41,22)
Record 7 -- GMLOAD(6309,63,391)
Main Index
GEOM3 257
Table of Bulk Data entry images related to static and thermal loads
Main Index
258 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 8 -- GRAV(4401,44,26)
Record 9 -- LOAD(4551,61,84)
Record 10 -- LOADCYH(3709,37,331)
Record 11 -- LOADCYN(3809,38,332)
Main Index
GEOM3 259
Table of Bulk Data entry images related to static and thermal loads
Record 12 -- LOADCYT(3909,39,333)
Record 13 -- LSEQ(3609,36,188)
Record 14 -- MOMENT(4801,48,19)
Main Index
260 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 15 -- MOMENT1(4601,46,21)
Record 16 -- MOMENT2(4701,47,23)
Record 17 -- PLOAD(5101,51,24)
Record 18 -- PLOAD1(6909,69,198)
Main Index
GEOM3 261
Table of Bulk Data entry images related to static and thermal loads
Record 19 -- PLOAD2(6802,68,199)
Record 20 -- PLOAD3(7109,71,255)
Record 21 -- PLOAD4(7209,72,299)
Main Index
262 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 22 -- PLOADX(7001,70,278)
This record is obsolete.
Record 23 -- PLOADX1(7309,73,351)
Record 24 -- PRESAX(5215,52,154)
Record 25 -- QBDY1(4509,45,239)
Main Index
GEOM3 263
Table of Bulk Data entry images related to static and thermal loads
Record 26 -- QBDY2(4909,49,240)
Record 27 -- QBDY3(2109,21,414)
Record 28 -- QHBDY(4309,43,233)
Record 29 -- QVECT(2209,22,241)
Main Index
264 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 30 -- QVOL(2309,23,416)
Record 31 -- RFORCE(5509,55,190)
Record 32 -- SLOAD(5401,54,25)
Main Index
GEOM3 265
Table of Bulk Data entry images related to static and thermal loads
Record 33 -- TEMP(5701,57,27)
Record 34 -- TEMPD(5641,65,98)
Record 35 -- TEMPEST(11109,111,424)
Record 36 -- TEMPF(6209,62,390)
Record 37 -- TEMPIC(11209,112,425)
Main Index
266 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 38 -- TEMPP1(8109,81,201)
Record 39 -- TEMPP2(8209,82,202)
This record is obsolete.
Record 40 -- TEMPP3(8309,83,203)
This record is obsolete.
Main Index
GEOM3 267
Table of Bulk Data entry images related to static and thermal loads
Record 41 -- TEMPRB(8409,84,204)
Record 42 -- PFACE(6409,64,9032)
This record is created by the GP0 module and not by the user.
Main Index
268 GEOM3
Table of Bulk Data entry images related to static and thermal loads
Record 43 -- PEDGE(6609,66,9031)
This record is created by the GP0 module and not by the user.
Main Index
GEOM3 269
Table of Bulk Data entry images related to static and thermal loads
Record 44 -- TRAILER
Main Index
270 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 271
Table of Bulk Data entry images related to constraints
Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element
connectivity.
Record 1 -- HEADER
Record 2 -- ASET(5561,76,215)
Record 3 -- ASET1(5571,77,216)
Record 4 -- BNDGRID(10200,102,473)
Main Index
272 GEOM4
Table of Bulk Data entry images related to constraints
Record 5 -- BSET(110,1,311)
Record 6 -- BSET1(210,2,312)
Record 7 -- CSET(310,3,313)
Record 8 -- CSET1(410,4,314)
Main Index
GEOM4 273
Table of Bulk Data entry images related to constraints
Record 9 -- CYAX(1510,15,328)
Record 10 -- CYJOIN(5210,52,257)
Record 11 -- CYSUP(1610,16,329)
Record 12 -- CYSYM(1710,17,330)
Main Index
274 GEOM4
Table of Bulk Data entry images related to constraints
Record 13 -- EGENDT(8801,88,9022)
Main Index
GEOM4 275
Table of Bulk Data entry images related to constraints
Record 14 -- FCENDT(9001,90,9024)
Main Index
276 GEOM4
Table of Bulk Data entry images related to constraints
Record 15 -- GMBC(8001,80,395)
Main Index
GEOM4 277
Table of Bulk Data entry images related to constraints
Record 16 -- GMSPC(7801,78,393)
Record 17 -- MPC(4901,49,17)
Main Index
278 GEOM4
Table of Bulk Data entry images related to constraints
Record 18 -- MPCADD(4891,60,83)
Record 19 -- OMIT(5001,50,15)
Record 20 -- OMIT1(4951,63,92)
Record 21 -- QSET(510,5,315)
Main Index
GEOM4 279
Table of Bulk Data entry images related to constraints
Record 22 -- QSET1(610,6,316)
Record 23 -- RBAR(6601,66,292)
Record 24 -- RBE1(6801,68,294)
Main Index
280 GEOM4
Table of Bulk Data entry images related to constraints
Record 25 -- RBE2(6901,69,295)
Record 26 -- RBE3(7101,71,187)
Main Index
GEOM4 281
Table of Bulk Data entry images related to constraints
Record 27 -- RBJOINT(14201,142,652)
Main Index
282 GEOM4
Table of Bulk Data entry images related to constraints
Record 28 -- -- RBJSTIF(14301,143,653)
Main Index
GEOM4 283
Table of Bulk Data entry images related to constraints
Main Index
284 GEOM4
Table of Bulk Data entry images related to constraints
Main Index
GEOM4 285
Table of Bulk Data entry images related to constraints
Main Index
286 GEOM4
Table of Bulk Data entry images related to constraints
Record 29 -- RELEASE(1310,13,247)
Record 30 -- RPNOM(14101,141,640)
Main Index
GEOM4 287
Table of Bulk Data entry images related to constraints
Record 31 -- RROD(6501,65,291)
Record 32 -- RSPLINE(7001,70,186
)
Record 33 -- RSSCON(7201,72,398)
Main Index
288 GEOM4
Table of Bulk Data entry images related to constraints
Record 34 -- RTRPLT(6701,67,293)
Main Index
GEOM4 289
Table of Bulk Data entry images related to constraints
Record 35 -- RWELD(11901,119,561)
Record 36 -- SEBSET(710,7,317)
Record 37 -- SEBSET1(810,8,318)
Main Index
290 GEOM4
Table of Bulk Data entry images related to constraints
Record 38 -- SECSET(910,9,319)
Record 39 -- SECSET1(1010,10,320)
Main Index
GEOM4 291
Table of Bulk Data entry images related to constraints
Record 40 -- SEQSET(1110,11,321)
Record 41 -- SEQSET1(1210,12,322)
Record 42 -- SESUP(1410,14,325)
Record 43 -- SEUSET(1810,18,334)
Main Index
292 GEOM4
Table of Bulk Data entry images related to constraints
Record 44 -- SEUSET1(1910,19,335)
Record 45 -- SPC(5501,55,16)
5 D RX Enforced displacement
Record 46 -- SPC1(5481,58,12)
Main Index
GEOM4 293
Table of Bulk Data entry images related to constraints
Record 47 -- SPCADD(5491,59,13)
Record 48 -- SPCD(5110,51,256)
5 D RX Enforced displacement
Record 49 -- SPCDE(8701,87,9021)
Main Index
294 GEOM4
Table of Bulk Data entry images related to constraints
Record 50 -- SPCDF(8901,89,9023)
Record 51 -- SPCDG(9701,97,9030)
Record 52 -- SPCE(9301,93,9027)
Record 53 -- SPCEB(9101,91,9025)
Main Index
GEOM4 295
Table of Bulk Data entry images related to constraints
Record 54 -- SPCF(9401,94,9028)
Record 55 -- SPCFB(9201,92,9026)
Record 56 -- SPCGB(9601,96,9029)
Main Index
296 GEOM4
Table of Bulk Data entry images related to constraints
Record 57 -- SPCGRID(8601,86,9031)
Record 58 -- SPCOFF(6110,61,343)
Record 59 -- SPCOFF1(6210,62,344)
Record 60 -- SUPORT(5601,56,14)
Main Index
GEOM4 297
Table of Bulk Data entry images related to constraints
Record 61 -- SUPORT1(10100,101,472)
Record 62 -- TEMPBC(11309,113,426)
Record 63 -- USET(2010,20,193)
Record 64 -- USET1(2110,21,194)
Main Index
298 GEOM4
Table of Bulk Data entry images related to constraints
Record 65 -- TRAILER
Main Index
GEOM4705 299
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)
Record 41 - SPC(5501,55,16)
Record 44 - SPCD(5110,51,256)
Main Index
300 GPDT68
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 1 -- HEADER
Record 2 -- POINT
Record 3 -- TRAILER
Main Index
GPDT68 301
Grid point definition table (Pre-Version 69)
Note: 1. Scalar points are identified by CP=-1 and words X1 through PS are zero.
2. See the description of the GRID (p. 1965) in the MSC Nastran Quick Reference
Guide Bulk Data entry constraint code, PS.
3. For fluid grid points CD=-1.
Main Index
302 GPL
Grid point list
Record 1 -- HEADER
Record 2 -- GRID
Contains a list of external grid and scalar identification numbers in internal sort.
Record 3 -- GRIDSIL
Contains pairs of external grid and scalar identification numbers and sequence numbers in internal sort.
Record 4 -- TRAILER
Note: 1. SEQNO, sequence number, may be overridden by the SEQGP Bulk Data entry.
Main Index
HIS 303
Table of design iteration history
Record 1 -- HEADER
Record 2 -- Repeat
Record 3 -- 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
304 KDICT
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 1 -- HEADER
Record 2 -- Repeat
Repeats for each element type.
Main Index
KDICT 305
Element stiffness dictionary table
Record 3 -- TRAILER
Notes: 1. FORM=3 indicates the element stiffness matrix is defined in the global coordinate
system.
2. FORM=4 indicates the element stiffness matrix is defined in the element coordinate
system transformation matrix is also contained in each element dictionary.
3. FORM=5 indicates the element stiffness matrix is defined in the basic coordinate
system.
4. FORM=6 indicates the element stiffness matrix is defined in the global coordinate
system and the number of degrees-of-freedom is variable.
5. SIL=0 indicates inactive degrees-of-freedom.
Main Index
306 LAMA
Normal modes or buckling eigenvalue summary table
Record 1 -- HEADER
Record 3 -- LAMA
Repeats for each eigenvalue.
Main Index
LAMA 307
Normal modes or buckling eigenvalue summary table
Record 4 -- TRAILER
Main Index
308 MPT
Table of Bulk Data entry images related to material properties
Record 1 -- HEADER
Record 2 -- CREEP(1003,10,245)
Record 3 -- MAT1(103,1,77)
Main Index
MPT 309
Table of Bulk Data entry images related to material properties
Record 4 -- MAT2(203,2,78)
Record 5 -- MAT3(1403,14,122)
Main Index
310 MPT
Table of Bulk Data entry images related to material properties
Record 6 -- MAT4(2103,21,234)
Record 7 -- MAT5(2203,22,235)
Main Index
MPT 311
Table of Bulk Data entry images related to material properties
Record 8 -- MAT8(2503,25,288)
Main Index
312 MPT
Table of Bulk Data entry images related to material properties
Record 9 -- MAT9(2603,26,300)
Record 10 -- MAT10(2801,28,365)
Record 11 -- MAT11(2903,29,371)
This record is not currently used.
Main Index
MPT 313
Table of Bulk Data entry images related to material properties
Record 12 -- MATHP(4506,45,374)
Main Index
314 MPT
Table of Bulk Data entry images related to material properties
Main Index
MPT 315
Table of Bulk Data entry images related to material properties
Record 13 -- MATS1(503,5,90)
Main Index
316 MPT
Table of Bulk Data entry images related to material properties
Record 14 -- MATT1(703,7,91)
Record 15 -- MATT2(803,8,102)
Record 16 -- MATT3(1503,15,189)
Record 17 -- MATT4(2303,23,237)
Main Index
MPT 317
Table of Bulk Data entry images related to material properties
Record 18 -- MATT5(2403,24,238)
Record 19 -- MATT8(903,9,336)
This record is not currently used.
Record 20 -- MATT9(2703,27,301)
Main Index
318 MPT
Table of Bulk Data entry images related to material properties
Record 21 -- -- MBOLT(12600,126,646)
Record 22 -- MBOLTUS(12800,128,650)
Main Index
MPT 319
Table of Bulk Data entry images related to material properties
Record 23 -- -- MSTACK(12700,127,649)
Main Index
320 MPT
Table of Bulk Data entry images related to material properties
Record 25 -- RADBND(9002,90,410)
Main Index
MPT 321
Table of Bulk Data entry images related to material properties
Record 26 -- RADM(8802,88,413)
Record 27 -- RADMT(8902,89,423)
Record 28 -- NLPARM(3003,30,286)
Main Index
322 MPT
Table of Bulk Data entry images related to material properties
Record 29 -- NLPCI(3104,32,350)
Record 30 -- TSTEPNL(3103,31,337)
Main Index
MPT 323
Table of Bulk Data entry images related to material properties
Record 31 -- TRAILER
Main Index
324 OBJTAB
Design objective table
OBJTAB is defined for a given analysis type and superelement and contains objective attributes with
retained response identification numbers.
Record 1 -- HEADER
Record 2 -- HEADER
Record 3 -- TRAILER
Main Index
OEE 325
Output element energy (strain, kinetic, loss)
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
326 OEE
Output element energy (strain, kinetic, loss)
Record 3 -- DATA
Main Index
OEE 327
Output element energy (strain, kinetic, loss)
Main Index
328 OEE
Output element energy (strain, kinetic, loss)
Record 4 -- 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
OEF 329
Table of element forces
Also contains composite failure indices and a analysis types (real and complex) and SORT1 and SORT2
formats.
Record 1 -- HEADER
Record 2 -- DATA
Record 3 -- IDENT
Main Index
330 OEF
Table of element forces
Main Index
OEF 331
Table of element forces
Record 4 -- DATA
Main Index
332 OEF
Table of element forces
Main Index
OEF 333
Table of element forces
Main Index
334 OEF
Table of element forces
Main Index
OEF 335
Table of element forces
Main Index
336 OEF
Table of element forces
Main Index
OEF 337
Table of element forces
Main Index
338 OEF
Table of element forces
Main Index
OEF 339
Table of element forces
Main Index
340 OEF
Table of element forces
Main Index
OEF 341
Table of element forces
Main Index
342 OEF
Table of element forces
Main Index
OEF 343
Table of element forces
Main Index
344 OEF
Table of element forces
Main Index
OEF 345
Table of element forces
Main Index
346 OEF
Table of element forces
Main Index
OEF 347
Table of element forces
Main Index
348 OEF
Table of element forces
Main Index
OEF 349
Table of element forces
Main Index
350 OEF
Table of element forces
Main Index
OEF 351
Table of element forces
Main Index
352 OEF
Table of element forces
Main Index
OEF 353
Table of element forces
Main Index
354 OEF
Table of element forces
Main Index
OEF 355
Table of element forces
Main Index
356 OEF
Table of element forces
Main Index
OEF 357
Table of element forces
Main Index
358 OEF
Table of element forces
Main Index
OEF 359
Table of element forces
Main Index
360 OEF
Table of element forces
Main Index
OEF 361
Table of element forces
Main Index
362 OEF
Table of element forces
Main Index
OEF 363
Table of element forces
Main Index
364 OEF
Table of element forces
Main Index
OEF 365
Table of element forces
Main Index
366 OEF
Table of element forces
Main Index
OEF 367
Table of element forces
Main Index
368 OEF
Table of element forces
Main Index
OEF 369
Table of element forces
Main Index
370 OEF
Table of element forces
Main Index
OEF 371
Table of element forces
Main Index
372 OEF
Table of element forces
Main Index
OEF 373
Table of element forces
Main Index
374 OEF
Table of element forces
Main Index
OEF 375
Table of element forces
Main Index
376 OEF
Table of element forces
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
Record 5 -- TRAILER
Note: 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
Ch. 4: Data BlocksMSC Nastran DMAP Programmer’
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
382 OES
Table of element stresses or strains
Main Index
OES 383
Table of element stresses or strains
Record 3 -- DATA
Main Index
384 OES
Table of element stresses or strains
Main Index
OES 385
Table of element stresses or strains
Main Index
386 OES
Table of element stresses or strains
Main Index
OES 387
Table of element stresses or strains
Main Index
388 OES
Table of element stresses or strains
Main Index
OES 389
Table of element stresses or strains
Main Index
390 OES
Table of element stresses or strains
Main Index
OES 391
Table of element stresses or strains
Main Index
392 OES
Table of element stresses or strains
Main Index
OES 393
Table of element stresses or strains
Main Index
394 OES
Table of element stresses or strains
Main Index
OES 395
Table of element stresses or strains
Main Index
396 OES
Table of element stresses or strains
Main Index
OES 397
Table of element stresses or strains
Main Index
398 OES
Table of element stresses or strains
Main Index
OES 399
Table of element stresses or strains
Main Index
400 OES
Table of element stresses or strains
Main Index
OES 401
Table of element stresses or strains
Main Index
402 OES
Table of element stresses or strains
Main Index
OES 403
Table of element stresses or strains
Main Index
404 OES
Table of element stresses or strains
Main Index
OES 405
Table of element stresses or strains
Main Index
406 OES
Table of element stresses or strains
Main Index
OES 407
Table of element stresses or strains
Main Index
408 OES
Table of element stresses or strains
Main Index
OES 409
Table of element stresses or strains
Main Index
410 OES
Table of element stresses or strains
Main Index
OES 411
Table of element stresses or strains
Main Index
412 OES
Table of element stresses or strains
Main Index
OES 413
Table of element stresses or strains
Main Index
414 OES
Table of element stresses or strains
Main Index
OES 415
Table of element stresses or strains
Main Index
416 OES
Table of element stresses or strains
Main Index
OES 417
Table of element stresses or strains
Main Index
418 OES
Table of element stresses or strains
Main Index
OES 419
Table of element stresses or strains
Main Index
420 OES
Table of element stresses or strains
Main Index
OES 421
Table of element stresses or strains
Main Index
422 OES
Table of element stresses or strains
Main Index
OES 423
Table of element stresses or strains
Main Index
424 OES
Table of element stresses or strains
Main Index
OES 425
Table of element stresses or strains
Main Index
426 OES
Table of element stresses or strains
Main Index
OES 427
Table of element stresses or strains
Main Index
428 OES
Table of element stresses or strains
Main Index
OES 429
Table of element stresses or strains
Main Index
430 OES
Table of element stresses or strains
Main Index
OES 431
Table of element stresses or strains
Main Index
432 OES
Table of element stresses or strains
Main Index
OES 433
Table of element stresses or strains
Main Index
434 OES
Table of element stresses or strains
Main Index
OES 435
Table of element stresses or strains
Main Index
436 OES
Table of element stresses or strains
Main Index
OES 437
Table of element stresses or strains
Main Index
438 OES
Table of element stresses or strains
Main Index
OES 439
Table of element stresses or strains
Main Index
440 OES
Table of element stresses or strains
Main Index
OES 441
Table of element stresses or strains
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
Record 4 -- 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 505
Table of grid point forces
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
506 OGF
Table of grid point forces
Record 3 -- DATA
Main Index
OGF 507
Table of grid point forces
Main Index
508 OGF
Table of grid point forces
Main Index
OGF 509
Table of grid point forces
Record 4 -- 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
2 = reigen
3 = ds0
4 = ds1
5 = freq
6 = bkl0
7 = bkl1
8 = ceigen
9 = pla
Main Index
510 OGS
Table of grid point stresses/strains or discontinuities
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
OGS 511
Table of grid point stresses/strains or discontinuities
Record 3 -- DATA
Main Index
512 OGS
Table of grid point stresses/strains or discontinuities
Main Index
OGS 513
Table of grid point stresses/strains or discontinuities
Main Index
514 OGS
Table of grid point stresses/strains or discontinuities
Main Index
OGS 515
Table of grid point stresses/strains or discontinuities
Record 4 -- TRAILER
Main Index
516 OPG
Table of applied loads
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
OPG 517
Table of applied loads
Main Index
518 OPG
Table of applied loads
Record 3 -- DATA
Main Index
OPG 519
Table of applied loads
Main Index
520 OPG
Table of applied loads
Record 4 -- TRAILER
Main Index
OPTPRM 521
Table of optimization parameters
Record 1 -- HEADER
Record 2 -- PARAMS
Main Index
522 OPTPRM
Table of optimization parameters
Record 3 -- TRAILER
Main Index
OQG 523
Table of single or multipoint constraint forces
For all analysis types (real and complex) and SORT1 and SORT2 formats.
Record 1 -- HEADER
Record 2 -- IDENT
Main Index
524 OQG
Table of single or multipoint constraint forces
Main Index
OQG 525
Table of single or multipoint constraint forces
Record 3 -- DATA
Main Index
526 OQG
Table of single or multipoint constraint forces
Main Index
OQG 527
Table of single or multipoint constraint forces
Record 4 -- TRAILER
Main Index
528 OUG
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 1 -- HEADER
Record 2 -- IDENT
Main Index
OUG 529
Table of displacements, velocities, accelerations
Main Index
530 OUG
Table of displacements, velocities, accelerations
Record 3 -- DATA
Main Index
OUG 531
Table of displacements, velocities, accelerations
Main Index
532 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 533
Table of displacements, velocities, accelerations
Main Index
534 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 535
Table of displacements, velocities, accelerations
Main Index
536 OUG
Table of displacements, velocities, accelerations
Main Index
OUG 537
Table of displacements, velocities, accelerations
Record 4 -- TRAILER
Main Index
538 R1MAP
Table of mapping from original first level
Record 1 -- HEADER
Record 2 -- RESPONSE
Record 3 -- TRAILER
Main Index
R1TAB 539
Table of type one response attributes
Record 1 -- HEADER
Record 2 -- Repeat
Main Index
540 R1TAB
Table of type one response attributes
Main Index
R1TAB 541
Table of type one response attributes
Main Index
542 R1TAB
Table of type one response attributes
Main Index
R1TAB 543
Table of type one response attributes
Main Index
544 R1TAB
Table of type one response attributes
Main Index
R1TAB 545
Table of type one response attributes
Record 3 -- 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
546 RESP12
Table of second level (synthetic) responses
Record 1 -- HEADER
Main Index
RESP12 547
Table of second level (synthetic) responses
Main Index
548 RESP12
Table of second level (synthetic) responses
Record 3 -- TRAILER
Main Index
RESP12 549
Table of second level (synthetic) responses
Main Index
550 SEMAP
Superelement Definition Table (Map)
Record 1 -- HEADER
Record 2 -- DEFINE
Repeated for each superelement according to process order.
Main Index
SEMAP 551
Superelement Definition Table (Map)
Record 3 -- MAP
Repeated for each superelement according to process order and contains
LENTRY words per grid point.
Record 4 -- INFO
Repeated for each superelement according to process order.
Main Index
552 SEMAP
Superelement Definition Table (Map)
Record 5 -- TRAILER
Notes: 4. In ENTRY=GRIDMAP, bits are numbered left to right beginning with zero and
span LENTRY-1 words.
Main Index
SEMAP 553
Superelement Definition Table (Map)
Notes: 5. where MAXBIT = NBPW*(LENTRY-1)-1, NBPW is the number of bits per word,
and "incongruent" indicates inconsistent coordinate systems on the boundary point.
6. In RECORD=INFO The primary superelement exterior grids points are sorted in
the order of the secondary exterior grid points. Only if SEQSEP is specified.
7. SELABEL is created by SEP1X only.
8. LENTRY is computed from IDBITS:
a. IDBITS is the minimum number of bits required to represent NBRSE.
ln max NBRSE,1
IDBITS = int -------------------------------------------------- + 1.01
ln 2
Main Index
554 SET
Table of combined sets
Record 1 -- HEADER
Record 2 -- (*)
Record 3 -- TRAILER
Main Index
TOL 555
Transient response time step output list
Record 1 -- HEADER
Record 2 -- TRAILER
Main Index
556 VIEWTB
View information table
Contains the relationship between each p-element and its view-elements and
view-grids.
Record 1 -- HEADER
Record 2 -- BEAMP(10500,105,14)
Main Index
VIEWTB 557
View information table
Record 3 -- HEXAP(14100,141,18)
Record 4 -- PENTAP(14200,142,16)
Main Index
558 VIEWTB
View information table
Record 5 -- QUADP(10300,103,16)
Record 6 -- TETRAP(14300,143,14)
Main Index
VIEWTB 559
View information table
Record 7 -- TRIAP(10400,104,15)
Main Index
560 VIEWTB
View information table
Record 8 -- 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 3: Nastran Data Definition Language (NDDL)
MSC Nastran DMAP Programmer’s Guide
NDDL Summary
Detailed Description of NDDL Statements
Main Index
562 MSC Nastran DMAP Programmer’s Guide
NDDL Summary
NDDL Summary
The NDDL (MSC Nastran Data Definition Language) has several purposes:
1. The NDDL describes the hierarchical data structure of the MSC Nastran database.
2. The NDDL provides the mechanism, in conjunction with the TYPE DMAP statement, for
determining which MSC Nastran generated data blocks or parameters or both will be stored on
the database.
3. The NDDL provides the schema necessary for representing the data block data structure.
4. The NDDL and its associated query language provides the means for selecting from the
hierarchical database structure specific data blocks in the form of flat tables, thus admitting them
to relational database manipulation.
5. The NDDL provides the necessary data dependencies for automatic modified restarts.
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
Chapter 3: Nastran Data Definition Language (NDDL) 563
Detailed Description of NDDL Statements
Main Index
564 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:
'$7$%/.,db_name,3$7+=pathname,/2&$7,21=loc_param,
MATRIX
UNSTRUCTURED
TYPE = TABLE style SAMEAS,sname 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 565
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:
• item_component defines a single item.
• entry_component defines a description of one or more record components and may be repeated
in the record.
• either_component defines a description of one or more record components and is conditional
upon the value of another item anywhere in the record.
item_component has one of the following forms:
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. For items referenced by BACK, item_type can only be I, PC4, or
PC5. For items referenced by COUNT, item_type must be I.
• item_type is:
Main Index
566 DATABLK
Describes data blocks used for NDDL access
(175<[=entry-name],
rec_component
SAMEAS, sentry_name
n
COUNT =
item_name
ENDENTRY,
EOR
WITH ,
end_value1,end_value2,
where:
Main Index
DATABLK 567
Describes data blocks used for NDDL access
AHEAD
(,7+(5 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:
Keywords:
Main Index
568 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. Name syntax is same as db_name.
entry_name Entry name. Optional. Name syntax is same as db_name.
item_name Item name.
item_vali Item value. If AHEAD or BACK is used then the type of item_vali must match
the item_type assigned to item_name. If item_type is PC4 or PC5, then
item_vali must be enclosed in single quotation marks.
func_code Function code. Optional. Specifies the function to perform on the value of
item_name, before comparing to item_val.
Func_code Operation
1 if (item_name / 1000) = 2, 3, or 5 then set to 2; else then set
to 1
2 mod( item_name, 100 )
3 mod( item_name, 1000 ) / 100
4 item_name / 10
5 mod( item_name, 10 )
6 if iand(item_name,8) 0 then set to 0; else then set to 1
7 if (item_name/1000) = 0 or 2 then set to 0; else 4 or 5 then set
to 2; else then set to 1
8 rightmost 16 bits of item_name
>65535 iand(item_name,iand(func_code,65535))
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.
2. For UNDEF items, DEPENdencies are not checked and for transfer of data between machine types
they are considered integer zero.
Main Index
DATABLK 569
Describes data blocks used for NDDL access
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.
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, MSC Nastran
sees not the record name e.g., MAT9, but rather the describer e.g.,(2603,26,300).
RECORD=CYJOIN(5210,52,257),
SIDE,I,C,I,
ENTRY,
G1,I,
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:
Main Index
570 DATABLK
Describes data blocks used for NDDL access
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,
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.
,...,
ENTRY=SOLDSP,SAMEAS,NONLIN,ENDENTRY,
Main Index
DATABLK 571
Describes data blocks used for NDDL access
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.
,...,
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.
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.
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.
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
Main Index
572 DATABLK
Describes data blocks used for NDDL access
OR,2,
GO,I,UNDEF,2,F,I,
ENDEITH, ...
In the example above, AHEAD(F) says read F, which is required to be integer (I) or packed character
(PC4 or PC5), to determine the appropriate description.N
EITHER,’OPT1’
X1,RS,Y1,RS,Z1,RS,
OR,’OPT2’
I1,I,I2,I,I3,I,
OR,’OPT3’,
R1,RS,I2,I,R3,RS,
ENDEITH, ...
Main Index
DEPEN 573
Specifies the dependence of a data block or parameter
Specifies the dependence of a data block or parameter on another data block, parameter, or virtual
parameter.
Format:
dep_db_name DB indep_db_namei DB
dep_param_name P indep_param_namei DB : desc_loc ,
dep_virtual_name VP indep_virtual_namei VP
DEPEN
Meaning: dep_* is dependent upon indep_*. In other words, if any or all of indep_* changes,
or is also marked for deletion. The RESTART module detects changes and marks
dep_* for deletion.
Variables:
dep_* Dependent data block, parameter, or virtual parameter as indicated by DB, P, or VP,
respectively.
indep_* Independent data block, parameter, or virtual parameter as indicated by DB, P, or VP,
respectively.
desc_loc Description locator of the independent record, entry, or item and the format is
record_name : entry_name : item_name
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,
Examples:
1. EPTS example:
Main Index
574 DEPEN
Specifies the dependence of a data block or parameter
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 575
Defines parameters requiring a path and/or dbset location
Format:
Variables:
parameter-name The name of the parameter; 1 through 8 characters in length. The first
character must be alphabetic. The following characters can be used for
parameter-names A through Z and 0 through 9. Any other characters are
invalid.
default-value The explicit default value of the parameter. If no default value is given,
CHARi defaults to a “blank” and all others default to zero.
data-type The data type. Possible data types are as follows:
Description data-type
Integer I
Real single precision RS
Real double precision RD
Complex single precision CS
Complex double precision CD
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.
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.
Main Index
576 PARAM
Defines parameters requiring a path and/or dbset location
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 577
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
578 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
Chapter 4: DMAP Modules and Statements
MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement List
DMAP Module and Statement Description Summary
Detailed Descriptions of DMAP Modules and Statements
Main Index
580 MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement List
Matrix Modules
FBS SMPYAD
Main Index
Chapter 4: DMAP Modules and Statements 581
DMAP Module and Statement List
Utility Modules
Main Index
582 MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement List
Main Index
Chapter 4: DMAP Modules and Statements 583
DMAP Module and Statement List
Main Index
584 MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement List
Main Index
Chapter 4: DMAP Modules and Statements 585
DMAP Module and Statement Description Summary
Matrix Modules
–1
FBS X = L U B
T
MPYAD X = A B C or X = A B C
NORM X = A normalized to 1.0 maximum in each column
PARTN
A A11 A12
A21 A22
Main Index
586 MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement Description Summary
UPARTN K jj K jl Pj
K ii or P i -----
K lj K ll Pl
Utility Modules
Main Index
Chapter 4: DMAP Modules and Statements 587
DMAP Module and Statement Description Summary
Main Index
588 MSC Nastran DMAP Programmer’s Guide
DMAP Module and Statement Description Summary
Main Index
ACMG 589
Detailed Descriptions of DMAP Modules and Statements
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
590 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 591
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
592 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.
OGPWGBW Grid point weight generator table transformed to the basic coordinate system divided
by WTMASS.
CASECC Table of Case Control command images.
PCDB Table of model (undeformed and deformed) plotting commands.
Main Index
ADAMSMNF 593
Generate files for MSC.Adams
Parameters:
Main Index
594 ADAMSMNF
Generate files for MSC.Adams
0 None; no plot set is used to restrict element and grid output; all grids and
elements will be output.
>0 All grids and element plot sets present in SET=PSETID.
CCSET Input-integer-default=-1. Case Control set identification number which specifies a
set of grids to be used for the N1,N2... list of the COARSEN option. (Reserved for
possible future implementation.)
PRECOL Input-integer-default=-1. Column number of preload vector in PXA. If
PRECOL<=0, then there is no preload.
WTMASS Input-real-default=1.0. Scale factor on structural mass matrix.
Remarks:
1. The invariants can be output to the MNF file only if MINVAR<>'NONE'.
Main Index
ADAMSRBM 595
Calculates rigid body motion based on MSC.ADAMS results
Format:
ADAMSRBM RBH,UGX,CSTM,BGPDT/URGB/APP $
RBH Large motion matrix computed by MSC.ADAMS. RBH contains six rows: the
first 3 rows are large translations and the next 3 rows are Euler angles.
UGX Solution matrix in g-set from frequency or transient response analysis.
CSTM Table of coordinate system transformation matrices.
BGPDT Basic grid point definition table.
Parameters:
Main Index
596 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 597
Performs and prints error estimate for current p-values
Parameters:
Remarks:
1. If superelements are present then CASECC must contain only the residual structure. EPT, EST,
UG, MPT, CSTM, GEOM4, BGPDT, and GPSNT apply to the current superelement only. See
Example.
2. If DATAREC Case Control command and OUTPUT Bulk Data entries are specified, then
ADAPT will also print or punch out the p-value and error tables for specified p-element
identification numbers at desired adaptivity loops.
Main Index
598 ADAPT
Performs and prints error estimate for current p-values
Example:
Set up ADAPT module for superelement analysis.
Main Index
ADD 599
Matrix add
Format:
ADD A,B/X/ALPHA/BETA/IOPT $
X Matrix
Parameters:
IOPT Operation
0 + , add
1 * , multiply
if A ij or B ij = 0, then X ij = 0
2 , divide
= A ij if B ij =
3 = B ij if B ij
Main Index
600 ADD
Matrix add
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.
2. 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 .
3. If A and B are not the same size, then the size of X will be the size of A. For example,
1 2 5 + 8 10 5
78 =
3 4 6 3 4 6
or
1 2 5 =
7 8 + 8 10
3 4 6
4. If ALPHA or BETA are specified as constants and their imaginary part is zero; e.g., “(5.,0.)”, then
they may alternately be specified as real constants; e.g., “5.” See examples.
5. For exponentiation of each element in a matrix, see DIAGONAL, 729 module.
Examples:
1. Add KDD to MDD:
ADD KDD,MDD/DDD $
2. Multiply MAA by 5.0:
ADD MAA,/MAA5/(5.0,0.0) $
or
ADD MAA,/MAA5/5.0 $
3. Overwrite terms of A with terms of:
ADD A,B/X///3 $
Main Index
ADD5 601
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
602 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 $
3. Scale A by a large number. The largest element in A is 1.0.
TYPE PARM,,CD,,SCALER=(1.D40,0.0D0) $
ADD5 A,,,,/ASCALED//////SCALER $
4. Change the type of the real double precision matrix A to complex.
ADD5 A,,,,/ACD//(1.,1.) $
Although the value of the second parameter does not appear in the output, it changes the type from
real double precision (type 2) to complex double precision.
Main Index
ADG 603
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
604 ADG
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
ADJMOD 605
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
606 ADR
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
ADR 607
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
608 AELOOP
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
AELOOP 609
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
610 AELOOP
Aerodynamic loop driver
Main Index
AEMODEL 611
Aerodynamic model loop driver
Drives the aerodynamic model loop and sets parameter values for the generation of aerodynamic tables.
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
612 AFPMP
Field point mesh data recovery
Format:
Parameters:
Main Index
AFPMP 613
Field point mesh data recovery
Main Index
614 AIEMGA
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
AIEMGA 615
Acoustic infinite element matrix generation and assembly
Parameters:
Main Index
616 AMG
Builds aerodynamic influence matrix
Generates a list of aerodynamic influence matrices (AJJT) and the transformation matrices needed to
convert these to the aerodynamic grid points (SKJ, D1JK, D2JK).
Format:
AMG MKLIST,ACPT/
AJJT,SKJ,D1JK,D2JK/
NK/NJ/SYMXZ/SYMXY/REFC/S,N,MACH0/MACHNO/
KBAR/APP/SUPAERO $
Parameters:
Main Index
AMG 617
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
618 AMP
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
AMP 619
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
620 APD
Generates aerodynamic geometry tables
Generate boxes, grid points, connectivity, degree-of-freedom sets, coordinate systems and control
information for aerodynamic analysis.
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
APD 621
Generates aerodynamic geometry tables
Parameters:
Remarks:
1. AEECT*, AEBGPDT*, and AEUSET* are output family data blocks based on qualifiers AEID
and MODLTYPE. AEID is not currently being used and is always 0.
2. BGPDT, ECT, and USET0 where MODLTYPE='STRUCTUR' are output by GP1, GP2, and
GP4, respectively.
Main Index
622 APPEND
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. This data block may have been created previously. See IOPT > 2.
Parameters:
Main Index
APPEND 623
Concatenate two data blocks
Remarks:
1. Under IOPT = 2, the output matrix data block is also used as an input and must be declared
APPEND in a FILE DMAP statement.
2. If the inputs are matrices then both inputs must be of the same type.
3. Either IN1 or IN2 may be purged. For IOPT = 2, IN2 must be purged.
4. In matrix appends, string formatted records are copied from one matrix data block to another.
5. In table appends, the header record is skipped on the appended file and all remaining records.
Also, the trailer of OUT will be set to that of IN2 (IOPT = 1) or IN1 (IOPT = 2).
6. It is recommended that the OUT data block be a scratch data block. In other words, it should not
be saved on a permanent DBset.
7. For values of IOPT -16, -17, -18, -19, or -2
the order in which the parameters are written is reversed. For example, IOPT=-20 causes CHAR
to be written first, then NULL2.
8. If NULL1 > 0, then a type code value is written in the word immediately preceding the word(s)
containing the value of the parameter. The type codes are: 0:INT, 1:REAL, 2:REALD, 3:CMPX,
4:CMPXD and 8:CHAR.
9. For IOPT > 10, trailer word 1 will contain a count of the number of data records on the file and
word 2 will contain the value of the NULL1 parameter.
Main Index
624 APPEND
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
ASDR 625
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
626 ASDR
Prints the extra point aerodynamic displacements
Parameters:
Main Index
ASG 627
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
628 ASG
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
where the number of rows in the UX vector is equal to the number of aerodynamic extra points.
The ZZX and PZ vectors have as many rows as there are r-set degrees of freedom. The IP matrix
is a pseudo identity matrix with as many rows as there are constrained extra points specified on
the TRIM Bulk Data entry. The IP matrix has ones in the row and columns corresponding to the
constrained variable and zeros located elsewhere. The Y vector contains the magnitudes of the
trim variable constraints. The AEL matrix contains the constraint relations (if any) specified by
AELINK Bulk Data entries. It has as many rows as there are AELINK constraints. It is required
that the sum of the number of supported degrees of freedom plus the number of TRIM constraints
and number of AELINK constraints equal the number of aerodynamic extra points.
Main Index
AXMDRV 629
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
630 AXMPR1
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
AXMPR2 631
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
632 BCDR
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
BCDR 633
Drives a boundary condition loop
Example:
Here is an excerpt from subDMAP PHASE0:
BCFLAG=TRUE $
NSKIP=0 $
DO WHILE ( BCFLAG ) $
BCDR CASES//SEID/' '/
S,N,NSKIP/S,N,NLOADS/S,N,BCFLAG/S,N,SPC/S,N,MPC/
S,N,SUPORT/S,N,LOAD/S,N,LSEQ//S,N,BC $
.
.
.
ENDDO $
Main Index
634 BDRYINFO
Generates geometry and connectivity information
Generate the geometry and connectivity information for an external superelement definition based on the
ASETi and QSETi Bulk Data entries and requested by the EXTSEOUT Case Control command.
Format:
BDRYINFO CASECC,GEOM1,GEOM2,BGPDT,USET,BULK,BULKINDX/
GEOM1EX,GEOM2EX,GEOM4EX,CASEEX/
MTRXFLAG/DMIGSFIX $
Main Index
BDRYINFO 635
Generates geometry and connectivity information
Parameters:
Main Index
636 BGCASO
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
BGP 637
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:
ADPCON Input-real-default=1.0. Scale factor for adjusting penalty values on restart. Update
penalty values if positive.
ISKIP Input-integer-default=0. Counter to update penalty values; updates on first pass and
no update later.
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 $
Main Index
638 BGP
Processes geometry for boundary contact regions
COPY BTOPSTF/BTOPCNV/-1/1 $
Main Index
BMG 639
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:
NOKBFL Output-integer-no default. Matrix KBFL existence flag; 0 if KBFL exists and -1
otherwise.
NOABFL Output-integer-no default. Matrix ABFL existence flag; 0 if ABFL exists and -1
otherwise.
MFACT Output-complex-no default. Scale factor for hydroelastic boundary mass matrix.
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,/
Main Index
640 BMG
Generates hydroelastic boundary matrices
LUSETD/NOABFL/NOKBFL/0 $
Main Index
BNDSPC 641
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.
2. YS cannot be purged.
Main Index
642 BNDSPC
Processes constraints on superelement boundaries
Example:
Excerpt from subDMAP PHASE0 with BNDSPC in a superelement and boundary condition loop.
Main Index
CAMPREP 643
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
644 CAMPREP
Creates list of DDVAL entry values for Campbell looping
0 Speed
>0 Word position in EPT for "property" or MPT for "material"
CAMPNAME Output-character-default=' '. Campbell loop name.
Blank Speed
'T' or 'A' Property
'E' or 'RHO' Material
NCAMPVAL Output-integer-default=0. Number of values on the DDVAL entry.
Main Index
CASE 645
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 /
PVT
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 $
Main Index
646 CASE
Dynamic analysis case control loop driver
Parameters:
Input:
<0 Skip one record on CASECC.
>0 Number of records to skip on CASECC to reach the current subset of
CASECC.
Output:
-1 No more cases.
>0 and APP<>'NONL': Indicates the number of records to skip on CASECC
to reach the next subset of CASECC.
>0 and APP='NONL': Indicates there are more CASECC records to process
and NSKIP must be incremented in the DMAP.
NOLOOP Output-integer-default=-1. Looping test flag.
-1 No DMAP looping is required.
1 DMAP looping is required.
LINC Output-integer-default=0. Number of load increments for this subcase. Used in
nonlinear static analysis only (APP='NONL' and IMETHOD=0).
GMAFLG Input-integer-default=0. Test control flag for changes in the set identification
numbers specified for the SDAMPING, K2PP, M2PP, B2PP, and TFL
commands. Used only when APP='FREQ' or 'CEIG'.
0 Do not ignore changes (default).
1 Ignore changes.
Main Index
CASE 647
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
648 CASE
Dynamic analysis case control loop driver
Main Index
CASE 649
Dynamic analysis case control loop driver
Examples:
1. Extract the load and subcase identification numbers and a parameter value from each subcase.
SOL 100
COMPILE USERDMAP
ALTER 2
TYPE PARM,,I,N,NSKIP $
TYPE PARM,,I,Y,MYPRM $
NSKIP=0 $ INITIALIZE
DO WHILE ( NSKIP>=0 ) $
CASE CASECC,/CASE1/’TRAN’/S,N,NSKIP $
PVT PVT,CASE1/ $
PARAML CASE1//’DTI’/1/1//S,N,SUBID $
PARAML CASE1//’DTI’/1/4//S,N,ILOAD $
MESSAGE //’ SUBID=’/SUBID/’ MYPRM=’/MYPRM/
’ ILOAD=’/ILOAD $
ENDDO $
CEND
SUBCASE 101
PARAM,MYPRM,1
LOAD=111
SUBCASE 102
PARAM,MYPRM,-6
LOAD=222
SUBCASE 103
PARAM,MYPRM,4
LOAD=333
SUBCASE 104
PARAM,MYPRM,22
LOAD=444
SUBCASE 105
PARAM,MYPRM,-3
LOAD=555
SUBCASE 106
PARAM,MYPRM,77
LOAD=666
BEGIN BULK
ENDDATA
2. Extract Case Control records 10, 11, and 12.
CASECASECC,/CASE10/'SLIC'/10/3 $
3. Extract Case Control records with the same MPC, SPC, and SUPORT set identification
numbers beginning at the NSKIP-th record.
CASECASECC,/CASEBC/'COMM'/S,N,NSKIP/
//////'MPC'/'SPC'/'SUPO' $
Main Index
650 CEAD
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 (4-3)
or
T 2
L M p + B p + K = 0 (Lanczo (4-4)
for the eigenvalues p and the associated right eigenvectors or left eigenvectors L .
Given a non-null rectangular matrix K , real or complex, it can be decomposed by the equation:
T
US 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
CEAD 651
Complex, unsymmetric eigenvalue analysis or singular value decomposition
Parameters:
If SID>0, then the CMETHOD command is ignored and the EIGC entry is
selected by this parameter value. Applicable for all methods.
If SID<0, then both the CMETHOD command and all EIGC entries are ignored
and the subsequent parameter values (E, ND1, etc.) will be used to control the
eigenvalue extraction. Applicable for single vector Lanczos, block Lanczos, QZ
Hessenberg, QR Hessenberg, and SVD (Singular Value Decomposition).
METH Input-character-default='CLAN'. If SID<0, then METH specifies the method of
eigenvalue extraction.
CLAN Complex Lanczos (block or single vector).
HESS QZ Hessenberg or QR Hessenberg.
SVD Singular Value Decomposition. See Remark 9.
EPS Input-real-default=1.E-5. Used only when SID<0.
ND1 Input-integer-default=0. The number of desired eigenvectors. Used only when
SID<0. If METH=’SVD’, then
>0 Full SVD is computed.
<0 The "economy" SVD is computed.
=0 All singular values are computed, but no singular vectors are computed.
Main Index
652 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
ALPHAJ Input-real-default=0.0. Real part of shift point for pre-Version 70.5 Lanczos
method. Used only when SID<0.
OMEGAJ Input-real-default=0.0. Imaginary part of shift point for
pre-Version 70.5 Lanczos method. Used only when SID<0.
MAXBLK Input-real-default=0.0. Maximum block size. Used only when SID<0.
IBLK Input-real-default=0.0. Initial block size. Used only when SID<0.
KSTEP Input-real-default=0.0. Frequency of solve. Used only when SID<0.
NDJ Input-integer-default=0. The number of desired eigenvectors at desired shift point
for pre-Version 70.5 Lanczos method. Used only when SID<0.
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 (4-5)
M hh p 2 + B hh p + K hh u h = 0 (4-6)
CEAD also normalizes the eigenvectors according to one of the following user requests:
• Unit magnitude of a selected coordinate (“POINT”).
• Unit magnitude of the largest component (“MAX”).
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.
Main Index
CEAD 653
Complex, unsymmetric eigenvalue analysis or singular value decomposition
which should be identity. See the MSC.Nastran Numerical Methods User’s Guide for the
definition of Y and X.
9. CEAD may be used to perform singular value decomposition.
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
The roots and vectors are sequenced inversely from the MSC Nastran convention. Singular Value
Decomposition is a standard mathematical technique with well-defined properties. Both 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
Main Index
654 CEAD
Complex, unsymmetric eigenvalue analysis or singular value decomposition
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
CMPZPR 655
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 $
EPT Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries.
MPT Table of Bulk Data entry images related to material properties, in particular, MAT2
and MAT8 entries.
DIT Table of TABLEij Bulk Data entry images.
PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry.
EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL records.
MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2 records.
Parameter:
NOCOMP Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry records
are found.
Remarks:
1. CMPZPR is functionally equivalent to module IFP6.
2. For each PCOMP entry (with PID<100000000) in EPT, an equivalent PSHELL entry image with
associated MAT2 images is generated. The newly generated images are then merged with the
existing PSHELL and MAT2 entries and written to the output datablocks EPTC and MPTC,,
respectively. If any duplicates are found in EPT and MPT, then they are simply overwritten.
Furthermore, any entries which may have been internally generated (i.e., with PID or
MID>100000000) are also stripped off.
Main Index
656 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 657
Compute component modal energies
Parameters:
Main Index
658 CMSENGY
Compute component modal energies
Main Index
COPY 659
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.
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
660 CURV
Transforms elemental centroid stresses (or strains)
Transforms elemental centroid stresses (or strains) to the element's material coordinate system and/or
interpolate the stresses (or strains) to element's connecting grid points. Applies to CQUAD4 and CTRIA3
elements and non-corner stresses only.
Format:
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 661
Transforms elemental centroid stresses (or strains)
Remarks:
1. CURV computes the CTRIA3 and CQUAD4 element stress and/or strain output in a material
coordinate system (normal output is in the element or basic coordinate system) and/or to
interpolate the stresses (or strains) to its connecting grid points.
2. For further details see also CURV (p. 711) in the MSC Nastran Quick Reference Guide.
Main Index
662 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 $
EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
BGPDT Basic grid point definition table.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics, p-
element analysis, and the iterative solver; and in particular, SET1 entries.
XYCDB Table of x-y plotting commands.
OPG1 Table of applied loads in SORT1 format.
OQG1 Table of single point forces of constraint in SORT1 format.
OUG1 Table of displacements in SORT1 format.
OES1G Table of grid point stresses in SORT1 format.
OSTR1G Table of grid point strains in SORT1 format.
Parameter:
Main Index
CURVPLOT 663
Converts grid point output tables
Remarks:
1. If EDT or XYCDB is purged, then CURVPLOT exits without warning.
2. EQEXIN and BGPDT cannot be purged.
3. Any of OPG1, OQG1, OUGV1, OES1G or OSTR1G and any of their corresponding outputs may
be purged.
4. OES1G and OSTR1G are computed by CURV.
5. The grid points used on the abscissa are specified on SET1 entries in EDT.
6. The output data blocks cannot be printed with OFP.
7. CURVPLOT is only applicable to static and normal modes analysis.
Example:
Excerpt from subDMAP SEDRCVR.
CURVPLOT EQEXINS,BGPDTS,EDT,XYCDBDR,OPG1,OQG1,OUGV1,OES1G,/
OPG2X,OQG2X,OUG2X,OES2X,/DOPT $
XYTRAN XYCDBDR,OPG2X,OQG2X,OUG2X,OES2X,/XYPLTS/'SET1'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOXYP $
IF ( NOXYP>=0 ) XYPLOT XYPLTS/ $
Main Index
664 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 665
Generates cyclic symmetry tables and transformation matrices
Parameters:
Remark:
CYCLIC1 generates equivalent GRAV and RFORCE Bulk Data entry images in harmonic components.
Main Index
666 CYCLIC2
Processes degrees-of-freedom
Processes degrees-of-freedom that are to be constrained between segments for cyclic symmetry
problems.
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.
3. CYCLIC2 can also accommodate the p-set:
Main Index
CYCLIC2 667
Processes degrees-of-freedom
CYCLIC2 GEOM4,EQDYN,USETD/
CYCD/
NSEG/CTYPE $
where EQDYN and USETD are output by DPD.
Main Index
668 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 669
Forms cyclic matrices
NOKVAL Output-integer-no default. Set to -1 if the value of HINDEX is not in the analysis set
of harmonic identification numbers.
KGTH Output-integer-no default. Set to -1 if all harmonic identification numbers (in
analysis set) have been processed.
REACT Output-integer-no default. Set to -1 if no support degrees-of- freedom; +1 if support
degrees of freedom exist; for k>2, it will always have value of -1.
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
670 CYCLIC4
Transforms cyclic components of load vectors or displacements
Transforms the cyclic components of load vectors associated with a particular harmonic into solution set
load vectors in the forward path. In the backward path, the solution set displacement vectors will be
transformed into cyclic components associated with the particular harmonic and appended to previous
harmonic solutions.
Format:
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 671
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
PARAML KVAL//'DTI'/1/NKVAL//S,N,KMAX $ LAST ANALYSIS HARMONIC
INDEX
PARAML KVAL//'IMATCH'/1/S,N,HINDEX//S,N,KVAL $
DO WHILE ( HINDEX<=KMAX ) $
CYCLIC4 HARM,GC,GS,PA,,,/
Main Index
672 CYCLIC4
Transforms cyclic components of load vectors or displacements
PK,,,/
'FORE'/HINDEX/'STAT'/NFREQ $
.
.
.
CYCLIC4 HARM,GC,GS,UK,,,/
UX,,,/
'BACK'/HINDEX/'STAT'/NFREQ $
ENDDO $ HINDEX<=KMAX
MPYAD UX,BACK,/ULC $
2. Frequency response analysis:
FILE UXVF=APPEND $
HINDEX=0 $ QUALIFIER
DO WHILE ( DONE>=0 ) $
IF ( DONE>=0 ) THEN $
IF ( NOKVAL>=0 ) THEN $
.
.
.
CYCLIC4 HARMF,GC,GS,PXF,,,/
PKF,,,/
'FORE'/HINDEX/RFNAME/NFREQ $
.
.
.
CYCLIC4 HARMF,GC,GS,UKVF,,,/
UXVF,,,/
'BACK'/HINDEX/RFNAME/NFREQ $
ENDIF $ NOKVAL>=0
HINDEX=HINDEX+1
ENDIF $ DONE>=0
ENDDO $ DONE>=0
MPYAD UXVF,BACKF,/UDVF $
3. Normal modes or buckling analysis:
FILE CYPHX=APPEND,SAVE/CYLAMA1=APPEND,SAVE/
CASEBK1=SAVE/BACK1=SAVE,OVRWRT $
PARAML KVALM//'TRAILER'/1/S,N,TOTALK $
PARAML KVALM//'DTI'/1/TOTALK//S,N,KMAX $
PARAML KVALM//'IMATCH'/1/HINDEX//S,N,KVAL $
HINDEX=0 $
DO WHILE ( HINDEX<=KMAX ) $
IF ( KVAL=-1 ) THEN $
.
.
.
CYCLIC4HARM,GC,GS,CYPHA,CYLAMA,CASEBK,BACK/
CYPHX,CYLAMA1,CASEBK1,BACK1/
'BACK'/HINDEX/APPCYC4/S,N,NFREQ/TOTALK $
ENDIF $ KVAL=-1
HINDEX=HINDEX+1 $
PARAML KVALM//'IMATCH'/1/HINDEX//S,N,KVAL $
Main Index
CYCLIC4 673
Transforms cyclic components of load vectors or displacements
ENDDO $ HINDEX<=KMAX
MPYAD CYPHX,BACK1,/CYPHA1 $
Main Index
674 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 675
Database converter for model generation and results processing
BKL1 Buckling
BKL0 Statics in a buckling solution
CEIGEN Complex modes
AERO Aerodynamics
CYCLIC Integer-input-default is 0. If CYCLIC=-1, then data will be interpreted as cyclic
analysis.
GEOMU Integer-input-default=40; the geometric information will output to this FORTRAN
unit.
LOADU Integer-input-default=-1 (LOADU = GEOMU). If LOADU>0 then, the static load
information will be output to this FORTRAN unit.
POSTU Integer-input-default=-1 (POSTU = GEOMU). If POSTU>0, then, the data recovery
information will be output to this FORTRAN unit.
DBCDIAG Integer-input-default=0. Controls the printing of certain diagnostics during the
conversion. If several diagnostics are desired, then the sum of the following values is
required. For example, DBCDIA=3 requests the printing of grid relation and element
connection record diagnostics.
Value Diagnostic Output
0 No diagnostics will be printed.
1 Grid relation record.
2 Element connection record.
4 Internal module begin message.
8 Internal module statistics.
16 Internal module CPU time and begin message in performance
summary table.
32 DBC database dictionary entries.
64 Messages for null NASTRAN logical file connections.
128 Suppress diagnostics when geometry updates occur.
256 Save the grid point stress surface and volume factors.
512 Do not save the grid point stress surface and volume subcase data.
PROGRAM Character-input-default=’XL’. If PROGRAM =’XL’, then the DBC database will be
suitable for processing in MSC.Patran. If PROGRAM =’GRASP’, then the DBC
database will be suitable for processing in MSC.Access.
OVRWRT Character-input-default=’YES’. DBC data base overwrite flag. If OVRWRT =’YES’
and the DBC database was created in a prior run, then data blocks pre-existing on the
DBC database will be overwritten in the current run when the qualifier values are
identical.
DESITER Integer-input-default=0. Design optimization loop identification number.
Main Index
676 DBC
Database converter for model generation and results processing
ADPTINDX Integer-input-default=0. When ADPTINDX is not equal to zero, the data base object
attribute will be qualified by the value of this parameter, which denotes intermediate
p-element results exist.
LUSET Integer-input-default=0. NDOF denotes size of the model (number of degrees of
freedom), which will be saved for p-element iterations indexed by the ADPTINDX
values and used to correlate the size of the model to the p-element iteration index.
Remarks:
1. Data block name table:
Generic
Name Chapter 2
(P1-P20) Names Stored on Unit Description
BEPT AEBGPDT --- Aerostructural basic grid point definition
table
BGPDT BGPDT GEOMU Basic grid point definition table
CASECC CASECC POSTU Table of Case Control command images
CONTAB CONTAB POSTU Table of design constraint attributes
CONTROL AECTRL POSTU Table of aerodynamic model's control
definition
CSTM CSTM GEOMU Table of coordinate system transformation
matrices
CVAL CVAL POSTU Matrix of design constraint values
DBCOPT DBCOPT POSTU Design optimization history table for
DESTAB DESTAB POSTU Table of design variable attributes
DIT DIT GEOMU/ Table of TABLEij Bulk Data entry images
POSTU
DSCM2 DSCM2 POSTU Normalized design sensitivity coefficient
matrix
DYNAMIC DYNAMIC GEOMU Table of Bulk Data entry images related to
dynamics
ECT GEOM2 GEOMU Element connectivity table
ELDCT ELDCT POSTU Table of element stress discontinuities
EMAP SEMAP GEOMU Superelement map table
EPT EPT GEOMU Table of Bulk Data entry images related to
element properties
EQEXIN EQEXIN GEOMU Equivalence between external and internal
point identification numbers
Main Index
DBC 677
Database converter for model generation and results processing
Generic
Name Chapter 2
(P1-P20) Names Stored on Unit Description
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 related to
LOADU constraints, degree-of-freedom membership
and rigid element connectivity
GPDCT GPDCT POSTU Table of grid point stress discontinuities
GPDT GPDT GEOMU Grid point definition table
GPECT GPECT POSTU Grid point element connection table
GPL GPL GEOMU/ External grid/scalar point identification
POSTU 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 summary table
CLAMA
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
Main Index
678 DBC
Database converter for model generation and results processing
Generic
Name Chapter 2
(P1-P20) Names Stored on Unit Description
OEKE ONRGY1 POSTU Table of element kinetic energies
OES OES POSTU Table of element stresses or strains in
SORT1 or SORT2 format
OESC OES1C POSTU Table of composite element stresses or
strains in SORT1 format
OESE ONRGY1 POSTU Table of element strain energies and energy
densities
OESNL OESNL1 POSTU Table of nonlinear element stresses in
SORT1 format
OGPF OGPFB1 POSTU Table of grid point forces
OGPKE OGPKE1 POSTU Table of grid point kinetic energies
OL OL POSTU Transient or frequency response output list
OMM OMM POSTU Table of MAXMIN results
OMPCF OQMG POSTU Table of MPCforces in SORT1 or SORT2
format
OPG OPG POSTU Table of applied loads in SORT1 or SORT2
format
OQG OQG POSTU Table of single or multipoint forces-of-
constraint in SORT1 or SORT2 format
OUG OUG POSTU Table of displacements in SORT1 or SORT2
format
OVG OVG POSTU Table of velocities in SORT1 or SORT2
format
PERROR ERROR1 POSTU Error-estimate table updated for current
superelement or adaptivity loop
R1MAPR R1MAPR POSTU Table of mapping from original first level
(direct) retained responses
R1TAB R1TAB POSTU Table of first level (direct) (DRESP1 Bulk
Data entry) attributes
R1VAL R1VAL POSTU Matrix of initial values of the retained first
level (direct) responses
R2MAPR R2MAPR POSTU Table of mapping from original second level
(synthetic) retained responses
R2VAL R2VAL POSTU Matrix of initial values of the retained
second level (synthetic) responses
Main Index
DBC 679
Database converter for model generation and results processing
Generic
Name Chapter 2
(P1-P20) Names Stored on Unit Description
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 the
POSTU relationship between each p-element and its
view-elements and view-grids
GEOMU BGPDT, CSTM, ECT, EMAP, EPT, GPDT, MPT, and SETS
LOADU GEOM3 and GEOM4
POSTU CASECC, GPS, EQEXIN, GEOM1, GPL, LAMA, OEF, OES, OESNL, OGPF,
OESE, OPG, OQG, OUG, OESC, DBCOPT, GPDCT, and ELDCT
Main Index
680 DBC
Database converter for model generation and results processing
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.
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/
Main Index
DBC 681
Database converter for model generation and results processing
APP//GEOMU/LOADU/POSTU/DBCDIAG/
PROGRAM/ $
Main Index
682 DBDELETE
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:
DATABLK Delete data blocks. datablk-list specifies a list of NDDL-defined data blocks
separated by commas.
PARAM Delete parameters. param-list specifies a list of parameters separated by commas.
where-expr Logical expression that specifies the desired values of colnames described in Table
2 under the DBDICT, 684 statement. If where-expr is true then the named items will
be deleted. For example, WHERE(VERSION=4 AND SEID<>2 AND SEID>0)
selects all items under version 4 for all values of SEID greater than 0 except 2. See
WHERE and CONVERT Clauses, 43 for a further description. The default for
VERSION and PROJECT is the current version and project. See also Remark 1.
Remarks:
1. The where-expr has the following rules:
If the where-expr specifies a colname that is not assigned to the data block or parameter then none
of that data block or parameter will be deleted. For example, given that SPC is not a qualifier for
KGG, then the following DBDELETE statement will not delete any KGG:
DBDELETE DATABLK=KGG WHERE(SPC=10)$
If the where-expr does not specify a colname that is assigned to the data block (or parameter), then
the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA,
then the following DBDICT statements are equivalent:
SPC=10 $
DBDELETE DATABLK=KAA $
or
DBDELETE DATABLK=KAA WHERE(SPC=10) $
The WILDCARD keyword may be added in order to wildcard all qualifiers not already specified
in where-expr. For example to delete all KAA where SPC=10 and regardless of MPC, SEID, etc.:
Main Index
DBDELETE 683
Deletes NDDL data blocks and parameters
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
684 DBDICT
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
Main Index
DBDICT 685
Prints database directory tables
specified with the SORT, FORMAT, and LABEL describers. Note that the full format only allows the
specification of a single table on a DBDICT statement.
DATABLK *
=
DATABLK LOCAL datablk-list
PARAM *
DBDICT = WHERE(where-expr),
PARAM LOCAL param-list
PROJVERS
QUALCURR
QUALIFIERS
SELECT(colname[- ‘ col-label’]. . . ),
SORT colname = A , ,
D
RIGHT
LABEL page - title‘ CENTER
LEFT
Describers:
DATABLK Print the data blocks. datablk-list specifies a list of NDDL-defined data blocks
separated by commas. If LOCAL is specified, the non-NDDL-defined data
blocks are printed.
PARAM Print the parameter table. param-list specifies a list of parameters separated by
commas. If LOCAL is specified, the non-NDDL-defined parameters are
printed.
PROJVERS Print the project-version table.
Main Index
686 DBDICT
Prints database directory tables
Main Index
DBDICT 687
Prints database directory tables
SORT Specifies how the rows are sorted. The sort based on ASCII sequence and is
performed in order according to each colname specified in the list. A “D”
following the colname causes the sort to be in descending order. An “A”
following the colname causes the sort to be in ascending order. Colnames
QUALSET, QUALALL, and TRAILER may not be specified under SORT.
Each colname specified in SORT must be separated by commas.
page-title A title to be printed on each page of the directory output.
RIGHT, CENTER, Print justification of the page title.
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 by a NDDL DATABLOCKS 2
NDDL DATABLK statement.
PARAM Parameters described by a NDDL PARAMETERS 3
NDDL PARAM statement.
QUALCURR Current Qualifiers and their CURRENT QUALIFIERS 4
values.
QUALIFIERS Qualifiers and their values for QUALIFIERS 5
each key number.
DATABLK Data blocks not described by a LOCAL DATABLOCKS 6
(LOCAL) NDDL DATABLK statement.
PARAM(LOCAL) Parameters not described by a LOCAL PARAMETERS 7
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
Main Index
688 DBDICT
Prints database directory tables
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:
* * * * 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.
Main Index
DBDICT 689
Prints database directory tables
Main Index
690 DBDICT
Prints database directory tables
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, AWIDTH=8, and
FWIDTH=12.
SELECT(NAME,DATABASE,DBSET,PROJNO=’PROJ’,VERSION=’VERS’,CDATE,CT
IME,
KEY,VALUE,QUALSET),
FORMAT(NAME=8,DATABASE=8,DBSET=8,CDATE=6,CTIME=6,
KEY=4,VALUE=40,IWIDTH=5,COLSPACE=1),
SORT(PROJNO=A,VERSION=A,DBSET=A,NAME=A),
LABEL(’NDDL PARAMETERS’ CENTER)
and looks like:
* * * * 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
Main Index
DBDICT 691
Prints database directory tables
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
Main Index
692 DBDICT
Prints database directory tables
-----------------------------------------------------------------------------------------------------------
336 ’ ’ 0
0 ’ ’
0 0 -1
0 0 0
QUALALL selects all qualifiers to be printed. The qualifiers will be printed in alphabetic order.
QUALSET selects the only the qualifiers SEID, PEID, SPC, MPC, LOAD, and METH to be
printed.
Table 4-4 gives the allowable colnames along with a description that may be specified in the
FORMAT, SELECT, and SORT describers. QUALALL and QUALSET may not be specified in
the FORMAT or SORT describers. The qualifier names and values are not printed one per row,
but rather from left to right as one logical line that is allowed to wrap after 132 columns.
Column Default
name column width Default column label Description
KEY 5 KEY Key number
qual-name See Note qualifier name Qualifier name
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Predefined subset of all
qualifiers
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and
FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.
5. The default print of the current qualifier values table is obtained by:
DBDICT QUALCURR
and is equivalent to:
DBDICT QUALCURR SELECT(QUALALL),
Main Index
DBDICT 693
Prints database directory tables
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.
Default Default
Column column column
name width label Description
qual-name See Note qualifier name Qualifier name
QUALALL See Note qualifier name All qualifiers
QUALSET See Note qualifier name Pre-defined subset of all qualifiers
Note: Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and
FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.
The default print of the local data block table is obtained by:
DBDICT DATABLK(LOCAL)
and is equivalent to:
DBDICT DATABLK(LOCAL),
SELECT(NAME,SUBDMAP,SIZE=’BLOCKS’,PURGED=’PU’,
EQUIVD=’EQ’,POINTER,TRL1,TRL2,TRL3,TRL4,
TRL5,TRL6,TRL7),
FORMAT(NAME=8,SUBDMAP=8,IWIDTH=8,COLSPACE=2),
SORT(NAME=A) LABEL(’LOCAL DATABLOCKS’ CENTER)
Main Index
694 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
TRLi specifies the data block trailer word i where 1 i 10 . TRAILER selects all 10 data
block trailer words.
The table below gives the allowable colnames along with a description that may be specified in
the FORMAT, SELECT, and SORT describers.
Main Index
DBDICT 695
Prints database directory tables
Listing 4-1
* * * * 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
696 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 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.
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:
Main Index
DBDICT 697
Prints database directory tables
a. If the where-expr specifies a colname that is not assigned to the data block or parameter then
no directory information will be printed for that data block or parameter. For example, given
that SPC is not a qualifier for KGG, then the following DBDICT statement will produce no
output:
DBDICT DATABLK=KGG WHERE(SPC=10) $
b. If the where-expr does not specify a colname that is assigned to the data block (or parameter)
then the qualifier is wildcarded. For example, given that SEID is a qualifier for KAA, then the
following DBDICT statements are equivalent:
DBDICT DATABLK=KAA $
DBDICT DATABLK=KAA WHERE(SEID = *) $
Examples:
1. Print the Project Version Table with a title.
DBDICT PROJVERS SORT(PROJNO,VERSION),
LABEL(’PROJECT VERSION TABLE’ LEFT) $
2. Print a directory of all data blocks qualified with PEID = 10 or SEID = 10. Print columns for the
NAME and DBSET, and the qualifiers SPC, MPC, and LOAD.
DBDICT DATABLK SELECT(NAME,SPC,MPC,LOAD,DBSET,SIZE,
SEID,PEID) ,
SORT(NAME,SIZE=D) WHERE( SEID=10 OR PEID=10) $
Main Index
698 DBEQUIV
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:
datablk-list Specifies a list of data blocks separated by commas. The default is *, which
selects all data blocks. The equivalenced data block may be renamed by
specifying a slash after the old name followed by the new name. For example,
if KLL is to be renamed to KLL1, then DATABLK=(KLL/KLL1) is specified.
param-list Specifies a list of parameters separated by commas. The default is *, which
selected all parameters. The equivalenced parameter may be renamed by
specifying a slash after the old name followed by the new name. For example,
if LUSETS is to be renamed to LUSET, then PARAM=(LUSETS/LUSET) is
specified.
where-expr Logical expression that specifies the desired values of colnames described in
Table 4-2 under the DBDICT statement. If where-expr is true then the named
items will be equivalenced. For example, WHERE(VERSION=4 AND
SEID<>2 AND SEID>0) selects all items under version 4 for all values of
SEID greater than 0 except 2. See WHERE and CONVERT Clauses, 43 for a
further description. The default for VERSION and PROJECT is the current
version and project. See Remark 1 for more information.
Main Index
DBEQUIV 699
Equivalences (or copies) NDDL data blocks and parameters
convert-expr Modifies the values for PROJECT, VERSION, DBSET, and qualifiers selected
by the where-expr. The format of convert-expr is:
PROJECT=project-expr;VERSION=version-expr;
DBSET=DBsetname;quali=qual-expri[;...]
For example, CONVERT (SEID=100+SEID; SPC=102).
Remarks:
1. The where-expr has the following rules:
If the where-expr specifies a colname that is not assigned to the data block or parameter then none
of that data block or parameter will be equivalenced. For example, given that SPC is not a qualifier
for KGG, then the following DBEQUIV statement will not equivalence any KGG:
DBEQUIV DATABLK=KGG WHERE(SPC=10) CONVERT(SPC=20) $
If the where-expr does not specify a colname that is assigned to the data block (or parameter), then
the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA,
then the following DBEQUIV statements are equivalent:
SPC=10 $
DBEQUIV DATABLK=KAA CONVERT(SPC=20) $
or
DBEQUIV DATABLK=KAA WHERE(SPC=10) CONVERT(SPC=20) $
The WILDCARD keyword may be added in order to wildcard all qualifiers not already specified
in where-expr. For example to equivalence all KAA where SPC=10 and regardless of MPC,
SEID, etc.:
DBEQUIV DATABLK=KAA WHERE(SPC=10 AND WILDCARD) CONVERT(SPC=20) $
Note: WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJNO,
VERSION, CDATE, etc.
Main Index
700 DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
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
SubDMAP DBFETCH 701
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.
Example:
Fetch data block named A (name flag = 1 drops the character E) and assign local name as EA.
Main Index
702 SubDMAP DBFETCH
Fetch data blocks stored by DBSTORE
Main Index
SubDMAP DBMGR 703
Functions on data blocks stored by DBSTORE
Performs functions on items stored on the database with this subDMAP and CALL DBSTORE.
Format:
1. Directory print
Print the contents of the database directory.
Format:
CALL DBMGR
’ ’/’ ’/’ ’/’ ’/’ ’ $
Parameters:
None.
Format:
Parameters:
Main Index
704 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
Format:
Parameters:
Format:
Parameters:
Main Index
SubDMAP DBMGR 705
Functions on data blocks stored by DBSTORE
Format:
Parameters:
Format:
Parameters:
Remarks:
1. All parameters must be specified even if they are not used or the default value is desired. Unused
integer parameters can be set to 0 and unused character parameters to ' ' (a string with 5 blanks).
2. If data blocks exist when storing, renaming or equivalencing, then they are overwritten.
Main Index
706 SubDMAP DBMGR
Functions on data blocks stored by DBSTORE
3. If CALL DBMGR is to be used in restart runs with the structured solution sequences (SOLs 101
through 200) then PUTSYS(1, 109) should be specified immediately preceding CALL DBMGR
and PUTSYS(0, 109) should be specified immediately following CALL DBMGR.
Main Index
DBSTATUS 707
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
708 SubDMAP DBSTORE
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.
Examples:
1. Store data block B on dbset DB100:
Main Index
SubDMAP DBSTORE 709
Stores data blocks on the database
Main Index
710 DBVIEW
Creates virtual datalock
Creates virtual data block (or view) from one or more data blocks.
Format:
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, 43 and
Remark 6. Be aware that certain restrictions apply to the where-expr when the
viewname will be used to specify an output data block on a module (see Remark
8).
Remarks:
1. DBVIEW is a nonexecutable statement defined only at compilation. It is not affected by IF ( )
THEN or DO WHILE blocks. Where-expr, however, is evaluated dynamically for the current
values of data-block qualifiers at the module where view-name is specified for input.
2. DBVIEW must be specified prior to the first occurrence of the use of the view-name. It may only
be specified as an input data block to a DMAP module.
3. If the data-block is “not generated” or if no data blocks satisfy the where-expr, then the view-name
will be considered as “not generated.” Also, if the where-expr contains a qualifier that is not in
the path of the data-block then the view-name is not generated.
4. view-name is recognized only in the current subDMAP.
5. A view-name that results in more than one data block is also called a family. If a family is
specified as input to a module that does not use families, then the first data block stored will be
the one that is used.
6. The values assigned to qualifiers not specified in the where-expr are taken from current values.
“AND WILDCARD” may be specified in the where-expr to indicate that unspecified qualifiers
do not have to match their current values to satisfy the DBVIEW statement.
Main Index
DBVIEW 711
Creates virtual datalock
7. A comma may be used in place of the spaces shown under Format to continue the DBVIEW
statement on more than one line. For example,
DBVIEW UGX=UG,
(WHERE SEID=10 AND,
SPC=20,
AND VERSION=5) $
8. 8. If the view-name in the subDMAP is used for an output datablock on a module then the
following restrictions apply:
a. The only operator allowed between qualifier assignments is the ";". For example,
WHERE(SEID)=10; PEID=20).
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) $
3. The following DBVIEW statement creates a view-name for the datablock KAA. The view-name
will be used as an output datablock to a DMAP module. The path qualifiers for this output
datablock will be assigned SEID=20 and SEID=10 and the remaining KAA path qualifiers will
be set to the current values.
DBVIEW KAA20 = KAA WHERE (SEID=20 ; PEID=10) $
4. The following DMAP sequence creates view-names for three input datablocks and four output
datablocks, using the same data block "XYZ".
DBVIEW IN1=XYZ, WHERE(SERIES3=JJ AND SERIES5=0 AND SERIES7=0) $
DBVIEW IN2=XYZ, WHERE(SERIES3=JJ+1 AND SERIES5=0 AND SERIES7=0) $
DBVIEW IN3=XYZ, WHERE(SERIES3=JJ+2 AND SERIES5=0 AND SERIES7=0) $
DBVIEW OUT1=XYZ, WHERE(SERIES3=0 ; SERIES5=1 ; SERIES7=JJ) $
DBVIEW OUT2=XYZ, WHERE(SERIES3=0 ; SERIES 5=2 ; SERIES7=JJ+1) $
Main Index
712 DBVIEW
Creates virtual datalock
Main Index
DCMP 713
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 = LDL 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 $
LD Nonstandard lower triangular factor [L] and diagonal matrix [D] or Cholesky
Factor. [LD] also contains [D] for symmetric decomposition.
U Upper triangular factor or high ratios matrix. If A is unsymmetric then U is the
nonstandard upper triangular factor of [A] or the Cholesky factor. If A is
symmetric and the value of system cell 166 includes the value of 8 then U
contains the contains the "high ratio terms of the factor diagonal ratios". See
Remark 4.
Main Index
714 DCMP
Matrix decomposition with extended diagnostics
Parameters:
KSYM Input/output-integer-default=1.
1 Use symmetric decomposition (default).
0 Use unsymmetric decomposition.
- Use decomposition consistent with form of [A]. KSYM will be reset to 0 or 1
consistent with actual decomposition type.
1
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
DCMP 715
Matrix decomposition with extended diagnostics
Remarks:
1. This module performs all of the functions of the DECOMP module and responds to the same
system cells. However the DCMP module default for KSYM is 1 instead of -1, which is the
default for DECOMP. All Remarks given for the DECOMP module also apply to the DCMP
module.
2. If given unsymmetric matrices (“Form 1"), the mechanism diagnostics are not provided. The
module is then functionally equivalent to the DECOMP module.
3. Data blocks USET, SIL, and PARTVEC and parameter SETNAME are required for the most
efficient method of decomposition. PARTVEC is only required if A is not the same size as
SETNAME.
4. If A is symmetric then U contains the "MATRIX/FACTOR DIAGONAL RATIO values printed
under UWM 4698. The mathematical definition of U is
Diag(A) = Ad, a vector.
Diag(T) = Dd, a vector.
In some circumstances T is not a diagonal matrix. The high ratio test being defined here has no
validity in the regions where there are off-diagonal terms (2 by 2 pivots), so those rows are
ignored in this testing. The ratio is defined as
Vi = Adi/Ddi
Regions where the model is approaching singularity have small Ddi terms. They are divided into
Adi to non-dimensionalize them, and checked against a quality parameter value named
MAXRATIO. The default value for MAXRATIO is 1.E7, but the user is allowed to change its
value. Terms less than MAXRATIO are set to zero in Vi. If any terms remain, the matrix is
identified as singular, and various warning and fatal messages may appear, depending on the
context in which the DCMP module is being called.
This vector may be used to better identify singularities and provide other actions when they are
being approached. This feature is used in normal modes analysis, where points with high ratios
are automatically constrained to ground, to make the eigensolution more stable.
5. The sparse symmetric decomposition method may be used to decompose only a certain partition
specified by a partitioning vector (PARTVEC input data block for DCMP). In this case the
following decomposition is obtained:
Main Index
716 DCMP
Matrix decomposition with extended diagnostics
A oo A oa L oo D oo T LT
L oo ao
A = =
A ao A aa L ao I A aa I
where
T
A aa = A aa – L ao D oo L ao
The results of L oo D oo L ao are written to LD and A aa to LSCM.
Example:
Inspect the numerical conditioning of the
m
M aa
Main Index
DDR2 717
Computes displacements due to mode acceleration
Format:
DDR2 86(7' 8' 3' .'' %'' 0'' 2/ 8186(' /// '0
8' 8( 3'
APP/NOUE/UNUSED1/UNUSED2 $
Parameters:
Main Index
718 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 (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 (4-8)
2
u·· d = – u d (4-9)
where is the forcing frequency and u d is the complex response vector. comes from PPF. The
a
vector P d 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 ------ (4-10)
Pe
a
ua
u d ----- (4-11)
ue
Main Index
DDR2 719
Computes displacements due to mode acceleration
u e is placed in data block UEVF. Subroutines CALCV and SSG2A perform this calculation. If
supports are present, then:
a Pl
P l ----- (4-12)
Pr
ul
u a ----- (4-13)
Pr
a
Solve for u a :
T a a
L ll L ll u l = P l (4-14)
a
a ul + D ur
ua = --------------------------------------- (4-15)
ur
otherwise,
a a
ua = ul
Subroutine SDR1B performs this calculation. If extra points are present, then:
a
a ua
ud ----- (4-16)
ue
a
Note: If the problem type is transient, u d must be merged with u· d and u·· d .
Main Index
720 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 721
Performs matrix method data recovery
Parameters:
OPTION Input-character-default=' '. Response summation method for scaled response spectra
analysis only. Possible values are:
'ABS' Absolute
'SRSS' Square root of the sum of the squares
'NRL' Naval Research Laboratory (new)
'NRLO' Naval Research Laboratory (old)
NOCOMP Input-integer-default=0. Set to 3 if IES is element strains.
ACOUSTIC Input-integer-default=0. Fluid-structure analysis flag.
PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.
0 No fluid elements exist.
1 Penalty or fluid acoustic elements exists.
2 Fluid/structure coupling exists.
ACOUT Input-character-default='PEAK'. Type of acoustic pressure output in fluid-structural
analysis.
'RMS' Root-mean-square
'PEAK' Peak
PREFDB Input-real-default=1.0. Peak pressure reference for pressure level in units of dB or
dBA.
SEID Input-integer-default=0. Superelement identification number.
DVAFLAG Input-integer-default=-1. Flag indicating velocities and accelerations will be output in
separate data blocks.
-1 Velocities and accelerations are contained in OUG.
1 Velocities and accelerations are contained in OVG and OAG.
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 (4-17)
If the modal solutions input to the module are SORT2, the equation is
Main Index
722 DDRMM
Performs matrix method data recovery
2 T 2
Output Matrix = Solution Matrix Data Matrix (4-18)
The output matrix formed for each modal input data block is converted to output data block format for
processing by the module OFP.
In (4-17) and (4-18), the solution matrix contains one solution vector (column) of size h (= number of
eigenvalues used) for each time or frequency step. Thus,
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:
2 1 T 2 1 T
Output Matrix = Output Matrix Output Matrix = Output Matrix
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
DECOMP 723
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 = LDL 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 $
LD Lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor. [LD]
also contains [D] for symmetric decomposition.
U Upper triangular factor or trapezoidal factor for partial decomposition. (See
Remark 4.)
LSEQ Resequencing matrix based on internal resequencing of A.
CPERM Table of column permutations under KSYM=4.
RPERM Table of row permutations under KSYM=4.
Parameters:
KSYM Input/output-integer-default=-1.
1 Use standard decomposition.
0 Use unsymmetric decomposition.
Main Index
724 DECOMP
Matrix decomposition
DECOMP Action
Main Index
DECOMP 725
Matrix decomposition
16 Place 1.0 in diagonal position for all null columns and proceed with
the decomposition.
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.
d. NASTRAN statement system cell 166 selects options for the sparse method.
0 No action.
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].
Main Index
726 DECOMP
Matrix decomposition
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:
T
7. In decomposing symmetric matrices, A = L D L , the diagonal factor D is stored in the
T
diagonal of the LD matrix output. The U = L factor is not output for this case.
8. Matrices with zero diagonal terms may be reliably solved if the corresponding leading minor is
nonzero. A more conservative course is to take a fatal error exit when zero diagonals occur,
regardless of the value of the leading minor. This action is obtained by setting DECOMP = 32.
9. Parallel sparse decomposition is selected with the NASTRAN statement keyword PARALLEL
(or SYSTEM (107)). To obtain optimal performance, it is also recommended that the SEQP
module be used with parameter NEWSEQ = 2.
Examples:
1. Solve A X = B .
DECOMP A/L,U,/ $
FBS L,U,B/X/ $
MATPRN X// $
T
2. Form K = G A G .
T
Then decompose K into L L assuming K is a symmetric matrix.
SMPYAD G,A,G,,,/K/3////1////6 $
DECOMP K/L,,/ $
3. Calculate
–1
K aa = K aa – K ao K oo K oa
Main Index
DECOMP 727
Matrix decomposition
Main Index
728 DELETE
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,
37.
Example:
DELETE /A,B,C,, $
Main Index
DIAGONAL 729
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 $
B Real vector (column matrix) or a rectangular matrix containing the terms of A raised
to a power
Parameters:
Remarks:
1. OPT = 'COLUMN' or 'SQUARE' provide exactly the same functions, except the output using
COLUMN is a vector, and the output using SQUARE is a square diagonal matrix. Both options
process only the real part of the diagonal terms of the input matrix.
Main Index
730 DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
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
–3
terms and print terms less than 10 .
DIAGONAL LOO/LOOD/’COLUMN’/1. $
DIAGONAL KOO/KOOD $
ADD LOOD,KOOD/LOVERK///2 $
MATMOD LOVERK,,,,/BIGLOVRK,/2////1.E-3 $
ADD LOVERK,BIGLOVRK/DIFF//-1.0 $
MATGPR BGPDT,USET,,DIFF//’H’/’O’ $
2. Obtain the absolute value of a matrix [A]
DIAGONAL A/AA/’WHOLE’ $
Main Index
DISDCMP 731
Performs distributed decomposition
Performs distributed decomposition which includes the parallel elimination of boundary nodes and
summation of global schur complement
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
732 DISDCMP
Performs distributed decomposition
Main Index
DISFBS 733
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
734 DISOFPM
Collects and merges OFP data blocks
Collects and merges OFP data blocks from the slave processors to the master processor.
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 735
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
736 DISOPT
Performs appropriate discrete optimization problems
Performs the approximate discrete optimization problem using design variables, constraints, responses,
sensitivity information, Design of Experiments (DOE), conservative discrete design, rounding-up, and
rounding-down approaches.
Format:
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 737
Performs appropriate discrete optimization problems
Main Index
738 DISOPT
Performs appropriate discrete optimization problems
Parameters:
Remarks:
None.
Main Index
DISPARM 739
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
740 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 $
Main Index
DISUTIL 741
Broadcasts data blocks between slave and master processors
DISUTIL MATS,,,////-8, 8, or 9 $
DISUTIL DB,,,/DBOUT/SENDID/RECVCODE/10 $
B Rectangular matrix which is the local load vector (with local values in local a-
set).
X Solution of the equation [A][X]=[B] which is the local solution matrix (with
global values in local a-set).
R Residual matrix which is local (with local or global values in local a-set).
EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.
DB Any data block to be broadcast from the master to the slave processors.
RESMAX Resultant or maxima matrix.
RESMAX0 Resultant or maxima matrix for residual structure.
CASECC Table of Case Control command images.
HEADCNTL List of integer codes for header print control.
UG Displacement matrix in g-set for the current processor (local).
SPCPART Partitioning vector for domain decomposition.
GEQMAP Table of grid based local equation map indicating which grid resides on which
processors/partitions for domain decomposition.
MATS Any matrix on slave processors.
Main Index
742 DISUTIL
Broadcasts data blocks between slave and master processors
Parameters:
Remarks:
1. All executions of DISUTIL must be synchronized across all processors.
2. EPSSE may be purged. EPSSE contains:
Main Index
DISUTIL 743
Broadcasts data blocks between slave and master processors
Main Index
744 DIVERG
Performs aerostatic divergence analysis
Performs aerostatic divergence analysis: determines physically meaningful complex eigenvalues and
saves the eigenvectors that correspond to the divergence roots.
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 745
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
746 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:
ITIME Input-real-no default. Time instant at which the dynamicloads are evaluated and
converted to static loads.Usually input by a user parameter.
LOADIDF Output-integer-default=0. Load set identification numberof the newly created static
load set of follower forces.
Main Index
DMPCASE 747
Splits Case Control across multiple processors
Format:
DMPCASE CASECC/CASECCP/NPROC/PROCID/NMASS/NCASE $
Parameters:
Remarks:
None.
Main Index
748 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:
PARMi Output-logical-default = FALSE. If the i-th output data block is generated, then
PARMi=TRUE.
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 749
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
750 DOM10
Prints initial and final results for design optimization
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 751
Prints initial and final results for design optimization
Examples:
Excerpt from subDMAP DESOPT for initial execution:
DBVIEW TOLV=OLI WHERE (SOLAPP='MTRAN') $
DBVIEW FOLV=OLI WHERE (SOLAPP='MFREQ' OR SOLAPP='DFREQ') $
IF ( DESCYCLE=1
) DOM10 DESTAB,XINIT,,CNTABRG, CVALRG, ,
DVPTAB,PROPI,,R1TABRG,R1VALRG,,
RSP2RG,R2VALRG,,OPTPRMG,OBJTBG,DRSTBLG,
TOLV,FOLV,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
-1/DESMAX/OBJIN//EIGNFREQ $
Excerpt from subDMAP DESOPT for intermediate executions:
DOM10 DESTAB,XINIT,XO,CNTABRG, CVALRG, CVALO,
DVPTAB,PROPI,PROPO,R1TABRG,R1VALRG,R1VALO,
RSP2RG,R2VALRG,R2VALO,OPTPRMG,OBJTBG,DRSTBLG,
TOLV,FOLV,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
DESCYCLE/DESMAX/OBJIN/OBJOUT/EIGENFREQ $
Excerpt from subDMAP EXITOPT for final execution:
DBVIEW FOL1V=FOL1 WHERE(WILDCARD) $
DBVIEW TOL2V=TOL2 WHERE(WILDCARD) $
IF ( CNVFLG=2 OR DESCYCL1=DESMAX OR OPTEXIT=6 ) DOM10,
DESTAB,XVAL,,CNTABRG, CVALRG, ,
DVPTAB,PROPI,,R1TABRG,R1VALRG,,
RSP2RG,R2VALRG,,OPTPRMG,OBJTBG,DRSTBLG,
TOL2V,FOL1V,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
-2/DESMAX/OBJIN//EIGNFREQ $
Main Index
752 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 753
Updates geometry and element properties in design optimization
Parameters:
Remarks:
The DOM11 module performs the following functions:
1. Creates the COORDN data block at the beginning of each iteration and updates property and
shape data blocks EPTN and GEOM1N at the end of each iteration.
2. Writes iteration information to the punch file.
3. Punches updated GRID and DESVAR entries.
Example:
Excerpt from subDMAP PREDOM:
DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,,,
DESGID,COORDO,CON,SHPVEC,/
EPTNN,COORDN,JUNKL/0/0 $
Initial:
DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,/
EPTNNX,COORDN,/0 $
Final:
DOM11 EPT,EPTTAB,PROPO,XO,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,GEOM1/
EPTN,COORDN,GEOM1N/DESCYCLE $
Main Index
754 DOM12
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,EDT,
EPTTAB*,DVPTAB*,XVALP,GEOM1P,
R1TABRG,R1VALRG,RSP2RG,R2VALRG,PCOMPT,UBULK,TOPELE,
PBRMSN,OBJTBG,CVALA,CVALP,DESTBX*,XOS*,PROPOS*,RPART,
SEDVLIST,XOESL,TOPTAB,TPRELE/
HISADD,OPTNEW,DBCOPT,DESNEW,NEWTOP,NEWTPR/
DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/CVTYP/OPTEXIT/
DESMAX/MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ/
DSAPRT/PROTYP/BADMESH/XYUNIT/FSDCYC/OBJAPPX/OBJINIT/
S,N,REJECT/ISHAPE/TREGION/OBJORG/SEID/PSENPCH $
Main Index
DOM12 755
Performs soft and hard convergence checks in design optimization
Main Index
756 DOM12
Performs soft and hard convergence checks in design optimization
Parameters:
Main Index
DOM12 757
Performs soft and hard convergence checks in design optimization
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
DSAPRT Input-logical-default=FALSE. DSAPRT Case Control command print flag.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
BADMESH Input-logical-default=FALSE. Bad geometry was detected.
XYUNIT Input-integer-default=0. Fortran unit number to which the DOM12.
FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this
is a fully stressed design cycle.
Main Index
758 DOM12
Performs soft and hard convergence checks in design optimization
Examples:
Main Index
DOM12 759
Performs soft and hard convergence checks in design optimization
Main Index
760 DOM6
Calculates sensitivity of all retained constraints
Calculates sensitivity of all retained constraints with respect to independent design variables.
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
DOM6 761
Calculates sensitivity of all retained constraints
Parameters:
Main Index
762 DOM9
Performs the approximate optimization problem
Performs the approximate optimization problem using design variables, constraints, responses and
sensitivity information.
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
DOM9 763
Performs the approximate optimization problem
Main Index
764 DOM9
Performs the approximate optimization problem
Parameters:
Main Index
DOPFS 765
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
766 DOPFS
Performs optimization of the fully stressed design
Remarks:
None.
Main Index
DOPR1 767
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,
TOMTAB,PCOMPT, GEOM3, GEOM4 /
DESTAB,XZ,DXDXI,DTB,DVPTAB*,EPTTAB*,CONSBL*,
DPLDXI*,PLIST2*,XINIT,PROPI*,DSCREN,DTOS2J*,
OPTPRM,CONS1T,DBMLIB,BCON0,BCONXI,DMATCK,DISTAB,
TOPTAB,PBRMSD,NWEDOM,NWCASE,TOPMC,
TOPMC2,TMINIT,TOPELE,TPRELE,TOPSM, TOPVOL,
DXDSXI,TOPGID,TOTVOL/
S,N,MODEPT/S,N,MODGEOM2/S,N,MODMPT/S,N,MODEDT/DPEPS/
S,N,PROTYP/S,N,DISVAR/S,N,NRANVAR/
NONLNR/OPTEXIT $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EPT Table of Bulk Data entry images related to element properties.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
MPT Table of Bulk Data entry images related to material properties.
EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.
CASECC Table of Case Control command images.
TOPTAB0 Table of topology designed properties.
TOPELE Element list for topology optimization.
PBRMS Table of intermediate arbitrary beam data.
BGPDT Basic grid point definition table.
ECT Element connectivity table.
GPECT Grid point element connection table.
VELEM Table of element lengths, areas, and volumes.
CSTM Table of coordinate system transformation matrices.
Tomtab Table of Bulk Data entries related to topometry optimization.
Main Index
768 DOPR1
Preprocesses design variables and designed property values
Pcompt Table containing LAM option input and expanded information from the
PCOMP Bulk Data entry.
GEOM3 Table of Bulk Data entry images related to static loads.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
Main Index
DOPR1 769
Preprocesses design variables and designed property values
Parameters:
Main Index
770 DOPR1
Preprocesses design variables and designed property values
Main Index
DOPR2 771
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 $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
BASVEC Auxiliary displacement matrix.
DESTAB Table of design variable attributes.
DXDXI Matrix relating linked and independent design variables.
XINIT Matrix of initial values of the design variables.
CASECC Table of Case Control command images.
AMLIST List of auxiliary model identification numbers.
DVIDS List of shape variable identification numbers to be used for the boundary dvgrid
option.
Main Index
772 DOPR2
Preprocesses the shape design variables and the shape basis vectors
DESVCP Global shape basis vector matrix with incorporation of DLINK relations with
extra columns for property/dummy variables.
CASEP Residual superelement Case Control table for plotting basis vectors.
DNODEL Table of designed and non-designed locations.
Parameters:
Remarks:
1. BASVEC may be DBLOCATE'd or internally generated.
2. CON is an offset vector that ensures the geometry at the beginning of a design cycle is same as
that in the analysis model. It is in the basic coordinate system.
Example:
Excerpt from subDMAP DESOPT:
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,CASEXX,
AMLIST,DVIDS/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,CASEP/
LUSET/NOUGD/PEXIST/DVGRDN $
Excerpt from subDMAP PREDOM:
DOPR2 EDOM,BGPDT,CSTM,BASVEC,DESTAB,DXDXI,XINIT,
CASEXX,,/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCP,CASEP/
LUSET/NOUGD $
Excerpt from subDMAP SCSHBV:
DOPR2 EDOMSX,BGPDTS,CSTMS,,DESTAB,DXDXI,XINIT,CASEXX,,/
DESGID,COORDO,SHPVEC,DCLDXT,CON,DTOS4J,DESVCPS,CASEP/
LUSETS/NOUGD/PEXIST/DVGRDN $
Main Index
DOPR3 773
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,DYNAM
IC/
OBJTAB,CONTAB,R1TAB,RESP12,RSP1CT,FRQRSP,CASEDS,
OINTDS,PELSETDS,DESELM,RESP3,ADRDUG,ADRDUTB,CASADJ,
MODRSP,CASEDM,RQATAB,RESP12X,RESP3X,CONTABX,OBJTABX,
ARVEC/
DMRESD/S,N,DESGLB/S,N,DESOBJ/S,N,R1CNT/S,N,R2CNT/
S,N,CNCNT/SOLAPP/SEID/S,N,EIGNFREQ/PROTYP/DSNOKD/
SHAPES/S,N,R3CNT/RGSENS/INREL/S,N,ADJFLG/S,N,TADJCOL
/
AUTOADJ/SOLADJC/S,N,NORMEV $
CASE Table of Case Control commands for the current analysis type and
superelement.
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
DTB Table of constants from the DTABLE Bulk Data entry.
ECT Element connectivity table.
EPT Table of Bulk Data entry images related to element properties.
DESTAB Table of design variable attributes.
EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ.
DEQIND Index table to DEQATN.
DEQATN Table of DEQATN Bulk Data entry images.
BGPDT Basic grid point definition table.
DVPTAB Table of attributes of the designed properties by internal property identification
number order. Output by DOPR1.
Main Index
774 DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.
CASECC Table of Case Control command images.
TOPTAB0 Table of topology designed properties.
TOPELE Element list for topology optimization.
VIEWTB View information table, contains the relationship between each
p-element and its view-elements and view-grids.
OINT p-element output control table. Contains OUTPUT Bulk Data entries. Output
by IFP.
PELSET p-element set table, contains SETS DEFINITIONS.
XINIT Matrix of initial values of the design variables.
FOL Frequency response frequency output list.
DIT Table of TABLEij Bulk Data entry images.
DYNAMIC Table of Bulk Data entry images related to dynamics.
OBJTAB Design objective table for a given analysis type and superelement. Objective
attributes with retained response identification number.
CONTAB Table of constraint attributes.
R1TAB Table of first level (DRESP1 Bulk Data entry) attributes.
RESP12 Table of second level responses.
RSP1CT Table of the count of type 1 responses per response type per subcase in R1TAB.
FRQRSP Table of the count of type 1 frequency/time responses per response type per
frequency or time step.
CASEDS Case control table for the data recovery of design responses.
OINTDS p-element output control table for constrained elements.
PELSETDS p-element set table for constrained elements.
DESELM Table of designed elements.
RESP3 Table of third level responses.
ADRDUG Matrix of adjoint loads for the g-set.
ADRDUTB Table of adjoint load attributes.
CASADJ Case Control table associated with adjoint method.
MODRSP Table of eigenvector response counts by subcase and mode.
CASEDM Case Control table for the recovery of design responses for modes.
RQATAB Table of Rayleigh Quotient Approximation.
Main Index
DOPR3 775
Preprocesses DCONSTR, DRESP1, and DRESP2
RESP12X RESP12 Table of second level (synthetic) responses from than one
superelement.
RESP3X Table of third level responses from more than one superelement.
CONTABX Table of constraint attributes with respect to RESP12X.
OBJTABX Design objective table for a given analysis type and superelement with respsect
to RESP12X.
ARVEC Residual vector matrix based on adjoint loads.
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.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values.
DSNOKD Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling
design sensitivity analysis. Usually specified as a user parameter.
SHAPES Input-logical-no default. Shape optimization Bulk Data entry presence flag. Must
be TRUE if DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present.
R3CNT Input/output-integer-default=0. Counter for type 3 responses in the RESP3 table.
RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.
Main Index
776 DOPR3
Preprocesses DCONSTR, DRESP1, and DRESP2
INREL Input-integer-default=0. Inertia relief selection flag. Usually input via user
parameter.
ADJFLG Output-integer-default=0. Adjoint sensitivity flag.
TADJCOL Output-integer-default=0. Accumulated column count for adjoint load vector, for
supporting adjoint load method for multiple superelements.
AUTOADJ Input-character-No default. Adjoint sensitivity automatic selection flag. Usually
input via user parameter.
SOLADJC Input-integer-default=0. Flag to select solving adjoint load vectors along with
applied load vectors
>=0 Yes (generate adjoint load vectors in DOPR3).
<0 No (do not generate adjoint load vectors in DOPR3).
NORMEV Output-integer-default=0. Eigenvalue normalization flag.
0 Mass normalized.
1 Maximum deflection normalized.
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
DOPR3X 777
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/ $
RESP12XM Merged table of second level (synthetic) responses from all superelements.
RESP3XM Merged table of third level responses from all superelements.
Parameters:
None.
Main Index
778 DOPR4
Creates design sensitivity tables for property and/or shape variables
Format:
DOPR4 DTOS2J*,DTOS4J,DESTAB/
TABDEQ,DTOS2K*,DTOS4K/
PROTYP $
Parameters:
Main Index
DOPR5 779
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
780 DOPR5
Updates design sensitivity tables
Parameters:
Main Index
DOPR6 781
Generates tables relating to grid perturbations
Format:
DOPR6 DTOS4,GPECT,EQEXIN,DESGID,EST,GEOM4,MIDLIS/
DGTAB,ESTDVS,TABEVS/
RSONLY/RGSENS $
Parameters:
Main Index
782 DOPR6
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
DOPRAN 783
Preprocess RMS responses
Format:
DOPRAN DYNAMIC,DIT,OL,R1TAB,BGPDT,CASE/
RMSTAB,CFSAB,PPVR/
LUSET $
DYNAMIC Table of Bulk Data entry images related to dynamics, specifically RANDPS.
DIT Table of TABLEij Bulk Data entry images, specifically TABRND1.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list.
R1TAB Table of first level (direct) (DRESP1 Bulk Data entry) attributes.
BGPDT Basic grid point definition table.
CASE Table of Case Control commands for the current analysis type and
superelement.
Parameters:
Remarks:
None.
Main Index
784 DPD
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,
ROTORT,FRFCONST/ GPLD,SILD,USETD,TFPOOL,DLT,PSDL,
RCROSSL,NLFT,TRL,EED,EQDYN,APPLOD,ENFLODK,ENFLODB,
ENFLODM,ENFMOTN,FRFXITPP,FRFLABEL,unused,ACPOOL/
LUSET/S,N,LUSETD/S,N,NOTFL/S,N,NODLT/S,N,NOPSDL/
DATAREC/ S,N,NONLFT/S,N,NOTRL/S,N,NOEED/SORTNLFT/
S,N,NOUE/UNUSED12/SEID/FRFGEN/S,N,NOACLD $
GPLD External grid/scalar/extra point identification number list. (GPL appended with
extra point data).
SILD Scalar index list for p-set. (SIL appended with extra point data).
Main Index
DPD 785
Creates tables from Bulk Data entry images specified for dynamic analysis
USETD Degree-of-freedom set membership table for p-set. (USET appended with extra
point data).
TFPOOL Table of TF Bulk Data entry images.
DLT Table of dynamic loads.
PSDL Power spectral density list.
RCROSSL Table of RCROSS Bulk Data entry images.
UNUSED7 Unused.
NLFT Nonlinear Forcing function table.
TRL Transient response list.
EED Table of eigenvalue extraction parameters.
EQDYN Equivalence table between external and internal grid/scalar/extra point
identification numbers. (EQEXIN appended with extra point data).
APPLOD Matrix of applied load amplitudes
ENFLODK Matrix of equivalent enforced motion load amplitudes due to stiffness effects
ENFLODB Matrix of equivalent enforced motion load amplitudes due to viscous damping
effects
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass effects
ENFMOTN Matrix of enforced motion amplitudes
FRFXITPP P-size column matrix generated in an FRF generation job containing coded
values for rows indicating whether the DOF corresponding to that row has unit
load specified on it via an FRFXIT entry, an FRFXIT1 entry or due to its being
a connection DOF (or a combination of these).
FRFLABEL Table containing LABEL information from FRFXIT Bulk Data entries.
ACPOOL Table of ACTRIM Bulk Data entry images.
Parameters:
Main Index
786 DPD
Creates tables from Bulk Data entry images specified for dynamic analysis
DATAREC Input-integer-default=0. Data recovery flag. If DATAREC>0, then DPD will not
perform UFM 2071 checks for DELAY and DPHASE which are not needed in data
recovery.
UNUSED6 Input-integer-default=0. Unused.
NONLFT Output-integer-no default. Set to 1 if nonlinear forcing function Bulk Data entries
are processed, -1 otherwise. 1 also means PSDL is created.
NOTRL Output-integer-no default. Set to 1 if transient time step parameter Bulk Data entries
are processed, -1 otherwise. 1 also means TRL is created.
NOEED Output-integer-no default. Set to 1 if eigenvalue extraction Bulk Data entries are
processed, -1 otherwise. 1 also means EED is created.
UNUSED10 Input-integer-no default. Unused.
NOUE Output-integer-no default. Number of extra points. Set to -1 if there are no extra
points.
UNUSED12 Input-integer-default=0. Unused.
SEID Input-integer-default=0. Superelement identification number.
FRFGEN Input-integer-default=0. FRF generation flag.
0 = Do not generate FRF information
1 = Generate FRF information
NOACLD Output-logical-default=false. Set true if ACLOAD Bulk Data entries are processed.
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
DRMH1 787
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
788 DRMH1
Converts data recovery tables to matrices and associated directory tables
2. DRMH1 will convert tables with complex numbers to a matrix. However, the matrix contains
complex numbers. As a result only the item codes specified in the real side of the plot code tables
are utilized.
3. The DRMH3 module performs the inverse operation: convert matrices into OFP tables.
Example:
In SOL 108, we wish to double the stress output in the OES1 table:
SOL 108
MALTER ’, ETC. DATA RECOVERY, SORT1’(,-1)
DRMH1 OES1,,,/TES,MES,,,,,, $
ADD5 MES,,,,/MES2/2. $
DRMH3 TES,MES2,,,,,,,OL2,CASEDR/OES12,,,/APP1 $
OFP OES12/ $
CEND
Main Index
DRMH3 789
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
790 DRMH3
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, 787 module description.
Main Index
DRMS1 791
Data recovery by mode superposition, Phase 1
To compute output transformation matrices for displacements, SPC forces, stresses, and element forces.
The input data blocks are the type generated by the SDR2 module and formatted for the OFP module.
Format:
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.
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.
Main Index
792 DRMS1
Data recovery by mode superposition, Phase 1
Main Index
DSABO 793
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
794 DSABO
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
DSAD 795
Processes tables related to design sensitivity response evaluation
Processes tables related to design sensitivity response evaluation, constraint screening and load case
deletion.
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.
BLAMA Buckling eigenvalue summary table.
CLAMA Complex eigenvalue summary table.
Main Index
796 DSAD
Processes tables related to design sensitivity response evaluation
Main Index
DSAD 797
Processes tables related to design sensitivity response evaluation
Main Index
798 DSAD
Processes tables related to design sensitivity response evaluation
Main Index
DSAD 799
Processes tables related to design sensitivity response evaluation
Parameters:
DMRESD Input-integer-default=-1. Design model flag. If set to -1, then the design model is
limited to the residual structure.
SEID Input-integer-default=0. Superelement identification number.
DESITER Input-integer-default=0. Design optimization iteration number.
EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.
Main Index
800 DSAD
Processes tables related to design sensitivity response evaluation
1 Eigenvalue (radian/time).
2 Frequency (cycle/time).
ADJFLG Output-integer-default=0. Adjoint sensitivity method flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
PEXIST Input-logical-default=FALSE. p-element existence flag. Set to TRUE if p-elements
are present.
MBCFLG Input-logical-default=FALSE. Multiple boundary condition in static analysis flag.
Set to TRUE if multiple boundary conditions are specified in static analysis.
RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 For combinations add above values
AUTOADJ Input-character-no default. Adjoint sensitivity automatic selection flag. If set to
'YES', then adjoint sensitivity will be automatically selected if appropiate. Usually
input via user parameter.
FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this
is a fully stressed design cycle.
NR3OFFST Input/output-integer-default=0. Counter for retained type 3 responses. The value is
initialized to 1 and is incremented by the number of records in RESP3R.
TADJCOL Output-integer-default=0. Accumulated column count for adjoint load vector.
SEID Input-integer-default=0. Superelement identification number.
ACTFREQ Input-integer-default=0. Active frequency processing flag.
FREQ1 Output-integer-default=0. Frequency set identification number in the first
frequency subcase.
DLOAD1 Output-integer-default=0. Dynamic load set identification number in the first
frequency subcase.
FREQ345 Input-logical-default=FALSE. Flag indicating presense of FREQ3, FREQ4, and
FREQ5 Bulk Data entries.
DISCYC Input-logical-default=FALSE. Discrete design cycle flag. TRUE if this is a discrete
design cycle.
FRM Input-real-default=0.0 Fractional mass for designed structure.
Main Index
DSAD 801
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
802 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 803
Creates sensitivity of grid responses
ADJGT0 ADJGT computed in a prior call to DSADJ and specified on second pass
through DSADJ.
DRUT0 DRUT computed.
Parameters:
Main Index
804 DSADJ
Creates sensitivity of grid responses
Main Index
DSADX 805
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
806 DSADX
Delete constraints for DRESP2 and DRESP3 that reference DRESP1
Parameters:
NR2OFFST Input/output-integer-no default. Counter for retained type 2 responses. The value is
incremented by the number of records in RSP2XE.
NR3OFFST Input/output-integer-no default. Counter for retained type 3 responses. The value is
incremented by the number of records in RESP3XE.
NCNOFFST Input/output-integer-no default. Counter for retained constraints. The value is
incremented by the number of records in CNTABXE.
PROTYP Input-integer-default=0. Designed property type code.
1 DVPRELi entries exist.
2 DVCRELi entries exist.
4 DVMRELi entries exist.
>0 Sum of above values for combinations.
OBJVAL Output-real-default=0. Objective value.
Main Index
DSAE 807
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:
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.
3. If central difference is requested then DSAE must be executed for the backward tables. For
example in subDMAP PSLGDV, DSAE is used as follows:
Main Index
808 DSAE
Merges tables to evaluate responses for the perturbed configuration
DSAE ESTDVP,ESTDVS,TABEVP,TABEVS,TABDEQ/
ESTDV2F,TABEV2 $
IF ( CDIFX='YES' ) DSAE,
ESTDVPB,ESTDVS,TABEVP,TABEVS,TABDEQ/
ESTDV2B,TABEV2 $
Main Index
DSAF 809
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.
VELEMN Table of element lengths, areas, and volumes for the perturbed configuration.
Main Index
810 DSAF
Generates tables incorporating effect of retained first level responses
ESTDCN Element summary table which incorporates combined constraints and design
variables.
TABECN Table of relationship between internal identification numbers of constraints in
ESTDCN and elements and responses in R1TABR.
ETTDCN Table of design variable and constraint internal identification numbers for the
effects of temperature.
KELMDCN Table of element matrices for stiffness, heat conduction, differential stiffness,
or follower stiffness which incorporates combined constraints and design
variables.
KDICTDCN KELM dictionary table which incorporates combined constraints and design
variables.
PTELMDCN Table of thermal loads in the elemental coordinate system which incorporates
combined constraints and design variables.
VELEMDCN Table of element lengths, areas, and volumes which incorporates combined
constraints and design variables.
GPECTDCN GPECT, which incorporates combined constraints and design variables.
Parameters:
Main Index
DSAH 811
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.
PHG* Family of normal modes eigenvector matrices in the g-set.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
Main Index
812 DSAH
Generates data blocks required for DSAL module
DBUG Buckling eigenvector matrix in the g-set associated with designed (active)
eigenvalues.
DPHG Normal modes eigenvector matrix in the g-set associated with designed (active)
eigenvalues.
CASEDSF Case Control table for all load cases and all design variables for the perturbed
configuration.
LBTAB Table of eigenvalues and generalized masses for retained buckling eigenvalue
responses.
BDIAG Diagonal matrix of buckling divided by buckling generalized differential
stiffness matrix.
LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses.
COGRID Correlation table between idcid/gid component for displacement responses.
COELEM Correlation table between idcid/eid/component for element responses.
DSEDV Partitioning vector for retained divergence responses.
OINTDSF p-element output control table for the perturbed configuration.
PELSDSF p-element set table for the perturbed configuration.
DGEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points for the perturbed configuration.
DGEOM3 Table of Bulk Data entry images related to static loads for the perturbed
configuration.
DNDVPT Partitioning vector to obtain the sensitivities of natural frequencies for normal
modes analysis from that of the union set.
MXDFDN Matrix of derivatives of forcing frequencies with respect to natural frequencies.
MXOMEG Matrix (diagonal) of active forcing frequencies in radians.
Main Index
DSAH 813
Generates data blocks required for DSAL module
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:
DMRESD Input-integer-default=0. Design model flag. If set to -1, then the design model is
limited to the residual structure.
NDVTOT Input-integer-default=0. Number of unique referenced design variables.
ADJFLG Output-integer-default=-1. Adjoint sensitivity method flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
SEID Input-integer-default=0. Superelement identification number.
Main Index
814 DSAH
Generates data blocks required for DSAL module
Main Index
DSAJ 815
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 $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EQEXIN Equivalence table between external and internal grid/scalar identification
numbers.
BGPDT Basic grid point definition table.
CSTM Table of coordinate system transformation matrices.
SIL Scalar index list.
BASVEC0 Auxiliary displacement matrix. Optional user input.
CASECC Table of Case Control command images.
GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom
membership and rigid element connectivity.
DESVEC Basis vector matrix which consists of basis vectors generated from DVGRID
Bulk Data entries and from columns of BASVEC0 matrix. Its components are
defined in the basic coordinate system.
DVIDS List of shape variable identification numbers to be used for the boundary
DVGRID option.
CASEP Case Control table with number of basis vectors in the DESVEC as the number
of Case Control records.
DESVECP Basis vector matrix which consists of basis vectors generated from DVGRID
bulk data entries and from columns of basvec matrix its components are
expressed in the global coordinate system.
Main Index
816 DSAJ
Generates g-set size reduced basis vectors for each design variable
Parameter:
Main Index
DSAL 817
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, OARPWRDS, OAIGDSN, OUGEXAC, OVGEXAC,
OAPEXAC, R1RATIOR/
DSCM/
NDVTOT/DELTAB/EIGNFREQ/ADJFLG/SEID/
S,N,ADELRS/S,N,ADELRF/ESLOPTX/DESCYCLE/DMRESD $
DRSTBL Table containing the number of retained responses for each subcase for each of
the response types.
DELWS Matrix of delta weight for all design variables.
DELVS Matrix of delta volume for all design variables.
DELB1 Matrix of delta buckling load factor for all design variables.
DELF1 Matrix of delta eigenvalue for all design variables.
COGRID Correlation table between idcid/gid component for displacement responses.
COELEM Correlation table between idcid/eid/component for element responses.
OUGDSN Table of displacements in SORT1 format for design responses for the perturbed
configuration.
OESDSN Table of element stresses in SORT1 format for the perturbed configuration.
OSTRDSN Table of element strains in SORT1 format for the perturbed configuration.
OEFDSN Table of element forces, excluding non-composite elements, in SORT1 format
for the perturbed configuration.
OEFITDSN Table of composite element failure indices for the perturbed configuration.
OESCDSN Table of composite element stresses in SORT1 format for the perturbed
configuration.
Main Index
818 DSAL
Generates design sensitivity coefficient matrix
OSTRCDSN Table of composite element strains in SORT1 format for the perturbed
configuration.
OQGDSN Table of single forces-of-constraint in SORT1 format for design responses for
the perturbed configuration.
ONRGYDSN Table of element strain energies and energy densities in SORT1 format for
design responses for the perturbed configuration.
OGPFDSN Table of grid point forces for the perturbed configuration.
OELOPDSN Table of element forces on adjacent elements.
R1VALR Matrix of retained type one responses.
TABDEQ Table of unique design variable identification numbers.
OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list.
DSDIV Matrix of delta divergence speed for all design variables.
DELX Matrix of delta trim variable responses for all design variables.
DELS Matrix of delta stability derivative responses for all design variables.
DELFL Matrix of delta flutter responses for all design variables.
DELCE Matrix of delta complex eigenvalue for all design variables.
DELGS Matrix of delta generalized stiffnesses for all design variables.
DELGM Matrix of delta generalized masses for all design variables.
FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step.
DELBSH Matrix of finite difference shape step sizes.
DRDUTB Table of adjoint load attributes.
ADELUS Matrix of adjoint sensitivities for static analysis.
ADELUF matrix of adjoint sensitivities for frequency response.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes.
DRMSVL Table of the RMS response values with respect to the design variables.
MODRPR Table indicating the number of retained responses per response type per mode.
OUGDSNM Table of eigenvectors for design responses for the perturbed configuration.
OESDSNM Table of element stresses from normal modes analysis for the perturbed
configuration.
OSTRDSNM Table of element strains from normal modes analysis for the perturbed
configuration.
OEFDSNM Table of element forces from normal modes analysis for the perturbed
configuration.
Main Index
DSAL 819
Generates design sensitivity coefficient matrix
ONRGDSNM Table of element strain energies from normal modes analysis for the perturbed
configuration.
ESRTDS Stress ratio for composites for perturbed configuration (statics only).
FRMDS Sensitivity matrix for fractional mass configuration (statics only).
OES1ABDS Table of screened element stresses for arbitrary beam cross sections for the
perturbed configuration.
OARPWRDS Acoustic Power to interior or near field.
OAIGDSN Acoustic Intensity to wetted structural grid.
OUGEXAC Exterior Acoustic pressure/intensity of AFPM.
OVGEXAC Exterior Acoustic velocity of AFPM.
OAPEXAC Exterior Acoustic Power of AFPM.
R1RATIOR Ratio on responses used in ESL.
Parameters:
Main Index
820 DSAL
Generates design sensitivity coefficient matrix
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 821
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 $
DTOS4 Table relating design variable to grid perturbation. Same as DTOS4K except
that the last three words in each entry contains the product of those in DTOS4K
and the shape step size.
DGTAB Table relating DTOS4 records and designed grid data. Correlation table of
internal grid sequence for the baseline and perturbed configuration.
BGPDVP Basic grid point definition table for the forward (or central) perturbed
configuration.
BGPDVB Basic grid point definition table for the backward perturbed configuration.
Parameters:
Main Index
822 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 823
Computes an inertial or pseudo-load matrix
Computes an inertial or pseudo-load matrix according to the following summation for frequency
response and normal modes:
2
w j * MU x + iw j * BU x + (4-19)
where:
w j = freq j * 2pi
or for complex eigenvalues:
2
p j * MU x + p j * BU x + K (4-20)
where:
r i
p j = w j + iw j
Format:
DSAP MUX,BUX,KUX,OL,DSPT1/
PX/
APP $
Main Index
824 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 825
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
826 DSAR
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
DSAR 827
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
828 DSARLP
Calculates pseudo-displacements for calculating sensitivities of stability derivatives
Calculates the pseudo-displacements used in calculating the sensitivities of stability derivatives and
determines the parameters required for all of the static aeroelastic sensitivity analyses.
Format:
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
DSARLP 829
Calculates pseudo-displacements for calculating sensitivities of stability derivatives
Parameters:
STFLG Output-integer-no default. Flag to indicate whether the current subcase has
active static response (DISP, STRAIN,STRESS, FORCE, CSTRAIN,
CSTRESS, or CFORCE on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
TFLG Output-integer-no default. Flag to indicate whether the current subcase has
active trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
SDFLG Output-integer-no default. Flag to indicate whether the current subcase has
active stability derivative response (STABDER on the DRESP1 Bulk Data
entry). 0 indicates no response, 1 indicates an active response.
NSKIP Input/output-integer-no default. Trim subcase counter.
LPFLG Input/output-integer-default=0. Flag to indicate whether there is another Case
Control record to process. Set to -1 for the last subcase and Mach number.
MACH Output-real-no default. Mach number.
Q Output-real-no default. Dynamic pressure.
AEQRATIO Output-real-no default. Aeroelastic feedback dynamic pressure ratio.
Remark:
DSARLP performs a function for static aeroelastic sensitivity analysis that is similar to the AELOOP
module for static aeroelastic analysis.
Main Index
830 DSARME
Computes RMS values
Computes the RMS values for random response analysis in design sensitivity.
Format:
DSARME UPDST,RMSTAB,CFSAB/
RMSVAL $
Parameters:
None.
Remarks:
None.
Main Index
DSARSN 831
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.
Parameters:
TFLG Input-integer-no default. Flag to indicate whether the current subcase has active
trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.
Main Index
832 DSARSN
Calculates delta response values for trim variables and stability derivatives
SDFLG Input-integer-no default. Flag to indicate whether the current subcase has active
stability derivative response (STABDER on the DRESP1 Bulk Data entry). 0
indicates no response, 1 indicates an active response.
Q Input-real-no default. Dynamic pressure.
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
DSAW 833
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
834 DSDVRG
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
DSFLTE 835
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
836 DSFLTE
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
DSFLTF 837
Calculates sensitivity of active flutter responses
Format:
DSFLTF VTQU,CDELK,CDELB,CDELM/DELFL/FCSENS $
Parameters:
Main Index
838 DSGRDM
Produces grid list of design model
Preprocesses the design entries in EDOM to produce a list of grids associated with the designed elements
and design responses.
Format:
DSGRDM EDOM,EPT,GEOM2,MPT,GEOM1/
DSGRID/
S,N,AUTOSE/S,N,NUMDIV/S,N,DRATIO $
EDOM Table of Bulk Data entries related to design sensitivity and optimization.
EPT Table of Bulk Data entry images related to element properties.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points
MPT Table of Bulk Data entry images related to material properties.
GEOM1 Table of Bulk Data entry images related to geometry.
DSGRID Table of identification numbers for those grid points in the design model
automatic superelement optimization feature.
Parameters:
Main Index
DSMA 839
Generates combined design sensitivity/constraint matrix
Generates the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity
Analysis only.
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
840 DSMA
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
DSPRM 841
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
842 DSPRM
Sets design sensitivity parameters
CSTRN Output-integer-default=0. Composite lamina strain constraint flag. Set to >0 if any
constraint.
DOFREQ Output-integer-default=0. Frequency response retained response flag. Set to >0 if
any retained response.
DOCEIG Output-integer-default=0. Complex eigenvalue response retained response flag. Set
to >0 if any retained response.
DOMTRAN Output-integer-default=0. Transient response retained response flag. Set to >0 if
any retained response.
DODIVG Output-integer-default=0. Divergence analysis retained response flag. Set to >0 if
any retained response.
DOSAERO Output-integer-default=0. Aerostatic trim or stability derivative retained response
flag. Set to >0 if any retained response.
DOFLUT Output-integer-default=0. Flutter analysis retained response flag. Set to >0 if any
retained response.
DOANALY Output-integer-default=0. Any analysis retained response flag. Set to >0 if any
retained response.
DOSASTAT Output-integer-default=0. Statics or aerostatic retained response flag. Set to >0 if
any retained response.
ADJFLG Input-integer-default=0. Adjoint sensitivity flag.
0 No adjoint sensitivity.
1 Adjoint sensitivity for static analysis.
2 Adjoint sensitivity for frequency response analysis.
DOFSPCF Output-integer-default=0. Frequency response retained SPCforce response flag.
Set to >0 if any retained response.
DOTSPCF Output-integer-default=0. Transient response retained SPCforce response flag. Set
to >0 if any retained response.
DOWGHT Output-integer-default=0. Weight retained response flag. Set to >0 if any retained
response.
DOESE Output-integer-default=0. Static analysis retained element strain energy response
flag. Set to >0 if any retained response.
Main Index
DSPRM 843
Sets design sensitivity parameters
DOSSPCF Output-integer-default=0. Static analysis retained SPCforce response flag. Set to >0
if any retained response.
DORMS Output-integer-default=0. RMS response retained response flag. Set to >0 if any
retained response.
DOEIGV Output-integer-default=0. Set to >0 if any eigenvector constraints.
DOGPF Output-integer-default=0. Set to >0 if any grid point force responses.
DOELOP Output-integer-default=0. Set to >0 if any element oriented force responses.
DOSTCOMP Output-integer-default=0. Static compliance flag. Set to >0 if any static
compliance.
DOFRMASS Output-integer-default=0. Fractional mass flag. Set to >0 if any fractional mass.
DOCSTRAT Output-integer-default=0. Composite stress ratio flag. Set to >0 if any composite
stress ratio.
Remark:
RSP1CT may be specified as input to DSPRM.
Main Index
844 DSTA
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
DSTA 845
Creates tables for Old Design Sensitivity Analysis 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:
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
846 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 847
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 $
XDICTDS Perturbed element matrix dictionary table. If CDIF='YES' then this is the
forward or backward perturbed element matrix dictionary.
XELMDS Table of perturbed element matrices. If CDIF='YES' then this is the forward or
backward perturbed element matrices.
BGPDT Basic grid point definition table.
SIL Scalar index list.
CSTM Table of coordinate system transformation matrices.
XDICT Baseline element matrix dictionary table.
XELM Baseline element matrices.
UGX Displacement matrix in g-set. For transient response analysis, UGX could also
represent velocity or acceleration.
AGX Gravity/thermal load matrix due to volumetric changes for the central, forward,
or backward perturbed configuration.
VG Left-handed displacement matrix in g-set. Divergence and flutter analysis only.
LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses.
DSPT1 Design sensitivity processing table.
VGDM Partitioning vector for sparse design model with ones where design response is
required if SPDM=-1. Also, UGX and ADJG must partitioned the ones of this
vector.
XDICTB Backward perturbed element matrix dictionary if CDIF=’YES’.
XELMB Backward perturbed if CDIF=’YES’.
Main Index
848 DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis
Parameters:
Main Index
DSVG1 849
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
850 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 851
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis
Parameters:
Remark:
Main Index
852 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 853
Generates pseudo-load matrix for equilibrium changes in thermal load
Parameters:
Remark:
CSTM and BGPDT may be purged.
Main Index
854 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 855
Generates a perturbed multipoint constraint transformation matrix
Generates a perturbed multipoint constraint transformation matrix for rigid element shape sensitivity
analysis.
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
856 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 857
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:
Main Index
858 DSVGP5
Performs multiplication of two matrices
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 859
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:
PARMi Output-logical-default = FALSE. If the i-th output data block is generated then
PARMi=TRUE.
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
860 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 861
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
862 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 863
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
864 DVIEWP
Generates view-element and view-grid information for processing p-elements
Generates the view-element and view-grid information for processing p-elements in design sensitivity
analysis.
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 865
Generates view-element and view-grid information for processing p-elements
Main Index
866 DYNCXPNT
Adds acoustic infinite extra points to the DYNAMIC table
Automatically generates the extra points for acoustic infinite elements and adds them 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 867
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
868 EFFMASS
Computes modal effective mass
Parameters:
Remarks:
None.
Main Index
ELFDR 869
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 $
OELOF1 Table of element oriented forces connected to common grid points in SORT1
format.
OELOP1 Table of element-oriented forces oriented along adjacent element edge
directions and summations of these components on equivalent edges in
SORT1 format.
Parameters:
Main Index
870 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 871
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
872 ELTPRT
Prints element summary information
• Identify each element type and the range of element identification numbers for the element type,
e.g.,
THERE ARE 10 ROD ELEMENTS. FIRST ID = 34 LAST ID = 470
Examples:
1. Duplicate element identification numbers are not allowed in the superelement solution sequences.
The following will cause the run to terminate if duplicate identification numbers exist (options 1
and 2).
ELTPRT ECT,,,,//1/S,N,ERROR $
IF (ERROR <0) EXIT $
If no duplicate identification numbers exist, the run will proceed in a normal manner.
2. Print the connection information for each grid point (option 3).
ELTPRT ,,GPECT,BGPDT,,,/ $
3. Print the measure of all elements (option 4).
ELTPRT ,,,BGPDT,,EST,CSTM/ $
Main Index
EMA 873
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:
Main Index
874 EMA
Assembles global g-set size matrix from elemental matrices
Method:
4
The structural damping matrix K gg is assembled from elements with structural damping. Structural
damping is specified in the GE field of the MATi entry.
NE
4
K gg = GEe Ke (4-21)
e=1
where:
NE = number of elements.
Remark:
EMA is used to generate stiffness (KGG), mass (MGG), damping (BGG), and structural damping
(K4GG) matrices.
Main Index
EMAKFR 875
Generates stiffness for follower forces
Generates the stiffness for follower forces due to rotational velocity and/or accelerations.
Format:
EMAKFR BGPDT,CSTM,SLT,MGG,CSTM0,SCSTM/
KRFGG/
LOADID/LOADIDP/SEID/LOADFACR/SYS66 $
Output:
Parameters:
LOADID Input-integer-no default. Load set identification number for the current
subcase.
LOADIDP Input-integer-default=0. Load set identification number for the previous
subcase.
SEID Input-integer-default=0. Superelement identification number.
LOADFACR Input-real-default=1.0. Load factor in nonlinear static analysis. (Same as
LOADFAC except real).
SYS66 Input-integer-default=255. System cell 66 override for matrix multiply.
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
876 EMG
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
EMG 877
Computes elemental matrices
Parameters:
Main Index
878 EMG
Computes elemental matrices
Main Index
EMG 879
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.
Main Index
880 EMG
Computes elemental matrices
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
EQUIVX 881
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
882 EQUIVX
Data block name equivalence
4. If DBS is also declared on the FILE DBS=APPEND statement then User Warning Message 81
will be issued. If the EQUIVX.../DBS statement is executed only once and is not re-executed in
the DMAP loop, then the message may be safely ignored. However, if the EQUIVX statement is
potentially re-executed then it should be replaced with the DELETE and COPY module.
For example,
FILE ESTNCH=APPEND $
EQUIVX ESTNL/ESTNCH/-1 $
should be replaced with:
FILE ESTNCH=APPEND $
DELETE /ESTNCH,,,, $
COPY ESTNL/ESTNCH $
Examples:
Data blocks A and B reside on the same DBset.
EQUIVX A/B/ALWAYS $
A and B are equivalenced.
EQUIVX A/B/NEVER $
The equivalence is broken, and B is deleted.
Main Index
ESTINDX 883
Creates an index, keyed by element identification number
Creates an index, keyed by element identification number, for the EST table.
Format:
ESTINDX /EST $
Parameters:
None.
Remark:
EST must be declared as an append file on the FILE statement.
Main Index
884 EXPORTLD
Creates an index, keyed by element identification number
Format:
EXPORTLD CASECC,PG,BGPDT/PG*,BGPDT*/NSKIP $
Parameters:
Remarks:
None.
Main Index
FA1 885
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
886 FA1
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
FA2 887
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
888 FA2
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
FBODYLD 889
Collects aeroelastic flutter data
FBODYLD 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
890 FBS
Matrix forward/backward substitution
Format:
FBS LD,U,B/X/KSYM/SIGN/FBTYP/FBREST/UNUSED/UNCOUP $
Parameters:
Main Index
FBS 891
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.
6. The equation for forward-only solution is L X = B , and for backward-only the solution
is L T X = B . Both are right-hand solutions.
7. Left-hand solutions (KSYM = 2) are available for factors of symmetric or unsymmetric matrices.
Also, the NASTRAN keyword FBSLEFT=n or SYSTEM(72)=n in the FMS section, or
PUTSYS(n,72) in the DMAP sequence, specifies the transpose flag on B :
If n=0 then FBS solves L U = B T .
If n=1 then FBS solves X T L U = B .
8. Parallel processing in this module (Method 1A only) is selected with the NASTRAN statement
keyword PARALLEL (or SYSTEM (107)). To force parallel processing, also specify NASTRAN
FBSOPT = -2, SPARSE = 0.
9. For the sparse method the B matrix must be in machine precision. See Remarks under the
DECOMP, 723 module description.
Main Index
892 FBS
Matrix forward/backward substitution
10. See the MSC.Nastran Numerical Methods User’s Guide for further details on the FBS module and
related topics.
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// $
5. Given that M and K are symmetric and M is also positive definite, find
T –1 T
LD K LD
where
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 893
Data block declaration
Format:
FILE DB1=[SAVE,APPEND,OVRWRT]/DB2=[SAVE,APPEND,
OVRWRT]/... $
Data Blocks:
Parameters:
SAVE Indicates data block is to be saved for possible looping in DMAP program.
APPEND Same as SAVE and also allows a module to append other data blocks to DBi
on successive passes through a DMAP loop.
OVRWRT Allows a data block to be overwritten.
Remarks:
1. FILE is a nonexecutable DMAP instruction that is used only by the DMAP compiler for
information purposes. It may appear anywhere in subDMAP. It is also a local declaration; i.e., it
must be declared in all subDMAPs where the SAVE, APPEND, or OVRWRT is needed.
2. A data block name may appear only once in all FILE statements within a subDMAP; otherwise,
the first appearance will determine all special characteristics applied to the data block.
3. The APPEND keyword should only be applied to local scratch data blocks. In other words, the
data block should not be referenced on a TYPE DB statement. It is also recommended that the
APPEND keyword not be applied to data blocks that appear as output on the EQUIVX module.
See the EQUIVX, 881 module description for further details.
Example:
1. Data block C is created only in the first pass through the loop and must be "saved" for subsequent
passes:
FILE C=SAVE $
TYPE PARM,,CS,N,R=(1.,0.) $
TYPE PARM,,I,N,COUNT=1 $
.
.
.
DO WHILE ( COUNT<=3 ) $
Main Index
894 FILE
Data block declaration
2. For an example of the APPEND keyword see the APPEND, 622 module description.
Main Index
FORTIO 895
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.
2. Errors encountered in FORTIO will not terminate the MSC Nastran execution. But IOSTAT will
return a nonzero value in the event of error(s) that terminate the request.
Main Index
896 FORTIO
Opens or closes a FORTRAN file
Example:
Close FORTRAN unit 24:
FORTIO //'CLOSE'/24/2/S,N,IOSTAT $
Main Index
FRLG 897
Generates frequency-dependent loads or time-dependent loads
Generates frequency-dependent loads or time-dependent loads via Fourier transform for frequency
response analysis.
Format:
FRLG CASECC,USETD,DLT,FRL,GMD,GOD,DIT,PHDH,APPLOD,
ENFLODK,ENFLODB,ENFLODM,ENFMOTN,ROTRT,
UNBVEC,EQDYN,FRFXITPP,FRFLABEL,FACLV*,PACLV*/
PPF,PSF,PDF,FOL,PHF,YPF/SOLTYP/S,N,FOURIER/
S,N,APP $
Main Index
898 FRLG
Generates frequency-dependent loads or time-dependent loads
FRFLABEL Table containing LABEL information from FRFXIT Bulk Data entries.
FACLV Family of frequency list vector by ACLOAD statement.
PACLV Family of acoustic pressure load matrix by ACLOAD statement.
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 899
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
900 FRLGEN
Creates frequency response list from the FREQi Bulk Data entries
Parameters:
Remarks:
LAMAF may be purged.
Main Index
FRQDRV 901
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
902 FRRD1
Solves for the steady-state frequency response displacement solution
Solves for the steady-state, modal or direct, frequency response, displacement solution using iterative or
direct methods.
Format:
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 903
Solves for the steady-state frequency response displacement solution
Parameters:
Method:
The solution for the response is performed in FRRD1 or FRRD2 (Frequency Response Solution). In the
case of a direct formulation the following equation is solved.
Main Index
904 FRRD1
Solves for the steady-state frequency response displacement solution
– 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 905
Solves for the steady-state frequency response displacement solution
Solves for the steady-state, modal or direct, frequency response, displacement solution using iterative or
direct methods.
Format:
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
906 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 907
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
908 GENTRAN
Generates a transformation matrix
Generates a transformation matrix that will convert the upstream boundary coordinate system to the
downstream coordinate system.
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 ) $
Main Index
GENTRAN 909
Generates a transformation matrix
Main Index
910 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 911
Create list of Mach numbers on reduced frequency pairs
Format:
GETMKL EDT/MKLIST/S,N,NMK $
Parameters:
Main Index
912 GI
Generates aerodynamic spline transformation matrix
Format:
SPLINE
GI AERO, ,BGPDT,AEBGPDT,AEUSET,AECOMP,CSTM
A, 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.
Main Index
GI 913
Generates aerodynamic spline transformation matrix
Example:
Excerpt from subDMAP AERO0:
Main Index
914 GIC2C
Forms splice matrix for element centroids
Forms a spline matrix that maps displacements measured at centroidal elemental grids of aero meshes to
the corner point (mesh connectivity) grids. This displacement map will allow visualization of
connectivity grid motion for "element centroid" based aero meshes (like DLM and ZAERO).
Format:
GIC2D AEBOX,AEGRID,AEBGPDT*,CSTM/GDKSKS $
Parameters:
None.
Main Index
GKAM 915
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
916 GKAM
Assembles modal mass, damping and stiffness matrices
Parameters:
NOUE Input-integer-no default. The number of EXTRA points. Set to -1 if there are
no extra points.
LMODES Input-integer-no default. The number of lowest modes to use in modal
transformation. All outputs will have LMODES number of columns.
LFREQ Input-real-no default. Lower frequency limit of modes to use in modal
transformation.
HFREQ Input-real-no default. Upper frequency limit of modes to use in modal
transformation.
UNUSED5 Input-integer-no default. Unused.
UNUSED6 Input-integer-no default. Unused.
UNUSED7 Input-integer-no default. Unused.
NONCUP Output-integer-no default. If K2DD, B2DD, and M2DD are purged. then the
model is considered uncoupled and NONCUP is set to -1.
FMODE Output-integer-default=1. The lowest mode number resulting from
LMODES or LFREQ and HFREQ.
KDAMP Input-integer-default=1. Viscous modal to structural damping flag. If set to -
1, then viscous modal damping (SDAMPING Case Control command) will
be included in the stiffness matrix as structural damping.
FLUID Input-logical-default=FALSE. Fluid damping processing flag. If TRUE, then
the modal damping set identification number is obtained from the
SDAMPING(FLUID) Case Control command.
Main Index
GKAM 917
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 (4-24)
T
M hh = m + dh M dd
2
dh (4-25)
and
T
B hh = b + dh B dd
2
dh (4-26)
m i = modal mass
b i = 2f i g f i m i
k i = 4 2 f i2 m i
m i = modal mass
bi = 0
k i = 1 + ig f i 4 2 f i2 m i
Values of g fi 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.
Main Index
918 GKAM
Assembles modal mass, damping and stiffness matrices
5. LAMA may be purged as long as both MI and LAMMAT exist. Using MI and LAMMAT is
preferable to LAMA because the the values in MI and LAMMAT are in machine precision.
6. No output matrix can be purged.
7. HFREQ and LFREQ are ignored if LMODES>0.
8. See Section 9.4.10 of the MSC Nastran Reference Manual for further details.
9. If modes are not selected with HFREQ, LFREQ and LMODES parameters or the MODESELECT
command and NOUE < 0, then PHDH will be purged and a subsequent EQUIVX from PHA to
PHDH must be executed.
Main Index
GNFM 919
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
920 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 921
Modifies tables to include p-element information
Modifies geometry, connectivity, loads, and constraints tables to include p-element information and also
create edge, face, and body tables.
Format:
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 $
GEOM1M Table of Bulk Data entry images related to geometry and updated for the
current p-level.
GEOM2M Table of Bulk Data entry images related to element connectivity and scalar
points and updated for the current p-level.
Main Index
922 GP0
Modifies tables to include p-element information
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
GP1 923
Performs basic geometry processing
Format:
GP1 GEOM1,GEOM2,GEOM3,GDNTAB,MEDGE,SGPDT,DYNAMIC,CASECC/
GPL,EQEXIN,GPDT,CSTM,BGPDT,SIL,VGF,GEOM3B,DYNAMICB,
VGEXF/S,N,LUSET/S,N,NOCSTM/S,N,NOPOINTS/
UNIT/UPERM/UPRMT/NUFLAG/SEID $
Main Index
924 GP1
Performs basic geometry processing
DYNAMICB Table of Bulk Data entry images related to dynamics without DAREA entry
images.
VGEXF Exterior acoustic partitioning vector with ones at the rows corresponding to
exterior acoustic degrees-of-freedom.
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
GP2 925
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:
Remarks:
1. EQEXIN and ECT may not be purged.
Main Index
926 GP2
Processes element connectivity
Main Index
GP3 927
Processes static and thermal loads
Format:
GP3 GEOM3,BGPDT,GEOM2,EDT,UGH,ESTH,BGPDTH,
CASEHEAT,MPT,PG*/
SLT,ETT/
S,N,NOLOAD/S,N,NOGRAV/S,N,NOTEMP $
GEOM3 Table of Bulk Data entry images related to static and thermal loads.
BGPDT Basic grid point definition table.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
UGH Temperature matrix in g-set from a heat transfer analysis.
ESTH Element summary table from a heat transfer analysis.
BGPDTH Basic grid point definition table from a heat transfer analysis.
CASEHEAT Case Control table from a heat transfer analysis.
MPT Table of Bulk Data entry images related to material properties.
PG* Family of external load matrices qualified by LOADID or FBLID
Main Index
928 GP3
Processes static and thermal loads
Parameters:
Remarks:
1. BGPDT may not be purged.
2. SLT may be purged if there are no static loads.
3. ETT may be purged if there are no thermal loads
4. If UGH is present in structural analysis run, then GP3 will create a new temperature set based on
UGH with set identification numbers obtained from TSTRUC command in CASEHEAT.
BGPDTH is used to correlate UGH to grid points. For h-elements ESTH is not required. For p-
elements ESTH is appended to element ETT record for interpolation purposes in element decks.
Here are the DBVIEW statements that are used to define these inputs in SOLs 101-200:
Main Index
GP4 929
Generates the degree-of-freedom set table
Generates the degree-of-freedom set table, based on single point constraints, multipoint constraints, rigid
elements, and set membership assignment Bulk Data entries (e.g., ASET). Also generate the enforced
displacement matrix and multipoint constraint equation matrix.
Format:
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
930 GP4
Generates the degree-of-freedom set table
Main Index
GP4 931
Generates the degree-of-freedom set table
Parameters:
Main Index
932 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 933
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
934 GP5
Creates table of static loads for panels in coupled fluid/structure analysis
Parameters:
Main Index
GPFDR 935
Computes grid point forces and element strain energy
Format:
PG QG
GPFDR CASECC,UG,KELM,KDICT,ECT,EQEXIN,GPECT, --------------- , ---------------- ,
UADJ AGG2
LAMA
FOL
BGPDT, ,CSTM,VELEM,PTELEM,QMG,NFDICT,FENL,
TOL
OLF
MELM,MDICT,BELM,BDICT,GEI,MATPOOL,F2J,VG,AG,EDT/
OELQS1,OELQW1,OELQM1,OELQD1,OPACC1/
APP/TINY/XFLAG/CYCLIC/WTMASS/NDVTOT/DMIGFN/G/GFL $
Main Index
936 GPFDR
Computes grid point forces and element strain energy
Main Index
GPFDR 937
Computes grid point forces and element strain energy
Parameters:
Main Index
938 GPFDR
Computes grid point forces and element strain energy
Remarks:
1. GPFDR creates the grid point force balance table for a user-selected set of points. This table lists
the forces acting at each selected point due to element constraints, single-point constraints, and
applied loads. Also listed is the sum total of these forces which represents the balance in an
opposite direction due to multipoint constraints, general elements, round-off errors, and other
nonlisted sources. Subtotals for element sets and element types are also provided.
2. GPFDR creates the element strain energy table for a user-selected set of elements. These selected
elements are listed by type with their strain energy, percent of total strain energy with respect to
all elements and strain energy density. The strain energy is computed by one of the following
equations:
If XFLAG=0 (default):
1 T
W e = --- F e u e (4-27)
2
If XFLAG=1:
1 1 T i
W e = --- u e K e u e (4-28)
2
1
where u e is the displacement for the first subcase or mode and
i
where u e 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 939
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
940 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 941
Performs auto-SPC operation
BD3X3 3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel
domain decomposition.
RMG1 Updated RMG matrix when MPC option is selected on the AUTOSPC Case
Control command.
GPSPRT Table of grid point singularity created on the first call to GPSP when the MPC
option is selected on the AUTOSPC Case Control command and
DONSET=0.
Main Index
942 GPSP
Performs auto-SPC operation
Parameters:
Main Index
GPSP 943
Performs auto-SPC operation
Remarks:
1. YS0 and YS may be purged.
2. For the most reliable identification and constraint of singularities on independent degrees-of-
freedom connected multipoint constraints or rigid elements then GPSP should be executed after
MCE1 and MCE2. Then KNN and KMM should be specified for the first two inputs and 'KMM'
should be specified for MPCMETH. For example, from subDMAP SEKR0:
UPARTN USET0,KGG/KMM,,,/'G'/'M'/'N' $
MCE2 USET0,GM,KGG,,,/KNN,,, $
GPSP KNN,KMM,...
...S,N,NGERR/'KMM' $
If KMM is purged then some singular rotational independent degrees-of-freedom may not be
identified unless all rotations at a given point are independent.
3. If GPSP is executed before MCE1 and MCE2 then KGG and RMG should be specified. Also, the
default for MPCMETH should be used.
GPSP KGG,RMG,...
If RMG is purged then singular independent degrees-of-freedom connected to multipoint
constraints or rigid elements will not be identified or constrained.
4. ACON should be set to -1 if processing a superelement.
Main Index
944 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 945
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
946 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 947
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
948 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:
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
Main Index
GPWG 949
Computes center of mass of structure relative to a given point
using a rigid body transformation calculation. The transformation is defined by the global coordinate
displacements resulting from unit translations and rotations of the whole body about a reference point.
Because of the scalar mass effects, the total mass may have directional properties, and the center of
gravity may not be a unique location. This effect is shown in the output by giving each of the the three
masses its own direction and center of gravity. The inertia terms are calculated by using the directional
mass effects. The axes about which the inertial terms are calculated may not intersect. However, these
axes are those which provide uncoupled rotation and translation effects. This is the significance of the
term "center of gravity." If the structural model has been constructed using only real masses. the three
masses printed out will be equal, the center of gravity will be unique, and the axes of the inertia terms
will intersect at the center of gravity.
The actual computation proceeds in four parts:
T
1. Computation of the D 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
u·· g = D u·· o (reference point) (4-29)
Method of Generation
Each grid point is considered in order. If it is a scalar point, zero is stored in each of the six
columns of D . If it is a grid point,
r1
ri = Ri – Ro = r2 (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
0 r3 –r2
Tr = –r3 0 r1 (4-31)
r2 –r1 0
is formed. GPWG calculates the 3x3 transformation matrix T i from the global coordinates to
basic coordinates for the grid point. The matrix
Main Index
950 GPWG
Computes center of mass of structure relative to a given point
T T
Ti Ti Tr
d = (4-32)
T
0 Ti
T T
is computed. The rows of d form the columns of D . The matrix D is generated a column
at a time and packed out onto a scratch file.
T
2. If all points were scalar point, GPWG returns; otherwise, form D from D .
3. M o is computed
T
M 0 = D M gg D (4-33)
t tr
Mo M M (4-34)
rt r
M M
The matrix is symmetric, where the superscripts t and r refer to translation and rotation,
respectively.
A check is made for inconsistent scalar masses. Let
t 2
= M ij (4-35)
and
t 2
= M ij i j (4-36)
T T t
M = S M S (4-38)
tr T tr
M = S M S (4-39)
r T r
M = S M S (4-40)
Main Index
GPWG 951
Computes center of mass of structure relative to a given point
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 (4-41)
t
M y = M 22 (4-42)
t
M z = M 33 (4-43)
S S r
I 12 = I 21 = – M 12 – M z X z Y z (4-48)
S S r
I 13 = I 31 = – M 13 – M y X y Z y (4-49)
S r 2 2
I 22 = M 22 – M z X y – M x Z x (4-50)
S r 2 2
I 22 = M 22 – M z X z – M x Z x (4-51)
S S r
I 32 = I 23 = – M 23 – M x Y x Z x (4-52)
S r 2 2
I 33 = M 33 – M x Y x – M y X y (4-53)
Main Index
952 GPWG
Computes center of mass of structure relative to a given point
For principal inertias, eigenvalues and eigenvectors are found such that
P
I 11 0 0
= Q I˜ Q
P T
0 I 22 0 (4-54)
P
0 0 I 33
where I˜ is the same as I with sizes of the off-diagonal terms reversed. Q contains the
P
normalized eigenvectors (with the directions of the principal inertias), and the I ii are the
eigenvalues. The matrices S and Q are actually coordinate rotation matrices and show the
directions of the principal masses and inertias.
Remarks:
1. BGPDT and OGPWG cannot be purged. If MGG is purged or null, GPWG will return. CSTM
must be present if coordinate systems are used to define the location of one or more grid points.
MEDGE must be present if p-elements are present.
2. GPWG is identical to Option 7 in the VECPLOT module.
3. GPWG calculates the masses, centers of gravity, and inertias of the general mathematical model
of the structure. The data are extracted from the [Mgg] matrix by using a rigid body
transformation calculation. The transformation is defined by the global coordinate displacements
resulting from unit translations and rotations of the whole body about a reference point.
4. Because of the scalar mass effects, the total mass may have directional properties, and the center
of gravity may not be a unique location. This effect is shown in the output by giving for each of
the three masses, its own direction and center of gravity. The inertia terms are calculated by using
the directional mass effects.
The axes about which the inertia terms are calculated may not intersect. However, these axes are
those which provide uncoupled rotation and translation effects. This is the significance of the term
"center of gravity". If the structural model has been constructed using only real masses, the three
masses printed out will be equal, the center of gravity will be unique, and the axes of the inertia
terms will intersect at the center of gravity.
Main Index
GUST 953
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 $
PHF1 Frequency response load matrix in the h-set (modal) combined with gust
loads.
WJ Gust matrix.
Main Index
954 GUST
Computes loads for aerodynamic analysis
Parameters:
NOGUST Output-integer-no default. Gust load flag. Set to -1 if no gust loads exist;
otherwise set to 1.
BOV Input-real-default=0.0. Conversion from frequency to reduced frequency.
MACH Input-real-default=0.0. Mach number.
Q Input-real-default=0.0. Dynamic pressure.
Remarks:
1. If DIT is purged, GUST will return (setting NOGUST = - 1).
2. CSTMA may be purged.
3. Often the shape (time dependence) of the gust is unknown, except for certain statistical
information, e.g., power spectral density and RMS value. In these cases the GUST module must
create frequency-dependent loads. Sometimes the gust shape is specified as a function of time,
which will be analyzed by Fourier transform techniques. Then the frequency dependent loads are
calculated by Fourier transform.
The value of the load is calculated from the downwash distribution. The calculation involves the
aerodynamic formulation. For all methods (except strip theory) the downwash is a part of the
aerodynamic theory used in the AMG-AMP modules. The downwash is associated with the j-set,
which corresponds to the Ajj matrix. The loads are computed from the downwash using
aerodynamic matrices.
The downwash to be provided comes from a simple model of the atmosphere. The velocity is
vertical (in the z-direction of the aerodynamic coordinate system), and appears (to an observer) in
the airplane coordinates to sweep back toward the +x direction. This implies that the downwash
vector has two properties:
It is proportional to the cosine of the dihedral angle for any panel.
There is a time delay of amount X/U for the arrival at any point. (X is streamwise coordinate.)
Main Index
GUSTLDW 955
Computes downwash load due to gust
Format:
GUSTLDW EDT,AERO,CSTMA,MKLIST,AEBGPDT*,SKJ,LAJJT,UAJJT/
QKGUST*/
GUST2ID/S,N,QKGUSTL $
Parameters:
Main Index
956 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:
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
IFP 957
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
958 IFP
Reads Bulk Data Section
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$
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/
Main Index
IFP 959
Reads Bulk Data Section
GEOM1.0,EPT.0,MPT.0,IEDT,IDIT,IDYNAMIC,
GEOM2.0,GEOM3.0,GEOM4.0,EPTA,IPCOMPT.0,
MTPOL.0,IAXIC,IPVT,IDMI,IDMINDX,IDTI,IDTINDX,
DEFUSET,IEDOM,IDEQATN,IDEQIND,CONTACT,OINT,UNUSED2/
S,N,NOGOIFP/S,N,RUNIFP3/S,N,RUNIFP4/S,N,RUNIFP5/
S,N,RUNIFP6/S,N,RUNIFP7/S,N,RUNIFP8/S,N,RUNIFP9//
S,N,RUNMEPT/S,N,RUNIFP10 $
$
PVT IPVT,iCASECC/ $ RESOLVE PARAMETER VALUES SET IN CASE CONTROL
$
IF ( RUNIFP3 ) THEN $
IFP3 IAXIC/GEOM1.3,GEOM2.3,GEOM3,GEOM4.3/S,N,NOGOIFP3 $
ELSE $
EQUIVX GEOM1.0/GEOM1.3/-1 $
EQUIVX GEOM2.0/GEOM2.3/-1 $
EQUIVX GEOM3.0/iGEOM3 /-1 $
V V.0/GEOM4.3/-1 $
ENDIF $
$
IF ( RUNIFP4 ) THEN $
IFP4 IAXIC,GEOM1.3,GEOM2.3,GEOM4.3,MTPOL.0/
GEOM1.4,GEOM2.4,IGEOM4,IMATPOOL/S,N,NOGOIFP4 $
ELSE $
EQUIVX GEOM1.3 /GEOM1.4/-1 $
EQUIVX V2.3 /GEOM2.4/-1 $
EQUIVX V4.3 /iGEOM4 /-1 $
EQUIVX MTPOL.0/IMATPOOL/-1 $
ENDIF $
$
IF ( RUNIFP5 ) THEN $
IFP5 IAXIC,GEOM1.4,GEOM2.4/IGEOM1.5,IV2.5/
S,N,NOGOIFP5 $
ELSE $
EQUIVX GEOM1.4/iGEOM1.5/-1 $
EQUIVX GEOM2.4/iGEOM2.5/-1 $
ENDIF $
$
IF ( RUNIFP8 ) THEN $
IFP8 MPT.0,IDIT/MPT.8/S,N,NOGOIFP8 $
ELSE $
EQUIVX MPT.0/MPT.8/-1 $
Main Index
960 IFP1
Reads Case Control Section
Format:
IFP1 /CASECC,PCDB,XYCDB,POSTCDB,FORCE,MMCDB/
S,N,NOGOIFP1/S,N,LASTCC/S,N,BEGSUP/STEPPR $
Parameter:
Remarks:
1. IFP1 does not stop if an error is detected in the Case Control Section; therefore, the following
statement should appear after the module:
Main Index
IFP1 961
Reads Case Control Section
IF (NOGOIFP1) EXIT $
2. IFP1 may be executed only once and should appear at the beginning of the DMAP sequence
before any other module.
Example:
Read multiple Case Control Sections in a loop. Each Case Control Section is prefaced with the
AUXCASE and AUXMODEL commands. The outputs from IFP1 are to be qualified on auxiliary model
identification number.
DO WHILE ( LASTCC<>2 ) $
IFP1 /XCASECC,XPCDB,XXYCDB,XPOSTCDB,XFORCE/
S,N,NOGOIFP1/S,N,LASTCC $
PARAML XCASECC//'DTI'/1/258//S,N,AUXMID $
EQUIVX XCASECC/CASEXX/-1 $
EQUIVX XPCDB/PCDB/-1 $
EQUIVX XXYCDB/XYCDB/-1 $
EQUIVX XPOSTCDB/POSTCDB/-1 $
EQUIVX XFORCE/FORCE/-1 $
ENDDO $
Main Index
962 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
Entry Record Output Records Output Data Blocks
AXIC None None
CCONEAX CCONE GEOM2
FORCEAX FORCE GEOM3
MOMAX MOMENT GEOM3
Main Index
IFP3 963
Modifies Bulk Data entry records
Bulk Data
Entry Record Output Records Output Data Blocks
MPCAX MPC GEOM4
OMITAX OMIT GEOM4
POINTAX MPC GEOM4
GRID GEOM1
PRESAX PLOAD GEOM3
RINGAX SPC GEOM4
GRID GEOM1
SECTAX MPC GEOM4
GRID GEOM1
SPCAX SPC GEOM4
SUPAX SUPORT GEOM4
TEMPAX TEMP GEOM3
4. The other Bulk Data entries recognized and processed by IFP3 are:
Example
See the example in the IFP, 957 module description.
Main Index
964 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.
Main Index
IFP4 965
Processes hydroelastic-related Bulk Data entry records
3. The following is a list of Bulk Data entry records generated or modified by IFP4:
Bulk Data
Entry Record Output Records Output Data Blocks
AXIF None None
BDYLIST Various MATPOOLX
CFLUID2 CFLUID2 GEOM2X
CFLUID3 CFLUID3 GEOM2X
CFLUID4 CFLUID4 GEOM2X
FLSYM Various MATPOOLX
FREEPT SPOINT GEOM2X
MPC GEOM4X
FSLIST CFSMASS GEOM2X
SPC GEOM4X
GRIDB GRID GEOM1X
PRESPT SPOINT GEOM2X
MPC GEOM4X
RINGFL GRID GEOM1X
SEQGP GEOM1X
DMIAX DMIG MATPOOLX
Example:
See the example in the IFP, 957 module description.
Main Index
966 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:
Input Record Input Data Block Output Record Output Data Block
AXSLOT AXIC None None
CAXIF2 GEOM2 PLOTEL GEOM2X
CAXIF3 GEOM2 PLOTEL GEOM2X
Main Index
IFP5 967
Process acoustic cavity-related Bulk Data entry records
Input Record Input Data Block Output Record Output Data Block
CSLOT3 GEOM2 PLOTEL GEOM2X
CSLOT4 GEOM2 PLOTEL GEOM2X
CAXIF4 GEOM2 PLOTEL GEOM2X
GRIDF AXIC GRID GEOM1X
GRIDS AXIC GRID GEOM1X
SLBDY AXIC CELAS2 GEOM2X
Example:
See the example in the IFP, 957 module description.
Main Index
968 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/v
S,N,NOGOIFP6/S,N,NOCOMP/DSFLAG $
EPT Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries.
MPT Table of Bulk Data entry images related to material properties, in particular,
MAT2 and MAT8 entries.
DIT Table of TABLEij Bulk Data entry images.
PCOMPT Table containing LAM option input from the PCOMP Bulk Data entry.
EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL
records.
MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2
records.
PCOMPTC Table containing LAM option input and expanded information from the
PCOMP Bulk Data entry.
Parameter:
Main Index
IFP6 969
Creates PSHELL and MAT2 Bulk Data entry records
Remarks:
1. IFP6 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP6 should
be checked before proceeding to the GP1 module.
2. IFP6 must appear after the IFP and before the IFP7 modules.
Example:
See the example in the IFP, 957 module description.
Main Index
970 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.
EPTX Copy of EPT except PBCOMP records are replaced by equivalent PBEAM
records.
Parameter:
Remarks:
1. IFP7 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP7 should
be checked before proceeding to the GP1 module.
2. IFP7 must appear after the IFP6 and before the IFP8 modules.
Example:
See the example in the IFP, 957 module description.
Main Index
IFP8 971
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 $
MPTX Copy of MPT except applicable MATHP records are updated to include
referenced TABLSE1 Bulk Data entry information
Parameter:
Remarks:
1. IFP8 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP8 should
be checked before proceeding to the GP1 module.
2. IFP8 must appear after the IFP4 and before the IFP9 modules.
3. IFP8 modifies the MATHP Bulk Data entry records using least squares fitting of experimental
data referenced on TABLES1 Bulk Data entry records to analytically obtained solutions.
Example:
See the example in the IFP, 957 module description.
Main Index
972 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 $
EPT Table of Bulk Data entry images related to element properties; in particular,
PBARL and PBEAML entries.
GEOM1 Table of Bulk Data entry images related to geometry.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the iterative
solver. Also contains SET1 entries.
GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points.
EPTX Copy of EPT except PBARL and PBEAML records are replaced by
equivalent PBAR and PBEAM records
PBRMS Table of intermediate arbitrary beam data.
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 973
Creates PBAR and PBEAM Bulk Data entry records
Example:
See the example in the module description of IFP, 957.
Main Index
974 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 975
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
976 IFPBSH2
Check PBUSH2D references for TABLED5 and DEQATN entries
Format:
IFPBSH2 EPT,DIT,DEQATN,DEQIND//S,N,NOGOIFB2 $
Parameters:
Main Index
IFT 977
Performs an inverse Fourier transform
Performs an inverse Fourier transform to convert the frequency response solution matrix to the time
domain.
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
Main Index
978 IFT
Performs an inverse Fourier transform
1 it
u i t = --- Re ũ i e d (4-55)
0
where ũ is considered to be a known input (frequency response, and u t is the output (time
response). Several approximations will be used for evaluation of (4-55). A special algorithm is to be used
for equal ’s, which can result in savings of computation times. A special algorithm will be introduced
to provide for a cubic spline fit for ũ between the data points.
Method:
General Approach. The integral will be expressed as a finite sum. The input data block UXF has
one row for each mode, and a column (complex) for each frequency. The output UXT will have the same
number of rows, but with these columns for each time step. Frequencies and times have been selected via
standard FREQi and TSTEP Bulk Data entries. Each row of the input matrix is transformed into a row
of the output.
The basic sume is given by
NFREQ
1 ·· i t
u i t m = ---
Re C mn ũ i n + D mn ũ i n e n m (4-56)
n=1
NFREQ
1 i n t m
u· i t m = --- Re i n C mn ũ i n + D mn ũ i n e (4-57)
n=1
NFREQ
1 2 i n t m
u·· i t m = --- Re – n C mn ũ i n e (4-58)
n=1
where:
m = 1, 2,...,NTIME
n = 2 f n f = frequency
ũ i n = the complex quantity in the i-th row and the n-th column of UHVF.
Main Index
IFT 979
Performs an inverse Fourier transform
Re = "Real part of." Note: for efficiency ReCu = ReCu Reu – Imc Imu
n – n – 1 n + 1 – n
C mn = -------------------------- E 2 – it m n – n – 1 + -------------------------- E 2 + it m n + 1 – n (4-59)
2 2
3 3
n – n – 1 n + 1 – n
D mn - G – it m n – n – 1 – ---------------------------------- G n + 1 – n
= – -------------------------------- (4-60)
24 24
For the first , only the second term of C and D is used; and, for the last , only the first term is used.
–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
2 C mn = 0 C m = (See (4-57).)
C m D mn are functions of m , See (4-57) and (4-58).
only. Special for first and last .
Main Index
980 IFT
Performs an inverse Fourier transform
nm
n t m = nmt = 2 ------- (4-61)
N
C k = cos 2k N
(4-62)
S k = sin 2k N
Then
i n t m
e = C k + iS k (4-63)
where
Mod nm
k = (4-64)
N
The table can be created with recurrence. For unequal , then
i n t m
e = cos n t m + i sin n t m (4-65)
The funtions E 2 and G will have special formulas depending upon the size of their argument.
1 – cos – sin
E 2 i = --------------------
- +i -------------------
- 0 (4-66)
1 2 1 2
--
- --
-
2 2
2 4 5 5
- + ------------------------
= 1 – --------- - – + + i --- – ------------------ + -------------------- – + 0 (4-67)
34 3456 3 3 4 5 3 47
G i = 2E 2 i – E 4 i (4-68)
2 3
----- – 1 + cos ----- – + sin
2 6
E 4 i = -------------------------------- - 0
- + -------------------------------
4
(4-69)
4
-
-----
------
24 24
2 4 3
- – + + i
- + ------------------------ - + -----------
.5 - – +
= 1 – --------- --- – ----------------- 0
(4-70)
56 5678 5 5 6 7 59
Main Index
IFT 981
Performs an inverse Fourier transform
–9
0 = 0.1 . The alternating series is continued until the last term computed is less than 10 .
··
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 = ------------------------------------------------------------------------------------------- (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
BN = --------------------------------------------------------------------------------------------------------------------------------------- (4-72)
n – n – 1
n = NFREQ – 1 3 2
(real and imaginary)
The forward pass:
ũ 2 – ũ 1
6 ------------------- – 2 – 1 A 2 B 2
·· 2 – 1
ũ 1 = ----------------------------------------------------------------- Real Part (4-73)
6 1 + 2 – 1 2 – A 2
0 Imaginary Part
Then continue for 2 NFREQ .
·· ··
ũ n = A n B n – ũ n – 1
Main Index
982 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 983
Creates output transformation matrix
Creates the output transformation matrix for a particular OFP table type.
Format:
ILMP2 EDT,OFP12,OFP22,OFP32/
OTMT,RLABEL/
NCOLMNP2 $
OTMT Transpose of the output transformation matrix. Each column of the matrix
will be associated with a single ILMP (and labeled in RLABEL). The rows
will be the partition of g-set size DOFs that are contributing (CP defined).
RLABEL Monitor point label for each column in OTMT.
Parameters:
Main Index
984 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 985
Indexes the Bulk Data table
Format:
INDXBULK BULK/BULKINDX $
Parameters:
None.
Remark:
1. INDXBULK only indexes the CORDij, GRID and QSETi records.
Main Index
986 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 $
Main Index
INPUTT2 987
Input tables of matrices from a FORTRAN unit
Parameters:
IUNIT Input-integer-no default. IUNIT is the FORTRAN unit number from which
the data blocks are to be read. IUNIT = 0 is not recommended.
LABL Input-character-default = 'XXXXXXXX'. LABL is the label on the
FORTRAN unit. A check of the label may or may not be performed based on
the value of ITAPE as indicated in the following table.
Main Index
988 INPUTT2
Input tables of matrices from a FORTRAN unit
HNAMEi Output-character-default=' '. Data block name found in the header of DBi
on the Fortran unit.
DBKNT Output-integer-default=0. Total number of data blocks found on IUNIT.
DBKNT is only computed under ITAPE= -3 or -13.
NDDLNAMi Input-character-default=blank. NDDL names corresponding to DB1 through
DB5. If DBi is a matrix, then the corresponding NDDLNAMi is 'MATRIX'.
Used only to read unformatted (binary) Fortran files created on non-native
computers.
Remarks:
1. Any or all of the output data blocks may be purged. Only nonpurged data blocks will be taken
from the tape. The data blocks will be taken sequentially from the tape starting from a position
determined by the value of the first parameter. Note that the output data block sequence A,B,,, is
the same as ,A,,B, or ,,,A,B.
2. The ASSIGN FMS statement is recommended for assigning the FORTRAN unit. Certain
FORTRAN units are reserved, see Making File Assignments (p. 88) in the MSC Nastran 2012
Installation and Operations Guide for a listing of reserved FORTRAN units.
3. Data blocks will be read from the FORTRAN unit in either binary or neutral format, depending
upon the FORM option of the ASSIGN FMS statement. If no ASSIGN FMS statement is
specified, then binary input is assumed.
4. The format of the FORTRAN binary file is given in the OUTPUT2 description
5. Factor matrices (forms 4, 5, 10, 11, 13 and 15) cannot be processed by INPUTT2.
Main Index
INPUTT4 989
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.
Main Index
990 INPUTT4
Inputs a matrix from a FORTRAN unit
2. Each real or complex matrix must have been written on IUNIT according to the format below.
• For example, in the nonsparse format and binary format (ASSIGN FORM=UNFORMATTED),
each matrix could be created (assumed on FORTRAN unit 8) as follows:
Record 1-four word record
WRITE(8) NCOL,NROW,NF,NTYPE
Record 2,3,etc.
WRITE(8) ICOL,IROW,NW,(X(I),I=1,NW)
• If the ASCII format (ASSIGN FORM=FORMATTED) and the nonsparse format is desired, then
each matrix must be created as follows:
Record 1
WRITE(8,100) NCOL,NROW,NF,NTYPE
100 FORMAT(4I8)
Record 2, 3, etc.
WRITE(8,200) ICOL,IROW,NW,(X(I),I=1,NW)
200 FORMAT(3I8,(1P,5E16.9))
The format for X(I) above must be (1P,rEw.d),
where d is the number of digits in the fractional part, w must be greater than d+7, and r is the
integer part of 80/w.
• The MSC Nastran "util" directory contains a utility subroutine called MAKIDS in a file called
mattst.f (or .for) which will write a matrix into the format suitable for INPUTT4. See Building
and Using MATTST (p. 248) in the MSC Nastran 2012 Installation and Operations Guide.
• Zero terms must be explicitly present from the first nonzero in any column to the last nonzero
term unless the sparse matrix option is used.
• Null columns need not be input (they will be properly handled if they are input).
3. The ASSIGN FMS statement is recommended for assigning the FORTRAN unit. Selection of a
proper value for IUNIT is machine dependent. If the ASSIGN statement is not provided, then the
format of the matrices on IUNIT is assumed to be nonsparse and binary. The ASCII format
requires an ASSIGN FMS statement with the FORM = FORMATTED option. Certain
FORTRAN units are reserved, see Making File Assignments (p. 88) in the MSC Nastran 2012
Installation and Operations Guide for a listing of reserved FORTRAN units.
4. The memory required is from the first nonzero entry in the column to the last nonzero entry.
5. Factor matrices from DECOMP and DCMP (matrix forms 4, 5, 10, 11, 13, and 15) cannot be
processed by INPUTT4.
Main Index
INTERR 991
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:
Main Index
992 INTERR
Generates modal components of base motion from a response spectrum
Remark:
Only FN may be purged, in which case INTERR returns.
Main Index
ISHELL 993
Invokes an external program
Format:
ISHELL //PRGNAME/S,N,IRTN/NOINT/NOREAL/NOCMPX/NOCHAR/NOUN
IT/
INT1 /INT2 /INT3 /INT4 /
REAL1/REAL2/REAL3/REAL4/
CMPX1/CMPX2/CMPX3/CMPX4/
CHAR1/CHAR2/CHAR3/CHAR4/
IUNIT1/IUNIT2/IUNIT3/IUNIT4 $
Parameters:
Main Index
994 ISHELL
Invokes an external program
Remarks:
1. The external program identified by PRGNAME will be passed arguments from MSC Nastran as
specified by the ISHELL parameters. The external program can be either a shell script or an
executable program. It can either mimic an internal module or provide any user-defined
functionality that requires access to MSC Nastran's data structures.
2. MSC Nastran remains in a "wait" state until the external program is completed.
3. OUTPUT2, OUTPUT4, INPUTT2 and INPUTT4 modules are required to pass tables and/or
matrices into the external program.
4. The name of external program must be uppercase and limited to 8 characters.
5. The unit numbers must have associated ASSIGN statements. Based on the ASSIGN statements,
the module will automatically pass the physical filenames associated with unit numbers to the
external program. These filenames are passed at the positions 31 through 34.
6. Errors encountered in ISHELL will not terminate the MSC Nastran execution. To help debug
errors in ISHELL, diagnostic messages may be requested on the nastran command line with
"symbol=MSCBGN=ishelln"; where n can be integer value 1 to 9 with 1 giving the lowest level
of verboseness and 9 giving the highest.
7. IRTN=-1 indicates a failure during invocation of PRGNAME. It is not related to errors
encountered within the invoked script or executable. For example, PRGNAME cannot be found
or does not have execute permission.
8. You will need a utility program to parse the arguments for your external program. For example,
use set -A argarray "$@" or a similar technique.
9. The FORTIO module must be used with ISHELL to OPEN and CLOSE FORTRAN units
referenced by the external program.
Example:
Invoke user executable DOITPGM:
ISHELL //'DOITPGM' $
Main Index
LAMX 995
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
996 LAMX
Eigenvalue Table Editor
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
Main Index
LAMX 997
Eigenvalue Table Editor
0
f
j
R 3j if R 3j 0
• Generalized mass: mj = 0
m j if R 3 = 0
• Then eigenvalue, radians, and generalized stiffness are based on the modified frequency and
generalized mass:
radians: j = 2f j
2
eigenvalue: j = j
generalized stiffness: Kj = j mj
Number of Modes
fj
0.0 3
mj
Main Index
998 LAMX
Eigenvalue Table Editor
3. In the LMAT matrix each row corresponds to a mode. Each column corresponds to eigenvalue,
radians, frequency, generalized mass, and generalized stiffness.
i i fi 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:
Main Index
LAMX 999
Eigenvalue Table Editor
Main Index
1000 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
LANCZOS 1001
Performs real eigenvalue analysis
Parameters:
If SID=0, the set identification number is obtained from the METHOD command
in CASECC and used to select the EIGR, EIGB, or EIGRL entries in
DYNAMICS.
If SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL
is selected by this parameter value. All subsequent parameter values (METH, F1,
etc.) are ignored.
If SID<0, then both the METHOD command and all EIGR, EIGB, or EIGRL
entries are ignored and the subsequent parameter values (METH, F1, etc.) will be
used to control the eigenvalue extraction.
F1 Input-real-default=0.0. The lower frequency bound in cycles per unit time.
F2 Input-real-default=0.0. The upper frequency bound in cycles per unit time. The
default value of 0.0 indicates machine infinity.
NDES Input-integer-default=0. The number of desired eigenvalues. If the last mode is
repeated, then nDes + m (where m is the multiplicity of the last mode) solutions
are found.
MSGLVL Input-integer-default=1. The level of diagnostic output for the Lanczos method
only.
0 No output.
1 Warning and fatal messages.
2 Summary output.
3 Detailed output on cost and convergence.
Main Index
1002 LANCZOS
Performs real eigenvalue analysis
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 1003
Expands Case Control table based on LSEQ Bulk Data entries
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:
APP Input-character-no default. Analysis type. Specifies which records to use in creating
equivalent static loads from dynamic loads. Allowable types are:
blank Not dynamics.
'FREQRESP' Frequency response -- use RLOADi record.
Main Index
1004 LCGEN
Expands Case Control table based on LSEQ Bulk Data entries
Main Index
LMATPRT 1005
Prints combined design sensitivity/constraint matrix
Prints the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity Analysis
only.
Format:
LMATPRT DSCMR,DSROWL,DSCOLL//
DSZERO $
Parameter:
Main Index
MSC Nastran DMAP Programmer’s Guide
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 1007
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
1008 MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries
Parameters:
Remarks:
None.
Main Index
MAKAEFS 1009
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
1010 MAKAEMON
Creates hinge moment (HM) monitor points
Creates hinge moment (HM) monitor points and merges with previously defined monitor points if
present. Also generates a new full vehicle (COEF) monitor point.
Format:
MAKAEMON AERO,EDT,AEMONOLD/
AEMONPT,MONITOR/
AECONFIG $
Parameters:
Remarks:
None.
Main Index
MAKCOMP 1011
Extracts components from EDT
Extract components from EDT and merge with previously defined components if OLDCMP is present.
Format:
MAKCOMP EDT,AECOMP,AECMPOLD/
AEROCOMP
/
STRUCOMP
MESH $
Parameters:
Remarks:
None.
Remarks:
None.
Main Index
1012 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:
1. The allowable values for NEWNAMi and OLDNAMi are:
Main Index
MAKENEW 1013
Converts tables from pre-Version 69 to Version 69 (or greater) format
2. The inputs, outputs, and parameters can be specified in any order as long as the parameters are in
the same positions as their respective inputs or outputs. For example, the following specifications
are equivalent.
MAKENEW GEOM1,AXIC,,,/NGEOM1,NAXIC,,,/
'GEOM1'/'AXIC'///'GEOM1'/'AXIC' $
MAKENEW AXIC,GEOM1,,,/NAXIC,NGEOM1,,,/
'AXIC'/'GEOM1'///'AXIC'/'GEOM1' $
3. In order to create BGPDT, EST, and CSTM, MAKENEW requires multiple inputs. For example,
MAKENEW BGPDT,EQEXIN,SIL,GPL,/NBGPDT,,,,/
'BGPDT'/'EQEXIN'/'SIL'/'GPL'//'BGPDT' $
MAKENEW EST,EQEXIN,SIL,,,/NEST,,,,/
'EST'/'EQEXIN'/'SIL'///'EST' $
MAKENEW CSTM,EQEXIN,GPL,,,/NCSTM,,,,/
'CSTM'/'EQEXIN'/'GPL'///'CSTM' $
4. The generation of the new data organization on 32 bit platforms does not increase the precisional
values of the data items.
5. Heat transfer and p-elements in EST cannot be processed by MAKENEW.
Main Index
1014 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 1015
Converts tables from Version 69 (or greater) to pre-Version 69 format
2. The inputs, outputs, and parameters can be specified in any order as long as the parameters are in
the same positions as their respective inputs or outputs. For example, the following specifications
are equivalent.
MAKEOLD GEOM1,AXIC,,,/OGEOM1,OAXIC,,,/
'GEOM1'/'AXIC'///'GEOM1'/'AXIC' $
MAKEOLD AXIC,GEOM1,,,/OAXIC,OGEOM1,,,/
'AXIC'/'GEOM1'///'AXIC'/'GEOM1' $
3. If BGPDT is specified as input then MAKEOLD creates four tables BGPDT, EQEXIN, SIL, and
GPL. For example,
MAKEOLD BGPDT,,,,/OBGPDT,OEQEXIN,OSIL,OGPL,/
'BGPDT'/////'BGPDT'/'EQEXIN'/'SIL'/'GPL' $
Main Index
1016 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 1017
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
1018 MAKMON
Builds table of monitor points
Format:
AEROCOMP
MAKMON EDT, , /
STRUCOMP AEROCOMP
AEMONPT
,MONDISP,MONGRP,MP3LAB,MP3GPF/MKERRCHK
$ MONITOR
Parameter:
Main Index
MASSCOMB 1019
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
1020 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/P
13 $
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 1021
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
1022 MATGEN
Matrix generator
Option P1 = 3
Generate a data block of prescribed size.
Format:
MATGEN ,/DB/3/P2 $
Parameters:
This option was primarily designed to generate data blocks of various sizes for data base testing. Each
data block contains two files; a short two-record descriptor file and a file with records that contain 100
words of zero.
Option P1 = 4
Generate a pattern matrix.
Format:
MATGEN ,/MAT/4/P2/P3/P4/P5/P6/P7/P8/P9 $
Parameters:
P2 Number of columns.
P3 Number of rows.
Main Index
MATGEN 1023
Matrix generator
P4 Precision.
P5 Number of values in nonzero string.
P6 Row number increment between nonzero strings after first nonzero
string (P7-1). Produces (P6-1) zeros.
P7 Row number of first nonzero value in first column. Produces (P7-1)
zero values.
P8 Row number increment to first nonzero string in second and
subsequent.
P9 Number of columns in overall pattern. Overall pattern is repeated at
column number P9+1.
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
.
.
.
. .
. . .
. .
P2
Remark:
The nonzero values in each column will be the column number.
Examples:
1. To generate a 10 x 10 diagonal matrix with the column number in each diagonal position, code:
Main Index
1024 MATGEN
Matrix generator
MATGEN ,/DIAG/4/10/10/0/1/10/1/1/10 $
2. Generate a 12x1 partitioning (Boolean) vector with a nonzero value at every third row:
MATGEN ,/ASTRIP/4 /1 /12/ /1 /3 /3 $
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 1025
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:
Main Index
1026 MATGEN
Matrix generator
Remarks:
10
10
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 $
Main Index
MATGEN 1027
Matrix generator
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 $
Parameters:
Main Index
1028 MATGEN
Matrix generator
The equation used to determine the coefficient of the (l,J)th term of the output matrix is:
MAT (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
J
For M1 (I,J) = 4 ; I = 1 100 J = 1200 :
MATGEN AB/Ml/8//100/200/-1 $
For M2 (I,J) = 3.5J – 5.21 = 1100J = 1200 :
MATGEN AB/M2/8//100/200/0 $
For M3 (I,J) = – 21.8 6.6 + – 1 0.01 7.9
---------- + ------- ; I = 1 100 and J = 1200 :
J
I J
Main Index
MATGEN 1029
Matrix generator
MATGEN AB/M3/8//100/200/2/1 $
For HILBERT (I,J) = 1.0 I + J – 1 ; I J = 1 10 :
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 $
Transform an a-set size matrix to external sequence.
VEC USET/VATOG/’G’/’A’/’COMP’ $
MERGE KAA,,,,VATOG,/KAGG/ $0 EXPAND TO
$ G- SIZE, INTERNAL SORT
MATGEN EQEXIN/INTEXT/9/0/LUSET $
SMPYAD INTEXT,KAGG,INTEXT,,/KAAGEXT/3////1////6 $
$ (KAAGEXT) = TRANSPOSE(INTEXT)*(KAAG)*
Main Index
1030 MATGEN
Matrix generator
By default in SOLs 1 through 200, PARAM, OLDSEQ is -1, which means this operation is not required.
Option P1 = 10
Not used.
Option P1 = 11
Generate a rectangular matrix, driven by USET table.
Format:
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 1031
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
1032 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 1033
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/TIN
Y/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
1034 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 1035
Degree-of-freedom matrix printer
Remark:
The supersets formed by the union of other sets have the following definitions:
sets supersets
mp
m
mr
sb
sg s
o
g
q p
ne
r n
c a d f
t fe
b l
lm
e
k
ks
sa
js
j
5. If the value specified for COLNAM is not one of the names shown in Remark 1, then the columns
will be labeled 1,2,3..., etc. without grid and component labels.
6. If the value specified for R is not one of the names shown in Remark 1, then the terms in each
column will be labeled “1 H”, “2 H”, “3 H”, etc. without grid and component labels. The user must
know which sets correspond to the rows and columns of the matrix to be printed. This is usually
apparent from the DMAP name of the matrix data block.
7. When using Format 1 this module may not be scheduled until after GPSP since data blocks
generated by GPSP are required inputs. (This module may be scheduled after GP4 if USET0 is
specified for input to MATGPR instead of USET.) When using Format 2 this module may not be
scheduled until after DPD since data blocks generated by DPD are required inputs. When using
Format 3, MATGPR must be scheduled after the APD module.
8. If MATRIX is purged, no printing will be done.
9. The rows and columns of A must correspond to the order of the degrees-of-freedom defined in
GPL, USET, SIL, BGPDT, etc.; i.e., internal sequence.
Main Index
1036 MATGPR
Degree-of-freedom matrix printer
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' $
COLUMN 1
MATRIX GCF
POINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0 1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0 1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0 4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0
Main Index
MATGPR 1037
Degree-of-freedom matrix printer
DIRECTION 1
G R O U N D C H E C K F O R C E S ( G - S E T )
Main Index
1038 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 1039
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.
4. If COLINC>0 then, by default, ENDCOL is assumed to be equal to the number of columns.
Examples:
1. Extract the seventh column from A and call it A7.
MATMOD A,,,,,/A7, /1/7 $
2. Extract the third, fourth, and fifth columns from A.
MATMOD A,,,,,/A345, /1/3/3 $
Main Index
1040 MATMOD
Matrix modification
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:
PURGE Input-integer-default=0. If PURGE=0, and the input matrix has no nonzero terms,
then the output matrix will be purged. If PURGE 0 , and the input matrix has
no nonzero terms then the output matrix will be null.
UPLOW Input-integer-default=0. Triangular nullification flag.
>0 All lower triangular terms in O1 are set to zero.
<0 All upper triangular terms in O1 are set to zero.
=0 No nullification.
TYPEF Input-integer-default=0. Filtering method.
0 Magnitude: O1(i,j) is set to zero when abs(I1(i,j)) < abs(FILTER).
1 Algebraic: O1(i,j) is set to zero when I1(i,j)<FILTER.
-1 Algebraic complement: O1(i,j) is set to zero when I1(i,j)>FILTER.
FILTER Input-real-default=0.0. Value of filter. Terms in I1 with an absolute magnitude
less than the absolute value of FILTER will be set to zero.
Main Index
MATMOD 1041
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:
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 $
Main Index
1042 MATMOD
Matrix modification
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.
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.
Main Index
MATMOD 1043
Matrix modification
Format:
Form 1 (Inserts 6x6 matrix along diagonal)
MATMOD I1,SIL,,,,/O1,/5/LUSET/0 $
Form 2 (Generates specified coordinate system to basic coordinate system transformation matrix)
MATMOD CSTM,SIL,,,,/01,/5/LUSET/P3 $
MATMOD CSTM,SIL,BGPDT,,,/01,/5//-1 $
Parameter:
Remarks:
1. If P3 = 0, this option accepts a six row by six column matrix and the SIL table. The output is a
g-size square matrix containing the 6 x 6 input matrix along the diagonal at every grid point.
Scalar and extra points contain 0.0 values.
If P3 > 0, the 6 x 6 single-precision matrix will be the transformation matrix from the coordinate
system with the coordinate ID = P3 to the basic system. If P3 points to a cylindrical or spherical
coordinate system, then the transformation location is at the origin of the P3 system. Scalar and
extra points contain 1.0.
Main Index
1044 MATMOD
Matrix modification
If P3 = -1, the 6 x 6 single-precision matrix will be the global-to-basic transformation for each
grid point. Scalar and extra points contain 1.0.
2. If SIL is purged, the MATMOD uses LUSET for the size of the g-set. The assumption is made
that only grids exist in the g-set. LUSET must not be zero if SIL is purged.
Examples:
Transform KGG to another coordinate system.
1. Assume TRANS to be a 6 x 6 transformation matrix and KGG was formed using only one
coordinate system (global coordinate system is the same at each grid point). Transform KGG
using TRANS.
MATMOD TRANS,SIL,,,,/TRANSG,/5 $
TRNSP TRANS/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGPRIME/3 $
2. Assume KGG was formed using coordinate system 10 as the global coordinate system for all grid
points. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,,,,/TRANSG,/5//10 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $
3. Assume KGG was formed using arbitrary coordinate systems as the global coordinate system for
each grid point. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,BGPDT,,,/TRANSG,/5//-1 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $
Transform KGGBASIC coordinate system 10.
MATMOD CSTM,SIL,,,,/TRANS10,/5//10 $
TRNSP TRANS10/TRANST10T $
SMPYAD TRANS10T,KGGBASIC,TRANS10,,,/KGG10/3 $
Option P1 = 6
Find the maximum absolute value for each row over all columns of a matrix.
Format:
MATMOD I1,,,,,/O1,/6 $
Main Index
MATMOD 1045
Matrix modification
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 $
Option P1 = 8
Normalize matrix.
Format:
MATMOD I1,,,,,/O1,/8////S,N,NORMREAL/
S,N,NORMIMAG $
Main Index
1046 MATMOD
Matrix modification
O1 Matrix shaped like I1 with every term divided by the magnitude of the
term in I1 with the largest magnitude.
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 $
u 1 v 1 a 1 u 2 v 2 a 2 u i v i a i
Example:
Find and output maximum transient response.
Main Index
MATMOD 1047
Matrix modification
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 $
LOCVEC G-size vector with values that represent grid locations in the basic
coordinate system.
BGPDT Basic grid point definition table.
Main Index
1048 MATMOD
Matrix modification
BGPDTN New BGPDT table with grid point locations that are displaced by
LOCVEC.
Example:
Build new BGPDT table based on the deformed state.
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)
O1 Column vector which has 1.0 at those rows where all matrices selected
have null columns if P4 > 0 or non-null columns if P4 < 0.
O2 Square symmetric matrix which has 1.0 on the diagonal of those
columns where all matrices selected have null columns if P4 > 0 or
non-null if P4 < 0.
Parameters:
Main Index
MATMOD 1049
Matrix modification
Remarks:
1. I2 and I3 may be purged.
2. O2 may be purged.
Example:
Search for simultaneous null columns in the g-size mass, damping, and stiffness matrices and remove
rows and columns corresponding to these columns.
MATMOD MGG,BGG,KGG,,,/PARTNULL,/12/S,N,NO
IF (NONULL > 0) THEN $
PARTN MGG,PARTNULL,/MGGNEW,,,/-1 $
EQUIVX MGGNEW/MGG/ALWAYS $
PARTN BGG,PARTNULL,/BGGNEW,,,/-1 $
EQUIVX BGGNEW/BGG/ALWAYS $
PARTN KGG,PARTNULL,/KGGNEW,,,/-1 $
EQUIVX KGGNEW/KGG/ALWAYS $
ENDIF $
Option P1 = 13
Copies any data block.
Format:
MATMOD I1,,,,,/O1,/13 $
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.
Main Index
1050 MATMOD
Matrix modification
Format:
MATMOD I1,,,,,/O1,/14/PURGE/UPLOW/STRTR/
FILTER/RELFLT/TRUNC $
Parameters:
Main Index
MATMOD 1051
Matrix modification
4. If I1 is not square and the relative filtering option is selected, then FILTER will be set to RELFLT
and the absolute filtering technique will be used. A user warning message will also be issued.
Option P1 = 15
Not implemented.
Option P1 = 16
Put matrix into DMIG format in a MATPOOL-type data block and/or generate DMIG punched output.
Format:
MATMOD MATIN,EQEXIN,USET,,,/MATPOOLX,/16/PNDMIG/
SORTFLG/TYPOUT////////CCHAR/DMIGNAME/
ROWSETNM/COLSETNM $
Parameters:
Main Index
1052 MATMOD
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.)
Main Index
MATMOD 1053
Matrix modification
6. The rows of the DMIG entry are always labeled with the appropriate grid/scalar IDs and
component numbers. If a displacement set is specified (or implied) for COLSETNM, then the
columns of the DMIG entry are also labeled with the appropriate grid/scalar IDs and component
numbers. Otherwise, the columns of the DMIG entry are labeled sequentially, starting with unity.
7. The EQEXIN input data block may not be purged.
8. The USET input data block may be purged if (a) the default value of 0 is used for SORTFLG or
(b) the displacement set specified (or implied) by ROWSETNM is ‘G’ and the displacement set
specified (or implied) by COLSETNM is either ‘G’ or the columns are just sequential entities.
9. The MATPOOLX output data block may be purged if PNDMIG is specified as non-zero and only
the DMIG punched output is desired.
10. By employing the “APPEND” option on a DMAP FILE statement, a single concatenated
MATPOOLX output data block may be generated from multiple calls to MATMOD Option 16.
See the following Example 2.
Example 1:
Generate DMIG punched output for the boundary stiffness matrix KAA, the boundary load matrix PA
and the matrix GMN (representing the MPC/rigid element equations) for an external superelement. The
KAA DMIG entry is to be named KAAEXTSE, the PA DMIG entry is to be named PAEXTSE and the
GMN DMIG entry is to be named GMNEXTSE.
The DMAP shown below illustrates the usage of Option 16 using input matrices in internal sort
(capability available in MSC.Nastran 2005 r2 and subsequent releases) as well as using input matrices in
external sort (only usage possible in pre-MSC.Nastran 2005 r2 releases). It can be seen that the DMAP
for the former case is much simpler and more efficient than for the latter case.
It should be pointed out here that, if the internal and external sorts are different, the DMIG output
resulting from the two scenarios shown below will “appear” to be different. This is because the matrix
elements will be output in different order, but their values will be the same. The DMIG output from the
two scenarios will yield identical matrices if they are used in turn by the MTRXIN module to re-generate
the matrices.
DMAP uses input matrices in internal sort (MSC.Nastran 2005 r2 and subsequent releases).
Main Index
1054 MATMOD
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
MATMOD 1055
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/SETSTR
4 $
Main Index
1056 MATMOD
Matrix modification
Parameters:
UBIT Input-integer-default=0. Obsolete method for set selection. For a more user-
friendly method use SETSTRi. In order to select specific sets for UBIT, add the
corresponding decimal equivalent numbers from the table below. For example, sets
R, O, and MP, UBIT=8+4+1=13. For supersets, add the decimal equivalent
numbers of the mutually exclusive sets which are contained in the superset. For
example, set S combines the SB and SG set and therefore UBIT=1024+512=1536.
The presence of any grid point degree of freedom in the associated sets causes all
degrees of freedom associated with that grid point to be given a value of 1.0 in the
output vector.
Decimal
Set Equivalent
Name Number
Q 4194304
LM 2097152
C 1048576
J 524288
K 262144
SA 131072
E 2048
SB 1024
SG 512
MR 16
R 8
O 4
B 2
MP 1
Main Index
MATMOD 1057
Matrix modification
• If SETFLG>0 then the PARTN=SID Case Control command selects the SET
command.
• If SETFLG<0 then absolute value of SETFLG selects the SET command.
NOCP Output-integer. NOCP will be set to -1 if the partitioning vector is null or cannot be
generated. Otherwise, it will be set to zero.
SETSTRi Input-character-default=' '. Set name string. SETSTR1 through SETSTR4 form
a single string of set name(s) and is 32 characters in length. The set names must be
separated by a plus sign, "+". For example, SETSTR1='M+R+N+SG' and
SETSTR2='+A+Q' specifies the m, r, n, sg, a, and q sets.
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.
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
1058 MATMOD
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
MATMOD 1059
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
1060 MATMOD
Matrix modification
2 Do not print anything. Results are returned in SUM (normally only used
with a single input matrix).
SUM Output-real. Sum of the absolute values of the largest terms in the input matrices.
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 LDL P
Main Index
MATMOD 1061
Matrix modification
where P is a permutation matrix (row and column interchange used to improve efficiency), L, a
lower triangular matrix, and D, a tridiagonal matrix. Option 21 extracts P, L, and D and converts
them to a standard form, suitable for input to any matrix module. L and P are appended column-
wise in output D.
2. Active column symmetric decomposition forms the equivalent matrix representation of a
symmetric matrix.
T
A = LDL
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 $
Main Index
1062 MATMOD
Matrix modification
Option P1 = 23
Determines type of eigenvalue analysis requested and optionally extracts values from the selected EIGR
or EIGRL Bulk Data entry.
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:
METHTYP Output-integer. Set to 1 if Inverse Power or Lanczos method selected; otherwise, set
to zero.
LANCZOS Output-integer. Set to -1 if Lanczos method selected; otherwise, set to zero.
METHFLAG Input-integer-default=0. METHOD ID selection flag.
>0 Search based on METHFLAG=SID.
0 Search based on METHOD(STRUCTURE)=SID.
-1 Search based on METHOD(FLUID)=SID.
-2 Search based on CMETHOD=SID
-3 Same as 0 except include EIGB in search for buckling.
EIGRVALR Output-real-default=0.0. Extracted real value from the EIGR or EIGRL entry.
NFOUND Output-integer-default=0. EIGR* entry found flag; 0 if entry was found and -1 if
entry was not found.
ICASE Input-integer-default=1. Case Control record number which contains the
METHOD command.
EIGRVALI Output-integer-default=0. Extracted integer value from the EIGR or EIGRL entry.
EIGRFLD EIGRFLD Input/output-character-default=' '. Field name of EIGR or EIGRL entry.
EIGRFLD is also an output if the field value is a character string.
Examples:
1. Determine method type on the EIGR entry:
MATMOD CASECC,DYNAMIC,,,,/,/23/S,N,METHTYP $
Main Index
MATMOD 1063
Matrix modification
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
1064 MATMOD
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
MATMOD 1065
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
1066 MATMOD
Matrix modification
Example:
DMIIN DMI,DMINDX/A3,,,,,,,,, $
MATMOD A3,,,,,/A6,/27 $
where A3 is the DMI matrix defined by the Bulk Data entries
DMI,A3,0,3,1,1,,4,1
DMI,A3,1,2,2.0,3.0,4.0
and A6 is the matrix
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 $
Example:
MATMOD B,,,,,/BDIAG,/28 $
If B is the matrix
1. 2.
3. 4.
then BDIAG will be
Main Index
MATMOD 1067
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 $
Main Index
1068 MATMOD
Matrix modification
Parameter:
Option P1 = 32
Convert tables created by DRMH1 into DTI Bulk Data entry format and write to the punch file. Also
converts DRMH1 directory tables in DTI Bulk Data entry format into DRMH1 output table format.
Format:
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
MATMOD 1069
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.
Main Index
1070 MATMOD
Matrix modification
Format:
MATMOD IM,,,,,/
SORTLIST,SORTBOOL/S,N,P1/COLNUM/S,N,PRESORT/
SORTOPT/// NKEYS $
IM Any matrix.
SORTLIST Vector consisting of the row numbers of the original positions of the
sorted terms.
SORTBOOL Square matrix containing unity at a row position in the column
associated with the sorted row terms.
Parameters:
Remark:
For complex matrices, only SORTOPT=2 or -2 is allowed.
Main Index
MATMOD 1071
Matrix modification
Example:
Given the input matrix, IM, generate an algebraic ascending order sort. The input matrix and its sorted
order (algebraically ascending) are:
IM =
– 2.0
0.0
– 1.0
4.0
1.0
0.0
P1=35 $
MATMOD IM,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////2 $
LIST =
1.0
3.0
2.0
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 $
Main Index
1072 MATMOD
Matrix modification
then the output matrix LIST for NKEYS=1 could contain either
LIST =
1.0
3.0
6.0
2, 0
5.0
4.0
or
LIST =
1.0
3.0
2.0
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 $
IMS =
– 2.0
– 1.0
0.0
0.0
1.0
4.0
Main Index
MATMOD 1073
Matrix modification
Remarks:
1. If the matrix input into this option contains more than one column and SORTBOOL is used
subsequently to operate on this matrix, all columns will have their rows re-ordered according to
the sort obtained from the column processed by the MATMOD operation. In this case, the column
that was selected during the MATMOD operation to produce the sorted ordering will be
guaranteed in sort. Other columns may or may not have their rows in sorted order.
2. The output data blocks are in machine precision, regardless of the precision of the input matrix.
3. NKEYS=2 provides a more repeatable sort in the presence of equal values in the input, at the cost
of longer run times. A test on a typical vector showed a difference of a factor of approximately
ten. If repeatability is not essential, NKEYS=1 is the preferred choice.
Option P1 = 36
Reduce the GRID record in the GEOM1 table to the entries corresponding to grid identification numbers
specified in a Case Control set.
General Format:
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/M36OPT///ELEMSET/MSGLVL
/PCHSET $
MATMOD GEOM1,CASECC,,,,/
GEOM1R,/
36/GRIDSET/S,N,NOGEOM1 $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,/
36/GRIDSET//1///ELEMSET/MSGLVL/PCHSET $
MATMOD GEOM1,CASECC,GEOM2,BGPDT,,/
GEOM1R,CASER/
36/GRIDSET/S,N,NOGEOM1/2///ELEMSET//PCHSET $
Main Index
1074 MATMOD
Matrix modification
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.
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 $
Main Index
MATMOD 1075
Matrix modification
IFPINDX /GEOM1 $
MATMOD GEOM1,CASECC,,,,/GEOM1R,/36/
GRIDSET/S,N,NOGEOM1 $
3. It is recommended that GEOM1 and GEOM2 be converted by the SECONVRT module and then
used as input to MATMOD.
4. M36OPT=1 performs a consistency check of the input sets and the actions are:
a. Create a grid point set of all points connected to the elements specified in the ELEMSET Case
Control set.
b. Verify that all points in the set generated above are present in the GRIDSET Case Control set
and vice-versa. By default, a fatal message will be issued error if any point is missing. But if
MSGLVL=-1, then a warning message is issued instead.
c. GEOM1R is an optional output, but if specified and if no inconsistency is detected then
GEOM1R will be generated.
5. M36OPT=2 ensures a consistent grid point set for the input element set and the actions are:
a. Create a set in CASER of all points touched by the elements contained in the ELEMSET Case
Control set. Create a Case Control set in CASER with an id = GRIDSET.
b. Create the GEOM1R based on CASER.
6. M36OPT=3 ensures a consistent grid point set for the input element set and allows additional
points to be added to the set and the actions are:
a. Create a set in CASER of all points touched by the elements contained in the ELEMSET Case
Control set defined in CASECC.
b. Create a Case Control set in CASER of the point set generated in a.
c. Locate the GRIDSET set in CASECC and merge in the set created in a. If GRIDSET set does
not exist on CASECC, simply store the ELEMSET generated grid list as the GRIDSET set ID
in CASER. Otherwise, copy the merged GRIDSET set into CASER.
d. Create the GEOM1R based on CASER.
Option P1 = 37
Reduce the element and SPOINT records in the GEOM2 table to the entries corresponding to element or
SPOINT identification numbers specified in a Case Control set.
Format:
MATMOD GEOM2,CASECC,,,,/GEOM2R,/37/
ELEMSET/GRIDSET/S,N,NOGEOM2 $
Main Index
1076 MATMOD
Matrix modification
GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points and indexed by the IFPINDX module. See Remark.
CASECC Table of Case Control command selections.
Parameters:
ELEMSET Input-integer. SET Case Control command identification number which contains a
list element identification numbers.
GRIDSET Input-integer. SET Case Control command identification number which contains a
list SPOINT identification numbers.
NOGEOM2 Output-integer. Processing status flag.
+1 No element and SPOINTs found in GEOM2 matching the contents in
ELEMSET and GRIDSET.
0 Some elements and SPOINTs in GEOM2 were found in ELEMSET and
GRIDSET.
-1 All elements and SPOINTs in GEOM2 were found in ELEMSET and
GRIDSET.
Remarks:
1. GEOM2 must be indexed with IFPINDX module before being used as input to this MATMOD
option:
FILE GEOM2=APPEND $
IFPINDX /GEOM2 $
MATMOD GEOM2,CASECC,,,,/GEOM2R,/37/
ELEMSET/GRIDSET/S,N,NOGEOM2 $
2. It is recommend that GEOM2 be converted by the SECONVRT module and then used as input to
MATMOD.
Option P1 = 38
Reduce the records in the EST table to the entries corresponding to element numbers specified in a Case
Control set.
Main Index
MATMOD 1077
Matrix modification
Format:
MATMOD EST,CASECC,,,,/ESTR,/38/
ELEMSET/GRIDSET/S,N,NOEST $
EST Table of Bulk Data entry images related to geometry and indexed by
the IFPINDX module.
CASECC Table of Case Control command selections.
Parameters:
ELEMSET Input-integer. SET Case Control command identification number that contains a
list element point identification numbers.
GRIDSET Input-integer. SET Case Control command identification number which contains
a list grid point identification numbers.
NOEST Output-integer. Processing status flag.
+1 No element found in EST matching the contents of ELEMSET.
0 Some elements in EST were found in ELEMSET.
-1 All elements and SPOINTs in EST were found in ELEMSET.
Remarks:
1. EST must be indexed with IFPINDX module before being used as input to this MATMOD option:
FILE EST=APPEND $
IFPINDX /EST $
MATMOD EST,CASECC,,,,/ESTR,/38/
ELEMSET/GRIDSET/S,N,NOEST $
Option P1 = 39
Remove and identify explicit zero terms in a matrix.
Format:
MATMOD I1,,,,,/O1,O2/39/S,N,NOXPLZER $
Main Index
1078 MATMOD
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
MATMOD 1079
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.
Main Index
1080 MATMOD
Matrix modification
Option P1 = 42
Permute a sparse square matrix.
Format:
MATMOD GRDRM,I1,,,,/O1,/42 $
O1 Permuted matrix.
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.
Main Index
MATMOD 1081
Matrix modification
Option P1 = 45
Permute matrix according to a row permutation.
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:
Main Index
1082 MATMOD
Matrix modification
Example:
Option P1 = 47
Perform null row search on a matrix.
Format:
MATMOD I1,,,,,/O1,/47///P4 $
I1 Any matrix.
O1 Column vector which has 1.0 at those rows where I1 has null rows if
P4 > 0 or non-null if P4 < 0. If I1 is purged, then O1 is purged. If I1 is
null, then O1 will be full.
Parameter:
Option P1 = 52
Convert frequency response displacement vectors to velocity or acceleration vectors.
Format:
Main Index
MATMOD 1083
Matrix modification
Parameter:
Remarks:
1. Velocity vectors are computed by multiplying each term of a column of I1with corresponding i .
2. Acceleration vectors are computed by multiplying each term of a column of I1with corresponding
2
–
Main Index
1084 MATOFP
Prints matrix similar to DISPLACEMENT output
Prints a matrix in the format similar to DISPLACEMENT output with a user-defined column label and
page header.
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
Main Index
MATOFP 1085
Prints matrix similar to DISPLACEMENT output
Parameters:
0: print
<>0: do not print
LCOLLBLi Input-character-default=(depends on APP). Label with up to 32 characters to be
printed left-justified in upper left corner of each page. The default values
depends on APP:
APP LCOLLBLi
'TRANRESP' TIME
'FREQRESP' FREQUENCY
'REIGEN' FREQUENCY
'CEIGEN' FREQUENCY
'USERLIST' LABEL
RCOLLBLi Input-character-default='COLUMN' (followed by column number). Label with
up to 32 characters to be printed right-justified in upper right corner of each page.
COLLBLi is then followed by column number.
HDRLBLi Input-character-default='MATRIX' (followed by matrix name). Header with up
to 64 characters to be printed and centered at the top of of each page.
Main Index
1086 MATOFP
Prints matrix similar to DISPLACEMENT output
Examples:
Example 1:
MATOFP GCF,BGPDT,,USET/ $
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 ’/’)’ $
Main Index
MATOFP 1087
Prints matrix similar to DISPLACEMENT output
Main Index
1088 MATPCH
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.
4. If Ni is specified, then Ni must be different for each corresponding input matrix. Also, the
maximum number of records that may be punched is 99999. If full square matrices are considered,
a maximum order of 629 is allowed. If matrices larger than this are desired, use the OUTPUT2 or
OUTPUT4 modules to produce a FORTRAN readable file.
Main Index
MATPCH 1089
Punches contents of matrix data blocks
5. Only sufficiently small nonpurged data blocks will be punched onto DMI Bulk Data entries.
Example:
Let the data block MAT contain the matrix
1 2 3 4 5 6 7 8 9 10
DMI MAT 0 2 1 2 5 6
DMI MAT 1 1 1.000000E 00
* 3 2.000000E 00 5 3.000000E 00
DMI* MAT 2 3 4.000000E 00
* 5.000000E 00
DMI* MAT 3 1 6.000000E 00
* 7.000000E 00 5 8.000000E 00
DMI* MAT 6 4 9.000000E 00
Main Index
1090 MATPRN
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 PRTFORM is set to 'LONG' (see Example 3), most of the digits of the internal representations
will be printed. Normally, the output is truncated to five or six digits.
6. For large, sparse matrices with scattered terms, the user is advised to use either the MATPRT or
MATGPR modules.
Examples:
1. MATPRN KGG/$
2. MATPRN KGG,PL,PG,BGG,UPV//$
3. MATPRN KGG //'LONG' $
Main Index
MATPRT 1091
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
1092 MATREDU
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:
Main Index
MATREDU 1093
Reduces square matrix from g-set to a-set or p-set to d-set
Parameters:
Method:
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
2. Eliminate single point constraints
B ff B fs
B nn
B sf B ss
B aa B ao
B ff
B oa B oo
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.
Main Index
1094 MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set
Main Index
MCE1 1095
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
for the transformation matrix G mn .
Main Index
1096 MCE2
Performs multipoint constraint elimination and reduction
Performs multipoint constraint elimination and reduction on up to four g-set size square matrices.
MCE2 USET,GM,XGG1,XGG2,XGG3,XGG4/
XNN1,XNN2,XNN3,XNN4 $
MCE2 USETD,GMD,XPP1,XPP2,XPP3,XPP4/
XNENE1,XNENE2,XNENE3,XNENE4/NOUE $
Parameters:
NOUE Input-integer-default=-1. The number of extra points. Set to -1 if there are no extra
points. USETD and GMD must be supplied if NOUE>0.
Method:
The MCE2 module partitions the stiffness matrix
Main Index
MCE2 1097
Performs multipoint constraint elimination and reduction
K nn K nm
K gg = (5-74)
K mn K mm
T T
K nn = G mn K mm G mn + K mn + K mn G mn + K nn (5-75)
Remark:
Any or all of XGGi and XNNi may be purged. However, if any of XGGi is specified then the
corresponding XNNi must also be specified.
Example:
Reduce K gg to K nn .
Main Index
1098 MCFRAC
Compute, sort and print modal contribution fractions
Format:
MCFRAC CASECC,LAMA,OL,BGPDT,RPH,UH,PVMCFR,MODSELT/
OMCF1,UNUSED/
APP/FMODE $
Parameters:
Main Index
MCFRAC 1099
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
1100 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:
Method:
1. Calculate the accelerations. This depends on the approach.
Main Index
MDATA 1101
Computes pressures for selected elements associated with virtual fluid mass
Type of
APP
Arithmetic
ua
2 2
REIG Real U a = – u a from LAMA
2
CEIG Complex U a = p u d from CLAMA
2
FREQ Complex U a = – u d from FOL
TRAN Real U a = the 3rd, 6th, 9th, etc., columns of UDVT
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
1102 MDCASE
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
MDCASE 1103
Partitions the Case Control table
Parameters:
Main Index
1104 MDCASE
Partitions the Case Control table
Main Index
MDCASE 1105
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
1106 MDENZO
MDACMS matrix utility
Matrix utility for matrix domain automatic component mode synthesis (MDACMS).
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
MDENZO 1107
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
1108 MDENZO
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 $
Main Index
MDENZO 1109
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
1110 MDENZO
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
MDISUTIL 1111
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,DBOU
T7,
DBOUT8,DBOUT9,DBOUT10,DBOUT11,DBOUT12,DBOUT13,
DBOUT14,DBOUT15/
SENDID/NUMDB/RECVCODE $
DBi Any data block to be broadcast from the master to the slave processors.
Parameters:
Remarks:
MDISUTIL calls option 10 of the DISUTIL module.
Main Index
1112 MERGE
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.
A A11 A12
A21 A22
Main Index
MERGE 1113
Matrix merge
Main Index
1114 MERGE
Matrix merge
MERGE A11,A21,A12,A22,CP,/A $
Form of [A22]
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.
Main Index
MERGE 1115
Matrix merge
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
Then, the DMAP instruction
MERGE A11,A21,A12,A22,CP,RP/A/1 $
will create the real matrix:
Main Index
1116 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 1117
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
1118 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 MSC Nastran output file
(FORTRAN Unit 6). To have the print also appear in the Performance Summary Table
(FORTRAN Unit 4 or dayfile), DIAG 53 must be turned on by the DIAG Executive Control
Statement.
5. T1 and T2 may be purged.
6. T2 must be declared APPEND on the FILE statement if more than one MESSAGE execution is
used to write into this table.
Example:
1. Print a user information message:
MESSAGE //’USER DMAP MSG’/10/’ERROR IN ITER. NO.’/COUNT $
2. Create a table of two messages and then print:
FILE TEST=APPEND $
maxint = 776705406 $
Main Index
MESSAGE 1119
Prints messages
offset = 150704034 $
message /test/' maxint ='/maxint /' offset ='/offset $
lstart = maxint - offset $
incr = offset / 39 $
message /test/' starting column ='/lstart /' incr ='/incr $
message test/ $
The following will appear in the f06 file:
^^^ MAXINT = 776705406 OFFSET = 150704034
^^^ STARTING COLUMN = 626001372 INCR = 3864206
Main Index
1120 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
MGEN 1121
Creates virtual fluid mass matrices
Main Index
1122 MKCNTRL
Assembles a description of aerodynamic controllers sets
Format:
MKCNTRL EDT,CSTMA,AEBGPDT/
AECTRL,TRX,AECSTMHG/
SYMXZ/AUNITS $
Parameters:
Remarks:
None.
Main Index
MKCSTMA 1123
Merge coordinate system tables; usually tables from structural and aerodynamic models.
Merge coordinate system tables; usually tables from structural and aerodynamic models.
Format:
MKCSTMA CSTM1,CSTM2/CSTMM $
Parameters:
None.
Main Index
1124 MKMNTIFP
Updates geometry, connectivity, and properties
Updates geometry, connectivity, and property tables to form frames to track monitor points.
Format:
MKMNTIFP BGPDT,CSTM,MONITOR,ECT,EPT,MPT/
GEOM1X,GEOM2X,EPTX,MPTX/
YOUNGM $
Parameters:
Main Index
MKRBVEC 1125
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
1126 MKRBVEC
Computes load summation about a given point
Main Index
MKSPLINE 1127
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,ACOMP,SCOMP,BGPDT,
ABGPDT/SPLINE/AEROEXT $
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with
external grid identification numbers.
Parameters:
Main Index
1128 MKSPLINE
Generates splines to interpolated results from structural to aero model
Example:
Excerpt from subDMAP PHASE0.
DBVIEW AEGRID=BGPDTS WHERE (MODLTYPE='AEROMESH' AND WILDCARD) $
MKSPLINE EDT,CSTMA,AEGRID,AECOMP/SPLINE $
Main Index
MODACC 1129
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
1130 MODACC
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
MODCASE 1131
Processes POST command for f06 redirection
Process Case Control records for output data recovery and redirect output to user-specified Fortran files
instead of the f06.
MODCASE CASECC,/POSTCC/1//S,N,NUNIQF06 $
MODCASE CASECC,POSTCC0/CASECCP/
2/F6CNTR//S,N,F6UNIT/S,N,F6SUFFIX $
Parameters:
Main Index
1132 MODENRGY
Computes modal energies
Computes modal strain and kinetic energies in frequency and transient response analysis.
Format:
MODENRGY CASECC,OL,UH,KHH,MHH,MODSELT/
TSNRGY,TKNRGY,MODSELT1,OL1,MSNRGY,MKNRGY/
APP/FMODE/UNUSED $
Main Index
MODENRGY 1133
Computes modal energies
Parameters:
Main Index
1134 MODEPF
Computes fluid-structure mode participation factors
Computes mode participation factors for fluid-structure models in frequency response analysis.
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
MODEPF 1135
Computes fluid-structure mode participation factors
Parameters:
Main Index
1136 MODEPF
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
MODEPOUT 1137
Filter, sort, and printout mode participation factor matrice
Filter, sort, and printout mode participation factor matrices. Also create table data blocks suitable for XY
plots and power spectral density calculations.
Format:
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
1138 MODEPOUT
Filter, sort, and printout mode participation factor matrice
Parameters:
Main Index
MODEPOUT 1139
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
1140 MODEPT
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
MODGDN 1141
Updates geometry table for existence of p-elements and superelements
Updates the geometry table for the existence of p-elements and superelements.
Format:
MODGDNv 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
1142 MODGM2
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
MODGM2 1143
Create table entries for PLPLANE and PLSOLID Bulk Data
Parameter:
Main Index
1144 MODGM2
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:
GEOM2X Record
GEOM2
Record Fluid Hyperelastic
CQUAD4 n/a QUAD4FD
CQUAD8 n/a QUAD8FD
CTRIA3 n/a TRIA3FD
CTRIA6 n/a TRIA3FD
CQUAD n/a QUADFD
CTRIAX n/a TRIAXFD
CQUADX n/a QUADXFD
CHEXA HEXPR HEXAFD
Main Index
MODGM2 1145
Create table entries for PLPLANE and PLSOLID Bulk Data
GEOM2X Record
GEOM2
Record Fluid Hyperelastic
CPENTA PENPR PENTAFD
CTETRA TETPR TETRAFD
Example:
See the example in the IFP module description.
Main Index
1146 MODGM4
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
MODGM4 1147
Reads SPCs and SPCDs and generates unique SPC and SPCD records
Main Index
1148 MODQSET
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
Augments GEOM1, GEOM2 and GEOM4 records with q-set degrees-of-freedom definition to account
for the component modes computed for all superelements.
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
MODQSET 1149
Augments GEOM1, GEOM2 and GEOM4 with q-set definitions
Main Index
1150 MODTRK
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 $
Main Index
MODTRK 1151
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
1152 MODTRL
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
MODTRL 1153
Modify trailer
Examples:
1. To make KAA symmetric (form=6) (MPYAD will label it square (form=1)):
MPYAD GO,KOA,KAAB/KAA/1 $
MODTRL KAA////6/ $
2. In order to change the precision of a matrix, use ADD5. If the new precision does not match the
machine precision specify PUTSYS (newprecision,55) before ADD5. For example, on a double-
word machine:
• Single to double
$'' 6,1*/( '28%/(
• Double to single
3876<6
$'' '28%/( 6,1*/(
3876<6
3. In order to change the type (complex or real) of a matrix, use ADD to convert real to complex and
MATMOD(34) for complex to real. For example,
• Real to complex
$'' 5($/ &03/;
• Complex to real
0$702' &03/; 5($/
Main Index
1154 MODUG
Modifies UG vector to incorporate displacements of piercing points for connector elements
Computes displacements of piercing points for connector elements and incorporates them into the
modified UG vector.
Format:
MODUG UG,BGPDT,EST,CSTM,GPECT,USET,CASECC/
OUG/S,N,MDUG $
UG Displacement vector.
BGPDT Basic grid point definition table.
EST Element summary table.
CSTM Coordinate system transformation table.
GPECT Grid point element connection table.
USET Set definition table.
CASECC Case control command table.
Parameters:
Main Index
MODUSET 1155
Modifies the degree-of-freedom set membership table (USET)
Format:
MODUSET EDITVEC,USET/
USETM/
USETOP/MAJOR/SET0/SET1/USETADD/UNUSED6/UNUSED7
$
Main Index
1156 MODUSET
Modifies the degree-of-freedom set membership table (USET)
Parameters:
USETOP Operation
UNION Combine SET0 and SET1 into MAJOR.
COMP0 Form SET0 from compelement of MAJOR and SET1.
COMP1 Form SET1 from compelement of MAJOR and SET0.
DELETE Remove degrees-of-freedom from MAJOR.
TURNON Add degrees-of-freedom from MAJOR.
COPY Copy degrees-of-freedom from SET0 to MAJOR.
EXPAND Extend uset length by USETADD.
MOVE Move SET0 degrees-of-freedom to MAJOR.
FILTER Remove degrees-of-freedom from USET that correspond to zero rows
in EDITVEC.
NEWMSET Rewrite the m-set according to partition vector EDITVEC. USETADD
is the new m-set size.
REPLACE Replace degrees-of-freedom set of MAJOR by SET0 corresponding to
1.0 rows in EDITVEC.
Remark:
1. EDITVEC may be purged if USETOP FILTER and USETOP NEWMSET and
USETOP REPLACE .
Main Index
MODUSET 1157
Modifies the degree-of-freedom set membership table (USET)
Examples:
1. Scalar degrees-of-freedom 1 through 5 will be defined in the u1-set and u3-set and scalar degrees-
of-freedom 6 through 10 in the u2-set and u3-set.
SOL ...
COMPILE ...
ALTER ...
MODUSET ,,USET/USET1 $
CEND
BEGIN BULK
SPOINT,1,THRU,10
USET1,U1,0,1,THRU,5
USET1,U3,0,6,THRU,10
2. The u1-set will be empty. The u2-set will contain the a-set and the u3-set will contain the f-set.
MODUSET ,,USET/VSET/'COMP0'/'F' /'U1'/'A' $
MODUSET ,,VSET/WSET/'COMP1'/'F' / /'U2' $
MODUSET ,,WSET/XSET/'UNION'/'U3'/'U1'/'U2' $
3. The following alter puts all degrees-of-freedom automatically constrained by GPSP into the sg-
set.
COMPILE SEKR0
ALTER 'GPSP'(,-1) $ BEFORE GPSP
$ MOVE DOF IN SET SB INTO SET U3
MODUSET, ,USET0/VSET/'MOVE'/'U3'/'SB'/ $
EQUIVX VSET/USET0/ALWAYS $
MESSAGE //'SB SET SHOULD NOW BE EMPTY - CHECK BELOW'/ $
TABPRT USET0,EQEXINS//'USET'/11
ALTER 'GPSP' $ AFTER GPSP
MESSAGE //'SB SET SHOULD NOW BE ONLY AUTOSPC DOF - CHECK BELOW'/
$
TABPRT USET,EQEXINS//'USET'/11
$ MOVE CURRENT SB (ALL FROM AUTOSPC) INTO SG
MODUSET, ,USET/VSET1/'MOVE'/'SG'/'SB'/ $
MESSAGE //'SB SET SHOULD NOW BE EMPTY,SG SHOULD BE PS + AUTOSPC'/
$
TABPRT VSET1,EQEXINS//'USET'/11
$ NOW MOVE SET U3 BACK INTO SB
MODUSET, ,VSET1/VSET2/'MOVE'/'SB'/'U3'/ $
EQUIVX VSET2/USET/ALWAYS $
MESSAGE //'SB SET SHOULD NOW BE ONLY SPC DOF'/
' SG SHOULD BE PS + AUTOSPC'/ $
TABPRT USET,EQEXINS//'USET'/11 $
Main Index
1158 MONVEC
Forms monitor point rigid body vectors
Format:
MONVEC AEROCOMP ,
AEMONPT ,
AEBGPDT , CSTMA /
MONITOR STRUCOMP
SRKS $
Parameters:
None.
Main Index
MONVEC3 1159
Process type 3 monitor points
Format:
MONVEC3 MP3LAB,STRUCOMP,BGPDT,CSTM,KDICT/
KDICT3*,MN3VEC* $
Parameters:
None.
Main Index
1160 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 1161
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
1162 MPPTRAN
Prints monitor point data for frequency response aeroelasticity
Format:
MPPTRAN CASECC,MPDB,OL,MAT1,MAT2,MAT3,MAT4//MATTYPE/MO
NTYPE $
Parameters:
Main Index
MPPTRAN 1163
Prints monitor point data for frequency response aeroelasticity
Remarks:
None.
Main Index
1164 MPYAD
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
T = 2, perform A B where A is the complex conjugate of A.
Only meaningful when A is complex.
T
T = 3, perform A B where A is the complex conjugate of A.
Only meaningful when A is complex.
SIGNAB Integer-input-default = 1. Sign of product flag.
SIGNAB = +1, perform A B
Main Index
MPYAD 1165
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
1166 MPYAD
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.
• For methods 2, 3, and 4, a combination of methods is selected by subtracting the sum of their
Deselection Values from 255. For example, NASTRAN MPYAD = 243 (which is obtained from
255-(4+8)) selects only Methods 2 Transpose and Nontranspose.
Main Index
MPYAD 1167
Matrix multiply and add
8. As an alternative to the deselection procedure described above, the MPYAD keyword value may
be set to select a single method while deselecting all other methods and submethods. To select a
single method, add 1048576 to the selection value of the desired method shown in the table below.
For example, if Method 1 Nontranspose Storage Submethod C is desired, then MPYAD =
1048586; computed from 1048576 + 10.
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
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
1168 MPYAD
Matrix multiply and add
If a Storage Submethod under Method 1 is selected in this manner, then a printout of timing
estimates for the other submethods may be requested by adding 3145728 to the selection value
above. Using the previous example, MPYAD = 3145738, computed from 3145728 + 10.
9. Sparse methods are deselected or selected by the SPARSE keyword (or SYSTEM(126)) on the
NASTRAN statement. The default SPARSE = 1 causes the automatic selection of sparse methods
if their CPU and I/O estimates are lower than those estimated for the methods in Remark 7. If the
sparse method is not desired, then specify SPARSE = 0 or 6.
• In order to select or force one or both methods below, then add l to its value(s) below.
Note that if SPARSE = 2, 3, 4, 5, or 7, then all methods in Remark 2 are turned off or deselected,
and the MPYAD keyword must be equal to zero.
• The SPARSE keyword is also used for sparse method selection within all modules which
perform matrix decomposition and forward-backward substitution; e.g., DCMP, DECOMP, FBS,
and SOLVE.
10. The diagonal matrix format (FORM = 3) for input matrices is not supported for the transpose
option (T = 1), and will cause an “ILLEGAL INPUT” fatal message. [A] can be transposed with
the TRNSP module.
11. Parallel processing in this module (Methods 1 Nontranspose Storage E and Transpose Storage C
only) is selected with the NASTRAN statement keyword PARALLEL (or SYSTEM(107)) which
is set to the number of parallel processors (default = 0). To force parallel processing, the MPYAD
keyword must be set to one of the following values:
Examples:
1. X = AB + C
Main Index
MPYAD 1169
Matrix multiply and add
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
1170 MRGCOMP
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
MRGCSTM 1171
Merges families of coordinate system defintion tables (CSTM)
Format:
MRGCSTM CSTM1*,CSTM2*,CSTM3*,CSTM4*,CSTM5*/
CSTMX/S,N,NOCSTMX $
Parameter:
Remark:
None.
Main Index
1172 MRGMON
Merges two monitor point tables
Merges two monitor point tables and optionally output their associated matrices.
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
MSGHAN 1173
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
1174 MSGSTRES
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
MTRXIN 1175
Converts DMIG entries to matrices
Converts matrices input on DMIG Bulk Data entries to matrix data blocks.
Format:
Form 1 -- Simplified (CASECC is purged).
EQEXIN
MTRXIN ,,MATPOOL, ,,/
EQDYN
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).
MTRXIN EQEXIN
CASECC,MATPOOL, ,, /
EQDYN TFPOOL
K2GG,M2GG,B2GG
,K42GG,A2GG /
K2PP,M2PP,B2PP
LUSET
/S,N,NOK2/S,N,NOM2/S,N,NOB2/S,N,NOK4
LUSETD
2/
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 $
Main Index
1176 MTRXIN
Converts DMIG entries to matrices
Form 4 -- Selection of DMIK, DMIJ and DMIJI by data block names MATKi, MATJi, and MATJIi.
AEBGPDTK
MTRXIN ,,MATPOOL, AEBGPDTJ ,, /
AEBGPDTI
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
MATP1 MATP2
MATP3 MATP4 MATP5
MATG1 , MATG2 ,
MATG3 , MATG4 , MATG5 /
RMATG
LUSETD
LUSET /S,N,NOMAT1/S,N,NOMAT2/S,N,NOMAT3/
10
LUSET
S,N,NOMAT4/S,N,NOMAT5/ 11 /
12
MATNAM1/MATNAM2/MATNAM3/MATNAM4/MATNAM5/
TFLID
NFEXIT/MATID1/MATID2/MATID3/MATID4/M
ATID5 $
Main Index
MTRXIN 1177
Converts DMIG entries to matrices
Form 6 -- Selection of DMIK, DMIJ, and DMIJI matrices by the MATNAMi input parameter values
(IOPT=13 through 15).
AEBGPDTK
MTRXIN ,,MATPOOL, AEBGPDTJ ,,/
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
1178 MTRXIN
Converts DMIG entries to matrices
MATPi Matrices defined on DMIG Bulk Data entries and intended for the
p-set.
MATGi Matrices defined on DMIG Bulk Data entries and intended for the g-
set.
RMATG Rectangular matrix defined on DMIG Bulk Data entries and may have
an arbitrary number of columns but g-set rows, similar to P2G.
MATKi Matrices defined on DMIK Bulk Data entries.
MATJi Matrices defined on DMIJ Bulk Data entries.
MATIi Matrices defined on DMIJI Bulk Data entries.
Parameters:
Main Index
MTRXIN 1179
Converts DMIG entries to matrices
Remarks:
1. Any output data block may be purged.
2. Form 1 is used to input matrices from DMIG entries named in the DMAP statement output
section. No Case Control commands are required.
3. Forms 2 and 3 are used to select the matrices with Case Control commands: K2GG, M2GG,
B2GG, K2PP, M2PP, B2PP, or P2G. “-2GG” matrices are of dimension g by g. “-2PP” matrices
are of dimension p by p. The P2G matrix has g-rows, with the number of columns determined by
the several methods used to input rectangular matrices described on the DMIG entry.
4. If the output data blocks are specified on a CALL statement and the DMIIN module is specified
in the subDMAP referenced by the CALL statement, then the data block name specified on the
CALL statement must be the same as the name specified on the DMIIN module.
Examples:
1. Assume the Bulk Data contains two DMIG matrices, named M1 and M2, which reference grid
and/or scalar points only. The following set of DMAP instructions will generate these two
matrices in matrix format, multiply them together and print the result.
MTRXIN ,,MATPOOL,EQEXIN,,/Ml,M2,/LUSET/S,N,NOMl/S,N,NOM2$
IF (NOM1 > -1 AND NOM2 > -1) THEN $
MPYAD M1,M2,/PRODUCT $
MATPRN PRODUCT//$
ENDIF $
2. Assume the Bulk Data contains two DMIG matrices, MASS and STIFF, which reference grid
and/or scalar points only. The following Case Control and DMAP instructions will generate these
two matrices in matrix format and add them to the structural mass and stiffness.
Case Control:
M2GG = MASS
K2GG = STIFF
DMAP instructions:
MTRXIN CASECC,MATPOOL,EQEXIN,,/STIFF,MASS,/
LUSET/S,N,NOSTIFF/S,N,NOMASS//1 $
IF (NOSTIFF > -1) THEN $
Main Index
1180 MTRXIN
Converts DMIG entries to matrices
ADD KGG,STIFF/KGGNEW $
EQUIVX KGGNEW/KGG/ALWAYS $
ENDIF $
IF (NOMASS > -1) THEN $
ADD MGG,MASS/MGGNEW $
EQUIVX MGGNEW/MGG/ALWAYS $
ENDIF
Main Index
NASSETS 1181
Combines all element sets for MSGMESH, and sets defined on SET1
NASSETS Combines all element sets for MSGMESH, and sets defined
on SET1
Combines all element sets defined in Case Control, including OUTPUT(PLOT) sections, for
MSGMESH, and sets defined on SET1 Bulk Data entries.
Format:
NASSETS CASECC,ELSET,EDT/
SET/
MESHSET $
Parameter:
Main Index
1182 NDINTERP
Nonlinear interpolator
Nonlinear interpolator.
Format:
NDINTERP CONTVXV,CONTVX/
IFACT,CONTDIF/
NSUPD/MINNUSE/MAXNUSE/STOL $
Parameters:
Main Index
NEWUSET 1183
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
1184 NLCOMB
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/T
STATIC/ $
Main Index
NLCOMB 1185
Consolidates tables related to nonlinear elements and applied loads
Parameters:
Main Index
1186 NLHARM
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/UNUS
ED7 $
Parameters:
Main Index
NLHARM 1187
Computes forces and derivatives of forces in Fourier space
Main Index
1188 NLICLOOP
Prepares data for the NLIC run in SOL 400
Format:
NLICLOOP CASECC,NLRSMP//STPPRV/S,N,ICLOOP $
Parameters:
Main Index
NLITER 1189
Computes nonlinear analysis solution matrices and tables
Computes nonlinear analysis solution matrices and tables. Applicable to static structural or steady state
heat transfer analysis.
Format:
Main Index
1190 NLITER
Computes nonlinear analysis solution matrices and tables
Main Index
NLITER 1191
Computes nonlinear analysis solution matrices and tables
Parameters:
LOADFAC Input/output-complex-no default. Load factor. The real part is the load factor
for the current iteration, having a fractional value between 0 and 1.
CONV Input/output-integer-default=0. Nonlinear analysis convergence flag.
On input:
0 Initialization.
On output:
-1 Convergence has not been achieved.
1 Convergence has been achieved.
RSTEP Input/output-integer-default=0. Controlled increments counter.
NEWP Input/output-integer-default=1. New subcase flag.
-1 Current subcase has not been completed.
1 Current subcase has been completed.
NEWK Output-integer-default=1. Stiffness update flag.
-1 Do not update stiffness.
1 Update stiffness.
2 Update stiffness, the solution is diverging and MAXBIS has been reached.
POUTF Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate
output is not requested.
Main Index
1192 NLITER
Computes nonlinear analysis solution matrices and tables
Main Index
NLITER 1193
Computes nonlinear analysis solution matrices and tables
Main Index
1194 NLITER
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.
2. KGGNL is needed for the reduced incomplete Cholesky factorization in the iterative solver only.
Otherwise it may be purged.
3. MGG, RDEST, RECM are only required for heat transfer analysis. Otherwise they may be
purged.
4. ULLT is required only for unsymmetric stiffness. Otherwise it may be purged.
5. TABS is required for creep analysis.
6. KFLAG is further explained below:
-1 Solution had converged, but no stiffness update had been made or solution had
not converged, and a stiffness matrix update had been made. A new stiffness
matrix is required before starting bisection.
1 Solution had converged and a stiffness update had been made. No new stiffness
matrix is required before starting bisection.
Main Index
NLRSLOOP 1195
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
1196 NLRSLOOP
Prepare data for nonlinear restarts.
Main Index
NLRSMAP 1197
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
1198 NLSOLV
Solves nonlinear static and transient response
Solves nonlinear static and transient response with an adaptive time increment for a given iteration.
Format:
Main Index
NLSOLV 1199
Solves nonlinear static and transient response
Main Index
1200 NLSOLV
Solves nonlinear static and transient response
Main Index
NLSOLV 1201
Solves nonlinear static and transient response
UPNT Solution matrix from nonlinear analysis appended from each output
time step (for transient analysis only).
FMVT Nonlinear element forces at m-set appended from each output time
step (for transient analysis only).
ESTNL0 Nonlinear element summary table from previous time step.
MESTNL0 Initial nonlinear element summary table at each STEPcase.
UPNL0 Initial solution matrix from nonlinear analysis at each STEPcase.
FENL1 Matrix of strain energy and grid point force at every element at the last
converged load step
Main Index
1202 NLSOLV
Solves nonlinear static and transient response
Parameters:
Main Index
NLSOLV 1203
Solves nonlinear static and transient response
LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update
at:
> Previous converged solution.
< At an intermediate iteration of the current time step.
=1 At the last iteration.
NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to
terminate.
NBIS Input/output-integer-default=0. Current bisection counter.
MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration
and the material subincrement processes.
TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and
damping forces.
LANGLE Input-integer-default=1. Large rotation calculation method:
1 Gimbal angle.
2 Left rotation vector.
3 Right rotation vector.
NDAMP Input-real-default=0.0. Numerical damping.
TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to
273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.
SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant
heat flux.
NORADMAT Input-integer-default=0. Radiation flag.
-2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
ADPCON Input-real-default=1.0. Contact penalty value. Scale factor for adjusting penalty
values on restart. Update penalty values if positive.
PBCONT Input-integer-default=0. Slideline contact flag.
NBCONT Input/output-integer-default=0. Number of bisections due to slideline contact.
CONT3D Input-integer-default=-1. 3D contact flag.
<0 No.
>-0 Yes.
MNEWK Input/output-integer-default=1. Matrix update flag for 3D contact.
Main Index
1204 NLSOLV
Solves nonlinear static and transient response
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
Main Index
NLTRD 1205
Computes transient nonlinear analysis solution matrices and tables
Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural
analysis only.
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,ITER
ID/
S,N,MU/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/
S,N,NOTIME/MAXLP/UNUSED17/UNUSE18/UNUSE19/
TABS/LANGLE $
Main Index
1206 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 1207
Computes transient nonlinear analysis solution matrices and tables
Main Index
1208 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 1209
Computes transient nonlinear analysis solution matrices and tables
Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural or
transient heat transfer analysis.
Format:
NLTRD2 CASECC,PDT,YS,ELDATA,KELMNL,
KDD,GM,MPT,DIT,KBDD,
DLT1,CSTM,BGPDT,SIL,USETD,
BRDD,MDD,NLFT,RDEST,RECM,
BDD,GPSNT,DITID,DEQIND,DEQATN,
ROTORT,BGDD*,KCVDD*,TMLD,UNUSED1,UNUSED2,RDG,P
SFL/ ULNT,IFS,ESTNLH,IFD,OESNL1,
PNL,TEL,MULNT,MESTNL,BTOPCNV,
BTOPSTF,OESNLB1,MPTTC,LTF,UTF/
KRATIO/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/
S,N,OLDDT/S,N,NSTEP/LGDISP
/S,N,CONSEC/S,N,ITERID/
ITIME/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/S,N,NBI
S/ MAXLP/TSTATIC/LANGLE/NDAMP/TABS/
SIGMA/NORADMAT/S,N,ADPCON/PBCONT/
S,N,NBCONT/FKSYMFAC/WTMASS/NOUDCMP $
Main Index
1210 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.
OESNL1 Table of nonlinear element stresses in SORT1 format.
PNL Nonlinear load matrix appended from each output time step.
TEL Transient response time output list appended from each subcase.
MULNT Solution matrix from nonlinear transient response analysis in the d-set
from the previous subcase.
Main Index
NLTRD2 1211
Computes transient nonlinear analysis solution matrices and tables
Parameters:
Main Index
1212 NLTRD2
Computes transient nonlinear analysis solution matrices and tables
Main Index
NLTRD2 1213
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
1214 NLTRLG
Produces time independent load vector
Format:
NLTRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,GM
D,GOD,
PHDH,EST,MPT,APPLOD,ENFLODK,ENFLODB,ENFLODM,EN
FMOTN/
PDT,TMLD,DLT1/TABS $
Main Index
NLTRLG 1215
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
1216 NORM
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
NORM 1217
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
T
CPHG 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
1218 NSMEPT
Modifies element properties
Modifies element properties table from the NSML and NSML1 records.
Format:
NSMEPT ECT,EPT,BGPDT/NEWEPT/S,N,NEWEPT $
Parameters:
Main Index
OFP 1219
Output file processor
To output (print or punch) data blocks prepared by other modules in user-oriented, self-explanatory
formats.
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.
Main Index
1220 OFP
Output file processor
Parameters:
Remarks:
1. Any or all data blocks may be purged.
2. DMAP modules READ (LAMA, OEIGS, LAMX, CLAMX), CEAD (CLAMA and OCEIGS),
and LAMX (LAMB) are matrix operation modules that prepare OFP formatted data blocks.
Modules SDR2, SDR3, VDR, ADR, CURV, DDRMM, DRMH3, ELFDR, GPFDR, GPWG,
LAMX, MDATA, SDRCOMP, SDRX, and SDRHT also prepare OFP formatted data blocks.
3. Parameter ODCODE is not honored by data blocks LAMA, OEIGS, LAMX, CLAMA, and
OGPWG, which are created by READ, CEAD, LAMX, and GPWG.
4. CSTM, EHT, BGPDTVU, and ERROR1 are required if p-elements are specified and only for data
recovery; i.e., displacement, stress, strain, etc.
Main Index
OFP 1221
Output file processor
5. CSTM, DEQATN, DEQIND, and DIT are required if the CORD3G Bulk Data entry is present
and only for element data recovery; i.e., displacement, stress, strain, etc.
Example:
Print the OUG1 table from the SDR2 module:
OFP OUG1/ $
Main Index
1222 OPTGP0
p-element analysis preprocessor
Preprocesses the input design optimization shape basis vectors for p-element analysis.
Format:
OPTGP0 GEOM1M,GEOM2M,MEDGE,EDOM,UNUSED5,UNUSED6,UNUSE
D7,
DEQATN,DEQIND/
EDOMM/
DELG $
GEOM1M Table of Bulk Data entry images related to geometry and updated for
the current p-level.
GEOM2M Table of Bulk Data entry images related to element connectivity and
scalar points and updated for the current p-level.
MEDGE Edge table for p-element analysis.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization.
UNUSED5 Unused and may be purged.
UNUSED6 Unused and may be purged.
UNUSED7 Unused and may be purged.
DEQATN Table of DEQATN Bulk Data entry images.
DEQIND Index table to DEQATN data block.
Parameter:
Main Index
OPTGP0 1223
p-element analysis preprocessor
Remark:
OPTGP0 preprocesses the shape basis vectors defined at the p-element geometry level for both the
GMCURV or POINT option and generates DVGRID entry images at the grid-n points (a point on an
FEEDGE, FEFACE or FEBODY entity with variable number of degrees-of-freedom).
Main Index
1224 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 1225
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
T
and if M ] is not given: Q M Q = I
T
or if M is not given: Q Q = I
where I is an identity matrix.
2. ORTHOG cannot orthogonalize complex matrices. If a complex matrix is input then a fatal
message is issued. SubDMAP ONORM can orthogonalize complex matrices which is described
under "General Enhancements for Orthogonalizing Complex Vectors" on page 149 of the
MSC.Nastran 2004 Release Guide.
Main Index
1226 OUTADF
Output Frequency Response Result to ADF Format File
Output the frequency response functions and participation factors to ADF format file.
Format:
OUTADF OFP1,OFP2,OFP3,OFP4,OFP5,UNITS,BGPDT,CASECC//IPRINT $
None
Parameters:
Remarks:
1. This module support the output table block of OUGx, OSMPF1, OAFMPF1, OASMPF1,
OAPMPF1, OAPPF1, OAGPF1 and OSPPF1 (TCODE=1, 10, 11 and 61 to 67).
2. OFPi may be purged.
3. If CASECC is purged, all supported result data in OFPi will output.
4. See the parameter POSTADF for the other information.
Main Index
OUTPRT 1227
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/ADPTE
XIT $
Main Index
1228 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors
Parameters:
NOSE Input-integer-default=0.
Set to -1 if there are no superelements; 0 otherwise. Superelement presence
flag.
SDROVR Input-character-default='AUTO'. Override for data recovery method flag,
SDR:
AUTO Choose full or sparse data recovery based on SDRDENS.
FULL Choose full data recovery.
SPARSE Choose sparse data recovery.
SDRDENS Input-integer-default=0. Sparse data recovery ceiling density. If the density of
PVGRID is greater than SDRDENS divided by 100, then choose full data
recovery.
Main Index
OUTPRT 1229
Constructs sparse load reduction and sparse data recovery partitioning vectors
Main Index
1230 OUTPUT2
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 MSC 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
OUTPUT2 1231
Output a table or matrix into a FORTRAN readable file
Remarks:
1. A data block (table or matrix) consists of logical records:
• In matrices, each column is contained in one logical record. Each record begins with the row
position of the first nonzero term in the column followed by the first through the last nonzero
term in the column.
• In tables, the contents of logical records vary according to the table but are described in Data
Blocks (Ch. 2).
2. The FORTRAN binary file consists of physical records of data from the data block and KEYs that
are provided to assist in the reading of the file. Each physical record of data is separated by one-
word records called KEYs. The KEYs will indicate one of the following depending on its location
in the binary file:
KEY Description
The length of the next physical record. It may also indicate the start of a new
>0
logical record.
0 End-of-File (data block) (EOF) or End-of-Data (EOD).
End-of-Logical record (EOR) or a null column. The absolute value indicates
<0
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 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.
Main Index
1232 OUTPUT2
Output a table or matrix into a FORTRAN readable file
7. The ASSIGN (p. 42) in the MSC Nastran Quick Reference Guide FMS statement is recommended
for assigning the FORTRAN unit. Selection of a proper value for IUNIT is machine dependent.
Refer to the Making File Assignments (p. 88) in the MSC Nastran 2012 Installation and
Operations Guide.
8. No physical record will exceed the value specified by the parameter MAXR which has a default
that is two times BUFFSIZE words. Furthermore, the value specified for MAXR should not
exceed the maximum allowable record size for the receiving disk device. See the Keywords and
Environment Variables (p. 45) in the MSC Nastran 2012 Installation and Operations Guide for
the maximum allowable values.
9. When the neutral format option is selected via FORM=FORMATTED on the ASSIGN FMS
statement (associated with OUTPUT2 parameter IUNIT), then MAXR and NDDLNAMi are
interpreted as follows:
MAXR Represents the maximum physical record size (in words) on the target
machine(s) for the machine binary-formatted file after it has been
converted from neutral to binary via the MSC-supplied conversion
utility RCOUT2.
NDDLNAMi Correlates the DMAP data block name with the corresponding NDDL-
defined name. If this parameter is left blank, then the corresponding
DMAP name (DB1 through DB5) is assumed to be the NDDL-defined
name.
The following is a partial list of the table data block names available for OUTPUT2 neutral file
formatting. For a more complete list see the NDDL.
In addition, all matrices defined with a TYPE DB, may also be neutral formatted. If a matrix is
not an NDDL data block, then the NDDLNAMi='MATRIX' should be used. For example, to write
the matrix MYMATRIX use
OUTPUT2 MYMATRIX,,,,//ITAPE/IUNIT/LABL/MAXR/'MATRIX' $
Main Index
OUTPUT2 1233
Output a table or matrix into a FORTRAN readable file
Note and the neutral format is a machine-neutral format that allows the transfer of the OUTPUT2-
generated files between different machine types. See RCOUT2 (p. 223) in the MSC Nastran 2012
Installation and Operations Guide for a discussion of this transfer process and the MSC-supplied
conversion utility RCOUT2.
10. The following formats describe each physical record. Note that the following formats depend on
the value of system cell 403 (NASTRAN statement keyword OP2NEW).
Physical
Record
Number Length Contents Description
1 1 KEY = 3
Date (3 words, month-day-year) --
2 KEY
integer
3 1 KEY = 7
NASTRAN Header (7 words*, One Logical Record
4 KEY
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
LABEL (2 words, Character-A4 =
6 KEY
LABL)
If OP2NEW = 0:
7 1 KEY = -1 (EOR)
8 1 KEY = 0 (EOF) End of Label
If OP2NEW = 1:
7 1 KEY = 3
Nastran Program Version (3 words,
8 KEY
Major, Minor, Round, Character A4)
9 1 KEY = -1 (EOR)
10 1 KEY = 0 (EOF)
Main Index
1234 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number Length Contents Description
9 1 KEY = 2
Data Block Name (2 words, Character- Header: Logical. Record1 of
10 KEY
A4) Data Block
11 1 KEY = -1 (EOR)
12 1 KEY = 7
13 KEY NASTRAN Trailer (7 words, integer) Trailer: Logical
14 1 KEY = -2 (EOR)
Record 2 of Data Block
15 1 KEY = 1 (Start new logical record)
16 1 KEY = 0
17 1 KEY = 2. Logical Record
Data Block Name (2 words, Character-
18 KEY 3 of Data Block
A4) and data (if any)
19 1 KEY=-3 (EOR).
Physical
Record
Number Length Contents Description
11 1 KEY = 2
12 KEY Data Block Name (2 words, Character-A4) Header: Logical. Record1 of
13 1 KEY = 3 Data Block
Main Index
OUTPUT2 1235
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number Length Contents Description
21 1 KEY = 2. Logical Record
Data Block Name (2 words, Character-A4)
22 KEY 3 of Data Block
and data (if any)
23 1 KEY=-3 (EOR).
Physical
Record
Number
OP2NEW
0 1 Length Contents Description
20 24 1 KEY=1 (Start new logical record) Logical Record 4
21 25 KEY Next Logical Record Type=0 for table record of Table
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
26 30 KEY Next Logical Record Type = 0 of Table
27 31 1 KEY > 0
28 32 KEY Data
29 33 1 KEY < 0 (EOR)**
. . Repeat Physical Records 25-29 (or 29-33) Additional Records
for Additional Records in Table of Table
. .
. .
n-7 1 KEY = 1 (Start new logical record) Last Logical
n-6 KEY Next Logical Record Type = 0 Record of Table
Main Index
1236 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number
OP2NEW
0 1 Length Contents Description
n-2 1 KEY = 1 (Start new logical record) If Last “Next
n-1 KEY Next Logical Record Type = 0 Logical Record
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.
Physical
Record
Number
OP2NEW
0 1 Length Contents Description
20 24 1 KEY=1 (Start new logical record)
Next Logical Record Type Logical Record 4 of
Matrix=first column
21 25 KEY 1 : matrix column (string records)
2 : factor matrix
3 : factor matrix
KEY > 0 Number of non-zero terms in First Column First
22 26 1
next string in word unit String Record
First non-zero row, followed by non-zero
23 27 KEY+1
terms
KEY > 0 Number of non-zero terms in First Column Second
24 28 1
next string in word unit String Record
First non-zero row, followed by non-zero
terms.
25 29 KEY+1
Repeat String Records 22-23 for
Additional Strings in Column
KEY > 0 Number of non-zero terms in First Column Last
n-2 1
next string in word unit String Record
Main Index
OUTPUT2 1237
Output a table or matrix into a FORTRAN readable file
Physical
Record
Number
OP2NEW
0 1 Length Contents Description
First non-zero row, followed by non-zero
n-1 KEY+1
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
n 1 KEY=1 (Start new logical record) Null Column
Main Index
1238 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Physical Record
Number Length Contents Description
Next Logical Record Type
n+1 KEY
(See Record 21 above)
n+2 1 KEY<0 (EOR) End of Null Column
KEY > 0 Number of non-zero terms in Last Column Last
m-5 1
next string in word unit String Record
First non-zero row, followed by non-zero
m-4 KEY+1
terms
m-3 1 KEY<0 End of Last Column
m-2 1 KEY=1 (Start new logical record)TD>
Next Logical Record type=0 If Last "Next Logical
m-1 KEY
Record Type" = 0
m 1 KEY = 0 (EOF) End of Matrix
Physical
Record
Number Length Contents
n+1 1 If No Data Blocks Follow, KEY = 0 (EOD) End-of-Data
11. OUTPUT2 files may be read using three utility subroutines provided in the utility ("util")
directory; see Building and Using TABTST (p. 254) in the MSC Nastran 2012 Installation and
Operations Guide.
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.
Main Index
OUTPUT2 1239
Output a table or matrix into a FORTRAN readable file
Format:
CALL IOPEN(IUN,L)
where IUN = An input integer which specifies the unit number to be read.
IOPEN 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.
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
IHEADR 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 MSC 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 (p. 570) in the ‘ and this guide.
Main Index
1240 OUTPUT2
Output a table or matrix into a FORTRAN readable file
Format:
CALL IREAD(IUN,ARRY,NARY,IMETH,NT,IRTN)
where IUN is as described in IOPEN.
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
IREAD conclusion of IREAD, in the current logical record, is skipped.
IRTN is an integer output value which indicates the status on return from IREAD.
IRTN = 1 End of logical record hit while trying to process NARY words.
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 MSC Nastran
logical record spans several physical FORTRAN records these are transparent (no
end-of-record returns) to the user.
Main Index
OUTPUT4 1241
Output matrices onto a FORTRAN readable file
Format:
OUTPUT4 M1,M2,M3,M4,M5//ITAPE/IUNIT/UNUSED3/BIGMAT/DIG
ITS $
Mi Matrices. Mi cannot be a factor matrix (forms 4, 5, 10, 11, 13, and 15).
Main Index
1242 OUTPUT4
Output matrices onto a FORTRAN readable file
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.
Remarks:
1. Each matrix will be written on IUNIT as follows:
Main Index
OUTPUT4 1243
Output matrices onto a FORTRAN readable file
• Record 1:
• 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.
• 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
Number Number Type Meaning
2 1 Integer Column number (ICOL).
Row position of first nonzero term
2 Integer
(IROW).
Number of words in the column
3 Integer
(NW). See Remark 3.
Column element values, single or
3, 4, etc. 1 through NW Real or Complex
double precision.
Main Index
1244 OUTPUT4
Output matrices onto a FORTRAN readable file
• Records 2, 3, 4, etc. for sparse, binary, and string header format (IUNIT < 0, and BIGMAT =
FALSE).
*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).
Main Index
OUTPUT4 1245
Output matrices onto a FORTRAN readable file
• 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).
Record Word
Number Number Type Meaning
1 Integer Column number (ICOL).
2 Integer Zero.
2
Number of words in the column (NW).
3 Integer
See Remark 3.
3 1 Integer String header (IS)*.
Real or A string of nonzero values, single or
4 1 through NW
Complex 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
Number Number Type Meaning
1 Integer Column number (ICOL).
2 Integer Zero.
2
Number of words in the column (NW).
3 Integer
See Remark 3.
Length of string, L, plus 1. See Remark
1 Integer
3.
3
Row position of first term in string
2 Integer
(IROW).
Real or A string of nonzero values, single or
4 1 through NW
Complex 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.
Main Index
1246 OUTPUT4
Output matrices onto a FORTRAN readable file
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.
Number of
Type Words
1 -- Real single precision 1
2 -- Real double precision 2
3 -- Complex single precision 2
4 -- Complex double precision 4
4. The ASSIGN FMS statement is recommended for assigning the FORTRAN unit (see the MSC
Nastran Quick Reference Guide). Selection of a proper value for IUNlT is machine dependent.
See Making File Assignments (p. 88) in the MSC Nastran 2012 Installation and Operations Guide.
5. If the nonsparse format (IUNIT > 0) is selected, zero terms will be explicitly present after the first
nonzero term in any column until the last nonzero term.
6. Null columns will not be output.
7. An entire column must fit in memory.
8. The FORTRAN binary file option (FORM = UNFORMATTED on the ASSIGN FMS statement)
is the preferred method when the file is to be used on the same computer. The ASCII format
FORM = UNFORMATTED on the ASSIGN FMS statement allows use of the file on another
computer type.
9. The output format of these files can be read by the INPUTT4 module.
10. OUTPUT4 files may be read using a utility FORTRAN subroutine called GETIDS, which is
provided in the utility directory. (See Building and Using MATTST (p. 248) in the MSC Nastran
2012 Installation and Operations Guide.) GETIDS is in the file called mattst.f or mattst.for.
The program must be modified if the ASCII format is desired.
The program is designed to read matrices less than 65536 rows. (BIGMAT = FALSE).
11. Sparse factor matrices (forms 4, 5, 10, 11, 13, and 15) cannot be processed by OUTPUT4.
Main Index
PARAML 1247
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,P
6/
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:
The following describes the various options and their formats. The meaning and usage of parameters P2
through P6, SETi, and Fi depend on the value of P1. Under all options P5 will be set to -1, if the input
data block does not exist, and no other parameters will be set.
Main Index
1248 PARAML
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 (Ch. 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,RBA
R/
'RTRPLT'/S,N,RTRPLT/'RSPLINE'/S,N,RSPLINE $
Main Index
PARAML 1249
Sets parameters from a data block
Formats:
Extract the computer’s vendor name:
PARAML //’COMPVEND’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
PARAML //’COMPMODL’//////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 = ‘DMI’
Extract an element from a matrix.
Main Index
1250 PARAML
Sets parameters from a data block
Format:
PARAML MAT//’DMI’/ICOL/IROW/S,N,REAL/
S,N,NROW/S,N,IMAG $
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 $
Main Index
PARAML 1251
Sets parameters from a data block
Parameters:
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
(Ch. 2), SPCFORCE requests are declared in word 135 of the CASECC data block.
PARAML CASECC//’DT1’/-1/135//S,N,SPCREQ $
Main Index
1252 PARAML
Sets parameters from a data block
Option P1 = ‘DTI2’
Extract double precision load factor stored in two consecutive words of the ESTNL data block and
truncate to single precision.
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
PARAML 1253
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.
PARAMLCASECC//'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
1254 PARAML
Sets parameters from a data block
Example:
Search for value of HINDEX in record 1 of KVAL table.
HINDEX = HINDEX +1 $
PARAMLKVAL//'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
PARAML 1255
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 $
Main Index
1256 PARAML
Sets parameters from a data block
Parameters:
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, 707 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.
Main Index
PARAML 1257
Sets parameters from a data block
Format:
PARAML CASECC//'SET'/S,N,RECNUM/S,N,WRDNUM/S,N,REAL/
S,N,INTGR//S,N,CHAR/S,N,SETKNTR $
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
1258 PARAML
Sets parameters from a data block
Parameters:
RECNUM Input-integer. Record number. If RECNUM is greater than the number of records
in TABIN, it will result in a fatal error. (RECNUM=0 refers to the header record of
TABIN.)
WORDNUM Input-integer. Word number.
>0 A total of NWORDS entries starting from word number. WORDNUM (and
going forward) are deleted from record number RECNUM. If NWORDS is
not specified, it is internally assumed to be 1.
=0 Delete the entire record RECNUM. NWORDS is ignored in this case.
<0 Delete the trailing portion of record RECNUM starting from word number
ABS(WORDNUM). NWORDS is ignored in this case.
NWORDS Input-integer. Number of words to delete.
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 $
Main Index
PARAML 1259
Sets parameters from a data block
PARAML TABIN/TABOUT/’TABINSI’/
RECNUM/WORDNUM//INTEG $
PARAML TABIN/TABOUT/’TABINSC’/
RECNUM/WORDNUM////CHAR $
PARAML TABIN/TABOUT/’TABINS2C’/
RECNUM/WORDNUM////CHAR $
Parameters:
Main Index
1260 PARAML
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 $
Main Index
PARAML 1261
Sets parameters from a data block
Parameters:
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 or set information from USET.
PARAML DB//'TRAILER'/WRDNUM/S,N,TVALUE/S,N,REAL/
S,N,NODB $
PARAML USET//'TRAILER'////S,N,NOSET//SETNAME $
Main Index
1262 PARAML
Sets parameters from a data block
Parameter:
Remarks:
1. Meaning of TVALUE:
2. If WRDNUM=6, the density of a matrix is returned as an integer value times 10000 in TVALUE
and also as a real value in REAL. If the density is greater than 99.999%, but not actually full, then
TVALUE will be 10000, which is misleading if one is checking for the “fullness” of a matrix. It
is recommended that either the REAL parameter be checked or the FULLMAT parameter be
checked under P1=’NULL’.
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 $
Main Index
PARAML 1263
Sets parameters from a data block
Option P1 = ‘USET’
Search for a specific integer value in a table record.
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).
PARAMLUSET//’USET’//////’M’/S,N,NOMSET/’S’/S,N,NOSSET $
Main Index
1264 PARAML
Sets parameters from a data block
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., ‘MSC Nastran -- Tier 2’:
PARAML //’VERSID1’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
PARAML //’VERSID2’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
PARAML //’VERSID3’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
PARAML //’VERSID4’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
PARAML //’VERSDATE’//////S,N,CHAR1//S,N,CHAR2//
S,N,CHAR3//S,N,CHAR4 $
Main Index
PARAML 1265
Sets parameters from a data block
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.
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:
Main Index
1266 PARAML
Sets parameters from a data block
See X-Y PLOT Commands (p. 608) in 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 1267
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/F
22 $
A Matrix to be partitioned.
RP Row partitioning vector -- single precision column vector.
CP Column partitioning vector -- single precision column vector.
Parameters:
Main Index
1268 PARTN
Matrix partition
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:
A A11 A12
A21 A22
Case 4: Neither {CP} nor {RP} are purged and SYM 0 :
PARTN A,CP,RP/A11,A21,A12,A22/1 $
[A11] is a (NROWA -- NR) by (NCOLA -- NC) matrix.
[A21] is a NR by (NCOLA -- NC) matrix.
[A12] is a (NROWA -- NR) by NC matrix
[A22] is a NR by NC matrix.
A A11 A12
A21 A22
Main Index
PARTN 1269
Matrix partition
A A11
A21
5. If {RP} is purged and SYM 0 , [A] is partitioned as follows:
6. If {RP} is purged and SYM 0 , [A] is partitioned as follows:
A A11 A12
A21 A22
where {CP} is used as both the row and column partitioner.
7. {RP} and {CP} cannot both be purged.
8. A A11 A12
A21 A22
Let [A] be an m by n matrix, {CP} be an nx1 vector containing q zero elements; and {RP} be a
mx1 vector containing p zero elements.
Partition [A11] will consist of all elements Aij of [A] for which CPj = RPi = 0.0 in the same order
as they appear in [A].
Partition [A12] will consist of all elements Aij of [A] for which CPj 0.0 and RPi = 0.0 in the
same order as they appear in [A].
Partition [A21] will consist of all elements Aij of [A] for which CPj = 0.0 and RPi 0.0 in the
same order as they appear in [A].
9. The default action for F11, F21, F12, and F22 allows the program to automatically select the
appropriate form.
Examples:
1. Let [A], {CP} and {RP} be defined as follows:
Main Index
1270 PARTN
Matrix partition
1.0
0.0
CP =
1.0
1.0
0.0
RP = 0.0
1.0
Then, the DMAP instruction
PARTN A,CP,RP/A11,A21,A12,A22/1 $
will create the real matrices:
Main Index
PARTN 1271
Matrix partition
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 $
then the resulting partitions would be
1 2 3
A11 A12
5 6 7
A21 A22
9 10 11
Main Index
1272 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:
Main Index
PCOMB 1273
Combines static loads from upstream superelements
Remarks:
1. Any input data block except CASEXX may be purged.
2. If MODE='STATICS' all records of CASECC, beginning at the NSKIP-th record, are processed
until a boundary change occurs.
Main Index
1274 PCOPY
Tests parallel copy
Format:
PCOPY INDB/
OUTDB1,OUTDB2,OUTDB3,OUTDB4,OUTDB5,OUTDB6,OUTD
B7,
OUTDB8/
PCOPY1/PCOPY2 $
Parameters:
Remark:
PCOPY is a reserved for MSC development purposes and should not be used.
Main Index
PFCALC 1275
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:
PFCALC CASECC,BGPDT,OL,RXS,UXFS,LAMAS,LAMAF,UXFF,MFXX,BFXX,KF
XX,PNLLST,RWXS,RXF,AXX,AXW,VGW,ABEH*,
PFXF,UBRS,UBRF,UBWS,APXW*,MSXX,BSXX,KSXX,PXS,
UBWF,APYW*, QFRQV*,QSXX*,QFXX*,QAXX*,QABEH*,QABEF*,
QABES*,QAXW*/ SMPF,SMPFD,OSMPF1,AFMPF,AFMPFD,OAFMPF1,
ASMPF,ASMPFD, OASMPF1,APMPF1,APMPFD,OAPMPF1,APPF,
APPFD,OAPPF1,AGPF, AGPFD,OAGPF1,SPPF,SPPFD,OSPPF1/
FS/APP/SOLTYPS/SOLTYPF/NOACTRM $
Main Index
1276 PFCALC
Participation factors for structure and acoustic applications
Main Index
PFCALC 1277
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).
Main Index
1278 PFCALC
Participation factors for structure and acoustic applications
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
PFOFP 1279
Output File Processor for Participation Factors
To output (print or punch) data blocks prepared by PFMODE, PFPANEL and PFGRID.
Format:
PFOFP OFP1,OFP2,OFP3,OFP4,OFP5//ODCODE/APP $
OFPi Output table suitable for processing by PFCALC module. See Remark 1.
None
Parameters:
Remarks:
1. Any of the data blocks may be purged.
Main Index
1280 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,
PUGS PUGD GPECT OES1
, , , /
USET ECT
PLOTMSG/
NGP/LUSET/JPLOT/DEFORMED/S,N,PLTNUM $
Main Index
PLOT 1281
Creates a table of plot instructions
Parameters:
NGP Input-integer-no default. Number of grid points and scalar points in the structure.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set. If LUSET=0 then its value will be extracted from the trailer of BGPDT.
JPLOT Input-integer-no default. Number of element plot sets. Set to -1 if there are none.
DEFORMED Input-integer-default=1. Deformed plot request flag.
1 Plot undeformed shapes.
-1 Plot deformed shapes.
PLTNUM Input/output-integer-default=0. Plot frame counter.
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
1282 PLTHBDY
Supports plotting of CHBDYi elements
Updates the geometry and connectivity tables to support 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 1283
Generates element sets for plotting
Format:
/
PLTSET PBGPDT PECT
PCDB, ,
BGPDT ECT
POSTCDB, , GEOM2
ELSET
3/6(706* 3/73$5 *36(76 /
PELSET
S,N,NGP/S,N,JPLOT/ECTYPE $
Main Index
1284 PLTSET
Generates element sets for plotting
Parameters:
NGP Output-integer-no default. Number of grid points and scalar points in the structure.
JPLOT Output-integer-no default. Number of element plot sets. Set to -1 if there are none.
ECTYPE Input-integer-default=0. Type of element connectivity input and plot set output:
0 ECT and ELSET.
1 GEOM2 and ELSET.
2 ECT and PELSET.
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 1285
For multi-level DMP, changes the active group set from a parent to a child group or from a child to a
parent group.
PNCHGRP 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
1286 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 1287
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
1288 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 1289
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
1290 PRESOL
Prepares special tables for the distributed parallel solution
Main Index
PROJVER 1291
Set or query project identification numbers
Format:
PROJVER //PRJVEROP/S,N,PROJNO/S,N,VERSION/S,N,EXISTS $
Parameters:
Main Index
1292 PRTMSG
Prints plotting information messages
Prints user information messages related to plot set definition and plotting.
Format:
PLOTMSG
PRTMSG 35'06*
PLSETMSG
Input Data Blocks:
Parameter:
Main Index
PRTPARM 1293
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:
3573$50 /86(7
• If PNAME = 'XXXXXXXX' then the values of all variable and constant parameters in the
Variable Parameter Table of the subDMAP identified by SUBDMAP are printed.
Examples:
3573$50 8QVRUWHG
3573$50 6RUWHG
Main Index
1294 PRTPARM
Parameter and DMAP message printer
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 1295
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
1296 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.
• 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.
Main Index
PVT 1297
Sets parameter values
• Fourth, the CASECC user input parameters for the current subcase override any settings of Bulk
Data parameters or above subcase level parameters of the same name. Any additional current
subcase parameters are set.
4. The Parameter Defaults Table is an internal table that contains the default value for all parameters
resolved between the Case Control, Bulk Data, NDDL, and the main and current subDMAP.
Main Index
1298 RANDOM
Computes functions from frequency response data
Computes power spectral density functions and autocorrelation 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, CSIG,CEPS,CFAI,CSRS/
PSDF,AUTO,
OUGPSD2,OUGATO2,OUGRMS1,OUGNO1,OUGCRM2,
OPGPSD2,OPGATO2,OPGRMS1,OPGNO1,OPGCRM2,
OQGPSD2,OQGATO2,OQGRMS1,OQGNO1,OQGCRM2,
OEFPSD2,OEFATO2,OEFRMS1,OEFNO1,OEFCRM2,
OEEPSD2,OEEATO2,OEERMS1,OEENO1,OEECRM2,
OQMPSD2,OQMATO2,OQMRMS1,OQMNO1,OQMCRM2,
OCPSDF,OCCORF,
OVGPSD2,OVGATO2,OVGRMS1,OVGNO1,OVGCRM2,
OAGPSD2,OAGATO2,OAGRMS1,OAGNO1,OAGCRM2,
OCSPSD2,OCSATO2,OCSRMS2,OCSNO2,OCSCRM2,
OCAPSD2,OCAATO2,OCARMS2,OCANO2,OCACRM2,
OCFPSD2,OCFATO2,OCFRMS2,OCFNO2,OCFCRM2,
OCRPSD2,OCRATO2,OCRRMS2,OCRNO2,OCRCRM2 /
S,N,NORAND/RMSINT/DVAFLAG $
Main Index
RANDOM 1299
Computes functions from frequency response data
OLMPF2M Table of load modal participation factors by natural modes in SORT2 format.
OPMPF2M Table of panel modal participation factors by natural modes in SORT2 format.
OGPMPF2M Table of panel grid modal participation factors by natural modes in SORT2 format.
OVG2 Table of velocities in SORT2 format.
OAG2 Table of accelerations in SORT2 format.
CSIG Table of lamina stresses in SORT2 format.
CEPS Table of lamina strains in SORT2 format.
CFAI Table of lamina failure indices in SORT2 format.
CSRS Table of lamina strength ratios in SORT2 format.
Main Index
1300 RANDOM
Computes functions from frequency response data
OESCRM2 Table of element stresses in SORT2 format for the cross correlation function.
OCSPSD2 Table of lamina stresses in SORT2 format for the PSD function.
OCSATO2 Table of lamina stresses in SORT2 format for the autocorrelation function.
OCSRMS1 Table of lamina stresses in SORT1 format for the RMS function.
OCSNO2 Table of lamina stresses in SORT2 format for the NO function.
OCSCRM2 Table of lamina stresses in SORT2 format for the cross correlation function.
OCAPSD2 Table of lamina strains in SORT2 format for the PSD function.
OCAATO2 Table of lamina strains in SORT2 format for the autocorrelation function.
OCARMS1 Table of lamina strains in SORT1 format for the RMS function.
OCANO2 Table of lamina strains in SORT2 format for the NO function.
OCACRM2 Table of lamina strains in SORT2 format for the cross correlation function.
OCFPSD2 Table of failure indices in SORT2 format for the PSD function.
OCFATO2 Table of failure indices in SORT2 format for the autocorrelation function.
OCFRMS1 Table of failure indices in SORT1 format for the RMS function.
OCFNO2 Table of failure indices in SORT2 format for the NO function.
OCFCRM2 Table of failure indices in SORT2 format for the cross correlation function.
OCRPSD2 Table of strength ratios format for the PSD function.
OCRATO2 Table of strength ratios in SORT2 format for the autocorrelation function.
OCRRMS1 Table of strength ratios in SORT1 format for the RMS function.
OCRNO2 Table of strength ratios in SORT2 format for the NO function.
OCRCRM2 Table of strength ratios in SORT2 format for the cross correlation function.
OEFPSD2 Table of element forces in SORT2 format for the PSD function.
OEFATO2 Table of element forces in SORT2 format for the autocorrelation function.
OEFRMS1 Table of element forces in SORT1 format for the RMS function.
OEFNO1 Table of element forces in SORT1 format for the NO function.
OEFCRM2 Table of element forces in SORT2 format for the cross correlation function.
OEEPSD2 Table of element strains in SORT2 format for the PSD function.
OEEATO2 Table of element strains in SORT2 format for the autocorrelation function.
OEERMS1 Table of element strains in SORT1 format for the RMS function.
OEENO1 Table of element strains in SORT1 format for the NO function.
OEECRM2 Table of element strains in SORT2 format for the cross correlation function.
OQMPSD2 Table of multipoint forces of constraint in SORT2 format for the PSD function.
OQMATO2 Table of multipoint forces of constraint in SORT2 format for the autocorrelation
function.
Main Index
RANDOM 1301
Computes functions from frequency response data
OQMRMS1 Table of multipoint forces of constraint in SORT1 format for the RMS function.
OQMNO1 Table of multipoint forces of constraint in SORT1 format for the NO function.
OQMCRM2 Table of multipoint forces of constraint in SORT2 format for the cross correlation
function.
OCPSDF Output table of cross-power-spectral-density functions.
OCCORF Output table of cross-correlation functions.
OVGPSD2 Table of velocities in SORT2 format for the PSD function.
OVGATO2 Table of velocities in SORT2 format for the autocorrelation function.
OVGRMS1 Table of velocities in SORT1 format for the RMS function.
OVGNO1 Table of velocities in SORT1 format for the NO function.
OVGCRM2 Table of velocities in SORT2 format for the cross correlation function.
OAGPSD2 Table of accelerations in SORT2 format for the PSD function.
OAGATO2 Table of accelerations in SORT2 format for the autocorrelation function.
OAGRMS1 Table of accelerations in SORT1 format for the RMS function.
OAGNO1 Table of accelerations in SORT1 format for the NO function.
OAGCRM2 Table of accelerations in SORT2 format for the cross correlation function.
OCSPSD2 Table of lamina stresses in SORT2 format for the PSD function.
OCSATO2 Table of lamina stresses in SORT2 format for the autocorrelation function.
OCSRMS1 Table of lamina stresses in SORT1 format for the RMS function.
OCSNO2 Table of lamina stresses in SORT2 format for the NO function.
OCSCRM2 Table of lamina stresses in SORT2 format for the cross correlation function.
OCAPSD2 Table of lamina strains in SORT2 format for the PSD function.
OCAATO2 Table of lamina strains in SORT2 format for the autocorrelation function.
OCARMS1 Table of lamina strains in SORT1 format for the RMS function.
OCANO2 Table of lamina strains in SORT2 format for the NO function.
OCACRM2 Table of lamina strains in SORT2 format for the cross correlation function.
OCFPSD2 Table of failure indices in SORT2 format for the PSD function.
OCFATO2 Table of failure indices in SORT2 format for the autocorrelation function.
OCFRMS1 Table of failure indices in SORT1 format for the RMS function.
OCFNO2 Table of failure indices in SORT2 format for the NO function.
OCFCRM2 Table of failure indices in SORT2 format for the cross correlation function.
OCRPSD2 Table of strength ratios format for the PSD function.
OCRATO2 Table of strength ratios in SORT2 format for the autocorrelation function.
OCRRMS1 Table of strength ratios in SORT1 format for the RMS function.
Main Index
1302 RANDOM
Computes functions from frequency response data
Parameters:
Method:
Overview
The Random Analysis Module calculates power spectral density functions, autocorrelation functions and
mean deviations for selected displacements, loads, forces of single-point constraint, and element forces
and stresses.
Module Initialization
1. The XYCDB must be present or RANDOM returns.
2. A set of RANDPS Bulk Data entries from PSDL must be selected in CASECC or RANDOM
returns.
3. The frequency list is extracted from the first non-empty data file.
4. The RANDPS Bulk Data entry defines the function
S ab f = x + iy F K f (5-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.
Main Index
RANDOM 1303
Computes functions from frequency response data
2
2 2L 1 + 2 p + 1 kwL U
S ab f = Wg -----
- -------------------------------------------------------
- (5-23)
U 2 p+32
1 + kwL U
2
where W g , L , U , p , and k are user-supplied data and W = 2f .
If a b on any RANDPS entry, the equations are called coupled; otherwise, they are called
uncoupled.
The following eight steps are accomplished:
a. The XYCDB is read for a list of requested points.
b. Compute S aa f at each load change.
c. Read in the data from the SORT2 data block and compute
2
S ja f = U j f S aa f (5-24)
S ja f = Sja f (5-25)
a
where a runs over all subcase identification numbers on the RANDPS entries.
e. When all subcases for the points have been processed, the mean response q j is calculated for
each point j :
N–1
1---
2 Sj fi + Sj fi + 1 fi + 1 – fi (5-26)
i=1
where N = number of frequencies.
The mean response is output with both the PSDF and the autocorrelation function.
The zero positive crossing N 0 is also computed and output with the mean response q j . N 0 is
defined by
1- 2
-----
2 w S J w dw S J w dw (5-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"
Main Index
1304 RANDOM
Computes functions from frequency response data
2
qj = Rj 0 = Sj f df (5-28)
0
thus the numerator must be integrated. Compute
2 2
rj = f S j f df
0
N–1
1---
rj =
2 Sj fi + Sj fi + 1 fi + 1 – fi (5-29)
i=1
2 2
= 3f i + 2f i f i + 1 + f i + 1 6
2 2
= f i + 2f i f i + 1 + 3f i + 1 6
Note that if and are 1.0, the sum for rj would become the formula for qj . Then
N 0 = r j q j is the quantity to be output.
f. If PSDF for point j is requested, one identification number and data record are written on the
PSDF data block.
g. If an autocorrelation function is requested for point j , the S j f are transformed to the time
domain to give the autocorrelation function:
N–1
1 Sj fi + 1 – Sj fi
Rj m = - -------------------------------------- cos 2 m f i + 1 – cos 2 m f i
--------------
4 m
2 2 fi + 1 – fi
i=1 (5-30)
1
+ ------------- S j f + 1 sin 2 m f i + 1 – S j f i sin 2 m f i
2 m
where:
i = index of the frequencies.
N = highest frequency.
m = is defined by
m
m = 0 + ----- max – 0 (5-31)
M
Main Index
RANDOM 1305
Computes functions from frequency response data
where:
0 = starting time lag.
M = number of time lag intervals.
max = maximum time lag 0 0 m
all of which are defined on a RANDT1 Bulk Data entry. Note that if, in (5-30), m = 0 , then
2
r m = qj
The Coupled Case
The following six steps are accomplished:
1. A list of unique subcase identification numbers are extracted from the RANDPS entries.
2. The XYCDB is read for a list of requested points.
1 1
3. For each RANDPS entry S j f is looked up for all f , For each point S j f is computed:
1
S j f = H ja f S ab f H jb f (5-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
1306 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 (5-34)
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 1307
Computes rigid body information
T
DM K ll DM + K rr (5-36)
Main Index
1308 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 (5-37)
Main Index
READ 1309
Extracts real symmetric system eigenvalues
d
K – K u = 0 for buckling analysis (5-39)
Format:
READ KAA,MAA,MR,DAR,DYNAMIC,USET,CASECC,
EQEXIN
, /
GAPAR
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
1310 READ
Extracts real symmetric system eigenvalues
Main Index
READ 1311
Extracts real symmetric system eigenvalues
Parameters:
NSKIP Input-integer-default=1. The method used by READ is taken from the NSKIP
record of CASECC.
FLUID Input-logical-default=FALSE. If FLUID = TRUE, then the EIGRL or EIGR entry
is selected from METHOD(FLUID) Case Control command.
SETNAME Input-character-default='A'. For maximum efficiency, the rows and columns KXX
and MXX must correspond to or be a partition of the displacement set specified by
SETNAME. If KAA and MAA are a partition then PARTVEC must be specified.
Main Index
1312 READ
Extracts real symmetric system eigenvalues
If SID=0, the set identification number is obtained from the METHOD command
in CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMIC.
If SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL is
selected by this parameter value. All subsequent parameter values (METH, F1,
etc.) are ignored.
If SID=-1, then both the METHOD command and all EIGR, EIGB, or EIGRL
entries are ignored and the subsequent parameter values (METH, F1, etc.) will be
used to control the eigenvalue extraction.
If SID=-2, then take action similar to SID=0 except fields on the Case Control
selection of EIGR/EIGRL may be overridden by parameters F1 through NORM
described below.
METH Input-character-default='LAN'. If SID<0, then METH specifies the method of
eigenvalue extraction.
LAN Lanczos.
INV Inverse power.
SINV Inverse power with Sturm sequence.
GIV Givens (tridiagonalization).
MGIV Modified Givens.
HOU Householder.
MHOU Modified Householder.
AGIV Automatic selection of GIV or MGIV.
AHOU Automatic selection of HOU or MHOU.
F1 Input-real-default=0.0. The lower frequency bound.
F2 Input-real-default=0.0. The upper frequency bound. The default value of 0.0
indicates machine infinity.
NE Input-integer-default=20. The number of estimated eigenvalues for non-Lanczos
methods only. For the Lanczos method, NE is the problem size which the QL
Householder method is used.
Note: NE default changed from 0 to 20.
ND Input-integer-default=0. The number of desired eigenvalues.
Main Index
READ 1313
Extracts real symmetric system eigenvalues
MSGLVL Input-integer-default=0. The level of diagnostic output for the Lanczos method
only.
0 No output.
1 Warning and fatal messages.
2 Summary output.
3 Setailed output on cost and convergence.
4 Setailed output on orthogonalization.
MAXSET Input-integer-default=0. Vector block size for Lanczos method only.
SHFSCL Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL
must be greater than 0.0.
NORM Input-character-default=' '. Method for normalizing eigenvectors. By default (or
NORM='MASS'), MASS normalization is performed. NORM='MAX' selects
normalization by maximum displacement.
PRTSUM Inpput-logical-default=TRUE. Lanczos eigenvalue summary print flag.
MAXRATIO Input-real-default=1.0E7. Minimum value of factor diagonal ratio which causes
termination of decomposition.
MDLGDEF Input-integer-default=8000. Minimum number of degrees-of-freedom that activates
special ACMS DECOMP/FBS method in READ module for buckling problems
(FORMAT<>"MODES").
Remarks:
1. In the solution sequences the eigensolution control parameters are selected by the METHOD or
METHOD(FLUID) command which are defined in the CASECC data block and selects a EIGR
or EIGRL Bulk Data entry record defined in the DYNAMIC or EED data block. EED is a subset
of and interchangeable with the DYNAMIC for this application. There are alternate formats as
shown below where the Case Control commands and/or the EIGR or EIGRL Bulk Data entries
are replaced with optional parameters SID, METH, F1, etc.
• SID=0 -- DYNAMIC and CASECC data blocks must be specified. METHOD command and
EIGR, or EIGRL, entries must be specified in the input file.
5($' .$$ 0$$ '<1$0,& &$6(&&
LAMA,PHA,MI,OEIGS,/
FORMAT/S,N,NEIGV $
• SID>0 -- Only DYNAMIC data block must be specified. The EIGR or EIGRL entry is selected
by the SID parameter. The CASECC data block may be purged and is ignored.
5($' .$$ 0$$ '<1$0,&
LAMA,PHA,MI,OEIGS,/
Main Index
1314 READ
Extracts real symmetric system eigenvalues
FORMAT/S,N,NEIGV////SID $
• SID<0 -- DYNAMIC and CASECC are not required. SID=-1 and METH through NORM
parameters are specified. For more detailed information on parameters F1 through NORM,
please refer to the descriptions of Bulk Data entries EIGR, 1807 and EIGRL (p. 1811) in the MSC
Nastran Quick Reference Guide. The CASECC and DYNAMIC data blocks may be purged and
are ignored.
5($' .$$ 0$$
LAMA,PHA,MI,OEIGS,/
FORMAT/S,N,NEIGV////-1//
F1/F2/NE/ND/MSGLVL/MAXSET/SHFSCL/NORM $
2. In the READ module, the most memory-intensive part of the calculations is involved with
symbolic decomposition of the mass or shifted stiffness matrix. Two methods of internal
resequencing are available. When the USET, SIL, EQEXIN, and PARTVEC data blocks and
SETNAME parameter are available, the resequencing is done in a grid point basis. These data
blocks allow correlation of row numbers in the a-set with grid point numbers. When any of these
data blocks are missing the resequencing is done on a degree-of-freedom basis, potentially 6 times
larger in size and requiring the square of this quantity for memory. The grid point option requires
less memory and is appreciably faster than the degree-of-freedom option.
3. In all eigensolution methods READ will calculate rigid body modes accurately without the
presence of SUPORTi entries in the Bulk Data Section. The SUPORTi entries define the r-set, the
reference set for rigid body modes. If all of the input blocks associated with the r-set are input
properly, the static shapes input in the DAR data block are used to compute rigid body modes. If
the calculated frequencies associated with these modes are small numbers, they are reset to binary
zero.
• Modern r-set introduced in Version 70.5:
DXR has the same number of rows as KXX and both are partitioned from DAR and KAA using
PARTVEC. DAR is the motion of the a-set variables due to unit motion of each r-set point,
successively, as calculated by static analysis and ignoring mass effects. Linear combinations of
these shapes are used for rigid body mode shapes that are orthogonal with respect to the mass
matrix.
5($' .;; 0;; 05 ';5 '<1$0,& 86(7 &$6(&& 3$579(& 6,/
,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
• Obsolete r-set processing as in Version 70:
Main Index
READ 1315
Extracts real symmetric system eigenvalues
DMX and VACOMP are used for special r-set processing based on the r-set rows being added to
DMX in the READ module. DMX is partitioned from DM in the way KXX is partitioned from
KAA. In other words, the same degrees-of-freedom are partitioned for both KXX and DMX. The
modern method uses DAR instead, with the r-set rows included in DAR.
5($' .;; 0;; 05 '0; '<1$0,& 86(7 &$6(&& 3$579(& 6,/
VACOMP,,LLL,EQEXIN/
LAMA,PHA,MI,OEIGS/
FORMAT/S,N,NEIGV//FLUID $
Use of this obsolete format is no longer recommended, and provisions for it may be removed
from the code in a future version. Refer to old documentation for a description of this obsolete
form.
4. For the Lanczos and INV methods KAA may be indefinite and MAA must be at least positive
semidefinite. For the unmodified tridiagonal methods (for example, HOU) KAA may be
indefinite, but MAA must be non-singular. For the modified and auto tridiagonal methods (for
example, MHOU and AHOU) MAA may be singular when [KAA + lambda*MAA] is non-
singular. Lambda is an internally calculated shift. The matrix sum will be singular or approach
singularity only when the system contains massless mechanisms. A shaft model made with bar
elements using point masses is an example of a system with a massless mechanism. The torsion
DOFs are not constrained to ground, and the point masses provide no rotary inertia. See the
MODERS subDMAP for the auto-omit DMAP steps used to remove rows and columns with null
mass for the tridiagonal methods. This makes the modified methods more efficient, and removes
some (but not all) possible causes of singularity in the mass matrix.
5. For the Lanczos and Sturm Inverse methods, LAMA and PHA may also be input if the APPEND
mode is being used.
6. LAMA and OElGS are suitable for OFP output.
7. MI may not be purged.
8. Parallel processing in this module (Householder method only) is selected with the NASTRAN
statement keyword PARALLEL (or SYSTEM(107)), see the <emphasis>MSC Nastran Quick
Reference Guide, Section 1.
9. If an r-set is present and special processing of rigid body modes is desired then it is recommended
that DAR have the same number of rows as KAA. If not, then either MR, USET, or VACOMP
should be specified.
10. For more detailed information on parameters F1 through NORM, please refer to the descriptions
of the EIGR and EIGRL Bulk Data entries in the <emphasis>MSC Nastran Quick Reference
Guide.
11. For the Lanczos method:
• By default, the Lanczos method uses sparse matrix methods. To use regular matrix methods
specify SPARSE = 1 on the NASTRAN statement or specify PUTSYS (126,1) just prior to the
READ module.
Main Index
1316 READ
Extracts real symmetric system eigenvalues
• 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.
12. If SID=-2, then NE is used to modify the ND parameter. ND is modified accordingly:
ND*(1+NE/100)
13. For the Lanczos (METH='LAN') and Householder (METH='HOU', 'MHOU', and 'AHOU')
methods, if the problem can fit into memory then a "QL" Householder eigensolution will be
performed. If the problem cannot fit in memory then the old method is used because the "QL"
method does not have spill capability.
The criterion for switching from the requested method to the "QL" method is controlled system
cell 359 and the NE parameter. The default value for system cell 359 is 1 which means:
• if METH='LAN' is requested, the program wil automatically switch to AHOU when the size of
the problem less than or equal to NE.
• if METH='HOU', 'MHOU', and 'AHOU' then the program will automatically switch to the "QL"
solution if the problem will fit in memory.
Examples:
1. Suppose the user has a matrix 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
RESMOD 1317
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
1318 RESMOD
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 BC
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
RESMOD 1319
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:
Main Index
1320 RESMOD
Perform linear algebra functions to support residual vector calculations
T
I0 M U0 = computational zeros
T
U1 M U1 0.0
4. U and M must be real.
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 $
Main Index
RESMOD 1321
Perform linear algebra functions to support residual vector calculations
U A set of vectors.
PHI Modal vectors.
MXX Mass matrix, physical degrees of freedom.
MQQ Mass matrix, modal degrees of freedom.
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
1322 RESTART
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.
Main Index
RESTART 1323
Data block comparison
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.
PRTUNIT Input-integer-default=0. Fortran unit flag to print differences betwee DB1 and
DB2.
=0 Print to f04.
<>0 Print to f06.
Remarks:
1. Any or all input data blocks may be purged.
2. If DLSTIN is not purged, the DB1 and DB2 must be purged.
3. If DBI and DB2 are not purged, the DLSTIN must be purged.
4. If INVOKE = TRUE then RESTART also deletes data blocks according to the data dependencies
(see DEPEN (Ch. 3)). Only data blocks with the current values of qualifiers for the path given by
DBi are deleted. If the paths of DBi and the path of the data block to be deleted differ, then all
intersecting qualifiers use the current value and the remaining nonintersecting qualifiers use the
wildcard (*) to determine deletion.
Example:
In this example, GEOM1 and GEOM2 are compared to the restart versions defined in the DBVIEW
statement. Changes are marked within the HIST file. Deletions are performed after SEID is set.
FILE HIST=APPEND $
PROJVER //’RESTART’/S,N,RESPRJ/S,N,RESVER/S,N,EXIST $
DBVIEW GEOM1R = GEOM1 (WHERE VERSION=RESVER) $
DBVIEW GEOM2R = GEOM2 (WHERE VERSION=RESVER) $
RESTART GEOM1,GEOM1R,/HIST/ $
Main Index
1324 RESTART
Data block comparison
RESTART GEOM2,GEOM2R,/HIST/ $
SEID = SEDWN $
RESTART,,,HIST//TRUE $
Main Index
RMDUPBLK 1325
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:
3. Only the CORD2C, CORD2R, CORD2S, and GRID Bulk Data entries are checked and
candidates for deletion.
Main Index
1326 RMG2
Processes radiation exchange coefficients
Processes radiation exchange coefficients to produce temperature heat flux transfer matrices.
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 1327
Processes radiation exchange coefficients
2 No radiation.
-1 Initial radiation.
1 Single band radiation with constant emissivity.
2 Radiation with temperature dependent emissivity.
3 Multiple band radiation with constant emissivity.
LUSET Input-integer-no default. The number of degrees-of-freedom in the
g-set.
Remark:
If KGGNL is not purged then LUSET is determined from KGGNL.
Main Index
1328 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 1329
Process rotordynamics Bulk Data input
Main Index
1330 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
Main Index
ROTRDR1 1331
Creates coriolis and circulation matrices
Parameters:
RECNUM Input/output-integer-default=1.
ROTORID Input/output-integer-default=0.
CONFAC Input-real-default=1.0E-5.
WTMASS Input-real-default=0.0. Scale factor on structural mass matrix.
METHSID Output-integer-default=0. Eigenvalue extraction entry set
identification number.
SDAMPSID Output-integer-default=0. Modal damping (TABDMP1) entry set
identification number.
Main Index
1332 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 1333
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
1334 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 1335
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,NLHI
C $
Parameters:
NHARM Output.
NHSUBFAC Output.
NLHIC Ouptut.
Option IOPT = 3
Format:
ROTRUTL CASECC,ROTOR,,,,/ROTORX,,/3//SPEED $
Main Index
1336 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 1337
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,NROTORS
E $
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
1338 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 $
Main Index
ROTRUTL 1339
Perform various utilities for rotordynamics processing.
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 $
Parameters:
NHARM Input.
FREQ Input.
CONDIV Input.
ISUBFAC Input.
Option IOPT = 10
Format:
ROTRUTL ,,,,,/MFCDISP,MFCVELO,/10/NHARM//NHPLUS $
Main Index
1340 ROTRUTL
Perform various utilities for rotordynamics processing.
Parameters:
NHARM Input.
NHPLUS Input.
Option IOPT = 11
Format:
ROTRUTL U,PTVEC,MFCDISP,MFCVELO,,/UT,VT,/11 $
U Solution matrix.
PTVEC Partitioning vector.
MFCDISP Matrix of cosines and sines to convert Fourier coefficients to time
domain displacements.
MFCVELO Matrix of cosines and sines to convert Fourier coefficients to time
domain velocities.
Option IOPT = 12
Convert U (fourier components of d-set) into TIC records to be used in a transient response analysis
Main Index
ROTRUTL 1341
Perform various utilities for rotordynamics processing.
Format:
ROTRUTL DYNAMIC,BGPDT,EVEC,U,,/,,/12/TICID/FREQ/NHARM
$
Parameters:
TICID Input.
FREQ Input.
NHARM Input.
Option IOPT = 13
Format:
ROTRUTL DIT,,,,,/,,/13/SDAMP/S,N,TR/S,N,INFOR $
Parameters:
SDAMP Input.
TR Output.
INFOR Output.
Main Index
1342 ROTRUTL
Perform various utilities for rotordynamics processing.
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
RSPEC 1343
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// $
Main Index
1344 RSPEC
Converts transient response motion for plotting
ENDIF $ RECORD>=0
ENDDO $ RECORD<>-1
Main Index
SCALAR 1345
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
1346 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 1347
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,AED
BINDX,PRBDOFS/
STBDER,UXDIFV/
MACH/Q/AECONFIG/SYMXY/SYMXZ/LPRINT $
Main Index
1348 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 1349
Computes solution and single-point forces
Computes and appends the solution (displacements, velocities, acceleration) and single-point forces of
constraint at the g-set for each boundary condition. Also appends applied loads.
Format:
SDR1 USET,PG,UL,UOO,YS,GOA,GM,PS,KFS,KSS,QR,KGG/
UG,PGT,QG/
NSKIP/APP/NOQG $
Main Index
1350 SDR1
Computes solution and single-point forces
Parameters:
NSKIP Input-integer-no default. The first subcase of the current boundary condition.
APP Input-character-no default. Analysis type.
Allowable values:
'STATICS' Statics.
'REIG' Normal modes.
'FREQRESP' Frequency response.
'TRANRESP' Transient response.
'CEIGEN' Complex eigenvalues.
'MMREIG' Normal modes for matrix method.
'BKL0' Pre-buckling (statics).
'BKL1' Buckling.
'DYNAMIC' Dynamics.
NOQG Input-integer-default=0. Single point forces of constraint matrix creation flag.
Default of 1 requests computation of the forces. Specify -1 to request no
computation.
Method:
Static Analysis
In the case of static analysis, SDR1 recovers dependent displacements
ul
ua (5-40)
ur
ua
uf (5-41)
uo
where
u o = G oa
t u + u o
a o (5-42)
uf
un (5-43)
Ys
Main Index
SDR1 1351
Computes solution and single-point forces
un
ug (5-44)
um
where
u m = G mn u n (5-45)
T
q s = K fs u f + K ss Y s – P s (5-46)
Eigenvalue Analysis
In the case of eigenvalue analysis SDR1 recovers dependent components of the eigenvectors
o = G oa a (5-47)
a
- = f
---- (5-48)
o
f
- = n
---- (5-49)
s
m = G mn n (1)
n
- = g
----- (5-50)
m
and single-point forces of constraint
T
q s = K fs f (5-51)
q s = K sf – 2 M sf f (5-52)
Remarks:
1. If NSKIP is greater than 1 and the outputs are declared APPEND on the FILE statement than the
outputs will be appended to outputs from prior executions of SDR1.
2. PG, YS, QR, and PS may be purged.
Main Index
1352 SDR1
Computes solution and single-point forces
Main Index
SDR2 1353
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
1354 SDR2
Creates data recovery output tables
Main Index
SDR2 1355
Creates data recovery output tables
Parameters:
Main Index
1356 SDR2
Creates data recovery output tables
Main Index
SDR2 1357
Creates data recovery output tables
Remarks:
1. Any output may be purged.
2. CSTM may be purged if no coordinate systems are referenced, or if stresses and/or forces are not
requested.
3. MPT and EST may be purged if there are no requests for element stresses, strains, or forces.
4. DIT may be purged if no stress or force requests are present or if no temperature dependent
materials are referenced.
5. SDR2 can also process p-set matrices (UP, QP, and PP instead of UG, QG, and PG) as long as
EQDYN and SILD are specified. Otherwise, SILD may be purged.
6. ETT may be purged if no thermal loading exists, or there are no requests for stresses or forces.
7. EDT may be purged if there are no element requests for forces or stresses, or if there are no
enforced element deformations in the problem.
8. BGPDT may be purged if all displacement (global) coordinate systems are in the basic coordinate
system and if there are no requests for element stresses, strains, or forces exist. However, PUG
will not be computed.
9. LAMA or CLAMA may not be purged if an eigenvalue or frequency response problem exists.
10. EQEXIN and XYCDB may be purged.
11. If SORT2 format is desired for the outputs then the parameter SORTFLAG must be set to 2 and
the input data blocks UG, QG, and QMG must be in their transposed form.
Main Index
1358 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
SDRCOMP 1359
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/APPFLAG/SRTFLAG
Main Index
1360 SDRCOMP
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
SDRHT 1361
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,APPLOD/
HOEF1,HOES1/
TABS/SIGMA/NORADMAT $
Main Index
1362 SDRHT
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
SDRNL 1363
Performs stress data recovery for nonlinear elements
Format:
SDRNL CASECC,ESTNL,ELDATA,UNUSED4,UNUSED5,UNUSED6,UN
USED7,
CSTM,UGNI,BGPDT/
OESNL1,OESNLB1,UNUSED3/
NLTYPE/UNUSED2/UNUSED3/NSKIP/LINC/UNUSED6/UNUS
ED7/
UNUSED8 $
Parameters:
Main Index
1364 SDRNL
Performs stress data recovery for nonlinear elements
Main Index
SDRP 1365
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
1366 SDRP
Computes data for p-elements
Main Index
SDRP 1367
Computes data for p-elements
Parameters:
ADPTEXIT Input-logical-no default. Set to TRUE if this is the final adaptivity loop.
ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element
analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.
APP Input-character-no default. Analysis type. Allowable values:
'STATICS' Statics.
'REIGEN' Normal modes.
'FREQ' Frequency response.
'TRANSNT' Transient response.
'CEIGEN' Complex eigenvalues.
SDRPOPT Input-character-no default. Principal stress/strain computation selection:
'SDRP' Compute in SDRP.
'OFP' Compute in OFP.
PVALID Input-integer-no default. p-value set identification number.
DESCYCLE Input-integer-no default. Design cycle analysis counter.
ADPTINDX Input-integer-no default. p-version analysis adaptivity index.
ODESMAX Input-integer-no default. Total number of design cycles performed.
OADPMAX Input-integer-no default. Total number of adaptivity cycles performed.
SEID Input-integer-no default. Superelement identification number.
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
1368 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 1369
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
1370 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 1371
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
1372 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 1373
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
1374 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:
Example:
Excerpt from subDMAP DESINIT:
DBVIEW EDOMF=EDOMS WHERE (wildcard) $
Main Index
SDSB 1375
Generates superelement processing list
Main Index
1376 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 1377
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.
0 Convert and echo all converted entries in the f06.
>0 Convert and echo the first n converted entries in the f06 where n is the value of system cell
350.
Main Index
1378 SEDR
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
SEDR 1379
Partitions tables for superelements
PCDBDR Table of model (undeformed and deformed) plotting commands for the
superelement (identification number equal to output value of SEID).
XYCDBDR Table of x-y plotting commands for a superelement (identification
number equal to output value of SEID).
VA Velocity matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID).
AA Acceleration matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID).
Parameters:
Main Index
1380 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 $
Main Index
SEDRDR 1381
Drives superelement data recovery loop
Parameters:
Main Index
1382 SEDRDR
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.
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 1383
Generates band information for EFM
Generates the partitioning vectors and band information for energy flow modeling (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
1384 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 1385
Calculates EFM values for a band
Main Index
1386 SEEFMDMP
Generates parameters for EMF
Generates mass values, damping loss factors, and frequency-dependent damping criteria for energy flow
modeling (EFM).
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 1387
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
1388 SEEFMNOR
Generates partitioning vector and shell normals for EFM
Generats the partitioning vector for extracting the grid point translational DOFs from all the DOF in the
superelement as well as to generate a matrix of superelement grid point shell normal vectors.
Format:
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 1389
Print output from the Energy Flow Modeling (EFM) analysis
SEEFMOUT Print output from the Energy Flow Modeling (EFM) analysis
Format:
SEEFMOUT EFMLIST,EFMASMTT,EXCITEFX,BANDLIST,
MNRGYMTF,APIMATT,RESMATFT/ $
EFMLIST Table containing list of superelements for which energy flow modeling
calculations are to be performed.
EFMASMTT Matrix of mass values for all EFM superelements.
EXCITEFX Matrix of power or force input for all EFM superelements.
BANDLIST Table of mode information for all bands.
MNRGYMTF Matrix of modal energy values for all EFM superelements for all
bands.
APIMATT Matrix of average power input per unit force for all EFM
superelements for all bands.
RESMATFT Matrix of average velocity respons for all EFM superelements for all
bands.
Parameters:
None.
Main Index
1390 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 1391
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
1392 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 1393
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
1394 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 1395
Constructs superelement map table
Format:
SEP1 GEOM1,GEOM2,GEOM4,EQEXIN,BGPDT,CSTM,CASECC,SET
REE/
SEMAP,SCSTM/
S,N,NOSE/CONFAC/LST2REC $
Parameters:
Main Index
1396 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 1397
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*,BND
FIL/
SEMAP,SGPDT,SCSTM/
S,N,NOSE/CONFAC/QUALNAM/QUALVAL/S,N,RSFLAG/
NQSET/EXTNAME/S,N,SEP1XOVR/NQMAX/SEBULK/TOLRSC
/
S,N,SWCHECK/ATQSET/S,N,RUNSEP2X $
Main Index
1398 SEP1X
Constructs superelement map table
Parameters:
Main Index
SEP1X 1399
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
1400 SEP2
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
SEP2 1401
Partitions tables for each superelement
Parameters:
Main Index
1402 SEP2CT
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
SEP2DR 1403
Drives superelement generation, assembly, and reduction loop
Drives the superelement generation, assembly, and reduction loop. Also drives the pseudo-load
generation loop.
Format:
SEP2DR
SLIST ,6(0$3
DSLIST
S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,LASTSE/S,N,NOM
AT/
S,N,NOASM/S,N,NOLOAD/S,N,NOLASM/S,N,NOUP/S,N,S
CNDRY/
S,N,EXTRN/S,N,NOMR/SEP2CNTL/S,N,NOPSLG/NOPGHD/
S,N,PARTSE/S,N,SETYPE/S,N,RSEID/NSENQSET $
Main Index
1404 SEP2DR
Drives superelement generation, assembly, and reduction loop
Parameters:
Main Index
SEP2DR 1405
Drives superelement generation, assembly, and reduction loop
Main Index
1406 SEP2DR
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
SEP2X 1407
Partitions tables for each superelement
Format:
SEP2X GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,SLIST,SEMAP,CA
SES,
DYNAMIC,UNUSED11,SGPDT,SCSTM,MATPOOL/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,SGPDTS,UNUSED9,DYNAMICS,MATPOOLS,UNUSED12
/
SEID/METHCMRS/SEP1XOVR $
Main Index
1408 SEP2X
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
SEP3 1409
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
1410 SEP3
Examines Case Control and determines superelement processing
Remark:
If there are no superelements, then SLIST is not created and may be purged.
Main Index
SEP4 1411
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
1412 SEP4
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
SEPLOT 1413
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
1414 SEPLOT
Assembles plot displacement matrices for superelements
Parameters:
Example:
Excerpt from subDMAP SUPER3:
DBVIEW BGPDTF=BGPDTS WHERE (PEID=* AND MODLTYPE='STRUCTUR') $
DBVIEW ECTF=ECTS WHERE (PEID=* AND MODLTYPE='STRUCTUR') $
DO WHILE ( PLTCNT>-1 ) $
SEPLOT PCDB,EMAP,scstm,BGPDTF,ECTF,PUGF/
BGPDTX,PUGX,PLTXY,PLTPARY,GPSETSY,ELTSETSY/
'PEID'/'SEID'/S,N,PLTCNT/S,N,NSILS/S,N,JPLOT $
PRTMSG PLTXY//PDRMSG $
IF ( JPLOT>=0 ) THEN $
PLOT PLTPARY,GPSETSY,ELTSETSY,CASECC,BGPDTX,
PUGX,PUGX,gpect,oes1x/
PLOTY2/NSILS/0/JPLOT/-1/S,N,PFILE $
PRTMSG PLOTY2//PDRMSG $
ENDIF $ JPLOT>=0
ENDDO $ PLTCNT>-1
Main Index
SEPR1 1415
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
1416 SEQP
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,GEO
M2X,
GEOM4X/
SEQOUT/SEQMETH//SUPER/FACTOR/
MPCFLG/START/MSGLVL/PEXIST/PSEQOPT/S,N,NTIPS/A
PP/
S,N,ZCOLLCT/S,N,TIPSCOL/ACMS/S,N,FLUIDSE/ATQSE
T/ PARTMEM $
SEQP MAT,GPL,USET,SIL/SEQMAP,,,,,/
SEQOUT/SEQMETH/SETNAME $
Main Index
SEQP 1417
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
1418 SEQP
Resequencing processor
Parameters:
Main Index
SEQP 1419
Resequencing processor
Main Index
1420 SEQP
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
6. Description of SUPER:
• If PARAM,SUPER=0, all grid points from the connection table that are not part of the group
currently being processed are deleted. This option provides for sequencing only the interior
points of a superelement. If any superelements are present, the residual structure is not
resequenced. If all of the grid points are in the residual structure, they are resequenced.
• If PARAM,SUPER=0 or 1, all grid points in the connection table are considered. This option
provides for the recognition of passive columns.
• If PARAM,SUPER=2, then all points that are connected to multipoint constraints (via MPC
entries) or rigid elements (e.g., the RBAR entry) are placed in a special group at the end of the
sequence. This option also forces SEQMETH=6 and may not be selected with other values of
SEQMETH. This option is intended primarily for models that have many active columns due to
MPCs or rigid elements; e.g., a model with disjoint structures connected only by MPCs or rigid
elements. See Matrix decomposition with extended diagnostics (Ch. 3) in the MSC.Nastran
Numerical Methods 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.
Main Index
SEQP 1421
Resequencing processor
If GRP=0, use GRP(MAX)+1 where GRP(MAX) is the largest group sequence number
previously processed.
8. START specifies the input sequence will be the sorted order of the grid point numbers including
the effect of any SEQGP entries input by the user. A single SEQGP entry can be input to select
the starting point for the new sequence. Otherwise, the first point of lowest connectivity will be
used as the starting point
9. PSEQOPT has the following values and actions:
• PSEQOPT='APPEND'. The list of all p-element grids at the bottom after all the regular grids.
APPEND is intended for p-element analysis with p-version preconditioning, i.e., SEQMETH =
5, 6 or 7.
• PSEQOPT='INSERT'. Insert the p-element grids in appropriate locations immediately after the
regular grid point to which they are associated which is the default in p-element analysis.
INSERT is intended for p-element analysis without p-version preconditioning, i.e., SEQMETH
= -1, 1, 2, 3 or 4.
Example:
The following example will generate a mapping matrix (SEQMAP) to resequence the matrix KAA. The
following SMPYAD module will resequence the rows and columns of KAA. Following the
decomposition of the resequenced matrix (KAAX), the MPYAD will resequence the right-hand side (PA)
and FBS will perform the forward/backward substitution on the resequenced right-hand side (PAX). The
final MPYAD operation will return the solution (UAX) to the original sequence (UA).
SEQP KAA,,,/SEQMAP,//METHOD $
SMPYAD SEQMAP,KAA,SEQMAP,,,/KAAX/3////1////6 $
DECOMP KAAX/LAA,/ $
MPYAD SEQMAP,PA,/PAX/1 $
FBS LAA,, PAX/UAX/ $
MPYAD SEQMAP,UAX,/UA/ $
Main Index
1422 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 1423
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
1424 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 1425
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 A = C and TA = 1 ; i.e.,
T
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:
T
1. Compute X = A B C – F .
SMPYAD A,B,C,,,F/X/3/1/-1/0/0/1 $
T T T T
2. Compute Z = – U V W X Y [Z].
SMPYAD U,V,W,X,Y,/Z/5/-1/0/0/1/1/1/1 $
T
3. Compute M .
SMPYAD PHI,MAA,PHI, ,,/X/3////1////6 $
Main Index
1426 SOLVE
Linear system solver
T T
Solves the matrix equation A X = B or the left-hand solution X A = B .
Format:
SOLVE A,B,SIL,USET,PARTVEC/
X/
SYM/SIGN/SETNAME $
Parameters:
Main Index
SOLVE 1427
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 $
T T
3. Solve X A = P .
SOLVE A,P,,,/X/2 $
Main Index
1428 SOLVIT
Iterative solver
Solves the matrix equation A X = B ] for X using a preconditioned conjugate gradient method.
SOLVIT A,B,XS,PC,USET,KGG,GM,SIL,EQEXIN,EDT,CASECC,EQ
MAP,
BGPDT,CSTM,PG,YS,KDICT,KELM,EST,MPT,DIT/
X,R,PC1,EPSSE/
SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/
NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID
EBSOPT/CVMEM/CASPIV/SET $
SOLVIT A,B,XS,PS,USET,USET0,SIL0,SIL,EQEXIN,EDT,CASEC
C,
EQMAP,,,,,,,,,/
X,R,PG,EPSSE/
SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/
NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID $
Main Index
SOLVIT 1429
Iterative solver
Main Index
1430 SOLVIT
Iterative solver
Parameters:
Model Type of
IPAD Method ITSOPT type A
0 reduced incomplete Cholesky 3 all real
2 block incomplete Cholesky 10,11 3-D real
Main Index
SOLVIT 1431
Iterative solver
Model Type of
IPAD Method ITSOPT type A
3 block incomplete Cholesky 10,11 2-D or real
mixed
5 block incomplete Cholesky 10,11 all complex
Main Index
1432 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.
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:
Main Index
SOLVIT 1433
Iterative solver
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
1434 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,CASEC
C,
DIT,UG,DEQATN,DEQIND,GPSNT,CSTM0,SCSTM,GEOM4,E
STL,
SLTNL0,KGG,USET/
PG
, PTELEM,SLTH,SLTNL,PGRV/
AG
LUSET/NSKIP/DSENS/APP/ALTSHAPE/TABS/SEID/
COMBMETH/LGDISP/NONLNR/OGRAV $
Main Index
SSG1 1435
Computes static load matrix
Main Index
1436 SSG1
Computes static load matrix
Parameters:
Main Index
SSG1 1437
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.
2. In SLTH the heat transfer loads REFERENCING ELEMENTS (QVOL, QBDY1, QBDY2,
QBDY3 and QVECT Bulk Data entries) have been converted to applied load factors and
connected grid points.
3. SLT and BGPDT cannot be purged if external static loads or LOAD Bulk Data entries are selected
in CASECC.
4. CSTM cannot be purged if any grid point or load references a coordinate system other than basic.
5. EST and MPT cannot be purged if thermal or element deformation loads are selected.
6. ETT cannot be purged if thermal loads are applied.
7. EDT cannot be purged if element deformation loads are selected.
8. MGG cannot be purged if GRAV or RFORCE loads are applied.
9. DIT cannot be purged if temperature-dependent materials are present.
10. UG may be purged, but geometric nonlinear effects will be ignored.
11. PTELEM may be purged.
12. CSTM0 and SCSTM are required to support the MB=-1 on the GRAV and RFORCE Bulk Data
entries.
Main Index
1438 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 1439
Reduces static load and enforced displacement matrices
Pn
Pg = (5-53)
Pm
T
P n = P n + G mn P m (5-54)
Pf
Pn = (5-55)
Ps
P f = P f – K fs Y s (5-56)
Pa
Pf = (5-57)
Po
T
P a = P a + G oa P o (5-58)
P a = P a – L ao D oo u ox (5-59)
L oo D oo u ox = P o (5-60)
for PARAM,ALTRED,NO.
Remarks:
1. GM cannot be purged if the m-set is present.
2. DM cannot be purged if the r-set and l-set are present.
3. PO cannot be purged if the o-set is present.
4. PS cannot be purged if the s-set is present.
5. QR and PL may be purged.
6. If there is no m-set, s-set, o-set, or r-set. then no outputs are produced.
7. If QR or PS are computed to be null then QR or PS will be purged.
8. If there is no r-set and PL is specified then PA will be copied to PL.
Main Index
1440 SSG2
Reduces static load and enforced displacement matrices
9. If KFS or YS is purged then the outputs will not include the effect of enforced displacements.
Main Index
SSG3 1441
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
1442 SSG3
Computes static solutions
Method:
The SSG3 module (Static Solution Generation -- Phase 3) solves the equation
K oo u oo = P o (5-61)
SSG3 also calculates the residual vector, P o , and the residual vector error ratio, o , for the omitted
coordinates
P o = K oo u oo – P o (5-62)
T
u oo P o
o = ------------------------------
- (5-63)
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 (5-64)
is calculated by the SSG3 module and printed under the heading “External Work.” This component of
strain energy includes effects of thermal loads, element deformations, and enforced displacements that
may be subtracted later in the solution process. For example, an enforced displacement that causes zero
strain will result in external work.
Remarks:
1. KLL may be purged if RUL is purged.
2. LOO, PO and UO may be purged if NOOSET<0.
3. KOO may be purged if NOOSET<0 or RUO is purged.
4. LLL or LOO may be purged.
Main Index
SSG3 1443
Computes static solutions
5. PO or PL may be purged.
6. RUL and RUO may be purged.
Main Index
1444 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 1445
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
1446 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 1447
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
1448 STATICS
Performs static analysis on real symmetric stiffness matrix
Parameters:
Remarks:
1. See the SOLVIT, 1428 module for further discussion related to the iterative method.
2. PC, XS, PC1, and RUG may be purged.
3. CASECC and EDT may be purged if NSKIP=-1.
4. ITSOPT, ITSMAX, and ITSEPSR are ignored if NSKIP>0.
Main Index
STDCON 1449
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/A
PP $
Parameters:
Main Index
1450 STDCON
Calculate stress discontinuities across elements and grid points
Main Index
STRSORT 1451
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
1452 STRSORT
Filters and sorts element data recovery tables
Remarks:
1. For further discussion see the DTI,INDTA and PARAM,S1 descriptions in the <emphasis>MSC
Nastran Quick Reference Guide.
2. SRTTYP=1 is used primarily to sort slideline element output by slave grid point identification
number.
Main Index
TA1 1453
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,N2M/
EST,ESTNL,GEI,GPECT,ESTL,VGFD,DITID,NFDICT,ESTNSM/
LUSET/S,N,NOESTL/S,N,NOSIMP/NOSUP/S,N,NOGENL/SEID/
LGDISP/NLAYERS/S,N,FREQDEP/PSHLDAMP/
S,N,MGEFLAG/NSMSID/xESTM/MultiPhy/LGDISPU/Texist $
Main Index
1454 TA1
Combines element data into tables
Parameters:
Main Index
TA1 1455
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.
a. PSHELL If SHLDAMP= ‘SAME’, then MIDi fields on the PSHELL entry will be
searched and the referenced MATi entries will be compared. If any are
different MGEFLAG is set to 2.
b. PBUSH Check the GE2 through GE6 values and if they are not uniform with respect
to GE1 exist then MGEFLAG is set to 1.
c. PBUSHT Check the TGEID2 through TGEID6 values and if they are not uniform
with respect to TGEID1 exist then MGEFLAG is set to 1.
d. If both a. and b. or c., then set MGEFLAG to 3.
Main Index
1456 TA1M
Map bulk data to advanced nonlinear data structures
Maps material, geometry, nodal and element information from bulk data-blocks into advanced nonlinear
data structures used for SOL400
Format:
ESTMG Element Summary Table for Advanced Nonlinear Elements : follows ESTM
GRPSTM Group Summary Table for Advanced Nonlinear Elements
Main Index
TA1M 1457
Map bulk data to advanced nonlinear data structures
MTSTM ummary table – contains offset data for advanced nonlinear elements and MATM
(advanced composites) data
MTSTM1, Material summary table – contains pointers, sizing and control parameters for
MTSTM2, materials associated with the advanced nonlinear elements
MTSTM3,
MTSTM4
MMTX, Element Data Tables for advanced nonlinear elements
MMTX1
NLVECM Non-Linear Vector Data including nodal temperatures, coordinate systems, tables,
orientations, beam section data
VCCTM Virtual Crack Closure Technique Data Table
GCOMM Global Common Block Data Table
GPECTH updated GPECT for Herrmann and Heat Shell Elements
Parameters:
Remarks:
1. TA1M is used in SOL 400 to map bulk data blocks into data structures for advanced nonlinear
elements. The nonlinear elements are triggered by the supplemental property cards PSLDN1,
PSHLN1, PSHLN2, PRODN1, PBARN1, PBEMN1 and PSHEARN.
Main Index
1458 TABEDIT
Performs editing operations on table data blocks
Edits an existing table data block according to user-input directives. String-formatted records are
generally not acceptable. Three types of editing operations are possible:
1. Delete, add, or replace entire records. New records come from the IFP module or from user input.
2. Delete, add, or replace word strings to a specified record. New data come from user input.
3. Merge-edit two records of fixed-length word groups such as would be generated by IFP.
Format:
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
TABEDIT 1459
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 position secondary
SRB,n data block TA, TB, or TC for a subsequent KR* operation.
SRC,n
MEA,i,n Merge-Edit the next record on TA, TB, or TC into record i according to
MEB,i,n IFP specifications for fixed-length word groups of length n.
MEC,i,n
INT Interrogate TOLD for number of records and number of words in each
record. Also print the first three words of each record.
Main Index
1460 TABEDIT
Performs editing operations on table data blocks
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 CR directive and
n words 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 directive the n words
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 position secondary data
SWB,n block TA, TB or TC for a subsequent KW* operation.
SWC,n
AWA,n Append n Words from TA, TB, or TC onto TNEW after copying the rest of
AWB,n the record specified by the CR directive.
AWC,n
KRA,n Kopy the Remaining contents of the current record from TA, TB, or TC
KRB,n onto TNEW.
KRC,n
ARA Append the Remaining contents of the current record from TA, TB, or TC
ARB onto TNEW after copying the rest of the record specified by the CR
ARC directive.
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
Main Index
TABEDIT 1461
Performs editing operations on table data blocks
A printout of GEOM1 using the TABPRT module (with OPT3=1) will show the following for record 1:
TABLE GEOM1
RECORD NO. 2
END OF FILE
TRAILER WORD1 = 0 WORD2 = 0 WORD3 = 8 WORD4 = 0 WORD5 = 0 WORD6 =
1. Note that the GRID entry for grid point 30 has an error in the y-location coordinate, which should
be 2.0 instead of 2.5. Make this correction without going through the conventional XSORT-IFP
process by using TABEDIT. Assume GEOM1 was saved on a user tape on the previous run as
GEOM1C.
DTIIN DTI,DTINDX/CONTROL,,,,,,,,, $
INPUTT2 /GEOM1C,,,,/-1 $
TABEDIT GEOM1C,CONTROL,,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END$
CEND
BEGIN BULK
DTI,CONTROL,1,CR,1,DW,23,23,1
,2.0
DTI,CONTROL,2,ER,ENDREC
ENDDATA
2. Repeat Example 1, assuming GEOM1 was saved on a previous run, by using record substitution.
DTIIN DTI,DTINDX/CON,,,,,,,,, $
TABEDIT XGEOM1,CON,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
Main Index
1462 TABEDIT
Performs editing operations on table data blocks
CEND
BEGIN BULK
DTI,CON,1,DR,1,ENDREC
DTI,CON,2,KRA,1,ENDREC
(all GRID entries, including the correction)
ENDDATA
3. Repeat Example 2 by using word substitution.
DTIIN DTI,DTINDX/CON,,,,,,,,, $
TABEDIT XGEOM1,CON,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
CEND
BEGIN BULK
DTI,CON,1,CR,1,DW,20,26,0
,SWA,3,KWA,7
GRID,30,0,2.0,2.0,0,3456,0
ENDDATA
4. Repeat Example 1, assuming GEOM1 was written onto a user file during the previous run, by
using the merge-edit feature.
DTIIN DTI,DTINDX/C,,,,,,,,, $
INPUTT2 GEOM1OLD,,,,/-1 $
TABEDIT GEOM1OLD,C,GEOM1,,/GEOM1X $
EQUIVX GEOM1X/GEOM1/ALWAYS $
END $
CEND
BEGIN BULK
DTI,C,1,MEA,1,8,ENDREC
GRID,30,0,2.0,2.0,0.0,0,3456,0
ENDDATA
Main Index
TABPRT 1463
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
1464 TABPRT
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).
Main Index
TABPRT 1465
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.
Main Index
1466 TABPRT
Formatted table printer
Format 2: (KEY=’USET’):
OPT1 Input-integer-default=0.
The degrees of freedom can be listed in ascending order according to their internal
or external sequence number, but not both. The external sequence number is the grid,
scalar, or extra point identification number. The internal sequence number is the
number assigned after resequencing.
For a given sequence there are two types of tables that may be printed: row sort and
column sort. For row sort, a table is printed for each set selected by USETSEL. Here
is an example of row sort (USETPRT = 0 or 10):
U S E T D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , R O
W S O R T )
A DISPLACEMENT SET
-1- -2- -3- -4- -5- -6- -7- -8- -
9- -10-
1= 2-1 2-2
Main Index
TABPRT 1467
Formatted table printer
For column sort, a single table is printed for the following sets: SB, SG,
L, A, F, N, G, R, O, S, M, E. Here is an example of column sort
(USETPRT = 1 or 11):
U S E T D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , C O L U
M N S O R T )
Decimal Decimal
Set Equivalent Set Equivalent
Name Number Name Number
Q 4194304 SB 1024
LM 2097152 SG 512
C 1048576 MR 16
J 524288 R 8
K 262144 O 4
Main Index
1468 TABPRT
Formatted table printer
Decimal Decimal
Set Equivalent Set Equivalent
Name Number Name Number
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.
Main Index
TABPRT 1469
Formatted table printer
0 Write CSUPER Bulk Data entries for residual structure but give SEID = -
OPT1.
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.
Main Index
1470 TABPRT
Formatted table printer
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
2. If OPT2 = 0,3 or 5 and TIMSIZ is supplied, then TABPRT will produce an estimation printout
for each superelement except the residual structure. The equations used along with the
semiempirical constants are printed as well as dominant CPU time estimates, space estimates, and
wall clock estimates. The user is cautioned that these estimates will be valid only for “large”
superelements and should be adjusted for anomalous characteristics.
Estimate totals are also provided at the end of the SEMAP printout. If ESTDATA is also supplied,
then the constants of the estimating equations are adjusted. This technique is described on the
Bulk Data entry DTI,ESTDATA.
3. Under Format 1, the generic data block name is used, but the actual DMAP name for the same or
equivalent information is also acceptable. For example, in the superelement solution sequence
data blocks BGPDTS, CSTMS, EQEXINS, and GPLS are created and may be printed with
TABPRT. If ‘FINDIT’ (default) is specified, the KEY will be taken from the header of the data
block.
Examples:
1. Print coordinate system transformation matrix table.
TABPRT CSTM//’CSTM’ $
2. Print grid point list table.
TABPRT GPL//’GPL’ $
3. Print basic grid point definition table.
TABPRT BGPDT// $
4. Print GEOM3X table with labels taken from DATABLK statement in the NDDL.
TABPRT GEOM3X//’GEOM3’///1 $
5. Print USET list for g-set and s-set in internal order using row sort.
TABPRT USET,BGPDT//’USET’/0/18 $
6. Print USET for the mutually exclusive sets in internal order using column sort.
TABPRT USET,BGPDT//’USET’/1 $
7. Print all SEMAP information except the grid list and secondary superelement boundary
sequencing list.
TABPRT EMAP//’SEMAP’/2/3 $
Main Index
TABPRT 1471
Formatted table printer
8. Punch CSUPER entries for the residual structure with SEID field set to 100.
TABPRT EMAP//’SEMAP’/-100/4 $
9. Print only estimation data for all superelements.
TABPRT EMAP,,TIMSIZ//’SEMAP’/-99999999/5 $
Main Index
1472 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 1473
Creates tables for follower force stiffness
Format:
TAFF SLT,BGPDT/
ESTF,GPECTF/
LUSET/LOADID/LOADIDP/LOADFACR/NBLOCK $
Parameters:
Main Index
1474 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
(37 6,/ (671/ *3(&7 ',7
TAHT 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 1475
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
1476 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 1477
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
1478 TASNP2
Computes grid point shell normal vectors at superelement boundaries
Parameters:
SNORM Input-real-no default. Maximum angle between grid point normal and shell normal.
If angle is less than SNORM then grid point normal will be computed.
SNORMPRT Input-integer-no default. Grid point shell normal print/punch flag.
0 No print or punch
1 Punch
2 Print only
3 Print and punch
SEID Input-character-no default. Superelement identification number.
QUALNAM Input-integer-no default. Name of qualifier to be used in selecting SNORMS.
EFMFLG Input-integer-default=0. Processing flag for how shell normals are computed on
superelement boundary points.
0 Compute the average all of the shell normals
1 Compute the resultant of all of shell normals
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 1479
Provide timing data
Provides timing data for various unit operations that may be used to compare and evaluate computer and
compiler performance.
Main Index
1480 TIMETEST
Provide timing data
Format:
TIMETEST TIMTS,A,B,C/TOUT,/N/M/T/OPT/CASE $
TIMETEST ,,,,/,/N/M/T/2/CASE $
TIMETEST ,,,,/,/N/M/T/2/CASE $
TIMETEST TIMTS3,,,/T3OUT,/N/M/T/3 $
TIMETEST TIMTS4,,,/T4OUT,/N/M/T/4 $
TIMETEST TIMTS5,,,/TOUT5,/N/5/1 $
TIMETEST TIMTS5,A,B,C/TOUT5,/N/M/T/5/2 $
TIMETEST T3OUT,T4OUT,T7OUT,T8OUT/TOUT6,/ / /
/6/CASE $
TIMETEST TIMTS3,,,,/TOUT7,/N/M/ /7 $
Main Index
TIMETEST 1481
Provide timing data
1 2 3 4 5 6 7 8 9 10
TIMT
DTI IREC CASE M N P
S3
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
TIMT ROW
DTI IREC CASE COLS DENS STRL
S4 S
IREC Record number (null records are ignored so records may be numbered by
tens for convenience in making in making changes).
CASE “A” normal case definition.
“B” indicates last case to be used in least squares solution for timing
constants.
Note: If no case value of B is found by the time the 10th case value is read, then the
10th case is treated as the last case to be used in the least squares solution for
timing constants.
Main Index
1482 TIMETEST
Provide timing data
TIMTS5 (for CASE=1 only) Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
TIMT
DTI IREC CASE ROWS COLS DENS TYPE STRL
S5
TIMTS5 (for both cases) Table created with DTI entries as follows:
1 2 3 4 5 6 7 8 9 10
TIMT METHO
DTI IREC CASE T CORE D
S5
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.
Main Index
TIMETEST 1483
Provide timing data
Main Index
1484 TIMETEST
Provide timing data
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
TOLAPP 1485
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
1486 TOLAPP
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
TRD1 1487
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,PDX
DVO/
UXT,PNL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/SETNAME/
NSOLT,NOTRLDFM/WTMASS $
Main Index
1488 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Main Index
TRD1 1489
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Parameters:
NOTRLDFM Input-integer-default=0. Fatal message flag when there the loads are null. See Remark
3.
0 Issue fatal message.
>0 Do no issue fatal message.
WTMASS Input-real-default=0.0. Scale factor on structural mass matrix.
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 (5-65)
Main Index
1490 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
M hh p 2 + B hh p + K hh u h = P h + P hnl (5-66)
1 1 1
D = -------2- M + --------- B + --- K (5-67)
t 2t 3
2 1
C = -------2- M – --- K (5-68)
t 3
–1 1 1
E = -------2- M + --------- B – --- K (5-69)
2t 3
t
is formed and saved.
The solution loops then proceed until a time step change occurs. The initial conditions are brought in and
the starting equation
1 1 1 1
D u 1 = --- P – 1 + P 0 + P 1 + N 0 + C u 0 + E u – 1 (5-70)
3
1
u –1 = u 0 – u· 0 t (5-71)
P 01 = K u 0 + B u· 0 (5-72)
Main Index
TRD1 1491
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
Note that the load computed at u = 0 is never used but is replaced by P 01 . u 2 through u n are
now computed from the general equation:
1
D U I + 2 = --- p I + p I + 1 + p I + 2 + N I + 1 + C u I + 1 + E u i (5-74)
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 (5-75)
where:
P i t = Su j t u k t (5-76)
S u j t A if u j t 0
Pi t = (5-77)
0 if u j t 0
NOLIN4 loads are computed as
– S – u i t A if u i t 0
Pi t = (5-78)
0 if u i t 0
The NOLIN5 loads are computed as
Main Index
1492 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
–1 4
P ga t A a – F ab Aa – F ab 1 – a E a A a U a + TABS
= – (5-79)
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.
1
u· i = --------- u i + 1 – u i – 1 (5-80)
2t
is output.
The acceleration vector is given by
1
u· i = -------2- u i + 1 + u i – 1 – 2 u i (5-81)
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 (5-67), (5-68) and (5-69) for t = t 2 .
1
D u i + 2 = --- P i1 + P i + 1 + P i + 2 + N i + 1 + C u i + 1 + E u i1 (5-82)
3
Main Index
TRD1 1493
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1
u· i + 1 = -------- u i + 1 – u i (5-83)
t 1
1
u·· i + 1 = -------2- u i + 1 – 2 u i + u i – 1 (5-84)
t 1
then
t 22
u i1 = u i + 1 – t 2 u i + 1 + -------- u·· i + 1
· (5-86)
2
P i1 = M u·· i + 1 + B u· i1 + K u i1 (5-87)
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:
1
D u i = --- P –11 + P 0 + P 1 + P 0 + C u n + E u –11 (5-88)
3
where
P 0 = K u n + B u· n + M u·· n (5-89)
2
t
u –11 = u n – t u· n + -------- u·· n (5-90)
2
Main Index
1494 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
and KHH are stored. The following data are necessary to solve the transient behavior of a modal
coordinate i .
12
oi = k i m i (5-93)
bi
i = --------
- (5-94)
2m i
2 2 2
i = oi – (5-95)
–5
The following coefficients are generated for each distinct time increment. There are four cases ( = 10
and the subscript i is implied.)
2 2
1. If o + (underdamped):
– h
F = e cos h + ---- sin h (5-96)
1
G = ---- e sin h (5-97)
2 2
1 –h – - 2
A = ---------- e ----------------- - + h cos h + 2
– h sin h – ---------- ----------- (5-98)
hk o 2
2o o
2
Main Index
TRD1 1495
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
2
– o – h
F' = --------- e sin h (5-100)
– h - sin h
G' = e cos h – --- (5-101)
1 – h 2
A' = ---------- e + h o sin mh + cos h – (5-102)
hk
1 – h
B' = ---------- – e sin h + cos h + (5-103)
hk
2 2
2. If o + (critically damped):
– h
F = e 1 + h (1)
– h
G = he (5-104)
1 1 –h
A = ------ --2- – --- e 2 + 2h + h
2 2
(5-105)
hk
1 – h
B = --------- – 2 + h – e 2 + h (5-106)
hk
2 – h
F' = he (5-107)
– h
G' = e 1 + h (5-108)
1 –h 2 2
A' = ------ e 1 + h + h – 1 (5-109)
hk
1 – h
B' = ------ 1 – e h + 1 (5-110)
hk
2 2
3. If o – (over damped):
– h -
cosh h + sinh h
F = e --- (5-111)
1 –h
G = ---- e sinh h (5-112)
Main Index
1496 TRD1
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
1 – h + 2
2 2
A = ---------- e – ------------------ - + h cosh h + 2
– h sinh h – ---------- ----------- (5-113)
hk o
2 2 o
2
o
1 - –h 2 + 2
B = --------- e – ------------------ sinh h + 2
----------- + cosh h + h – 2
----------- (5-114)
hk
2
2
2
o o o
2
–h
F' = – -----o- e sinh h (5-115)
– h - sinh h
cosh h – ---
G' = e (5-116)
1 – h 2
A' = ---------- e + h o sinh h + cosh h – (5-117)
hk
1 – h
B' = ---------- e sinh h + cosh h + (5-118)
hk
4. If o = (undamped):
F = 1 (5-119)
G = H (5-120)
2
A = h 3m (5-121)
2
B = h 6m (5-122)
F' = 0 (5-123)
G' = 1 (5-124)
A' = h 2m (5-125)
B' = h 2m (5-126)
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 (5-127)
Main Index
TRD1 1497
Solves for modal/direct, transient, displacement, velocity, and acceleration solution
·
·· P i j + 1 b i i j + 1 K i i j + 1
i j + 1 = --------------- – ------------------- – -------------------- (5-129)
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
1498 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/SETNA
ME $
Main Index
TRD2 1499
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
1500 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 1501
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.
Parameters:
Main Index
1502 TRLG
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.
Main Index
TRLG 1503
Generates applied loads in transient analysis
If TOUT=2 and PXT is specified then PPT, RPX, and V01P must be present. GMD, GOD, PST,
PDT, and PDT1 may be purged.
2. MGG and MPT may be purged if there are no GRAV or RFORCE and PLOAD1 records in SLT,
respectively or SLT is purged.
3. DLTH and SLT may be purged.
4. If LSEQ entries exist, then SLT should be purged in order to avoid doubling of the LSEQ loads.
Main Index
1504 TRNSP
Matrix transpose
T
Computes X = A .
Format:
TRNSP A/X $
A Matrix A .
X Matrix transpose of A .
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 1505
Declares NDDL data blocks, qualifiers, and parameters.
The TYPE DMAP statement performs three different functions, depending on its format:
1. Identifies NDDL data blocks.
2. Specifies the type and authorization of NDDL parameters, qualifiers, and location parameters.
3. Specifies the type and authorization of local parameters.
The TYPE statement is a nonexecutable statement, but must appear before any NDDL data block,
parameter, qualifier, or location parameter; or any local parameter that relies on the TYPE statement to
identify its type and authorization.
The TYPE statement has the following formats:
Formats:
1. Data blocks:
7<3( '% GEOLVW
2. NDDL parameters, qualifiers and location parameters:
Main Index
1506 TYPE
Declares NDDL data blocks, qualifiers, and parameters.
Describers:
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
logical LOGICAL
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:
Main Index
TYPE 1507
Declares NDDL data blocks, qualifiers, and parameters.
CALL
MESSAGE
Assignment
Conditional (IF and DO WHILE)
DBVlEW module (WHERE clause if its not a qualifier)
3. Default values for NDDL parameters and qualifiers are specified on the PARAM and QUAL
NDDL statements and, if specified on the TYPE statement, result in a warning message.
4. With the exception of parameters declared as QUALifiers through the QUAL NDDL statement,
all NDDL parameters are stored immediately in the database on completion of a DMAP
assignment statement or the module S option.
5. As described under CALL DMAP statement, the (S,) option to save control and QUALifier
parameters is necessary to facilitate parallel and recursive processing.
6. Only the ptype is used on the TYPE PARM for parameters passed through a subDMAP argument
list. Also, default values are ignored.
7. It is recommended that all TYPE statements in a SUBDMAP appear immediately after the
SUBDMAP statement.
8. If NDDL data blocks passed through a SUBDMAP argument list are referenced on a TYPE DB
statement, then a fatal error will occur.
9. If data blocks not defined in the NDDL appear in a TYPE DB statement, then a fatal error will
occur.
10. If the parameter type and authorization specified on a TYPE statement do not match those
specified in a DMAP module, then a fatal error will occur.
11. If the parameter type specified on a TYPE statement does not match the type required by a DMAP
module, then a fatal error will occur.
12. Character parameters which appear on TYPE statements and also module instructions must be
defined with ptype CHAR8. For example:
TYPE PARM,,CHAR8,N,MAJOR,SETJ,COMP='COMP' $
MAJOR='G' $
SETJ='A' $
VEC USET/VGACOMP1/MAJOR/SETJ/COMP $
Use of other lengths, such as CHAR4, results in fatal termination.
Examples:
The following TYPE PARM statements show how parameters are typed in a subDMAP. Note the use of
comments.
$
$ QUALS
TYPE PARM,NDDL,I,Y,MODEL,SOLlD,SElD,BASE $
$ IFP PARAMETERS
TYPE PARM,NDDL,I,Y,ERROR,NOTRED,ASING,MODACC,FIXEDB,
BAILOUT $
TYPE PARM,NDDL,RS,,MAXRATIO $
Main Index
1508 TYPE
Declares NDDL data blocks, qualifiers, and parameters.
Main Index
UEIGL 1509
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
1510 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems
Parameters:
If SID<0, then both the UMETHOD command and all EIGUL entries
are ignored and the subsequent parameter values (F1, F2, etc.) will be
used to control the eigenvalue extraction.
F1 Input-real-default=0.0. The lower frequency/eigenvalue bound.
F2 Input-real-default=0.0. The upper frequency/eigenvalue bound. The
default value of 0.0 indicates machine infinity.
ND Input-integer-default=0. The number of desired eigenvalues.
EPS Input-real-default=0.0. Convergence criterion. By default EPS will be
set to N/10000 where N is the size of KXX, etc.
Remarks:
1. In certain MSC Nastran applications the eigenvalue problem presented contains real,
unsymmetric matrices. One such application, the direct structural acoustic problem is formulated
as:
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
where Kll is the structural stiffness matrix, real, symmetric positive definite, however, the Q ll
divergence matrix is real, unsymmetric.
2. The left-handed solutions of the two problems presented before are:
T 2
K aa + M aa = 0
for acoustics and
Main Index
UEIGL 1511
Solves both linear and quadratic real unsymmetric eigenvalue problems
T
K ll + Q ll = 0
for aeroelastic divergence.
Based on the physical principals of above problems, the eigenvectors are real and the eigenvalues
are either real (aeroelastic divergence) or pure imaginary (acoustics).
3. QXX is required if MXX is purged and vice versa.
4. XORTH, CLAMMAT, SVEC, BP, APL and, APU may be purged.
Main Index
1512 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
UMERGE 1513
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:
Main Index
1514 UMERGE
Merges two matrices based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions.
sets supersets
mp
m
mr
sb
sg s
o
g
q p
ne
r n
c a d f
t fe
b l
lm
e
k
ks
sa
js
j
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
UMERGE 1515
Merges two matrices based on USET
Main Index
1516 UMERGE1
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:
Main Index
UMERGE1 1517
Merges up to four matrices based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
sets supersets
mp
m
mr
sb
sg s
o
g
q p
ne
r n
c a d f
t fe
b l
lm
e
k
ks
sa
js
j
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
1518 UMERGE1
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
UPARTN 1519
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:
Main Index
1520 UPARTN
Partitions a matrix based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
sets supersets
mp
m
mr
sb
sg s
o
g
q p
ne
r n
c a d f
t fe
b l
lm
e
k
ks
sa
js
j
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
UPARTN 1521
Partitions a matrix based on USET
2. Extract PHRC, with rows corresponding to the union of the r and c-set, from PHTOM, with
rows corresponding to the union of the t, o, and m-sets.
a. UPARTNUSET,PHTOM/PHRC,,/'T+O+M'/'R+C'//1 $
3. Partition [KGG] into the q-set and its complement, columns only:
K gg K gq K gcomp
a. UPARTN USET,KGG/KGQ,,KGCOMP,/’G’/’Q’//2 $
Main Index
1522 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.
Remarks:
1. If PHDH is purged PH will not be output.
Main Index
UREDUC 1523
Reduces rectangular matrices from p-set (or g-set) to d- and/or h-set
2. GM (or GMD) and GOA (or GOD) may not be purged unless their m-set and
o-set degrees-of-freedom do not exist.
3. The method of reduction is equivalent to a combination of the DMAP modules UPARTN,
UMERGE1, MPYAD, and MCE2.
Main Index
1524 VDR
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
&$6(&&, 8;< 2/ ;<&'% 31/ 02
'6(/7 EQEXIN USET
VDR
OUXY1,OPNL1/
APP/SOLTYP/S,N,NOSORT2S/S,N,NOSOUT/S,N,NOSDR2/
FMODE/S,N,NOSORT2 $
Main Index
VDR 1525
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
1526 VEC
Creates partitioning vector based on USET
To create a partitioning vector based on degree-of-freedom sets. The vector may be used by the MERGE
and PARTN modules.
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:
Main Index
VEC 1527
Creates partitioning vector based on USET
Remarks:
1. The supersets formed by the union of other sets have the following definitions:
sets supersets
mp
m
mr
sb
sg s
o
g
q p
ne
r n
c a d f
t fe
b l
lm
e
k
ks
sa
js
j
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' $
3. Example 1 could also be accomplished by
Main Index
1528 VEC
Creates partitioning vector based on USET
VEC USET/V/'BITID'////'A' $
Main Index
VECPLOT 1529
Transforms, searches, and computes resultants of matrices
Performs utility functions on g-set size matrices, including computation of resultants, transformation
from one coordinate system to another, and generation of rigid body matrices.
Format:
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.
PGRES Same as RESMAX output in a prior execution of VECPLOT when PG
is input for XG and IOPT=1 or 8.
Main Index
1530 VECPLOT
Transforms, searches, and computes resultants of matrices
Parameters:
Main Index
VECPLOT 1531
Transforms, searches, and computes resultants of matrices
Remarks:
1. The table below describes the contents of XOUT and the printed output for each IOPT.
x' = u x + x
3 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.
Main Index
1532 VECPLOT
Transforms, searches, and computes resultants of matrices
Main Index
VECPLOT 1533
Transforms, searches, and computes resultants of matrices
2. If displacement coordinate systems exist, or COORID = 0, then CSTM may not be purged and
SCSTM may not be purged if partitioned superelements are present.
3. CASECC and LAMA may be purged.
4. BGPDT and XOUT may not be purged.
5. XG may be purged if IOPT=3, 4, or 6.
6. MEDGE may be purged if p-elements are not present.
7. USET may be purged except for IOPT=6, 9, and 10.
8. IOPT=11 processes, but does not require, the EQUILIBRIUM Case Control command and
requires the previous executions of VECPLOT to compute resultants of PG, QG, and QMG with
IOPT=1 or 8. It is assumed that the resultants, PGRES, QGRES, and QMGRES were computed
with the same value of GRDPNT.
Examples:
1. Convert a displacement vector in a global coordinate system that is cylindrical to the basic system,
and print it.
VECPLOT UG,BGPDT,SCSTM,CSTM,,,,/UGBASIC/0/0/1 $
MATGPR BGPDT,USET,,UGBASIC//’H’/’G’ $
2. Given a free-free model with no mechanisms, compute its rigid body modes in the global and
basic coordinate systems.
VECPLOT ,,BGPDT,SCSTM,CSTM,,,,/RBGLOBAL///4 $
TRNSP RBGLOBAL/RBT $
VECPLOT RBT,BGPDT,,CSTM,,,,/RBBASIC///1 $
3. Convert a load matrix to the basic coordinate system, and print out the maximum load at any grid
point for each load vector.
VECPLOT PG,BGPDT,SCSTM,CSTM,,,,/PGBASIC//0/5 $
MATPRN PG,PGBASIC//$
Main Index
1534 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 1535
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
1536 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 1537
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
1538 WEIGHT
Calculates model's volume and/or weight
Main Index
XSORT 1539
Reads and sorts Bulk Data Section
Format:
XSORT FORCE,BULKOLD/
BULK,UBULK/
S,N,NOGOXSRT/S,N,QUALNAM/S,N,NEXTID/S,N,LASTBU
LK/
S,N,EQVBLK $
Parameter:
Main Index
1540 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 1541
Writes plot information to plot file (.plt)
Format:
XYPLOT XYPLOT// $
Parameters:
None.
Main Index
1542 XYTRAN
Creates table of plot instructions for x-y plots
XYTRAN XYCDB,OPG2,OQG2,OUG2,OES2,OEF2,OSTR2,OQMG2,
OVG2,OAG2,OESC2,OSTC2,OEFC2,OSRC2/
XYPLOT/
APP/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID/DVAFLAG $
XYTRAN XYCDB,OXRESP,,,,,,,,/
XYPOLT/
‘RSPEC’/XYSET/S,N,PLTNUM/UNUSED/S,N,NOXYPLOT/
S,N,TABID $
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 1543
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
1544 XYTRAN
Creates table of plot instructions for x-y plots
Parameters:
Main Index
XYTRAN 1545
Creates table of plot instructions for x-y plots
Remarks:
1. OFPi2 may be element stresses, displacements, element forces, single-point forces of constraint,
applied loads, slideline contact stresses, nonlinear loads in p-set,
h-set, or d-set.
2. OFPi2 may be specified in any order.
3. If APP='RAND' then PSDF and AUTO must be specified.
4. If APP='RSPEC' then OXRESP must be specified.
5. If APP='VG' then OVG must be specified.
Examples:
1. Modal frequency response solution set (h-set) output:
XYTRAN XYCDB,OUDVC2,,,,/XYPLTFA/'FREQ'/'HSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLT $
2. Direct transient response physical set (p-set) output:
XYTRAN XYCDB,OPP2,OQP2,OUPV2,OES2,OEF2/XYPLTT/'TRAN'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLT $
3. Random response output:
XYTRAN XYCDB,PSDF,AUTO,,,/XYPLTR/'RAND'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOPLTR $
4. Response spectra output:
XYTRAN XYCDB,OXRESP,,,,/XYPLTSS/'RSPEC'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP/S,N,TABID $
5. Aerodynamic V-g curve output:
XYTRAN XYCDB,OVG,,,,/XYPLTCE/'VG'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP $
6. Grid point output; i.e., grid points on the abscissa:
XYTRAN
XYCDB,OPG2X,OQG2X,OUG2X,OES2X,OEF2X/XYPLTT/'SET1'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NP $
7. Slideline contact output:
XYTRAN XYCDBS,OESNLBP2,,,,/XYPLTB1/'CONT'/'PSET'/
S,N,PFILE/S,N,CARDNO/S,N,NOXYP $
Main Index
Glossary
MSC Nastran DMAP Programmer’s Guide
Glossary
Data Block Glossary
Parameter Glossary
Main Index
Glossary 1547
Data Block Glossary
Chapter 4 Chapter 2
Name Name Description
A Square matrix to be decomposed by DCMP, DECOMP, SOLVE, and
SOLVIT. Rectangular matrix to be processed by the DIAGONAL
and SCALAR modules. Rectangular matrix formed from partitions.
Output by MERGE, UMERGE, and UMERGE1. Rectangular
matrix to be used in MPYAD and SMPYAD module product.
Rectangular matrix to be used in NORM module.
AA Acceleration matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID). Output by
SEDR.
AAP Sparse partial reduced matrix in update matrix format when
KSYM=3. Output by DCMP.
ABESF* Family of a-set size panel area matrices.
ACPT Aerodynamic connection and property table. Output by APD.
ADBINDX Table of the aerodynamic database contents. (one entry for each of
the NV instances created). Output by ADG.
ADELUF Matrix of adjoint sensitivities for frequency response.
ADELUS Matrix of adjoint sensitivities for static analysis.
ADELX Matrix of adjoint sensitivities. Output by DSADJ.
ADJG Adjoint sensitivity displacement matrix in the g-set or
p-set.
ADJGT Transposed adjoint solution matrix specified on first pass through
DSADJ. Output by DSADJ.
ADJGT0 ADJGT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
ADRDUG Matrix of adjoint loads for the g-set. Output by DOPR3.
ADRDUTB Table of adjoint load attributes. Output by DOPR3.
AEBGPDT* BGPDT Family of aerodynamic basic grid point definition tables. Output by
APD.
AEBGPDTI Basic grid point definition table for the aerodynamic js-set
interference degrees-of-freedom.
Main Index
1548 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 4 Chapter 2
Name Name Description
AEBGPDTI* Family of basic grid point definition tables for the interference js-set
aerodynamic degrees-of-freedom.
AEBGPDTJ Basic grid point definition table for the aerodynamic js-set degrees-
of-freedom.
AEBGPDTJ* Family of basic grid point definition tables for the js-set
aerodynamic degrees-of-freedom.
AEBGPDTK Basic grid point definition table for the aerodynamic ks-set degrees-
of-freedom.
AEBGPDTK* Family of basic grid point definition tables for the ks-set
aerodynamic degrees-of-freedom.
AEBOX Table of aerodynamic element connectivity. Output by APD as
BGPDT with qualifier MODLTYPE='AEROMESH'.
AECMPOLD Previously generated AECOMP.
AECOMP Aerodynamic component definition table. Output by APD.
AECSTMHG Table of aerodynamic coordinate system transformation matrices
that only contains the hinge moment referenced coordinates systems
if not null. Output by MKCNTRL.
AECTRL Table of aerodynamic model's control definition. Output by ADG.
AEDBIDX Index table consisting of the triples. Output by MAKAEFS.
AEDBINDX Aeroelastic database index for monitor point data.
AEDBUXV Matrix of vehicle states.
AEDW Matrix of downwash vectors contained on DMIJ Bulk Data entries
referenced by the AEDW entries. Output by MAKAEFA.
AEDWIDX Index to the AEDW tables. Output by MAKAEFA.
AEECT* GEOM2 Family of aerodynamic element connection tables. Output by APD.
AEFIDX Index to the AEFORCE tables. Output by MAKAEFA.
AEFRC Matrix of force vectors contained on DMIK Bulk data entries
referenced by the AEFORCE entries. Output by MAKAEFA.
AEGRID BGPDT Basic grid point definition tables for the aerodynamic model. Output
by APD as BGPDT with qualifier MODLTYPE='AEROMESH'.
AEIDW Matrix of interference downwash vectors contained on DMIJ Bulk
Data entries referenced by the AEDW entries. Output by
MAKAEFA.
AEIPRE Matrix of interference pressure vectors contained on DMIJ Bulk data
entries referenced by the AEPRESS entries. Output by MAKAEFA.
AEMONOLD Table of HM monitor points.
Main Index
Glossary 1549
Data Block Glossary
Chapter 4 Chapter 2
Name Name Description
AEMONPT Aerodynamic monitor point table. Output by MAKAEMON and
MAKMON.
AEPRE Matrix of pressure vectors contained on DMIJ Bulk data entries
referenced by the AEPRESS entries. Output by MAKAEFA.
AEPRSIDX Index to the AEPRESS tables. Output by MAKAEFA.
AERO Table of control information for aerodynamic analysis. Output by
APD.
AEROCOMP Table of aerodynamic components when MESH='AERO'. Output by
MAKCOMP.
AEUSET* USET Family of aerodynamic USET tables. Output by APD.
AG Acceleration matrix in g-set.
AGD Acceleration matrix in g-set for the downstream superelement.
AGG Fluid/structure coupling matrix at all points or for a structural panel.
Output by GP5.
AGX Gravity/thermal load matrix due to volumetric changes for the
central, forward, or backward perturbed configuration. Output by
SSG1.
AH Signed global modally reduced area matrix
Aij Matrix partitions. Output by PARTN and UPARTN.
AJJT Aerodynamic influence matrix. Output by AMG.
AM2 Damping matrix in the d-set for linear elements multiplied by the
negative of the time step delta
AM3 Combined mass and damping matrix multiplied the square of the
reciprocal of the time step delta and the reciprocal of twice the time
step delta, respectively.
AMLIST List of auxiliary model identification numbers. Output by AXMPR1.
AMSPLINE Table of aerodynamic splines for display. Converted from forces and
pressures computed on AEBGPDT grid points, (box centroidal
points) to AEGRID grid points (box corner points). Output by APD.
ANORM Normalized matrix. Output by NORM.
APART Partitioning vector for panel coupling matrix when
PNLPTV=TRUE.
APIMAT Diagonal matrix of average power input values. Output by
SEEFMCLF.
APIMATT Matrix of average power input per unit force for all EFM
superelements for all bands.
Main Index
1550 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 4 Chapter 2
Name Name Description
APL Lower triangular factor of null space A matrix.
APPLOD Matrix of applied load amplitudes. Output by DPD.
APU Upper triangular factor of null space A matrix.
ARVEC Residual vector matrix based on adjoint loads. Output by DOPR3.
AUG1 Displacement matrix in g-set for aerostatic analysis. Output by
DSAD.
AUTO Autocorrelation function table. Output by RANDOM.
AUXTAB Table of aerodynamic extra point identification numbers,
displacements, labels, type, status, position and hinge moments for
all subcases.
AXIC Table of Bulk Data entry images related to conical shell, hydro
elastic, and acoustic cavity analysis. Output by IFP.
Chapter 3 Chapter 2
Name Name Description
B Output matrix from the DIAGONAL module. Right hand side of a
system of equations input to the FBS, SOLVE, and SOLVIT
modules. Rectangular matrix to be used in MPYAD and SMPYAD
module product.
B2DD Total damping matrix from viscous damping elements and the B2PP
Case Control command and reduced to the d-set. In transient
response analysis, B2DD may also include structural damping
effects.
B2GG Matrix defined on DMIG Bulk Data entries and referenced by the
B2GG Case Control command. Output by MTRXIN.
B2PP Matrix defined on DMIG Bulk Data entries and referenced by the
B2PP Case Control command. Output by MTRXIN.
BAA Viscous damping matrix in a-set or d-set.
BACK Transformation matrix from cyclic to physical components.
Required in static and pre-buckling analysis only. Output by
CYCLIC1.
BANDLIST Table of mode information for all bands. Output by SEEFMBND.
BANDPV Matrix of partitioning vectors for all non-trivial bands. Output by
SEEFMBND.
BASVEC Auxiliary displacement matrix.
BASVEC0 Auxiliary displacement matrix. Optional user input.
Main Index
Glossary 1551
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
BCON0 Table of constant terms in the beam section constraint relationship.
Output by DOPR1.
BCONXI Matrix relating beam library constraints to the independent design
variables. Output by DOPR1.
BCONXT Matrix transpose of BCONXI.
BD3X3 3x3 diagonal strip for boundary degrees-of-freedom from KGG for
parallel domain decomposition. Output by GPSP.
BDD Damping (or heat capacitance) matrix for the d-set for linear
elements only.
BDIAG Diagonal matrix of buckling divided by buckling generalized
differential stiffness matrix. Output by DSAH.
BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format.
Output by BMG.
BDICT KDICT BELM dictionary table. Output by EMG.
BELM KELM Table of element damping or heat capacity matrices. Output by
EMG.
BFEFE Damping matrix in the fe-set (or nonlinear tangential heat
capacitance matrix) for both linear and nonlinear elements in the fe-
set.
BFHH Fluid partition of modal damping matrix BHH.
BGDD* Family of coriolis matrices.
BGPDT* BGPDT Family of basic grid point definition tables (BGPDT) qualified by
LOADID and LOADNAME and associated with PG*. Output by
EXPORTLD.
BGPDT BGPDT Basic grid point definition table. Output by GP1.
BGPDTD BGPDT Basic grid point definition table for a downstream superelement.
BGPDTFB* Family of BGPDT tables associated with FBLPG. One instance
defines the grids for one given freebody subsystem. Output by
FBDODYLD.
BGPDTM BGPDT Basic grid point definition table and updated for the current p-level.
Output by GP1 with GEOM1M and GEOM2M as inputs.
BGPDTN BGPDT New BGPDT table based on displaced grid locations. Output by
MATMOD option 11.
BGPDTS BGPDT Basic grid point definition table for a superelement. Output by GP1.
BGPDTX BGPDT BGPDT assembled for superelements defined on the SEPLOT or
SEUPPLOT command. Output by SEPLOT.
Main Index
1552 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
BGPDVB BGPDT Basic grid point definition table for the backward perturbed
configuration. Output by DSAM.
BGPDVP BGPDT Basic grid point definition table for the forward (or central)
perturbed configuration. Output by DSAM.
BGPDVX BGPDT Basic grid point definition table for the central, forward, or
backward perturbed configuration. Output by DSAM.
BGPECT GEOM2 Boundary grid point element connection table. Output by BGP.
BGPP* Family of coriolis matrices - p-set.
BHH Generalized (modal) damping matrix
BHH1 Modified generalized (modal) damping matrix. Output by FA1.
BKDICT KDICT BKELM dictionary table.
BKK Viscous damping matrix in cyclic components. Output by
CYCLIC3.
BLAMA LAMA Buckling eigenvalue summary table. Output by READ.
BLAMA* LAMA Family of buckling eigenvalue summary tables.
BMODAL Matrix of modal damping values from selected TABDMP1 Bulk
Data entry in DIT. Output by GKAM.
BNDFIL Table containing the local and global boundary grids in the order
given by extreme for domain decomposition. Output by SEQP.
BP Null space B matrix.
BPP Damping (or heat capacitance) matrix for the p-set for linear
elements only.
BRDD Damping matrix in the d-set for linear elements only or heat
capacitance matrix for both linear and nonlinear elements in the d-
set.
BTOPO Contact regions topological information table. Output by BGP.
BTOPOCNV Updated contact regions input information table. Output by
NLITER, NLSOLV, and NLTRD2.
BTOPOSTF Updated contact regions topological information table. Output by
NLITER, NLSOLV, and NLTRD2.
BULKINDX Table of all sorted Bulk Data entries with indices. Output by
INDXBULK.
BXX Viscous damping matrix in any set. Usually h-set or d-set in CEAD,
FRRD1, FRRD2, TRD1, and TRD2.
BUG* Family of buckling eigenvector matrices in the g-set
Main Index
Glossary 1553
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
BUX Matrix of damping multiplied by displacement or eigenvectors.
BULK Table of all Bulk Data entries. Output by XSORT and RMDUPBLK.
BULK* Family of auxiliary model or superelement Bulk Data sections.
BULKOLD BULK table from a prior run.
Chapter 3 Chapter 2
Name Name Description
C Rectangular matrix to be used in MPYAD module addition and
SMPYAD module product.
CASADJ CASECC Case Control table associated with adjoint method. Output by
DSAD.
CASDSN CASECC Case Control table with unneeded analysis subcase(s) deleted,
excluding static aeroelastic subcases. Output by DSAD.
CASDSX CASECC Case Control table with unneeded analysis subcase deleted
CASE CASECC Table of Case Control commands for the current analysis type and
superelement.
CASEA CASECC A single record (subcase) of CASECC for aerodynamic analysis.
Output by AELOOP.
CASEBK CASECC Case Control table for cyclic data recovery. One record for every
column in BACK. Required in static and pre-buckling analysis only.
Output by CYCLIC1.
CASEBUCK CASECC Case Control table for buckling analysis and based on
ANALYSIS=BUCK. Output by MDCASE.
CASECC CASECC Table of Case Control command images. Output by IFP1.
CASECC* CASECC Family of auxiliary model Case Control tables.
CASECC1 CASECC Primary model Case Control table appended with extra subcases to
account for the boundary shapes. Output by SHPCAS.
CASECCP Selected records of CASECC assigned to local processor. Output by
DMPCASE.
CASECCU CASECC Table of Case Control command images originally output by IFP1.
Used when first CASECC is replaced by one of the CASECC
outputs from a prior call to MDCASE.
CASECCBO CASECC Updated CASECC for contact region data recovery operations.
Output by BGCASO.
CASECCP CASECC subsetted for current selection of Fortran unit. Output by
MODCASE.
Main Index
1554 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
CASECCR CASECC Table of Case Control command images for data recovery. Output by
TOLAPP.
CASECEIG CASECC Case Control table for modal or direct complex eigenvalue analysis
and based on ANALYSIS=MCEIG or DCEIG. Output by
MDCASE.
CASEDM CASECC Case Control table for the recovery of design responses for modes.
CASEDMF CASECC Case Control for all load-cases for all design variables for the
perturbed configuration for modes. Output by DSAH.
CASEDR CASECC Table of Case Control command images for the superelement
(identification number equal to output value of SEID). Output by
SEDR.
CASEDS CASECC Case control table for the data recovery of design responses. Output
by DOPR3 and DSTA.
CASEDSF CASECC Case Control table for all load cases and all design variables for the
perturbed configuration. Output by DSAH.
CASEDVRG CASECC Case Control table for aerostatic divergence analysis and based on
ANALYSIS=DIVERG. Output by MDCASE.
CASEFLUT CASECC Case Control table for flutter and based on ANALYSIS=FLUTTER.
Output by MDCASE.
CASEFR CASECC Updated Case Control table for static loads generation and solution
in cyclic symmetry analysis. One record for every distinct load set
identification number. Output by CYCLIC1.
CASEFREQ CASECC Case Control table for modal or direct frequency response analysis
and based on ANALYSIS=MFREQ or DFREQ. Output by
MDCASE.
CASEHEAT CASECC Case Control table for heat transfer analysis and based on
ANALYSIS=HEAT. Output by MDCASE.
CASEMODE CASECC Case Control table for normal modes analysis and based on
ANALYSIS=MODES. Output by MDCASE.
CASEMTRN CASECC Case Control table for modal transient analysis and based on
ANALYSIS=MTRAN. Output by MDCASE.
CASENT CASECC CASECC transformed for nonlinear transient response analysis.
Output by ST2DYN.
CASEP CASECC Residual superelement Case Control table for plotting basis vectors.
Output by DOPR2. Case Control table with number of basis vectors
in the DESVEC as the number of Case Control records. Output by
DSAJ.
Main Index
Glossary 1555
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
CASER Table of Case Control command images loaded with SET
id=GRIDSET. Output by MATMOD option 36.
CASERS CASECC Case Control table for the residual structure and a given analysis
type.
CASES CASECC Table of Case Control command images for the current
superelement (identification number equal to output value of SEID).
Output by SEP2CT.
CASESADV CASECC Combined Case Control table which includes CASESAER or
CASEDVRG. Output by MDCASE.
CASESAER CASECC Case Control table for aerostatic analysis and based on
ANALYSIS=SAERO. Output by MDCASE.
CASESMEM CASECC Case Control table for electromagnetic analysis and based on
ANALYSIS=ELEC. Output by MDCASE.
CASESMST CASECC Case Control table for structural analysis and based on
ANALYSIS=STRU. Output by MDCASE.
CASESNMB CASECC Combined Case Control table which includes CASESTAT,
CASEMODE, CASEBUCK, CASESAER, CASEDVRG, and
CASEFLUT. Output by MDCASE.
CASESTAT CASECC Case Control table for static analysis and based on
ANALYSIS=STATICS. Output by MDCASE.
CASESX CASECC Expanded Case Control table. Output by LCGEN.
CASEUNIT Table of Case Control parameters requesting to a unit displacements.
In addition, the monitor points will be expressed as various sets of
output depending on what is being monitored. Output by ILMP1.
CASEUPSE CASECC Case Control table for upstream superelements only. Output by
MDCASE.
CASEVEC CASECC Table of Case Control command images with the PARTN command
referencing all of auxiliary model's grid identification numbers.
Output by AXMPR2.
CASEXX CASECC Subset of CASECC for current loop. Output by CASE.
CASEYY CASECC Appended Case Control table in flutter analysis. Output by FA2.
CCPOS Table of Case Control record locations. Output by AELOOP and
AEMODEL.
CCPOS1 Table of Case Control record locations. Output by AELOOP and
AEMODEL.
CDELB Triple matrix product for flutter damping sensitivity
CDELK Triple matrix product for flutter stiffness sensitivity
Main Index
1556 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
CDELM Triple matrix product for flutter mass sensitivity
CFSAB Matrix of spectral densities--weighting factors for RMS
calculations. Output by DOPRAN.
CIDATA Miscellaneous data for controlled increment method. Output by
NLITER.
CLAMA LAMA Complex eigenvalue summary table. Output by CEAD.
CLAMA1 LAMA Complex eigenvalue summary table in flutter analysis. Output by
CEAD.
CLAMA2 LAMA Appended complex eigenvalue summary table in flutter analysis.
Output by FA2.
CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal. Output
by CEAD, LAMX, and UEIGL.
CLFMAT Matrix of coupling loss factors. Output by SEEFMCLF.
CMAT Complex matrix.
CMBXPHG Matrix of component modes transformed to the basic coordinate
system and row-ordered in external grid id sequence.
CMLAMA Component modal eigenvalue summary table.
CMSEQ Table of (strain, kinetic, or damping) energy in all components.
Output by CMSENGY.
CMSQE Matrix of (strain, kinetic, or damping) energy in the component.
CMSTEQ Table of (strain, kinetic, or damping) energy in all components.
Output by CMSENGY.
CMSTQE Matrix of (strain, kinetic, or damping) energy in the component.
CNTABR CONTAB Table of retained constraint attributes. Output by DSAD.
CNTABRG CONTAB Table of retained constraint attributes.
CNTABXE CNTABXM with resolved DRESP2 and DRESP3 records. Output
by DSADX.
CNTABXM Merged CNTABX associated with unresolved DRESP2 and
DRESP3 records.
CNVTST Convergence test matrix.
CONTABX Table of constraint attributes with respect to RESP12X.
COELEM Correlation table between idcid/eid/component for element
responses. Output by DSAH.
COGRID Correlation table between idcid/gid component for displacement
responses. Output by DSAH.
Main Index
Glossary 1557
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
COLOR Coloring array. Number of rows corresponds to size of MAT. The i-
th entry corresponds to the superelement identification number (tip
superelement or collector or 0 (residual)) to which the i-th degree-
of-freedom. belongs. Output by PRESOL.
COMP Merged table of components. Output by MRGCOMP.
COMPi Table of aerodynamic or structural components
CON Matrix of constants that relates design variables and design
coordinates. Output by DOPR2.
CONS1T Matrix transpose of relationship between dependent and
independent design variables. Output by DOPR1.
CONSBL Matrix of constant property values. Output by DOPR1.
CONSBL* Family of matrices of constant property values. Output by DOPR1.
CONTAB CONTAB Table of constraint attributes. Output by DOPR3.
CONTACT Table of Bulk Data entries related to contact regions. Output by IFP.
CONTROL Table of editing directives for the TABEDIT module.
CONTVDIF Derivative interpolation factor matrix (NV rows by NX columns).
Output by NDINTERP.
CONTVX Controller vector used to interpolate UXV (NX rows)
CONTVXV Assemblage of all controller vectors (NX rows by NV columns)
COORD Matrix of initial or final designed coordinate values, COORDO or
COORDN.
COORDN Updated (optimized) COORDO. Output by DOM11.
COORDO Matrix of initial designed coordinate values at the beginning of each
design cycle. Output by DOPR2.
CP Column partitioning vector. Output by VEC and MATMOD option
17.
CPERM Table of column permutations under KSYM=4. Output by
DECOMP.
CPH1 Complex eigenvector matrix for h-set in flutter analysis. Output by
CEAD.
CPH2 Appended complex eigenvector matrix for h-set in flutter analysis.
Output by FA2.
CPHFL Left flutter eigenvector - h-set. Output by DSFLTE.
CPHP Complex eigenvector matrix in the p-set.
CPHFR Left flutter eigenvector - h-set. Output by DSFLTE.
Main Index
1558 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
CPHX Complex eigenvector matrix in the d-set or h-set. Output by CEAD.
CPHL Complex eigenvector matrix in the l-set. Output by CEAD.
CSNMB CASECC Case Control table for a given superelement and all analysis types.
CSTM CSTM Table of coordinate system transformation matrices. Output by GP1.
CSTMi CSTM Tables of coordinate system transformation matrices; either
aerodynamic or structural.
CSTMi* Family of CSTM tables.
CSTM0 CSTM Table of coordinate system transformation matrices for the residual
structure.
CSTMA CSTM Table of aerodynamic coordinate system transformation matrices for
g-set + ks-set grid points. Output by APD.
CSTMD CSTM Table of coordinate system transformation matrices for a
downstream superelement.
CSTMM CSTM Merged table of coordinate system transformation matrices. Output
by MKCSTMA.
CSTMS CSTM Table of coordinate system transformation matrices for a
superelement.
CSTMX Merged table of CSTMi. Output by MRGCSTM.
CVAL Matrix of constraint values, CVALO or CVALRG.
CVALO Matrix of final (optimized) constraint values. Output by DOM9.
CVAL Matrix of retained constraint values. Output by DSAD.
CVALR Matrix of retained constraint values. Output by DSAD.
CVALRG Matrix of initial constraint values.
CVALXE CVALRG with resolved DRESP2 and DRESP3 records Output by
DSADX.
CVEC Partitioning vector for separating the primary model solutions from
boundary shape induced solutions. Output by SHPCAS.
CVECT Load combination factor matrix. Output by PCOMB.
CYCD Table of constraints in harmonic components. Output by CYCLIC2.
Main Index
Glossary 1559
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
D Rectangular matrix to be used in SMPYAD module product.
Diagonal matrix extracted from LD. Output by MATMOD option
21.
D1JE Real part of downwash matrix due to extra points.
D1JK Real part of downwash matrix. Output by AMG.
D2JE Imaginary part of downwash matrix due to extra points.
D2JK Imaginary part of downwash matrix. Output by AMG.
DAR Rigid body transformation matrix for the r-set to the
a-set. Formed from the merge of DM and an l-set size identity matrix.
DBCOPT DBCOPT Design optimization history table for post-processing. Output by
DOM12.
DB Data block.
DBi Data block to be processed by the DBC, INPUTT2, and OUTPUT2
modules. Data blocks to be compared in the RESTART module. Data
block declared on the FILE statement. Data block to be purged by
PURGEX module. Any data block to be broadcast from the master
to the slave processors.
DBMLIB Table of designed beam library data. Output by DOPR1.
DBNAME Data block for 'NAME' option of PARAML module. Output by
PARAML.
DBOUTi DBi received on the slave processor. Output by MDISUTIL.
DBP Primary data block.
DBS Secondary data block. Output by EQUIVX.
DBUG Buckling eigenvector matrix in the g-set associated with designed
(active) eigenvalues. Output by DSAH.
DCLDXT Matrix of coefficients in the grid to design variable relationship.
Output by DOPR2.
DCPHL Complex eigenvectors associated with the divergence eigenvalues
extracted from the real part of eigenvectors associated with the
divergence eigenvalues. Output by CEAD.
DEFUSET Table of DEFUSET Bulk Data entry images. Output by IFP.
DELB1 Matrix of delta buckling load factor for all design variables.
DELBSH Matrix of finite difference shape step sizes.
DELBSX Updated DELBSH where the numerical zero terms are replaced by a
prescribed small value. Output by DOPR5.
DELCE Matrix of delta complex eigenvalue for all design variables
Main Index
1560 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DELDV Matrix of divergence sensitivity. Output by DSDVRG.
DELF1 Matrix of delta eigenvalue for all design variables.
DELFL Matrix of delta flutter responses for all design variables. Output by
DSFLTF.
DELGM Matrix of delta generalized masses for all design variables.
DELGS Matrix of delta generalized stiffnesses for all design variables.
DELS Matrix of delta stability derivative responses for all design variables.
DELS1 Matrix of delta stability derivative responses for all design variables
for a single trim subcase. Output by DSARSN.
DELTGM Multipoint constraint transformation matrix for the perturbed
configuration. Output by DSVGP4.
DELVS Matrix of delta volume for all design variables. Output by DSAW.
DELWS Matrix of delta weight for all design variables. Output by DSAW.
DELX Matrix of delta trim variable responses for all design variables.
DELX1 Matrix of delta trim variable responses for all design variables for a
single trim subcase. Output by DSARSN.
DEQATN Table of DEQATN Bulk Data entry images. Output by IFP.
DEQIND Index table to DEQATN data block. Output by IFP.
DESELM Table of designed elements. Output by DOPR3.
DESGID Table of designed grid coordinate attributes. Output by DOPR2.
DESNEW Update table of design variable attributes. Output by DOM12.
DESTAB DESTAB Table of design variable attributes. Output by DOPR1.
DESVCP Global shape basis vector matrix with incorporation of DLINK
relations with extra columns for property/dummy variables. Output
by DOPR2.
DESVEC Basis vector matrix which consists of basis vectors generated from
DVGRID Bulk Data entries and from columns of BASVEC0 matrix.
Its components are defined in the basic coordinate system.
DESVECP Basis vector matrix which consists of basis vectors generated from
DVGRID bulk data entries and from columns of BASVEC0 matrix
its components are expressed in the global coordinate system.
DFFDNF Table containing the derivatives of forcing frequencies with respect
to natural frequencies. Output by FRLGEN.
DGEOM2 GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points for the perturbed configuration. Output by DSAH.
Main Index
Glossary 1561
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DGEOM3 GEOM3 Table of Bulk Data entry images related to static loads for the
perturbed configuration. Output by DSAH.
DGMVPT Partitioning vector to obtain the sensitivities of generalized mass for
normal modes analysis from that of the union set. Output by DSAH.
DGSVPT Partitioning vector to obtain the sensitivities of generalized stiffness
for normal modes analysis from that of the union set. Output by
DSAH.
DGTAB Table relating DTOS4 records and designed grid data. Correlation
table of internal grid sequence for the baseline and perturbed
configuration. Output by DOPR6.
DISTAB Table of discrete optimization value sets. Output by DOPR1.
DIT DIT Table of TABLEij Bulk Data entry images. Output by IFP.
DITID Table of identification numbers in DIT. Output by TA1.
DITNT DIT transformed for nonlinear transient response analysis. Output by
ST2DYN.
DIVDAT Table of divergence data. Output by DIVERG.
DIVTAB Table of aerostatic divergence data for all subcases.
DJX Downwash matrix. Downwash at the j-point due to the x
aerodynamic extra point. Output by ADG.
DLCPHL Left-handed complex eigenvectors associated with the divergence
eigenvalues extracted from the real part of left-handed eigenvectors
associated with the divergence eigenvalues. Output by DIVERG.
DLSTIN List of data blocks and their paths. Output in a previous execution of
RESTART.
DLSTOUT List of data blocks and their paths. Output by RESTART.
DLT Table of dynamic loads. Output by DPD.
DLT1 Table of dynamic loads updated for nonlinear analysis. Output by
NLCOMB and NLTRLG.
DLTH Table of dynamic loads updated for heat transfer analysis. Output by
TRLG.
DM Rigid body transformation matrix for the r-set to the
l-set. Output by RBMG3.
DMATCK Table of designed material consistency check. Output by DOPR1.
DMI Table of all matrices specified on DMI Bulk Data entries. Output by
IFP.
DMIi Matrix data blocks created from DMI. Output by DMIIN.
Main Index
1562 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DMINDX Index into DMI. Output by IFP.
DNODEL Table of designed and non-designed locations. Output by DOPR2.
DNVVPT Partitioning vector to obtain the sensitivities of natural frequencies
for eigenvector optimization from that of the union set. Output by
DSAH.
DPHG Normal modes eigenvector matrix in the g-set associated with
designed (active) eigenvalues. Output by DSAH.
DPLDXI Matrix of coefficients in the property to independent design variable
relationship. Output by DOPR1.
DPLDXI* Family of matrices of coefficients in the property to independent
design variable relationship. Output by DOPR1.
DPLDXT Matrix transpose of DPLDXI.
DRDUG Matrix of adjoint loads for the g-set. Output by DSAD.
DRDUGM Modified matrix of adjoint loads. Output by ADJMOD.
DRDUTB Table of adjoint load attributes. Output by DSAD.
DRDUTBM Modified table of adjoint load attributes. Output by ADJMOD.
DRLIST Superelement processing list for data recovery. Output by SEP4.
DRMSVL Table of the RMS response values with respect to the design
variables. Output by DSAMRG.
DRSTBL Table containing the number of retained responses for each subcase
for each of the response types. Output by DSAD.
DRSTBLG Table containing the number of retained responses for each subcase
for each of the response types.
DRUT Processed version of DRDUTB specified on first pass through
DSADJ. Output by DSADJ.
DRUT0 DRUT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
DSCM Design sensitivity coefficient matrix. Output by DSAL.
DSCM2 Normalized design sensitivity coefficient matrix. Output by DOM6.
DSCMCOL DCSMCOL Correlation table for normalized design sensitivity coefficient
matrix. Output by DSTAP2.
DSCMG Unnormalized design sensitivity matrix.
DSCMR Old combined design sensitivity/constraint matrix. Output by
DSMA.
Main Index
Glossary 1563
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DSCOLL Table of design sensitivity column labels for design sensitivity
matrix, DSCMR. Output by DSTA.
DSCREN Table of constants from the DSCREEN Bulk Data entry. Output by
DOPR1.
DSDIV Matrix of delta divergence speed for all design variables.
DSEDV Partitioning vector for retained divergence responses. Output by
DSAH.
DSEGM Old design sensitivity eigenvalue gradient matrix.
DSESM Design sensitivity eigenvector selection matrix - Boolean operator to
select eigenvectors which are referenced by constraints (buckling
and normal modes only). Output by DSTA.
DSGRID Table of identification numbers for those grid points in the design
model automatic superelement optimization feature. Output by
DSGRDM.
DSIDLBL Table of design response labels. Output by DSTAP2.
DSLIST Superelement processing list to direct the pseudo-load and response
sensitivity calculations. Output by SDSB.
DSPT1 Design sensitivity processing table. Output by DSAN and DSTA.
DSPT2 Old Design sensitivity processor table two. Output by DSTA.
DSROWL Table of design sensitivity row labels for design sensitivity matrix,
DSCMR. Output by DSTA.
DSTABR Matrix of restrained perturbed dimensional stability derivatives.
DSTABU Matrix of unrestrained perturbed dimensional stability derivatives.
DTB Table of constants from the DTABLE Bulk Data entry. Output by
DOPR1.
DTI Table of all matrices specified on DTI Bulk Data entries. Output by
IFP.
DTIi Table data blocks created from DTI. Output by DTIIN.
DTINDX Index into DTI. Output by IFP.
DTOS2 Design variable/property cross reference table. Same as DTOS2K
except that the PREF in each entry is the product of a DPLDXI
element and the corresponding design variable value. Output by
DOPR5.
DTOS2* Family of tables which are the same as DTOS2K* except that the
PREF in each entry is the product of a DPLDXI element and the
corresponding design variable value. Output by DOPR5.
Main Index
1564 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DTOS2J Table identifying independent design variables and property values.
Output by DOPR1.
DTOS2J* Family of tables identifying independent design variables and
property. Output by DOPR1.
DTOS2K Same as DTOS2J except that the dvid in each entry refers to the
position of an internal design variable identification number in the
first TABDEQ record. Output by DOPR4.
DTOS2K* Family of tables which are the same as DTOS2J* except that the dvid
in each entry refers to the position of an internal design variable
identification number in the first TABDEQ record. Output by
DOPR4.
DTOS4 Table relating design variable to grid perturbation. Same as DTOS4K
except that the last three words in each entry contains the product of
those in DTOS4K and the shape step size. Output by DOPR5.
DTOS4J Designed grid perturbation vector in basic coordinate system. Output
by DOPR2.
DTOS4K Same as DTOS4J except that the identification number in each five-
word entry is the position of an internal design variable identification
number in the first TABDEQ record. Output by DOPR4.
DUGNI Incremental displacement matrix between the last two converged
steps. Output by NLITER.
DUPV Displacment increment at the final iteration before exit. Output by
NLSOLV.
DUX Matrix of aerodynamic extra point displacements for the perturbed
configuration. Output by ASG.
DVIDS List of shape variable identification numbers to be used for the
boundary DVGRID option. Output by DSAJ.
DVPTAB DVPTAB Table of attributes of the designed properties by internal property
identification number order. Output by DOPR1.
DVPTAB* DVPTAB Family of tables of attributes of the designed properties by internal
property identification number order. Output by DOPR1.
DVSLIS List of design variables affected by shape variations. Output by
DSVGP4.
DXDXI Matrix relating linked and independent design variables. Output by
DOPR1.
DXDXIT Matrix transpose of DXDXI.
DYNAMIC DYNAMIC Table of Bulk Data entry images related to dynamics. Output by IFP.
Main Index
Glossary 1565
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
DYNAMICB Table of Bulk Data entry images related to dynamics without
DAREA entry images. Output by GP1.
DYNAMICS DYNAMIC Table of Bulk Data entry images related to dynamics for the current
superelement. Output by SEP2 and SEP2X.
DYNAMNT DYNAMIC transformed for nonlinear transient response analysis.
Output by ST2DYN.
Chapter 3 Chapter 2
Name Name Description
E Rectangular matrix to be used in SMPYAD module product.
ECT GEOM2 Element connectivity table. Output by GP2.
ECT* GEOM2 Family of element connectivity tables for all superelements.
ECTA GEOM2 Secondary element connectivity table. Output by GP2.
EDITVEC Vector with zeros in rows to be removed under usetop='filter'.
EDOM Table of Bulk Data entries related to design sensitivity and
optimization. Output by IFP.
EDOM* Family of EDOM tables for all superelements.
EDOMM Table of Bulk Data entries related to design sensitivity and
optimization updated for p-element analysis. Output by OPTGP0.
EDOMS Table of Bulk Data entries related to design sensitivity and
optimization for a superelement. Output by SDSA.
EDT Table of Bulk Data entry images related to element deformation,
aerodynamics, p-element analysis, divergence analysis, and the
iterative solver. Also contains SET1 entries. Output by IFP.
EDT0 Table of archived set of MONPNT2 records to be merged into
EDTM.
EDTM Archival of EDT containing just the monitor records. Output by
ILMP1.
EED DYNAMIC Table of eigenvalue extraction parameters. Output by DPD.
EFMASMTT Matrix of mass values for all EFM superelements
EFMMCOL Column matrix of EFM superelement mass values. Output by
SEEFMDMP.
EFMDMP Table containing mass values, damping loss factors and frequency-
dependent damping criteria for all superelements for which energy
flow modeling calculations are to be performed. Output by
SEEFMDMP.
Main Index
1566 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
EFMLIST Table containing list of superelements for which energy flow
modeling calculations are to be performed. Output by SEEFMLST.
EFMMAT Matrix of energy factors. Output by SEEFMCLF.
EGK Pseudo-load (equilibrium variation) matrix in the g-set due to
stiffness. Output by DSVG1P.
EGM Pseudo-load (equilibrium variation) matrix in the g-set due to mass.
Output by DSVG1P.
EGPSF EGPSF Table of element to grid point interpolation factors. Output by
GPSTR1.
EGPSTR EGPSTR Table of grid point stresses or strains for post-processing in the DBC
module. Output by GPSTR2.
EGTX Pseudo-load matrix (variation in equilibrium) due to changes in the
thermal load/design variables for the central, forward, or backward
perturbed configuration. Output by DSVG2.
EGVREC Table of eigenvector record for sensitivity computation. Output by
DSAH.
EGX Pseudo-load (equilibrium variation) matrix in the g-set due to
stiffness, mass, viscous damping or structural damping. Output by
DSVG1P.
EHT Element hierarchical table for p-element analysis. Output by GP0.
EHTA Secondary element hierarchical table. Output by GP0.
ELDATA Table of combined nonlinear information data. Output by
NLCOMB.
ELDCT ELDCT Table of element stress discontinuities for post-processing in the
DBC module. Output by STDCON.
ELEMVOL Element volume table, contains p-element volumes and the p-value
dependencies of each p-element grid, edge, face and body. Output
by VIEWP.
ELSET Table of element sets defined in OUTPUT(POST), SETS
DEFINITION, or OUTPUT(PLOT) sections of Case Control.
Output by PLTSET and SEPLOT.
EMAT Matrix of editing parameters.
EMM Effective mass matrix. Output by EFFMAS.
ENEMAT Matrix of modal energy. Output by SEEFMCLF.
ENFLODB Matrix of equivalent enforced motion load amplitudes due to
viscous damping effects. Output by DPD.
Main Index
Glossary 1567
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
ENFLODK Matrix of equivalent enforced motion load amplitudes due to
stiffness effects. Output by DPD.
ENFLODM Matrix of equivalent enforced motion load amplitudes due to mass
effects. Output by DPD.
ENFMOTN Matrix of enforced motion amplitudes. Output by DPD.
EPSSE Table of epsilon and external work. Output by SSG3, SOLVIT, and
DISUTIL.
EPT EPT Table of Bulk Data entry images related to element properties.
Output by IFP and IFP6.
EPTT EPT updated for topology optimization. Output by IFP10.
EPTA EPT Secondary table of Bulk Data entry images related to element
properties.
EPTC EPT Copy of EPT except PCOMP records are replaced by equivalent
PSHELL records. Output by IFP6, CMPZPR, and DSTA.
EPTN EPT Updated (optimized) EPT. Output by DOM11.
EPTS EPT Table of Bulk Data entry images related to element properties for a
superelement. Output by SEP2 and SEP2X.
EPTTAB EPT Table of designed property attributes. Output by DOPR1.
EPTTAB* EPT Family of tables of designed property attributes. Output by DOPR1.
EPTX EPT EPT with design variable perturbations. Output by DSABO. Copy
of EPT except PBCOMP records are replaced by equivalent
PBEAM records. Output by IFP7. Copy of EPT except PBARL and
PBEAML records are replaced by equivalent PBAR and PBEAM
records. Output by IFP9. Copy of EPT except PACABS and
PACABR entries are updated with TABLEij references.
Output by MKMNTIFP: EPT updated to track monitor points
Output by MODGM2: Copy of EPT updated for converted
CSHEAR elements.
EQACST Equivalence table between internal fluid grid points and internal
structural grid points which lie on the fluid/structure boundary.
Output by GP5.
EQDYN EQEXIN Equivalence table between external and internal grid/scalar/extra
point identification numbers. (EQEXIN appended with extra point
data). Output by DPD.
EQEXIN EQEXIN Equivalence table between external and internal grid/scalar
identification numbers. OUTPUT by GP1.
Main Index
1568 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
EQEXINS EQEXIN Equivalence table between external and internal grid/scalar
identification numbers for a superelement. Output by SEP2 and
SEP2X.
EQMAP Table of degree-of-freedom global-to-local maps for domain
decomposition. Output by PRESOL.
EQMAPD Similar to EQMAP but on a degree-of-freedom basis. Output by
PRESOL.
EQMAPD0 EQMAPD from a prior call to PRESOL.
ERHM Matrix of dimensional unsplined restrained elastic hinge moment
data
ERROR0 ERROR Error estimate table generated by ADAPT module in previous
superelement or adaptivity loop.
ERROR1 ERROR Error-estimate table updated for current superelement or adaptivity
loop. Output by ADAPT.
EST Element summary table. Output by TA1.
ESTDATA Table of superelement estimation data overrides. Output by DTIIN.
ESTL Linear element summary table. Output by TA1.
ESTDCN Element summary table which incorporates combined constraints
and design variables. Output by DSAF and DSTA.
ESTDV2 Merged EST with grid and element property design variable
perturbations. If CDIF='YES' then this is the forward perturbation.
Output by DSAE.
ESTDVB Element summary table for the backward perturbed configuration.
Required only if CDIF='YES'.
ESTDVM EST EST with updated material property identification numbers. Output
by DSABO.
ESTDVP EST with element property design variable perturbations. Output by
DSABO and DSTA.
ESTDVS EST with grid design variable perturbations. Output by DOPR6.
ESTF Element summary table for follower force stiffness. Output by
TAFF.
ESTNL Nonlinear element summary table. Output by TA1.
ESTNL1 Nonlinear element summary table updated for heat transfer analysis.
Output by TAHT.
ESTNL0 Nonlinear element summary table from previous time step. Output
by NLSOLV.
Main Index
Glossary 1569
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
ESTNLH Nonlinear element summary table at converged step. Output by
NLITER, NLTRD, NLTRD2, and NLSOLV.
ESTR EST table with reduced records. Output by MATMOD option 38.
ETT Element temperature table. Output by GP3.
ETTDCN Table of design variable and constraint internal identification
numbers for the effects of temperature. Output by DSAF and DSTA.
ETTDV Element temperature table where the original element identification
numbers have been converted to new design variable identification
numbers. Output by DSAN and DSTA.
EUHM Matrix of dimensional unsplined unrestrained elastic hinge moment
data.
EXCITEFX Matrix of power or force input for all EFM superelements
EXCITF Matrix of EFM superelement force input values. Output by
SEEFMXIT.
EXCITP Matrix of EFM superelement power input values. Output by
SEEFMXIT.
Main Index
1570 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
F Rectangular matrix to be used in SMPYAD module addition.
F2J Matrix of strain energy on DMIG Bulk Data entries referenced by
the K2GG Case Control command. Must be qualified by qualifier
named by DMIGFN.
FENL Strain energy and grid point force at every element from the previous
load step in nonlinear matrix format.
FENL1 Strain energy and grid point force at every element at the current load
step in nonlinear matrix format. Output by NLITER.
FFAJ Matrix of pressures at aerodynamic boxes.
FFGH Follower force for OLOAD output. Output by NLITER.
FG Element forces due to large displacements. Output by GNFM.
FGNL Nonlinear element force matrix from the last iteration. Output by
NLITER.
FLUTAB Flutter summary table for all subcases.
FLUTABK Flutter summary table for K and KE methods. Output by FA2.
FLUTABP Flutter summary table for all methods except K and KE. Output by
FA1.
FMPF Matrix of fluid mode participation factors. Output by MODEPF.
FMV Nonlinear element forces at m-set. Output by NLSOLV.
FMVT Nonlinear element forces at m-set appended from each output time
step (for transient analysis only). Output by NLSOLV.
FN Matrix of natural frequencies (mass normalized stiffness).
FOL FOL Frequency response frequency output list. Output by FRLG.
FOL1 FOL Frequency response frequency output list truncated by the OFREQ
Case Control command. Output by MODACC.
FOLMAT Matrix of frequencies in radian units. Output by MATMOD Option
33.
FOLR Retained frequency response frequency output list. Output by
DSAD.
FOLT FOL Frequency response frequency output list with first frequency
truncated if first frequency is zero. UXF is also similarly truncated.
Output by FRRD1 or FRRD2.
FORCE Table of MSGSTRESS plotting commands defined under the
OUTPUT(CARDS) section in CASE CONTROL and MSGMESH
field information. Output by IFP1.
Main Index
Glossary 1571
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
FORE Transformation matrix from physical to cyclic components. Output
by CYCLIC1.
FREQMASS Matrix of frequencies and generalized masses.
FRL Frequency response list. Output by FRLGEN.
FRL1 Frequency response list for the current processor if distributed
processing is requested. Output by FRLGEN.
FRLI Frequency response list for a single frequency. Output by FRQDRV.
FRLR Retained frequency response list. Output by DSAD.
FRMDS Sensitivity matrix for fractional mass configuration (statics only).
Output by DSAW.
FRQRMF FRQRPR table for frequency response.
FRQRSP Table of the count of type 1 frequency/time responses per response
type per frequency or time step. Output by DOPR3.
FRQRPR Table containing the number of first level (direct) retained responses
per response type and per frequency or time step. Output by DSAD.
FRQRPRG Table containing the number of first level (direct) retained responses
per response type and per frequency or time step.
FSAVE Flutter storage save or answer table. Output by FA1.
Main Index
1572 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
GAMMAD Complex double precision. This is the scalar multiplier for [C].
GAPAR Partitioning vector which is used to partition the local
a-set displacements from the global a-set displacements. It contains
a 1 at each row that does not have a contribution from the current
processor and zero if it does. Required only for geometric domain
decomp.
GC Transformations matrix between symmetric (cosine) components
and solution set components. Output by CYCLIC3.
GDGK Aerodynamic transformation matrix for displacements from the k-
set to g-set. Output by GI.
GDKI Aerodynamic transformation matrix for displacements from the k-
set to h-set.
GDKSKS Matrix relation of the corner to the centroidal displacements. Output
by GIC2C.
GDNTAB Table of grid points generated for p-element analysis. Output by
GP0.
GEG Element displacement interpolation matrix. Output by MGEN.
GEI Table of general element data. Output by TA1.
GEOM1 GEOM1 Table of Bulk Data entry images related to geometry. Output by IFP.
GEOM1* GEOM1 Family of GEOM1 tables for all partitioned superelements defined
in separate Bulk Data sections.
GEOM1A GEOM1 Table of Bulk Data entry images related to geometry and assigned to
an auxiliary model. Output by IFP.
GEOM1C GEOM1 Table of Bulk Data entry images related to geometry and merged
from GEOM1 and GEOM1A. Output by AXMPR2.
GEOM1EX GEOM1 GEOM1 table containing records which define an external
superelement. Specifically, it contains CORD1j, CORD2j, EXTRN,
and GRID Bulk Data records. Output by BDRYINFO.
GEOM1M GEOM1 Table of Bulk Data entry images related to geometry and updated for
the current p-level. Output by GP0.
GEOM1N GEOM1 Updated (optimized) GEOM1. Output by DOM11. Modified
GEOM1 with CORD1j records converted to CORD2j records.
Output by SECONVRT.
GEOM1P GEOM1 Table of Bulk Data entry images related to geometry updated for p-
elements and superelements. Output by MODGDN.
Main Index
Glossary 1573
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1574 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
GEOM2S GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points for the current superelement. Output by SEP2 and
SEP2X.
GEOM2T GEOM2 GEOM2 updated for topology optimization. Output by IFP10.
GEOM2VU GEOM2 Table of Bulk Data entry images related to element connectivity and
scalar points p-elements removed and view-elements added. Output
by VIEWP.
GEOM2W GEOM2 GEOM2 augmented with SPOINT entries to represent all of the non-
fluid superelement component modes. Output by MODQSET.
GEOM2X GEOM2 GEOM2 table related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis. Output by IFP3, IFP4, and IFP5.
GEOM2 table augmented with fluid data and SPOINTS if
ACMS='YES'. Output by SEQP.
GEOM3 GEOM3 Table of Bulk Data entry images related to static and thermal loads.
Output by IFP.
GEOM3B GEOM3 Table of Bulk Data entry images related to static and thermal loads
with DAREA entry images converted to equivalent FORCE and
MOMENT entry images. Output by GP1.
GEOM3M GEOM3 Table of Bulk Data entry images related to static and thermal loads
and updated for the current p-level. Output by GP0.
GEOM3N GEOM3 Updated GEOM3 for cyclic symmetry analysis. Output by
CYCLIC1. Modified GEOM3 with FORCEi and MOMENTi
records converted to FORCE and MOMENT records. Output by
SECONVRT.
GEOM3NT GEOM3 GEOM3 transformed for nonlinear transient response analysis.
Output by ST2DYN.
GEOM3S GEOM3 Table of Bulk Data entry images related to static and thermal loads
for the current superelement. Output by SEP2 and SEP2X.
GEOM3T GEOM3 GEOM3 table with new or modified temperatures. Output by
MATMOD option 18.
GEOM3X GEOM3 GEOM3 table related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis. Output by IFP3.
GEOM4 GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity. Output by IFP.
GEOM4* GEOM4 Family of GEOM4 tables for all partitioned superelements defined
in separate Bulk Data sections.
GEOM4CN GEOM4 Updated constraints for 3D contact. Output by NLSOLV.
Main Index
Glossary 1575
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
GEOM4EX GEOM4 GEOM4 table containing records which define an external
superelement. Specifically, ASETi and QSETi Bulk Data records.
Output by BDRYINFO.
GEOM4M GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity and updated for
the current p-level. Output by GP0.
GEOM4P GEOM4 Table of Bulk Data entry images related to constraints and updated
for the constraints applied by GMBC, GMSPC, SPC, SPC1, or
SPCD Bulk Data entries. Output by MODGM4.
GEOM4S GEOM4 Table of Bulk Data entry images related to constraints, degree-of-
freedom membership and rigid element connectivity for the current
superelement. Output by SEP2 and SEP2X.
GEOM4W GEOM4 GEOM4 augmented with dummy SEQSET1 entries to represent the
fluid superelement modes and QSET1 for all other non-fluid
superelement component modes. Output by MODQSET.
GEOM4X GEOM4 GEOM4 table related to axisymmetric conical shell and hydroelastic
Output by IFP3 and IFP4. GEOM4 table augmented with new RBE1
and RBE2 records (because all RBE1 and RBE2 elements are split
so that each one contains only one m-set grid) for ACMS='YES'.
Also augmented with SEQSET1 records for ACMS='YES'. Output
by SEQP.
GETNUMPN Logical. Panel static load computation flag. If TRUE then get
number of panels flag only and do not compute panel static loads.
GEQMAP Table of grid based local equation map indicating which grid resides
on which processors/partitions for domain decomposition. Output
by SEQP.
GLBRSP Matrix of global responses when system cell 297=-1. Output by
SDRP.
GLBRSPDS Global results matrix
GLBTAB Table of global responses when system cell 297=-1. Output by
SDRP.
GLBTABDS Global results correlation table
GLERR Table of global error estimates from previous iteration. Output by
ADAPT.
GLERR1 Table of global error estimates for current iteration. Output by
ADAPT.
GM Multipoint constraint transformation matrix, m-set by
n-set. Output by MCE1.
Main Index
1576 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
GMD Multipoint constraint transformation matrix with extra points, m-set
by ne-set. Output by UMERGE1.
GMNE Multipoint constraint transformation matrix, m-set by ne-set.
GMS Multipoint constraint transformation matrix, m-set by s-set.
GOA Omitted degree-of-freedom transformation matrix, o-set by a-set.
Output by FBS.
GOD Omitted degree-of-freedom transformation matrix with extra points,
o-set by d-set. Output by UMERGE1.
GPDCT Table of grid point stress discontinuities for post-processing in the
DBC module. Output by STDCON.
GPDT GPDT Grid point definition table. Output by GP1.
GPECT Grid point element connection table. Output by TA1.
GPECT1 Grid point element connection table for heat transfer analysis.
Output by TAHT.
GPECTDCN GPECT which incorporates combined constraints and design
variables. Output by DSAF.
GPECTF Grid point element connection table for follower force stiffness.
Output by TAFF.
GPFLBL Labels for GPFMAT rows. Output by ILMPGPF.
GPFMAT Matrix of monitor point force data where each column is a subcase
and each row is one component of the monitored forces. Output by
ILMPGPF.
GPFORCE Integer. The number of columns in FENL. If GPFORCE less than or
equal to zero then no GPFORCE or ESE command is present.
GPGK Aerodynamic transformation matrix for loads from the k-set to g-set.
Output by GI.
GPKH Aerodynamic transformation matrix for loads from the k-set to h-set.
GPIK Aerodynamic transformation matrix for loads from the h-set to k-set.
GPKE Matrix of grid point kinetic energies.
GPL GPL External grid/scalar point identification number list. Output by GP1.
GPLD External grid/scalar/extra point identification number list. (GPL
appended with extra point data). Output by DPD.
GPMPF Matrix of grid panel mode participation factors. Output by
MODEPF.
GPSETS Table of grid point sets related to the element plot sets. Output by
PLTSET and SEPLOT.
Main Index
Glossary 1577
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
GPSNT Grid point shell normal table. Output by TASNP2.
GPSNTN Grid point shell normal table updated due to the interaction with
RSSCON elements. Output by GP4.
GPSNTS Grid point shell normal table for the current superelement. Output by
SEP2 and TASNP2.
GPSPRT Table of grid point singularity created on the first call to GPSP when
the MPC option is selected on the AUTOSPC Case Control
command and DONSET=0. Output by GPSP.
GPSPRT0 GPSPRT from a previous call to GPSP and required when
DONSET=-1.
GPTT1 Table of grid point temperatures (for transient analysis only). Output
by NLCOMB.
GRIDFMP Integer. Case Control set identification number of fluid grids that
will be output.
GRIDMP Integer. Case Control set identification number for a set of fluid
grids.
GRIDSET Integer. SET Case Control command identification number which
contains a list grid point identification numbers.
GRDRM Permutation matrix. Output by PRESOL.
GS Transformation matrix between symmetric (sine) components and
solution set components. Output by CYCLIC3.
Main Index
1578 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
HARM Table of harmonic indices. Output by CYCLIC1.
HDRLBLi Character. Header with up to 64 characters to be printed and centered
at the top of each page.
HEADCNTL List of integer codes for header print control in the DISUTIL module
under VECPLOT options IOPT=1 or 5. Output by VECPLOT.
HIS HIS Table of design iteration history.
HISADD HIS Table of design iteration history for current design cycle. Output by
DOM12.
HMKT Matrix used to compute hinge moments for each AESURF entry.
Output by ADG.
HOEF1 OEF Table of element fluxes in SORT1 format updated for CHBDYi
elements. Output by SDRHT.
HOES1 Table of element heat flow in SORT1 format combined for linear
and nonlinear elements. Output by SDRHT.
Main Index
Glossary 1579
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
Ii Inputs to MATMOD and MATPCH module.
IEF OEF Table of element forces due to unit modal displacement in SORT1 or
SORT2 format. Output by SDR2 or SDR3.
IES OES Table of element stresses or strains due to unit modal displacement
in SORT1 or SORT2 format. Output by SDR2 or SDR3.
IFACT Interpolation factor vector (NV rows). Output by NDINTERP.
IFD Matrix of nonlinear element forces at constrained points at the output
time steps. Output by NLTRD and NLTRD2.
IFG Matrix of nonlinear element forces for the g-set at the output time
steps. Output by NLTRD.
IFP Matrix of element forces at the previous time step. Output by
NLSOLV.
IFPDB Table data block with IFP module table attributes.
IFS Matrix of total element forces and their rate of change. Output by
NLTRD2 and NLSOLV.
IFST Matrix of nonlinear element forces at constrained points at the output
time steps (for transient analysis only). Output by NLSOLV.
IMAT Matrix containing imaginary part of CMAT. Output by MATMOD
option 34.
IMATG Pesudo identity g-set matrix.
INDTA Table of element stress/strain or force item code overrides.
INVEC Starting vector(s).
IQG OQG Table of single point forces of constraint due to unit modal
displacement in SORT1 or SORT2 format. Output by SDR2 or
SDR3.
IUG OUG Table of displacements due to unit modal displacement in SORT1 or
SORT2 format. Output by SDR2 or SDR3.
IUNITSOL Integer. If IUNITSOL=0, then trim solution is being supplied. If
IUNITSOL>0, then IUNITSOL'th unit solution is being supplied.
Main Index
1580 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
K2DD Stiffness matrix contribution from the K2PP Case Control command
and reduced to the d-set. In frequency response analysis, K2DD may
also include structural damping effects.
K2GG Matrix defined on DMIG Bulk Data entries and referenced by the
K2GG Case Control command. Output by MTRXIN.
K2PP Matrix defined on DMIG Bulk Data entries and referenced by the
K2PP Case Control command. Output by MTRXIN.
K4AA Structural damping matrix in a-set or d-set.
K4KK Structural damping matrix in cyclic components. Output by
CYCLIC3.
K4XX Structural damping matrix in any set. Usually h-set or
d-set in FRRD1.
KAA Stiffness matrix in a-set or d-set.
KAAL Element stiffness matrix for linear elements only reduced to a-set.
KBDD Tangential stiffness in d-set.
KCVDD* Family of gyroscopic matrices.
KCVPP* Family of gyroscopic matrices - p-set.
KDD Stiffness matrix for the d-set, linear elements only.
KDDICT KDICT KDELM dictionary table. Output by EMG.
KDELM KELM Table of element matrices for differential stiffness. Output by EMG.
KDICT KDICT KELM dictionary table. Output by EMG.
KDICT1 KDICT KELM1 dictionary table. Output by GNFM.
KDICTDCN KELM dictionary table. which incorporates combined constraints
and design variables. Output by DSAF.
KDICTDS Perturbed element stiffness matrix dictionary table. If CDIF='YES'
then this is the forward perturbed element matrix dictionary. Output
by EMG.
KDICTNL KDICT KELMNL dictionary table. Output by EMG.
KDICTX KDICT Baseline element stiffness matrix dictionary table for
h-elements or p-elements. Output by EMG.
KELM KELM Table of element matrices for stiffness, heat conduction, differential
stiffness, or follower stiffness. Output by EMG.
KELM1 KELM Table of element matrices for incremental stiffness. Output by
GNFM.
Main Index
Glossary 1581
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
KELMDCN KELM Table of element matrices for stiffness, heat conduction, differential
stiffness, or follower stiffness which incorporates combined
constraints and design variables. Output by DSAF.
KELMDS KELM Table of perturbed element stiffness matrices. If CDIF='YES' then
this is the forward perturbed element matrix dictionary. Output by
EMG.
KELMNL KELM Table of element matrices for stiffness for nonlinear elements.
KFEFE Tangential stiffness in fe-set.
KFHH Fluid partition of modal stiffness matrix KHH.
KFRIC Frictional stiffness for 3D contact. Output by NLSOLV.
KFS Stiffness matrix partition (f-set by s-set) from KNN.
KGG Stiffness matrix in g-set.
KGG1 Stiffness matrix in g-set with general elements. Output by SMA3.
KGGNL Stiffness (or heat conduction) matrix in g-set for material nonlinear
elements only.
KGGNL1 Conduction matrix in g-set for material nonlinear elements only and
updated for radiation. Output by RMG2.
KGGT Total structural stiffness matrix in g-size (sum of linear, nonlinear
and differential matrices).
KHH Generalized (modal) stiffness matrix.
KHH1 Modified generalized (modal) stiffness matrix. Output by FA1.
KKK Stiffness matrix in cyclic components. Output by CYCLIC3.
KLL Stiffness matrix reduced to the l-set.
KLR Stiffness matrix partition (l-set by r-set) from KTT.
KMM Stiffness matrix in m-set (partition of KGG).
KNN Stiffness matrix in n-set; after multipoint constraint reduction.
KOO Stiffness matrix partitioned to the o-set from KFF.
KPP Stiffness matrix for the p-set, linear elements only.
KRDD Combined linear and material nonlinear stiffness matrix in the d-set.
KRFGG Stiffness matrix due to follower rotational forces in g-set. Output by
EMAKFR.
KRR Stiffness matrix partition (r-set by r-set) from KTT.
KRZX Matrix of restrained dimensional elastic derivatives.
Main Index
1582 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
KSAZX Matrix of dimensional rigid stability derivatives that includes the
effect of splines.
KSGG S-set by f-set matrix and s-set by s-set partitions of the material
nonlinear stiffness matrix and expanded to g-set size.
KSS Stiffness matrix partition (s-set by s-set) from KNN.
KTPP Tangential Stiffness of p-set.
KTTP Sparse partial decomp update matrix.
KTTS KTTP converted to standard matrix format. Output by MATMOD
option 46.
KUX Matrix of stiffness multiplied by displacement or eigenvectors.
KVAL Table of harmonic indices for analysis. Output by CYCLIC1.
KXWAA Stiffness matrix for the a-set, row-ordered in external grid id
sequence and divided by WTMASS.
KXX Stiffness matrix in any set. Usually v-set in READ. Usually h-set or
d-set in CEAD, FRRD1, FRRD2, TRD1, and TRD2.
Main Index
Glossary 1583
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
L Lower triangular decomposition factor. Output by MATMOD option
21.
LAJJT Lower triangular decomposition factor matrix of AJJT.
LAM1DD Lower triangular factor of the dynamic tangential matrix in the d-set.
LAMA LAMA Normal modes eigenvalue summary table. Output by READ,
LANCZOS, MODACC, and UEIGL.
LAMA* LAMA Family of normal modes eigenvalue summary tables.
LAMA1 LAMA Normal modes eigenvalue summary table updated for mode
tracking. Output by MODTRK.
LAMAF LAMA Normal modes eigenvalue summary table for the fluid portion of the
model.
LAMAM Matrix (diagonal) of eigenvalues for subspace iteration. Output by
DSAH.
LAMAS LAMA Normal modes eigenvalue summary table for the structural portion
of the model. Matrix (diagonal) of eigenvalue shifts for subspace
iteration. Output by DSAH.
LAMASEL LAMA table containing only those modes defined by MODSELT.
Output by GKAM.
LAMAX LAMA Modified LAMA table. Output by LAMX.
LAMMAT Diagonal matrix containing eigenvalues on the diagonal. Output by
READ, LANCZOS, and UEIGL.
LAO Sparse partial decomposition factor when KSYM=3. Output by
DCMP.
LBTAB Table of eigenvalues and generalized masses for retained buckling
eigenvalue responses. Output by DSAH.
LCDVEC Partitioning vector for load case deletion. The row size is the same
number of columns in UGX and ones for columns which are retained
in UGX1. LCDVEC is intended for partitioning of analysis results
related to inertia relief and SPCforces. Output by DSAD.
LCOLLBLi Character. Label with up to 32 characters to be printed left-justified
in upper left corner of each page.
LCPHL Left-handed complex eigenvector matrix in the l-set. Output by
CEAD.
LCPHP Left-handed complex eigenvector matrix in the p-set.
LCPHX Left-handed complex eigenvector matrix in the d-set or h-set. Output
by CEAD.
Main Index
1584 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
LD Lower triangular factor/diagonal. Output by DECOMP and DCMP.
LFTAB Table of eigenvalues and generalized masses for retained normal
mode eigenvalue responses. Output by DSAH.
LGPART Same as SPCPART except LGPART includes grid points not
connected to any element. Output by SEQP.
LISET Integer. Size of interference js-set extracted from the AEBGPTI
table. Output by MTRXIN.
LJSET Integer. Size of js-set extracted from the AEBGPTJ table. Output by
MTRXIN.
LKSET Integer. Size of ks-set extracted from the AEBGPTK table. Output
by MTRXIN.
LLL Lower triangular factor/diagonal for the l-set from KLL.
LLLT Lower triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
LMAT Normal modes eigenvalue summary table converted to a matrix.
Output by LAMX.
LMTROWS Integer. Number of Lagrange Multipliers appended to the A matrix.
These rows are excluded from the internal reordering in the DCMP
module.
LMPF Matrix of fluid force to fluid mode participation factors. Output by
MODEPF.
LOCVEC Vector containing grid locations in the basic coordinate system.
LOO Lower triangular factor/diagonal for the o-set from KOO. Output by
DCMP.
LSCM Schur complement matrix based on internal partitioning of A.
Output by DCMP.
LSEQ Resequencing matrix based on internal resequencing of KLL.
Output by DCMP and DECOMP.
LTF Lower triangular file of the solution matrix ULNT. Output by
NLTRD2 and NLSOLV.
LVTAB Table of eigenvalues and generalized masses for retained normal
mode eigenvector responses for all subcases. Output by DSAH.
LVTABI Table of eigenvalues and generalized masses for retained normal
mode eigenvector responses per subcase. Output by DSAH.
LXX Lower triangular factor/diagonal of shifted stiffness matrix.
Main Index
Glossary 1585
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
M2DD Mass matrix contribution from the M2PP Case Control command
and reduced to the d-set.
M2GG Matrix defined on DMIG Bulk Data entries and referenced by the
M2GG Case Control command. Output by MTRXIN.
M2PP Matrix defined on DMIG Bulk Data entries and referenced by the
M2PP Case Control command. Output by MTRXIN.
M9I Table of the nine mass invariants. Output by ADAMSMNF.
MA Rigid body mass matrix for the a-set. Output by EFFMAS.
MAA Mass matrix in a-set or d-set.
MABXWGG Mass matrix for the a-set, expanded to g-set, transformed to the basic
coordinate system, row-ordered in external grid identification
number sequence, and divided by WTMASS.
MAPS Superelement upstream to downstream boundary coordinate system
transformation matrix output by GENTRAN. Superelement
boundary transformation matrix for secondary superelements
(mirror, identical, and repeated), boundary resequencing and
releases output by SEP2 and SEP2X.
MAPS* Family of MAPS (superelement upstream to downstream boundary
coordinate system, secondary (mirror, identical, and repeated), and
release transformation matrix).
MAR Table of virtual mass element areas. Output by MGEN.
MAT Matrix. Output by MATGEN.
MATi Input matrices.
MAT1 Square symmetric matrix 1 to be partitioned.
MAT1N Local filtered matrix 1. Output by PRESOL.
MAT2 Square symmetric matrix 2 to be partitioned.
MAT2N Local filtered matrix 2. Output by PRESOL.
MATIi Matrices defined on DMIJI Bulk Data entries. Output by MTRXIN.
MATGi Matrices defined on DMIG Bulk Data entries and intended for the g-
set. Output by MTRXIN.
MATJi Matrices defined on DMIJ Bulk Data entries. Output by MTRXIN.
MATKi Matrices defined on DMIK Bulk Data entries. Output by MTRXIN.
MATNAMi Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI
Bulk Data entries.
Main Index
1586 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
MATPi Matrices defined on DMIG Bulk Data entries and intended for the p-
set. Output by MTRXIN.
MATPOOL Table of Bulk Data entry images related to hydroelastic boundary,
heat transfer radiation, virtual mass, DMIG, and DMIAX entries.
Output by IFP and IFP4.
MATPOOLS MATPOOL table for the current superelement. Output by SEP2X.
MATPOOLX MATPOOL table related to hydroelastic analysis. Output by IFP4.
MATS Any matrix on slave processors.
MATM Any matrix on master processor. Output by DISUTIL.
MBODY Body table for p-element analysis. Output by GP0.
MBSP Updated mass matrix (s-set)
MCEIGCC Logical. Modal complex eigenvalue analysis subcase flag. Set to
TRUE if at least one ANALYSIS=MCEIG command was found in
CASECC and CASECEIG is specified in the output list. Output by
MDCASE.
MCHI Matrix relating displacements to source strengths. Output by
MGEN.
MCHI2 Secondary matrix relating displacements to source strengths. Output
by MGEN.
MDD Mass (or radiation) matrix for the d-set
MDICT MELM dictionary table. Output by EMG.
MDUGNI Matrix of incremental displacements with respect to the last
converged step (UI - U0), to be used for LANGLE=3 or for the new
CQUADR/CTRIAR elements. Output by NLITER.
MEA Matrix of element forces per unit motion of the a-set.
MEDGE Edge table for p-element analysis. Output by GP0.
MEF Matrix form of element force output table. Output by DRMH1 and
DRMS1.
MEM Modal effective mass matrix. Output by EFFMAS.
MEMF Modal effective mass fraction table. Output by EFFMAS.
MES Matrix form of element stress or strain output table. Output by
DRMH1 and DRMS1.
MELM KELM Table of element mass matrices. Output by EMG.
MESH Mesh type for aerodynamic or structural components: 'AERO' or
'STRU'.
Main Index
Glossary 1587
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
MESTNL Nonlinear element summary table at current step. Output by
NLITER, NLSOLV, and NLTRD2.
MESTNL0 Initial nonlinear element summary table at each STEPcase. Output
by NLSOLV.
MEW Modal effective weight matrix. Output by EFFMAS.
MFACE Face table for p-element analysis. Output by GP0.
MFEFE Mass (or radiation) matrix for the fe-set.
MFHH Fluid partition of modal mass matrix MHH.
MGG Mass or radiation matrix in g-size.
MGG* Family of MGG (g-set mass) matrices.
MGGCOMB Combined mass matrix. Output by MASSCOMB.
MHH Generalized (modal) mass matrix
MHH1 Modified generalized (modal) mass matrix. Output by FA1.
MI Modal mass matrix. Output by READ and LANCZOS.
Mi Matrix data block. Output by INPUTT4 and input to MATPRN and
OUTPUT4.
MIDLIS Table of pairs of user-supplied material property identification
numbers (MIDs) and internal baseline MIDs. Output by DSABO.
MKK Mass matrix in cyclic components. Output by CYCLIC3.
MKLIST Table of Mach number and reduced frequency pairs. Output by
GETMKL.
MKNRGY Matrix of modal kinetic energy. Output by MODENRGY.
MLAM Matrix relating element forces to source strengths. Output by
MGEN.
MLAM2 Secondary matrix relating element forces to source strengths. Output
by MGEN.
MLL Mass matrix reduced to the l-set.
MLR Mass matrix partition (l-set by r-set) from MTT.
MMCDB Table of MAXMIN(DEF) specifications. Output by IFP1.
MMP Mass matrix (m-set by p-set)
MNRGYMTF Matrix of modal energy values for all EFM superelements for all
bands.
MOA Mass matrix partition (o-set by a-set) from MFF.
Main Index
1588 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
MODRPR Table indicating the number of initial responses per response type
per mode. Output by DSAD.
MODRPRG Table indicating the number of retained responses per response type
per mode.
MODRSP Table of eigenvector response counts by subcase and mode. Output
by DOPR3.
MODRSPR MODRSP for retained frequencies. Output by DSAD.
MODSELT Table of mode numbers selected by the combination of
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. If FLUID=TRUE,
then MODSELT is based on the MODESELECT(FLUID) Case
Control command and user parameters LMODESFL, LFREQFL,
and HFREQFL. Output by GKAM.
MODSELT1 Subset of MODSELT as selected by the MODALSE and
MODALKE Case Control commands. Output by MODENRGY.
MODSELTF Table of mode numbers selected by the combination of the
MODESELECT(FLUID) Case Control command and user
parameters LMODESFL, LFREQFL, and HFREQFL. Output by
GKAM.
MODSELTS Table of mode numbers selected by the combination of the
MODESELECT(STRUCTURE) Case Control command and user
parameters LMODES, LFREQ, and HFREQ. Output by GKAM.
MODSELV Partitioning vector equivalent of MODSELT. Output by GKAM.
MOFPi Matrix form of the i-th output table. Output by DRMH1 and
DRMS1.
MON Merged monitor table. Output by MRGMON.
MONi Monitor tables
MONDISP Monitor points table for displacements. Output by MAKMON.
MONITOR Structural monitor point table. Output by MAKAEMON and
MAKMON.
MOO Mass matrix partitioned to the o-set from KFF.
MP2S Table of MONPNT2 responses at trim.
MPAER Elastic restrained loads on aerodynamic monitor points at trim.
MPAERP Total elastic restrained loads on aerodynamic monitor points at trim
due to static applied loads.
MPAERV Elastic restrained monitor point loads on aerodynamic model
Main Index
Glossary 1589
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
MPAEUV Elastic unrestrained monitor point loads on aerodynamic model
MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim.
MPART Partitioning vector based on a permutation vector. Output by
MATGEN option 13.
MPARV Rigid monitor point loads on aerodynamic model
MPFEM Modal participation factors for effective mass. Output by EFFMAS.
MPFMAP Table describing content of mode participation factor matrices.
Output by MODEPF.
MPJN2O Mapping matrix to map j-set data from new order to old order.
Output by APD.
MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry
images. Output by VDR.
MPP Mass matrix in the p-set
MPSER Elastic restrained loads on structural monitor points at trim
(excluding inertial loads and static applied loads).
MPSERP Elastic restrained loads on structural monitor points due to static
applied loads.
MPSERV Elastic restrained monitor point loads on structural model
MPSEUV Elastic unrestrained monitor point loads on structural model
MPSIR Inertial loads on structural monitor points at trim.
MPSIRV Inertial restrained monitor point loads on structural model
MPSIUV Inertial unrestrained monitor point loads on structural model
MPSR Rigid aerodynamic loads on structural monitor points at trim
(excluding inertial loads and static applied loads).
MPSRP Rigid loads on structural monitor points due to static applied loads.
MPSRV Rigid splined monitor point loads on structural model
MPT MPT Table of Bulk Data entry images related to material properties.
Output by IFP and IFP6.
MPTC MPT Copy of MPT except MAT8 records are replaced by equivalent
MAT2 records. Output by IFP6, CMPZPR, and DSTA.
MPTN MPT Updated (optimized) MPT. Output by DOM11.
MPTNT MPT MPT transformed for nonlinear transient response analysis. Output
by ST2DYN.
MPTS MPT Table of Bulk Data entry images related to material properties for the
current superelement. Output by SEP2 and SEP2X.
Main Index
1590 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
MPTT MPT MPT updated for topology optimization. Output by IFP10.
MPTTC MPT MPT table updated for thermal control mechanisms. Output by
NLTRD2.
MPTX MPT MPT with design variable perturbations. Output by DSABO. Copy
of MPT except MATHP records are updated to include referenced
TABLES1 Bulk Data entry information. Output by IFP8.
Output by MKMNTIFP: MPT updated to track monitor points
Output by MODGM2: Copy of MPT updated for converted
CSHEAR elements.
MQE* Family of superelement modal mass matrices.
MQG Matrix form of single or multipoint forces-of-constraint output table.
Output by DRMH1 and DRMS1.
MR Rigid body mass matrix (r-set by r-set). Output by RBMG4.
MRR Stiffness matrix partition (r-set by r-set) from MTT.
MSNRGY Matrix of modal strain energy. Output by MODENRGY.
MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to
the new mode numbering. Output by MODTRK.
MUG Matrix form of displacement output table. Output by DRMH1 and
DRMS1.
MUGNI Displacement (or temperature) matrix for stiffness (or heat
conduction) update. Output by NLITER.
MULNT Solution matrix from nonlinear transient response analysis in the d-
set from the previous subcase. Output by NLTRD2.
MUPN Solution matrix from nonlinear response analysis in the p-set for
matrix update. Output by NLSOLV.
MUX Matrix of mass multiplied by displacements or eigenvectors.
MXWAA Mass matrix for the a-set, row-ordered in external grid id sequence
and divided by WTMASS.
MXX Mass matrix in any set. Usually v-set in READ. Usually h-set or d-
set in CEAD, FRRD1, FRRD2, TRD1, and TRD2.
MZZ Generalized mass matrix based on PHZ.
Main Index
Glossary 1591
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
NAMEi Matrices defined on DMIG Bulk Data entries. Output by MTRXIN.
NEWDBi Input table in Version 69 (or greater) format. Output by MAKENEW.
NEWEPT EPT updated from the NSML and NSML1 records. Output by
NSMEPT.
NFDICT Nonlinear element energy/force index table. Output by TA1.
NLFT Nonlinear Forcing function table. Output by DPD.
NLRSMAP Nonlinear restart map from the restart step. Output by NLRSLOOP.
NLRSMAP0 NLRSMAP from the previous run.
NORTAB Table containing fluid face and the maximum of eight structural
grids which lie within the acoustic face. Output by GP5.
NSMEST NSM Bulk Data entries in EST format. Output by TA1.
NWCASE CASECC associated with beta response. Output by DOPR1.
NWEDOM EDOM modified for random design variables. Output by DOPR1.
Main Index
1592 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OAG OUG Table of accelerations in SORT1 or SORT2 format. Output by SDR2.
OAG1VU OUG Table of accelerations in SORT1 format for view grids. Output by
SDRP.
OAG2 OUG Table of accelerations in SORT2 format. Output by SDR3.
OAGATO2 OUG Table of accelerations in SORT2 format for the autocorrelation
function. Output by RANDOM.
OAGCRM2 OUG Table of accelerations in SORT2 format for the cross correlation
function. Output by RANDOM.
OAGNO2 OUG Table of accelerations in SORT2 format for the NO function. Output
by RANDOM.
OAGPSD2 OUG Table of accelerations in SORT2 format for the PSD function.
Output by RANDOM.
OAGRMS2 OUG Table of accelerations in SORT2 format for the RMS function.
Output by RANDOM.
OBJTAB OBJTAB Design objective table for a given analysis type and superelement.
Objective attributes with retained response identification number.
Output by DOPR3.
OBJTABX Design objective table for a given analysis type and superelement
with respsect to RESP12X. Output by DOPR3.
OBJTBG OBJTAB Design objective table. Objective attributes with retained response
identification number.
OBJTBM Merged OBJTBR associated with unresolved DRESP2 and DRESP3
records
OBJTBR OBJTAB Table of design objective attributes with retained response
identification number. Output by DSAD.
OBTABXE OBJTABM with resolved DRESP2 and DRESP3 records. Output by
DSADX.
OCCORF Output table of cross-correlation functions. Output by RANDOM.
OCEIG Complex eigenvalue extraction report. Output by CEAD.
OCPSDF Output table of cross-power-spectral-density functions. Output by
RANDOM.
OEDE1 OEE Elemental energy loss. Output by GPFDR.
OEDS1 OES Table of element stress discontinuities. Output by STDCON.
OEEATO2 OEE Table of element strains in SORT2 format for the autocorrelation
function. Output by RANDOM.
Main Index
Glossary 1593
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OEECRM2 OEE Table of element strains in SORT2 format for the cross correlation
function. Output by RANDOM.
OEENO2 OEE Table of element strains in SORT2 format for the NO function.
Output by RANDOM.
OEEPSD2 OEE Table of element strains in SORT2 format for the PSD function.
Output by RANDOM.
OEERMS2 OEE Table of element strains in SORT2 format for the RMS function.
Output by RANDOM.
OEF OEF Table of element forces in SORT1 or SORT2 format. Output by
DDRMM.
OEF1 OEF Table of element forces (or fluxes) in SORT1 format. Output by
SDR2 or DRMH3.
OEF1A OEF Table of element forces in SORT1 format for the composite elements
only. Output by SDR2.
OEF1AA OEF Table of element forces in SORT1 format for the non-composite
elements only. Output by SDRCOMP.
OEF1DS OEF Table of element forces, excluding non-composite elements, in
SORT1 format for design responses.
OEF1VU OEF Table of element forces in SORT1 format for view elements. Output
by SDRP.
OEF1X OEF Table of element forces in SORT1 format updated for PLOAD1
loads and intermediate station output. Output by SDRX and
SDRXD.
OEF2 OEF Table of element forces in SORT2 format.
OEFATO2 OEF Table of element forces in SORT2 format for the autocorrelation
function. Output by RANDOM.
OEFCRM2 OEF Table of element forces in SORT2 format for the cross correlation
function. Output by RANDOM.
OEFD1M OEF Table of element forces in SORT1 format for design responses and
appended for all normal modes solutions.
OEFDSN OEF Table of element forces, excluding non-composite elements, in
SORT1 format for the perturbed configuration.
OEFDSNM OEF Table of element forces from normal modes analysis for the
perturbed configuration.
OEFIT OEF Table of composite element failure indices. Output by SDRCOMP.
OEFITDS OEF Table of composite element failure indices for design responses.
Main Index
1594 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OEFITDSN OEF Table of composite element failure indices for the perturbed
configuration.
OEFNL1 OEF Table of nonlinear element fluxes in SORT1 format. Output by
SDR2.
OEFNO2 OEF Table of element forces in SORT2 format for the NO function.
Output by RANDOM.
OEFPSD2 OEF Table of element forces in SORT2 format for the PSD function.
Output by RANDOM.
OEFRMS2 OEF Table of element forces in SORT2 format for the RMS function.
Output by RANDOM.
OEIG Real eigenvalue extraction report. Output by READ.
OEKE1 Elemental kinetic energy. Output by GPFDR.
OELOPDSN Table of element forces on adjacent elements.
OELOP1DS Table of element-oriented forces for design responses.
OEP Table of element pressures due to virtual mass in SORT1 or SORT2
format. Output by MDATA.
OES OES Table of element stresses or strains in SORT1 or SORT2 format.
Output by DDRMM.
OES1 OES Table of element stresses or strains in SORT1 format. Output by
SDR2 or DRMH3. OES1A Table of element strain/curvatures in
SORT1 format for the composite elements only. Output by SDR2.
OES1C OES Table of composite element stresses or strains in SORT1 format.
Output by SDRCOMP.
OES1CDS OES Table of composite element stresses in SORT1 format for design
responses.
OES1DS OES Table of element stresses in SORT1 format for design responses.
OES1M OES Element stress or strain table in SORT1 format in the element's
material coordinate system defined on the MAT1 entry. Output by
CURV.
OES1G OES Grid point stress or strain table in SORT1 format and interpolated
from the centroidal stress table, OES1M. Output by CURV.
OES1VU OES Table of element stresses in SORT1 format for view elements.
Output by SDRP.
OES1X OES Table of element stresses in SORT1 format updated for PLOAD1
loads and intermediate station output. Output by SDRX and
SDRXD. Table of linear and nonlinear element stresses in SORT1
and linear element format. Output by MERGEOFP.
Main Index
Glossary 1595
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OES2 OES Table of element stresses or strains in SORT2 format.
OES2GX OES Table of grid point stresses in SORT2 format. Output by
CURVPLOT.
OESATO2 OES Table of element stresses in SORT2 format for the autocorrelation
function. Output by RANDOM.
OESCDSN OES Table of composite element stresses in SORT1 format for the
perturbed configuration.
OESCRM2 Table of element stresses in SORT2 format for the cross correlation
function. Output by RANDOM.
OESD1M Table of element stresses in SORT1 format for design responses and
appended for all normal modes solutions.
OESDSN OES Table of element stresses in SORT1 format for the perturbed
configuration
OESDSNM Table of element stresses from normal modes analysis for the
perturbed configuration
OESNL1 OES Table of nonlinear element stresses in SORT1 format. Output by
NLTRD, NLTRD2, NLSOLV, and SDRNL.
OESNLB1 OES Table of slideline contact element stresses in SORT1 format. Output
by NLTRD2, NLSOLV, and SDRNL.
OESNLH Table of element heat flow in SORT1 format for nonlinear elements.
OESNLXR OES Table of nonlinear element stresses in SORT1 format and appended
for all subcases (OESNLX from SDRNL).
OESNO2 OES Table of element stresses in SORT2 format for the NO function.
Output by RANDOM.
OESPSD2 OES Table of element stresses in SORT2 format for the PSD function.
Output by RANDOM.
OESRMS2 OES Table of element stresses in SORT2 format for the RMS function.
Output by RANDOM.
OFMPF2M Table of fluid modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OFPE Element data recovery table in SORT1 or SORT2 format.
OFPES Filtered and sorted element data recovery table. Output by
STRSORT.
OFPi Output table suitable for processing by the OFP module.
OFPi1 Output table in SORT1 format usually created by, but not limited to,
the SDR2 module.
Main Index
1596 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OFPi2 Output table in SORT2 format.
OFPiX Output table in SORT2 or SORT1 format. Output by SDR3.
OGDS1 Table of grid point stress discontinuities. Output by STDCON.
OGPFB1 OGF Table of grid point forces. Output by GPFDR.
OGPFB1DS OGF Table of grid point forces for design responses.
OGPFDSN OGF Table of grid point forces for the perturbed configuration.
OGPKE1 Table of grid point kinetic energies in SORT1 format. Output by
SDR2.
OGPLYFI Table of global ply failure indices. Output by SDRCOMP.
OGPLYSS Table of global ply stresses/strains. Output by SDRCOMP.
OGPMPF2M Table of panel grid modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OGPSR Table of global ply strength ratios. Output by SDRCOMP.
OGPWG Grid point weight generator table in weight units. Output by GPWG
or VECPLOT (option 7).
OGPWG* Family of superelement grid point weight generator tables
OGPWGBW Grid point weight generator table transformed to the basic coordinate
system divided by WTMASS.
OGS1 OGS Table of grid point stresses or strains in SORT1 format. Output by
GPSTR2.
OGSTR1 OGS Table of grid point strains in SORT1 format.
Oi Outputs of MATMOD module.
OINT p-element output control table. Contains OUTPUT Bulk Data
entries. Output by IFP.
OINTDS p-element output control table for constrained elements. Output by
DOPR3.
OINTDSF p-element output control table for the perturbed configuration.
Output by DSAH.
OL Complex or real eigenvalue summary table, transient response time
output list or frequency response frequency output list. Output by
CEAD, READ, TRLG, and FRLG.
OL1 In MODACC, OL truncated by the OFREQ or OTIME Case Control
command. In MODENRGY, subset of OL selected by the
MODALSE and MODALKE Case Control commands. Output by
MODACC and MODENRGY.
Main Index
Glossary 1597
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OLDDBi Output table in pre-Version 69 format. Output by MAKEOLD.
OLF Nonlinear static load factor list.
OLMPF2M Table of load modal participation factors by natural modes in SORT2
format. Output by RANDOM.
OMAT1 MAT in OFP-suitable table in SORT1 format. Output by MATOFP.
OMCF1 Table of modal contribution factors in SORT1 format. Output by
MCFRAC.
OMM Table of maximum/minimum in SORT1 or SORT2 format. Output
by SDR2.
ONRGD1M OEE Table of element strain energies for design responses and appended
for all normal modes solutions.
ONRGDSNM OEE Table of element strain energies from normal modes analysis for the
perturbed configuration.
ONRGY1 OEE Table of element strain energies and energy densities. Output by
GPFDR.
ONRGYDS OEE Table of element strain energies in SORT1 format for design
responses. Output by GPFDR.
ONRGYDSN OEE Table of element strain energies and energy densities in SORT1
format for design responses for the perturbed configuration.
OPG1 OPG Table of applied loads in SORT1 format. Output by SDR2.
OPG2 OPG Table of applied loads in SORT2 format.
OPG2X OPG Table of applied loads in SORT2 format. Output by CURVPLOT.
OPGATO2 OPG Table of applied loads in SORT2 format for the autocorrelation
function. Output by RANDOM.
OPGCRM2 OPG Table of applied loads in SORT2 format for the cross correlation
function. Output by RANDOM.
OPGNO2 OPG Table of applied loads in SORT2 format for the NO function. Output
by RANDOM.
OPGPSD2 OPG Table of applied loads in SORT2 format for the PSD function.
Output by RANDOM.
OPGRMS2 OPG Table of applied loads in SORT2 format for the RMS function.
Output by RANDOM.
OPLYSR Table of ply strength ratios. Output by SDRCOMP.
OPMPF2M Table of panel modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
Main Index
1598 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OPNL1 Table of nonlinear loads in SORT1 format for the h-set or d-set.
Output by VDR.
OPTPRM OPTPRM Table of optimization parameters.
OPTPRMG OPTPRM Table of optimization parameters.
OPTNEW Updated table of optimization parameters. Output by DOM12.
OQG OQG Table of single or multipoint forces-of-constraint in SORT1 or
SORT2 format. Output by DDRMM.
OQG1 OQG Table of single or multipoint forces-of-constraint in SORT1 format.
Output by SDR2 or DRMH3.
OQG1DS OQG Table of single point forces-of-constraint in SORT1 format for
design responses.
OQG2 OQG Table of single point forces of constraint in SORT2 format.
OQG2X OQG Table of single point forces of constraint in SORT2 format. Output
by CURVPLOT.
OQGATO2 OQG Table of single point forces of constraint in SORT2 format for the
autocorrelation function. Output by RANDOM.
OQGCRM2 OQG Table of single point forces of constraint in SORT2 format for the
cross correlation. Output by RANDOM.
OQGDSN OQG Table of single forces-of-constraint in SORT1 format for design
responses for the perturbed configuration.
OQGNO2 OQG Table of single point forces of constraint in SORT2 format for the
NO function. Output by RANDOM.
OQGPSD2 OQG Table of single point forces of constraint in SORT2 format for the
PSD function. Output by RANDOM.
OQGRMS2 OQG Table of single point forces of constraint in SORT2 format for the
RMS function. Output by RANDOM.
OQMATO2 OQG Table of multipoint forces of constraint in SORT2 format for the
autocorrelation function. Output by RANDOM.
OQMCRM2 OQG Table of multipoint forces of constraint in SORT2 format for the
cross correlation function. Output by RANDOM.
OQMG OQG Table of multipoint forces-of-constraint in SORT1 or SORT2 format.
Output by SDR2.
OQMG2 OQG Table of multipoint forces of constraint in SORT2 format.
OQMNO2 OQG Table of multipoint forces of constraint in SORT2 format for the NO
function. Output by RANDOM.
Main Index
Glossary 1599
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OQMPSD2 OQG Table of multipoint forces of constraint in SORT2 format for the
PSD function. Output by RANDOM.
OQMRMS2 OQG Table of multipoint forces of constraint in SORT2 format for the
RMS function. Output by RANDOM.
OSMPF2M Table of structural modal participation factors by natural modes in
SORT2 format. Output by RANDOM.
OSTR OES Table of element stresses in SORT1 or SORT2 format. Output by
SDR2.
OSTR1CDS OEE Table of composite element strains in SORT1 format for design
responses.
OSTR1DS OEE Table of element strains in SORT1 format for design responses.
OSTR1G OEE Table of grid point strains in SORT1 format. Output by CURV.
OSTR1VU OEE Table of element strains in SORT1 format for view elements. Output
by SDRP.
OSTR1X OES Table of element strains in SORT1 format augmented with strains for
1-D elements. Output by SDRX and SDRXD.
OSTR2 OEE Table of element strains in SORT2 format.
OSTR2GX OEE Table of grid point strains in SORT2 format. Output by CURVPLOT.
OSTRCDSN OEE Table of composite element strains in SORT1 format for the
perturbed configuration.
OSTRD1M OES Table of element strains in SORT1 format for design responses and
appended for all normal modes solutions.
OSTRDSN OEE Table of element strains in SORT1 format for the perturbed
configuration
OSTRDSNM OES Table of element strains from normal modes analysis for the
perturbed configuration.
OTMT Transpose of the output transformation matrix. Each column of the
matrix will be associated with a single ILMP (and labeled in
RLABEL). The rows will be the partition of g-set size dofs which are
contributing (CP defined). Ouptut by ILMP2.
OUG OUG Table of displacements in SORT1 or SORT2 format. Output by
DDRMM.
OUG1 OUG Table of displacements in SORT1 format. Output by SDR2 or
DRMH3.
OUG1DS OUG Table of displacements in SORT1 format for design responses.
Main Index
1600 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
OUG1VU OUG Table of displacements in SORT1 format for view grids. Output by
SDRP.
OUG2 OUG Table of displacements in SORT2 format.
OUG2X OUG Table of displacements in SORT2 format. Output by CURVPLOT.
OUGATO2 OUG Table of displacements in SORT2 format for the autocorrelation
function. Output by RANDOM.
OUGCRM2 OUG Table of displacements in SORT2 format for the cross correlation
function. Output by RANDOM.
OUGD1M OUG Table of displacements in SORT1 format for design responses and
appended for all normal modes solutions.
OUGDSN OUG Table of displacements in SORT1 format for design responses for the
perturbed configuration.
OUGDSNM OUG Table of eigenvectors for design responses for the perturbed
configuration.
OUGNO2 OUG Table of displacements in SORT2 format for the NO function.
Output by RANDOM.
OUGPSD2 OUG Table of displacements in SORT2 format for the PSD function.
Output by RANDOM.
OUGRMS2 OUG Table of displacements in SORT2 format for the RMS function.
Output by RANDOM.
OUTVEC Last vector block (Lanczos only). Output by READ.
OUXY1 OUG Table of displacements in SORT1 format for h-set or
d-set. Output by VDR.
OVG Table of aeroelastic x-y plot data for V-g or V-f curves. Output by
FA2.
OVG OUG Table of velocities in SORT1 or SORT2 format. Output by SDR2.
OVG1VU Table of velocities in SORT1 format for view grids. Output by
SDRP.
OVG2 Table of velocities in SORT2 format.
OVGATO2 Table of velocities in SORT2 format for the autocorrelation function.
Output by RANDOM.
OVGCRM2 Table of velocities in SORT2 format for the cross correlation
function. Output by RANDOM.
OVGNO2 Table of velocities in SORT2 format for the NO function. Output by
RANDOM.
Main Index
Glossary 1601
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1602 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
P2G Matrix defined on DMIG Bulk Data entries and referenced by the
P2G Case Control command. Output by MTRXIN.
PA Static load matrix reduced to the a-set. Output by SSG2.
PA* Family of static load matrices (PA) applied on the boundary (a-set)
of all upstream superelements.
PAK Aerodynamic forces at aerodynamic boxes.
PANSLT Panel static load table. Output by GP5.
PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to
degrees-of-freedom which were eliminated in the partition to obtain
KXX, etc. Required for maximum efficiency during symmetric
decomposition and if KXX represents a subset of the
d-set (SETNAME='D'). PARTVEC is not required if KXX
represents the h-set. See SETNAME parameter description below.
PBGPDT BGPDT Basic grid point definition table updated to support plotting
CHBDYi elements. Output by PLTHBDY.
PBRMS Table of intermediate arbitrary beam data. Output by IFP9.
PBRMSD Table of arbitrary beam data. Output by DOPR1.
PBRMSN Updated (optimized) PBRMSD. Output by DOM11.
PBYG Matrix of equivalent static loads due to enforced velocity for the g-
set.
PC Optional stepwise preconditioner in SOLVIT and STATICS, same as
A and KGG respectively.
PC1 Updated stepwise preconditioner matrix. Output by SOLVIT and
STATICS.
PCDB Table of model (undeformed and deformed) plotting commands.
Output by IFP1.
PCDBS Table of model (undeformed and deformed) plotting commands for
the current superelement (identification number equal to output
value of SEID). Output by SEP2CT.
PCDBDR Table of model (undeformed and deformed) plotting commands for
the superelement (identification number equal to output value of
SEID). Output by SEDR.
PCOMPT Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry.
PCOMPTC Table containing LAM option input and expanded information from
the PCOMP Bulk Data entry. Output by IFP6.
Main Index
Glossary 1603
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
PCOMPTX PCOMPT with design variable perturbations. Output by DSABO.
PD Dynamic load matrix for the d-set.
PD1 Equivalent load vector for mode acceleration computations for the
a-set. Output by DDR2.
PDF Frequency response load matrix in the d-set. Output by FRLG.
PDT Transient response load matrix in the d-set for output time steps.
Output by TRLG and NLTRLG.
PDT1 Transient response load matrix in the d-set for all time steps. Output
by TRLG.
PECT Element connectivity table updated to support plotting CHBDYi
elements. Output by PLTHBDY.
PELSDSF p-element set table for the perturbed configuration. Output by
DSAH.
PELSET p-element set table, contains SETS DEFINITIONS. Output by
PLTSET.
PELSETDS p-element set table for constrained elements. Output by DOPR3.
PFHF Fluid partition of frequency response modally reduced load matrix.
PFP Frequency response load matrix in the p-set combined with gust
loads. Output by GUST.
PG Static load matrix applied to the g-set. In superelement analysis and
output by SELA, PG includes the loads from upstream
superelements. Output by SSG1 and SELA.
PG* Family of PG matrices vectors qualified by LOADID and
LOADNAME. One matrix is created per EXPORTLD request.
Output by EXPORTLD.
PG1 Combined static load matrix for the g-set and in the residual
structure. Output by PCOMB.
PGFB* Family of PG matrices. Output by FBDODYLD.
PGG Force matrix in g-set for all processors (global). Output by
DISUTIL.
PGRV Static load matrix applied to the g-set but due to gravity loads only.
Output by SSG1.
PGT Static load matrix applied to the g-set appended for all boundary
conditions. Output by SDR1.
PGUP Static load matrix for the g-set and in the residual structure due to
static loads in upstream superelements only.
Main Index
1604 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
PGVST Static load vector matrix (g-set). Output by MAKAEFS.
PHA Normal modes eigenvector matrix in the a-set. Output by READ.
PHA1 Normal modes eigenvector matrix in the a-set updated for mode
tracking. Output by MODTRK.
PHAREF1 Designed normal modes eigenvector matrix in the a-set updated for
mode tracking. Output by MODTRK.
PHASH2 Structural partition (row-wise) of eigenvector matrix PHDH. Also
partitioned column-wise according to parameter STRUCTMP.
PHDFH Fluid partition (row-wise) of eigenvector matrix PHDH.
PHDH Transformation matrix from d-set to h-set (modal). Output by
GKAM.
PHF Frequency response load matrix in the h-set (modal). Output by
FRLG.
PHF1 Frequency response load matrix in the h-set (modal) combined with
gust loads. Output by GUST.
PHG Normal modes eigenvector matrix in the g-set. Output by READ and
LANCZOS.
PHG* Family of normal modes eigenvector matrices in the
g-set.
PHG1 Normal modes eigenvector matrix in the g-set updated for mode
tracking. Output by MODTRK.
PHGREF Designed normal modes eigenvector matrix in the g-set from the
prior design cycle output of MODTRK. Output by MODTRK.
PHGREF1 Designed normal modes eigenvector matrix in the g-set updated for
mode tracking. Output by MODTRK.
PHIDLL Retained left divergence eigenvector responses.
PHIDRL Retained right divergence eigenvector responses.
PHT Transient response load matrix in the h-set (modal) for all time steps.
Output by TRLG.
PHX Right eigenvector matrix for real eigenvalues only. Output by
UEIGL.
PHXL Left eigenvector matrix for real eigenvalues only. Output by UEIGL.
PHZ Generalized degree-of-freedom transformation matrix. Output by
DYNREDU.
Main Index
Glossary 1605
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
PIj Any matrix with the same number of columns as there are
eigenvalues, frequencies, or time steps in OL. The rows of the
matrix may correspond to any degree-of-freedom set size.
PIj1 PIj truncated by the OFREQ or OTIME Case Control command.
Output by MODACC.
PJ Static load matrix for the g-set of the current superelement and
applied to its interior points only.
PKF Matrix of k-set forces per frequency.
PKYG Matrix of equivalent static loads due to enforced displacement for
the g-set.
PL Static load matrix reduced to the l-set. Output by SSG2.
PLI Static load matrix with inertial loads and reduced to the l-set. Output
by SSG4.
PLIST2 Table of type two properties on DVPREL2 Bulk Data entries.
Output by DOPR1.
PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data
entries. Output by DOPR1.
PLMAT Initial and final load matrices for subcase.
PLOTMSG Table of user informational messages generated during the plot
process. Output by PLOT.
PLSETMSG Table of user informational messages generated during the
definition of element plot sets. Output by PLTSET and SEPLOT.
PLTPAR Table of plot parameters and plot control. Output by PLTSET and
SEPLOT.
PMPF Matrix of contribution of structural panels to fluid mode
participation factors. Output by MODEPF.
PMYG Matrix of equivalent static loads due to enforced acceleration for the
g-set.
PNL Nonlinear load matrix appended from each output time step. Output
by NLTRD, NLTRD2, TRD1, and TRD2.
PNLLST Table of triplets defining panel names and their associated IPANEL
qualifier values
PNLT Nonlinear load matrix appended from each output time step. (for
transient analysis only). Output by NLSOLV.
PO Static load matrix partitioned to the o-set. Output by SSG2.
Main Index
1606 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
POI Static load matrix with inertial loads and reduced to the o-set. Output
by SSG4.
POSTCC Table containing POST command selections. Output by
MODCASE.
POSTCC0 POSTCC computed from previous execution of MODCASE
(POSTCFLG=1)
POSTCDB Table of commands from the OUTPUT(POST) section of Case
Control. Output by IFP1.
PPF Frequency response load matrix in the p-set. Output by FRLG.
PPL Nonlinear load (applied and NOLINi) matrix appended from each
output time step. Output by NLSOLV.
PPLT Nonlinear load (applied and NOLINi) matrix appended appended
from each output time step (for transient analysis only). Output by
NLSOLV.
PPN Applied load vectors for nonlinear analysis in the p-set.
PPT Transient response load matrix in the p-set for output time steps.
Output by TRLG.
PVPERQ Partitioning vector for the V columns of PGVST into those to be
scaled by Q (=1) and those that are absolute (=0). Output by
MAKAEFS.
PPVR Partitioning vector for random responses. Output by DOPRAN.
PRBDOFS Partitioning matrix to partition the "active" URDDI from the
"inactive". Active URRDI are assigned a 1.0 value and are
connected to the SUPORT degrees-of-freedom. Output by
MAKETR.
PROPI Matrix of initial property values. Output by DOPR1.
PROPI* Family of matrices of initial property values. Output by DOPR1.
PROPO Matrix of final (optimized) property values. Output by DOM9.
PS Static load matrix partitioned to the s-set. Output by SSG2.
PSDF Power spectral density table. Output by RANDOM.
PSDL Power spectral density list. Output by DPD.
PSF Frequency response load matrix in the s-set. Output by FRLG.
PSFL Loads due to enforced motion on linear elements in nonlinear
transient analysis.
PSI Modal partitioning factor matrix.
Main Index
Glossary 1607
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
PST Transient response load matrix in the s-set for output time steps.
Output by TRLG.
PTELEM Table of thermal loads in the elemental coordinate system. Output by
SSG1.
PTELEM0 Table of thermal loads in the elemental coordinate system from prior
subcase. Output by SSG1.
PTELMDCN Table of thermal loads in the elemental coordinate system which
incorporates combined constraints and design variables. Output by
DSAF.
PTELMDSX Table of thermal loads in the elemental coordinate system for the
central, forward, or backward perturbed configuration. Output by
SSG1.
PUG Matrix of translational displacements. Output by SDR2.
PUG* Family of matrices of translational displacements for all
superelements.
PUGD Matrix of translational displacements in dynamic analysis. Output
by SDR2.
PUGS Matrix of translational displacements in static analysis. Output by
SDR2.
PUGX PUG assembled for superelements defined on the SEPLOT or
SEUPPLOT command. Output by SEPLOT.
PVAL0 P-value table generated by the ADAPT module in previous
superelement, adaptivity cycle, or run.
PVAL1 P-value table updated for current superelement or adaptivity loop.
Output by ADAPT.
PVEC Partitioning vector for supported degrees-of-freedom specified on
CYSUP Bulk Data entry. Output by CYCLIC3.
PVGRID Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the following
Case Control commands: DISPLACEMENT, VELOCITY,
ACCELERATION, FORCE, STRESS, STRAIN, SPCFORCE,
MPCFORCE, MPRES, GPFORCE, ESE, EKE, EDE, GPKE.
Output by OUTPRT.
PVGT Partitioning vector for extracting the grid point translational DOFs.
Output by SEEFMNOR.
PVLOAD Partitioning vector with ones at rows corresponding to degrees-of-
freedom at which static and dynamic loads are applied. Output by
OUTPRT.
Main Index
1608 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
PVMCFR Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
MCFRACTION Case Control command. Output by OUTPRT.
PVMPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
MPCFORCE Case Control command. Output by OUTPRT.
PVSBIT1 Partitioning vector from all modes to subspace iteration modes.
Output by DSAH.
PVSBIT2 Partitioning vector from subspace iteration modes to constrained
modes. Output by DSAH.
PVSPC Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to elements or grids specified on the
SPCFORCE Case Control command. Output by OUTPRT.
PVT Table containing parameter values from PARAM Bulk Data entry
images. Output by IFP.
PVTS Table containing parameter values which are resolved from values
in PVT, CASECC, and, optionally, the NDDL. Output by PVT.
PX Inertial or pseudo-load matrix. Output by DSAP.
PXA Matrix of modally reduced static loads.
PXF Frequency response load matrix in h-set (modal) or d-set.
PXT Transient response load matrix in the h-set (modal) or
d-set. Output by TRLG.
PXTDV Transient response load matrix in h-set (modal) or d-set combined
from two executions of TRLG: one with DVFLAG=0 and the other
of DVFLAG=1.
PXT1 Reduced transient response load matrix analysis. Output by DSAR.
PZ Reduced aerostatic loads matrix.
Main Index
Glossary 1609
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
QG Single-point constraint forces of constraint matrix in the g-set.
Output by LANCZOS, STATICS, and SDR1.
QHH Aerodynamic matrix of size h- by h-set. Output by AMP.
QHHL Aerodynamic matrix list
QHJ Aerodynamic matrix of size h- by j-set. Output by AMP.
QHJK Aero transformation matrix between h and j sets. Output by GUST.
QHJL Aero transformation matrix between h and j sets.
QKGUST* Family of j-set downwashes (normal washes) matrices qualified by
reduced frequency, mach number, and gust rotation.
QKH Aerodynamic matrix of size k- by h-set. Output by AMP.
QKHL Aero transformation matrix between h and k sets.
QLL Aerodynamic matrix for divergence analysis.
QMG Multipoint constraint forces of constraint matrix in the
g-set. Output by LANCZOS and STATICS.
QMPF Multipoint forces of constraint matrix in the p-set for frequency
response.
QMPFM Merged QMPF. Output by DSAD.
QNV Quasi-Newton sweeping vectors. Output by NLITER.
QPF Single-point forces of constraint matrix in the p-set for frequency
response.
QPFM Merged QPF. Output by DSAD.
QPV Nonlinear constraint forces. Output by NLSOLV.
QR Matrix of determinate support forces. Output by SSG2.
QXX Aerodynamic matrix in any set.
Main Index
1610 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
R Residual matrix. Output by SOLVIT.
R1MAPR R1MAP Table of mapping from original first level (direct) retained
responses. Output by DSAD.
R1TAB Table of first level (direct) (DRESP1 Bulk Data entry) attributes.
Output by DOPR3.
R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry)
attributes. Output by DSAD.
R1TABRG Table of attributes of the retained first level (direct) responses.
R1VAL Matrix of initial values of the retained first level (direct) responses.
Output by DSAD.
R1VALO Matrix of final (optimized) values of the retained first level (direct)
responses. Output by DOM9.
R1VALR Matrix of retained type one responses. Output by DSAD.
R1VALRG Matrix of initial values of the retained first level (direct) responses.
R2MAPR Table of mapping from original second level (synthetic) retained
responses. Output by DSAD.
R2VAL Matrix of initial values of the retained second level (synthetic)
responses. Output by DSAD.
R2VALO Matrix of final (optimized) values of the second level (synthetic)
responses. Output by DOM9.
R2VALR Matrix of retained second level (synthetic) responses.
R2VALRG Matrix of initial values of the retained second level (synthetic)
responses.
R2VALXE R2VALRG with resolved DRESP2 records. Output by DSADX.
R3VAL Matrix of initial values of the retained third level responses. Output
by DSAD.
R3VALO Matrix of final values of the third level responses. Output by DOM9.
R3VALR Matrix of initial values of the retained third level responses. Output
by DSAD.
R3VALRG Matrix of initial values of the retained third level responses.
R3VALXE R3VALRG with resolved DRESP3 records. Output by DSADX.
RBF Rigid body force matrix. Output by VECPLOT and MKRBVEC.
RCROSSL Table of RCROSS Bulk Data entry images. Output by DPD.
RDEST Radiation element summary table. Output by RMG2.
Main Index
Glossary 1611
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
RECM Radiation exchange coefficient matrix. Output by RMG2.
RDG Reduction matrix from g-set to d-set (transposed).
RESMATFT Matrix of average velocity response for all EFM superelements for
all bands.
RESMAX Resultant or maxima matrix. Output by VECPLOT.
RESMAX0 Resultant or maxima matrix for residual structure. Output by
VECPLOT.
RESP12X RESP12 Table of second level (synthetic) responses from than one
superelement. Output by DOPR3.
RESP12XM Merged table of second level (synthetic) responses from all
superelements.
RESP12XR RESP12X for retained frequencies. Output by DSAD.
RESP3 Table of third level responses. Output by DOPR3.
RESP3R Table of retained third level responses in RESP3. Output by DSAD.
RESP3X Table of third level responses from more than one superelement.
Output by DOPR3.
RESP3XE RESP3XM with resolved DRESP3 records. Output by DSADX.
RESP3XM Merged table of third level responses from all superelements.
RESP3XR RESP3X for retained frequencies. Output by DSAD.
RESP12 RESP12 Table of second level (synthetic) responses. Output by DOPR3.
RGG Radiation transfer matrix in the g-set. Output by RMG2.
RHMCF Matrix of dimensional rigid unsplined hinge moment data
RLABEL Monitor point label for each column in OTMT. Ouptut by ILMP2.
RMAT Matrix containing real part of CMAT. Output by MATMOD option
34.
RMATG Rectangular matrix defined on DMIG Bulk Data entries and may
have an arbitrary number of columns but g-set rows, similar to P2G.
Output by MTRXIN.
RMG Multipoint constraint equation matrix. Output by GP4.
RMG1 Updated RMG matrix when MPC option is selected on the
AUTOSPC Case Control command. Output by GPSP.
RMPTQM Matrix of updated initial MPCforces.
RMSTAB Table of RMS responses. Output by DOPRAN.
RMSTABR Table of retained RMS responses in RMSTAB. Output by DSAD.
Main Index
1612 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
RMSTBR Table of retained RMS responses.
RMSVAL Matrix of initial RMS values. Output by DSARME.
RMSVALR Matrix of initial values of the retained RMS responses in RMSVAL.
Output by DSAD.
RMSVLR Matrix of retained RMS values.
ROTORT Table of rotordynamics user input for transient analysis. Output by
ROTOR module.
RP Row partitioning vector.
RPERM Table of row permutations under KSYM=4. Output by DECOMP.
RPH Transformation matrix from h-set to p-set.
RPV Load matrix (two columns) at the final iteration before exit.
RPX Reduction matrix from p-set to h-set (modal) or d-set.
RQA Matrix of spawned generalized stiffness and mass indices. Output by
DSTAP2.
RQATAB Table of Rayleigh Quotient Approximation. Output by DOPR3.
RQATABR Table of Rayleigh Quotient Approximation for retained eigenvalues.
RQATABRG Total table of Rayleigh Quotient Approximation for retained
eigenvalues.
RR2IDR Table of retained referenced type two response identification list.
Output by DSAD.
RR2IDXE RR2IDR with resolved DRESP2 and DRESP3 records. Output by
DSADX.
RSLTDATA Table of actual results data when system cell 297=3. Output by
SDRP.
RSLTSTAT Table of result-state information when system cell 297=2. Output by
SDRP.
RSP12R RESP12 Table of retained second level (synthetic) responses in RESP12.
Output by DSAD.
RSP1CT Table of the count of type 1 responses per response type per subcase
in R1TAB. Output by DOPR3.
RSP2RG RESP12 Table of attributes of the retained second level (synthetic) responses.
RSP2XE RSP2RXM with resolved DRESP2 records. Output by DSADX.
RSP2XM Merged RSP2X with unresolved DRESP2 records
RSP3RG Table of attributes of the retained third level responses.
RSPTQS Matrix of updated initial SPCforces.
Main Index
Glossary 1613
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1614 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
SCLFMAT Matrix of simple coupling loss factors. Output by SEEFMCLF.
SCSTM Table of global transformation matrices for partitioned
superelements. Output by SEP1 and SEP1X.
SELIST Table containing the list of partitioned superelements defined in
separate Bulk Data sections. Output by SEPR1.
SEMAP SEMAP Superelement map table. Output by SEP1 or SEP1X.
SEQMAP Mapping matrix for resequencing. Output by SEQP.
SET SET Table of combined sets. Output by NASSETS.
SETREE Superelement tree table usually input via the DTI,SETREE Bulk
Data entry.
SGPDT Superelement basic grid point definition table. Output by SEP1X.
SGPDTS Superelement basic grid point definition table for the current
superelement. Output by SEP2X.
SGPDTS* Family of SGPDTS tables created in previous runs.
SHPVEC Matrix of basis vectors - coefficients relating designed grid
coordinates and design variables. Output by DOPR2.
SIL Scalar index list. Output by GP1.
SIL0 SIL table from a previous adaptivity index in p-version analysis.
SILD Scalar index list for the p-set. Output by DPD.
SKJ Integration matrix. Output by AMG.
SLIST Superelement processing list to matrix generation, assembly, and
reduction. Output by SEP3.
SLT Table of static loads. Output by GP3.
SLTF Table of static loads with follower forces only. Output by DLT2SLT.
SLT1 Table of static loads updated for nonlinear analysis. Output by
NLCOMB.
SLTH Table of static loads updated for heat transfer analysis. Output by
SSG1.
SLTNL SLT with follower forces for CQUADR/CTRIAR elements for both
the current and last load step. Output by SSG1.
SLTNL0 SLTNL from a prior execution of SSG1.
SMPF Matrix of contribution of structure to fluid mode participation
factors. Output by MODEPF.
SNORM* Family of shell normal vectors at superelement boundaries.
Main Index
Glossary 1615
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
SNORMM Matrix of superelement grid point shell normal vectors. Output by
SEEFMNOR.
SNORMS Table of shell normal vectors on a superelement's boundary. Output
by TASNP1.
SORTBOOL Square matrix containing unity at a row position in the column
associated with the sorted row terms. Output by MATMOD option
35.
SORTLIST Vector consisting of the row numbers of the original positions of the
sorted terms. Output by MATMOD option 35.
SPCCOL Local f-size partitioning vector with 1.0 for the local boundary's s-
set degrees-of-freedom. Required only for geometric domain
decomp.
SPCPART Partitioning vector for domain decomposition. Output by SEQP.
SPECSEL Response spectra input correlation table.
SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with
external grid identification numbers. Output by MKSPLINE.
SPSEL Table of response spectra generation correlation selections.
SRKS Matrix of monitor point rigid body vectors. Output by MONVEC.
SRKT Matrix used to sum the forces and moments acting on the k-set
degrees-of-freedom to the reference point. Output by ADG.
STATDATA Table of state information when system cell 297=1. Output by SDRP.
STBDER Table of aerostatic stability derivatives for a single subcase. Output
by SDP.
STBTAB Table of aerostatic stability derivatives for all subcases.
STRUCOMP Table of structural components when MESH='STRU'. Output by
MAKCOMP.
SVEC Starting "random" eigenvector matrix.
SYSE Matrix of (strain or kinetic) energy in the residual structure a-set.
SZR Merged monitor matrices. Output by MRGMON.
SZRi Associated monitor matrices
Main Index
1616 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
T Table information to support MATGEN module options. Diagonal
from symmetric decomposition. Output by MATMOD option 21.
TA Secondary table to be merged into TOLD to form TNEW.
TAB Table.
TABi Tables.
TABDEQ Table of unique design variable identification numbers. Output by
DOPR4.
TABECN Table of relationship between internal identification numbers of
constraints in ESTDCN and elements and responses in R1TABR.
Output by DSAF.
TABEVP Cross-reference table between ESTDVP records and element and
design variable identification numbers. Output by DSABO.
TABEVS Cross reference table between ESTDVS records and element and
design variable identification numbers. Output by DOPR6.
TABEV2 Merged cross reference table of TABEVP and TABEVS. Output by
DSAE.
TB Secondary table to be merged into TOLD to form TNEW.
TC Secondary table to be merged into TOLD to form TNEW.
TEF Directory table for MEF. Output by DRMH1 and DRMS1.
TEL Transient response time output list appended from each subcase.
Output by NLTRD, NLSOLV, and NLTRD2.
TEMF Total effective mass fraction table. Output by EFFMAS.
TES Directory table for MES. Output by DRMH1 and DRMS1.
TFPOOL Table of TF Bulk Data entry images. Output by DPD.
TIMSIZ Table of CPU and disk space estimation parameters. Output by
SEQP.
TKNRGY Table of modal kinetic energy. Output by MODENRGY.
TMINIT Table of initial design variable values for topology with
manufacturing constraints. Output by DOPR1.
TMLD Table of loads for nonlinear transient analysis. Output by NLTRLG.
TNEW Table data block to be edited by TABEDIT.
TOFPi Directory table for MOFPi. Output by DRMH1 and DRMS1.
TOL TOL Transient response time output list. Output by IFT, TOLAPP, TRD2
and TRLG.
Main Index
Glossary 1617
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
TOL1 TOL Transient response time output list reduced by the OTIME Case
Control command or for the current nonlinear transient subcase.
Output by MODACC and TOLAPP.
TOLD Table data block to be edited by TABEDIT.
TOLR Updated TOL in restarts requested by user parameter STIME>0.0.
Output by TRLG.
TOPELE Element list for topology optimization. Output by IFP10.
TOPMC Topology member size control table. Output by DOPR1.
TOPMC2 Topology member size control table for manufacturing constraints.
Output by DOPR1.
TOPOLE Table of topology pole parameters (used only for topology
manufacturing constraints). Output by DOPR1.
TOPTAB Table of topology designed properties with design variable
identification numbers. Output by DOPR1.
TOPTAB0 Table of topology designed properties. Output by IFP10.
TOUT DRMH1 directory table in table data block or DTI format.
TPRELE Table of topology pole vs. element ids (used only for topology
manufacturing constraints). Output by DOPR1.
TQG Directory table for MQG. Output by DRMH1 and DRMS1.
TR Matrix to transform forces from the support point to the
aerodynamic reference point. Output by MAKETR.
TRANTR Transpose of TR where the number of columns of TR matches the
URDDUXV states of TRX. Both are reduced to just the active origin
rigid body degrees-of-freedom. Output by MAKETR.
TRL Transient response list. Output by DPD.
TRX Boolean matrix to select accelerations from the list of aerodynamic
extra points. Output by ADG.
TSNRGY Table of modal strain energy. Output by MODENRGY.
TUG Directory table for MUG. Output by DRMH1 and DRMS1.
TXY DRMH1 directory table in DTI or table data block format. Output by
DRMH1.
Main Index
1618 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
U Upper triangular factor. Output by DECOMP and DCMP.
UA Displacement or eigenvector matrix in the a-set or solution matrix on
the boundary (a-set) of the superelement (identification number
equal to output value of SEID).
UACCE Reduced acceleration solution matrix from transient response
analysis. Output by DSAR.
UAJJT Upper triangular decomposition factor matrix of AJJT.
UAM1DD Upper triangular factor of the dynamic tangential matrix in the d-set.
UBULK Table of all unsorted Bulk Data entries. Output by XSORT.
UD Solution matrix for the d-set. Displacements only in frequency
response. Displacements, velocities, and accelerations in transient
response.
UD1 Improved solution matrix for the d-set. Output by DDR2.
UDISP Reduced displacement solution matrix from transient response
analysis. Output by DSAR.
UE Improved solution matrix for the e-set (extra points). Output by
DDR2.
UG Displacement matrix in g-set. For the DSVG1 module and transient
analysis, UG can also represent velocity or acceleration. Output by
SDR1 and STATICS. Velocity matrix in g-set.
UGD Displacement matrix in g-set for the downstream superelement.
UGDS Displacement matrix in g-set due to pseudo-loads.
UGDS1 Displacement matrix in g-set for the total variation. Output by
DSVG3.
UGG Displacement matrix in g-set for all processors (global). Output by
DISUTIL.
UGNI Displacement matrix at converged step in the g-set. Output by
NLITER.
UGNT Total displacement matrix in the g-set. Output by UGVADD.
UGT Updated temperature matrix in g-set. Output by MATMOD option
19. Transposed regular solution matrix specified on first pass
through DSADJ. Output by DSADJ.
UGT0 UGT computed in a prior call to DSADJ and specified on second
pass through DSADJ.
UGX Matrix of analysis model displacements in g-set or p-set.
Main Index
Glossary 1619
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
UGX1 Copy of UGX matrix with null columns in place of the deleted
responses. Output by DSAD.
UH Solution matrix for the h-set (modal degrees-of-freedom). Modal
displacements only in frequency response. Modal displacements,
velocities, and accelerations in transient response.
UHF Modal displacement matrix in p-set for frequency response.
UHFF Fluid partition (row-wise) of solution matrix UHF. Also partitioned
column-wise according to parameter FLUIDMP.
UHFM Merged UHF. Output by DSAD.
UHFS Structural partition (row-wise) of solution matrix UHF. Also
partitioned column-wise according to parameter STRUCTMP.
UHR Modal displacement vector for spectral analysis. Output by
INTERR.
UI Solution matrix where the columns correspond to eigenvalues,
frequencies, or time steps in OL. The rows of the matrix may
correspond to any degree-of-freedom set size.
UI1 UI truncated by the OFREQ or OTIME. Case Control command.
Output by MODACC.
UL Displacement matrix in l-set. Output by SSG3.
ULAMA Unsymmetric eigenvalue summary table. Output by UEIGL.
ULL Upper triangular factor for the l-set from KLL.
ULLT Upper triangular factor for nonlinear elements including material,
slideline, and differential stiffness effects.
ULNT Solution matrix from nonlinear transient response analysis in the d-
set. Output by NLTRD and NLTRD2.
UNITDISP Unit displacement matrix where each row represents a unit
displacement at a degree-of-freedom. Only degrees-of-freedom
which participate in the union of all monitor points will contain a
unit displacement. UNITDISP has LUSET number of columns.
Output by ILMP1.
UNITPV Partitioning vector (g-set) with 1.0 at each grid where a unit
displacement is requested. (All 6 degrees-of- freedom will be
assumed to contribute). Output by ILMP1.
UNITS Table of units. Usually input by the user via DTI Bulk Data entries.
UO Displacement matrix in o-set. Output by SSG3.
UOO Displacement matrix in o-set due to applied loads on the o-set with
the a-set fixed (set to zero).
Main Index
1620 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
UPF Displacement matrix in p-set for frequency response.
UPFM Merged UPF. Output by DSAD.
UPNL0 Initial solution matrix from nonlinear analysis at each STEPcase.
Output by NLSOLV.
UPNT Solution matrix from nonlinear analysis appended from each output
time step (for transient analysis only). Output by NLSOLV.
UPSDT Table of transfer function data needed for RMS calculations.
UPSDTR UPSDT for retained frequencies. Output by DSAD.
URDDIDX An instance of an ADBINDX that describes the acceleration entries.
Output by MAKETR.
URDDUXV UX vector states for the active URDDi. These are rows of TRX that
are non-null. Null rows occur either because the USER didn't define
AESTAT, URDDi, OR because the associated URDDi is invalid for
this symmetry condition (e.g., URDD1,3,5 are invalid for
antisymmetric analysis). Output by MAKETR.
USET USET Degree-of-freedom set membership table for g-set. Output by GPSP.
USET0 USET Degree-of-freedom set membership table for g-set usually prior to
Auto-SPC update in GPSP. Output by GP4. USET table from a
previous adaptivity index in
p-version analysis.
USET1 USET USET updated with constraints from upstream superelements.
Output by BNDSPC.
USETD USET Degree-of-freedom set membership table for p-set. Output by DPD.
USETM USET Modified degree-of-freedom set membership table for g-set. Output
by MODUSET.
USETN USET with updated set membership. Output by NEWUSET.
UTF Upper triangular file of the solution matrix ULNT. Output by
NLTRD2 and NLSOLV.
UVELO Reduced velocity solution matrix from transient response analysis.
Output by DSAR.
UX Matrix of aerodynamic extra point displacements. Output by ASG.
UXDAT Table of aerodynamic extra point identification numbers,
displacements, labels, type, status, position and hinge moments.
Output by ASG.
UXDIFV Derivative interpolation factors matrix at UX = UXREF. Output by
ASG and SDP.
Main Index
Glossary 1621
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1622 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
V01P Partitioning vector for sparse load reduction.
VA Velocity matrix on the boundary (a-set) of the superelement
(identification number equal to output value of SEID). Output by
SEDR.
VDA Partitioning vector--d-set size--with 1.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.
VGF Fluid/structure partitioning vector with ones at the rows
corresponding to fluid degrees-of-freedom. Output by GP1.
VGFD Partitioning vector with ones at rows corresponding to degrees-of-
freedom connected to frequency-dependent elements. Output by
TA1.
VGA G-set size partitioning vector with values of 1.0 at the rows
corresponding to the a-set.
VGQ Partitioning vector with values of 1.0 at rows corresponding to
degrees-of-freedom in the q-set.
VIEWTB VIEWTB View information table, contains the relationship between each p-
element and its view-elements and view-grids. Output by VIEWP.
Main Index
Glossary 1623
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1624 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
WETFACES Table of wetted structure element and face identification numbers
found for each individual open fluid face.
WGTM Table of 6x6 rigid body mass matrix. Output by WEIGHT.
WJ Gust matrix. Output by GUST.
WMID Table of weight as a function of material identification number.
Output by WEIGHT.
WRJVBRL Downwash matrix (NJ rows by NV columns). Downwash at the j-
points due to the linear, angle/rate rigid body aerodynamic extra-
points and linear control surfaces. Output by ADG.
WSKJF Weighted integration matrix.
WTCRID Table of retained weight responses with column and row numbers in
rigid mass matrix. Output by DSAW.
WTDSCP Partitioning vector for weight. Output by DSAW.
Main Index
Glossary 1625
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
X Solution of the equation [A][X]=[B]. Output by FBS, SOLVE, and
SOLVIT. Matrix product. Output by MPYAD and SMPYAD. Matrix
transpose. Output by TRNSP.
X66 Triple-product of XG with rigid body modes for IOPT=9 or 10.
Output by VECPLOT.
X66P Previous output of X66, usually at g-set. Used by IOPT=9, when
setnam<>'g', as a baseline to compare against the non-g-set results in
X66.
XAA Reduced square matrix in a-set. Output by MATREDU.
XAA* Family of reduced square matrices in a-set pertaining to the upstream
superelements.
XD Rectangular matrix of displacements or loads in the p-set. Output by
UREDUC.
XDD Reduced square matrix in d-set. Output by MATREDU.
XDICT KDICT Baseline element matrix dictionary table.
XDICTB Backward perturbed element matrix dictionary if CDIF='YES'.
XDICTDS KDICT Perturbed element matrix dictionary table. If CDIF='YES' then this
is the forward or backward perturbed element matrix dictionary.
XDICTX KDICT Baseline element matrix dictionary table or backward perturbed
element matrix dictionary if CDIF='YES'.
XELM KELM Baseline element matrices. Output by EMG.
XELMB Backward perturbed element matrices if CDIF='YES'
XELMDS KELM Table of perturbed element matrices. If CDIF='YES' then this is the
forward or backward perturbed element matrix dictionary.
XELMX KELM Baseline element matrices or backward perturbed element matrices
if CDIF='YES'.
XG Rectangular matrix of displacements or loads in the
g-set.
XGG Square matrix in g-set. In superelement analysis, XGG includes
contributions from upstream superelements. Output by EMA and
SEMA.
XGGi Square matrices in g-set. Output by EMA and SEMA.
XH Rectangular matrix of displacements or loads in the h-set (modal).
Output by UREDUC.
XINIT Matrix of initial values of the design variables. Output by DOPR1.
Main Index
1626 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
XJJ Square matrix for the g-set of the current superelement and applied
to its interior points only.
XNENEi Square matrix in ne-set. Output by MCE2.
XNNi Square matrices in n-set. Output by MCE2.
XO Matrix of final (optimized) values of the design variables.
XORTH Cross-orthogonality matrix. Output by CEAD and UEIGL.
XOUT Resultant to table output. Output by VECPLOT.
XP Rectangular matrix of displacements or loads in the p-set
XPP Square matrix in p-set.
XPPi Square matrix in p-set.
XS Optional starting vector, same type as B and PG in SOLVIT and
STATICS, respectively. Rectangular matrix of displacements or
loads in the s-set. Output by UREDUC.
XSF S-set by f-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction. Output by MATREDU.
XSS S-set by s-set matrix partition of XGG or XPP after multipoint
constraint elimination and reduction. Output by MATREDU.
XYCDB Table of x-y plotting commands. Output by IFP1.
XYCDBDR Table of x-y plotting commands for a superelement (identification
number equal to output value of SEID). Output by SEDR.
XYCDBS Table of x-y plotting commands for the current superelement
(identification number equal to output value of SEID). Output by
SEP2CT.
XYPLOT Table of x-y plot control values. Output by XYTRAN.
XZ Matrix containing the constant portion of the dependent to
independent design variable linking relationship. Output by DOPR1.
Chapter 3 Chapter 2
Name Name Description
YACCE Matrix of enforced accelerations.
YGBNDR Boundary shape matrices appended for all auxiliary or geometric
models.
YPF Frequency response enforced motion matrix in the p-set. Output by
FRLG.
Main Index
Glossary 1627
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
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
1628 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
Chapter 3 Chapter 2
Name Name Description
ZETAH Mass-normalized damping.
Z1ZX Matrix of unrestrained dimensional elastic derivatives
ZZX Reduced aerostatic solution matrix.
K_____ Stiffness
KD____ Differential stiffness
B_____ Viscous damping
K4____ Structural damping (See GE field on MATi entries)
__2DD Stiffness in dynamic formulation
M____ Mass
___JJ Stiffness, damping, and mass matrices without upstream superelement
contributions. Exception: __AJJ_ is the aerodynamic influence matrix.
L__, U__ Lower and upper triangular decomposition factors
Note: Some of the above names may be prefixed with a "C" to indicate a complex matrix.
Superelements:
Main Index
Glossary 1629
Data Block Glossary
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
1630 MSC Nastran DMAP Programmer’s Guide
Data Block Glossary
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.
Main Index
Glossary 1631
Data Block Glossary
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
1632 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Parameter Glossary
The parameter Glossary lists the names and a brief description of all parameters shown in the module
descriptions in Detailed Descriptions of DMAP Modules and Statements, 589. Naming conventions
appear at the end of the glossary.
1 holds the full g-size solution vector and is recommended if disk space is
limited
Main Index
Glossary 1633
Parameter Glossary
Main Index
1634 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1635
Parameter Glossary
Main Index
1636 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
f i + 1 CLOSE f i
Main Index
Glossary 1637
Parameter Glossary
Main Index
1638 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1639
Parameter Glossary
Main Index
1640 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
where f max and f min are the maximum and minimum frequencies across all
FREQi Bulk Data entries.
DFRQCC Logical. Direct frequency response analysis subcase flag. Set to TRUE if at least one
ANALYSIS=DFREQ command was found in CASECC and CASEFREQ is
specified in the output list. Output by MDCASE.
DIGITS Integer. Number of digits for the fractional part of values written by the OUTPUT4
module.
DISCYC Logical. Discrete design cycle flag. TRUE if this is a discrete design cycle.
DISMETH Integer. Method of processing in DISUTIL module.
DISVAR Logical. Discrete optimization variable flag. Set to TRUE if discrete optimization
design variables are specified. Output by DOPR1.
DLOAD1 Integer. Dynamic load set identification number in the first frequency subcase.
Output by DSAD.
DMIGFN Character. Qualifier name for F2J matrices.
DMPYIN Logical. For DODMP>0, broadcast flag to input matrices from master processor to
slave processor(s).
DMPYOUT Logical. For DODMP>0, broadcast flag to X matrix from slave processor(s) to
master processor.
Main Index
Glossary 1641
Parameter Glossary
Main Index
1642 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1643
Parameter Glossary
Main Index
1644 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1645
Parameter Glossary
Main Index
1646 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1647
Parameter Glossary
Main Index
1648 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1649
Parameter Glossary
Main Index
1650 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1651
Parameter Glossary
Main Index
1652 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1653
Parameter Glossary
Main Index
1654 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1655
Parameter Glossary
Main Index
1656 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1657
Parameter Glossary
Main Index
1658 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1659
Parameter Glossary
Main Index
1660 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1661
Parameter Glossary
Main Index
1662 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1663
Parameter Glossary
Main Index
1664 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1665
Parameter Glossary
Main Index
1666 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1667
Parameter Glossary
Main Index
1668 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1669
Parameter Glossary
Main Index
1670 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1671
Parameter Glossary
Main Index
1672 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1673
Parameter Glossary
Main Index
1674 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1675
Parameter Glossary
Main Index
1676 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1677
Parameter Glossary
Main Index
1678 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1679
Parameter Glossary
Main Index
1680 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
Main Index
Glossary 1681
Parameter Glossary
Main Index
1682 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
-1Negative
-1Negative
-1Negative
-1Negative
-1Negative
SING Integer. Singularity flag. If singularities are found, then SING will be set to -1;
otherwise +1. Output by DCMP and DECOMP.
SKPMTX Integer. If SKPMTX<>0, then KELM1 and KDICT1 will be generated.
SMEMCC Logical. Electromagnetic analysis subcase flag. Set to TRUE if at least one
ANALYSIS=ELECT command was found in CASECC and CASESAER is specified
in the output list. Output by MDCASE.
SMPFEPS Real. Threshold for filtering out small structure factor magnitudes.
SMSTCC Logical. Structural analysis subcase flag. Set to TRUE if at least one
ANALYSIS=STRUCT command was found in CASECC and CASESMST is
specified in the output list. Output by MDCASE.
SNORM Real. Maximum angle between grid point normal and shell normal. If angle is less
than SNORM then grid point normal will be computed.
SNORMPRT Integer. Grid point shell normal print/punch flag.
0No print or punch
1Punch
2Print only
SOFFSET Real. Stiffness ratio for equivalent CBEAM generated for the offsets.
Main Index
Glossary 1683
Parameter Glossary
SOLADJC Integer. Flag to select solving adjoint load vectors along with applied load vectors
> 0Yes (generate adjoint load vectors in DOPR3)
SPC Integer. SPC Case Control command set identification number specified in the third
word of the NSKIP-th record of CASECC.
SPCGEN Integer. SPC Bulk Data entry punch flag. If set to >0, then singularities identified by
this module are written to the PUNCH file as SPC Bulk Data entries.
SPDM Integer. Sparse design model flag. Output by OUTPRT. If -1, then VGDM must be
supplied.
-1Yes
0No
SPSELREC Output. Last record number processed in SPSEL. Set to -1 when processing last
record. Output by RSPEC.
Main Index
1684 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
SRCOMPS Character. Flag to request output of table of ply strength ratios (OESRT). Usually
input by user parameter.
SRTELTYP Integer. Element type to be filtered and sorted. By default, all element types will be
filtered and sorted.
SRTOPT Integer. Filter/sort option based on NUMOUT and BIGER.
0Maximum magnitude
1Minimum magnitude
2Maximum algebraic
3Minimum algebraic
SRTTYP Integer. Item code 1 sort flag. Set to 1 to perform an integer sort on item code 1 which
is usually an integer quantity.
START Integer. Number of the grid points at the beginning of the input sequence in the SEQP
module.
STARTCOL Integer. Starting column number to extract from I1.
STATCC Logical. Static analysis subcase flag. Set to TRUE if at least one
ANALYSIS=STATICS command was found in CASECC and CASESTAT is
specified in the output list. Output by MDCASE.
STATIC Integer. Static analysis flag. Set to zero for static analysis and one for dynamic
analysis.
STATOPT Character. Static solution method.
'DRCT' Direct
'ITER' Iterative.
STATSUB Integer. STATSUB Case Control command set identification number specified in the
256-th word of the NSKIP-th record of CASECC.
STEPCUR Integer. Identification number of the STEP case at the restart point. Output by
NLRSLOOP.
STEPCURL Integer. Identification number of the previous STEP case from the restart point.
Output by NLRSLOOP.
STEPRR Logical. STEP Case Control command flag. Set to TRUE if the STEP command is
allowed in the current solution sequence.
STFLG Integer. Flag to indicate whether the current subcase has active static response (DISP,
STRAIN,STRESS, FORCE, CSTRAIN, CSTRESS, or CFORCE on the DRESP1
Bulk Data entry). 0 indicates no response, 1 indicates an active response. Output by
DSARLP.
Main Index
Glossary 1685
Parameter Glossary
STIME Real. On initial input, starting time step and on output, accumulated time used for
restarts. Output by NLTRD, NLSOLV, and NLTRD2.
STIMER Real. Load factor (or time) at the restart point. Output by NLRSLOOP.
STIMES Real. Start time of the current STEP case. Output by NLRSLOOP.
STOL Real. State matching tolerance.
STPSCL Real. Shape step size scaling factor.
STRUCTMP Integer. Number of structure modes to use computing factors.
SUBCUR Integer. Identification number of the SUBCASE at the restart point. Output by
NLRSLOOP.
SUPAERO Character. Method for supersonic aero; 'ZONA' or 'CPM'.
SUPER Integer. Selects coupled or uncoupled sequencing or special handling of multipoint
constraints in the SEQP module.
SUPORT Integer. SUPORT Case Control command set identification number specified in the
255-th word of the NSKIP-th record of CASECC.
SWCHECK Logical. Spot weld check exit flag indicating that bit 256 is on in CHKRUN. Output
by SEP1X.
SWEXIST Logical. Spot weld element existence flag. Set to TRUE if spot weld elements exist.
Output by MODGM2.
SYM Integer. Symmetric partition or merge flag.
0Symmetric; i.e., CP is used for RP
TABID Integer. TABLED1 punch flag. If IDTAB is greater than zero, all requests for
XYPUNCH will produce TABLED1 Bulk Data entries for the curve. The table
identification number will start at TABID and increase by one for each table punched.
Output by XYTRAN.
Main Index
1686 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
TABS Real. Absolute temperature conversion. For example, set to 273.16 when specifying
temperatures in Celsius or 459.69 in Fahrenheit.
TADJCOL Integer. Accumulated column count for adjoint load vector, for supporting adjoint
load method for multiple superelements. Output by DOPR3 and DSAD.
TCOLADJ Integer. Total number of columns of DRDUG for all superelements.
TEMPSID Integer. Temperature set identification number. Usually obtained from the
TEMPERATURE Case Control command. Required for use in stress recovery of
differential stiffness.
TESTNEG Integer. Load increment method flag in nonlinear static analysis. Output by CASE.
TFLG Integer. Flag to indicate whether the current subcase has active trim responses (TRIM
on the DRESP1 Bulk Data entry). 0 indicates no response, 1 indicates an active
response. Output by DSARLP.
TFLID Integer. Transfer function set identification number. TFLID is ignored if IOPT=3, 4,
5, 13, 14, or 15.
THRESH Integer. Exponent of 10 which defines the pivoting threshold for unsymmetric
decomposition.
Ti Integer. Transpose flag for first four matrices input to SMPYAD.
1Transpose
0Nonlinear statics
Main Index
Glossary 1687
Parameter Glossary
TRL5Ti Integer. Specifies value for the fifth word in TOFPi's trailer.
TSTART Integer. CPU clock time at entry to FA1. Output by FA1 and FA2. On output from
FA2, set to -1 if there is insufficient time for another DMAP loop.
TSTATIC Integer. Static analysis flag. Set to 1 to ignore inertia and damping forces.
TVALUE Integer. Trailer value. Output by PARAML and SCALAR.
TVOLFL Integer. Total volume flag. Output by SDSA.
TWGTFL Integer. Total weight flag. Output by SDSA.
TWODIV Output. Nonlinear analysis divergence flag.
0No previous divergence on this load step.
Main Index
1688 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
USETADD Integer. USET length extension. Extend the size of the USET by this amount.
USETOP Character. Name of desired operation.
VALUED Complex double precision. Contents of element at IROW-th row and ICOL-th column
in matrix [A]. Output by SCALAR.
VERS Integer. Version number. Output by PROJVER.
VOLS Real. Total volume of analysis model. Output by WEIGHT.
VREF Real. Flutter velocity divisor to obtain flutter indices.
VUBEAM Character. Name for VUBEAM element.
VUELJUMP Integer. Delta between view-element identification numbers.
VUENEXT Integer. Starting identification number for next view-element. Output by DVIEWP
and VIEWP.
VUEXIST Logical. View-element flag. Set to TRUE if view-elements exist. Output by DVIEWP
and VIEWP.
VUGJUMP Integer. Delta between view-grid identification numbers.
VUGNEXT Integer. Starting identification number for next view-grid. Output by DVIEWP and
VIEWP.
VUHEXA Character. Name for VUHEXA element.
VUPENTA Character. Name for VUPENTA element.
VUQUAD4 Character. Name for VUQUAD4 element.
VUTETRA Character. Name for VUTETRA element.
VUTRIA3 Character. Name for VUTRIA3 element.
W3 Real. Scale factor denominator for including stiffness in viscous damping for transient
analysis. Usually input by user parameter.
W4 Real. Scale factor denominator for including non-uniform structural damping in
viscous damping for transient analysis. Usually input by user parameter.
WGTS Real. Total weight of analysis model. Output by WEIGHT.
WGTVOL Integer. Weight/volume retained response flag. Set to >0 if any retained response.
Output by DSPRM.
WRDNUM Integer. Word number of table element. Output by PARAML.
WTMASS Real. Scale factor on structural mass matrix.
Main Index
Glossary 1689
Parameter Glossary
WVFLG Integer. Weight/volume response flag. If CASECC does not contain any subcases for
statics, normal modes, or buckling subcase then set to 1 if there is a weight or volume
response specified on the DRESP1 Bulk Data entry image in EDOM. Output by
MDCASE.
XFLAG Integer. Strain energy method selection.
0Elemental force
1Cross displacement
XNORM Real. Maximum absolute normalizing value over all columns. Output by NORM.
XNORMD Real-double precision. Same as XNORM except in double precision.
XTYPE Integer. Type of element matrix data:
0Stiffness
1Damping
2Mass
Main Index
1690 MSC Nastran DMAP Programmer’s Guide
Parameter Glossary
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
MSC.Fatigue Quick Start Guide
Index
MSC Nastran DMAP Programmer’s Guide
A Executive modules
Arithmetic operators, 9 description summary, 587
list of, 581
Expressions and operators
C arithmetic operators, 9
Character operator (&), 9
character operator (&), 9
logical operators, 10
D relational operators, 9
Data block
automatic deletion of, 38
basic definition of, 2
F
File management statements, 2
local, definition of, 14
Functions, intrinsic, 19
permanent, definition of, 14
rules for, 38
scratch, definition of, 14 L
states of, 14 Logical operators, 10
DATABLK NDDL statement, 563, 564
DBset, 13 M
DEPEN NDDL statement, 573 MATPRN DMAP module, 1089
DMAP Matrix modules
general rules, 3 description summary, 585
last time used (LTU) instruction, 38 list of, 580
output from previous module" rule, 37 Matrix trailer, 12
DMAP control statements
conditional branching, 30
DO WHILE DMAP statement, 33
N
NDDL (Nastran Data Definition Language)
looping, 32
basic definition of, 2
DMAP modules
DATABLK NDDL statement, 564
basic definition, 2
DEPEN NDDL statement, 573
description summary, by category, 580
PARAM NDDL statement, 575
detailed descriptions of,, see also specific
PATH NDDL statement, 577
module name
purpose of, 562
list of, by category, 580
QUAL NDDL statement, 578
obsolete, 588
summary of statements, 562
DO WHILE DMAP statement, 33
syntax of descriptions, 563
E O
Errors, see also user errors
Obsolete modules, list of, 588
OFP DMAP module, 1219
Main Index
ii MSC Nastran DMAP Programmer’s Guide
P
PARAM NDDL statement, 575
Parameters
basic definition of, 2
PATH NDDL statement, 577
Preface modules, 39
PRTPARM DMAP module, 1271
Q
QUAL NDDL statement, 578
R
Relational operators, 9
S
SCRATCH data block
automatic deletion of, 38
special rules for, 38
SOLution 100, 39
Solution sequences, definition of, 2
SubDMAP
DBFETCH, 41
DBMGR, 41
DBSTORE, 41
U
Upward compatibility in Version 68,, see also
V68 DMAP changes
User errors, processing of, 40
User fatal message 1126,, see also DMAP
output from previous module" rule
Utility modules
description summary, 586
list of, 581
Main Index