MSC Nastran DMAP Programmers GuideMSC Nastran 2012DMAP Programmers GuideMain IndexWorldwide Webwww.mscsoftware.comDisclaimerMSC.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, 2010Revision 0. November 15, 2011NA*V2012*Z*DMAP*Z*DC-PROGCorporate Europe Asia PacificMSC.Software Corporation2 MacArthur PlaceSanta Ana, CA 92707Telephone: (800) 345-2078FAX: (714) 784-4056MSC.Software GmbHAm Moosfeld 1381829 MunichGERMANYTelephone: (49) (89) 43 19 87 0Fax: (49) (89) 43 61 71 6Asia PacificMSC.Software Japan Ltd.Shinjuku First West 8F23-7 Nishi Shinjuku1-Chome, Shinjuku-Ku Tokyo 160-0023, JAPANTelephone: 0120-924-832 (toll free, Japan only)Mobile phone: 03-6911-1222Fax: (81) (3)-6911-1201Main IndexC O N T E N T S Table of ContentsPreface About This Book, viii List of MSC Nastran Books, ix Technical Support, x1Direct Matrix Abstraction Introduction, 2 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, 432Data Blocks Introduction, 46 Matrix Data Blocks, 47MSC Nastran DMAP Programmers GuideTable of ContentsMain 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- BGPDT68, 68- CASECC, 69- CLAMA, 88- CONTAB, 90- CSTM, 91- CSTM68, 93- DBCOPT, 99- DESTAB, 101- DIT, 102- DSCMCOL, 107- DVPTAB, 116- DYNAMIC, 117- EGPSF, 133- EGPSTR, 137- ELDCT, 140- EPT, 142- EPT01, 179- EQEXIN, 181- ERROR, 183- FOL, 184- GEOM1, 185- GEOM168, 198- GEOM2, 201- GEOM201, 246- GEOM3, 255- GEOM301, 270- GEOM4, 271- GEOM4705, 299- GPDT68, 300- GPL, 302- HIS, 303- KDICT, 304- LAMA, 306- MPT, 308- OBJTAB, 324- OEE, 325- OEF, 329- OES, 381- OGF, 505- OGS, 510- OPG, 516- OPTPRM, 521- OQG, 523- OUG, 528- R1MAP, 538- R1TAB, 539- RESP12, 546- SEMAP, 550- SET, 554- TOL, 555- VIEWTB, 5563Nastran Data Definition Language (NDDL) NDDL Summary, 562 Detailed Description of NDDL Statements, 563- DATABLK, 564- DEPEN, 573- PARAM, 575- PATH, 577- QUAL, 5784DMAP Modules and Statements DMAP Module and Statement List, 580 Matrix Modules, 580Main 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- ADAMSMNF, 592- ADAMSRBM, 595- ADAPT, 596- ADD, 599- ADD5, 601- ADG, 603- ADJMOD, 605- ADR, 606- AELOOP, 608- AEMODEL, 611- AFPMP, 612- AIEMGA, 614- AMG, 616- AMP, 618- APD, 620- APPEND, 622- ASDR, 625- ASG, 627- AXMDRV, 629- AXMPR1, 630- AXMPR2, 631- BCDR, 632- BDRYINFO, 634- BGCASO, 636- BGP, 637- BMG, 639- BNDSPC, 641- CAMPREP, 643- CASE, 645- CEAD, 650- CMPZPR, 655- CMSENGY, 656- COPY, 659- CURV, 660- CURVPLOT, 662- CYCLIC1, 664- CYCLIC2, 666- CYCLIC3, 668- CYCLIC4, 670- DBC, 674- DBDELETE, 682- DBDICT, 684- DBEQUIV, 698- SubDMAP DBFETCH, 701- SubDMAP DBMGR, 703- DBSTATUS, 707- SubDMAP DBSTORE, 708- DBVIEW, 710- DCMP, 713- DDR2, 717- DDRMM, 720- DECOMP, 723- DELETE, 728- DIAGONAL, 729- DISDCMP, 731- DISFBS, 733- DISOFPM, 734- DISOFPS, 735- DISOPT, 736- DISPARM, 739- DISUTIL, 740- DIVERG, 744- DLT2SLT, 746- DMPCASE, 747- DMIIN, 748- DOM10, 749- DOM11, 752- DOM12, 754- DOM6, 760- DOM9, 762- DOPFS, 765- DOPR1, 767- DOPR2, 771- DOPR3, 773- DOPR3X, 777- DOPR4, 778- DOPR5, 779- DOPR6, 781- DOPRAN, 783- DPD, 784- DRMH1, 787Main Index- DRMH3, 789- DRMS1, 791- DSABO, 793- DSAD, 795- DSADJ, 802- DSADX, 805- DSAE, 807- DSAF, 809- DSAH, 811- DSAJ, 815- DSAL, 817- DSAM, 821- DSAN, 822- DSAP, 823- DSAPRT, 825- DSAR, 826- DSARLP, 828- DSARME, 830- DSARSN, 831- DSAW, 833- DSDVRG, 834- DSFLTE, 835- DSFLTF, 837- DSGRDM, 838- DSMA, 839- DSPRM, 841- DSTA, 844- DSTAP2, 846- DSVG1, 847- DSVG1P, 850- DSVG2, 852- DSVG3, 854- DSVGP4, 855- DSVGP5, 857- DTIIN, 859- DUMMOD1, 860- DUMMOD2, 861- DUMMOD3, 862- DUMMOD4, 863- DVIEWP, 864- DYNCXPNT, 866- EFFMASS, 867- ELFDR, 869- ELTPRT, 870- EMA, 873- EMAKFR, 875- EMG, 876- EQUIVX, 881- ESTINDX, 883- EXPORTLD, 884- FA1, 885- FA2, 887- FBODYLD, 889- FBS, 890- FILE, 893- FORTIO, 895- FRLG, 897- FRLGEN, 899- FRQDRV, 901- FRRD1, 902- FRRD2, 905- GENTRAN, 908- GETCOL, 910- GETMKL, 911- GI, 912- GIC2C, 914- GKAM, 915- GNFM, 919- GP0, 921- GP1, 923- GP2, 925- GP3, 927- GP4, 929- GP5, 933- GPFDR, 935- GPJAC, 939- GPSP, 940- GPSTR1, 944- GPSTR2, 945- GPSTRPBX, 947- GPWG, 948- GUST, 953- GUSTLDW, 955- GYROLD, 956- IFP, 957- IFP1, 960- IFP3, 962- IFP4, 964- IFP5, 966- IFP6, 968- IFP7, 970- IFP8, 971- IFP9, 972- IFP10, 974- IFPINDX, 975- IFPBSH2, 976- IFT, 977- ILMP1, 982- ILMP2, 983- ILMPGPF, 984- INDXBULK, 985- INPUTT2, 986- INPUTT4, 989- INTERR, 991Main Index- ISHELL, 993- LAMX, 995- LANCZOS, 1000- LCGEN, 1003- LMATPRT, 1005- MACOFP, 1006- MAKAEFA, 1007- MAKAEFS, 1009- MAKAEMON, 1010- MAKCOMP, 1011- MAKENEW, 1012- MAKEOLD, 1014- MAKETR, 1016- MAKMON, 1018- MASSCOMB, 1019- MATGEN, 1020- MATGPR, 1033- MATMOD, 1038- MATOFP, 1084- MATPCH, 1088- MATPRN, 1090- MATPRT, 1091- MATREDU, 1092- MCE1, 1095- MCE2, 1096- MCFRAC, 1098- MDATA, 1100- MDCASE, 1102- MDENZO, 1106- MDISUTIL, 1111- MERGE, 1112- MERGEOFP, 1117- MESSAGE, 1118- MGEN, 1120- MKCNTRL, 1122- MKCSTMA, 1123- MKMNTIFP, 1124- MKRBVEC, 1125- MKSPLINE, 1127- MODACC, 1129- MODCASE, 1131- MODENRGY, 1132- MODEPF, 1134- MODEPOUT, 1137- MODEPT, 1140- MODGDN, 1141- MODGM2, 1142- MODGM4, 1146- MODQSET, 1148- MODTRK, 1150- MODTRL, 1152- MODUG, 1154- MODUSET, 1155- MONVEC, 1158- MONVEC3, 1159- MPP, 1160- MPPTRAN, 1162- MPYAD, 1164- MRGCOMP, 1170- MRGCSTM, 1171- MRGMON, 1172- MSGHAN, 1173- MSGSTRES, 1174- MTRXIN, 1175- NASSETS, 1181- NDINTERP, 1182- NEWUSET, 1183- NLCOMB, 1184- NLHARM, 1186- NLICLOOP, 1188- NLITER, 1189- NLRSLOOP, 1195- NLRSMAP, 1197- NLSOLV, 1198- NLTRD, 1205- NLTRD2, 1209- NLTRLG, 1214- NORM, 1216- NSMEPT, 1218- OFP, 1219- OPTGP0, 1222- ORTHOG, 1224- OUTADF, 1226- OUTPRT, 1227- OUTPUT2, 1230- OUTPUT4, 1241- PARAML, 1247- PARTN, 1267- PCOMB, 1272- PCOPY, 1274- PFCALC, 1275- PFOFP, 1279- PLOT, 1280- PLTHBDY, 1282- PLTSET, 1283- PNCHGRP, 1285- PNMKGRP, 1286- PRESOL, 1288- PROJVER, 1291- PRTMSG, 1292- PRTPARM, 1293- PURGEX, 1295- PVT, 1296- RANDOM, 1298Main Index- RBMG3, 1306- RBMG4, 1308- READ, 1309- RESMOD, 1317- RESTART, 1322- RMDUPBLK, 1325- RMG2, 1326- ROTOR, 1328- ROTRDR1, 1330- ROTRDR2, 1332- ROTRUTL, 1334- RSPEC, 1343- SCALAR, 1345- SDP, 1347- SDR1, 1349- SDR2, 1353- SDR3, 1358- SDRCOMP, 1359- SDRHT, 1361- SDRNL, 1363- SDRP, 1365- SDRX, 1368- SDRXD, 1370- SDSA, 1372- SDSB, 1374- SDSC, 1376- SECONVRT, 1377- SEDR, 1378- SEDRDR, 1380- SEEFMBND, 1383- SEEFMCLF, 1384- SEEFMDMP, 1386- SEEFMLST, 1387- SEEFMNOR, 1388- SEEFMOUT, 1389- SEEFMXIT, 1390- SELA, 1391- SEMA, 1393- SEP1, 1395- SEP1X, 1397- SEP2, 1400- SEP2CT, 1402- SEP2DR, 1403- SEP2X, 1407- SEP3, 1409- SEP4, 1411- SEPLOT, 1413- SEPR1, 1415- SEQP, 1416- SHPCAS, 1422- SMA3, 1423- SMPYAD, 1424- SOLVE, 1426- SOLVIT, 1428- SSG1, 1434- SSG2, 1438- SSG3, 1441- SSG4, 1444- ST2DYN, 1446- STATICS, 1447- STDCON, 1449- STRSORT, 1451- TA1, 1453- TA1M, 1456- TABEDIT, 1458- TABPRT, 1463- TABPT, 1472- TAFF, 1473- TAHT, 1474- TASNP1, 1476- TASNP2, 1477- TIMETEST, 1479- TOLAPP, 1485- TRD1, 1487- TRD2, 1498- TRLG, 1500- TRNSP, 1504- TYPE, 1505- UEIGL, 1509- UGVADD, 1512- UMERGE, 1513- UMERGE1, 1516- UPARTN, 1519- UREDUC, 1522- VDR, 1524- VEC, 1526- VECPLOT, 1529- VIEW, 1534- VIEWP, 1535- WEIGHT, 1537- XSORT, 1539- XYPLOT, 1541- XYTRAN, 1542Glossary Data Block Glossary, 1547 Data Block Naming Conventions, 1628 Parameter Glossary, 1632 Parameter Naming Conventions, 1690Main Index PrefaceDMAP Programmers GuidePrefaceAbout This BookList of MSC Nastran BooksTechnical SupportMain IndexDMAP Programmers GuideAbout This BookviiiAbout This BookThe MSC Nastran 2012 DMAP Programmer's Guide is a replacement for and update of the former Version 2005 r3 DMAP Modules and Data Blocks book. Contained in this Guide is the introduction to DMAP, syntax and concepts, data block descriptions, and NDDL statement descriptions. The guide also contains material that is more frequently referenced: the DMAP Module descriptions.Main Indexix PrefaceList of MSC Nastran BooksList of MSC Nastran BooksBelow is a list of some of the MSC Nastran documents. You may find any of these documents from MSC.Software at http://simcompanion.mscsoftware.com.Installation and Release Guides Installation and Operations Guide Release GuideGuidesReference Books Quick Reference Guide DMAP Programmers Guide Reference ManualUsers Guides Getting Started Linear Static Analysis Dynamic Analysis MSC Nastran Demonstration Problems Thermal Analysis Superelements Design Sensitivity and Optimization Implicit Nonlinear (SOL 600) Explicit Nonlinear (SOL 700) Aeroelastic Analysis User Defined Services EFEA Users Guide EFEA Tutorial EBEA Users GuideMain IndexDMAP Programmers GuideTechnical SupportxTechnical SupportFor technical support phone numbers and contact information, please visit: http://www.mscsoftware.com/Contents/Services/Technical-Support/Contact-Technical-Support.aspxSupport Center (www.simcompanion.mscsoftware.com)Support Online. The Support Center provides technical articles, frequently asked questions and documentation from a single location.Main Index Chapter 1: Direct Matrix AbstractionDMAP Programmers Guide1Direct Matrix AbstractionIntroductionThe MSC Nastran DMAP LanguageData BlocksInstructionsOutput from a Previous Module RuleAutomatic Deletion of Scratch Data BlocksPreface Modules and SOLution 100Processing of User ErrorsSubDMAPs DBMGR, DBSTORE, and DBFETCHWHERE and CONVERT ClausesMain IndexDMAP Programmers GuideIntroduction2IntroductionMSC 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 Index3 Chapter 1: Direct Matrix AbstractionThe MSC Nastran DMAP LanguageThe MSC Nastran DMAP LanguageThe basic components, or objects, of the DMAP language are:The basic syntax of the DMAP language is: The DMAP language uses free-field input format and is case insensitive. A physical entry consists of information in columns 1 through 72. Columns 73 through 80 can be used for comments, but these columns do not appear in the printed listing and are not stored on the database. For the specification of modules or statements, a parent entry continues to a subsequent entry if it terminates in a comma [ , ] or a slash [ / ], or if it is missing a right parenthesis [ ) ]. The dollar sign [ $ ] ends any DMAP instruction and causes all subsequent data to be treated as commentary. The recommended convention is to terminate all DMAP instructions with a dollar sign. DMAP symbolic names are used to identify variable parameters, data blocks, DBVIEW view-names, subDMAPs, or LABEL statements. A symbolic name is composed of alphanumeric characters 1 to 8 characters in length. The following characters are allowed: A through Z, and 0 through 9. The first character must be a character from A through Z.Parameters Scalar quantities used to control the flow of DMAP execution and to communicate options and/or values to modules or functions.Data Blocks Tables or matrices represented by a symbolic name.Instructions Statements or modules that process parameters and/or data blocks as input and/or output.Main IndexDMAP Programmers GuideParameters4ParametersParameters 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.The type of a parameter must be declared in at least one of three ways:Constant ParametersA constant represents a fixed value and is a number (integer, real, or complex), logical, or character string.Type Description Example(s)Integer whole number 10 or -4Real decimal number that is a whole number and a decimal point, with an optional decimal fraction.27000. or 2.7E5 or 2.7D5Complex a pair of real numbers representing the real and imaginary parts of a complex quantity(1.1,2.3) or (1.D0,3.5D1)Logical represents either TRUE or FALSE TRUE or FALSECharacter a string of 1 to 80 characters 'GEORGE'Type No. of wordsInteger 1Real single precision 1Real double precision 2Complex single precision 2Complex double precision 4Logical 1Character 1 to 20Constant Inherent in its specification or constructionExplicit On a TYPE statement for variable parametersImplicit In a modules parameter list for variable parametersMain Index5 Chapter 1: Direct Matrix AbstractionParametersInteger ConstantsAn integer constant is a whole number with no decimal point. Its form is snnwhere:s is optional if the sign is positive (+). A minus sign must be used to indicate a negative integer constant. The absolute value of an integer constant cannot be greater than Real ConstantsA 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 ConstantsA 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.s=a sign, plus (+) or minus (-)nn=a string of digits (0 through 9)snn.ddEsee for single precisionsnn.ddDsee for double precision2311 214748367. = s=a sign, plus (+) or minus (-)nn, dd, ee= strings of digits (0 through 9)E or D=that snn.dd is multiplied by ee raised to the power of 10. E indicates single precision, and D indicates double precision.Main IndexDMAP Programmers GuideParameters6Logical ConstantsA logical constant is specified as TRUE or FALSE.Character ConstantsA 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 ParametersA 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 listIf one or more of the above is not satisfied, then User Fatal Message 439 will be issued during DMAP compilation.Value of a Variable ParameterDuring a DMAP execution or when restarting a DMAP from the database, the value of a variable parameter is determined by the first applicable value on the following sequential list:1. Value from the most recently executed assignment DMAP statement or the most recently executed save function (S,N prefix. See DMAP Modules and Statements, 579).2. Value from the PARAM Bulk Data entry, if the parameter NAME has the Y authorization.3. Value saved on the database, if the parameter NAME is listed with an NDDL TYPE DMAP statement and the run is a restart.4. Value from the NAME=v, if present in a non-NDDL parameter TYPE instruction. This value is determined at DMAP compile time from the TYPE instruction (regardless of its location in DMAP) that contains the statement.Main Index7 Chapter 1: Direct Matrix AbstractionParameters5. 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.Predefined Variable ParametersThe program predefines the value of some variable parameters. It is not necessary to type these parameters with a TYPE DMAP statement, nor is it possible to change their type. We do not recommend changing these parameter values. The predefined variable parameters are: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.Recommended Parameter Type SpecificationFollow these recommendations to produce a more readable DMAP sequence where all Y parameters and parameters with non-MPL defaults are specified on TYPE statements.TYPEd and NDDL TYPEd and Not NDDL Not TYPEdLast executed assignment statement or module output with "S,N," prefix or CALL statement output with "S," prefix. The qualifier values for NDDL parameters cannot change.Bulk Data PARAM entry override, if parameter is type Y and has not been previously reassigned in an assignment (=) statement (unless the PVT module has been executed to reset the Bulk Data and Case Control PARAM entries).Value on the data base name=vfrom its first occurrence in a TYPE statementWill cause UFM 439NDDL default value TYPE statement defaultNAME VALUE TYPEALWAYS -1 IntegerNEVER +1 IntegerTRUE TRUE LogicalFALSE FALSE *LogicalNOGO 0 IntegerMain IndexDMAP Programmers GuideParameters8 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:For example, the following sequence is recommended for setting the TYPE of ALPHA:and the following is not recommended:Expressions and OperatorsAn expression represents a single value and consists of one or more constant and/or variable parameters separated by operators. Expressions are classified as arithmetic, relational, logical, or character. Arithmetic expressions produce numerical values; relational and logical expressions produce logical values. An expression can contain intrinsic functions. An expression is specified:/V,Y,param_name//S,Y,param_name//V,N,param_name//C,Y,param_name//C,N,param_name/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 $IF( FLAG ) PARAMR //'COMPLEX'//BETA/GAMMA/S,Y,ALPHA $ . . .ADD A,B/C/V,Y,ALPHA=(1.,1.) $Main Index9 Chapter 1: Direct Matrix AbstractionParameters In the right hand side of an assignment (=) statement As arguments for intrinsic functions As logical expressions in control statements: DO WHILE, IF, IF-THEN, ELSE IF-THEN As logical expressions in the WHERE clause of DBVIEW, DBEQUIV, and DBDELETE statementsArithmetic OperatorsThe allowable arithmetic operations are shown in the table below in the order of execution precedence. Parentheses are used to change the order of precedence. Operations within parentheses are performed first, with the usual order of precedence being maintained within the parentheses.In general, mixed mode expressions are not supported. For example, to compute A=B*C, where A and B are complex, but C is real, it is necessary to convert C to a complex number: A=B*CMPLX (C), where CMPLX is described under Intrinsic Functions in this section.Character OperatorThe only character operation is concatenation. Its form is shown below.Relational OperatorsRelational 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.Operator OperationSample Expressions Interpreted As-,+ Negative or Positiveimmediately precededby exponentiationX-Y X(-Y)** 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+YOperator Operation Sample Expressions& Concatenation ABC & DE = ABCDEMain IndexDMAP Programmers GuideParameters10Logical OperatorsLogical 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 Relation Tested Expression= Equality X=Y,>< Inequality XY, X>Y< Less than or equal X Greater than or equal X>YOperator X Y OutputNOT TRUE n/a FALSEFALSE n/a TRUEX AND Y TRUE TRUE TRUETRUE FALSE FALSEFALSE TRUE FALSEFALSE FALSE FALSEX OR Y TRUE TRUE TRUETRUE FALSE TRUEFALSE TRUE TRUEFALSE FALSE FALSEX XOR Y TRUE TRUE FALSETRUE FALSE TRUEFALSE TRUE TRUEFALSE FALSE FALSEMain Index11 Chapter 1: Direct Matrix AbstractionParametersX EQV Y TRUE TRUE TRUETRUE FALSE FALSEFALSE TRUE FALSEFALSE FALSE TRUEOperator X Y OutputMain IndexDMAP Programmers GuideData Blocks12Data BlocksA 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 blocks records are appear in Data Blocks, 45.Table TrailersIn 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 tables description. Table trailers are printed when DIAG 15 is specified in the Executive Control or DIAGON(15) is specified in the DMAP sequence.Matrix TrailersIn 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 Contents1 Number of columns in matrix2 Number of rows in matrix3 Form of the matrix (square, rectangular, etc.)4 Type of matrix (real, complex, etc.)5 Largest number of nonzero words among all columns6 Density of the matrix multiplied by 100007 Size in blocks8 Maximum string length over all strings9 Number of strings10 Average bandwidth11 Maximum bandwidth12 Number of null columnsMain Index13 Chapter 1: Direct Matrix AbstractionData BlocksForm is defined as one of the following:Type is defined as one of the following:Data Block Type and StatusThe data block type depends on whether the data block is stored on a permanent or scratch DBset and whether its name appears on a TYPE DB statement. A DBset is a physical file that is a subdivision of the database; see Chapter 12 of the MSC Nastran Reference Manual.There are three types of DMAP data blocks:Form Meaning1 Square2 Rectangular3 Diagonal4 Lower triangular factor5 Upper triangular factor6 Symmetric8 Identity9 Pseudoidentity10 Cholesky factor11 Trapezoidal factor13 Sparse lower triangular factor 15 Sparse upper triangular factorType Meaning1 Real, single precision2 Real, double precision3 Complex, single precision4 Complex, double precisionPermanent NDDL Referenced on a TYPE DB statement and assigned to a permanent DBset through the NDDLMain IndexDMAP Programmers GuideData Blocks14At 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.Scratch NDDL Referenced on a TYPE DB statement and assigned to the SCRATCH DBset through the NDDLLocal Not referenced on a TYPE DB statement and automatically assigned to the SCRATCH DBsetGenerated The data block has been created.Not generated The data block has been deleted or is not yet created.Empty The data block has been created but has no data (or purged). In other words, the name of the data block is stored on a permanent DBset without any associated data.Main Index15 Chapter 1: Direct Matrix AbstractionInstructionsInstructionsA 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.ModulesA 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: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:module_name , input_data_block_list /output_data_block_list / parameter_list $ Main IndexDMAP Programmers GuideInstructions16Listing 1-1 Module Properties ListThe MPL listing contains useful information under the following column headers: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 $ 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 116 78 1854 PARAML 1 1 1 0 2 1. BCD 1861 -- NO DEFAULT -- 1- 2 2. INT 1862 1 3 3. INT 1864 1 4Header DescriptionMOD-NAME Module nameIN Number of input data blocksOUT Number of output data blocksID Parameter positionTYP type of parameter: INT - integer RSP - real single precision RDP - real double precision CSP - complex single precision CDP - complex double precision BCD - character LOG - logicalDEFAULT Default value of parameterMain Index17 Chapter 1: Direct Matrix AbstractionInstructionsAccording 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: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:In addition, trailing commas can be left unspecified:Parameters can be specified on a module as: Input only Input and output Output onlyEach 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:ELTPRT ECT,GPECT,BGPDT,UNUSED4,EST,CSTM,MPT,DIT,CASECC/VELEM/PROUT/S,N,ERROR $ELTPRT , ,GPECT,BGPDTS,,,,,,/ $ELTPRT , ,GPECT,BGPDTS,,,,,,/ $Main IndexDMAP Programmers GuideInstructions18ADD 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.StatementsA 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 FunctionAssignment StatementThe 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 Index19 Chapter 1: Direct Matrix AbstractionInstructionsFunction StatementFunctions 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:Returned values for character functions can be processor dependent.The following table shows the complete function library. The abbreviations in the far right column signify types:X ACOS(X)I RSRS RSRD RDCS CSCD CDAbbreviation TypeI IntegerR, RS, or RD RealC, CS, or CD ComplexA CharacterL LogicalMain IndexDMAP Programmers GuideInstructions20Format Definition ResultArgument Typeto Result TypeABS absolute value if is I or R, if I to IR and C to RACOS arccosine where, if is I or RI and R to CC to CThe result is computed in radians.ACOSH hyperbolic arccosine I and R to RC to CFor real and integer arguments, values less than 1 result in errors.ANDL numeric AND I, R, and C to LASIN arcsin where, if is I or RI and R to RC to CThe result is computed in radians.ASINH hyperbolic sine I and R to RC to CATAN arctangent I and R to RC to CThe result is computed in radians.ATAN2 arctangent of quotient I and R to RC to Cx ( ) x xa2b2x + x a i b + =x ( ) x ( )1 cos1 x 1 s s xx ( )cosh1 x ( )x 1 >x y , ( ) TRUE if x 0 and y 0 x2 0 =x1 x2 x1 a bi + = x2 c di + =a b 0 = = c da b 0 = = sign of c ( ) sign of d ( ) =a b c d 0 = = t 2 sign of a ( ) sign of b ( ) = c d 0 = = t 2 x ( )n 1 n 2number of bits per character ( )=c ( )Main IndexDMAP Programmers GuideInstructions22CMPLXCMPLXconvert to complex See belowFor 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 A to ACONCAT2(a1,a2) concatenation A to AAny trailing blanks of a1 are compressed to a single blank before a2 is concatenated.CONCAT3(a1,a2) concatenation A to AThe result is argument 1, with trailing blanks removed and argument 2 concatenated together.CONJG complexconjugate is conjugate to C to CCOS cosine I,R to R, C to CThe angle must be in radians.COSH hyperbolic cosine I,R to R, C to CThe angle must be in radians.DBLE convert to double precisionI to RD, R to RDC to CDInteger and real single values are converted to real double values.Real double values are not changed.Complex single values are converted to complex double values.Complex double values are not changed.DIAGOFF(x1,..) turn off DIAG TRUE if 0 < x1...xna1 a2 a1 a2 sa1 a2 ( , ) a1 a2 sa1 a2 ( , ) a1 a2 sa1 a2 ( , ) a1 a2 =x ( ) x ( )elogx ( ) x ( )10logx1 x2 ( , ) x x2 ( )1logx ( ) xxx y ( , )70 y +x 70 y + ( , )x y ( , )Main IndexDMAP Programmers GuideInstructions26The value of y ranges from 1 to 10. Returns the value of system cell . The command is similar in operation to PUTSYS .MAX( , ,...) choosing the largest argumentmax(x1,x2,...) I to I, R to RThe 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 RThe 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 I to I, R to RThe 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. must not be equal to 0.NEQVL(X,Y) numeric nonequivalenceI,R,C to LThe result is TRUE if the signs of the arguments are different, FALSE otherwise.NINT type to I with Round-off INT , if INT , if I,R,C to IFor complex arguments the function is applied to the real component.NOOP() no-operation returns TRUE logical output no inputFormat Definition ResultArgument Typeto Result Type70 y +x 70 y + ( , )x1 x2x1 x2 ( ) -INT x1 x2 ( )x2x ( ) x 0.5 + ( ) x 0 >x 0.5 ( ) x 0 0) is the same as SEID>0. Arithmetic operations and DMAP functions may also be specified in the where-expr (see Expressions and Operators, 8).If a qualifier in a where-expr is not a qualifier in the path of a specified item, then the where-expr is set to FALSE. If the where-expr does not contain a specification for all qualifiers in the path of an item, then the unspecified qualifiers will be wildcarded (i.e., quali=*, all values will be selected). The default values of qualifiers, PROJECT, VERSION, and DBSET are described under the statement in which the WHERE clause is specified.If where-expr is to be used on a DBVIEW statement to define an output data block from a module, then the following restrictions apply: The only operator allowed between qualifier assignments is the ";", for example, WHERE (SEID=10; PEID=20).Main IndexDMAP Programmers GuideWHERE and CONVERT Clauses44 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 BlocksMSC Nastran DMAP Programmers Guide2Data BlocksIntroductionMatrix Data BlocksTable Data BlocksTable DescriptionsData Block DescriptionsMain IndexMSC Nastran DMAP Programmers GuideIntroduction46IntroductionData 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 Index47 Chapter 2: Data BlocksMatrix Data BlocksMatrix Data BlocksThe rows and columns of most matrices correspond to degree-of-freedom sets which are defined in the USET table. Matrices are usually named according to __rc where r and c are the names of the degree-of-freedom sets for the row and column, respectively. For example, the rows and columns of KFS correspond to the f-set and the s-set.The rows and columns corresponding to degree-of-freedom sets are ordered according to an ascending internal point identification number sequence. This is the same as the external (user-assigned) grid point identification number sequence unless resequencing is requested (PARAM,OLDSEQ,>-1).Some matrices are also named with pseudo-degree-of-freedom set names.w -- The set omitted after auto-omit (a-set combines x-set and w-set)x -- The set retained after auto-omit (complement of w-set)J -- Superelement interior degrees-of-freedom; for example, KJJ and PJH -- Modal degrees-of-freedom; for example, PHDH, MHH, PHF and UHFIn some matrices, the columns correspond to subcases, normal modes, time steps, or forcing frequencies. These matrices are usually related to loads and solutions and named __r__ where r is the name of the degree-of-freedom set. For example, PG is static loads applied to the g-set and PHA is the a-set eigenvector matrix. In frequency and transient response, a "F" or "T" may also be added to the name. For example, UDF and UDT are the solution matrices at the d-set for frequency and transient response.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 Analysis Type Columns correspond to ascendingLinear Statics Subcase identification numberNonlinear Statics Loop identification numberNormal or Complex Eigenvalues Mode numberFrequency Response Subcase identification numberand forcing frequency valueTransient Response Time step valueMain IndexMSC Nastran DMAP Programmers GuideMatrix Data Blocks48there will be a separate solution matrix for each subcase. For a description of matrix trailers, see Data Blocks, 12.Main Index49 Chapter 2: Data BlocksTable Data BlocksTable Data BlocksThis section discusses common attributes across several tables: IFP tables OFP tables Element types See Table Descriptions, 65.IFP TablesThe 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.IFP Table Header Words and Trailer BitsThe first three words in all IFP Tables uniquely identify or label the contents of the record and are called "header words". The second header word indicates a bit position, called a "trailer bit", in the table trailer. The trailer bit indicates the presence of a record type in the data block; i.e., if the record is present in the table, then the bit is turned on in the trailer.There are a total of 176 trailer bits. The first 96 trailer bits correspond to bit positions 1 through 16, numbered from the right, in each trailer word and beginning with trailer word 1. The second 80 trailer bits correspond to bit positions 17 through 32, numbered from the right, in each trailer word and beginning with trailer word 1. The table below shows that correspondence between a trailer bit and its word and bit location in the trailer. Trailer BitLocation in TrailerWord Position1 -- 16 1 16 -- 117 -- 32 2 16 -- 133 -- 48 3 16 -- 149 -- 64 4 16 -- 165 -- 80 5 16 -- 181 -- 96 6 16 -- 1Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks50For 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 + 1BIT = 16*(1+TBIT/97) -- MOD(TBIT-1,16)where TBIT = trailer bit from second word of header recordWORD = trailer wordBIT = trailer word bit position numbered from the rightand all variables are defined as integers.OFP TablesHeader RecordThe header record of all OFP tables contains codes that indicate how the output should be labeled, formatted, and printed.97 -- 112 1 32 -- 17113 -- 128 2 32 -- 17129 -- 144 3 32 -- 17145 -- 160 4 32 -- 17161 -- 176 5 32 -- 17Word Name Contains1 approach_code Analysis type and output device type(s)2 table_code Header, labeling, and sort types9 format_code Data types (real or complex)11 stress_code Stress/strain, von Mises/max. shear, strain-curvature/strain-fiber flags12 jflag Acoustic element output flag13 iacflg Acoustic displacement (pressure) output request flag:2 = Yes and 0 = No14 q4cstr CQUAD4 corner output stress option21 metrik Electromagnetic units code (1 thru 6 or 10, default=10)Trailer BitLocation in TrailerWord PositionMain Index51 Chapter 2: Data BlocksTable Data BlocksApproach_CodeApproach_code indicates analysis type and device type(s).1. Analysis type is equal to approach_code/10 indicates:2. Device type(s) are extracted from the bit pattern equal to MOD(approach_code,10). The bits numbered from the right are:22 emssol Electromagnetic static solution code (0=CF+MAG,1=CF,2=ELEC,3=MAGN)23 thermal Thermal (heat transfer) element or scaled response spectra output:Bit Description 1 Thermal2 Scaled response spectra ABS3 Scaled response spectra SRSS4 Scaled response spectra NRL5 Scaled response spectra NRLOType Description 1 Statics2 Normal modes or buckling (real eigenvalues)3 Differential stiffness 0 (obsolete)4 Differential stiffness 1 (obsolete)5 Frequency6 Transient7 Pre-buckling8 Post-buckling9 Complex eigenvalues10 Nonlinear statics11 Geometric nonlinear staticsBit Description 1 PrintWord Name ContainsMain IndexMSC Nastran DMAP Programmers GuideTable Data Blocks52Therefore, MOD(approach_code,10) can be one of the following values:Examples:Table_codeTable_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.2 Plot3 PunchValue Device Type(s) 0 None1 Print2 Plot3 Print and plot4 Punch5 Print and punch6 Plot and punch7 Print, plot, and punchApproach_code Description61 Print transient response results15 Print and punch statics results106 Plot and punch nonlinear statics resultsType Chapter 2 Name Description 1 OUG Displacement vector2 OPG Load vector3 OQG SPCforce vector4 OEF Element force (or flux)5 OES Element stress(or strain)Bit Description Main Index53 Chapter 2: Data BlocksTable Data Blocks6 LAMA Eigenvalue summary7 OUG Eigenvector8 none Grid point singularity table (obsolete)9 OEIGS Eigenvalue analysis summary10 OUG Velocity vector11 OUG Acceleration vector12 OPG Nonlinear force vector13 OGPWG Grid point weight generator14 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 points22 OELOF1 Element internal forces and moments 23 OELOP1 Summation of element oriented forces on adjacent elements24 OEP Element pressures25 OEF Composite failure indices26 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 energy37 OEE Element energy lossType Chapter 2 Name Description Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks542. Data format, sort type and random type is extracted from the bit pattern equal to table_code/1000. Bits numbered from the right are:Therefore, table_code/1000 can be one of the following values:38 OMM MAXMIN summary39 OQG MPC forces40 OGPKE Grip point kinetic energyBit Description 1 Complex (on) flag 2 SORT2 (on) flag3 Random (on) flagValue Sort Type Data Format Random ?0 SORT1 Real No1 SORT1 Complex No2 SORT2 Real No3 SORT2 Complex No4 SORT1 Real Yes5 SORT2 Real Yestable_code Description4 Real force in SORT15 Real stress/strain in SORT11005 Complex stress/strain in SORT12010 Real velocities in SORT23005 Complex stress/strain in SORT25003 Random SPCforces in SORT2Type Chapter 2 Name Description Main Index55 Chapter 2: Data BlocksTable Data BlocksForemat_codeFormat_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_codeIn 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 systemStress_code is a bit pattern and the bits numbered from the right are:Value Data Format1 Real2 Real/imaginary3 Magnitude/phaseBit Description 1 Hencky von Mises (on) flag2 Strain (on) flag3 Strain/curvature (on) flag4 Same as bit 25 Material coordinate system (on) flagMain IndexMSC Nastran DMAP Programmers GuideTable Data Blocks56Therefore, stress_code can be one of the following values: Value On bitsCoordinate System Description0 0 0 0 0 0 Element Stress maximum shear or octahedral1 0 0 0 0 1 Stress von Mises10 0 1 0 1 0 Strain curvature maximum shear or octahedral11 0 1 0 1 1 Strain curvature von Mises14 0 1 1 1 0 Strain fiber maimum shear or octahedral15 0 1 1 1 1 Strain fiber von Mises16 1 0 0 0 0 Material Stress maximum shear or octahedral17 1 0 0 0 1 Stress von Mises26 1 1 0 1 0 Strain curvature maximum shear or octahedral27 1 1 0 1 1 Strain curvature von Mises30 1 1 1 1 0 Strain fiber maimum shear or octahedral31 1 1 1 1 1 Strain fiber von MisesMain Index57 Chapter 2: Data BlocksTable Data BlocksElement TypeSome 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.Type Name Description 00 Grid 01 ROD Rod 02 BEAM Beam 03 TUBE Tube04 SHEAR Shear panel05 FORMON12 FORCEi/MOMENTi follower stiffness06 FORCE Unused (Pre-V69 CTRIA1) 07 PLOAD4 PLOAD4 follower stiffness08 PLOADX1 PLOADX1 follower stiffness 09 PLOAD/PLOAD2 PLOAD/PLOAD2 follower stiffness10 CONROD Rod with properties11 ELAS1 Scalar spring 12 ELAS2 Scalar spring with properties13 ELAS3 Scalar spring to scalar points only 14 ELAS4 Scalar spring to scalar points only with properties 15 AEROT3 16 AEROBEAM17 Unused (Pre-V69 CTRIA2) 18 Unused (Pre-V69 CQUAD2) 19 Unused (Pre-V69 CQUAD1) 20 DAMP1 Scalar damper 21 DAMP2 Scalar damper with properties 22 DAMP3 Scalar damper to scalar points only 23 DAMP4 Scalar damper to scalar points only with properties24 VISC Viscous damper 25 MASS1 Scalar mass 26 MASS2 Scalar mass with properties Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks5827 MASS3 Scalar mass to scalar points only 28 MASS4 Scalar mass to scalar points only with properties 29 CONM1 Concentrated mass -- general form 30 CONM2 Concentrated mass -- rigid body form 31 PLOTEL Plot 32 Unused 33 QUAD4 Quadrilateral plate 34 BAR Simple beam (see also Type=100) 35 CONE Axisymmetric shell 36 Unused (Pre-V69 CTRIARG) 37 Unused (Pre-V69 CTRAPRG) 38 GAP Gap 39 TETRA Four-sided solid 40 BUSH1D Rod type spring and damper 41 Unused (Pre-V69 CHEXA1) 42 Unused (Pre-V69 CHEXA2) 43 FLUID2 Fluid with 2 points 44 FLUID3 Fluid with 3 points 45 FLUID4 Fluid with 4 points 46 FLMASS 47 AXIF2 Fluid with 2 points 48 AXIF3 Fluid with 3 points 49 AXIF4 Fluid with 4 points 50 SLOT3 Three-point slot 51 SLOT4 Four-point slot 52 HBDY Heat transfer plot for CHBDYG and CHBDYP 53 TRIAX6 Axisymmetric triangular 54 Unused (Pre-V69 TRIM6) 55 DUM3 Three-point dummy 56 DUM4 Four-point dummy 57 DUM5 Five-point dummy 58 DUM6 Six-point dummy 59 DUM7 Seven-point dummy Type Name Description Main Index59 Chapter 2: Data BlocksTable Data Blocks60 DUM8 Eight-point dummy (also two-dimensional crack tip CRAC2D)61 DUM9 Nine-point dummy (also three-dimensional crack tip CRAC3D)62 Unused (Pre-V69 CQDMEM1) 63 Unused (Pre-V69 CQDMEM2) 64 QUAD8 Curved quadrilateral shell 65 Unused (Pre-V69 CHEX8) 66 Unused (Pre-V69 CHEX20) 67 HEXA Six-sided solid 68 PENTA Five-sided solid 69 BEND Curved beam or pipe 70 TRIAR Triangular plate with no membrane-bending coupling 71 Unused 72 AEROQ4 73 Unused (Pre-V69 CFTUBE) 74 TRIA3 Triangular plate 75 TRIA6 Curved triangular shell 76 HEXPR Acoustic velocity/pressures in six-sided solid 77 PENPR Acoustic velocity/pressures in five-sided solid 78 TETPR Acoustic velocity/pressures in four-sided solid 79 Unused 80 Unused 81 Unused 82 QUADR Quadrilateral plate with no membrane-bending coupling 83 HACAB Acoustic absorber 84 HACBR Acoustic barrier 85 TETRANL Nonlinear data recovery four-sided solid 86 GAPNL Nonlinear data recovery gap 87 TUBENL Nonlinear data recovery tube 88 TRIA3NL Nonlinear data recovery triangular plate 89 RODNL Nonlinear data recovery rod 90 QUAD4NL Nonlinear data recovery quadrilateral plate 91 PENTANL Nonlinear data recovery five-sided solid 92 CONRODNL Nonlinear data recovery rod with properties Type Name Description Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks6093 HEXANL Nonlinear data recovery six-sided solid 94 BEAMNL Nonlinear data recovery beam 95 QUAD4LC Composite data recovery quadrilateral plate 96 QUAD8LC Composite data recovery curved quadrilateral shell 97 TRIA3LC Composite data recovery triangular shell 98 TRIA6LC Composite data recovery curved triangular shell 99 Unused 100 BARS Simple beam with intermediate station data recovery 101 AABSF Acoustic absorber with frequency dependence 102 BUSH Generalized spring and damper 103 QUADP p-version quadrilateral shell 104 TRIAP p-version triangular shell 105 BEAMP p-version beam 106 DAMP5 Heat transfer scalar damper with material property 107 CHBDYE Heat transfer geometric surface -- element form 108 CHBDYG Heat transfer geometric surface -- grid form 109 CHBDYP Heat transfer geometric surface -- property form 110 CONV Heat transfer boundary with free convection 111 CONVM Heat transfer boundary with forced convection 112 QBDY3 Heat transfer boundary heat flux load for a surface 113 QVECT Heat transfer thermal vector flux load 114 QVOL Heat transfer volume heat addition 115 RADBC Heat transfer space radiation 116 SLIF1D Slideline contact 117 WELDC Weld (Formats ELEMID and GRID with MSET=off)118 WELDP Weld (Formats ELPAT and PARTPAT)119 SEAM Seam (future development)120 GENEL General element121 DMIG Direct matrix input g-set122 Unused (Pre-V70.5 electromagnetic DIEL)123 Unused (Pre-V70.5 electromagnetic HEXAE)124 Unused (Pre-V70.5 electromagnetic IND)125 Unused (Pre-V70.5 electromagnetic LINE)Type Name Description Main Index61 Chapter 2: Data BlocksTable Data Blocks126 Unused (Pre-V70.5 electromagnetic PENTAE)127 Unused (Pre-V70.5 electromagnetic CQUAD)128 Unused (Pre-V70.5 electromagnetic CQUADX)129 Unused (Pre-V70.5 electromagnetic RELUC)130 Unused (Pre-V70.5 electromagnetic RES )131 Unused (Pre-V70.5 electromagnetic CTETRAE)132 Unused (Pre-V70.5 electromagnetic CTRIA)133 Unused (Pre-V70.5 electromagnetic TRIAX)134 Unused (Pre-V70.5 electromagnetic LINEOB)135 Unused (Pre-V70.5 electromagnetic LINXOB)136 Unused (Pre-V70.5 electromagnetic QUADOB)137 Unused (Pre-V70.5 electromagnetic TRIAOB)138 Unused (Pre-V70.5 electromagnetic LINEX )139 QUAD4FD Hyperelastic 4-noded quadrilateral shell140 HEXA8FD Hyperelastic 8-noded solid 141 HEXAP p-version six-sided solid 142 PENTAP p-version five-sided solid 143 TETRAP p-version four-sided solid 144 QUAD144 Quadrilateral plate with data recovery for corner stresses 145 VUHEXA p-version six-sided solid display 146 VUPENTA p-version five-sided solid display 147 VUTETRA p-version four-sided solid display 148 Unused (Pre-V70.5 electromagnetic HEXAM)149 Unused (Pre-V70.5 electromagnetic PENTAM)150 Unused (Pre-V70.5 electromagnetic TETRAM)151 Unused (Pre-V70.5 electromagnetic QUADM)152 Unused (Pre-V70.5 electromagnetic TRIAM)153 Unused (Pre-V70.5 electromagnetic QUADXM)154 Unused (Pre-V70.5 electromagnetic TRIAXM)155 Unused (Pre-V70.5 electromagnetic QUADPW)156 Unused (Pre-V70.5 electromagnetic TRIAPW)157 Unused (Pre-V70.5 electromagnetic LINEPW)158 Unused (Pre-V70.5 electromagnetic QUADOBM)Type Name Description Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks62159 Unused (Pre-V70.5 electromagnetic TRIAOBM)160 PENTA6FD Hyperelastic pentahedron 6-noded 161 TETRA4FD Hyperelastic tetrahedron 4-noded 162 TRIA3FD Hyperelastic triangular 3-noded 163 HEXAFD Hyperelastic hexahedron 20-noded 164 QUADFD Hyperelastic quadrilateral 9-noded 165 PENTAFD Hyperelastic pentahedron 15-noded 166 TETRAFD Hyperelastic tetrahedron 10-noded 167 TRIAFD Hyperelastic triangular 6-noded 168 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded 169 TRIAXFD Hyperelastic axisymmetric triangular 6-noded 170 QUADX4FD Hyperelastic axisymmetric quadrilateral 4-noded 171 QUADXFD Hyperelastic axisymmetric quadrilateral 9-noded 172 QUADRNL Nonlinear QUADR173 TRIARNL Nonlinear TRIAR174 Unused (Pre-V70.5 electromagnetic LINEOBM)175 Unused (Pre-V70.5 electromagnetic LINXOBM)176 Unused (Pre-V70.5 electromagnetic QUADWGM)177 Unused (Pre-V70.5 electromagnetic TRIAWGM)178 Unused (Pre-V70.5 electromagnetic QUADIB )179 Unused (Pre-V70.5 electromagnetic TRIAIB )180 Unused (Pre-V70.5 electromagnetic LINEIB )181 Unused (Pre-V70.5 electromagnetic LINXIB )182 Unused (Pre-V70.5 electromagnetic QUADIBM)183 Unused (Pre-V70.5 electromagnetic TRIAIBM)184 Unused (Pre-V70.5 electromagnetic LINEIBM)185 Unused (Pre-V70.5 electromagnetic LINXIBM)186 Unused (Pre-V70.5 electromagnetic QUADPWM)187 Unused (Pre-V70.5 electromagnetic TRIAPWM)188 Unused (Pre-V70.5 electromagnetic LINEPWM)189 VUQUAD p-version quadrilateral shell display 190 VUTRIA p-version triangular shell display 191 VUBEAM p-version beam display Type Name Description Main Index63 Chapter 2: Data BlocksTable Data Blocks192 CVINT Curve interface 193 Unused (Pre-V70.5 electromagnetic QUADFR) 194 Unused (Pre-V70.5 electromagnetic TRIAFR)195 Unused (Pre-V70.5 electromagnetic LINEFR)196 Unused (Pre-V70.5 electromagnetic LINXFR)197 SFINT Surface interface 198 CNVPEL199 VUHBDY p-version HBDY display 200 WELD Weld (Formats ALIGN, ELEMID, and GRIDID with MSET=on)201 QUAD4FD Hyperelastic quadrilateral 4-noded nonlinear data recovery Gauss/grid202 HEXA8FD Hyperelastic hexahedron 8-noded nonlinear data recovery Gauss/grid203 SLIF1D? Slideline contact204 PENTA6FD Hyperelastic pentahedron 6-noded nonlinear format Gauss/Grid205 TETRA4FD Hyperelastic tetrahedron 4-noded nonlinear format Gauss206 TRIA3FD Hyperelastic triangular 3-noded nonlinear format Gauss207 HEXAFD Hyperelastic hexahedron 20-noded nonlinear format Gauss208 QUADFD Hyperelastic quadrilateral 8-noded nonlinear format Gauss209 PENTAFD Hyperelastic pentahedron 15-noded nonlinear format Gauss210 TETRAFD Hyperelastic tetrahedron 10-noded nonlinear format Grid211 TRIAFD Hyperelastic triangular 6-noded nonlinear format Gauss/Grid212 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded nonlinear format Gauss213 TRIAXFD Hyperelastic axisymmetric triangular 6-noded nonlinear format Gauss/Grid 214 QUADX4FD Hyperelastic axisymmetric quadrilateral 4-noded nonlinear format Gauss/Grid215 QUADXFD Hyperelastic axisymmetric quadrilateral 8-noded nonlinear format Gauss216 TETRA4FD Hyperelastic tetrahedron 4-noded nonlinear format Grid217 TRIA3FD Hyperelastic triangular 3-noded nonlinear format Grid218 HEXAFD Hyperelastic hexahedron 20-noded nonlinear format Grid219 QUADFD Hyperelastic quadrilateral 8-noded nonlinear format GridType Name Description Main IndexMSC Nastran DMAP Programmers GuideTable Data Blocks64220 PENTAFD Hyperelastic pentahedron 15-noded nonlinear format Grid221 TETRAFD Hyperelastic tetrahedron 10-noded nonlinear format Gauss222 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded nonlinear format Grid223 QUADXFD Hyperelastic axisymmetric quadrilateral 8-noded nonlinear format Grid224 ELAS1 Nonlinear ELAS1225 ELAS3 Nonlinear ELAS3226 BUSH Nonlinear BUSH227 RBAR Rigid bar228 RBE1 Rigid body form 1229 RBE3 Rigid body form 3230 RJOINT Rigid joint231 RROD Rigid pin element232 QUADRLC Composite QUADR233 TRIARLC Composite TRIARType Name Description Main Index65 Chapter 2: Data BlocksTable DescriptionsTable DescriptionsTable 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 IndexBGPDTData Block Descriptions66Data Block DescriptionsContains 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 -- DATARecord 2 -- XIDMAPBGPDTBasic grid point definition tableWord Name Type Description1 NAME(2) CHAR4 Data block name Word Name Type Description1 CID I Coordinate system identification number 2 SIL I Internal (scalar) identification number 3 EXTID I External (user) identification number 4 DOF_TYPE I Degree of freedom/point type 5 PSC I Permanent set constraint 6 BGID I Boundary grid identification number of -EXTID 7 XCOORD RX x in basic coordinate system 8 YCOORD RX y in basic coordinate system 9 ZCOORD RX z in basic coordinate system Words 1 through 9 repeat until End of Record Word Name Type Description1 EXTID I External identification number 2 INTID I Internal identification number Words 1 through 2 repeat until End of Record Main Index67 BGPDTBasic grid point definition tableRecord 3 -- BIDMAPRecord 4 -- NORMALRecord 5 -- TRAILERWord Name Type Description1 BGID I Boundary (system) identification number 2 INTID I Internal identification number Words 1 through 2 repeat until End of Record Word Name Type Description1 XNORM RX X normal in aerodynamic system 2 YNORM RX Y normal in aerodynamic system 3 ZNORM RX Z normal in aerodynamic system Words 1 through 3 repeat until End of Record Word Name Type Description1 WORD1 I Number of grid points and scalar points 2 WORD2 I Number of boundary points 3 WORD3 I Number of degrees-of-freedom 4 WORD4 I Precision of the real values; i.e., type=RX 5 WORD5 I Number of scalar points 6 WORD6 I Maximum external identification number Notes: 1. For partitioned superelements the locations are in the superelements 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 IndexBGPDT68Basic grid point definition table (Pre-Version 69)68Contains 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 -- HEADERRecord 1 -- DATARecord 2 -- TRAILERBGPDT68Basic grid point definition table (Pre-Version 69)Word Name Type Description1 NAME(2) CHAR4 Data block name Word Name Type Description1 CID I Coordinate system identification number 2 XCOORD RS x in basic coordinate system 3 YCOORD RS y in basic coordinate system 4 ZCOORD RS z in basic coordinate system Words 1 through 4 repeat until End of Record Word Name Type Description1 WORD1 I Number of grid and scalar points 2 UNDEF(5 ) none Note: 1. Scaler points are identified by CID = -1 and XCOORD = YCOORD = ZCOORD = 0.Main Index69 CASECCCase Control informationRecord 0 -- HEADERRecord 1 -- RepeatCASECCCase Control informationWord Name Type Description1 NAME(2) CHAR4 Data block name Word Name Type Description1 SID I Subcase identification number 2 MPCSET I Multipoint constraint set (MPC) 3 SPCSET I Single point constraint set (SPC) 4 ESLSET I External static load set (LOAD) 5 REESET I Real eigenvalue extraction set (METHOD(STRUCTURE)) 6 ELDSET I Element deformation set (DEFORM) 7 THLDSET I Thermal load set (TEMP(LOAD)) 8 THMATSET I Thermal material set TEMP(MAT or INIT) 9 TIC I Transient initial conditions (IC) 10 NONPTSET I Nonlinear load output set (NLLOAD) 11 NONMEDIA I Nonlinear load output media (NLLOAD) 12 NONFMT I Nonlinear load output format (NLLOAD) 13 DYMLDSET I Dynamic load set (DLOAD) 14 FEQRESET I Frequency response set (FREQUENCY) 15 TFSET I Transfer function set (TFL) 16 SYMFLG I Symmetry flag (SYMSEQ and SUBSEQ) 17 LDSPTSET I Load output set (OLOAD) 18 LDSMEDIA I Load output media (OLOAD) 19 LDSFMT I Load output format (OLOAD) 20 DPLPTSET I Displacement, temperature, or pressure output set (DISP,THERM,PRES) 21 DPLMEDIA I Displacement, temperature, or pressure output media (DISP,THERM,PRES) Main IndexCASECCCase Control information7022 DPLFMT I Displacement, temperature, or pressure output format (DISP,THERM,PRES) 23 STSPTSET I Stress output set (STRESS) 24 STSMEDIA I Stress output media (STRESS) 25 STSFMT I Stress output format (STRESS) 26 FCEPTSET I Force (or flux) output set (FORCE or FLUX) 27 FCEMEDIA I Force (or flux) output media (FORCE or FLUX) 28 FCEFMT I Force (or flux) output format (FORCE or FLUX) 29 ACCPTSET I Acceleration (or enthalpy delta) output set (ACCEL or HDOT) 30 ACCMEDIA I Acceleration (or enthalpy delta) output media (ACCE, HDOT) 31 ACCFMT I Acceleration (or enthalpy delta) output format (ACCE, HDOT) 32 VELPTSET I Velocity (or enthalpy) output set (VELOCITY or ENTHALPY) 33 VELMEDIA I Velocity (or enthalpy) output media (VELOCITY) or ENTHALPY) 34 VELFMT I Velocity (or enthalpy) output format (VELOCITY) or ENTHALPY) 35 FOCPTSET I Forces of single-point constraint output set (SPCFORCE) 36 FOCMEDIA I Forces of single-point constraint output media (SPCFORCE) 37 FOCFMT I Forces of single-point constraint output format (SPCFORCE) 38 TSTEPTRN I Time step set for transient analysis (TSTEP) 39 TITLE(32) CHAR4 Title character string (TITLE) 71 SUBTITLE(32) CHAR4 Subtitle character string (SUBTITLE) 103 LABEL(32) CHAR4 LABEL character string (LABEL) 135 STPLTFLG I Model plot flag: set to 1 if OUTPUT(PLOT) is specified 136 AXSYMSET I Axisymmetric set (AXISYMMETRIC) 137 NOHARMON I Number of harmonics to output (HARMONICS) 138 TSTRV I Need definition Word Name Type DescriptionMain Index71 CASECCCase Control information139 K2PP(2) CHAR4 Name of direct input (p-set) stiffness matrix (K2PP) 141 M2PP(2) CHAR4 Name of direct input (p-set) mass matrix (M2PP) 143 B2PP(2) CHAR4 Name of direct input (p-set) damping matrix (B2PP) 145 OUTRESPV I Output frequencies or times (OFREQ or OTIME) 146 SEDR I Data recovery superelement list (SEDR) 147 FLDBNDY I Fluid boundary element selection (MFLUID) 148 CEESET I Complex eigenvalue extraction set (CMETHOD) 149 DAMPTBL I Structural damping table set (SDAMP(STRUCT) 150 DYNRED I Dynamic reduction selection (DYNRED) 151 SSDSET I Solution set displacements output set (SDISP) 152 SSDMEDIA I Solution set displacements output media (SDISP) 153 SSDFMT I Solution set displacements output format (SDISP) 154 SSVSET I Solution set velocities output set (SVELO) 155 SSVMEDIA I Solution set velocities output media (SVELO) 156 SSVFMT I Solution set velocities output format (SVELO) 157 SSASET I Solution set accelerations output set (SACCE) 158 SSAMEDIA I Solution set accelerations output media (SACCE) 159 SSAFMT I Solution set accelerations output format (SACCE) 160 NONLINLD I Nonlinear load set in transient problems (NONLINEAR) 161 PARTIT I Partitioning set (PARTN) 162 CYCLIC I Symmetry option in cyclic symmetry (DSYM) 163 RANDOM I Random analysis set (RANDOM) 164 NONPARAM I Nonlinear static analysis control parameters (NLPARM) 165 FLUTTER I Flutter set (FMETHOD) 166 LCC I Number of words in this record up to LSEM167 GPFSET I Grid point force output set (GPFORCE) Word Name Type DescriptionMain IndexCASECCCase Control information72168 GPFMEDIA I Grid point force output media (GPFORCE) 169 GPFFMT I Grid point force output format (GPFORCE) 170 ESESET I Strain energy output set (ESE) 171 ESEMEDIA I Strain energy output media (ESE) 172 ESEFMT I Strain energy output format (ESE) 173 ARFPTSET I Aerodynamic force output set (AEROF) 174 ARFMEDIA I Aerodynamic force output media (AEROF) 175 ARFFMT I Aerodynamic force output format (AEROF) 176 SEID I Superelement identification number(SUPER) 177 LCN I Load column number (SUPER) 178 GUST I Gust load selection (GUST) 179 SEFINAL I Final superelement identification number(SEFINAL) 180 SEMG I Generate matrices (K,M,B,K4) for superelement set or identification number(SEMG) 181 SEKR I Reduce stiffness matrix (K) for superelement set or identification number (SEKR) 182 SELG I Generate static loads for superelement set or identification number (SELG) 183 SELR I Reduce static loads for superelement set or identification number (SELR) 184 SEEX I Superelement set or identification number to be excluded (SEEXCLUDE) 185 K2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix (K2GG) 187 M2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix (M2GG) 189 B2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix (B2GG) 191 SVSET I Solution eigenvector output set (SVECTOR) 192 SVMEDIA I Solution eigenvector output media (SVECTOR) 193 SVFMT I Solution eigenvectors output format (SVECTOR) 194 FLUPTSET I Fluid pressure output set (MPRES) 195 FLUMEDIA I Fluid pressure output media (MPRES) Word Name Type DescriptionMain Index73 CASECCCase Control information196 FLUFMT I Fluid pressure output format (MPRES) 197 HOUT(3) I Cyclic symmetry harmonic output (HOUTPUT) 200 NOUT(3) I Cyclic symmetry physical output (NOUTPUT) 203 P2G(2) CHAR4 Name of direct input (g-set) static loads matrix (P2G) 205 LOADSET I Sequence of static loads sets (LOADSET) 206 SEMR I Generate matrices (M,B,K4) for superelement set or identification number (SEMG) 207 VONMISES I von Mises fiber (STRESS) 208 SECMDFLG I Superelement command existence flag 209 GPSPTSET I Grid point stress output set (GPSTRESS) 210 GPSMEDIA I Grid point stress output media (GPSTRESS) 211 GPSFMT I Grid point stress output format (GPSTRESS) 212 STFSET I Grid point stress field output set (STRFIELD) 213 STFMEDIA I Grid point stress field output media (STRFIELD 214 STFFMT I Grid point stress field output format (STRFIELD) 215 CLOAD I Superelement static load combination set (CLOAD) 216 SET2ID I Old design sensitivity contraint and variable set (SET2) 217 DSAPRT I Old design sensitivity analysis print option (SENSITY) 218 DSASTORE I Old design sensitivity analysis store option (SENSITY) 219 DSAOUTPT I Old design sensitivity analysis OUTPUT4 option (SENSITY) 220 STNSET I Strain output set (STRAIN) 221 STNMEDIA I Strain output media (STRAIN) 222 STNFMT I Strain output format (STRAIN) 223 APRESS I Aerodynamic pressure output set (APRESSURE) 224 TRIM I Aerostatic trim variable constrain set (TRIM) 225 MODLIST I Output modes list set (OMODES) Word Name Type DescriptionMain IndexCASECCCase Control information74226 REESETF I Real eigenvalue extraction set for fluid (METHOD(FLUID)) 227 ESDPTSET I Element stress discontinuity output set (ELSDCON) 228 ESDMEDIA I Element stress discontinuity output media (ELSDCON) 229 ESDFMT I Element stress discontinuity output format (ELSDCON) 230 GSDPTSET I Grid point stress discontinuity output set (GPSDCON) 231 GSDMEDIA I Grid point stress discontinuity output media (GPSDCON) 232 GSDFMT I Grid point stress discontinuity output format (GPSDCON) 233 SEDV I Generate pseudo-loads for superelement set or identification number (SEDV) 234 SERE I Generate responses for superelement set or identification number (SERESP) 235 SERS I Restart processing for superelement set or identification number (SERS) 236 CNTSET I Slideline contact output set (BOUTPUT) 237 CNTMEDIA I Slideline contact output media (BOUTPUT) 238 CNTFMT I Slideline contact output format (BOUTPUT) 239 DIVERG I Aerostatic divergence control parameter set (DIVERG) 240 OUTRCV I p-element output control parameters (OUTRCV) 241 STATSUBP I Static subcase identification number for pre-load (STATSUB(PRELOAD)) 242 UNDEF(2 ) none 242244 DFT1 RS Displacement Filter T1 component or TM magnitude**2 245 DFT2 RS Displacement Filter T2 component 246 ADAPT I p-element adaptivity control parameter set (ADAPT) 247 DESOBJ I Design objective set (DESOBJ) 248 DESSUB I Design constraint set for current subcase (DESSUB) Word Name Type DescriptionMain Index75 CASECCCase Control information249 SUBSPAN I Design constraint span set (DRSPAN) 250 DESGLB I Design constraint set for all subcases (DESGLB) 251 ANALYSIS CHAR4 Type of analysis (ANALYSIS) 252 GPQSTRS I CQUAD4 grid point corner stress option (STRESS) 253 GPQFORC I CQUAD4 grid point corner force option (STRESS) 254 GPQSTRN I CQUAD4 grid point corner strain option (STRESS) 255 SUPORT1 I Supported degree-of-freedom set (SUPORT1) 256 STATSUBB I Static subcase identification number for buckling (STATSUB(BUCKLE)) 257 BCID I Boundary condition identification number (BC) 258 AUXMODEL I Auxiliary model identification number (AUXMODEL) 259 ADACT I p-element adaptivity active subcase flag (ADACT) 260 DATSET I p-element output set (DATAREC) 261 DATMEDIA I p-element output media (DATAREC) 262 DATFMT I p-element output format (DATAREC) 263 VUGSET I View-grid and element output set (VUGRID) 264 VUGMEDIA I View-grid and element output media (VUGRID) 265 VUGFMT I View-grid and element output format (VUGRID) 266 MPCFSET I Forces of multipoint constraint output set (MPCFORCE) 267 MPCMEDIA I Forces of multipoint constraint output media (MPCFORCE) 268 MPCFFMT I Forces of multipoint constraint output format (MPCFORCE) 269 REUESET I Real unsymmetric eigenvalue extraction set (UMETHOD) 270 DAMPTBLF I Structural damping table set for the fluid (SDAMP(FLUID) 271 ITERMETH I Iterative solver control parameters (SMETHOD) 272 NLSSET I Nonlinear stress output set (NLSTRESS) 273 NLSMEDIA I Nonlinear stress output media (NLSTRESS) Word Name Type DescriptionMain IndexCASECCCase Control information76274 NLSFMT I Nonlinear stress output format (NLSTRESS) 275 MODTRKID I Mode tracking control parameter set (MODTRAK) 276 DSAFORM I Design sensitivity output format: 1 = yes, 2 = no (DSAPRT) 277 DSAEXPO I Design sensitivity output export: 1 = no, 2 = yes (DSAPRT) 278 DSABEGIN I Design sensitivity output start iteration (DSAPRT) 279 DSAINTVL I Design sensitivity output interval (DSAPRT) 280 DSAFINAL I Design sensitivity output final iteration (DSAPRT) 281 DSASETID I Design sensitivity output set (DSAPRT) 282 SORTFLG I Overall SORT1/SORT2 flag: 1 means SORT1 and 2 means SORT2. 283 RANDBIT I Random analysis request bit pattern (DISP,VELO,etc.) 284 AECONFIG(2) CHAR4 Aerodynamic configuration name 286 AESYMXY I Symmetry flag for aerodynamic xy plane 287 AESYMXZ I Symmetry flag for aerodynamic xz plane 288 UNDEF none 289 UNDEF none 290 UNDEF none 291 GPEPTSET I Grid point strain output set (GPSTRAIN) 292 GPEMEDIA I Grid point strain output media (GPSTRAIN) 293 GPEFMT I Grid point strain output format (GPSTRAIN) 294 TEMPMAT I Thermal material set TEMP(MAT)295 AECSSSET I Aerodynamic control surface schedule (CSSCHD) 296 EKEPTSET I Element kinetic energy output set (EKE) 297 EKEMEDIA I Element kinetic energy media (EKE) 298 EKEFMT I Element kinetic energy format (EKE) 299 EKETHRSH RS Element kinetic energy threshold (EKE) 300 EDEPTSET I Element damping energy output set (EDE) 301 EDEMEDIA I Element damping energy media (EDE) Word Name Type DescriptionMain Index77 CASECCCase Control information302 EDEFMT I Element damping energy format (EDE) 303 EDETHRSH RS Element damping energy threshold (EDE) 304 DFT3 RS Displacement Filter T3 component 305 DFR1 RS Displacement Filter R1 component or RM magnitude**2 306 DFR2 RS Displacement Filter R2 component 307 DFR3 RS Displacement Filter R3 component 308 K42GG (2) CHAR4 Name of direct input (g-set) structural element damping matrix (K42GG)310 A2GG (2) CHAR4 Name of direct input (g-set) area matrix (A2GG)312 NK42GG I Internal set identification number for K42GG313 NA2GG I Internal set identification number for A2GG314 EFFMASET I Modal effective mass output set (MEFFMASS) 315 EFFMAGID I Modal effective mass GID (MEFFMASS) 316 EFFMATHR RS Modal effective mass threshold (MEFFMASS) 317 EQUILMED I EQUILIBRIUM print/punch bit pattern318 EQUILGRD I EQUILIBRIUM grid point identification number319 RCRSET I RCROSS output set 320 RCRFMT I RCROSS format 321 AEUXREF I AEUXREF 322 GCHK I Ground check flag (GROUNDCHECK) 323 GCHKOUT I Ground check output (GROUNDCHECK) 324 GCHKSET I Ground check set (GROUNDCHECK) 325 GCHKGID I Ground check GID (GROUNDCHECK) 326 GCHKTHR RS Ground check THRESH (GROUNDCHECK) 327 GCHKRTHR RS Ground check RTHRESH (GROUNDCHECK) 328 GCHKDREC I Ground check data recovery (GROUNDCHECK) 329 ASPCMED I Output media request (AUTOSPC) 330 ASPCEPS RS EPS value for fixup (AUTOSPC) 331 ASPCPRT I EPS value for printing (AUTOSPC) 332 ASPCPCH I Punch Set identification number (AUTOSPC) 333 UNDEF none 334 UNDEF none Word Name Type DescriptionMain IndexCASECCCase Control information78335 NK2PP I Internal set identification number for K2PP336 NM2PP I Internal set identification number for M2PP337 NB2PP I Internal set identification number for B2PP338 NK2GG I Internal set identification number for K2GG 339 NM2GG I Internal set identification number for M2GG 340 NB2GG I Internal set identification number for B2GG 341 NP2G I Internal set identification number for P2G 342 GEODSET I Geometry check DISP set identification number (GEOMCHECK) 343 GEODMXMN I Geometry check DISP max/min (GEOMCHECK) 344 GEODOCID I Geometry check DI