dmap

NX Nastran DMAP Programmer’s Guide Proprietary & Restricted Rights Notice © 2007 UGS Corp. All Rights Reserved. This software and related documentation are proprietary to UGS Corp. NASTRAN is a registered trademark of the National Aeronautics and Space Administration. NX Nastran is an enhanced proprietary version developed and maintained by UGS Corp. MSC is a registered trademark of MSC.Software Corporation. MSC.Nastran and MSC.Patran are trademarks of MSC.Software Corporation. All other trademarks are the property of their respective owners. 2 NX Nastran DMAP Programmer’s Guide Contents Direct Matrix Abstraction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Introduction to DMAP . . . . . . . . . . . . . . . . . . . . The NX Nastran DMAP Language . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . Output from a Previous Module Rule . . . . . . . . . Automatic Deletion of Scratch Data Blocks . . . . . Preface Modules and SOLution 100 . . . . . . . . . . Processing User Errors . . . . . . . . . . . . . . . . . . . SubDMAPs DBMGR, DBSTORE, and DBFETCH WHERE and CONVERT Clauses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 . 1-2 . 1-3 1-10 1-12 1-30 1-30 1-31 1-31 1-32 1-34 Overview of Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Matrix Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Table Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Data Block Descriptions B-E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 BGPDT . . BGPDT68 . CASECC . CDDATA . CLAMA . . CONTAB . CONTACT CSTM . . . CSTM68 . . DBCOPT . DESTAB . DIT . . . . . DSCMCOL DVPTAB . DYNAMIC EGPSF . . . EGPSTR . ELDCT . . EPT . . . . . EQEXIN . ERROR . . EST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 . 3-4 . 3-4 3-26 3-29 3-30 3-31 3-34 3-36 3-43 3-45 3-46 3-50 3-61 3-62 3-76 3-80 3-83 3-85 3-115 3-116 3-117 Data Block Descriptions F-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 FOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 NX Nastran DMAP Programmer’s Guide 3 Contents GEOM1 . . GEOM168 GEOM2 . . GEOM3 . . GEOM4 . . GPDT68 . . GPL . . . . . HIS . . . . . KDICT . . . LAMA . . . MPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 4-15 4-27 4-67 4-81 4-105 4-106 4-107 4-108 4-110 4-111 Data Block Descriptions O-V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 OBC . . . OBJTAB OCCORF OCPSDF OEE . . . OEF . . . . OES . . . . OGF . . . OGK . . . OGS . . . . OMECON OMEOSC OMKEC . OMKEO . OMSEC . OMSEO . OPG . . . OPTPRM OQG . . . OSDISP2 OSHT . . OUG . . . R1MAP . R1TAB . . RESP12 . SEMAP . SET . . . . TOL . . . . VIEWTB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 5-4 5-4 5-6 5-7 5-13 5-74 5-218 5-223 5-225 5-232 5-234 5-236 5-238 5-240 5-243 5-245 5-250 5-252 5-257 5-258 5-260 5-272 5-272 5-278 5-282 5-286 5-287 5-287 . . . . . Glossaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 Data Block Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Parameter Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-53 NASTRAN Data Definition Language (NDDL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 NDDL Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Detailed Description of NDDL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 4 NX Nastran DMAP Programmer’s Guide Contents Overview of DMAP Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1 DMAP Module and Statement List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 DMAP Module and Statement Description Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5 Descriptions of DMAP Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1 ACMG . . . . . . . . . . . ADAPT . . . . . . . . . . ADD . . . . . . . . . . . . ADD5 . . . . . . . . . . . . ADDVM . . . . . . . . . . ADG . . . . . . . . . . . . ADR . . . . . . . . . . . . AELOOP . . . . . . . . . AEMODEL . . . . . . . . AMG . . . . . . . . . . . . AMP . . . . . . . . . . . . APD . . . . . . . . . . . . . APPEND . . . . . . . . . ASDR . . . . . . . . . . . ASG . . . . . . . . . . . . . AXMDRV . . . . . . . . . AXMPR1 . . . . . . . . . AXMPR2 . . . . . . . . . BCDR . . . . . . . . . . . BDRYINFO . . . . . . . BGCASO . . . . . . . . . BGP . . . . . . . . . . . . . BMG . . . . . . . . . . . . BNDSPC . . . . . . . . . BOLTFOR . . . . . . . . BOLTSF . . . . . . . . . . CASE . . . . . . . . . . . . CEAD . . . . . . . . . . . CHKCVG . . . . . . . . . CMPZPR . . . . . . . . . COPY . . . . . . . . . . . CURV . . . . . . . . . . . CURVPLOT . . . . . . . CYCLIC1 . . . . . . . . . CYCLIC2 . . . . . . . . . CYCLIC3 . . . . . . . . . CYCLIC4 . . . . . . . . . DBC . . . . . . . . . . . . DBDELETE . . . . . . . DBDICT . . . . . . . . . . DBEQUIV . . . . . . . . SubDMAP DBFETCH SubDMAP DBMGR . . DBSTATUS . . . . . . . SubDMAP DBSTORE DBVIEW . . . . . . . . . DCMP . . . . . . . . . . . DDR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 9-4 9-6 9-8 9-10 9-11 9-12 9-13 9-15 9-16 9-17 9-19 9-21 9-23 9-25 9-27 9-27 9-28 9-29 9-31 9-32 9-32 9-33 9-34 9-36 9-36 9-37 9-42 9-44 9-45 9-46 9-47 9-48 9-50 9-51 9-52 9-54 9-57 9-63 9-65 9-76 9-78 9-79 9-82 9-83 9-85 9-86 9-89 NX Nastran DMAP Programmer’s Guide 5 Contents DDR2N . . . DDRMM . . DECOMP . . DELETE . . DIAGONAL DISDCMP . DISFBS . . . DISOFPM . DISOFPS . . DISOPT . . . DISUTIL . . DIVERG . . DMIIN . . . . DOM10 . . . DOM11 . . . DOM12 . . . DOM6 . . . . DOM9 . . . . DOPFS . . . DOPR1 . . . DOPR2 . . . DOPR3 . . . DOPR4 . . . DOPR5 . . . DOPR6 . . . DOPRAN . . DPD . . . . . DRMH1 . . . DRMH3 . . . DRMS1 . . . DSABO . . . DSAD . . . . DSADJ . . . . DSAE . . . . DSAF . . . . . DSAH . . . . DSAJ . . . . . DSAL . . . . . DSAM . . . . DSAN . . . . DSAP . . . . . DSAPRT . . DSAR . . . . DSARLP . . DSARME . . DSARSN . . DSAW . . . . DSDVRG . . DSFLTE . . . DSFLTF . . . DSMA . . . . DSPRM . . . DSTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-92 . 9-95 . 9-97 9-101 9-101 9-103 9-105 9-105 9-106 9-107 9-109 9-112 9-113 9-114 9-117 9-119 9-123 9-125 9-127 9-128 9-130 9-132 9-135 9-136 9-137 9-138 9-139 9-141 9-143 9-144 9-145 9-147 9-152 9-154 9-155 9-157 9-159 9-160 9-162 9-163 9-164 9-165 9-166 9-168 9-169 9-170 9-171 9-172 9-172 9-173 9-174 9-175 9-177 6 NX Nastran DMAP Programmer’s Guide Contents DSTAP2 . . . DSVG1 . . . . DSVG1P . . DSVG2 . . . . DSVG3 . . . . DSVGP4 . . DSVGP5 . . DTIIN . . . . DUMMOD1 DUMMOD2 DUMMOD3 DUMMOD4 DVIEWP . . DYNREDU . EFFMASS . ELFDR . . . ELTPRT . . . EMA . . . . . EMAKFR . . EMC . . . . . EMG . . . . . EMR . . . . . EQUIVX . . ESTINDX . . FA1 . . . . . . FA2 . . . . . . FBS . . . . . . FILE . . . . . FOCODS . . FOCOEL . . FOCOST . . FOELCF . . FOELCS . . FONOTR . . FORTIO . . . FRLG . . . . . FRLGEN . . FRQDRV . . FRRD1 . . . . FRRD2 . . . . GENTRAN . GETCOL . . GETMKL . . GI . . . . . . . GKAM . . . . GMERGE . . GNFM . . . . GP0 . . . . . . GP1 . . . . . . GP1LM . . . GP2 . . . . . . GP3 . . . . . . GP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-180 9-180 9-182 9-184 9-185 9-186 9-187 9-188 9-189 9-189 9-190 9-191 9-191 9-193 9-194 9-195 9-196 9-198 9-199 9-200 9-201 9-205 9-206 9-207 9-208 9-209 9-210 9-212 9-214 9-214 9-215 9-216 9-217 9-218 9-219 9-220 9-222 9-223 9-223 9-226 9-227 9-228 9-229 9-230 9-231 9-233 9-233 9-234 9-236 9-238 9-239 9-240 9-241 NX Nastran DMAP Programmer’s Guide 7 Contents GP5 . . . . . . . GPARTN . . . GPFDR . . . . GPJAC . . . . . GPSP . . . . . . GPSTR1 . . . . GPSTR2 . . . . GPWG . . . . . GUST . . . . . IFP . . . . . . . IFP1 . . . . . . IFP3 . . . . . . IFP4 . . . . . . IFP5 . . . . . . IFP6 . . . . . . IFP7 . . . . . . IFP8 . . . . . . IFP9 . . . . . . IFPINDX . . . IFT . . . . . . . INPUTT2 . . . INPUTT4 . . . INTERR . . . . ISHELL . . . . LAMX . . . . . LANCZOS . . LCGEN . . . . LMATPRT . . LRFORCE . . MACOFP . . . MAKAEFA . . MAKAEFS . . MAKAEMON MAKCOMP . MAKENEW . MAKEOLD . . MAKETR . . . MAKMON . . MATGEN . . . MATGPR . . . MATMOD . . MATPCH . . . MATPRN . . . MATPRT . . . MATREDU . . MCE1 . . . . . MCE2 . . . . . MDATA . . . . MDCASE . . . MERGE . . . . MERGEOFP . MESSAGE . . MGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-243 9-245 9-246 9-249 9-249 9-251 9-252 9-253 9-255 9-256 9-259 9-261 9-263 9-264 9-266 9-267 9-268 9-269 9-269 9-270 9-271 9-272 9-274 9-275 9-277 9-281 9-283 9-284 9-285 9-286 9-286 9-288 9-289 9-289 9-290 9-292 9-293 9-294 9-295 9-307 9-311 9-350 9-352 9-352 9-353 9-355 9-355 9-356 9-357 9-360 9-364 9-365 9-365 8 NX Nastran DMAP Programmer’s Guide Contents MKCNTRL . . MKCSTMA . . MKSPLINE . MODACC . . . MODEPF . . . MODEPOUT MODEPT . . . MODGDN . . MODGM2 . . MODGM4 . . MODTRK . . . MODTRL . . . MODUSET . . MONVEC . . . MPP . . . . . . MPYAD . . . . MRGCOMP . MRGMON . . MSGHAN . . . MSGSTRES . MTRXIN . . . NASSETS . . NLCOMB . . . NLITER . . . . NLTRD . . . . NLTRD2 . . . NORM . . . . . NXNADAMS NXNRFI . . . OFP . . . . . . . OPTGP0 . . . . ORTHOG . . . OUTPRT . . . OUTPUT2 . . OUTPUT4 . . PARAML . . . PARTN . . . . PCOMB . . . . PCOPY . . . . PLOT . . . . . . PLTHBDY . . PLTSET . . . . PRESOL . . . PROJVER . . PRTMSG . . . PRTPARM . . PURGEX . . . PVT . . . . . . . RANDOM . . . RBMG3 . . . . RBMG4 . . . . READ . . . . . RESTART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-366 9-367 9-368 9-368 9-370 9-372 9-374 9-375 9-376 9-377 9-378 9-380 9-381 9-383 9-384 9-386 9-391 9-391 9-392 9-392 9-393 9-398 9-398 9-400 9-405 9-409 9-413 9-415 9-416 9-417 9-419 9-420 9-422 9-424 9-433 9-438 9-451 9-455 9-456 9-457 9-458 9-459 9-461 9-462 9-462 9-463 9-464 9-465 9-466 9-469 9-470 9-471 9-478 NX Nastran DMAP Programmer’s Guide 9 Contents RMAXMIN . RMG2 . . . . ROTCDA . . ROTCZG . . ROTUTL . . RSPEC . . . . SCALAR . . SDP . . . . . . SDR1 . . . . . SDR2 . . . . . SDR3 . . . . . SDRCOMP . SDRHT . . . SDRNL . . . SDRP . . . . . SDRX . . . . . SDRXD . . . SDSA . . . . . SDSB . . . . . SDSC . . . . . SECONVRT SEDR . . . . SEDRDR . . SELA . . . . . SEMA . . . . SEP1 . . . . . SEP1X . . . . SEP2 . . . . . SEP2CT . . . SEP2DR . . . SEP2X . . . . SEP3 . . . . . SEP4 . . . . . SEPLOT . . SEPR1 . . . . SEQP . . . . . SHPCAS . . SMA3 . . . . SMPYAD . . SOLVE . . . . SOLVIT . . . SSG1 . . . . . SSG2 . . . . . SSG3 . . . . . SSG4 . . . . . STATICS . . STDCON . . STRSORT . TA1 . . . . . . TABEDIT . . TABPRT . . TABPT . . . . TAFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-480 9-481 9-482 9-483 9-484 9-486 9-487 9-488 9-490 9-491 9-496 9-497 9-498 9-499 9-501 9-503 9-505 9-506 9-508 9-509 9-509 9-510 9-512 9-514 9-515 9-517 9-518 9-520 9-522 9-522 9-526 9-527 9-528 9-530 9-531 9-532 9-537 9-538 9-539 9-540 9-542 9-547 9-550 9-551 9-552 9-554 9-556 9-557 9-558 9-560 9-564 9-572 9-573 10 NX Nastran DMAP Programmer’s Guide Contents TAHT . . . TASNP1 . . TASNP2 . . TIMETEST TOLAPP . TRD1 . . . . TRD2 . . . . TRLG . . . . TRNSP . . TYPE . . . . UEIGL . . . UGVADD . UMERGE . UMERGE1 UPARTN . UREDUC . VDR . . . . VDRE . . . VEC . . . . . VECPLOT VIEW . . . . VIEWP . . WEIGHT . XSORT . . XYPLOT . XYTRAN . .... .... .... ... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-574 9-575 9-576 9-577 9-581 9-583 9-585 9-586 9-589 9-590 9-593 9-595 9-596 9-598 9-600 9-602 9-603 9-605 9-606 9-608 9-612 9-613 9-615 9-615 9-617 9-617 NX Nastran DMAP Programmer’s Guide 11 Chapter 1 Direct Matrix Abstraction • • • • • • • • • • • Introduction to DMAP The NX Nastran DMAP Language Parameters 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 NX Nastran DMAP Programmer’s Guide 1-1 Chapter 1 Direct Matrix Abstraction 1.1 Introduction to DMAP NX Nastran Direct Matrix Abstraction Program (DMAP) is a high-level language with its own compiler and grammatical rules. This section provides a summary description of the NX 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 NX 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 (UGS recommends mnemonic names) 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 NX Nastran execution completes, data blocks and parameters written to scratch files are erased, and those written to the permanent physical file are available for future use. The NX Nastran Data Definition Language (NDDL) 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)” . NX Nastran provides a variety of prewritten solution sequences. These solution sequences consist of a series of DMAP statements. You can use DMAP to modify these prewritten solution sequences or to write your own solution sequences. The compilation, linkage, and execution of a DMAP program is specified by executive control statements in the input file. The creation of and access to databases is specified by file management statements also contained in the input file. File management statements are described in the “File Management Statements” in the NX Nastran Quick Reference Guide . 1.2 The NX Nastran DMAP Language The basic components, or objects, of the DMAP language are: Parameters Data Blocks Instructions Scalar quantities used to control the flow of DMAP execution and to communicate options and/or values to modules or functions. Tables or matrices represented by a symbolic name. Statements or modules that process parameters and/or data blocks as input and/or output. The basic syntax of the DMAP language is: • The DMAP language uses free-field input format and is case insensitive. 1-2 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction • 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. UGS recommends following the convention of terminating 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 and is 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. • • • 1.3 Parameters Parameters can be either constants, variables, or expressions and can represent one of several types: Type Integer Real Complex Logical Character Description Whole number Decimal number that is a whole number and a decimal point, with an optional decimal fraction. A pair of real numbers representing the real and imaginary parts of a complex quantity Represents either TRUE or FALSE A string of 1 to 80 characters Example(s) 10 or -4 27000. or 2.7E5 or 2.7D5 (1.1,2.3) or (1.D0,3.5D1) TRUE or FALSE ’GEORGE’ 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. Type Integer Real single precision Real double precision Complex single precision Complex double precision Number of words 1 1 2 2 4 NX Nastran DMAP Programmer’s Guide 1-3 Chapter 1 Direct Matrix Abstraction Type Logical Character Number of words 1 1 to 20 The type of a parameter must be declared in at least one of three ways: Constant Explicit Implicit Inherent in its specification or construction On a TYPE statement for variable parameters In a module’s parameter list for variable parameters Constant Parameters A constant represents a fixed value and is a number (integer, real, or complex), logical, or character string. Integer Constants An integer constant is a whole number with no decimal point. Its form is: snn where: s nn = = a sign, plus (+) or minus (-) a string of digits (0 through 9) 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 231 − 1 = 214748367. Real Constants A real constant is a whole number with a decimal point that can be followed by a decimal fraction and/or a decimal exponent. The complete form is: snn.ddEsee snn.ddDsee where: s nn, dd, ee = = A sign, plus (+) or minus (-) Strings of digits (0 through 9) For single precision For double precision 1-4 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction 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. 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, an integer must follow, even if the exponent is 0. Only the leftmost 14 digits in nn.dd are used by NX 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. 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 can 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 can 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. Value of a Variable Parameter During 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”). 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. NX Nastran DMAP Programmer’s Guide 1-5 Chapter 1 Direct Matrix Abstraction 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. 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. 6. Default value from the first occurrence of either a non-NDDL TYPE DMAP statement or a module with a MPL default value. Non-NDDL TYPE DMAP statements have a default value of zero, blank, or FALSE for real or integer, character, or logical parameters. 7. Default value is zero, blank, or FALSE for real or integer, character, or logical parameters. Determining the current value of a variable parameter is summarized in the following table. NDDL TYPEd Not TYPEd Last executed assignment statement or module save (S,N,). The qualifier values for NDDL parameters cannot change. Bulk Data PARAM entry override, if the 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 NDDL default value Predefined Variable Parameters The 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. UGS does not recommend changing these parameter values. The predefined variable parameters are: NAME ALWAYS NEVER TRUE FALSE NOGO VALUE -1 +1 TRUE FALSE 0 TYPE Integer Integer Logical Logical Integer name=vfrom its first occurrence in a TYPE statement TYPE statement default MPL default of parameter first occurrence 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 1-6 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction 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 Specification Follow these recommendations to produce a more readable DMAP sequence where all Y parameters and parameters with non-MPL defaults are specified on TYPE statements. • If the parameter’s value is to be specified in the Case Control or Bulk Data Section, type the parameter near the top of the DMAP sequence, as shown below. TYPE PARM,,type,Y,param_name $ • If the parameter’s default value is defined on the NDDL PARAM statement and you want to use the NDDL default value, type the parameter near the top of the DMAP sequence, as shown below. TYPE PARM,NDDL,type,Y,param_name $ • If the desired default value differs from the MPL default, specify the parameter and the default value on a TYPE statement, as shown below. 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, UGS recommends the following sequence 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 $ UGS does not recommend the following: IF( FLAG ) PARAMR . . . ADD A,B/C/V,Y,ALPHA=(1.,1.) $ //’COMPLEX’//BETA/GAMMA/S,Y,ALPHA $ NX Nastran DMAP Programmer’s Guide 1-7 Chapter 1 Direct Matrix Abstraction Expressions and Operators An 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: • • • 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 statements 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. Operator –,+ Operation Negative or Positive immediately preceded by exponentiation Exponentiation Negative or Positive Multiplication or Division Addition or Subtraction Sample expressions X–Y Interpreted as X(–Y) ** –,+ *, / +,– –X**Y –X – Y X*Y+Z X+Y –(X**Y) (–X) – Y (X*Y)+Z 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. Operator & Operation Concatenation Sample expressions ‘ABC’ & ‘DE’ = ‘ABCDE’ 1-8 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Relational Operators Relational operators are used to compare two expressions. The result of the comparison is a logical TRUE or FALSE. When arithmetic and relational operators are combined in one expression, the arithmetic operations are performed first. The table below shows the allowable relational operators. Operator = <>,>< < > ≤ ≥ 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 NOT X TRUE FALSE X AND Y TRUE TRUE FALSE FALSE X OR Y TRUE TRUE FALSE FALSE Y n/a n/a TRUE FALSE TRUE FALSE TRUE FALSE TRUE FALSE Output FALSE TRUE TRUE FALSE FALSE FALSE TRUE TRUE TRUE FALSE Relation tested Equality Inequality Less than Greater than Less than or equal Greater than or equal Expression X=Y X<>Y, X><Y X<Y X>Y X≤Y X≥Y NX Nastran DMAP Programmer’s Guide 1-9 Chapter 1 Direct Matrix Abstraction Operator X XOR Y X TRUE TRUE FALSE FALSE Y TRUE FALSE TRUE FALSE TRUE FALSE TRUE FALSE Output FALSE TRUE TRUE FALSE TRUE FALSE FALSE TRUE X EQV Y TRUE TRUE FALSE FALSE 1.4 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; for example, real, integer, complex, character, and so on. For matrices, the data record corresponds to the nonzero values in the column of the matrix; for example, 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. Table trailers In tables, the trailer record contains six words. The contents vary among the tables and are described in “Data Blocks” 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 1 2 Contents Number of columns in matrix Number of rows in matrix 1-10 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Word 3 4 5 6 7 8 9 10 11 12 Contents Form of the matrix Type of matrix Largest number of nonzero words among all columns Density of the matrix multiplied by 10000 Size in blocks Maximum string length over all strings Number of strings Average bandwidth Maximum bandwidth Number of null columns Form is defined as one of the following: Form 1 2 3 4 5 6 8 9 10 11 13 15 Meaning Square Rectangular Diagonal Lower triangular factor Upper triangular factor Symmetric Identity Pseudo identity Cholesky factor Trapezoidal factor Sparse lower triangular factor Sparse upper triangular factor Type is defined as one of the following: NX Nastran DMAP Programmer’s Guide 1-11 Chapter 1 Direct Matrix Abstraction Type 1 2 3 4 Meaning Real, single precision Real, double precision Complex, single precision Complex, double precision Data Block Type and Status The 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 the NX Nastran User’s Guide). There are three types of DMAP data blocks: Permanent NDDL Scratch NDDL Local Referenced on a TYPE DB statement and assigned to a permanent DBset through the NDDL Referenced on a TYPE DB statement and assigned to the SCRATCH DBset through the NDDL Not referenced on a TYPE DB statement and automatically assigned to the SCRATCH DBset. At any point during a DMAP execution a data block is in one of the three following states: Generated Not generated Empty The data block has been created The data block has been deleted or is not yet created 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. 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), 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. 1.5 Instructions A DMAP instruction can be classified as either a module or a statement. A module is similar to a "macro" function and, in general, processes data blocks as input and/or output. A module can 1-12 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction 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 “Descriptions of DMAP Modules and Statements”. 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 NX 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: Listing 1-1. Module Properties List. NX Nastran DMAP Programmer’s Guide 1-13 Chapter 1 Direct Matrix Abstraction The MPL listing contains useful information under the following column headers: Header Description MOD-NAME IN OUT ID TYP Module name Number of input data blocks Number of output data blocks Parameter position 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 “Descriptions of DMAP Modules and Statements”. If a parameter is unspecified, the default value is assumed and obtained from the MPL. For example, MPYAD A , B , / D $ According to the MPYAD module description, if C is unspecified, 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, a constant or variable parameter must be specified for the first parameter. For example, -- NO DEFAULT -- on the PARAML module indicates that 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 $ 1-14 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction 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,,,,,,/ $ In addition, trailing commas can be left unspecified: ELTPRT , ,GPECT,BGPDTS,,,,,,/ $ Parameters can be specified on a module as: • • • Input only Input and output Output only Each module has its own rules for parameter specification, as described in “Descriptions of DMAP Modules and Statements”. If a parameter is specified as input, 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: ADD A , B / C / ALPHA $ If a parameter is to be used as both input and output, or output only, 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 is returned by the PARAM module for later use in the DMAP program. If the S,N prefix is omitted, 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 Database Function Assignment Statement The assignment statement evaluates an expression and assigns the resulting value to a variable parameter. This statement has the following form: NX Nastran DMAP Programmer’s Guide 1-15 Chapter 1 Direct Matrix Abstraction 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. Function Statement Functions can appear only 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, can 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 I RS RD CS CD ACOS(X) RS RS RD CS CD 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: Abbreviation I R, RS, or RD C, CS, or CD Type Integer Real Complex 1-16 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Abbreviation A L Format ABS(x) Definition absolute value Result |x| if x is I or R Type Character Logical Argument type to result type I to IR and C to R , if x = a + ib ACOS(x) arccosine cos−1(x) where −1 ≤ x ≤ 1, if x is I or R I and R to CC to C The result is computed in radians. ACOSH(x) hyperbolic arccosine cosh−1(x)x ≥ 1 I and R to RC 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 FALSE otherwise ASIN(x) arcsin sin−1(x) where−1 ≤ x ≤ 1, if x is I or R I and R to RC to C I, R, and C to L The result is computed in radians. ASINH(x) ATAN(x) hyperbolic sine arctangent sinh−1(x) tan−1(x) I and R to RC to C I and R to RC to C The result is computed in radians. ATAN2(x1, x2) arctangent of quotient tan−1(x1/x2) I and R to RC to C If both arguments are zero, the result is zero. If x1 and x2 are real and: x1 = 0 and x2 > 0, the result is 0.x1 = 0 and x2 < 0, the result is π.x1 > 0 and x2 = 0, the result is π/2.x1 < 0 and x2 = 0, the result is −π/2. If x1 and x2 are complex (x1 = a + bi and x2 = b + di) and: a = b = 0 and (sign of c) = (sign of d), the result is 0.a = b = 0 and (sign of c) ≠ (sign of d), the result is π. (sign of a) = (sign of b) and c = d = 0, the result is π/2. (sign of a) ≠ (sign of b) and c = d = 0, the result is −π/2. ATANH(x) hyperbolic arctangent tan−1(x) where −1 ≤ x≤ 1, if x is I or R I and R to RC to C NX Nastran DMAP Programmer’s Guide 1-17 Chapter 1 Direct Matrix Abstraction Format ATANH2(x1, x2) Definition hyperbolic arctangent of quotient Result tan−1(x1, x2) Argument type to result type I and R to RC 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 = b + di) and: a = b = 0 and (sign of c) = (sign of d), the result is 0.a = b = 0 and (sign of c) ≠ (sign of d), the result is π. (sign of a) = (sign of b) and c = d = 0, the result is π/2. (sign of a) ≠ (sign of b) and c = d = 0, the result is −π/2. CHAR(x) character value See note below. I to A The function takes the processor collating sequence equivalent (for example, 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 n = 2(number of bits per character). CLEN(c) character length Character string length in multiples of 4. A to I CLOCK( ) CPU time in sec. since job started convert to complex a + ib x, if complex x+i 0, otherwise I CMPLX(a, b) CMPLX(x) See below 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; for example, 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 concatenation a1 & a2 A to A CONCAT2(a1, a2) 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) complexconjugate a − ib is conjugate to a + ib C to C 1-18 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Format COS(x) Definition cosine Result cos(x) Argument type to result type I,R to R, C to C The angle must be in radians. COSH(x) hyperbolic cosine cosh(x) I,R to R, C to C The angle must be in radians. DBLE(x) convert to double precision I to RD, R to RDC to CD Integer and real single values are converted to real double values. Real double values are not changed. Complex single values are converted to complex double values Complex double values are not changed. DIAGOFF(x1, ..) turn off DIAG TRUE if 0 < x1...xn<65 FALSE otherwise DIAGON(x1, ..) turn on DIAG TRUE if 0 < x1...xn<65 FALSE otherwise DIM(x1, x2) positive difference x1 - MIN(x1,x2) I to I, R to RC not allowed I to L I to L 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 (collapse string) replace multiple blanks with blank (compress string) double product ’AB’ = DLABLANK(’A B’) A to A DLXBLANK(x) ’AB’ = DLXBLANK(’A B’) A to A DPROD(x1,x2) x1 * x2 I to RD, R to RDC 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) GETDIAG(x) exponential get DIAG cell ex I,R to R, C to C I to I Function returns the value of DIAG cell x, where x = 1 or 2. See “PUTDIAG, GETDIAG”. NX Nastran DMAP Programmer’s Guide 1-19 Chapter 1 Direct Matrix Abstraction Format GETSYS(x,y) Definition get value of SYSTEM cell y Result Argument type to result type I to I The value extracted has the same type (I, RS, RD ...) as x. The value x must be a variable parameter. In order to obtain the value for later use in the DMAP, specify x = GETSYS(x,y). See “PUTSYS, GETSYS”. ICHAR(x) return integer value ASCII code A to I The function returns the ASCII code of the character argument. Integer returned I < 2(number of bits per character). 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. The resulting 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 a1 2 = INDEX(’ABC’,’B’) A to I The result is zero if the second string is not found in the first string. INDEXSTR (a1,a2,x1,x2) start position of a2 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) with sign of x I,R,C to I A,I to I For complex arguments the function is applied to the real component. ITOL(x) type to L TRUE, if x < 0 FALSE, if x ≥ 0 LEQ(a1, a2) lexical equality TRUE, if a1 = a2 FALSE otherwise A to L I,R to L 1-20 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Format LGE(a1, a2) Definition lexical greater than or equal to Result TRUE, if a1 ≥ a2 FALSE, if a1 < a2 Argument type to result type A to L LGT(a1, a2) lexical greater than TRUE, if a1 > a2 FALSE, if a1 ≤ a2 A to L LLE(a1,a2) lexical lessthan or equal TRUE, if a1 ≤ a2 FALSE otherwise A to L LLT(a1, a2) lexical lessthan TRUE, if a1 ≤ a2 FALSE otherwise A to L LNE(a1, a2) lexical notequal to TRUE, if a1 ≠ a2 FALSE otherwise A to L 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 loge(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 log10(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 log1(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) MCGETSYS(x,y) type to I MODCOM get 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 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). I output –1, if x is TRUE+1, if x is FALSE L to I I output NX Nastran DMAP Programmer’s Guide 1-21 Chapter 1 Direct Matrix Abstraction Format MAX( 1,x2,...) Definition choosing the largest argument Result max(x1,x2,...) Argument type to result type I to I, R to R 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( 1,x2,...) choosing the smallest min(x1,x2,...) I to I, R to R 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 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 nonequivalence I,R,C to L 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 ≥ 0INT(x − 0.5), if x < 0 I,R,C to I For complex arguments the function is applied to the real component. NOOP() NORMAL(x) no-operation normalize if x = a + bi NOTL(x) numeric not FALSE if x < 0 TRUE otherwise NUMEQ(x1,x2) equality TRUE, if x1 = x2 FALSE otherwise NUMGE(x1,x2) greater than or equal to TRUE if x1 ≥ x2 FALSE, if x1 < x2 NUMGT(x1,x2) greater than TRUE, if x1 > x2 FALSE, if x1 ≤ x2 I,R,C to L I,R,C to L I,R,C to L I,R,C to L returns TRUE logical output no input C to R 1-22 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Format NUMLE(x1,x2) Definition less than or equal to Result TRUE if x1 ≤ x2 FALSE otherwise Argument type to result type I,R,C to L NUMLT(x1,x2) less than TRUE, if x1 < x2 FALSE otherwise I,R,C to L NUMNE(x1,x2) not equal to TRUE, if x1 ≠ x2 FALSE otherwise I,R,C to L ORL(x1,x2) numeric or TRUE, if x1 <0 or x2 < 0 FALSE otherwise I,R,C to L PI(x) multiples of pi xπ I,R to R, C to C Complex arguments of (a,b) form return aπ, bπ results. PRECISON() current analysis precision integer output The function returns the currently requested precision: 1, single precision, 2, double precision. PUTDIAG(x,y) put x into DlAG cell y I to I The function deposits the value x into DIAG cell y, where y = 1 or 2. See “PUTDIAG, GETDIAG”. PUTSYS(x,y) modify system cell put x into system cell y I to I The function deposits the value x into system cell y. PUTSYS returns the value x on completion. See “PUTSYS, GETSYS”. RAND(x) random number generator x = seed if x>0. Use last RAND(x) as seed if x=0. If x<0 use wall clock as seed. I,R to R 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 non-reproducible random sequence. RDIAGON(x,y) turns on DIAGover range x to y TRUE if x>0, and y<65 FALSE otherwise The function turns on the DIAGs within the range x,y. The value of TRUE is returned if the operation was successful. I to L NX Nastran DMAP Programmer’s Guide 1-23 Chapter 1 Direct Matrix Abstraction Format REAL(x) Definition Type to R Result real(x)a, if x=a+ib Argument type to result type I,R to R, C to R 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 memory to the value x |x1|, if x2 > 0−|x1|, if x2 < 0 I,RS,L SIGN(x1,x2) transfer of sign I to I, R to R Resultant type determined by first argument. SIN(x) sine sin(x) I,R to R, C to C The angles are given in radians. SINH(x) hyperbolic sine sinh(x) I,R to R, C to C The angles are given in radians. SNGL(x) SPROD(x1,x2) convert to single single prec product x1 * x2 I,R to RS, C to CS 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 I,R to R, C to C If the value of integer or real arguments is less than 0, 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(A,x1,x2) substring SUBSTRIN (′ABC′, 2, 3) → ′BC′ x1,x2 can be I, R 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) TANH(x) tangent hyperbolic tangent tan(x) tanh(x) I,R to R, C to C I,R to R, C to C 1-24 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Format TIMETOGO() Definition remaining CPU Time Result Argument type to result type 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 of argument A,I,R,C,L to I 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 FALSE otherwise I,R,C to L 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 restore the original DIAG 8 setting, the following sequence can 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 can be set and recovered via the PUTSYS and GETSYS DMAP functions. See “nastran Command and NASTRAN Statement” in the NX 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 $ NX Nastran DMAP Programmer’s Guide 1-25 Chapter 1 Direct Matrix Abstraction Control Statement The NX 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: Conditional Execution Unconditional Branching Conditional Branching Looping Calling SubDMAP Operations Termination IF JUMP and LABEL IF()THEN, ELSE IF()THEN, ELSE, and ENDIF DO WHILE and ENDDO SUBDMAP, CALL, and RETURN EXIT and END Conditional Execution—IF Statement The IF statement conditionally executes a single DMAP instruction: IF ( logical expression ) instruction $ In other words, if the logical expression is true, the instruction is executed. Instruction is any DMAP module or statement, except a control statement or the FILE, DBVIEW, TYPE and SUBDMAP statements. Examples include: IF ( NOGOA=-1 ) ADD GOAT,GOAQ/GOA $ IF ( ERRFLAG<0 ) CALL ERROR //S,GO/ERROR $ IF ( A AND B ) X=2*Y $ Unconditional Branching—JUMP and LABEL Statements The JUMP and LABEL statements are analogous to the GO TO and CONTINUE statements in FORTRAN, except the LABEL statement cannot appear above the JUMP statement. For example, JUMP n $ . . . LABEL n $ where n is character string, up to eight alphanumeric characters in length, and the first character must be alphabetic. JUMP and LABEL can be used to jump out of a DO WHILE loop or IF()THEN block, but JUMP and LABEL cannot be used to jump into a DO WHILE loop or IF()THEN block. JUMP can appear on an IF statement; however, in this case, UGS recommends using an IF()THEN statement. Conditional Branching—IF ( ) THEN Statement The IF ( ) THEN operation has the following form: 1-26 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction 1. IF(expression)THEN $ . . DMAP executed if expression is TRUE . ENDIF $ 2. IF(expression)THEN $ . . . ELSE $ . . . ENDIF $ DMAP executed if expression is FALSE DMAP executed if expression is TRUE 3. IF(expression 1)THEN $ . . . ELSE IF(expression 2)THEN $ . . . DMAP executed if expression 1 is FALSE and expression 2 is TRUE DMAP executed if expression 1 is TRUE ELSE IF(expression n)THEN $ . . . DMAP executed if expression 1 through expression n-1 are FALSE and expression n is TRUE ELSE $ . . . DMAP executed if expression 1 through expression n are FALSE ENDIF $ The expressions in the above examples are relational and/or logical operations that result in a logical output of either TRUE or FALSE. The allowable relational operators are discussed in “Expressions and Operators” Looping—DO WHILE ( ) Statement DO WHILE(expression) $ . . . NX Nastran DMAP Programmer’s Guide 1-27 Chapter 1 Direct Matrix Abstraction ENDDO $ 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 in “Expressions and Operators”. There is no limit to the allowable number of DO WHILE statements. Scratch NDDL and local blocks which are first referenced and created inside a DO WHILE loop are automatically deleted at the end of the loop. The FILE statement with the APPEND or SAVE keyword can 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” for examples. Calling SubDMAP Operations—SUBDMAP, CALL, and RETURN Statements The CALL and SUBDMAP statements allow for the definition of DMAP subprograms called subDMAPs. The RETURN statement can be used in a subDMAP to return to the calling subDMAP. The SUBDMAP statement denotes the beginning of a DMAP subprogram; either a main subDMAP or a called subDMAP. A main subDMAP can be invoked with the SOL Executive Control statement and cannot have any arguments. A called subDMAP can or cannot have arguments and is invoked by a CALL statement in another subDMAP, defined as the calling subDMAP. The form of the SUBDMAP and CALL statements are: SUBDMAP subDMAP-name [I1,I2,I3,.../ O1,O2,O3,.../ P1/P2/P3/... $] [I1,I2,I3,.../ O1,O2,O3,.../ [S,]P1/[S,]P2/[S,]P3/...] $ CALL subDMAP-name where subDMAP-name is the name of a subDMAP. The arguments Ii, Oi, and Pi are the list of input data block names, output data block names, and variable parameter names or constant parameters. The specification of arguments is optional. If arguments are specified, the CALL and SUBDMAP statements must agree in order, in number, and, for parameters only, in type. The linker checks for correspondence of the arguments. The linker also checks for consistent parameter authorization if NASTRAN SYSTEM(147)=1. In addition, a view-name defined by the DBVIEW statement cannot be specified in the argument list. If an argument list is specified on the SUBDMAP statement, no argument can be left unspecified. Also, all parameter arguments must be variable parameter names. Any data block argument on the CALL statement can be left unspecified. Inside the called subDMAP, the data block argument is treated as purged. All parameters must be specified on the CALL statement, but the parameters can be either a variable parameter name or a constant value. Also on the CALL statement, parameter values, such as qualifiers or local parameters (which are computed in the called subDMAP), can be returned to calling subDMAP by preceding the parameter name with "S,". This method is called the save option. The save option is not required for parameters specified on TYPE PARM,NDDL statements in the called subDMAP. The RETURN statement can be specified anywhere in the subDMAP. This statement terminates execution of the current subDMAP and resumes execution of the calling subDMAP. If the 1-28 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction RETURN 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 can 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 $ SUBDMAP TEST X,Y,Z/L,M,N/A1/A2/A3 $ TYPE PARM,,I,Y,A3 $ TYPE PARM,,I,N,A1,A2 $ . . . RETURN $ END $ The following should also be noted: • The data block names specified on the SUBDMAP statement argument list are called local names and do not appear in any diagnostic output. Diagnostic output, such as data base directory print or DIAG 8, indicates only the top-level name. The top-level name is the name of the data block in the highest CALL statement in which it appears. In the example above, the local names are X, Y, Z, and so on, and the top-level names are A, B, C, and so on. All input data blocks specified on a CALL statement must have been previously defined by output from a module in the calling subDMAP or from a previously specified CALL statement, or specified on TYPE DB statements. See the “TYPE” statement. Recursive subDMAP calls are allowed; for example, a subDMAP can call itself either directly or indirectly. The last parameter in the argument list must not be followed by a slash (/). • • • Termination—EXIT and END statements Both EXIT and END statements terminate the DMAP execution. However, the EXIT statement can be specified at any time in a subDMAP, and the END statement can be specified only once and must appear at the end of a subDMAP. The following example demonstrates the use of both statements: SUBDMAP AAA $ . . (some DMAP instructions) NX Nastran DMAP Programmer’s Guide 1-29 Chapter 1 Direct Matrix Abstraction . IF(ERROR)EXIT$ . . (some DMAP instructions) . END $ If ERROR is true, the EXIT statement is used to terminate the subDMAP. The END statement is required and must be the last statement in the subDMAP. Declarative Statement The declarative statements are TYPE, DBVIEW, and FILE. See “DMAP Modules and Statements” for a description, and “Output from a Previous Module Rule” and “Automatic Deletion of Scratch Data Blocks” for related discussion. Data Base Function Statement The data base function statements are DBEQUIV and DBDELETE. See “DMAP Modules and Statements” for a description. 1.6 Output from a Previous Module Rule If a data block has already been specified as output by a previous module and is specified as output from another module, User Fatal Message 1126 is issued during execution. This principle is called the “output from a previous module” or “output twice” rule. This rule is waived if any of the following is true: • • • The data block is specified on a FILE statement with the APPEND or OVRWRT keyword. The data block is TYPE’d (specified on a TYPE DB statement), and its current qualifier values are different from the qualifier values given at the time of the previous module execution. The data block is specified as output on a CALL statement and TYPE’d. 1.7 Automatic Deletion of Scratch Data Blocks Scratch NDDL and local data blocks are stored on the SCRATCH DBset. A DBset is a physical file that is a subdivision of the database. To minimize the size of the SCRATCH DBset, module scratch files are automatically deleted upon completion of the module and DMAP scratch data blocks are automatically deleted after the DMAP instruction in which they are used last. The location of this DMAP instruction is called the last-time-used (LTU). An LTU is assigned to every data block. When the LTU of an Scratch NDDL data block is reached, the data block is deleted if the current qualifier values match. If the data block’s LTU is skipped, the entire family is deleted, regardless of the current qualifier values. Special rules apply for data blocks specified in the following situations: • For a scratch data block specified before a loop and last used inside the loop, the LTU is extended to the bottom of the loop (for example, ENDDO), meaning that the data block is deleted when the loop is exited. If the data block is Scratch NDDL, the entire family is deleted, regardless of the current qualifier values. 1-30 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction • For a local data block created inside a DMAP loop and last used after the loop, the data block is deleted after the next execution of the top of the loop, for example, DO WHILE, even though the data block’s LTU is located after the loop (for example, when the loop is exited). Thus, the last generated data block can be used after the loop exits. For a scratch data block created and last used inside a DMAP loop, the FILE statement with the SAVE keyword extends the data block’s original LTU to the bottom of the loop. Otherwise, the data block is deleted at the original LTU within the loop. For a Scratch NDDL data block used in a DBVIEW statement, the data block is deleted at the LTU of the view name or the data block name, whichever is last. • • DlAG 57 prints the LTU information of all data blocks and a message indicating when they are deleted. 1.8 Preface Modules and SOLution 100 The preface modules IFP1, XSORT, IFPi, DTIIN, and DMIIN generate data blocks related to the Case Control, Bulk Data, and DMI or DTI entries. These modules are specified at the beginning of all solution sequences. SOLution 100 is also provided for the DMAP writer who wishes to execute his/her DMAP sequences without having to specify the Preface modules IFP1, XSORT, and IFPi. The DMAP writer needs to insert the following DMAP statements in the Executive Control of the input data: 1. SOL 100 COMPILE USERDMAP ALTER 2 2. If matrices or tables are to be input with DMI or DTI Bulk Data entries, the DMIIN or DTIIN modules must be specified by the DMAP writer. For example, the following DMAP statements generate matrices A, B, C, D, and E and tables TA, TB, TC, TD, and TE: DMIIN DMIIN DMI,DMINDX/A,B,C,D,E,,,,,/ $ DMI,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. 4. The DMAP writer’s DMAP sequence can now be inserted. 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. 1.9 Processing User Errors Modules used in Phase I of the superelement SOLution sequences (SOLs 101 through 200) include an option to continue processing after fatal errors are discovered and printed in the output file. The module completes processing as best it can, then sets a special integer parameter named NOGO to -1. The output files can be purged or incomplete. If no errors are discovered, NOGO is set to 0. The DMAP writer can choose to branch to the end of a loop or take other NX Nastran DMAP Programmer’s Guide 1-31 Chapter 1 Direct Matrix Abstraction actions when error conditions are discovered. This option is selected by setting SYSTEM cell 82 to 1. Users who insert alters into Phase l should be aware of this option. An example of this option, based on the method used in SOLs 101 through 200, is: PUTSYS(1,82) $ALLOWS DMAP TO FIELD NOGO FLAGS . . . GP2 GEOM2S,EQEXINS,,GEOM2A,EPTA/ECTS,ECTAS $ IF ( NOGO = -1 ) THEN $ CALL ERRPH1 //SUBDMAP/0/-1/DUMMY $ LOOPER RETURN $ CONTINUE TO NEXT SE ALTHOUGH ENDIF $ . . . PUTSYS (0,82) $ DISALLOWS DMAP TO FIELD NOGO FLAGS ERROR FOUND IN CURRENT SE The GEOM2S file contains element connectivity data. If the GP2 module detects errors in this data, it sets NOGO to -1. Modules that presently have this option include: DCMP DECOMP DYCNTRL EMG GP2 GP3 GP4 LCGEN MGEN MTRXIN SEDR SELA SEMA SSG1 TA1 1.10 SubDMAPs DBMGR, DBSTORE, and DBFETCH The DBMGR, DBSTORE, and DBFETCH module capabilities prior to MSC.Nastran Version 66 have been replaced by subDMAPs, as described below. CALL CALL CALL DBMGR //OPT/P2/P3/P4/P5/P6/DB1/DB2/DB3/DB4/DB5 $ DBSTORE DB1,DB2,DB3,DB4,DB5//Q1/Q2/DBSET/COND $ DBFETCH /DB1,DB2,DB3,DB4,DB5/Q1/Q2/FLAG/0/S,SUCCESS $ The complete descriptions can be found in “DMAP Modules and Statements” under subDMAPs DBFETCH, DBMGR, and DBSTORE. 1-32 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction Prior to MSC.Nastran Version 66, data blocks can be stored, fetched, and manipulated from the database via the DMAP modules DBSTORE, DBFETCH and DBMGR. In MSC.Nastran Version 66 these modules were removed in favor of a more robust and automatic capability. To help you store data blocks that are not already defined in the NDDL, a set of subDMAPs are available that emulate most of the capabilities in those modules. The subDMAPs and their capabilities are: CALL DBSTORE CALL DBFETCH CALL DBMGR Store data blocks on the database Retrieve data blocks from the database Perform various functions related to data blocks stored using CALL DBSTORE 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 if they are being used in any NX Nastran solution sequences. For example: SOL 101 DIAG 47 COMPILE SEDRCVR ALTER ’AFTER ELEMENT STRESS’ CALL CEND DBSTORE OES1,,,,//0/SEID/’ ’/0 $ These subDMAPs are also used in a user’s solution sequence. SOL MYDMAP COMPILE MYDMAP SUBDMAP MYDMAP $ . . . CALL DBSTORE A,,,,//0/1/’ . . . END $ CEND ’/0 $ 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 NX Nastran DMAP Programmer’s Guide 1-33 Chapter 1 Direct Matrix Abstraction 1.11 WHERE and CONVERT Clauses The WHERE clause is used in the selection of items (data blocks and parameters) on the DBDICT, DBLOCATE, DBLOAD, and DBUNLOAD statements. The CONVERT clause modifies qualifier values of items selected by the WHERE clause on the DBLOCATE and DBLOAD statements. The WHERE and CONVERT clauses specify values for PROJECT, VERSION, qualifiers, and DBSET. PROJECT specifies the project-ID that is originally defined on the PROJECT FMS statement at the time the project is created. VERSION specifies the desired version-ID under the project-ID. Qualifiers are used to uniquely identify items on the database with the same name. For example, data block KAA has SEID as one of its qualifiers, which is the superelement ID. An item can have more than one qualifier and the collection of all qualifiers assigned to an item is called a path. All data blocks and parameters with qualifiers are defined in the NDDL Sequence (see “NASTRAN Data Definition Language (NDDL)”). Data blocks and parameters are defined on the DATABLK and PARAM NDDL statements. The DATABLK and PARAM statements specify the name of the data block, parameter, and also its path name. The path names are defined on the PATH NDDL statement, which lists the qualifiers assigned to the path. Qualifiers are defined on the QUAL NDDL statement. DBSET specifies the desired DBset. The DBset of an item is specified after the LOCATION keyword on the DATABLK and PARAM NDDL statement. The format of the WHERE clause is: WHERE (where-expr) where-expr is a logical expression that specifies the desired values of qualifiers, PROJECT, VERSION, and DBSET. If the result of the logical expression is TRUE for an item on the database, the item is selected. For example, WHERE(VERSlON=4 AND SElD < > 2 AND SElD > 0) selects all items under version 4 for all values of SEID greater than 0 except 2. A simple where-expr is a comparison using the following relational operators = , > ‘ < ‘ ≤, ≥, or utortu. For example, SElD > 0 means if SEID is greater than zero, the logical expression is true. Several simple where expressions can be joined into one where expression by the following logical operators: AND, OR, XOR, and EQV. The NOT operator can be used to negate a where expression. For example, NOT(SEID>0) is the same as SEID≥0. Arithmetic operations and DMAP functions can also be specified in the where expression (see “Expressions and Operators”). If a qualifier in a where-expr is not a qualifier in the path of a specified item, 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, the unspecified qualifiers are wildcarded. (For example, in the statement quali= * , all values are selected.) The default values of qualifiers, PROJECT, VERSION, and DBSET are described under the statement in which the WHERE clause is specified. 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” in the NX Nastran Quick Reference Guide), and qualifier values of items selected by the WHERE clause on the DBLOCATE and DBLOAD statements. The CONVERT clause contains one or more assignment statements separated by semicolons. The format of the CONVERT clause is: CONVERT(PROJECT=project-expr; VERSION=version-expr; , DBSET=DBset-expr;quali=qual-expri[;...]) 1-34 NX Nastran DMAP Programmer’s Guide Direct Matrix Abstraction The PROJECT and VERSION statements modify the project-ID (see “PROJ” in the NX Nastran Quick Reference Guide) and version-ID. The DBSET statement modifies the DBset-name. The value of quali is replaced by qual-expri for selected items that have quali in their path. qual-expri is any valid expression (see “Expressions and Operators” 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, a fatal message is issued. If project-expr and/or version-expr produces a project- or version-ID which does not exist, one is created. Also, all version-lDs less than version-expr that do not exist are created; but they are “empty.” Examples of the CONVERT clause are: • • 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, 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; the new values for the SElD qualifier are 2, 4, and 6: • • Set all values of qualifier SElD to be twice the value of the PEID qualifier. CONVERT(SElD=2*PElD) NX Nastran DMAP Programmer’s Guide 1-35 Chapter 2 Overview of Data Blocks • • • Introduction Matrix Data Blocks Table Data Blocks NX Nastran DMAP Programmer’s Guide 2-1 Chapter 2 Overview of Data Blocks 2.1 Introduction Data block descriptions are provided for all matrices and tables that are currently processed by the OUTPUT2 and DBC modules in the NX Nastran solution sequences with PARAM,POST. Data block descriptions are arranged alphabetically by the generic name of the data block. A data block description can 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 “Glossaries” . 2.2 Matrix Data Blocks The 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 PJ H – Modal degrees-of-freedom; for example, PHDH, MHH, PHF and UHF In 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, an "F" or "T" can also be added to the name. For example, UDF and UDT, are the solution matrices at the d-set for frequency and transient response. Analysis type Linear statics Nonlinear statics Normal or complex eigenvalues Frequency response Transient response Columns correspond to ascending Subcase identification number Loop identification number Mode number Subcase ID and Forcing frequency value Time step value 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, U_T has 30 columns. If multiple TSTEP command subcases are requested, there is a separate solution 2-2 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks 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 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 represent the second subcase, and so on. For example, if an analysis is performed with four forcing frequencies and three DLOADsubcases, the solution matrix has 12 columns in which the first 4 columns correspond all forcing frequencies in the first subcase. If multiple FREQUENCY command subcases are requested, there is a separate solution matrix for each subcase. For a description of matrix trailers see “Data Blocks” . 2.3 Table Data Blocks This section discusses common attributes across tables. IFP Tables The IFP module processes the Bulk Data Section and creates data blocks which contain images of each Bulk Data entry. Modules IFP2 through IFP9, MODEPT, MODGM2, GP0, SEQP, and MODGM4 then 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, no record is written. IFP Table Header Words and Trailer Bits The 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 record type in the data block; that is, if the record is present in the table, 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 the correspondence between a trailer bit and its word and bit location in the trailer. Trailer Bit Word 1 – 16 17 – 32 33 – 48 1 2 3 Location in trailer Position 16 – 1 16 – 1 16 – 1 NX Nastran DMAP Programmer’s Guide 2-3 Chapter 2 Overview of Data Blocks Trailer Bit Word 49 – 64 65 – 80 81 – 96 97 – 112 113 – 128 129 – 144 145 – 160 161 – 176 4 5 6 1 2 3 4 5 Location in trailer Position 16 – 1 16 – 1 16 – 1 32 – 17 32 – 17 32 – 17 32 – 17 32 – 17 For example, the GRID record in the GEOM1 data block is assigned to trailer bit 45 which corresponds to the 4th bit position, numbered from the right, in trailer word 3. Based on the trailer bit, the following FORTRAN statements can 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 the second word of the header record WORD = trailer word BIT = trailer word bit position numbered from the right and all variables are defined as integers. OFP Tables The header record of all OFP tables contains codes which indicate how the output should be labeled, formatted, and printed. Word 1 2 9 11 Name approach_code table_code format_code stress_code Contains Analysis type and output device type(s) Header, labeling, and sort types Data types (real or complex) Stress/strain, von Mises/max. shear, strain-curvature/strain-fiber flags. Also, SPCForce/MPCForce flag. Acoustic element output flag 12 jflag 2-4 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Word 13 Name iacflg Contains Acoustic displacement (pressure) output request flag: 2 = Yes and 0 = No. 14 21 22 23 q4cstr metrik emssol thermal CQUAD4 corner output stress option Electromagnetic units code (1 thru 6 or 10, default=10) Electromagnetic static solution code (0=CF+MAG,1=CF,2=ELEC,3=MAGN) Thermal (heat transfer) element output Note: In some OFP table descriptions (OEE, OEF, OES for example), you will see formats such as ACODE,4=05, or TCODE,1=02 (versus ACODE=05 or TCODE=02). The integer values 4 and 1 in these examples are function codes. Function codes specify operations to perform on the value in the data block. The operation result will then be used to determine the data format. The following lists the available function codes and their operation: Function codes 1 2 3 4 5 6 7 Operation if (item_name/1000 = 2,3,4,6) then return 2, else return 1 mod(item_name,100) mod(item_name,1000) item_name/10 mod(item_name,10) if iand(item_name,8)<> then set to 0, else set to 1 if item_name/1000 = 0 or 2, then set to 0 = 1,3 or 4, then set to 1 > 4, then set to 2. >65535 iand(item_name,iand(func_code,65535)) For example, if a value of 100 is found in an ACODE,4 field, the function_code of 4 results in the operation item_name/10 = 100/10 = 10. Thus the data format under the ACODE,4=10 row would be used. NX Nastran DMAP Programmer’s Guide 2-5 Chapter 2 Overview of Data Blocks Approach_Code Approach_code indicates the analysis type and device type(s). 1. Analysis type is equal to approach_code/10 indicates: Type 1 2 3 4 5 6 7 8 9 10 11 Description Statics Normal modes or buckling (real eigenvalues) Differential stiffness 0 Differential stiffness 1 Frequency Transient Pre-buckling Post-buckling Complex eigenvalues Nonlinear statics 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 1 2 3 Description Print Plot Punch Therefore, MOD(approach_code,10) can be one of the following values: Value 0 1 2 3 Device type(s) None Print Plot Print and plot 2-6 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Value 4 5 6 7 Device type(s) Punch Print and punch Plot and punch Print, plot, and punch Examples: Approach_code 61 15 106 Description Print transient response results Print and punch statics results Plot and punch nonlinear statics results Table_code Table_code indicates basic table content (displacements, stresses, and so on), data format (Real or complex), and sort type (SORT1 or SORT2). 1. MOD(table_code,1000) indicates table content; displacements, stresses, and so on. Type Data Block Description Name OUG OPG OQG OEF OES LAMA OUG None OEIGS OUG OUG Description 1 2 3 4 5 6 7 8 9 10 11 Displacement Vector Load Vector SPCforce or MPCforceVector Element Force (or Flux) Element Stress (or Strain) Eigenvalue Summary Eigenvector Grid Point Singularity Table (Obsolete) Eigenvalue Analysis Summary Velocity Vector Acceleration Vector NX Nastran DMAP Programmer’s Guide 2-7 Chapter 2 Overview of Data Blocks Type Data Block Description Name OPG OGPWG OUG OUG OUG OUG OEE OGF Description 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 Nonlinear Force Vector Grid Point Weight Generator Eigenvector (Solution Set) Displacement Vector (Solution Set) Velocity Vector (Solution Set) Acceleration Vector (Solution Set) Element Strain Energy Grid Point Force Balance Stresses at grid points OES OELOF1 OELOP1 OEP OEF OGS OGS OGS OGS OGS OGS OGS OGS OGS Strain / Curvature at Grid Points Element Internal Forces and Moments Summation of Element Oriented Forces on Adjacent Elements Element Pressures Composite Failure Indices Grid Point Stresses (Surface) Grid Point Stresses (Volume – Direct) Grid Point Stresses (Volume – Principal) Element Stress Discontinuities (Surface) Element Stress Discontinuities (Volume – Direct) Element Stress Discontinuities (Volume – Principal) Grid Point Stress Discontinuities (Surface) Grid Point Stress Discontinuities (Volume – Direct) Grid Point Stress Discontinuities (Volume – Principal) 2-8 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type Data Block Description Name OGS OEE OEE OMSEC OMSED OMKEC OMKED OMECON OMEOSC OGK OBC OQG Description 35 36 37 38 39 40 41 42 43 61 62 63 Grid Point Stresses (Plane Strain) Element Kinetic Energy Element Energy Loss Constant modal strain energy Oscillating modal strain energy Constant modal kinetic energy Oscillating modal kinetic energy Constant total modal energy Oscillating total modal energy Gasket Element Results Contact Pressure and Traction Results Contact Force Results 2. Data format and sort types are extracted from the bit pattern equal to table_code/1000. Bits numbered from the right are: Bit 1 2 3 Description Complex (on) flag SORT2 (on) flag Random (on) flag Therefore, table_code/1000 can be one of the following values: Value 0 1 2 3 4 Sort type SORT1 SORT1 SORT2 SORT2 SORT1 Data format Real Complex Real Complex Real Random No No No No Yes NX Nastran DMAP Programmer’s Guide 2-9 Chapter 2 Overview of Data Blocks Value 6 Sort type SORT2 Data format Real Random Yes Examples: table_code 4 5 1005 2010 3005 6003 Description Real Force in SORT1 Real Stress/Strain in SORT1 Complex Stress/Strain in SORT1 Real Displacements in SORT2 Complex Stress/Strain in SORT2 Random SPCforces in SORT2 Format_code Format_code is somewhat redundant and can conflict with table_code. In regard to real or complex data formats, table_code/1000 always overrides format_code. However, when table_code indicates complex data, format_code is used to determine whether the output is real, real/imaginary, or magnitude/phase. Value 1 2 3 Data format Real Real/Imaginary Magnitude/Phase 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. Stress_code is a bit pattern and the bits numbered from the right are: Bit 1 Description Hencky von Mises (on) flag 2-10 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Bit 2 3 4 5 Description Strain (on) flag Strain/fiber (on) flag Same as bit 2 Material coordinate system (on) flag Therefore, stress_code can be one of the following values: Value 0 1 10 11 14 15 On bits 0000 0001 1010 1011 1110 1111 Description Stress maximum shear or octahedral Stress von Mises Strain Curvature maximum shear or octahedral Strain Curvature von Mises Strain Fibre maimum shear or octahedral Strain Fibre von Mises In the OQG data block description, stress_code can be one of the following values: Value 0 1 Description SPCForce MPCForce 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; see types 85 through 98, 100, 144, and 201 through 223. Type 00 01 02 03 ROD BEAM TUBE Name Description Grid Rod Beam Tube NX Nastran DMAP Programmer’s Guide 2-11 Chapter 2 Overview of Data Blocks Type 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 Name SHEAR FORCE1, MOMENTi Description Shear panel FORCEi/MOMENTi follower stiffness Unused (Pre-V69 CTRIA1) PLOAD4 PLOADX1 PLOAD/PLOAD2 CONROD ELAS1 ELAS2 ELAS3 ELAS4 AEROT3 AEROBEAM PLOAD4 follower stiffness PLOADX1 follower stiffness PLOAD/PLOAD2 follower stiffness Rod with properties Scalar spring Scalar spring with properties Scalar spring to scalar points only Scalar spring to scalar points only with properties Unused (Pre-V69 CTRIA2) Unused (Pre-V69 CQUAD2) Unused (Pre-V69 CQUAD1) DAMP1 DAMP2 DAMP3 DAMP4 VISC MASS1 MASS2 MASS3 MASS4 CONM1 Scalar damper Scalar damper with properties Scalar damper to scalar points only Scalar damper to scalar points only with properties Viscous damper Scalar mass Scalar mass with properties Scalar mass to scalar points only Scalar mass to scalar points only with properties Concentrated mass – general form 2-12 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 Name CONM2 PLOTEL Description Concentrated mass – rigid body form Plot Unused QUAD4 BAR CONE Quadrilateral plate with centroid force and stress recovery Simple beam (see also Type=100) Axisymmetric shell Unused (Pre-V69 CTRIARG) Unused (Pre-V69 CTRAPRG) GAP TETRA BUSH1D Gap Four-sided solid Rod type spring and damper Unused (Pre-V69 CHEXA1) Unused (Pre-V69 CHEXA2) FLUID2 FLUID3 FLUID4 FLMASS AXIF2 AXIF3 AXIF4 SLOT3 SLOT4 HBDY TRIAX6 Fluid with 2 points Fluid with 3 points Fluid with 4 points Fluid with 2 points Fluid with 3 points Fluid with 4 points Three-point slot Four-point slot Heat transfer plot for CHBDYG and CHBDYP Axisymmetric triangular Unused (Pre-V69 TRIM6) DUM3 Three-point dummy NX Nastran DMAP Programmer’s Guide 2-13 Chapter 2 Overview of Data Blocks Type 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 Name DUM4 DUM5 DUM6 DUM7 DUM8 DUM9 Description Four-point dummy Five-point dummy Six-point dummy Seven-point dummy Eight-point dummy (also two-dimensional crack tip CRAC2D) Nine-point dummy (also three-dimensional crack tip CRAC3D) Unused (Pre-V69 CQDMEM1) Unused (Pre-V69 CQDMEM2) QUAD8 Curved quadrilateral shell Unused (Pre-V69 CHEX8) Unused (Pre-V69 CHEX20) HEXA PENTA BEND TRIAR Six-sided solid Five-sided solid Curved beam or pipe Triangular plate with corner force and stress recovery Unused AEROQ4 Unused (Pre-V69 CFTUBE) TRIA3 TRIA6 HEXPR PENPR TETPR Triangular plate Curved triangular shell Acoustic velocity/pressures in six-sided solid Acoustic velocity/pressures in five-sided solid Acoustic velocity/pressures in four-sided solid Unused Unused 2-14 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 Name Description Unused QUADR HACAB HACBR TETRA GAP TUBE TRIA3 ROD QUAD4 PENTA CONROD HEXA BEAM QUAD4 QUAD8 TRIA3 TRIA6 Quadrilateral plate with corner force and stress recovery Acoustic absorber Acoustic barrier Nonlinear data recovery four-sided solid Nonlinear data recovery gap Nonlinear data recovery tube Nonlinear data recovery triangular plate Nonlinear data recovery rod Nonlinear data recovery quadrilateral plate Nonlinear data recovery five-sided solid Nonlinear data recovery rod with properties Nonlinear data recovery six-sided solid Nonlinear data recovery beam Composite data recovery quadrilateral plate Composite data recovery curved quadrilateral shell Composite data recovery triangular shell Composite data recovery curved triangular shell Unused BAR AABSF BUSH QUADP TRIAP BEAMP DAMP5 Simple beam with intermediate station data recovery Acoustic absorber with frequency dependence Generalized spring and damper p-version quadrilateral shell p-version triangular shell p-version beam Heat transfer scalar damper with material property NX Nastran DMAP Programmer’s Guide 2-15 Chapter 2 Overview of Data Blocks Type 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 Name CHBDYE CHBDYG CHBDYP CONV CONVM QBDY3 QVECT QVOL RADBC SLIF1D Description Heat transfer geometric surface – element form Heat transfer geometric surface – grid form Heat transfer geometric surface – property form Heat transfer boundary with free convection Heat transfer boundary with forced convection Heat transfer boundary heat flux load for a surface Heat transfer thermal vector flux load Heat transfer volume heat addition Heat transfer space radiation Slideline contact Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused 2-16 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 Name Description Unused Unused Unused Unused Unused Unused QUAD4FD HEXA8FD HEXAP PENTAP TETRAP QUAD144 VUHEXA VUPENTA VUTETRA Hyperelastic 4-noded quadrilateral shell Hyperelastic 8-noded solid p-version six-sided solid p-version five-sided solid p-version four-sided solid Quadrilateral plate with data recovery for corner forces and stresses p-version six-sided solid display p-version five-sided solid display p-version four-sided solid display Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused NX Nastran DMAP Programmer’s Guide 2-17 Chapter 2 Overview of Data Blocks Type 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 Name Description Unused PENTA6FD TETRA4FD TRIA3FD HEXAFD QUADFD PENTAFD TETRAFD TRIAFD TRIAX3FD TRIAXFD QUADX4FD QUADXFD Hyperelastic pentahedron 6-noded Hyperelastic tetrahedron 4-noded Hyperelastic triangular 3-noded Hyperelastic hexahedron 20-noded Hyperelastic quadrilateral 9-noded Hyperelastic pentahedron 15-noded Hyperelastic tetrahedron 10-noded Hyperelastic triangular 6-noded Hyperelastic axisymmetric triangular 3-noded Hyperelastic axisymmetric triangular 6-noded Hyperelastic axisymmetric quadrilateral 4-noded Hyperelastic axisymmetric quadrilateral 9-noded Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused 2-18 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 Name Description Unused Unused Unused Unused VUQUAD VUTRIA VUBEAM CVINT p-version quadrilateral shell display p-version triangular shell display p-version beam display Curve interface Unused Unused Unused Unused SFINT CNVPEL VUHBDY CWELD QUAD4FD HEXA8FD SLIF1D? PENTA6FD TETRA4FD TRIA3FD HEXAFD Surface interface p-version HBDY display Weld or fastener Hyperelastic quadrilateral 4-noded nonlinear d.r. Gaus/Grid Hyperelastic hexahedron 8-noded nonlinear d.r. Gaus/Grid Slideline contact Hyperelastic pentahedron 6-noded nonlinear format Gaus/Grid Hyperelastic tetrahedron 4-noded nonlinear format Gaus Hyperelastic triangular 3-noded nonlinear format Gaus Hyperelastic hexahedron 20-noded nonlinear format Gaus NX Nastran DMAP Programmer’s Guide 2-19 Chapter 2 Overview of Data Blocks Type 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 Name QUADFD PENTAFD TETRAFD TRIAFD TRIAX3FD TRIAXFD QUADX4FD QUADXFD TETRA4FD TRIA3FD HEXAFD QUADFD PENTAFD TETRAFD TRIAX3FD QUADXFD ELAS1 ELAS3 BUSH Description Hyperelastic quadrilateral 8-noded nonlinear format Gaus Hyperelastic pentahedron 15-noded nonlinear format Gaus Hyperelastic tetrahedron 10-noded nonlinear format Grid Hyperelastic triangular 6-noded nonlinear format Gaus/Grid Hyperelastic axisymmetric triangular 3-noded nonlinear format Gaus Hyperelastic axisymmetric triangular 6-noded nonlinear format Gaus/Grid Hyperelastic axisymmetric quadrilateral 4-noded nonlinear format Gaus/Grid Hyperelastic axisymmetric quadrilateral 8-noded nonlinear format Gaus Hyperelastic tetrahedron 4-noded nonlinear format Grid Hyperelastic triangular 3-noded nonlinear format Grid Hyperelastic hexahedron 20-noded nonlinear format Grid Hyperelastic quadrilateral 8-noded nonlinear format Grid Hyperelastic pentahedron 15-noded nonlinear format Grid Hyperelastic tetrahedron 10-noded nonlinear format Gaus Hyperelastic axisymmetric triangular 3-noded nonlinear format Grid Hyperelastic axisymmetric quadrilateral 8-noded nonlinear format Grid Nonlinear ELAS1 Nonlinear ELAS3 Nonlinear BUSH 2-20 NX Nastran DMAP Programmer’s Guide Overview of Data Blocks Type 227 228 229 230 231 232 233 234 235 236 237 238 239 Name TRIAR QUADR Description New quadrilateral plate with data recovery for center forces and stresses New quadrilateral plate with data recovery for center forces and stresses Reserved Reserved Reserved QUADR – Composite TRIAR – Composite Composite data recovery for new quadrilateral plate Composite data recovery for new quadrilateral plate Reserved Reserved Reserved Reserved Reserved Reserved NX Nastran DMAP Programmer’s Guide 2-21 Chapter 3 Data Block Descriptions B-E • • • • • • • • • • • • • • • • • • • • BGPDT BGPDT68 CASECC CLAMA CONTAB CONTACT CSTM CSTM68 DBCOPT DESTAB DIT DSCMCOL DVPTAB DYNAMIC EGPSF EGPSTR ELDCT EPT EQEXIN ERROR NX Nastran DMAP Programmer’s Guide 3-1 Chapter 3 Data Block Descriptions B-E 3.1 BGPDT 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 Basic grid point definition table Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – DATA Word 1 2 3 4 5 6 7 8 9 Name CID SIL EXTID DOF_TYPE PSC BGID XCOORD YCOORD ZCOORD Type I I I I I I RX RX RX Description Coordinate system identification number Internal (scalar) identification number External (User) identification number Degree of freedom/Point Type Permanent Set Constraint Boundary Grid ID of –EXTID x in basic coordinate system y in basic coordinate system z in basic coordinate system Words 1 through 9 repeat until End of Record Record 2 – XIDMAP Word 1 2 Name EXTID INTID Type I I Description External identification number Internal identification number Words 1 through 2 repeat until End of Record 3-2 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 3 – BIDMAP Word 1 2 Name BGID INTID Type I I Description Boundary (System) identification number Internal identification number Words 1 through 2 repeat until End of Record Record 4 – NORMAL Word 1 2 3 Name XNORM YNORM ZNORM Type RX RX RX Description X normal in aerodynamic system Y normal in aerodynamic system Z normal in aerodynamic system Words 1 through 3 repeat until End of Record Record 5 – TRAILER Word 1 2 3 4 5 6 Name WORD1 WORD2 WORD3 WORD4 WORD5 WORD6 Type I I I I I I Description Number of grid points and scalar points Number of boundary points Number of degrees-of-freedom Precision of the real values; for example, type=RX Number of scalar points Maximum external identification number 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, the number of boundary grids, is zero, record BIDMAP does not exist and XIDMAP is used. 4. When grid point data is written to an OP2 file, by default the MAKEOLD module will convert the grid point data to BGPDT68 format (see format below). PARAM,OMACHPR,YES can NX Nastran DMAP Programmer’s Guide 3-3 Chapter 3 Data Block Descriptions B-E be included in the input file to prevent this conversion, but be aware that post processors may not recognize the BGPDT format as described above. 3.2 BGPDT68 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 Basic grid point definition table (Pre-Version 69) Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – DATA Word 1 2 3 4 Name CID XCOORD YCOORD ZCOORD Type I RS RS RS Description Coordinate system identification number x in basic coordinate system y in basic coordinate system z in basic coordinate system Words 1 through 4 repeat until End of Record Record 2 – TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of grid and scalar points Notes: 1. Scaler points are identified by CID=-1 and XCOORD = YCOORD = ZCOORD = 0. 2. When the BGPDT68 datablock is written by the MAKEOLD module, the data is named BGPDT although the BGPDT68 format is written. 3.3 CASECC Case control information 3-4 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – REPEAT Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name SID MPCSET SPCSET ESLSET REESET ELDSET THLDSET THMATSET TIC NONPTSET NONMEDIA NONFMT DYMLDSET FEQRESET TFSET SYMFLG LDSPTSET LDSMEDIA LDSFMT Type I I I I I I I I I I I I I I I I I I I Description Subcase identification number Multipoint constraint set (MPC) Single point constraint set (SPC) External static load set (LOAD) Real eigenvalue extraction set (METHOD(STRUCTURE)) Element deformation set (DEFORM) Thermal load set (TEMP(LOAD)) Thermal material set TEMP(MAT or INIT) Transient initial conditions (IC) Nonlinear load output set (NLLOAD) Nonlinear load output media (NLLOAD) Nonlinear load output format (NLLOAD) Dynamic load set (DLOAD) Frequency response set (FREQUENCY) Transfer function set (TFL) Symmetry flag (SYMSEQ and SUBSEQ) Load output set (OLOAD) Load output media (OLOAD) Load output format (OLOAD) NX Nastran DMAP Programmer’s Guide 3-5 Chapter 3 Data Block Descriptions B-E Word 20 21 22 23 24 25 26 27 28 29 30 31 32 33 Name DPLPTSET DPLMEDIA DPLFMT STSPTSET STSMEDIA STSFMT FCEPTSET FCEMEDIA FCEFMT ACCPTSET ACCMEDIA ACCFMT VELPTSET VELMEDIA Type I I I I I I I I I I I I I I Description Displ., temp., or pressure output set (DISP,THERM,PRES) Displ., temp., or pressure output media (DISP,THERM,PRES) Displ., temp., or pressure output format (DISP,THERM,PRES) Stress output set (STRESS) Stress output media (STRESS) Stress output format (STRESS) Force (or flux) output set (FORCE or FLUX) Force (or flux) output media (FORCE or FLUX) Force (or flux) output format (FORCE or FLUX) Acceleration (or enthalpy delta) output set (ACCEL or HDOT) Acceleration (or enthalpy delta) output media (ACCE, HDOT) Acceleration (or enthalpy delta) output format (ACCE, HDOT) Velocity (or enthalpy) output set (VELOCITY or ENTHALPY) Velocity (or enthalpy) output media (VELOCITY) or ENTHALPY) Velocity (or enthalpy) output format (VELOCITY) or ENTHALPY) Forces of single-point constraint output set (SPCFORCE) Forces of single-point constraint output media (SPCFORCE) 34 VELFMT I 35 36 FOCPTSET FOCMEDIA I I 3-6 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 37 38 39 Word 71 103 135 136 137 138 139 141 143 145 146 147 148 149 Name FOCFMT TSTEPTRN TITLE(32) Name SUBTITLE(32) LABEL(32) STPLTFLG AXSYMSET NOHARMON TSTRV K2PP(2) M2PP(2) B2PP(2) OUTRESPV SEDR FLDBNDY CEESET DAMPTBL Type I I CHAR4 Type CHAR4 CHAR4 I I I I CHAR4 CHAR4 CHAR4 I I I I I Description Forces of single-point constraint output format (SPCFORCE) Time step set for transient analysis (TSTEP) Title character string (TITLE) Description Subtitle character string (SUBTITLE) LABEL character string (LABEL) Model plot flag: set to 1 if OUTPUT(PLOT) is specified Axisymmetric set (AXISYMMETRIC) Number of harmonics to output (HARMONICS) Need definition Name of direct input (p-set) stiffness matrix (K2PP) Name of direct input (p-set) mass matrix (M2PP) Name of direct input (p-set) damping matrix (B2PP) Output frequencies or times (OFREQ or OTIME) Data recovery superelement list (SEDR) Fluid boundary element selection (MFLUID) Complex eigenvalue extraction set (CMETHOD) Structural damping table set (SDAMP(STRUCT) NX Nastran DMAP Programmer’s Guide 3-7 Chapter 3 Data Block Descriptions B-E Word 151 152 153 154 155 156 157 158 159 Name SSDSET SSDMEDIA SSDFMT SSVSET SSVMEDIA SSVFMT SSASET SSAMEDIA SSAFMT Type I I I I I I I I I Description Solution set displacements output set (SDISP) Solution set displacements output media (SDISP) Solution set displacements output format (SDISP) Solution set velocities output set (SVELO) Solution set velocities output media (SVELO) Solution set velocities output format (SVELO) Solution set accelerations output set (SACCE) Solution set accelerations output media (SACCE) Solution set accelerations output format (SACCE) Description Nonlinear load set in transient problems (NONLINEAR) Partitioning set (PARTN) Symmetry option in cyclic symmetry (DSYM) Random analysis set (RANDOM) Nonlinear static analysis control parameters (NLPARM) Flutter set (FMETHOD) Number of words in this record up to LSEM Grid point force output set (GPFORCE) Word 160 161 162 163 164 165 166 167 Name NONLINLD PARTIT CYCLIC RANDOM NONPARAM FLUTTER LCC GPFSET Type I I I I I I I I 3-8 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 168 169 170 171 172 173 174 175 176 177 178 179 Name GPFMEDIA GPFFMT ESESET ESEMEDIA ESEFMT ARFPTSET ARFMEDIA ARFFMT SEID LCN GUST SEFINAL Type I I I I I I I I I I I I Description Grid point force output media (GPFORCE) Grid point force output format (GPFORCE) Strain energy output set (ESE) Strain energy output media (ESE) Strain energy output format (ESE) Aerodynamic force output set (AEROF) Aerodynamic force output media (AEROF) Aerodynamic force output format (AEROF) Superelement ID (SUPER) Load column number (SUPER) Gust load selection (GUST) Final Superelement ID (SEFINAL) Description Generate matrices (K,M,B,K4) for superelement set or ID (SEMG) Reduce stiffness matrix (K) for superelement set or ID (SEKR) Generate static loads for superelement set or ID (SELG) Reduce static loads for superelement set or ID (SELR) Superelement set or ID to be excluded (SEEXCLUDE) Word 180 Name SEMG Type I 181 182 183 184 SEKR SELG SELR SEEX I I I I NX Nastran DMAP Programmer’s Guide 3-9 Chapter 3 Data Block Descriptions B-E Word 185 187 189 191 192 193 194 195 196 197 Name K2GG(2) M2GG(2) B2GG(2) SVSET SVMEDIA SVFMT FLUPTSET FLUMEDIA FLUFMT HOUT(3) Type CHAR4 CHAR4 CHAR4 I I I I I I I Description Name of direct input (g-set) stiffness matrix (K2GG) Name of direct input (g-set) stiffness matrix (M2GG) Name of direct input (g-set) stiffness matrix (B2GG) Solution eigenvector output set (SVECTOR) Solution eigenvector output media (SVECTOR) Solution eigenvectors output format (SVECTOR) Fluid pressure output set (MPRES) Fluid pressure output media (MPRES) Fluid pressure output format (MPRES) Cyclic symmetry harmonic output (HOUTPUT) Description Cyclic symmetry physical output (NOUTPUT) Name of direct input (g-set) static loads matrix (P2G) Sequence of static loads sets (LOADSET) Generate matrices (M,B,K4) for superelement set or ID (SEMG) von Mises fiber (STRESS) Superelement command existence flag Grid point stress output set (GPSTRESS) Word 200 203 205 206 207 208 209 Name NOUT(3) P2G(2) LOADSET SEMR VONMISES SECMDFLG GPSPTSET Type I CHAR4 I I I I I 3-10 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 210 211 212 213 214 215 216 217 218 219 Name GPSMEDIA GPSFMT STFSET STFMEDIA STFFMT CLOAD SET2ID DSAPRT DSASTORE DSAOUTPT Type I I I I I I I I I I Description Grid point stress output media (GPSTRESS) Grid point stress output format (GPSTRESS) Grid point stress field output set (STRFIELD) Grid point stress field output media (STRFIELD Grid point stress field output format (STRFIELD) Superelement static load combination set (CLOAD) Old design sensitivity contraint and variable set (SET2) Old design sensitivity analysis print option (SENSITY) Old design sensitivity analysis store option (SENSITY) Old design sensitivity analysis OUTPUT4 option (SENSITY) Description Strain output set (STRAIN) Strain output media (STRAIN) Strain output format (STRAIN) Aerodynamic pressure output set (APRESSURE) Aerostatic trim variable constrain set (TRIM) Output modes list set (OMODES) Real eigenvalue extraction set for fluid (METHOD(FLUID)) Word 220 221 222 223 224 225 226 Name STNSET STNMEDIA STNFMT APRESS TRIM MODLIST REESETF Type I I I I I I I NX Nastran DMAP Programmer’s Guide 3-11 Chapter 3 Data Block Descriptions B-E Word 227 228 229 230 231 232 233 Name ESDPTSET ESDMEDIA ESDFMT GSDPTSET GSDMEDIA GSDFMT SEDV Type I I I I I I I Description Element stress discontinuity output set (ELSDCON) Element stress discontinuity output media (ELSDCON) Element stress discontinuity output format (ELSDCON) Grid point stress discontinuity output set (GPSDCON) Grid point stress discontinuity output media (GPSDCON) Grid point stress discontinuity output format (GPSDCON) Generate pseudo-loads for superelement set or identification number (SEDV) Generate responses for superelement set or ID (SERESP) Restart processing for superelement set or ID (SERS) Slideline contact output set (BOUTPUT) Slideline contact output media (BOUTPUT) Slideline contact output format (BOUTPUT) Aerostatic divergence control parameter set (DIVERG) Description P-element output control parameters (OUTRCV) Static subcase identification number for pre-load (STATSUB(PRELOAD)) 234 SERE I 235 236 237 238 239 SERS CNTSET CNTMEDIA CNTFMT DIVERG I I I I I Word 240 241 Name OUTRCV STATSUBP Type I I 3-12 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 242 Name MODESELS Type I Description Mode selection set identification number for the structure (MODESELECT) Mode selection set identification number for the fluid (MODESELECT) Solution sequence number SOL 601 analysis option (106 or 129) P-element adaptivity control parameter set (ADAPT) Design objective set (DESOBJ) Design constraint set for current subcase (DESSUB) Design constraint span set (DRSPAN) Design constraint set for all subcases (DESGLB) Type of analysis (ANALYSIS) CQUAD4 grid point corner stress option (STRESS) CQUAD4 grid point corner force option (STRESS) CQUAD4 grid point corner strain option (STRESS) Supported degree-of-freedom set (SUPORT1) Static subcase ID for buckling (STATSUB(BUCKLE)) Boundary condition ID (BC) Auxiliary model ID (AUXMODEL) P-element adaptivity active subcase flag (ADACT) 243 MODESELF I 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 SOLNUM ANLOPT ADAPT DESOBJ DESSUB SUBSPAN DESGLB ANALYSIS GPQSTRS GPQFORC GPQSTRN SUPORT1 STATSUBB BCID AUXMODEL ADACT I I I I I I I CHAR4 I I I I I I I I NX Nastran DMAP Programmer’s Guide 3-13 Chapter 3 Data Block Descriptions B-E Word 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 Name DATSET DATMEDIA DATFMT VUGSET VUGMEDIA VUGFMT MPCFSET MPCMEDIA MPCFFMT REUESET DAMPTBLF ITERMETH NLSSET NLSMEDIA NLSFMT MODTRKID DSAFORM Type I I I I I I I I I I I I I I I I I Description P-element output set (DATAREC) P-element output media (DATAREC) P-element output format (DATAREC) View-grid and element output set (VUGRID) View-grid and element output media (VUGRID) View-grid and element output format (VUGRID) Forces of multipoint constraint output set (MPCFORCE) Forces of multipoint constraint output media (MPCFORCE) Forces of multipoint constraint output format (MPCFORCE) Real unsymmetric eigenvalue extraction set (UMETHOD) Structural damping table set for the fluid (SDAMP(FLUID) Iterative solver control parameters (SMETHOD) Nonlinear stress output set (NLSTRESS) Nonlinear stress output media (NLSTRESS) Nonlinear stress output format (NLSTRESS) Mode tracking control parameter set (MODTRAK) Design sensitivity output format: 1=yes,2=no (DSAPRT) 3-14 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 277 278 279 Name DSAEXPO DSABEGIN DSAINTVL Type I I I Description Design sensitivity output export: 1=no,2=yes (DSAPRT) Design sensitivity output start iteration (DSAPRT) Design sensitivity output interval (DSAPRT) Description Design sensitivity output final iteration (DSAPRT) Design sensitivity output set (DSAPRT) Overall SORT1/SORT2 flag: 1 means SORT1 and 2 means SORT2. Random analysis request bit pattern (DISP,VELO, and so on) Aerodynamic configuration name Symmetry flag for aerodynamic xy plane Symmetry flag for aerodynamic xz plane Word 280 281 282 Name DSAFINAL DSASETID SORTFLG Type I I I 283 284 286 287 288 289 290 291 292 293 294 RANDBIT AECONFIG(2) AESYMXY AESYMXZ UNDEF UNDEF UNDEF GPEPTSET GPEMEDIA GPEFMT ESETHRSH I CHAR4 I I None None None I I I RS Grid point strain output set (GPSTRAIN) Grid point strain output media (GPSTRAIN) Grid point strain output format (GPSTRAIN) Element strain energy threshold (ESE) NX Nastran DMAP Programmer’s Guide 3-15 Chapter 3 Data Block Descriptions B-E Word 295 296 297 298 299 Name AECSSSET EKEPTSET EKEMEDIA EKEFMT EKETHRSH Type I I I I RS Description Aerodynamic Control Surface Schedule (CSSCHD) Element kinetic energy output set (EKE) Element kinetic energy media (EKE) Element kinetic energy format (EKE) Element kinetic energy threshold (EKE) Description Element damping energy output set (EDE) Element damping energy media (EDE) Element damping energy format (EDE) Element damping energy threshold (EDE) Word 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 Name EDEPTSET EDEMEDIA EDEFMT EDETHRSH UNDEF UNDEF UNDEF UNDEF UNDEF UNDEF UNDEF UNDEF UNDEF UNDEF EFFMASET Type I I I RS None None None None None None None None None None I Modal effective mass output set (MEFFMASS) 3-16 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 315 316 317 318 319 Word 320 321 322 323 324 325 326 327 328 329 330 331 332 333 Name EFFMAGID EFFMATHR UNDEF UNDEF RCRSET Name RCRFMT AEUXREF GCHK GCHKOUT GCHKSET GCHKGID GCHKTHR GCHKRTHR GCHKDREC ASPCMED ASPCEPS ASPCPRT ASPCPCH UNDEF(2) Type I RS None None I Type I I I I I I RS RS I I RS I I None Description Modal effective mass GID (MEFFMASS) Modal effective mass threshold (MEFFMASS) RCROSS output set Description RCROSS format AEUXREF Ground Check Flag (GROUNDCHECK) Ground Check Output (GROUNDCHECK) Ground Check Set (GROUNDCHECK) Ground Check Gid (GROUNDCHECK) Ground Check Thresh (GROUNDCHECK) Ground Check RThresh (GROUNDCHECK) Ground Check Data recovery (GROUNDCHECK) Output Media Request (AUTOSPC) EPS value for fixup (AUTOSPC) EPS value for printing (AUTOSPC) Punch Set Id (AUTOSPC) NX Nastran DMAP Programmer’s Guide 3-17 Chapter 3 Data Block Descriptions B-E Word 335 336 337 338 339 Word 340 341 342 Name NK2PP NM2PP NB2PP NK2GG NM2GG Name NB2GG NP2G GEODSET Type I I I I I Type I I I Description Internal set id for K2PP Internal set id for M2PP Internal set id for B2PP Internal set id for K2GG Internal set id for M2GG Description Internal set id for B2GG Internal set id for P2G Geometry Check DISP Set identification number (GEOMCHECK) Geometry Check DISP Max/Min (GEOMCHECK) Geometry Check DISP Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of DISP Max/Min Output (GEOMCHECK) Geometry Check OLOAD Set identification number (GEOMCHECK) Geometry Check OLOAD Max/Min (GEOMCHECK) Geometry Check OLOAD Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of OLOAD Max/Min Output (GEOMCHECK) Geometry Check SPCF Set identification number (GEOMCHECK) 343 344 GEODMXMN GEODOCID I I 345 GEODNUMB I 346 GEOLSET I 347 348 GEOLMXMN GEOLOCID I I 349 GEOLNUMB I 350 GEOSSET I 3-18 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 351 352 Name GEOSMXMN GEOSOCID Type I I Description Geometry Check SPCF Max/Min (GEOMCHECK) Geometry Check SPCF Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of SPCF Max/Min Output (GEOMCHECK) Geometry Check MPCF Set identification number (GEOMCHECK) Geometry Check MPCF Max/Min (GEOMCHECK) Geometry Check MPCF Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of MPCF Max/Min Output (GEOMCHECK) Geometry Check ACCE Set identification number (GEOMCHECK) Geometry Check ACCE Max/Min (GEOMCHECK) Description Geometry Check ACCE Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of ACCE Max/Min Output (GEOMCHECK) Geometry Check VELO Set identification number (GEOMCHECK) Geometry Check VELO Max/Min (GEOMCHECK) 353 GEOSNUMB I 354 GEOMSET I 355 356 GEOMMXMN GEOMOCID I I 357 GEOMNUMB I 358 GEOASET I 359 GEOAMXMN I Word 360 Name GEOAOCID Type I 361 GEOANUMB I 362 GEOVSET I 363 GEOVMXMN I NX Nastran DMAP Programmer’s Guide 3-19 Chapter 3 Data Block Descriptions B-E Word 364 Name GEOVOCID Type I Description Geometry Check VELO Max/Min Output Cor. Sys. (GEOMCHECK) Geometry Check No. of VELO Max/Min Output (GEOMCHECK) Internal set id for TFL BCONTACT Set identification number Grid point kinetic energy output set (GPKE) Grid point kinetic energy media (GPKE) Grid point kinetic energy format (GPKE) Element Summary Output (ELSUM) Weight Check Flag (WEIGHTCHECK) Weight Check Output (WEIGHTCHECK) Weight Check Set identification number (WEIGHTCHECK) Weight Check GID (WEIGHTCHECK) Weight Check CGI (WEIGHTCHECK) Weight Check Weight/Mass units (WEIGHTCHECK) External Superelement Output items (EXTSEOUT) External Superelement output media (EXTSEOUT) External Superelement Unit (EXTSEOUT) 365 GEOVNUMB I 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 NTFL BCONTACT GPKESET GPKEMEDI GPKEFMT ELMSUM WCHK WCHKOUT WCHKSET WCHKGID WCHKCGI WCHKWM EXSEOUT EXSEMED EXSEUNIT I I I I I I I I I I I I I I I 3-20 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 381 382 383 Name EXSERES1 EXSERES2 K42GG(2) Type I I CHAR4 Description External Superelement Reserved (EXTSEOUT) External Superelement Reserved (EXTSEOUT) Name of direct input (g-set) structural damping matrix K42GG Internal set id for K42GG 385 386 NK42GG UNDEF(13) Name CHECK ADMOUT FLEXBODY FLEXONLY MINVAR PSETID OUTGSTRS OUTGSTRN FLEXBODY FLEXONLY MINVAR PSETID OUTGSTRS OUTGSTRN I None Word 399 400 401 402 403 404 405 406 407 408 409 410 411 412 Type I I I I I I I I I I I I I I Description ADAMSMNF CHECK flag ADAMSMNF ADMOUT flag ADAMSMNF FLEXBODY flag ADAMSMNF FLEXONLY flag ADAMSMNF MINVAR parameter ADAMSMNF PSETID parameter ADAMSMNF OUTGSTRS flag ADAMSMNF OUTGSTRN flag RECURDYNRFI FLEXBODY flag RECURDYNRFI FLEXONLY flag RECURDYNRFI MINVAR parameter RECURDYNRFI PSETID parameter RECURDYNRFI OUTGSTRS flag RECURDYNRFI OUTGSTRN flag NX Nastran DMAP Programmer’s Guide 3-21 Chapter 3 Data Block Descriptions B-E Word 413 414 415 416 417 418 419 420 421 426 427 428 429 430 432 433 434 435 436 437 438 439 440 Name BCSET BCRESU BCMEDIA BCFMT BCTYPE GKRESU GKMEDIA GKFMT UNDEF(5) RSMETHOM ESE MDESET MDEMEDI UNDEF(2) MDEFMT UNDEF MDECMPT MDESORT MDETYPE MDECALC RMETSET RIGID BOLTPRE Type I I I I I I I I None I I I I None I None I I I I I I I Description Contact Set ID Contact results output Contact results media code Contact results format code Traction=1, Force=2, Both=3 Gasket results output Gasket results media code Gasket results format code RSMETHOD parameter ESE parameter Modal energy output set (MODALE) Modal energy media (MODALE) Modal energy output format (MODALE) Modal energy computation set (MODALE) Modal energy sort flag (MODALE) Modal energy type flag (MODALE) Modal energy calculation flag (MODALE) RMETHOD set id Rigid element type Bolt preload set 3-22 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 Word 600 601 Name BGSET MODCON IPRPU ADMCHK MODSEL ADMREC ADMFORM MSRMODE RGBODY MSGLVL EBDSET SHELLTHK STMEDIA STFMT UNDEF(145) Name LSEM(C) COEF Type I I I I I I I I I I I I I I None Type I RS Description Glue set id Modal contribution flag RANDOM print/punch option ADMRECVR ADMCHK flag Rotor dynamics mode set ADMRECVR activation flag ADMRECVR ADMFORM parameter ADMRECVR MSRMODE parameter ADMRECVR RGBODY flag ADMRECVR MSGLVL parameter Element birth/death set Shell thickness results output flag Shell thickness results media code Shell thickness results format code Description Number of symmetry subcase coefficients from item SYMFLG Symmetry subcase coefficients (SUBSEQ or SYMSEQ) Word 601 repeats LSEM times 602 603 SETID SETLEN(C) I I Set identification number Length of this set NX Nastran DMAP Programmer’s Guide 3-23 Chapter 3 Data Block Descriptions B-E Word 604 Name SETMEM Type I Description Set member identification number Word 604 repeats SETLEN times Words 602 through 604 repeat NSETS times 605 606 607 608 610 PARLEN =8 612 PARLEN =9 612 613 PARLEN =10 612 613 614 615 PARLEN =12 612 613 614 615 End PARLEN RTYPE REAL ITYPE IMAG RTYPE REAL ITYPE IMAG TYPE REAL INTEGER PARA PARLEN(C) CHTYPE(C) PARAM(2) PNAME(2) CHAR4 I I CHAR4 CHAR4 Length I Integer value Hard-coded to "PARA" Length of this parameter value specification Character type flag: 3 means character, 2 otherwise Hard-coded to "PARA" and "M " Name of parameter Real-double parameter value I RD Real type - hard-coded to -4 Real-double value Complex-single parameter value I RS I RS Real part type - hard-coded to -2 Real part value Imaginary part type hard-coded to -2 Imaginary part value Complex-double parameter value I RD I RD Real part type - hard-coded to -4 Real part value Imaginary part type hard-coded to -4 Imaginary part value 3-24 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word Name Type Description Words 605 through max repeat until NANQ occurs Words 605 through 615 repeat until End of Record Record 2 – TRAILER Word 1 2 3 4 5 Name WORD1 WORD2 WORD3 WORD4 UNDEF(2) Type I I I I None Description Number of records Number of records Maximum record length Plot flag Notes: 1. Possible values for output media (___MEDIA) are: • • • 1 = print 2 = plot 4 = punch and their sums; for example, 3 indicates print and plot. 2. Possible values for SORT1 output format (___FMT) are: • • • 1 = real 2 = real/imaginary 3 = magnitude/phase For SORT2, the same values are negative. 3. Possible values for SYMFLG are: • • • 0 = no symmetry -1 = REPCASE and N = number of SYMSEQ or SUBSEQ coefficients 4. Possible values for DSAPRT are: • 1 = Print (default) NX Nastran DMAP Programmer’s Guide 3-25 Chapter 3 Data Block Descriptions B-E • 0 = No print 5. Possible values for DSASTORE are: • • 1 = Store on data base and 0 = Don’t store on data base (default) 6. Possible values for DSAOUTPT are: • • 1 = Store via OUTPUT2 and 0 = Don’t store via OUTPUT2 (default) 7. Possible values for AXSYMSET are: • • 1 = Sine 2 = Cosine or fluid 8. Possible values for the SECMDFLG are: • • 0 = at least one of SEMG, SEKR, SEMR, SELG, SELR or SEALL is specified -1 = None are specified 9. DSAFINAL=-1 means the last iteration. 10. DSASETID=-1 means the all design sensitivities. 11. RANDBIT contains bit pairs for the selection of PSDF and ATOC beginning with left handed bits 1 and 2 for DISP and continuing with VELO, ACCE, OLOAD, SPCF, STRESS, FORCE, STRAIN, and MPCF Case Control commands for bits 3 through 18. The bit pair value of "00" means none, "01" means ATOC, "10" means PSDF, and "11" means RALL. 12. Possible values for AESYMXY and AESYMXZ are: • • • 2 = antisymmetric 3 = asymmetric 4 = antisymmetric 3.4 CDDATA Campbell diagram data table. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name 3-26 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 1 – List of rotor speeds Word 1 2 3 Name NVAL KEYW ROTS(NVAL) Type I I RS Description Number of values Keyword=10001 List of rotor speeds Record 2 – List of eigenfrequencies in the analysis system Word 1 2 3 Name NVAL KEYW EIGF(NVAL) Type I I RS Description Number of values Keyword=20000+SOLN, where SOLN=solution number Eigenfrequencies for solution SOLN Words 2 and 3 repeat of all solutions. Record 3 – List of Lehr damping values Word 1 2 3 Name NVAL KEYW DAMP(NVAL) Type I I RS Description Number of values Keyword=30000+SOLN, where SOLN=solution number Damping values for solution SOLN Words 2 and 3 repeat of all solutions. Record 4– List of real eigenvalues Word 1 2 3 Name NVAL KEYW EIGV(NVAL) Type I I RS Description Number of values Keyword=40000+SOLN, where SOLN=solution number Eigenvalues for solution SOLN Words 2 and 3 repeat of all solutions. NX Nastran DMAP Programmer’s Guide 3-27 Chapter 3 Data Block Descriptions B-E Record 5 – List of whirl direction codes (2.0=backwords, 3.0 forward, 4.0=linear) Word 1 2 3 Name NVAL KEYW WHRD(NVAL) Type I I RS Description Number of values Keyword=50000+SOLN, where SOLN=solution number Whirl direction codes for solution SOLN Words 2 and 3 repeat of all solutions. Record 6 – List of converted frequencies in analysis system Word 1 2 3 Name NVAL KEYW FREQ(NVAL) Type I I RS Description Number of values Keyword=60000+SOLN, where SOLN=solution number Converted frequencies for solution SOLN Words 2 and 3 repeat of all solutions. Record 7– List of whirl direction codes for converted solution (2.0=backwords, 3.0 forward, 4.0=linear) Word 1 2 3 Name NVAL KEYW CWHRD Type I I RS Description Number of values Keyword=70000+SOLN, where SOLN=solution number Whirl direction codes for solution SOLN Words 2 and 3 repeat of all solutions. Record 8 – TRAILER Word 1 2 Name WORD1 UNDEF(5) Type I none Description Number of rotor speeds 3-28 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E 3.5 CLAMA Complex eigenvalue summary table Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – OFPID Word 1 3 10 11 51 83 115 Name RECID(2) UNDEF(7 ) SIX UNDEF(40 ) TITLE(32) SUBTITLE(32) LABEL(32) Type I None I None CHAR4 CHAR4 CHAR4 Title character string (TITLE) Subtitle character string (SUBTITLE) LABEL character string (LABEL) Constant 6 Description Constants 90 and 1006 Record 2 – LAMA Repeats for each eigenvalue. Word 1 2 3 4 5 6 Name MODE ORDER REIGEN IEIGEN FREQ DAMP Type I I RS RS RS RS Description Mode number Extraction order Eigenvalue – real part Eigenvalue – imaginary part Frequency: ABS(IEIGEN)/(2*Pi) Damping Coefficient: (-2*REIGEN)/ABS(IEIGEN) Record 3 – TRAILER Word 1 Name WORD1 Type I Description 1006 NX Nastran DMAP Programmer’s Guide 3-29 Chapter 3 Data Block Descriptions B-E Word 2 5 6 Name UNDEF(3 ) SIX UNDEF Type None I None Description Constant 6 3.6 CONTAB Design constraint table Contains a record for each design constraint. Records are sorted by the internal constraint identification number. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – Repeat – Repeated for each design constraint Word 1 2 3 4 5 6 7 8 9 Name IDCID DCID IRID RTYPE TYPE LUFLAG BOUND REGION SCID Type I I I I I I RS I I Description Internal design constraint identification number DCONSTR Bulk Data entry identification number Internal response identification number Response type Type of response (1 or 2) Bound Type (1=lower,2=upper) Bound value Internal region identification number Subcase identification number Record 2 – TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of records; that is, design constraints 3-30 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E 3.7 CONTACT Table of Bulk Data entry related to surface contact Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – BCMATL (7310,73,590) Word 1 2-n N+1 Name ID IPi -1 Type I I I Description Identification number Material ID Delimiter Record 2– BCPROP (7210,72,589) Word 1 2-n N+1 Name ID IPi -1 Type I I I Description Identification number Material ID Delimiter Record 3– BCRPARA (7710,77,594) Word 1 2 3 4 5 Name CRID SURF OFFSET TYPE MGP Type I I RS I I Description Region ID TOP=1, BOT=2 ≥ 0.0 offset distance FLEX=1, RIGID=2 Master grid point Record 4– BCTADD (7510,75,592) Word 1 Name CSID Type I Description Combined contact set ID NX Nastran DMAP Programmer’s Guide 3-31 Chapter 3 Data Block Descriptions B-E Word 2-n N+1 Name Si -1 Type I I Description Contact set ID Delimiter Record 5– BCTPARA (7610,76,593) Note: entry 2-5 repeats for each parameter Word 1 2-3 4 5 6 Name CSID Param(i) TYPE Value(i) -1 Type I CHAR4 I I or RS I Description Contact set ID Parameter name Parameter data type Parameter value Delimiter Record 6– BCTPARM (8110,81,598) Note: entry 2-5 repeats for each parameter Word 1 2-3 4 5 6 Name CSID Param(i) TYPE Value(i) -1 Type I CHAR4 I I or RS I Description Contact set ID Parameter name Parameter data type Parameter value Delimiter Record 7– BCTSET (7410,74,591) Note: entry 2-6 repeats for each additional region pair. Word 1 2 3 Name CSID SIDi TIDi Type I I I Description Contact set ID Source region ID Target region ID 3-32 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 5 6 7 Name FRICi MIND MAXD -1 Type RS RS RS I Description Coefficient of Friction Minimum search distance Maximum search distance Delimiter Record 8– BSURF (724,7,441) Word 1 2-n N+1 Name ID EIDi -1 Type I I I Description Identification number Element ID Delimiter Record 9 – BSURFS (7110,71,588) Note: entry 2-5 repeats for each element/grids Word 1 2 3-5 6 Name ID EIDi G1 - G3 -1 Type I I I I Description Identification number Element ID Grid point ID Delimiter Record 10 – NXSTRAT (7810,78,595) Note: entry 2-5 repeats for each parameter Word 1 2-3 4 5 6 Name ID Param (i) TYPE Value(i) -1 Type I CHAR4 I I or RS I Description ID (not used) Parameter name Parameter data type Parameter value Delimiter NX Nastran DMAP Programmer’s Guide 3-33 Chapter 3 Data Block Descriptions B-E Record 11 – EBDSET (8510,85,447) Word 1 2 3 4 6 Name ID TBIRTH TDEATH EID -1 Type I RS RS I I Description Birth/Death set ID number Element birth time Element death time Element ID’s Delimiter Record 12 – EBDADD (8610,86,448) Word 1 2 3 Name ID BDID -1 Type I I I Description Resulting Birth/Death set ID number Birth/Death set ID’s defined via EBDSET entries Delimiter 3.8 CSTM Coordinate system transformation matrices table The transformation is from global to basic. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – IDENT Word 1 2 3 4 Name CID TYPE IINDEX RINDEX Type I I I I Description Coordinate system identification number Type of system Index into INTDATA record Index into REALDATA record 3-34 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 2 – REALDATA Word 1 Name REALDATA Type RX Description Real data Record 3 – INTDATA Word 1 Name INTDATA Type I Description Integer data Record 4 – TRAILER Word 1 2 3 4 5 6 Name WORD1 WORD2 WORD3 WORD4 WORD5 WORD6 Type I I I I I I Description Number of grid points + number of scalar points Number of coordinate systems Type of systems present – see Note 1. Precision of REALDATA record - 1 or 2 Length of REALDATA record Length of INTDATA record 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, and so on. Identification numbers similar to CSTM68. XYZi data found in CSTM68 are converted to grid entry indices into BGPDT. NX Nastran DMAP Programmer’s Guide 3-35 Chapter 3 Data Block Descriptions B-E 3.9 CSTM68 Coordinate system transformation matrices table (Pre-Version 69) The transformation is from global to basic. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – HEADER Word 1 2 Word CIDTYPE =0 3 4 5 6 7 8 9 10 11 12 13 14 TR1 TR2 TR3 R11 R12 R13 R21 R22 R23 R31 R32 R33 Name CID CIDTYPE Name Type I I Type Unknown RS RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Direction cosine in 1-1 Direction cosine in 1-2 Direction cosine in 1-3 Direction cosine in 2-1 Direction cosine in 2-2 Direction cosine in 2-3 Direction cosine in 3-1 Direction cosine in 3-2 Direction cosine in 3-3 Description Coordinate system identification number Coordinate system type Description 3-36 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word CIDTYPE =1 3 4 5 6 7 8 9 10 11 12 13 14 Word CIDTYPE =2 3 4 5 6 7 8 9 10 11 12 13 Name Type Rectanglar Description TR1 TR2 TR3 R11 R12 R13 R21 R22 R23 R31 R32 R33 Name RS RS RS RS RS RS RS RS RS RS RS RS Type Cylindrical Translation in direction 1 Translation in direction 2 Translation in direction 3 Direction cosine in 1-1 Direction cosine in 1-2 Direction cosine in 1-3 Direction cosine in 2-1 Direction cosine in 2-2 Direction cosine in 2-3 Direction cosine in 3-1 Direction cosine in 3-2 Direction cosine in 3-3 Description TR1 TR2 TR3 R11 R12 R13 R21 R22 R23 R31 R32 RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Direction cosine in 1-1 Direction cosine in 1-2 Direction cosine in 1-3 Direction cosine in 2-1 Direction cosine in 2-2 Direction cosine in 2-3 Direction cosine in 3-1 Direction cosine in 3-2 NX Nastran DMAP Programmer’s Guide 3-37 Chapter 3 Data Block Descriptions B-E Word 14 Word CIDTYPE =3 3 4 5 6 7 8 9 10 11 12 13 14 Word CIDTYPE =4 3 5 6 7 8 9 Name R33 Name Type RS Type Spherical Description Direction cosine in 3-3 Description TR1 TR2 TR3 R11 R12 R13 R21 R22 R23 R31 R32 R33 Name RS RS RS RS RS RS RS RS RS RS RS RS Type Translation in direction 1 Translation in direction 2 Translation in direction 3 Direction cosine in 1-1 Direction cosine in 1-2 Direction cosine in 1-3 Direction cosine in 2-1 Direction cosine in 2-2 Direction cosine in 2-3 Direction cosine in 3-1 Direction cosine in 3-2 Direction cosine in 3-3 Description Convective defined on a GMCURV+GMSURF pair UNDEF(2 ) CURVID SURFID CURCID SURCID UNDEF(6 ) Name None I I I I None Type Reserved GMCURV identification number GMSURF identification number Coordinate System where GMCURV is defined Coordinate System where GMSURF is defined Reserved Description Word CIDTYPE =5 Convective defined on a GMSURF 3-38 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 3 5 6 7 Word CIDTYPE =6 3 RECINDX =1 4 5 6 7 11 RECINDX =2 4 5 13 RECINDX =3 4 5 8 11 14 RECINDX =4 Name UNDEF(2 ) SURFID SURCID UNDEF(8 ) Name Type None I I None Type Description Reserved GMSURF identification number Coordinate System where GMSURF is defined Reserved Description Convective defined on a FEEDGE+FEFACE pair RECINDX I Index 1 RECTOTAL EDGEID FACEID GP(4) GFACE(4) I I I I I Index 2 RECTOTAL GFACE(8) UNDEF(2 ) I I None Index 3 RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF I RS RS RS None Index 4 Total number of records ( = 8 ) Basic Coordinates of FEEDGE grid 1 Basic Coordinates of FEEDGE grid 2 Basic Coordinates of FEEDGE grid 3 Reserved Total number of records ( = 8 ) Grid identification number of next 8 of 12 FEFACE grids Reserved Total number of records ( = 8 ) FEEDGE identification number FEFACE identification number Grid identification numbers of 4 FEEDGE grids Grid identification numbers of 1st 4 of 12 FEFACE grids Record index number NX Nastran DMAP Programmer’s Guide 3-39 Chapter 3 Data Block Descriptions B-E Word 4 5 8 11 14 RECINDX =5 4 5 8 11 14 RECINDX =6 4 5 8 11 14 RECINDX =7 4 5 8 11 14 RECINDX =8 4 5 Name RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF Type I RS RS RS None Index 5 Description Total number of records ( = 8 ) Basic Coordinates of FEEDGE grid 4 Basic Coordinates of FEFACE grid 1 Basic Coordinates of FEFACE grid 2 Reserved RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF I RS RS RS None Index 6 Total number of records ( = 8 ) Basic Coordinates of FEFACE grid 3 Basic Coordinates of FEFACE grid 4 Basic Coordinates of FEFACE grid 5 Reserved RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF I RS RS RS None Index 7 Total number of records ( = 8 ) Basic Coordinates of FEFACE grid 6 Basic Coordinates of FEFACE grid 7 Basic Coordinates of FEFACE grid 8 Reserved RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF I RS RS RS None Index 8 Total number of records ( = 8 ) Basic Coordinates of FEFACE grid 9 Basic Coordinates of FEFACE grid 10 Basic Coordinates of FEFACE grid 11 Reserved RECTOTAL XYZ(3) I RS Total number of records ( = 8 ) Basic Coordinates of FEFACE grid 12 3-40 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 8 Name UNDEF(7 ) Type None Description Reserved End RECINDX Word CIDTYPE =7 3 RECINDX =1 4 5 6 RECINDX =2 4 5 8 11 14 RECINDX =3 4 5 8 11 14 RECINDX =4 4 5 8 11 RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF RECTOTAL GFACE(3) XYZ1(3) XYZ2(3) UNDEF RECTOTAL FACEID GFACE(9) RECINDX Name Type Description Convective defined on a FEFACE I Index 1 I I I Index 2 I I RS RS None Index 3 I RS RS RS None Index 4 I RS RS RS Total number of records ( = 6 ) Basic Coordinates of FEFACE grid 6 Basic Coordinates of FEFACE grid 7 Basic Coordinates of FEFACE grid 8 Total number of records ( = 6 ) Basic Coordinates of FEFACE grid 3 Basic Coordinates of FEFACE grid 4 Basic Coordinates of FEFACE grid 5 Reserved Total number of records ( = 6 ) Grid IDs of next 3 of 12 FEFACE grids Basic Coordinates of FEFACE grid 1 Basic Coordinates of FEFACE grid 2 Reserved Total number of records ( = 6 ) FEFACE identification number Grid IDs of first 9 of 12 FEFACE grids Record index number NX Nastran DMAP Programmer’s Guide 3-41 Chapter 3 Data Block Descriptions B-E Word 14 RECINDX =5 4 5 8 11 14 RECINDX =6 4 5 8 Name UNDEF Type None Index 5 Description Reserved RECTOTAL XYZ1(3) XYZ2(3) XYZ(3) UNDEF I RS RS RS None Index 6 Total number of records ( = 6 ) Basic Coordinates of FEFACE grid 9 Basic Coordinates of FEFACE grid 10 Basic Coordinates of FEFACE grid 11 Reserved RECTOTAL XYZ(3) UNDEF(7 ) I RS None Total no of records. Should be 6 Basic Coordinates of FEFACE grid 12 Reserved End RECINDX End CIDTYPE Record 2 – TRAILER Word 1 2 3 Name WORD1 WORD2 UNDEF(4 ) Type I I None Description Number of grid and scalar points Number of coordinate systems Notes: Coordinate system type: 1 = rectangular 2 = cylindrical 3 = spherical 4 = convective coordinate system defined on a GMCURV+GMSURF pair 5 = convective coordinate system defined on a GMSURF 6 = convective coordinate system defined on a FEEDGE+FEFACE pair 7 = convective coordinate system defined on a FEFACE 3-42 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E 3.10 DBCOPT Design optimization history table for postprocessing Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – EXACT Word 1 Name REAL Type RS Description Objective function values, exact from analysis Word 1 repeats until End of Record Record 2 – APPRX Word 1 Name REAL Type RS Description Objective function values, optimal w.r.t approximation Word 1 repeats until End of Record Record 3 – MAXIM Word 1 Name REAL Type RS Description Objective function values, maximum values of constraints Word 1 repeats until End of Record Record 4 – DVIDS Word 1 Name INTGR Type I Description Design variable identification number Word 1 repeats until End of Record NX Nastran DMAP Programmer’s Guide 3-43 Chapter 3 Data Block Descriptions B-E Record 5 – INITV Word 1 Name REAL Type RS Description Design variable values, 1st cycle ? Word 1 repeats until End of Record Record 6 – COL17 Word 1 Name REAL Type RS Description Design variable value, Nth cycle ? Word 1 repeats until End of Record Record 7 – DVLABEL Word 1 2 3 4 Name IDVID DVID LABEL1 LABEL2 Type I I CHAR4 CHAR4 Description Internal design variable identification number External design variable identification number First part of design variable Second part of design variable Record 8 – TRAILER Word 1 2 3 4 5 Name NFEA NAOP NDV NCC UNDEF(2 ) Type I I I I None Description Number of finite element analyses Number of optimization cycles w.r.t. approximate model Number of design variables Convergence criterion Notes: Convergence criterion 1 = Hard convergence 2 = Soft convergence 3-44 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E 3 = Compromise 4 = Maximum design cycles reached 3.11 DESTAB Design variable attributes Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – Repeat Word 1 2 3 4 5 6 7 Name IDVID DVID LABEL1 LABEL2 VMIN VMAX DELX Type I I CHAR4 CHAR4 RS RS RS Description Internal design variable identification number External design variable identification number First part of design Variable Second part of design Variable Lower bound Upper bound Move limit for a design cycle Record 2 – TRAILER Word 1 2 3 4 Name NDV NDVI NDVD UNDEF(3 ) Type I I I None Description Number of design variables Number of independent design variables Number of dependent design variables Notes: Independent design variables are given first in ascending IDVID followed by dependent design variables in ascending IDVID order. NX Nastran DMAP Programmer’s Guide 3-45 Chapter 3 Data Block Descriptions B-E 3.12 DIT Direct input tables Contains images of TABLEij, TABDMP1 and GUST Bulk Data entries. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – GUST(1005,10,174) Word 1 2 3 4 5 Name SID DLOAD WG X0 V Type I I RS RS RS Description Gust load identification number TLOADi or RLOADi identification number Scale factor Streamwise location of the gust reference point Velocity of vehicle Record 2 – TABDMP1(15,21,162) Word 1 2 9 10 Name ID UNDEF(7 ) F G Type I None RS RS Natural frequency Damping Description Table identification number Words 9 through 10 repeat until (-1,-1) occurs Record 3 – TABLE3D(4000,40,460) Word 1 2 3 4 Name ID X0 Y0 Z0 Type I RS RS RS Description Table identification number X offset of the independent variable Y offset of the independent variable Z offset of the independent variable 3-46 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 5 6 9 10 11 12 Name F0 UNDEF(3 ) XI YI ZI FI Type RS None RS RS RS RS Description Offset of the dependent variable X independent variable Y independent variable Z independent variable Dependent variable Words 9 through 12 repeat until End of Record Record 4 – TABLED1(1105,11,133) Word 1 2 3 4 9 10 Name ID CODEX CODEY UNDEF(5 ) X Y Type I I I None RS RS X tabular value Y tabular value Description Table identification number Type of interpolation for the x-axis Type of interpolation for the y-axis Words 9 through 10 repeat until (-1,-1) occurs Record 5 – TABLED2(1205,12,134) Word 1 2 3 9 10 Name ID X1 UNDEF(6 ) X Y Type I RS None RS RS X value Y value Description Table identification number X-axis shift Words 9 through 10 repeat until (-1,-1) occurs NX Nastran DMAP Programmer’s Guide 3-47 Chapter 3 Data Block Descriptions B-E Record 6 – TABLED3(1305,13,140) Word 1 2 3 4 9 10 Name ID X1 X2 UNDEF(5 ) X Y Type I RS RS None RS RS X value Y value Description Table identification number X-axis shift X-axis normalization Words 9 through 10 repeat until (-1,-1) occurs Record 7 – TABLED4(1405,14,141) Word 1 2 3 4 5 6 9 Name ID X1 X2 X3 X4 UNDEF(3 ) A Type I RS RS RS RS None RS Description Table identification number X-axis shift X-axis normalization X value when x is less than X3 X value when x is greater than X4 Word 9 repeats until End of Record Record 8 – TABLEM1(105,1,93) Same as record TABLED1 description Record 9 – TABLEM2(205,2,94) Same as record TABLED2 description Record 10 – TABLEM3(305,3,95) Same as record TABLED3 description 3-48 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 11 – TABLEM4(405,4,96) Same as record TABLED4 description Record 12 – TABLES1(3105,31,97) Word 1 2 9 10 Name ID UNDEF(7 ) X Y Type I None RS RS X value Y value Description Table identification number Words 9 through 10 repeat until (-1,-1) occurs Record 13 – TABLEST(1905,19,178) Word 1 2 9 10 Name ID UNDEF(7 ) TI TIDI Type I None RS I Temperature TABLES1 Bulk Data entry identification number Description Table identification number Words 9 through 10 repeat until (-1,-1) occurs Record 14 – TABRND1(55,25,191) Word 1 2 3 4 9 10 Name ID CODEX CODEY UNDEF(5 ) F G Type I I I None RS RS Frequency Power spectral density Description Table identification number Type of interpolation for the x-axis Type of interpolation for the y-axis Words 9 through 10 repeat until (-1,-1) occurs NX Nastran DMAP Programmer’s Guide 3-49 Chapter 3 Data Block Descriptions B-E Record 15 – TABRNDG(56,26,303) Power spectral density for gust loads in aeroelastic analysis Word 1 2 3 4 5 Name ID TYPE LU WG UNDEF(4 ) Type I I RS RS None Description Table identification number Power spectral density type Scale of turbulence divided by velocity Root-mean-square gust velocity Words 1 through 8 repeat until (-1,-1) occurs Record 16 – TRAILER Word 1 2 3 Name WORD1 WORD2 UNDEF(4 ) Type I I None Description Record presence trailer word 1 Record presence trailer word 2 Notes: Type of interpolation (CODEX and CODEY): 0 = linear 1 = log 3.13 DSCMCOL Design sensitivity parameters Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name 3-50 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 1 – TYPE1 – Type 1 Responses Word 1 2 3 Word RTYPE =1 4 9 Word RTYPE =2 4 9 Word RTYPE =3 4 5 6 7 9 Word RTYPE =4 4 5 6 MODE UNDEF SUBCASE MODE UNDEF SUBCASE UNDEF(2 ) SEID Name UNDEF(5 ) SEID Name UNDEF(5 ) SEID Name Name IRID RID RTYPE Name Type I I I Type Weight None I Type Volume None I Type Buckling I None I None I Type Normal modes I None I Subcase identification number Mode number Superelement identification number Description Subcase identification number Mode number Superelement identification number Description Superelement identification number Description Description Internal response identification number External response identification number Response Type Description NX Nastran DMAP Programmer’s Guide 3-51 Chapter 3 Data Block Descriptions B-E Word 7 9 Word RTYPE =5 4 5 6 7 9 Word RTYPE =6 4 5 6 7 9 Word RTYPE =7 4 5 6 7 8 9 Name UNDEF(2 ) SEID Name Type None I Type Description Superelement identification number Description Static displacement GRID COMP SUBCASE UNDEF(2 ) SEID Name I I I None I Type Static stress EID COMP SUBCASE UNDEF(2 ) SEID Name I I I None I Type Static strain EID COMP SUBCASE UNDEF VIEWID SEID I I I None I I View element identification number Superelement identification number Element identification number Strain component number Subcase identification number Superelement identification number Description Element identification number Stress component number Subcase identification number Superelement identification number Description Grid identification number Displacement component number Subcase identification number 3-52 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word RTYPE =8 4 5 6 7 8 9 Name Type Static force Description EID COMP SUBCASE UNDEF VIEWID SEID Name I I I None I I Type Element identification number Force component number Subcase identification number View element identification number Superelement identification number Description Word RTYPE =9 4 5 6 7 8 9 Composite failure EID COMP SUBCASE UNDEF PLY SEID Name I I I None I I Type Ply number Superelement identification number Description Element identification number Failure component number Subcase identification number Word RTYPE =10 4 5 6 7 8 9 Composite stress EID COMP SUBCASE UNDEF PLY SEID Name I I I None I I Type Ply number Superelement identification number Description Element identification number Stress component number Subcase identification number Word RTYPE =11 Composite strain NX Nastran DMAP Programmer’s Guide 3-53 Chapter 3 Data Block Descriptions B-E Word 4 5 6 7 8 9 Word RTYPE =13 4 5 6 7 9 Name EID COMP SUBCASE UNDEF PLY SEID Name Type I I I None I I Type Description Element identification number Strain component number Subcase identification number Ply number Superelement identification number Description Static SPC force GRID COMP SUBCASE UNDEF(2) SEID Name I I I None I Type Superelement identification number Description Grid identification number SPC force component number Subcase identification number Word RTYPE =14 4 5 6 7 9 Element static strain energy EID COMP SUBCASE UNDEF(2) SEID Name I I I None I Type Superelement identification number Description Element identification number Strain energy component number Subcase identification number Word RTYPE =20 4 5 6 Frequency response displacement GRID COMP SUBCASE I I I Grid identification number Displacement component number Subcase identification number 3-54 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 7 8 9 Name FREQ UNDEF SEID Name Type RS None I Type Description Frequency Superelement identification number Description Word RTYPE =21 4 5 6 7 8 9 Frequency response velocity GRID COMP SUBCASE FREQ UNDEF SEID Name I I I RS None I Type Superelement identification number Description Grid identification number Velocity component number Subcase identification number Frequency Word RTYPE =22 4 5 6 7 8 9 Frequency response acceleration GRID COMP SUBCASE FREQ UNDEF SEID Name I I I RS None I Type Superelement identification number Description Grid identification number Acceleration component number Subcase identification number Frequency Word RTYPE =23 4 5 6 7 Frequency response SPC Force GRID COMP SUBCASE FREQ I I I RS Grid identification number SPC Force component number Subcase identification number Frequency NX Nastran DMAP Programmer’s Guide 3-55 Chapter 3 Data Block Descriptions B-E Word 8 9 Name UNDEF SEID Name Type None I Description Superelement identification number Word RTYPE =24 4 5 6 7 8 9 Type Description Frequency response stress EID COMP SUBCASE FREQ UNDEF SEID Name I I I RS None I Superelement identification number Element identification number Stress component number Subcase identification number Frequency Word RTYPE =25 4 5 6 7 8 9 Type Description Frequency response force EID COMP SUBCASE FREQ UNDEF SEID Name I I I RS None I Superelement identification number Element identification number Force component number Subcase identification number Frequency Word RTYPE =26 4 5 6 7 8 Type Description RMS displacement GRID COMP SUBCASE UNDEF RANDPS I I I None I RANDPS ID Grid identification number RMS displacement component number Subcase identification number 3-56 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 9 Name SEID Name Type I Type RMS velocity Description Superelement identification number Description Word RTYPE =27 4 5 6 7 8 9 GRID COMP SUBCASE UNDEF RANDPS SEID Name I I I None I I Type Grid identification number RMS velocity component number Subcase identification number RANDPS ID Superelement identification number Description Word RTYPE =28 4 5 6 7 8 9 RMS acceleration GRID COMP SUBCASE UNDEF RANDPS SEID Name I I I None I I Type RANDPS ID Superelement identification number Description Grid identification number RMS acceleration component number Subcase identification number Word RTYPE =60 4 5 6 7 8 9 Transient response displacement GRID COMP SUBCASE TIME UNDEF SEID I I I RS None I Superelement identification number Grid identification number Displacement component number Subcase identification number Time NX Nastran DMAP Programmer’s Guide 3-57 Chapter 3 Data Block Descriptions B-E Word RTYPE =61 4 5 6 7 8 9 Name Type Description Transient response velocity GRID COMP SUBCASE TIME UNDEF SEID Name I I I RS None I Type Superelement identification number Description Grid identification number Velocity component number Subcase identification number Time Word RTYPE =62 4 5 6 7 8 9 Transient response acceleration GRID COMP SUBCASE TIME UNDEF SEID Name I I I RS None I Superelement identification number Description Grid identification number Acceleration component number Subcase identification number Time Word RTYPE =63 4 5 6 7 8 9 Type Transient response SPC Force GRID COMP SUBCASE TIME UNDEF SEID Name I I I RS None I Type Superelement identification number Grid identification number SPC force component number Subcase identification number Time Word RTYPE =64 Description Transient response stress 3-58 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 5 6 7 8 9 Name EID COMP SUBCASE TIME UNDEF SEID Name Type I I I RS None I Description Element identification number Stress component number Subcase identification number Time Superelement identification number Description Word RTYPE =65 4 5 6 7 8 9 Type Transient response force EID COMP SUBCASE TIME UNDEF SEID Name I I I RS None I Type Superelement identification number Element identification number Force component number Subcase identification number Time Word RTYPE =81 4 5 6 7 8 9 Description Aeroelastic divergence SUBCASE UNDEF ROOT MACH UNDEF SEID Name I None I RS None I Superelement identification number Description Root Mach number Subcase identification number Word RTYPE =82 4 Type Aeroelastic trim SUBCASE I Subcase identification number NX Nastran DMAP Programmer’s Guide 3-59 Chapter 3 Data Block Descriptions B-E Word 5 6 7 9 Word RTYPE =83 4 5 6 7 8 9 Word RTYPE =84 4 5 6 7 8 9 End RTYPE Name UNDEF XID UNDEF(2) SEID Name Type None I None I Type Description XID Superelement identification number Description Aeroelastic stability derivative SUBCASE RU COMP UNDEF XID SEID Name I I I None I I Type XID Superelement identification number Description Subcase identification number R/U Component number Aeroelastic flutter damping SUBCASE MODE DENSITY MACH VEL SEID I I RS RS RS I Subcase identification number Mode number Density Mach number Velocity Superelement identification number Record 2 – TYPE2 – Type 2 Responses Word 1 2 Name IRID RID Type I I Description Internal response identification number External response identification number 3-60 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 3 4 5 6 Name SUBCASE DFLAG FREQTIME SEID Type I I RS I Description Subcase identification number Dynamic response flag (See Note) Frequency or time step Superelement identification number Record 3 – TRAILER Word 1 2 3 Name NR1 NR2 UNDEF(4 ) Type I I None Description Number of Type 1 responses Number of Type 2 responses Notes: 1. Record 1 contains NR1 * 9 words. 2. Record 2 contains NR2 * 6 words. 3. If the Subcase ID on record 2 is ’SPAN’, the response spans subcases (not currently supported). 4. The DFLG attribute identifies the dynamic response type. 5. 1 – Response is not dynamic. FREQ/TIME is not required. 6. 2 – Response is dynamic. FREQ/TIME is required. 7. ? – Response is dynamic and spans frequency or time steps. FREQ/TIME is not defined. 8. If the Superlement ID attribute on record 2 is ’SPAN’, the response spans superelements (not currently supported). 3.14 DVPTAB Designed property table Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name NX Nastran DMAP Programmer’s Guide 3-61 Chapter 3 Data Block Descriptions B-E Record 1 – Repeat By ascending internal property identification number order. Type one properties are first and type two follow. Word 1 2 3 4 5 6 7 8 9 Name IPID DVTYP EPPNT PTYP1 PTYP2 PID FID PMIN PMAX Type I I I CHAR4 CHAR4 I I RS RS Description Internal property identification number DVPRELi Bulk Data entry identification number Property type (1 or 2) First word of the property type Second word of the property type Property identification number Property field position Minimum property value Maximum property value Record 2 – TRAILER Word 1 2 3 4 Name NPROP NENT1 NENT2 UNDEF(3 ) Type I I I None Description Number of designed properties (number of records in table Number of designed properties from DVPREL1 Bulk Data entries Number of DVPREL2 Bulk Data entries Notes: There are as many records as there are designed properties. (NPROP = NENT1 + NENT2) 3.15 DYNAMIC Table of Bulk Data entry images related to dynamics 3-62 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – ACSRCE(5307,53,379) Power vs. frequency for a simple acoustic source Word 1 2 3 4 5 6 7 Name SID DAREA DPHASE DELAY TC RHO B Type I I I I I RS RS Description Load set identification number DAREA Bulk Data entry identification number DPHASE Bulk Data entry identification number DELAY Bulk Data entry identification number TABLEDi Bulk Data entry identification number for C(f) Density of the fluid Bulk modulus of the fluid Record 2 – DAREA(27,17,182) Scale factor for dynamic loads Word 1 2 3 4 Name SID P C A Type I I I RS Description Load set identification number Grid, scalar, or extra point identification number Component number Scale factor Record 3 – DELAY(37,18,183) Time delay parameter for dynamic loads Word 1 2 Name SID P Type I I Description Load set identification number Grid, scalar, or extra point identification number NX Nastran DMAP Programmer’s Guide 3-63 Chapter 3 Data Block Descriptions B-E Word 3 4 Name C T Type I RS Description Component number Time delay Record 4 – DLOAD(57,5,123) Linear combination of dynamic loads Word 1 2 3 4 Name SID S SI LI Type I RS RS I Description Load set identification number Overall scale factor Scale factor i Load set identification number i Words 3 through 4 repeat until (-1,-1) occurs Record 5 – DPHASE(77,19,184) Phase lead parameter in dynamic loading Word 1 2 3 4 Name SID P C TH Type I I I RS Description Load set identification number Grid, scalar, or extra point identification number Component number Phase lead Record 7 – EIGB(107,1,86) Word 1 2 4 5 6 Name SID METHOD(2) L1 L2 NEP Type I CHAR4 RS RS I Description Load set identification number Method of eigenvalue extraction Lower bound of eigenvalue range of interest Upper bound of eigenvalue range of interest Estimate of number of roots in positive range 3-64 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 7 8 9 10 12 13 14 Name NDP NDN UNDEF NORM(2) G C UNDEF(5 ) Type I I None CHAR4 I I None Description Desired number of positive roots Desired number of negative roots Method for normalizing eigenvectors Grid or scalar point identification number Component number Record 8 – EIGC(207,2,87) Word 1 2 4 6 7 8 9 10 CONTFLG =0 11 12 13 14 15 16 17 AAJ WAJ ABJ WBJ LJ NEJ NDJ Name SID METHOD(2) NORM(2) G C E ND1 CONTFLG Type I CHAR4 CHAR4 I I RS I I Description Load set identification number Method of eigenvalue extraction Method for normalizing eigenvectors Grid or scalar point identification number Component number Convergence criterion Number of desired eigenvectors Continuation flag With continuation RS RS RS RS RS I I Location of A on real axis Location of A on imaginary axis Location of B on real axis Location of B on imaginary axis Width of search region Number of estimated roots Number of desired eigenvectors Words 11 through 17 repeat until (-1,-1,-1,-1,-1,-1,-1) occ NX Nastran DMAP Programmer’s Guide 3-65 Chapter 3 Data Block Descriptions B-E Word Name Type Description CONTFLG =–1 End CONTFLG Without continuation Record 9 – EIGP(257,4,158) Word 1 2 3 4 Name SID ALPHA OMEGA M Type I RS RS I Description Load set identification number Location of pole on real axis Location of pole on imaginary axis Multiplicity of complex root at pole Record 10 – EIGR(307,3,85) Word 1 2 4 5 6 7 8 10 12 13 14 Name SID METHOD(2) F1 F2 NE ND UNDEF(2 ) NORM(2) G C UNDEF(5 ) Type I CHAR4 RS RS I I None CHAR4 I I None Method for normalizing eigenvectors Grid or scalar point identification number Component number Description Load set identification number Method of eigenvalue extraction Lower bound of frequency range of interest Upper bound of frequency range of interest Number of estimated roots Number of desired roots Record 11 – EIGRL(308,8,348) Word 1 Name SID Type I Description Set identification number 3-66 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 2 3 4 5 6 7 8 9 10 12 13 14 Name V1 V2 ND MSGLVL MAXSET SHFSCL FLAG1 FLAG2 NORM(2) ALPH NUMS FI Type RS RS I I I RS I I CHAR4 RS I RS Description Lower bound of frequency range of interest Upper bound of frequency range of interest Number of desired eigenvectors Diagnostic level Number of vectors in block or set Estimate of first flexible mode V1 specification flag – set to 1 if V1 is specified V2 specification flag – set to 1 if V2 is specified Method for normalizing eigenvectors Constant for quadratic frequency segment distribution Number of frequency segments Frequency at the upper boundary of the i-th segment Word 14 repeats NUMS times Record 12 – EPOINT(707,7,124) Word 1 Name ID Type I Description Extra point identification number Record 13 – FREQ(1307,13,126) Word 1 2 Name SID F Type I RS Description Set identification number Frequency Word 2 repeats until End of Record NX Nastran DMAP Programmer’s Guide 3-67 Chapter 3 Data Block Descriptions B-E Record 14 – FREQ1(1007,10,125) Word 1 2 3 4 Name SID F1 DF NDF Type I RS RS I Description Set identification number First frequency Frequency increment Number of frequency increments Record 15 – FREQ2(1107,11,166) Word 1 2 3 4 Name SID F1 F2 NF Type I RS RS I Description Set identification number First frequency Last frequency Number of logarithmic intervals Record 16 – FREQ3(1407,14,39) Word 1 2 3 4 5 6 Name SID F1 F2 TYPE NEF BIAS Type I RS RS CHAR4 I RS Description Set identification number Lower bound of modal frequency range Upper bound of modal frequency range Type of interpolation: LINE or LOG Number of frequencies Clustering bias parameter Record 17 – FREQ4(1507,15,40) Word 1 2 3 Name SID F1 F2 Type I RS RS Description Set identification number Lower bound of modal frequency range Upper bound of modal frequency range 3-68 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 5 Name FSPD NFM Type RS I Description Frequency spread Number of evenly spaced frequencies per spread Record 18 – FREQ5(1607,16,41) Word 1 2 3 4 Name SID F1 F2 FRI Type I RS RS RS Description Load set identification number Lower bound of modal frequency range Upper bound of modal frequency range Fractions of natural frequencies Word 4 repeats until End of Record Record 19 – NOLIN1(3107,31,127) Word 1 2 3 4 5 6 7 8 Name SID GI CI S GJ CJ T UNDEF Type I I I RS I I I None Description Load set identification number Grid, scalar, or extra point identification number of I Component number for GI. Scale factor Grid, scalar, or extra point identification number of J Component number for GJ Identification number of a TABLEDi Bulk Data entry. Record 20 – NOLIN2(3207,32,128) Word 1 Name SID Type I Description Load set identification number NX Nastran DMAP Programmer’s Guide 3-69 Chapter 3 Data Block Descriptions B-E Word 2 3 4 5 6 7 8 Name GI CI S GJ CJ GK CK Type I I RS I I I I Description Grid, scalar, or extra point identification number of I Component number for GI. Scale factor Grid, scalar, or extra point identification number of J Component number for GJ Grid, scalar, or extra point identification number of K Component number for GK Record 21 – NOLIN3(3307,33,129) Word 1 2 3 4 5 6 7 8 Name SID GI CI S GJ CJ A UNDEF Type I I I RS I I RS None Description Load set identification number Grid, scalar, or extra point identification number of I Component number for GI. Scale factor Grid, scalar, or extra point identification number of J Component number for GJ Exponent of the forcing function Record 22 – NOLIN4(3407,34,130) Word 1 2 3 Name SID GI CI Type I I I Description Load set identification number Grid, scalar, or extra point identification number of I Component number for GI. 3-70 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 5 6 7 8 Name S GJ CJ A UNDEF Type RS I I RS None Description Scale factor Grid, scalar, or extra point identification number of J Component number for GJ Exponent of the forcing function Record 23 – RANDPS(2107,21,195) Word 1 2 3 4 5 6 Name SID J K X Y TID Type I I I RS RS I Description Set identification number Subcase identification number of the excited set Subcase identification number of the applied load set X component Y component Identification number of a TABRNDi entry that defines G(F) Record 24 – RANDT1(2207,22,196) Word 1 2 3 4 Name SID N TO TMAX Type I I RS RS Description Set identification number Number of time lag intervals Starting time lag Maximum time lag Record 25 – RLOAD1(5107,51,131) Word 1 2 Name SID DAREA Type I I Description Load set identification number DAREA Bulk Data entry identification number NX Nastran DMAP Programmer’s Guide 3-71 Chapter 3 Data Block Descriptions B-E Word 3 4 5 6 7 Name DPHASE DELAY TC TD TYPE Type RS RS I I I Description DPHASE Bulk Data entry identification number DELAY Bulk Data entry identification number TABLEDi Bulk Data entry identification number for C(f) TABLEDi Bulk Data entry identification number for D(f) Nature of the dynamic excitation Record 26 – RLOAD2(5207,52,132) Word 1 2 3 4 5 6 7 Name SID DAREA DPHASE DELAY TB TP TYPE Type I I I I I I I Description Load set identification number DAREA Bulk Data entry identification number DPHASE Bulk Data entry identification number DELAY Bulk Data entry identification number TABLEDi Bulk Data entry identification number for B(f) TABLEDi Bulk Data entry identification number for Phi(f) Nature of the dynamic excitation Record 27 – SEQEP(5707,57,135) Word 1 2 Name ID SEQID Type I I Description Extra point identification number Sequenced identification number Record 28 – TF(6207,62,136) Word 1 2 Name SID GD Type I I Description Set identification number Grid, scalar, or extra point identification number 3-72 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 3 4 5 6 7 8 9 10 11 Name CD B0 B1 B2 GI CI A0I A1I A2I Type I RS RS RS I I RS RS RS Description Component number for point GD Transfer function coefficient Transfer function coefficient Transfer function coefficient Grid, scalar, or extra point identification number Component number for point GI Transfer function coefficient Transfer function coefficient Transfer function coefficient Words 7 through 11 repeat until (-1,-1,–1,-1,-1) occurs Record 29 – TIC(6607,66,137) Word 1 2 3 4 5 Name SID G C U0 V0 Type I I I RS RS Description Load set identification number Grid, scalar, or extra point identification number Component number for point GD Initial displacement Initial velocity Record 30 – TLOAD1(7107,71,138) Word 1 2 3 4 5 Name SID DAREA DELAY TYPE TID Type I I I I I Description Load set identification number DAREA Bulk Data entry identification number DELAY Bulk Data entry identification number Nature of the dynamic excitation Identification number of TABLEDi entry that gives F(t) NX Nastran DMAP Programmer’s Guide 3-73 Chapter 3 Data Block Descriptions B-E Record 31 – TLOAD2(7207,72,139) Word 1 2 3 4 5 6 7 8 9 10 Name SID DAREA DELAY TYPE T1 T2 F P C B Type I I I I RS RS RS RS RS RS Description Load set identification number DAREA Bulk Data entry identification number DELAY Bulk Data entry identification number Nature of the dynamic excitation Time constant 1 Time constant 2 Frequency Phase angle Exponential coefficient Growth coefficient Record 32 – ROTORD(8210,82,599) Word 1 2 3 4 5 6,7 8 9,10 11,12 13,14 15 Name SID NUMROT RSTART RSTEP NUMSTEP REFSYS CMOUT RUNIT FUNIT ZSTEIN ORBEPS Type I I RS RS I CHAR8 RS CHAR8 CHAR8 CHAR8 RS Description Set identification number Number of rotors (i=1, NUMROT below) Starting rotor speed (in RPM) Rotor speed step size (in RPM) Number of steps for rotor speed Rotational reference system (YHROT,YH or YHFIX,YH Complex mode output request Revolution input/output units for rotor (YHRPM or YHRAD or YHCPS or YHHZ) Frequency output units (YHRPM or YHRAD or YHCPS or YHHZ) Flag to incorpoate Steiner inertia terms (YHYES,YH or YHNO,YH) Threshold value for detection of whirl direction 3-74 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 16 17 18 19 20–21 22+8*(i-1) 23+8*(i-1) 24+8*(i-1) 25+8*(i-1) 26+8*(i-1) 27+8*(i-1) 28+8*(i-1) 29+8*(i-1) Name ROTPRT SYNC ETYPE EORDER Type I I I RS Description Optimal flag Optional printout flag Optional printout flag Optional printout flag (not used) RIDi RSETi RSPEEDi RCOORDI W3i W4i RFORCEi I I RS I RS RS I Rotor ID for ith rotor Set number for rotor speed for multiple rotors Relative rotor speed for multiple rotors Coordinate system ID number specifying rotation axis as Z Damping coefficient like PARAM,W3 Damping coefficient like PARAM,W4 RFORCE bulk data ID number specifying rotational force to be applied (not used) Record 33 – ROTORG(8410,84,600) Word 1 2 Name SID ID Type I I Description Set identification number of rotor Grid or scalar point ID’s which define a rotor Record 34 – TSTEP(8307,83,142) Word 1 2 3 4 Name SID N DT NO Type I I RS I Description Set identification number Number of time steps of value DTi Time increment Skip factor for output Words 2 through 4 repeat until (-1,-1,-1) occurs NX Nastran DMAP Programmer’s Guide 3-75 Chapter 3 Data Block Descriptions B-E Record 34 – TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words 3.16 EGPSF Table of element to grid point surface interpolation factors Contains surface and volume data and element stress factors for each grid point in that surface or volume. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – IDENT Word 1 Name SRFTYP(C) Type I Description Entity Type: 2=surface and 3=volume. See Note 1. Record 2 – DATA Word Name Type Description SRFTYP =2 1 2 3 4 5 6 7 8 SURFID NKEYS(C) SURFID SETID FIBRE OCID AXIS NORMAL Surface definition I I I I I I I I Surface identification number Number of keywords in surface data Surface identification number Set identification number Fibre code for surfaces Output coordinated system identification number Axis code Normal code 3-76 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 9 10 11 12 13 14 21 22 23 24 Name METH TOL MSG BREAK ECID UNDEF(7 ) UWMREF GPELREC NELS(C) EID Type I RS I I I None I I I I Description Method of calculation Tolerance Branch message flag Break flag Element coordinate system usage flag Reference message flag Record number of GPEL Number of elements in surface Element identification numbers in surface Word 24 repeats NELS times 25 26 27 28 29 30 31 32 33 NG(C) GRID REFID NE(C) ELTYPE ELID THETA FLAG FACTOR I I I I I I RS I RS Number of grid points in surface Grid point identification number (internal) Reference element identification number No. of elements contributing to stress at this grid Element type Element identification number Angle stress point flag Angle stress point flag Stress Factor Words 29 through 33 repeat NE times Words 26 through 33 repeat NG times SRFTYP =3 1 2 3 VOLID NKEYS(C) VOLIDN Volume definition I I I Volume identification number Number of keywords in volume data Negative of volume identification number NX Nastran DMAP Programmer’s Guide 3-77 Chapter 3 Data Block Descriptions B-E Word 4 5 6 13 14 22 23 24 Name SETID STRESS UNDEF(7 ) ECID UNDEF(8 ) GPELREC NELS(C) EID Type I I None I None I I I Description Set identification number Stress code Element coordinate system usage flag Record number of GPEL Number of elements in volume Element identification numbers in volume Word 24 repeats NELS times 25 26 27 28 29 30 31 40 41 NG(C) GRID REFID NE(C) ELTYPE ELID TOE(9) FLAG FACTOR I I I I I I RS I RS Number of grid points in volume Grid point identification number (internal) Reference element identification number No. of elements contributing to stress at this grid Element type Element identification number Element stress output 3x3 trans. matrix 10*connectivity+identity flag. See Note 2. Factor to apply to stress Words 29 through 41 repeat NE times Words 26 through 41 repeat NG times SRFTYP =–1 End SRFTYP End of Data Record 3 – TRAILER Word 1 Name NSV Type I Description Number of surfaces and volumes 3-78 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 2 Name UNDEF(5 ) Type None Description 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 is 1 if TOE is an identity matrix. 3. Possible values for items in RECORD=DATA are: FIBRE Fibre code for surfaces 0 1 2 3 4 5 6 7 STRESS All (Z1,Z2,MID) (default) Z1 only Z2 only Z1 and Z2 MID only Z1 and MID Z2 and MID All Stress code for volumes 2 1 0 Principal Direct Both OCID Output coordinate system ID 0 >0 Basic system (default) User defined coordinate system AXIS Axis code (surfaces only) 0 1 2 X axis (default) Y axis Z axis NX Nastran DMAP Programmer’s Guide 3-79 Chapter 3 Data Block Descriptions B-E NORMAL Normal code (surfaces only) 0 1 2 3 -1 -2 -3 10 Radius X axis Y axis Z axis -X axis -Y axis -Z axis Radius vector normal METH Method of calculation (surfaces only) 0 1 Topological (default) Geometric MSG Branch message flag (surfaces only) 0 1 No message (default) Issue messages Break flag (surfaces only) 0 1 No break Break BREAK ECID Element coordinate system usage flag 0 -1 Not used Used 4. GPELREC is nonzero if warning messages concerning the reference normal or reference axis have been issued. 3.17 EGPSTR Element grid point stress table Provides grid point stress data for postprocessing. 3-80 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – Repeat See “EGPSF” for a description of surface and volume definition data. Word 1 2 3 4 5 6 Name SUBVEC TSEIG TYPE(C) SVID NE(C) EID Type I RS I I I I Description Subcase or vector identification number Eigenvalue or time step value Surface/volume type Surface/volume identification number Number of elements Element identification numbers Word 6 repeats NE times 7 8 NS(C) DATA I I Number of words of in surface or volume data Surface/volume definition data (See note above) Word 8 repeats NS times 9 10 11 TYPE =2 12 13 14 15 16 17 18 FIBRE SX SY TXY A SMAJ SMIN NG(C) GRID ELID I I I Number of grid points Grid point identification number Element identification number Surface stresses CHAR4 RS RS RS RS RS RS Fibre name Normal x Normal y Shear xy Shear angle Major principal Minor principal NX Nastran DMAP Programmer’s Guide 3-81 Chapter 3 Data Block Descriptions B-E Word 19 20 Name TMAX HVM Type RS RS Description Maximum shear Hencky/Von Mises Words 12 through 20 repeat NF times TYPE =3 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 End TYPE Words 10 through max repeat NG times SX SY SZ TXY TYZ TZX MP HVM SA SB SC LXA LXB LXC LYA LYB LYC LZA LZB LZC Volume stresses RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Normal x Normal y Normal z Shear xy Shear yz Shear zx Mean pressure Hencky-von Mises Principal stresses in a-direction Principal stresses in b-direction Principal stresses in c-direction x-a direction cosine x-b direction cosine x-c direction cosine y-a direction cosine y-b direction cosine y-c direction cosine z-a direction cosine z-b direction cosine z-c direction cosine 3-82 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 2 – TRAILER Word 1 Name UNDEF(6 ) Type None Description 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, NF=1 If strain/curvature and FIBRE <> 4, NF=2 If stress FIBRE=1, 2, or 4, NF=1. If stress FIBRE=0, 3, 5, 6, or, 7, NF=3. 2. SUBVEC and TSEIG can have the following values: Linear statics Cyclic statics Nonlinear statics Normal Modes Buckling Transient subcase ID vector ID subcase ID vector ID vector ID vector ID 0.0 0.0 load factor eigenvalue critical load time 3. The element identification number is 0 unless more than one grid stress is output for a given grid point. In this case, the element identification number defines the connected element for the given grid point stress. 3.18 ELDCT Element stress discontinuity table Similar in format to “EGPSTR” . Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name NX Nastran DMAP Programmer’s Guide 3-83 Chapter 3 Data Block Descriptions B-E Record 1 – Repeat See “EGPSF” for a description of surface and volume definition data Word 1 2 3 4 5 6 Name SUBVEC TSEIG TYPE(C) SVID NS(C) DATA Type I RS I I I I Description Subcase or vector identification number Eigenvalue or time step value Surface/volume type Surface/volume identification number Number of words of in surface or volume data Surface/volume definition data (See note above) Word 6 repeats NS times 7 8 9 TYPE =2 10 11 12 13 14 15 16 17 18 19 FIBRE SX SY TXY A SMAJ SMIN TMAX HVM ERR NE(C) EID TYPE I I I Number of elements Element identification number Element type Surface stress discontinuities CHAR4 RS RS RS RS RS RS RS RS RS Fibre name Normal x Normal y Shear xy Shear angle Major principal Minor principal Maximum shear Hencky/Von Mises Error estimate Words 10 through 19 repeat NF times TYPE =3 10 SX Volume stresse discontinuities RS Normal x 3-84 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 11 12 13 14 15 16 17 18 19 20 21 22 End TYPE Name SY SZ TXY TYZ TZX MP HVM SA SB SC ERRN ERRP Type RS RS RS RS RS RS RS RS RS RS RS RS Description Normal y Normal z Shear xy Shear yz Shear zx Mean pressure Hencky-von Mises Principal stresses in a-direction Principal stresses in b-direction Principal stresses in c-direction Error estimate for normal stress Error estimate for principal stress Words 8 through max repeat NE times Record 2 – TRAILER Word 1 Name UNDEF(6 ) Type None Description Notes: NF is based on the value of FIBRE and whether strain/curvature or stresses are being processed. • • • • If strain/curvature and FIBRE = 4, NF=1 If strain/curvature and FIBRE <> 4, NF=2 If stress FIBRE=1, 2, or 4, NF=1. If stress FIBRE=0, 3, 5, 6, or 7, NF=3. 3.19 EPT Element property table NX Nastran DMAP Programmer’s Guide 3-85 Chapter 3 Data Block Descriptions B-E Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – PAABSF(1502,15,36) – Acoustic absorber element with frequency dependence Defines the properties of a frequency-dependent acoustic absorber Word 1 2 3 4 5 6 7 8 Name PID TZREID TZMID S A B K RHOC Type I I I RS RS RS RS RS Description Property identification number TABLEDi entry identification number for resistance TABLEDi entry identification number for reactance Impedance scale factor Area factor when only 1 or 2 grid points are specified Equivalent structural damping Equivalent stiffness Constant used for absorption coefficient Record 2 – PACABS(8300,83,382) – Acoustic absorber element Defines the properties of the acoustic absorber element Word 1 2 3 4 5 Name PID SYNTH TID1 TID2 TID3 Type I I I I I Description Property identification number Request the calculation of B, K, and M TABLEDi entry identification number for resistance TABLEDi entry identification number for reactance TABLEDi entry identification number for weighting function 3-86 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 6 7 8 9 10 Name TESTAR CUTFR B K M Type RS RS RS RS RS Description Area of the test specimen Cutoff frequency for tables referenced above Equivalent structural damping values Equivalent structural stiffness Equivalent mass Record 3 – PACBAR(8500,85,384) – Acoustic barrier element Word 1 2 3 4 5 Name PID MBACK MSEPTM FRESON KRESON Type I RS RS RS RS Description Property identification number Mass per unit area of the backing material Mass per unit area of the septum material Resonant frequency of the sandwich construction Resonant stiffness of the sandwich construction Record 4 – PBAR(52,20,181) – Simple beam element Word 1 2 3 4 5 6 7 8 9 10 Name PID MID A I1 I2 J NSM FE C1 C2 Type I I RS RS RS RS RS RS RS RS Stress recovery location at point C in element y-axis Stress recovery location at point C in element z-axis Description Property identification number Material identification number Area Area moment of inertia in plane 1 Area moment of inertia in plane 2 Torsional constant Nonstructural mass per unit length NX Nastran DMAP Programmer’s Guide 3-87 Chapter 3 Data Block Descriptions B-E Word 11 12 13 14 15 16 17 18 19 Name D1 D2 E1 E2 F1 F2 K1 K2 I12 Type RS RS RS RS RS RS RS RS RS Description Stress recovery location at point D in element y-axis Stress recovery location at point D in element z-axis Stress recovery location at point E in element y-axis Stress recovery location at point E in element z-axis Stress recovery location at point F in element y-axis Stress recovery location at point F in element z-axis Area factor for shear in plane 1 Area factor for shear in plane 2 Area product of inertia for plane 1 and 2 Record 5 – PBARL(9102,91,52) Word 1 2 3 5 7 Name PID MID GROUP(2) TYPE(2) VALUE Type I I CHAR4 CHAR4 RS Description Property identification number Material identification number Cross-section group name Cross section type Cross-section dimensions and NSM Word 7 repeats until End of Record Record 6 – PBCOMP(5403,55,349) Word 1 2 3 Name PID MID A Type I I RS Description Property identification number Material identification number Area 3-88 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 5 6 7 8 9 10 11 12 13 14 15 Word NSECT =0 16 17 18 Name I1 I2 I12 J NSM K1 K2 M1 M2 N1 N2 NSECT(C) Name Type RS RS RS RS RS RS RS RS RS RS RS I Type Description Area moment of inertia in plane 1 Area moment of inertia in plane 2 Area product of inertia for plane 1 and 2 Torsional constant Nonstructural mass per unit length Area factor for shear in plane 1 Area factor for shear in plane 2 Location center of gravity of nonstructural mass along y-axis Location center of gravity of nonstructural mass along y-axis Location neutral axis along element’s y-axis Location neutral axis along element’s y-axis Number of lumped areas Description Y Z UNDEF(3 ) RS RS None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Words 16 through 20 repeat 4 times Word NSECT =1 16 17 18 19 Y Z C MID RS RS RS I Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description NX Nastran DMAP Programmer’s Guide 3-89 Chapter 3 Data Block Descriptions B-E Word 20 Name UNDEF Type None Description Words 16 through 20 repeat NSECT times Name Type Word NSECT =2 16 17 18 19 20 Description Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Words 16 through 20 repeat NSECT times Word NSECT =3 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =4 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description 3-90 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =5 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =6 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =7 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times NX Nastran DMAP Programmer’s Guide 3-91 Chapter 3 Data Block Descriptions B-E Word NSECT =8 16 17 18 19 20 Name Type Description Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Words 16 through 20 repeat NSECT times Word NSECT =9 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =10 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =11 Name Type Description 3-92 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 16 17 18 19 20 Name Y Z C MID UNDEF Type RS RS RS I None Description Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Words 16 through 20 repeat NSECT times Word NSECT =12 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =13 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =14 16 Y RS Lumped area location along element’s y-axis Name Type Description NX Nastran DMAP Programmer’s Guide 3-93 Chapter 3 Data Block Descriptions B-E Word 17 18 19 20 Name Z C MID UNDEF Type RS RS I None Description Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Words 16 through 20 repeat NSECT times Word NSECT =15 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =16 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =17 16 17 Y Z RS RS Lumped area location along element’s y-axis Lumped area location along element’s z-axis Name Type Description 3-94 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 18 19 20 Name C MID UNDEF Type RS I None Description Fraction of the total area for the lumped area Material identification number Words 16 through 20 repeat NSECT times Word NSECT =18 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =19 16 17 18 19 20 Y Z C MID UNDEF RS RS RS I None Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Material identification number Name Type Description Words 16 through 20 repeat NSECT times Word NSECT =20 16 17 18 Y Z C RS RS RS Lumped area location along element’s y-axis Lumped area location along element’s z-axis Fraction of the total area for the lumped area Name Type Description NX Nastran DMAP Programmer’s Guide 3-95 Chapter 3 Data Block Descriptions B-E Word 19 20 Name MID UNDEF Type I None Description Material identification number Words 16 through 20 repeat NSECT times End NSECT Record 7 – PBEAM(5402,54,262) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name PID MID NSEGS CCF X SO XXB A I1 I2 I12 J NSM C1 C2 D1 D2 Type I I I I RS RS RS RS RS RS RS RS RS RS RS RS RS Stress output request Distance ratio from end A Area Area moment of inertia in plane 1 Area moment of inertia in plane 2 Area product of inertia for plane 1 and 2 Torsional constant Nonstructural mass per unit length Stress recovery location at point C in element y-axis Stress recovery location at point C in element z-axis Stress recovery location at point D in element y-axis Stress recovery location at point D in element z-axis Description Property identification number Material identification number Number of segments* Constant cross-section flag: 1=yes and 0=no 3-96 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 18 19 20 21 Name E1 E2 F1 F2 Type RS RS RS RS Description Stress recovery location at point E in element y-axis Stress recovery location at point E in element z-axis Stress recovery location at point F in element y-axis Stress recovery location at point F in element z-axis Words 6 through 21 repeat 11 times 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 K1 K2 S1 S2 NSIA NSIB CWA CWB M1A M2A M1B M2B N1A N2A N1B RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Area factor for shear in plane 1 Area factor for shear in plane 2 Shear relief coefficient due to taper for plane 1 Shear relief coefficient due to taper for plane 1 Nonstructural mass moment of inertia per unit length at end A Nonstructural mass moment of inertia per unit length at end B Warping coefficient for end A Warping coefficient for end B Location of C.G. of nonstructural mass at end A along y-axis Location of C.G. of nonstructural mass at end A along z-axis Location of C.G. of nonstructural mass at end B along y-axis Location of C.G. of nonstructural mass at end B along z-axis Location of neutral axis at end A along element’s y-axis Location of neutral axis at end A along element’s z-axis Location of neutral axis at end B along element’s y-axis NX Nastran DMAP Programmer’s Guide 3-97 Chapter 3 Data Block Descriptions B-E Word 37 Name N2B Type RS Description Location of neutral axis at end B along element’s z-axis Record 8 – PBEAML(9202,92,53) Word 1 2 3 5 7 Name PID MID GROUP(2) TYPE(2) VALUE Type I I CHAR4 CHAR4 RS Description Property identification number Material identification number Cross-section group name Cross section type Cross section values for XXB, SO, NSM, and dimensions Word 7 repeats until (–1) occurs Record 9 – PBEND(2502,25,248) Word 1 2 3 4 5 6 7 8 9 10 11 12 Name PID MID A I1 I2 J FSI RM T P RB THETAB Type I I RS RS RS RS I RS RS RS RS RS Description Property identification number Material identification number Area Area moment of inertia in plane 1 Area moment of inertia in plane 2 Torsional constant Flexibility and stress intensification factors Mean cross-sectional radius of the curved pipe Wall thickness of the curved pipe Internal pressure Bend radius of the line of centroids Arc angle of element 3-98 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Name C1 C2 D1 D2 E1 E2 F1 F2 K1 K2 NSM RC ZC DELTAN SACL ALPHA FLANGE KX KY Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS I RS RS Description Stress recovery location at point C in element y-axis Stress recovery location at point C in element z-axis Stress recovery location at point D in element y-axis Stress recovery location at point D in element z-axis Stress recovery location at point E in element y-axis Stress recovery location at point E in element z-axis Stress recovery location at point F in element y-axis Stress recovery location at point F in element z-axis Area factor for shear in plane 1 Area factor for shear in plane 2 Nonstructural mass per unit length Radial offset of the geometric centroid Offset of the geometric centroid Radial offset of the neutral axis from the geometric centroid Miter spacing at center line. One-half angle between the adjacent miter axis (Degrees). For FSI=5, defines the number of flanges attached. For FSI=6, the user defined flexibility factor for the torsional moment. For FSI=6, the user defined flexibility factor for the out-of-plane bending moment. NX Nastran DMAP Programmer’s Guide 3-99 Chapter 3 Data Block Descriptions B-E Word 32 33 34 35 Name KZ Not used SY SZ Type RS Description For FSI=6, the user defined flexbility factor for the in-plane bending moment. RS RS For FSI=6, the user defined stress intensification factor for the out-of-plane bending. For FSI=6, the user defined stress intensification factor for the in-plane bending. Record 10 – PBUSH(1402,14,37) Word 1 2 8 14 15 16 17 18 Name PID K(6) B(6) GE1 SA ST EA ET Type I RS RS RS RS RS RS RS Description Property identification number Nominal stiffness values Nominal damping coefficient Nominal structural damping constant Stress recovery coefficient in the translational component Stress recovery coefficient in the rotational component Strain recovery coefficient in the translational component Strain recovery coefficient in the rotational component Record 11 – PBUSH1D(3101,31,219) Word 1 2 3 4 5 Name PID K C M ALPHA Type I RS RS RS RS Description Property identification number Stiffness Viscous Damping Mass Temperature coefficient 3-100 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 Name SA EA TYPEA CVT CVC EXPVT EXPVC IDTSU IDTCU IDTSUD IDCSUD TYPES IDTS IDCS IDTDU IDCDU TYPED IDTD IDTD IDTDV Type RS RS I RS RS RS RS I I I I I I I I I I I I I Description Stress recovery coefficient Strain recovery coefficient Shock data type: 0=Null, 1=Table, 2=Equation Coefficient of translation velocity tension Coefficient of translation velocity compression Exponent of velocity tension Exponent of velocity compression TABLEDi or DEQATN entry identification number for scale factor vs displacement DEQATN entry identification number for scale factor vs displacement DEQATN entry identification number for derivative tension DEQATN entry identification number for derivative compression Spring data type: 0=Null, 1=Table, 2=Equation TABLEDi or DEQATN entry identification number for tension compression DEQATN entry identification number for compression DEQATN entry identification number for scale factor vs displacement DEQATN entry identification number for force vs displacement Damper data type: 0=Null, 1=Table, 2=Equation TABLEDi or DEQATN entry identification number for tension compression DEQATN entry identification number for compression DEQATN entry identification number for scale factor versus velocity NX Nastran DMAP Programmer’s Guide 3-101 Chapter 3 Data Block Descriptions B-E Word 26 27 28 29 30 31 32 33 34 35 36 37 38 Name IDCDV TYPEG IDTG IDCG IDTDU IDCDU IDTDV IDCDV TYPEF IDTF IDCF UT UC Type I I I I I I I I I I I RS RS Description DEQATN entry identification number for force versus velocity General data type: 0=Null, 1=Table, 2=Equation TABLEDi or DEQATN entry identification number for tension compression DEQATN entry identification number for compression DEQATN entry identification number for scale factor versus displacement DEQATN entry identification number for force versus displacement DEQATN entry identification number for scale factor versus velocity DEQATN entry identification number for force vs velocity Fuse data type: 0=Null, 1=Table TABLEDi entry identification number for tension TABLEDi entry identification number for compression Ultimate tension Ultimate compression Record 12 – PBUSHT(702,7,38) Word 1 2 8 14 15 Name PID TKID(6) TBID(6) TGEID TKNID(6) Type I I I I I Description Property identification number TABLEDi entry identification numbers for stiffness TABLEDi entry identification numbers for viscous damping TABLEDi entry identification number for structural damping TABLEDi entry IDs for force versus deflection 3-102 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 13 – PCOMP(2706,27,287) Word 1 2 3 4 5 6 7 8 9 10 11 12 Name PID N(C) Z0 NSM SB FT TREF GE MID T THETA SOUT Type I I RS RS RS I RS RS I RS RS I Description Property identification number Number of plies Distance from the reference plane to the bottom surface Nonstructural mass per unit area Allowable shear stress of the bonding material Failure theory Reference temperature Damping coefficient Material identification number Thicknesses of the ply Orientation angle of the longitudinal direction of the ply Stress or strain output request of the ply Words 9 through 12 repeat N times Record 14 – PCONEAX(152,19,147) Word 1 2 3 4 5 6 7 8 Name PID MID1 T1 MID2 I MID3 T2 NSM Type I I RS I RS I RS RS Description Property identification number Material identification number for membrane Membrane thickness Material identification number for bending Moment of inertia per unit width Material identification number for transverse shear Transverse shear thickness Nonstructural mass per unit area NX Nastran DMAP Programmer’s Guide 3-103 Chapter 3 Data Block Descriptions B-E Word 9 10 11 Name Z1 Z2 PHI Type RS RS RS Description Fiber distance 1 from the middle surface for stress recovery Fiber distance 2 from the middle surface for stress recovery Azimuthal angle for stress recovery Word 11 repeats 14 times Record 15 – PCONV(11001,110,411) Word 1 2 3 4 Name PID MID FORM EXPF Type I I I RS Description Property identification number Material identification number Type of formula used for free convection Free convection exponent Record 16 – PCONVM(2902,29,420) Word 1 2 3 4 5 6 7 8 Name PID MID FORM FLAG COEF EXPR EXPPI EXPPO Type I I I I RS RS RS RS Description Property identification number Material identification number Type of formula used for free convection Flag for mass flow convection Constant coefficient used for forced convection Reynolds number convection exponent Prandtl number convection exponent into the working fluid Prandtl number convection exponent out of the working fluid 3-104 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 17 – PDAMP(202,2,45) Word 1 2 Name PID B Type I RS Description Property identification number Force per unit velocity Record 18 – PDAMPT(1202,12,33) Word 1 2 Name PID TBID Type I I Description Property identification number TABLEDi entry identification number for viscous damping Record 19 – PDAMP5(8702,87,412) Word 1 2 3 Name PID MID B Type I I RS Description Property identification number Material identification number Damping multiplier Record 20 – PDUM1(6102,61,116) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 21 – PDUM2(6202,62,117) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 22 – PDUM3(6302,63,118) Word 1 Name UNDEF Type None Description NX Nastran DMAP Programmer’s Guide 3-105 Chapter 3 Data Block Descriptions B-E Word Name Type Description Word 1 repeats until End of Record Record 23 – PDUM4(6402,64,159) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 24 – PDUM5(6502,65,160) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 25 – PDUM6(6602,66,161) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 26 – PDUM7(6702,67,163) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 27 – PDUM8(6802,68,164) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record 3-106 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 28 – PDUM9(6902,69,165) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 29 – PELAS(302,3,46) Word 1 2 3 4 Name PID K GE S Type I RS RS RS Description Property identification number Elastic property value Damping coefficient Stress coefficient Record 30 – PELAST(1302,13,34) Word 1 2 3 4 Name PID TKID TGEID TKNID Type I I I I Description Property identification number TABLEDi entry identification number for stiffness TABLEDi entry identification number for structural damping TABLEDi entry identification number for force vs. deflection Record 31 – PGAP(2102,21,121) Word 1 2 3 4 5 6 Name PID UO FO KA KB KT Type I RS RS RS RS RS Description Property identification number Initial gap opening Preload Axial stiffness for the closed gap Axial stiffness for the open gap Transverse stiffness when the gap is closed NX Nastran DMAP Programmer’s Guide 3-107 Chapter 3 Data Block Descriptions B-E Word 7 8 9 10 11 Name MU1 MU2 TMAX MAR TRMIN Type RS RS RS RS RS Description Coefficient of static friction Coefficient of kinetic friction Maximum allowable penetration Maximum allowable adjustment ratio Fraction of TMAX for the lower bound of penetration Record 32 – PHBDY(2802,28,236) Word 1 2 3 4 Name PID AF D1 D2 Type I RS RS RS Description Property identification number Area factor of the surface Diameter 1 associated with the surface Diameter 1 associated with the surface Record 33 – PINTC(12001,120,480) Word 1 2 3 4 Name PID TOL DSCALE UNDEF(5 ) Type I RS RS None Description Property identification number Tolerance between interface elements and subdomain boundaries Scaling parameter for Lagrange multiplier functions Record 34 – PINTS(12101,121,484) Word 1 2 3 Name PID TOL DSCALE Type I RS RS Description Property identification number Tolerance between interface elements and subdomain boundaries Scaling parameter for Lagrange multiplier functions 3-108 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 4 Name UNDEF(5 ) Type None Description Record 35 – PLPLANE(4606,46,375) Word 1 2 3 4 5 Name PID MID CID STR UNDEF(7 ) Type I I I CHAR4 None Description Property identification number Material identification number Coordinate system identification number Location of stress and strain output Record 36 – PLSOLID(4706,47,376) Word 1 2 3 4 Name PID MID STR UNDEF(4 ) Type I I CHAR4 None Description Property identification number Material identification number Location of stress and strain output Record 37 – PMASS(402,4,44) Word 1 2 Name PID M Type I RS Description Property identification number Mass Record 38 – PROD(902,9,29) Word 1 2 3 4 Name PID MID A J Type I I RS RS Description Property identification number Material identification number Area Torsional constant NX Nastran DMAP Programmer’s Guide 3-109 Chapter 3 Data Block Descriptions B-E Word 5 6 Name C NSM Type RS RS Description Coefficient to determine torsional stress Nonstructural mass per unit length Record 39 – PSHEAR(1002,10,42) Word 1 2 3 4 5 6 Name PID MID T NSM F1 F2 Type I I RS RS RS RS Description Property identification number Material identification number Thickness o Nonstructural mass per unit area. Effectiveness factor for stiffness along edges 1-2 and 3-4 Effectiveness factor for stiffness along edges 2-3 and 1-4 Record 40 – PSHELL(2302,23,283) Word 1 2 3 4 5 6 7 8 9 10 11 Name PID MID1 T MID2 BK MID3 TS NSM Z1 Z2 MID4 Type I I RS I RS I RS RS RS RS I Description Property identification number Material identification number for the membrane Default membrane thickness for Ti on the connection entry Material identification number for bending Bending moment of inertia ratio Material identification number for transverse shear Transverse shear thickness ratio Nonstructural mass per unit area Fiber distance 1 for stress calculation Fiber distance 1 for stress calculation Material identification number for membrane-bending coupling 3-110 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 41 – PSOLID(2402,24,281) Word 1 2 3 4 5 6 7 Name PID MID CORDM IN STRESS ISOP FCTN Type I I I I I I CHAR4 Description Property identification number Material identification number Material coordinate system identification number Integration network Location selection for stress output Integration scheme Fluid element flag Record 42 – PSOLIDL(7602,76,370) Word 1 2 3 4 5 6 7 8 9 10 Name PID FT TREF GE NSM NLAY MID T1 THETA SOUT Type I I RS RS RS I I RS RS I Material identification number Description Property identification number Words 7 through 10 repeat 40 times Record 43 – PTRIA6(6202,62,117) Word 1 Name PID Type I Description Property identification number NX Nastran DMAP Programmer’s Guide 3-111 Chapter 3 Data Block Descriptions B-E Word 2 3 Name MID REAL(4) Type I RS Description Material identification number Record 44 – PTUBE(1602,16,30) This record is slightly unstructured: OD2 is only written out if heat transfer Word 1 2 3 4 5 6 Name PID MID OD T NSM OD2 Type I I RS RS RS RS Description Property identification number Material identification number Outside diameter of tube Thickness of tube Nonstructural mass per unit length Heat transfer only: Outside diameter of tube Record 45 – PSET(10301,103,399) Word 1 2 3 4 5 6 7 Name ID POLY1 POLY2 POLY3 CID TYPE TYPEID Type I I I I I CHAR4 I Description p-value set identification number Polynomial order in 1 direction of the CID system Polynomial order in 2 direction of the CID system Polynomial order in 2 direction of the CID system Coordinate system identification number Type of set provided: "SET" or "ELID" SET identification number or element identification number with this p-value specification. Words 1 through 7 repeat until End of Record Record 46 – PVAL(10201,102,400) Word 1 Name ID Type I Description p-value set identification number 3-112 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 2 3 4 5 6 7 Name POLY1 POLY2 POLY3 CID TYPE TYPEID Type I I I I CHAR4 I Description Polynomial order in 1 direction of the CID system Polynomial order in 2 direction of the CID system Polynomial order in 2 direction of the CID system Coordinate system identification number Type of set provided: "SET" or "ELID" SET identification number or element identification number with this p-value specification. Words 1 through 7 repeat until End of Record Record 47 – PVISC(1802,18,31) Word 1 2 3 Name PID CE CR Type I RS RS Description Property identification number Viscous damping for extension Viscous damping for rotation Record 48 – PWELD(11801,118,560) Word 1 2 3 4 5 6 7 8 9 Name PID MID D CONNBEH CONNTYPE EXTCON CONDTYPE WELDTYPE MINLEN Type I I RS I I I I I RS Description Property identification number Material property identification number Diameter of the spot weld Connection behavior (0=FF/F, 1=FR, 10=RF/R, 11=RR) Connection type (0=clamp, 1=hinge, 2=bolt) External constraint flag (0=off, 1=on) Condition type (0=rigid, 1=equivalent) Weld type (0=spot weld, 1=but seam, 2=T-seam) Minimum length of spot weld NX Nastran DMAP Programmer’s Guide 3-113 Chapter 3 Data Block Descriptions B-E Word 10 11 12 13 14 Name MAXLEN GMCHK SPCGS CMASS UNDEF(1) Type RS I I RS None Description Maximum length of spot weld Perform geometry check SPC the master grid GS Concentrated mass Record 49 – VIEW(2606,26,289) Word 1 2 3 4 5 6 Name IVIEW ICAVITY SHADE NB NG DISLIN Type I I I I I RS Description View identification number Cavity identification number Shadowing flag for the face of CHBDYi element Subelement mesh size in the beta direction Subelement mesh size in the gamma direction Displacement of a surface perpendicular to the surface Record 50 – VIEW3D(3002,30,415) Word 1 2 3 4 5 6 7 8 Name ICAVITY GITB GIPS CIER ETOL ZTOL WTOL RADCHK Type I I I I RS RS RS I Description Radiant cavity identification number Gaussian integration order for third-body shadowing Gaussian integration order for self-shadowing Discretization level Error estimate Zero tolerance Warpage tolerance Radiation exchange diagnostic output level 3-114 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Record 51 – TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words 3.20 EQEXIN Equivalence between external and internal grid/scalar numbers Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – EXT2INT Contains pairs of external grid and scalar identification numbers and internal numbers in external sort. Word 1 2 Name GRIDID INTID Type I I Description External grid or scalar identification number Internal identification number Record 2 – EXT2SIL Contains pairs of external grid and scalar numbers and coded SIL numbers in external sort. Word 1 2 Name GRIDID TENXSIL Type I I Description External grid or scalar identification number 10*SIL number + code (See Note) Record 3 – TRAILER Word 1 2 Name NGS UNDEF(5 ) Type I None Description Total number of grid scalar points NX Nastran DMAP Programmer’s Guide 3-115 Chapter 3 Data Block Descriptions B-E Notes: In TENXSIL, the 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: 1 2 3 for grid point for scalar point for extra point For example, if there are three grid points in the model, the three SIL numbers are 1, 7, and 13 and the TENXSIL numbers are 11, 71, and 131. 3.21 ERROR Table of p-element error tolerances Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 – ERROR Word 1 2 3 6 7 8 Name EID ERRMAX P(3) ERRCAS WHYCAS WHYALL Type I RS I RS I I Description Element identification number Accumulated Maximum error for all subcases Polynomial order in x,y,z directions Calculated error for current subcase Why an element is excluded from error analysis Accumulation over all subcases of previous item Words 1 through 8 repeat until End of Record Record 2 – TRAILER Word 1 Name NWERRN Type I Description Used by OFPVUI subroutine 3-116 NX Nastran DMAP Programmer’s Guide Data Block Descriptions B-E Word 2 3 4 5 6 Name ERRPRN PVALDV ILOOP PVALID UNDEF Type I I I I None Description Accumulates error print requests Accumulates PVAL card print/punch requests. To check with current ILOOP for new adaptivity loop To be used as old PVAL identification number. Updated only when SEID=0 Notes: WHYCAS is composed of bits for internal use only. Bits include values for ERRTOL,SIGTOL,EPSTOL,ERRGRD,ERRELM 3.22 EST Element Summary Table EST is a collection of data from other data blocks for all elements. The format of EST is not included in this manual, but the datablocks ECT, EPT and ETT which contribute to EST are. The format of EST can be viewed by opening est.ddl in a text editor: install_path\nxnr\nast\del\est.ddl. NX Nastran DMAP Programmer’s Guide 3-117 Chapter 4 Data Block Descriptions F-M • • • • • • • • • • • • FOL GEOM1 GEOM168 GEOM2 GEOM3 GEOM4 GPDT68 GPL HIS KDICT LAMA MPT NX Nastran DMAP Programmer’s Guide 4-1 Chapter 4 Data Block Descriptions F-M 4.1 FOL Frequency response frequency output list Record 0 – HEADER Word 1 3 Name NAME(2) FREQ Type CHAR4 RS Description Data block name Frequency Word 3 repeats until End of Record Record 1 – TRAILER Word 1 2 3 4 Name WORD1 WORD2 WORD3 UNDEF(3 ) Type I I I None Description Number of frequencies Frequency set record number Number of loads 4.2 GEOM1 Table of Bulk Data entry images related to geometry Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – CORD1C(1701,17,6) Word 1 2 3 4 5 Name CID TWO ONE G1 G2 Type I I I I I Description Coordinate system identification number Constant 2 Constant 1 Grid point 1 identification number Grid point 2 identification number 4-2 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 6 Name G3 Type I Description Grid point 3 identification number Record 2 – CORD1R(1801,18,5) Word 1 2 3 4 5 6 Name CID ONE1 ONE2 G1 G2 G3 Type I I I I I I Description Coordinate system identification number Constant 1 Constant 1 Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number Record 3 – CORD1S(1901,19,7) Word 1 2 3 4 5 6 Name CID THREE ONE G1 G2 G3 Type I I I I I I Description Coordinate system identification number Constant 3 Constant 1 Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number Record 4 – CORD2C(2001,20,9) Word 1 2 3 4 5 Name CID TWO1 TWO2 RID A1 Type I I I I RX Description Coordinate system identification number Constant 2 Constant 2 Reference coordinate system identification number Location of A in coordinate 1 of RID NX Nastran DMAP Programmer’s Guide 4-3 Chapter 4 Data Block Descriptions F-M Word 6 7 8 9 10 11 12 13 Name A2 A3 B1 B2 B3 C1 C2 C3 Type RX RX RX RX RX RX RX RX Description Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID Record 5 – CORD2R(2101,21,8) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 Name CID ONE TWO RID A1 A2 A3 B1 B2 B3 C1 C2 C3 Type I I I I RX RX RX RX RX RX RX RX RX Description Coordinate system identification number Constant 1 Constant 2 Reference coordinate system identification number Location of A in coordinate 1 of RID Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID 4-4 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 6 – CORD2S(2201,22,10) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 Name CID SIXTY5 EIGHT RID A1 A2 A3 B1 B2 B3 C1 C2 C3 Type I I I I RX RX RX RX RX RX RX RX RX Description Coordinate system identification number Constant 65 or 3? Constant 8 or 2? Reference coordinate system identification number Location of A in coordinate 1 of RID Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID Record 7 – CSUPER(2301,23,304) Word 1 2 3 Name SSID PSID G Type I I I Description Coded identification number for secondary superelement Primary superelement identification number Exterior grid or scalar point identificaiton numbers Word 3 repeats until End of Record Record 8 – CSUPEXT(5501,55,297) Word 1 Name SEID Type I Description Superelement identification number NX Nastran DMAP Programmer’s Guide 4-5 Chapter 4 Data Block Descriptions F-M Word 2 Name G Type I Description Grid or scalar point IDs in the downstream superelement Word 2 repeats until End of Record Record 9 – EXTRN(1627,16,463) Word 1 2 Name GID C Type I I Description Grid point identification numbers to connect external SE Component numbers Words 1 through 2 repeat until (-1,-1) occurs Record 10 – FEEDGE(6101,61,388) Word 1 2 3 4 5 6 7 Name EDGEID GRID1 GRID2 CID GEOMIN GEOMID1 GEOMID2 Type I I I I CHAR4 I I Description Edge identification number Identification number of end GRID 1 Identification number of end GRID 2 Coordinate system identification number Type of referencing entry: "GMCURV" or "POINT" Identification number of a POINT or GMCURV entry Identification number of a POINT or GMCURV entry Record 11 – GMCURV(6601,66,392) Word 1 2 4 Name CURVID GROUP(2) CIDIN Type I CHAR4 I Description Curve identification number Group of curves/surfaces to which this curve belongs Coordinate system identification number for the geometry 4-6 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 5 6 Name CIDBC DATA Type I CHAR4 Description Coordinate system identification number for the constraints Geometry evaluator specific data Word 6 repeats until End of Record Record 12 – FEFACE(6201,62,389) Word 1 2 3 4 5 6 7 Name FACEID GRID1 GRID2 GRID3 GRID4 CIDBC SURFID(2) Type I I I I I I I Description Face identification number Identification number of end GRID 1 Identification number of end GRID 2 Identification number of end GRID 3 Identification number of end GRID 4 Coordinate system identification number for the constraints Alternate method used to specify the geometry Record 13 – POINT(6001,60,377) Word 1 2 3 4 5 Name ID CID X1 X2 X3 Type I I RX RX RX Description Point identification number Coordinate system identification number Location of the point in coordinate 1 of CID Location of the point in coordinate 2 of CID Location of the point in coordinate 3 of CID Record 14 – GMSURF(10101,101,394) Word 1 2 Name ID GROUP(2) Type I CHAR4 Description Surface Identification number Group of curves/surfaces to which this curve belongs NX Nastran DMAP Programmer’s Guide 4-7 Chapter 4 Data Block Descriptions F-M Word 4 5 6 Name CIDIN CIDBC DATA Type I I CHAR4 Description Coordinate system identification number for the geometry Coordinate system identification number for the constraints Geometry evaluator specific data Word 6 repeats until End of Record Record 15 – GMCORD(6401,64,402) Word 1 2 3 4 Name CID ENTITY ID1 ID2 Type I CHAR4 I I Description Coordinate system identification number Bulk Data entry used to define the coordinate system Entity identification number 1 Entity identification number 2 Record 16 – GRID(4501,45,1) Word 1 2 3 4 5 6 7 8 Name ID CP X1 X2 X3 CD PS SEID Type I I RX RX RX I I I Description Grid point identification number Location coordinate system identification number Location of the point in coordinate 1 of CP Location of the point in coordinate 2 of CP Location of the point in coordinate 3 of CP Degree-of-freedom coordinate system identification number Permanent single-point constraints Superelement identification number 4-8 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 17 – SEBNDRY(1527,15,466) Word 1 2 3 Name SEIDA SEIDB G Type I I I Description Superelement A identification number Superelement B identification number Boundary grid point identification number in SEIDA Word 3 repeats until End of Record Record 18 – SEBULK(1427,14,465) Word 1 2 3 4 5 6 7 8 Name SEID TYPE RSEID METHOD TOL LOC MEDIA UNIT Type I I I I RS I I I Description Superelement identification number Superelement type Reference superelement identification number Boundary point search method: 1=automatic or 2=manual Location tolerance Coincident location check option: yes=1 or no=2 Media format of boundary data of external SE FORTRAN unit number of OP2 and OP4 input of external SE Record 19 – SECONCT(427,4,453) Word 1 2 3 4 5 9 10 Name SEIDA SEIDB TOL LOC UNDEF(4 ) GA GB Type I I RS I None I I Grid point identification number in SEIDA Grid point identification number in SEIDB Description Superelement A identification number Superelement B identification number Location tolerance Coincident location check option: yes=1 or no=2 NX Nastran DMAP Programmer’s Guide 4-9 Chapter 4 Data Block Descriptions F-M Word Name Type Description Words 9 through 10 repeat until (-1,-1) occurs Record 20 – SEELT(7902,79,302) Word 1 2 Name SEID EID Type I I Description Superelement identification number Element identification number Word 2 repeats until End of Record Record 21 – SEEXCLD(527,72,454) Word 1 2 3 Name SEIDA SEIDB GA Type I I I Description Superelement A identification number Superelement B identification number or -1 for all Grid point identification number in SEIDA Word 3 repeats until End of Record Record 22 – SELABEL(1027,10,459) Word 1 2 Name SEID LABEL(14) Type I CHAR4 Description Superelement identification number Label associated with superelement SEID Record 23 – SELOC(827,8,457) Word 1 2 3 4 5 Name SEID GA1 GA2 GA3 GB1 Type I I I I I Description Superelement identification number Grid point 1 identification number in SEID Grid point 2 identification number in SEID Grid point 3 identification number in SEID Grid point 1 identification number in the main Bulk Data 4-10 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 6 7 Name GB2 GB3 Type I I Description Grid point 2 identification number in the main Bulk Data Grid point 3 identification number in the main Bulk Data Record 24 – SEMPLN(927,9,458) Word 1 2 MIRRTYPE=1 3 4 5 6 MIRRTYPE=2 3 4 5 6 7 G CID N1 N2 N3 G1 G2 G3 UNDEF(2 ) Name SEID MIRRTYPE Type I I Plane I I I None Normal I I RS RS RS Grid point identification number in the main Bulk Data Coordinate system identification number Normal component in direction 1 of CID Normal component in direction 2 of CID Normal component in direction 3 of CID Grid point 1 identification number in the main Bulk Data Grid point 2 identification number in the main Bulk Data Grid point 3 identification number in the main Bulk Data Not Defined Description Superelement identification number Mirror type End MIRRTYPE Record 25 – SENQSET(1327,13,464) Word 1 2 Name SEID NQSET Type I I Description Superelement identification number Number of internally generated scalar points NX Nastran DMAP Programmer’s Guide 4-11 Chapter 4 Data Block Descriptions F-M Record 26 – SEQGP(5301,53,4) Word 1 2 Name ID SEQID Type I I Description Grid or scalar point identification number Sequenced identification number Record 27 – SEQSEP(5401,54,305) Word 1 2 3 Name SSID PSID G Type I I I Description Secondary superelement identification number Primary superelement identification number Exterior grid or scalar point identificaiton numbers Word 3 repeats until End of Record Record 28 – SESET(5601,56,296) Word 1 2 Name SEID G Type I I Description Superelement identification number Grid or scalar point identification number Word 2 repeats until End of Record Record 29 – SETREE(1227,12,462) Word 1 2 Name SEID SEUPI Type I I Description Superelement identification number Upstream superelement identification number Word 2 repeats until End of Record Record 30 – SNORM(5678,71,475) Word 1 2 Name GID CID Type I I Description Grid point identification number Coordinate system identification number 4-12 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 3 4 5 Name N1 N2 N3 Type RS RS RS Description Normal component in direction 1 of CID Normal component in direction 2 of CID Normal component in direction 3 of CID Record 31 – CSUPER1(5701,57,323) This record is obsolete. Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 XX =0 16 17 G C Name SEID PSID TYPE VIEW DIROPT DIRTOL GEOMTOL CARDID MODEL SOLID DBSET COPY DELETE GRIDLIST XX Type I I I I I RS RS I I I I I I I I xx I I ,{ ,{ Description Superelement identification number Primary superelement identification number ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ xx Words 16 through 17 repeat until (-1,-1,-1) occurs XX =–1 yy NX Nastran DMAP Programmer’s Guide 4-13 Chapter 4 Data Block Descriptions F-M Word End XX Name Type Description Record 32 – CSUPUP(5801,58,324) This record is obsolete. Word 1 2 3 4 5 6 Name SEUP1 PSID SEDOWN1 SEUP2 PSID SEDOWN2 Type I I I I I I Description ,{ Primary superelement identification number ,{ ,{ Primary superelement identification number ,{ Record 33 – TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words Notes: 1. CSUPER1 and CSUPUP records are recognized only by IFP module and are 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 id 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 4-14 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M • 6=MIRROR 4.3 GEOM168 Table of Bulk Data entry images related to geometry Pre-Version 69 Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – CORD1C(1701,17,6) Word 1 2 3 4 5 6 Name CID TWO ONE G1 G2 G3 Type I I I I I I Description Coordinate system identification number Constant 2 Constant 1 Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number Record 2 – CORD1R(1801,18,5) Word 1 2 3 4 5 6 Name CID ONE1 ONE2 G1 G2 G3 Type I I I I I I Description Coordinate system identification number Constant 1 Constant 1 Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number NX Nastran DMAP Programmer’s Guide 4-15 Chapter 4 Data Block Descriptions F-M Record 3 – CORD1S(1901,19,7) Word 1 2 3 4 5 6 Name CID THREE ONE G1 G2 G3 Type I I I I I I Description Coordinate system identification number Constant 3 Constant 1 Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number Record 4 – CORD2C(2001,20,9) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 Name CID TWO1 TWO2 RID A1 A2 A3 B1 B2 B3 C1 C2 C3 Type I I I I RS RS RS RS RS RS RS RS RS Description Coordinate system identification number Constant 2 Constant 2 Reference coordinate system identification number Location of A in coordinate 1 of RID Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID Record 5 – CORD2R(2101,21,8) Word 1 Name CID Type I Description Coordinate system identification number 4-16 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 3 4 5 6 7 8 9 10 11 12 13 Name ONE TWO RID A1 A2 A3 B1 B2 B3 C1 C2 C3 Type I I I RS RS RS RS RS RS RS RS RS Description Constant 1 Constant 2 Reference coordinate system identification number Location of A in coordinate 1 of RID Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID Record 6 – CORD2S(2201,22,10) Word 1 2 3 4 5 6 7 8 9 10 11 Name CID SIXTY5 EIGHT RID A1 A2 A3 B1 B2 B3 C1 Type I I I I RS RS RS RS RS RS RS Description Coordinate system identification number Constant 65 or 3? Constant 8 or 2? Reference coordinate system identification number Location of A in coordinate 1 of RID Location of A in coordinate 2 of RID Location of A in coordinate 3 of RID Location of B in coordinate 1 of RID Location of B in coordinate 2 of RID Location of B in coordinate 3 of RID Location of C in coordinate 1 of RID NX Nastran DMAP Programmer’s Guide 4-17 Chapter 4 Data Block Descriptions F-M Word 12 13 Name C2 C3 Type RS RS Description Location of C in coordinate 2 of RID Location of C in coordinate 3 of RID Record 7 – CSUPER(2301,23,304) Word 1 2 3 Name SSID PSID G Type I I I Description Coded identification number for secondary superelement Primary superelement identification number Exterior grid or scalar point identificaiton numbers Word 3 repeats until End of Record Record 8 – CSUPEXT(5501,55,297) Word 1 2 Name SEID G Type I I Description Superelement identification number Grid or scalar point IDs in the downstream superelement Word 2 repeats until End of Record Record 9 – EXTRN(1627,16,463) Word 1 2 Name GID C Type I I Description Grid point identification numbers to connect external SE Component numbers Words 1 through 2 repeat until (-1,-1) occurs Record 10 – FEEDGE(6101,61,388) Word 1 2 Name EDGEID GRID1 Type I I Description Edge identification number Identification number of end GRID 1 4-18 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 3 4 5 6 7 Name GRID2 CID GEOMIN GEOMID1 GEOMID2 Type I I CHAR4 I I Description Identification number of end GRID 2 Coordinate system identification number Type of referencing entry: "GMCURV" or "POINT" Identification number of a POINT or GMCURV entry Identification number of a POINT or GMCURV entry Record 11 – GMCURV(6601,66,392) Word 1 2 4 5 6 Name CURVID GROUP(2) CIDIN CIDBC DATA Type I CHAR4 I I CHAR4 Description Curve identification number Group of curves/surfaces to which this curve belongs Coordinate system identification number for the geometry Coordinate system identification number for the constraints Geometry evaluator specific data Word 6 repeats until End of Record Record 12 – FEFACE(6201,62,389) Word 1 2 3 4 5 6 7 Name FACEID GRID1 GRID2 GRID3 GRID4 CIDBC SURFID(2) Type I I I I I I I Description Face identification number Identification number of end GRID 1 Identification number of end GRID 2 Identification number of end GRID 3 Identification number of end GRID 4 Coordinate system identification number for the constraints Alternate method used to specify the geometry NX Nastran DMAP Programmer’s Guide 4-19 Chapter 4 Data Block Descriptions F-M Record 13 – POINT(6001,60,377) Word 1 2 3 4 5 Name ID CID X1 X2 X3 Type I I RS RS RS Description Point identification number Coordinate system identification number Location of the point in coordinate 1 of CID Location of the point in coordinate 2 of CID Location of the point in coordinate 3 of CID Record 14 – GMSURF(10101,101,394) Word 1 2 4 5 6 Name ID GROUP(2) CIDIN CIDBC DATA Type I CHAR4 I I CHAR4 Description Surface Identification number Group of curves/surfaces to which this curve belongs Coordinate system identification number for the geometry Coordinate system identification number for the constraints Geometry evaluator specific data Word 6 repeats until End of Record Record 15 – GMCORD(6401,64,402) Word 1 2 3 4 Name CID ENTITY ID1 ID2 Type I CHAR4 I I Description Coordinate system identification number Bulk Data entry used to define the coordinate system Entity identification number 1 Entity identification number 2 Record 16 – GRID(4501,45,1) Word 1 Name ID Type I Description Grid point identification number 4-20 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 3 4 5 6 7 8 Name CP X1 X2 X3 CD PS SEID Type I RS RS RS I I I Description Location coordinate system identification number Location of the point in coordinate 1 of CP Location of the point in coordinate 2 of CP Location of the point in coordinate 3 of CP Degree-of-freedom coordinate system identification number Permanent single-point constraints Superelement identification number Record 17 – SEBNDRY(1527,15,466) Word 1 2 3 Name SEIDA SEIDB G Type I I I Description Superelement A identification number Superelement B identification number Boundary grid point identification number in SEIDA Word 3 repeats until End of Record Record 18 – SEBULK(1427,14,465) Word 1 2 3 4 5 6 Name SEID TYPE RSEID METHOD TOL LOC Type I I I I RS I Description Superelement identification number Superelement type Reference superelement identification number Boundary point search method: 1=automatic or 2=manual Location tolerance Coincident location check option: yes=1 or no=2 NX Nastran DMAP Programmer’s Guide 4-21 Chapter 4 Data Block Descriptions F-M Record 19 – SECONCT(427,4,453) Word 1 2 3 4 5 9 10 Name SEIDA SEIDB TOL LOC UNDEF(4 ) GA GB Type I I RS I None I I Grid point identification number in SEIDA Grid point identification number in SEIDB Description Superelement A identification number Superelement B identification number Location tolerance Coincident location check option: yes=1 or no=2 Words 9 through 10 repeat until (-1,-1) occurs Record 20 – SEELT(7902,79,302) Word 1 2 Name SEID EID Type I I Description Superelement identification number Element identification number Word 2 repeats until End of Record Record 21 – SEEXCLD(527,72,454) Word 1 2 3 Name SEIDA SEIDB GA Type I I I Description Superelement A identification number Superelement B identification number or –1 for all Grid point identification number in SEIDA Word 3 repeats until End of Record Record 22 – SELABEL(1027,10,459) Word 1 2 Name SEID LABEL(14) Type I CHAR4 Description Superelement identification number Label associated with superelement SEID 4-22 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 23 – SELOC(827,8,457) Word 1 2 3 4 5 6 7 Name SEID GA1 GA2 GA3 GB1 GB2 GB3 Type I I I I I I I Description Superelement identification number Grid point 1 identification number in SEID Grid point 2 identification number in SEID Grid point 3 identification number in SEID Grid point 1 identification number in the main Bulk Data Grid point 2 identification number in the main Bulk Data Grid point 3 identification number in the main Bulk Data Record 24 – SEMPLN(927,9,458) Word 1 2 MIRRTYPE=1 3 4 5 6 MIRRTYPE=2 3 4 5 6 G CID N1 N2 G1 G2 G3 UNDEF(2 ) Name SEID MIRRTYPE Type I I Plane I I I None Normal I I RS RS Grid point identification number in the main Bulk Data Coordinate system identification number Normal component in direction 1 of CID Normal component in direction 2 of CID Grid point 1 identification number in the main Bulk Data Grid point 2 identification number in the main Bulk Data Grid point 3 identification number in the main Bulk Data Not Defined Description Superelement identification number Mirror type NX Nastran DMAP Programmer’s Guide 4-23 Chapter 4 Data Block Descriptions F-M Word 7 Name N3 Type RS Description Normal component in direction 3 of CID End MIRRTYPE Record 25 – SENQSET(1327,13,464) Word 1 2 Name SEID NQSET Type I I Description Superelement identification number Number of internally generated scalar points Record 26 – SEQGP(5301,53,4) Word 1 2 Name ID SEQID Type I I Description Grid or scalar point identification number Sequenced identification number Record 27 – SEQSEP(5401,54,305) Word 1 2 3 Name SSID PSID G Type I I I Description Secondary superelement identification number Primary superelement identification number Exterior grid or scalar point identification numbers Word 3 repeats until End of Record Record 28 – SESET(5601,56,296) Word 1 2 Name SEID G Type I I Description Superelement identification number Grid or scalar point identification number Word 2 repeats until End of Record 4-24 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 29 – SETREE(1227,12,462) Word 1 2 Name SEID SEUPI Type I I Description Superelement identification number Upstream superelement identification number Word 2 repeats until End of Record Record 30 – SNORM(5678,71,475) Word 1 2 3 4 5 Name GID CID N1 N2 N3 Type I I RS RS RS Description Grid point identification number Coordinate system identification number Normal component in direction 1 of CID Normal component in direction 2 of CID Normal component in direction 3 of CID Record 31 – CSUPER1(5701,57,323) This record is obsolete and is removed eventually. Word 1 2 3 4 5 6 7 8 9 10 11 Name SEID PSID TYPE VIEW DIROPT DIRTOL GEOMTOL CARDID MODEL SOLID DBSET Type I I I I I RS RS I I I I Description Superelement identification number Primary superelement identification number ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ ,{ NX Nastran DMAP Programmer’s Guide 4-25 Chapter 4 Data Block Descriptions F-M Word 12 13 14 15 XX =0 16 17 Name COPY DELETE GRIDLIST XX Type I I I I xx Description ,{ ,{ ,{ xx G C I I ,{ ,{ Words 16 through 17 repeat until (-1,-1,-1) occurs XX =-1 End XX yy Record 32 – CSUPUP(5801,58,324) This record is obsolete and is removed eventually. Word 1 2 3 4 5 6 Name SEUP1 PSID SEDOWN1 SEUP2 PSID SEDOWN2 Type I I I I I I Description ,{ Primary superelement identification number ,{ ,{ Primary superelement identification number ,{ Record 33 - TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words Notes: 1. CSUPER1 and CSUPUP records are recognized only by the IFP module and are removed eventually. 4-26 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M 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 id 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 4.4 GEOM2 Table of Bulk Data entries related to element connectivity 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 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name Record 1 - BEAMAERO(2601,26,0) Word 1 2 3 5 Name EID COMPID COMPTYPE(2) G(2) Type I I CHAR4 I Description Box identification number Component number in AECOMP Component type: SLBD (slender body) Grid identification numbers in AEGRID defining perimeter NX Nastran DMAP Programmer’s Guide 4-27 Chapter 4 Data Block Descriptions F-M Record 2 - CAABSF(2708,27,59) Word 1 2 3 4 5 6 Name EID PID G1 G2 G3 G4 Type I I I I I I Description Element identification number Property identification number Grid point 1 identification number Grid point 2 identification number Grid point 3 identification number Grid point 4 identification number Record 3 - CAXIF2(2108,21,224) Word 1 2 3 4 5 6 Name EID IDF1 IDF2 RHO B UNDEF Type I I I RS RS None Description Element identification number GRIDF point 1 identification number GRIDF point 2 identification number Fluid density in mass units Fluid bulk modulus Record 4 - CAXIF3(2208,22,225) Word 1 2 3 4 5 6 7 Name EID IDF1 IDF2 IFD3 RHO B UNDEF Type I I I I RS RS None Description Element identification number GRIDF point 1 identification number GRIDF point 2 identification number GRIDF point 2 identification number Fluid density in mass units Fluid bulk modulus 4-28 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 5 - CAXIF4(2308,23,226) Word 1 2 3 4 5 6 7 8 Name EID IDF1 IDF2 IFD3 IDF4 RHO B UNDEF Type I I I I I RS RS None Description Element identification number GRIDF point 1 identification number GRIDF point 2 identification number GRIDF point 2 identification number GRIDF point 4 identification number Fluid density in mass units Fluid bulk modulus Record 6 - CBAR(2408,24,180) Word 1 2 3 4 F =0 5 6 7 8 F =1 5 6 7 8 F =2 X1 X2 X3 F X1 X2 X3 F Name EID PID GA GB Type I I I I Z RS RS RS I T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 1 Description Element identification number Property identification number Grid point End A identification number Grid point End B identification number XYZ option - global cooridnate system RS RS RS I Grid option T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 1 NX Nastran DMAP Programmer’s Guide 4-29 Chapter 4 Data Block Descriptions F-M Word 5 6 8 End F 9 10 11 12 13 14 15 16 Name GO UNDEF(2 ) F Type I None I Description Grid point ID at end of orientation vector Orientation vector flag = 2 PA PB W1A W2A W3A W1B W2B W3B I I RS RS RS RS RS RS Pin flags for end A Pin flags for end B T1 component of offset vector from GA T2 component of offset vector from GA T3 component of offset vector from GA T1 component of offset vector from GB T2 component of offset vector from GB T3 component of offset vector from GB Record 7 - CBARAO(4001,40,275) Word 1 2 3 4 5 6 7 8 9 Name EID SCALE X1 X2 X3 X4 X5 X6 UNDEF Type I I RS RS RS RS RS RS None Description Element identification number Scale of Xi values 1st intermediate station for data recovery 2nd intermediate station for data recovery 3rd intermediate station for data recovery 4th intermediate station for data recovery 5th intermediate station for data recovery 6th intermediate station for data recovery 4-30 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 8 - CBEAM(5408,54,261) Word 1 2 3 4 5 6 F =0 7 8 9 10 F =1 7 8 9 10 F =2 7 8 10 End F 11 12 13 PA PB W1A I I RS Pin flags for end A Pin flags for end B T1 component of offset vector from GA GO UNDEF(2 ) F X1 X2 X3 F X1 X2 X3 F Name EID PID GA GB SA SB Type I I I I I I Y RS RS RS I T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 0 Description Element identification number Property identification number Grid point End A identification number Grid point End B identification number Scalar or grid point End A identification number for warping Scalar or grid point End B identification number for warping XYZ option - global coordinate system RS RS RS I Grid option I None I Orientation vector flag = 2 Grid point ID at end of orientation vector T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag =1 NX Nastran DMAP Programmer’s Guide 4-31 Chapter 4 Data Block Descriptions F-M Word 14 15 16 17 18 Name W2A W3A W1B W2B W3B Type RS RS RS RS RS Description T2 component of offset vector from GA T3 component of offset vector from GA T1 component of offset vector from GB T2 component of offset vector from GB T3 component of offset vector from GB Record 9 - CBEAMP(11401,114,9016) Word 1 2 3 7 8 F =0 9 10 11 12 F =1 9 10 11 12 F =2 9 10 GO UNDEF(2 ) X1 X2 X3 F X1 X2 X3 F Name EID PID G(4) SA SB Type I I I I I Z RS RS RS I T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag Description Element identification number Property identification number Internal indices of grid points Scalar or grid point End A identification number for warping Scalar or grid point End B identification number for warping XYZ option - global cooridnate system RS RS RS I Grid option I None Grid point ID at end of orientation vector T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 1 4-32 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 12 End F 13 14 15 16 17 18 19 20 21 22 Name F Type I Description Orientation vector flag = 2 BIT PA PB W1A W2A W3A W1B W2B W3B UNDEF(2 ) RS I I RS RS RS RS RS RS None Built In Twist Pin flags for end A Pin flags for end B T1 component of offset vector from GA T2 component of offset vector from GA T3 component of offset vector from GA T1 component of offset vector from GB T2 component of offset vector from GB T3 component of offset vector from GB Record 10 - CBEND(4601,46,298) Word 1 2 3 4 F =0 5 6 7 8 F =1 5 6 X1 X2 X1 X2 X3 F Name EID PID GA GB Type I I I I Z RS RS RS I T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 0 Description Element identification number Property identification number Grid point End A identification number Grid point End B identification number XYZ option - global cooridnate system RS RS T1 component of orientation vector from GA T2 component of orientation vector from GA NX Nastran DMAP Programmer’s Guide 4-33 Chapter 4 Data Block Descriptions F-M Word 7 8 F =2 5 6 8 End F 9 13 Name X3 F Type RS I Grid option Description T3 component of orientation vector from GA Orientation vector flag = 1 GO UNDEF(2 ) F I None I Grid point ID at end of orientation vector Orientation vector flag = 2 UNDEF(4 ) GEOM None I Element geometry option Record 11 - CBUSH(2608,26,60) Word 1 2 3 4 F =-1 5 8 F =0 5 6 7 8 F =1 5 6 X1 X2 X1 X2 X3 F UNDEF(3 ) F Name EID PID GA GB Type I I I I Description Element identification number Property identification number Grid point End A identification number Grid point End B identification number Use Element CID below for orientation None I Orientation vector flag = -1 XYZ option - Basic coordinate system - SECONVRT module RS RS RS I XYZ option RS RS T1 component of orientation vector from GA T2 component of orientation vector from GA T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 0 4-34 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 7 8 F =2 5 6 8 End F 9 10 11 12 13 14 Name X3 F Type RS I Grid option Description T3 component of orientation vector from GA Orientation vector flag = 1 GO UNDEF(2 ) F I None I Grid point identification number at end of orientation vector Orientation vector flag = 2 CID S OCID S1 S2 S3 I RS I RS RS RS Element coordinate system identification Location of spring damper Coordinate system for spring offset T1 component of spring-damper offset in the OCID system T2 component of spring-damper offset in the OCID system T3 component of spring-damper offset in the OCID system Record 12 - CBUSH1D(5608,56,218) Word 1 2 3 5 6 Name EID PID G(2) CID UNDEF(3 ) Type I I I I None Description Element identification number Property identification number Grid point identification numbers Coordinate system identification number Record 13 - CCONE(2315,23,0) Word 1 Name EID Type I Description Element identification number NX Nastran DMAP Programmer’s Guide 4-35 Chapter 4 Data Block Descriptions F-M Word 2 3 4 Name PID RINGA RINGB Type I I I Description Property identification number Ringa + 1000000 * n Ringb + 100000 * n Record 14 - CDAMP1(201,2,69) Word 1 2 3 4 5 6 Name EID PID G1 G2 C1 C2 Type I I I I I I Description Element identification number Property identification number Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Record 15 - CDAMP2(301,3,70) Word 1 2 3 4 5 6 Name EID B G1 G2 C1 C2 Type I RS I I I I Description Element identification number Value of the scalar damper Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Record 16 - CDAMP3(401,4,71) Word 1 2 3 4 Name EID PID S1 S2 Type I I I I Description Element identification number Property identification number Scalar point 1 identification number Scalar point 2 identification number 4-36 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 17 - CDAMP4(501,5,72) Word 1 2 3 4 Name EID B S1 S2 Type I RS I I Description Element identification number Value of the scalar damper Scalar point 1 identification number Scalar point 2 identification number Record 18 - CDAMP5(10608,106,404) Word 1 2 3 4 Name EID PID S1 S2 Type I I I I Description Element identification number Property identification number Scalar point 1 identification number Scalar point 2 identification number Record 19 - CDUM2(6208,62,108) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 20 - CDUM3(6308,63,109) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 21 - CDUM4(6408,64,110) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record NX Nastran DMAP Programmer’s Guide 4-37 Chapter 4 Data Block Descriptions F-M Record 22 - CDUM5(6508,65,111) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 23 - CDUM6(6608,66,112) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 24 - CDUM7(6708,67,113) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 25 - CDUM8(6808,68,114) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 26 - CDUM9(6908,69,115) Word 1 Name UNDEF Type None Description Word 1 repeats until End of Record Record 27 - CELAS1(601,6,73) Word 1 2 Name EID PID Type I I Description Element identification number Property identification number 4-38 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 3 4 5 6 Name G1 G2 C1 C2 Type I I I I Description Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Record 28 - CELAS2(701,7,74) Word 1 2 3 4 5 6 7 8 Name EID K G1 G2 C1 C2 GE S Type I RS I I I I RS RS Description Element identification number Stiffness of the scalar spring Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Damping coefficient Stress coefficient Record 29 - CELAS3(801,8,75) Word 1 2 3 4 Name EID PID S1 S2 Type I I I I Description Element identification number Property identification number Scalar point 1 identification number Scalar point 2 identification number Record 30 - CELAS4(901,9,76) Word 1 2 Name EID K Type I RS Description Element identification number Stiffness of the scalar spring NX Nastran DMAP Programmer’s Guide 4-39 Chapter 4 Data Block Descriptions F-M Word 3 4 Name S1 S2 Type I I Description Scalar point 1 identification number Scalar point 2 identification number Record 31 - CFLUID2(8515,85,0) Word 1 2 3 4 5 6 Name EID IDF1 IDF2 RHO B HARMINDX Type I I I RS RS I Description Element identification number RINGFL point 1 identification number RINGFL point 2 identification number Mass density Bulk modulus Harmonic index Record 32 - CFLUID3(8615,86,0) Word 1 2 3 4 5 6 7 Name EID IDF1 IDF2 IDF3 RHO B HARMINDX Type I I I I RS RS I Description Element identification number RINGFL point 1 identification number RINGFL point 2 identification number RINGFL point 3 identification number Mass density Bulk modulus Harmonic index Record 33 - CFLUID4(8715,87,0) Word 1 2 3 Name EID IDF1 IDF2 Type I I I Description Element identification number RINGFL point 1 identification number RINGFL point 2 identification number 4-40 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 4 5 6 7 8 Name IDF3 IDF4 RHO B HARMINDX Type I I RS RS I Description RINGFL point 3 identification number RINGFL point 4 identification number Mass density Bulk modulus Harmonic index Record 34 - CINT(7701,77,8881) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 Name EID PID PTELC NSEG PTSGR NBOUND BID NEDGE PTBND PTBGR PTBED PTBGL PTBEL Type I I I I I I I I I I I I I Description Element identification number Property identification number Pointer to element identification number Number of segments Pointer to segment displacements Number of boundaries Boundary identification number Number of edges Pointer to boundary identification number Pointer to boundary grid displacements Pointer to boundary edge displacements Pointer to boundary grid Lagrange Multipliers Pointer to boundary edge Lagrange Multipliers Words 7 through 13 repeat 6 times 14 UNDEF(2 ) None Record 35 - CGAP(1908,19,104) Word 1 Name EID Type I Description Element identification number NX Nastran DMAP Programmer’s Guide 4-41 Chapter 4 Data Block Descriptions F-M Word 2 3 4 F =0 5 6 7 8 F =1 5 6 7 8 F =2 5 6 8 End F 9 Name PID GA GB Type I I I Z Description Property identification number Grid point End A identification number Grid point End B identification number X1 X2 X3 F RS RS RS I T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 0 XYZ option - global cooridnate system X1 X2 X3 F RS RS RS I Grid option GO UNDEF(2 ) F I None I Orientation vector flag = 2 Grid point ID at end of orientation vector T1 component of orientation vector from GA T2 component of orientation vector from GA T3 component of orientation vector from GA Orientation vector flag = 1 CID I Element coordinate system identification number Record 36 - CHACAB(8100,81,381) Word 1 2 3 Name EID PID G(20) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points 4-42 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 37 - CHACBR(8200,82,383) Word 1 2 3 Name EID PID G(20) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 38 - CHBDYE(8308,83,405) Word 1 2 3 4 5 6 7 Name EID EID2 SIDE IVIEWF IVIEWB RADMIDF RADMIDB Type I I I I I I I Description Element identification number Heat conduction element identification number Consistent element side identification number VIEW entry identification number for the front face VIEW entry identification number for the back face RADM entry identification number for front face RADM entry identification number for back face Record 39 - CHBDYG(10808,108,406) Word 1 2 3 4 5 Name EID UNDEF TYPE IVIEWF IVIEWB Type I None I I I Surface type VIEW entry identification number for the front face VIEW entry identification number for the back face Description Element identification number NX Nastran DMAP Programmer’s Guide 4-43 Chapter 4 Data Block Descriptions F-M Word 6 7 8 9 Name RADMIDF RADMIDB UNDEF G(8) Type I I None I Description RADM entry identification number for front face RADM entry identification number for back face Grid point identification numbers of connection points Record 40 - CHBDYP(10908,109,407) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 Name EID PID TYPE IVIEWF IVIEWB G1 G2 GO RADMIDF RADMIDB DISLIN CE E1 E2 Type I I I I I I I I I I I I RS RS Coordinate system for defining orientation vector T1 components of the orientation vector in the CE system T2 components of the orientation vector in the CE system Description Element identification number Property identification number Surface type VIEW entry identification number for the front face VIEW entry identification number for the back face Grid point 1 identification number Grid point 2 identification number Grid point ID at end of orientation vector RADM entry identification number for front face RADM entry identification number for back face 4-44 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 15 Name E3 Type RS Description T3 components of the orientation vector in the CE system Record 41 - CHEXA(7308,73,253) Word 1 2 3 Name EID PID G(20) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 42 - CHEXA20F(16300,163,9989) Same as record CHEXA description. Record 43 - CHEXAFD(14000,140,9990) Same as record CHEXA description. Record 44 - CHEXAL(7708,77,369) Word 1 2 3 23 Name EID MID G(20) THETA Type I I I RS Description Element identification number Material identification number Grid point identification numbers of connection points Material property orientation angle Record 45 - CHEXP(12001,120,9011) Word 1 2 3 11 Name EID PID G(8) E1(24) Type I I I I Description Element identification number Property identification number Grid point identification numbers of connection points NX Nastran DMAP Programmer’s Guide 4-45 Chapter 4 Data Block Descriptions F-M Word 35 41 42 Name F(6) B1 E2(24) Type I I I Description Record 46 - CHEXPR(7409,74,9991) Same as record CHEXA description. Record 47 - CMASS1(1001,10,65) Word 1 2 3 4 5 6 EID PID G1 G2 C1 C2 Name I I I I I I Type Description Element identification number Property identification number Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Record 48 - CMASS2(1101,11,66) Word 1 2 3 4 5 6 Name EID M G1 G2 C1 C2 Type I RS I I I I Description Element identification number Scalar mass value Grid point 1 identification number Grid point 2 identification number Component number at grid point 1 Component number at grid point 2 Record 49 - CMASS3(1201,12,67) Word 1 Name EID Type I Description Element identification number 4-46 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 3 4 Name PID S1 S2 Type I I I Description Property identification number Scalar point 1 identification number Scalar point 2 identification number Record 50 - CMASS4(1301,13,68) Word 1 2 3 4 Name EID M S1 S2 Type I RS I I Description Element identification number Scalar mass value Scalar point 1 identification number Scalar point 2 identification number Record 51 - CMFREE(2508,25,0) Word 1 2 3 4 5 Name EID S S2 Y N Type I I I RS I Description Element identification number Record 52 - CONM1(1401,14,63) Word 1 2 3 4 5 7 Name EID G CID M1(1) M2(2) M3(3) Type I I I RS RS RS Description Element identification number Grid point identification number Coordinate system identification number Mass matrix term M11 Mass matrix terms M21 through M22 Mass matrix terms M31 through M33 NX Nastran DMAP Programmer’s Guide 4-47 Chapter 4 Data Block Descriptions F-M Word 10 14 19 Name M4(4) M5(5) M6(6) Type RS RS RS Description Mass matrix terms M41 through M44 Mass matrix terms M51 through M55 Mass matrix terms M61 through M66 Record 53 - CONM2(1501,15,64) Word 1 2 3 4 5 6 7 8 9 11 Name EID G CID M X1 X2 X3 I1(1) I2(2) I3(3) Type I I I RS RS RS RS RS RS RS Description Element identification number Grid point identification number Coordinate system identification number Mass T1 offset from the grid point to the center of gravity T2 offset from the grid point to the center of gravity T3 offset from the grid point to the center of gravity Mass moments of inertia term I11 Mass moments of inertia term I21 through I22 Mass moments of inertia term I31 through I33 Record 54 - CONROD(1601,16,47) Word 1 2 3 4 5 6 Name EID G1 G2 MID A J Type I I I I RS RS Description Element identification number Grid point 1 identification number Grid point 2 identification number Material identification number Area Torsional constant 4-48 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 7 8 Name C NSM Type RS RS Description Coefficient for torsional stress Nonstructural mass per unit length Record 55 - CONV(12701,127,408) Word 1 2 3 4 5 Name EID PCONID FLMND CNTRLND TA Type I I I I I Description Element identification number Convection property identification number Point for film convection fluid property temperature Control point for free convection boundary condition Ambient points used for convection Word 5 repeats 8 times Record 56 - CONVM(8908,89,422) Word 1 2 3 4 5 Name EID PCONID FLMND CNTMDOT TA Type I I I I I Description Element identification number Convection property identification number Point for film convection fluid property temperature Control point used for controlling mass flow. Ambient points used for convection Word 5 repeats 2 times Record 57 - CPENP(12101,121,9012) Word 1 2 Name EID PID Type I I Description Element identification number Property identification number NX Nastran DMAP Programmer’s Guide 4-49 Chapter 4 Data Block Descriptions F-M Word 3 9 27 32 33 Name G(6) E1(18) F(5) B1 E2(14) Type I I I I I Description Grid point identification numbers of connection points Record 58 - CPENTA(4108,41,280) Word 1 2 3 Name EID PID G(15) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 59 - CPENPR(7509,75,9992) Same as record CPENTA description. Record 60 - CPENT15F(16500,165,9987) Same as record CPENTA description. Record 61 - CPENT6FD(16000,160,9988) Same as record CPENTA description. Record 62 - CQDX4FD(17000,170,9980) Word 1 2 3 Name EID PID G(9) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 63 - CQDX9FD(17100,171,9979) Same as record CQDX4FD description. 4-50 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 64 - CQUAD(9108,91,507) Word 1 2 3 Name EID PID G(9) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 65 - CQUAD4(2958,51,177) Word 1 2 3 7 8 9 10 11 Name EID PID G(4) THETA ZOFFS UNDEF TFLAG T(4) Type I I I RS RS None I RS Alternate thickness flag Membrane thickness of element at grid points Description Element identification number Property identification number Grid point identification numbers of connection points Material property orientation angle or coordinate system ID Offset from the surface of grid points reference plane Record 66 - CQUAD4FD(13900,139,9984) Same as record CQUAD description. Record 67 - CQUAD8(4701,47,326) Word 1 2 3 11 Name EID PID G(8) T(4) Type I I I RS Description Element identification number Property identification number Grid point identification numbers of connection points Membrane thickness of element at grid points NX Nastran DMAP Programmer’s Guide 4-51 Chapter 4 Data Block Descriptions F-M Word 15 16 17 Name THETA ZOFFS TFLAG Type RS RS I Description Material property orientation angle or coordinate system ID Offset from the surface of grid points reference plane Alternate thickness flag Record 68 - CQUAD9FD(16400,164,9983) Word 1 2 3 Name EID PID G(9) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 69 - CQUADP(11101,111,9014) Word 1 2 3 20 27 28 29 30 32 Name EID PID G(17) UNDEF(7 ) INORM THETA ZOFFS UNDEF(2 ) T(4) Type I I I None I RS RS None RS Membrane thickness of element at grid points Flag for normals Material property orientation angle or coordinate system ID Offset from the surface of grid points reference plane Description Element identification number Property identification number Internal indices of connection points Record 70 - CQUADR(8009,80,367) Same as record CQUAD4 description. 4-52 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 71 - CQUADX(9008,90,508) Same as record CQUAD description. Record 72 - CROD(3001,30,48) Word 1 2 3 Name EID PID G(2) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 73 - CSHEAR(3101,31,61) Word 1 2 3 Name EID PID G(4) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 74 - CSLOT3(4408,44,227) Word 1 2 5 6 7 8 Name EID IDS(3) RHO B M HARMINDX Type I I RS RS I I Description Element identification number GRIDS identification numbers Fluid density in mass units Fluid bulk modulus Number of slots in circumferential direction Harmonic index Record 75 - CSLOT4(4508,45,228) Word 1 2 Name EID IDS(4) Type I I Description Element identification number GRIDS identification numbers NX Nastran DMAP Programmer’s Guide 4-53 Chapter 4 Data Block Descriptions F-M Word 6 7 8 9 Name RHO B M HARMINDX Type RS RS I I Description Fluid density in mass units Fluid bulk modulus Number of slots in circumferential direction Harmonic index Record 76 - CTETP(12201,122,9013) Word 1 2 3 7 19 23 24 Name EID PID G(4) E1(12) F(4) B1 E2(4) Type I I I I I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 77 - CTETRA(5508,55,217) Word 1 2 3 Name EID PID G(10) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 78 - CTETPR(7609,76,9993) Same as record CTETRA description. Record 79 - CTETR10F(16600,166,9985) Same as record CTETRA description. 4-54 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 80 - CTETR4FD(16100,161,9986) Same as record CTETRA description. Record 81 - CTRIA3(5959,59,282) Word 1 2 3 6 7 8 10 11 Name EID PID G(3) THETA ZOFFS UNDEF(2) TFLAG T(3) Type I I I RS RS None I RS Alternate thickness flag Membrane thickness of element at grid points Description Element identification number Property identification number Grid point identification numbers of connection points Material property orientation angle or coordinate system identification number Offset from the surface of grid points reference plane Record 82 - CTRIA3FD(16200,162,9982) Word 1 2 3 Name EID PID G(6) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 83 - CTRIA6(4801,48,327) Word 1 2 3 9 Name EID PID G(6) THETA Type I I I RS Description Element identification number Property identification number Grid point identification numbers of connection points Material property orientation angle or coordinate system identification number NX Nastran DMAP Programmer’s Guide 4-55 Chapter 4 Data Block Descriptions F-M Word 10 11 12 Name ZOFFS T(3) TFLAG Type RS RS I Description Offset from the surface of grid points reference plane Membrane thickness of element at grid points Alternate thickness flag Record 84 - CTRIA6FD(16700,167,9981) Same as record CTRIA3FD description. Record 85 - CTRIAP(11301,113,9015) Word 1 2 3 14 17 18 19 20 22 Name EID PID G(11) UNDEF(3 ) THETA UNDEF ZOFFS UNDEF(2 ) T(3) Type I I I None RS None RS None RS Membrane thickness of element at grid points Offset from the surface of grid points reference plane Material property orientation angle or coordinate system identification number Description Element identification number Property identification number Internal indices of grid points Record 86 - CTRIAR(9200,92,385) Same as record CTRIA3 description. Record 87 - CTRIAX(10108,101,512) Word 1 2 3 Name EID PID G(6) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points 4-56 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 9 Name UNDEF Type None Description Record 88 - CTRIAX6(6108,61,107) Word 1 2 3 9 10 Name EID MID G(6) THETA UNDEF(2 ) Type I I I RS None Description Element identification number Material identification number Grid point identification numbers of connection points Material property orientation angle Record 89 - CTRIX3FD(16800,168,9978) Word 1 2 3 6 Name EID PID G(3) UNDEF(3 ) Type I I I None Description Element identification number Property identification number Grid point identification numbers of connection points Record 90 - CTRIX6FD(16900,169,9977) Word 1 2 3 Name EID PID G(6) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 91 - CTUBE(3701,37,49) Word 1 Name EID Type I Description Element identification number NX Nastran DMAP Programmer’s Guide 4-57 Chapter 4 Data Block Descriptions F-M Word 2 3 Name PID G(2) Type I I Description Property identification number Grid point identification numbers of connection points Record 92 - CVISC(3901,39,50) Word 1 2 3 Name EID PID G(2) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 93 - CWELD(11701,117,559) Word 1 2 3 4 5 6 7 8 FORMAT =0 9 17 FORMAT =1 9 UNDEF(16 ) GUPPER(8) GLOWER(8) Name EID PID GS FORMAT(C) GA GB TYPE CID Type I I I I I I I I GRIDID I I ALIGN None Grid identification numbers of the upper shell Grid identification numbers of the lower shell Description Element ID for FORM="ALIGN", "ELEMID" or "GRIDID" Property ID Spot weld master node ID GS Connection format (0 GRIDID, 1 ALIGN, 2 elemid ID of GA ID of GB Types of upper and lower elements for FORM="GRIDID" C 4-58 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word FORMAT =2 9 10 11 Name Type ELEMID Description EIDUP EIDLOW UNDEF(14 ) I I None Element identification number of the upper shell Element identification number of the lower shell End FORMAT 25 26 27 UNDEF RID1 RID2 None I I R R Record 94 - CWELDC(13501,135,564) Word 1 2 3 4 5 6 7 8 9 17 25 26 27 Name EID PID GS FORMAT(C) GA GB TYPE CID GUPPER(8) GLOWER(8) UNDEF RID1 RID2 Type I I I I I I I I I I None I I R R Description Element identification number Property identification number Spot weld master node identification number GS Connection format (0=GRIDID) Identification number of GA Identification number of GB Types of upper and lower elements for FORM="GRIDID" C Grid identification numbers of the upper shell Grid identification numbers of the lower shell NX Nastran DMAP Programmer’s Guide 4-59 Chapter 4 Data Block Descriptions F-M Record 95 - CWELDG(13601,136,562) Word 1 2 3 4 5 6 7 8 FORMAT =3 9 10 11 14 15 16 19 22 FORMAT =4 9 10 11 15 16 17 EIDSH PIDSH GIDSH(4) TH ZOFFS UNDEF(2 ) EIDSH PIDSH GIDSH(3) TH ZOFFS UNDEF(3 ) T(3) UNDEF(3 ) Name EID PID GS FORMAT(C) GA GB TYPE CID Type I I I I I I I I TRIA3 I I I RS RS None RS None QUAD4 I I I RS RS None Element identification number Property identification number of PSHELL Grid identification numbers of element MCID or THETA ZOFFS Membrane thickness Element identification number Property identification number of PSHELL Grid Iidentification numbers of element MCID or THETA ZOFFS Description Shell element identification number Property identification number Spot weld master node identification number GS Connection format (3=TRIA3, 4=QUAD4, 6=TRIA6, 8=QUAD8) Identification number of GA Identification number of GB Types of upper and lower elements for FORM="GRIDID" C 4-60 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 19 23 FORMAT =6 9 10 11 17 18 19 22 FORMAT =8 9 10 11 19 23 24 Name T(4) UNDEF(2 ) Type RS None TRIA6 Description Membrane thickness EIDSH PIDSH GIDSH(6) TH ZOFFS T(3) UNDEF(3 ) I I I RS RS RS None QUAD8 Element identification number Property identification number of PSHELL Grid identification numbers of element MCID or THETA ZOFFS Membrane thickness EIDSH PIDSH GIDSH(8) T(4) TH ZOFFS I I I RS RS RS Element identification number Property identification number of PSHELL Grid identification numbers of element Membrane thickness MCID or THETA ZOFFS End FORMAT 25 26 27 EID2 RID1 RID2 I I I CWELD or RBAR element identification number R R Record 96 - GENEL(4301,43,28) Word 1 2 Name EID UI Type I I Description Element identification number Independent grid point identification number NX Nastran DMAP Programmer’s Guide 4-61 Chapter 4 Data Block Descriptions F-M Word 3 Name CI Type I Description Component number Words 2 through 3 repeat until End of Record 4 5 6 M(C) UD CD I I I Number of rows and columns in K or Z and rows in S Dependent grid point identification number Component number Words 5 through 6 repeat until End of Record 7 8 9 N(C) F KZIJ I I RS Number of columns in S 1 => Z 2=> K Lower triangular terms of the K or Z matrix. See Notes. Word 9 repeats MM times 10 NZERO =1 11 SIJ NZERO(C) I Actually " 0" RS Terms of the S matrix Word 11 repeats M times Word 11 repeats N times NZERO =0 End NZERO 12 UNDEF None Word 12 repeats until End of Record Record 97 - GMBNDC(3201,32,478) Word 1 2 3 4 Name BID GRIDI GRIDF ENTITY(2) Type I I I CHAR4 Description Boundary identification number Initial grid identification number for boundary Final grid identification number for boundary Entity type for defining boundary 4-62 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 6 Name EID Type I Description Entity identification numbers for boundary of subdomain Word 6 repeats until End of Record Record 98 - GMBNDS(12901,129,482) Word 1 2 6 8 Name BID GRIDC(4) ENTITY(2) EID Type I I CHAR4 I Description Boundary identification number Corner grid 1 Entity type for defining boundary Entity identification numbers for boundary of subdomain Word 8 repeats until End of Record Record 99 - GMINTC(3301,33,479) Word 1 2 3 9 Name EID PID IBOUND(6) UNDEF(42 ) Type I I I None Description Element identification number Property identification number Boundary identification number Record 100 - GMINTS(13001,130,483) Word 1 2 3 7 Name EID PID IBOUND(4) UNDEF(44 ) Type I I I None Description Element identification number Property identification number Boundary identification number NX Nastran DMAP Programmer’s Guide 4-63 Chapter 4 Data Block Descriptions F-M Record 101 - PLOTEL(5201,52,11) Word 1 2 Name EID G(2) Type I I Description Element identification number Grid point identification numbers of connection points Record 102 - Q4AERO(3002,46,0) Word 1 2 3 5 Name EID COMPID COMPTYPE(2) G(4) Type I I CHAR4 I Description Box identification number Component number in AECOMP Component type: SLBD (slender body) Grid identification numbers in AEGRID defining perimeter Record 103 - RADBC(12801,128,417) Word 1 2 3 4 Name EID FAMB CNTRLND NODAMB Type I RS I I Description Element identification number Radiation view factor between the face and the ambient point Control point for radiation boundary condition Record 104 - SINT(7801,78,8883) Word 1 2 3 4 5 6 Name EID PID PTELE NSEG STSC PTSC Type I I I I I I Description Element identification number Property identification number Pointer to element identification number Number of segments Stride for segment displacement data Pointer to segment displacements 4-64 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 7 8 9 10 11 12 13 14 15 Name NBOUND BID NFACE STBC NSEG STLC1 PTBND PTBC PTLC Type I I I I I I I I I Description Number of boundaries Boundary identification number Number of faces Stride for boundary displacement data Number of segments Stride for Boundary Lagrange Multiplier data Pointer to boundary identification number Pointer to boundary displacements Pointer to boundary Lagrange Multipliers Words 8 through 15 repeat 5 times 16 UNDEF(3 ) None Record 105 - SPOINT(5551,49,105) Word 1 Name ID Type I Description Scalar point identification number Record 106 - T3AERO(2701,27,0) Word 1 2 3 5 Name EID COMPID COMPTYPE(2) G(3) Type I I CHAR4 I Description Box identification number Component number in AECOMP Component type: SLBD (slender body) Grid identification numbers in AEGRID defining perimeter Record 107 - VUHEXA(12301,123,145) Word 1 2 Name EID PID Type I I Description Element identification number Property identification number NX Nastran DMAP Programmer’s Guide 4-65 Chapter 4 Data Block Descriptions F-M Word 3 Name G(8) Type I Description Grid point identification numbers of connection points Record 108 - VUPENTA(12401,124,146) Word 1 2 3 Name EID PID G(6) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 109 - VUTETRA(12501,125,147) Word 1 2 3 Name EID PID G(4) Type I I I Description Element identification number Property identification number Grid point identification numbers of connection points Record 110 - TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words Notes: 1. Records appear in ascending internal element ID. 2. When the ECT is an alias for the GEOM2VU block, the third word of the header record in: • • • VUHEXA becomes 9921 VUPENTA becomes 9922 VUTETRA becomes 9923 For each of the above, the grid id is then a VIEW grid id. The beginning value of the VIEW grids is controlled by system cell 182. 3. Internal indices are: • CQUADP: (NGRIDS + 2*NEDGES +4*NFACES + 1 Bubble Point) 4-66 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M • • CTRIAP: (NGRIDS+2*NEDGES+NFACES + 1BODY(for bubble) CBEAMP: (NGRIDS+2*NEDGES) 4. For the BEAMAERO, Q4AERO, and T3AERO records, the component types are general labels for components: • SLBD are Slender Body Types and are "BEAM-LIKE" Elements appearing only in the BEAMAERO Record. The remaining Components Types can be QUAD or TRIA connections denoting various element types. INBD are Interference Body Panels. LS are Lifting Surface Panels. WAKE are Wake Boxes. MFLO are Flow-Thru Surfaces like Inlets (Mass-Flow). • • • • • 5. In GENEL record, MM=((M*(M+1)/2)-1). 4.5 GEOM3 Table of Bulk Data entry images related to static and thermal loads Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – FORCE(4201,42,18) Word 1 2 3 4 5 Name SID G CID F N(3) Type I I I RS RS Description Load set identification number Grid point identification number Coordinate system identification number Scale factor Components of a vector coordinate system defined by CID NX Nastran DMAP Programmer’s Guide 4-67 Chapter 4 Data Block Descriptions F-M Record 2 – FORCE1(4001,40,20) Word 1 2 3 4 Name SID G F G(2) Type I I RS I Description Load set identification number Grid point identification number Scale factor Grid point identification numbers Record 3 – FORCE2(4101,41,22) Word 1 2 3 4 Name SID G F G(4) Type I I RS I Description Load set identification number Grid point identification number Scale factor Grid point identification numbers Record 4 – GMLOAD(6309,63,391) Word 1 2 3 4 5 6 7 8 Name SID CID N1 N2 N3 ENTITY ENTID METHTYP Type I I RS RS RS CHAR4 I I TABLE3D I None TABLE3D identification number Description Load set identification number Coordinate system identification number Component 1 of a vector coordinate system defined by CID Component 2 of a vector coordinate system defined by CID Component 3 of a vector coordinate system defined by CID Entity type that is being loaded Entity identification number Method METHTYP =1 9 10 TABLID UNDEF(8 ) 4-68 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word Name Type DEQATN I None CONSTANT RS LINEAR RS QUAD RS CUBIC RS Description METHTYP =2 9 10 EQTNID UNDEF(8 ) DEQATN identification number METHTYP =3 9 FIELD(9) Load magnitude data METHTYP =4 9 FIELD(9) Load magnitude data METHTYP =5 9 FIELD(9) Load magnitude data METHTYP =6 9 FIELD(9) Load magnitude data METHTYP=11 9 10 MTABLID UNDEF(8) I None METHTYP=12 9 10 MEQTNID UNDEF(8) I None METHTYP=13 9 MCONST(9) RS METHTYP=14 9 MLINEAR(9) RS METHTYP=15 9 MQUAD(9) RS METHTYP=16 9 MCUBIC(9) RS End METHTYP NX Nastran DMAP Programmer’s Guide 4-69 Chapter 4 Data Block Descriptions F-M Record 5 – GRAV(4401,44,26) Word 1 2 3 4 7 Name SID CID A N(3) MB Type I I RS RS I Description Load set identification number Coordinate system identification number Acceleration vector scale factor Components of a vector coordinate system defined by CID Bulk Data Section with CID definition: -1=main, 0=partitioned Record 6 – LOAD(4551,61,84) Word 1 2 3 4 Name SID S SI LI Type I RS RS I Description Load set identification number Overall scale factor Scale factor on LI Load set identification number Words 3 through 4 repeat until (-1,-1) occurs Record 7 – LOADCYH(3709,37,331) Word 1 2 3 4 5 6 Name SID S HID HTYPE SI LI Type I RS I I RS I Description Load set identification number Scale factor Harmonic index Harmonic type Scale factor on LI Load set identification number Words 5 through 6 repeat 2 times 4-70 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 8 – LOADCYN(3809,38,332) Word 1 2 3 4 5 6 Name SID S SEGID SEGTYPE SI LI Type I RS I I RS I Description Load set identification number Scale factor Segment identification number Segment type Scale factor on LI Load set identification number Words 5 through 6 repeat 2 times Record 9 – LOADCYT(3909,39,333) Word 1 2 3 4 Name SID TABLEID LOADSET METHOD Type I I I I Description Load set identification number TABLEDi identification number Load set identification number Method of interpolation Words 2 through 4 repeat 2 times Record 10 – LSEQ(3609,36,188) Word 1 2 3 4 5 Name SID DAREA LID TID UNDEF Type I I I I None Description Load set identification number DAREA set identification number Load set identification number Temperature set identification number Record 11 – MOMENT(4801,48,19) Word 1 Name SID Type I Description Load set identification number NX Nastran DMAP Programmer’s Guide 4-71 Chapter 4 Data Block Descriptions F-M Word 2 3 4 5 Name G CID M N(3) Type I I RS RS Description Grid point identification number Coordinate system identification number Moment scale factor Components of a vector coordinate system defined by CID Record 12 – MOMENT1(4601,46,21) Word 1 2 3 4 Name SID G M G(2) Type I I RS I Description Load set identification number Grid point identification number Moment scale factor Grid point identification numbers Record 13 – MOMENT2(4701,47,23) Word 1 2 3 4 Name SID G M G(4) Type I I RS I Description Load set identification number Grid point identification number Moment scale factor Grid point identification numbers Record 14 – PLOAD(5101,51,24) Word 1 2 3 Name SID P G(4) Type I RS I Description Load set identification number Pressure Grid point identification numbers 4-72 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 15 – PLOAD1(6909,69,198) Word 1 2 3 4 5 6 7 8 Name SID EID TYPE SCALE X1 P1 X2 P2 Type I I I I RS RS RS RS Description Load set identification number Element identification number Load type Scale factor for X1 and X2 Distance to position 1 along the element axis from end A Pressure at position 1 Distance to position 2 along the element axis from end A Pressure at position 2 Record 16 – PLOAD2(6802,68,199) Word 1 2 3 Name SID P EID Type I RS I Description Load set identification number Pressure Element identification number Record 17 – PLOAD3(7109,71,255) Word 1 2 3 4 Name SID P EID G(2) Type I RS I I Description Load set identification number Pressure Element identification number Grid point identification numbers Record 18 – PLOAD4(7209,72,299) Word 1 Name SID Type I Description Load set identification number NX Nastran DMAP Programmer’s Guide 4-73 Chapter 4 Data Block Descriptions F-M Word 2 3 7 8 9 10 Name EID P(4) G1 G34 CID N(3) Type I RS I I I RS Description Element identification number Pressures Grid point identification number at a corner of the face Grid point ID at a diagonal from G1 or CTETRA corner Coordinate system identification number Components of a vector coordinate system defined by CID Record 19 – PLOADX(7001,70,278) This record is obsolete Word 1 2 4 Name SID P(2) G(3) Type I RS I Description Load set identification number Pressure Grid point identification numbers Record 20 – PLOADX1(7309,73,351) Word 1 2 3 4 5 7 Name SID EID PA PB G(2) THETA Type I I RS RS I RS Description Load set identification number Element identification number Surface traction at grid point GA Surface traction at grid point GB Corner grid point identification numbers Angle between surface traction and inward normal 4-74 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 21 – PRESAX(5215,52,154) Word 1 2 3 5 6 Name SID P RID(2) PHI1 UNDEF Type I RS I RS None Description Load set identification number Pressure Ring identification numbers Azimuthal angles in degrees Record 22 – QBDY1(4509,45,239) Word 1 2 3 Name SID Q0 EID Type I RS I Description Load set identification number Heat flux into element Element identification number Record 23 – QBDY2(4909,49,240) Word 1 2 3 Name SID EID Q0(8) Type I I RS Description Load set identification number Element identification number Heat flux at the i-th grid point on the referenced CHBDYj Record 24 – QBDY3(2109,21,414) Word 1 2 3 4 Name SID Q0 CNTRLND EID Type I RS I I Description Load set identification number Thermal heat flux load, or load multiplier Control point for thermal flux load Element identification number NX Nastran DMAP Programmer’s Guide 4-75 Chapter 4 Data Block Descriptions F-M Record 25 – QHBDY(4309,43,233) Word 1 2 3 4 5 Name SID FLAG Q0 AF G(8) Type I I RS RS I Description Load set identification number Face type Magnitude of thermal flux into face Area factor Grid point identification numbers Record 26 – QVECT(2209,22,241) Word 1 2 3 4 5 6 Name SID Q0 TSOUR CE FLAG E Type I RS RS I I RS Vector component of flux in coordinate system CE Description Load set identification number Magnitude of thermal flux vector into face Temperature of the radiant source Coordinate system identification number for thermal vector flux Words 5 through 6 repeat 3 times 7 8 CNTRLND EID I I Control point Element identification number Record 27 – QVOL(2309,23,416) Word 1 2 3 4 Name SID QVOL CNTRLND EID Type I RS I I Description Load set identification number Power input per unit volume produced by a conduction element Control point used for controlling heat generation Element identification number 4-76 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 28 – RFORCE(5509,55,190) Word 1 2 3 4 5 8 9 10 Name SID G CID A R(3) METHOD RACC MB Type I I I RS RS I RS I Description Load set identification number Grid point identification number Coordinate system identification number Scale factor of the angular velocity Rectangular components of rotation vector Method used to compute centrifugal forces Scale factor of the angular acceleration Bulk Data Section with CID definition: -1=main, 0=partitioned Record 29 – SLOAD(5401,54,25) Word 1 2 3 Name SID G F Type I I RS Description Load set identification number Scalar or grid point identification number Scale factor Record 30 – TEMP(5701,57,27) Word 1 2 3 Name SID G T Type I I RS Description Temperature set identification number Grid point identification number Temperature Record 31 – TEMPD(5641,65,98) Word 1 2 Name SID T Type I RS Description Temperature set identification number Temperature NX Nastran DMAP Programmer’s Guide 4-77 Chapter 4 Data Block Descriptions F-M Record 32 – TEMPEST(11109,111,424) Word 1 2 3 Name SID TEMP EID Type I RS I Description Temperature set identification number Temperature Element identification number Record 33 – TEMPF(6209,62,390) Word 1 2 3 4 Name SID EID FTEMP FTABID Type I I I I Description Temperature set identification number Element identification number DEQATN identification number TABLE3D identification number Record 34 – TEMPIC(11209,112,425) Word 1 2 3 Name SID TEMP EID Type I RS I Description Temperature set identification number Temperature Element identification number Record 35 – TEMPP1(8109,81,201) Word 1 2 3 4 5 Name SID EID T TPRIME TS(2) Type I I RS RS RS Description Temperature set identification number Element identification number Temperature at the element’s reference plane Effective linear thermal gradient Temperatures for stress calculation Record 36 – TEMPP2(8209,82,202) This record is obsolete 4-78 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 1 2 3 4 5 6 7 Name SID EID T MX MY MXY T(2) Type I I RS RS RS RS RS Description Temperature set identification number Element identification number S,{ S,{ S,{ S,{ S,{ Record 37 – TEMPP3(8309,83,203) This record is obsolete Word 1 2 3 4 Name SID EID Z T Type I I RS RS Description Temperature set identification number Element identification number S,{ S,{ Words 3 through 4 repeat 11 times Record 38 – TEMPRB(8409,84,204) Word 1 2 3 4 5 6 7 8 Name SID EID TA TB TP1A TP1B TP2A TP2B Type I I RS RS RS RS RS RS Description Temperature set identification number Element identification number Temperature at end A on the neutral axis Temperature at end B on the neutral axis Effective linear gradient in direction 1 on end A Effective linear gradient in direction 1 on end B Effective linear gradient in direction 2 on end A Effective linear gradient in direction 2 on end B NX Nastran DMAP Programmer’s Guide 4-79 Chapter 4 Data Block Descriptions F-M Word 9 Name TS(8) Type RS Description Temperatures for stress calculation Record 39 – PFACE(6409,64,9032) This record is created by the GP0 module; not by the user. Word 1 2 3 4 7 8 9 18 22 23 24 25 Name SID FACEID CID N(3) EQTNID TABLID FIELD(9) G(4) GNIDA GNIDB PSEL MAXNDF Type I I I RS I I RS I I I I I Description Load set identification number Face identification number Coordinate system identification number Components of a vector coordinate system defined by CID DEQATN identification number TABLE3D identification number See GMLOAD record Grid point identification numbers Side i grid-n A identification number Side i grid-n B identification number Computed p value Maximum number of degrees-of-freedom or stride Words 22 through 25 repeat 4 times 26 27 28 29 31 32 FACFID NDOF LDISTFG UNDEF(2 ) CIDF NDOFF(4) I I I None I I Coordinate system ID of the face NDOF flags Grid-n identification number for the face Number of degrees-of-freedom for the face Load distribution flag 4-80 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 40 – PEDGE(6609,66,9031) This record is created by the GP0 module; not by the user. Word 1 2 3 4 7 8 9 13 15 16 17 18 19 20 33 Name SID EDGEID CID N(3) EQTNID TABLID FIELD(4) G(2) F1ID F2ID PSEL MAXNDF INTFL UNDEF(13 ) CIDE Type I I I RS I I RS I I I I I I None I Coordinate system identification number of the edge Description Load set identification number Edge identification number Coordinate system identification number Components of a vector coordinate system defined by CID DEQATN identification number TABLE3D identification number See GMLOAD record Grid point identification numbers Grid-n 1 identification number Grid-n 2 identification number Computed p value Maximum number of degrees-of-freedom or stride 1 or 2 Record 41 – TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words 4.6 GEOM4 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. NX Nastran DMAP Programmer’s Guide 4-81 Chapter 4 Data Block Descriptions F-M Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – ASET(5561,76,215) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers Record 2 – ASET1(5571,77,216) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 3 4 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 3 – BNDGRID(10200,102,473) Word 1 Name GPI Type I Description Shape boundary grid point identification number Record 4 – BSET(110,1,311) Word 1 Name ID Type I Description Grid or scalar point identification number 4-82 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 Name C Type I Description Component numbers Record 5 – BSET1(210,2,312) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 3 4 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 6 – CSET(310,3,313) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers Record 7 – CSET1(410,4,314) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 Yes NX Nastran DMAP Programmer’s Guide 4-83 Chapter 4 Data Block Descriptions F-M Word 3 4 Name ID1 ID2 Type I I Description First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 8 – CYAX(1510,15,328) Word 1 Name G Type I Description Grid point identification number on the axis of symmetry Word 1 repeats until End of Record Record 9 – CYJOIN(5210,52,257) Word 1 2 4 Name SIDE C(2) ID Type I CHAR4 I Description Side identification number: 1 or 2 Coordinate system type on symetry booundary Grid or scalar point identification number Word 4 repeats until End of Record Record 10 – CYSUP(1610,16,329) Word 1 2 Name GID C Type I I Description Grid or scalar point identification number Component numbers Record 11 – CYSYM(1710,17,330) Word 1 2 Name NSEG STYPE(2) Type I CHAR4 Description Number of segments Symmetry type 4-84 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 12 – EGENDT(8801,88,9022) Word 1 2 3 4 5 6 7 8 Name LOADID SPCID EDGEID C DISTFLG DISFUN DISTAB FIELD(4) Type I I I I I I I RS Description Load set identification number SPC set identification number Edge identification number Component numbers Distribution flag Distribution function (DEQATN) Distribution table (TABLE3D) See GMBC record Words 4 through 11 repeat 6 times 12 13 14 15 16 17 18 19 21 22 24 25 26 27 28 ELTYPE EID EORD EDGEID FACEID CURVID SURFID G(2) MIDG POINT(2) F1ID F2ID NDOF CIDE MAXNDFE I I I I I I I I I I I I I I I Point identification numbers Grid-n 1 identification number Grid-n 2 identification number I,{ Coordinate system identification number for the edge Maximum number of degrees-of-freedom, or stride, for the edge Element type Element identification number Edge order Edge identification number Face identification number Curve identification number Surface identification number Grid point identification numbers NX Nastran DMAP Programmer’s Guide 4-85 Chapter 4 Data Block Descriptions F-M Word 29 30 31 32 33 34 35 36 37 38 Name MAXNDFB PUSER PSEL BODYFID NDOFB F1ID CID X Y Z Type I I I I I I I RS RS RS Description Maximum number of degrees-of-freedom, or stride, for the body p-level specified by user p-level selected by program Grid-n identification number for the body Number of degrees-of-freedom for the body Grid-n 1 identification number Coordinate system identification number S,{ S,{ S,{ Words 34 through 38 repeat 7 times Record 13 – FCENDT(9001,90,9024) Word 1 2 3 4 5 6 7 8 Name LOADID SID FACEID C DISTFLG DISFUN DISTAB FIELD(9) Type I I I I I I I RS Description Load set identification number Set identification number Face identification number Component numbers Distribution flag Distribution function (DEQATN) Distribution table (TABLE3D) See GMBC record Words 4 through 16 repeat 6 times 17 18 19 F1ID F2ID NDOF I I I Grid-n 1 identification number Grid-n 2 identification number Number of degrees-of-freedom for the face 4-86 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 20 21 Name MAXNDF CIDE Type I I Description Maximum number of degrees-of-freedom or stride Coordinate system identification number of the edge Words 17 through 21 repeat 4 times 22 23 24 25 26 27 28 29 30 31 35 36 37 38 42 46 47 48 49 50 51 FACFID NDOF MAXNDFF CIDF ELTYPE EID EORD FACEID SURFID G(4) CIDF MAXNDIF UNDEF PUSER(4) PSEL(4) FACFID NDOF F1ID CID X Y I I I I I I I I I I I I None I I I I I I RS RS p-level specified by user p-level selected by program Grid-n identification number for the face Number of degrees-of-freedom for the face Grid-n 1 identification number Coordinate system identification number Grid-n identification number for the face Number of degrees-of-freedom for the face Maximum number of degrees-of-freedom for the face Coordinate system identification number for the face Element type Element identification number Edge order Face identification number Surface identification number Grid point identification numbers Coordinate system identification number for the face NX Nastran DMAP Programmer’s Guide 4-87 Chapter 4 Data Block Descriptions F-M Word 52 Name Z Type RS Description Words 48 through 52 repeat 13 times Record 14 – GMBC(8001,80,395) Word 1 2 3 4 5 6 METHOD =1 7 8 METHOD =2 7 8 METHOD =3 7 METHOD =4 7 METHOD =5 7 METHOD =6 7 FIELD(9) FIELD(9) FIELD(9) FIELD(9) EQTNID UNDEF(8 ) TABLID UNDEF(8 ) Name LID SPCID C ENTITY ENTID METHOD Type I I I CHAR4 I I TABLE3D I None DEQATN I None CONSTANT RS LINEAR RS QUAD RS CUBIC RS Enforced displacement data Enforced displacement data Enforced displacement data Enforced displacement data DEQATN identification number TABLE3D identification number Description Load set identification number SPC set identification number Component number Entity type that is being loaded Entity identification number Method of data specification End METHOD 4-88 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 15 – GMSPC(7801,78,393) Word 1 2 3 4 Name ID C ENTITY ENTID Type I I CHAR4 I Description Set identification number Component number Entity type that is being loaded Entity identification number Record 16 – MPC(4901,49,17) Word 1 2 3 4 5 6 7 Name SID G C A GI CI AI Type I I I RX I I RX Description Set identification number Grid point identification number Component number Coefficient Grid point identification number Component number Coefficient Words 5 through 7 repeat until (-1,-1,-1) occurs Record 17 – MPCADD(4891,60,83) Word 1 2 Name SID S Type I I Description Set identification number Set identification number Word 2 repeats until End of Record Record 18 – OMIT(5001,50,15) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers NX Nastran DMAP Programmer’s Guide 4-89 Chapter 4 Data Block Descriptions F-M Record 19 – OMIT1(4951,63,92) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 3 4 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 20 – QSET(510,5,315) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers Record 21 – QSET1(610,6,316) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 3 4 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number 4-90 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word Name Type Description End THRUFLAG Record 22 – RBAR(6601,66,292) Word 1 2 3 4 5 6 7 Name EID GA GB CNA CNB CMA CMB Type I I I I I I I Description Element identification number Grid point A identification number Grid point B identification number Component numbers of independent degrees-of-freedom at end A Component numbers of independent degrees-of-freedom at end B Component numbers of dependent degrees-of-freedom at end A Component numbers of dependent degrees-of-freedom at end B Record 23 – RBE1(6801,68,294) Word 1 2 3 Name EID GN CN Type I I I Description Element identification number Grid point identification number for independent degrees-of-freedom Component numbers of independent degrees-of-freedom Words 2 through 3 repeat until (-2,-2) occurs 4 5 GM CM I I Grid point identification number for dependent degrees-of-freedom Component numbers of dependent degrees-of-freedom Words 4 through 5 repeat until (-1,-1) occurs NX Nastran DMAP Programmer’s Guide 4-91 Chapter 4 Data Block Descriptions F-M Record 24 – RBE2(6901,69,295) Word 1 2 3 4 Name EID GN CM GM Type I I I I Description Element identification number Grid point identification number for independent degrees-of-freedom Component numbers of dependent degrees-of-freedom Grid point identification number for dependent degrees-of-freedom Word 4 repeats until End of Record Record 25 – RBE3(7101,71,187) Word 1 2 3 4 5 6 Name EID REFG REFC WT1 C G Type I I I RS I I Description Element identification number Reference grid point identification number Component numbers at the reference grid point Weighting factor for components of motion at G Component numbers Grid point identification number Word 6 repeats until End of Record Words 4 through 6 repeat until End of Record 7 8 GM CM I I Grid point identification number for dependent degrees-of-freedom Component numbers of dependent degrees-of-freedom Words 7 through 8 repeat until End of Record Record 26 – RELEASE(1310,13,247) Word 1 2 Name SEID C Type I I Description Superelement identification number Component numbers 4-92 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 3 Name THRUFLAG Type I No I Description Thru range flag THRUFLAG=0 4 ID Grid or scalar point identification number Word 4 repeats until End of Record THRUFLAG=1 4 5 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 27 – RROD(6501,65,291) Word 1 2 3 4 5 Name EID GA GB CMA CMB Type I I I I I Description Element identification number Grid point A identification number Grid point B identification number Component numbers of dependent degrees-of-freedom at end A Component numbers of dependent degrees-of-freedom at end B Record 28 – RSPLINE(7001,70,186) Word 1 2 3 4 5 Name EID DBYL G1 G2 C2 Type I RS I I I Description Element identification number Ratio of the diameter to the sum of the segments lengths Grid point identification number Grid point identification number Components to be constrained Words 4 through 5 repeat until (-1,-1) occurs NX Nastran DMAP Programmer’s Guide 4-93 Chapter 4 Data Block Descriptions F-M Record 29 – RSSCON(7201,72,398) Word 1 2 TYPE =0 3 4 5 6 TYPE =01 3 4 5 6 7 8 TYPE =02 3 4 5 6 TYPE =03 3 4 5 TYPE =04 3 CBID ELID1 ELID2 UNDEF(4 ) EDGE1 EDGE2 EDGE3 UNDEF(3 ) GRID1 GRID2 GRID3 GRID4 GRID5 GRID6 GRID1 GRID2 GRID3 UNDEF(3 ) Name EID TYPE(C) Type I I GRID style 1 I I I None GRID style 2 I I I I I I Edge style I I I None Element style I I None CINTERF I Element identification number 1 Element identification number 2 Edge identification number 1 Edge identification number 2 Edge identification number 3 Grid identification number 1 Grid identification number 2 Grid identification number 3 Grid identification number 4 Grid identification number 5 Grid identification number 6 Grid identification number 1 Grid identification number 2 Grid identification number 3 Description Element identification number Type of connectivity 4-94 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 4 5 6 End TYPE Name SBID CBPID UNDEF(3) Type I I None Description Record 30 – RTRPLT(6701,67,293) Word 1 2 3 4 5 6 7 8 9 10 11 Name EID GA GB GC CNA CNB CNC UNDEF CMA CMB CMC Type I I I I I I I None I I I Component numbers for dependent degrees-of-freedom at vertex A Component numbers for dependent degrees-of-freedom at vertex B Component numbers for dependent degrees-of-freedom at vertex C Description Element identification number Grid point A identification number Grid point B identification number Grid point C identification number Component numbers for independent degrees-of-freedom at vertex A Component numbers for independent degrees-of-freedom at vertex B Component numbers for independent degrees-of-freedom at vertex C Record 31 – RWELD(11901,119,561) Word 1 2 3 Name EID GA TYPE Type I I I Description Element ID Grid ID of GA Type of shell element NX Nastran DMAP Programmer’s Guide 4-95 Chapter 4 Data Block Descriptions F-M Word 4 12 Name GI(8) GS Type I I Description Grid IDs of shell element Grid ID of GS Record 32 – SEBSET(710,7,317) Word 1 2 3 Name SEID ID C Type I I I Description Superelement identification number Grid or scalar point identification number Component numbers Record 33 – SEBSET1(810,8,318) Word 1 2 3 Name SEID C THRUFLAG Type I I I No I Grid or scalar point identification number Description Superelement identification number Component numbers Thru range flag THRUFLAG=0 4 ID Word 4 repeats until End of Record THRUFLAG=1 4 5 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 34 – SECSET(910,9,319) Word 1 2 3 Name SEID ID C Type I I I Description Superelement identification number Grid or scalar point identification number Component numbers 4-96 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 35 – SECSET1(1010,10,320) Word 1 2 3 Name SEID C THRUFLAG Type I I I No I Grid or scalar point identification number Description Superelement identification number Component numbers Thru range flag THRUFLAG=0 4 ID Word 4 repeats until End of Record THRUFLAG=1 4 5 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 36 – SEQSET(1110,11,321) Word 1 2 3 Name SEID ID C Type I I I Description Superelement identification number Grid or scalar point identification number Component numbers Record 37 – SEQSET1(1210,12,322) Word 1 2 3 Name SEID C THRUFLAG Type I I I No I Grid or scalar point identification number Description Superelement identification number Component numbers Thru range flag THRUFLAG=0 4 ID Word 4 repeats until End of Record THRUFLAG=1 Yes NX Nastran DMAP Programmer’s Guide 4-97 Chapter 4 Data Block Descriptions F-M Word 4 5 Name ID1 ID2 Type I I Description First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 38 – SESUP(1410,14,325) Word 1 2 3 Name SEID ID C Type I I I Description Superelement identification number Grid or scalar point identification number Component numbers Record 39 – SEUSET(1810,18,334) Word 1 2 3 4 Name SEID SNAME ID C Type I I I I Description Superelement identification number Set name Grid or scalar point identification number Component numbers Record 40– SEUSET1(1910,19,335) Word 1 2 3 4 Name SEID SNAME C THRUFLAG Type I I I I No I Grid or scalar point identification number Description Superelement identification number Set name Component numbers Thru range flag THRUFLAG=0 5 ID Word 5 repeats until End of Record THRUFLAG=1 Yes 4-98 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 5 6 Name ID1 ID2 Type I I Description First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 41 – SPC(5501,55,16) Word 1 2 3 4 Name SID ID C D Type I I I RS Description Set identification number Grid or scalar point identification number Component numbers Enforced displacement Record 42 – SPC1(5481,58,12) Word 1 2 3 Name SID C THRUFLAG Type I I I No I Grid or scalar point identification number Description Set identification number Component numbers Thru range flag THRUFLAG=0 4 ID Word 4 repeats until End of Record THRUFLAG=1 4 5 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG NX Nastran DMAP Programmer’s Guide 4-99 Chapter 4 Data Block Descriptions F-M Record 43 – SPCADD(5491,59,13) Word 1 2 Name SID S Type I I Description Set identification number Set identification number Word 2 repeats until End of Record Record 44 – SPCD(5110,51,256) Word 1 2 3 4 Name SID ID C D Type I I I RS Description Superelement identification number Grid or scalar point identification number Component numbers Enforced displacement Record 45 – SPCDE(8701,87,9021) Word 1 2 3 4 5 6 Name LOADID ID C D EDGEID SID Type I I I RS I I Description Load set identification number Grid or scalar point identification number Component numbers Enforced displacement Edge identification number Set identification number Record 46 – SPCDF(8901,89,9023) Word 1 2 3 4 Name LOADID ID C D Type I I I RS Description Load set identification number Grid or scalar point identification number Component numbers Enforced displacement 4-100 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 5 6 Name FACEID SID Type I I Description Face identification number Set identification number Record 47 – SPCDG(9701,97,9030) Word 1 2 3 4 5 6 Name LOADID ID C METHOD D SID Type I I I I RS I Description Load set identification number Grid or scalar point identification number Component numbers Method Enforced displacement Set identification number Record 48 – SPCE(9301,93,9027) Word 1 2 3 4 5 Name SID ID C D EDGID Type I I I RS I Description Set identification number Grid or scalar point identification number Component numbers Enforced displacement Grid or scalar point identification number Record 49 – SPCEB(9101,91,9025) Word 1 2 3 4 5 Name SID ID C D EDGEID Type I I I RS I Description Set identification number Grid or scalar point identification number Component numbers Enforced displacement Edge identification number NX Nastran DMAP Programmer’s Guide 4-101 Chapter 4 Data Block Descriptions F-M Record 50 – SPCF(9401,94,9028) Word 1 2 3 4 5 Name SID ID C D FACEID Type I I I RS I Description Set identification number Grid or scalar point identification number Component numbers Enforced displacement Face identification number Record 51 – SPCFB(9201,92,9026) Word 1 2 3 4 5 Name SID ID C D LOADID Type I I I RS I Description Set identification number Grid or scalar point identification number Component numbers Enforced displacement Load set identification number Record 52 – SPCGB(9601,96,9029) Word 1 2 3 4 5 6 Name LOADID ID C METHOD D SID Type I I I I RS I Description Load set identification number Grid or scalar point identification number Component numbers I,{ Enforced displacement Set identification number Record 53 – SPCGRID(8601,86,9031) Word 1 Name SID Type I Description Set identification number 4-102 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 3 4 Name ID C UNDEF(2 ) Type I I None Description Grid or scalar point identification number Component numbers Record 54 – SPCOFF(6110,61,343) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers Record 55 – SPCOFF1(6210,62,344) Word 1 2 Name C THRUFLAG Type I I No I Grid or scalar point identification number Description Component numbers Thru range flag THRUFLAG=0 3 ID Word 3 repeats until End of Record THRUFLAG=1 3 4 ID1 ID2 Yes I I First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 56 – SUPORT(5601,56,14) Word 1 2 Name ID C Type I I Description Grid or scalar point identification number Component numbers NX Nastran DMAP Programmer’s Guide 4-103 Chapter 4 Data Block Descriptions F-M Record 57 – SUPORT1(10100,101,472) Word 1 2 3 Name SID ID C Type I I I Description Set identification number Grid point identification number Component numbers Words 2 through 3 repeat until (-1,-1) occurs Record 58 – TEMPBC(11309,113,426) Word 1 2 3 4 Name SID TYPE TEMP GID Type I I RS I Description Temperature set identification number Type of temperature boundary condition: STAT or TRAN Temperature Grid or scalar point identification number Record 59 – USET(2010,20,193) Word 1 2 3 Name SNAME ID C Type I I I Description Set name Grid or scalar point identification number Component numbers Record 60 – USET1(2110,21,194) Word 1 2 3 Name SNAME C THRUFLAG Type I I I No I Grid or scalar point identification number Description Set name Component numbers Thru range flag THRUFLAG=0 4 ID Word 4 repeats until End of Record 4-104 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word Name Type Yes I I Description THRUFLAG=1 4 5 ID1 ID2 First grid or scalar point identification number Second grid or scalar point identification number End THRUFLAG Record 61– TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words 4.7 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 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – POINT Word 1 2 3 4 5 6 Name ID CP X1 X2 X3 CD Type I I RS RS RS I Description Internal grid point identification number Location coordinate system identification number Location of the point in coordinate 1 of CP (X, R or Rho) Location of the point in coordinate 2 of CP (Y, Theta or Theta) Location of the point in coordinate 3 of CP (Z, Phi or Phi) Degree-of-freedom coordinate system identification number NX Nastran DMAP Programmer’s Guide 4-105 Chapter 4 Data Block Descriptions F-M Word 7 Name PS Type I Description Permanent single-point constraints Record 2 – TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of grid points and scalar points Notes: 1. Scalar points are identified by CP=-1 and words X1 through PS are zero. 2. See the description of the “GRID” in the NX Nastran Quick Reference Guide Bulk Data entry constraint code, PS. 3. For fluid grid points, CD=-1. 4.8 GPL Grid point list Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – GRID Contains a list of external grid and scalar identification numbers in internal sort. Word 1 Name GRIDID Type I Description External grid or scalar identification number Record 2 – GRIDSIL Contains pairs of external grid and scalar identification numbers and sequence numbers in internal sort. Word 1 Name GRIDID Type I Description External grid or scalar identification number 4-106 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 Name SEQNO Type I Description Sequence number = 1000 * external identification number Record 3 – TRAILER Word 1 2 Name NGS UNDEF(5 ) Type I None Description Total number of grid and scalar points Notes: 1. SEQNO, sequence number, can be overridden by the SEQGP Bulk Data entry. 4.9 HIS Table of design iteration history Contains a compilation of information from the convergence checks. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – Repeat Word 1 2 3 4 5 6 7 8 Name DSITER CVTYP CVPROV OBJ1 OBJO GMAX IRMAX XVAL Type I I I RS RS RS I RS Description Design iteration number Convergence type: 1=soft or 2=hard Convergence result: 0=no, 1=soft, or 2=hard Initial objective value Final objective value Maximum constraint value Row of the maximum constraint value Design variable value NX Nastran DMAP Programmer’s Guide 4-107 Chapter 4 Data Block Descriptions F-M Word Name Type Description Word 8 repeats until End of Record Record 2 – TRAILER Word 1 2 Name NDV UNDEF(5 ) Type I None Description Number of design variables 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. 4.10 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 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – Repeat Repeats for each element type. Word 1 2 3 4 5 Name ELTYPE NUMWDS NUMGRID(C) DOFPERG FORM(C) Type I I I I I Description Element type Number of words per entry Number of defined grid points Degrees of freedom per grid point Form of element matrix 4-108 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 6 7 8 9 10 FORM =3 11 Name EID NACTIVEG GE ADDRESS1 ADDRESS2 Type I I RS I I Description Element identification number Number of active grid points Material damping constant GINO address of matrix GINO address of matrix Lower left triangle in global coord. system SIL I SIL values of connected grid points Word 11 repeats NUMGRID times FORM =4 11 SIL Lower left triangle and transformation matrices I SIL values of connected grid points Word 11 repeats NUMGRID times 12 13 14 15 16 17 18 19 20 FORM =5 11 SIL E11 E21 E31 E12 E22 E32 E13 E23 E33 RX RX RX RX RX RX RX RX RX Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Element to basic transformation Lower left triangle in basic coordinate system I SIL values of connected grid points Word 11 repeats NUMGRID times End FORM Words 6 through max repeat until End of Record NX Nastran DMAP Programmer’s Guide 4-109 Chapter 4 Data Block Descriptions F-M Record 2 – TRAILER Word 1 2 3 4 Name PREC MAXROW MAXGRID UNDEF(3 ) Type I I I None Description Precision of element matrices (1 or 2) Maximum number of rows in an element matrix Maximum number of grid points in a FORM=4 record Notes: 1. FORM=3 indicates that the element stiffness matrix is defined in the global coordinate system. 2. FORM=4 indicates that the element stiffness matrix is defined in the element coordinate system. The transformation matrix is also contained in each element dictionary. 3. FORM=5 indicates that the element stiffness matrix is defined in the basic coordinate system. 4. SIL=0 indicates inactive degrees-of-freedom. 4.11 LAMA Normal modes or buckling eigenvalue summary table Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – OFPID – OFP Header Record Word 1 3 10 11 12 51 Name RECID(2) UNDEF(7 ) SEVEN RESFLG UNDEF(39 ) TITLE(32) Type I None I I None CHAR4 Title character string (TITLE) Constant 7 Residual vector augmentation flag Description Constants 21 and 6 4-110 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 83 115 Name SUBTITLE(32) LABEL(32) Type CHAR4 CHAR4 Description Subtitle character string (SUBTITLE) LABEL character string (LABEL) Record 2 – LAMA Repeats for each eigenvalue. Word 1 2 3 4 5 6 7 Name MODE ORDER EIGEN OMEGA FREQ MASS STIFF Type I I RS RS RS RS RS Description Mode number Extraction order Eigenvalue Square root of eigenvalue Frequency Generalized mass Generalized stiffness Record 3 – TRAILER Word 1 2 Name NMODES UNDEF(6 ) Type I None Description Number of modes 4.12 MPT Table of Bulk Data entry images related to material properties Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name NX Nastran DMAP Programmer’s Guide 4-111 Chapter 4 Data Block Descriptions F-M Record 1 – CREEP(1003,10,245) Word 1 2 3 4 5 6 7 8 9 10 Name MID T0 EXP FORM TIDKP TIDCP TIDCS THRESH TYPE AG(7) Type I RS RS I I I I RS I RS Description Material identification number Reference temperature Temperature-dependent term in the creep rate expression Form of the input data: "CRLAW" or "TABLE" TABLES1 ID which defines creep model parameter Kp TABLES1 ID which defines creep model parameter Cp TABLES1 ID which defines creep model parameter Cs Threshold limit for creep process Empirical creep law identification number Coefficients of the empirical creep law Record 2 – MAT1(103,1,77) Word 1 2 3 4 5 6 7 8 9 10 11 Name MID E G NU RHO A TREF GE ST SC SS Type I RS RS RS RS RS RS RS RS RS RS Description Material identification number Young’s modulus Shear modulus Poisson’s ratio Mass density Thermal expansion coefficient Reference temperature Structural element damping coefficient Stress limit for tension Stress limit for compression Stress limit for shear 4-112 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 12 Name MCSID Type I Description Material coordinate system identification number Record 3 – MAT2(203,2,78) Word 1 2 8 9 12 13 14 15 16 17 Name MID GIJ(6) RHO AJ(3) TREF GE ST SC SS MCSID Type I RS RS RS RS RS RS RS RS I Description Material identification number Material property matrix Mass density Thermal expansion coefficients Reference temperature Structural element damping coefficient Stress limit for tension Stress limit for compression Stress limit for shear Material coordinate system identification number Record 4 – MAT3(1403,14,122) Word 1 2 3 4 5 6 7 8 9 Name MID EX ETH EZ NUXTH NUTHZ NUZX RHO GZX Type I RS RS RS RS RS RS RS RS Description Material identification number Young’s modulus in the x direction Young’s modulus in the theta direction Young’s modulus in the z direction Poisson’s ratios in x-theta direction Poisson’s ratios in theta-z direction Poisson’s ratios in z-x direction Mass density Shear modulus in the z-x direction NX Nastran DMAP Programmer’s Guide 4-113 Chapter 4 Data Block Descriptions F-M Word 10 11 12 13 14 15 16 Name UNDEF AX ATH AZ TREF GE UNDEF Type None RS RS RS RS RS None Description Thermal expansion coefficient in the x direction Thermal expansion coefficient in the theta direction Thermal expansion coefficient in the z direction Reference temperature Structural element damping coefficient Record 5 – MAT4(2103,21,234) Word 1 2 3 4 5 6 7 8 9 10 11 Name MID K CP RHO H MU HGEN REFENTH TCH TDELTA QLAT Type I RS RS RS RS RS RS RS RS RS RS Description Material identification number Thermal conductivity Heat capacity per unit mass at constant pressure Mass density Free convection heat transfer coefficient Dynamic viscosity Heat generation capability used with QVOL entries Reference enthalpy Lower temperature limit for phase change region Total temperature change range Latent heat of fusion per unit mass Record 6 – MAT5(2203,22,235) Word 1 2 Name MID KIJ(6) Type I RS Description Material identification number Thermal conductivity matrix 4-114 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 8 9 10 Name CP RHO HGEN Type RS RS RS Description Heat capacity per unit mass Mass density Heat generation capability used with QVOL entries Record 7 – MAT8(2503,25,288) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 Name MID E1 E2 NU12 G12 G1Z G2Z RHO A1 A2 TREF XT XC YT YC S GE F12 Type I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Material identification number Modulus of elasticity in longitudinal direction Modulus of elasticity in lateral direction Poisson’s ratio In-plane shear modulus Transverse shear modulus for shear in 1-Z plane Transverse shear modulus for shear in 2-Z plane Mass density Thermal expansion coefficient in longitudinal direction Thermal expansion coefficient in lateral direction Reference temperature for the calculation of thermal loads Allowable longitudinal stress or strain in tension Allowable longitudinal stress or strain in compression Allowable lateral stress or strain in tension Allowable lateral stress or strain in compression Allowable stress or strain for in-plane shear Structural damping coefficient Interaction term in the tensor polynomial theory of Tsai-Wu NX Nastran DMAP Programmer’s Guide 4-115 Chapter 4 Data Block Descriptions F-M Word 19 Name STRN Type RS Description For the maximum strain theory only Record 8 – MAT9(2603,26,300) Word 1 2 23 24 30 31 32 Name MID G(21) RHO A(6) TREF GE UNDEF(4 ) Type I RS RS RS RS RS None Description Material identification number Material property matrix Mass density Thermal expansion coefficients Reference temperature for the calculation of thermal loads Structural damping coefficient Record 9 – MAT10(2801,28,365) Word 1 2 3 4 5 Name MID BULK RHO C GE Type I RS RS RS RS Description Material identification number Bulk modulus Mass density Speed of sound Structural damping coefficient Record 10 – MAT11(2903,29,371) This record is not currently used. Word 1 2 3 4 Name MID E1 E2 E3 Type I RS RS RS Description 4-116 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 5 6 7 8 9 10 11 12 15 16 17 18 19 20 21 22 23 Name V12 V23 V31 G12 R23 G31 RHO A(3) XT XC YT YC ZT ZC S12 S23 S31 Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Record 11 – MATG (8310,83,403) Word 1 2 3 4 5 15 16 Name MID IDMEM BEHAV TABLD TABLUi YPRS EPL Type I I I I I RS RS Description Material identification number ID of MAT1 Behavior type (not used) ID of TABLES1 ID of TABLES1 (I=1 to 10) Initial yield pressure Tensile modulus NX Nastran DMAP Programmer’s Guide 4-117 Chapter 4 Data Block Descriptions F-M Word 17 18 19 20 21 22 Name GPL GAP TABYPRS TABEPL TABGPL TABGAP Type RS RS I I I I Description Transverse shear modulus Initial gap (not used) ID of TABLES1 (not used) ID of TABLES1 (not used) ID of TABLES1 (not used) ID of TABLES1 (not used) Record 12 – MATHE (7910,79,596) MATHE Format 1: (default) Mooney-Rivlin model (Model = Mooney) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name MID Model UNDEF K RHO Texp Tref GE C10 C01 UNDEF TAB1 TAB2 TAB3 TAB4 TABD C20 I RS Type I I None RS RS RS RS RS RS RS None I I I Description Material identification number Mooney-Rivlin model Not used Bulk Modulus Mass density Coefficient of thermal expansion Reference temperature Structural damping (not used) Material constant Material constant Not used Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) Material constant 4-118 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 18 19 20 21 22 23 24 Name C11 C02 C30 C21 C12 C03 -1 Type RS RS RS RS RS RS I Description Material constant Material constant Material constant Material constant Material constant Material constant Delimiter MATHE Format 2: Ogden model or Hyperfoam model (Model = Ogden or Foam) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Name MID Model NOT K RHO Texp Tref GE Mul Alpha1 Beta1 TAB1 TAB2 TAB3 TAB4 TABD Type I I I RS RS RS RS RS RS RS None I I I I I Description Material identification number Ogden or Foam Curve fitting terms (not used) Bulk Modulus Mass density Coefficient of thermal expansion Reference temperature Structural damping (not used) Coefficient Coefficient Coefficient Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) NX Nastran DMAP Programmer’s Guide 4-119 Chapter 4 Data Block Descriptions F-M Word 17-40 41 Name Mu2 to Beta9 -1 Type RS I Description Coefficients Delimiter MATHE Format 3: Arruda-Boyce model (Model = Aboyce) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name MID Model UNDEF K RHO Texp Tref GE NKT N UNDEF TAB1 TAB2 TAB3 TAB4 TABD -1 I I Type I I None RS RS RS RS RS RS RS None I I I Description Material identification number Aboyce Not used Bulk Modulus Mass density Coefficient of thermal expansion Reference temperature Structural damping (not used) Material constant Material constant Not used Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) Table ID (not used) Delimiter Record 13 – MATHP(4506,45,374) Word 1 Name MID Type I Description Material identification number 4-120 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 Name A10 A01 D1 RHO ALPHA TREF GE SF NA ND KP A20 A11 A02 D2 A30 A21 A12 A03 Type RS RS RS RS RS RS RS I I I RS RS RS RS RS RS RS RS RS Description Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to volumetric deformation Mass density Coefficient of volumetric thermal expansion Reference temperature Structural damping element coefficient ??? Order of the distortional strain energy polynomial function Order of the volumetric strain energy polynomial function ??? Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to volumetric deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation NX Nastran DMAP Programmer’s Guide 4-121 Chapter 4 Data Block Descriptions F-M Word 21 22 23 24 25 26 27 28 29 30 31 32 33 34 Name D3 A40 A31 A22 A13 A04 D4 A50 A41 A32 A23 A14 A05 D5 Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Material constant related to volumetric deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to volumetric deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to distortional deformation Material constant related to volumetric deformation 35 CONTFLG I Continuation flag CONTFLG =1 36 TAB1 With continuation I TABLES1 identification number which defines tension/compression 4-122 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 37 38 39 40 43 Name TAB2 TAB3 TAB4 UNDEF(3 ) TAB5 Type I I I None I Description TABLES1 identification number which defines equibiaxial tension TABLES1 identification number which defines simple shear TABLES1 identification number which defines pure shear TABLES1 identification number which defines volumetric compression CONTFLG =0 End CONTFLG Without continuation Record 14 – MATS1(503,5,90) Word 1 2 3 4 5 6 7 8 9 Name MID TID TYPE H YF HR LIMIT1 LIMIT2 UNDEF(3 ) Type I I I RS I I RS RS None Description Material identification number TABLES1 or TABLEST entry identification number Type of material nonlinearity Work hardening slope Yield function criterion Hardening Rule Initial yield point Internal friction angle Record 15 – MATT1(703,7,91) Word 1 2 12 Name MID TID(10) UNDEF Type I I None Description Material identification number TABLEMi entry identification numbers NX Nastran DMAP Programmer’s Guide 4-123 Chapter 4 Data Block Descriptions F-M Record 16 – MATT2(803,8,102) Word 1 2 17 Name MID TID(15) UNDEF Type I I None Description Material identification number TABLEMi entry identification numbers Record 17 – MATT3(1503,15,189) Word 1 2 Name MID TID(15) Type I I Description Material identification number Entry identification numbers Record 18 – MATT4(2303,23,237) Word 1 2 3 4 5 6 7 Name MID TK TCP UNDEF TH TMU THGEN Type I I I None I I I TABLEMi identification number for free convection heat transfer coefficient TABLEMi identification number for dynamic viscosity TABLEMi identification number for heat generation with QVOL entries Description Material identification number TABLEMi identification number for thermal conductivity TABLEMi identification number for heat capacity per unit mass Record 19 – MATT5(2403,24,238) Word 1 2 Name MID TK(6) Type I I Description Material identification number TABLEMi identification numbers for thermal conductivity 4-124 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 8 9 10 Name TCP UNDEF THGEN Type I None I Description TABLEMi identification number for heat capacity per unit mass TABLEMi identification number for heat generation with QVOL entries Record 20– MATT8(903,9,336) Word 1 2 11 12 19 Name MID TID(9) UNDEF TID(7) UNDEF Type I I None I None TABLEMi entry identification numbers TABLEMi entry identification numbers Description Record 21 – MATT9(2703,27,301) Word 1 2 23 24 30 31 32 Name MID TG(21) TRHO TA(6) UNDEF TGE UNDEF(4 ) Type I I I I None I None TABLEMi identification number for structural damping coefficient Description Material identification number TABLEMi identification numbers for material property matrix TABLEMi identification number for mass density TABLEMi identification numbers for thermal expansion coefficients Record 22 – RADBND(9002,90,410) Word 1 Name NUMBER Type I Description Number of radiation wave bands NX Nastran DMAP Programmer’s Guide 4-125 Chapter 4 Data Block Descriptions F-M Word 2 3 Name PLANCK2 LAMBDA Type RS RS Description Planck’s second radiation constant Highest wavelength of the i-th wave band Word 3 repeats until End of Record Record 23 – RADM(8802,88,413) Word 1 2 3 Name NUMBER(C) MID EMISI Type I I RS Description Number of emissivities including absorptivity Material identification number Surface emissivity at wavelength LAMBDAi Word 3 repeats NUMBER times Words 2 through 3 repeat until End of Record Record 24 – RADMT(8902,89,423) Word 1 2 3 Name NUMBER(C) MID TEMISI Type I I I Description Number of emissivities Material identification number TABLEMi ID for surface emissivity Word 3 repeats NUMBER times Words 2 through 3 repeat until End of Record Record 25 – NLPARM(3003,30,286) Word 1 2 3 4 5 Name SID NINC DT KMETHOD KSTEP Type I I RS I I Description Set identification number Number of increments Incremental time interval for creep analysis Method for controlling stiffness updates Number of iterations before the stiffness update 4-126 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Word 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name MAXITER CONV INTOUT EPSU EPSP EPSW MAXDIV MAXQN MAXLS FSTRESS LSTOL MAXBIS MAXR RTOLB Type I I I RS RS RS I I I RS RS I RS RS Description Limit on number of iterations for each load increment Flags to select convergence criteria Intermediate output flag Error tolerance for displacement U criterion Error tolerance for displacement P criterion Error tolerance for displacement W criterion Limit on probable divergence conditions Maximum number of quasi-Newton correction vectors Maximum number of line searches Fraction of effective stress Line search tolerance Maximum number of bisections Maximum ratio for the adjusted arc-length increment Maximum value of incremental rotation Record 26 – NLPCI(3104,32,350) Word 1 2 3 4 5 6 7 8 Name SID TYPE MINALR MAXALR SCALE UNDEF DESITER MXINC Type I CHAR4 RS RS RS None I I Desired number of iterations for convergence Maximum number of controlled increment steps Description Set identification number Constraint type Minimum allowable arc-length adjustment ratio Maximum allowable arc-length adjustment ratio Scale factor (w) for controlling the loading contribution NX Nastran DMAP Programmer’s Guide 4-127 Chapter 4 Data Block Descriptions F-M Record 27 – TSTEPNL(3103,31,337) Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Name SID NDT DT NO METHOD KSTEP MAXITER CONV EPSU EPSP EPSW MAXDIV MAXQN MAXLS FSTRESS MAXBIS ADJUST MSTEP RB MAXR UTOL RTOLB Type I I RS I I I I I RS RS RS I I I RS I I I RS RS RS RS Description Set identification number Number of time steps of value DT Time increment Time step interval for output Method for dynamic matrix update Time step interval or number of converged bisections Limit on number of iterations Flags to select convergence criteria Error tolerance for displacement U criterion Error tolerance for displacement P criterion Error tolerance for displacement W criterion Limit on probable divergence conditions Maximum number of quasi-Newton correction vectors Maximum number of line searches Fraction of effective stress Maximum number of bisections Time step skip factor for automatic time step adjustment Number of steps to obtain the dominant period response Define bounds for maintaining the same time step Maximum ratio for the adjusted arc-length increment Tolerance on displacement or temperature increment Maximum value of incremental rotation 4-128 NX Nastran DMAP Programmer’s Guide Data Block Descriptions F-M Record 28 – TRAILER Word 1 Name BIT(6) Type I Description Record presence trailer words NX Nastran DMAP Programmer’s Guide 4-129 Chapter 5 Data Block Descriptions O-V • • • • • • • • • • • • • OBC OBJTAB OEE OEF OES OGF OGK OGS OMECON OMEOSC OMKEC OMKEO OMSEC • • • • • • • • • • • • OMSEO OPG OPTPRM OQG OUG R1MAP R1TAB RESP12 SEMAP SET TOL VIEWTB NX Nastran DMAP Programmer’s Guide 5-1 Chapter 5 Data Block Descriptions O-V 5.1 OBC Output contact pressure and traction results For SOL 101, SOL 601,106, SOL 601,129 and SOL 701. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name, for example, OBC1 Record 1 – IDENT Word 1 2 3 4 TCODE=1 ACODE=01 5 ACODE=10 5 End ACODE TCODE=2 5 End TCODE 6 8 9 10 11-50 51 UNDEF(2) LOADSET FCODE NUMWDE UNDEF TITLE(32) none I I I None CHAR4 Title Load set or zero 1 Number of words per entry in DATA record EKEY SORT2 I Device code + 10 * point identification number TIME LOADSET Name ACODE(C) TCODE(C) UNDEF SUBCASE Type I I None I SORT1 SOL 101 Linear Statics I Load set or zero Description Device code + 10* Approach Code Table code, 62 601 & 701 Nonlinear RS Time Step 5-2 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 83 115 Name SUBTITL(32) LABEL(32) Type CHAR4 CHAR4 Description Subtitle Label Record 2 – DATA Word TCODE=1 1 TCODE=2 ACODE=01 1 ACODE=10 1 End ACODE End TCODE 2 3 4 5 P T1 T2 T3 RS RS RS RS Contact Pressure Contact tangential traction in direction X (Base C.S.) Contact tangential traction in direction Y (Base C.S.) Contact tangential traction in direction Z (Base C.S.) TIME LOADSET EKEY Name Type SORT1 I SORT2 SOL 101 Linear Statics I Load set or zero Device code + 10 * point identification number Description 601 & 701 Nonlinear RS Time Step Repeat word 1-5 for each grid point. Notes: 1. Contact results are grid point based results. 2. Contact tangential traction is expressed as a vector data (magnitude and direction) in X, Y and Z components of Basic Coordinate System. 3. SORT2 is supported only for SOL 101 Linear Statics. NX Nastran DMAP Programmer’s Guide 5-3 Chapter 5 Data Block Descriptions O-V 5.2 OBJTAB Design objective table OBJTAB is defined for a given analysis type and superelement and contains objective attributes with retained response identification numbers. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – HEADER Word 1 2 3 4 5 6 Name IRID RTYPE1 RTYPE2 MINMAX SEID SID Type I I I I I I Description Response identification number Type of response: 1 or 2 Type of response: 1 or 2 Minimum/maximum flag: -1=minimum and 1=maximum Superelement identification number Subcase identification number Record 2 – TRAILER Word 1 Name UNDEF(6 ) Type None Description 5.3 OCCORF Table of cross-correlation functions. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name 5-4 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 1 – IDENT Word 1 2 3 4 5 6 7 9 10 11 12 13 14 15 16 17 18 51 83 115 Name ACODE(C) TCODE(C) UNDEF RANDID DCODE RCROSSID UNDEF(2) FCODE NUMWDE(C) RTYPE1 ID1 COMP1 RTYPE2 ID2 COMP2 CURID UNDEF(33) TITLE(32) SUBTITL(32) LABEL(32) Type I I none I I I none I I CHAR4 I I CHAR4 I I I none CHAR4 CHAR4 CHAR4 Title Subtitle Label Format Code Length of entries in RECORD=DATA (always 3) Type of first response quantity Element, grid or scalar point ID number Component code (item) ID number Type of second response quantity Element, grid, or scalar point ID number Component code (item) ID number Curve ID number RANDOM set identification number Device code +10*function number RCROSS identification number Description Device code + 10*Approach code Table code; always 4200 Record 2 – DATA Word 1 2 Name FREQ CCORF Type RS RS Description Frequency (Hz) Cross-correlation function NX Nastran DMAP Programmer’s Guide 5-5 Chapter 5 Data Block Descriptions O-V Record 3– TRAILER Word 1 2 3 Name WORD1 WORD2 UNDEF(4) Type I I none Description Number of records Number of data values in record 2. 5.4 OCPSDF Table of cross-power spectral density functions. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – IDENT Word 1 2 3 4 5 6 7 9 10 11 12 13 14 Name ACODE(C) TCODE(C) UNDEF RANDID DCODE RCROSSID UNDEF(2) FCODE NUMWDE(C) RTYPE1 ID1 COMP1 RTYPE2 Type I I none I I I none I I CHAR4 I I CHAR4 Format code Length of entries in RECORD=DATA (always 3) Type of first response quantity Element, grid or scalar point ID number Component code (item) ID number Type of second response quantity RANDOM set identification number Device code +10*function number RCROSS identification number Description Device code + 10*Approach code Table code; always 4100 5-6 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 15 16 17 18 51 83 115 Name ID2 COMP2 CURID UNDEF(33) TITLE(32) SUBTITL(32) LABEL(32) Type I I I none CHAR4 CHAR4 CHAR4 Description Element, grid, or scalar point ID number Component code (item) ID number Curve ID number Title Subtitle Label Record 2 – DATA Word 1 2 3 Name FREQ CPSDFR CPSDFI Type RS RS RS Description Frequency (Hz) Real part of cross-power spectral density function value Imaginary part of cross-power spectral density function value Record 3– TRAILER Word 1 2 3 Name WORD1 WORD2 UNDEF(4) Type I I none Description Number of records Number of data values in record 2. 5.5 OEE Output element energy (strain, kinetic, loss) Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Block Name NX Nastran DMAP Programmer’s Guide 5-7 Chapter 5 Data Block Descriptions O-V Record 1 - IDENT Word 1 2 Name ACODE(C) TCODE(C) Type I I Description Device code + 10*approach code 18 for strain, 36 for kinetic, and 37 for energy loss Total strain energy of all elements in subcase/mode Subcase number 3 ETOTAL RS 4 ACODE,4 =0 5 ACODE,4 =01 5 ACODE,4 =02 5 ACODE,4 =03 5 ACODE,4 =04 5 ACODE,4 =05 5 ACODE,4 =06 5 ACODE,4 =07 5 ACODE,4 =08 5 ACODE,4 =09 SUBCASE I UNDEF None Statics Not defined UNDEF None Real Eigenvalues See word 8 MODE I Differential Stiffness Mode Number UNDEF None Differential Stiffness See word 8 UNDEF None Frequency See word 8 FREQ RS Transient Frequency TIME RS Time Step Buckling 0 ( Pre buckling ) UNDEF None See word 8 Buckling 1 ( Post buckling ) MODE I Complex Eigenvalues Mode Number 5-8 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 ACODE,4 =10 5 ACODE,4 =11 5 ACODE,4 =12 5 End ACODE,4 6 8 9 10 11 12 Name MODE Type I Description Mode Number Nonlinear Statics ( Sol 106 ) LOADFAC RS Load factor Geometric Nonlinear Statics ( Sol 4 ? ) ) UNDEF None See word 8 CONTRAN ? ( Can appear as ACODE=6 ) TIME RS Time Step ELNAME(2) LOADSET APROACH NUMWDE CVALRES ESUBT CHAR4 I I I I RS Element type name Load set or zero Approach Number of words per entry in DATA record C Subtotal of Strain Energy in the Set identification number Set identification number Number Natural eigenvalue real part Natural eigenvalue imaginary part Natural frequency 13 14 15 16 17 18 19 SETID EIGENR EIGENI FREQ UNDEF ETOTPOS ETOTNEG I RS RS RS None RS RS Total positive energy Total negative energy NX Nastran DMAP Programmer’s Guide 5-9 Chapter 5 Data Block Descriptions O-V Word 20 Name FCODE Type I Description Format Code 1 – Real 2 – Real/Imaginary 3 – Magnitude/Phase 21 22 23 51 83 115 ELTYPE THRESH UNDEF(28) TITLE(32) SUBTITL(32) LABEL(32) I RS None CHAR4 CHAR4 CHAR4 Element Type Energy Threshold Title Subtitle Label Record 2 - DATA Word TCODE,1 =1 1 TCODE,1 =02 ACODE,4 =0 1 ACODE,4 =01 1 ACODE,4 =02 1 ACODE,4 =03 1 ACODE,4 =04 1 ACODE,4 =05 EKEY I EKEY I EKEY I EKEY I UNDEF None Not defined EKEY Name Type Sort 1 I Sort 2 - Swap with word 5 of IDENT Description 5-10 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 ACODE,4 =06 1 ACODE,4 =07 1 ACODE,4 =08 1 ACODE,4 =09 1 ACODE,4 =10 1 ACODE,4 =11 1 ACODE,4 =12 1 End ACODE,4 End TCODE,1 2 Name FREQ Type RS Description Frequency TIME RS Time step EKEY I EKEY I EKEY I FQTS RS Frequency or Time step EKEY I EKEY I ENERGY RS Element Energy or Subtotal after all elements Percent of Total Energy Element Energy Density, or ’-1’ after all elements 3 4 TCODE,7=0 (Real) 1 2 3 4 PCT DEN RS RS Real ID ENERGY PCT DEN I RS RS RS (depends on TCODE,1) Element Energy Percent of Total Energy Element Energy Density NX Nastran DMAP Programmer’s Guide 5-11 Chapter 5 Data Block Descriptions O-V Word TCODE,7=1 (Real/Imaginary or Magnitude/Phase) CVALRES=1,2 1 2 3 4 5 CVALRES=4 1 2 3 4 5 6 7 End CVALRES End TCODE,7 Name Type Description ID ENERGY.R ENERGY.I PCT DEN I RS RS RS RS (depends on TCODE,1) Element Energy (real/mag part) Element Energy (imag/phase part) Percent of Total Energy Element Energy Density ID ENERGY.R ENERGY.I ENERGY.R ENERGY.I PCT DEN I RS RS RS RS RS RS (depends on TCODE,1) Element Ave Energy (real/mag part) Element Ave Energy (imag/phase part) Element Amp Energy (real/mag part) Element Amp Energy (imag/phase part) Percent of Total Energy Element Energy Density Record 3- TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of element types output 5-12 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V 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, and so on 3. Approach code: 1 = statics 2 = reigen, 3=ds0 4 = ds1 5 = freq 6 = bkl0 7 = bkl 8 = ceigen 9 = pla 4. Nonexistent element energy densities are flagged by integer ’-1’ in the field. 5.6 OEF Table of element forces Also contains composite failure indices and analysis types (real and complex), and SORT1 and SORT2 formats. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2 ) Type CHAR4 I I I None Description Data block name NX Nastran DMAP Programmer’s Guide 5-13 Chapter 5 Data Block Descriptions O-V Record 1 - IDENT Word 1 2 3 4 TCODE,1 =1 ACODE,4 =01 5 6 LOADID UNDEF(2 ) Name ACODE(C) TCODE(C) ELTYPE(C) SUBCASE Type I I I I SORT1 format Statics I None Normal modes or buckling (real eigenvalues) I RS None Differential Stiffness 0 I None Differential Stiffness 1 I None Frequency RS None Transient RS None Pre-buckling Time step Frequency Load set identification number Load set identification number Mode number Eigenvalue Load set identification number Description Device code + 10*Approach code Table code Element type Subcase or Random identification number ACODE,4 =02 5 6 7 MODE EIGN UNDEF ACODE,4 =03 5 6 LOADID UNDEF(2 ) ACODE,4 =04 5 6 LOADID UNDEF(2 ) ACODE,4 =05 5 6 FREQ UNDEF(2 ) ACODE,4 =06 5 6 TIME UNDEF(2 ) ACODE,4 =07 5-14 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 Name LOADID UNDEF(2 ) Type I None Post-buckling I RS None Description Load set identification number ACODE,4 =08 5 6 7 LOADID EIGR UNDEF Load set identification number Eigenvalue ACODE,4 =09 5 6 7 MODE EIGR EIGI Complex Eigenvalues I RS RS Nonlinear Statics RS None Geometric Nonlinear Statics I None Load set identification number Load step Mode number Eigenvalue - real part Eigenvalue - imaginary part ACODE,4 =10 5 6 LOADSTEP UNDEF(2 ) ACODE,4 =11 5 6 LOADID UNDEF(2 ) End ACODE,4 TCODE,1 =02 5 6 LOADID UNDEF(2 ) SORT2 format I None Load set identification number End TCODE,1 8 9 10 11 DLOADID FCODE(C) NUMWDE(C) OCODE I I I I Dynamic load set or Random code identification number Format code Number of words per entry NX Nastran DMAP Programmer’s Guide 5-15 Chapter 5 Data Block Descriptions O-V Word 12 14 23 24 51 83 115 Name PID (SOL 601 and 701 only) Q4CSTR THERMAL(C) UNDEF(27 ) TITLE(32) SUBTITLE(32) LABEL(32) Type I I I None CHAR4 CHAR4 CHAR4 Description Physical Property ID for SOL 601 & 701 only. UNDEF for all other SOLs Corner Stress Flag =1 for heat transfer and 0 otherwise Title character string (TITLE) Subtitle character string (SUBTITLE) LABEL character string (LABEL) Record 2 - DATA Word Name Type SORT1 Format I SORT2 Format Statics I Load set identification number Element identification number Description TCODE,1 =1 1 EID TCODE,1 =02 ACODE,4 =01 1 LOADID ACODE,4 =02 1 MODE Normal modes or buckling (real eigenvalues) I Mode number ACODE,4 =03 1 LOADID Differential Stiffness 0 I Load set identification number ACODE,4 =04 1 LOADID Differential Stiffness 1 I Frequency RS Transient RS Pre-buckling Time step Frequency Load set identification number ACODE,4 =05 1 FREQ ACODE,4 =06 1 TIME ACODE,4 =07 5-16 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 Name LOADID Type I Post-buckling I Description Load set identification number ACODE,4 =08 1 LOADID Load set identification number ACODE,4 =09 1 MODE Complex Eigenvalues I Mode number ACODE,4 =10 1 LOADSTEP Nonlinear Statics RS Load step ACODE,4 =11 1 LOADID Geometric Nonlinear Statics I Load set identification number End ACODE,4 End TCODE,1 Word Name Type Thermal data 2-D and 3-D elements CHAR4 RS RS RS RS RS RS I Element type x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ zero Description THERMAL =1 NUMWDE =10 2 4 5 6 7 8 9 10 NAME(2) XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX ZED NUMWDE =8 2 4 5 NAME(2) FAPPLIED FREECONV (CHBDY) thermal 107,108,109 CHAR4 RS RS Element name Applied load Free convection NX Nastran DMAP Programmer’s Guide 5-17 Chapter 5 Data Block Descriptions O-V Word 6 7 8 Name FORCECON FRAD FTOTAL Type RS RS RS conv elements RS Description Forced convection Radiation Total NUMWDE =2 2 FTOTAL Total NUMWDE =9 2 4 5 6 7 8 9 NAME(2) XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX 1-D elements; for example, CBEAM, CBEND, CTUBE CHAR4 RS RS RS RS RS RS Element type x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ NUMWDE =58 2 3 4 5 6 7 8 9 PARENT VUGRID XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX VUHEXA 145 Thermal I I RS RS RS RS RS RS Parent C VU Grid identification number x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Words 3 through 9 repeat 8 times NUMWDE =44 2 3 PARENT VUGRID VUPENTA 146 Thermal I I Parent identification number VU Grid identification number 5-18 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 4 5 6 7 8 9 Name XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX Type RS RS RS RS RS RS Description x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Words 3 through 9 repeat 6 times NUMWDE =30 2 3 4 5 6 7 8 9 PARENT VUGRID XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX VUTETRA 147 Thermal I I RS RS RS RS RS RS Parent identification number VU Grid identification number x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Words 3 through 9 repeat 4 times NUMWDE =34 2 3 4 5 6 7 8 9 PARENT COORD ICORD THETA UNDEF VUGRID XGRAD YGRAD VUQUAD 189 Thermal I I CHAR4 I None I RS RS VU Grid identification number x gradient or ’1’ y gradient or ’1’ Parent p-element identification number Coordinate system identification number Flat/curved and so on Material angle NX Nastran DMAP Programmer’s Guide 5-19 Chapter 5 Data Block Descriptions O-V Word 10 11 12 13 Name ZGRAD XFLUX YFLUX ZFLUX Type RS RS RS RS Description z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Words 7 through 13 repeat 4 times NUMWDE =27 2 3 4 5 6 7 8 9 10 11 12 13 PARENT COORD ICORD THETA UNDEF VUGRID XGRAD YGRAD ZGRAD XFLUX YFLUX ZFLUX VUTRIA 190 Thermal I I CHAR4 I None I RS RS RS RS RS RS VU Grid Id x gradient or ’1’ y gradient or ’1’ z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Parent p-element identification number Coordinate system identification number Flat/curved and so on Material angle Words 7 through 13 repeat 3 times NUMWDE =18 2 3 4 5 6 7 PARENT COORD ICORD VUGRID XGRAD YGRAD VUBEAM 191 Thermal I I CHAR4 I RS RS Parent p-element identification number Coordinate system identification number Flat/curved and so on VU Grid Id x gradient or ’1’ y gradient or ’1’ 5-20 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 Name ZGRAD XFLUX YFLUX ZFLUX Type RS RS RS RS Description z gradient or ’1’ x flux or ’1’ y flux or ’1’ z flux or ’1’ Words 5 through 11 repeat 2 times End NUMWDE Word Name Type Description THERMAL =00 ELTYPE =01 TCODE,7 =0 or 2 2 3 TCODE,7 =1 2 3 4 5 AFR AFI TRQR TRQI AF TRQ Non-thermal element output Rod element (CROD) Real or Random Response RS RS Axial Force Torque Real/imaginary or magnitude/phase RS RS RS RS Axial Force - real/mag. part Axial Force - imag./phase part Torque - real/mag. part Torque - imag./phase part End TCODE,7 ELTYPE =02 TCODE,7 =0 or 2 2 3 4 5 6 7 GRID SD BM1 BM2 TS1 TS2 Beam element (CBEAM) Real or Random Response I RS RS RS RS RS Grid point identification number Station Distance divided by element’s length Bending moment plane 1 Bending moment plane 2 Shear Plane 1 Shear Plane 2 NX Nastran DMAP Programmer’s Guide 5-21 Chapter 5 Data Block Descriptions O-V Word 8 9 10 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name AF TTRQ WTRQ Type RS RS RS Description Axial Force Total Torque Warping Torque Real/imaginary or magnitude/phase GRID SD BM1R BM2R TS1R TS2R AFR TTRQR WTRQR BM1I BM2I TS1I TS2I AFI TTRQI WTRQI I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Grid point identification number Station Distance divided by element’s length Bending moment plane 1 - real/mag. part Bending moment plane 2 - real/mag. part Shear plane 1 - real/mag. part Shear plane 2 - real/mag. part Axial force - real/mag. part Total torque - real/mag. part Warping torque - real/mag. part Bending moment plane 1 - imag./phase part Bending moment plane 2 - imag./phase part Shear plane 1 - imag./phase part Shear plane 2 - imag./phase part Axial force - imag./phase part Total torque - imag./phase part Warping torque - imag./phase part End TCODE,7 Words 2 through max repeat 011 times ELTYPE =03 TCODE,7 =0 or 2 2 3 AF TRQ Tube element (CTUBE) Real or Random Response RS RS Axial Force Torque 5-22 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 2 3 4 5 Name Type Description Real/imaginary or magnitude/phase AFR AFI TRQR TEQI RS RS RS RS Axial Force - real/mag. part Axial Force - imag./phase part Torque - real/mag. part Torque - imag./phase part End TCODE,7 ELTYPE =04 TCODE,7 =0 or 2 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 F41R F41 F21 F12 F32 F23 F43 F34 F14 KF1 S12 KF2 S23 KF3 S34 KF4 S41 Shear panel element (CSHEAR) Real or Random Response RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Force 4 to 1 Force 2 to 1 Force 1 to 2 Force 3 to 2 Force 2 to 3 Force 4 to 3 Force 3 to 4 Force 1 to 4 Kick Force on 1 Shear 1 2 Kick Force on 2 Shear 2 3 Kick Force on 3 Shear 3 4 Kick Force on 4 Shear 4 1 Real/imaginary or magnitude/phase RS Force 4 to 1 - real/mag. part NX Nastran DMAP Programmer’s Guide 5-23 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 Name F21R F12R F32R F23R F43R F34R F14R F41I F21I F12I F32I F23I F43I F34I F14I KF1R S12R KF2R S23R KF3R S34R KF4R S41R KF1I S12I KF2I Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Force 2 to 1 - real/mag. part Force 1 to 2 - real/mag. part Force 3 to 2 - real/mag. part Force 2 to 3 - real/mag. part Force 4 to 3 - real/mag. part Force 3 to 4 - real/mag. part Force 1 to 4 - real/mag. part Force 4 to 1 - imag./phase part Force 2 to 1 - imag./phase part Force 1 to 2 - imag./phase part Force 3 to 2 - imag./phase part Force 2 to 3 - imag./phase part Force 4 to 3 - imag./phase part Force 3 to 4 - imag./phase part Force 1 to 4 - imag./phase part Kick Force on 1 - real/mag. part Shear 1 2 - real/mag. part Kick Force on 2 - real/mag. part Shear 2 3 - real/mag. part Kick Force on 3 - real/mag. part Shear 3 4 - real/mag. part Kick Force on 4 - real/mag. part Shear 4 1 - real/mag. part Kick Force on 1 - imag./phase part Shear 1 2 - imag./phase part Kick Force on 2 - imag./phase part 5-24 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 29 30 31 32 33 Name S23I KF3I S34I KF4I S41I Type RS RS RS RS RS Description Shear 2 3 - imag./phase part Kick Force on 3 - imag./phase part Shear 3 4 - imag./phase part Kick Force on 4 - imag./phase part Shear 4 1 - imag./phase part End TCODE,7 ELTYPE =05 2 ELTYPE =06 2 ELTYPE =07 2 ELTYPE =08 2 ELTYPE =09 2 Word ELTYPE =10 TCODE,7 =0 or 2 2 3 TCODE,7 =1 2 3 4 AFR AFI TRQR AF TRQ UNDEF Name UNDEF UNDEF UNDEF UNDEF FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness) None Unused None PLOAD4 (follower stiffness) None PLOADX1 (follower stiffness) None PLOAD and PLOAD2 (follower stiffness) None Type Description Rod element connection and property (CONROD) Real or Random Response RS RS Axial Force Torque Real/imaginary or magnitude/phase RS RS RS Axial Force - real/mag. part Axial Force - imag./phase part Torque - real/mag. part NX Nastran DMAP Programmer’s Guide 5-25 Chapter 5 Data Block Descriptions O-V Word 5 Name TRQI Type RS Description Torque - imag./phase part End TCODE,7 ELTYPE =11 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F Scalar spring element (CELAS1) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force - real/mag. part Force - imag./phase part End TCODE,7 ELTYPE =12 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F Scalar spring element with properties (CELAS2) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force - real/mag. part Force - imag./phase part End TCODE,7 ELTYPE =13 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F Scalar spring element to scalar points only (CELAS3) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force - real/mag. part Force - imag./phase part End TCODE,7 ELTYPE =14 TCODE,7 =0 or 2 2 F Scalar spring element to scalar pts. only with prop. (CELAS4) Real or Random Response RS Force 5-26 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 2 3 Name Type Description Real/imaginary or magnitude/phase FR FI RS RS Force - real/mag. part Force - imag./phase part End TCODE,7 ELTYPE =15 2 ELTYPE =16 2 ELTYPE =17 2 ELTYPE =18 2 ELTYPE =19 2 Word ELTYPE =20 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F UNDEF Name UNDEF UNDEF UNDEF UNDEF AEROT3 None AEROBEAM None Unused (Pre-V69 CTRIA2) None Unused (Pre-V69 CQUAD2) None Unused (Pre-V69 CQUAD1) None Type Description Scalar damper (CDAMP1). (See Note 2. .) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force Force End TCODE,7 ELTYPE =21 TCODE,7 =0 or 2 2 TCODE,7 =1 F Scalar damper with properties (CDAMP2). (See Note 2.) Real or Random Response RS Force Real/imaginary or magnitude/phase NX Nastran DMAP Programmer’s Guide 5-27 Chapter 5 Data Block Descriptions O-V Word 2 3 Name FR FI Type RS RS Description Force Force End TCODE,7 ELTYPE =22 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F Scalar damper to scalar points only (CDAMP3). (See Note 2.) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force Force End TCODE,7 ELTYPE =23 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 FR FI F Scalar damper to scalar points only with prop (CDAMP4). (See Note 2. .) Real or Random Response RS Force Real/imaginary or magnitude/phase RS RS Force Force End TCODE,7 ELTYPE =24 TCODE,7 =1 2 3 4 5 AFR AFI TRQR TRQI Viscous damper (CVISC) Real/imaginary or magnitude/phase RS RS RS RS Axial Force - real/mag. part Axial Force - imag./phase part Torque - real/mag. part Torque - imag./phase part TCODE,7 =0 or 2 2 3 AF TRQ Real or Random Response RS RS Axial Force Torque 5-28 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =25 2 ELTYPE =26 2 ELTYPE =27 2 ELTYPE =28 2 ELTYPE =29 2 Word ELTYPE =30 2 ELTYPE =31 2 ELTYPE =32 2 ELTYPE =33 Name Type Description Scalar mass (CMASS1) UNDEF None Scalar mass with properties (CMASS2) UNDEF None Scalar mass to scalar pts. only (CMASS3) UNDEF None Scalar mass to scalar pts. only with properties (CMASS4) UNDEF None Concentrated mass element - general form (CONM1) UNDEF Name None Type Description Concentrated mass element - rigid body form (CONM2) UNDEF None Dummy plot element (PLOTEL) UNDEF None Unused UNDEF None Quadrilateral plate element (CQUAD4) Real or Random Response RS RS RS RS RS RS RS Membrane in x Membrane in y Membrane in xy Bending in x Bending in y Bending in xy Transverse Shear in x TCODE,7 =0 or 2 2 3 4 5 6 7 8 MX MY MXY BMX BMY BMXY TX NX Nastran DMAP Programmer’s Guide 5-29 Chapter 5 Data Block Descriptions O-V Word 9 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TY Type RS Description Transverse Shear in y Real/imaginary or magnitude/phase MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane in x - real/mag. part Membrane in y - real/mag. part Membrane in xy - real/mag. part Bending in x - real/mag. part Bending in y - real/mag. part Bending in xy - real/mag. part Transverse Shear in x - real/mag. part Transverse Shear in y - real/mag. part Membrane in x - imag./phase part Membrane in y - imag./phase part Membrane in xy - imag./phase part Bending in x - imag./phase part Bending in y - imag./phase part Bending in xy - imag./phase part Transverse Shear in x - imag./phase part Transverse Shear in y - imag./phase part End TCODE,7 ELTYPE =34 TCODE,7 =0 or 2 2 3 4 5 6 BM1A BM2A BM1B BM2B TS1 Simple beam element (CBAR and see also ELTYPE=100) Real or Random Response RS RS RS RS RS Bending moment end A plane 1 Bending moment end A plane 2 Bending moment end B plane 1 Bending moment end B plane 2 Shear plane 1 5-30 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 7 8 9 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TS2 AF TRQ Type RS RS RS Description Shear plane 2 Axial Force Torque Real/imaginary or magnitude/phase BM1AR BM2AR BM1BR BM2BR TS1R TS2R AFR TRQR BM1AI BM2AI BM1BI BM2BI TS1I TS2I AFI TRQI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Bending moment end A plane 1 - real part Bending moment end A plane 2 - real part Bending moment end B plane 1 - real part Bending moment end B plane 2 - real part Shear plane 1 - real part Shear plane 2 - real part Axial force - real part Torque - real part Bending moment end A plane 1 - imaginary part Bending moment end A plane 2 - imaginary part Bending moment end B plane 1 - imaginary part Bending moment end B plane 2 - imaginary part Shear plane 1 - imaginary part Shear plane 2 - imaginary part Axial Force - imaginary part Torque - imaginary part End TCODE,7 ELTYPE =35 2 3 HOPA BMU Axisymmetric shell element (CCONEAX) RS RS Harmonic or point angle Bending Moment u NX Nastran DMAP Programmer’s Guide 5-31 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 ELTYPE =36 2 ELTYPE =37 2 ELTYPE =38 TCODE,7 =0 2 3 4 5 6 7 8 9 TCODE,7 =1 2 3 4 5 6 7 8 Name BMV TM SU SV Type RS RS RS RS Description Bending Moment v Twisting Moment Shear u Shear v Unused (Pre-V69 CTRIARG) UNDEF None Unused (Pre-V69 CTRAPRG) UNDEF None Gap element (CGAP) Real FX SFY SFZ U V W SV SW RS RS RS RS RS RS RS RS Comp. Force in x Shear Force in y Shear Force in z Axial Disp in u Shear Disp in v Shear Disp in w Slip Disp in v Slip Disp in w Real/imaginary or magnitude/phase FX SFY SFZ U V W SV RS RS RS RS RS RS RS Comp. Force in x Shear Force in y Shear Force in z Axial Disp in u Shear Disp in v Shear Disp in w Slip Disp in v 5-32 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 Name SW Type RS Description Slip Disp in w End TCODE,7 ELTYPE =39 2 3 4 5 6 7 8 9 10 11 12 13 14 Word ELTYPE =40 2 3 4 5 6 7 8 ELTYPE =41 FE UE VE AS AE EP FAIL AXR AYR AZR VXR VYR VXR AXI AYI AZI VXI VYI VXI DB Name Acoustics - Tetra (?) RS RS RS RS RS RS RS RS RS RS RS RS RS Type Description Rod type spring and damper (CBUSH1D) RS RS RS RS RS RS I Element Force Axial Displacement Axial Velocity* Axial Stress* Axial Strain* Plastic Strain* Failed Element Flag Unused (Pre-V69 CHEXA1) NX Nastran DMAP Programmer’s Guide 5-33 Chapter 5 Data Block Descriptions O-V Word 2 ELTYPE =42 2 ELTYPE =43 2 ELTYPE =44 2 ELTYPE =45 2 ELTYPE =46 2 ELTYPE =47 2 ELTYPE =48 2 ELTYPE =49 2 Word ELTYPE =50 2 ELTYPE =51 2 ELTYPE =52 2 ELTYPE =53 2 Name UNDEF Type None Description Unused (Pre-V69 CHEXA2) UNDEF None Fluid element with 2 points (CFLUID2) UNDEF None Fluid element with 3 points (CFLUID3) UNDEF None Fluid element with 4 points (CFLUID4) UNDEF None Cflmass UNDEF None Fluid element with 2 points (CAXIF2) UNDEF None Fluid element with 3 points (CAXIF3) UNDEF None Fluid element with 4 points (CAXIF4) UNDEF Name None Type Description Three-point slot element (CSLOT3) UNDEF None Four-point slot element (CSLOT4) UNDEF None Heat transfer plot element for CHBDYG and CHBDYP UNDEF None Axisymmetric triangular element (CTRIAX6) UNDEF None 5-34 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =54 2 ELTYPE =55 Name Type Description Unused (Pre-V69 CTRIM6) UNDEF None Three-point dummy element (CDUM3) Real or Random Response RS User defined TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =56 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Four-point dummy element (CDUM4) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =57 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Five-point dummy element (CDUM5) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =58 TCODE,7 =0 or 2 2 F(9) Six-point dummy element (CDUM6) Real or Random Response RS User defined NX Nastran DMAP Programmer’s Guide 5-35 Chapter 5 Data Block Descriptions O-V Word TCODE,7 =1 2 11 Name Type Description Real/imaginary or magnitude/phase FR(9) FI(9) RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =59 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Seven-point dummy element (CDUM7) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 Word ELTYPE =60 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Name Type Description Two-dimensional crack tip element (CRAC2D or CDUM8) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =61 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 FR(9) FI(9) F(9) Three-dimensional crack tip element (CRAC3D or CDUM9) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 5-36 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =62 2 ELTYPE =63 2 ELTYPE =64 2 3 Name Type Description Unused (Pre-V69 CQDMEM1) UNDEF None Unused (Pre-V69 CQDMEM2) UNDEF None Curved quadrilateral shell element (CQUAD8) TERM GRID CHAR4 I Character string "CEN/" Number of active grids or corner grid identification number TCODE,7 =0 or 2 4 5 6 7 8 9 10 11 TCODE,7 =1 4 5 6 7 8 9 10 11 12 MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MX MY MXY BMX BMY BMXY TX TY Real or Random Response RS RS RS RS RS RS RS RS Membrane force in x Membrane force in y Membrane force in xy Bending moment in x Bending moment in y Bending moment in xy Shear force in x Shear force in y Real/imaginary or magnitude/phase RS RS RS RS RS RS RS RS RS Membrane force in x - real/mag. part Membrane force in y - real/mag. part Membrane force in xy - real/mag. part Bending moment in x - real/mag. part Bending moment in y - real/mag. part Bending moment in xy - real/mag. part Shear force in x - real/mag. part Shear force in y - real/mag. part Membrane force in x - imag./phase part NX Nastran DMAP Programmer’s Guide 5-37 Chapter 5 Data Block Descriptions O-V Word 13 14 15 16 17 18 19 Name MYI MXYI BMXI BMYI BMXYI TXI TYI Type RS RS RS RS RS RS RS Description Membrane force in y - imag./phase part Membrane force in xy - imag./phase part Bending moment in x - imag./phase part Bending moment in y - imag./phase part Bending moment in xy - imag./phase part Shear force in x - imag./phase part Shear force in y - imag./phase part End TCODE,7 Words 3 through max repeat 005 times ELTYPE =65 2 ELTYPE =66 2 ELTYPE =67 2 3 4 5 6 7 8 9 10 11 12 13 AXR AYR AZR VXR VYR VXR AXI AYI AZI VXI VYI VXI UNDEF UNDEF Unused (Pre-V69 CHEX8) None Unused (Pre-V69 CHEX20) None Acoustics in HEXA RS RS RS RS RS RS RS RS RS RS RS RS 5-38 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 14 ELTYPE =68 2 3 4 5 6 7 8 9 10 11 12 13 14 ELTYPE =69 Name DB Type RS Description Acoustics in PENTA AXR AYR AZR VXR VYR VXR AXI AYI AZI VXI VYI VXI DB RS RS RS RS RS RS RS RS RS RS RS RS RS Curved beam or pipe element (CBEND - see note.) Real or Random Response I RS RS RS RS RS RS Grid point identification number Bending moment plane 1 Bending moment plane 1 Shear plane 1 Shear plane 2 Axial force Torque TCODE,7 =0 or 2 2 3 4 5 6 7 8 TCODE,7 =1 2 GRID GRID BM1 BM2 TS1 TS2 AF TRQ Real/imaginary or magnitude/phase I Grid point identification number - real/mag. part NX Nastran DMAP Programmer’s Guide 5-39 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 13 14 Name BM1R BM2R TS1R TS2R AFR TRQR BM1I BM2I TS1I TS2I AFI TRQI Type RS RS RS RS RS RS RS RS RS RS RS RS Description Bending moment plane 1 - real/mag. part Bending moment plane 1 - real/mag. part Shear plane 1 - real/mag. part Shear plane 2 - real/mag. part Axial force - real/mag. part Torque - real/mag. part Bending moment plane 1 - imag./phase part Bending moment plane 1 - imag./phase part Shear plane 1 - imag./phase part Shear plane 2 - imag./phase part Axial force - imag./phase part Torque - imag./phase part End TCODE,7 Words 2 through max repeat 002 times Word ELTYPE =70 2 3 TERM GRID Name Type Description Triangular plate element (CTRIAR) CHAR4 I Character string "CEN/" Number of active grids or corner grid ID TCODE,7 =0 or 2 4 5 6 7 8 9 10 MX MY MXY BMX BMY BMXY TX Real or Random Response RS RS RS RS RS RS RS Membrane force in x Membrane force in y Membrane force in xy Bending moment in x Bending moment in y Bending moment in xy Shear force in x 5-40 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 11 TCODE,7 =1 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name TY Type RS Description Shear force in y Real/imaginary or magnitude/phase MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane force in x - real/mag. part Membrane force in y - real/mag. part Membrane force in xy - real/mag. part Bending moment in x - real/mag. part Bending moment in y - real/mag. part Bending moment in xy - real/mag. part Shear force in x - real/mag. part Shear force in y - real/mag. part Membrane force in x - imag./phase part Membrane force in y - imag./phase part Membrane force in xy - imag./phase part Bending moment in x - imag./phase part Bending moment in y - imag./phase part Bending moment in xy - imag./phase part Shear force in x - imag./phase part Shear force in y - imag./phase part End TCODE,7 Words 3 through max repeat 004 times ELTYPE =71 2 ELTYPE =72 2 ELTYPE =73 2 UNDEF UNDEF UNDEF Unused None AEROQ4 None Unused (Pre-V69 CFTUBE) None NX Nastran DMAP Programmer’s Guide 5-41 Chapter 5 Data Block Descriptions O-V Word ELTYPE =74 Name Type Description Triangular shell element (CTRIA3) Real or Random Response RS RS RS RS RS RS RS RS Membrane in x Membrane in y Membrane in xy Bending in x Bending in y Bending in xy Transverse Shear in x Transverse Shear in y TCODE,7 =0 or 2 2 3 4 5 6 7 8 9 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI MX MY MXY BMX BMY BMXY TX TY Real/imaginary or magnitude/phase RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane in x - real/mag. part Membrane in y - real/mag. part Membrane in xy - real/mag. part Bending in x - real/mag. part Bending in y - real/mag. part Bending in xy - real/mag. part Transverse Shear in x - real/mag. part Transverse Shear in y - real/mag. part Membrane in x - imag./phase part Membrane in y - imag./phase part Membrane in xy - imag./phase part Bending in x - imag./phase part Bending in y - imag./phase part Bending in xy - imag./phase part Transverse Shear in x - imag./phase part 5-42 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 17 Name TYI Type RS Description Transverse Shear in y - imag./phase part End TCODE,7 ELTYPE =75 2 3 TERM GRID Curved triangular shell element (CTRIA6) CHAR4 I Character string "CEN/" Number of active grids or corner grid ID TCODE,7 =0 or 2 4 5 6 7 8 9 10 11 TCODE,7 =1 4 5 6 7 8 9 10 11 12 13 14 MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI MX MY MXY BMX BMY BMXY TX TY Real or Random Response RS RS RS RS RS RS RS RS Membrane force in x Membrane force in y Membrane force in xy Bending moment in x Bending moment in y Bending moment in xy Shear force in x Shear force in y Real/imaginary or magnitude/phase RS RS RS RS RS RS RS RS RS RS RS Membrane force in x - real/mag. part Membrane force in y - real/mag. part Membrane force in xy - real/mag. part Bending moment in x - real/mag. part Bending moment in y - real/mag. part Bending moment in xy - real/mag. part Shear force in x - real/mag. part Shear force in y - real/mag. part Membrane force in x - imag./phase part Membrane force in y - imag./phase part Membrane force in xy - imag./phase part NX Nastran DMAP Programmer’s Guide 5-43 Chapter 5 Data Block Descriptions O-V Word 15 16 17 18 19 Name BMXI BMYI BMXYI TXI TYI Type RS RS RS RS RS Description Bending moment in x - imag./phase part Bending moment in y - imag./phase part Bending moment in xy - imag./phase part Shear force in x - imag./phase part Shear force in y - imag./phase part End TCODE,7 Words 3 through max repeat 004 times ELTYPE =76 2 ELNAME(2) Acoustic velocity/pressures in six-sided solid element (CHEXA) CHAR4 Element name: "HEXPR" TCODE,7 = 1 4 5 6 7 8 9 10 11 12 13 14 15 16 AXR AYR AZR VXR VYR VZR PRESSURE AXI AYI AZI VXI VYI VXI Real/imaginary or magnitude/phase RS RS RS RS RS RS RS RS RS RS RS RS RS Acceleration in x - real/mag. part Acceleration in x - real/mag. part Acceleration in x - real/mag. part Velocity in x - real/mag. part Velocity in y - real/mag. part Velocity in y - real/mag. part Pressure in DB Acceleration in x - imag./phase part Acceleration in x - imag./phase part Acceleration in x - imag./phase part Velocity in x - imag./phase part Velocity in y - imag./phase part Velocity in y - imag./phase part TCODE,7 =0 or 2 4 5 AX AY Real or Random Response RS RS Acceleration in x - real/mag. part Acceleration in x - real/mag. part 5-44 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 10 ELTYPE =77 2 Name AZ VX VY VZ PRESSURE Type RS RS RS RS RS Description Acceleration in x - real/mag. part Velocity in x - real/mag. part Velocity in y - real/mag. part Velocity in y - real/mag. part Pressure in DB Acoustic velocity/pressures in five-sided solid element (CPENTA) ELNAME(2) CHAR4 Element name: "PENPR" TCODE,7 =0 or 2 4 5 6 7 8 9 10 TCODE,7 =1 4 5 6 7 8 9 10 11 12 13 AXR AYR AZR VXR VYR VZR PRESSURE AXI AYI AZI AX AY AZ VX VY VZ PRESSURE Real or Random Response RS RS RS RS RS RS RS Complex RS RS RS RS RS RS RS RS RS RS Acceleration in x - real/mag. part Acceleration in x - real/mag. part Acceleration in x - real/mag. part Velocity in x - real/mag. part Velocity in y - real/mag. part Velocity in y - real/mag. part Pressure in DB Acceleration in x - imag./phase part Acceleration in x - imag./phase part Acceleration in x - imag./phase part Acceleration in x Acceleration in x Acceleration in x Velocity in x Velocity in y Velocity in y Pressure in DB NX Nastran DMAP Programmer’s Guide 5-45 Chapter 5 Data Block Descriptions O-V Word 14 15 16 Name VXI VYI VXI Type RS RS RS Description Velocity in x - imag./phase part Velocity in y - imag./phase part Velocity in y - imag./phase part End TCODE,7 ELTYPE =78 2 ELNAME(2) Acoustic velocity/pressures in four-sided solid element (CTETRA) CHAR4 Element name: "TETPR" TCODE,7 =0 or 2 4 5 6 7 8 9 10 TCODE,7 =1 4 5 6 7 8 9 10 11 12 13 14 AXR AYR AZR VXR VYR VZR PRESSURE AXI AYI AZI VXI AX AY AZ VX VY VZ PRESSURE Real or Random Response RS RS RS RS RS RS RS Acceleration in x Acceleration in x Acceleration in x Velocity in x Velocity in y Velocity in y Pressure in DB RS RS RS RS RS RS RS RS RS RS RS Acceleration in x - real/mag. part Acceleration in x - real/mag. part Acceleration in x - real/mag. part Velocity in x - real/mag. part Velocity in y - real/mag. part Velocity in y - real/mag. part Pressure in DB Acceleration in x - imag./phase part Acceleration in x - imag./phase part Acceleration in x - imag./phase part Velocity in x - imag./phase part 5-46 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 15 16 Name VYI VXI Type RS RS Description Velocity in y - imag./phase part Velocity in y - imag./phase part End TCODE,7 ELTYPE =79 2 Word ELTYPE =80 2 ELTYPE =81 2 ELTYPE =82 2 3 TERM GRID UNDEF UNDEF UNDEF Name Unused None Type Unused None Unused None Quadrilateral plate element (CQUADR) CHAR4 I Character string "CEN/" Number of active grids (4) or corner grid identification number Description TCODE,7 =0 or 2 4 5 6 7 8 9 10 11 TCODE,7 =1 4 5 MXR MYR MX MY MXY BMX BMY BMXY TX TY Real or Random Response RS RS RS RS RS RS RS RS Membrane force in x Membrane force in y Membrane force in xy Bending moment in x Bending moment in y Bending moment in xy Shear force in x Shear force in y Real/imaginary or magnitude/phase RS RS Membrane force in x - real/mag. part Membrane force in y - real/mag. part NX Nastran DMAP Programmer’s Guide 5-47 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Membrane force in xy - real/mag. part Bending moment in x - real/mag. part Bending moment in y - real/mag. part Bending moment in xy - real/mag. part Shear force in x - real/mag. part Shear force in y - real/mag. part Membrane force in x - imag./phase part Membrane force in y - imag./phase part Membrane force in xy - imag./phase part Bending moment in x - imag./phase part Bending moment in y - imag./phase part Bending moment in xy - imag./phase part Shear force in x - imag./phase part Shear force in y - imag./phase part End TCODE,7 Words 3 through max repeat 005 times ELTYPE =83 2 ELTYPE =84 2 ELTYPE =85 2 ELTYPE =86 2 ELTYPE =87 2 UNDEF UNDEF UNDEF UNDEF UNDEF Acoustic absorber element (CHACAB) None Acoustic barrier element (CHACBR) None Nonlinear TETRA None Nonlinear GAP None Nonlinear TUBE None 5-48 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =88 2 ELTYPE =89 2 Word ELTYPE =90 2 ELTYPE =91 2 ELTYPE =92 2 ELTYPE =93 2 3 4 5 6 7 8 9 10 11 12 13 14 ELTYPE =94 Name Type Description Nonlinear TRIA3 UNDEF None Nonlinear ROD UNDEF Name None Type Description Nonlinear QUAD4 UNDEF None Nonlinear PENTA UNDEF None Nonlinear CONROD UNDEF None Acoustics in HEXA AXR AYR AZR VXR VYR VXR AXI AYI AZI VXI VYI VXI DB RS RS RS RS RS RS RS RS RS RS RS RS RS Nonlinear BEAM NX Nastran DMAP Programmer’s Guide 5-49 Chapter 5 Data Block Descriptions O-V Word 2 ELTYPE =95 2 4 5 6 7 8 9 ELTYPE =96 2 4 5 6 7 8 9 ELTYPE =97 2 4 5 6 7 8 9 Name UNDEF Type None Description Composite quadrilateral plate element (CQUAD4) THEORY(2) LAMID FP FM FB FMAX FFLAG CHAR4 I RS CHAR4 RS RS CHAR4 Theory Lamina number Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag Composite curved quadrilateral shell element (CQUAD8) THEORY(2) LAMID FP FM FB FMAX FFLAG CHAR4 I RS CHAR4 RS RS CHAR4 Theory Lamina number Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag Composite triangular shell element (CTRIA3) THEORY(2) LAMID FP FM FB FMAX FFLAG CHAR4 I RS CHAR4 RS RS CHAR4 Theory Lamina number Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag 5-50 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =98 2 4 5 6 7 8 9 ELTYPE =99 2 Word Name Type Description Composite curved triangular shell element (CTRIA6) THEORY(2) LAMID FP FM FB FMAX FFLAG CHAR4 I RS CHAR4 RS RS CHAR4 Unused UNDEF Name None Type Description Theory Lamina number Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag ELTYPE =100 TCODE,7 =0 or 2 2 3 4 5 6 7 8 TCODE,7 =1 2 3 4 5 SD BM1R BM2R TP1R SD BM1 BM2 TS1 TS2 AF TRQ Simple beam element w/stations (CBAR with CBARAO or PLOAD1) Real or Random Response RS RS RS RS RS RS RS Station distance divided by length Bending moment plane 1 Bending moment plane 2 Shear plane 1 Shear plane 2 Axial force Torque Real/imaginary or magnitude/phase RS RS RS RS Station distance divided by length Bending moment plane 1 - real/mag. part Bending moment plane 2 - real/mag. part Shear plane 1 - real/mag. part NX Nastran DMAP Programmer’s Guide 5-51 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 10 11 12 13 14 Name TP2R AFR TRQR BM1I BM2I TS1I TS2I AFI TRQI Type RS RS RS RS RS RS RS RS RS Description Shear plane 2 - real/mag. part Axial force - real/mag. part Torque - real/mag. part Bending moment plane 1 - imag./phase part Bending moment plane 2 - imag./phase part Shear plane 1 - imag./phase part Shear plane 2 - imag./phase part Axial force - imag./phase part Torque - imag./phase part End TCODE,7 ELTYPE =101 2 3 4 IMPEDR IMPEDI ABSORB Acoustic absorber element with freq. dependence (CAABSF) RS RS RS Impedance - real/mag. part Impedance - imag./phase part Absorption coefficient ELTYPE =102 TCODE,7 =0 or 2 2 3 4 5 6 7 TCODE,7 =1 2 3 4 FXR FYR FZR FX FY FZ MX MY MZ Generalized spring and damper element (CBUSH) Real or Random Response RS RS RS RS RS RS Force x Force y Force z Moment x Moment y Moment z Real/imaginary or magnitude/phase RS RS RS Force x - real/mag. part Force y - real/mag. part Force z - real/mag. part 5-52 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 Name MXR MYR MZR FXI FYI FZI MXI MYI MZI Type RS RS RS RS RS RS RS RS RS Description Moment x - real/mag. part Moment y - real/mag. part Moment z - real/mag. part Force x - imag./phase part Force y - imag./phase part Force z - imag./phase part Moment x - imag./phase part Moment y - imag./phase part Moment z - imag./phase part End TCODE,7 ELTYPE =103 2 UNDEF Quadrilateral shell element (QUADP) None Triangular shell p-element (TRIAP) None Beam p-element (BEAMP) None Scalar damper with material property (CDAMP5) None Heat transfer boundary condition element - (CHBDYE) CHAR4 RS RS RS RS RS Element name Applied load Free convection Forced convection Radiation Total ELTYPE =104 2 UNDEF ELTYPE =105 2 UNDEF ELTYPE =106 2 UNDEF ELTYPE =107 2 4 5 6 7 8 NAME(2) FAPPLIED FREECONV FORCECON FRAD FTOTAL ELTYPE =108 Heat transfer boundary condition element (CHBDYG) NX Nastran DMAP Programmer’s Guide 5-53 Chapter 5 Data Block Descriptions O-V Word 2 4 5 6 7 8 Name NAME(2) FAPPLIED FREECONV FORCECON FRAD FTOTAL Type CHAR4 RS RS RS RS RS Description Element name Applied load Free convection Forced convection Radiation Total ELTYPE =109 2 4 5 6 7 8 Word NAME(2) FAPPLIED FREECONV FORCECON FRAD FTOTAL Name Heat transfer boundary condition element (CHBDYP) CHAR4 RS RS RS RS RS Type CONV None CONVM None QBDY3 None QVECT None QVOL None Radbc None Element name Applied load Free convection Forced convection Radiation Total Description ELTYPE =110 2 UNDEF ELTYPE =111 2 UNDEF ELTYPE =112 2 UNDEF ELTYPE =113 2 UNDEF ELTYPE =114 2 UNDEF ELTYPE =115 2 UNDEF 5-54 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description ELTYPE =116 2 Word UNDEF Name Slideline contact (SLIF1D)? None Type CQUAD None CQUADX None RELUC - EMAS? None Type RES - EMAS? None TETRAE - EMAS? None CTRIA None CTRIAX None LINEOB - EMAS? None LINXOB - EMAS? None QUADOB - EMAS? None TRIAOB - EMAS? Description Description ELTYPE =127 2 UNDEF ELTYPE =128 2 UNDEF ELTYPE =129 2 Word UNDEF Name ELTYPE =130 2 UNDEF ELTYPE =131 2 UNDEF ELTYPE =132 2 UNDEF ELTYPE =133 2 UNDEF ELTYPE =134 2 UNDEF ELTYPE =135 2 UNDEF ELTYPE =136 2 UNDEF ELTYPE =137 NX Nastran DMAP Programmer’s Guide 5-55 Chapter 5 Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =138 2 UNDEF LINEX - EMAS? None Hyperelastic QUAD4FD None Type HEXA8FD None Six-sided solid p-element (HEXAP) None Five-sided solid p-element (PENTAP) None Four-sided solid p-element (TETRAP) None Quadrilateral plate element for corner stresses (QUAD144) CHAR4 I Character string "CEN/" Number of active grids (4) or corner grid ID Description ELTYPE =139 2 Word UNDEF Name ELTYPE =140 2 UNDEF ELTYPE =141 2 UNDEF ELTYPE =142 2 UNDEF ELTYPE =143 2 UNDEF ELTYPE =144 2 3 TERM GRID TCODE,7 =0 or 2 4 5 6 7 8 9 10 11 MX MY MXY BMX BMY BMXY TX TY Real or Random Response RS RS RS RS RS RS RS RS Membrane x Membrane y Membrane xy Bending x Bending y Bending xy Shear x Shear y 5-56 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name Type Description Real/imaginary or magnitude/phase MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane x - real/mag. part Membrane y - real/mag. part Membrane xy - real/mag. part Bending x - real/mag. part Bending y - real/mag. part Bending xy - real/mag. part Shear x - real/mag. part Shear y - real/mag. part Membrane x - imag./phase part Membrane y - imag./phase part Membrane xy - imag./phase part Bending x - imag./phase part Bending y - imag./phase part Bending xy - imag./phase part Shear x - imag./phase part Shear y - imag./phase part End TCODE,7 Words 3 through max repeat 005 times ELTYPE =145 2 UNDEF Six-sided solid display element (VUHEXA) None Five-sided solid display element (VUPENTA) None Four-sided solid display element (VUTETRA) None HEXAM - EMAS? ELTYPE =146 2 UNDEF ELTYPE =147 2 UNDEF ELTYPE =148 NX Nastran DMAP Programmer’s Guide 5-57 Chapter 5 Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =149 2 Word UNDEF Name PENTAM - EMAS? None Type Description ELTYPE =150 2 UNDEF TETRAM - EMAS? None QUADM - EMAS? None TRIAM - EMAS? None QUADXM - EMAS? None TRIAXM - EMAS? None QUADPW - EMAS? None TRIAPW - EMAS? None LINEPW - EMAS? None QUADOBM - EMAS? None TRIAOBM - EMAS? None Type Description ELTYPE =151 2 UNDEF ELTYPE =152 2 UNDEF ELTYPE =153 2 UNDEF ELTYPE =154 2 UNDEF ELTYPE =155 2 UNDEF ELTYPE =156 2 UNDEF ELTYPE =157 2 UNDEF ELTYPE =158 2 UNDEF ELTYPE =159 2 Word UNDEF Name ELTYPE =160 Five-sided finite deformation solid element (PENTA6FD) 5-58 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =161 2 UNDEF Five-sided finite deformation solid element (TETRA4FD) None Triangular finite deformation shell element (TRIA3FD) None HEXAFD None QUADFD None PENTAFD None TETRAFD None TRIAFD None TRIAX3FD None TRIAXFD None Type QUADX4FD None QUADXFD None LINEOBM - EMAS None Description ELTYPE =162 2 UNDEF ELTYPE =163 2 UNDEF ELTYPE =164 2 UNDEF ELTYPE =165 2 UNDEF ELTYPE =166 2 UNDEF ELTYPE =167 2 UNDEF ELTYPE =168 2 UNDEF ELTYPE =169 2 Word UNDEF Name ELTYPE =170 2 UNDEF ELTYPE =171 2 UNDEF ELTYPE =174 2 UNDEF NX Nastran DMAP Programmer’s Guide 5-59 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =175 2 UNDEF LINXOBM - EMAS None QUADWGM - EMAS None TRIAWGM - EMAS None QUADIB - EMAS None TRIAIB - EMAS None Type Description ELTYPE =176 2 UNDEF ELTYPE =177 2 UNDEF ELTYPE =178 2 UNDEF ELTYPE =179 2 Word UNDEF Name ELTYPE =180 2 UNDEF LINEIB - EMAS None LINXIB - EMAS None QUADIBM - EMAS None TRIAIBM - EMAS None LINEIBM - EMAS None LINXIBM - EMAS None QUADPWM - EMAS None TRIAPWM - EMAS ELTYPE =181 2 UNDEF ELTYPE =182 2 UNDEF ELTYPE =183 2 UNDEF ELTYPE =184 2 UNDEF ELTYPE =185 2 UNDEF ELTYPE =186 2 UNDEF ELTYPE =187 5-60 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =188 2 UNDEF LINEPWM - EMAS None Quadrilateral plate view element (VUQUAD) I I CHAR4 I None Real Parent p-element identification number Coordinate system identification number Flat/curved and so on Material angle ELTYPE =189 2 3 4 5 6 TCODE,7 =0 7 8 9 10 11 14 15 16 17 18 19 VUID MFX MFY MFXY UNDEF(3 ) BMX BMY BMXY SYZ SZX UNDEF PARENT COORD ICORD THETA UNDEF I RS RS RS None RS RS RS RS RS None VU-grid identification number ID for corner Membrane force x Membrane force y Membrane force xy Bending moment x Bending moment y Bending moment xy Shear yz Shear zx Words 7 through 19 repeat 004 times TCODE,7 =1 7 8 9 VUID MFXR MFYR Real/imaginary or magnitude/phase I RS RS VU-grid identification number for corner Membrane force x real/mag. Membrane force y real/mag. NX Nastran DMAP Programmer’s Guide 5-61 Chapter 5 Data Block Descriptions O-V Word 10 11 14 15 16 17 18 19 20 21 22 23 26 27 28 29 30 31 Name MFXYR UNDEF(3 ) BMXR BMYR BMXYR SYZR SZXR UNDEF MFXI MFYI MFXYI UNDEF(3 ) BMXI BMYI BMXYI SYZI SZXI UNDEF Type RS None RS RS RS RS RS None RS RS RS None RS RS RS RS RS None Description Membrane force xy real/mag. Bending moment x real/mag. Bending moment y real/mag. Bending moment xy real/mag. Shear yz real/mag. Shear zx real/mag. Membrane force x imag./phase Membrane force y imag./phase Membrane force xy imag./phase Bending moment x imag./phase Bending moment y imag./phase Bending moment xy imag./phase Shear yz imag./phase Shear zx imag./phase Words 7 through 31 repeat 004 times End TCODE,7 Word Name Type Description ELTYPE =190 2 3 4 5 PARENT COORD ICORD THETA Triangular shell view element (VUTRIA) I I CHAR4 I Parent p-element identification number Coordinate system identification number Flat/curved and so on Material angle 5-62 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 TCODE,7 =0 7 8 9 10 11 14 15 16 17 18 19 Name UNDEF Type None Real Description VUID MFX MFY MFXY UNDEF(3 ) BMX BMY BMXY SYZ SZX UNDEF I RS RS RS None RS RS RS RS RS None VU grid ID for this corner Membrane force x Membrane force y Membrane force xy Bending moment x Bending moment y Bending moment xy Shear yz Shear zx Words 7 through 19 repeat 003 times TCODE,7 =1 7 8 9 10 11 14 15 16 17 18 19 VUID MFXR MFYR MFXYR UNDEF(3 ) BMXR BMYR BMXYR SYZR SZXR UNDEF Real/imaginary or magnitude/phase I RS RS RS None RS RS RS RS RS None Bending moment x real/mag. Bending moment y real/mag. Bending moment xy real/mag. Shear yz real/mag. Shear zx real/mag. VU grid ID this corner Membrane force x real/mag. Membrane force y real/mag. Membrane force xy real/mag. NX Nastran DMAP Programmer’s Guide 5-63 Chapter 5 Data Block Descriptions O-V Word 20 21 22 23 26 27 28 29 30 31 Name MFXI MFYI MFXYI UNDEF(3 ) BMXI BMYI BMXYI SYZI SZXI UNDEF Type RS RS RS None RS RS RS RS RS None Description Membrane force x imag./phase Membrane force y imag./phase Membrane force xy imag./phase Bending moment x imag./phase Bending moment y imag./phase Bending moment xy imag./phase Shear yz imag./phase Shear zx imag./phase Words 7 through 31 repeat 003 times End TCODE,7 ELTYPE =191 2 3 4 TCODE,7 =0 5 6 7 8 9 10 11 12 TCODE,7 =1 VUGRID POSIT FORCEX SHEARY SHEARZ TORSION BENDY BENDZ PARENT COORD ICORD Beam view element (VUBEAM) I I CHAR4 Real I RS RS RS RS RS RS RS VU grid ID for output grid x/L position of VU grid identification number Force x Shear force y Shear force z Torsional moment x Bending moment y Bending moment z Parent p-element identification number Coordinate system identification number Flat/curved and so on Real/imaginary or magnitude/phase 5-64 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 14 15 16 17 18 Name VUGRID POSIT FORCEXR SHEARYR SHEARZR TORSINR BENDYR BENDZR FORCEXI SHEARYI SHEARZI TORSINI BENDYI BENDZI Type I RS RS RS RS RS RS RS RS RS RS RS RS RS Description VU grid identification number for output grid x/L position of VU grid identification number Force x real/mag. Shear force y real/mag. Shear force z real/mag. Torsional moment x real/mag. Bending moment y real/mag. Bending moment z real/mag. Force x imag./phase Shear force y imag./phase Shear force z imag./phase Torsional moment x imag./phase Bending moment y imag./phase Bending moment z imag./phase End TCODE,7 Words 5 through max repeat 2 times ELTYPE =192 2 UNDEF CVINT None QUADFR - EMAS None TRIAFR - EMAS None LINEFR - EMAS None LINXFR - EMAS None ELTYPE =193 2 UNDEF ELTYPE =194 2 UNDEF ELTYPE =195 2 UNDEF ELTYPE =196 2 UNDEF NX Nastran DMAP Programmer’s Guide 5-65 Chapter 5 Data Block Descriptions O-V Word Name Type GMINTS None CNVPEL None VUHBDY None Type CWELD Description ELTYPE =197 2 UNDEF ELTYPE =198 2 UNDEF ELTYPE =199 2 Word UNDEF Name Description ELTYPE =200 TCODE,7 =0 or 2 2 3 4 5 6 7 8 9 TCODE,7 =1 2 3 4 5 6 7 8 9 BM1AR BM2AR BM1BR BM2BR TS1R TS2R AFR TRQR BM1A BM2A BM1B BM2B TS1 TS2 AF TRQ Real or Random Response RS RS RS RS RS RS RS RS Bending moment end A plane 1 Bending moment end A plane 2 Bending moment end B plane 1 Bending moment end B plane 2 Shear plane 1 Shear plane 2 Axial Force Torque Real / Imaginary RS RS RS RS RS RS RS RS Bending moment end A plane 1 - real part Bending moment end A plane 2 - real part Bending moment end B plane 1 - real part Bending moment end B plane 2 - real part Shear plane 1 - real part Shear plane 2 - real part Axial force - real part Torque - real part 5-66 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 12 13 14 15 16 17 Name BM1AI BM2AI BM1BI BM2BI TS1I TS2I AFI TRQI Type RS RS RS RS RS RS RS RS Description Bending moment end A plane 1 - imaginary part Bending moment end A plane 2 - imaginary part Bending moment end B plane 1 - imaginary part Bending moment end B plane 2 - imaginary part Shear plane 1 - imaginary part Shear plane 2 - imaginary part Axial Force - imaginary part Torque - imaginary part End TCODE,7 ELTYPE =201 TCODE,7 =0 or 2 2 3 4 5 6 7 8 9 TCODE,7 =1 2 3 4 5 BM1AR BM2AR BM1BR BM2BR BM1A BM2A BM1B BM2B TS1 TS2 AF TRQ CWELDC (and Nonlinear hyperelastic QUAD4FD ???) Real or Random Response RS RS RS RS RS RS RS RS Bending moment end A plane 1 Bending moment end A plane 2 Bending moment end B plane 1 Bending moment end B plane 2 Shear plane 1 Shear plane 2 Axial Force Torque Real / Imaginary RS RS RS RS Bending moment end A plane 1 - real part Bending moment end A plane 2 - real part Bending moment end B plane 1 - real part Bending moment end B plane 2 - real part NX Nastran DMAP Programmer’s Guide 5-67 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 10 11 12 13 14 15 16 17 Name TS1R TS2R AFR TRQR BM1AI BM2AI BM1BI BM2BI TS1I TS2I AFI TRQI Type RS RS RS RS RS RS RS RS RS RS RS RS Description Shear plane 1 - real part Shear plane 2 - real part Axial force - real part Torque - real part Bending moment end A plane 1 - imaginary part Bending moment end A plane 2 - imaginary part Bending moment end B plane 1 - imaginary part Bending moment end B plane 2 - imaginary part Shear plane 1 - imaginary part Shear plane 2 - imaginary part Axial Force - imaginary part Torque - imaginary part End TCODE,7 ELTYPE =202 2 UNDEF Nonlinear hyperelastic HEXA4FD None Slideline contact (SLIF1D)? See also ELTYPE=116 None ELTYPE =203 2 UNDEF ELTYPE =204 2 UNDEF None ELTYPE =205 2 UNDEF None Hyperelastic triangular 3-noded nonlinear format (TRIA3FD) Gaus None ELTYPE =206 2 UNDEF 5-68 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description ELTYPE =207 2 UNDEF Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD) Gaus None ELTYPE =208 2 UNDEF None ELTYPE =209 2 Word UNDEF Name None Type Description ELTYPE =210 2 UNDEF None ELTYPE =211 2 UNDEF None ELTYPE =212 2 UNDEF None ELTYPE =213 2 UNDEF None ELTYPE =214 2 UNDEF None ELTYPE =215 2 UNDEF None ELTYPE =216 2 UNDEF None Hyperelastic triangular 3-noded nonlinear format (TRIA3FD) Grid None Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD) Grid ELTYPE =217 2 UNDEF ELTYPE =218 NX Nastran DMAP Programmer’s Guide 5-69 Chapter 5 Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =219 2 Word UNDEF Name None Type Description ELTYPE =220 2 UNDEF None ELTYPE =221 2 UNDEF None ELTYPE =222 2 UNDEF None ELTYPE =223 2 UNDEF None Nonlinear ELAS1 None Nonlinear ELAS3 None Nonlinear BUSH None Triangular shell element (CTRIAR) Real or Random Response RS RS RS RS RS RS Membrane in x Membrane in y Membrane in xy Bending in x Bending in y Bending in xy ELTYPE =224 2 UNDEF ELTYPE =225 2 UNDEF ELTYPE =226 2 UNDEF ELTYPE =227 TCODE,7 =0 or 2 2 3 4 5 6 7 MX MY MXY BMX BMY BMXY 5-70 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TX TY Type RS RS Description Transverse Shear in x Transverse Shear in y Real/imaginary or magnitude/phase MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane in x - real/mag. part Membrane in y - real/mag. part Membrane in xy - real/mag. part Bending in x - real/mag. part Bending in y - real/mag. part Bending in xy - real/mag. part Transverse Shear in x - real/mag. part Transverse Shear in y - real/mag. part Membrane in x - imag./phase part Membrane in y - imag./phase part Membrane in xy - imag./phase part Bending in x - imag./phase part Bending in y - imag./phase part Bending in xy - imag./phase part Transverse Shear in x - imag./phase part Transverse Shear in y - imag./phase part End TCODE,7 ELTYPE =228 TCODE,7 =0 or 2 2 3 4 5 MX MY MXY BMX Quadrilateral plate element (CQUADR) Real or Random Response RS RS RS RS Membrane in x Membrane in y Membrane in xy Bending in x NX Nastran DMAP Programmer’s Guide 5-71 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name BMY BMXY TX TY Type RS RS RS RS Description Bending in y Bending in xy Transverse Shear in x Transverse Shear in y Real/imaginary or magnitude/phase MXR MYR MXYR BMXR BMYR BMXYR TXR TYR MXI MYI MXYI BMXI BMYI BMXYI TXI TYI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Membrane in x - real/mag. part Membrane in y - real/mag. part Membrane in xy - real/mag. part Bending in x - real/mag. part Bending in y - real/mag. part Bending in xy - real/mag. part Transverse Shear in x - real/mag. part Transverse Shear in y - real/mag. part Membrane in x - imag./phase part Membrane in y - imag./phase part Membrane in xy - imag./phase part Bending in x - imag./phase part Bending in y - imag./phase part Bending in xy - imag./phase part Transverse Shear in x - imag./phase part Transverse Shear in y - imag./phase part End TCODE,7 Word Name Type Description ELTYPE =232 2 4 THEORY(2) LAMID Composite quadrilateral plate element (CQUADR) CHAR4 I Theory Lamina number 5-72 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 Name FP FM FB FMAX FFLAG Type RS CHAR4 RS RS CHAR4 Description Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag ELTYPE =233 2 4 5 6 7 8 9 THEORY(2) LAMID FP FM FB FMAX FFLAG Composite triangular shell element (CTRIAR) CHAR4 I RS CHAR4 RS RS CHAR4 Theory Lamina number Failure index for direct stresses Failure mode for maximum strain theory Failure index for interlaminar shear stress or -1 Maximum of FP and FB or -1. Failure flag End ELTYPE End THERMAL Record 3 - TRAILER Word 1 Name UNDEF(6 ) Type None Description Notes: 1. The RECORD=IDENT and DATA pair is repeated for each subcase. 2. For CDAMPi and CVISC elements, force output is available only 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, if EID=-1, the OFP module prints a blank line. NX Nastran DMAP Programmer’s Guide 5-73 Chapter 5 Data Block Descriptions O-V 5.7 OES For all analysis types (real and complex) and SORT1 and SORT2 formats. Table of element stresses or strains Record 0 - HEADER Word 1 3 Name NAME(2) WORD Type CHAR4 I Description Data block Name No Def or Month, Year, One, One Word 3 repeats until End of Record Record 1 - IDENT Word 1 2 3 4 TCODE,1 =1 ACODE,4 =01 5 6 ACODE,4 =02 5 6 7 ACODE,4 =03 5 6 ACODE,4 =04 5 LSDVMN LSDVMN UNDEF(2 ) MODE EIGN MODECYCL LSDVMN UNDEF(2 ) Name ACODE(C) TCODE(C) ELTYPE(C) SUBCASE Type I I I I Sort 1 Statics I None Real Eigenvalues I RS F1 Mode Number Eigenvalue Mode or Cycle Load set number Description Device code + 10*Approach Code Table Code Element Type Subcase or Random identification number Differential Stiffness I None Differential Stiffness I Load set number Load set number 5-74 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 ACODE,4 =05 5 6 ACODE,4 =06 5 6 ACODE,4 =07 5 6 ACODE,4 =08 5 6 7 ACODE,4 =09 5 6 7 ACODE,4 =10 5 6 ACODE,4 =11 5 6 ACODE,4 =12 5 Name UNDEF(2 ) Type None Frequency Description FREQ UNDEF(2 ) RS None Transient Frequency TIME UNDEF(2 ) RS None Time Step Buckling Phase 0 (Pre-buckling) LSDVMN UNDEF(2 ) I None Buckling Phase 1 (Post-buckling) LSDVMN EIGR UNDEF I RS None Complex Eigenvalues MODE EIGR EIGI I RS RS Mode Eigenvalue (real) Eigenvalue (imaginary) Mode Number Eigenvalue Load set Nonlinear statics LFTSFQ UNDEF(2 ) RS None Old geometric nonlinear statics LSDVMN UNDEF(2 ) I None CONTRAN ? (Can appear as ACODE=6) TIME RS Time step? Load set Load step NX Nastran DMAP Programmer’s Guide 5-75 Chapter 5 Data Block Descriptions O-V Word 6 Name UNDEF(2 ) Type None Description End ACODE,4 TCODE,1 =02 5 6 LSDVMN UNDEF(2 ) Sort 2 I None Load set, mode number, time step, and so on End TCODE,1 8 9 10 11 12 13 LOADSET FCODE NUMWDE(C) SCODE(C) PID (SOL 601 and 701 only) ELRESCS I I I I I I Load set number, Random code ID or Zero Format Code Number of words per entry in DATA record Stress/Strain code Physical Property ID for SOL 601 & 701 only. UNDEF for all other SOLs Coordinate system in which stresses are written. Applicable to SOL 601/701, solid elements only. 0 = in element coordinate system (default) 1 = stresses are written according to CORDM 14 51 83 115 Q4CSTR TITLE(32) SUBTITL(32) LABEL(32) I CHAR4 CHAR4 CHAR4 Corner Stress Flag Title Subtitle Label Record 2 - DATA Word Name Type Description SORTCODE=1 TCODE,1 =1 1 EKEY Sort 1 - SortCode=((TCODE/1000)+2)/2 o I Device code + 10*Point identification number 5-76 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Sort 2 Analysis type n I Description TCODE,1 =02 ACODE/10=01 ACODE,4 =01 1 EKEY Device code + 10* Point identification number ACODE,4 =02 1 EKEY I Device code + 10* Point identification number ACODE,4 =03 1 EKEY I Device code + 10* Point identification number ACODE,4 =04 1 EKEY I Device code + 10* Point identification number ACODE,4 =05 1 FREQ RS Frequency ACODE,4 =06 1 TIME RS Time step ACODE,4 =07 1 EKEY I Device code + 10* Point identification number ACODE,4 =08 1 EKEY I Device code + 10* Point identification number ACODE,4 =09 1 EKEY I Device code + 10* Point identification number ACODE,4 =10 1 FQTS RS Frequency or Time step ACODE,4 =11 1 EKEY I Device code + 10* Point identification number ACODE,4 =12 1 EKEY I Device code + 10* Point identification number NX Nastran DMAP Programmer’s Guide 5-77 Chapter 5 Data Block Descriptions O-V Word Name Type Description End ACODE,4 End ACODE/10 Word ELTYPE =00 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 ELTYPE =01 SCODE,6 =0 TCODE,7 =0 2 3 4 AE MSA TE MATID NX1 NY1 TXY1 SA1 MJRP1 MNRP1 TMAX1 PCODE NX2 NY2 TXY2 SA2 MJRP2 MNRP2 TMAX2 Name Type Description Grid - OES1G table I RS RS RS RS RS RS RS I RS RS RS RS RS RS RS Material identification number Normal in x at d1 Normal in y at d1 Shear in xy at d1 Theta ( Shear Angle ) at d1 Major Principal at d1 Minor Principal at d1 Maximum Shear at d1 10*interpolation points + projection code Normal in x at d2 Normal in y at d2 Shear in xy at d2 Theta ( Shear Angle ) at d2 Major Principal at d2 Minor Principal at d2 Maximum Shear at d2 Rod element (CROD) Strain Real RS RS RS Axial Strain Axial Safety Margin* Torsional Strain 5-78 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 Name MST Type RS Description Torsional Safety Margin* Real / Imaginary AER AEI TER TEI RS RS RS RS Axial Strain Axial Strain Torsional Strain Torsional Strain Random Response AE TE RS RS Axial Strain Torsional Strain End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 AS TS ASR ASI TSR TSI AS MSA TS MST Stress Real RS RS RS RS Axial Stress Axial Safety Margin* Torsional Stress Torsional Safety Margin* Real / Imaginary RS RS RS RS Axial Stress Axial Stress Torsional Stress Torsional Stress Random Response RS RS Axial Stress Torsional Stress End TCODE,7 End SCODE,6 NX Nastran DMAP Programmer’s Guide 5-79 Chapter 5 Data Block Descriptions O-V Word ELTYPE =02 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 Name Type Description Beam element (CBEAM) Strain Real GRID SD EXC EXD EXE EXF EMAX EMIN MST MSC I RS RS RS RS RS RS RS RS RS External Grid Point identification number Station Distance/Length Long. Strain at Point C Long. Strain at Point D Long. Strain at Point E Long. Strain at Point F Maximum stress Minimum stress Margin of Safety in Tension Margin of Safety in Compression Words 2 through 11 repeat 011 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 GRID SD ERCR EXDR EXER EXFR EXCI EXDI EXEI EXFI Real / Imaginary I RS RS RS RS RS RS RS RS RS External Grid Point identification number Station Distance/Length Long. Strain at Point C Long. Strain at Point D Long. Strain at Point E Long. Strain at Point F Long. Strain at Point C Long. Strain at Point D Long. Strain at Point E Long. Strain at Point F Words 2 through 11 repeat 011 times 5-80 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =2 2 3 4 5 6 7 Name Type Description Random Response GRID SD EXC EXD EXE EXF I RS RS RS RS RS External Grid Point identification number Station Distance/Length Long. Strain at Point C Long. Strain at Point D Long. Strain at Point E Long. Strain at Point F Words 2 through 7 repeat 011 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 GRID SD SXC SXD SXE SXF SMAX SMIN MST MSC Stress Real I RS RS RS RS RS RS RS RS RS External Grid Point identification number Station Distance/Length Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Maximum stress Minimum stress Margin of Safety in Tension Margin of Safety in Compression Words 2 through 11 repeat 011 times TCODE,7=1 2 3 4 GRID SD SRCR Real/Imaginary I RS RS External Grid Point identification number Station Distance/Length Long. Stress at Point C NX Nastran DMAP Programmer’s Guide 5-81 Chapter 5 Data Block Descriptions O-V Word 5 6 7 8 9 10 11 Name SXDR SXER SXFR SXCI SXDI SXEI SXFI Type RS RS RS RS RS RS RS Description Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Words 2 through 11 repeat 011 times TCODE,7 =2 2 3 4 5 6 7 GRID SD SXC SXD SXE SXF Random Response I RS RS RS RS RS External Grid Point identification number Station Distance/Length Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Words 2 through 7 repeat 011 times End TCODE,7 End SCODE,6 ELTYPE=03 SCODE,6=0 TCODE,7 =0 2 3 4 5 AE MSA TE MST Tube element (CTUBE) Strain Real RS RS RS RS Axial Strain Axial Safety Margin* Torsional Strain Torsional Safety Margin* 5-82 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7=1 2 3 4 5 TCODE,7 =2 2 3 Name Type Description Real / Imaginary AER AEI TER TEI RS RS RS RS Axial Strain Axial Strain Torsional Strain Torsional Strain Random Response AE TE RS RS Axial Strain Torsional Strain End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 AS TS ASR ASI TSR TSI AS MSA TS MST Stress Real RS RS RS RS Axial Stress Axial Safety Margin* Torsional Stress Torsional Safety Margin* Real / Imaginary RS RS RS RS Axial Stress Axial Stress Torsional Stress Torsional Stress Random Response RS RS Axial Stress Torsional Stress End TCODE,7 End SCODE,6 ELTYPE =04 Shear panel element (CSHEAR) NX Nastran DMAP Programmer’s Guide 5-83 Chapter 5 Data Block Descriptions O-V Word SCODE,6 =0 TCODE,7 =0 2 3 4 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 Name Type Strain Real Description ETMAX ETAVG MS RS RS RS Maximum Shear Average Shear Safety Margin* Real / Imaginary ETMAXR ETMAXI ETAVGR ETAVGI RS RS RS RS Random Response ETMAX ETAVG RS RS Maximum Shear Average Shear Maximum Shear Maximum Shear Average Shear Average Shear End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 TCODE,7 =1 2 3 4 5 TCODE,7 =2 TMAXR TMAXI TAVGR TAVGI TMAX TAVG MS Stress Real RS RS RS Maximum Shear Average Shear Safety Margin* Real / Imaginary RS RS RS RS Random Response Maximum Shear Maximum Shear Average Shear Average Shear 5-84 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 3 Name TMAX TAVG Type RS RS Description Maximum Shear Average Shear End TCODE,7 End SCODE,6 ELTYPE =05 2 ELTYPE =06 2 ELTYPE =07 2 ELTYPE =08 2 ELTYPE =09 2 Word ELTYPE =10 SCODE,6 =0 TCODE,7 =0 2 3 4 5 TCODE,7 =1 2 3 AER AEI AE MSA TE MST UNDEF Name UNDEF UNDEF UNDEF UNDEF FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness) None Unused None PLOAD4 (follower stiffness) None PLOADX1 (follower stiffness) None PLOAD and PLOAD2 (follower stiffness) None Type Description Rod element connection and property (CONROD) Strain Real RS RS RS RS Axial Strain Axial Safety Margin* Torsional Strain Torsional Safety Margin* Real / Imaginary RS RS Axial Strain Axial Strain NX Nastran DMAP Programmer’s Guide 5-85 Chapter 5 Data Block Descriptions O-V Word 4 5 TCODE,7 =2 2 3 Name TER TEI Type RS RS Random Response Description Torsional Strain Torsional Strain AE TE RS RS Axial Strain Torsional Strain End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 AS TS ASR ASI TSR TSI AS MSA TS MST Stress Real RS RS RS RS Axial Stress Axial Safety Margin* Torsional Stress Torsional Safety Margin* Real / Imaginary RS RS RS RS Axial Stress Axial Stress Torsional Stress Torsional Stress Random Response RS RS Axial Stress Torsional Stress End TCODE,7 End SCODE,6 ELTYPE =11 SCODE,6 =0 TCODE,7 =0 or 2 2 E Scalar spring element (CELAS1) Strain Real or Random Response RS 5-86 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 2 3 Name Type Description Real / Imaginary ER EI RS RS End TCODE,7 SCODE,6 =01 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 SR SI S Stress Real or Random Response RS Stress Real / Imaginary RS RS Stress Stress End TCODE,7 End SCODE,6 ELTYPE =12 SCODE,6 =0 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 ER EI E Scalar spring element with properties (CELAS2) Strain Real or Random Response RS Real / Imaginary RS RS End TCODE,7 SCODE,6 =01 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 SR SI S Stress Real or Random Response RS Stress Real/Imaginary RS RS Stress Stress NX Nastran DMAP Programmer’s Guide 5-87 Chapter 5 Data Block Descriptions O-V Word Name Type Description End TCODE,7 End SCODE,6 ELTYPE =13 SCODE,6 =0 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 ER EI E Scalar spring element to scalar points only (CELAS3) Strain Real or Random Response RS Real / Imaginary RS RS End TCODE,7 SCODE,6 =01 TCODE,7 =0 or 2 2 TCODE,7 =1 2 3 SR SI RS RS Stress Stress S Stress Real or Random Response RS Stress End TCODE,7 End SCODE,6 ELTYPE =14 2 ELTYPE =15 2 ELTYPE =16 2 ELTYPE =17 2 UNDEF UNDEF UNDEF UNDEF Scalar spring element to scalar points only with properties (CELAS4) None AEROT3 None AEROBEAM None Unused (pre-V69 TRIA2 Same as TRIA1) None 5-88 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =18 2 ELTYPE =19 2 Word ELTYPE =20 2 ELTYPE =21 2 ELTYPE =22 2 ELTYPE =23 2 ELTYPE =24 TCODE,7 =0 2 TCODE,7 =1 2 3 4 5 TCODE,7 =2 2 3 Name Type Description Unused (pre-V69 QUAD2 Same as TRIA1) UNDEF None Unused (pre-V69 QUAD1 Same as TRIA1) UNDEF Name None Type Description Scalar damper (CDAMP1) UNDEF None Scalar damper with properties (CDAMP2) UNDEF None Scalar damper to scalar points only (CDAMP3) UNDEF None Scalar damper to scalar points only with properties (CDAMP4) UNDEF None Viscous damper (CVISC) Real UNDEF None Real / Imaginary ASR ASI TAUR TAUI RS RS RS RS Axial Stress Axial Stress Torque Torque Random Response AS TAU RS RS Axial Stress Torque End TCODE,7 ELTYPE =25 Scalar mass (CMASS1) NX Nastran DMAP Programmer’s Guide 5-89 Chapter 5 Data Block Descriptions O-V Word 2 ELTYPE =26 2 ELTYPE =27 2 ELTYPE =28 2 ELTYPE =29 2 Word ELTYPE =30 2 ELTYPE =31 2 ELTYPE =32 2 ELTYPE =33 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 Name UNDEF Type None Description Scalar mass with properties (CMASS2) UNDEF None Scalar mass to scalar points only (CMASS3) UNDEF None Scalar mass to scalar pts. only with properties (CMASS4) UNDEF None Concentrated mass element - general form (CONM1) UNDEF Name None Type Description Concentrated mass element - rigid body form (CONM2) UNDEF None Dummy plot element (PLOTEL) UNDEF None Unused UNDEF None Quadrilateral plate element (CQUAD4) Strain Real FD1 EX1 EY1 EXY1 EA1 EMJRP1 EMNRP1 RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 5-90 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TCODE,7 =2 2 Name EMAX1 FD2 EX2 EY2 EXY2 EA2 EMJRP2 EMNRP2 EMAX2 Type RS RS RS RS RS RS RS RS RS Description Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 EX1R EX1I EY1R EY1I EXY1R EXY1I FD2 EX2R EX2I EY2R EY2I EXY2R EXY2I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 RS Z1 = Fibre Distance NX Nastran DMAP Programmer’s Guide 5-91 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 Name EX1 EY1 EXY1 FD2 EX2 EY2 EXY2 Type RS RS RS RS RS RS RS Description Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 FD1 SX1 SY1 TXY1 SA1 SMJRP1 SMNRP1 SMAX1 FD2 SX2 SY2 TXY2 SA2 SMJRP2 SMNRP2 SMAX2 Stress Real RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 5-92 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TCODE,7 =2 2 3 4 5 6 7 8 9 Name Type Description Real / Imaginary FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 SX1 SY1 TXY1 FD2 SX2 SY2 TXY2 RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 End SCODE,6 NX Nastran DMAP Programmer’s Guide 5-93 Chapter 5 Data Block Descriptions O-V Word ELTYPE =34 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 TCODE,7 =1 2 3 4 5 6 7 8 Name Type Description Simple beam element (CBAR and see also ELTYPE=100) Strain Real EX1A EX2A EX3A EX4A AE EBMAXA EBMINA MST EXIB EX2B EX3B EX4B EBMAXB EBMINB MSC RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS SA1 SA2 SA3 SA4 Axial SA maximum SA minimum Safety Margin in Tension* SB1 SB2 SB3 SB4 SB maximum SB minimum Safety Margin in Comp* Real / Imaginary EX1AR EX2AR EX3AR EX4AR AER EX1AI EX2AI RS RS RS RS RS RS RS SA1 SA2 SA3 SA4 Axial SA1 SA2 5-94 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 14 15 16 17 18 19 TCODE,7 =2 2 3 4 5 6 7 8 9 10 Name EX3AI EX4AI AEI EX1BR EX2BR EX3BR EX4BR EX1BI EX2BI EX3BI EX4BI Type RS RS RS RS RS RS RS RS RS RS RS Description SA3 SA4 Axial SB1 SB2 SB3 SB4 SB1 SB2 SB3 SB4 Random Response EX1A EX2A EX3A EX4A AE EX1B EX2B EX3B EX4B RS RS RS RS RS RS RS RS RS SA1 SA2 SA3 SA4 Axial SB1 SB2 SB3 SB4 End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 SX1A SX2A Stress Real RS RS SA1 SA2 NX Nastran DMAP Programmer’s Guide 5-95 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 8 9 10 11 12 13 14 15 16 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 Name SX3A SX4A AS BMAXA BMINA MST SX1B SX2B SX3B SX4B BMAXB BMINB MSC Type RS RS RS RS RS RS RS RS RS RS RS RS RS Description SA3 SA4 Axial SA maximum SA minimum Safety Margin in Tension SB1 SB2 SB3 SB4 SB maximum SB minimum Safety Margin in Comp* Real / Imaginary SX1AR SX2AR SX3AR SX4AR ASR SX1AI SX2AI SX3AI SX4AI ASI SX1BR SX2BR RS RS RS RS RS RS RS RS RS RS RS RS SA1 SA2 SA3 SA4 Axial SA1 SA2 SA3 SA4 Axial SB1 SB2 5-96 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 14 15 16 17 18 19 TCODE,7 =2 2 3 4 5 6 7 8 9 10 Name SX3BR SX4BR SX1BI SX2BI SX3BI SX4BI Type RS RS RS RS RS RS Description SB3 SB4 SB1 SB2 SB3 SB4 Random Response SX1A SX2A SX3A SX4A AS SX1B SX2B SX3B SX4B RS RS RS RS RS RS RS RS RS SA1 SA2 SA3 SA4 Axial SB1 SB2 SB3 SB4 End TCODE,7 End SCODE,6 ELTYPE =35 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 HOPA FD1 EU1 EV1 ET1 Axisymmetric shell element (CCONEAX) Strain Real RS RS RS RS RS Harmonic or point angle Z1=Fibre Distance Normal in u at z1 Normal in v at z1 Shear in uv at z1 NX Nastran DMAP Programmer’s Guide 5-97 Chapter 5 Data Block Descriptions O-V Word 7 8 9 10 11 12 13 14 15 16 17 18 TCODE,7 =1 2 TCODE,7 =2 2 Name A1 EMJRP1 EMNRP1 ETMAX1 FD2 EU2 EV2 ET2 A2 EMJRP2 EMNRP2 ETMAX2 Type RS RS RS RS RS RS RS RS RS RS RS RS Description Theta (Shear Angle) at z1 Major Principal at z1 Minor Principal at z1 Maximum Shear at z1 Z2=Fibre Distance Normal in u at z2 Normal in v at z2 Shear in uv at z2 Theta (Shear Angle) at z2 Major Principal at z2 Minor Principal at z2 Maximum Shear at z2 Real / Imaginary UNDEF None Random Response UNDEF None End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 HOPA FD1 SU1 SV1 ST1 A1 SMJRP1 Stress Real RS RS RS RS RS RS RS Harmonic or point angle Z1=Fibre Distance Normal in u at z1 Normal in v at z1 Shear in uv at z1 Theta (Shear Angle) at z1 Major Principal at z1 5-98 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 14 15 16 17 18 TCODE,7 =1 2 TCODE,7 =2 2 Name SMNRP1 STMAX1 FD2 SU2 SV2 ST2 A2 SMJRP2 SMNRP2 STMAX2 Type RS RS RS RS RS RS RS RS RS RS Description Minor Principal at z1 Maximum Shear at z1 Z2=Fibre Distance Normal in u at z2 Normal in v at z2 Shear in uv at z2 Theta (Shear Angle) at z2 Major Principal at z2 Minor Principal at z2 Maximum Shear at z2 Real / Imaginary UNDEF None Random Response UNDEF None End TCODE,7 End SCODE,6 ELTYPE =36 2 ELTYPE =37 2 ELTYPE =38 2 3 4 5 6 FX SFY SFZ U V UNDEF UNDEF Unused (Pre-V69 CTRIARG) None Unused (Pre-V69 CTRAPRG) None Gap element (CGAP) RS RS RS RS RS ? ? ? ? ? NX Nastran DMAP Programmer’s Guide 5-99 Chapter 5 Data Block Descriptions O-V Word 7 8 9 ELTYPE =39 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Name W SV SW Type RS RS RS Tetra Strain Real Description ? ? ? CID CTYPE NODEF GRID EX ETXY EP1 P1X P2X P3X EPR EOCT EY ETYZ EP2 P1Y P2Y P3Y EZ ETZX I CHAR4 I I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate Type (BCD) Number of Active Points External grid ID (0=center) Normal in x Shear in xy First principal stress First principal x cosine Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx 5-100 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 22 23 24 25 Name EP3 P1Z P2Z P3Z Type RS RS RS RS Description Third principal stress First principal z cosine Second principal z cosine Third principal z cosine Words 5 through 25 repeat 005 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 CID CTYPE NODEF GRID EXR EYR EZR ETXYR ETYZR ETZXR EXI EYI EZI ETXYI ETYZI ETZXI Real / Imaginary I CHAR4 I I RS RS RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid ID (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 17 repeat 005 times TCODE,7 =2 2 3 CID CTYPE Random Response I CHAR4 Stress Coordinate System Coordinate System Type (BCD) NX Nastran DMAP Programmer’s Guide 5-101 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 8 9 10 11 Name NODEF GRID EX EY EZ ETXY ETYZ ETZX Type I I RS RS RS RS RS RS Description Number of Active Points External grid ID (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 11 repeat 005 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 CID CTYPE NODEF GRID SX TXY P1 P1X P2X P3X PR OCT SY TYZ Stress Real I CHAR4 I I RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Shear in xy First principal stress First principal x cosine Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz 5-102 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 16 17 18 19 20 21 22 23 24 25 Name P2 P1Y P2Y P3Y SZ TZX P3 P1Z P2Z P3Z Type RS RS RS RS RS RS RS RS RS RS Description Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx Third principal stress First principal z cosine Second principal z cosine Third principal z cosine Words 5 through 25 repeat 005 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 CID CTYPE NODEF GRID SXR SYR SZR TXYR TYZR TZXR SXI SYI SZI TXYI Real / Imaginary I CHAR4 I I RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy NX Nastran DMAP Programmer’s Guide 5-103 Chapter 5 Data Block Descriptions O-V Word 16 17 Name TYZI TZXI Type RS RS Description Shear in yz Shear in zx Words 5 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 CID CTYPE NODEF GRID SX SY SZ TXY TYZ TZX Random Response I CHAR4 I I RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 11 repeat 005 times End TCODE,7 End SCODE,6 Word ELTYPE =40 TCODE,7 =0 2 3 4 5 6 7 FE UE VE AS AE EP Name Type Description Rod type spring and damper (CBUSH1D) Real RS RS RS RS RS RS Element Force Axial Displacement Axial Velocity* Axial Stress* Axial Strain* Plastic Strain* 5-104 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 TCODE,7 =1 2 3 4 5 6 7 8 9 TCODE,7 =2 2 3 4 5 Name FAIL Type I Description Failed Element Flag Real / Imaginary FER UER ASR AER FEI UEI ASI AEI RS RS RS RS RS RS RS RS Element Force Axial Displacement Axial Stress* Axial Strain* Element Force Axial Displacement Axial Stress* Axial Strain* Random Response FE UE AS AE RS RS RS RS Element Force Axial Displacement Axial Stress* Axial Strain* End TCODE,7 ELTYPE =41 2 ELTYPE =42 2 ELTYPE =43 2 ELTYPE =44 2 ELTYPE =45 2 UNDEF UNDEF UNDEF UNDEF UNDEF Unused (Pre-V69 CHEXA1) None Unused (Pre-V69 CHEXA2) None Fluid element with 2 points (CFLUID2) None Fluid element with 3 points (CFLUID3) None Fluid element with 4 points (CFLUID4) None NX Nastran DMAP Programmer’s Guide 5-105 Chapter 5 Data Block Descriptions O-V Word ELTYPE =46 2 ELTYPE =47 Name Type Cflmass Description UNDEF None Fluid element with 2 points (CAXIF2) Real or Random Response RS RS RS RS Radial Axis Axial Axis Tangential Edge Circumferential Edge TCODE,7 =0 or 2 2 3 4 5 TCODE,7 =1 2 3 4 5 6 7 8 9 RAR AAR TER CER RAI AAI TEI CEI RA AA TE CE Real / Imaginary RS RS RS RS RS RS RS RS Radial Axis Axial Axis Tangential Edge Circumferential Edge Radial Axis Axial Axis Tangential Edge Circumferential Edge End TCODE,7 ELTYPE =48 TCODE,7 =0 or 2 2 3 4 5 6 7 RC CC AC TE1 CE1 TE2 Fluid element with 3 points (CAXIF3) Real or Random Response RS RS RS RS RS RS Radial centroid Circumferential centroid Axial centroid Tangential edge 1 Circumferential edge 1 Tangential edge 2 5-106 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name CE2 TE3 CE3 Type RS RS RS Description Circumferential edge 2 Tangential edge 3 Circumferential edge 3 Real / Imaginary RCR CCR ACR TE1R CE1R TE2R CE2R TE3R CE3R RCI CCI ACR TE1I CE1I TE2I CE2I TE3I CE3I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Radial centroid Circumferential centroid Axial centroid Tangential edge 1 Circumferential edge 1 Tangential edge 2 Circumferential edge 2 Tangential edge 3 Circumferential edge 3 Radial centroid Circumferential centroid Axial centroid Tangential edge 1 Circumferential edge 1 Tangential edge 2 Circumferential edge 2 Tangential edge 3 Circumferential edge 3 End TCODE,7 ELTYPE =49 TCODE,7 =0 or 2 2 RC Fluid element with 4 points (CAXIF4) Real or Random Response RS Radial centroid NX Nastran DMAP Programmer’s Guide 5-107 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Name CC AC TE1 CE1 TE2 CE2 TE3 CE3 TE4 CE4 Type RS RS RS RS RS RS RS RS RS RS Description Circumferential centroid Axial centroid Tangential edge 1 Circumferential edge 1 Tangential edge 2 Circumferential edge 2 Tangential edge 3 Circumferential edge 3 Tangential edge 4 Circumferential edge 4 Real / Imaginary RCR CCR ACR TE1R CE1R TE2R CE2R TE3R CE3R TE4R CE4R RCI CCI ACR TE1I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Radial centroid Circumferential centroid Axial centroid Tangential edge 1 Circumferential edge 1 Tangential edge 2 Circumferential edge 2 Tangential edge 3 Circumferential edge 3 Tangential edge 4 Circumferential edge 4 Radial centroid Circumferential centroid Axial centroid Tangential edge 1 5-108 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 17 18 19 20 21 22 23 Name CE1I TE2I CE2I TE3I CE3I TE4I CE4I Type RS RS RS RS RS RS RS Description Circumferential edge 1 Tangential edge 2 Circumferential edge 2 Tangential edge 3 Circumferential edge 3 Tangential edge 4 Circumferential edge 4 End TCODE,7 Word ELTYPE =50 TCODE,7 =0 or 2 2 3 4 5 6 TCODE,7 =1 2 3 4 5 6 7 8 9 10 RCR ACR TE1R TE2R TE3R RCI ACI TE1I TE2I RC AC TE1 TE2 TE3 Name Type Description Three-point slot element (CSLOT3) Real or Random Response RS RS RS RS RS Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 Tangential edge 3 Real / Imaginary RS RS RS RS RS RS RS RS RS Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 Tangential edge 3 Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 NX Nastran DMAP Programmer’s Guide 5-109 Chapter 5 Data Block Descriptions O-V Word 11 Name TE3I Type RS Description Tangential edge 3 End TCODE,7 ELTYPE =51 TCODE,7 =0 or 2 2 3 4 5 6 7 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 RCR ACR TE1R TE2R TE3R TE4R RCI ACI TE1I TE2I TE3I TE4I RC AC TE1 TE2 TE3 TE4 Four-point slot element (CSLOT4) Real or Random Response RS RS RS RS RS RS Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 Tangential edge 3 Tangential edge 4 Real / Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 Tangential edge 3 Tangential edge 4 Radial centroid Axial centroid Tangential edge 1 Tangential edge 2 Tangential edge 3 Tangential edge 4 End TCODE,7 ELTYPE =52 2 UNDEF Heat transfer plot element for CHBDYG and CHBDYP None 5-110 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =53 TCODE,7 =0 2 3 4 5 6 7 8 9 Name Type Description Axisymmetric triangular element (CTRIAX6) Real LOC RS AZS AS SS MAXP TMAX OCTS I RS RS RS RS RS RS RS Location Code Radial Stress Azimuthal Stress Axial Stress Shear Stress Maximum Principal Maximum Shear Octahedral Words 2 through 9 repeat 004 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 LOC RSR RSI AZSR AZSI ASR ASI SSR SSI Real / Imaginary I RS RS RS RS RS RS RS RS Location Code ? Radial Stress ? Radial Stress ? Azimuthal Stress ? Azimuthal Stress ? Axial Stress ? Axial Stress ? Shear Stress ? Shear Stress ? Words 2 through 10 repeat 004 times TCODE,7 =2 2 3 4 LOC RS AZS Random Response I RS RS Location Code ? Radial Stress ? Azimuthal Stress ? NX Nastran DMAP Programmer’s Guide 5-111 Chapter 5 Data Block Descriptions O-V Word 5 6 Name AS SS Type RS RS Description Axial Stress ? Shear Stress ? Words 2 through 6 repeat 004 times End TCODE,7 ELTYPE =54 2 ELTYPE =55 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 SR(9) SI(9) S(9) UNDEF Unused (Pre-V69 CTRIM6) None Three-point dummy element (CDUM3) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =56 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 SR(9) SI(9) S(9) Four-point dummy element (CDUM4) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =57 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 SR(9) SI(9) S(9) Five-point dummy element (CDUM5) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase 5-112 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description End TCODE,7 ELTYPE =58 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 SR(9) SI(9) S(9) Six-point dummy element (CDUM6) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 ELTYPE =59 TCODE,7 =0 or 2 2 TCODE,7 =1 2 11 SR(9) SI(9) S(9) Seven-point dummy element (CDUM7) Real or Random Response RS User defined Real/imaginary or magnitude/phase RS RS User defined - real/mag. User defined - mag./phase End TCODE,7 Word ELTYPE =60 2 3 4 5 6 7 8 9 10 X Y SX SY TXY KI KII S8 S9 Name Type Description Two-dimensional crack tip element (CRAC2D or CDUM8) RS RS RS RS RS RS RS RS RS X coordinate Y coordinate Normal X Normal Y Shear XY Stress Intensity Factor KI Stress Intensity Factor KII ? ? NX Nastran DMAP Programmer’s Guide 5-113 Chapter 5 Data Block Descriptions O-V Word ELTYPE =61 2 3 4 5 6 7 8 9 10 ELTYPE =62 2 ELTYPE =63 2 ELTYPE =64 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 Name Type Description Three-dimensional crack tip element (CRAC3D or CDUM9) X Y Z TXY TYZ TZX KI KII KIII RS RS RS RS RS RS RS RS RS Normal X Normal Y Normal Z Shear XY Shear YZ Shear ZX Stress Intensity Factor KI Stress Intensity Factor KII Stress Intensity Factor KIII Unused (Pre-V69 CQDMEM1) UNDEF None Unused (Pre-V69 CQDMEM2) UNDEF None Curved quadrilateral shell element (CQUAD8) Strain Real TERM GRID FD1 EX1 EY1 ETXY1 A1 EMJRP1 EMNRP1 CHAR4 I RS RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 5-114 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 11 12 13 14 15 16 17 18 19 Name ETMAX1 FD2 EX2 EY2 ETXY2 A2 EMRPJ2 EMNRP2 ETMAX2 Type RS RS RS RS RS RS RS RS RS Description Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 005 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 TERM GRID FD1 EX1R EX1I EY1R EY1I ETXY1R ETXY1I FD2 EX2R EX2I EY2R EY2I ETXY2R Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 NX Nastran DMAP Programmer’s Guide 5-115 Chapter 5 Data Block Descriptions O-V Word 17 Name ETXY2I Type RS Description Shear in xy at Z2 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 TERM GRID FD1 EX1 EY1 ETXY1 FD2 EX2 EY2 ETXY2 Random Response CHAR4 I RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 005 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 TERM GRID FD1 SX1 SY1 TXY1 A1 SMJRP1 Stress Real CHAR4 I RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 5-116 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 12 13 14 15 16 17 18 19 Name SMNRP1 TMAX1 FD2 SX2 SY2 TXY2 A2 SMJRP2 SMNRP2 TMAX2 Type RS RS RS RS RS RS RS RS RS RS Description Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 005 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TERM GRID FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS Number active grids identification numbers or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 NX Nastran DMAP Programmer’s Guide 5-117 Chapter 5 Data Block Descriptions O-V Word 16 17 Name TXY2R TXY2I Type RS RS Description Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 TERM GRID FD1 EX1 EY1 ETXY1 FD2 EX2 EY2 ETXY2 Random Response CHAR4 I RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 005 times End TCODE,7 End SCODE,6 ELTYPE =65 2 ELTYPE =66 2 ELTYPE =67 SCODE,6 =0 TCODE,7 =0 2 3 CID CTYPE UNDEF UNDEF Unused (Pre-V69 CHEX8) None Unused (Pre-V69 CHEX20) None Hexa Strain Real I CHAR4 Stress Coordinate System Coordinate Type (BCD) 5-118 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 Name NODEF GRID EX ETXY EP1 P1X P2X P3X EPR EOCT EY ETYZ EP2 P1Y P2Y P3Y EZ ETZX EP3 P1Z P2Z P3Z Type I I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Number of Active Points External grid identification number (0=center) Normal in x Shear in xy First principal stress First principal x cosine Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx Third principal stress First principal z cosine Second principal z cosine Third principal z cosine Words 5 through 25 repeat 009 times TCODE,7 =1 2 3 CID CTYPE Real / Imaginary I CHAR4 Stress Coordinate System Coordinate System Type (BCD) NX Nastran DMAP Programmer’s Guide 5-119 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name NODEF GRID EXR EYR EZR ETXYR ETYZR ETZXR EXI EYI EZI ETXYI ETYZI ETZXI Type I I RS RS RS RS RS RS RS RS RS RS RS RS Description Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 17 repeat 009 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 CID CTYPE NODEF GRID EX EY EZ ETXY ETYZ ETZX Random Response I CHAR4 I I RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx 5-120 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description Words 5 through 11 repeat 009 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 CID CTYPE NODEF GRID SX TXY P1 P1X P2X P3X PR OCT SY TYZ P2 P1Y P2Y P3Y SZ TZX P3 P1Z Stress Real I CHAR4 I I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Shear in xy First principal stress First principal x cosine Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx Third principal stress First principal z cosine NX Nastran DMAP Programmer’s Guide 5-121 Chapter 5 Data Block Descriptions O-V Word 24 25 Name P2Z P3Z Type RS RS Description Second principal z cosine Third principal z cosine Words 5 through 25 repeat 009 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 CID CTYPE NODEF GRID SXR SYR SZR TXYR TYZR TZXR SXI SYI SZI TXYI TYZI TZXI Real / Imaginary I CHAR4 I I RS RS RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 17 repeat 009 times TCODE,7 =2 2 3 4 5 CID CTYPE NODEF GRID Random Response I CHAR4 I I Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) 5-122 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 10 11 Name SX SY SZ TXY TYZ TZX Type RS RS RS RS RS RS Description Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 11 repeat 009 times End TCODE,7 End SCODE,6 ELTYPE =68 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 CID CTYPE NODEF GRID EX ETXY EP1 P1X P2X P3X EPR EOCT EY ETYZ Penta Strain Real I CHAR4 I I RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Shear in xy First principal stress First principal x cosine Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz NX Nastran DMAP Programmer’s Guide 5-123 Chapter 5 Data Block Descriptions O-V Word 16 17 18 19 20 21 22 23 24 25 Name EP2 P1Y P2Y P3Y EZ ETZX EP3 P1Z P2Z P3Z Type RS RS RS RS RS RS RS RS RS RS Description Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx Third principal stress First principal z cosine Second principal z cosine Third principal z cosine Words 5 through 25 repeat 007 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 CID CTYPE NODEF GRID EXR EYR EZR ETXYR ETYZR ETZXR EXI EYI EZI ETXYI Real / Imaginary I CHAR4 I I RS RS RS RS RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy 5-124 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 16 17 Name ETYZI ETZXI Type RS RS Description Shear in yz Shear in zx Words 5 through 17 repeat 007 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 CID CTYPE NODEF GRID EX EY EZ ETXY ETYZ ETZX Random Response I CHAR4 I I RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 11 repeat 007 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 CID CTYPE NODEF GRID SX TXY P1 P1X Stress Real I CHAR4 I I RS RS RS RS Stress Coordinate System Coordinate Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Shear in xy First principal stress First principal x cosine NX Nastran DMAP Programmer’s Guide 5-125 Chapter 5 Data Block Descriptions O-V Word 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 Name P2X P3X PR OCT SY TYZ P2 P1Y P2Y P3Y SZ TZX P3 P1Z P2Z P3Z Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Second principal x cosine Third principal x cosine Mean pressure Octahedral shear stress Normal in y Shear in yz Second principal stress First principal y cosine Second principal y cosine Third principal y cosine Normal in z Shear in zx Third principal stress First principal z cosine Second principal z cosine Third principal z cosine Words 5 through 25 repeat 007 times TCODE,7 =1 2 3 4 5 6 7 8 9 CID CTYPE NODEF GRID SXR SYR SZR TXYR Real / Imaginary I CHAR4 I I RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy 5-126 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 12 13 14 15 16 17 Name TYZR TZXR SXI SYI SZI TXYI TYZI TZXI Type RS RS RS RS RS RS RS RS Description Shear in yz Shear in zx Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 17 repeat 007 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 CID CTYPE NODEF GRID SX SY SZ TXY TYZ TZX Random Response I CHAR4 I I RS RS RS RS RS RS Stress Coordinate System Coordinate System Type (BCD) Number of Active Points External grid identification number (0=center) Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Words 5 through 11 repeat 007 times End TCODE,7 End SCODE,6 ELTYPE =69 SCODE,6 =0 TCODE,7 =0 Curved beam or pipe element (CBEND) Strain Real NX Nastran DMAP Programmer’s Guide 5-127 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 Name GRID CA EC ED EE EF EMAX EMIN MST MSC Type I RS RS RS RS RS RS RS RS RS Description External Grid Point identification number Circumferential Angle Long. strain at Point C Long. strain at Point D Long. strain at Point E Long. strain at Point F Maximum strain Minimum strain Margin of Safety in Tension Margin of Safety in Compression Words 2 through 11 repeat 002 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 GRID CA ECR EDR EER EFR ECI EDI EEI EFI Real / Imaginary I RS RS RS RS RS RS RS RS RS External Grid Point identification number Circumferential Angle Long. strain at Point C Long. strain at Point D Long. strain at Point E Long. strain at Point F Long. strain at Point C Long. strain at Point D Long. strain at Point E Long. strain at Point F Words 2 through 11 repeat 002 times TCODE,7 =2 2 3 GRID CA Random Response I RS External Grid Point identification number Circumferential Angle 5-128 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 4 5 6 7 Name EC ED EE EF Type RS RS RS RS Description Long. strain at Point C Long. strain at Point D Long. strain at Point E Long. strain at Point F Words 2 through 7 repeat 002 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 GRID CA SC SD SE SF SMAX SMIN MST MSC Stress Real I RS RS RS RS RS RS RS RS RS External Grid Point identification number Circumferential Angle Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Maximum stress Minimum stress Margin of Safety in Tension Margin of Safety in Compression Words 2 through 11 repeat 002 times TCODE,7 =1 2 3 4 5 6 7 GRID CA SCR SDR SER SFR Real / Imaginary I RS RS RS RS RS External Grid Point identification number Circumferential Angle Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F NX Nastran DMAP Programmer’s Guide 5-129 Chapter 5 Data Block Descriptions O-V Word 8 9 10 11 Name SCI SDI SEI SFI Type RS RS RS RS Description Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Words 2 through 11 repeat 002 times TCODE,7 =2 2 3 4 5 6 7 GRID CA SC SD SE SF Random Response I RS RS RS RS RS External Grid Point identification number Circumferential Angle Long. Stress at Point C Long. Stress at Point D Long. Stress at Point E Long. Stress at Point F Words 2 through 7 repeat 002 times End TCODE,7 End SCODE,6 Word ELTYPE =70 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 TERM GRID FD1 EX1 EY1 ETXY1 Name Type Description Triangular plate element (CTRIAR) Strain Real CHAR4 I RS RS RS RS "CEN" Number active grids ID or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 5-130 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 12 13 14 15 16 17 18 19 Name A1 EMJRP1 EMNRP1 ETMAX1 FD2 EX2 EY2 ETXY2 A2 EMJRP2 EMNRP2 ETMAX2 Type RS RS RS RS RS RS RS RS RS RS RS RS Description Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 004 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 TERM GRID FD1 EX1R EX1I EY1R EY1I ETXY1R ETXY1I FD2 EX2R EX2I Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 NX Nastran DMAP Programmer’s Guide 5-131 Chapter 5 Data Block Descriptions O-V Word 14 15 16 17 Name EY2R EY2I ETXY2R ETXY2I Type RS RS RS RS Description Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 004 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 TERM GRID FD1 EX1 EY1 ETXY1 FD2 EX2 EY2 ETXY2 Random Response CHAR4 I RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 004 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 TERM GRID FD1 SX1 SY1 Stress Real CHAR4 I RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 5-132 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 7 8 9 10 11 12 13 14 15 16 17 18 19 Name TXY1 A1 MJRP1 MNRP1 TMAX1 FD2 SX2 SY2 TXY2 A2 MJRP2 MNRP2 TMAX2 Type RS RS RS RS RS RS RS RS RS RS RS RS RS Description Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 004 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 TERM GRID FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 NX Nastran DMAP Programmer’s Guide 5-133 Chapter 5 Data Block Descriptions O-V Word 13 14 15 16 17 Name SX2I SY2R SY2I TXY2R TXY2I Type RS RS RS RS RS Description Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 004 times TCODE,7 =2 2 3 4 5 6 7 8 9 10 11 TERM GRID FD1 SX1 SY1 TXY1 FD2 SX2 SY2 TXY2 Random Response CHAR4 I RS RS RS RS RS RS RS RS Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 004 times End TCODE,7 End SCODE,6 ELTYPE =71 2 ELTYPE =72 2 ELTYPE =73 2 UNDEF UNDEF UNDEF Unused None AEROQ4 None Unused (Pre-V69 CFTUBE) None 5-134 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =74 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 Name Type Description Triangular shell element (CTRIA3) Strain Real FD1 EX1 EY1 EXY1 EA1 EMJRP1 EMNRP1 EMAX1 FD2 EX2 EY2 EXY2 EA2 EMJRP2 EMNRP2 EMAX2 RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 EX1R EX1I EY1R EY1I EXY1R RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 NX Nastran DMAP Programmer’s Guide 5-135 Chapter 5 Data Block Descriptions O-V Word 8 9 10 11 12 13 14 15 TCODE,7 =2 2 3 4 5 6 7 8 9 Name EXY1I FD2 EX2R EX2I EY2R EY2I EXY2R EXY2I Type RS RS RS RS RS RS RS RS Description Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 EX1 EY1 EXY1 FD2 EX2 EY2 EXY2 RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 FD1 SX1 SY1 TXY1 SA1 SMJRP1 Stress Real RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 5-136 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TCODE,7 =2 Name SMNRP1 SMAX1 FD2 SX2 SY2 TXY2 SA2 SMJRP2 SMNRP2 TMAX2 Type RS RS RS RS RS RS RS RS RS RS Description Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response NX Nastran DMAP Programmer’s Guide 5-137 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 Name FD1 SX1 SY1 TXY1 FD2 SX2 SY2 TXY2 Type RS RS RS RS RS RS RS RS Description Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 End SCODE,6 ELTYPE =75 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 TERM GRID FD1 EX1 EY1 ETXY1 A1 EMJRP1 EMNRP1 ETMAX1 FD2 EX2 EY2 Curved triangular shell element (CTRIA6) Strain Real CHAR4 I RS RS RS RS RS RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 5-138 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 15 16 17 18 19 Name ETXY2 A2 EMJRP2 EMNRP2 ETMAX2 Type RS RS RS RS RS Description Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 004 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TERM GRID FD1 EX1R EX1I EY1R EY1I ETXY1R ETXY1I FD2 EX2R EX2I EY2R EY2I ETXY2R ETXY2I Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 004 times TCODE,7 =2 2 TERM Random Response CHAR4 "CENTER" NX Nastran DMAP Programmer’s Guide 5-139 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 Name GRID FD1 EX1 EY1 ETXY1 FD2 EX2 EY2 ETXY2 Type I RS RS RS RS RS RS RS RS Description Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 004 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 TERM GRID FD1 SX1 SY1 TXY1 A1 SMJRP1 SMNRP1 TMAX1 FD2 SX2 Stress Real CHAR4 I RS RS RS RS RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 5-140 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 14 15 16 17 18 19 Name SY2 TXY2 A2 SMJRP2 SMNRP2 TMAX2 Type RS RS RS RS RS RS Description Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 004 times TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TERM GRID FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I Real / Imaginary CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 004 times TCODE,7 =2 Random Response NX Nastran DMAP Programmer’s Guide 5-141 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 Name TERM GRID FD1 SX1 SY1 TXY1 FD2 SX2 SY2 TXY2 Type CHAR4 I RS RS RS RS RS RS RS RS Description Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 004 times End TCODE,7 End SCODE,6 ELTYPE =76 2 ELTYPE =77 2 ELTYPE =78 2 ELTYPE =79 2 Word ELTYPE =80 2 UNDEF UNDEF Name UNDEF UNDEF UNDEF Acoustic velocity/pressures in six-sided solid element (CHEXA) None Acoustic velocity/pressures in five-sided solid element (CPENTA) None Acoustic velocity/pressures in four-sided solid element (CTETRA) None Undef None Type Undef None Description 5-142 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ELTYPE =81 2 ELTYPE =82 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Name Type Undef Description UNDEF None Quadrilateral plate element (CQUADR) Strain Real TERM GRID FD1 EX1 EY1 ETXY1 A1 EMJRP1 EMNRP1 ETMAX1 FD2 EX2 EY2 ETXY2 A2 EMJRP2 EMNRP2 ETMAX2 CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 005 times TCODE,7 =1 2 TERM Real / Imaginary CHAR4 "CENTER" NX Nastran DMAP Programmer’s Guide 5-143 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name GRID FD1 EX1R EX1I EY1R EY1I ETXY1R ETXY1I FD2 EX2R EX2I EY2R EY2I ETXY2R ETXY2I Type I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 TERM GRID FD1 EX1 EY1 ETXY1 FD2 EX2 Random Response CHAR4 I RS RS RS RS RS RS "CENTER" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 5-144 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 Name EY2 ETXY2 Type RS RS Description Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 005 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 TERM GRID FD1 SX1 SY1 TXY1 A1 MJRP1 MNRP1 TMAX1 FD2 SX2 SY2 TXY2 A2 MJRP2 MNRP2 TMAX2 Stress Real CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS "CEN" Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta (Shear Angle) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Words 3 through 19 repeat 005 times TCODE,7 =1 Real / Imaginary NX Nastran DMAP Programmer’s Guide 5-145 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TERM GRID FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I Type CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Fiber distance at Z2 Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 TERM GRID FD1 SX1 SY1 TXY1 FD2 Random Response CHAR4 I RS RS RS RS RS Number active grids identification number or grid identification number Fiber distance at Z1 Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Fiber distance at Z2 5-146 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 Name SX2 SY2 TXY2 Type RS RS RS Description Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Words 3 through 11 repeat 005 times End TCODE,7 End SCODE,6 ELTYPE =83 2 ELTYPE =84 2 ELTYPE =85 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 CTYPE GRID SX SY SZ SXY SYZ SZX SE EPS ECS EX EY EZ EXY UNDEF UNDEF Acoustic absorber element (CHACAB) None Acoustic barrier element (CHACBR) None TETRA - Nonlinear CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS Grid / Gauss Stress in x Stress in y Stress in z Stress in xy Stress in yz Stress in zx Equivalent stress Effective plastic strain Effective creep strain Strain in x Strain in y Strain in z Strain in xy NX Nastran DMAP Programmer’s Guide 5-147 Chapter 5 Data Block Descriptions O-V Word 17 18 Name EYZ EZX Type RS RS Description Strain in yz Strain in zx Words 3 through 18 repeat 005 times ELTYPE =86 2 3 4 5 6 7 8 9 10 11 ELTYPE =87 2 3 4 5 6 7 ELTYPE =88 NUMWDE =13 2 3 4 FD1 SX1 SY1 RS RS RS Z1 = Fiber distance Stress in x at Z1 Stress in y at Z1 AS SE TE EPS ECS LTS CPX SHY SHZ AU SHV SHW SLV SLP FORM1 FORM2 GAP - Nonlinear RS RS RS RS RS RS RS RS CHAR4 CHAR4 Comp x Shear in y Shear in z Axial in u Shear in v Shear in w Slip in v Slip in w No definition No definition Nonlinear tube element (CTUBE) RS RS RS RS RS RS Axial Stress Equivalent Stress Total Strain Effective Plastic strain Effective Creep strain Linear torsional stress TRIA3 - Nonlinear (Same as QUAD4) 5-148 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 Name SZ1 TXY1 ES EPS1 ECS1 EX1 EY1 EZ1 ETXY1 Type RS RS RS RS RS RS RS RS RS Description Stress in z at Z1 Shear stress in xy at Z1 Equivalent stress at Z1 Effective plastic/inelastic strain at Z1 Effective creep strain at Z1 Strain in x at Z1 Strain in y at Z1 Strain in z at Z1 Shear strain in xy at Z1 NUMWDE =25 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 FD1 SX1 SY1 UNDEF TXY1 ES EPS1 ECS1 EX1 EY1 UNDEF ETXY1 FD2 SX2 SY2 UNDEF RS RS RS None RS RS RS RS RS RS None RS RS RS RS None Z1 = Fiber distance Stress in x at Z1 Stress in y at Z1 Stress in z at Z1 Shear stress in xy at Z1 Equivalent stress at Z1 Effective plastic/inelastic strain at Z1 Effective creep strain at Z1 Strain in x at Z1 Strain in y at Z1 Strain in z at Z1 Shear strain in xy at Z1 Z2 = Fiber distance Stress in x at Z2 Stress in y at Z2 Stress in z at Z2 NX Nastran DMAP Programmer’s Guide 5-149 Chapter 5 Data Block Descriptions O-V Word 18 19 20 21 22 23 24 25 Name TXY2 ES EPS2 ECS2 EX2 EY2 UNDEF ETXY2 Type RS RS RS RS RS RS None RS Description Shear stress in xy at Z2 Equivalent stress at Z2 Effective plastic/inelastic strain at Z2 Effective creep strain at Z2 Strain in x at Z2 Strain in y at Z2 Strain in z at Z2 Shear strain in xy at Z2 End NUMWDE ELTYPE =89 2 3 4 5 6 7 Word ELTYPE =90 NUMWDE =13 2 3 4 5 6 7 8 FD1 SX1 SY1 SZ1 TXY1 ES EPS1 RS RS RS RS RS RS RS Z1 = Fiber distance Stress in x at Z1 Stress in y at Z1 Stress in z at Z1 Shear stress in xy at Z1 Equivalent stress at Z1 Effective plastic/inelastic strain at Z1 AS SE TE EPS ECS LTS Name Nonlinear rod element (CROD) RS RS RS RS RS RS Type Axial Stress Equivalent Stress Total Strain Effective Plastic strain Effective Creep strain Linear torsional stress Description QUAD4 - Nonlinear 5-150 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 Name ECS1 EX1 EY1 EZ1 ETXY1 Type RS RS RS RS RS Description Effective creep strain at Z1 Strain in x at Z1 Strain in y at Z1 Strain in z at Z1 Shear strain in xy at Z1 NUMWDE =25 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 FD1 SX1 SY1 UNDEF TXY1 ES EPS1 ECS1 EX1 EY1 UNDEF ETXY1 FD2 SX2 SY2 UNDEF TXY2 ES EPS2 ECS2 RS RS RS None RS RS RS RS RS RS None RS RS RS RS None RS RS RS RS Z1 = Fiber distance Stress in x at Z1 Stress in y at Z1 Stress in z at Z1 Shear stress in xy at Z1 Equivalent stress at Z1 Effective plastic/inelastic strain at Z1 Effective creep strain at Z1 Strain in x at Z1 Strain in y at Z1 Strain in z at Z1 Shear strain in xy at Z1 Z2 = Fiber distance Stress in x at Z2 Stress in y at Z2 Stress in z at Z2 Shear stress in xy at Z2 Equivalent stress at Z2 Effective plastic/inelastic strain at Z2 Effective creep strain at Z2 NX Nastran DMAP Programmer’s Guide 5-151 Chapter 5 Data Block Descriptions O-V Word 22 23 24 25 Name EX2 EY2 UNDEF ETXY2 Type RS RS None RS Description Strain in x at Z2 Strain in y at Z2 Strain in z at Z2 Shear strain in xy at Z2 End NUMWDE ELTYPE =91 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 CTYPE GRID SX SY SZ SXY SYZ SZX SE EPS ECS EX EY EZ EXY EYZ EZX Nonlinear five-sided solid element (CPENTA) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Grid or Gauss Extermal Grid identification number; 0 = Center Stress in x Stress in y Stress in z Stress in xy Stress in yz Stress in zx Equivalent stress Equivalent plastic strain Effective creep strain Strain in x Strain in y Strain in z Strain in xy Strain in yz Strain in zx Words 3 through 18 repeat 007 times ELTYPE =92 2 AS Nonlinear rod element connection and property (CONROD) RS Axial Stress 5-152 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 3 4 5 6 7 ELTYPE =93 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 Name SE TE EPS ECS LTS Type RS RS RS RS RS Description Equivalent Stress Total Strain Effective Plastic strain Effective Creep strain Linear torsional stress Nonlinear six-sided solid element (CHEXA) CTYPE GRID SX SY SZ SXY SYZ SZX SE EPS ECS EX EY EZ EXY EYZ EZX CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Grid or Gauss Extermal Grid identification number; 0 = Center Stress in x Stress in y Stress in z Stress in xy Stress in yz Stress in zx Equivalent stress Equivalent plastic strain Effective creep strain Strain in x Strain in y Strain in z Strain in xy Strain in yz Strain in zx Words 3 through 18 repeat 009 times ELTYPE =94 2 GRIDA Nonlinear beam element (CBEAM) I External Grid point Id at A NX Nastran DMAP Programmer’s Guide 5-153 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 Name LOCCA NSXCA NSECA TECA EPECA ECECA LOCDA NSXDA NSEDA TEDA EPEDA ECEDA LOCEA NSXEA NSEEA TEEA EPEEA ECEEA LOCFA NSXFA NSEFA TEFA EPEFA ECEFA GRIDB LOCCB Type CHAR4 RS RS RS RS RS CHAR4 RS RS RS RS RS CHAR4 RS RS RS RS RS CHAR4 RS RS RS RS RS I CHAR4 Description ’C’ (BCD Value) at A Long. Stress at point C at A Equivalent Stress at A Total Strain at A Effective Plastic strain at A Effective Creep strain at A ’D’ (BCD Value) at A Long. Stress at point D at A Equivalent Stress at A Total Strain at A Effective Plastic strain at A Effective Creep strain at A ’E’ (BCD Value) at A Long. Stress at point E at A Equivalent Stress at A Total Strain at A Effective Plastic strain at A Effective Creep strain at A ’F’ (BCD Value) at A Long. Stress at point F at A Equivalent Stress at A Total Strain at A Effective Plastic strain at A Effective Creep strain at A External Grid point identification number at B ’C’ (BCD Value) at B 5-154 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 ELTYPE =95 SCODE,6 =0 2 Name NSXCB NSECB TECB EPECB ECECB LOCDB NSXDB NSEDB TEDB EPEDB ECEDB LOCEB NSXEB NSEEB TEEB EPEEB ECEEB LOCFB NSXFB NSEFB TEFB EPEFB ECEFB Type RS RS RS RS RS CHAR4 RS RS RS RS RS CHAR4 RS RS RS RS RS CHAR4 RS RS RS RS RS Description Long. Stress at point C at B Equivalent Stress at B Total Strain at B Effective Plastic strain at B Effective Creep strain at B ’D’ (BCD Value) at B Long. Stress at point D at B Equivalent Stress at B Total Strain at B Effective Plastic strain at B Effective Creep strain at B ’E’ (BCD Value) at B Long. Stress at point E at B Equivalent Stress at B Total Strain at B Effective Plastic strain at B Effective Creep strain at B ’F’ (BCD Value) at B Long. Stress at point F at B Equivalent Stress at B Total Strain at B Effective Plastic strain at B Effective Creep strain at B QUAD4 composite Strain PLY I Lamina Number NX Nastran DMAP Programmer’s Guide 5-155 Chapter 5 Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 Name EX1 EY1 ET1 EL1 EL2 A1 EMJRP1 EMNRP1 ETMAX1 Type RS RS RS RS RS RS RS RS RS Stress I RS RS RS RS RS RS RS RS RS Description Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 8 9 10 11 PLY SX1 SY1 T1 SL1 SL2 A1 MJRP1 MNRP1 TMAX1 Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear End SCODE,6 ELTYPE =96 SCODE,6 =0 2 3 4 PLY EX1 EY1 QUAD8 composite (Same as QUAD4 composite) Strain I RS RS Lamina Number Normal-1 Normal-2 5-156 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 Name ET1 EL1 EL2 A1 EMJRP1 EMNRP1 ETMAX1 Type RS RS RS RS RS RS RS Stress I RS RS RS RS RS RS RS RS RS Description Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 8 9 10 11 PLY SX1 SY1 T1 SL1 SL2 A1 MJRP1 MNRP1 TMAX1 Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear End SCODE,6 ELTYPE =97 SCODE,6 =0 2 3 4 5 6 PLY EX1 EY1 ET1 EL1 TRIA3 composite (Same as QUAD4 composite) Strain I RS RS RS RS Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z NX Nastran DMAP Programmer’s Guide 5-157 Chapter 5 Data Block Descriptions O-V Word 7 8 9 10 11 Name EL2 A1 EMJRP1 EMNRP1 ETMAX1 Type RS RS RS RS RS Stress I RS RS RS RS RS RS RS RS RS Description Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 8 9 10 11 PLY SX1 SY1 T1 SL1 SL2 A1 MJRP1 MNRP1 TMAX1 Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear End SCODE,6 ELTYPE =98 SCODE,6 =0 2 3 4 5 6 7 8 PLY EX1 EY1 ET1 EL1 EL2 A1 TRIA6 composite (Same as QUAD4 composite) Strain I RS RS RS RS RS RS Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle 5-158 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 Name EMJRP1 EMNRP1 ETMAX1 Type RS RS RS Stress I RS RS RS RS RS RS RS RS RS Description Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 8 9 10 11 PLY SX1 SY1 T1 SL1 SL2 A1 MJRP1 MNRP1 TMAX1 Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear End SCODE,6 ELTYPE =99 2 Word UNDEF Name Undef None Type Description ELTYPE =100 SCODE,6 =0 TCODE,7 =0 2 3 4 5 SD EXC EXD EXE Simple beam element w/stations (CBAR with CBARAO or PLOAD1) Strain Real RS RS RS RS % along bar for output Strain at point c Strain at point d Strain at point e NX Nastran DMAP Programmer’s Guide 5-159 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 10 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 TCODE,7 =2 2 3 4 5 Name EXF AE EMAX EMIN MS Type RS RS RS RS RS Description Strain at point f Axial strain Maximum strain Minimum strain Margin of Safety Real / Imaginary SD EXCR EXDR EXER EXFR AER EMAXR EMINR EXCI EXDI EXEI EXFI AEI EMAXI EMINI RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS % along bar for output Strain at point c Strain at point d Strain at point e Strain at point f Axial strain Maximum strain Minimum strain Strain at point c Strain at point d Strain at point e Strain at point f Axial strain Maximum strain Minimum strain Random Response SD EXC EXD EXE RS RS RS RS % along bar for output Strain at point c Strain at point d Strain at point e 5-160 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 Name EXF AE EMAX EMIN Type RS RS RS RS Description Strain at point f Axial strain Maximum strain Minimum strain End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 TCODE,7 =1 2 3 4 5 6 7 8 9 10 SD SXCR SXDR SXER SXFR ASR SMAXR SMINR SXCI SD SXC SXD SXE SXF AS SMAX SMIN MS Stress Real RS RS RS RS RS RS RS RS RS % along bar for output Stress at point c Stress at point d Stress at point e Stress at point f Axial stress Maximum stress Minimum stress Margin of Safety Real / Imaginary RS RS RS RS RS RS RS RS RS % along bar for output Stress at point c Stress at point d Stress at point e Stress at point f Axial stress Maximum stress Minimum stress Stress at point c NX Nastran DMAP Programmer’s Guide 5-161 Chapter 5 Data Block Descriptions O-V Word 11 12 13 14 15 16 TCODE,7 =2 2 3 4 5 6 7 8 9 Name SXDI SXEI SXFI ASI SMAXI SMINI Type RS RS RS RS RS RS Description Stress at point d Stress at point e Stress at point f Axial stress Maximum stress Minimum stress Random Response SD SXC SXD SXE SXF AS SMAX SMIN RS RS RS RS RS RS RS RS % along bar for output Stress at point c Stress at point d Stress at point e Stress at point f Axial stress Maximum stress Minimum stress End TCODE,7 End SCODE,6 ELTYPE =101 TCODE,7 =0 or 2 2 3 TCODE,7 =1 2 3 4 IMPEDR IMPEDI ABSORB IMPED ABSORB Acoustic absorber element with freq. dependence (CAABSF) Real or Random Response RS RS Impedance Absorption Coefficient Real / Imaginary RS RS RS Impedance Impedance Absorption Coefficient End TCODE,7 5-162 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description ELTYPE =102 TCODE,7 =0 or 2 2 3 4 5 6 7 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 TXR TYR TZR RXR RYR RZR TXI TYI TZI RXI RYI RZI TX TY TZ RX RY RZ Generalized spring and damper element (CBUSH) Real or Random Response RS RS RS RS RS RS Translation x Translation y Translation z Rotation x Rotation y Rotation z Real / Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Translation x R Translation y R Translation z R Rotation x R Rotation y R Rotation z R Translation x I Translation y I Translation z I Rotation x I Rotation y I Rotation z I End TCODE,7 ELTYPE =103 2 UNDEF Quadrilateral shell element (QUADP) None Triangular shell p-element (TRIAP) None ELTYPE =104 2 UNDEF NX Nastran DMAP Programmer’s Guide 5-163 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =105 2 UNDEF Beam p-element (BEAMP) None Scalar damper with material property (CDAMP5) None Heat transfer boundary condition element - (CHBDYE) None Heat transfer boundary condition element (CHBDYG) None Heat transfer boundary condition element (CHBDYP) None Type CONV None CONVM None RADBC None QBDY3 None QVECT None QVOL None Radbc None Slideline contact (SLIF1D)? Description ELTYPE =106 2 UNDEF ELTYPE =107 2 UNDEF ELTYPE =108 2 UNDEF ELTYPE =109 2 Word UNDEF Name ELTYPE =110 2 UNDEF ELTYPE =111 2 UNDEF ELTYPE =115 2 UNDEF ELTYPE =112 2 UNDEF ELTYPE =113 2 UNDEF ELTYPE =114 2 UNDEF ELTYPE =115 2 UNDEF ELTYPE =116 5-164 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 Word Name UNDEF Name Type None Type CQUAD CQUADX Description Description ELTYPE =127 ELTYPE =128 ELTYPE =129 Word Name RELUC - EMAS? Type RES - EMAS? TETRAE - EMAS? CTRIA CTRIAX LINEOB - EMAS? LINXOB - EMAS? QUADOB - EMAS? TRIAOB - EMAS? LINEX - EMAS? Hyperelastic QUAD4FD CHAR4 I RS RS RS RS RS RS Description ELTYPE =130 ELTYPE =131 ELTYPE =132 ELTYPE =133 ELTYPE =134 ELTYPE =135 ELTYPE =136 ELTYPE =137 ELTYPE =138 ELTYPE =139 2 3 4 5 6 7 8 9 TYPE ID SX SY SXY ANGLE SMJ SMI Words 3 through 9 repeat 004 times NX Nastran DMAP Programmer’s Guide 5-165 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =140 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 TYPE ID SX SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY BZ SZ SZX PC CX CY CZ Hyperelastic 8-noded hexahedron element linear format (HEXAFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Words 3 through 22 repeat 008 times ELTYPE =141 2 UNDEF Six-sided solid p-element (HEXAP) None Five-sided solid p-element (PENTAP) ELTYPE =142 5-166 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 Name UNDEF Type None Description ELTYPE =143 2 UNDEF Four-sided solid p-element (TETRAP) None Quadrilateral plate element for corner stresses (QUAD144) Strain Real ELTYPE =144 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 TERM GRID FD1 EX1 EY1 ETXY1 A1 EMJRP1 EMNRP1 ETMAX1 FD2 EX2 EY2 ETXY2 A2 EMJRP2 EMNRP2 ETMRP2 CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Fiber distance at z1 Normal in x at z1 Normal in y at z1 Shear in xy at z1 Shear angle at z1 Major Principal at z1 Minor Principal at z1 von Mises or max shear at z1 Fiber distance at z2 Normal in x at z2 Normal in y at z2 Shear in xy at z2 Shear angle at z2 Major Principal at z2 Minor Principal at z2 von Mises or max shear at z2 Words 3 through 19 repeat 005 times TCODE,7 =1 Real / Imaginary NX Nastran DMAP Programmer’s Guide 5-167 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TERM GRID FD1 EX1R EX1I EY1R EY1I ETXY1R ETXY1I FD2 EX2R EX2I EY2R EY2I ETXY2R ETXY2I Type CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Fiber distance at z1 Normal in x at z1 Normal in x at z1 Normal in y at z1 Normal in y at z1 Shear in xy at z1 Shear in xy at z1 Fiber distance at z2 Normal in x at z2 Normal in x at z2 Normal in y at z2 Normal in y at z2 Shear in xy at z1 Shear in xy at z1 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 TERM GRID FD1 EX1 EY1 ETXY1 FD2 EX2 Random Response CHAR4 I RS RS RS RS RS RS Fiber distance at z1 Normal in x at z1 Normal in y at z1 Shear in xy at z1 Fiber distance at z2 Normal in x at z2 5-168 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 Name EY2 ETXY2 Type RS RS Description Normal in y at z2 Shear in xy at z1 Words 3 through 11 repeat 005 times End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 TERM GRID FD1 SX1 SY1 TXY1 A1 MJRP1 MNRP1 TMAX1 FD2 SX2 SY2 TXY2 A2 MJRP2 MNRP2 TMAX2 Stress Real CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Fiber distance at z1 Normal in x at z1 Normal in y at z1 Shear in xy at z1 Shear angle at z1 Major Principal at z1 Minor Principal at z1 von Mises or max shear at z1 Fiber distance at z2 Normal in x at z2 Normal in y at z2 Shear in xy at z2 Shear angle at z2 Major Principal at z2 Minor Principal at z2 von Mises or max shear at z2 Words 3 through 19 repeat 005 times TCODE,7 =1 Real / Imaginary NX Nastran DMAP Programmer’s Guide 5-169 Chapter 5 Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Name TERM GRID FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I Type CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Fiber distance at z1 Normal in x at z1 Normal in x at z1 Normal in y at z1 Normal in y at z1 Shear in xy at z1 Shear in xy at z1 Fiber distance at z2 Normal in x at z2 Normal in x at z2 Normal in y at z2 Normal in y at z2 Shear in xy at z2 Shear in xy at z2 Words 3 through 17 repeat 005 times TCODE,7 =2 2 3 4 5 6 7 8 9 TERM GRID FD1 SX1 SY1 TXY1 FD2 SX2 Random Response CHAR4 I RS RS RS RS RS RS Fiber distance at z1 Normal in x at z1 Normal in y at z1 Shear in xy at z1 Fiber distance at z2 Normal in x at z2 5-170 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 10 11 Name SY2 TXY2 Type RS RS Description Normal in y at z2 Shear in xy at z2 Words 3 through 11 repeat 005 times End TCODE,7 End SCODE,6 ELTYPE =145 2 PARENTID Six-sided solid display element (VUHEXA) I Len=2+ 12 * No. of points I RS RS RS RS RS RS RS RS RS RS RS NUMWDE =98 3 4 5 6 7 8 9 10 11 12 13 14 GRIDID XNORM YNORM ZNORM TXY TYZ TZX PRIN01 PRIN02 PRIN03 MEAN VONOROCT Words 3 through 14 repeat 008 times NUMWDE =58 3 4 5 6 GRIDID XNORM YNORM ZNORM Len= 2 + 7 * No. of points I RS RS RS NX Nastran DMAP Programmer’s Guide 5-171 Chapter 5 Data Block Descriptions O-V Word 7 8 9 Name TXY TYZ TZX Type RS RS RS Description Words 3 through 9 repeat 008 times NUMWDE =106 3 4 5 6 7 8 9 10 11 12 13 14 15 GRIDID XNORMR YNORMR ZNORMR TXYR TYZR TZXR XNORMI YNORMI ZNORMI TXYI TYZI TZXI Len= 2 + 13 * No. of points I RS RS RS RS RS RS RS RS RS RS RS RS Words 3 through 15 repeat 008 times End NUMWDE ELTYPE =146 2 PARENTID Five-sided solid display element (VUPENTA) I NUMWDE =74 3 4 5 GRIDID XNORM YNORM I RS RS 5-172 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 10 11 12 13 14 Name ZNORM TXY TYZ TZX PRIN01 PRIN02 PRIN03 MEAN VONOROCT Type RS RS RS RS RS RS RS RS RS Description Words 3 through 14 repeat 006 times NUMWDE =44 3 4 5 6 7 8 9 GRIDID XNORM YNORM ZNORM TXY TYZ TZX I RS RS RS RS RS RS Words 3 through 9 repeat 006 times NUMWDE =80 3 4 5 6 7 8 GRIDID XNORMR YNORMR ZNORMR TXYR TYZR 2 + 6*13 I RS RS RS RS RS NX Nastran DMAP Programmer’s Guide 5-173 Chapter 5 Data Block Descriptions O-V Word 9 10 11 12 13 14 15 Name TZXR XNORMI YNORMI ZNORMI TXYI TYZI TZXI Type RS RS RS RS RS RS RS Description Words 3 through 15 repeat 006 times End NUMWDE ELTYPE =147 2 PARENTID Four-sided solid display element (VUTETRA) I NUMWDE =50 3 4 5 6 7 8 9 10 11 12 13 14 GRIDID XNORM YNORM ZNORM TXY TYZ TZX PRIN01 PRIN02 PRIN03 MEAN VONOROCT I RS RS RS RS RS RS RS RS RS RS RS Words 3 through 14 repeat 004 times NUMWDE =30 5-174 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 3 4 5 6 7 8 9 Name GRIDID XNORM YNORM ZNORM TXY TYZ TZX Type I RS RS RS RS RS RS Description Words 3 through 9 repeat 004 times NUMWDE =54 3 4 5 6 7 8 9 10 11 12 13 14 15 GRIDID XNORMR YNORMR ZNORMR TXYR TYZR TZXR XNORMI YNORMI ZNORMI TXYI TYZI TZXI 2 + 4*13 I RS RS RS RS RS RS RS RS RS RS RS RS Words 3 through 15 repeat 004 times End NUMWDE ELTYPE =148 2 UNDEF HEXAM - EMAS? None NX Nastran DMAP Programmer’s Guide 5-175 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =149 2 Word UNDEF Name PENTAM - EMAS? None Type Description ELTYPE =150 2 UNDEF TETRAM - EMAS? None QUADM - EMAS? None TRIAM - EMAS? None QUADXM - EMAS? None TRIAXM - EMAS? None QUADPW - EMAS? None TRIAPW - EMAS? None LINEPW - EMAS? None QUADOBM - EMAS? None TRIAOBM - EMAS? None Type Description ELTYPE =151 2 UNDEF ELTYPE =152 2 UNDEF ELTYPE =153 2 UNDEF ELTYPE =154 2 UNDEF ELTYPE =155 2 UNDEF ELTYPE =156 2 UNDEF ELTYPE =157 2 UNDEF ELTYPE =158 2 UNDEF ELTYPE =159 2 Word UNDEF Name ELTYPE =160 Hyperelastic 5-sided 6-noded solid element (PENTAFD) Linear form? 5-176 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Name TYPE ID SX SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY BZ SZ SZX PC CX CY CZ Type CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Words 3 through 22 repeat 006 times ELTYPE =161 2 3 4 TYPE ID SX Linear form for hyperelastic 4 node TETR CHAR4 I RS NX Nastran DMAP Programmer’s Guide 5-177 Chapter 5 Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Name SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY BZ SZ SZX PC CX CY CZ Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Words 3 through 22 repeat 001 times ELTYPE =162 2 3 4 5 6 7 TYPE ID SX SY SXY ANGLE Linear form for hyperelastic 3 node TRIA (strain) CHAR4 I RS RS RS RS 5-178 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 Name SMJ SMI Type RS RS Description Words 3 through 9 repeat 001 times ELTYPE =163 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 TYPE ID SX SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY BZ SZ SZX PC CX CY CZ Linear form for hyperelastic 20 node HEX CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Words 3 through 22 repeat 027 times NX Nastran DMAP Programmer’s Guide 5-179 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =164 2 3 4 5 6 7 8 9 TYPE ID SX SY SXY ANGLE SMJ SMI Hyperelastic quadrilateral 9-noded element (QUADFD) Linear? CHAR4 I RS RS RS RS RS RS Words 3 through 9 repeat 009 times ELTYPE =165 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TYPE ID SX SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY Hyperelastic 5-sided 15-noded solid element (PENTAFD) Linear? CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS 5-180 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 16 17 18 19 20 21 22 Name BZ SZ SZX PC CX CY CZ Type RS RS RS RS RS RS RS Description Words 3 through 22 repeat 021 times ELTYPE =166 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 TYPE ID SX SXY PA AX AY AZ PRESSURE SY SYZ PB BX BY BZ SZ SZX Linear form for hyperelastic 10 node TET CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS NX Nastran DMAP Programmer’s Guide 5-181 Chapter 5 Data Block Descriptions O-V Word 19 20 21 22 Name PC CX CY CZ Type RS RS RS RS Description Words 3 through 22 repeat 005 times ELTYPE =167 2 3 4 5 6 7 8 9 TYPE ID SX SY SXY ANGLE SMJ SMI Linear form for hyperelastic 6 node TRIA (plane strain) CHAR4 I RS RS RS RS RS RS Words 3 through 9 repeat 003 times ELTYPE =168 2 3 4 5 6 7 8 9 TYPE ID SX SY SXY ANGLE SMJ SMI Linear form for hyperelastic 3 node TRIA (axisymm) CHAR4 I RS RS RS RS RS RS Words 3 through 9 repeat 001 times ELTYPE =169 Linear form for hyperelastic 6 node TRIA (axisymm) 5-182 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 Name TYPE ID SX SY SXY ANGLE SMJ SMI Type CHAR4 I RS RS RS RS RS RS Description Words 3 through 9 repeat 003 times Word Name Type Description ELTYPE =170 2 3 4 5 6 7 8 9 TYPE ID SX SY SXY ANGLE SMJ SMI Linear form for hyperelastic 4 node QUAD (axisymm) CHAR4 I RS RS RS RS RS RS Words 3 through 9 repeat 004 times ELTYPE =171 2 3 4 5 6 TYPE ID SX SY SXY Linear form for hyperelastic 9 node QUAD (axisymm) CHAR4 I RS RS RS NX Nastran DMAP Programmer’s Guide 5-183 Chapter 5 Data Block Descriptions O-V Word 7 8 9 Name ANGLE SMJ SMI Type RS RS RS Description Words 3 through 9 repeat 009 times Word Name Type Description ELTYPE =189 SCODE,6 =0 2 3 4 5 6 TCODE,7 =0 7 8 10 11 12 13 16 17 18 19 20 21 VUID NONE(2) MSX MSY MXY NONE(3) BCX BCY BCXY TYZ TZX UNDEF(3 ) PARENT COORD ICORD THETA ITYPE Quadrilateral plate view element (VUQUAD) Strain I I CHAR4 I I Real I I RS RS RS RS RS RS RS RS RS None VU grid identification number for this corner Nothing Membrane stain x Membrane strain y Membrane strain xy Nothing Bending curvature x Bending curvature y Bending curvature xy Shear yz Shear zx Parent p-element identification number CID coordinate system identification number ICORD flat/curved and so on THETA angle ITYPE strcur =0, fiber=1 Words 7 through 23 repeat 004 times 5-184 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 7 8 10 11 12 13 16 17 18 19 20 21 22 23 24 25 28 29 30 31 32 33 Name Type Description Real / Imaginary VUID UNDEF(2 ) MSXR MSYR MXYR UNDEF(3 ) BCXR BCYR BCXYR TYZR TZXR UNDEF MSXI MSYI MXYI UNDEF(3 ) BCXI BCYI BCXYI TYZI TZXI UNDEF I None RS RS RS None RS RS RS RS RS None RS RS RS None RS RS RS RS RS None Bending curvature x IP Bending curvature y IP Bending curvature xy IP Shear yz IP Shear zx IP Membrane strain x IP Membrane strain y IP Membrane strain xy IP Bending curvature x RM Bending curvature y RM Bending curvature xy RM Shear yz RM Shear zx RM Membrane strain x RM Membrane strain y RM Membrane strain xy RM VU grid identification number this corner Words 7 through 33 repeat 004 times TCODE,7 =2 2 UNDEF Random Response None NX Nastran DMAP Programmer’s Guide 5-185 Chapter 5 Data Block Descriptions O-V Word Name Type Description End TCODE,7 SCODE,6 =01 2 3 4 5 6 TCODE,7 =0 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 VUID Z1 Z2 NX1 NY1 TXY1 ANGLE1 MJRP1 MNRP1 MAXSV1 NX2 NY2 TXY2 ANGLE2 MJRP2 MNRP2 MAXSV2 PARENT COORD ICORD THETA ITYPE Stress I I CHAR4 I I Real I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS VU grid identification number for this corner Z1 fiber distance Z2 fiber distance Normal x at Z1 Normal y at Z1 Shear xy at Z1 Shear Angle at Z1 or n/a Major principal at Z1 or n/a Minor principal at Z1 or n/a vonMises/Max.Shear at Z1 or n/a Normal x at Z2 Normal y at Z2 Shear xy at Z2 Shear Angle at Z2 or n/a Major principal at Z2 or n/a Minor principal at Z2 or n/a vonMises/Max.Shear at Z2 or n/a Parent p-element identification number CID coordinate system identification number ICORD flat/curved and so on THETA angle ITYPE strcur =0, fiber=1 Words 7 through 23 repeat 004 times 5-186 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word TCODE,7 =1 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Name Type Description Real / Imaginary VUID Z1 Z2 NX1R NX1I NY1R NY1I TXY1R TXY1I NZ1R NZ1I TYZ1R TYZ1I TZX1R TZX1I NX2R NX2I NY2R NY2I TXY2R TXY2I NZ1R NZ1I TYZ1R TYZ1I I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS VU grid identification number for this corner Z1 fiber distance Z2 fiber distance Normal x rm at Z1 Normal x ip at Z1 Normal y rm at Z1 Normal y ip at Z1 Shear xy rm at Z1 Shear xy ip at Z1 Normal z rm at Z1 or n/a Normal z ip at Z1 or n/a Shear yz rm at Z1 or n/a Shear yz ip at Z1 or n/a Shear zx rm at Z1 or n/a Shear zx ip at Z1 or n/a Normal x rm at Z2 Normal x ip at Z2 Normal y rm at Z2 Normal y ip at Z2 Shear xy rm at Z2 Shear xy ip at Z2 Normal z rm at Z1 or n/a Normal z ip at Z1 or n/a Shear yz rm at Z1 or n/a Shear yz ip at Z1 or n/a NX Nastran DMAP Programmer’s Guide 5-187 Chapter 5 Data Block Descriptions O-V Word 32 33 Name TZX1R TZX1I Type RS RS Description Shear zx rm at Z1 or n/a Shear zx ip at Z1 or n/a Words 7 through 33 repeat 004 times TCODE,7 =2 2 UNDEF Random Response None End TCODE,7 End SCODE,6 Word Name Type Description ELTYPE =190 SCODE,6 =0 2 3 4 5 6 TCODE,7 =0 7 8 10 11 12 13 16 17 18 19 VUID NONE(2) MSX MSY MXY NONE(3) BCX BCY BCXY TYZ PARENT COORD ICORD THETA ITYPE Triangular shell view element (VUTRIA) Strain I I CHAR4 I I Real I I RS RS RS RS RS RS RS RS VU grid identification number for this corner Nothing Membrane stain x Membrane strain y Membrane strain xy Nothing bending curvature x Bending curvature y Bending curvature xy Shear yz Parent p-element identification number CID coordinate system identification number ICORD flat/curved and so on THETA angle ITYPE strcur =0, fiber=1 5-188 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 20 21 Name TZX NONE(3) Type RS RS Description Shear zx Nothing Words 7 through 23 repeat 003 times TCODE,7 =1 7 8 10 11 12 13 16 17 18 19 20 21 22 23 24 25 28 29 30 31 32 33 VUID UNDEF(2 ) MSXR MSYR MXYR UNDEF(3 ) BCXR BCYR BCXYR TYZR TZXR UNDEF MSXI MSYI MXYI UNDEF(3 ) BCXI BCYI BCXYI TYZI TZXI UNDEF Real / Imaginary I None RS RS RS None RS RS RS RS RS None RS RS RS None RS RS RS RS RS None Bending curvature x IP Bending curvature y IP Bending curvature xy IP Shear yz IP Shear zx IP Membrane strain x IP Membrane strain y IP Membrane strain xy IP Bending curvature x RM Bending curvature y RM Bending curvature xy RM Shear yz RM Shear zx RM Membrane strain x RM Membrane strain y RM Membrane strain xy RM VU grid identification number this corner NX Nastran DMAP Programmer’s Guide 5-189 Chapter 5 Data Block Descriptions O-V Word Name Type Description Words 7 through 33 repeat 003 times TCODE,7 =2 2 UNDEF Random Response None End TCODE,7 SCODE,6 =01 2 3 4 5 6 TCODE,7 =0 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 VUID Z1 Z2 NX1 NY1 TXY1 ANGLE1 MJRP1 MNRP1 MAXSV1 NX2 NY2 TXY2 ANGLE2 MJRP2 PARENT COORD ICORD THETA ITYPE Stress I I CHAR4 I I Real I RS RS RS RS RS RS RS RS RS RS RS RS RS RS VU grid identification number for this corner Z1 fiber distance Z2 fiber distance Normal x at Z1 Normal y at Z1 Shear xy at Z1 Shear Angle at Z1 or n/a Major principal at Z1 or n/a Minor principal at Z1 or n/a vonMises/Max.Shear at Z1 or n/a Normal x at Z2 Normal y at Z2 Shear xy at Z2 Shear Angle at Z2 or n/a Major principal at Z2 or n/a Parent p-element identification number CID coordinate system identification number ICORD flat/curved and so on THETA angle ITYPE strcur =0, fiber=1 5-190 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 22 23 Name MNRP2 MAXSV2 Type RS RS Description Minor principal at Z2 or n/a vonMises/Max.Shear at Z2 or n/a Words 7 through 23 repeat 003 times TCODE,7 =1 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 VUID Z1 Z2 NX1R NX1I NY1R NY1I TXY1R TXY1I NZ1R NZ1I TYZ1R TYZ1I TZX1R TZX1I NX2R NX2I NY2R NY2I TXY2R TXY2I NZ1R Real / Imaginary I RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS VU grid identification number for this corner Z1 fiber distance Z2 fiber distance Normal x rm at Z1 Normal x ip at Z1 Normal y rm at Z1 Normal y ip at Z1 Shear xy rm at Z1 Shear xy ip at Z1 Normal z rm at Z1 or n/a Normal z ip at Z1 or n/a Shear yz rm at Z1 or n/a Shear yz ip at Z1 or n/a Shear zx rm at Z1 or n/a Shear zx ip at Z1 or n/a Normal x rm at Z2 Normal x ip at Z2 Normal y rm at Z2 Normal y ip at Z2 Shear xy rm at Z2 Shear xy ip at Z2 Normal z rm at Z1 or n/a NX Nastran DMAP Programmer’s Guide 5-191 Chapter 5 Data Block Descriptions O-V Word 29 30 31 32 33 Name NZ1I TYZ1R TYZ1I TZX1R TZX1I Type RS RS RS RS RS Description Normal z ip at Z1 or n/a Shear yz rm at Z1 or n/a Shear yz ip at Z1 or n/a Shear zx rm at Z1 or n/a Shear zx ip at Z1 or n/a Words 7 through 33 repeat 003 times TCODE,7 =2 2 UNDEF Random Response None End TCODE,7 End SCODE,6 ELTYPE =191 2 3 4 TCODE,7 =0 5 6 7 10 11 12 VUGRID POSIT POS(3) NX TXY TZX PARENT COORD ICORD Beam view element (VUBEAM) I I CHAR4 Real I RS RS RS RS RS VU grid ID for output grid x/L position of VU grid identification number Y, Z, W coordinate of output point Normal x Shear xy Shear zx Parent p-element identification number CID coordinate system identification number ICORD flat/curved and so on Words 7 through 12 repeat 4 times 13 14 MAXLONG MINLONG RS RS Max longitudinal Min longitudinal Words 5 through 14 repeat 2 times TCODE,7 =1 Real / Imaginary 5-192 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 10 11 12 13 14 15 Name VUGRID POSIT POS(3) NXR NXI TXYR TXYI TZXR TZXI Type I RS RS RS RS RS RS RS RS Description VU grid ID for output grid x/L position of VU grid identification number Y, Z, W coordinate of output point Normal x RM Normal x IP Shear xy RM Shear xy IP Shear zx RM Shear zx IP Words 7 through 15 repeat 4 times Words 5 through 15 repeat 2 times TCODE,7 =2 2 UNDEF Random Response None End TCODE,7 ELTYPE =192 2 UNDEF CVINT None QUADFR - EMAS None TRIAFR - EMAS None LINEFR - EMAS None LINXFR - EMAS None GMINTS None ELTYPE =193 2 UNDEF ELTYPE =194 2 UNDEF ELTYPE =195 2 UNDEF ELTYPE =196 2 UNDEF ELTYPE =197 2 UNDEF NX Nastran DMAP Programmer’s Guide 5-193 Chapter 5 Data Block Descriptions O-V Word Name Type CNVPEL None VUHBDY None Type CWELD None Description ELTYPE =198 2 UNDEF ELTYPE =199 2 Word UNDEF Name Description ELTYPE =200 2 UNDEF ELTYPE =201 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic quadrilateral 4-noded, nonlinear format (QUAD4FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 13 repeat 004 times ELTYPE =202 2 3 4 TYPE ID SX Hyperelastic hexahedron 8-noded, nonlinear format (HEXA8FD) CHAR4 I RS GAUS 5-194 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 14 15 16 17 Name SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Type RS RS RS RS RS RS RS RS RS RS RS RS RS Description Words 3 through 17 repeat 008 times ELTYPE =203 2 3 4 5 6 7 8 9 10 11 12 REGIONID MGRID1 MGRID2 SCOORD F S SIGMA TAU NGAP SLIP SLIPRAT Slideline contact (SLIF1D) I I I RS RS RS RS RS RS RS RS Contact region identification number Master grid 1 Master grid 2 Surface coordinate Normal force Shear force Normal stress Shear stress Normal gap Slip Slip ratio NX Nastran DMAP Programmer’s Guide 5-195 Chapter 5 Data Block Descriptions O-V Word 13 Name SLIPCODE(2) Type CHAR4 Description Slip code ELTYPE =204 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Hyperelastic pentahedron 6-noded, nonlinear format (PENTA6FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 17 repeat 006 times ELTYPE =205 2 3 4 5 6 TYPE ID SX SY SZ Hyperelastic tetrahedron 4-noded, nonlinear format (TETRA4FD) CHAR4 I RS RS RS GAUS 5-196 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 7 8 9 10 11 12 13 14 15 16 17 Name SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Type RS RS RS RS RS RS RS RS RS RS RS Description Words 3 through 17 repeat 001 times ELTYPE =206 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic triangular 3-noded, nonlinear format (TRIA3FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 13 repeat 001 times NX Nastran DMAP Programmer’s Guide 5-197 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =207 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Hyperelastic hexahedron 20-noded, nonlinear format (HEXAFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 17 repeat 027 times ELTYPE =208 2 3 4 5 6 7 TYPE ID SX SY SZ SXY Hyperelastic quadrilateral 8-noded, nonlinear format (QUADFD) CHAR4 I RS RS RS RS GAUS 5-198 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 12 13 Name PRESSURE VOLSTR EX EY EZ EXY Type RS RS RS RS RS RS Description Words 3 through 13 repeat 009 times ELTYPE =209 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Hyperelastic pentahedron 15-noded nonlinear format (PENTAFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 17 repeat 021 times NX Nastran DMAP Programmer’s Guide 5-199 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =210 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 17 repeat 005 times ELTYPE =211 2 3 4 5 6 7 8 TYPE ID SX SY SZ SXY PRESSURE Hyperelastic triangular 6-noded, nonlinear format (TRIAFD) CHAR4 I RS RS RS RS RS GRID 5-200 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 Name VOLSTR EX EY EZ EXY Type RS RS RS RS RS Description Words 3 through 13 repeat 003 times ELTYPE =212 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic axi. triangular 3-noded nonlinear format (TRIAX3FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 13 repeat 001 times ELTYPE =213 2 3 4 5 TYPE ID SX SY Hyperelastic axi. triangular 6-noded nonlinear format (TRIAXFD) CHAR4 I RS RS GAUS NX Nastran DMAP Programmer’s Guide 5-201 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 10 11 12 13 Name SZ SXY PRESSURE VOLSTR EX EY EZ EXY Type RS RS RS RS RS RS RS RS Description Words 3 through 13 repeat 003 times ELTYPE =214 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic axi. quadrilateral 4-noded nonlinear format(QUADX4FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GAUS Words 3 through 13 repeat 004 times ELTYPE =215 2 TYPE Hyperelastic axi. quadrilateral 8-noded nonlinear format (QUADXFD) CHAR4 GAUS 5-202 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 3 4 5 6 7 8 9 10 11 12 13 Name ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Type I RS RS RS RS RS RS RS RS RS RS Description Words 3 through 13 repeat 009 times ELTYPE =216 2 3 4 5 6 7 8 9 10 11 12 13 14 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ Hyperelastic tetrahedron 4-noded nonlinear format (TETRA4FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS GRID NX Nastran DMAP Programmer’s Guide 5-203 Chapter 5 Data Block Descriptions O-V Word 15 16 17 Name EXY EYZ EZX Type RS RS RS Description Words 3 through 17 repeat 004 times ELTYPE =217 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic triangular 3-noded nonlinear format (TRIA3FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 13 repeat 003 times ELTYPE =218 2 3 4 5 6 7 8 TYPE ID SX SY SZ SXY SYZ Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD) CHAR4 I RS RS RS RS RS GRID 5-204 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 12 13 14 15 16 17 Name SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Type RS RS RS RS RS RS RS RS RS Description Words 3 through 17 repeat 008 times ELTYPE =219 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic quadrilateral 8-noded nonlinear format (QUADFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 13 repeat 004 times NX Nastran DMAP Programmer’s Guide 5-205 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =220 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TYPE ID SX SY SZ SXY SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Hyperelastic pentahedron 15-noded nonlinear format (PENTAFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 17 repeat 006 times ELTYPE =221 2 3 4 5 6 7 TYPE ID SX SY SZ SXY Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD) CHAR4 I RS RS RS RS GRID 5-206 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 12 13 14 15 16 17 Name SYZ SZX PRESSURE VOLSTR EX EY EZ EXY EYZ EZX Type RS RS RS RS RS RS RS RS RS RS Description Words 3 through 17 repeat 004 times ELTYPE =222 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic axi. triangular 3-noded nonlinear format (TRIAX3FD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 13 repeat 003 times NX Nastran DMAP Programmer’s Guide 5-207 Chapter 5 Data Block Descriptions O-V Word Name Type Description ELTYPE =223 2 3 4 5 6 7 8 9 10 11 12 13 TYPE ID SX SY SZ SXY PRESSURE VOLSTR EX EY EZ EXY Hyperelastic axi. quadrilateral 8-noded nonlinear format (QUADXFD) CHAR4 I RS RS RS RS RS RS RS RS RS RS GRID Words 3 through 13 repeat 004 times ELTYPE =224 2 3 F S Nonlinear ELAS1 RS RS Force Stress ELTYPE =225 2 3 F S Nonlinear ELAS3 RS RS Force Stress ELTYPE =226 2 3 4 5 6 FX FY FZ STX STY Nonlinear BUSH RS RS RS RS RS Force X Force Y Force Z Stress Translational X Stress Translational Y 5-208 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 7 8 9 10 11 12 13 14 15 16 17 18 19 Name STZ ETX ETY ETZ MX MY MZ SRX SRY SRZ ERX ERY ERZ Type RS RS RS RS RS RS RS RS RS RS RS RS RS Description Stress Translational Z Strain Rotational X Strain Rotational Y Strain Rotational Z Moment X Moment Y Moment Z Stress Rotational X Stress Rotational Y Stress Rotational Z Strain Rotational X Strain Rotational Y Strain Rotational Z ELTYPE =227 SCODE,6 =0 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 FD1 EX1 EY1 EXY1 EA1 EMJRP1 EMNRP1 EMAX1 FD2 EX2 Triangular shell element (CTRIAR) Strain Real RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 NX Nastran DMAP Programmer’s Guide 5-209 Chapter 5 Data Block Descriptions O-V Word 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 TCODE,7 =2 2 3 4 5 Name EY2 EXY2 EA2 EMJRP2 EMNRP2 EMAX2 Type RS RS RS RS RS RS Description Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 EX1R EX1I EY1R EY1I EXY1R EXY1I FD2 EX2R EX2I EY2R EY2I EXY2R EXY2I RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 EX1 EY1 EXY1 RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 5-210 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 Name FD2 EX2 EY2 EXY2 Type RS RS RS RS Description Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 3 FD1 SX1R FD1 SX1 SY1 TXY1 SA1 SMJRP1 SMNRP1 SMAX1 FD2 SX2 SY2 TXY2 SA2 SMJRP2 SMNRP2 TMAX2 Stress Real RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary RS RS Z1 = Fibre Distance Normal in x at Z1 NX Nastran DMAP Programmer’s Guide 5-211 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 8 9 10 11 12 13 14 15 TCODE,7 =2 2 3 4 5 6 7 8 9 Name SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R TXY2I Type RS RS RS RS RS RS RS RS RS RS RS RS Description Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 SX1 SY1 TXY1 FD2 SX2 SY2 TXY2 RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 End SCODE,6 ELTYPE =228 SCODE,6 =0 TCODE,7 =0 Quadrilateral plate element (CQUADR) Strain Real 5-212 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 8 9 10 Name FD1 EX1 EY1 EXY1 EA1 EMJRP1 EMNRP1 EMAX1 FD2 EX2 EY2 EXY2 EA2 EMJRP2 EMNRP2 EMAX2 Type RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS RS Description Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 EX1R EX1I EY1R EY1I EXY1R EXY1I FD2 EX2R RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 NX Nastran DMAP Programmer’s Guide 5-213 Chapter 5 Data Block Descriptions O-V Word 11 12 13 14 15 TCODE,7 =2 2 3 4 5 6 7 8 9 Name EX2I EY2R EY2I EXY2R EXY2I Type RS RS RS RS RS Description Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Shear in xy at Z2 Random Response FD1 EX1 EY1 EXY1 FD2 EX2 EY2 EXY2 RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 SCODE,6 =01 TCODE,7 =0 2 3 4 5 6 7 8 9 10 FD1 SX1 SY1 TXY1 SA1 SMJRP1 SMNRP1 SMAX1 FD2 Stress Real RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 Theta ( Shear Angle ) at Z1 Major Principal at Z1 Minor Principal at Z1 Maximum Shear at Z1 Z2 = Fibre Distance 5-214 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 11 12 13 14 15 16 17 TCODE,7 =1 2 3 4 5 6 7 8 9 10 11 12 13 14 TCODE,7 =2 2 3 4 5 Name SX2 SY2 TXY2 SA2 SMJRP2 SMNRP2 SMAX2 Type RS RS RS RS RS RS RS Description Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 Theta (Shear Angle) at Z2 Major Principal at Z2 Minor Principal at Z2 Maximum Shear at Z2 Real / Imaginary FD1 SX1R SX1I SY1R SY1I TXY1R TXY1I FD2 SX2R SX2I SY2R SY2I TXY2R RS RS RS RS RS RS RS RS RS RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in x at Z1 Normal in y at Z1 Normal in y at Z1 Shear in xy at Z1 Shear in xy at Z1 Z2 = Fibre Distance Normal in x at Z2 Normal in x at Z2 Normal in y at Z2 Normal in y at Z2 Shear in xy at Z2 Random Response FD1 SX1 SY1 TXY1 RS RS RS RS Z1 = Fibre Distance Normal in x at Z1 Normal in y at Z1 Shear in xy at Z1 NX Nastran DMAP Programmer’s Guide 5-215 Chapter 5 Data Block Descriptions O-V Word 6 7 8 9 Name FD2 SX2 SY2 TXY2 Type RS RS RS RS Description Z2 = Fibre Distance Normal in x at Z2 Normal in y at Z2 Shear in xy at Z2 End TCODE,7 End SCODE,6 Word Name Type Description ELTYPE =232 SCODE,6 =0 2 3 4 5 6 7 8 9 10 11 PLY EX1 EY1 ET1 EL1 EL2 A1 EMJRP1 EMNRP1 ETMAX1 QUADR composite Strain I RS RS RS RS RS RS RS RS RS Stress I RS RS RS RS RS Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 PLY SX1 SY1 T1 SL1 SL2 5-216 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 Name A1 MJRP1 MNRP1 TMAX1 Type RS RS RS RS Description Shear angle Major Principal Minor Principal von Mises or Maximum shear End SCODE,6 ELTYPE =233 SCODE,6 =0 2 3 4 5 6 7 8 9 10 11 PLY EX1 EY1 ET1 EL1 EL2 A1 EMJRP1 EMNRP1 ETMAX1 TRIAR composite (Same as TRIAR composite) Strain I RS RS RS RS RS RS RS RS RS Stress I RS RS RS RS RS RS RS Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Lamina Number Normal-1 Normal-2 Shear-12 Shear-1Z Shear-2Z Shear angle Major Principal Minor Principal von Mises or Maximum shear SCODE,6 =01 2 3 4 5 6 7 8 9 PLY SX1 SY1 T1 SL1 SL2 A1 MJRP1 NX Nastran DMAP Programmer’s Guide 5-217 Chapter 5 Data Block Descriptions O-V Word 10 11 Name MNRP1 TMAX1 Type RS RS Description Minor Principal von Mises or Maximum shear End SCODE,6 End ELTYPE Record 3 - TRAILER Word 1 Name UNDEF(6 ) Type None Description 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). 5.8 OGF Table of grid point forces Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Block Name Record 1 - IDENT Word 1 2 Name ACODE(C) TCODE(C) Type I I Description Device code + 10*Approach code Table code; always 19 5-218 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 3 4 ACODE,4=0 5 Name UNDEF SUBCASE Type None I Description Subcase identification number UNDEF None Statics None Not defined ACODE,4=01 5 UNDEF See word 8 ACODE,4=02 5 MODE Real Eigenvalues I Mode Number ACODE,4=03 5 UNDEF Differential Stiffness 0 None See word 8 ACODE,4=04 5 UNDEF Differential Stiffness 1 None Frequency RS Transient RS Time step Frequency See word 8 ACODE,4=05 5 FREQ ACODE,4=06 5 TIME ACODE,4=07 5 UNDEF Buckling 0 (Pre-buckling) None See word 8 ACODE,4=08 5 MODE Buckling 1 (Post-buckling) I Mode number ACODE,4=09 5 MODE Complex Eigenvalues I Mode number ACODE,4=10 5 LOADFAC Nonlinear Statics (Sol 106) RS Load factor ACODE,4=11 5 UNDEF Geometric Nonlinear Statics None See word 8 NX Nastran DMAP Programmer’s Guide 5-219 Chapter 5 Data Block Descriptions O-V Word Name Type CONTRAN RS Description ACODE,4=12 5 TIME Time step End ACODE,4 6 8 9 10 11 13 14 15 16 17 51 83 115 UNDEF(2) LOADSET FCODE NUMWDE(C) UNDEF(2) SETID EIGENR EIGENI FREQ UNDEF(34) TITLE(32) SUBTITL(32) LABEL(32) None I I I None I RS RS RS None CHAR4 CHAR4 CHAR4 Title Subtitle Label Set identification number Natural eigenvalue – real part Natural eigenvalue – imaginary part Natural frequency Load set or zero Format Code Number of words per entry in DATA record Record 2 - DATA Word TCODE,1 =1 1 EKEY Name Type Sort 1 I Device code + 10* Point identification number Description TCODE,1 =02 ACODE,4 =0 1 UNDEF Sort 2 - Swap with word 5 of IDENT None Not defined ACODE,4 =01 1 EKEY I Device code + 10* Point identification number ACODE,4 =02 5-220 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 Name EKEY Type I Description Device code + 10* Point identification number ACODE,4 =03 1 EKEY I Device code + 10* Point identification number ACODE,4 =04 1 EKEY I Device code + 10* Point identification number ACODE,4 =05 1 FREQ RS Frequency ACODE,4 =06 1 TIME RS Time step ACODE,4 =07 1 EKEY I Device code + 10* Point identification number ACODE,4 =08 1 EKEY I Device code + 10* Point identification number ACODE,4 =09 1 EKEY I Device code + 10* Point identification number ACODE,4 =10 1 FQTS RS Frequency or Time step ACODE,4 =11 1 EKEY I Device code + 10* Point identification number ACODE,4 =12 1 EKEY I Device code + 10* Point ID End ACODE,4 End TCODE,1 2 3 EID ELNAME(2) I CHAR4 real Element identification number if element force; otherwise zero NUMWDE =10 NX Nastran DMAP Programmer’s Guide 5-221 Chapter 5 Data Block Descriptions O-V Word 5 6 7 8 9 10 Name F1 F2 F3 M1 M2 M3 Type RS RS RS RS RS RS complex RS RS RS RS RS RS RS RS RS RS RS RS Description Force in displacement coordinate system direction 1 Force in displacement coordinate system direction 2 Force in displacement coordinate system direction 3 Moment in displacement coordinate system direction 1 Moment in displacement coordinate system direction 2 Moment in displacement coordinate system direction 3 NUMWDE =16 5 6 7 8 9 10 11 12 13 14 15 16 F1R F2R F3R M1R M2R M3R F1I F2I F3I M1I M2I M3I End NUMWDE Record 3 - TRAILER Word 1 Name WORD1 Type I Description Number of output line entries 5-222 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 2 Name UNDEF(5 ) Type None Description Notes: 1. Records repeat for each subcase having any output requests. 2. Device code: 1 = print 2 = plot 4 = punch 5 = print, and punch, and so on 3. Approach code: 1 = statics 2 = reigen 3 = ds0 4 = ds1 5 = freq 6 = bkl0 7 = bkl1 8 = ceigen 9 = pla 5.9 OGK Output gasket element results For SOL 601,106 and SOL 601,129. Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data Block Name, for example, OGK1 Record 1 - IDENT Word 1 Name ACODE Type I Description Device code + 10*Approach code NX Nastran DMAP Programmer’s Guide 5-223 Chapter 5 Data Block Descriptions O-V Word 2 3 Name TCODE ELTYPE Type I I Description Table code; 61 Element Type (for example, linear hexa=67, linear penta=68, nonlinear penta=91, hexa=93, ....) 4 5 6-7 8 9 10 11 12 11-50 51 83 115 SUBCASE TIME UNDEF LOADSET FCODE NUMWDE UNDEF PID UNDEF TITLE(32) SUBTITL(32) LABEL(32) I RS None I I I None I None CHAR4 CHAR4 CHAR4 Title Subtitle Label Physical Property ID Load Set or Zero 1 Number of words per entry in DATA record Time Step Record 2 - DATA Word 1 2 3 4 5 6 Name EKEY GP GC GPC YS GS Type I RS RS RS RS I Description Device code + 10* Element identification number Gasket pressure Gasket closure Gasket plastic closure Gasket yield stress Gasket status Repeat word 1-6 for each element. 5-224 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Notes: Gasket element results are elemental based results. 5.10 OGS Table of grid point stresses/strains or discontinuities SORT1, SORT2, and real formats only. Record 0 - HEADER Word 1 3 Name NAME(2) WORD Type CHAR4 I Description Data block name Month, day, year, 0, 1 Word 3 repeats until End of Record Record 1 - IDENT Word 1 2 3 4 ACODE =01 5 6 ACODE =02 5 6 ACODE =06 5 6 ACODE =10 TIME UNDEF MODE EIGN LSDVMN UNDEF Name ACODE(C) TCODE(C) ID SUBCASE Type I I I I Statics I None Real Eigenvalues I RS Transient RS None Nonlinear Statics Time Step Mode Number Eigenvalue Load set number Description Device code + 10*Approach code Table type code Surface or volume identification number Subcase or mode identification number NX Nastran DMAP Programmer’s Guide 5-225 Chapter 5 Data Block Descriptions O-V Word 5 6 End ACODE 7 8 9 10 11 12 13 14 15 51 83 115 Name LOADSTEP UNDEF Type RS None Description Load Step UNDEF REFID FCODE NUMWDE SCODE OCOORD AXIS NORMAL UNDEF(36 ) TITLE(32) SUBTITL(32) LABEL(32) None I I I I I I I None CHAR4 CHAR4 CHAR4 Title Subtitle Label Reference coordinate system identification number Format code Number of words per entry in DATA record Stress/Strain code Output coordinate system code Axis specification code Normal Specification code Record 2 – DATA Word TCODE =26 1 2 3 4 5 6 7 EKEY ID FIBRE NX NY TXY A Name Type Surface I I CHAR4 RS RS RS RS 10*Grid point identification number + Device code Element identification number Fibre Normal in x Normal in y Shear in xy Angle Description 5-226 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 TCODE =27 1 2 3 4 5 6 7 8 9 TCODE =28 1 2 3 4 5 6 7 8 9 10 Name MJRP MNRP TMAX HVM Type RS RS RS RS Description Major principal Minor principal Maximum shear Hency-von Mises Volume with direct EKEY NX NY NZ TXY TYZ TZX PR HVM I RS RS RS RS RS RS RS RS 10*Grid point identification number + Device Code Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Mean pressure Hencky-von Mises or Octahedral Volume with principal EKEY LXA LXB LXC LYA LYB LYC LZA LZB LZC I RS RS RS RS RS RS RS RS RS 10*Grid point identification number + Device code Direction cosine from x to a Direction cosine from x to b Direction cosine from x to c Direction cosine from y to a Direction cosine from y to b Direction cosine from y to c Direction cosine from z to a Direction cosine from z to b Direction cosine from z to c NX Nastran DMAP Programmer’s Guide 5-227 Chapter 5 Data Block Descriptions O-V Word 11 12 13 14 15 TCODE =29 1 2 4 5 6 7 8 9 10 11 12 Word TCODE =30 1 2 4 5 6 7 Name SA SB SC EPR EHVM Type RS RS RS RS RS Description Principal in a Principal in b Principal in c Mean pressure Hencky-von Mises or Octahedral Element discontinuities for surface EKEY ELTYPE(2) FIBRE NX NY TXY MJPR MNPR TMAX HVM ERR Name I CHAR4 CHAR4 RS RS RS RS RS RS RS RS Type 10*Grid point identification number + Device code Element type Fibre Normal in x Normal in y Shear in xy Major principal Minor principal Maximum shear Hencky-von Mises Error estimate Description Element discontinuities for volumes with direct EKEY ELTYPE(2) NX NY NZ SXY I CHAR4 RS RS RS RS 10*Element identification number + Device code Element type Normal in x Normal in y Normal in z Shear in xy 5-228 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 8 9 10 11 12 TCODE =31 1 2 4 5 6 7 8 9 TCODE =32 1 2 3 4 5 6 7 8 9 10 Name SYZ SZX PR HVM ERR Type RS RS RS RS RS Description Shear in yz Shear in zx Mean pressure Hencky-von Mises Error estimate Element discontinuities for volumes with principal EKEY ELTYPE(2) SA SB SC MP HVM ERR I CHAR4 RS RS RS RS RS RS 10*Element identification number + Device code Element type Principal in a Principal in b Principal in c Mean pressure Hencky-von Mises or Octahedral Error estimate Grid point discontinuities for surface EKEY FIBRE NX NY NXY MJPR MNPR TMAX HVM ERR I CHAR4 RS RS RS RS RS RS RS RS 10*Grid point identification number + Device code Fibre Normal in x Normal in y Shear in xy Major principal Minor principal Maximum shear Hencky-von Mises Error estimate NX Nastran DMAP Programmer’s Guide 5-229 Chapter 5 Data Block Descriptions O-V Word TCODE =33 1 2 3 4 5 6 7 8 9 10 TCODE =34 1 2 3 4 5 6 7 TCODE =35 1 2 3 4 5 Name Type Description Grid point discontinuities for volumes with direct EKEY NX NY NZ TXY TYZ TZX PR HVM ERR I RS RS RS RS RS RS RS RS RS 10*Grid point identification number + Device Code Normal in x Normal in y Normal in z Shear in xy Shear in yz Shear in zx Mean pressure Hencky-von Mises or Octahedral Error estimate Grid point discontinuities for volumes with principal EKEY SA SB SC PR HVM ERR I RS RS RS RS RS RS 10*Grid point identification number + Device Code Principal in a Principal in b Principal in c Mean pressure Hencky-von Mises or Octahedral Error estimate Grid point stresses for surfaces with plane strain EKEY NX NY NZ TXY I RS RS RS RS 10*Grid point identification number and Grid Code Normal in x Normal in y Normal in z (always -1) Shear in xy 5-230 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 Name PR Type RS Description Mean pressure (always -1) End TCODE,2 End TABLE Record 3 – TRAILER Word 1 Name UNDEF(6 ) Type None Description Notes: 1. Records repeat for each surface or volume. 2. Record 2 is the same format for stress (SCODE=0) or strain (SCODE=1). 3. Format Code ’1’ implies real. 4. Output coordinate system code 1 = Surface or CID for 3D 2 = Element 3 = Basic (3D only) 5. Axis specification code (for surfaces only) 1 = X Axis 2 = Y Axis 3 = Z Axis 6. Normal Specification code (for surfaces only ) 1 = Radius vector 2 = X Axis 3 = Y Axis 4 = Z Axis 5 = –X Axis 6 = –Y Axis 7 = –Z Axis 8 = –Radius vector NX Nastran DMAP Programmer’s Guide 5-231 Chapter 5 Data Block Descriptions O-V 5.11 OMECON Table of constant total modal energies. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name Record 1 - IDENT Word 1 2 3 4 5 6 9 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) FORM Type I I None I I/RS None I Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 51 83 115 NUMWDE(C) UNDEF(40) TITLE(32) SUBTITL(32) LABEL(32) I None CHAR4 CHAR4 CHAR4 Title Subtitle Label Length of entries in RECORD=DATA Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code 5-232 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 2 - DATA Word Name Type Sort 1 RS I RS RS Sort 2 I I RS RS Device code + 10*mode number Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Description TCODE=1042 1 2 3 4 FREQ TYPE REAL or MAG IMAG or PHASE TCODE=3042 1 2 3 4 EKEY TYPE REAL or MAG IMAG or PHASE Record 3 - TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of output line entries Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: 1 = print 4 = punch 5 = print and punch 4. Approach code: 5= freq NX Nastran DMAP Programmer’s Guide 5-233 Chapter 5 Data Block Descriptions O-V 5. Table code: 1042 = SORT1 complex 3042 = SORT2 complex Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.12 OMEOSC Table of oscillating total modal energies. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name Record 1 - IDENT Word 1 2 3 4 5 6 9 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) FORM Type I I None I I/RS None I Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 NUMWDE(C) UNDEF(40) I None Length of entries in RECORD=DATA Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code 5-234 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 51 83 115 Name TITLE(32) SUBTITL(32) LABEL(32) Type CHAR4 CHAR4 CHAR4 Description Title Subtitle Label Record 2 - DATA Word Name Type Sort 1 RS I RS RS Sort 2 I I RS RS Device code + 10*mode number Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Description TCODE=1043 1 2 3 4 FREQ TYPE REAL or MAG IMAG or PHASE TCODE=3043 1 2 3 4 EKEY TYPE REAL or MAG IMAG or PHASE Record 3 - TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of output line entries Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: NX Nastran DMAP Programmer’s Guide 5-235 Chapter 5 Data Block Descriptions O-V 1 = print 4 = punch 5 = print and punch 4. Approach code: 5= freq 5. Table code: 1043 = SORT1 complex 3043 = SORT2 complex Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.13 OMKEC Table of constant modal kinetic energies. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name Record 1 - IDENT Word 1 2 3 4 5 6 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) Type I I None I I/RS None Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code 5-236 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 Name FORM Type I Description Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 51 83 115 NUMWDE(C) UNDEF(40) TITLE(32) SUBTITL(32) LABEL(32) I None CHAR4 CHAR4 CHAR4 Length of entries in RECORD=DATA Title Subtitle Label Record 2 - DATA Word Name Type Sort 1 RS I RS RS Sort 2 I I RS RS Device code + 10*mode number Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Description TCODE=1040 1 2 3 4 FREQ TYPE REAL or MAG IMAG or PHASE TCODE=3040 1 2 3 4 EKEY TYPE REAL or MAG IMAG or PHASE Record 3 - TRAILER Word 1 Name WORD1 Type I Description Number of output line entries NX Nastran DMAP Programmer’s Guide 5-237 Chapter 5 Data Block Descriptions O-V Word 2 Name UNDEF(5 ) Type None Description Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: 1 = print 4 = punch 5 = print and punch 4. Approach code: 5= freq 5. Table code: 1040 = SORT1 complex 3040 = SORT2 complex Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.14 OMKEO Table of oscillating modal kinetic energies. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name 5-238 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 1 - IDENT Word 1 2 3 4 5 6 9 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) FORM Type I I None I I/RS None I Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 51 83 115 NUMWDE(C) UNDEF(40) TITLE(32) SUBTITL(32) LABEL(32) I None CHAR4 CHAR4 CHAR4 Title Subtitle Label Length of entries in RECORD=DATA Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code Record 2 - DATA Word Name Type Sort 1 RS I RS RS Sort 2 I Device code + 10*mode number Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Description TCODE=1041 1 2 3 4 FREQ TYPE REAL or MAG IMAG or PHASE TCODE=3041 1 EKEY NX Nastran DMAP Programmer’s Guide 5-239 Chapter 5 Data Block Descriptions O-V Word 2 3 4 Name TYPE REAL or MAG IMAG or PHASE Type I RS RS Description Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Record 3 - TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of output line entries Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: 1 = print 4 = punch 5 = print and punch 4. Approach code: 5= freq 5. Table code: 1041 = SORT1 complex 3041 = SORT2 complex Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.15 OMSEC Table of constant modal strain energies. 5-240 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name Record 1 - IDENT Word 1 2 3 4 5 6 9 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) FORM Type I I None I I/RS None I Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 51 83 115 NUMWDE(C) UNDEF(40) TITLE(32) SUBTITL(32) LABEL(32) I None CHAR4 CHAR4 CHAR4 Title Subtitle Label Length of entries in RECORD=DATA Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code Record 2 - DATA Word Name Type Sort 1 Description TCODE=1038 NX Nastran DMAP Programmer’s Guide 5-241 Chapter 5 Data Block Descriptions O-V Word 1 2 3 4 Name FREQ TYPE REAL or MAG IMAG or PHASE Type RS I RS RS Sort 2 I I RS RS Description Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) TCODE=3038 1 2 3 4 EKEY TYPE REAL or MAG IMAG or PHASE Device code + 10*mode number Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Record 3 - TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of output line entries Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: 1 = print 4 = punch 5 = print and punch 4. Approach code: 5= freq 5. Table code: 1038 = SORT1 complex 3038 = SORT2 complex 5-242 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V 6. Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.16 OMSEO Table of oscillating modal strain energies. Record 0 - HEADER Word 1 3 4 5 6 Name NAME(2) MONTH DAY YEAR UNDEF(2) Type CHAR4 I I I None Description Block Name Record 1 - IDENT Word 1 2 3 4 5 6 9 Name ACODE(C) TCODE(C) UNDEF SUBCASE MODE/FREQ UNDEF(3) FORM Type I I None I I/RS None I Form of data: =1 For real/imaginary =3 For magnitude/phase 10 11 51 83 NUMWDE(C) UNDEF(40) TITLE(32) SUBTITL(32) I None CHAR4 CHAR4 Title Subtitle Length of entries in RECORD=DATA Subcase identification number Device code + 10*Mode number (SORT1) / Frequency in Hz (SORT2) Description Device code + 10*Approach code Table code NX Nastran DMAP Programmer’s Guide 5-243 Chapter 5 Data Block Descriptions O-V Word 115 Name LABEL(32) Type CHAR4 Description Label Record 2 - DATA Word Name Type Sort 1 RS I RS RS Sort 2 I I RS RS Device code + 10*mode number Always 4 for ‘modal’ Real part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Frequency in Hz. Always 4 for ‘modal’. Real part of energy value (FORM=1) or magnitude of energy value (FORM=3) Imaginary part of energy value (FORM=1) or phase (degrees) of energy value (FORM=3) Description TCODE=1039 1 2 3 4 FREQ TYPE REAL or MAG IMAG or PHASE TCODE=3039 1 2 3 4 EKEY TYPE REAL or MAG IMAG or PHASE Record 3 - TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of output line entries Notes: 1. Four words of data in record 2 repeats for each mode (SORT2) or each frequency (SORT1). 2. Records 1 and 2 repeat for each frequency (SORT2) or each mode (SORT1). 3. Device code: 1 = print 4 = punch 5-244 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V 5 = print and punch 4. Approach code: 5= freq 5. Table code: 1039 = SORT1 complex 3039 = SORT2 complex 6. Mode number = 0 implies summation results (summation of all modal energy values for a frequency) 5.17 OPG Table of applied loads For all analysis types (real and complex), and SORT1 and SORT2 formats. Record 0 – HEADER Word 1 3 Name NAME(2) WORD Type CHAR4 I Description Data block name No Def or Month, Year, One, One Word 3 repeats until End of Record Record 1 – IDENT Word 1 2 3 4 TCODE =1 ACODE =01 5 6 ACODE =02 LSDVMN UNDEF(2 ) Name ACODE(C) TCODE(C) UNDEF SUBCASE Type I I None I Sort 1 Statics I None Real Eigenvalues Load set number Subcase or Random identification number Description Device code + 10*Approach Code Table Code NX Nastran DMAP Programmer’s Guide 5-245 Chapter 5 Data Block Descriptions O-V Word 5 6 7 ACODE =03 5 6 ACODE =04 5 6 ACODE =05 5 6 ACODE =06 5 6 ACODE =07 5 6 ACODE =08 5 6 7 ACODE =09 5 6 7 Name MODE EIGN MODECYCL Type I RS F1 Description Mode Number Eigenvalue Mode or Cycle Differential Stiffness LSDVMN UNDEF(2 ) I None Differential Stiffness LSDVMN UNDEF(2 ) I None Frequency FREQ UNDEF(2 ) RS None Transient TIME UNDEF(2 ) RS None Buckling Phase 0 (Pre-buckling) LSDVMN UNDEF(2 ) I None Buckling Phase 1 (Post-buckling) LSDVMN EIGR UNDEF I RS None Complex Eigenvalues MODE EIGR EIGI I RS RS Mode Eigenvalue (real) Eigenvalue (imaginary) Mode Number Eigenvalue Load set Time Step Frequency Load set number Load set number 5-246 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word ACODE =10 5 6 ACODE =11 5 6 ACODE =12 5 6 Name Type Description Nonlinear statics LFTSFQ UNDEF(2 ) RS None Old geometric nonlinear statics LSDVMN UNDEF(2 ) I None CONTRAN ? (Can appear as ACODE=6) TIME UNDEF(2 ) RS None Time Load set Load step End ACODE TCODE =02 5 6 LSDVMN UNDEF(2 ) Sort 2 I None Load set, Mode Number End TCODE 8 9 10 11 23 24 51 83 115 RCODE FCODE(C) NUMWDE UNDEF(12 ) THERMAL UNDEF(27 ) TITLE(32) SUBTITL(32) LABEL(32) I I I None I None CHAR4 CHAR4 CHAR4 Title Subtitle Label 1 for heat transfer and 0 otherwise Random code ID number. Format Code Number of words per entry in DATA record Record 2 – DATA Word TCODE =1 Name Type Sort 1 Description NX Nastran DMAP Programmer’s Guide 5-247 Chapter 5 Data Block Descriptions O-V Word 1 TCODE =02 ACODE =01 1 ACODE =02 1 ACODE =03 1 ACODE =04 1 ACODE =05 1 ACODE =06 1 ACODE =07 1 ACODE =08 1 ACODE =09 1 ACODE =10 1 ACODE =11 1 ACODE =12 1 Name EKEY Type I Description Device code + 10* Point identification number Sort 2 - Swap with word 5 of IDENT EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number FREQ RS Frequency TIME RS Time step EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number FQTS RS Frequency or Time step EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number 5-248 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word End ACODE End TCODE 2 Name Type Description TYPE I Point type: G for grid and S for scalar FCODE =0 or 2 3 4 5 6 7 8 FCODE =1 3 4 5 6 7 8 9 10 11 12 13 14 End FCODE F1R F2R F3R M1R M2R M3R F1I F2I F3I M1I M2I M3I F1 F2 F3 M1 M2 M3 Real or Random Response RS RS RS RS RS RS Real/Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Applied force in direction 1 – Real Applied force in direction 2 – Real Applied force in direction 3 – Real Applied moment in direction 1 – Real Applied moment in direction 2 – Real Applied moment in direction 3 – Real Applied force in direction 1 – Imaginary Applied force in direction 2 – Imaginary Applied force in direction 3 – Imaginary Applied moment in direction 1 – Imaginary Applied moment in direction 2 – Imaginary Applied moment in direction 3 – Imaginary Applied force in direction 1 Applied force in direction 2 Applied force in direction 3 Applied moment in direction 1 Applied moment in direction 2 Applied moment in direction 3 NX Nastran DMAP Programmer’s Guide 5-249 Chapter 5 Data Block Descriptions O-V Record 3 – TRAILER Word 1 Name UNDEF(6 ) Type None Description 5.18 OPTPRM Table of optimization parameters Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1- PARAMS Word 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Name APRCOD IPRINT DESMAX METHOD DELP DPMIN PTOL CONV1 CONV2 GMAX DELX DLXMIN DELB GSCAL CONVDV Type I I I I RS RS RS RS RS RS RS RS RS RS RS Description Approach code Print parameter Maximum design cycles Optimization method Allowed property change Minimum DELP Property tolerance Relative objective convergence criterion Absolute objective convergence criterion Maximum allowed constraint violation Allowed design variable change Minimum DELX Finite difference step Constraint scale factor Relative design variable convergence criterion 5-250 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 Name CONVPR P1 P2 CT CTMIN DABOBJ DELOBJ DOBJ1 DOBJ2 DX1 DX2 ISCAL ITMAX ITRMOP IWRITE IGMAX JTMAX ITRMST JPRINT IPRNT1 IPRNT2 JWRITE STPSCL Type RS I I RS RS RS RS RS RS RS RS I I I I I I I I I I I RS Description Absolute design variable convergence criterion DOM print parameter DOM print parameter Active constraint threshold Violated constraint threshold DOT absolute objective convergence criterion DOT relative objective convergence criterion 1D search absolute objective limit 1D search relative objective limit 1D search absolute DV limit 1D search relative DV limit Scaling flag Maximum DOT MFD iterations DOT convergence MFD criterion File for optimizer print Active constraint counter Maximum DOT SLP iterations DOT convergence SLP criterion SLP print code Scale factor print 1D search print File for iteration history print Scale factor for shape step size Record 2- TRAILER Word 1 Name UNDEF(6 ) Type None Description NX Nastran DMAP Programmer’s Guide 5-251 Chapter 5 Data Block Descriptions O-V 5.19 OQG Table of single or multipoint constraint forces. Also contact force results from SOL 101, SOL 601,106, SOL 601,129 and SOL 701. For all analysis types (real and complex), and SORT1 and SORT2 formats. Contact force results are real only. Record 0 – HEADER Word 1 3 Name NAME(2) WORD Type CHAR4 I Description Data block name No Def or Month, Year, One, One Word 3 repeats until End of Record Record 1 – IDENT Word 1 2 3 4 TCODE =1 ACODE =01 5 6 ACODE =02 5 6 7 ACODE =03 5 6 ACODE =04 LSDVMN UNDEF(2 ) MODE EIGN MODECYCL LSDVMN UNDEF(2 ) Name ACODE(C) TCODE(C) UNDEF SUBCASE Type I I None I Sort 1 Statics I None Real Eigenvalues I RS F1 Mode Number Eigenvalue Mode or Cycle Load set number Subcase or Random identification number Description Device code + 10*Approach Code Table Code Differential Stiffness I None Differential Stiffness Load set number 5-252 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 ACODE =05 5 6 ACODE =06 5 6 ACODE =07 5 6 ACODE =08 5 6 7 ACODE =09 5 6 7 ACODE =10 5 6 ACODE =11 5 6 ACODE =12 Name LSDVMN UNDEF(2 ) Type I None Frequency Description Load set number FREQ UNDEF(2 ) RS None Transient Frequency TIME UNDEF(2 ) RS None Time Step Buckling Phase 0 (Pre-buckling) LSDVMN UNDEF(2 ) I None Buckling Phase 1 (Post-buckling) LSDVMN EIGR UNDEF I RS None Complex Eigenvalues MODE EIGR EIGI I RS RS Mode Eigenvalue (real) Eigenvalue (imaginary) Mode Number Eigenvalue Load set Nonlinear statics LFTSFQ UNDEF(2 ) RS None Old geometric nonlinear statics LSDVMN UNDEF(2 ) I None CONTRAN (Can appear as ACODE=6) Load set Load step or time step NX Nastran DMAP Programmer’s Guide 5-253 Chapter 5 Data Block Descriptions O-V Word 5 6 Name TIME UNDEF(2 ) Type RS None Description Time End ACODE TCODE =02 5 6 LSDVMN UNDEF(2 ) Sort 2 I None Load set, Mode Number End TCODE 8 9 10 11 12 23 24 51 83 115 RCODE FCODE(C) NUMWDE MPCFORCE UNDEF(11 ) THERMAL UNDEF(27 ) TITLE(32) SUBTITL(32) LABEL(32) I I I I None I None CHAR4 CHAR4 CHAR4 Title Subtitle Label =1 for heat transfer and 0 otherwise Random code ID number Format Code Number of words per entry in DATA record 1 for MPCforce output and 0 for SPCforce output Record 2 - DATA Word TCODE =1 1 TCODE =02 ACODE =01 1 ACODE =02 EKEY I Device code + 10* Point identification number EKEY Name Type Sort 1 I Device code + 10* Point identification number Description Sort 2 - Swap with word 5 of IDENT 5-254 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 ACODE =03 1 ACODE =04 1 ACODE =05 1 ACODE =06 1 ACODE =07 1 ACODE =08 1 ACODE =09 1 ACODE =10 1 ACODE =11 1 ACODE =12 1 End ACODE End TCODE 2 Name EKEY Type I Description Device code + 10* Point identification number EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number FREQ RS Frequency TIME RS Time step EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number FQTS RS Frequency or Time step EKEY I Device code + 10* Point identification number EKEY I Device code + 10* Point identification number TYPE I Point type: G for grid and S for scalar FCODE =0 or 2 3 QF1 Real or Random Response RS Constraint force in direction 1 NX Nastran DMAP Programmer’s Guide 5-255 Chapter 5 Data Block Descriptions O-V Word 4 5 6 7 8 FCODE =1 3 4 5 6 7 8 9 10 11 12 13 14 End FCODE Name QF2 QF3 QM1 QM2 QM3 Type RS RS RS RS RS Real/Imaginary Description Constraint force in direction 2 Constraint force in direction 3 Constraint moment in direction 1 Constraint moment in direction 2 Constraint moment in direction 3 QF1R QF2R QF3R QM1R QM2R QM3R QF1I QF2I QF3I QM1I QM2I QM3I RS RS RS RS RS RS RS RS RS RS RS RS Constraint force in direction 1 – Real Constraint force in direction 2 – Real Constraint force in direction 3 – Real Constraint moment in direction 1 – Real Constraint moment in direction 2 – Real Constraint moment in direction 3 – Real Constraint force in direction 1 – Imaginary Constraint force in direction 2 – Imaginary Constraint force in direction 3 – Imaginary Constraint moment in direction 1 – Imaginary Constraint moment in direction 2 – Imaginary Constraint moment in direction 3 – Imaginary Data Format when Table Code = 63 (OQG contact force results) 1 2 3 4 5 EKEY TYPE QF1 QF2 QF3 I I RS RS RS Device code + 10*Point identification number Point type, Grid or Scalar (always Grid for contact force) Contact force in direction X (Base C.S.) Contact force in direction Y (Base C.S.) Contact force in direction Z (Base C.S.) 5-256 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 Name QM1 QM2 QM2 Type RS RS RS Description Not used Not used Not used Repeat word 1-8 for each grid point. Record 3 – TRAILER Word 1 Name UNDEF(6 ) Type None Description 5.20 OSDISP2 Table of Modal Contributions Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block Name Record 1 – OSINT Word 1–10 11–50 51,52 53,54 55–144 145 146 Name OSDNUM UNDEF (40) SOLNM1(2) SOLNM2(2) UNDEF(90) INUM UNDEF Type I None Char4 Char4 None I None Description NX Nastran DMAP Programmer’s Guide 5-257 Chapter 5 Data Block Descriptions O-V Record 2 - OSNUM Word 1 2 3 Name ISTART IVAL AVAL Type I I RS Description Record 3- Trailer Word 1 Name UNDEF(6 ) Type none Description Notes: 1. Records 1 and 2 may repeat in order for n number of times followed by the trailer. 5.21 OSHT Output shell element thickness results For SOLs 601/701, Sort 1 only. Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block Name, e.g. OSHT1 Record 1 – IDENT Word 2 3 11–50 Name TCODE ELTYPE UNDEF Type I I None Description Table Code, 60 Element Type Record 2 - DATA Word ELTYPE=88 Name Type Description TRIA3 - Nonlinear 5-258 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 2 3 4 Name EKEY TERM GRID THICK Type I CHAR4 I RS Description “CEN” Grid identification number; 0 for centroid Thickness Words 3 through 4 repeat 004 times ELTYPE=90 1 2 3 4 EKEY TERM GRID THICK QUAD4 - Nonlinear I CHAR4 I RS “CEN” Grid identification number; 0 for centroid Thickness Words 3 through 4 repeat 005 times ELTYPE=240 1 2 3 4 EKEY TERM GRID THICK TRIA6 - Nonlinear I CHAR4 I RS “CEN” Grid identification number; 0 for centroid Thickness Words 3 through 4 repeat 004 times ELTYPE=241 1 2 3 4 EKEY TERM GRID THICK QUAD8 - Nonlinear I CHAR4 I RS “CEN” Grid identification number; 0 for centroid Thickness Words 3 through 4 repeat 005 times NX Nastran DMAP Programmer’s Guide 5-259 Chapter 5 Data Block Descriptions O-V 5.22 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 0 - HEADER Word 1 3 Name NAME(2) WORD Type CHAR4 I Description Data block name No Def or Month, Year, One, One Word 3 repeats until End of Record Record 1 - IDENT Word 1 2 3 4 TCODE,1 =1 ACODE,4 =01 5 6 LSDVMN UNDEF(2 ) Name ACODE(C) TCODE(C) UNDEF SUBCASE Type I I None I Sort 1 Statics I None Real Eigenvalues I RS F1 Mode Number Eigenvalue Mode or Cycle Load set number Subcase or Random identification number Description Device code + 10*Approach Code Table Code ACODE,4 =02 5 6 7 MODE EIGN MODECYCL ACODE,4 =03 5 6 LSDVMN UNDEF(2 ) Differential Stiffness I None Differential Stiffness Load set number ACODE,4 =04 5-260 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 Name LSDVMN UNDEF(2 ) Type I None Frequency RS None Transient RS None Description Load set number ACODE,4 =05 5 6 FREQ UNDEF(2 ) Frequency ACODE,4 =06 5 6 TIME UNDEF(2 ) Time Step ACODE,4 =07 5 6 LSDVMN UNDEF(2 ) Buckling Phase 0 (Pre-buckling) I None Buckling Phase 1 (Post-buckling) I RS None Complex Eigenvalues I RS RS Mode Eigenvalue (real) Eigenvalue (imaginary) Mode Number Eigenvalue Load set ACODE,4 =08 5 6 7 LSDVMN EIGR UNDEF ACODE,4 =09 5 6 7 MODE EIGR EIGI ACODE,4 =10 5 6 LFTSFQ UNDEF(2 ) Nonlinear statics RS None Old geometric nonlinear statics I None CONTRAN ? ( Can appear as ACODE=6 ) Load set Load step ACODE,4 =11 5 6 LSDVMN UNDEF(2 ) ACODE,4 =12 NX Nastran DMAP Programmer’s Guide 5-261 Chapter 5 Data Block Descriptions O-V Word 5 6 Name TIME UNDEF(2 ) Type RS None Description Time End ACODE,4 TCODE,1 =02 5 6 LSDVMN UNDEF(2 ) Sort 2 I None Load set, Mode Number End TCODE,1 8 9 10 11 13 14 23 24 51 83 115 RCODE FCODE NUMWDE UNDEF(2) ACFLAG(C) UNDEF(9 ) THERMAL UNDEF(27 ) TITLE(32) SUBTITL(32) LABEL(32) I I I None I None I None CHAR4 CHAR4 CHAR4 Title Subtitle Label 1 for heat transfer and 0 otherwise Acoustic presure flag Random code ID number Format Code Number of words per entry in DATA record Record 2 - DATA Word Name Type Sort 1 I Device code + 10* Point identification number Description TCODE,1 =01 1 EKEY TCODE,1 =02 ACODE,4 =01 1 EKEY Sort 2 - Swap with word 5 of IDENT I Device code + 10* Point identification number ACODE,4 =02 5-262 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 1 Name EKEY Type I Description Device code + 10* Point identification number ACODE,4 =03 1 EKEY I Device code + 10* Point identification number ACODE,4 =04 1 EKEY I Device code + 10* Point identification number ACODE,4 =05 1 FREQ RS Frequency ACODE,4 =06 1 TIME RS Time step ACODE,4 =07 1 EKEY I Device code + 10* Point identification number ACODE,4 =08 1 EKEY I Device code + 10* Point identification number ACODE,4 =09 1 EKEY I Device code + 10* Point identification number ACODE,4 =10 1 FQTS RS Frequency or Time step ACODE,4 =11 1 EKEY I Device code + 10* Point identification number ACODE,4 =12 Word 1 Name EKEY Type I Description Device code + 10* Point identification number End ACODE,4 End TCODE,1 2 TYPE I Point type: G for grid and S for scalar TABLCODE=01 Displacement - TablCode=MOD(TCODE,1000) NX Nastran DMAP Programmer’s Guide 5-263 Chapter 5 Data Block Descriptions O-V Word Name Type Description TCODE,2 =01 ACFLAG =0 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 8 9 10 11 12 13 14 DT1R DT2R DT3R DR1R DR2R DR3R DT1I DT2I DT3I DR1I DR2I DR3I DT1 DT2 DT3 DR1 DR2 DR3 Real Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Real/ Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 Word ACFLAG =2 TCODE,7 =0 or 2 Name Type Description Acoustic Pressure Real or Random Response 5-264 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 3 4 5 6 7 TCODE,7 =1 3 4 5 6 7 8 9 10 11 Name P PRMS DB DBA UNDEF(2 ) Type RS RS RS RS None Description Sound pressure level RMS Sound pressure level Sound pressure level in dB Sound pressure level in dBA Real/ Imaginary PR PRMSR DBR DBAR PI PRMSI DBI DBAI UNDEF(4 ) RS RS RS RS RS RS RS RS None Sound pressure level RMS Sound pressure level Sound pressure level in dB Sound pressure level in dBA Sound pressure level - imaginary RMS Sound pressure level - imaginary Sound pressure level in dB - imaginary Sound pressure level in dBA - imaginary End TCODE,7 End ACFLAG Word Name Type Description TCODE,2 =07 TCODE,7 =0 or 2 3 4 5 6 7 8 DT1 DT2 DT3 DR1 DR2 DR3 Eigenvector Displacement Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 NX Nastran DMAP Programmer’s Guide 5-265 Chapter 5 Data Block Descriptions O-V Word TCODE,7 =1 3 4 5 6 7 8 9 10 11 12 13 14 Name Type Description Real/ Imaginary DT1R DT2R DT3R DR1R DR2R DR3R DT1I DT2I DT3I DR1I DR2I DR3I RS RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 Word Name Type Velocity Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Description TCODE,2 =10 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 VT1R VT2R VT1 VT2 VT3 VR1 VR2 VR3 Real/ Imaginary RS RS Translation in direction 1 Translation in direction 2 5-266 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 5 6 7 8 9 10 11 12 13 14 Name VT3R VR1R VR2R VR3R VT1I VT2I VT3I VR1I VR2I VR3I Type RS RS RS RS RS RS RS RS RS RS Description Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 Word Name Type Acceleration Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Description TCODE,2 =11 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 AT1R AT2R AT3R AR1R AR2R AT1 AT2 AT3 AR1 AR2 AR3 Real/ Imaginary RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 NX Nastran DMAP Programmer’s Guide 5-267 Chapter 5 Data Block Descriptions O-V Word 8 9 10 11 12 13 14 Name AR3R AT1I AT2I AT3I AR1I AR2I AR3I Type RS RS RS RS RS RS RS Description Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 Word Name Type Description TCODE,2 =14 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 8 9 10 DT1R DT2R DT3R DR1R DR2R DR3R DT1I DT2I DT1 DT2 DT3 DR1 DR2 DR3 Eigenvector Displacement (Solution Set) Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Real/ Imaginary RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary 5-268 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 11 12 13 14 Name DT3I DR1I DR2I DR3I Type RS RS RS RS Description Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 Word Name Type Description TCODE,2 =15 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 8 9 10 11 12 13 DT1R DT2R DT3R DR1R DR2R DR3R DT1I DT2I DT3I DR1I DR2I DT1 DT2 DT3 DR1 DR2 DR3 Displacement (Solution Set) Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Real/ Imaginary RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary NX Nastran DMAP Programmer’s Guide 5-269 Chapter 5 Data Block Descriptions O-V Word 14 Name DR3I Type RS Description Rotation in direction 3 - imaginary End TCODE,7 Word Name Type Description TCODE,2 =16 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 8 9 10 11 12 13 14 VT1R VT2R VT3R VR1R VR2R VR3R VT1I VT2I VT3I VR1I VR2I VR3I VT1 VT2 VT3 VR1 VR2 VR3 Velocity (Solution Set) Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Real/ Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 5-270 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word Name Type Description TCODE,2 =17 TCODE,7 =0 or 2 3 4 5 6 7 8 TCODE,7 =1 3 4 5 6 7 8 9 10 11 12 13 14 AT1R AT2R AT3R AR1R AR2R AR3R AT1I AT2I AT3I AR1I AR2I AR3I AT1 AT2 AT3 AR1 AR2 AR3 Acceleration (Solution Set) Real or Random Response RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Real/ Imaginary RS RS RS RS RS RS RS RS RS RS RS RS Translation in direction 1 Translation in direction 2 Translation in direction 3 Rotation in direction 1 Rotation in direction 2 Rotation in direction 3 Translation in direction 1 - imaginary Translation in direction 2 - imaginary Translation in direction 3 - imaginary Rotation in direction 1 - imaginary Rotation in direction 2 - imaginary Rotation in direction 3 - imaginary End TCODE,7 End TCODE,2 Record 3 - TRAILER Word 1 Name UNDEF(6 ) Type None Description NX Nastran DMAP Programmer’s Guide 5-271 Chapter 5 Data Block Descriptions O-V 5.23 R1MAP Table of mapping from original first level (Direct) Retained Responses Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – RESPONSE Word 1 Name IRID Type I Description Internal response identification number Word 1 repeats until End of Record Record 2 – TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of responses 5.24 R1TAB Table of type one response attributes Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 - Repeat Word 1 2 3 Name IRID RID TYPE(C) Type I I I Description Internal response identification number External response identification number Response type 5-272 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 4 6 7 Word TYPE =1 8 10 11 TYPE =2 8 10 11 TYPE =3 8 9 10 TYPE =4 8 9 10 TYPE =5 8 9 10 11 TYPE =6 Name LABEL(2) REGION SCID Name Type CHAR4 I I Type Weight Description Label Region identifier Subcase identification number Description UNDEF(2 ) SEID UNDEF(2 ) None I None Volume Superelement identification number or ALL UNDEF(2 ) SEID UNDEF(2 ) None I None Lama Superelement identification number or ALL MODE APRX UNDEF(3 ) I I None Eign Mode number Approximation code MODE APRX UNDEF(3 ) I I None Disp Mode number Approximation code COMP UNDEF GRID UNDEF(2 ) I None I None Stress Displacement component Grid identification number NX Nastran DMAP Programmer’s Guide 5-273 Chapter 5 Data Block Descriptions O-V Word 8 9 10 11 TYPE =7 8 9 10 11 TYPE =8 8 9 10 11 TYPE =9 8 9 10 11 TYPE =10 8 9 10 11 TYPE =11 8 Name ICODE UNDEF PID UNDEF(2 ) Type I None I None Strain Description Stress item code Property entry identification number ICODE UNDEF PID UNDEF(2 ) I None I None Force Strain item code Property entry identification number ICODE UNDEF PID UNDEF(2 ) I None I None CFAILURE Force item code Property entry identification number ICODE PLY PID UNDEF(2 ) I I I None CSTRESS Failure criterion item code Lamina number Property entry identification number ICODE PLY PID UNDEF(2 ) I I I None CSTRAIN Stress item code Lamina number Property entry identification number ICODE I Strain item code 5-274 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 Word TYPE =20 8 9 10 11 TYPE =21 8 9 10 11 TYPE =22 8 9 10 11 TYPE =23 8 9 10 11 TYPE =24 8 Name PLY PID UNDEF(2 ) Name Type I I None Type FRDISP Description Lamina number Property entry identification number Description COMP FREQ GRID UNDEF(2 ) I RS I None FRVELO Displacement component Frequency Grid identification number COMP FREQ GRID UNDEF(2 ) I RS I None FRACCL Velocity component Frequency Grid identification number COMP FREQ GRID UNDEF(2 ) I RS I None FRSPCF Acceleration Component Frequency Grid identification number COMP FREQ GRID UNDEF(2 ) I RS I None FRSTRE SPCForce Component Frequency Grid identification number ICODE I Stress item code NX Nastran DMAP Programmer’s Guide 5-275 Chapter 5 Data Block Descriptions O-V Word 9 10 11 TYPE =25 8 9 10 11 Word TYPE =60 8 9 10 11 TYPE =61 8 9 10 11 TYPE =62 8 9 10 11 TYPE =63 8 Name FREQ PID UNDEF(2 ) Type RS I None FRFORC Description Frequency Property entry identification number ICODE FREQ PID UNDEF(2 ) Name I RS I None Type TDISP Force item code Frequency Property entry identification number Description COMP TIME GRID UNDEF(2 ) I RS I None TVELO Displacement component Time step Grid identification number COMP TIME GRID UNDEF(2 ) I RS I None TACCL Velocity component Time step Grid identification number COMP TIME GRID UNDEF(2 ) I RS I None TSPCF Acceleration component Time step Grid identification number COMP I SPCForce component 5-276 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 10 11 TYPE =64 8 9 10 11 TYPE =65 8 9 10 11 Word TYPE =81 8 9 11 12 TYPE =82 8 9 12 TYPE =83 8 9 Name TIME GRID UNDEF(2 ) Type RS I None TSTRE Description Time step Grid identification number ICODE FREQ PID UNDEF(2 ) I RS I None TFORCE Stress item code Time step Property entry identification number ICODE FREQ PID UNDEF(2 ) Name I RS I None Type DIVERG Force item code Time step Property entry identification number Description ROOT UNDEF(2 ) MACH DIVERG I None RS I TRIM Root number Mach number DIVERG identification number XID UNDEF(3 ) TRIM I None I SABDER AESTAT or AESURF identification number TRIM identification number XID COMP I I AESTAT or AESURF identification number Component NX Nastran DMAP Programmer’s Guide 5-277 Chapter 5 Data Block Descriptions O-V Word 10 11 12 TYPE =84 8 9 10 11 12 End TYPE 13 14 15 Name RESFLG UNDEF TRIM Type I None I FLUTTER Description Restraint flag TRIM identification number MODE MACH VELOC DENSITY FLUTTER I RS RS RS I Mode number Mach numbers Velocity Density Flutter identification number UNDEF TYFLG SEID None I I Flag to indicate how response is referenced Superelement identification number Record 2 - TRAILER Word 1 2 Name NR1 UNDEF(5 ) Type I None Description Number of type one responses (number of records in table) Notes: 1. 2. Table is in IRID order and is in the order in which responses are to be generated. 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. 5.25 RESP12 Table of second level (synthetic) responses 5-278 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 - Repeat - for each Type 2 response Word 1 2 3 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 Name IR2ID R2ID LABEL(2) EQID REG ND(C) NC(C) NR(C) NCORD(C) NPROP1(C) NCONP1(C) NMATP1(C) NPROP2(C) NCONP2(C) NMATP2(C) NRR2(C) ARGDSP NCEQ(C) IDV Type I I CHAR4 I I I I I I I I I I I I I I I I Description Internal response identification number External response identification number Label Equation identification number Region identification number Number of design variables Number of constants from constant table (Data block DTB) Number of type one responses Number of coordinates Number of type one properties Number of type one connectivity properties Number of type one material properties Number of type two properties Number of type two connectivity properties Number of type two material properties Number of referenced type two responses Number of discrepancy on arguments Number of constants from equation table (Data block DEQATN) Internal design variable identification number Word 20 repeats ND times 21 CVLT1 RS Table constant NX Nastran DMAP Programmer’s Guide 5-279 Chapter 5 Data Block Descriptions O-V Word Name Type Description Word 21 repeats NC times 22 IR1ID I Type one response identification number Word 22 repeats NR times 23 24 NODE DIR I I Node number Direction Words 23 through 24 repeat NCORD times 25 PROP1ID I Type one property identification number Word 25 repeats NPROP1 times 26 CONP1ID I Type one connectivity property identification number Word 26 repeats NCONP1 times 27 MATP1ID I Type one material property identification number Word 27 repeats NMATP1 times 28 PROP2ID I Type two property identification number Word 28 repeats NPROP2 times 29 CONP2ID I Type two connectivity property identification number Word 29 repeats NCONP2 times 30 MATP2ID I Type two material property identification number Word 30 repeats NMATP2 times 31 IR2ID I Type two response identification number Word 31 repeats NRR2 times 32 CVLQ RS Equation constant Word 32 repeats NCEQ times 33 34 RC ARGS I I Record count Number of arguments 5-280 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 35 36 37 38 39 40 Name OSCAR DEQA RECNUM BIT TLC(C) TEMPVPS Type I CHAR4 I I I I Description Oscar type; always 13 "DEQA" Record number DEQATN identification number number bitwise-or-ed with bit 32 Temporary VPS location count Temporary VPS locations Word 40 repeats TLC times 41 42 43 IC(C) INST INSTI(3) I CHAR4 I Instruction word count Instruction character word Instruction integer words Words 42 through 45 repeat IC/4 times 46 DATATYP I Integer input I Real input RS Real Integer Temporary VPS value section DATATYP =1 47 INT DATATYP =2 47 REAL DATATYP =3 47 CHARS(2) Character input CHAR4 Character End DATATYP Words 46 through max repeat until End of Record Record 2 - TRAILER Word 1 2 Name NRP2 MAXL Type I I Description Number of records (type 2 responses) in the table Maximum record length NX Nastran DMAP Programmer’s Guide 5-281 Chapter 5 Data Block Descriptions O-V Word 3 4 Name MAXEQ UNDEF(3 ) Type I None Description Maximum value of EQPOS - 1 for all the records Notes: 1. EQPOS = 12 + ND + NC + NR + 2*NCORD + NPROP + NCEQ 1.NCC is equal to 2*NCRD. 2. Pointer FRT1 is equal to ND+NCT+12, pointer FRCD is equal to FRT1+NCEQ, pointer FRCEQ is equal to FRCD + 2 * NCRD, pointer EQPOS is equal to FRCEQ + NCEQ. 5.26 SEMAP Superelement Definition Table (Map) Provides geometry and connection information for a problem formulated in terms of superelements. Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 - DEFINE Repeated for each superelement according to process order Word 1 2 3 4 5 6 7 8 Name SEID INTIDX ORDER SEDN SEDWNIDX PEID TYPEBIT NODNCNCT Type I I I I I I I I Description Super element identification number Internal index of superelement Processing order Downstream superelement identification number Internal index of downstream superelement Primary superelement identification number Superelement type bit map (See note 3) Number of downstream connections 5-282 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 9 Name BITINFO Type I Description On bits correspond to connected downstream SE’s Word 9 repeats LENTRY-1 times Words 8 through 9 repeat NBRSE times 10 11 12 13 NLBL NWLBL(C) SEID LABELI I I I CHAR4 Number of SELABEL entries Number of words in label Super element identification number Four characters in the label Word 13 repeats NWLBL times Words 10 through 13 repeat NLBL times Record 2 - MAP Repeated for each superelement according to process order and contains LENTRY words per grid point Word 1 2 Name GRIDID GRIDBIT Type I I Description Grid point identification number Grid point bit map Word 2 repeats LENTRY-1 times Record 3 - INFO Repeated for each superelement according to process order Word 1 2 3 4 5 6 Name SEID BITNO NG(C) NE(C) PEID SEBITS Type I I I I I I Description Superelement identification number Bit number for superelement Number of exterior grid points Number of elements NE=NBR of simple+genel+rigid Primary superelement identification number Superelement type bit map (See Note 3) NX Nastran DMAP Programmer’s Guide 5-283 Chapter 5 Data Block Descriptions O-V Word 7 8 9 Name SEDWN BITDWN EXTGRD Type I I I Description Downstream superelement identification number Bit number of downstream superelement Sorted list of exterior (boundary) grid point identification numbers Word 9 repeats NG times 10 ELIDS I Sorted list of element identification numbers Word 10 repeats NE times 11 PGRID I List of primary superelement exterior grids Word 11 repeats until End of Record Record 4 - TRAILER Word 1 2 3 4 5 6 Name NBRSE NBRGP NBRSCL LENTRY NBRSEC NWDDEF Type I I I I I I Description Number of superelements including residual (NBRSE+1) Total number of grid and scalar points in structure Number of scalar points Number of words per entry in RECORD=MAP Number of secondary superelements Number of words per entry in RECORD=DEFINE Notes: 1. SEID=0 implies residual. 2. This table is UNSTRUCTURED. The reason is that each of the records repeat for each superelement. 3. The low order (right to left) 10 bits in TYPEBIT are set as follows: Bit Position: Meaning 0 9 8 7 6 5 4 3 2 1 ------------------0 0 0 0 0 0 0 0 0 0 1 . . . . . . . . . . 1 . . . . . . . . . . 1 . . . . . . . . . . 1 . . . . . . . . . . 1 . . . . . ------Primary Partitioned Reflect Z Reflect Y Reflect X Repeated 5-284 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V . . . . . . . . . . . . . . . . . . . . . . . . . 1 . . . . . 1 . . . . . 1 . . . . . 1 . . . . . 1 Collector External Mirror Identical Apply mapping transform 4. The BITINFO in ENTRY=DWNCNCT indicates the downstream superelement(s?). Bit Number 0 1 through NBRSE-1 Downstream superelement is: The residual structure The superelement(s) corresponding to the INTIDX-th bit(s) 5. In ENTRY=GRIDMAP, bits are numbered left to right beginning with zero and span LENTRY-1 words. Bit number 0 1 through NBRSE-1 NBRSE NBRSE+1 MAXBIT-IDBITS through MAXBIT Meaning Grid is connected to the residual structure Grid is connected to the superelement(s) corresponding to the INTIDX-th bit(s) Grid is a scalar point Grid is an incongruent boundary point Internal superelement index (INTIDX) to which grid is interior 6. where MAXBIT = NBPW*(LENTRY-1)-1, NBPW is the number of bits per word, and "incongruent" indicates inconsistent coordinate systems on the boundary point. 7. In RECORD=INFO the primary superelement exterior grid points are sorted in the order of the secondary exterior grid points. Only if SEQSEP is specified. 8. SELABEL is created by SEP1X only. 9. LENTRY is computed from IDBITS: 10. IDBITS is the minimum number of bits required to represent NBRSE. IDBITS = int ( ln ( max (NBRSE,1)) ln 2 ln 2 11. where ln is the natural logarithm and int is the integer function. 12. LENTRY is number of words in the grid point map. + 1.01) NX Nastran DMAP Programmer’s Guide 5-285 Chapter 5 Data Block Descriptions O-V LENTRY = int ( NBRSE + IDBITS + 1 NBPW + 2) NBPW 13. For example, if NBRSE=50 and NBPW=32, IDBITS=6 and LENTRY=3. 14. The structure of RECORD=MAP is the same for SEP1 and SEP1X, but the content is different. For SEP1X, GRIDID in RECORD=MAP identifies only boundary grid points and GRIDBIT delineates to which superelement the point connects. For SEP1 the bits are not really clear in meaning. However some rules tend to indicate when the exterior grid becomes interior. 15. RECORD=INFO is the same between both systems, although modules SEP1X and SEP2X do not use ENTRY=ELIDS. 16. ENTRY=PGRID exists only for secondary superelements with resequencing, that is, bit 1 is on in TYPE, and lists the relative primary grid points in the same order as ENTRY=EXTGRD. 5.27 SET Table of combined sets Record 0 – HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 – (*) Word 1 2 3 4 5 Name ID TYPE SETORIG SETLEN SETMEM Type I I I I I Description Set identification number Set type Origin of set Length of set Set members Word 5 repeats SETLEN times 5-286 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Record 2 – TRAILER Word 1 2 3 Name WORD1 WORD2 UNDEF(4 ) Type I I None Description Number of sets Number of members in largest set Notes: 1. TYPE: 0=unknown, 1=grid, 2=element, 3=grid pairs 2. SETORIG: 1=Case Control section, 2=plot section, 3=SET1 Bulk Data entries, 4=MSGMESH input 5.28 TOL Transient response time step output list Record 0 – HEADER Word 1 3 Name NAME(2) TIME Type CHAR4 RS Description Data block name Time step Word 3 repeats until End of Record Record 1 – TRAILER Word 1 2 Name WORD1 UNDEF(5 ) Type I None Description Number of time steps 5.29 VIEWTB View information table Contains the relationship between each p-element and its view-elements and view-grids. NX Nastran DMAP Programmer’s Guide 5-287 Chapter 5 Data Block Descriptions O-V Record 0 - HEADER Word 1 Name NAME(2) Type CHAR4 Description Data block name Record 1 - HEXAP(14100,141,18) Word 1 2 3 4 5 6 7 8 9 10 11 Name EID CID NX NY NZ MTH MINEID MAXEID MINGID MAXGID G(8) Type I I I I I CHAR4 I I I I I Description Element identification number Coordinate system identification number - from CID field View mesh subdivision - from VIEW field View mesh subdivision - from VIEW field View mesh subdivision - from VIEW field Method – ’DIRE’ means direct Mininum VUHEXA identification number for this element Maximum VUHEXA identification number for this element Minimum Grid identification number for this element Maximum Grid identification number for this element Corner Grid identification numbers Record 2 – PENTAP(14200,142,16) Word 1 2 3 4 5 Name EID CID NX NY NZ Type I I I I I Description Element identification number Coordinate system identification number - from CID field View mesh subdivision – from VIEW field View mesh subdivision – from VIEW field View mesh subdivision – from VIEW field 5-288 NX Nastran DMAP Programmer’s Guide Data Block Descriptions O-V Word 6 7 8 9 10 11 Name MTH MINEID MAXEID MINGID MAXGID G(6) Type CHAR4 I I I I I Description Method – ’DIRE’ means direct Mininum VUPENTA IDENTIFICATION NUMBER for this element Maximum VUPENTA IDENTIFICATION NUMBER for this element Minimum Grid identification number for this element Maximum Grid identification number for this element Corner Grid identification numbers Record 3 – TETRAP(14300,143,14) Word 1 2 3 4 5 6 7 8 9 10 11 Name EID CID NX NY NZ MTH MINEID MAXEID MINGID MAXGID G(4) Type I I I I I CHAR4 I I I I I Description Element identification number Coordinate system identification number – from CID field View mesh subdivision – from VIEW field View mesh subdivision – from VIEW field View mesh subdivision – from VIEW field Method – ’DIRE’ means direct Mininum VUTETRA identification number for this element Maximum VUTETRA identification number for this element Minimum Grid identification number for this element Maximum Grid identification number for this element Corner Grid identification numbers NX Nastran DMAP Programmer’s Guide 5-289 Chapter 5 Data Block Descriptions O-V Record 4 – TRAILER Word 1 Name UNDEF(6 ) Type None Description Notes: 1. For each of the three 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. 5-290 NX Nastran DMAP Programmer’s Guide Chapter 6 Glossaries • • Data Block Glossary Parameter Glossary NX Nastran DMAP Programmer’s Guide 6-1 Chapter 6 Glossaries 6.1 Data Block Glossary The Data Block Glossary lists the names and a brief description of all data blocks shown in the module descriptions in “Descriptions of DMAP Modules and Statements” . Naming conventions appear at the end of the glossary. Datablock Name Parent Datablock Format Description 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. Family of a-set size panel area matrices. Aerodynamic connection and property table. Output by APD. Table of the aerodynamic database contents. (one entry for each of the NV instances created). Output by ADG. Matrix of adjoint sensitivities. Output by DSADJ. Adjoint sensitivity displacement matrix in the g-set or p-set. BGPDT Family of aerodynamic basic grid point definition tables. Output by APD. Basic grid point definition table for the aerodynamic js-set interference degrees-of-freedom. Family of basic grid point definition tables for the interference js-set aerodynamic degrees-of-freedom. Basic grid point definition table for the aerodynamic js-set degrees-of-freedom. Family of basic grid point definition tables for the js-set aerodynamic degrees-of-freedom. Basic grid point definition table for the aerodynamic ks-set degrees-of-freedom. Family of basic grid point definition tables for the ks-set aerodynamic degrees-of-freedom. Previously generated AECOMP. Aerodynamic component definition table. Output by APD. Table of aerodynamic coordinate system transformation matrices that only contains the hinge moment referenced coordinates systems if not null. Output by MKCNTRL. Table of aerodynamic model’s control definition. Output by ADG. Index table consisting of the triples. Output by MAKAEFS. Aeroelastic database index for monitor point data. Matrix of vehicle states. Matrix of downwash vectors contained on DMIJ Bulk Data entries referenced by the AEDW entries. Ouptut by MAKAEFA. Index to the AEDW tables. Ouptut by MAKAEFA. GEOM2 Family of aerodynamic element connection tables. Output by APD. Index to the AEFORCE tables. Ouptut by MAKAEFA. A ABESF* ACPT ADBINDX ADELX ADJG AEBGPDT* AEBGPDTI AEBGPDTI* AEBGPDTJ AEBGPDTJ* AEBGPDTK AEBGPDTK* AECMPOLD AECOMP AECSTMHG AECTRL AEDBIDX AEDBINDX AEDBUXV AEDW AEDWIDX AEECT* AEFIDX 6-2 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name AEFRC AEGRID AEIDW AEIPRE AEMONOLD AEMONPT AEPRE AEPRSIDX AERO AEROCOMP AEUSET* AGG AGX AH Aij AJJT AM2 AM3 AMLIST AMSPLINE ANORM APART APL APU AUG1 AUTO AUXTAB AXIC Parent Datablock Format Description Matrix of force vectors contained on DMIK Bulk data entries referenced by the AEFORCE entries. Ouptut by MAKAEFA. BGPDT Basic grid point definition tables for the aerodynamic model. Output by APD as BGPDT with qualifier MODLTYPE=’AEROMESH’. Matrix of interference downwash vectors contained on DMIJ Bulk Data entries referenced by the AEDW entries. Ouptut by MAKAEFA. Matrix of interference pressure vectors contained on DMIJ Bulk data entries referenced by the AEPRESS entries. Ouptut by MAKAEFA. Table of HM monitor points. Aerodynamic monitor point table. Output by MAKAEMON and MAKMON. Matrix of pressure vectors contained on DMIJ Bulk data entries referenced by the AEPRESS entries. Ouptut by MAKAEFA. Index to the AEPRESS tables. Ouptut by MAKAEFA. Table of control information for aerodynamic analysis. Output by APD. Table of aerodynamic components when MESH=’AERO’. Output by MAKCOMP. USET Family of aerodynamic USET tables. Output by APD. Fluid/structure coupling matrix at all points or for a structural panel. Output by GP5. Gravity/thermal load matrix due to volumetric changes for the central, forward, or backward perturbed configuration. Output by SSG1. Signed global modally reduced area matrix Matrix partitions. Output by PARTN and UPARTN. Aerodynamic influence matrix. Output by AMG. Damping matrix in the d-set for linear elements multiplied by the negative of the time step delta 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. List of auxiliary model identification numbers. Output by AXMPR1. 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. Normalized matrix. Output by NORM. Partitioning vector for panel coupling matrix when PNLPTV=TRUE. Lower triangular factor of null space A matrix. Upper triangular factor of null space A matrix. Displacement matrix in g-set for aerostatic analysis. Output by DSAD. Autocorrelation function table. Output by RANDOM. Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments for all subcases. Table of Bulk Data entry images related to conical shell, hydro elastic, and acoustic cavity analysis. Output by IFP. NX Nastran DMAP Programmer’s Guide 6-3 Chapter 6 Glossaries Datablock Name Parent Datablock Format Description 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. 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. Matrix defined on DMIG Bulk Data entries and referenced by the B2GG Case Control command. Output by MTRXIN. Matrix defined on DMIG Bulk Data entries and referenced by the B2PP Case Control command. Output by MTRXIN. Viscous damping matrix in a-set or d-set. Transformation matrix from cyclic to physical components. Required in static and pre-buckling analysis only. Output by CYCLIC1. Auxiliary displacement matrix. Auxiliary displacement matrix. Optional user input. Table of constant terms in the beam section constraint relationship. Output by DOPR1. Matrix relating beam library constraints to the independent design variables. Output by DOPR1. Matrix transpose of BCONXI. 3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel domain decomposition. Output by GPSP. Damping (or heat capacitance) matrix for the d-set for linear elements only. Diagonal matrix of buckling divided by buckling generalized differential stiffness matrix. Output by DSAH. Hydroelastic boundary matrices in DMIG Bulk Data entry format. Output by BMG. B B2DD B2GG B2PP BAA BACK BASVEC BASVEC0 BCON0 BCONXI BCONXT BD3X3 BDD BDIAG BDPOOL BDICT BELM BFHH BGPDT* BGPDT BGPDTD BGPDTM BGPDTN BGPDTS BGPDTX BGPDVB BGPDT BGPDT BGPDT BGPDT BGPDT BGPDT BGPDT BGPDT KDICT KELM BELM dictionary table. Output by EMG. Table of element damping or heat capacity matrices. Output by EMG. Fluid partition of modal damping matrix BHH. Family of basic grid point definition tables for all superelements. Basic grid point definition table. Output by GP1. Basic grid point definition table for a downstream superelement. Basic grid point definition table and updated for the current p-level. Output by GP1 with GEOM1M and GEOM2M as inputs. New BGPDT table based on displaced grid locations. Output by MATMOD option 11. Basic grid point definition table for a superelement. Output by GP1. BGPDT assembled for superelements defined on the SEPLOT or SEUPPLOT command. Output by SEPLOT. Basic grid point definition table for the backward perturbed configuration. Output by DSAM. 6-4 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name BGPDVP BGPDVX BGPECT BHH BHH1 BKDICT BKK BLAMA BLAMA* BNDFIL BP BRDD BTOPO BTOPOCNV BTOPOSTF BXX BUG* BUX BULK BULK* BULKOLD Parent Datablock Format BGPDT BGPDT GEOM2 Description Basic grid point definition table for the forward (or central) perturbed configuration. Output by DSAM. Basic grid point definition table for the central, forward, or backward perturbed configuration. Output by DSAM. Boundary grid point element connection table. Output by BGP. Generalized (modal) damping matrix Modified generalized (modal) damping matrix. Output by FA1. KDICT BKELM dictionary table. Viscous damping matrix in cyclic components. Output by CYCLIC3. LAMA LAMA Buckling eigenvalue summary table. Output by READ. Family of buckling eigenvalue summary tables. Table containing the local and global boundary grids in the order given by extreme for domain decomposition. Output by SEQP. Null space B matrix. Damping matrix in the d-set for linear elements only or heat capacitance matrix for both linear and nonlinear elements in the d-set. Contact regions topological information table. Output by BGP. Updated contact regions input information table. Output by NLITER and NLTRD2. Updated contact regions topological information table. Output by NLITER and NLTRD2. Viscous damping matrix in any set. Usually h-set or d-set in CEAD, FRRD1, FRRD2, TRD1, and TRD2. Family of buckling eigenvector matrices in the g-set Matrix of damping multiplied by displacement or eigenvectors. Table of all Bulk Data entries. Output by XSORT. Family of auxiliary model or superelement Bulk Data sections. BULK table from a prior run. Datablock Name C CASADJ CASDSN CASDSX CASE CASEA Parent Datablock Format Description Rectangular matrix to be used in MPYAD module addition and SMPYAD module product. CASECC CASECC CASECC CASECC CASECC Case Control table associated with adjoint method. Output by DSAD. Case Control table with unneeded analysis subcase(s) deleted, excluding static aeroelastic subcases. Output by DSAD. Case Control table with unneeded analysis subcase deleted Table of Case Control commands for the current analysis type and superelement. A single record (subcase) of CASECC for aerodynamic analysis. Output by AELOOP. NX Nastran DMAP Programmer’s Guide 6-5 Chapter 6 Glossaries Datablock Name CASEBK CASEBUCK CASECC CASECC* CASECC1 CASECCBO CASECCR CASECEIG CASEDR CASEDS CASEDSF CASEDVRG CASEFLUT Parent Datablock Format CASECC CASECC CASECC CASECC CASECC CASECC CASECC Description 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. Case Control table for buckling analysis and based on ANALYSIS=BUCK. Output by MDCASE. Table of Case Control command images. Output by IFP1. Family of auxiliary model Case Control tables. Primary model Case Control table appended with extra subcases to account for the boundary shapes. Output by SHPCAS. Updated CASECC for contact region data recovery operations. Output by BGCASO. Table of Case Control command images for data recovery. Output by TOLAPP. Case Control table for modal or direct complex eigenvalue analysis and based on ANALYSIS=MCEIG or DCEIG. Output by MDCASE. CASECC CASECC CASECC CASECC CASECC Table of Case Control command images for the superelement (identification number equal to output value of SEID). Output by SEDR. Case control table for the data recovery of design responses. Output by DOPR3 and DSTA. Case Control table for all load cases and all design variables for the perturbed configuration. Output by DSAH. Case Control table for aerostatic divergence analysis and based on ANALYSIS=DIVERG. Output by MDCASE. Case Control table for flutter and based on ANALYSIS=FLUTTER. Output by MDCASE. 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. Case Control table for modal or direct frequency response analysis and based on ANALYSIS=MFREQ or DFREQ. Output by MDCASE. Case Control table for heat transfer analysis and based on ANALYSIS=HEAT. Output by MDCASE. Case Control table for normal modes analysis and based on ANALYSIS=MODES. Output by MDCASE. Case Control table for modal transient analysis and based on ANALYSIS=MTRAN. Output by MDCASE. 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. Case Control table for the residual structure and a given analysis type. Table of Case Control command images for the current superelement (identification number equal to output value of SEID). Output by SEP2CT. Combined Case Control table which includes CASESAER or CASEDVRG. Output by MDCASE. Case Control table for aerostatic analysis and based on ANALYSIS=SAERO. Output by MDCASE. CASEFR CASECC CASEFREQ CASEHEAT CASEMODE CASEMTRN CASECC CASECC CASECC CASECC CASEP CASERS CASES CASESADV CASESAER CASECC CASECC CASECC CASECC CASECC 6-6 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name CASESMEM CASESMST CASESNMB CASESTAT CASESX CASEXX CASEUPSE CASEVEC CASEXX CASEYY CDELB CDELK CDELM CFSAB CIDATA CLAMA CLAMA1 CLAMA2 CLAMMAT CMAT CNTABR CNTABRG CNVTST COELEM COGRID COMP COMPi CON Parent Datablock Format CASECC CASECC CASECC CASECC CASECC CASECC CASECC CASECC CASECC CASECC Description Case Control table for electromagnetic analysis and based on ANALYSIS=ELEC. Output by MDCASE. Case Control table for structural analysis and based on ANALYSIS=STRU. Output by MDCASE. Combined Case Control table which includes CASESTAT, CASEMODE, CASEBUCK, CASESAER, CASEDVRG, and CASEFLUT. Output by MDCASE. Case Control table for static analysis and based on ANALYSIS=STATICS. Output by MDCASE. Expanded Case Control table. Output by LCGEN. Case Control table intended for Phase 1 matrix generation, assembly and reduction. Output by MDCASE. Case Control table for upstream superelements only. Output by MDCASE. Table of Case Control command images with the PARTN command referencing all of auxiliary model’s grid identification numbers. Output by AXMPR2. Subset of CASECC for current loop. Output by CASE. Appended Case Control table in flutter analysis. Output by FA2. Triple matrix product for flutter damping sensitivity Triple matrix product for flutter stiffness sensitivity Triple matrix product for flutter mass sensitivity Matrix of spectral densities–weighting factors for RMS calculations. Output by DOPRAN. Miscellaneous data for controlled increment method. Output by NLITER. LAMA LAMA LAMA Complex eigenvalue summary table. Output by CEAD. Complex eigenvalue summary table in flutter analysis. Output by CEAD. Appended complex eigenvalue summary table in flutter analysis. Output by FA2. Diagonal matrix with complex eigenvalues on the diagonal. Output by CEAD, LAMX, and UEIGL. Complex matrix. CONTAB CONTAB Table of retained constraint attributes. Output by DSAD. Table of retained constraint attributes. Convergence test matrix. Correlation table between idcid/eid/component for element responses. Output by DSAH. Correlation table between idcid/gid component for displacement responses. Output by DSAH. Merged table of components. Output by MRGCOMP. Table of aerodynamic or structural components Matrix of constants that relates design variables and design coordinates. Output by DOPR2. NX Nastran DMAP Programmer’s Guide 6-7 Chapter 6 Glossaries Datablock Name CONS1T CONSBL CONSBL* CONTAB CONTACT CONTROL COORD COORDN COORDO CP CPH1 CPH2 CPHFL CPHP CPHFR CPHX CPHL CSNMB CSTM CSTMi CSTM0 CSTMA CSTMD CSTMM CSTMS CVAL CVALO CVAL CVALR CVALRG CVEC Parent Datablock Format Description Matrix transpose of relationship between dependent and independent design variables. Output by DOPR1. Matrix of constant property values. Output by DOPR1. Family of matrices of constant property values. Output by DOPR1. CONTAB Table of constraint attributes. Output by DOPR3. Table of Bulk Data entries related to contact regions. Output by IFP. Table of editing directives for the TABEDIT module. Matrix of initial or final designed coordinate values, COORDO or COORDN. Updated (optimized) COORDO. Output by DOM11. Matrix of initial designed coordinate values at the beginning of each design cycle. Output by DOPR2. Column partitioning vector. Output by VEC and MATMOD option 17. Complex eigenvector matrix for h-set in flutter analysis. Output by CEAD. Appended complex eigenvector matrix for h-set in flutter analysis. Output by FA2. Left flutter eigenvector - h-set. Output by DSFLTE. Complex eigenvector matrix in the p-set. Left flutter eigenvector - h-set. Output by DSFLTE. Complex eigenvector matrix in the d-set or h-set. Output by CEAD. Complex eigenvector matrix in the l-set. Output by CEAD. CASECC CSTM CSTM CSTM CSTM CSTM CSTM CSTM Case Control table for a given superelement and all analysis types. Table of coordinate system transformation matrices. Output by GP1. Tables of coordinate system transformation matrices; either aerodynamic or structural. Table of coordinate system transformation matrices for the residual structure. Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points. Output by APD. Table of coordinate system transformation matrices for a downstream superelement. Merged table of coordinate system transformation matrices. Output by MKCSTMA. Table of coordinate system transformation matrices for a superelement. Matrix of constraint values, CVALO or CVALRG. Matrix of final (optimized) constraint values. Output by DOM9. Matrix of retained constraint values. Output by DSAD. Matrix of retained constraint values. Output by DSAD. Matrix of initial constraint values. Partitioning vector for separating the primary model solutions from boundary shape induced solutions. Output by SHPCAS. 6-8 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name CVECT CYCD Parent Datablock Format Description Load combination factor matrix. Output by PCOMB. Table of constraints in harmonic components. Output by CYCLIC2. Datablock Name D D1JE D1JK D2JE D2JK DAR DBCOPT DB DBi DBMLIB DBNAME DBP DBS DBUG DCLDXT DCPHL DEFUSET DELB1 DELBSH DELBSX DELCE DELDV DELF1 DELFL DELS Parent Datablock Format Description Rectangular matrix to be used in SMPYAD module product. Diagonal matrix extracted from LD. Output by MATMOD option 21. Real part of downwash matrix due to extra points. Real part of downwash matrix. Output by AMG. Imaginary part of downwash matrix due to extra points. Imaginary part of downwash matrix. Output by AMG. 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 Design optimization history table for post-processing. Output by DOM12. Data block. 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. Table of designed beam library data. Output by DOPR1. Data block for ’NAME’ option of PARAML module. Output by PARAML. Primary data block. Secondary data block. Output by EQUIVX. Buckling eigenvector matrix in the g-set associated with designed (active) eigenvalues. Output by DSAH. Matrix of coefficients in the grid to design variable relationship. Output by DOPR2. Complex eigenvectors associated with the divergence eigenvalues extracted from the real part of eigenvectors associated with the divergence eigenvalues. Output by CEAD. Table of DEFUSET Bulk Data entry images. Output by IFP. Matrix of delta buckling load factor for all design variables. Matrix of finite difference shape step sizes. Updated DELBSH where the numerical zero terms are replaced by a prescribed small value. Output by DOPR5. Matrix of delta complex eigenvalue for all design variables Matrix of divergence sensitivity. Output by DSDVRG. Matrix of delta eigenvalue for all design variables. Matrix of delta flutter responses for all design variables. Output by DSFLTF. Matrix of delta stability derivative responses for all design variables. NX Nastran DMAP Programmer’s Guide 6-9 Chapter 6 Glossaries Datablock Name DELS1 DELTGM DELVS DELWS DELX DELX1 DEQATN DEQIND DESELM DESGID DESNEW DESTAB DESVCP Parent Datablock Format Description Matrix of delta stability derivative responses for all design variables for a single trim subcase. Output by DSARSN. Multipoint constraint transformation matrix for the perturbed configuration. Output by DSVGP4. Matrix of delta volume for all design variables. Output by DSAW. Matrix of delta weight for all design variables. Output by DSAW. Matrix of delta trim variable responses for all design variables. Matrix of delta trim variable responses for all design variables for a single trim subcase. Output by DSARSN. Table of DEQATN Bulk Data entry images. Output by IFP. Index table to DEQATN data block. Output by IFP. Table of designed elements. Output by DOPR3. Table of designed grid coordinate attributes. Output by DOPR2. Update table of design variable attributes. Output by DOM12. DESTAB Table of design variable attributes. Output by DOPR1. Global shape basis vector matrix with incorporation of DLINK relations with extra columns for property/dummy variables. Output by DOPR2. 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. 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. Table containing the derivatives of forcing frequencies with respect to natural frequencies. Output by FRLGEN. DESVEC DESVECP DFFDNF DGEOM2 DGEOM3 DGTAB DISTAB DIT DITID DIVDAT DIVTAB DJX DIT GEOM2 GEOM3 Table of Bulk Data entry images related to element connectivity and scalar points for the perturbed configuration. Output by DSAH. Table of Bulk Data entry images related to static loads for the perturbed configuration. Output by DSAH. Table relating DTOS4 records and designed grid data. Correlation table of internal grid sequence for the baseline and perturbed configuration. Output by DOPR6. Table of discrete optimization value sets. Output by DOPR1. Table of TABLEij Bulk Data entry images. Output by IFP. Table of identification numbers in DIT. Output by TA1. Table of divergence data. Output by DIVERG. Table of aerostatic divergence data for all subcases. Downwash matrix. Downwash at the j-point due to the x aerodynamic extra point. Output by ADG. 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. DLCPHL 6-10 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name DLSTIN DLSTOUT DLT DLT1 DLTH DM DMATCK DMI DMIi DMINDX DNODEL DPHG DPLDXI DPLDXI* DPLDXT DRDUG DRDUTB DRLIST DRMSVL DRSTBL DRSTBLG DSCM DSCM2 DSCMCOL DSCMG DSCMR DSCOLL DSCREN DSDIV Parent Datablock Format Description List of data blocks and their paths. Output in a previous execution of RESTART. List of data blocks and their paths. Output by RESTART. Table of dynamic loads. Output by DPD. Table of dynamic loads updated for nonlinear analysis. Output by NLCOMB. Table of dynamic loads updated for heat transfer analysis. Output by TRLG. Rigid body transformation matrix for the r-set to the l-set. Output by RBMG3. Table of designed material consistency check. Output by DOPR1. Table of all matrices specified on DMI Bulk Data entries. Output by IFP. Matrix data blocks created from DMI. Output by DMIIN. Index into DMI. Output by IFP. Table of designed and non-designed locations. Output by DOPR2. Normal modes eigenvector matrix in the g-set associated with designed (active) eigenvalues. Output by DSAH. Matrix of coefficients in the property to independent design variable relationship. Output by DOPR1. Family of matrices of coefficients in the property to independent design variable relationship. Output by DOPR1. Matrix transpose of DPLDXI. Matrix of adjoint loads for the g-set. Output by DSAD. Table of adjoint load attributes. Output by DSAD. Superelement processing list for data recovery. Output by SEP4. Table of the RMS response values with respect to the design variables. Output by DSAMRG. Table containing the number of retained responses for each subcase for each of the response types. Output by DSAD. Table containing the number of retained responses for each subcase for each of the response types. Design sensitivity coefficient matrix. Output by DSAL. Normalized design sensitivity coefficient matrix. Output by DOM6. DCSMCOL Correlation table for normalized design sensitivity coefficient matrix. Output by DSTAP2. Unnormalized design sensitivity matrix. Old combined design sensitivity/constraint matrix. Output by DSMA. Table of design sensitivity column labels for design sensitivity matrix, DSCMR. Output by DSTA. Table of constants from the DSCREEN Bulk Data entry. Output by DOPR1. Matrix of delta divergence speed for all design variables. NX Nastran DMAP Programmer’s Guide 6-11 Chapter 6 Glossaries Datablock Name DSEDV DSEGM DSESM DSIDLBL DSLIST DSPT1 DSPT2 DSROWL DSTABR DSTABU DTB DTI DTIi DTINDX DTOS2 Parent Datablock Format Description Partitioning vector for retained divergence responses. Output by DSAH. Old design sensitivity eigenvalue gradient matrix. Design sensitivity eigenvector selection matrix - Boolean operator to select eigenvectors which are referenced by constraints (buckling and normal modes only). Output by DSTA. Table of design response labels. Output by DSTAP2. Superelement processing list to direct the pseudo-load and response sensitivity calculations. Output by SDSB. Design sensitivity processing table. Output by DSAN and DSTA. Old Design sensitivity processor table two. Output by DSTA. Table of design sensitivity row labels for design sensitivity matrix, DSCMR. Output by DSTA. Matrix of restrained perturbed dimensional stability derivatives. Matrix of unrestrained perturbed dimensional stability derivatives. Table of constants from the DTABLE Bulk Data entry. Output by DOPR1. Table of all matrices specified on DTI Bulk Data entries. Output by IFP. Table data blocks created from DTI. Output by DTIIN. Index into DTI. Output by IFP. 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. 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. Table identifying independent design variables and property values. Output by DOPR1. Family of tables identifying independent design variables and property. Output by DOPR1. Same as DTOS2J except that the dvid in each entry refers to the position of an internal design variable ID in the first TABDEQ record. Output by DOPR4. 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 ID in the first TABDEQ record. Output by DOPR4. 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. Designed grid perturbation vector in basic coordinate system. Output by DOPR2. Same as DTOS4J except that the ID in each five-word entry is the position of an internal design variable ID in the first TABDEQ record. Output by DOPR4. Incremental displacement matrix between the last two converged steps. Output by NLITER. DTOS2* DTOS2J DTOS2J* DTOS2K DTOS2K* DTOS4 DTOS4J DTOS4K DUGNI 6-12 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name DUX DVIDS DVPTAB DVPTAB* DVSLIS DXDXI DXDXIT DYNAMIC DYNAMICB DYNAMICS Parent Datablock Format Description Matrix of aerodynamic extra point displacements for the perturbed configuration. Output by ASG. 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. Family of tables of attributes of the designed properties by internal property identification number order. Output by DOPR1. List of design variables affected by shape variations. Output by DSVGP4. Matrix relating linked and independent design variables. Output by DOPR1. Matrix transpose of DXDXI. DYNAMIC Table of Bulk Data entry images related to dynamics. Output by IFP. Table of Bulk Data entry images related to dynamics without DAREA entry images. Output by GP1. DYNAMIC Table of Bulk Data entry images related to dynamics for the current superelement. Output by SEP2 and SEP2X. Datablock Name E ECT ECT* ECTA EDITVEC EDOM EDOM* EDOMM EDOMS Parent Datablock Format Description Rectangular matrix to be used in SMPYAD module product. GEOM2 GEOM2 GEOM2 Element connectivity table. Output by GP2. Family of element connectivity tables for all superelements. Secondary element connectivity table. Output by GP2. Vector with zeros in rows to be removed under usetop=’filter’. Table of Bulk Data entries related to design sensitivity and optimization. Output by IFP. Family of EDOM tables for all superelements. Table of Bulk Data entries related to design sensitivity and optimization updated for p-element analysis. Output by OPTGP0. Table of Bulk Data entries related to design sensitivity and optimization for a superelement. Output by SDSA. 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. EDT EED EGK EGM EGPSF EGPSF DYNAMIC Table of eigenvalue extraction parameters. Output by DPD. Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness. Output by DSVG1P. Pseudo-load (equilibrium variation) matrix in the g-set due to mass. Output by DSVG1P. Table of element to grid point interpolation factors. Output by GPSTR1. NX Nastran DMAP Programmer’s Guide 6-13 Chapter 6 Glossaries Datablock Name EGPSTR Parent Datablock Format EGPSTR Description Table of grid point stresses or strains for post-processing in the DBC module. Output by GPSTR2. 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. Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness, mass, viscous damping or structural damping. Output by DSVG1P. Element hierarchical table for p-element analysis. Output by GP0. Secondary element hierarchical table. Output by GP0. Table of combined nonlinear information data. Output by NLCOMB. EGTX EGX EHT EHTA ELDATA ELDCT ELEMVOL ELSET EMAT EMM EPSSE EPT EPTA EPTC EPTN EPTS EPTTAB EPTTAB* EPT EPT EPT EPT EPT EPT EPT ELDCT Table of element stress discontinuities for post-processing in the DBC module. Output by STDCON. Element volume table, contains p-element volumes and the p-value dependencies of each P-element grid, edge, face and body. Output by VIEWP. Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section of Case Control. Output by PLTSET and SEPLOT. Matrix of editing parameters. Effective mass matrix. Output by EFFMAS. Table of epsilon and external work. Output by SSG3, SOLVIT, and DISUTIL. Table of Bulk Data entry images related to element properties. Output by IFP and IFP6. Secondary table of Bulk Data entry images related to element properties. Copy of EPT except PCOMP records are replaced by equivalent PSHELL records. Output by IFP6, CMPZPR, and DSTA. Updated (optimized) EPT. Output by DOM11. Table of Bulk Data entry images related to element properties for a superelement. Output by SEP2 and SEP2X. Table of designed property attributes. Output by DOPR1. Family of tables of designed property attributes. Output by DOPR1. 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. Equivalence table between internal fluid grid points and internal structural grid points which lie on the fluid/structure boundary. Output by GP5. EPTX EPT EQACST EQDYN EQEXIN EQEXINS EQEXIN EQEXIN EQEXIN Equivalence table between external and internal grid/scalar/extra point identification numbers. (EQEXIN appended with extra point data). Output by DPD. Equivalence table between external and internal grid/scalar identification numbers. OUTPUT by GP1. Equivalence table between external and internal grid/scalar identification numbers for a superelement. Output by SEP2 and SEP2X. 6-14 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name EQMAP ERHM ERROR0 ERROR1 EST ESTDATA ESTL ESTDCN ESTDV2 ESTDVB ESTDVM ESTDVP ESTDVS ESTF ESTNL ESTNL1 ESTNLH ESTR ETT ETTDCN Parent Datablock Format Description Table of degree-of-freedom global-to-local maps for domain decomposition. Output by PRESOL. Matrix of dimensional unsplined restrained elastic hinge moment data ERROR ERROR Error estimate table generated by ADAPT module in previous superelement or adaptivity loop. Error-estimate table updated for current superelement or adaptivity loop. Output by ADAPT. Element summary table. Output by TA1. Table of superelement estimation data overrides. Output by DTIIN. Linear element summary table. Output by TA1. Element summary table which incorporates combined constraints and design variables. Output by DSAF and DSTA. Merged EST with grid and element property design variable perturbations. If CDIF=’YES’ then this is the forward perturbation. Output by DSAE. Element summary table for the backward perturbed configuration. Required only if CDIF=’YES’. EST EST with updated material property identification numbers. Output by DSABO. EST with element property design variable perturbations. Output by DSABO and DSTA. EST with grid design variable perturbations. Output by DOPR6. Element summary table for follower force stiffness. Output by TAFF. Nonlinear element summary table. Output by TA1. Nonlinear element summary table updated for heat transfer analysis. Output by TAHT. Nonlinear element summary table at converged step. Output by NLITER, NLTRD, and NLTRD2. EST table with reduced records. Output by MATMOD option 38. Element temperature table. Output by GP3. Table of design variable and constraint internal identification numbers for the effects of temperature. Output by DSAF and DSTA. Element temperature table where the original element identification numbers have been converted to new design variable identification numbers. Output by DSAN and DSTA. Matrix of dimensional unsplined unrestrained elastic hinge moment data. ETTDV EUHM Datablock Name F FENL Parent Datablock Format Description Rectangular matrix to be used in SMPYAD module addition. Strain energy and grid point force at every element from the previous load step in nonlinear matrix format. NX Nastran DMAP Programmer’s Guide 6-15 Chapter 6 Glossaries Datablock Name FENL1 FFAJ FFGH FG FGNL FLUTAB FMPF FN FOL FOL1 FOLMAT FOLT FORCE FORE FREQMASS FRL FRL1 FRLI FRQRMF FRQRSP FRQRPR FRQRPRG FSAVE Parent Datablock Format Description Strain energy and grid point force at every element at the current load step in nonlinear matrix format. Output by NLITER. Matrix of pressures at aerodynamic boxes. Follower force for OLOAD output. Output by NLITER. Element forces due to large displacements. Output by GNFM. Nonlinear element force matrix from the last iteration. Output by NLITER. Flutter summary table for all subcases. Matrix of fluid mode participation factors. Output by MODEPF. Matrix of natural frequencies (mass normalized stiffness). FOL FOL Frequency response frequency output list. Output by FRLG. Frequency response frequency output list truncated by the OFREQ Case Control command. Output by MODACC. Matrix of frequencies in radian units. Output by MATMOD Option 33. 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. Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS) section in CASE CONTROL and MSGMESH field information. Output by IFP1. Transformation matrix from physical to cyclic components. Output by CYCLIC1. Matrix of frequencies and generalized masses. Frequency response list. Output by FRLGEN. Frequency response list for the current processor if distributed processing is requested. Output by FRLGEN. Frequency response list for a single frequency. Output by FRQDRV. FRQRPR table for frequency response. Table of the count of type 1 frequency/time responses per response type per frequency or time step. Output by DOPR3. Table containing the number of first level (direct) retained responses per response type and per frequency or time step. Output by DSAD. Table containing the number of first level (direct) retained responses per response type and per frequency or time step. Flutter storage save or answer table. Output by FA1. Datablock Name GAMMAD Parent Datablock Format Description Complex double precision. This is the scalar multiplier for [C]. 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. GAPAR 6-16 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name GC GDGK GDKI GDNTAB GEG GEI GEOM1 GEOM1* GEOM1A GEOM1C Parent Datablock Format Description Transformations matrix between symmetric (cosine) components and solution set components. Output by CYCLIC3. Aerodynamic transformation matrix for displacements from the k-set to g-set. Output by GI. Aerodynamic transformation matrix for displacements from the k-set to h-set. Table of grid points generated for p-element analysis. Output by GP0. Element displacement interpolation matrix. Output by MGEN. Table of general element data. Output by TA1. GEOM1 GEOM1 GEOM1 GEOM1 Table of Bulk Data entry images related to geometry. Output by IFP. Family of GEOM1 tables for all partitioned superelements defined in separate Bulk Data sections. Table of Bulk Data entry images related to geometry and assigned to an auxiliary model. Output by IFP. Table of Bulk Data entry images related to geometry and merged from GEOM1 and GEOM1A. Output by AXMPR2. GEOM1 table containing records which define an external superelement. Specifically, it contains CORD1j, CORD2j, EXTRN, and GRID Bulk Data records. Output by BDRYINFO. GEOM1EX GEOM1M GEOM1N GEOM1P GEOM1Q GEOM1R GEOM1S GEOM1VU GEOM1 GEOM1 GEOM1 GEOM1 Table of Bulk Data entry images related to geometry and updated for the current p-level. Output by GP0. Updated (optimized) GEOM1. Output by DOM11. Modified GEOM1 with CORD1j records converted to CORD2j records. Output by SECONVRT. Table of Bulk Data entry images related to geometry updated for p-elements and superelements. Output by MODGDN. Same as GEOM1 except SEQGP Bulk Data entry records have been added and any pre-existing SEQGP records are removed. Output by SEQP. GEOM1 table with reduced GRID record. Output by MATMOD option 36. GEOM1 GEOM1 Table of Bulk Data entry images related to geometry for the current superelement. Output by SEP2 and SEP2X. Table of Bulk Data entry images related to geometry with view-grids added. Output by VIEWP. 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. Table of Bulk Data entry images related to element connectivity and scalar points. Output by IFP. Family of GEOM2 tables for all partitioned superelements defined in separate Bulk Data sections. Table of secondary Bulk Data entry images related to element connectivity and updated for the current p-level. Output by GP0. GEOM2 table containing records which define an external superelement. Specifically, it PLOTEL and SPOINT Bulk Data records. Output by BDRYINFO. GEOM1X GEOM1 GEOM2 GEOM2* GEOM2A GEOM2EX GEOM2 GEOM2 GEOM2 NX Nastran DMAP Programmer’s Guide 6-17 Chapter 6 Glossaries Datablock Name GEOM2M Parent Datablock Format GEOM2 Description Table of Bulk Data entry images related to element connectivity and scalar points and updated for the current p-level. Output by GP0. Updated (optimized) GEOM2. Output by DOM11. Modified GEOM2 with GO replaced by X1, X2, and X3 on CBAR, CBEAM, CBEND, CBUSH and CGAP records. Output by SECONVRT. GEOM2 table with reduced element record. Output by MATMOD option 37. GEOM2N GEOM2R GEOM2S GEOM2VU GEOM2 GEOM2 GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points for the current superelement. Output by SEP2 and SEP2X. Table of Bulk Data entry images related to element connectivity and scalar points p-elements removed and view-elements added. Output by VIEWP. 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. Table of Bulk Data entry images related to static and thermal loads. Output by IFP. 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. GEOM2X GEOM3 GEOM3B GEOM3M GEOM2 GEOM3 GEOM3 Table of Bulk Data entry images related to static and thermal loads and updated for the current p-level. Output by GP0. 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. Table of Bulk Data entry images related to static and thermal loads for the current superelement. Output by SEP2 and SEP2X. GEOM3 table with new or modified temperatures. Output by MATMOD option 18. GEOM3 table related to axisymmetric conical shell, hydroelastic, and acoustic cavity analysis. Output by IFP3. Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity. Output by IFP. Family of GEOM4 tables for all partitioned superelements defined in separate Bulk Data sections. GEOM4 table containing records which define an external superelement. Specifically, ASETi and QSETi Bulk Data records. Output by BDRYINFO. GEOM3N GEOM3 GEOM3S GEOM3T GEOM3X GEOM4 GEOM4* GEOM4EX GEOM4M GEOM3 GEOM3 GEOM3 GEOM4 GEOM4 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. 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. 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. 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. GEOM4P GEOM4 GEOM4S GEOM4 GEOM4X GEOM4 6-18 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name GETNUMPN GEQMAP GLBRSP GLBRSPDS GLBTAB GLBTABDS GLERR GLERR1 GM GMD GOA GOD GPDCT GPDT GPECT GPECT1 GPECTF GPFORCE GPGK GPKH GPIK GPKE GPL GPLD GPMPF GPSETS GPSNT GPSNTS GRIDFMP Parent Datablock Format Description Logical. Panel static load computation flag. If TRUE then get number of panels flag only and do not compute panel static loads. Table of grid based local equation map indicating which grid resides on which processors/partitions for domain decomposition. Output by SEQP. Matrix of global responses when system cell 297=-1. Output by SDRP. Global results matrix Table of global responses when system cell 297=-1. Output by SDRP. Global results correlation table Table of global error estimates from previous iteration. Output by ADAPT. Table of global error estimates for current iteration. Output by ADAPT. Multipoint constraint transformation matrix, m-set by n-set. Output by MCE1. Multipoint constraint transformation matrix with extra points, m-set by ne-set. Output by UMERGE1. Omitted degree-of-freedom transformation matrix, o-set by a-set. Output by FBS. Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set. Output by UMERGE1. Table of grid point stress discontinuities for post-processing in the DBC module. Output by STDCON. GPDT Grid point definition table. Output by GP1. Grid point element connection table. Output by TA1. Grid point element connection table for heat transfer analysis. Output by TAHT. Grid point element connection table for follower force stiffness. Output by TAFF. Integer. The number of columns in FENL. If GPFORCE less than or equal to zero then no GPFORCE or ESE command is present. Aerodynamic transformation matrix for loads from the k-set to g-set. Output by GI. Aerodynamic transformation matrix for loads from the k-set to h-set. Aerodynamic transformation matrix for loads from the h-set to k-set. Matrix of grid point kinetic energies. GPL External grid/scalar point identification number list. Output by GP1. External grid/scalar/extra point identification number list. (GPL appended with extra point data). Output by DPD. Matrix of grid panel mode participation factors. Output by MODEPF. Table of grid point sets related to the element plot sets. Output by PLTSET and SEPLOT. Grid point shell normal table. Output by TASNP2. Grid point shell normal table for the current superelement. Output by SEP2 and TASNP2. Integer. Case Control set identification number of fluid grids that will be output. NX Nastran DMAP Programmer’s Guide 6-19 Chapter 6 Glossaries Datablock Name GRIDMP GRIDSET GS Parent Datablock Format Description Integer. Case Control set identification number for a set of fluid grids. Integer. SET Case Control command identification number which contains a list grid point identification numbers. Transformation matrix between symmetric (sine) components and solution set components. Output by CYCLIC3. Datablock Name HARM HDRLBLi HEADCNTL HIS HISADD HMKT HOEF1 Parent Datablock Format Description Table of harmonic indices. Output by CYCLIC1. Character. Header with up to 64 characters to be printed and centered at the top of of each page. 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. Table of design iteration history for current design cycle. Output by DOM12. Matrix used to compute hinge moments for each AESURF entry. Output by ADG. OEF Table of element fluxes in SORT1 format updated for CHBDYi elements. Output by SDRHT. Datablock Name Ii IEF IES IFD IFG IFPDB IFS IMAT INDTA INVEC IQG IUG IUNITSOL Parent Datablock Format Description Inputs to MATMOD and MATPCH module. OEF OES Table of element forces due to unit modal displacement in SORT1 or SORT2 format. Output by SDR2 or SDR3. Table of element stresses or strains due to unit modal displacement in SORT1 or SORT2 format. Output by SDR2 or SDR3. Matrix of nonlinear element forces at constrained points at the output time steps. Output by NLTRD and NLTRD2. Matrix of nonlinear element forces for the g-set at the output time steps. Output by NLTRD. Table data block with IFP module table attributes. Matrix of total element forces and their rate of change. Output by NLTRD2. Matrix containing imaginary part of CMAT. Output by MATMOD option 34. Table of element stress/strain or force item code overrides. Starting vector(s). OQG OUG Table of single point forces of constraint due to unit modal displacement in SORT1 or SORT2 format. Output by SDR2 or SDR3. Table of displacements due to unit modal displacement in SORT1 or SORT2 format. Output by SDR2 or SDR3. Integer. If IUNITSOL=0, then trim solution is being supplied. If IUNITSOL>0, then IUNITSOL’th unit solution is being supplied. 6-20 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name Parent Datablock Format Description 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. Matrix defined on DMIG Bulk Data entries and referenced by the K2GG Case Control command. Output by MTRXIN. Matrix defined on DMIG Bulk Data entries and referenced by the K2PP Case Control command. Output by MTRXIN. Structural damping matrix in a-set or d-set. Structural damping matrix in cyclic components. Output by CYCLIC3. Structural damping matrix in any set. Usually h-set or d-set in FRRD1. Stiffness matrix in a-set or d-set. Element stiffness matrix for linear elements only reduced to a-set. Tangential stiffness in d-set. Stiffness matrix for the d-set, linear elements only. K2DD K2GG K2PP K4AA K4KK K4XX KAA KAAL KBDD KDD KDDICT KDELM KDICT KDICT1 KDICTDCN KDICTDS KDICTNL KDICTX KELM KELM1 KELMDCN KDICT KDICT KELM KELM KELM KDICT KELM KDICT KDICT KDELM dictionary table. Output by EMG. Table of element matrices for differential stiffness. Output by EMG. KELM dictionary table. Output by EMG. KELM1 dictionary table. Output by GNFM. KELM dictionary table. which incorporates combined constraints and design variables. Output by DSAF. Perturbed element stiffness matrix dictionary table. If CDIF=’YES’ then this is the forward perturbed element matrix dictionary. Output by EMG. KELMNL dictionary table. Output by EMG. Baseline element stiffness matrix dictionary table for h-elements or p-elements. Output by EMG. Table of element matrices for stiffness, heat conduction, differential stiffness, or follower stiffness. Output by EMG. Table of element matrices for incremental stiffness. Output by GNFM. Table of element matrices for stiffness, heat conduction, differential stiffness, or follower stiffness which incorporates combined constraints and design variables. Output by DSAF. Table of perturbed element stiffness matrices. If CDIF=’YES’ then this is the forward perturbed element matrix dictionary. Output by EMG. Table of element matrices for stiffness for nonlinear elements. Fluid partition of modal stiffness matrix KHH. Stiffness matrix partition (f-set by s-set) from KNN. Stiffness matrix in g-set. Stiffness matrix in g-set with general elements. Output by SMA3. Stiffness (or heat conduction) matrix in g-set for material nonlinear elements only. KELMDS KELMNL KFHH KFS KGG KGG1 KGGNL KELM KELM NX Nastran DMAP Programmer’s Guide 6-21 Chapter 6 Glossaries Datablock Name KGGNL1 KGGT KHH KHH1 KKK KLL KLR KMM KNN KOO KRDD KRFGG KRR KRZX KSAZX KSGG KSS KUX KVAL KXX Parent Datablock Format Description Conduction matrix in g-set for material nonlinear elements only and updated for radiation. Output by RMG2. Total structural stiffness matrix in g-size (sum of linear, nonlinear and differential matrices). Generalized (modal) stiffness matrix. Modified generalized (modal) stiffness matrix. Output by FA1. Stiffness matrix in cyclic components. Output by CYCLIC3. Stiffness matrix reduced to the l-set. Stiffness matrix partition (l-set by r-set) from KTT. Stiffness matrix in m-set (partition of KGG). Stiffness matrix in n-set; after multipoint constraint reduction. Stiffness matrix partitioned to the o-set from KFF. Combined linear and material nonlinear stiffness matrix in the d-set. Stiffness matrix due to follower rotational forces in g-set. Output by EMAKFR. Stiffness matrix partition (r-set by r-set) from KTT. Matrix of restrained dimensional elastic derivatives. Matrix of dimensional rigid stability derivatives that includes the effect of splines. 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. Stiffness matrix partition (s-set by s-set) from KNN. Matrix of stiffness multiplied by displacement or eigenvectors. Table of harmonic indices for analysis. Output by CYCLIC1. Stiffness matrix in any set. Usually v-set in READ. Usually h-set or d-set in CEAD, FRRD1, FRRD2, TRD1, and TRD2. Datablock Name L LAJJT LAM1DD LAMA LAMA* LAMA1 LAMAF LAMAS Parent Datablock Format Description Lower triangular decomposition factor. Output by MATMOD option 21. Lower triangular decomposition factor matrix of AJJT. Lower triangular factor of the dynamic tangential matrix in the d-set. LAMA LAMA LAMA LAMA LAMA Normal modes eigenvalue summary table. Output by READ, LANCZOS, MODACC, and UEIGL. Family of normal modes eigenvalue summary tables. Normal modes eigenvalue summary table updated for mode tracking. Output by MODTRK. Normal modes eigenvalue summary table for the fluid portion of the model. Normal modes eigenvalue summary table for the structural portion of the model. 6-22 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name LAMAX LAMMAT LBTAB Parent Datablock Format LAMA Description Modified LAMA table. Output by LAMX. Diagonal matrix containing eigenvalues on the diagonal. Output by READ, LANCZOS, and UEIGL. Table of eigenvalues and generalized masses for retained buckling eigenvalue responses. Output by DSAH. 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. Character. Label with up to 32 characters to be printed left-justified in upper left corner of each page. Left-handed complex eigenvector matrix in the l-set. Output by CEAD. Left-handed complex eigenvector matrix in the p-set. Left-handed complex eigenvector matrix in the d-set or h-set. Output by CEAD. Lower triangular factor/diagonal. Output by DECOMP and DCMP. Table of eigenvalues and generalized masses for retained normal mode eigenvalue responses. Output by DSAH. Same as SPCPART except LGPART includes grid points not connected to any element. Output by SEQP. Integer. Size of interference js-set extracted from the AEBGPTI table. Output by MTRXIN. Integer. Size of js-set extracted from the AEBGPTJ table. Output by MTRXIN. Integer. Size of ks-set extracted from the AEBGPTK table. Output by MTRXIN. Lower triangular factor/diagonal for the l-set from KLL. Lower triangular factor for nonlinear elements including material, slideline, and differential stiffness effects. Normal modes eigenvalue summary table converted to a matrix. Output by LAMX. Integer. Number of Lagrange Multipliers appended to the A matrix. These rows are excluded from the internal reordering in the DCMP module. Matrix of fluid force to fluid mode participation factors. Output by MODEPF. Vector containing grid locations in the basic coordinate system. Lower triangular factor/diagonal for the o-set from KOO. Output by DCMP. Resequencing matrix based on internal resequencing of KLL. Output by DCMP and DECOMP. Lower triangular factor/diagonal of shifted stiffness matrix. LCDVEC LCOLLBLi LCPHL LCPHP LCPHX LD LFTAB LGPART LISET LJSET LKSET LLL LLLT LMAT LMTROWS LMPF LOCVEC LOO LSEQ LXX Datablock Name M2DD Parent Datablock Format Description Mass matrix contribution from the M2PP Case Control command and reduced to the d-set. NX Nastran DMAP Programmer’s Guide 6-23 Chapter 6 Glossaries Datablock Name M2GG M2PP MA MAA Parent Datablock Format Description Matrix defined on DMIG Bulk Data entries and referenced by the M2GG Case Control command. Output by MTRXIN. Matrix defined on DMIG Bulk Data entries and referenced by the M2PP Case Control command. Output by MTRXIN. Rigid body mass matrix for the a-set. Output by EFFMAS. Mass matrix in a-set or d-set. 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. Family of MAPS (superelement upstream to downstream boundary coordinate system, secondary (mirror, identical, and repeated), and release transformation matrix). Table of virtual mass element areas. Output by MGEN. Matrix. Output by MATGEN. Matrices defined on DMIJI Bulk Data entries. Output by MTRXIN. Matrices defined on DMIG Bulk Data entries and intended for the g-set. Output by MTRXIN. Matrices defined on DMIJ Bulk Data entries. Output by MTRXIN. Matrices defined on DMIK Bulk Data entries. Output by MTRXIN. Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI Bulk Data entries. Matrices defined on DMIG Bulk Data entries and intended for the p-set. Output by MTRXIN. Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries. Output by IFP and IFP4. MATPOOL table for the current superelement. Output by SEP2X. MATPOOL table related to hydroelastic analysis. Output by IFP4. Any matrix on slave processors. Any matrix on master processor. Output by DISUTIL. Body table for p-element analysis. Output by GP0. 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. Matrix relating displacements to source strengths. Output by MGEN. Secondary matrix relating displacements to source strengths. Output by MGEN. Mass (or radiation) matrix for the d-set MELM dictionary table. Output by EMG. Matrix of element forces per unit motion of the a-set. Edge table for p-element analysis. Output by GP0. Matrix form of element force output table. Output by DRMH1 and DRMS1. MAPS MAPS* MAR MAT MATIi MATGi MATJi MATKi MATNAMi MATPi MATPOOL MATPOOLS MATPOOLX MATS MATM MBODY MCEIGCC MCHI MCHI2 MDD MDICT MEA MEDGE MEF 6-24 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name MEM MEMF MES MELM MESH MESTNL MEW MFACE MFHH MGG MHH MHH1 MI Mi MIDLIS MKK MKLIST MLAM MLAM2 MLL MLR MOA MOFPi MON MONi MONITOR MOO MPAER MPAERV MPAEUV MPAR MPARV MPFEM Parent Datablock Format Description Modal effective mass matrix. Output by EFFMAS. Modal effective mass fraction table. Output by EFFMAS. Matrix form of element stress or strain output table. Output by DRMH1 and DRMS1. KELM Tble of element mass matrices. Output by EMG. Mesh type for aerodynamic or structural components: ’AERO’ or ’STRU’. Nonlinear element summary table at current step. Output by NLITER and NLTRD2. Modal effective weight matrix. Output by EFFMAS. Face table for p-element analysis. Output by GP0. Fluid partition of modal mass matrix MHH. Mass or radiation matrix in g-size. Generalized (modal) mass matrix Modified generalized (modal) mass matrix. Output by FA1. Modal mass matrix. Output by READ and LANCZOS. Matrix data block. Output by INPUTT4 and input to MATPRN and OUTPUT4. Table of pairs of user-supplied material property identification numbers (MIDs) and internal baseline MIDs. Output by DSABO. Mass matrix in cyclic components. Output by CYCLIC3. Table of Mach number and reduced frequency pairs. Output by GETMKL. Matrix relating element forces to source strengths. Output by MGEN. Secondary matrix relating element forces to source strengths. Output by MGEN. Mass matrix reduced to the l-set. Mass matrix partition (l-set by r-set) from MTT. Mass matrix partition (o-set by a-set) from MFF. Matrix form of the i-th output table. Output by DRMH1 and DRMS1. Merged monitor table. Output by MRGMON. Monitor tables Structural monitor point table. Output by MAKAEMON and MAKMON. Mass matrix partitioned to the o-set from KFF. Elastic restrained loads on aerodynamic monitor points at trim. Elastic restrained monitor point loads on aerodynamic model Elastic unrestrained monitor point loads on aerodynamic model Rigid aerodynamic loads on aerodynamic monitor points at trim. Rigid monitor point loads on aerodynamic model Modal participation factors for effective mass. Output by EFFMAS. NX Nastran DMAP Programmer’s Guide 6-25 Chapter 6 Glossaries Datablock Name MPFMAP MPJN2O MPOOL MPSER MPSERP MPSERV MPSEUV MPSIR MPSIRV MPSIUV MPSR MPSRP MPSRV MPT MPTC MPTN MPTS Parent Datablock Format Description Table describing content of mode participation factor matrices. Output by MODEPF. Mapping matrix to map j-set data from new order to old order. Output by APD. Table of RADSET, RADLST, and RADMTX Bulk Data entry images. Output by VDR. Elastic restrained loads on structural monitor points at trim(excluding inertial loads and static applied loads). Elastic restrained loads on structural monitor points due to static applied loads. Elastic restrained monitor point loads on structural model Elastic unrestrained monitor point loads on structural model Inertial loads on structural monitor points at trim. Inertial restrained monitor point loads on structural model Inertial unrestrained monitor point loads on structural model Rigid aerodynamic loads on structural monitor points at trim (excluding inertial loads and static applied loads). Rigid loads on structural monitor points due to static applied loads. Rigid splined monitor point loads on structural model MPT MPT MPT MPT Table of Bulk Data entry images related to material properties. Output by IFP and IFP6. Copy of MPT except MAT8 records are replaced by equivalent MAT2 records. Output by IFP6, CMPZPR, and DSTA. Updated (optimized) MPT. Output by DOM11. Table of Bulk Data entry images related to material properties for the current superelement. Output by SEP2 and SEP2X. 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. Matrix form of single or multipoint forces-of-constraint output table. Output by DRMH1 and DRMS1. Rigid body mass matrix (r-set by r-set). Output by RBMG4. Stiffness matrix partition (r-set by r-set) from MTT. Table of updated DRESP1 Bulk Data entry images corresponding to the new mode numbering. Output by MODTRK. Matrix form of displacement output table. Output by DRMH1 and DRMS1. Displacement (or temperature) matrix for stiffness (or heat conduction) update. Output by NLITER. Solution matrix from nonlinear transient response analysis in the d-set from the previous subcase. Output by NLTRD2. Matrix of mass multiplied by displacements or eigenvectors. Mass matrix in any set. Usually v-set in READ. Usually h-set or d-set in CEAD, FRRD1, FRRD2, TRD1, and TRD2. MPTX MPT MQG MR MRR MTRAK MUG MUGNI MULNT MUX MXX 6-26 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name MZZ Parent Datablock Format Description Generalized mass matrix based on PHZ. Datablock Name NAMEi NEWDBi NFDICT NLFT NORTAB Parent Datablock Format Description Matrices defined on DMIG Bulk Data entries. Output by MTRXIN. Input table in Version 69 (or greater) format. Output by MAKENEW. Nonlinear element energy/force index table. Output by TA1. Nonlinear Forcing function table. Output by DPD. Table containing fluid face and the maximum of eight structural grids which lie within the acoustic face. Output by GP5. Datablock Name Parent Datablock Format OBJTAB OBJTAB OBJTAB Description OBJTAB OBJTBG OBJTBR OCCORF OCEIG OCPSDF OEDE1 OEDS1 OEEATO2 OEECRM2 OEENO2 OEEPSD2 OEERMS2 OEF OEF1 OEF1A OEF1AA OEF1DS Design objective table for a given analysis type and superelement. Objective attributes with retained response identification number. Output by DOPR3. Design objective table. Objective attributes with retained response identification number. Table of design objective attributes with retained response identification number. Output by DSAD. Output table of cross-correlation functions. Output by RANDOM. Complex eigenvalue extraction report. Output by CEAD. Output table of cross-power-spectral-density functions. Output by RANDOM. Elemental energy loss. Output by GPFDR. OES OEE Table of element stress discontinuities. Output by STDCON. Table of element strains in SORT2 format for the autocorrelation function. Output by RANDOM. Table of element strains in SORT2 format for the cross correlation function. Output by RANDOM. OEE OEE OEE OEF OEF OEF OEF OEF Table of element strains in SORT2 format for the NO function. Output by RANDOM. Table of element strains in SORT2 format for the PSD function. Output by RANDOM. Table of element strains in SORT2 format for the RMS function. Output by RANDOM. Table of element forces in SORT1 or SORT2 format. Output by DDRMM. Table of element forces (or fluxes) in SORT1 format. Output by SDR2 or DRMH3. Table of element forces in SORT1 format for the composite elements only. Output by SDR2. Table of element forces in SORT1 format for the non-composite elements only. Output by SDRCOMP. Table of element forces, excluding non-composite elements, in SORT1 format for design responses. NX Nastran DMAP Programmer’s Guide 6-27 Chapter 6 Glossaries Datablock Name Parent Datablock Format OEF Description OEF1VU Table of element forces in SORT1 format for view elements. Output by SDRP. Table of element forces in SORT1 format updated for PLOAD1 loads and intermediate station output. Output by SDRX and SDRXD. Table of element forces in SORT2 format. Table of element forces in SORT1 format for the autocorrelation function. Table of element forces in SORT1 format in the material coordinate system for the autocorrelation Table of element forces in SORT2 format for the autocorrelation function. Output by RANDOM. Table of element forces in SORT2 format in the material coordinate system for the autocorrelation. Output by RANDOM. Table of element forces in SORT1 format for the CRMS function. Table of element forces in SORT1format in the material coordinate system for the CRMS function. Table of element forces in SORT2 format for the cross correlation function. Output by RANDOM. Table of element forces in SORT2 format in the material coordinate system for the CRMS function. Output by RANDOM. Table of element forces, excluding non-composite elements, in SORT1 format for the perturbed configuration. Table of composite element failure indices. Output by SDRCOMP. Table of composite element failure indices for design responses. Table of composite element failure indices for the perturbed configuration. Table of nonlinear element fluxes in SORT1 format. Output by SDR2. Table of element forces in SORT1 format for the NO function. Table of element forces in SORT1 format in the material coordinate system for the NO function. Table of element forces in SORT2 format for the NO function. Output by RANDOM. Table of element forces in SORT2 format in the material coordinate system for the NO function. Output by RANDOM. Table of element forces in SORT1 format for the PSD function. Table of element forces in SORT1 format in the material coordinate system for the PSD function. Table of element forces in SORT2 format for the PSD function. Output by RANDOM. Table of element forces in SORT2 format in the material coordinate system for the PSD function. Output by RANDOM. Table of element forces in SORT1 format for the RMS function. OEF1X OEF2 OEFATO1 OEFATO1M OEFATO2 OEFATO2M OEFCRM1 OEFCRM1M OEFCRM2 OEFCRM2M OEFDSN OEFIT OEFITDS OEFITDSN OEFNL1 OEFNO1 OEFNO1M OEFNO2 OEFNO2M OEFPSD1 OEFPSD1M OEFPSD2 OEFPSD2M OEFRMS1 OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF OEF 6-28 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name Parent Datablock Format OEF OEF OEF Description OEFRMS1M OEFRMS2 OEFRMS2M OEIG OEKE1 OEP OES OES1 OES1C OES1CDS OES1DS OES1M OES1G OES1VU OES1X OES2 OES2GX OESATO1 OESATO1M OESATO2 OESATO2M OESCDSN OESCRM1 OESCRM1M OESCRM2 OESCRM2M Table of element forces in SORT1 format in the material coordinate system for the RMS function. Table of element forces in SORT2 format for the RMS function. Output by RANDOM. Table of element forces in SORT2 format in the material coordinate system for the RMS function. Output by RANDOM. Real eigenvalue extraction report. Output by READ. Elemental kinetic energy. Output by GPFDR. Table of element pressures due to virtual mass in SORT1 or SORT2 format. Output by MDATA. OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES OES Table of element stresses or strains in SORT1 or SORT2 format. Output by DDRMM. 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. Table of composite element stresses or strains in SORT1 format. Output by SDRCOMP. Table of composite element stresses in SORT1 format for design responses. Table of element stresses in SORT1 format for design responses. Element stress or strain table in SORT1 format in the material coordinate system defined on the MAT1 entry. Output by CURV. Grid point stress or strain table in SORT1 format and interpolated from the centroidal stress table, OES1M. Output by CURV. Table of element stresses in SORT1 format for view elements. Output by SDRP. 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. Table of element stresses or strains in SORT2 format. Table of grid point stresses in SORT2 format. Output by CURVPLOT. Table of element stresses in SORT1 format for the autocorrelation function. Table of element stresses in SORT1 format in the material coordinate system for the autocorrelation function. Table of element stresses in SORT2 format for the autocorrelation function. Output by RANDOM. Table of element stresses in SORT2 format in the material coordinate system for the autocorrelation function. Output by RANDOM. Table of composite element stresses in SORT1 format for the perturbed configuration. Table of element stresses in SORT1 format for the CRMS function. Table of element stresses in SORT1 format in the material coordinate system for the CRMS function. Table of element stresses in SORT2 format for the CRMS function. Output by RANDOM Table of element stresses in SORT2 format in the material coordinate system for the CRMS function. Output by RANDOM NX Nastran DMAP Programmer’s Guide 6-29 Chapter 6 Glossaries Datablock Name OESDSN OESNL1 OESNLB1 OESNLXR OESNO1 OESNO1M OESNO2 OESNO2M Parent Datablock Format OES OES OES OES OES OES OES OES Description Table of element stresses in SORT1 format for the perturbed configuration Table of nonlinear element stresses in SORT1 format. Output by NLTRD, NLTRD2, and SDRNL. Table of slideline contact element stresses in SORT1 format. Output by NLTRD2 and SDRNL. Table of nonlinear element stresses in SORT1 format and appended for all subcases (OESNLX from SDRNL). Table of element stresses in SORT1 format for the NO function. Table of element stresses in SORT1 format in the material coordinate system for the NO function. Table of element stresses in SORT2 format for the NO function. Output by RANDOM. Table of element stresses in SORT2 format in the material coordinate system for the NO function. Output by RANDOM. Table of element stresses in SORT1 format for the PSD function. Table of element stresses in SORT1 format in the material coordinate system for the PSD function. Table of element stresses in SORT2 format for the PSD function. Output by RANDOM. Table of element stresses in SORT2 format in the material coordinate system for the PSD function. Output by RANDOM. Table of element stresses in SORT1 format for the RMS function. Table of element stresses in SORT1 format in the material coordinate system for the RMS function. Table of element stresses in SORT2 format for the RMS function. Output by RANDOM. Table of element stresses in SORT2 format in the material coordinate system for the RMS function. Output by RANDOM. Table of composite element ply strength ratio. Output by SDRCOMP Table of fluid modal participation factors by natural modes in SORT2 format. Output by RANDOM. Element data recovery table in SORT1 or SORT2 format. Filtered and sorted element data recovery table. Output by STRSORT. Output table suitable for processing by the OFP module. Output table in SORT1 format usually created by, but not limited to, the SDR2 module. Output table in SORT2 format. Output table in SORT2 or SORT1 format. Output by SDR3. Table of grid point stress discontinuities. Output by STDCON. OESPSD1 OES OESPSD1M OESPSD2 OESPSD2M OESRMS1 OESRMS1M OESRMS2 OESRMS2M OESRT OFMPF2M OFPE OFPES OFPi OFPi1 OFPi2 OFPiX OGDS1 OGPFB1 OGPKE1 OES OES OES OES OES OES OES OEF OGF Table of grid point forces. Output by GPFDR. Table of grid point kinetic energies in SORT1 format. Output by SDR2. 6-30 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name Parent Datablock Format Description OGPMPF2M OGPWG OGS1 Oi OINT OINTDS OINTDSF OL OLDDBi OLF OLMPF2M ONRGY1 ONRGYDS ONRGYDSN OPG1 OPG2 OPG2X OPGATO1 OEE OEE OPG OPG OPG OPG OGS Table of panel grid modal participation factors by natural modes in SORT2 format. Output by RANDOM. Grid point weight generator table in weight units. Output by GPWG or VECPLOT (option 7). Table of grid point stresses or strains in SORT1 format. Output by GPSTR2. Outputs of MATMOD module. P-element output control table. Contains OUTPUT Bulk Data entries. Output by IFP. P-element output control table for constrained elements. Output by DOPR3. P-element output control table for the perturbed configuration. Output by DSAH. Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list. Output by CEAD, READ, TRLG, and FRLG. Output table in pre-Version 69 format. Output by MAKEOLD. Nonlinear static load factor list. Table of load modal participation factors by natural modes in SORT2 format. Output by RANDOM. Table of element strain energies and energy densities. Output by GPFDR. Table of element strain energies in SORT1 format for design responses. Output by GPFDR. Table of element strain energies and energy densities in SORT1 format for design responses for the perturbed configuration. Table of applied loads in SORT1 format. Output by SDR2. Table of applied loads in SORT2 format. Table of applied loads in SORT2 format. Output by CURVPLOT. Table of applied loads in SORT1 format for the autocorrelation function. Table of applied loads in SORT2 format for the autocorrelation function. Output by RANDOM. Table of applied loads in SORT1 format for the cross correlation function. Table of applied loads in SORT2 format for the cross correlation function. Output by RANDOM. Table of applied loads in SORT1 format for the NO function. Table of applied loads in SORT2 format for the NO function. Output by RANDOM. Table of applied loads in SORT1 format for the PSD function. Table of applied loads in SORT2 format for the PSD function. Output by RANDOM. Table of applied loads in SORT1 format for the RMS function. Table of applied loads in SORT2 format for the RMS function. Output by RANDOM. Table of panel modal participation factors by natural modes in SORT2 format. Output by RANDOM. OPGATO2 OPGCRM1 OPGCRM2 OPGNO1 OPGNO2 OPGPSD1 OPGPSD2 OPGRMS1 OPGRMS2 OPMPF2M OPG OPG OPG OPG OPG OPG OPG OPG OPG NX Nastran DMAP Programmer’s Guide 6-31 Chapter 6 Glossaries Datablock Name OPNL1 OPTPRM OPTPRMG OPTNEW OQG OQG1 OQG1DS OQG2 OQG2X OQGATO1 OQGATO2 OQGCRM1 OQGCRM2 OQGDSN OQGNO1 OQGNO2 OQGPSD1 OQGPSD2 OQGRMS1 OQGRMS2 OQMATO1 OQMATO2 Parent Datablock Format Description Table of nonlinear loads in SORT1 format for the h-set or d-set. Output by VDR. OPTPRM OPTPRM Table of optimization parameters. Table of optimization parameters. Updated table of optimization parameters. Output by DOM12. OQG OQG OQG OQG OQG OQG OQG Table of single or multipoint forces-of-constraint in SORT1 or SORT2 format. Output by DDRMM. Table of single or multipoint forces-of-constraint in SORT1 format. Output by SDR2 or DRMH3. Table of single point forces-of-constraint in SORT1 format for design responses. Table of single point forces of constraint in SORT2 format. Table of single point forces of constraint in SORT2 format. Output by CURVPLOT. Table of single point forces of constraints in SORT1 format for the autocorrelation function. Table of single point forces of constraints in SORT2 format for the autocorrelation function. Output by RANDOM. Table of single point forces of constraint in SORT1 format for the cross correlation. Table of single point forces of constraint in SORT2 format for the cross correlation. Output by RANDOM. OQG OQG OQG OQG OQG OQG OQG OQG OQG Table of single forces-of-constraint in SORT1 format for design responses for the perturbed configuration. Table of single point forces of constraint in SORT1 format for the NO function. Table of single point forces of constraint in SORT2 format for the NO function. Output by RANDOM. Table of single point forces of constraint in SORT1 format for the PSD function. Table of single point forces of constraint in SORT2 format for the PSD function. Output by RANDOM. Table of single point forces of constraints in SORT1 format for the RMS function. Table of single point forces of constraints in SORT2 format for the RMS function. Output by RANDOM. Table of multipoint forces of constraint in SORT1 format for the autocorrelation function. Table of multipoint forces of constraint in SORT2 format for the autocorrelation function. Output by RANDOM. Table of multipoint forces of constraints in SORT1 format for the CRMS function. Table of multipoint forces of constraints in SORT2 format for the CRMS function. Output by RANDOM OQG OQG Table of multipoint forces of constraint in SORT2 format. Table of multipoint forces of constraint in SORT1 format for the NO function. OQMCRM1 OQMCRM2 OQMG2 OQMNO1 6-32 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name Parent Datablock Format OQG OQG OQG OQG OQG Description OQMNO2 OQMPSD1 OQMPSD2 OQMRMS1 OQMRMS2 OSMPF2M OSTATO1M OSTATO2M OSTCRM1M OSTCRM2M OSTNO1M OSTNO2M OSTPSD1M OSTPSD2M OSTR1CDS OSTR1DS OSTR1G OSTR1VU OSTR1X OSTR2 OSTRATO1 OSTRATO2 OSTR2GX OSTRCDSN OSTRCRM1 OSTRCRM2 Table of multipoint forces of constraint in SORT2 format for the NO function. Output by RANDOM. Table of multipoint forces of constraint in SORT1 format for the PSD function. Table of multipoint forces of constraint in SORT2 format for the PSD function. Output by RANDOM. Table of multipoint forces of constraint in SORT1 format for the RMS function. Table of multipoint forces of constraints in SORT2 format for the RMS function. Output by RANDOM. Table of structural modal participation factors by natural modes in SORT2 format. Output by RANDOM. OES OES OES OES OES OES OES OES OEE OEE OEE OEE Table of element strains in SORT1 format in the material coordinate system for the autocorrelation function. Table of element strains in SORT2 format in the material coordinate system for the autocorrelation function. Output by RANDOM. Table of element strains in SORT1 format in the material coordinate system for the CRMS function. Table of element strains in SORT2 format in the material coordinate system for the CRMS function. Output by RANDOM Table of element strains in SORT1 format in the material coordinate system for the NO function. Table of element strains in SORT2 format in the material coordinate system for the NO function. Output by RANDOM. Table of element strains in SORT1 format in the material coordinate system for the PSD function. Table of element strains in SORT2 format in the material coordinate system for the PSD function. Output by RANDOM. Table of composite element strains in SORT1 format for design responses. Table of element strains in SORT1 format for design responses. Table of grid point strains in SORT1 format. Output by CURV. Table of element strains in SORT1 format for view elements. Output by SDRP. Table of element strains in SORT1 format augmented with strains for 1-D elements. Output by SDRX and SDRXD. OEE OES OES OEE OEE OES OES Table of element strains in SORT2 format. Table of element strains in SORT1 format for the autocorrelation function. Table of element strains in SORT2 format for the autocorrelation function. Output by RANDOM. Table of grid point strains in SORT2 format. Output by CURVPLOT. Table of composite element strains in SORT1 format for the perturbed configuration. Table of element strains in SORT1 format for the CRMS function. Table of element strains in SORT2 format for the CRMS function. Output by RANDOM NX Nastran DMAP Programmer’s Guide 6-33 Chapter 6 Glossaries Datablock Name OSTRDSN OSTRMS1M OSTRMS2M OSTRNO1 OSTRNO2 OSTRPSD1 OSTRPSD2 OSTRRMS1 OSTRRMS2 OUG OUG1 OUG1DS OUG1VU OUG2 OUG2X OUGATO1 OUGATO2 OUGCRM1 OUGCRM2 OUGDSN OUGNO1 OUGNO2 OUGPSD1 OUGPSD2 OUGRMS1 OUGRMS2 OUGV1 OUGV2 OUTVEC OUXY1 OVG Parent Datablock Format OEE OES OES OES OES OES OES OES OES OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG OUG Description Table of element strains in SORT1 format for the perturbed configuration Table of element strains in SORT1 format in the material coordinate system for the RMS function. Table of element strains in SORT2 format in the material coordinate system for the RMS function. Output by RANDOM. Table of element strains in SORT1 format for the NO function. Table of element strains in SORT2 format for the NO function. Output by RANDOM. Table of element strains in SORT1 format for the PSD function. Table of element strains in SORT2 format for the PSD function. Output by RANDOM. Table of element strains in SORT1 format for the RMS function. Table of element strains in SORT2 format for the RMS function. Output by RANDOM. Table of displacements in SORT1 or SORT2 format. Output by DDRMM. Table of displacements in SORT1 format. Output by SDR2 or DRMH3. Table of displacements in SORT1 format for design responses. Table of displacements in SORT1 format for view grids. Output by SDRP. Table of displacements in SORT2 format. Table of displacements in SORT2 format. Output by CURVPLOT. Table of displacements in SORT1 format for the autocorrelation function. Table of displacements in SORT2 format for the autocorrelation function. Output by RANDOM. Table of displacements in SORT1 format for the cross correlation function. Table of displacements in SORT2 format for the cross correlation function. Output by RANDOM. Table of displacements in SORT1 format for design responses for the perturbed configuration. Table of displacements in SORT1 format for the NO function. Table of displacements in SORT2 format for the NO function. Output by RANDOM. Table of displacements in SORT1 format for the PSD function. Table of displacements in SORT2 format for the PSD function. Output by RANDOM. Table of displacements in SORT1 format for the RMS function. Table of displacements in SORT2 format for the RMS function. Output by RANDOM. Table of absolute displacement, velocity and acceleration in SORT1 format. Table of absolute displacement, velocity and acceleration in SORT2 format. Last vector block (Lanczos only). Output by READ. OUG Table of displacements in SORT1 format for h-set or d-set. Output by VDR. Table of aeroelastic x-y plot data for V-g or V-f curves. Output by FA2. 6-34 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name OXRESP Parent Datablock Format Description Table of response spectra in SORT2 format. Output by RSPEC. Datablock Name P2G PA PA* PAK PANSLT Parent Datablock Format Description Matrix defined on DMIG Bulk Data entries and referenced by the P2G Case Control command. Output by MTRXIN. Static load matrix reduced to the a-set. Output by SSG2. Family of static load matrices (PA) applied on the boundary (a-set) of all upstream superelements. Aerodynamic forces at aerodynamic boxes. Panel static load table. Output by GP5. 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. PARTVEC PBGPDT PBYG PC PC1 PCDB PCDBS BGPDT Basic grid point definition table updated to support plotting CHBDYi elements. Output by PLTHBDY. Matrix of equivalent static loads due to enforced velocity for the g-set. Optional stepwise preconditioner in SOLVIT and STATICS, same as A and KGG respectively. Updated stepwise preconditioner matrix. Output by SOLVIT and STATICS. Table of model (undeformed and deformed) plotting commands. Output by IFP1. Table of model (undeformed and deformed) plotting commands for the current superelement (identification number equal to output value of SEID). Output by SEP2CT. Table of model (undeformed and deformed) plotting commands for the superelement (identification number equal to output value of SEID). Output by SEDR. Table containing LAM option input and expanded information from the PCOMP Bulk Data entry. Table containing LAM option input and expanded information from the PCOMP Bulk Data entry. Output by IFP6. PCOMPT with design variable perturbations. Output by DSABO. Dynamic load matrix for the d-set. Equivalent load vector for mode acceleration computations for the a-set. Output by DDR2. Frequency response load matrix in the d-set. Output by FRLG. Transient response load matrix in the d-set for output time steps. Output by TRLG. Transient response load matrix in the d-set for all time steps. Output by TRLG. Element connectivity table updated to support plotting CHBDYi elements. Output by PLTHBDY. PCDBDR PCOMPT PCOMPTC PCOMPTX PD PD1 PDF PDT PDT1 PECT NX Nastran DMAP Programmer’s Guide 6-35 Chapter 6 Glossaries Datablock Name PELSDSF PELSET PELSETDS PFHF PFP PG PG1 PGG PGT PGUP PGVST PHA PHA1 PHAREF1 PHASH2 PHDFH PHDH PHF PHF1 PHG PHG* PHG1 PHGREF PHGREF1 PHIDLL PHIDRL PHT Parent Datablock Format Description P-element set table for the perturbed configuration. Output by DSAH. P-element set table, contains SETS DEFINITIONS. Output by PLTSET. P-element set table for constrained elements. Output by DOPR3. Fluid partition of frequency response modally reduced load matrix. Frequency response load matrix in the p-set combined with gust loads. Output by GUST. 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. Combined static load matrix for the g-set and in the residual structure. Output by PCOMB. Force matrix in g-set for all processors (global). Output by DISUTIL. Static load matrix applied to the g-set appended for all boundary conditions. Output by SDR1. Static load matrix for the g-set and in the residual structure due to static loads in upstream superelements only. Static load vector matrix (g-set). Output by MAKAEFS. Normal modes eigenvector matrix in the a-set. Output by READ. Normal modes eigenvector matrix in the a-set updated for mode tracking. Output by MODTRK. Designed normal modes eigenvector matrix in the a-set updated for mode tracking. Output by MODTRK. Structural partition (row-wise) of eigenvector matrix PHDH. Also partitioned column-wise according to parameter STRUCTMP. Fluid partition (row-wise) of eigenvector matrix PHDH. Transformation matrix from d-set to h-set (modal). Output by GKAM. Frequency response load matrix in the h-set (modal). Output by FRLG. Frequency response load matrix in the h-set (modal) combined with gust loads. Output by GUST. Normal modes eigenvector matrix in the g-set. Output by READ and LANCZOS. Family of normal modes eigenvector matrices in the g-set. Normal modes eigenvector matrix in the g-set updated for mode tracking. Output by MODTRK. Designed normal modes eigenvector matrix in the g-set from the prior design cycle output of MODTRK. Output by MODTRK. Designed normal modes eigenvector matrix in the g-set updated for mode tracking. Output by MODTRK. Retained left divergence eigenvector responses. Retained right divergence eigenvector responses. Transient response load matrix in the h-set (modal) for all time steps. Output by TRLG. 6-36 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name PHX PHXL PHZ PJ PKF PKYG PL PLI PLIST2 PLIST2* PLMAT PLOTMSG PLSETMSG PLTPAR PMPF PMYG PNL PNLLST PO POI POSTCDB PPF PPT PPVR PRBDOFS PROPI PROPI* PROPO PS Parent Datablock Format Description Right eigenvector matrix for real eigenvalues only. Output by UEIGL. Left eigenvector matrix for real eigenvalues only. Output by UEIGL. Generalized degree-of-freedom transformation matrix. Output by DYNREDU. Static load matrix for the g-set of the current superelement and applied to its interior points only. Matrix of k-set forces per frequency. Matrix of equivalent static loads due to enforced displacement for the g-set. Static load matrix reduced to the l-set. Output by SSG2. Static load matrix with inertial loads and reduced to the l-set. Output by SSG4. Table of type two properties on DVPREL2 Bulk Data entries. Output by DOPR1. Family of tables of type two properties on DVPREL2 Bulk Data entries. Output by DOPR1. Initial and final load matrices for subcase. Table of user informational messages generated during the plot process. Output by PLOT. Table of user informational messages generated during the definition of element plot sets. Output by PLTSET and SEPLOT. Table of plot parameters and plot control. Output by PLTSET and SEPLOT. Matrix of contribution of structural panels to fluid mode participation factors. Output by MODEPF. Matrix of equivalent static loads due to enforced acceleration for the g-set. Nonlinear load matrix appended from each output time step. Output by NLTRD, NLTRD2, TRD1, and TRD2. Table of triplets defining panel names and their associated IPANEL qualifier values Static load matrix partitioned to the o-set. Output by SSG2. Static load matrix with inertial loads and reduced to the o-set. Output by SSG4. Table of commands from the OUTPUT(POST) section of Case Control. Output by IFP1. Frequency response load matrix in the p-set. Output by FRLG. Transient response load matrix in the p-set for output time steps. Output by TRLG. Partitioning vector for random responses. Output by DOPRAN. 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. Matrix of initial property values. Output by DOPR1. Family of matrices of initial property values. Output by DOPR1. Matrix of final (optimized) property values. Output by DOM9. Static load matrix partitioned to the s-set. Output by SSG2. NX Nastran DMAP Programmer’s Guide 6-37 Chapter 6 Glossaries Datablock Name PSDF PSDL PSF PSI PST PTELEM PTELEM0 PTELMDCN PTELMDSX PUG PUG* PUGD PUGS PUGX PVAL0 PVAL1 PVEC Parent Datablock Format Description Power spectral density table. Output by RANDOM. Power spectral density list. Output by DPD. Frequency response load matrix in the s-set. Output by FRLG. Modal partitioning factor matrix. Transient response load matrix in the s-set for output time steps. Output by TRLG. Table of thermal loads in the elemental coordinate system. Output by SSG1. Table of thermal loads in the elemental coordinate system from prior subcase. Output by SSG1. Table of thermal loads in the elemental coordinate system which incorporates combined constraints and design variables. Output by DSAF. Table of thermal loads in the elemental coordinate system for the central, forward, or backward perturbed configuration. Output by SSG1. Matrix of translational displacements. Output by SDR2. Family of matrices of translational displacements for all superelements. Matrix of translational displacements in dynamic analysis. Output by SDR2. Matrix of translational displacements in static analysis. Output by SDR2. PUG assembled for superelements defined on the SEPLOT or SEUPPLOT command. Output by SEPLOT. P-value table generated by the ADAPT module in previous superelement, adaptivity cycle, or run. P-value table updated for current superelement or adaptivity loop. Output by ADAPT. Partitioning vector for supported degrees-of-freedom specified on CYSUP Bulk Data entry. Output by CYCLIC3. 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. Partitioning vector with ones at rows corresponding to degrees-of-freedom at which static and dynamic loads are applied. Output by OUTPRT. 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. 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. Table containing parameter values from PARAM Bulk Data entry images. Output by IFP. Table containing parameter values which are resolved from values in PVT, CASECC, and, optionally, the NDDL. Output by PVT. Inertial or pseudo-load matrix. Output by DSAP. PVGRID PVLOAD PVMPC PVSPC PVT PVTS PX 6-38 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name PXF PXT PXT1 PZ Parent Datablock Format Description Frequency response load matrix in h-set (modal) or d-set. Transient response load matrix in the h-set (modal) or d-set. Output by TRLG. Reduced transient response load matrix analysis. Output by DSAR. Reduced aerostatic loads matrix. Datablock Name QG QHH QHHL QHJ QHJK QHJL QKH QKHL QLL QMG QNV QR QXX Parent Datablock Format Description Single-point constraint forces of constraint matrix in the g-set. Output by LANCZOS, STATICS, and SDR1. Aerodynamic matrix of size h- by h-set. Output by AMP. Aerodynamic matrix list Aerodynamic matrix of size h- by j-set. Output by AMP. Aero transformation matrix between h and j sets. Output by GUST. Aero transformation matrix between h and j sets. Aerodynamic matrix of size k- by h-set. Output by AMP. Aero transformation matrix between h and k sets. Aerodynamic matrix for divergence analysis. Multipoint constraint forces of constraint matrix in the g-set. Output by LANCZOS and STATICS. Quasi-Newton sweeping vectors. Output by NLITER. Matrix of determinate support forces. Output by SSG2. Aerodynamic matrix in any set. Datablock Name R R1MAPR R1TAB R1TABR R1TABRG R1VAL R1VALO R1VALR R1VALRG R2MAPR Parent Datablock Format Description Residual matrix. Output by SOLVIT. R1MAP Table of mapping from original first level (direct) retained responses. Output by DSAD. Table of first level (direct) (DRESP1 Bulk Data entry) attributes. Output by DOPR3. Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes. Output by DSAD. Table of attributes of the retained first level (direct) responses. Matrix of initial values of the retained first level (direct) responses. Output by DSAD. Matrix of final (optimized) values of the retained first level (direct) responses. Output by DOM9. Matrix of retained type one responses. Output by DSAD. Matrix of initial values of the retained first level (direct) responses. Table of mapping from original second level (synthetic) retained responses. Output by DSAD. NX Nastran DMAP Programmer’s Guide 6-39 Chapter 6 Glossaries Datablock Name R2VAL R2VALO R2VALR R2VALRG R3VAL R3VALO R3VALR R3VALRG RADAMPG RADAMPZ RADCONS RADDATC RADEATC RADEFFM RADEFMP RADNATC RAECONS RAEDATC RAEEATC RAENATC RAFCONS RAFDATC RAFEATC RAFNATC RAGCONS RAGDATC RAGEATC RAGNATC RALDATC RANCONS RANDATC RANEATC Parent Datablock Format Description Matrix of initial values of the retained second level (synthetic) responses. Output by DSAD. Matrix of final (optimized) values of the second level (synthetic) responses. Output by DOM9. Matrix of retained second level (synthetic) responses. Matrix of initial values of the retained second level (synthetic) responses. Matrix of initial values of the retained third level responses. Output by DSAD. Matrix of final values of the third level responses. Output by DOM9. Matrix of initial values of the retained third level responses. Output by DSAD. Matrix of initial values of the retained third level responses. Structural damping ratio matrix Viscous damping ratio matrix OUG OUG OUG OUG OUG OUG OES OES OES OES OEF OEF OEF OEF OEF OEF OEF OEF OPG OEE OEE OEE Displacement Constraint Mode Displacement Distributed Attachment Mode Displacement Equivalent Inertia Attachment mode Displacement Effective Inertia Mode Displacement PHA^T Displacement Nodal Attachment Mode Strain Constraint Mode Strain Distributed Attachment Mode Strain Equivalent Inertia Attachment mode Strain Nodal Attachment Mode Element Force Constraint Mode Element Force Distributed Attachment Mode Element Force Equivalent Inertia Attachment mode Element Force Nodal Attachment Mode Grid Point Forces Constraint Mode Grid Point Forces Distributed Attachment Mode Grid Point Forces Equivalent Inertia Attachment mode Grid Point Forces Nodal Attachment Mode Load vector used to compute the Distributed Attachment modes Strain Energy Constraint Mode Strain Energy Distributed Attachment Mode Strain Energy Equivalent Inertia Attachment mode 6-40 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name RANNATC RARCONS RARDATC RAREATC RARNATC RASCONS RASDATC RASEATC RASNATC RBF RCROSSL RDEST RECM RESMAX RESMAX0 RESP3 RESP3R RESP12 RGG RHMCF RMAT RMATG RMG RMSTAB RMSTABR RMSTBR RMSVAL RMSVALR RMSVLR ROUGV1 ROUGV2 RP Parent Datablock Format OEE OQG OQG OQG OQG OES OES OES OES Description Strain Energy Nodal Attachment Mode Reaction Force Constraint Mode Reaction Force Distributed Attachment Mode Reaction Force Equivalent Inertia Attachment mode Reaction Force Nodal Attachment Mode Stress Constraint Mode Stress Distributed Attachment Mode Stress Equivalent Inertia Attachment mode Stress Nodal Attachment Mode Rigid body force matrix. Table of RCROSS Bulk Data entry images. Output by DPD. Radiation element summary table. Output by RMG2. Radiation exchange coefficient matrix. Output by RMG2. Resultant or maxima matrix. Output by VECPLOT. Resultant or maxima matrix for residual structure. Output by VECPLOT. Table of third level responses. Output by DOPR3. Table of retained third level responses in RESP3. Output by DSAD. RESP12 Table of second level (synthetic) responses. Output by DOPR3. Radiation transfer matrix in the g-set. Output by RMG2. Matrix of dimensional rigid unsplined hinge moment data Matrix containing real part of CMAT. Output by MATMOD option 34. 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. Multipoint constraint equation matrix. Output by GP4. Table of RMS responses. Output by DOPRAN. Table of retained RMS responses in RMSTAB. Output by DSAD. Table of retained RMS responses. Matrix of initial RMS values. Output by DSARME. Matrix of initial values of the retained RMS responses in RMSVAL. Output by DSAD. Matrix of retained RMS values. OUG OUG Table of relative displacement, velocity and acceleration in SORT1 format. Table of relative displacement, velocity and acceleration in SORT2 format. Row partitioning vector. NX Nastran DMAP Programmer’s Guide 6-41 Chapter 6 Glossaries Datablock Name RPX RR2IDR RSLTDATA RSLTSTAT RSP12R RSP1CT RSP2RG RSP3RG RSQUERY RSTAB RUG RUL RUO Parent Datablock Format Description Reduction matrix from p-set to h-set (modal) or d-set. Table of retained referenced type two response identification list. Output by DSAD. Table of actual results data when system cell 297=3. Output by SDRP. Table of result-state information when system cell 297=2. Output by SDRP. RESP12 Table of retained second level (synthetic) responses in RESP12. Output by DSAD. Table of the count of type 1 responses per response type per subcase in R1TAB. Output by DOPR3. RESP12 Table of attributes of the retained second level (synthetic) responses. Table of attributes of the retained third level responses. Table of results state query. Matrix of dimensional rigid stability derivatives generated directly from the aerodynamic model. Residual matrix for the g-set. Output by STATICS. Residual matrix for the l-set. Output by SSG3. Residual matrix for the o-set. Output by SSG3. Datablock Name SCSTM SELIST SEMAP SEQMAP SET SETREE SGPDT SGPDTS SGPDTS* SHPVEC SIL SIL0 SILD SKJ SLIST Parent Datablock Format Description Table of global transformation matrices for partitioned superelements. Output by SEP1X. Table containing the list of partitioned superelements defined in separate Bulk Data sections. Output by SEPR1. SEMAP Superelement map table. Output by SEP1 or SEP1X. Mapping matrix for resequencing. Output by SEQP. SET Table of combined sets. Output by NASSETS. Superelement tree table usually input via the DTI,SETREE Bulk Data entry. Superelement basic grid point definition table. Output by SEP1X. Superelement basic grid point definition table for the current superelement. Output by SEP2X. Family of SGPDTS tables created in previous runs. Matrix of basis vectors - coefficients relating designed grid coordinates and design variables. Output by DOPR2. Scalar index list. Output by GP1. SIL table from a previous adaptivity index in p-version analysis. Scalar index list for the p-set. Output by DPD. Integration matrix. Output by AMG. Superelement processing list to matrix generation, assembly, and reduction. Output by SEP3. 6-42 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name SLT SLT1 SLTH SMPF SNORM* SNORMS SORTBOOL SORTLIST SPCCOL SPCPART SPECSEL SPLINE SPSEL SRKS SRKT STATDATA STBDER STBTAB STRUCOMP SVEC SZR SZRi Parent Datablock Format Description Table of static loads. Output by GP3. Table of static loads updated for nonlinear analysis. Output by NLCOMB. Table of static loads updated for heat transfer analysis. Output by SSG1. Matrix of contribution of structure to fluid mode participation factors. Output by MODEPF. Family of shell normal vectors at superelement boundaries. Table of shell normal vectors on a superelement’s boundary. Output by TASNP1. Square matrix containing unity at a row position in the column associated with the sorted row terms. Output by MATMOD option 35. Vector consisting of the row numbers of the original positions of the sorted terms. Output by MATMOD option 35. Local f-size partitioning vector with 1.0 for the local boundary’s s-set degrees-of-freedom. Required only for geometric domain decomp. Partitioning vector for domain decomposition. Output by SEQP. Response spectra input correlation table. Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external grid identification numbers. Output by MKSPLINE. Table of response spectra generation correlation selections. Matrix of monitor point rigid body vectors. Output by MONVEC. Matrix used to sum the forces and moments acting on the k-set degrees-of-freedom to the reference point. Output by ADG. Table of state information when system cell 297=1. Output by SDRP. Table of aerostatic stability derivatives for a single subcase. Output by SDP. Table of aerostatic stability derivatives for all subcases. Table of structural components when MESH=’STRU’. Output by MAKCOMP. Starting "random" eigenvector matrix. Merged monitor matrices. Output by MRGMON. Associated monitor matrices Datablock Name T TA TAB TABi TABDEQ Parent Datablock Format Description Table information to support MATGEN module options. Diagonal from symmetric decomposition. Output by MATMOD option 21. Secondary table to be merged into TOLD to form TNEW. Table. Tables. Table of unique design variable identification numbers. Output by DOPR4. NX Nastran DMAP Programmer’s Guide 6-43 Chapter 6 Glossaries Datablock Name TABECN TABEVP TABEVS TABEV2 TB TC TEF TEL TEMF TES TFPOOL TIMSIZ TNEW TOFPi TOL TOL1 TOLD TOUT TQG TR Parent Datablock Format Description Table of relationship between internal identification numbers of constraints in ESTDCN and elements and responses in R1TABR. Output by DSAF. Cross-reference table between ESTDVP records and element and design variable identification numbers. Output by DSABO. Cross reference table between ESTDVS records and element and design variable identification numbers. Output by DOPR6. Merged cross reference table of TABEVP and TABEVS. Output by DSAE. Secondary table to be merged into TOLD to form TNEW. Secondary table to be merged into TOLD to form TNEW. Directory table for MEF. Output by DRMH1 and DRMS1. Transient response time output list appended from each subcase. Output by NLTRD and NLTRD2. Total effective mass fraction table. Output by EFFMAS. Directory table for MES. Output by DRMH1 and DRMS1. Table of TF Bulk Data entry images. Output by DPD. Table of CPU and disk space estimation parameters. Output by SEQP. Table data block to be edited by TABEDIT. Directory table for MOFPi. Output by DRMH1 and DRMS1. TOL TOL Transient response time output list. Output by IFT, TOLAPP, TRD2 and TRLG. Transient response time output list reduced by the OTIME Case Control command or for the current nonlinear transient subcase. Output by MODACC and TOLAPP. Table data block to be edited by TABEDIT. DRMH1 directory table in table data block or DTI format. Directory table for MQG. Output by DRMH1 and DRMS1. Matrix to transform forces from the support point to the aerodynamic reference point. Output by MAKETR. 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. Transient response list. Output by DPD. Boolean matrix to select accelerations from the list of aerodynamic extra points. Output by ADG. Directory table for MUG. Output by DRMH1 and DRMS1. DRMH1 directory table in DTI or table data block format. Output by DRMH1. TRANTR TRL TRX TUG TXY Datablock Name U Parent Datablock Format Description Upper triangular factor. Output by DECOMP and DCMP. 6-44 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name UA UACCE UAJJT UAM1DD UD UD1 UDISP UE UG UGD UGDS UGDS1 UGG UGNI UGNT UGT UGX UGX1 Parent Datablock Format Description 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). Reduced acceleration solution matrix from transient response analysis. Output by DSAR. Upper triangular decomposition factor matrix of AJJT. Upper triangular factor of the dynamic tangential matrix in the d-set. Solution matrix for the d-set. Displacements only in frequency response. Displacements, velocities, and accelerations in transient response. Improved solution matrix for the d-set. Output by DDR2. Reduced displacement solution matrix from transient response analysis. Output by DSAR. Improved solution matrix for the e-set (extra points). Output by DDR2. Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG can also represent velocity or acceleration. Output by SDR1 and STATICS. Displacement matrix in g-set for the downstream superelement. Displacement matrix in g-set due to pseudo-loads. Displacement matrix in g-set for the total variation. Output by DSVG3. Displacement matrix in g-set for all processors (global). Output by DISUTIL. Displacement matrix at converged step in the g-set. Output by NLITER. Total displacement matrix in the g-set. Output by UGVADD. Updated temperature matrix in g-set. Output by MATMOD option 19. Matrix of analysis model displacements in g-set or p-set. Copy of UGX matrix with null columns in place of the deleted responses. Output by DSAD. Solution matrix for the h-set (modal degrees-of-freedom). Modal displacements only in frequency response. Modal displacements, velocities, and accelerations in transient response. Fluid partition (row-wise) of solution matrix UHF. Also partitioned column-wise according to parameter FLUIDMP. Structural partition (row-wise) of solution matrix UHF. Also partitioned column-wise according to parameter STRUCTMP. Modal displacement vector for spectral analysis. Output by INTERR. Displacement matrix in l-set. Output by SSG3. Unsymmetric eigenvalue summary table. Output by UEIGL. Upper triangular factor for the l-set from KLL. Upper triangular factor for nonlinear elements including material, slideline, and differential stiffness effects. Solution matrix from nonlinear transient response analysis in the d-set. Output by NLTRD and NLTRD2. UH UHFF UHFS UHR UL ULAMA ULL ULLT ULNT NX Nastran DMAP Programmer’s Guide 6-45 Chapter 6 Glossaries Datablock Name UO UOO UPSDT URDDIDX Parent Datablock Format Description Displacement matrix in o-set. Output by SSG3. Displacement matrix in o-set due to applied loads on the o-set with the a-set fixed (set to zero). Table of transfer function data needed for RMS calculations. An instance of an ADBINDX that describes the acceleration entries. Output by MAKETR. 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. URDDUXV USET USET0 USET1 USETD USETM UVELO UX UXDAT UXDIFV UXF UXR UXT UXT1 UXTRIM UXU UXV UXVBRL UXVF UXVP UXVST USET USET USET USET USET Degree-of-freedom set membership table for g-set. Output by GPSP. 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. USET updated with constraints from upstream superelements. Output by BNDSPC. Degree-of-freedom set membership table for p-set. Output by DPD. Modified degree-of-freedom set membership table for g-set. Output by MODUSET. Reduced velocity solution matrix from transient response analysis. Output by DSAR. Matrix of aerodynamic extra point displacements. Output by ASG. Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments. Output by ASG. Derivative interpolation factors matrix at UX = UXREF. Output by ASG and SDP. Solution matrix from frequency response analysis in d- or h-set. Output by FRRD1 or FRRD2. Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of restrained stability derivatives. Output by DSARLP. Solution matrix from transient response analysis in d- or h-set. Output by TRD1, TRD2, and IFT. Reduced solution matrix from transient response analysis. Output by DSAR. UX vector at trim. Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of unrestrained stability derivatives. Output by DSARLP. Control state matrix for ADB or AEDB Controller state matrix for WJVBRL downwash vectors. UXVBRL has NX rows and NV columns. Output by ADG. Matrix of UXVEC vectors defined by the AEFORCE Bulk Data entries. Ouptut by MAKAEFA. Matrix of UXVEC vectors defined by the AEPRESS Bulk Data entries. Ouptut by MAKAEFA. Aerodynamic extra point displacement matrix. Output by MAKAEFS. 6-46 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name UXVW Parent Datablock Format Description Matrix of UXVEC vectors defined by the AEDW Bulk Data entries. Ouptut by MAKAEFA. Datablock Name V01P VDXC VDXR VELEM VELEMDCN VELEMN Parent Datablock Format Description Partitioning vector for sparse load reduction. Partitioning vector with 1.0 at rows corresponding to null columns in KDD, BDD, and MDD. Partitioning vector with 1.0 at rows corresponding to null rows in KDD, BDD, and MDD. Table of element lengths, areas, and volumes. Output by ELTPRT. Table of element lengths, areas, and volumes which incorporates combined constraints and design variables. Output by DSAF. Table of element lengths, areas, and volumes for the perturbed configuration. Output by ELTPRT. 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. Left-handed displacement matrix in g-set. Divergence and flutter analysis only. G-set size partitioning vector with values of 1.0 at the rows corresponding to the a-set. Fluid/structure partitioning vector with ones at the rows corresponding to fluid degrees-of-freedom. Output by GP1. Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to frequency-dependent elements. Output by TA1. G-set size partitioning vector with values of 1.0 at the rows corresponding to the a-set. Partitioning vector with values of 1.0 at rows corresponding to degrees-of-freedom in the q-set. VFO1 VG VGA VGF VGFD VGA VGQ VIEWTB VIEWTBDS VTQU VIEWTB VIEWTB View information table, contains the relationship between each p-element and its view-elements and view-grids. Output by VIEWP. View information table, contains the relationship between each p-element and its view-elements and view-grids for the perturbed model. Output by DVIEWP. Table of flutter sensitivity data. Output by DSFLTE. Datablock Name WGTM WJ WMID WRJVBRL WSKJF Parent Datablock Format Description Table of 6x6 rigid body mass matrix. Output by WEIGHT. Gust matrix. Output by GUST. Table of weight as a function of material identification number. Output by WEIGHT. 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. Weighted integration matrix. NX Nastran DMAP Programmer’s Guide 6-47 Chapter 6 Glossaries Datablock Name WTCRID WTDSCP Parent Datablock Format Description Table of retained weight responses with column and row numbers in rigid mass matrix. Output by DSAW. Partitioning vector for weight. Output by DSAW. Datablock Name X X66 X66P XAA XAA* XD XDD XDICT XDICTDS XDICTX XELM XELMDS XELMX XG XGG XGGi XH XINIT XJJ XNNi XO XORTH XOUT XP XPP Parent Datablock Format Description 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. Triple-product of XG with rigid body modes for IOPT=9 or 10. Output by VECPLOT. 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. Reduced square matrix in a-set. Output by MATREDU. Family of reduced square matrices in a-set pertaining to the upstream superelements. Rectangular matrix of displacements or loads in the p-set. Output by UREDUC. Reduced square matrix in d-set. Output by MATREDU. KDICT KDICT KDICT KELM KELM KELM Baseline element matrix dictionary table. Perturbed element matrix dictionary table. If CDIF=’YES’ then this is the forward or backward perturbed element matrix dictionary. Baseline element matrix dictionary table or backward perturbed element matrix dictionary if CDIF=’YES’. Baseline element matrices. Output by EMG. Table of perturbed element matrices. If CDIF=’YES’ then this is the forward or backward perturbed element matrix dictionary. Baseline element matrices or backward perturbed element matrices if CDIF=’YES’. Rectangular matrix of displacements or loads in the g-set. Square matrix in g-set. In superelement analysis, XGG includes contributions from upstream superelements. Output by EMA and SEMA. Square matrices in g-set. Output by EMA and SEMA. Rectangular matrix of displacements or loads in the h-set (modal). Output by UREDUC. Matrix of initial values of the design variables. Output by DOPR1. Square matrix for the g-set of the current superelement and applied to its interior points only. Square matrices in n-set. Output by MCE2. Matrix of final (optimized) values of the design variables. Cross-orthogonality matrix. Output by CEAD and UEIGL. Resultant to table output. Output by VECPLOT. Rectangular matrix of displacements or loads in the p-set Square matrix in p-set. 6-48 NX Nastran DMAP Programmer’s Guide Glossaries Datablock Name Parent Datablock Format Description 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. S-set by f-set matrix partition of XGG or XPP after multipoint constraint elimination and reduction. Output by MATREDU. S-set by s-set matrix partition of XGG or XPP after multipoint constraint elimination and reduction. Output by MATREDU. Table of x-y plotting commands. Output by IFP1. Table of x-y plotting commands for a superelement (identification number equal to output value of SEID). Output by SEDR. Table of x-y plotting commands for the current superelement (identification number equal to output value of SEID). Output by SEP2CT. Table of x-y plot control values. Output by XYTRAN. Matrix containing the constant portion of the dependent to independent design variable linking relationship. Output y DOPR1. XS XSF XSS XYCDB XYCDBDR XYCDBS XYPLOT XZ Datablock Name YGBNDR YPF YPO YPT YS YS0 YS1 YSD YSD1 YSMAT Parent Datablock Format Description Boundary shape matrices appended for all auxiliary or geometric models. Frequency response enforced motion matrix in the p-set. Output by FRLG. Transient response enforced motion matrix in the p-set and for the output time steps. Output by TRLG. Transient response enforced motion matrix in the p-set. Output by TRLG. Matrix of enforced displacements or temperatures. Output by GPSP. Matrix of enforced displacements temperatures usually prior to Auto-SPC update in GPSP. Output by GP4. YS updated with enforced displacements from upstream superelements. Output by BNDSPC. Accumulated matrix of enforced displacements from upstream superelements. YSD updated with enforced displacements from upstream and current superelements to be passed to downstream superelements. Output by BNDSPC. Initial and final enforced displacement matrices. Datablock Name ZETAH Z1ZX ZZX Parent Datablock Format Description Mass-normalized damping. Matrix of unrestrained dimensional elastic derivatives Reduced aerostatic solution matrix. NX Nastran DMAP Programmer’s Guide 6-49 Chapter 6 Glossaries Data Block Naming Conventions Stiffness, Damping, and Mass: K_____ KD____ B_____ K4____ __2DD M____ ___JJ L__, U__ Stiffness Differential stiffness Viscous damping Structural damping (See GE field on MATi entries) Stiffness in dynamic formulation Mass Stiffness, damping, and mass matrices without upstream superelement contributions. Exception: __AJJ_ is the aerodynamic influence matrix. Lower and upper triangular decomposition factors Some of the above names may be prefixed with a "C" to indicate a complex matrix. Superelements: CM____ _____S __LIST MAPS SEMAP Superelement (component) modes Assigned only to SEP2 and GP1 module outputs Superelement processing list; for example, SLIST, DRLIST, and DSLIST Superelement boundary grid map Superelement map Loads and Solutions: A_____ B_____ C_____ CY____ F_____ _____F _____T ___NL_ _____NI ___PH__ PH____ CPH___ BPH___ Aeroelastic or aerostatic Buckling Complex modes Cyclic symmetry Flutter Frequency response Transient response Nonlinear static or transient response; for example, USETNL, ESTNL and OESNLX Nonlinear static or transient response generated in a nonlinear loop. Eigensolution Normal modes eigenvector matrix; for example, PHG (g-set) and PHA(a-set) Complex modes eigenvector matrix; for example, CPHD (d-set) and CPHL (l-set). Buckling eigenvector matrix; for example, BPHA (a-set) 6-50 NX Nastran DMAP Programmer’s Guide Glossaries Solutions: ___U___ ___Q___ ___QM__ CMPH___ __LAMA __UH__ __OL__ ___NT__ _____N Static and dynamics (except eigen-) solution; for example, CYUG is the cyclic static solution g-set 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 Multipoint forces of constraint in statics and dynamics solution; for example, QMG, QMPT, and CYQMG Component modes eigenvector matrices. Eigenvalue summary table; for example, LAMA, BLAMA (buckling), CLAMA (complex), and CMLAMA (component modes) Dynamic solution at modal degrees-of-freedom; for example, AUHF is the Aeroelastic solution h-set Dynamic output list; for example, FOL (frequency) and TOL (transient). Nonlinear transient response; for example, UPNT and ULNTH Nonlinear static solution appended for all loops; for example, UGN and QGN Loads: P_____ Y___ PA PJ PG PP____ PH____ __PPF_ __PPT_ __UH__ __UG__ __UL__ __UP__ Dynamic and static loads Enforced displacement Static loads a-set Static loads g-set (no upstream loads) Static loads g-set Dynamic loads p-set Dynamic loads h-set Dynamic loads p-set, frequency response Dynamic loads p-set, transient response Dynamic solution at modal degrees-of-freedom Static solution g-set; for example, UGN is the nonlinear solution at the g-set. Static or dynamic solution l-set; for example, ULN is the nonlinear solution at the g-set. Dynamic solution p-set; for example, UPN is the nonlinear transient solution at the p-set. Solution Output Tables: O__ES__ O__GPS__ O__GPF__ O__NRG__ O__EF__ O__EE__ O__STR__ Element stresses (STRESS=n) Grid point stresses (GPSTRESS=n) Grid point forces (GPFORCE=n) Element strain energy (ESE=n) Element forces (FORCE=n) Element strains (STRAIN=n) Element strains (STRAIN=n) NX Nastran DMAP Programmer’s Guide 6-51 Chapter 6 Glossaries O__UG__ O__UP__ O__QG__ O__QMG_ O__QP__ O_____1 O_____2 Static solution (DISP=n) Dynamic solution (DISP=n) Static spcforces (SPCF=n) Static mpcforces (MPCF=n) Dynamic spcforces (SPCF=n) SORT1 format SORT2 format Miscellaneous: __CASE__ ___CDB_ GEOM__ USET__ _GPDT_ CSTM_ O_____ _EST__ _DICT_ _ELM_ _____1 _____1X Case Control section tables; for example, Outputs from IFP1, SEP2 and SEDRDR are CASECC, CASES, and CASEDR. 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. Table of Bulk Data entry images related to geometry, connectivity, static loads, and degree-of-freedom set membership. Degree-of-freedom set; for example, USET0 (from GP4), USET (from GPSP), and USETD (from DPD). Grid point definition tables; for example, BGPDT and GPDT. Coordinate Systems Transformation matrix tables; for example, CSTM, CSTMS, CSTMA Solution output tables; for example, OCYES1 is cyclic statics, element stresses, and SORT1. OCPHQP1 is complex modes, SPCForces, and SORT1. OUG2 is statics, displacements, and SORT2. Element summary table; for example, Outputs from TA1 are named EST and ESTL. Output from NLITER and NLTRD is named ESTNL. Dictionary table for element stiffness, mass, etc.; for example, KDICT (linear), KDDICT (differential), KDICTNL (material nonlinear), MDICT (mass) Element stiffness, mass, etc.; for example, KELM (linear), KDELM (differential), MELM (mass) MODACC module outputs. (OTIME and OFREQ); for example, ULF1, FOL1 SDRX and SDRXD module outputs; for example, OES1X, OEF1X Inconsistent Names: BUG GM POS PSS DM MR MRR __V__ __PHI__ Buckling eigenvector matrix; should be renamed to BPHG. Transformation between m-set and n-set; should be renamed to GMN. Static loads on the o-set; should be renamed to PO. Static loads on the s-set; should be renamed to PS. Transformation between l-set and r-set; should be renamed to DLR. Rigid body mass matrix (r-set by r-set); should be renamed to MRR. Stiffness matrix partition (r-set by r-set) from MTT; should be renamed to MRR1. Obsolete designation indicating "vector"; for example, OUGV1, UGVS, UHVF. Obsolete designation indicating eigensolution; for example, PHIDH (should be PHDH) 6-52 NX Nastran DMAP Programmer’s Guide Glossaries PHDH Transformation from d-set to h-set; should be renamed to PHD. 6.2 Parameter Glossary The parameter Glossary lists the names and a brief description of all parameters shown in the module descriptions in “Descriptions of DMAP Modules and Statements” . Naming conventions appear at the end of the glossary. Name ACMS ACON ACOUSTIC Type and Description Character. Automatic Component Mode Synthesis flag. If ACMS=’YES’, then the model will be automatically partitioned into superelements according to NTIPS, TIPSCOL, AND ZCOLLCT. Integer. B-set constraint flag. If ACON<0, then b-set degrees-of-freedom will be constrained if AUTOSPC=’YES’. Integer. Fluid-structure analysis flag. Output by GP2. 0 1 2 ACOUT No fluid elements exist Penalty or fluid acoustic elements exists Fluid/structure coupling exists Character. Type of acoustic pressure output in fluid-structural analysis. ’RMS’ ’PEAK’ Root-mean-square Peak ADJFLG Integer. Adjoint sensitivity flag. Output by DSAD. 0 1 2 No adjoint sensitivity Adjoint sensitivity for static analysis Adjoint sensitivity for frequency response analysis ADPCON ADPTEXIT ADPTINDX AECONFIG AEQRATIO AERTYP Real. Scale factor for adjusting penalty values on restart. Update penalty values if positive. Logical. Set to TRUE if this is the final adaptivity loop. Output by ADAPT. Integer. P-version analysis adaptivity index. Character. Aerodynamic configuration. Output by AEMODEL. Real. Aeroelastic feedback dynamic pressure ratio. Output by AELOOP and DSARLP. Character. Aerodynamic analysis type: ’STATICS’ ’DYNAMICS’ ’STADYN’ Aerostatic Flutter and aeroelastic All aerodynamic analysis types ALPHAD ALPHAJ ALTSHAPE Complex double precision. This is the scalar multiplier for [A]. Real. Real part of shift point Aj for pre-Version 70.5 Lanczos method. Integer. Set of displacement functions in p-element analysis. 0 1 MacNeal set Full Product Space set. NX Nastran DMAP Programmer’s Guide 6-53 Chapter 6 Glossaries Name AMLFLG Type and Description Logical. Set to TRUE if AMLIST if generated. Output by AXMPR1. Character. Analysis type. Output by FRLG: Dynamic load type. APP Set to ’FREQ’, if RLOAD1 or RLOAD2 entries are referenced. Set to ’TRAN’, if TLOAD1 or TLOAD2 entries are referenced. ARCLG ARCSGN AUNIT AUNITS AUTOADJ AUTOSEEL Real. The arc length at the last converged step. Output by NLITER. Integer. The sign of PDD P at the beginning of the subcase. This is used in restarts in the post-buckling region. Output by NLITER. Logical. If TRUE then unit solutions are assumed. Real. Used to convert accelerations expressed in gravity units to units of length per time squared. Character. Adjoint sensitivity automatic selection flag. If set to ’YES’, then adjoint sensitivity will be automatically selected if appropiate. Usually input via user parameter. Character. Default=NO. Input to SEP1. ‘NO’ ‘YES’ AUTOSPC AUXMFL AUXMID BADMESH BAILOUT BC BCFLAG BCKCOL BCLBL Auto-SEELT capability ‘not’ activated. Auto-SEELT capability activated. Character. Automatic constraint flag. If set to ’YES’, then singularities will be constrained. Logical. Auxiliary model loop control flag. Output by AXMDRV. Set to FALSE when processing the last auxiliary model. Integer. Auxiliary model identification number. Output by AXMDRV. Logical. Bad geometry was detected. Integer. Decomposition maximum ratio exit flag. Integer. BC Case Control command set identification number specified in the 257-th word of the NSKIP-th record of CASECC. Logical. Set to FALSE at the last boundary condition. Integer. Subcase record number in CASESTAT referenced by the STATSUB(BUCKLE) subcase identification number. BCKCOL also corresponds to the column number of static solution vector. Output by GETCOL. Integer. f06 file page header control. -1 0 1 Clear page header Initialize page header without page eject Initialize page header with page eject BEGSUP BETA BETAD BIGER BIGMAT BITID BEGIN SUPER flag. Set to TRUE if BEGIN SUPER is specified for the first Bulk Data section. Output by IFP1. Complex. Integration parameter. Complex double precision. This is the scalar multiplier for [B]. Real. Minimum absolute value of element quantity to be output. Logical. Big matrix (>65535 rows) format flag. Integer. Bit position of a degree-of-freedom set. 6-54 NX Nastran DMAP Programmer’s Guide Glossaries Name BOV BOXIDF Type and Description Real. Conversion from frequency to reduced frequency. Value calculated by REFC/(2.*VELOCITY). Output by APD. Integer. Box corner point identification flag. Output by APD. 0 Points have unique identification numbers starting with the aerodynamic component identification number. Points identification numbers are incremented by 1, to avoid an overlap if they were started with the aerodynamic component identification numbers. No display of the corner points is possible. -1 BSKIP BTBRS BUCKCC BULKFGi BULKNMi CARDNO CASCOMi CFDFLG Logical. Pre-buckling subcase skip flag. If TRUE, the skip first subcase in CASECC. Real. Parameter for electromagnetic analysis. Logical. Buckling analysis subcase flag. Set to TRUE if at least one ANALYSIS=BUCK command was found in CASECC and CASEBUCK is specified in the output list. Output by MDCASE. Integer. Bulk Data entry record existence flag. Set to -1 if Bulk Data entry record exists. Output by PARAML. Integer. Bulk Data entry name. Integer. Punch file line counter. CARDNO is incremented by one for each line written to the punch file and is also written into columns 73-80 of each line. Output by XYTRAN. Character. Case Control command names. Integer. Central finite difference flag. 1 -1 Forward Backward CDIF Character. Finite difference scheme. ’YES’ ’NO’ Central Forward CHAR CHAR2 CHARi CHOLSKY Character. Character value of table element. Output by PARAML. Character. Character value of table element concatenated from the values in the WRDNUM and WRDNUM-th position. Output by PARAML. Character. Character value for PRGNAME. Integer. Cholesky decomposition flag. Real. Close natural frequency scale factor. Under the OPTION=’ABS’ method, close natural frequencies will be summed if the natural frequencies satisfy: CLOSE CLOSEOPT Integer. FORTIO close options. 1 2 3 Rewind (leaves file open, if open) Close/keep (default) Close/delete CMPX Complex. Complex value in the next record. NX Nastran DMAP Programmer’s Guide 6-55 Chapter 6 Glossaries Name CMPXD CMPXi CNCNT CNVFLG Type and Description Complex double precision. Complex double precision value in the next record. Complex. Complex value for PRGNAME. Integer. Counter for constraints in CONTAB. Output by DOPR3. Integer. Design optimization convergence flag. Output by DOM12. 0 1 2 No convergence is achieved Soft convergence is achieved Hard convergence is achieved COLINC COLNAM COLNUM COMPRPLC CONFAC Integer. Column increment. Extract every COLINC’th column between STARTCOL and ENDCOL. Character. Degree-of-freedom set name for labeling matrix rows MATGPR output. Integer. Selects the column number of the input matrix that will be sorted to produce SORTLIST and SORTBOOL. Default selects the first column. Logical. If TRUE then components with duplicate names will be copied from COMP1 into COMP. Integer. Image superelement congruence tolerance for the location of boundary grid points and displacement coordinate systems. Integer. A composite number equal to 10*(value of NSTEP the last time MAXBIS was reached) + (the number of consecutive time steps which have reached MAXBIS). If CONSEC=5, then solution process is terminated. Output by NLTRD and NLTRD2. Integer. Nonlinear analysis convergence flag. Output by NLITER, NLTRD, and NLTRD2. On input: 0 On output: -1 1 Convergence has not been achieved Convergence has been achieved. Initialization CONSEC CONV COORID COUPMASS Integer. Coordinate system identification number. Integer. Coupled mass generation flag. -1 0 Lumped Coupled CP CSTRN CSTRES CTYPE Integer. DBC module control parameter. Output by DBC. Integer. Composite lamina strain constraint flag. Set to >0 if any constraint. Output by DSPRM. Integer. Composite lamina stress constraint flag. Set to >0 if any constraint. Output by DSPRM. Character. Cyclic symmetry type as specified on CYSYM Bulk Data entry. Output by CYCLIC1. ’ROT’ ’AXI’ ’DIH’ Rotational Axisymmetric Dihedral CVTYP Integer. Type of convergence test. 1 Soft convergence is to be checked 6-56 NX Nastran DMAP Programmer’s Guide Glossaries Name Type and Description 2 3 Hard convergence is to be checked Final iteration histories are to be printed CYCLIC DATAREC DBCPATH DCEIGCC DEBUG DECOMP DEFORMED Logical or integer. Set to TRUE or -1 for cyclic symmetry models. Integer. Data recovery flag. If DATAREC>0, then DPD will not perform UFM 2071 checks for DELAY and DPHASE which are not need in data recovery. Integer. Dummy variable parameter to allow passing of qualifiers from the NASTRAN database to the DBC database. Logical. Direct complex eigenvalue analysis subcase flag. Set to TRUE if at least one ANALYSIS=DCEIG command was found in CASECC and CASECEIG is specified in the output list. Output by MDCASE. Integer. Passive column logic control flag in DCMP and DECOMP. Integer. DCMP and DECOMP module error termination flag. Integer. Deformed plot request flag. 1 -1 Plot undeformed shapes Plot deformed shapes DEFRMID DELG DELTAB DELTAD DESCYCLE DESGLB DESITER DESMAX DESOBJ DESOPT DESPCH DESVAR DET DETER Integer. Element deformation set identification number. Usually obtained from the DEFORM Case Control command. Required for use in stress recovery of differential stiffness. Real. Scale factor on perturbed length. Real. Relative finite difference move parameter as specified on the DOPTPRM Bulk Data entry and stored in the OPTPRM data block. Complex double precision. This is the scalar multiplier for [D]. Integer. Design cycle analysis counter or flag. Integer. DESGLB Case Control command set identification number. Output by DOPR3 and MDCASE. Integer. Design optimization iteration number. Integer. Maximum allowed design optimization iteration number. Integer. DESOBJ Case Control command set identification number. Output by DOPR3 and MDCASE. Integer. Non-composite element force flag. If set to 1, then the non-composite element forces are extracted form OEF1A and copied to OEF1AA. Integer. Punch control for updated DESVAR, DREPS1 and GRID Bulk Data entries. See “DESPCH” in the NX Nastran Quick Reference Guide . Integer. Retained DVPRELi or DVGRID entry flag for superelement SEID. Set to -1 if there are retained design variable perturbations. Output by SDSA. Complex. Scaled value of the determinant of a matrix. Output by DCMP and DECOMP. Complex. Shift value. Output by DYCNTRL. Real. Duplicate frequency threshold. Two frequencies, f 1 and f 2 , are considered duplicates if DFREQ where fmax and fmin are the maximum and minimum frequencies across all FREQi Bulk Data entries. NX Nastran DMAP Programmer’s Guide 6-57 Chapter 6 Glossaries Name DFRQCC DIGITS DISMETH DISVAR DMRESD DOANALY DOBUCK DOCEIG DODIVG DOESE DOFLUT DOFREQ DOFSPC DOMODES DOMTRAN DOPT DORMS DOSAERO DOSASTAT DOSSPCF DOSTAT DOTSPC DOWGHT DPEPS DRESP DSAPRT DSENS DSFLAG Type and Description 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. Integer. Number of digits for the fractional part of values written by the OUTPUT4 module. Integer. Method of processing in DISUTIL module. Logical. Discrete optimization variable flag. Set to TRUE if discrete optimization design variables are specified. Output by DOPR1. Integer. Design model flag. If set to -1, then the design model is limited to the residual structure. Output by SDSB. Integer. Any analysis retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Buckling constraint flag. Set to >0 if any constraint. Output by DSPRM. Integer. Complex eigenvalue response retained response flag. Set to >0 if any retained response. Integer. Divergence analysis retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Static analysis retained element strain energy response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Flutter analysis retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Frequency response retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Frequency response retained SPCforce response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Normal modes constraint flag. Set to >0 if any constraint. Output by DSPRM. Integer. Transient response retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Scaling method between grid points on the abscissa for the CURVPLOT module. Integer. RMS response retained response flag. Set to >0 if any retained response. Integer. Aerostatic trim or stability derivative retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Statics or aerostatic retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Static analysis retained SPCforce response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Statics constraint flag. Set to >0 if any constraint. Output by DSPRM. Integer. Transient response retained SPCforce response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Weight retained response flag. Set to >0 if any retained response. Output by DSPRM. Real. Tolerance for design model override of analysis model properties. See further description in theNX Nastran Quick Reference Guide . Integer. Retained DRESP1 entry flag for superelement SEID. Set to -1 if there are retained design responses. Output by SDSA. Logical. DSAPRT Case Control command print flag. Integer. Acceleration matrix creation flag. Set to 1 to generate AG, accelerations due to inertial loads. Logical. Design sensitivity flag. Set to TRUE for design sensitivity job. 6-58 NX Nastran DMAP Programmer’s Guide Glossaries Name DSNOKD DSVGF Type and Description Real. Scale factor on the differential stiffness matrix in buckling design sensitivity analysis. Usually specified as a user parameter. Integer. Specifies scaling of solution vector by eigenvalue. 0 1 No scaling Scale DSZERO Real. Design sensitivity coefficient print threshold. If the absolute value of the coefficient is greater than DSZERO then the coefficient will be printed. Integer. Mode acceleration based displacement matrix flag. If DTMi<>0, then MOPFi is a mode acceleration based displacement matrix and, therefore, velocities and accelerations will not be output to OFPi. For APP=’TRANRESP’, MOFPi must have only one column per time step instead of the usual three. Integer. Duplicate word group option in the TABEDIT module. Character. Flag for skipping basis vector components associated with all GRIDNs in DESVCP. If DVGRDN=’YES’, then components will be skipped. Logical. Aerostatic divergence analysis subcase flag. Set to TRUE if at least one ANALYSIS=DIVERG command was found in CASECC and CASEDVRG is specified in the output list. Output by MDCASE. Integer. Eigenvalue/frequency response type flag. Output by DOPR3. 1 2 Eigenvalue (radian/time) Frequency (cycle/time) DTMi DUPWG DVGRDN DVRGCC EIGNFREQ ECTYPE Integer. Type of element connectivity input and plot set output: 0 1 2 ECT and ELSET GEOM2 and ELSET ECT and PELSET EIGRFLD EIGRVALI EIGRVALR ELEMSET ENDCOL ENFM EPPRT EPS EPSBIG EPSI EPSLND EPSMALC Character. Field name of EIGR or EIGRL entry. EIGRFLD is also an output if the field value is a character string. Output by MATMOD option 23. Integer. Extracted integer value from the EIGR or EIGRL entry. Output by MATMOD option 23. Real. Extracted real value from the EIGR or EIGRL entry. Output by MATMOD option 23. Integer. SET Case Control command identification number that contains a list element point identification numbers. Integer. Ending column number to extract from I1. Integer Enforced motion flag. Set to ‘0’ if no enforced motion. Set to ‘1’ if enforced motion exists. Output by LCGEN. Real. Singularity print parameter. Singularities greater than EPPRT will not be printed if PRGPST=’YES’. Real. Convergence criterion. By default EPS will be set to N/10000 where N is the size of KXX, etc. Real. Large number for tuning. Integer. Static solution error ratio flag. Set to -1 if the error ratio is greater than 1.E-3. Output by SSG3 and DISUTIL. Complex double precision. This is the scalar multiplier for [E]. Real. Small number for tuning. NX Nastran DMAP Programmer’s Guide 6-59 Chapter 6 Glossaries Name EPSNO EPZERO Type and Description Integer. Number of eigensolutions to check and the quantity of error checking output. If left at its default value, only the highest epsilon for the first ten or NEIGV modes (whichever is less) are printed. If EPSNO is greater than zero, the epsilons for the first EPSNO are printed. Real. Singularity test parameter. Singularities greater than EPZERO will not be constrained. Logical. Copy/equivalence flag of BULKOLD to BULK. If on input EQVBLK=FALSE, and no new Bulk Data then copy BULKOLD to BULK. If on input and output EQVBLK=TRUE and no new Bulk Data, then BULKOLD must be be equivalenced to BULK in a subsequent EQUIVX statement. If there are any new Bulk Data then EQVBLK will be set to FALSE on output. xsort. Integer. Bad factor diagonal ratio flag. Output by DCMP and DECOMP. Integer. Duplicate element identification flag. Output by ELTPRT. Character. Energy type. Inputs to VDRE. ‘SEC’ ‘SED’ ‘KEC’ ‘KED’ ‘TOTC’ ‘TOTD’ Strain energy - constant. Strain energy - oscillating. Kinetic energy - constant. Kinetic energy - oscillating. Total energy - constant. Total energy - oscillating. EQVBLK ERR ERROR ETYPE EXISTS Character. Project and version status. Output by PROJVER. ’EXISTS’ ’DELETED’ ’NONE’ If project and version exists If project and version is deleted If project and version never existed EXTNAME EXTRN EXTWORK F1 F2 FAC1 FAC2 FAC3 FACTOR FAILI FBTYP FCSENS Character. Name of the qualifier used to identify External Superelements. Note linkage to the SEBULK data entry. Integer. External superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID=0. Output by SEP2DR and SEDRDR. Real. External work. Output by SSG3. Real. The lower frequency bound in cycles per unit time in READ and UEIGL. Tolerance for treating small values as zero during decomposition in DCMP and DECOMP. Maximum value to print in MATGPR output. Real. The upper frequency bound in cycles per unit time in READ and UEIGL. The default value of 0.0 indicates machine infinity. Complex. Square of the reciprocal of the time step increment. Imaginary part is always zero. Output by TRLG. Complex. Reciprocal of twice the time step increment. Imaginary part is always zero. Output by TRLG. Complex. Negative of the reciprocal of the time step increment. Imaginary part is always zero. Output by TRLG. Integer. Factor in the computation of the sequenced identification number (SEQID) in the SEQP module. Integer. Composite failure index constraint flag. Set to >0 if any constraint. Output by DSPRM. Integer. Forward or backward pass selection. Integer. Flutter/complex eigenvalue sensitivity flag. 6-60 NX Nastran DMAP Programmer’s Guide Glossaries Name Fij FILTERF FILTERS FIRSTBA FLOOP FLUID Type and Description Integer. Form of output matrix partitions. Real. Filter for fluid factor matrices. Real. Filter for structure factor matrices. Logical. Zero frequency truncation flag. Set to TRUE if first frequency is truncated. Output by FRRD1 or FRRD2. Integer. Flutter eigenvalue analysis loop counter. Set to zero for initial entry and incremented by one for each loop until the last loop then set to -1. Output by FA1. Logical. Fluid processing flag. GKAM If TRUE, then modal damping set identification number is obtained from the SDAMPING(FLUID) Case Control command. METHOD command option (FLUID or STRUCTURE). If FLUID=TRUE, the EIGRL entry is selected from METHOD(FLUID) Case Control command. READ and LANCZOS FLUIDMP FLUIDSE FLUTCC FLXONL FLXERR FMODE FMPFEPS FORM FORMAT FOUND FOURIER FREQDEP FREQINDX FREQTYP Integer. Number of fluid modes to use in computing factors. If FLUIDMP>0 then compute factors for the first FLUIDMP modes. Integer. Fluid superelement identification number. Set to a value greater than zero if ACMS=’YES’ and fluid elements are present. Output by SEQP. Logical. Flutter analysis subcase flag. Set to TRUE if at least one ANALYSIS=FLUTTER command was found in CASECC and CASEFLUT is specified in the output list. Integer FLEXONLY keyword from ADAMSMNF case control entry. Set to ‘0’ to solve residual structure. Set to ‘1’ to not solve residual structure. Output by NXNADAMS. Error flag. Set to ‘0’ for no error. Set to ‘1’ if error occured during MNF creation (process should be terminated). Output by NXNADAMS. Integer Integer. The lowest mode number resulting from LMODES or LFREQ and HFREQ. Real. Threshold for filtering out small fluid factor magnitudes. Integer. Form of output matrix. Character. Eigenvalue problem type. Must specify ’MODES’. Buckling problems are not supported. Integer. Integer value search flag. Set to -1 if integer value is found by PARAML. Output by PARAML. Integer. Fourier transform. Set to 1 if TLOADi Bulk Data entries are referenced by the DLOAD set identification number in CASECC. Output by FRLG. Logical. Frequency-dependent element flag. Set to TRUE if frequency-dependent elements are present or to be processed. Output by TA1. Integer. Frequency or time step index. Selects frequency associated with UA. Character. Frequency dependent element processing mode: ’ESTF’ ’ESTNF’ Compute frequency dependent stiffness Compute nominal frequency dependent stiffness FREQVAL FREQWA FRQLOOP Real. Frequency value for frequency dependent element generation. Output by FRQDRV. Real. Parameter for electromagnetic analysis. Integer. Frequency loop counter. On input, FRQLOOP should be initialized to 0 before the loop. On output, FRQLOOP is incremented by one and at the last frequency, FRQLOOP is negated. For example, if the fifth frequency is the last then FRQLOOP is output as -5. Output by FRQDRV. NX Nastran DMAP Programmer’s Guide 6-61 Chapter 6 Glossaries Name FSDCYC GAMMAD GEOMU GETNUMPN GMAFLG GPF GPFORCE GRDPNT GRIDFMP GRIDMP GRIDSET GUSTAERO HDRLBLi HEATCC HFREQ HINDEX HPFLAG Type and Description Logical. Fully stressed design cycle flag. Set to TRUE if this is a fully stressed design cycle. Complex double preision. This is the scalar multiplier for [C]. Integer. Fortran unit number to which the DBC module writes geometric information. Logical. Panel static load computation flag. If TRUE then get number of panels flag only and do not compute panel static loads. Integer. Test control flag for changes in the set identification numbers specified for the SDAMPING, K2PP, M2PP, B2PP, and TFL commands. Integer. Parameter for electromagnetic analysis. Integer. The number of columns in FENL. If GPFORCE less than or equal to zero then no GPFORCE or ESE command is present. Integer. Reference grid point identification number. Inertias are computed GRDPNT. If GRDPNT=-1 then the origin of the basic coordinate system is used. Output by VECPLOT. Integer. Case Control set identification number of fluid grids that will be output. Integer. Case Control set identification number for a set of fluid grids. Integer. SET Case Control command identification number which contains a list grid point identification numbers. Integer. QHJ computed only if GUSTAERO<0. Character. Header with up to 64 characters to be printed and centered at the top of of each page. Logical. Heat transfer analysis subcase flag. Set to TRUE if at least one ANALYSIS=HEAT command was found in CASECC and CASEHEAT is specified in the output list. Output by MDCASE. Real. Upper frequency limit of modes to use in modal transformation. Integer. Harmonic index. Integer. Element type processing flag. 1 2 h-element p-element IAPP Integer. Analysis type. Allowable values are: 1 2 3 Statics, aerostatic, frequency, or transient response Buckling or normal modes Flutter or divergence IBLK ICOL IEXT IFTM Integer. Initial block size. Integer. Column number of a matrix element. Integer. Extraction level for reduced incomplete Cholesky factorization. See the “SOLVIT” module description. Integer. Fourier transform method. 0 1 2 Constant Piecewise linear (default) Cubic spline IMACHNO Integer. Mach number (MACH) multiplied by 1000 and specified as an integer. 6-62 NX Nastran DMAP Programmer’s Guide Glossaries Name IMAG IMETHOD INTGR INTi INVOKE Type and Description Real. Imaginary part of matrix or table element. Output by PARAML. Integer. Nonlinear transient analysis flag. Input and output by CASE. Integer. Integer value of table element. Output by PARAML. Integer. Integer value for PRGNAME. Logical. Restart deletion invocaton flag. Integer. LOADSET Case Control command processing flag. If IOPT=0, then the LOADSET command is ignored and all LSEQ entries will be used to expand CASECC. If IOPT=1, then only those LSEQ entries selected by the LOADSET command will be used. Integer. Case Control command selection flag for the MTRXIN module. Integer. Normalization method. Integer. Matrix partition or merge option. Integer. VECPLOT module output option. IOPT IOSTAT Integer. FORTIO status return code. Output by FORTIO. For OPERATN=’OPEN’ or ’CLOSE’: 0 1 Successful Unsuccessful For OPERATN=’EXISTS’: 0 1 IPAD IPANEL IROW IRTN ISENS ISKIP ISOFLG ITAPE Assigned physical file exists Assigned physical file does not exist Integer. Padding level for reduced incomplete Cholesky factorization. See the “SOLVIT” module description. Integer. The number of records to skip to get the required data in the PANSLT table. Integer. Row number of a matrix element. Output by PARAML. Integer. External program return code. Output by ISHELL. Integer. Set to 1 if a sensitivity analysis is to be performed in the ASG module. Integer. Counter to update penalty values in BGP; updates on first pass and no update later. Integer. Parameter for electromagnetic analysis. Integer. MACOFP module Fortran unit positioning option. 0 -1 -1 -3 -4 No action before write Rewind before write A new unit is mounted before write and rewind at end Rewind at start and end Dismount old unit and mount new unit. INPUTT2/OUTPUT2 module Fortran unit positioning option. +n 0 -1 Skip forward n data blocks before reading/writing No action before reading/writing Rewind before reading/writing NX Nastran DMAP Programmer’s Guide 6-63 Chapter 6 Glossaries Name Type and Description -3 -9 Print data blocks and then rewind before reading/writing Write a final EOF (OUTPUT2 only) INPUTT4/OUTPUT4 module Fortran unit positioning option. 0 -1 -2 -3 ITERID ITIME ITOPT ITSEPS ITSEPSR ITSERR No action before reading/writing Rewind before reading/writing Rewind after reading/writing Rewind before and after reading/writing Integer. Nonlinear analysis iteration count. Output by NLITER and NLTRD2. Real. Initial time step at the beginning of a subcase. Integer. Preconditioner method for iterative solver. See the “SOLVIT” module description. Integer. Power of ten for convergence parameter epsilon for iterative solution method. On output, set to 0 for convergence and 1 for no convergence. Real. Convergence parameter epsilon for iterative solution method. Integer. Iterative solver return code. Output by SOLVIT. 1 2 No convergence Insufficient memory ITSMAX ITSOPT IUNIT IUNITi IUNITSOL IVALUE JPLOT K6ROT KBAR KDAMP KDGEN KEY KFLAG KGTH KMATUP KRATIO KSTEP Integer. Maximum number of iterations for iterative solution method. Integer. Preconditioner flag for STATICS and SOLVIT module. Integer. Fortran unit number. Integer. Fortran unit number. Integer. If IUNITSOL=0, then trim solution is being supplied. If IUNITSOL>0, then IUNITSOL’th unit solution is being supplied. Integer. Integer value to search for in a table. Integer. Number of element plot sets. Set to -1 if there are none. Output by PLTSET and SEPLOT. Real. Normal rotational stiffness factor for CQUAD4 and CTRIA3 elements. Real. Reduced frequency. Integer. Viscous modal to structural damping flag. If set to -1, then viscous modal damping (SDAMPING Case Control command) will be included in the stiffness matrix as structural damping. Integer. Differential stiffness matrix generation flag. Usually the column number in UG to use in differential stiffness matrix generation. Character. Generic or NDDL name of a data block. Integer. Stiffness update flag. Set to -1 to update stiffness before starting bisection. It reflects the NEWK and CONV status at the last converged solution or stiffness update. Output by NLITER. Integer. Set to -1 if all harmonic IDs (in analysis set) have been processed. Output by CYCLIC3. Integer. Stiffness matrix update count within the increment. Output by NLITER. Complex. Stiffness ratio to be used for time step adjustment. Output by NLTRD2. Integer. Frequency of solve in complex eigenvalue analysis. 6-64 NX Nastran DMAP Programmer’s Guide Glossaries Name KSYM Type and Description Integer. Symmetric decomposition flag. Output by DCMP and DECOMP. Real. CPU time remaining. If KTIME is positive then KTIME is the time remaining at the start of the stiffness update. If negative, no stiffness update was done since the last exit from NLITER. KTIME still holds the negative of the stiffness update time from the last stiffness update. Output by NLITER, NLTRD, and NLTRD2. Character. Label on the Fortran unit identified by IUNIT. Integer. Large rotation calculation method: 1 2 Gimbal angle Rotation vector KTIME LABL LANGLE LASTBULK LASTCC LASTCNMU LASTSE LASTUPD LCOLLBLi LDSEQ LFREQ LGDISP Logical. Flag to indicate the current Bulk Data section is the last section in the input file. Output by XSORT. Integer. Last auxiliary model Case Control section flag. Output by IFP1. Real. Last converged value of the arc-length load factor. Output by NLITER. Integer. Last superelement flag. Set to -1 if the current superelement is the last to process. Output by SEP2DR and SEDRDR. Integer. The time step number of the last stiffness update. Set to 0 if the stiffness update is performed due to the CGAP element during the iteration. Output by NLTRD and NLTRD2. Character. Label with up to 32 characters to be printed left-justified in upper left corner of each page. Integer. PG column number. On input, last column number of PG on previous SELA execution. On output, last column number of PG on current execution. Output by SELA. Real. Lower frequency limit of modes to use in modal transformation. Integer. Large displacement and follower force flag. -1 1 2 No large displacement and follower force effects will be considered. Large displacement and follower force effects will be considered. Only large displacement effects will be considered. LINC LISET LJSET LKSET LMODES LMTROWS LOAD LOADFAC LOADFACR LOADID Integer. Number of load increments for this subcase. Integer. Size of interference js-set extracted from the AEBGPTI table. Output by MTRXIN. Integer. Size of js-set extracted from the AEBGPTJ table. Output by MTRXIN. Integer. Size of ks-set extracted from the AEBGPTK table. Output by MTRXIN. Integer. The number of lowest modes to use in modal transformation. All outputs will have LMODES number of columns. Integer. Number of Lagrange Multipliers appended to the A matrix. These rows are excluded from the internal reordering in the DCMP module. Integer. LOAD Case Control command set identification number specified in the fourth word of the NSKIP-th record of CASECC. Complex. Load factor. The real part is the load factor for the current iteration, having a fractional value between 0 and 1. Output by NLITER. Real. Load factor in nonlinear static analysis. (Same as LOADFAC except real). Integer. Load set identification number for the current subcase. NX Nastran DMAP Programmer’s Guide 6-65 Chapter 6 Glossaries Name LOADIDP LOADU LPFLG LPRINT LSEQ LST2REC LSTEP LSTRN Type and Description Integer. Load set identification number for the previous subcase. Integer. Fortran unit number to which the DBC module writes static load information. Integer. Flag to indicate whether there is another CASEA record to process. Set to -1 for the last subcase and Mach number. Output by AELOOP and DSARLP. Logical. Print flag for divergence analysis (DIVERG), flutter analysis (FA1), and stability derivatives (SDP). Integer. LOADSET Case Control command set identification number specified in the 205-th word of the NSKIP-th record of CASECC. Integer. Last two records write flag. Set to TRUE to write last two records. Integer. Load step. The current iteration step at the subcase level for static solutions. Integer. Laminar strain flag. 0 1 Compute laminar stresses Compute laminar strains LUMPB LUMPM LUSET LUSETD LUSETS MACH MACH0 MAJOR MATCH Real. Lumping factor for electromagnetic damping. Real. Lumping factor for electromagnetic mass. Integer. The number of degrees-of-freedom in the g-set. Output by GP1 or PARAML. Integer. The number of degrees-of-freedom in the p-set. Output by DPD. Integer. The number of degrees-of-freedom in the g-set of the current superelement. Output by GP1. Real. Mach number. Output by AELOOP and DSARLP. Real. Previously processed Mach number. Output by AMG. Character. Name of the major degree-of-freedom set. Integer. Type of fluid/structural mesh matching. Output by GP5. 0 1 Matching mesh Non-matching mesh MATCPX MATNAMi MAXBLK MAXLP MAXR MAXRAT MAXRATIO MAXSET MBCFLG MCEIGCC Integer. Complex material properties flag for electromagnetic elements. Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI Bulk Data entries. Integer. Maximum block size. Integer. Maximum limit allowed for element relaxation iteration and the material subincrement processes. Integer. Maximum physical record size. Real. Maximum value of factor diagonal ratio. Output by DECOMP. Real. Minimum value of factor diagonal ratio which causes termination of decomposition. Integer. Vector block size for Lanczos method only. The actual value of block size may be reduced depending on available memory and problem size. Logical. Multiple boundary condition in static analysis flag. Set to TRUE if multiple boundary conditions are specified in static analysis. 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. 6-66 NX Nastran DMAP Programmer’s Guide Glossaries Name MDTRKFLG Type and Description Integer. Mode tracking status flag. 0 1 Mode tracking was successful Mode tracking was unsuccessful MESH MESHSET METH METHCMRS METRIK MINDIAG MFACT MFLG MFRQCC MODE Character. Shading summary print flag. Set to ’YES’ to print summary; ’NO’ otherwise. Mesh type for aerodynamic or structural components: ’AERO’ or ’STRU’. Integer. MSGMESH set processing flag. If nonzero, then combine mesh sets defined in the MSGMESH punch file. Character. Method of real eigenvalue extraction. Integer. Residual structure METHOD set identification (SID) override. METHCMRS>0 overrides SID value specified in CASES. Integer. Parameter for electromagnetic analysis. Real. Norm of the minimum diagonal term in U. Output by DCMP and DECOMP. Complex. Scale factor for hydroelastic boundary mass matrix. Output by BMG. Integer. Flag to indicate whether there is another Mach number to process in the current subcase. Set to 0 for the last Mach number in the subcase. Output by AELOOP. Logical. Modal frequency response analysis subcase flag. Set to TRUE if at least one ANALYSIS=MFREQ command was found in CASECC and CASEFREQ is specified in the output list. Output by MDCASE. Character. Boundary condition change ignore flag. ’NONLINEAR’ Ignore boundary condition changes ’STATICS’ Do not ignore boundary condition changes MODECC MODEPT MODETRAK Logical. Normal modes analysis subcase flag. Set to TRUE if at least one ANALYSIS=MODES command was found in CASECC and CASEMODE is specified in the output list. Output by MDCASE. Logical. Analysis model element property modification flag. Set to TRUE indicates that the design model is overriding element properties in the analysis model. Output by DOPR1. Integer. Mode tracking request flag. 0 >0 Mode tracking was not requested Mode tracking is requested MODGEOM2 MODGM4 MODMPT MONRPLC MPC Logical. Analysis model connectivity modification flag. Set to TRUE indicates that the design model is overriding connectivity in the analysis model. Output by DOPR1. Logical. GEOM4P update flag. Set to TRUE if GEOM4M is updated. Output by MODGM4. Logical. Analysis model material property modification flag. Set to TRUE indicates that the design model is overriding material properties in the analysis model. Output by DOPR1. Logical. If TRUE then components with duplicate names will be copied from MON1 into MON. Integer. MPC Case Control command set identification number specified in the second word of the NSKIP-th record of CASECC. Integer. Multipoint constraint set identification number change flag. Set to 1 if the current subcase contains a different multipoint constraint set from the previous subcase. Set to -1 otherwise or if there are no multipoint constraints in the current subcase. Output by GP4. Integer. Controls whether the grid point connectivity created by multipoint constraint Bulk Data entries (MPC, MPCADD, and MPCAX and the rigid element entries; e.g., RBAR) is considered during resequencing. MPCF2 MPCFLG NX Nastran DMAP Programmer’s Guide 6-67 Chapter 6 Glossaries Name MPCMETH MPFSORT MPNFLG MSCHG MSGINP1 MSGINP2 MSGLVL Type and Description Character. Multipoint constraint processing method. Also indicates the type of matrix in the second input position: ’RG’ for RMG and ’KMM’ for KMM. Integer. Sort flag. A value in the first table is added to a value in the second table. Integer. Set to 1 if multiple panels exist. Output by GP5. Integer. Boundary condition change flag in. In nonlinear static analysis only. Output by CASE. Integer. Optional integer input. Integer. Optional integer input. Integer. The level of diagnostic output for the Lanczos method only. 0 1 2 3 4 No output Warning and fatal messages Summary output Detailed output on cost and convergence More detailed output on orthogonalizations and some extra arithmetic to check on orthogonality Integer. Diagnostic output flag in the SEQP module. 0 1 No Yes Integer. Diagnostic output flag in the SOLVIT module. 0 1 Minimal; i.e, UIM 6447 UIM 6447, convergence ratios, and residual norms Integer. Diagnostic output flag in the TABEDIT module. MSGNUM MSGOUT MTRNCC MU NAME NASOUT NBCONT NBIS NBLOCK NBRCHG NBSORT2 Integer. Message number. Integer. Optional integer output. Output by MSGHAN. Logical. Modal transient response analysis subcase flag. Set to TRUE if at least one ANALYSIS=MTRAN command was found in CASECC and CASEMTRN is specified in the output list. Output by MDCASE. Real. The magnitude of the last g-set displacement matrix. Output by NLTRD. Character. Name of a data block. Output by PARAML. Logical. Print flag for fluid/structural mesh matching summary. Integer. Number of bisections due to slideline contact. Output by NLITER and NLTRD2. Integer. Current bisection counter. Output by NLITER and NLTRD2. Integer. Number of spill blocks to form if “out of memory” algorithm is used. Integer. Number of negative terms on the diagonal. Output by DCMP and DECOMP. Integer. Contact region output sort format flag. Output by BGCASO. 1 2 If SORT2 format is requested for printing If x-y plotting is requested 6-68 NX Nastran DMAP Programmer’s Guide Glossaries Name NCNOFFST Type and Description Integer. Counter for retained constraints. The value is initialized to 1 in and is incremented by the number of records in CNTABR. Output by DSAD. Integer. Number of columns (i.e.; subcases, modes, time steps or frequencies) desired in the output matrices. By default, all data records will be converted into the output matrices. If NCOL is less than the number of data records in the input table, then the first NCOL records are converted and the remaining records are ignored. Output by TRD1 and TRD2. Integer. Number of columns. Output by NORM. Integer. Number of columns desired in the solution matrix for the residual structure. Usually determined by the PARAML module. Integer. The number of desired eigenvalues. Integer. The number of desired eigenvalues in first complex region. Real. Numerical damping. Character. NDDL name of the DBi-th data block. Integer. The number of desired eigenvalues. If the last mode is repeated, then nDes + m (where m is the multiplicity of the last mode) solutions are found. Integer. The number of desired eigenvalues in j-th complex region. for pre-Version 70.5 Lanczos method. Integer. Number of unique referenced design variables. Integer. Number of estimated eigenvalues. Integer. The number of estimated eigenvalues for non-Lanczos methods only. For the Lanczos method, NE is the problem size which the QL Householder method is used. Integer. Number of eigenvalues to keep. 0 >0 Keep all eigenvalues Keep first NEIG-th eigenvalues NCOL NCUL ND ND1 NDAMP NDDLNAMi NDES NDJ NDVTOT NE NEIG NEIGV NEWCASE NEWK Integer. The number of eigenvectors found. Set to -1 if none were found. Output by CEAD, READ, LANCZOS, and UEIGL. Integer. CASECCBO output flag. Set to 1 if CASSECBO is generated. Output by BGCASO. Integer. Stiffness update flag. Output by NLITER, NLTRD, and NLTRD2. -1 1 2 Do not update stiffness. Update stiffness. Update stiffness, the solution is diverging and MAXBIS has been reached. NEWNAMi NEWP Character. The generic name of the corresponding input table; e.g., NEWNAM3 corresponds to NEWDB3, etc. Integer. New subcase flag. Output by NLITER, NLTRD, NLTRD2, and TOLAPP. -1 1 Current subcase has not been completed. Current subcase has been completed. NEXTID NFEXIT NFREQ NGERR Integer. Identification number which appears on the BEGIN BULK command of the next Bulk Data section; usually superelement or auxiliary model identification number. Output by XSORT. Logical. Termination flag. If FALSE do not issue User Fatal Message 2070 and do not terminate the module if the matrix is not found. Integer. Number of frequencies for frequency response analysis. Output by CYCLIC1. Integer. Error flag. If errors are encountered, then NGERR is set to -1; otherwise +1. Output by GPSP. NX Nastran DMAP Programmer’s Guide 6-69 Chapter 6 Glossaries Name NGP NHBDY Ni NINPTPS NJ NK NKEYS NLAM NLAYERS NLFLAG NLOADS NLSTRAIN NLTYPE Type and Description Integer. Number of grid points and scalar points in the structure. Output by PLTSET and SEPLOT. Integer. Number of CHBDYi elements. Set to -1 if none exist. Output by PLTHBDY. Character. Continuation entry prefix. Integer. Approximate number of surrounding independent element interpolation points to be considered when interpolating at a grid point for a given material coordinate system. Integer. Number of degrees-of-freedom in j-set degrees-of-freedom. Output by APD. Integer. Number of degrees-of-freedom in k-set degrees-of-freedom. Output by APD. Integer. Duplicate value sort option specification. Integer. Number modes to create in LAMAX. Integer. Number of layers to integrate through the thickness of CQUAD4 and CTRIA3 elements in nonlinear analysis. Integer. Output by NLITER. Integer. The number of subcase records contiguous with respect to the MPC and SPC command in the first subcase of the current boundary condition. Logical. Nonlinear strain data recovery, otherwise flag at word 11 of OES1 takes precedence. Set to TRUE if nonlinear strains are to be processed. Integer. Nonlinear analysis type. 0 1 Statics Transient response NMAT NMK NNDFRQ NOA NOABFL NOASM NOB2 NOBGG NOBKGG NOBSET0 NOCEAD NOCHAR NOCMPX NOCOMP Integer. Number of matrices. Integer. Number of Mach number and reduced frequency pairs. Output by GETMKL. Integer. Number of forcing frequencies which depend upon natural frequencies. Integer. Constraint and omit set flag. Set to -1 if NOMSET=-1, NOSSET=-1, and NOOSET=-1; otherwise the number of degrees-of-freedom in the a-set. Output by GP4 and GPSP. Integer. Matrix ABFL existence flag; 0 if ABFL exists and -1 otherwise. Output by BMG. Integer. Matrix assembly flag. Set to -1 if no matrix assembly and reduction is requested for the current superelement based on the SEKR or SEALL Case Control commands. Output by SEP2DR and SEP3. Integer. B2GG or B2PP generation flag. Set to +1 if B2GG or B2PP is generated; -1 otherwise. Output by MTRXIN. Integer. Same as NOKGG except for BELM and BDICT. Output by EMG. Integer. Slideline contact stiffness generation flag. Set to 1 to generate slideline contact stiffness. Integer. Number of null columns in PHZ in front of non-null columns. Output by DYNREDU. Integer. Complex eigenvalue analysis flag. Set to 1 if complex eigenvalue analysis needs to be performed, otherwise, set to -1. Output by FA1. Integer. Number of character value inputs. Integer. Number of complex value inputs. Integer. Composite stress/strain flag. -5 Forces of composites in STRAIN=sid 6-70 NX Nastran DMAP Programmer’s Guide Glossaries Name Type and Description -2 -1 0 1 2 3 4 5 Forces of composites in STRESS=sid Stresses for all elements (same as 0 except in DMAP) Stresses for all elements Stresses for non-composites only Strain/curvature and forces of composites in STRESS=sid Strains for all elements and MPCForces Strains for non-composites only Strain/curvature of composites in STRAIN=sid NODLT NODR NOEDS1 NOEED NOEGPSF NOEGPSTR NOELDCT NOEST NOESTL NOFORT NOFREQ NOFRL NOGDS1 NOGEOM1 NOGEOM2 NOGEOM3 NOGENL NOGOIFP NOGOIFPi NOGOMEPT NOGOMGM2 NOGONL NOGOXSRT NOGPDCT Integer. Set to 1 if dynamics loads Bulk Data entries are processed, -1 otherwise. 1 also means DLT is created. Output by DPD. Integer. Data recovery request flag. Set to -1 if there is no data recovery requested for any superelement. Output by SEDRDR and SEP4. Integer. OEDS1 generation flag. Set to 0 if OEDS1 is generated. Output by STDCON. Integer. Set to 1 if eigenvalue extraction Bulk Data entries are processed, -1 otherwise. 1 also means EED is created. Output by DPD. Integer. EGPSF creation flag. Set to zero if EGPSF is created. Integer. EGPSTR creation flag. Set to 0 if EGPSTR is created. Output by GPSTR2. Integer. ELDCT generation flag. Set to 0 if ELDCT is generated. Output by STDCON. Integer. Processing status flag. Output by MATMOD option 38. Integer. ESTL generation output flag. Set to 1 if ESTL is generated; -1 otherwise. Output by TA1. Integer. OUTPUT4 flag. Set to 0 if FORT is requested on the SENSITY Case Control command. Output by DSTA. Integer. Number of excitation frequencies. Integer. FRL generation flag. Set to -1 if FRL is not generated. Output by FRLGEN. Integer. OGDS1 generation flag. Set to 0 if OGDS1 is generated. Output by STDCON. Integer. Processing status flag. Output by MATMOD option 36. Integer. Processing status flag. Output by MATMOD option 37. Integer. GEOM3N creation flag. Set to 1 if GEOM3N is created, otherwise set to -1. Output by CYCLIC1. Integer. The number of general elements. Set to -1 if there are no general elements. Logical. IFP module error return flag. Set to TRUE if an error was detected. Output by IFP. Logical. IFPi module error return flag. Set to TRUE if an error was detected. Output by IFPi. Logical. MODEPT module error return flag. Set to TRUE if an error was detected. Output by MODEPT. Logical. MODGM2 module error return flag. Set to TRUE if an error is found. Output by MODGM2. Integer. Nonlinear "no-go" flag. Set to +1 to continue or -1 to terminate. Output by NLTRD2. Logical. XSORT module error return flag. Set to TRUE if an error was detected. Output by XSORT. Integer. GPDCT generation flag. Set to 0 if GPDCT is generated. Output by STDCON. NX Nastran DMAP Programmer’s Guide 6-71 Chapter 6 Glossaries Name NOGRAV NOGUST NOINT NOK2 NOK4GG Type and Description Integer. Gravity load existence flag. Set to -1 if no GRAV Bulk Data entry images, +1 otherwise. Output by GP3. Integer. Gust load flag. Set to -1 if no gust loads exist; otherwise set to 1. Output by GUST. Integer. Number of integer value inputs for PRGNAME. Integer. K2GG or K2PP generation flag. Set to +1 if K2GG or K2PP is generated; -1 otherwise. Output by MTRXIN. Integer. Differential stiffness or structural damping generation flag. Output by EMG. On input: ≥3 <3 On output: 1 -1 If structural damping coefficient (GE) is detected on material property Bulk Data entry records Otherwise Compute geometric nonlinear effects Do not compute geometric nonlinear effects NOKGG Integer. KELM and KDICT generation flag. Output by EMG. On input: 0 -1 On output: 0 -1 Generated Not generated Generate Do not generate NOKBFL NOKVAL NOL NOLASM NOLOAD NOLOADF NOLOOP NOM2 NOMAT NOMATi NOMGEN Integer. Matrix KBFL existence flag; 0 if KBFL exists and -1 otherwise. Output by BMG. Integer. Set to -1 if the value of HINDEX (K) is not in the analysis set of harmonic IDs. Output by CYCLIC3. Integer. Dependent set flag. Set to -1 if all degrees-of-freedom belong to m-set, s-set, o-set, and/or r-set; otherwise, the degrees-of-freedom in the l-set. Output by GP4. Integer. Load assembly flag. Set to -1 if no load assembly and reduction is requested for the current superelement based on the SELR or SEALL Case Control commands. Output by SEP2DR and SEP3. Integer. Static load existence flag. Set to -1 if no static loads and SLT is not created, +1 otherwise. Output by GP3. Integer. Number of load cases per excitation frequency. Integer. Looping test flag. Output by CASE. Integer. M2GG or M2PP generation flag. Set to +1 if M2GG or M2PP is generated; -1 otherwise. Output by MTRXIN. Integer. Matrix generation flag. Set to -1 if no matrix generation is requested for the current superelement based on the SEMG or SEALL Case Control commands. Output by SEP2DR and SEP3. Integer. Generation flag. Set to +1 if MAT* is generated; 1 otherwise. Output by MTRXIN. Integer. Fluid mass existence flag. Set to the MFLUID set identification number if MFLUID is specified in CASECC. Output by MGEN. 6-72 NX Nastran DMAP Programmer’s Guide Glossaries Name NOMGG NOMPF2E NOMR Type and Description Integer. Same as NOKGG except for MELM and MDICT. Output by EMG. Integer. Flag to generate O*MPF2E data blocks. Integer. Mass and damping assembly flag. Set to -1 if no mass and damping assembly and reduction is requested for the current superelement based on the SEMR or SEALL Case Control commands. Output by SEP2DR and SEP3. Integer. Number of degrees-of-freedom in the m-set or multipoint constraint and rigid element flag. Set to -1 if there are none. Output by GP4 or PARAML. Integer. MSGSTRES execution flag. Set to -1 if MSGSTRES execution is not desired. Integer. NAMEi generation flag. Set to +1 if NAMEi is generated; -1 otherwise. Output by MTRXIN. Integer. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if SOLTYP=’MODAL’ and KXX, BXX, and MXX are diagonal. NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX will be ignored. GKAM: If K2DD, B2DD, and M2dd are purged. then the model is considered uncoupled and NONCUP is set to -1. Integer. Set to 1 if nonlinear forcing function Bulk Data entries are processed, -1 otherwise. 1 also means PSDL is created. Output by DPD. Integer. Nonlinear heat transfer flag. Set to -1 if nonlinear heat transfer elements are detected. Output by EMG. Integer. OGS1 creation flag. Set to 0 if OGS1 is created. Output by GPSTR2. Integer. FRLGEN reexecution flag. Set to -1 for no reexecution. Output by FRLGEN. Integer. Number of degrees-of-freedom in the o-set or omitted degree-of-freedom flag. Set to -1 if there are none. Output by GP4 or PARAML. Integer. Output request flag. Set to -1 if no output requests are specified for the current superelement. Output by SEDR. Integer. P2G generation flag. Set to +1 if P2G is generated; -1 otherwise. Output by MTRXIN. Integer. Upstream load presence flag. Set to -1 if there are no loads due to upstream superelements. Output by SELA. Integer. Page header and eject flag. 0 -1 -2 Print page header in f06 and label in f04 Do not print page header in f06 Do not print page header in f06 and label in f04 NOMSET NOMSGSTR NONAMEi NONCUP NONLFT NONLHT NOOGS1 NOOPT NOOSET NOOUT NOP2G NOPG NOPGHD NOPLOT NOPNLT NOPRT NOPSDL NOPSLG NOQG Integer. Plot request flag. Set to -1 if no deformed plot requests are specified for the current superelement. Output by SEDR. Integer. Penalty function flag for electromagnetic elements. Integer. Print flag. Set to 1 if PRINT is requested on the SENSITY Case Control command. Output by DSTA. Integer. Set to 1 if random analysis Bulk Data entries are processed, -1 otherwise. 1 also means PSDL is created. Output by DPD. Integer. Pseudo-load generation flag. Set to -1 if no load generation is requested for the current superelement based on the SEDV or SERESP Case Control commands. Output by SEP2DR. Integer. Single point forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. NX Nastran DMAP Programmer’s Guide 6-73 Chapter 6 Glossaries Name NOQMG NOQSET NORADMAT Type and Description Integer. Multipoint forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. Integer. Number of degrees-of-freedom in the q-set. Integer. Radiation flag. Output by RMG2. -2 -1 1 2 3 No radiation Initial radiation Single band radiation with constant emissivity Radiation with temperature dependent emissivity Multiple band radiation with constant emissivity NORAND NOREAL NORM NORSET NOSASET NOSAVE NOSDR2 NOSE NOSECOM NOSEDV NOSEPLOT NOSERESP Integer. Set to -1 if no random analysis is requested; 0 otherwise. Output by RANDOM. Integer. Number of real value inputs. Character. Method for normalizing eigenvectors. By default (or NORM=’MASS’), MASS normalization is performed. NORM=’MAX’ selects normalization by maximum displacement. Integer. Number of degrees-of-freedom in the r-set. or supported degree-of-freedom flag. Set to -1 if there are none. Output by GP4 or PARAML. Integer. Number of degrees-of-freedom in the a-set of the structure. Integer. Data base store flag. Set to 0 if SAVE is requested on the SENSITY Case Control command. Output by DSTA. Integer. Physical set (g-set) output flag. Set to 1 if any physical set output is requested in CASECC or XYCDB; -1 otherwise. Output by VDR. Integer. Superelement presence flag. Set to -1 if there are no superelements; 0 otherwise. In SEP1X only, set to number of superelements if superelements exist. Output by SEP1 and SEP1X. Integer. Superelement Case Control command flag. Set to -1 if there are no SEALL, SEMG, SEKR, SELG, SELR, or SEMR commands specified in CASECC. Output by SEP3. Integer. Pseudo-load generation flag based on the SEDV Case Control command. Set to -1 if pseudo-loads are not requested for any superelement. Output by SDSB. Integer. SEPLOT or SEUPPLOT request flag. Set to -1 if there are no SEPLOT or SEUPPLOT commands specified in the OUTPUT(PLOT) section. Output by SEP4. Integer. Response sensitivity calculation flag based on the SERESP Case Control command. Set to -1 if response sensitivities are not requested for any superelement. Output by SDSB. Integer. Constraint, omit, and support set flag. Set to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-freedom defined in the a-set (e.g., ASETi, QSETi Bulk Data entries); +1 otherwise. Output by GP4, GPSP, and TRLG. Integer. Degree-of-freedom set existence flag. Set to positive integer if set i exists. Output by PARAML. Integer. The number of elements exclusive of general elements. Set to -1 if there are no simple elements. Output by TA1 and TAHT. Integer. SORT1 format flag. Set to -1 if SORT1 format is not requested for current superelement. Output by SEDR. Integer. SORT2 format flag. Set to 1 if SORT2 format is requested. Output by MDATA, SDR2, and VDR. Integer. Solution set SORT2 format flag. Set to 1 if SORT2 format or x-y plotting is requested for the solution set; -1 otherwise. Output by VDR. NOSET NOSETi NOSIMP NOSORT1 NOSORT2 NOSORT2S 6-74 NX Nastran DMAP Programmer’s Guide Glossaries Name NOSOUT NOSSET NOSUP Type and Description Integer. Solution set (d- or h-set) output flag. Set to 1 if any solution set output is requested; -1 otherwise. Output by VDR. Integer. Number of degrees-of-freedom in the s-set. or single point constraint flag. Set to -1 if there are none. Output by GP4 or PARAML. Integer. Element summary table request flag. 1 2 Generate EST only (usually for linear analysis) Form EST, ESTNL and ESTL (usually for nonlinear analysis) NOTEMP NOTFL NOTIME NOTRACK NOTRL NOUE NOUG NOUGD NOUNIT NOUP NOXGG NOXOUT Integer. Thermal load existence flag. Set to -1 if no TEMP or TEMPD Bulk Data entry images in GEOM3 and ETT is not created, +1 otherwise. Output by GP3. Integer. The number of transfer function Bulk Data entries. Set to -1 if no sets are defined. Output by DPD. Integer. Time out flag. Set to 1 if there is no time left for further iterations but enough time to perform data recovery. Output by NLTRD. Logical. Mode tracking success flag. Set to TRUE if mode tracking was successful. Output by MODTRK. Integer. Set to 1 if transient time step parameter Bulk Data entries are processed, -1 otherwise. 1 also means TRL is created. Output by DPD. Integer. The number of extra points. Set to -1 if there are no extra points. Output by DPD or PARAML. Integer. UG presence flag. Set to -1 if UG already exists for the current superelement. Output by SEDR. Integer. Flag for external input of auxiliary model displacement matrix. If NOUGD>0, then matrix exists. Integer. Number of Fortran input units. Integer. Upstream superelement flag. Set to -1 if there are no superelements connected upstream from the current superelement. Output by SEP2DR and SEDR. Integer. XGG existence flag. Set to -1 if XGG does not exist. Output by MATREDU. Integer. SDRX update flag. Output by SDRX and SDRXD. 0 -1 OEF1X and OES1X are updated OEF1X and OES1X are not updated NOXPLZER NOXPP NOXYPLOT NOYSET NOZSET NQMAX NQSET NR1OFFST NR2OFFST Integer. Explicit zero existence flag. Set to -1 if no explicit zeros are found. Output by MATMOD option 39. Integer. XPP existence flag. Set to -1 if XPP does not exist. Output by MATREDU. Integer. X-Y plot request flag. Set to -1 if no x-y plot requests are specified for the current superelement. Output by SEDR and XYTRAN. Integer. Number of generalized degrees-of-freedom with non-null columns in PHZ. Integer. Number of generalized degrees-of-freedom. Also number of columns in PHZ. Integer. Maximum number of auto-q-set’s allowed per partitioned superelement. See NQSET. Integer. Number of automatic q-set degrees-of-freedom (auto-q-set). Each superelement will have NQSET number of q-set degrees-of-freedom. Integer. Counter for retained type 1 responses. The value is initialized to 1 and is incremented by the number of records in R1TABR. Output by DSAD. Integer. Counter for retained type 2 responses. The value is initialized to 1 and is incremented by the number of records in RSP12R. Output by DSAD. NX Nastran DMAP Programmer’s Guide 6-75 Chapter 6 Glossaries Name NR3OFFST NROW NSEG NSENQSET NSKIP Type and Description Integer. Counter for retained type 3 responses. The value is initialized to 1 and is incremented by the number of records in RESP3R. Output by DSAD. Integer. Number of rows. Output by NORM. Integer. Number of cyclic segments as specified on CYSYM Bulk Data entry. Output by CYCLIC1. Integer. Number of SENQSET degrees-of-freedom allocated to the current superelement. Integer. Record number in CASECC with special meanings in the following applications. Output by GP4, CASE, and BCDR. GP4, BCDR, and SDR1: The first subcase of the current boundary condition. The first subcase of the current boundary condition (nonlinear statics only) or current FREQ, K2PP, M2PP, B2PP, TFL, or SDAMP condition (frequency response or complex eigenvalue analysis). Trim subcase counter. Trim subcase counter. Record number of current subcase in CASECC and used only if the SMETHOD command selects the ITER Bulk Data entry which specifies values for the desired iteration parameters. If NSKIP=-1 then CASECC is not required and the values are taken from the module specification of the values. Subcase record number to read in CASEBUCK for the STATSUB subcase identification number. Loop counter in old geometric nonlinear analysis (SOL 4). Subcase record number to read in CASECC for the METHOD set identification number. Subcase record number to read in CASECC for the LOADSET set identification number. Subcase record number to read in CASECC. On input: Subcase record number to read in CASECC. On output: Set to -2 if run is to be terminated. CASE AELOOP DSARLP FRRD1 and SOLVIT GETCOL GNFM READ and LANCZOS LCGEN NLCOMB, PCOMB, and SDRNL NLITER and TOLAPP NSOUT NSTEP NSWELM NSWPPT NTIPS NULLMAT NULLROW Integer. Number of time steps to output. By default all time steps are output. Integer. Current time step position for subcase, set to 0 at the beginning of the subcase. Output by NLTRD and NLTRD2. Integer. Current spot weld element ID. Output by MODGM2 and MODGM4. Integer. Current spot weld projection point ID. Integer. The number of domains (tip superelements to be created automatically when ACMS=’YES’. If NTIPS=0, then the number of domains will be set equal to the number of processors. Output by SEQP. Integer. Null matrix flag. Set to -1 if MAT is null. Integer. Flag to insert null rows in the output matrices for nonlinear quantities. 0 1 Insert null rows, which is compatible with DRMS1 output format Do not insert null rows, which is required for DRMH3 processing NUMHDOF NUMOUT Integer. The number of modes. Integer. Output element quantity flag. 6-76 NX Nastran DMAP Programmer’s Guide Glossaries Name Type and Description >0 0 -1 -2 Number of element quantities per element type to be output Output all quantities for elements in a group if the absolute value of one or more elements is greater than BIGER. Output sorted quantities with absolute value greater than BIGER. Output filtered quantities with absolute value greater than BIGER. NUMPAN NVECT NX OADPMAX OBJIN OBJOUT OBJSID OBJVAL ODESMAX OG OLDDT OLDNAMi OMEGAJ OMID OPERATN Integer. Number of panels. Output by GP5. Integer. Number of columns in CVECT and PG1. Output by PCOMB. Integer. Number of extra aerodynamic degrees-of-freedom. Output by ADG. Integer. Total number of adaptivity cycles performed. Real. Initial objective value. Real. Final objective value. Output by DOM9. Integer. Superelement identification number associated with DESOBJ. Set to -1 for all cases unless the user specifies the DESOBJ command in a particular superelement subcase. Output by MDCASE. Real. Objective value. Output by DSAD. Integer. Total number of design cycles performed. Integer. CURV module’s grid point processing flag. If set to 0, then grid point stresses or strains are computed. Real. Time step increment used in the previous iteration or time step to be used after the matrix update or subcase switch. Output by NLTRD and NLTRD2. Character. The generic name of the corresponding output; e.g., OLDNAM3 corresponds to OLDDB3, etc. Real. Imaginary part of shift point Aj for pre-Version 70.5 Lanczos method. Character. Material output coordinate system flag. If OMID=’YES’ then stresses, strains, and forces are output in the material coordinate system of CQUAD4, CTRIA3, CQUAD8, and CTRIA6 elements. Character. FORTIO operation. ’EXISTS’ ’OPEN’ ’CLOSE’ Check for assigned physical file existence Open file Close file OPT Character. DIAGONAL module processing option. ’COLUMN’ ’SQUARE’ ’WHOLE’ Extract diagonal to a column matrix and raise all elements to POWER Extract diagonal to a square matrix and raise all elements to POWER Raise all elements to POWER OPTi OPTEXIT OPTFLG Integer. Print control parameters in the TABPRT module. Integer. Design optimization termination option. See the “OPTEXIT” in the NX Nastran Quick Reference Guide . Integer. DSVG1P application method: 1 2 Statics Normal modes NX Nastran DMAP Programmer’s Guide 6-77 Chapter 6 Glossaries Name Type and Description 3 Ncceleration load OPTION Character. Response summation method for scaled response spectra analysis. Possible values are: ’ABS’ SRSS’ ’NRL’ ’NRLO’ Absolute Square root of the sum of the squares Naval Research Laboratory (new) Naval Research Laboratory (old) OSTEP OSWELM OSWPPT OUTFMP OUTOPT OUTSMP OVRWRT PANAME PANELMP PARM PARMi PARTSE PATH Integer. Restart step number. Integer. Offset for spot weld element IDs. Integer. Offset for spot weld projection point IDs. Integer. Number of fluid modes to output. Integer. CURV module’s output option. Integer. Number of structure modes to output. Character. DBC database overwrite flag. Character. The name of the panel whose coupling matrix is created. Output by ACMG. Integer. Flag to compute panel participation factors. Integer. Equivalence flag on the EQUIVX module. Purge flag on the PURGEX module. Logical. Output data block presence flag. Output by DMIIN and DTIIN. Logical. Partitioned superelement flag. Set to TRUE if the current superelement is a partitioned superelement. Output by SEP2DR. Character. Direction of cyclic transformation: ’FORE’ ’BACK’ Forward (analysis) Backward (data recovery) PBCONT PDEPDO Integer. Slideline contact flag. Integer. Skip factor flag. See NOi on TSTEP Bulk Data entry. Output by TRLG. 0 -1 Skip factor is >1. Skip factor is 1. PEID PENFAC PEXIST Pi Integer. Primary superelement identification number. Output by SEP2DR and SEDRDR. Real. Penalty factor for electromagnetic elements. Logical. Set to TRUE if p-elements are present. Character. Generic name of the data block DBi to be processed by the DBC module. Integer. Inputs to the MATGEN, MATMOD, and PARAML module. Any type. Inputs to MESSAGE module. Integer. Size of the load matrix. Compared to the size of load matrix in the previous subcase in order to detect boundary condition changes in the current subcase. Boundary condition changes are not allowed in the arc-length method. Output by NLITER. Integer. SEPLOT (or SEUPPLOT) command counter. Output by SEPLOT. On input: PLSIZE PLTCNT 6-78 NX Nastran DMAP Programmer’s Guide Glossaries Name Type and Description 0 On output: >0 Current SEPLOT (or SEUPPLOT) command Initialization PLTNUM PNLPTV PNQALNAM POSTU POUTF POWER PREC Output. Plot frame counter. Output by PLOT, MSGSTRES, and XYTRAN. Logical. Panel participation/partition vector flag. If TRUE, then generate a partitioning vector APART which may be used to partition the g-set size coupling matrix to obtain the panel’s coupling matrix. Character. Name of qualifier for panels. Integer. Fortran unit number to which the DBC module writes data recovery information. Integer. Intermediate output flag. Set to -1 if intermediate output is not requested. Output by NLITER and TOLAPP. Integer. Power of 10 to be multiplied by DET in DCMP and DECOMP. Exponent to which the real part of each element in A is raised in the DIAGONAL module. Integer. Precision of output matrix. 0 1 2 Machine-precision Single Double PRECOL PREFDB PREFONLY PRESORT PRGNAME PRGPST PRNTOPT PRJVEROP Integer. Subcase record number in CASESTAT referenced by the STATSUB(PRELOAD) subcase identification number. PRECOL also corresponds to the column number of static solution vector. Output by GETCOL. Real. Peak pressure reference for pressure level in units of dB or dBA. Integer. Preface execution only flag in SOLVIT module. Integer. Pre-sort flag. Set to -1 if column is already sorted. Output by MATMOD option 35. Character. Name of external program called by ISHELL module. Character. Singularity summary print flag. If set to ’YES’, then the summary is printed. Character. MATGPR module print options. Character. Operation name. ’GET’ ’NEXT’ ’SET’ ’LAST’ ’RESTART’ Get current project and version Get next non-deleted project and version Set current project and version Get the last (bottom) project and version Get restart project and version PROGRAM Character. DBC database format flag. ’XL’ ’GRASP’ MSC.Patran NX Nastran Access PROJ PROPOPT Integer. Project number. Output by PROJVER. Integer. Property optimization flag. Set to 1 if element properties are defined as design variables. Output by DSABO. NX Nastran DMAP Programmer’s Guide 6-79 Chapter 6 Glossaries Name PROPTN PROTYP Type and Description Integer. In order to support a pre-Version 68 capability, if PROPTN=-1 then an EPT data block which is based on the values and the property to design variable relations will be produced. Integer. Designed property type code. Output by DOPR1. 1 2 4 >0 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations add above values PROUT PRTSWM PRTUIM PSEQOPT PVALNEW Q QUALNAM QUALNAMP QUALVAL R1CNT R2CNT R3CNT RBFAIL RCOLLBLi REACT REAL REALD REALi RECNUM REFC REPEAT RESFLG RESPi RESTYP Integer. Print control for the ELTPRT module. Logical. UWM 6991 print control flag in NORM module. Logical. UIM 4570 print control flag in SELA module. Character. P-element append flag. Specifies append (default) or insert option for p-elements in the SEQP module. Integer. New p-value set identification number. Output by ADAPT. Real. Dynamic pressure. Output by AELOOP and DSARLP. Character. Name of qualifier to be varied when selecting MAPS from MAPS* in SEMA, SELA, and SEDR modules. Character. Keyword which appears on the BEGIN BULK command of the next Bulk Data section; usually AUXMODEL or SEID. Output by XSORT. Character. Name of qualifier to be used in selecting PUG. Integer. QUALNAM value assigned to the Main Bulk Data section. Integer. Counter for type 1 responses in data block R1TAB. Output by DOPR3. Integer. Counter for type 2 responses in data block RESP12. Output by DOPR3. Integer. Counter for type 3 responses in the RESP3 table. Output by DOPR3. Logical. Set to TRUE if grounding check does not pass strain energy threshold used by IOPT=10. Output by VEPCLOT. Character. If RCOLLBLi is blank then ’COLUMN’ will be printed. Label with up to 32 characters to be printed right-justified in upper right corner of each page. RCOLLBLi is then followed by column number. Integer. For zero-th and first harmonic, set to -1 if no support degrees-of-freedom; +1 if support degrees-of-freedom exist. For harmonics greater than 1 REACT is always -1. Output by CYCLIC3. Real. Real part of matrix or table element. Output by PARAML. Real double precision. Real value in the next record. Real. Real value for PRGNAME. Integer. Record number of table element. Output by PARAML. Real. Output by PARAML of AERO data block. Integer. Last boundary condition flag. Set to -1 at the last boundary condition; +1 otherwise. Output by GP4. Integer. Residual vector eigenvalue subheading print flag to be used by the OFP module. Character. Response type. Integer. Optimization results flag. 6-80 NX Nastran DMAP Programmer’s Guide Glossaries Name RGSENS ROWNAM RSEID RSFLAG RSTEP RUNIFPi RUNMEPT SAERCC SCNDRY Type and Description Logical. Rigid element sensitivity flag. Output by DOPR5 or DSVGP4. Character. Degree-of-freedom set name for labeling matrix rows in MATGPR output. Integer. Repeated superelement identification number as specified on the SEBULK Bulk Data entry. Output by SEP2DR and SEDRDR. Logical. Main Bulk Data superelement presence flag. Set to TRUE if superelements are defined in the main Bulk Data section. Output by SEP1X. Integer. Controlled increments counter. Output by NLITER. Logical. IFPi module execution flag. Set to TRUE if IFPi module execution is required. Output by IFP. Logical. MODEPT module execution flag. Set to TRUE if MODEPT module execution is required. Output by IFP. Logical. Aerostatic analysis subcase flag. Set to TRUE if at least one ANALYSIS=SAERO command was found in CASECC and CASESAER is specified in the output list. Output by MDCASE. Integer. Secondary (identical or mirror) superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0. Output by SEP2DR and SEDRDR. Integer. Flag to indicate whether the current subcase has active stability derivative response (STABDER on the DRESP1 Bulk Data entry). 0 indicates no response, 1 indicates an active response. Output by DSARLP. Integer. Sparse data recovery ceiling density. If the density of PVGRID is greater than SDRDENS divided by 100, then choose full data recovery. Integer. Data recovery method flag. Output by OUTPRT. Character. Override for data recovery method flag. Character. Principal stress/strain computation selection: ’SDRP’ ’OFP’ Compute in SDRP Compute in OFP SDFLG SDRDENS SDRMETH SDROVR SDRPOPT SEBULK SEDRCNTL Logical. Partitioned superelement presence flag. Set to TRUE if partitioned superelements are present or BEGIN SUPER is specified for the first BEGIN BULK Case Control command. Character. Processing list selection. ’’ ’CURR’ All superelements will be processed (default). Only the superelement specified by SEID parameter will be processed. SEDWN SEFLAG SEID SEP1XOVR Integer. Downstream superelement identification number. Output by SEP2DR and SEDRDR. Logical. Set to TRUE if partitioned superelements are present. Output by SEPR1. Integer. Superelement identification number. On output from SEP3 and SEP4, SEID is an initialization flag; i.e., if there are superelements, then SEID is set to -1 to initialize SEP2DR and SEDRDR; otherwise 0. Output by SEP2DR, SEDRDR, SEP3, and SEP4. Integer. Over-ride bits for module processing. Bit(s) 1-3 4 5 Value(s) 1-5 8 16 Description Override Search Algorithm Selection. Disable Automatic Main Bulk Scalar Print RSSCON old/new locations. NX Nastran DMAP Programmer’s Guide 6-81 Chapter 6 Glossaries Name Type and Description 6 7 8 32 64 128 Print Boundary Search Sequence. SEP1X "Diag 30" Debugging Output. Auto-SET in Residual place in OSET when other sets present in the Residual. Name SEP2CNTL Type and Description Character. Processing selection. ’ALL’ ’PSLGDV’ ’DSLIST’ ’SLIST’ ’SEDWN’ ’CURR’ All superelements will be processed Only superelements specified on the SEDV Case Control commands Only superelements specified on the SERESP Case Control commands Only superelements specified on the SEALL, SEMG, SEKR, SELG, SELR, or SEMR Case Control commands. All superelements that have SEDWN as their downstream superelement. Only the superelement specified by SEID parameter will be processed. SEP4CNTL Integer. Processing list selection. ’ALL’ <>’ALL’ All superelements will be processed Only superelements specified on SEDR Case Control command SEPRTN SEQMETH SEQOUT SETi SETKNTR SETNAM SETNAME Logical. SUPER command processing flag. Set to TRUE to ignore SUPER command. Integer. Resequencing method. Integer. SEQP module output options. Character. Degree-of-freedom set name. Integer. Pointer to desired member in set; e.g., 1 means first member in set, 2 means second member, etc. If the set is exhausted then SETKNTR is reset to -1. Output by PARAML SET option. Character. Degree-of-freedom set name used by IOPT=9 and 10. Character. Degree-of-freedom set name. SOLVIT, DCMP, READ: For maximum efficiency, the rows and columns of the input matrices must correspond to or be a partition of the degree-of-freedom specified by SETNAME. SEQP Specifies size of MAT in SEQP module. SETYPE Character. Superelement type as specified on the SEBULK Bulk Data entry. Output by SEP2DR and SEDRDR. ’REPEAT’ ’MIRROR’ ’COLLTR’ ’EXTRNA’ ’PRIMARY’ Repeated Mirror Collector External Primary SHAPEOPT SHAPES Integer. Shape optimization flag. Set to 1 if shape optimization is activated. Output by DSAM. Logical. Shape optimization Bulk Data entry presence flag. Must be TRUE if DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present. 6-82 NX Nastran DMAP Programmer’s Guide Glossaries Name SHFSCL Type and Description Real. Estimate of the first flexible natural frequency. SHFSCL must be greater than 0.0. Integer. Alternate set identification number. If SID=0, the set identification number is obtained from the METHOD command in CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMIC. Similarly for CMETHOD and EIGC. If SID>0, then METHOD command is ignored and the EIGR, EIGB, or EIGRL is selected by this parameter value. All subsequent parameter values (METH, F1, etc.) are ignored. Similarly for CMETHOD and EIGC for Lanczos method only. If SID<0, then both the METHOD command and all EIGR, EIGB, or EIGRL entries are ignored and the subsequent parameter values (METH, F1, etc.) will be used to control the eigenvalue extraction. Similarly for CMETHOD and EIGC for Lanczos method only. Real. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Integer. Sign of right hand side matrix, PG in STATICS or B in SOLVIT. 1 -1 Positive Negative SID SIGMA SIGN SIGNAB Integer. Sign of matrix product in MPYAD. 1 -1 Positive Negative Integer. Sign of matrix product in SMPYAD. 1 -1 Positive Pegative SIGNP SIGNC Integer. Sign of matrix addition in MPYAD. 1 -1 Positive Negative Integer. Sign of matrix addition in SMPYAD. 1 -1 Positive Negative SIGNF SING SKPMTX SMEMCC SMPFEPS SMSTCC SNORM SNORMPRT Integer. Singularity flag. If singularities are found, then SING will be set to -1; otherwise +1. Output by DCMP and DECOMP. Integer. If SKPMTX<>0, then KELM1 and KDICT1 will be generated. 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. Real. Threshold for filtering out small structure factor magnitudes. 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. Real. Maximum angle between grid point normal and shell normal. If angle is less than SNORM then grid point normal will be computed. Integer. Grid point shell normal print/punch flag. 0 1 2 No print or punch Punch Print only NX Nastran DMAP Programmer’s Guide 6-83 Chapter 6 Glossaries Name Type and Description 3 Print and punch SORTOPT SOLAPP SOLCUR SOLTYP Integer. Sort option specification. Character. Design optimization analysis type. Integer. Nonlinear loop identification number. Character. Solution method. ’MODAL’ ’DIRECT’ Modal Direct SPC SPCGEN SPSELREC SRCOMP SRTELTYP SRTOPT Integer. SPC Case Control command set identification number specified in the third word of the NSKIP-th record of CASECC. 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. Output. Last record number processed in SPSEL. Set to -1 when processing last record. Output by RSPEC. Character. Flag to request output table of ply strength ratios (OESRT). Integer. Element type to be filtered and sorted. By default, all element types will be filtered and sorted. Integer. Filter/sort option based on NUMOUT and BIGER. 0 1 2 3 Maximum magnitude Pinimum magnitude Maximum algebraic Minimum algebraic SRTTYP START STARTCOL STATCC STATIC STATOPT Integer. Item code 1 sort flag. Set to 1 to perform an integer sort on item code 1 which is usually an integer quantity. Integer. Number of the grid points at the beginning of the input sequence in the SEQP module. Integer. Starting column number to extract from I1. 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. Integer. Static analysis flag. Set to zero for static analysis and one for dynamic analysis. Character. Static solution method. ’DRCT’ ’ITER’ Direct Iterative. STATSUB Integer. STATSUB Case Control command set identification number specified in the 256-th word of the NSKIP-th record of CASECC. 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. Real. On initial input, starting time step and on output, accumulated time used for restarts. Output by NLTRD and NLTRD2. Real. Shape step size scaling factor. STFLG STIME STPSCL 6-84 NX Nastran DMAP Programmer’s Guide Glossaries Name STRUCTMP SUPAERO SUPER SUPORT SWEXIST SYM Type and Description Integer. Number of structure modes to use computing factors. Character. Method for supersonic aero; ’ZONA’ or ’CPM’. Integer. Selects coupled or uncoupled sequencing or special handling of multipoint constraints in the SEQP module. Integer. SUPORT Case Control command set identification number specified in the 255-th word of the NSKIP-th record of CASECC. Logical. Spot weld element existence flag. Set to TRUE if spot weld elements exist. Output by MODGM2. Integer. Symmetric partition or merge flag. 0 <>0 Symmetric; i.e., CP is used for RP Asymmetric; i.e., CP and RP are distinct SYMFLG SYMXY SYMXZ SYS66 T Complex. Scale factor. Integer. Aerodynamic x-y symmetry flag. Output by AEMODEL. Integer. Aerodynamic z-y symmetry flag. Output by AEMODEL. Integer. System cell 66 override for matrix multiply. Integer. Transpose flag for first matrix input to MPYAD. 1 0 Transpose Do not transpose TABID Integer. TABLED1 punch flag. If IDTAB is greater than zero, all requests for XYPUNCH will produce TABLED1 Bulk Data entries for the curve. The table identification number will start at TABID and increase by one for each table punched. Output by XYTRAN. Real. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit. Integer. Temperature set identification number. Usually obtained from the TEMPERATURE Case Control command. Required for use in stress recovery of differential stiffness. Integer. Load increment method flag in nonlinear static analysis. Output by CASE. 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. Integer. Transfer function set identification number. TFLID is ignored if IOPT=3, 4, 5, 13, 14, or 15. Integer. Exponent of 10 which defines the pivoting threshold for unsymmetric decomposition. Integer. Transpose flag for first four matrices input to SMPYAD. 1 0 Transpose Do not transpose TABS TEMPSID TESTNEG TFLG TFLID THRESH Ti TINY TIPSCOL TITLEi TOLAPPF Real. Small element strain energy value. Element strain energies less than TINY will not be printed. Integer. The number of tip superelements upstream of each downstream collector superelement. See ACMS=’YES’. Output by SEQP. Character. Titles for VECPLOT module printed output. Integer. Nonlinear analysis type: 1 Nonlinear transient NX Nastran DMAP Programmer’s Guide 6-85 Chapter 6 Glossaries Name Type and Description 0 Nonlinear statics TOLRSC TOTALK TOUT Real. RSSCON element alignment tolerance factor. Integer. Total number of harmonics. Output by CYCLIC1. Integer. TRLG processing flag. <1 1 2 Use NOi on TSTEP Bulk Data entry All time steps Same as <1 except RPX is input TRD2OPT Integer. TRD2 output option. 1 2 Output based on TSTEP Bulk Data entry Output based on every time step TRL5Ti TSTART TSTATIC TVALUE TVOLFL TWGTFL TWODIV Integer. Specifies value for the fifth word in TOFPi’s trailer. 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. Integer. Static analysis flag. Set to 1 to ignore inertia and damping forces. Integer. Trailer value. Output by PARAML and SCALAR. Integer. Total volume flag. Output by SDSA. Integer. Total weight flag. Output by SDSA. Output. Nonlinear analysis divergence flag. 0 1 No previous divergence on this load step. One previous divergence on this load step. TYPE UNITNO UNSYMF UPFM UPSECC USETBIT USETADD USETOP VALUED VERS VOLS VREF VUBEAM Integer. Type of output matrix. Integer. Specifies FORTRAN unit number. Character. Unsymmetric stiffness generation for slideline contact stiffness. If set to ’YES’ then stiffness matrix will be unsymmetric for slideline contact. Integer. UFM 4252 print flag. Set to -1 to print UFM 4252 and set NOGO=-1 if there are missing upstream boundary matrices. Logical. Superelement analysis subcase flag. Set to TRUE if SUPER=ALL or SUPER>0 in CASECC. and CASEUPSE is specified in the output list. Output by MDCASE. Integer. Decimal equivalent of bit position of a degree-of-freedom set. Output by PARAML. Integer. USET length extension. Extend the size of the USET by this amount. Character. Name of desired operation. Complex double precision. Contents of element at IROW-th row and ICOL-th column in matrix [A]. Output by SCALAR. Integer. Version number. Output by PROJVER. Real. Total volume of analysis model. Output by WEIGHT. Real. Flutter velocity divisor to obtain flutter indices. Character. Name for VUBEAM element. 6-86 NX Nastran DMAP Programmer’s Guide Glossaries Name VUELJUMP VUENEXT VUEXIST VUGJUMP VUGNEXT VUHEXA VUPENTA VUQUAD4 VUTETRA VUTRIA3 WGTS WGTVOL WRDNUM WTMASS WVFLG XFLAG Type and Description Integer. Delta between view-element identification numbers. Integer. Starting identification number for next view-element. Output by DVIEWP and VIEWP. Logical. View-element flag. Set to TRUE if view-elements exist. Output by DVIEWP and VIEWP. Integer. Delta between view-grid identification numbers. Integer. Starting identification number for next view-grid. Output by DVIEWP and VIEWP. Character. Name for VUHEXA element. Character. Name for VUPENTA element. Character. Name for VUQUAD4 element. Character. Name for VUTETRA element. Character. Name for VUTRIA3 element. Real. Total weight of analysis model. Output by WEIGHT. Integer. Weight/volume retained response flag. Set to >0 if any retained response. Output by DSPRM. Integer. Word number of table element. Output by PARAML. Real. Scale factor on structural mass matrix. 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. Integer. Strain energy method selection. 0 1 Elemental force Cross displacement XNORM XNORMD XTYPE Real. Maximum absolute normalizing value over all columns. Output by NORM. Real-double precision. Same as XNORM except in double precision. Integer. Type of element matrix data: 0 1 2 Stiffness Damping Mass XYSET Character. Degree-of-freedom set type. ’SOL’ ’DSET’ ’HSET’ ’PSET’ Solution set (d-set or h-set) d-set h-set p-set XYUNIT ZCOLLCT ZFREQ Integer. FORTRAN unit number to which the DOM12 module writes design optimization x-y plot data. 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. Integer. Zero frequency truncation selection. If set to 1 then the zero frequency, if any, will be truncated from UXF and FOL. NX Nastran DMAP Programmer’s Guide 6-87 Chapter 6 Glossaries Parameter Naming Conventions LUSET NO__SET NORC NO_____ ALWAYS NEVER NP NOGO "Length of USET"; i.e., number of degrees-of-freedom in the g-set. For example, LUSETD (d-set), LUSETS (superelement) Sometimes, and more rightly, called NOGSET. Number of degrees-of-freedom in the __-set (=-1 if none) Set to -1 if there is no c-set and no r-set. "no" _____ (e.g.; no data block) exists or can be found Initialized and always assumed to be -1 Initialized and always assumed to be 0 Local usage or dummy Hidden parameter set by module (no "S,N,NOGO" on module call) Must be trapped immediately. 6-88 NX Nastran DMAP Programmer’s Guide Chapter 7 NASTRAN Data Definition Language (NDDL) • • NDDL Summary Detailed Description of NDDL Statements NX Nastran DMAP Programmer’s Guide 7-1 Chapter 7 NASTRAN Data Definition Language (NDDL) 7.1 NDDL Summary The NDDL (NX Nastran Data Definition Language) has several purposes: 1. The NDDL describes the hierarchical data structure of the NX Nastran database. 2. The NDDL provides the mechanism, in conjunction with the TYPE DMAP statement, for determining which NX Nastran generated data blocks or parameters or both are 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 provide the means for selecting specific data blocks in the form of flat tables from the hierarchical database structure, thus admitting them to relational database manipulation. 5. The NDDL provides the necessary data dependencies for automatic modified restarts. Descriptions of NDDL Statements DATABLK DEPEN PARAM PATH QUAL Define a data block’s name, path, and location and describe its contents Define a data block, parameter, or virtual parameter to be dependent upon other data block(s), parameter(s) or virtual parameter(s) Define a parameter’s name, type, path, location, and default value List the QUALifiers to be used in accessing the data block or parameter via the NDDL Define a qualifier’s name, type and default value 7.2 Detailed Description of NDDL Statements Syntactical Descriptions In the descriptions of the NDDL statements, the following notation is used: 1. Slashes, colons, and parentheses must be specified as shown. 2. Uppercase letters are keywords and must be specified as shown. 3. Lowercase letters represent variables, the permissible values of which are indicated in the descriptive text. 4. Shaded words indicate the default. 5. One or more items in square brackets [ ] are optional. If the describers are stacked vertically, only one can be specified. 6. One or more items in braces { } must be specified. If the describers are stacked vertically, only one can be specified. 7-2 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) DATABLK Describes data blocks used for NDDL access A data block is a collection of matrix columns or table records and can be broken down into the following entities: 1. Record (or column) is a group of items and/or entries. 2. Entry is a group of items and/or entries within a record. 3. Item is a single scalar quantity; such as an integer, real number, complex number, character string, or logical. Format: DATABLK,db_name,PATH=pathname,LOCATION=loc_param, where: style SAMEAS db_description = = = The db_description has special rules. Only TABLE(OFP) and TABLE(CASE) are allowed. The db_description on another DATABLK, sname statement. 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. where: RECORD(*) = RECORD = rec_description defines all records. It can be specified only once following RECORD=HEADER. rec_name[(h1 [,h2 [,h3 ]]] assigns a name to the record and can optionally indicate that the record begins with one to three integers called header words. This format can be specified more than once. Only a few data blocks have this type of record; such as IFP module output data blocks. rec_description contains one or more of the following rec_components that can be repeated and in any order: • item_component defines a single item. NX Nastran DMAP Programmer’s Guide 7-3 Chapter 7 NASTRAN Data Definition Language (NDDL) • • entry_component defines a description of one or more rec_components that can be repeated in the record. either_component defines a description of one or more rec_components that is conditional upon the value of another item anywhere in the record. item_component has one of the following forms: where: rep_count C = = The number of times the item is repeated. The default is zero. item_name is referenced by BACK in an either_component or COUNT in an entry_component. • item_type is: Item type I RS RD CS CD CHARi LOGICAL Description Integer Real — single precision Real — double precision Complex — single precision Complex — double precision Character (i = length) Logical • UNDEF indicates a dummy item that is one machine-word in length. entry_component has the following form: ENTRY[ = entry-name], rec_component 7-4 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) where: COUNT = The number of times the entry occurs in the record. item_name specifies the name of an item in the record whose value specifies the number of occurrences and n specifies a constant integer value for the number of occurrences. An entry description specified on another ENTRY=sentry_name A numeric value(s) that identifies the end of repeating ENTRY... ENDENTRY grouping. If this is specified, no more rec_components follow in the record and RECORD or EOF must follow. This is required; it terminates the entry_components. SAMEAS end_valuei If EOR ENDENTRY = = = = either_component has the following form: where: AHEAD or BACK = An item defined elsewhere in the record. NX Nastran DMAP Programmer’s Guide 7-5 Chapter 7 NASTRAN Data Definition Language (NDDL) OR ENDEITH = = The beginning of an optional description of the item=item_valn. This is required and terminates the either_component. Keywords: TYPE TABLE TABLE (CASE) TABLE (OFP) MATRIX UNSTRUCTURED EOR EOF Defines the class or characteristics of information it contains. A collection of records. Special style of table for Case Control tables. Special style of table that are suitable for input to the OFP module. A M by N dimensional array of related items obeying the rules of matrix algebra. The data block has no description. db_description, and SAMEAS are ignored. End of record description. End of the data block description. 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. Name of the path, which is also referenced on a PATH statement. Variable character parameter name with a value that is the DBset name. See the PARAM NDDL statement and the INlT FMS statement. Record name (optional). Entry name (optional). Item name. Item_name can have an integer argument and would then take the form: item_name(i) where i is an explicit integer value. Item value. Function code. (Optional) Specifies an operation to perform on the item_name value found in the data block. The result of the operation will then be compared to item_val. pathname loc_param rec_name entry_name item_name item_vali func_code 7-6 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) 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 cannot physically exist in any given data block. 2. For UNDEF items, DEPENdencies are not checked. For transfer of data between machine types, they are considered integer zero. Examples: 1. The simplest DATABLK statement might be of the form: DATABLK,INDATA,PATH=DMS,LOCATION=DBDN,EOF A more complex specification of a DATABLK statement is of the form: DATABLK,GEOM4S,TYPE=TABLE,PATH=PEIDI,LOCATION=IFPX,SAMEAS, GEOM4,EOF In the above statement, SAMEAS,GEOM4 specifies that GEOM4S has the same data block description specified under the DATABLK,GEOM4 statement. 2. Consider the following: DATABLK ,EQEXIN,TYPE=TABLE,PATH=PEIDI,LOCATION=IFPX, RECORD=HEADER,NAME(2),CHAR4,EOR, RECORD=EXT2INT, GRIDID,I,INTERNAL,I, EOR, RECORD=EXT2SIL, GRIDID,I,TENXSIL,I,EOR,EOF The NAME(2) above represents a two-word item with each word four characters in length. The RECORD=EXT2INT gives this particular record the record-name EXT2INT. In the record named EXT2INT there are two integer items called GRIDID and INTERNAL. These two groups are repeated until the EOR is encountered. A simple ENTRY ... ENDENTRY grouping is: RECORD=MAT9(2603,26,300), MID,I, ENTRY=GEES, G(21),RS, ENDENTRY, RHO,RS,..., EOR, In the above example, the Gs were grouped into an ENTRY - ENDENTRY group called GEES with 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, NX Nastran sees the describer (2603,26,300), rather than the record name (for example, MAT9). Another example of an ENTRY ... ENDENTRY group is as follows: 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 NX Nastran DMAP Programmer’s Guide 7-7 Chapter 7 NASTRAN Data Definition Language (NDDL) encountered, repetition of the ENTRY ... ENDENTRY group stops. Another similar example is of the form: RECORD=MPC(4901,49,17), SID,I,..., ENTRY, G1,I,C1,I,A1,RS, ENDENTRY,WITH,(-1,-1,-1),EOR, In the above MPC record, the group G1, C1, A1, repeats until -1 -1 -1 is encountered in the record. A complex example of ENTRY ... ENDENTRY groups is shown next. RECORD=RBE3(7101,71,187), EID,I,REFGRID,I,REFC,I, ENTRY, WT1,RS,C1,I, ENTRY, G1,I, ENDENTRY,WITH,-1, ENDENTRY,WITH,-2, ENTRY, GM1,I,CM1,I, ENDENTRY,WITH,-3, EOR, In this example, an ENTRY ... ENDENTRY group is shown nested within another ENTRY ... ENDENTRY group. If an ENTRY .. ENDENTRY group appears in another ENTRY ... ENDENTRY group, it must be entirely contained in the particular group. The outer ENTRY ... ENDENTRY group of this example uses the ElTHER,OR clause to select the ENDENTRY statement. In this particular example, the inner ENTRY ... ENDENTRY group is terminated by -1. The outer ENTRY ... ENDENTRY group is terminated when a -2 is encountered. If a -2 is encountered, another ENTRY ... ENDENTRY group terminating with -3 is executed. If -3 is encountered the outer loop terminates. The record is continuously repeated in this fashion until the EOR is encountered. The next example uses EITHER,OR clauses to select one of several possible table formats including an ENTRY ... ENDENTRY grouping. RECORD=RELEASE(1310,13,247), SEID,I,C,I, EITHER,0, ENTRY, G1,I, ENDENTRY,WITH,-1, 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 an “ALL” option. Another use of the SAMEAS clause is as follows: ,..., ENTRY=SOLDSP,SAMEAS,NONLIN,ENDENTRY, This statement says that SOLDSP entry has an identical group structure to an ENTRY=NONLIN grouping, which is in the same data block and comes physically before the SOLDSP entry. The COUNT = n is shown in the next example: ,..., 7-8 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) 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. The next example shows a use of UNDEF, length. RECORD=CCONE(2315,23,0), EID,I,PID,I, UNDEF,18, EOR, Here UNDEF,18 says that the next 18 items in the table are undefined. Neither item-name nor data-type are defined. The next example shows the use of AHEAD(item-name). RECORD=CBAR(2408,24,180), EID,I,PID,I,GA,I,GB,I, EITHER,AHEAD(F)=1, X1 ,RS,X2,RS,X3,RS,F,I OR,2, GO,I,UNDEF,2,F,I, ENDEITH, ... In this example, AHEAD(F) says read F, which is required to be integer to determine the appropriate description, N. DEPEN 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. NX Nastran DMAP Programmer’s Guide 7-9 Chapter 7 NASTRAN Data Definition Language (NDDL) Format: 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_* indep_* desc_loc Dependent data block, parameter, or virtual parameter as indicated by DB, P, or VP, respectively. Independent data block, parameter, or virtual parameter as indicated by DB, P, or VP, respectively. Description locator of the independent record, entry, or item. 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, DEPEN A/B $ delete A if any item in B changes DEPEN A/B:C $ delete A only if record C changes DEPEN A/B:C:D $ delete A only if entry D of record C changes DEPEN A/B:C:D:E $ delete A only if item E in entry D of record C changes 2. If record_name, entry_name or item_name is not defined in the DATABLK description, leave these fields blank but specify the colon. Examples: 1. EPTS example: DEPEN EPTS TYPE=TABLE PATH=PEIDI LOCATION=IFPX, SAMEAS,EPT,EOF DATABLK EPT TYPE=TABLE PATH=IFPI LOCATION=IFPX, RECORD=PBAR(52,20,181) PID,I,MID,I,A,RS,I1,RS,I2,RS,J,RS,NSM,RS,FE,RS,C1,RS,C2, RS,D1,RS,D2,RS,E1,TS,E2,RS,F1,RS,F2,K1,RS,K2,RS,I12,RS,EOR, RECORD=PBEAM(5402,54,262), PID,I,MID,I,NI,CCF,I,X,RS, ENTRY=SECTIONS, SO,RS,XXB,RS,A,RS,I1,RS,I2,RS,I12,RS, J,RS,NSM,RS,C1,RS,C2,RS,D1,RS,D2,RS,E1,RS, E2,RS,F1,RS,R2,RS,ENDENTRY,COUNT=11, K1,TS,K2,RS,S1,RS,S2,RS,NSIA,RS,NSIB,RS,CWA,RS, CWB,RS,M1A,RS,M2A,RS,M1B,RS,M2B,RS, 7-10 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) N1A,RS,N1B,RS,N2A,RS,N2B,RS,EOR, DEPEN EPTSK(VP)/EPTS:PBAR::PID,EPTS:PBAR::MID, EPTS:PBAR::A, . . . EPTS:PBEAM:SECTIONS:A,EPTS:PBEAM:SECTIONS:I1,EPTS:PBEAM:SECTIONS:I2, 2. GEOM1S example: DATABLK GEOM1S TYPE=TABLE PATH=PEID LOCATION=IFPX, SAMEAS,GEOM1,EOF DATABLK GEOM1 TYPE=TABLE PATH=IFP LOCATION=IFPX, RECORD=HEADER,NAME(2),CHAR4,EOR, . . RECORD=GRID(4501,45,1), ID,I,CP,I,X1,RS,X2,RS,X3,RS,CD,I,PS,I,SEID,I,EOR, . . RECORD=SEQGP(5301,53,4), ID,I,SEQID,I,EOR, . . EOF DEPEN NODES(VP)/GEOM1S:GRID::ID,GEOM1S:GRID::CP, GEOM1S:GRID:::X1,GEOM1S:GRID::X2,GEOM1S:GRID::X3, GEOM1S:GRID::CD $ DEPEN GPLS / NODES(VP,SNODES(VP) $ DEPEN LUSETS(P) /GPLS,GEOM1S:SEQGP $ PARA PARAM Defines parameters requiring a path and/or dbset location Format: PARAM parameter-name[=default-value] TYPE=data-type, PATH=path-name LOCATION=dbset-name $ 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. The explicit default value of the parameter. If no default value is given, CHARi defaults to a “blank” and all others default to zero. The data type. Possible data types are as follows: Description Integer default-value data-type Data type I NX Nastran DMAP Programmer’s Guide 7-11 Chapter 7 NASTRAN Data Definition Language (NDDL) Data type RS RD CS CD CHARi, where i = 1 through 80 LOGICAL Description Real — single precision Real — double precision Complex — single precision Complex — double precision Character Logical The logical name of the hierarchical structure. Refer to the PATH statement. 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. path-name dbset-name Remarks: 1. The TYPE DMAP statement can not override the default set with this statement. Any default value set with the TYPE DMAP statement is ignored. 2. DBset-name parameters in LOCATION must be assigned to MASTER. 3. Character values must be enclosed in single quotation marks. Examples: PARAM,POST=0,TYPE=I,PATH=DMS,LOCATION=DBDN PARAM,WTMASS=1.0,TYPE=RS,PATH=DMS,LOCATION=DBUP PARAM,CM1=(1.0,0.0),TYPE=CS,LOCATION=DBDN PARAM,MESH=’NO’,TYPE=CHAR8,PATH=DMS,LOCATION=DBUP PARAM,DBUP=’DBALL’,TYPE=CHAR8,PATH=DMS, LOCATION=MASTER PARAM,DBDN=’DBALL’,TYPE=CHAR8,PATH=DMS, LOCATION=MASTER PATH Defines a list of qualifiers for reference on DATABLK/PARAM NDDL statements Format: PATH pathname qual-name1, qual-name2, ... 7-12 NX Nastran DMAP Programmer’s Guide NASTRAN Data Definition Language (NDDL) 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 can be referenced on one or more DATABLK and/or PARAM statements with PATH=path-name. A list of qualifiers that are defined on QUAL NDDL statements. qual-namei Example: The path DMSL specifies qualifiers MODEL, SEID, and LID. PATH DMSL MODEL,SEID,LID $ QUAL Defines qualifiers referenced on PATH NDDL statement Format: QUAL(qtype) qual-name1=default-value1 qual-name2=default-value2,... Variables: qtype qtype I RS RD CS CD CHARi, where i = 1,80 LOGICAL qual-namei default-valuei Type of qualifier. Description Integer Real — single precision Real — double precision Complex — single precision Complex — double precision Character Logical Name of the qualifier referenced on a PATH NDDL statement. Default value of the qualifier. Character values must be enclosed in single quotation marks. Remarks: 1. qual-namei can be referenced on one or more PATH NDDL statements. NX Nastran DMAP Programmer’s Guide 7-13 Chapter 7 NASTRAN Data Definition Language (NDDL) 2. The TYPE,PARM,NDDL DMAP statement must be used to declare the qualifier in the subDMAP. 3. Qualifiers can 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 7-14 NX Nastran DMAP Programmer’s Guide Chapter 8 Overview of DMAP Modules and Statements • • DMAP Module and Statement List DMAP Module and Statement Description Summary NX Nastran DMAP Programmer’s Guide 8-1 Chapter 8 Overview of DMAP Modules and Statements 8.1 DMAP Module and Statement List Descriptions of the most common and easy-to-use DMAP modules and statements are contained in “Descriptions of DMAP Modules and Statements”, arranged alphabetically. Conditional statements IF, IF ( ) THEN, ELSE, ELSE IF ( ) THEN, ENDIF, DO WHILE, ENDDO, JUMP, and LABEL are described in “Control Statement”. The Assignment (=) statement is described in “Assignment Statement”, and the Function statements are described in “Function Statement”. Matrix Modules ADD ADD5 CEAD DCMP DECOMP DIAGONAL FBS MERGE MPYAD NORM PARTN READ SMPYAD SOLVE SOLVIT TRNSP UMERGE UMERGE1 UPARTN Utility Modules APPEND COPY DBC DBDICT DMIIN DRMS1 DTIIN ELTPRT IFP IFP1, . . . IFP9 INPUTT2 INPUTT4 LAMX MATGEN MATGPR MATMOD MATPCH MATPRN MATPRT MODTRL MTRXIN NXNADAMS OFP OUTPUT2 OUTPUT4 PARAML PRTPARM PVT RESTART SCALAR SEQP TABEDIT TABPRT TABPT VEC VECPLOT XSORT 8-2 NX Nastran DMAP Programmer’s Guide Overview of DMAP Modules and Statements Executive Modules and Statements DBVIEW DELETE EQUIVX FILE MESSAGE PURGEX Miscellaneous Modules and Statements ACMG ADAPT ADG ADR AELOOP AEMODEL AMG AMP APD ASDR ASG AXMDRV AXMPR1 AXMPR2 BDRYINFO BCDR BGCASO BGICA BGP BMG BNDSPC CASE CMPZPR CURV CURVPLOT CYCLIC1 CYCLIC2 CYCLIC3 CYCLIC4 DOPRAN DPD DRMH1 DRMH3 DRMT1 DSABO DSA DBDELETE DBEQUIV DBSTATUS DDR2 DDRMM DISDCMP DISFBS DISOFPM DSADJ DSAE DSAF DSAH DSAJ DSAL DSAM DSAN DISOFPS DISOPT DISUTIL DIVERG DOM10 DOM11 DOM12 DOM6 DSAP DSAPRT DSAR DSARLP DSARME DSARMG DSARSN DSAW DOM9 DOPFS DOPR1 DOPR2 DOPR3 DOPR4 DOPR5 DOPR6 DSDVRG DSFLTE DSFLTF DSMA DSPRM DSTA DSTAP2 DSVG1 NX Nastran DMAP Programmer’s Guide 8-3 Chapter 8 Overview of DMAP Modules and Statements DSVG1P DSVG2 DSVG3 DSVGP4 DSVGP5 DUMMOD1-4 DVIEWP DYCNTRL DYNREDU GPJAC GPSP GPSTR1 GPSTR2 GPWG GUST EFFMAS ELFDR EMA EMAKFR EMG ESTINDX FA1 FA2 FORTIO IFPINDX IFT INTERR ISHELL LANCZOS LCGEN LMATPRT FRLG FRLGEN FRQDRV FRRD1 FRRD2 GENTRAN GETCOL GETMKL GI MACOFP MAKAEFA MAKAEFS MAKAEMON MAKCOMP MAKENEW MAKEOLD MAKMON GKAM GNFM GP0 GP1 GP2 GP3 GP4 GP5 GPFDR MATGEN MATREDU MCE1 MCE2 MDATA MDCASE MGEN MKCNTRL OUTPRT PCOMB PLOT PLTHBDY PLTSET PLTMSG PRESOL PROJVER MKCSTMA MKRBVEC MKSPLINE MODACC MODEPF MODEPOUT MODGDN MODGM4 MODTRK MODUSET MONVEC MPP MRGCOMP MRGMON MSGHAN MSGSTRES NASSETS NLCOMB NLITER NLTRD NLTRD2 OFPINDX OPTGP0 ORTHOG 8-4 NX Nastran DMAP Programmer’s Guide Overview of DMAP Modules and Statements RANDOM RBMG3 RBMG4 RMG2 RSPEC SCE1 SDP SDR1 RANDOM RMAXMIN SHPCAS SMA3 SSG1 SSG2 SSG3 SSG4 STATICS SDR2 SDR3 SDRCOMP SDRHT SDRNL SDRP SDRX SDRXD STDCON STRSORT TA1 TAFF TAHT TASNP1 TASNP2 TOLAPP TRD1 SDSA SDSB SDSC SECONVRT SEDR SEDRDR SELA SEMA TRD2 TRLG UEIGL UGVADD UREDUC VDR VIEW VIEWP WEIGHT SEP1 SEP1X SEP2 SEP2CT SEP2DR SEP2X SEP3 PROJVER XYPLOT XYTRAN 8.2 DMAP Module and Statement Description Summary Following is a summary description of the modules described in detail in the next section and a listing of obsolete modules. Matrix Modules Module ADD ADD5 CEAD DECOMP,DCMP DIAGONAL Basic operation [X] = α[A] β[B] [X] = α[A] + β[B] + λ[C] + Δ[D] + ε[E] Solves for p and {φ} in([M]p2 + [B]p + [K]) {φ} = {0} [A] → [L] [U] NX Nastran DMAP Programmer’s Guide 8-5 Chapter 8 Overview of DMAP Modules and Statements Module FBS MERGE Basic operation [X] = ±([L] [U])−1[B] MPYAD NORM PARTN [X] = ±[A][B] ± [C] or [X] = ±[A]T [B] ± [C] [X] = [A] normalized to 1.0 maximum in each column READ, LANCZOS SMPYAD SOLVE, SOLVIT TRNSP UMERGE Solves for λ and {φ} in ([K] − λ[M]){φ} = {0} [X] = [A][B][C][D][E] ± [F] or [AT [B][A] [X] = ± [A−1 [B] or ± [A]−1 [X] = [A]T UMERGE1 UPARTN Utility Modules Module APPEND COPY DBC DBDICT DMIIN Basic function Concatenates two data blocks Copies a data block Converts data blocks for model generation and results processing Prints database directory tables with optional user-selectable format Converts DMI Bulk Data entries to data blocks 8-6 NX Nastran DMAP Programmer’s Guide Overview of DMAP Modules and Statements Module DRMS1 DTIIN ELTPRT IFP1 IFP, IFP3 through IFP9 INPUTT2 INPUTT4 LAMX MATGEN MATGPR MATMOD MATPCH MATPRN MATPRT MERGEOFP MESSAGE MODACC MODTRL MTRXlN NXNADAMS OFP OUTPUT2 OUTPUT4 PARAML PRTPARM Basic function Recovers data by mode superposition Converts DTI Bulk Data entries to data blocks Prints Element Summary Information Reads in the Case Control Section Converts the output from the XSORT module into several tables Reads data blocks from FORTRAN-readable files Reads matrices from FORTRAN-readable files Edits or generates real or complex eigenvalue summary table Generates special matrices, such as identities, and so on Prints matrices with grid point and component identification Transforms a collection of input matrices into output matrices Punches the contents of matrix data blocks onto DMI Bulk Data entries Prints general matrix data blocks (10 items per line) Prints matrix data blocks (6 items per line) Merges linear and nonlinear stress data blocks from SDR2 Prints user defined messages Partitions solution vectors based on the OTIME or OFREQ Case Control command Modifies data block trailer data Converts DMIG Bulk Data entries to matrix data blocks Writes ADAMS Modal Neutral File (MNF) for a superelement. Provides user-oriented self-explanatory formats for data blocks prepared by other functional modules (for example, READ, CEAD, SDR2, etc.) Writes tables or matrices onto FORTRAN-readable files Writes matrices onto FORTRAN-readable files Select parameters from a user input matrix or table Prints parameter values and DMAP error messages NX Nastran DMAP Programmer’s Guide 8-7 Chapter 8 Overview of DMAP Modules and Statements Module PVT RESTART SCALAR SEQP TABEDlT TABPRT TABPT TIMETEST VEC VECPLOT XSORT Basic function Sets parameter values from Case Control and/or Bulk Data PARAM entries Compares two data blocks and/or invokes dependencies defined in the NDDL Selects parameters from a user input matrix or table Generates a mapping matrix for use in resequencing matrices Edits tables Prints selected table data blocks using user-oriented formats Prints table data blocks Compute timing data Generates partitioning vector Transforms, searches, and computes resultants of vectors Reads in the Bulk Data Section Executive Modules and Statements Module or statement DBVIEW DELETE EQUIVX FILE PURGEX TYPE Basic function Creates a virtual data block from an NDDL data block Deletes a data block(s) from the database Assign another name to a data block Defines special data block characteristics to DMAP compiler Flags a data block as empty on the database Identifies NDDL data blocks and parameters Obsolete Modules and Statements The following modules are obsolete and are either no longer available or not recommended: DMAP module or statement COND Alternate method or modules IF and IF ( ) THEN statement 8-8 NX Nastran DMAP Programmer’s Guide Overview of DMAP Modules and Statements DMAP module or statement DBDIR EQUIV INREL PARAM PARAMR PURGE RBMG2 REIGL REPT SCE1 SETVAL SMP2 TASN Alternate method or modules DBDICT statement EQUIVX module SubDMAP SEMR3 Function and assignment statements Function and assignment statements PURGEX module DECOMP READ module DO WHILE statement UPARTN Assignment statement UPARTN, MPYAD, SMPYAD TASNP2 NX Nastran DMAP Programmer’s Guide 8-9 Chapter 9 Descriptions of DMAP Modules and Statements NX Nastran DMAP Programmer’s Guide 9-1 Chapter 9 Descriptions of DMAP Modules and Statements The following descriptions of commonly used DMAP modules are in alphabetical order. 9.1 ACMG Computes the coupling matrix for fluid/structure interface at all points or only points on a given structural panel. Format: ACMG Input Data Blocks: PANSLT BGPDT CSTM SIL ECT EQACST NORTAB EQEXIN EDT Panel static load table Basic grid point definition table Table of coordinate system transformation matrices Scalar index list Element connectivity table Equivalence between internal fluid grid points and internal structural grid points which lie on the fluid/structure boundary Table containing fluid face and the maximum of eight structural grids which lie within the acoustic face Equivalence between external grid/scalar and internal identification numbers Element deformation table, which contains SET1 entries Output Data Blocks: AGG APART Fluid/structure coupling matrix at all points or for a structural panel Partitioning vector for panel coupling matrix when PNLPTV=TRUE 9-2 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: LUSET MPNFLG NUMPAN PANAME IPANEL MATCH Input-integer-no default. The number of degrees-of-freedom in the g-set. Input-integer-default=0. Set to 1 if multiple panels exist. Input-integer-default=1. Number of panels. Output-character-default=‘NASTPANL’ Name of the panel whose coupling matrix is created. Input-integer-default=1. Number of records to skip to get the required data in the PANSLT table. Input-integer-default=0. Type of fluid/structural mesh matching. 0 1 PNLPTV matching mesh nonmatching mesh Input-logical-default=FALSE. Panel participation/partition vector flag. If TRUE, generate a partitioning vector APART which can be used to partition the g-set size coupling matrix to obtain the panel‘s coupling matrix. 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 $ PANSLT,BGPDTS,CSTMS,SILS,ECTS,EQACST,NORTAB,EQEXINS/ AGG/LUSETS/////MATCH $ ACMG Compute coupling matrices for all structural panels. 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 GP5 NX Nastran DMAP Programmer’s Guide 9-3 Chapter 9 Descriptions of DMAP Modules and Statements 9.2 ADAPT 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 $ Input Data Blocks: CASECC EPT EDT EST ELEMVOL VIEWTB UG MPT ETT CSTM PVAL0 ERROR0 PELSET DEQATN DEQIND DIT OINT Case Control table Table of Bulk Data entry images related to element properties Element deformation table. Contains ADAPT Bulk Data entries. Element summary table Element volume table, contains p-element volumes and the p-value dependencies of each p-element grid, edge, face and body View information table, contains the relationship between each p-element and its view-elements and view-grids Displacement matrix in g-set Table of Bulk Data entry images related to material properties Element temperature table Table of coordinate system transformation matrices p-value table generated by ADAPT module in previous superelement or adaptivity loop Error estimate table generated by ADAPT module in previous superelement or adaptivity loop p-element set table, contains SETS DEFINITIONS Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of TABLEij Bulk Data entry images p-element output control table, contains OUTPUT Bulk Data entries 9-4 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GEOM4 BGPDT GPSNT EPSSE LAMA GLERR Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Basic grid point definition table Grid point shell normal table Table of epsilon and external work Normal modes eigenvalue summary table Table of global error estimates from previous iteration Output Data Blocks: PVAL1 ERROR1 GLERR1 P-value table updated for current superelement or adaptivity loop Error-estimate table updated for current superelement or adaptivity loop Table of global error estimates for current iteration Parameters: 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. Input-character-no default. Analysis type: ‘STATICS’or ‘REIGEN’ Input-integer-no default. P-version analysis adaptivity index. Input-integer-no default. Superelement identification number. Output-integer-no default. New p-value set identification number. Output-logical-no default. Set to TRUE if this is the final adaptivity loop. Input-integer-no default. Design optimization iteration number. Input-integer-no default. Design optimization maximum allowed iteration number. Input-integer-default=0. Design optimization convergence flag. APP ADPTIND SEID PVALNEW ADPTEXIT DESITER DESMAX CNVFLG Remarks: 1. If superelements are present, CASECC must contain only the residual structure. EPT, EST, UG, MPT, CSTM, GEOM4, BGPDT, and GPSNT apply to the current superelement only. See Example. NX Nastran DMAP Programmer’s Guide 9-5 Chapter 9 Descriptions of DMAP Modules and Statements 2. If DATAREC Case Control command and OUTPUT Bulk Data entries are specified, ADAPT also prints or punches out the p-value and error tables for specified p-element identification numbers at desired adaptivity loops. Example: Set up ADAPT module for superelement analysis. EQUIVX CASESX/CASE0/-1 $ CAPTURE R.S. CASE CONTROL $ FOR ALL SUPERELEMENTS EQUIVX PVAL /PVALN/-1 $ COPY NDDL, WITH CURRENT VALUE EQUIVX ERROR/ERRORN/-1 $ OF PVALID QUALIFIER, TO SCRATCH. DO WHILE (LPFLG >= 0) $ IF ( RSONLY ) THEN $ SEID = 0 $ PEID = 0 $ LPFLG=-1 $ EXIT LOOP AFTER THIS PASS ELSE $ SEP2DR SLIST,EMAP//S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,LPFLG/ S,N,NOMAT/S,N,NOASM/S,N,NOLOAD/S,N,NOLASM/S,N,NOUP/ S,N,SCNDRY/S,N,EXTRN/S,N,NOMR/‘ALL‘//-1 $ ENDIF $ CALL SETQ CASESX//SEID/PEID/S,MTEMP/S,K2GG/S,M2GG/S,B2GG/S,MPC/ S,SPC/S,LOAD/S,DEFORM/S,TEMPLD/S,P2G/S,DYRD/S,METH/ S,MFLUID $ ADAPT CASE0,EPTS,EDT,EST,ELEMVOL,VIEWTB,UG,MPTS,ETT,CSTMS, PVALN,ERRORN,PELSETS,DEQATN,DEQIND,DIT,OINT,GEOM4S, BGPDTS,GPSNTS/ PVAL1,ERROR1/ ALTSHAPE/APP/ADPTINDX/SEID/S,N,PVALNEW/S,N,FINISH/ DESITER/DESMAX/CNVFLG $ EQUIVX PVAL1/PVALN/ALWAYS $ ..."ACCUMULATE" UPDATED PVALS EQUIVX ERROR1/ERRORN/ALWAYS $ AND ERRORS ACROSS ALL S.E.‘S DELETE /UG,,,, $ IF ( ADPTEXIT ) ADPTEXIT = FINISH $ ENDDO $ LPFLG >= 0 9.3 ADD β [B] where α and β are scalar multipliers ( can be the +, *, ÷ or Matrix add Computes [X] = α[A] overwrite operators). Format: ADD A,B/X/ALPHA/BETA/IOPT $ Input Data Blocks: A B Any matrix (real or complex). Any matrix (real or complex). 9-6 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: X Matrix. Parameters: ALPHA BETA IOPT Input-complex single precision-default = (1.0,0.0). This is α, the scalar multiplier for [A]. Input-complex single precision-default = (1.0,0.0). This is β, the scalar multiplier for [B ]. Input-integer-default = 0. This chooses the operator Operation + , add in xjj = αAjj βBij IOPT 0 1 2 3 Remarks: 1. [A] and/or [B ] can be purged, in which case the corresponding term in the matrix sum is assumed to be null. The input data blocks must be unique. 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, the size of X is the size of A. For example: Equation 9-1. or NX Nastran DMAP Programmer’s Guide 9-7 Chapter 9 Descriptions of DMAP Modules and Statements Equation 9-2. 4. If ALPHA or BETA are specified as constants and their imaginary part is zero; for example, “(5.,0.)”, they can alternately be specified as real constants; for example, “5.” See examples. 5. For exponentiation of each element in a matrix see the “DIAGONAL” 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 the following terms. ADD A,B/X///3 $ 9.4 ADD5 Matrix add To compute [X ] = α[A] + β[B ] + λ[C] + Δ[D ] + [E ], where α, β, λ, Δ, and are scalar multipliers. Format: ADD5 A,B,C,D,E/ X/ ALPHA/BETA/GAMMA/DELTA/EPSLN/ ALPHAD/BETAD/GAMMAD/DELTAD/EPSLND $ Input Data Blocks: A,B,C,D,E Must be distinct matrices (real or complex) Output Data Block: X Matrix 9-8 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: ALPHA BETA GAMMA DELTA EPSLN ALPHAD BETAD GAMMAD DELTAD EPSLND Input-complex single precision-default = (1.0,0.0). This is α, the scalar multiplier for [A]. Input-complex single precision-default = (1.0,0.0). This is β, the scalar multiplier for [B ]. Input-complex single precision-default = (1.0,0.0). This is λ, the scalar multiplier for [D]. Input-complex single precision-default = (1.0,0.0). This is Δ, the scalar multiplier for [D]. Input-complex single precision-default = (1.0,0.0). This is , the scalar multiplier for [E]. Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar multiplier for [A]. Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar multiplier for [B]. Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar multiplier for [C]. Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar multiplier for [C]. Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar multiplier for [E]. Remarks: 1. Any of the matrices can be purged, in which case the corresponding term in the matrix sum is assumed to be 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, X is 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, 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; for example, “(5.,0.)”, they can be alternately specified as real constants; for example, “5.” See Example 2 below. 5. If any of the scalar single precision multipliers are specified as constants and their imaginary part is zero; for example, (5.,0.), they can be alternately specified as real constants; for example, 5. See Example 2. This alternate specification is not allowed for the double precision multipliers. Constant double precision values must be entered in full: for example, (2.0D0, 0.0D0). NX Nastran DMAP Programmer’s Guide 9-9 Chapter 9 Descriptions of DMAP Modules and Statements 6. If ALPHAD, BETAD, GAMMAD, DELTAD, or EPSLND is non-zero, the corresponding single precision parameter is 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. 9.5 ADDVM Add a vector to each column of a matrix. Format: ADDVM VEC,MAT/MATO/NCOL $ Input Data Blocks: VEC MATI Matrix containing the vector Input matrix Output Data Blocks: MATO Output matrix Parameters: NCOL Input-integer. Column of VEC to be used. 9-10 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.6 ADG 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 $ Input Data Blocks: AECTRL CSTMA AERO AECOMP W2GJ ACPT Table of aeroelastic model controls Table of aerodynamic coordinate system transformation matrices for g-set and ks-set grid points Table of control information for aerodynamic analysis Aerodynamic component definition table Matrix of aerodynamic intercepts that is usually input via DMI Bulk Data entries Aerodynamic connection and property table Output Data Blocks: UXVBRL WJVBRL Controller state matrix for WJVBRL downwash vectors. UXVBRL has NX rows and NV columns. 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. Table of the aerodynamic database contents (one entry for each of the NV instances created) ADBINDX Parameters: NJ NK SYMXZ Input-integer-no default. Number of aerodynamic boxes (j-points). Input-integer-no default. Number of aerodynamic degrees of freedom (k-points). Input-integer-no default. x-z symmetry flag. NX Nastran DMAP Programmer’s Guide 9-11 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: 1. NK, and NJ are computed by the APD module. 2. If ACPT is not purged, the DJX matrix is built using ACPT and AECOMP. Example: PARAML CASECC//‘DTI‘/-1/224//S,N,TRMFLG $ DBVIEW AEUSET=USET0 WHERE (MODLTYPE=‘AEROSTRC’AND WILDCARD) $ DBVIEW AEBGPDT=BGPDTS WHERE (MODLTYPE=‘AEROSTRC’AND WILDCARD) $ IF( TRMFLG=-1 ) ADG EDT,CSTMA,AEBGPDT,AERO,AEUSET,AECOMP,ACPT,W2GJ/ DJX,TRX,AECTRL,SRKT,HMKT/ AUNITS/NJ/NK/S,N,NX/CIDAP/SYMXZ/SYMXY $ 9.7 ADR 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 $ Input Data Blocks: UH CASECC QKHL OL AEBGPDT AEUSET Complex modal displacements matrix - h-set Case Control table Aero transformation matrix between h and k sets Complex eigenvalue summary table for flutter analysis or frequency response output list for aeroelastic analysis Basic grid point definition table with the aerodynamic degrees of freedom added (ks-set in AEUSET) Aerodynamic USET table Output Data Block: PKF Matrix of k-set forces per frequency Parameters: BOV MACH Input-real-no default. Conversion from frequency to reduced frequency. Input-real-default=0.0. Mach number. 9-12 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements APP Input-character-no default. Analysis type. ‘FREQRESP’– aeroelastic ‘FLUTTER’ – flutter AECONFIG SYMXY SYMXZ Input-character-no default. Aerodynamic configuration. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-integer-no default. Aerodynamic x-z symmetry flag. Remarks: 1. None of the input data blocks can be purged if an AEROF Case Control command is specified. 2. PKF cannot be purged. Examples: 1. ADR in flutter analysis: DBVIEW AEUSET=USET ( WHERE MODLTYPE=‘AEROSTRC’AND WILDCARD)$ DBVIEW AEBGPDT=BGPDTS ( WHERE MODLTYPE=‘AEROSTRC’AND WILDCARD)$ ADR FPHH,CASEYY,QKHL,FLAMA,AEBGPDT,AEUSET/ PKF/ BOV/MACH/‘FLUTTER’$ 2. ADR in aeroelastic analysis: DBVIEW AEUSET=USET ( WHERE MODLTYPE=‘AEROSTRC’AND WILDCARD)$ DBVIEW AEBGPDT=BGPDTS ( WHERE MODLTYPE=‘AEROSTRC’AND WILDCARD)$ ADR AUHF,CASES,QKHL,FOL,AEBGPDT,AEUSET/ PKF/ BOV/MACH/‘FREQRESP’$ 9.8 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/ CASEA/ 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 $ Input Data Blocks: CASECC Case Control table. NX Nastran DMAP Programmer’s Guide 9-13 Chapter 9 Descriptions of DMAP Modules and Statements EDT Element Deformation Table. Contains all of the entries for related to aerostatic and aeroelastic analysis. Output Data Blocks: CASEA A single record (subcase) of CASECC Parameters: NSKIP LPFLG MFLG Input/output-integer-default=0. Trim subcase counter. 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. Input/output-integer-default=0. Flag to indicate whether there is another Mach number to process in the current subcase. Set to 0 for the last Mach number in the subcase Output-real-no default. Mach number. Output-real-no default. Dynamic pressure. Output-real-no default. Aeroelastic feedback dynamic pressure ratio. Output-character-no default. Aerodynamic configuration. Output-integer-no default. Aerodynamic x-y symmetry flag. Output-integer-no default. Aerodynamic x-z symmetry flag. MACH Q AEQRATIO AECONFIG SYMXY SYMXZ 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 TRIM or a DIVERG Case Control command. 1. If it is TRIM, 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, MFLG is checked for any remaining MACH numbers in the subcase. If any are found, 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, LPFLG is set to -1. Examples: 1. Set up for aerostatic analysis. DO WHILE ( LPFLG>=0 ) $ AELOOP CASECC,EDT/ 9-14 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CASEA/ S,N,NSKIP/S,N,LPFLG/MFLG/S,N,MACH/S,N,Q $ NSKIP = NSKIP + 1 $ ENDDO $ LPFLG>=0 2. Set up for divergence analysis. DO WHILE ( LPFLG>=0 ) $ Loop on number of subcases MFLG = 1 $ DO WHILE ( MFLG>0 ) $ Loop on Mach number AELOOP CASECC,EDT/ CASEA/ S,N,NSKIP/S,N,LPFLG/S,N,MFLG/S,N,MACH/S,N,Q $ ENDDO $ MFLG>0 ENDDO $ LPFLG>=0 9.9 AEMODEL Aerodynamic model loop driver Drives the aerodynamic model loop and sets parameter values for the generation of aerodynamic tables. Format: AEMODEL CASECC,EDT// S,N,NSKIP/S,N,LPFLG/S,N,AECONFIG/S,N,SYMXY/S,N,SY Input Data Blocks: CASECC EDT Table of Case Control command images. 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 Data Blocks: None. Parameters: NSKIP LPFLG AECONFIG SYMXZ SYMXY Input/output-integer-default=0. Trim subcase counter. Input/output-integer-default=0. Flag to indicate whether there is another case control record to process. Set to -1 for the last aerodynamic subcase. Output-character-no default. Aerodynamic configuration. Output-integer-no default. Aerodynamic z-y symmetry flag. Output-integer-no default. Aerodynamic x-y symmetry flag. NX Nastran DMAP Programmer’s Guide 9-15 Chapter 9 Descriptions of DMAP Modules and Statements 9.10 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 $ Input Data Blocks: MKLIST ACPT Aerodynamic matrix generation table Aerodynamic connection and property table Output Data Blocks: AJJT SKJ D1JK D2JK Aerodynamic influence matrix Integration matrix list Real part of downwash matrix Imaginary part of downwash matrix Parameters: NK NJ SYMXZ SYMXY REFC MACH0 MACHNO KBAR Input-integer-no default. Number of degrees of freedom in k-set. Input-integer-no default. Number of degrees of freedom in j-set. Input-integer-no default. Aerodynamic z-y symmetry flag. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-real-no default. Input/output-real-default=-1.0. Previously processed Mach number. Input-real-default=0.0. Mach number. Input-real-default = 0.0. Reduced frequency. 9-16 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements APP Input-character-default=’ ’ Analysis type. ‘FREQRESP’- aeroelastic ‘FLUTTER’- flutter SUPAERO Input-character-default=‘ZONA’ Method selection for supersonic aerodynamics. An alternate method is ‘CPM’ Remarks: 1. Neither AERO nor ACPT can be purged. 2. D2JK is not used in aerostatic analysis. Examples: 1. Set up AMG for aerostatic analysis. AMG AERO,ACPT/ AJJT,SKJ,D1JK,D2JX/ NK/NJ/S,N,MACH0/MACH/0.0/‘STATICS’$ 2. Set up AMG for aeroelastic or flutter analysis. AMG AERO,ACPT/ AJJT,SKJ1,D1JK,D2JK/ NK/NJ/S,N,MACH0/MACH/KBAR $ 9.11 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 $ Input Data Blocks: AJJT WSKJF D1JK D2JK GDKI GPIK Aerodynamic influence matrix Weighted integration matrix Real part of downwash matrix Imaginary part of downwash matrix Aerodynamic transformation matrix for displacements from the k-set to h-set Aerodynamic transformation matrix for loads from the h-set to k-set NX Nastran DMAP Programmer’s Guide 9-17 Chapter 9 Descriptions of DMAP Modules and Statements GPKH D1JE D2JE MKLIST LAJJT UAJJT Aerodynamic transformation matrix for loads from the k-set to h-set Imaginary part of downwash matrix due to extra points Imaginary part of downwash matrix due to extra points Table of Mach number and reduced frequency pairs Lower triangular decomposition factor matrix of AJJT Upper triangular decomposition factor matrix of AJJT Output Data Blocks: QHH QKH QHJ Aerodynamic matrix of size h- by h-set Aerodynamic matrix of size k- by h-set Aerodynamic matrix of size h- by j-set Parameters: NUMHDOF NOUE GUSTAERO MACH KBAR Input-integer-no default. The number of modes. Input-integer-no default. The number of extra points. Input-integer-default=0. QHJ computed only if GUSTAERO<0. Input-real-default=0.0. Mach number. Input-real-default=0.0. Reduced frequency. Remarks: 1. None of the input data blocks can 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, can be supplied by the user via INPUTT4. These extra points are used for control systems and other special effects. 4. If NOUE<0, D1JE and D2JE can be purged. 9-18 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 5. QKH, relating aerodynamic pressures to modal coordinates, is required for use in a data reduction module. The matrix of generalized forces, QHH, can be purged if only data reduction is desired. 9.12 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 $ Input Data Blocks: EDT CSTM Table of Bulk Data entry images related to aerodynamics. Table of coordinate system transformation matrices. Output Data Blocks: AEECT* Two aerodynamic element connection tables (ECT) based on MODLTYPE qualifier: MODLTYPE=‘AEROMESH’and MODLTYPE=‘AEROSTRC’ See Example. Two aerodynamic basic grid point definition tables (BGPDT) with the degrees of freedom added and based on MODLTYPE qualifier: MODLTYPE=‘AEROMESH’and MODLTYPE=‘AEROSTRC’ See Example. Aerodynamic USET table defining ks-set based on MODLTYPE qualifier: MODLTYPE=‘AEROSTRC’ See Example. Aerodynamic component definition table Control information for control of aerodynamic matrix generation and flutter analysis Aerodynamic connection and property table Aerodynamic coordinate system transformation matrices for g-set and ks-set grid points Table of aerodynamic splines for display. Mapping matrix to map j-set data from neworder to old order AEBGPDT* AEUSET* AECOMP AERO ACPT CSTMA AMSPLINE MPJN2O NX Nastran DMAP Programmer’s Guide 9-19 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: NK NJ BOV AERTYP Output-integer-no default. Number of degrees of freedom in the k displacement set. Output-integer-no default. Number of degrees of freedom in the j displacement set. Output-integer-default=0.0. Value calculated by REFC/(2.*VELOCITY). Input-character-default=‘DYNAMICS’ Analysis type: ‘STATICS’– aerostatic ‘DYNAMICS’– flutter and aeroelastic ‘STADYN’– all aerodynamic analysis types BOXIDF Output-integer-default. Box corner point identification flag. 0 -1 Points have unique identification numbers starting with the aerodynamic component identification number. Points identification numbers are incremented by 1, to avoid an overlap if they were started with the aerodynamic component identification numbers. No display of the corner points is possible. 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. MODLTYPE STRUCTUR AEROSTRC AEROMESH Model structural aero-structural plotting DOF set p-set ks-set n/a 2. BGPDT, ECT, and USET0 where MODLTYPE=‘STRUCTUR’are output by GP1, GP2, and GP4, respectively. Example: The first statement sets the MODLTYPE qualifier for data blocks BGPDTS and USET. The subsequent DBVIEW statements reference the outputs from APD for use in other modules. MODLTYPE=‘AEROSTRC’$ APD EDT,xCSTM/ ECTS,BGPDTS,USET0,AECOMP,AERO,ACPT,CSTMA/ S,N,NK/S,N,NJ/S,N,BOV/AERTYP/S,N,CIDAP $ DBVIEW AEBOX=ECTS WHERE (MODLTYPE=‘AEROMESH‘) $ DBVIEW AEGRID=BGPDTS WHERE (MODLTYPE=‘AEROMESH‘) $ 9-20 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DBVIEW AEUSET=USET0 WHERE (MODLTYPE=‘AEROSTRC‘) $ DBVIEW AEBGPDT=BGPDTS WHERE (MODLTYPE=‘AEROSTRC‘) $ 9.13 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 performs the following types of unions: Equation 9-3. Equation 9-4. Format: APPEND IN1,IN2/OUT/IOPT/NULL1/NULL2/ REAL/REALD/CMPX/CMPXD/CHAR $ Input Data Blocks: IN1,IN2 A pair of data blocks contributing to OUT (matrices or tables) Output Data Block: OUT Output data block corresponding to first pair of input data blocks Parameters: IOPT Input-integer-default = 1. IOPT selects the method of appending. NX Nastran DMAP Programmer’s Guide 9-21 Chapter 9 Descriptions of DMAP Modules and Statements 1 append columns (or records) of IN2 to IN1 as shown in Eq. 9–3. 2 append columns (or records) of IN1 to OUT as shown in Eq. 9–4. IN2 is ignored. 10 write NULL2 in the next record of OUT 11 write REAL in the next record of OUT 12 write REALD in the next record of OUT 13 write CMPX in the next record of OUT 14 write CMPXD in the next record of OUT 15 write CHAR in the next record of OUT 16 write NULL2 followed by REAL in the next record of OUT 17 write NULL2 followed by REALD in the next record of OUT 18 write NULL2 followed by CMPX in the next record of OUT 19 write NULL2 followed by CMPXD in the next record of OUT 20 write NULL2 followed by CHAR in the next record of OUT NULL1 Input-integer-default = 0. The number of null columns or records assumed for IN1 if IN1 is purged. In other words, IN2 is appended to a data block with NULL1 number of records or columns. Used only if IOPT = 1. Input-integer-default = 0. The number of null columns or records to append onto IN1 if IN2 is purged. Used only if lOPT = 1. Input-real-default=0.0. Real value in the next record. Input-complex-default=0.D0. Complex value in the next record. Input-complex-default=(0.0,0.0). Complex value in the next record. Input-complex double precision-default=(0.D0,0.D0). Complex double precision value in the next record. Input-character-default=‘XXXXXXXX’ Character value in the next record. NULL2 REAL REALD CMPX CMPXD CHAR Remarks: 1. Under IOPT = 2, the output matrix data block is actually used as an input and must be declared APPEND in a FILE DMAP statement. 2. Both inputs must be of the same type matrix. 3. Either IN1 or IN2 can 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. 9-22 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 5. In table appends, the header record is skipped on the appended file and all remaining records. Also, the trailer of OUT is set to that of IN2 (IOPT = 1) or IN1 (IOPT = 2). 6. UGS recommends that the OUT data block be a scratch data block. In other words, it should not be saved on a permanent DBset. 7. For values of IOPT -16, -17, -18, -19, or -2 the order of the parameters written is reversed. For example, IOPT=-20 causes CHAR to be written first, then NULL2. 8. If NULL1>0, a type indicator 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>9, trailer word 1 contains a count of the number of data records on the file and word 2 contains the value of the NULL1 parameter. Examples: 1. Generate a matrix [U] whose five columns are a vector {US} 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 $ 9.14 ASDR Prints the aerodynamic extra point displacements and the aerodynamic pressures and forces as requested in Case Control. NX Nastran DMAP Programmer’s Guide 9-23 Chapter 9 Descriptions of DMAP Modules and Statements Format: ASDR CASEA,UXDAT,AECTRL,FFAJ,ACPT,PAK,AEUSET,AEBGPDT, AECOMP,MONITOR,MPSR,MPSER,MPSIR,MPSRPS,MPSERPS, AEMONPT,MPAR,MPAER,AERO,CSTMA// MACH/Q/AECONFIG/SYMXY/SYMXZ/IUNITSOL $ Input Data Blocks: CASEA UXDAT AECTRL FFAJ ACPT PAK AEUSET AEBGPDT AECOMP MONITOR MPSR MPSER MPSIR MPSRP MPSERP AEMONPT MPAR MPAER AERO CSTMA A single record (subcase) of CASECC for aerodynamic analysis Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments Table of aeroelastic model controls Matrix of pressures at aerodynamic boxes Aerodynamic connection and property table Matrix of aerodynamic forces at aerodynamic boxes Aerodynamic USET table Basic grid point definition table with the aerodynamic degrees of freedom added (ksa-set in AEUSET) Aerodynamic component definition table Structural monitor point table Rigid aerodynamic loads on structural monitor points at trim (excluding inertial loads and static applied loads) Elastic restrained loads on structural monitor points at trim (excluding inertial loads and static applied loads) Inertial loads on structural monitor points at trim Rigid loads on structural monitor points due to static applied loads Elastic restrained loads on structural monitor points due to static applied loads Aerodynamic monitor point table Rigid aerodynamic loads on aerodynamic monitor points at trim Elastic restrained loads on aerodynamic monitor points at trim Table of control information for aerodynamic analysis. Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points 9-24 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: None. Parameters: MACH Q AECONFIG SYMXY SYMXZ IUNITSOL Input-real-no default. Mach number. Input-real-no default. Dynamic pressure. Input-character-no default. Aerodynamic configuration. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-integer-no default. Aerodynamic x-z symmetry flag. Input-integer-default=0. If IUNITSOL=0, trim solution is being supplied. If IUNITSOL>0, IUNITSOL‘th unit solution is being supplied. 9.15 ASG Computes the aerodynamic extra point displacements Format: ASG CASEA,AEMONPT,MONITOR,MPAERV,MPSERV,MPSIR,AEDBUXV, MPSERP,AECTRL,EDT,PRBDOFS,DIT,AEDBINDX/ UX,UXDAT,UXDIFV/SYMXZ/ISENS $ Input Data Blocks: CASEA AEMONPT MONITOR MPAERV MPSERV MPSIR AEDBUXV MPSERP AECTRL EDT A single record (subcase) of CASECC for aerodynamic analysis Aerodynamic monitor point table Structural monitor point table Elastic restrained monitor point loads on aerodynamic model Elastic restrained monitor point loads on structural model Inertial loads on structural monitor points at trim Matrix of vehicle states Elastic restrained loads on structural monitor points due to static applied loads Table of aerodynamic model‘s control definition Table of Bulk Data entry images related to aerodynamics NX Nastran DMAP Programmer’s Guide 9-25 Chapter 9 Descriptions of DMAP Modules and Statements 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. Table of TABLEij Bulk Data entry images Aeroelastic database index for monitor point data DIT AEDBINDX Output Data Blocks: UX UXDAT UXDIFV Matrix of aerodynamic extra point displacements Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments Derivative interpolation factors matrix at UX = UXREF Parameter: SYMXZ ISENS Input-integer-no default. Aerodynamic x-z symmetry flag. Input-integer-default=0. Set to 1 if a sensitivity analysis is to be performed. Remarks: 1. TR, KRZX, DIT, ERHM, and UXDAT can be purged if ISENS=1. 2. ASG solves the following equation for UX: Equation 9-5. 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. The sum of the number of supported degrees of freedom plus the number of TRIM constraints and number of AELINK constraints must equal the number of aerodynamic extra points. 9-26 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.16 AXMDRV Loop driver for auxiliary model processing Format: AXMDRV AMLIST//S,N,AUXMID/S,N,AUXMFL $ Input Data Blocks: AMLIST List of auxiliary model identification numbers Output Data Blocks: None. Parameters: AUXMID AUXMFL Output-integer-default=0. Auxiliary model identification number. Output-logical-default=TRUE. Auxiliary model loop control flag. Set to FALSE when processing the last auxiliary model. 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, that is, 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 $ 9.17 AXMPR1 Builds a list of auxiliary model Bulk Data sections Format: AXMPR1 CASECC*,BULK*/ AMLIST/ S,N,AMLFLG $ NX Nastran DMAP Programmer’s Guide 9-27 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: CASECC* BULK* Family of auxiliary model Case Control sections Family of auxiliary model Bulk Data sections Output Data Blocks: AMLIST List of auxiliary model identification numbers Parameters: AMLFLG Output-logical-default=FALSE. Set to TRUE if AMLIST if generated. 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 that 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 $ 9.18 AXMPR2 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 $ Input Data Blocks: GEOM1 Table of Bulk Data entry images related to geometry and assigned to the primary model 9-28 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GEOM1A Table of Bulk Data entry images related to geometry and assigned to the auxiliary model identified by AUXMID Output Data Blocks: GEOM1C CASEVEC Table of Bulk Data entry images related to geometry and merged from GEOM1 and GEOM1A Case Control table with the PARTN command referencing all of auxiliary model‘s grid identification numbers Parameter: AUXMID Auxiliary Model Identification Number Remarks: 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. 9.19 BCDR 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,BCSET/S,N,BGSET/S,N,BOLTPRE/ S,N,RIGID/S,N,LOAD/S,N,LSEQ/S,N,STATSUB/ S,N,BC/ BCLABL $ Input Data Block: CASECC Table of Case Control command images. Output by IFP1. Output Data Block: None. Parameters: SEID Input-integer-no default. Superelement identification number. NX Nastran DMAP Programmer’s Guide 9-29 Chapter 9 Descriptions of DMAP Modules and Statements SOLAPP NSKIP NLOADS Input-character-no default. Design optimization analysis type. Currently not used. Input/output-integer-no default. The record number in CASECC corresponding to the first subcase of the current boundary condition. Output-integer-default=0. The number of subcase records contiguous with respect to the MPC and SPC command in the first subcase of the current boundary condition. Output-logical-no default. Set to FALSE at the last boundary condition. Output-integer-default=0. SPC Case Control command set identification number specified in the third word of the SKIP-th record of CASECC Output-integer-default=0. MPC Case Control command set identification number specified in the second word of the NSKIP-th record of CASECC. Output-integer-default=0. SUPORT Case Control command set identification number specified in the 255-th word of the NSKIP-th record of CASECC. Output-integer-default=0. Contact set identification number. Output-integer-default=0. Glue set identification number. Output-integer-default=0. Bolt preload identification number. Output-character-default=linear. Selects the rigid element processing method for RBAR, RBE1, RBE2, RROD and RTRPLT elements. Output-integer-default=0. LOAD Case Control command set identification number specified in the fourth word of the NSKIP-th record of CASECC. Output-integer-default=0. LOADSET Case Control command set identification number specified in the 205-th word of the NSKIP-th record of CASECC. Output-integer-default=0. STATSUB Case Control command set identification number specified in the 256-th word of the NSKIP-th record of CASECC. Output-integer-default=0. BC Case Control command set identification number specified in the 257-th word of the NSKIP-th record of CASECC. Input-integer-default=0. f06 file page header control. -1 Clear page header 0 1 Initialize page header without page eject Initialize page header with page eject. BCFLAG SPC MPC SUPORT BCSET BGSET BOLTPRE RIGID LOAD LSEQ STATSUB BC BCLBL Example: Excerpt from subDMAP PHASE0: 9-30 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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,BCSET/S,N,BGSET/S,N,BOLTPRE/ S,N,RIGID/S,N,LOAD/S,N,LSEQ//S,N,BC $ . . . ENDDO $ 9.20 BDRYINFO 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/ GEOM1EX,GEOM2EX,GEOM4EX $ Input Data Blocks: CASECC GEOM1 GEOM2 BGPDT USET Table of Case Control command images Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Basic grid point definition table Degree-of-freedom set membership table for g-set Output Data Block: GEOM1EX GEOM1 table containing records which define an external superelement. Specifically, it contains CORD1j, CORD2j, EXTRN, and GRID Bulk Data records. GEOM2 table containing records which define an external superelement. Specifically, it contains PLOTEL and SPOINT Bulk Data records. GEOM4 table containing records which define an external superelement. Specifically, it contains ASETi and QSETi Bulk Data records. GEOM2EX GEOM4EX Parameters: None. NX Nastran DMAP Programmer’s Guide 9-31 Chapter 9 Descriptions of DMAP Modules and Statements 9.21 BGCASO Updates Case Control table for contact region data recovery operations. Format BGCASO CONTACT,BTOPO,CASECC,XYCDB/ CASECCBO/ S,N,NEWCASE/S,N,NBSORT2 $ Input Data Blocks: CONTACT CASECC BTOPO XYCDB Table of Bulk Data entries related to contact regions Table of Case Control command images Contact regions topological information table Table of x-y plotting command Output Data Block: CASECCBO Updated CASECC for contact region data recovery operations Parameters: NEWCASE NBSORT2 Output-integer-no default. CASECCBO output flag. Set to 1 if CASSECBO is generated. Output-integer-default=0. Contact region output sort format flag. 1 if SORT2 format is requested for printing 2 if x-y plotting is requested 9.22 BGP 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 $ 9-32 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: CSTM SIL KGGT Table of coordinate system transformation matrices Scalar index list Total structural stiffness matrix in g-size (sum of linear, nonlinear and differential matrices) Output Data Block: BTOPO BGPECT Contact regions topological information table Boundary grid point element connection table Parameters: ADPCON ISKIP Input-real-default=1.0. Scale factor for adjusting penalty values on restart. Update penalty values if positive. Input-integer-default=0. Counter to update penalty values; updates on first pass and no update later. Remarks: 1. CSTM can be purged. 2. BTOPO is both input and output. See example. Example: Excerpt of BGP for a nonlinear loop in SOL 106: FILE BGP COPY BTOPSTF=APPEND/BTOPCNV=APPEND $ CSTMS,SILS,KGGT/BTOPSTF,BGPECT/ADPCONx/ISKIP $ BTOPSTF/BTOPCNV/-1/1 $ 9.23 BMG Generates boundary matrices (in DMIG format) for hydroelastic analysis. Format: BMG MATPOOL,BGPDT,CSTM/ BDPOOL/ S,N,NOKBFL/S,N,NOABFL/S,N,MFACT $ Input Data Blocks: MATPOOL Table of Bulk Data entry images related to hydroelastic boundary data NX Nastran DMAP Programmer’s Guide 9-33 Chapter 9 Descriptions of DMAP Modules and Statements BGPDT CSTM Basic grid point definition table Table of coordinate system transformation matrices Output Data Block: BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format Parameters: NOKBFL NOABFL MFACT Output-integer-no default. Matrix KBFL existence flag; 0 if KBFL exists and -1 otherwise. Output-integer-no default. Matrix ABFL existence flag; 0 if ABFL exists and -1 otherwise. Output-complex-no default. Scale factor for hydroelastic boundary mass matrix. Remarks: MTRXIN must always be used in conjunction with module BMG to produce the matrices. See example. Example: Generate hydroelastic boundary matrices. BMG MATPOOL,BGPDTS,CSTMS/ BDPOOL/ S,N,NOKBFL/S,N,NOABFL/S,N,MFACT $ ABFL = NOTL(NOABFL) $ IF ( ABFL OR NOTL(NOKBFL) ) MTRXIN ,,BDPOOL,EQDYN,,/ ABFL,KBFL,/ LUSETD/NOABFL/NOKBFL/0 $ 9.24 BNDSPC Processes constraints and enforced displacements applied on superelement boundaries. Format: BNDSPC SEMAP,USET,BGPDT,YS,YSD/ USET1,YS1/ SEID/NLOADS $ Input Data Blocks: SEMAP Superelement map table 9-34 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements USET BGPDT YS YSD Degree-of-freedom set membership table Basic grid point definition table for the current superelement Matrix of enforced displacements Accumulated matrix of enforced displacements from upstream superelements Output Data Blocks: USET1 YS1 USET updated with constraints from upstream superelements YS updated with enforced displacements from upstream superelements Parameters: SEID NLOADS Integer-input-default=0. Superelement identification number. Integer-input-default=0. The number of subcase records contiguous with respect to the MPC and SPC command in the first subcase of the current boundary condition. Remarks: 1. BNDSPC performs 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. Example: Excerpt from subDMAP PHASE0 with BNDSPC in a superelement and boundary condition loop: DO WHILE (LPFLG >= 0) $ . . . BCFLAG=TRUE $ DO WHILE ( BCFLAG ) $ . . . BNDSPC EMAP,USET0,BGPDTS,YSB,YSD/ USET01,YSB1/ SEID/NLOADS $ EQUIVX USET01/USET0/-1 $ EQUIVX YSB1/YSB/-1 $ . . . NX Nastran DMAP Programmer’s Guide 9-35 Chapter 9 Descriptions of DMAP Modules and Statements ENDDO $ BCFLAG ENDDO $ LPFLG 9.25 BOLTFOR Calculates bolt forces from preload Format: BOLTFOR CASECC,BGPDT,CSTM,GEOM3,ECT,EDT,SIL/ BTFG,EBOLT/NSKIP/S,N,LUSET/S,N,NBOLTS $ Input Data Blocks: CASECC BGPDT CSTM GEOM3 ECT EDT SIL Table of case control command images. Basic grid point definition table. Table of coordinate system transformation matrices. Table of Bulk Data entry images related to static and thermal loads. Element connectivity table. Element data table. Scalar index list. Output Data Blocks: BTFG EBOLT Bolt load vector applied to the g-set. Table of element ids of bolt elements. Parameters: NSKIP LUSET NBOLTS Input-integer-no default. Record number in CASECC corresponding to the first subcase of the current boundary condition. Integer-input-no default. Number of degrees of freedom in the g-set. Output-integer-no default. Number of bolts defined to be preloaded. 9.26 BOLTSF Calculates bolt strain force 9-36 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: BOLTSF CASECC,BGPDT,CSTM,GEOM3,ECT,EPT,MPT,EDT,SILUG/ BTSFG/NSKIP $ Input Data Blocks: CASECC BGPDT CSTM GEOM3 ECT EPT MPT EDT SIL UG Table of case control command images. Basic grid point definition table. Table of coordinate system transformation matrices. Table of Bulk Data entry images related to static and thermal loads. Element connectivity table. Element property table Material property table Element data table. Scalar index list. Displacements due to bolt preload forces in the g-set Output Data Blocks: BTSFG Bolt force vector due to initial strain applied to the g-set Parameters: NSKIP Input-integer-no default. Record number in CASECC corresponding to the first subcase of the current boundary condition. 9.27 CASE Dynamic analysis case control loop driver Assembles the appropriate subcases (records) of Case Control for the current loop based on various Case Control commands. NX Nastran DMAP Programmer’s Guide 9-37 Chapter 9 Descriptions of DMAP Modules and Statements Format: CASE Input Data Blocks: CASECC PSDL MPT Table of Case Control command images. Power spectral density list. Required only when APP=‘FREQ’ Table of Bulk Data entry images for TSTEPNL, NLPARM, and NLPCI. Required only when APP=‘NONL’ Output Data Block: CASEXX Subset of CASECC for current loop Parameters: APP Input-character-no default. Analysis type. ‘CEIG’ ‘FREQ’ ‘TRAN’ ‘NONL’ ‘SLIC’ ‘COMM’ Complex eigenvalue Frequency response Transient response Nonlinear static or transient Slice a contiguous subset of CASECC records into CASEXX; that is, NOLOOP number of records starting with the NSKIP-th record. Extract a slice of contiguous subset records, beginning at the NSKIP-th record, with the same Case Control command set identification numbers for command names specified in CASCOMi. NSKIP Input/output-integer-default=1. CASECC record counter or nonlinear transient loop identification number Input: ≤0 Skip one record on CASECC 9-38 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements >0 Output: -1 >0 >0 NOLOOP Number of records to skip on CASECC to reach the current subset of CASECC No more cases and APP<>‘NONL’: Indicates the number of records to skip on CASECC to reach the next subset of CASECC. and APP=‘NONL’: Indicates that there are more CASECC records to process and NSKIP must be incremented in the DMAP. Output-integer-default=-1. Looping test flag -1 1 No DMAP looping is required. DMAP looping is required. LINC GMAFLG Output-integer-default=0. Number of load increments for this subcase. Used in nonlinear static analysis only (APP=‘NONL’and IMETHOD=0). 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 1 Do not ignore changes (default). Ignore changes. MSCHG Output-integer-default=0. Boundary condition change flag. Used in nonlinear static analysis only (APP=‘NONL’and IMETHOD=0). -1 1 If MPC and SPC Case Control commands for this subcase are the same as those in the immediately preceding subcase. If MPC or SPC commands are different. TESTNEG Output-integer-default=-2. Load increment method flag. Used in nonlinear static analysis only (APP=‘NONL’and IMETHOD=0). -2 1 Standard Controlled increment IMETHOD Input/output-integer-default=0. Nonlinear transient analysis flag. Input: 0 <>0 Nonlinear static analysis (default) Nonlinear transient analysis Output (nonlinear transient only): NX Nastran DMAP Programmer’s Guide 9-39 Chapter 9 Descriptions of DMAP Modules and Statements -1 2 CASCOMi Auto or TSTEP method (NLTRD module) ADAPT method (NLTRD2 module) Input-character-default=’ ’ Case Control command names. See APP=‘COMM’ 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, 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. APP=‘FREQ’: Frequency response CASE CASECC,PSDL/ CASEXX/ APP/S,N,NSKIP/S,N,NOLOOP//GMAFLG $ Processing is the same as complex eigenvalue analysis, except that the set identification numbers specified for the FREQUENCY Case Control command is also compared. If the RANDOM command is specified, the selected set is read from PSDL and a list of subcase identification numbers referenced by the RANDPS Bulk Data entry images is made. If some subcases referenced by RANDPS Bulk Data entry images have not been output on CASEXX, CASE terminates with User Fatal Message 3033. APP=‘TRAN’: Linear transient response CASE CASECC,/ CASEXX/ APP/S,N,NSKIP/S,N,NOLOOP $ The first NSKIP records (subcases) on CASECC are skipped. The next record is read and copied onto CASEXX and an attempt is made to read the next record of CASECC. If this is not possible, NSKIP is set to -1 and, if this is the first entry into CASE, NOLOOP is set to -1. APP=‘NONL’and IMETHOD=0: Nonlinear static analysis CASE CASECC,MPT/ CASEXX/ APP/S,N,NSKIP//S,N,LINC//S,N,MSCHG/S,N,TESTNEG $ The first NSKIP records on CASECC are skipped. The next record is read and copied onto CASEXX. MSCHG is set to indicate whether the MPC or SPC set identification numbers have changed since the previous subcase. NINC is set equal to the value in the NINC field on the selected NLPARM Bulk Data entry image. If there is an associated NLPCI Bulk Data entry image, the controlled increment method is being used, and the TESTNEG parameter is set to indicate this. TEMPERATURE(INITIAL) and TEMPERATURE(LOAD) commands are checked for proper specification. 9-40 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements APP=‘NONL’and IMETHOD<>0: Nonlinear transient response CASE CASECC,MPT/ CASEXX/ APP/S,N,NSKIP//////S,N,IMETHOD $ IMETHOD is set according to the METHOD field of the selected TSTEPNL Bulk Data entry image in MPT. NSKIP is set to the loop identification number. 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. CASE CASECC,/CASE10/‘SLIC‘/10/3 $ 3. Extract Case Control records with the same MPC, SPC, and SUPORT set identification numbers beginning at the NSKIP-th record. CASE CASECC,/CASEBC/‘COMM‘/S,N,NSKIP/ //////‘MPC‘/‘SPC‘/‘SUPO’$ NX Nastran DMAP Programmer’s Guide 9-41 Chapter 9 Descriptions of DMAP Modules and Statements 9.28 CEAD Complex or unsymmetric eigenvalue analysis Given that [M], [B] and [K] are mass, damping, and stiffness, solve the equation: or for the eigenvalues p and the associated right eigenvectors {φ} or left eigenvectors {φL}. 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 $ Input Data Blocks: KXX BXX MXX DYNAMIC CASECC VDXC VDXR Stiffness matrix. Usually KHH or KDD. Viscous damping matrix. Usually BHH or BDD. Mass matrix. Usually MHH or MDD. Table of Bulk Data entry images related to dynamics. Table of Case Control command images. Partitioning vector with 1.0 at rows corresponding to null columns in KDD, BDD, and MDD. Partitioning vector with 1.0 at rows corresponding to null rows in KDD, BDD, and MDD. Output Data Blocks: CPHX CLAMA OCEIG LCPHX CLAMMAT Complex eigenvector matrix. Usually CPHH or CPHD. Complex eigenvalue summary table. Complex eigenvalue extraction report. Left-handed complex eigenvector matrix (Lanczos only). Usually LCPHH or LCPHD. Diagonal matrix with complex eigenvalues on the diagonal. See Remark 8. 9-42 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: NEIGV UNUSED2 SID Output-integer-no default. NEIGV indicates the number of eigenvalues found. If none were found, NEIGV is set to -1. Input-integer-default=1. Unused. Input-integer-default=0. Alternate set identification number. If SID=0, the set identification number is obtained from the CMETHOD command in CASECC and used to select the EIGC entry in DYNAMIC. If SID>0, the CMETHOD command is ignored and the EIGC entry is selected by this parameter value. Applicable for all methods If SID<0, both the CMETHOD command and all EIGC entries are ignored and the subsequent parameter values (E, ND1, etc.) are 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, METH specifies the method of eigenvalue extraction CLAN HESS SVD ISRR EPS ND1 ALPHAJ OMEGAJ MAXBLK IBLK KSTEP NDJ Complex Lanczos (block or single vector) QZ Hessenberg or QR Hessenberg Singular Value Decomposition. Iterative Schur-Rayleigh-Ritz Method Input-real-default=1.E-5. Used only when SID<0. Input-integer-default=0. The number of desired eigenvectors. Used only when SID<0. Input-real-default=0.0. Real part of shift point for pre-Version 70.5 Lanczos method. Used only when SID<0. Input-real-default=0.0. Imaginary part of shift point for pre-Version 70.5 Lanczos method. Used only when SID<0. Input-real-default=0.0. Maximum block size. Used only when SID<0. Input-real-default=0.0. Initial block size. Used only when SID<0. Input-real-default=0.0. Frequency of solve. Used only when SID<0. 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. Remarks: 1. Eigenvalues are extracted by the Inverse Power, Hessenberg, or Lanczos method. NX Nastran DMAP Programmer’s Guide 9-43 Chapter 9 Descriptions of DMAP Modules and Statements 2. At least one of KXX, BXX, or 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 can be purged for all. 4. CLAMA and OCEIG are suitable for printing by the OFP module. 5. For the Hessenberg method, spill logic can be requested with SYSTEM(108)=1 on the NASTRAN statement. This allows for no limits on problem size. 6. For the Hessenberg method, the mass matrix must be nonsingular. 7. UGS recommends using the UEIGL module for real unsymmetric eigensolutions. 8. CLAMMAT contains the diagonal matrix of eigenvalues, with dimensions compatible with CPHX and/or LCPHX so that [KDD] [CPHX] + [BDD][CPHX][CLAMMAT] + [MDD][CPHX][CLAMMAT] 2 = 0 and [LCPHX] T [KDD] + [CLAMMAT][LCPHX] T + [BDD] + [CLAMMAT] 2 [LCPHX] T [KDD] = 0 For development purposes, when block Lanczos is selected and system cell 108 is set to 2048, the fifth output slot contains the cross orthogonality matrix [Y] T [X], which should be identity. See the NX Nastran Numerical Methods User’s Guide for the definition of Y and X. Example: The following DMAP sequence extracts eigenvalues and eigenvectors and prints the results. CEAD OFP IF K,B,M,DYNAMIC,CASECC,,/VEC,CLAMA,OCEIGS,/ S,N,NFOUND $ CLAMA,OCEIGS// $ (NFOUND>-1) MATPRN VEC// $ 9.29 CHKCVG Check on contact convergence Format: CHKCVG TLAMDA,TLAMDO//TYPE/S,N,CMXF/S,N,FRAT/S,N,CNVI $ Input Data Blocks: TLAMDA TLAMDO Current contact result. Previous contact result. 9-44 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: TYPE CMXF FRAT CNVI Input-integer. Type of convergence check. Input/Output - integer. Input - Convergence ratio factor. Output - Maxmum value. Output - real. Convergence ratio. Output-integer. Convergence flag. 0 - Not converged 1 - Converged 9.30 CMPZPR 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 $ Input Data Blocks: EPT MPT DIT PCOMPT Table of Bulk Data entry images related to element properties, in particular, PSHELL and PCOMP entries. Table of Bulk Data entry images related to material properties, in particular, MAT2 and MAT8 entries. Table of TABLEij Bulk Data entry images. Table containing LAM option input and expanded information from the PCOMP Bulk Data entry. Output Data Blocks: EPTC MPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL records. Copy of MPT except MAT8 records are replaced by equivalent MAT2 records. NX Nastran DMAP Programmer’s Guide 9-45 Chapter 9 Descriptions of DMAP Modules and Statements 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, they are overwritten. Furthermore, any entries which have been internally generated (that is, with PID or MID>100000000) are also stripped off. 9.31 COPY Copies data blocks. Format: COPY DBI/DBO/PARM/BLOCK $ Input Data Block: DBI The data block to be copied Output Data Block: DBO A copy of DBI Parameters: PARM BLOCK Input-integer-default=-1 (PARM < 0 – the data block is copied. PARM ≥ 0 – no action is taken.) Input-integer-default=1 BLOCK < 0 – Block sensitive copy is used. BLOCK ≥ 0 – Standard copy is used. Remarks: 1. If BLOCK < 0 and the block size between DBI and DBO is different, a fatal error is issued. 2. This module is preferred over the copy options in MATMOD option 13 and TABEDIT. 9-46 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Example: Copy data block KELM. COPY KELM/KELMX/ALWAYS/-1 $ 9.32 CURV Transforms elemental centroid stresses (or strains) to the element‘s material coordinate system and/or interpolate the stresses (or strains) to the 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 $ Input Data Blocks: OES1 MPT CSTM EST BGPDT Element stress or strain table in SORT1 format Table of Bulk Data entry images related to material properties Table of coordinate system transformation matrices Element summary table Basic grid point definition table Output Data Blocks: OES1M OES1G Element stress or strain table in SORT1 format in the element‘s material coordinate system defined on the MAT1 entry Grid point stress or strain table in SORT1 format and interpolated from the centroidal stress table, OES1M Parameters: OUTOPT Input-integer-default=0. Output option: ≤0 1 2 4 Use the element output option found on OES1. Print Plot Punch NX Nastran DMAP Programmer’s Guide 9-47 Chapter 9 Descriptions of DMAP Modules and Statements The above values can be added together to select two or more forms of output. For example, OUTOPT=6 requests both plot and punch output. OG NINPTPS Input-integer-default=0. Grid point processing flag. If set to 0, grid point stresses or strains are computed. Input-integer-default=0. Approximate number of surrounding independent element interpolation points to be considered when interpolating at a grid point for a given material coordinate system. 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” in the NX Nastran Quick Reference Guide. 9.33 CURVPLOT Converts grid point output tables, that is, 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 $ Input Data Blocks: EQEXIN BGPDT EDT Equivalence table between external and internal grid/scalar identification numbers Basic grid point definition table Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, and the iterative solver; and in particular, SET1 entries Table of x-y plotting commands Table of applied loads in SORT1 format Table of single point forces of constraint in SORT1 format Table of displacements in SORT1 format Table of grid point stresses in SORT1 format XYCDB OPG1 OQG1 OUG1 OES1G 9-48 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OSTR1G Table of grid point strains in SORT1 format Output Data Blocks: OPG2X OQG2X OUG2X OES2GX OSTR2GX Table of applied loads in SORT2 format Table of single point forces of constraint in SORT2 format Table of displacements in SORT2 format Table of grid point stresses in SORT2 format Table of grid point strains in SORT2 format Parameter: DOPT Input-integer-default=0. Scaling method between grid points on the abscissa. 0 1 2 3 4 Proportional with respect to total distance Proportional with respect to x distance only Proportional with respect to y distance only Proportional with respect to z distance only Equally Remarks: 1. If EDT or XYCDB is purged, 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 can 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 applicable only 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 $ NX Nastran DMAP Programmer’s Guide 9-49 Chapter 9 Descriptions of DMAP Modules and Statements IF ( NOXYP>=0 ) XYPLOT XYPLTS/ $ 9.34 CYCLIC1 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 $ Input Data Blocks: CASECC GEOM3 GEOM4 DIT FRL Table of Case Control command images Table of Bulk Data entry images related to static loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership, and rigid element connectivity Table of TABLEij Bulk Data entry images Frequency response list Output Data Blocks: KVAL GEOM3N CASEFR Table of harmonic indices for analysis Updated GEOM3 for cyclic symmetry analysis Updated Case Control table for static loads generation and solution in cyclic symmetry analysis. One record for every distinct load set identification number. Table of harmonic indices Transformation matrix from physical to cyclic components Case Control table for cyclic data recovery. One record for every column in BACK. Required in static and pre-buckling analysis only. Transformation matrix from cyclic to physical components. Required in static and pre-buckling analysis only. HARM FORE CASEBK BACK 9-50 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: NSEG CTYPE Output-integer-no default. Number of cyclic segments as specified on CYSYM Bulk Data entry. Output-character-no default. Cyclic symmetry type as specified on CYSYM Bulk Data entry. ‘ROT’ ‘AXI’ ‘DIH’ APP Rotational Axisymmetric Dihedral Input-character-no default. Analysis type. ‘STATICS’ ‘MODES’ ‘BUCKLNG1’ ‘BUCKLNG2’ ‘FREQRESP’ Statics Normal modes Pre-buckling (statics) Buckling Frequency response NOGEOM3 NFREQ TOTALK Output-integer-no default. GEOM3N creation flag. Set to 1 if GEOM3N is created, otherwise set to -1. Output-integer-no default. Number of frequencies for frequency response analysis. Output-integer-default=0. Total number of harmonics. Remarks: CYCLIC1 generates equivalent GRAV and RFORCE Bulk Data entry images in harmonic components. 9.35 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 $ NX Nastran DMAP Programmer’s Guide 9-51 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: GEOM4 EQEXIN USET Table of Bulk Data entry images related to constraints, degree-of-freedom membership, and rigid element connectivity Equivalence table between external and internal grid/scalar identification numbers Degree-of-freedom set membership table Output Data Block: CYCD Table of constraints in harmonic components Parameters: NSEG CTYPE Input-integer-no default. Number of cyclic segments as specified on CYSYM Bulk Data entry. Input-character-no default. Cyclic symmetry type as specified on CYSYM Bulk Data entry. ‘ROT’ ‘AXI’ ‘DIH’ Rotational Axisymmetric Dihedral Remarks: 1. CYCLIC2 is a preprocessor for the CYCLIC3 and CYCLIC4 modules and is specified before the harmonic index loop in DMAP. 2. CYCLIC2 processes CYJOIN, CYAX, and CYSUP Bulk Data entry images in GEOM4 and identifies the constraints between the degrees-of-freedom in the analysis set for the cosine (symmetric) and sine (antisymmetric) models. 3. CYCLIC2 can also accommodate the p-set: CYCLIC2 GEOM4,EQDYN,USETD/ CYCD/ NSEG/CTYPE $ where EQDYN and USETD are output by DPD. 9.36 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. 9-52 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: CYCD KVAL KAA MAA BAA K4AA Table of constraints in harmonic components Table of harmonic indices for analysis Stiffness matrix in a-set or d-set Mass matrix in a-set or d-set Viscous damping matrix in a-set or d-set Structural damping matrix in a-set or d-set Output Data Blocks: KKK MKK BKK K4KK GC GS PVEC Stiffness matrix in cyclic components Mass matrix in cyclic components Viscous damping matrix in cyclic components Structural damping matrix in cyclic components Transformations matrix between symmetric (cosine) components and solution set components Transformation matrix between symmetric (sine) components and solution set components Partitioning vector for supported degrees-of-freedom specified on CYSUP Bulk Data entry Parameters: HINDEX NSEG NOKVAL KGTH Input-integer-no default. Harmonic index. Input-integer-no default. Number of segments. Output-integer-no default. Set to -1 if the value of HINDEX is not in the analysis set of harmonic IDs. Output-integer-no default. Set to -1 if all harmonic IDs (in analysis set) have been processed. NX Nastran DMAP Programmer’s Guide 9-53 Chapter 9 Descriptions of DMAP Modules and Statements 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 always has a value of -1. Remarks: 1. For buckling analysis, the negative of the differential stiffness, -KDAA, can be specified in place of MAA. ADD CYCLIC3 KDAA,/KDAAM/-1. $ 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 has rows equal to the number of columns in the GC matrix. 9.37 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 are transformed into cyclic components associated with the particular harmonic and appended to previous harmonic solutions. Format: CYCLIC4 Input Data Blocks: HARM Table of Case Control command images. 9-54 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GC GS PAC PHK UK LAMA CASEBK BACK Transformations matrix between symmetric (cosine) components and solution set components Transformation matrix between symmetric (sine) components and solution set components Static loads matrix in harmonic components Eigenvectors in solution set components Solution vector in solution set components Eigenvalue summary table for current harmonic. Required for normal modes analysis only (APP=‘REIG’and PATH=‘BACK‘). Case Control Data Block for output requests. Required for normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘). Backward transformation matrix from cyclic to physical components. Required for normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘). Output Data Blocks: PK UX PHX LAMA1 CASEBK1 BACK1 Load vector matrix in solution set components Solution vector matrix in cyclic components Eigenvector matrix in cyclic component. Appended eigenvalue summary table for all harmonics. Required for normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘). Case Control table for data recovery requests for all harmonics. Required for normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘). Backward transformation matrix from cyclic to physical components for all harmonics. Required for normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘). Parameters: PATH Input-character-no default. Direction of cyclic transformation: ‘FORE’ ‘BACK’ HINDEX APP Forward (analysis) Backward (data recovery) Input-integer-no default. Harmonic index. Input-character-no default. Analysis type. NX Nastran DMAP Programmer’s Guide 9-55 Chapter 9 Descriptions of DMAP Modules and Statements ‘STAT’ ‘REIG’ ‘BUCK’ ‘FREQ’ NFREQ TOTALK Statics Normal modes Buckling Frequency response Input/output-integer-no default. The number of passes through CYCLIC4. NFREQ is incremented by one on each execution of CYCLIC4. Input-integer-default=0. Total number of harmonics. If TOTALK>0, CASEBK1 and BACK1 is created. Required for normal modes analysis only. Examples: 1. Static analysis: FILE UX=APPEND $ PARAML KVAL//‘TRAILER‘/1/S,N,NKVAL $ NUMBER OF ANALYSIS HARMONICS PARAML KVAL//‘DTI‘/1/NKVAL//S,N,KMAX $ LAST ANALYSIS HARMONIC INDEX PARAML KVAL//‘IMATCH‘/1/S,N,HINDEX//S,N,KVAL $ DO WHILE ( HINDEX<=KMAX ) $ CYCLIC4 HARM,GC,GS,PA,,,/ PK,,,/ ‘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: 9-56 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements FILE CYPHX=APPEND,SAVE/CYLAMA1=APPEND,SAVE/ CASEBK1=SAVE/BACK1=SAVE,OVRWRT $ PARAML KVALM//‘TRAILER‘/1/S,N,TOTALK $ PARAML KVALM//‘DTI‘/1/TOTALK//S,N,KMAX $ PARAML KVALM//‘IMATCH‘/1/HINDEX//S,N,KVAL $ HINDEX=0 $ DO WHILE ( HINDEX<=KMAX ) $ IF ( KVAL=-1 ) THEN $ . . . CYCLIC4 HARM,GC,GS,CYPHA,CYLAMA,CASEBK,BACK/ CYPHX,CYLAMA1,CASEBK1,BACK1/ ‘BACK‘/HINDEX/APPCYC4/S,N,NFREQ/TOTALK $ ENDIF $ KVAL=-1 HINDEX=HINDEX+1 $ PARAML KVALM//‘IMATCH‘/1/HINDEX//S,N,KVAL $ ENDDO $ HINDEX<=KMAX MPYAD CYPHX,BACK1,/CYPHA1 $ 9.38 DBC Database converter for model generation and results processing Converts data blocks to a form usable by NX Nastran Access and MSC.Patran. 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 $ Input Data Block: DBi Data blocks for postprocessing. Output Data Blocks: None. Parameters: Pi Character-input-default is blank. The generic name of the corresponding data block; for example, P3 corresponds to DB3, and so on. (See table below for generic name.) Integer-input-default=0. The current superelement ID. If SEID=-1, the current SEID is assumed to be the qualifier value in the path of parameter DBCPATH. Dummy variable parameter to allow the passing of qualifiers from the NX Nastran database to the DBC database. SEID must be -1. SEID DBCPATH NX Nastran DMAP Programmer’s Guide 9-57 Chapter 9 Descriptions of DMAP Modules and Statements CP Integer-input/output-default=0. Control parameter. If set to other than zero, an error occurs in the module and further attempts to execute the module causes a module return without module execution. Character-input-default is blank. Allowable values of approach code: STATICS or blank TRANRESP FREQRESP REIG NLST BKL1 BKL0 CEIGEN AERO Statics Linear/nonlinear transient response Frequency response Normal modes Nonlinear statics Buckling Statics in a buckling solution Complex modes Aerodynamics APP CYCLIC GEOMU LOADU POSTU DBCDIAG Integer-input-default is 0. If CYCLIC = -1, data is interpreted as cyclic analysis. Integer-input-default=40; the geometric information is output to this FORTRAN unit. Integer-input-default=-1 (LOADU = GEOMU). If LOADU >0, the static load information is output to this FORTRAN unit. Integer-input-default=-1 (POSTU = GEOMU). If POSTU >0, the data recovery information is output to this FORTRAN unit. Integer-input-default=0. Controls the printing of certain diagnostics during the conversion. If several diagnostics are desired, the sum of the following values is required. For example, DBCDIA = 3 requests the printing of grid relation and element connection record diagnostics. Value 0 1 2 4 8 Diagnostic Output No diagnostics are printed. Grid relation record Element connection record Internal module begin message Internal module statistics 9-58 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 16 32 64 128 256 512 PROGRAM Internal module CPU time and begin message in performance summary table DBC database dictionary entries Messages for null NASTRAN logical file connections Suppress diagnostics when geometry updates occur Save the grid point stress surface and volume factors Do not save the grid point stress surface and volume subcase data. Character-input-default=’XL’. If PROGRAM =’XL’, the DBC database is suitable for processing in MSC.Patran. If PROGRAM =’GRASP’, the DBC database is suitable for processing in NX Nastran Access. Character-input-default=’YES’. DBC data base overwrite flag. If OVRWRT =’YES’ and the DBC database was created in a prior run, data blocks pre-existing on the DBC database are overwritten in the current run when the qualifier values are identical. Integer-input-defaul =0. Design optimization loop identification number. Integer-input-default=0. When ADPTINDX is not equal to zero, the data base object attribute is qualified by the value of this parameter, which denotes intermediate p-element results exist. Integer-input-default=0. NDOF denotes size of the model (number of degrees of freedom), which is 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. OVRWRT DESITER ADPTINDX LUSET Remarks: 1. Data block name table: Generic Name (P1-P20) Data Block Description Name AEBGPDT BGPDT CASECC CONTAB AECTRL CSTM CVAL Stored on Unit Description BEPT BGPDT CASECC CONTAB CONTROL CSTM CVAL — GEOMU POSTU POSTU POSTU GEOMU POSTU Aerostructural basic grid point definition table Basic grid point definition table Table of Case Control command images Table of design constraint attributes Table of aerodynamic model‘s control definition Table of coordinate system transformation matrices Matrix of design constraint values NX Nastran DMAP Programmer’s Guide 9-59 Chapter 9 Descriptions of DMAP Modules and Statements Generic Name (P1-P20) Data Block Description Name DBCOPT DESTAB DIT DSCM2 DYNAMIC GEOM2 ELDCT SEMAP EPT Stored on Unit Description DBCOPT DESTAB DIT DSCM2 DYNAMIC ECT ELDCT EMAP EPT POSTU POSTU GEOMU/POSTU POSTU GEOMU GEOMU POSTU GEOMU GEOMU Design optimization history table for Table of design variable attributes Table of TABLEij Bulk Data entry images Normalized design sensitivity coefficient matrix Table of Bulk Data entry images related to dynamics Element connectivity table Table of element stress discontinuities Superelement map table Table of Bulk Data entry images related to element properties Equivalence between external and internal point identification numbers Element summary table Matrix of aerodynamic restrained elastic forces Matrix of aerodynamic unrestrained elastic forces Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to static and thermal loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of grid point stress discontinuities Grid point definition table Grid point element connection table External grid/scalar point identification number list Table of grid point stresses or strains for post-processing Table of design iteration history Matrix of aerodynamic restrained inertia forces Matrix of aerodynamic unrestrained inertia forces Real or complex eigenvalue summary table EQEXIN EQEXIN GEOMU EST FRM FURM GEOM1 GEOM3 EST — — GEOM1 GEOM3 GEOMU POSTU POSTU GEOMU LOADU GEOM4 GEOM4 GEOMU/LOADU GPDCT GPDT GPECT GPL GPS GPDCT GPDT GPECT GPL EGPSTR POSTU GEOMU POSTU GEOMU/POSTU POSTU HIS IRM IURM LAMA HIS — — LAMA/CLAMA POSTU POSTU POSTU POSTU 9-60 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Generic Name (P1-P20) Data Block Description Name MPT Stored on Unit Description MPT GEOMU Table of Bulk Data entry images related to material properties Design objective table Table of element energy losses Table of element forces in SORT1 or SORT2 format Table of element kinetic energies Table of element stresses or strains in SORT1 or SORT2 format Table of composite element stresses or strains in SORT1 format Table of element strain energies and energy densities Table of nonlinear element stresses in SORT1 format Table of grid point forces Transient or frequency response output list Table of applied loads in SORT1 or SORT2 format Table of single or multipoint forces-of-constraint in SORT1 or SORT2 format Table of displacements in SORT1 or SORT2 format Error-estimate table updated for current superelement or adaptivity loop Table of mapping from original first level (direct) retained responses Table of first level (direct) (DRESP1 Bulk Data entry) attributes Matrix of initial values of the retained first level (direct) responses Table of mapping from original second level (synthetic) retained responses Matrix of initial values of the retained second level (synthetic) responses Table of second level (synthetic) responses Matrix of aerodynamic rigid forces OBJTAB OEDE OEF OEKE OES OBJTAB ONRGY1 OEF ONRGY1 OES POSTU POSTU POSTU POSTU POSTU OESC OES1C POSTU OESE ONRGY1 POSTU OESNL OESNL1 POSTU OGPF OL OPG OQG OGPFB1 OL OPG OQG POSTU POSTU POSTU POSTU OUG PERROR OUG ERROR1 POSTU POSTU R1MAPR R1MAPR POSTU R1TAB R1TAB POSTU R1VAL R1VAL POSTU R2MAPR R2MAPR POSTU R2VAL R2VAL POSTU RESP12 RM RESP12 — POSTU POSTU NX Nastran DMAP Programmer’s Guide 9-61 Chapter 9 Descriptions of DMAP Modules and Statements Generic Name (P1-P20) Data Block Description Name SCSTM Stored on Unit Description SCSTM GEOMU Table of global transformation matrices for partitioned superelements Table of combined sets Table of element to grid point interpolation factors Matrix of aerodynamic restrained elastic displacements Matrix of aerodynamic unrestrained elastic displacements View information table, contains the relationship between each p-element and its view-elements and view-grids SETS SVF UG SET EGPSF — GEOMU POSTU POSTU UUG — POSTU VIEWTB VIEWTB GEOMU/POSTU 2. DBCPATH is a parameter defined on a statement in the NASTRAN NDDL; that is, PARAM,DBCPATH = 0,PATH = DBCQUAL PATH DBCQUAL QUAL1,QUAL2,QUAL3,etc. where QUALi selects the QUALifier values associated with the PATH of the input data blocks from NASTRAN to be written along with the input data blocks on the DBC database. In other words, the intersection of the PATH DBCQUAL and the PATH of the input data blocks forms the set of QUALifiers to be written to the DBC database and associated with the input data blocks. Also, the PROJECT and VERSION is written. UGS recommends that the input data blocks all have the same PATH. If it is not NDDL, only the PROJECT and VERSION are associated with the input data blocks on the DBC database. 3. Generic data blocks: ECT, GEOM1, and EQEXIN, must exist on POSTU (when PROGRAM =’XL’) or GEOMU (when PROGRAM =’GRASP’) prior to the conversion of the following data blocks: OUG, OES, OEF, OPG, OQG, and GPS. 4. If PROGRAM =’XL’, the converted format of the above data blocks is written to one of three databases (FORTRAN units): GEOMU, LOADU, and POSTU. GEOMU LOADU POSTU BGPDT, CSTM, ECT, EMAP, EPT, GPDT, MPT, and SETS GEOM3 and GEOM4 CASECC, GPS, EQEXIN, GEOM1, GPL, LAMA, OEF, OES, OESNL, OGPF, OESE, OPG, OQG, OUG, OESC, DBCOPT, GPDCT, and ELDCT 5. If PROGRAM =’GRASP’, 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. 9-62 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 7. Generic names OES and OESC must be specified in separate DBC modules and can 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. TYPE PARM,,I,Y,DBCDIAG=0,GEOMUNIT,LOADUNIT,POSTUNIT $ TYPE PARM,,CHAR8,Y,PROGRAM=’XL’ $ 1. After generation of IFP module, output data blocks. DBC CSTM,EPT,MPT,GEOM4,CASECC,,,,,,,,,,,,,,// ’CSTM’/’EPT’/’MPT’/’GEOM4’/’CASECC’/ //////////////SEID//S,N,CP/APP//GEOMU/ LOADU/POSTU/DBCDIAG/PROGRAM/ $ 2. Inside superelement generation loop. Data required for undeformed plotting of geometry and loads. DBC BGPDTS,GPLS,GPDTS,ECTS,GEOM1S,EQEXINS, GEOM3S,GEOM4S,,,,,,,,,,,//’BGPDT’/’GPL’/ ’GPDT’/’ECT’/’GEOM1’/’EQEXIN’/’GEOM3’/ ’GEOM4’/////////////SEID//S,N,CP/APP// GEOMU/LOADU/POSTU/DBCDIAG/ PROGRAM/ $ 3. Inside superelement data recovery loop. Grid point stresses. DBC GPLS,EGPSTR,,,,,,,,,,,,,,,,,//’GPL’/’GPS’/ /////////////////SEID//S,N,CP/APP/GEOMU/ LOADU/POSTU/DBCDIAG/PROGRAM $ Forces, stresses, displacements, and so on. Note: ECTS, GEOM1S, and EQEXINS are repeated here in case the above call was not executed, as in a data recovery restart. DBC OPG1,OUGV1,OEF1X,OES1X,OQG1,ONRGY1,OGPFB1, ECTS,GEOM1S,EQEXINS,,,,,,,,,//’OPG’/’OUG’/ ’OEF’/’OES’/’OQG’/’OESE’/’OGPF’/’ECT’/ ’GEOM1’/’EQEXIN’//////////SEID//S,N,CP/ APP//GEOMU/LOADU/POSTU/DBCDIAG/ PROGRAM/ $ 9.39 DBDELETE Deletes NDDL data blocks and parameters Deletes NDDL data blocks and parameters. An optional WHERE clause can be specified for a more selective deletion. NX Nastran DMAP Programmer’s Guide 9-63 Chapter 9 Descriptions of DMAP Modules and Statements Format: Describers: DATABLK PARAM where-expr Delete data blocks. datablk-list specifies a list of NDDL-defined data blocks separated by commas. Delete parameters. param-list specifies a list of parameters separated by commas. Logical expression that specifies the desired values of colnames described in Table 2 under the “DBDICT” statement. If the where-expr is true, the named items are 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” 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, none of that data block or parameter is deleted. For example, given that SPC is not a qualifier for KGG, the following DBDELETE statement does 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), the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA, the following DBDICT statements are equivalent: SPC=10 $ DBDELETE DATABLK=KAA $ or DBDELETE DATABLK=KAA WHERE(SPC=10) $ The WILDCARD keyword can 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, and so on.: DBDELETE DATABLK=KAA WHERE(SPC=10 AND WILDCARD) $ Note: WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJECT, VERSION, CDATE, and so on. 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. 9-64 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.40 • • • • • • • DBDICT Prints database directory tables Data blocks described by an NDDL DATABLK statement Parameters described by an NDDL PARAM statement All unique paths (KEYs) and their qualifiers values Qualifiers and their current values Data blocks not described by an NDDL DATABLK statement Parameters not described by an NDDL PARAM statement Project and version information Basic Format: The basic format of DBDICT specifies which tables to print and prints all items (data blocks and parameters) found in the directory. Also, the attributes (colnames) to be printed and the print format are predefined. Note that more than one table can be specified on the same DBDICT statement. DBDICT [DATABLK PARAM PROJVERS QUALCURR QUALIFIERS] Examples: DBDICT DBDICT PARAM PROJVERS Full Format: The full format permits the selection of items by name and/or by the WHERE describer. The full format also permits the attributes to be printed using the SELECT describer. In addition, the print format can be specified with the SORT, FORMAT, and LABEL describers. Note that the full format allows the specification of only a single table on a DBDICT statement. SELECT(colname[- ’col-label’]. . . ), FORMAT (FWIDTH = w [.d] LWIDTH = k DWIDTH = w [.d] AWIDTH = a IWIDTH = i, COLSPACE = c VALUE = w, NX Nastran DMAP Programmer’s Guide 9-65 Chapter 9 Descriptions of DMAP Modules and Statements colname = col-width, . . .), 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. 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. Print the project-version table. Print the qualifier table. Print the current values of the qualifiers. SORT is ignored. Logical expression that specifies the desired values of colnames described below. For example, WHERE(VERSION = 4 AND SEID <> 2 AND SEID >0) selects all items under version 4 for all values of SEID greater than 0 except 2. See “WHERE and CONVERT Clauses” for a further description. The default for VERSION is the current version and PROJECT is the current project. The default for qual is * which is all qualifier values found on the database. See Remark 12. Specifies a list of column names to be printed. The order of the specified colnames is printed from left to right. If colname is not specified, all columns are printed. Column name. Colname specifies a particular attribute of the database item; such as data block name (NAME), creation date (CDATE), number of blocks (SIZE), or qualifier name (SEID, SPC, etc.). The allowable colnames are given in the Remarks. The label to printed above the column identified by colname. The default for col-label is the colname. col-label cannot be specified for colnames: QUALSET, QUALALL, and TRAILER. Specifies the default width for single precision real numbers in real and complex qualifiers. (Integers: w >0 and d>0, Default = 12.5). PARAM PROJVERS QUALIFIERS QUALCURR where-expr SELECT colname col-label FWIDTH = w.d 9-66 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DWIDTH = w.d AWIDTH = a Specifies the default width for double precision real numbers in real and complex qualifiers. (Integers: w > 0 and d > 0, Default = 17.10). Specifies the default width for character string qualifiers. Character strings are printed with enclosing single quotation marks, even if the string is blank. (Integer > 0, Default = 8.) Specifies the default width for integer qualifiers. (Integer > 0, see Remarks for defaults.) Specifies the default width for logical qualifiers. Logical values are printed as either “T” for TRUE or “F” for FALSE. (Integer >0, Default = 1.) Specifies the default number of spaces between columns. (Integer > 0, see Remarks for defaults). Specifies the default width for parameter values. The values are printed as character strings with left justification. (Integer>0, Default=40.) The print width of the data under colname or qual-name. For real numbers, specify w.d where w is the width of the field and d is the number of digits in the mantissa. For integers and character strings, specify w where w is the width of the field. col-width cannot be specified for colnames: QUALSET, QUALALL, and TRAILER. 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 cannot be specified under SORT. Each colname specified in SORT must be separated by commas. A title to be printed on each page of the directory output. Print justification of the page title. IWIDTH = i LWIDTH = k COLSPACE = c VALUE = w col-width SORT page-title RIGHT, CENTER, LEFT Remarks: 1. DBDICT prints seven different tables according to a default or user-defined format. The tables are: Describer DATABLK Description Data blocks described by a NDDL DATABLK statement Parameters described by a NDDL PARAM statement Current Qualifiers and their values Default page-title NDDL DATABLOCKS See remark 2 PARAM NDDL PARAMETERS 3 QUALCURR CURRENT QUALIFIERS 4 NX Nastran DMAP Programmer’s Guide 9-67 Chapter 9 Descriptions of DMAP Modules and Statements Describer QUALIFIERS Description Qualifiers and their values for each key number Data blocks not described by a NDDL DATABLK statement Parameters not described by a NDDL PARAM statement Project-Version Default page-title QUALIFIERS See remark 5 DATABLK(LOCAL) LOCAL DATABLOCKS 6 PARAM(LOCAL) LOCAL PARAMETERS 7 PROJVERS PROJECT-VERSION 8 If DBDICT is specified without any describers, the NDDL Data Blocks Table are printed. See Remark 2. In an FMS statement, DATABLK(LOCAL) and PARAM(LOCAL) produce no output, and QUALCURR produces the default values specified on the NDDL QUAL statement. The defaults and allowable colnames for SELECT, FORMAT, SORT, and LABEL depend on the table. The defaults are described in the following remarks and tables. 2. The default print of the NDDL Data Blocks Table is obtained by: DBDICT or DBDICT DATABLK and is equivalent to: DBDICT DATABLK , SELECT(NAME,DATABASE,DBSET,PROJNO=’PROJ’,VERSION=’VERS’,CDATE, CTIME, SIZE,KEY,PURGED=’PU’,EQUIVD=’EQ’, POINTER=’FILE’,QUALSET) , FORMAT(NAME=8,DBSET=8,CDATE=6,CTIME=6,SIZE=5, KEY=4 ,PURGED=4,EQUIVD=4,POINTER=8, IWIDTH=5,COLSPACE=1) , SORT(PROJNO=A,VERSION=A,DBSET=A,NAME=A) , LABEL(’NDDL DATABLOCKS’ CENTER) and looks like: Listing 9-1. DBDICT PARAM Example 9-68 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements The table below gives the allowable colnames along with a description that can be specified in the FORMAT, SELECT, and SORT describers. Column name Default column width 40 4 4 6 6 8 8 8 6 6 5 See Note 4 8 8 8 4 4 4 4 8 8 8 8 9 See Note See Note Default column label Description PROJECT PROJNO VERSION CDATE CTIME NAME DATABASE DBSET RDATE RTIME SIZE qual-name KEY TRLi TRAILER EXTNAME EQUIVD PURGED EQFLAG SCRFLAG POINTER DBENTRY FEQCHAIN BEQCHAIN DBDIR20 QUALALL QUALSET PROJECT NAME PROJ NO VERSION CDATE CTIME NAME DATABASE DBSET RDATE RTIME SIZE qualifier name KEY TRLi TRLi EXTNAME EQ PU EF SF POINTER DBENTRY FEQCHAIN BEQCHAIN DBDIR(20) qualifier name qualifier name Project name defined by PROJECT statement Project number associated with PROJECT Version number Creation Date Creation Time Parameter name MASTER DBset name DBset name Revision Date Revision Time Number of blocks Qualifier name Key number i-th word in the trailer All 10 trailer words Extended name Equivalenced flag Purged flag Scratch equivalenced flag Scratch DBSET flag Directory pointer Database entry pointer Forward equivalence chain Backward equivalence chain Directory word 20 All qualifiers Predefined subset of all qualifiers NX Nastran DMAP Programmer’s Guide 9-69 Chapter 9 Descriptions of DMAP Modules and Statements Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, AWIDTH=8, and FWIDTH=12. 3. The default print of the NDDL parameter table is obtained by: DBDICT PARAM and is equivalent to: DBDICT PARAM, SELECT(NAME,DATABASE,DBSET,PROJNO=’PROJ’,VERSION=’VERS’,CDATE,CTIME, KEY,VALUE,QUALSET), FORMAT(NAME=8,DATABASE=8,DBSET=8,CDATE=6,CTIME=6, KEY=4,VALUE=40,IWIDTH=5,COLSPACE=1), SORT(PROJNO=A,VERSION=A,DBSET=A,NAME=A), LABEL(’NDDL PARAMETERS’ CENTER) and looks like: Listing 9-2. DBDICT PARAM Example The table below gives the allowable colnames along with a description that can be specified in the FORMAT, SELECT, and SORT describers. Column name Default column width 40 5 4 6 6 8 8 8 6 Default column label Description PROJECT PROJNO VERSION CDATE CTIME NAME DATABASE DBSET RDATE PROJECT NAME PROJ VERS CDATE CTIME NAME DATABASE DBSET RDATE Project name defined by PROJECT statement Project number associated with PROJECT Version number Creation Date Creation Time Parameter name MASTER DBset name DBset name Revision Date 9-70 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Column name Default column width 6 8 40 4 See Note See Note See Note Default column label Description RTIME POINTER VALUE KEY qual-name QUALALL QUALSET RTIME POINTER VALUE KEY qualifier name qualifier name qualifier name Revision Time Directory pointer Parameter value Key number Qualifier name All qualifiers Predefined subset of all qualifiers Default widths for qualifiers are DWIDTH=17.10, AWIDTH=8, IWIDTH=5, LWIDTH=1, and FWIDTH=12.5. 4. The default print of the Qualifier Table is obtained by: DBDICT QUALIFIERS and is equivalent to: DBDICT QUALIFIERS , SELECT(KEY QUALALL) , FORMAT(DWIDTH=17.10 AWIDTH=8 IWIDTH=5 LWIDTH=1 , FWIDTH=12.5 COLSPACE=2) SORT(KEY=A) , LABEL(’QUALIFIERS’ CENTER ) and looks like: Listing 9-3. DBDICT QUALIFIERS Example QUALALL selects all qualifiers to be printed. The qualifiers are printed in alphabetic order. QUALSET selects only the qualifiers SEID, PEID, SPC, MPC, LOAD, and METH to be printed. NX Nastran DMAP Programmer’s Guide 9-71 Chapter 9 Descriptions of DMAP Modules and Statements The table below gives the allowable colnames along with a description that can be specified in the FORMAT, SELECT, and SORT describers. QUALALL and QUALSET cannot 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 name KEY qual-name QUALALL QUALSET Default column width 5 See Note See Note See Note Default column label KEY qualifier name qualifier name qualifier name Description Key number Qualifier name All qualifiers Predefined subset of all qualifiers 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), FORMAT(AWIDTH=8,IWIDTH=5,LWIDTH=1,COLSPACE=2), LABEL=(’CURRENT QUALIFIERS’ CENTER) and looks like: Listing 9-4. DBDICT QUALCURR Example The table below gives the allowable colnames along with a description that can be specified in the SELECT describers. Column name Default column width See Note See Note Default column label Description qual-name QUALALL qualifier name qualifier name Qualifier name All qualifiers 9-72 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Column name Default column width See Note Default column label Description QUALSET qualifier name Pre-defined subset of all qualifiers 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. Note: DBDICT QUALCURR Colnames. 6. 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) and looks like: Listing 9-5. DBDICT DATABLK(LOCAL) Example 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 can be specified in the FORMAT, SELECT, and SORT describers. Column name Default column width 8 8 8 8 8 8 8 Default column label NAME SUBDMAP BLOCKS EQ PU POINTER TRLi Description NAME SUBDMAP SIZE EQUIVD PURGED POINTER TRLi Parameter name SubDMAP name Number of blocks Equivalenced flag Scratch flag Directory pointer i-th word in the trailer NX Nastran DMAP Programmer’s Guide 9-73 Chapter 9 Descriptions of DMAP Modules and Statements Column name Default column width 8 8 Default column label TRLi EXTNAME Description TRAILER EXTNAME All 10 trailer words Extended name 7. The default print of the local parameter table is obtained by: DBDICT PARAM(LOCAL) and is equivalent to: DBDICT PARAM(LOCAL) SELECT(NAME,SUBDMAP,VALUE), FORMAT(COLSPACE=4,VALUE=40,AWIDTH=8), SORT(NAME=A) LABEL(’ LOCAL PARAMETERS’ CENTER) and looks like: Listing 9-6. DBDICT PARAM(LOCAL) Example. The table below gives the allowable colnames along with a description that can be specified in the FORMAT, SELECT, and SORT describers. Column name Default column width 8 8 40 Default column label Description NAME SUBDMAP VALUE NAME SUBDMAP VALUE Parameter name SubDMAP name Parameter name 8. The default print of Project Version Table is obtained by: 9-74 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DBDICT PROJVERS and is equivalent to: DBDICT PROJVERS , SELECT(PROJECT=’PROJECT NAME’,PROJNO, VERSION ,DELFLG=’DELETED’ , CDATE=’CREATION DATE’ CTIME=’CREATION TIME’) , FORMAT(PROJECT=40,PROJ=10,VERS=10,DELFLG=7, COLSPACE=1 ,CDATE=13,CTIME=13) , LABEL(’PROJECT-VERSION’,CENTER) SORT(PROJNO=A,VERSION=A) and looks like: Listing 9-7. DBDICT PROJVERS Example The table below gives the allowable colnames along with a description that can be specified in the FORMAT, SELECT, and SORT describers. Column name Default column width 40 10 10 7 Default column label Description PROJECT PROJNO VERSION DELFLG PROJECT NAME PROJ NO VERSION DELETED Project name defined by PROJECT statement Project number associated with PROJECT Version number Flag indicating whether this project/version has been deleted by the RESTART NOKEEP or DBCLEAN statements Creation Date Creation Time CDATE CTIME 13 13 CREATION DATE CREATION TIME CDATE is printed as YYMMDD where YY, MM, and DD are the year, month, and date, respectively. CTIME is HHMMSS where HH, MM, and SS are the hour, minute, and second, respectively. 9. If a parameter or qualifier value is defined to be a character string, the value is printed with enclosing single quotation marks. Blank strings are also printed with single quotation marks. 10. If a given qualifier is not in the path of a given data block or parameter, blank spaces are printed. NX Nastran DMAP Programmer’s Guide 9-75 Chapter 9 Descriptions of DMAP Modules and Statements 11. A line wraps 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. 12. The where-expr has the following rules: • If the where-expr specifies a colname that is not assigned to the data block or parameter, no directory information is printed for that data block or parameter. For example, given that SPC is not a qualifier for KGG, the following DBDICT statement produces no output: DBDICT DATABLK=KGG WHERE(SPC=10) $ • If the where-expr does not specify a colname that is assigned to the data block (or parameter), the qualifier is wildcarded. For example, given that SEID is a qualifier for KAA, 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) $ 9.41 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 can be specified for a more selective equivalence. Format: 9-76 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Describers: datablk-list Specifies a list of data blocks separated by commas. The default is *, which selects all data blocks. The equivalenced data block can 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, DATABLK=(KLL/KLL1) is specified. Specifies a list of parameters separated by commas. The default is *, which selected all parameters. The equivalenced parameter can 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, PARAM=(LUSETS/LUSET) is specified. Logical expression that specifies the desired values of colnames described in Table 2 under the DBDICT statement. If where-expr is true, the named items are 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” for a further description. The default for VERSION and PROJECT is the current version and project. See Remark 1 for more information. 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[;...] param-list where-expr convert-expr For example, CONVERT (SEID=100+SEID; SPC=102). See “WHERE and CONVERT Clauses” for a further discussion on WHERE and CONVERT clauses. The default action for VERSION and PROJECT is to convert to the current version-ID and current project-ID. But if either PROJECT or VERSION is specified in the convert-expr, both must be specified. OVRWRT NOOVRWRT By default (that is, NOOVRWRT), duplicate data blocks or parameters on the created by DBEQUIV cause a fatal message. A duplicate means that a data block or parameter has not only the same name but also the same qualifier values, PROJECT, VERSION, and DBSET as the primary data block or parameter. If OVRWRT is specified, the primary data block is overwritten. By default, data blocks and parameters created by DBEQUIV cannot be output again in a subsequent DMAP module. If RESTART is specified, the selected data blocks and parameters can be overwritten once. RESTART 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, none of that data block or parameter is equivalenced. For example, given that SPC is not a qualifier for KGG, the following DBEQUIV statement does not equivalence any KGG: DBEQUIV DATABLK=KGG WHERE(SPC=10) CONVERT(SPC=20) $ NX Nastran DMAP Programmer’s Guide 9-77 Chapter 9 Descriptions of DMAP Modules and Statements If the where-expr does not specify a colname that is assigned to the data block (or parameter), the current value of the qualifier is assumed. For example, given that SEID is a qualifier for KAA, 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 can 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, and so on: DBEQUIV DATABLK=KAA WHERE(SPC=10 AND WILDCARD) CONVERT(SPC=20) $ WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJNO, VERSION, CDATE, and so on. 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. 9.42 SubDMAP DBFETCH Fetch data blocks stored by DBSTORE Retrieves user-specified data blocks on the database previously stored with CALL DBSTORE. Format: CALL DBFETCH /DB1,DB2,DB3,DB4,DB5/Q1/Q2/ FLAG/0/S,SUCCESS $ Input Data Blocks: None. Output Data Blocks: DBi Data blocks to be fetched. See Remark 3. Parameters: Q1 Q2 FLAG Integer-input-no default. First qualifier. Integer-input-no default. Second qualifier. Integer-input-no default. Name flag: 0 means fetch DBi with name DBi. 1 means drop the first character of DBi before searching the directory. 9-78 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SUCCESS Integer-output-no default. SUCCESS = -1 means all data blocks were successfully retrieved. SUCCESS = 0 means otherwise. 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, the actual name of the data block to be stored on the database is the name that appears on the “highest” CALL statement that contains DBi. DIAG 47 can 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, the RESTART or DBLOCATE FMS statement must be specified. If DBLOCATE is used, 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. CALL DBFETCH /EA,,,,/1/1/1/0/S,EXIST $ 9.43 SubDMAP DBMGR Functions on data blocks stored by DBSTORE Performs functions on items stored on the database with this subDMAP and CALL DBSTORE. Format: CALL DBMGR //OPT/P2/P3/P4/P5/P6/DB1/DB2/DB3/DB4/DB5 $ 1. Directory print Print the contents of the database directory. Format: CALL DBMGR //2/0/0/0/0/0/ ’ ’/’ ’/’ ’/’ ’/’ ’ $ Input Data Blocks: None. Output Data Blocks: None. NX Nastran DMAP Programmer’s Guide 9-79 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: None. 2. Data block deletion Deletes up to five data block(s) previously stored with CALL DBSTORE. Format: CALL DBMGR //5/Q1/Q2/0/0/0/DB1/DB2/DB3/DB4/DB5 $ Parameters: Q1 Q2 DBi Integer-input-no default. First qualifier of DBi. Integer-input-no default. Second qualifier of DBi. Character-input-no default. Names of data blocks to be deleted 3. Data block equivalence Assign up to four alias names to one to four data blocks. Format: CALL DBMGR //7/QP1/QP2/QS1/QS2/0/ DBP/DBS1/DBS2/DBS3/DBS4 $ Parameters: QP1 QP2 QS1 QS2 DBSi Integer-input-no default. First qualifier of primary data block (DBP). Integer-input-no default. Second qualifier of primary data block (DBP). Integer-input-no default. First qualifier of secondary data block (DBSi). Integer-input-no default. Second qualifier of secondary data block (DBSi). DBP Character-input-no default. Primary data block name. Character-input-no default. Secondary data block names to be equivalenced to DBP. 4. Data block rename Rename and/or modify the qualifier values of a data block previously stored with CALL DBSTORE. Format: CALL DBMGR //9/QO1/QO2/QN1/QN2/0/ DBOLD/DBNEW/’ ’/’ ’ $ 9-80 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: None. Output Data Blocks: None. Parameters: QO1 QO2 QN1 QN2 DBOLD DBNEW Integer-input-no default. First qualifier of previously stored data block (DBOLD). Integer-input-no default. Second qualifier of previously stored data block (DBOLD). Integer-input-no default. First qualifier of new name of data block (DBNEW). Integer-input-no default. Second qualifier of new name of data block (DBNEW). Character-input-no default. Name of the previously stored data block. Character-input-no default. New name of the previously stored data block. 5. Store character string Store up to five character strings with qualifiers. Format: CALL DBMGR //10/Q1/Q2/0/0/0/STR1/STR2/STR3/STR4/STR5 $ Parameters: Q1 Q2 STRi Integer-input-no default. First qualifier of STRi. Integer-input-no default. Second qualifier of STRi. Character-input-no default. Strings up to 8 characters in length. 6. Test for presence of a data block or a character string Test for the presence of a data block previously stored by CALL DBSTORE or a character string previously stored by CALL DBMGR (OPT=10). Format: CALL DBMGR //11/Q1/Q2/0/S,PRES1/S,PRES2/ DB1/DB2/’ ’/’ ’ $ NX Nastran DMAP Programmer’s Guide 9-81 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: Q1 Q2 PRESi DBi Integer-input-no default. First qualifier of DBi. Integer-input-no default. Second qualifier of DBi. Integer-output-no default. 0 means DBi not present. -1 means DBi present. Character-input-no default. Character strings or the names of data blocks. Remarks: 1. All parameters must be specified even if they are not used or the default value is desired. Unused integer parameters can be set to 0 and unused character parameters to ’ ’ (a string with 5 blanks). 2. If data blocks exist when storing, renaming or equivalencing, they are overwritten. 3. If CALL DBMGR is to be used in restart runs with the structured solution sequences (SOLs 101 through 200), PUTSYS(1, 109) should be specified immediately preceding CALL DBMGR and PUTSYS(0, 109) should be specified immediately following CALL DBMGR. 9.44 DBSTATUS Checks status of up to ten data blocks Format: DBSTATUS DB1,DB2,DB3,DB4,DB5,DB6,DB7,DB8,DB9,DB10// S,N,NODB1/S,N,NODB2/S,N,NODB3/S,N,NODB4/S,N,NODB5/ S,N,NODB6/S,N,NODB7/S,N,NODB8/S,N,NODB9/S,N,NODB10 $ Input Data Blocks: DBi Any data block (matrix or table) Output Data Blocks: None. Parameters: NODBi Output-integer-default=-1. Status of the DBi-th data block: -1 0 1 Not generated Empty Generated 9-82 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 10 11 Offline and empty Offline and generated Remarks: 1. Trailing commas in the input data block list can be omitted without warning. For example the following statement: DBSTATUS KAA,,,,,,,,,//S,N,NOKAA $ can 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; that is, PARAML returns -1 for empty data blocks and fatally terminates for offline data blocks. 9.45 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: CALL DBSTORE DB1,DB2,DB3,DB4,DB5//Q1/Q2/DBSET/COND $ Input Data Blocks: DBi Data blocks to be stored. See Remark 5. Parameters: Q1 Q2 DBSET COND Integer-input-no default. First qualifier of DBi. Integer-input-no default. Second qualifier of DBi. Character-input-no default. The dbset-name to store DBi. The dbset-name must be padded with blanks to 5 characters in length; for example, ’DBDN ’. Integer-input-no default. Conditional store flag. COND = 0 means store and COND ≠ 0 means do not store. 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; that is, ’ ’ (a string with 5 blanks), DBi is stored on DBset DBALL. NX Nastran DMAP Programmer’s Guide 9-83 Chapter 9 Descriptions of DMAP Modules and Statements 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), 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, the actual name of the data block to be stored on the database is the name that appears on the “highest” CALL statement that contains DBi. DIAG 47 can be specified so that the actual name is printed to the F06 file. Examples: 1. Store data block B on dbset DB100. PUTSYS(1, 109) $ deactivate restart skipping CALL DBSTORE B,,,,//2/2/’DB100’/0 $ PUTSYS(0, 109) $ activate restart skipping 2. The following example computes five variations on a basic matrix [K + λiM][X] = [B], where K, B, and M are input via DMI Bulk Data entries and (λi, i = 1,5) are input via DTI,LAMLST entries. In the first loop, the matrix KPLM is formed and decomposed and its factors, L and U, stored. In the second loop, the factors are fetched and, along with B, input to the FBS module to solve for X. SOL 100 COMPILE USERDMAP ALTER 2 $ TYPE PARM,,I,N,LOOPCNT=1,SING=0 $ TYPE PARM,,CHAR8,N,BX $ BLANK STRING TYPE PARM,,CS,N,LAMC $ DMIIN DMI,DMINDX/K,M,B,,,,,,, $ DTIIN DTI,DTINDX/LAMLST,,,,,,,,, $ MATPRN K,M,B/ $ DO WHILE (LOOPCNT<=5 AND SING>-1) $ PARAML LAMLST//’DTI’/1/LOOPCNT/S,N,LAMBDA $ LAMC=CMPLX(LAMBDA) $ ADD K,M/KPLM//LAMC $ DECOMP KPLM/L,U/-1/////S,N,SING $ IF (SING>-1) THEN $ CALL DBSTORE L,U,,,//0/LOOPCNT/BX/0 $ LOOPCNT=LOOPCNT+1 $ ENDIF $ ENDDO $ $ IF (SING>-1) THEN $ CALL DBMGR //2/0/0/0/0/0/BX/BX/BX/BX/BX $ LOOPCNT=1 $ DO WHILE (LOOPCNT<=5) $ CALL DBFETCH /FL,FU,,,/0/LOOPCNT/1/0/0 $ FBS FL,FU,B/X $ MESSAGE //’ LOOPCNT=’/LOOPCNT $ MATPRN X/ $ LOOPCNT=LOOPCNT+1 $ ENDDO $ ENDIF $ CEND TITLE=SOLVE FOR FIVE X BEGIN BULK DMI,K,..... 9-84 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DMI,B,..... DMI,M,..... DTI,LAMLST,..... ENDDATA 9.46 DBVIEW Creates a 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. Name of a data block. 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” and Remark 6. data-block where-expr 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 can be specified only 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, the view-name is considered as “not generated.” Also, if the where-expr contains a qualifier that is not in the path of the data-block, 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, the first data block stored is the one that is used. 6. The values assigned to qualifiers not specified in the where-expr are taken from current values. “AND WILDCARD” can be specified in the where-expr to indicate that unspecified qualifiers do not have to match their current values to satisfy the DBVIEW statement. NX Nastran DMAP Programmer’s Guide 9-85 Chapter 9 Descriptions of DMAP Modules and Statements 7. A comma can 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) $ 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) $ 9.47 DCMP Matrix decomposition with extended diagnostics Decompose a square matrix [A] into upper and lower triangular factors [U ] and [L] and diagonal matrix [D]. DCMP is identical to DECOMP, but also provides extended diagnostics. [A] = [L] [U] for unsymmetric [A] [A] = [L][D][L]T for symmetric [A] Format: DCMP USET,SIL,EQEXIN,A,PARTVEC,EQMAP/ LD,U,LSEQ/ 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 $ Input Data Blocks: USET SIL EQEXIN A PARTVEC Degree-of-freedom set membership table Scalar index list Equivalence between external and internal numbers A square matrix (real or complex, symmetric or unsymmetric) Partitioning vector specified when A is a partition of SETNAME. Its rowsize is indicated by SETNAME. A is the zero-th partition from PARTVEC. 9-86 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition Output Data Blocks: LD U Nonstandard lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor. [LD] also contains [D] for symmetric decomposition. Upper triangular factor or high ratios matrix. If A is unsymmetric, 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, U contains the contains the "high ratio terms of the factor diagonal ratios." See Remark 4. Resequencing matrix based on internal resequencing of A. LSEQ Parameters: KSYM Input/output-integer-default=1. 1 0 -1 3 CHOLSKY Use symmetric decomposition (default). Use unsymmetric decomposition. Use decomposition consistent with form of [A]. KSYM is reset to 0 or 1 consistent with actual decomposition type. Use symmetric partial decomposition. Input-integer-default=0. If KSYM=1 or KSYM=-1 and [A] is symmetric: 1 0 Use Cholesky decomposition. Use standard decomposition (default). If KSYM=3, CHOLSKY is set to the number of degrees of freedom in the o-set. BAILOUT Input-integer-default=0. If BAILOUT≥0, the module exits with an error message if the factor-to-diagonal ratio exceeds MAXRATIO. If BAILOUT≤-1, the module continues with a warning message if the factor-to-diagonal ratio exceeds MAXRATIO. Input-real-default=1.E5. See the BAILOUT and ERR parameter. Input-character-default=‘H’. One or two letters indicating the set membership of [A]. Input-real-default = 0.0. Tolerance for suppressing numbers of small magnitude. Matrix elements with magnitudes less than F1 are set to zero. Input-integer-default=-1. See the “DECOMP” module. MAXRATIO SETNAME F1 DECOMP NX Nastran DMAP Programmer’s Guide 9-87 Chapter 9 Descriptions of DMAP Modules and Statements DEBUG THRESH MINDIAG DET POWER SING NBRCHG ERR Input-integer-default=-1. See the “DECOMP” module. Input-integer-default=-6. See the “DECOMP” module. Output-real double precision-default=0.0D0. See the “DECOMP” module. Output-complex-default=(0.0,0.0). See the “DECOMP” module. Output-integer-default=0. See the “DECOMP” module. Output-integer-default=0. See the “DECOMP” module. Output-integer-default=0. See the “DECOMP” module. Output-integer-default=-1. If BAILOUT=-1, this parameter always remains at zero. If BAILOUT=0 and the factor-to-diagonal ratio is negative or greater than MAXRATIO, ERR is reset to -1. Input-integer-default=0. Number of Lagrange Multipliers appended to the A matrix. These rows are excluded from the internal reordering in the DCMP module. LMTROWS 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, 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 you can 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 can appear, depending on the context in which the DCMP module is being called. 9-88 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements This vector can 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. Example: Inspect the numerical conditioning of the [Mmaa] matrix. If the matrix is poorly conditioned, diagnostics are produced. DCMP USET,SIL,EQEXIN,MMAA,/LAA,UAA,/////’A’ $ DIAGONAL LAA/DLAA $ MATPRN DLAA/$ 9.48 DDR2 Computes displacements due to mode acceleration Improves accuracy of modal transient or frequency response displacements by computing displacements due to mode acceleration. Format: DDR2 USETD,UD,PD,KDD,BDD,MDD,OL,UNUSED,LLL,DM/ UD1,UE,PD1/ APP/NOUE/UNUSED1/UNUSED2 $ Input Data Blocks: USETD UD PD KDD BDD MDD OL LLL DM Degree-of-freedom set membership table for p-set Solution matrix for the d-set. Displacements only in frequency response. Displacements, velocities, and accelerations in transient response. Dynamic load matrix for the d-set Stiffness matrix for the d-set Damping matrix for the d-set Mass matrix for the d-set Transient response time output list or frequency response frequency output list Lower triangular factor/diagonal for the l-set Rigid body transformation matrix for the r-set to the l-set Output Data Blocks: UD1 UE Improved solution matrix for the d-set Improved solution matrix for the e-set (extra points) NX Nastran DMAP Programmer’s Guide 9-89 Chapter 9 Descriptions of DMAP Modules and Statements PD1 Equivalent load vector for mode acceleration computations for the a-set Parameters: APP Input-character-no default. Analysis type. ‘TRAN’: transient response ‘FREQ’: frequency response NOUE UNUSED1 UNUSED2 Input-integer-default=-1. The number of extra points. Input-integer-default=-1. Unused. Input-integer-default=-1. Unused. Remarks: 1. The solution matrix, UD1, can also be used to improve the data recovery output; such as, stress, strain, and so on. 2. USETD, UD, PD, MDD, OL, and LLL cannot be purged. 3. DM cannot 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: Equation 9-6. For a transient analysis problem {ud}, { analysis, }, and {üd} are given explicitly. For frequency response Equation 9-7. Equation 9-8. 9-90 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements where ω is the forcing frequency and {ud} is the complex response vector. ω comes from PPF. The vector {Pad} 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 provides a better answer for displacements. If extra points are present, Equation 9-9. Equation 9-10. {ue} is placed in data block UEVF. Subroutines CALCV and SSG2A perform this calculation. If supports are present, Equation 9-11. Equation 9-12. Solve for {uaa}: Equation 9-13. This is accomplished in subroutine FBSDRV. If supports are present, Equation 9-14. otherwise, {uaa} = {ual}.Subroutine SDR1B performs this calculation. If extra points are present, 9-91 NX Nastran DMAP Programmer’s Guide Chapter 9 Descriptions of DMAP Modules and Statements Equation 9-15. Note: If the problem type is transient, {uad} must be merged with { }, and {üd}. 9.49 DDR2N Computes displacements due to the new method of mode acceleration Improves accuracy of modal transient or frequency response displacements by computing displacements due to the new method of mode acceleration. Format: DDR2N UHF,KHH,BHH,MHH,PHDH,OL,CONMODS,YS, EAMACC,EAMVEL,EAMDIS,LDATTMOD,PFFTAB/ UD1/ APP $ Input Data Blocks: UHF KHH BHH MHH PHDH OL Solution matrix for the h-set. Displacements only in frequency response. Displacements, velocities, and accelerations in transient response. Stiffness matrix for the h-set Damping matrix for the h-set Mass matrix for the h-set Mode shape matrix for (d-set) – (e-set) Transient response time output list or frequency response frequency output list CONMODS Constraint modes YS EAMACC EAMVEL EAMDIS Enforced motion Equivalent mass attachment modes Equivalent viscous damping attachment modes Equivalent structural damping attachment modes LDATTMOD Load attachment modes 9-92 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements PFFTAB Table values for applied loads Output Data Blocks: UD1 Solution matrix for the d-set Parameters: APP Input-character-no default. Analysis type. ‘TRAN’: transient response ‘FREQ’: frequency response Remarks: 1. The solution matrix, UD1, may be used to improve the data recovery output; such as, stress, strain, and so on. 2. UHF, KHH, MHH, PHDH and OL cannot be purged. 3. CONMODS and YS cannot be purged if enforced motion exists. Method: The dynamic equations of motion can be written as Equation 9-16. where = mass, viscous damping, stiffness, and structural damping matrices. uf = absolute displacements of the f-set dof = effective external forces in which Pf = loads applied to the f-set dof us = enforced motion applied to the s-set dof The displacements can be calculated by rewriting equation 9-16 into the following format: Equation 9-17. Velocities and accelerations are still recovered directly from the normal modes responses as: NX Nastran DMAP Programmer’s Guide 9-93 Chapter 9 Descriptions of DMAP Modules and Statements Equation 9-18. Equation 9-19. where = matrix of normal modes = matrix of constraint modes of enforced motion dof = = vector of modal velocities = vector of modal accelerations Substituting equations 9-18 and 9-19 into equations 9-17, displacements can be calculated by: Equation 9-20. where = = = = = = = matrix of attachment modes due to applied forces = matrix of equivalent mass attachment modes matrix of equivalent viscous damping attachment modes matrix of equivalent structural damping attachment modes Ω= = m= c= diagonal matrix of m-th natural frequency (in general, not diagonal) = (in general, not diagonal) 9-94 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements If rigid body modes exist, the responses can be calculated by including the rigid body motion term where into equation 9-20, = matrix of rigid body modes = modal displacements of rigid body modes. 9.50 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,IUG1,IQG1,IES1,IEF1/ OUG,OQG,OES,OEF,UNUSED5/ OPTION/NOCOMP/PEXIST/ACOUSTIC/ACOUT/PREFDB/SEID $ Input Data Blocks: CASECC EST UH Table of Case Control command images Element summary table Solution matrix for the h-set (modal degrees-of-freedom). Modal displacements only in frequency response. Modal displacements, velocities, and accelerations in transient response. Transient response time output list or frequency response frequency output list Table of displacements due to unit modal displacement in SORT1 or SORT2 format Table of single point forces of constraint due to unit modal displacement in SORT1 or SORT2 format Table of element stresses or strains due to unit modal displacement in SORT1 or SORT2 format. For strains, NOCOMP must be set to 3. Table of element forces due to unit modal displacement in SORT1 or SORT2 format. Table of x-y plotting commands Table of displacements due to unit modal displacement in SORT1. Required only for the sparse data recovery in SORT2 format. OL IUG IQG IES IEF XYCDB IUG1 NX Nastran DMAP Programmer’s Guide 9-95 Chapter 9 Descriptions of DMAP Modules and Statements IQG1 IES1 IEF1 Table of single point forces of constraint due to unit modal displacement in SORT1 format. Required only for the sparse data recovery in SORT2 format. Table of element stresses or strains due to unit modal displacement in SORT1 format. Required only for the sparse data recovery in SORT2 format. Table of element forces due to unit modal displacement in SORT1 format. Required only for the sparse data recovery in SORT2 format. Output Data Blocks: OUG OQG OES OEF UNUSED5 Table of displacements in SORT1 or SORT2 format Table of single point forces of constraint SORT1 or SORT2 format Table of element stresses or strains in SORT1 or SORT2 format Table of element forces in SORT1 or SORT2 format Unused and can be purged Parameters: OPTION Input-character-default=‘ABS’ Response summation method for scaled response spectra analysis only. Possible values are: ‘ABS’ ‘SRSS’ ‘NRL’ ‘NRLO’ NOCOMP ACOUSTIC PEXIST Absolute Square root of the sum of the squares Naval Research Laboratory (new) Naval Research Laboratory (old) Input-integer-default=0. Set to 3 if IES is element strains. Input-integer-default=0. Fluid-structure analysis flag. Input-logical-default=FALSE. Set to TRUE if p-elements are present. 0 1 2 No fluid elements exist. Penalty or fluid acoustic elements exists. Fluid/structure coupling exists. ACOUT Input-character-default=‘PEAK’ Type of acoustic pressure output in fluid-structural analysis. ‘RMS’ ‘PEAK’ Root-mean-square Peak 9-96 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements PREFDB SEID Input-real-default=1.0. Peak pressure reference for pressure level in units of dB or dBA. Input-integer-default=0. Superelement identification number. Remarks: 1. If UD is a real matrix and OL is purged, 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). 9.51 DECOMP Matrix decomposition To decompose a square matrix [A] into upper and lower triangular factors [U] and [L] and diagonal matrix [D]. Format: DECOMP A/LD,U,LSEQ/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 $ Input Data Block: A Square matrix (real or complex; symmetric, or unsymmetric, or indefinite symmetric). Output Data Blocks: LD U LSEQ Lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor. [LD] also contains [D] for symmetric decomposition. Upper triangular factor or trapezoidal factor for partial decomposition. (See Remark 4.) Resequencing matrix based on internal resequencing of A. NX Nastran DMAP Programmer’s Guide 9-97 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: KSYM Input/output-integer-default=-1. 1 0 -1 3 CHOLSKY Use standard decomposition. Use unsymmetric decomposition. Use decomposition consistent with form of [A]. KSYM is reset to 0 or 1 consistent with actual decomposition type (default). Use symmetric partial decomposition. Sparse method is not available with partial decomposition. Input-integer-default=0. If KSYM = 1 or KSYM = -1 and [A] is symmetric: 1 0 Use Cholesky decomposition. Use standard decomposition (default). If KSYM = 3, CHOLSKY is set to the number of degrees of freedom in the o-set. MINDIAG DET Output-real double precision-default = 0.0D0. The norm of the minimum diagonal term of [U]. Output-complex single precision-default=(0.0,0.0). The scaled value of the determinant of [A]. See the POWER parameter. DET is not applicable to sparse methods. See Remark 1. Output-integer-default=0. Integer POWER of 10 by which DET should be multiplied to obtain the determinant of [A]. In other words, the determinant of [A] is equal to DET*10POWER. POWER is not applicable to sparse methods. See Remark 1. Output-integer-default=0. SING is set to -1 if [A] is singular. See Remark 3. Output (for symmetric decomposition only)-integer-default=0. NBRCHG is the number of negative terms on the diagonal. Output (for symmetric decomposition only)-real-default=0.0. MAXRAT is the maximum value of the ratio of the matrix diagonal to the factor diagonal. Input-integer-default=-1. Controls operation of module for exceptional conditions as defined in the following table. If DECOMP > 0, DECOMP overrides the value specified on NASTRAN SYSTEM(69) statement. DECOMP 0 or -1 1 Action Print up to 50 messages for null columns and zero diagonals (non-sparse method only). Terminate execution when first null column is encountered. POWER SING NBRCHG MAXRAT DECOMP 9-98 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2 4 8 16 32 64 DEBUG Suppress printing of message when a null column is encountered (non-sparse method only). Terminate execution when first zero diagonal term is encountered. Suppress printing of message when a zero diagonal term is encountered (non-sparse method only). Place 1.0 in diagonal position for all null columns and proceed with the decomposition. Stop the decomposition when zero diagonal terms are encountered. Exit after execution of preface for symmetric decomposition. Input-integer-default=-1. Passive column logic control. DEBUG is used only by non-sparse method. See the NX Nastran Numerical Methods User’s Guide and Remark 8. Input-integer-default=-6. Power of 10 defining the pivoting threshold for unsymmetric decomposition. Row pivoting is done if any value on the factor diagonal is less than 10THRESH. UGS recommends using THRESH = -2 for indefinite matrices because accuracy is improved even though execution time is increased. THRESH Remarks: 1. By default, the DECOMP module uses sparse matrix methods. See the NX 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; that is, the parameter CHOLSKY = 1 is ignored. d. NASTRAN statement system cell 166 selects options for the sparse method. 0 1 2 4 No action If insufficient core is encountered, switch to conventional decomposition and continue (default) Print diagnostics Do not issue fatal message if maximum ratios are exceeded. The maximum ratios are replaced by 1.0. NX Nastran DMAP Programmer’s Guide 9-99 Chapter 9 Descriptions of DMAP Modules and Statements 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, SING is set to one if unit values are placed on the diagonal. 4. if KSYM = 3, the [A] matrix is decomposed through the first n degrees of freedom, where n is the value provided by the CHOLSKY parameter. The resulting trapezoidal factor is output as [L] and the remaining undecomposed partition of the [A] matrix, with contributions from the first n degrees of freedom added, is output as [U ]. 5. Cholesky factors (matrix form 10) can be used for all standard matrix operations; for example, ADD, MPYAD, and so on. 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 has the following forms in the matrix trailer: Form 4 5 10 11 13 15 Factor type Lower triangle Upper triangle Cholesky Trapezoidal Lower triangular Lower or upper triangular Matrix type Symmetric or unsymmetric Unsymmetric only Symmetric only Symmetric only Sparse symmetric Sparse unsymmetric 7. In decomposing symmetric matrices, [A] = [L] [D] [L]T, the diagonal factor [D] is stored in the diagonal of the [LD] matrix output. The [U ] = [L]T factor is not output for this case. 8. Matrices with zero diagonal terms can 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, UGS also recommends that the SEQP module be used with parameter NEWSEQ = 2. Examples: 1. Solve [A][X] = [B]. DECOMP FBS MATPRN A/L,U,/ $ L,U,B/X/ $ X// $ 2. Form [K] = [G]T[A][G]. Then decompose [K] into [L] [L]T assuming that [K] is a symmetric matrix. SMPYAD DECOMP G,A,G,,,/K/3////1////6 $ K/L,,/ $ 9-100 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 3. Calculate following: • • • using partial decomposition, form [Loo] given the NOOSET integer parameter defining the size of [Koo]. NOASET integer parameter defining the size of [Kaa] and [Koa]. NOFSET = NOOSET + NOASET $ FORM PARTITIONING VECTOR MATGEN ,/VFOX/6/NOFSET/NOOSET/NOASET $ $ MERGE O-SET AND A-SET WITH A-SET LAST MERGE KOO,KAO,KOA,KAAB,VFOX,/KFFX/-1/0/6 $ $ PARTIALLY DECOMPOSE KFFX DECOMP KFFX/LFO,KAA,/3/NOOSET $ PARTN LFO, ,VFOX/LOO, LAO, ,/1 $ 9.52 DELETE Deletes data blocks Format: DELETE /DB1,DB2,DB3,DB4,DB5 $ Input Data Blocks: None. Output Data Blocks: DBi Any table or matrix. Parameters: None. Remarks: 1. Any or all data blocks can be purged. 2. The output from previous module rule does not apply. Example: DELETE /A,B,C,, $ 9.53 DIAGONAL Extracts diagonal from matrix or raises matrix to a power NX Nastran DMAP Programmer’s Guide 9-101 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Block: A Square or diagonal matrix (real or complex) if OPT ≠ ‘WHOLE’ orrectangular (real or complex) matrix if OPT = ’WHOLE’ Output Data Block: B Real vector (column matrix) or a rectangular matrix containing the terms of A raised to a power Parameters: OPT Input-character-default=‘COLUMN’ Type of matrix output. ’COLUMN’ Extract the diagonal elements of square matrix A into vector B (if A is complex, only the real part is extracted) and raise the elements to the exponent POWER. Extract the diagonal elements of square matrix A into diagonal matrix B (if A is complex, extract only the real part) and raise the elements to the exponent POWER. Copy rectangular matrix A into rectangular matrix B and raise the elements to the exponent POWER. If A is complex and POWER<>1.0, extract only the real part. However, if POWER=1.0, B contains the magnitude of the elements. ‘SQUARE’ ’WHOLE’ POWER Input-real single precision-default=1. Exponent to which the real part of each element is raised. See Remarks. Remarks: 1. OPT = ’COLUMN’ or ’SQUARE’ provides exactly the same functions, except that the output using COLUMN is a vector, and the output using SQUARE is a square diagonal matrix. Both options process only the real part of the diagonal terms of the input matrix. If POWER = 0, unit column or the identity matrix of the dimension of the input matrix is produced. This is an efficient method for producing these useful DMAP tools. OPT = ’WHOLE’ operates on all terms of the input matrix to produce an output matrix of the same dimension. Sparse factor matrices (form = 11, 13, or 15) are not supported with OPT = ’WHOLE’. Each term is processed independently. 9-102 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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, all nonzero terms of [A] produce unit terms in [B]. Zero terms in [A] produces zero terms in [B]. This is a means for producing Boolean matrices. [A] can be either real or complex. If POWER = 1.0, [B] is a real matrix with terms that are the absolute value of the terms of [A]. If [A] is complex, [B] contains the magnitude of the terms of [A]. 3. For fractional values of POWER and OPT = ’WHOLE’, all elements must be nonnegative. For OPT = ’COLUMN’ or ’SQUARE’ all diagonal elements must be nonnegative. 4. For whole number values of POWER, only real [A] matrices are allowed. The sign of the terms of [A] are properly preserved. 5. If an illegal operation is requested, a warning message is produced, and [B] is purged. Examples: 1. Extract the diagonal terms from LOO and KOO, form the ratio of factor diagonal to diagonal terms, and print terms less than 10-3. DIAGONAL DIAGONAL ADD MATMOD ADD MATGPR LOO/LOOD/’COLUMN’/1. $ KOO/KOOD $ LOOD,KOOD/LOVERK///2 $ LOVERK,,,,/BIGLOVRK,/2////1.E-3 $ LOVERK,BIGLOVRK/DIFF//-1.0 $ BGPDT,USET,,DIFF//’H’/’O’ $ 2. Obtain the absolute value of a matrix [A] DIAGONAL A/AA/’WHOLE’ $. 9.54 DISDCMP 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 $ Input Data Blocks: USET SIL Degree-of-freedom set membership table Scalar index list NX Nastran DMAP Programmer’s Guide 9-103 Chapter 9 Descriptions of DMAP Modules and Statements EQEXIN SCHUR Unused5 EQMAP Equivalence between external and internal numbers Local Schur complement matrix in sparse factor format Unused and can be purged Table of degree-of-freedom global-to-local maps for domain decomposition Output Data Blocks: LBB DSFDSC SCHURS Distributed boundary matrix factor in sparse factor format (contains the local panels of the fronts). Distributed boundary matrix factor. Sum of all SCHUR matrices from all processors. Parameters: HLPMETH Input-integer-default=1. Processing option. >0 =0 Unused2 Unused3 Unused4 Unused5 Unused6 Unused7 Unused8 Unused9 Unused10 Unused11 Unused12 Unused13 Unused14 Unused15 Summation ONLY. Complete boundary decomposition (default). Input-integer-default=0. Unused and can be left unspecified. Input-integer-default=0. Unused and can be left unspecified. Input-real-default=1.E5. Unused and can be left unspecified. Input-character-default=‘H’ Unused and can be left unspecified. Input-real-default=0.0. Unused and can be left unspecified. Input-integer-default=-1. Unused and can be left unspecified. Input-integer-default=-1. Unused and can be left unspecified. Input-integer-default=-6. Unused and can be left unspecified. Input-real double precision-default=0.D0. Unused and can be left unspecified. Output-complex-default=(0.0,0.0). Unused and can be left unspecified. Input-integer-default=0. Unused and can be left unspecified. Input-integer-default=0. Unused and can be left unspecified. Input-integer-default=0. Unused and can be left unspecified. Input-integer-default=-1. Unused and can be left unspecified. 9-104 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.55 DISFBS Performs distributed forward-backward substitution Format: DISFBS LBB,DSFDSC,EQMAP,UABAR/ UA,PABAR,LOO/ HLPMETH $ Input Data Blocks: LBB DSFDSC EQMAP UABAR Distributed boundary sparse factor matrix (contains the local panels of the fronts) Table description of boundary sparse factor matrix Table of degree-of-freedom global-to-local maps for domain decomposition Local updated rectangular ("loads") matrix Output Data Blocks: UA PABAR LOO Global boundary solution for distributed decomposition Summed up updated rectangular ("loads") matrix for distributed decomposition Merged boundary sparse factor matrix for distributed decomposition Parameters: HLPMETH Input-integer-default=0. Processing option. >0 0 4 Summation only Complete distributed forward-backward substitution (default) Summation operation and merging of distributed sparse boundary factor matrix Remarks: LBB and DSFDSC can be purged. 9.56 DISOFPM Collects and merges OFP data blocks Collects and merges OFP data blocks from the slave processors to the master processor. NX Nastran DMAP Programmer’s Guide 9-105 Chapter 9 Descriptions of DMAP Modules and Statements Format: DISOFPM OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8/ OFP1M,OFP2M,OFP3M,OFP4M,OFP5M,OFP6M,OFP7M,OFP8M/ MAXBUFF $ Input Data Blocks: OFPi OFP tables in SORT1 (or SORT2) format Output Data Blocks: OFPiM Merged OFP tables in SORT1 (or SORT2) format Parameters: MAXBUFF Input-integer-default=250000. Maximum buffer size in words given to each processor for the merging process. 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; for example, if the element stress OFP data block appears in the first input of the second call to DISOFPS, the element stress data block must also appear in the first input and output of the second call to DISOFPM. 9.57 DISOFPS Send OFP data blocks Send OFP data blocks from the slave processors to the master processor. Format: DISOFPS OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8 $ Input Data Blocks: OFPi OFP tables in SORT1 (or SORT2) format Output Data Blocks: None. 9-106 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: None. Remarks: 1. OFPi can be purged. However if OFPi is not purged, 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; for example, if the element stress OFP data block appears in the first input of the second call to DISOFPS, the element stress data block must also appear in the first input and output of the second call to DISOFPM. 9.58 DISOPT Performs appropriate discrete optimization problems Performs the approximate discrete optimization problem using design variables, constraints, responses, and 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/ XO,CVALO,R1VALO,R2VALO,PROPO, R3VALO/ OBJIN/S,N,OBJOUT/PROTYP/UNUSED4/UNUSED5/ UNUSED6/UNUSED7/UNUSED8/UNUSED9/UNUSED10/ UNUSED11/UNUSED12/UNUSED13 $ Input Data Blocks: XINIT DESTAB CONSBL* DPLDXI* XZ DXDXI DPLDXT* Matrix of initial values of the design variables Table of design variable attributes Matrix family of constant property values Matrix family of coefficients in the property to independent design variable relationship Matrix containing the constant portion of the dependent to independent design variable linking relationship Matrix relating linked and independent design variables Matrix family of transpose of DPLDXI. NX Nastran DMAP Programmer’s Guide 9-107 Chapter 9 Descriptions of DMAP Modules and Statements 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 Table of DEQATN Bulk Data entry images Index table to DEQATN data block Matrix transponse of DXDXI Table family of type two properties on DVPREL2 Bulk Data entries Table of optimization parameters Matrix initial values of the retained first level responses Table of attributes of the retained second level responses Table of attributes of the retained first level responses Table of retained constraint attributes Unnormalized design sensitivity matrix Table family of attributes of the designed properties by internal property identification number order Matrix family of initial property values Matrix transpose of relationship between dependent and independent design variables Design objective table. Objective attributes with retained response identification number. Updated (optimized) Table of designed coordinate values Matrix of constants that relates design variables and design coordinates. Matrix of basis vectors – coefficients relating designed grid coordinates and design variables Matrix of coefficients in the grid to independent design variable relationship Table of unique design variable identification numbers Table family of designed property attributes Table of designed beam library data Table of constant terms in the beam section constraint relationship Matrix relating beam library constraints to the independent design variables Matrix transpose of BCONXI Table of designed node list 9-108 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements RR2IDRG RESP3RG DISTAB Table of retained referenced type two response identification list Table of retained third level responses in RESP3 tabl Table of discrete optimization value sets Output Data Blocks: XO CVALO R1VALO R2VALO PROPO R3VALO Matrix of final (optimized) values of the design variables Matrix of final (optimized) constraint values Matrix of final (optimized) values of the retained first level responses Matrix of final (optimized) values of the second level responses Matrix of final (optimized) property values Matrix of final (optimized) values of the third level responses Parameters: OBJIN OBJOUT PROTYP UNUSEDi Input-real-no default. Initial objective value. Output-real-no default. Final objective value. Input-integer-default=0. Designed property type code. Input-integer-default=0. Unused. Remarks: None. 9.59 DISUTIL Broadcast data blocks between slave and master processors Broadcast data blocks between master and slave processors for parallel processing. Additional processing can 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 $ Format for DISMETH=3 on master processor: NX Nastran DMAP Programmer’s Guide 9-109 Chapter 9 Descriptions of DMAP Modules and Statements DISUTIL DB,,,////3 $ Format for DISMETH=3 on slave processor: DISUTIL ,,,,/DB///3 $ Format for DISMETH=4 or 5: DISUTIL RESMAX,RESMAX0,CASECC,HEADCNTL////4 or 5 $ Format for DISMETH=6: DISUTIL UG,SPCPART,,EQMAP/UGG///6 $ Format for DISMETH=7: DISUTIL PG,SPCPART,,EQMAP/PGG///7 $ Format for DISMETH=8 or 9 on master processor: DISUTIL MATS,,,////-8, 8, or 9 $ Format for DISMETH=8 or 9 on slave processor: DISUTIL MATS,,,////-8, 8, or 9 $ Input Data Blocks: B X R EQMAP DB RESMAX RESMAX0 CASECC HEADCNTL UG Rectangular matrix which is the local load vector (with local values in local a-set) Solution of the equation [A][X]=[B] which is the local solution matrix (with global values in local a-set) Residual matrix which is local (with local or global values in local a-set) Table of degree-of-freedom global-to-local maps for domain decomposition Any data block to be broadcast from the master to the slave processors Resultant or maxima matrix Resultant or maxima matrix for residual structure Table of Case Control command images List of integer codes for header print control Displacement matrix in g-set for the current processor (local) 9-110 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SPCPART GEQMAP MATS Partitioning vector for domain decomposition Table of grid based local equation map indicating which grid resides on which processors/partitions for domain decomposition Any matrix on slave processors Output Data Blocks: EPSSE UGG PGG DB MATM Table of epsilon and external work Displacement matrix in g-set for all processors (global) Force matrix in g-set for all processors (global) Any data block to be broadcast from the master to the slave processors Any matrix on master processor Parameters: NSKIP EPSI DISMETH Input-integer-default=1. Record number in CASECC corresponding to the first subcase of the current boundary condition. Output-integer-default=1. Static solution error ratio flag. Set to -1 if the error ratio is greater than 1.E-3. Input-integer-default=1. Method. 1 Compute epsilons and external works assuming a-set components of RUF are local values (which occurs in a direct solution). Compute epsilons and external works assuming a-set components of RUF are global values (which occurs in a in iterative solution). Broadcast table or matrix from master to slaves. Broadcast VECPLOT resultant output from slaves to master and combine on master. Broadcast VECPLOT maxima output from slaves to master and combine on master. Broadcast displacement matrices from slaves to master and merge into global displacement matrix on master. Broadcast force matrices from slaves to master and add/merge into global force matrix on master. 2 3 4 5 6 7 NX Nastran DMAP Programmer’s Guide 9-111 Chapter 9 Descriptions of DMAP Modules and Statements 8, -8 Broadcast any matrix from slaves to master and add all matrices on master. UGS recommends DISMETH=8 for dense matrices and -8 for sparse matrices. Broadcast any matrix from slaves to master and append columnwise all matrices on master. 9 Remarks: 1. All executions of DISUTIL must be synchronized across all processors. 2. EPSSE can be purged. EPSSE contains: a. Sequential number of subcases b. Superelement (domain) identification number c. Epsilon error ratio d. Strain energy (external work) 3. RESMAX0 can be purged on the slave processors. 4. UGG cannot be purged on the master processors. 5. For DISMETH=8 or 9, MATS and MATM must be in machine precision. 9.60 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 $ Input Data Blocks: CLAMA DYNAMIC CASEA EDT Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk Data entries. Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk Data entries. A single record (subcase) of CASECC for aerodynamic analysis. Specifies the DIVERG and CMETHOD command set identification numbers. Table of Bulk Data entry images related to aerostatic and divergence analysis. 9-112 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CPHL LCPHL Complex eigenvector matrix in the l-set Left-handed complex eigenvector matrix in the l-set Output Data Blocks: DIVDAT DCPHL DLCPHL Table of divergence data. Complex eigenvectors associated with the divergence eigenvalues extracted from the real part of eigenvectors associated with the divergence eigenvalues. Left-handed complex eigenvectors associated with the divergence eigenvalues extracted from the real part of left-handed eigenvectors associated with the divergence eigenvalues. Parameters: IMACHNO LPRINT Input-integer-no default. Mach number multiplied by 1000 and specified as an integer. Input-logical-default=TRUE. Print flag for divergence analysis. Remarks: 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 DIVERG DIVDTX=APPEND/PHIDRX=APPEND/PHIDLX=APPEND $ 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 9.61 DMIIN Inputs DMI entries to DMAP Input matrices referenced on DMI Bulk Data entries. Format: DMIIN DMI,DMINDX/DMI1,DMI2,DMI3,DMI4,DMI5,DMI6,DMI7, DMI8,DMI9,DMI10/PARM1/PARM2/PARM3/PARM4/PARM5/ PARM6/PARM7/PARM8/PARM9/PARM10 $ NX Nastran DMAP Programmer’s Guide 9-113 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: DMI DMINDX Table of all matrices specified on DMI Bulk Data entries Index into DMI Output Data Blocks: DMIi Matrix data blocks with names that appear in field 2 of the DMI entries (for example, the DMI matrix called DMI1 is output on data block DMI1). See Remark 3. Parameters: PARMi Output-logical-default = FALSE. If the i-th output data block is generated, PARMi=TRUE. Remarks: 1. The input data blocks DMI and DMINDX are output from the preface module IFP. 2. Any output data block can 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, 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 creates the data blocks A and C. Matrix B is ignored. DMIIN DMI,DMINDX/A,C,,,,,,,,/S,N,YESA/S,N,YESC $ 9.62 DOM10 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// DESCYCLE/DESMAX/OBJIN/OBJOUT/EIGNFREQ/PROTYP/ RESTYP $ 9-114 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: DESTAB XINIT XO CNTABRG CVALRG CVALO DVPTAB* PROPI* PROPO* R1TABRG R1VALRG R1VALO RSP2RG R2VALRG R2VALO OPTPRMG OBJTBG DRSTBLG TOL1 FOL1 FRQRPRG DBMLIB BCON0 Table of design variable attributes Matrix of initial values of the design variable Matrix of final (optimized) values of the design variables Table of retained constraint attributes Matrix of initial constraint values Matrix of final (optimized) constraint values. Family of tables of attributes of the designed properties by internal property identification number order Family of matrices of initial property values Family of matrices of final (optimized) property values Table of attributes of the retained first level responses Matrix of initial values of the retained first level responses Matrix of final (optimized) values of the retained first level responses Table of attributes of the retained second level responses Matrix of initial values of the retained second level responses Matrix of final values of the second level responses Table of optimization parameters Design objective table. Objective attributes with retained response identification number. Table containing the number of retained responses for each subcase for each of the response types Transient response time output list truncated by the OTIME Case Control command Frequency response frequency output list truncated by the OFREQ Case Control command Table containing the number of first level retained responses per response type and per frequency or time step Table of designed beam library data Table of constant terms in the beam section constraint relationship NX Nastran DMAP Programmer’s Guide 9-115 Chapter 9 Descriptions of DMAP Modules and Statements BCONXI WMID RSP3RG R3VALRG R3VALO Matrix relating beam library constraints to the independent design variables Table of weight as a function of material identification number Table of attributes of the retained third level responses Matrix of initial values of the retained third level responses Matrix of final values of the third level responses Output Data Blocks: None. Parameters: DESCYCLE Input-integer-default=0. Design cycle analysis counter or flag. -1 -2 >0 DESMAX OBJIN OBJOUT EIGNFREQ Initial execution of DOM10 Final execution of DOM10 Design cycle number Input-integer-default=0. Maximum allowed design optimization iteration number. Input-real-default=0.0. Initial objective value. Input-real-default=0.0. Final objective value. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 Eigenvalue (radian/time) Frequency (cycle/time) PROTYP Input-integer-default=0. Designed property type code. 1 2 4 >0 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values RESTYP Input-integer-default=0. Optimization results flag. 0 1 Approximate model Exact analysis for fully stessed design optimization 9-116 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ 9.63 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/ EPTN,COORDN,GEOM1N,GEOM2N,MPTN/ DESCYCLE/PROTYP $ Input Data Blocks: EPT EPTTAB* PROPO* XO DESTAB CSTM BGPDT Table of Bulk Data entry images related to element properties Family of tables of designed property attributes Family of matrices of final (optimized) property values Matrix of final (optimized) values of the design variables Table of design variable attributes Table of coordinate system transformation matrices Basic grid point definition table NX Nastran DMAP Programmer’s Guide 9-117 Chapter 9 Descriptions of DMAP Modules and Statements DESGID COORDO CON SHPVEC GEOM1 GEOM2 MPT DMATCK Table of designed grid coordinate attributes Table of designed coordinate values Matrix of constants that relates design variables and design coordinates Matrix of basis vectors – coefficients relating designed grid coordinates and design variables Table of Bulk Data entry images related to geometry. Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to material properties Table of designed material consistency check Output Data Blocks: EPTN COORDN GEOM1N GEOM2N MPTN Updated (optimized) EPT Updated (optimized) COORDO Updated (optimized) GEOM1 Updated (optimized) GEOM2 Updated (optimized) MPT Parameters: DESCYCLE PROTYP Input-integer-default=0. Design cycle analysis counter. Input-integer-default=0. Designed property type code. 1 2 4 >0 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values 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. 9-118 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ 9.64 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, EPTTAB*,DVPTAB*,XVALP,GEOM1P, R1TABRG,R1VALRG,RSP2RG,R2VALRG,PCOMPT/ HISADD,OPTNEW,DBCOPT,DESNEW/ DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/CVTYP/OPTEXIT/ DESMAX/MDTRKFLG/DESPCH/DESPCH1/MODETRAK/ EIGNFREQ/DSAPRT/PROTYP/BADMESH/XYUNIT/FSDCYC $ Input Data Blocks: XINIT XO CVAL PROPI* PROPO* OPTPRM HIS DESTAB GEOM1N Matrix of initial values of the design variables Matrix of final (optimized) values of the design variables Matrix of constraint values, CVALO or CVALRG Family of matrices of initial property values Family of matrices of final (optimized) property values Table of optimization parameters Table of design iteration history Table of design variable attributes Updated (optimized) Table of Bulk Data entry images related to geometry NX Nastran DMAP Programmer’s Guide 9-119 Chapter 9 Descriptions of DMAP Modules and Statements COORDO EDOM MTRAK EPT GEOM2 MPT EPTTAB* DVPTAB* XVALP GEOM1P R1TABRG R1VALRG RSP2RG R2VALRG PCOMPT Matrix of designed coordinate values Table of Bulk Data entries related to design sensitivity and optimization Table of updated DRESP1 Bulk Data entry images corresponding to the new mode numbering Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to material properties Family of tables of designed property attributes Family of tables of attributes of the designed properties by internal property identification number order XVAL table from previous iteration GEOM1 table from previous design iteration Table of attributes of the retained first level responses Matrix of initial values of the retained first level responses Table of attributes of the retained second level responses Matrix of initial values of the retained second level responses Table containing LAM option input and expanded information from the PCOMP Bulk Data entry Output Data Blocks: HISADD OPTNEW DBCOPT DESNEW Table of design iteration history for current design cycle Updated table of optimization parameters Design optimization history table for post-processing Update table of design variable attributes Parameters: DESCYCLE OBJIN OBJOUT Input-integer-default=0. Design cycle analysis counter. Input-real-default=0.0. Initial objective value. Input-real-default=0.0. Final objective value. 9-120 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CNVFLG Output-integer-default=0. Design optimization convergence flag. 0 1 2 No convergence is achieved. Soft convergence is achieved. Hard convergence is achieved. CVTYP Input-integer-default=0. Type of convergence test. 1 2 3 Soft convergence is to be checked. Hard convergence is to be checked. Final iteration histories are to be printed. OPTEXIT DESMAX MDTRKFLG Input-integer-default=0. Design optimization termination option. See OPTEXIT description in the NX Nastran Quick Reference Guide. Input-integer-default=0. Maximum allowed design optimization iteration number. Input-integer-default=0. Mode tracking status flag. 0 1 Mode tracking was successful. Mode tracking was unsuccessful. DESPCH Input-integer-default=0. Punch control for updated DESVAR, DREPS1 and GRID Bulk Data entries. See DESPCH description in the NX Nastran Quick Reference Guide. Input-integer-default=6. Punch output type flag. 0 1 2 None Designed analysis property entries All of the entries of the type as long as at least one property entry is designed for the type 4 Design model entries. DESPCH1 <>0 For combinations, sum above values. >0 <0 MODETRAK Indicates large field format Indicates small field format Input-integer-default=0. Mode tracking request flag. 0 Mode tracking was not requested. NX Nastran DMAP Programmer’s Guide 9-121 Chapter 9 Descriptions of DMAP Modules and Statements >0 EIGNFREQ Mode tracking is requested. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 Eigenvalue (radian/time) Frequency (cycle/time) DSAPRT PROTYP Input-logical-default=FALSE. DSAPRT Case Control command print flag. Input-integer-default=0. Designed property type code. 1 2 4 >0 DVPRELi entries exist. DVCRELi entries exist. DVMRELi entries exist. For combinations, add above values BADMESH XYUNIT FSDCYC Input-logical-default=FALSE. Bad geometry was detected. Input-integer-default=0. Fortran unit number to which the DOM12 Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this is a fully stressed design cycle. Examples: 1. Excerpt from subDMAP DESOPT following hard convergence: DBVIEW XPREV=XINIT DBVIEW PROPPV=PROPI DBVIEW HISPV=HIS (WHERE DESITER=DESCYCLP) $ (WHERE DESITER=DESCYCLP AND DPTYPE=*) $ (WHERE DESITER=DESCYCLP) $ DOM12 XPREV,XINIT,CVALRG,PROPPV,PROPIF,OPTPRMG, HISPV,DESTAB,,,EDOM,MTRAK,EPT,GEOM2,MPT, EPTTABF,DVPTABF,,/ HISADD,NEWPRM,,NEWDES/ DESCYCLE/OBJPV/OBJIN/S,N,CNVFLG/2/OPTEXIT// MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ/ DSAPRT/PROTYP $ APPEND HISADD,/HISX/2 $ EQUIVX HISX/HIS/-1 $ DBSTATUS NEWPRM,NEWDES//S,N,NONEWP/S,N,NONEWD $ IF ( NONEWP>0 ) EQUIVX NEWPRM/OPTPRMG/-1 $ IF ( NONEWD>0 ) EQUIVX NEWDES/DESTAB/-1 $ 2. Excerpt from subDMAP DESOPT following soft convergence: DBVIEW DBVIEW DBVIEW DBVIEW PROPIF =PROPI PROPOF=PROPO EPTTABF =EPTTAB DVPTABF =DVPTAB WHERE (DPTYPE=*) $ (WHERE DPTYPE = *) WHERE (DPTYPE=*) $ WHERE (DPTYPE=*) $ 9-122 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DOM12 XINIT,XO,CVALO,PROPIF,PROPOF,OPTPRMG,HIS,DESTAB, GEOM1N,COORDO,,,EPT,GEOM2,MPT,EPTTABF,DVPTABF,,/ HISADD,NEWPRM,,NEWDES/ DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/1/OPTEXIT// MDTRKFLG/DESPCH/DESPCH1/MODETRAK/EIGNFREQ//PROTYP $ APPEND HISADD,/HISX/2 $ EQUIVX HISX/HIS/-1 $ 3. Excerpt from subDMAP EXITOPT for termination: IF ( CNVFLG>0 OR DESCYCL1=DESMAX OR OPTEXIT>3 OR DSPRINT OR DSUNFORM OR DSEXPORT OR MODETRAK>0 OR BADMESH ) DOM12, ,XVAL,,,PROPOF,,HIS,DESTAB,GEOM1,COORDO,EDOM,MTRAK, EPT,GEOM2,MPT,EPTTABF,DVPTABF,XVALP,GEOM1P/ ,,DBCOPT,/ DESCYCL1///CNVFLG/3/OPTEXIT/DESMAX/MDTRKFLG/ DESPCH/DESPCH1/MODETRAK/EIGNFREQ/DSAPRT/PROTYP/ BADMESH/XYUNIT $ 9.65 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/ DSCM2/ PROTYP/UNUSED2/UNUSED3/UNUSED4/UNUSED5/UNUSED6/ UNUSED7/UNUSED8/UNUSED9/UNUSED10/UNUSED11/UNUSED12 $ Input Data Blocks: XINIT DPLDXI* CONSBL* R1VALRG R2VALRG DSCMG RSP2RG DEQATN Matrix of initial values of the design variable Family of matrices of coefficients in the property to independent design variable relationship Family of matrices of constant property values Matrix of initial values of the retained first level responses Matrix of initial values of the retained second level responses Unnormalized design sensitivity matrix Table of attributes of the retained second level responses Table of DEQATN Bulk Data entry images. NX Nastran DMAP Programmer’s Guide 9-123 Chapter 9 Descriptions of DMAP Modules and Statements PLIST2* DEQIND DXDXIT DCLDXT COORD DESTAB DVPTAB* TABDEQ EPTTAB* DBMLIB DPLDXT* DNODEL RR2IDR RSP3RG R3VALRG Family of tables of type two properties on DVPREL2 Bulk Data entries Index table to DEQATN data block. Matrix of coefficients in the design variable linking relationship Matrix of coefficients in the grid to design variable relationship Matrix of initial or final designed coordinate values, COORDO or COORDN Table of design variable attributes Family of tables of attributes of the designed properties by internal property identification number order Table of unique design variable identification numbers Family of tables of designed property attributes Table of designed beam library data Family of matrix transposes of DPLDXI Table of designed and non-designed locations Table of retained referenced type two response identification list Table of attributes of the retained third level responses Matrix of initial values of the retained third level responses Output Data Blocks: DSCM2 Normalized design sensitivity coefficient matrix Parameters: PROTYP Input-integer-default=0. Designed property type code. 1 2 4 >0 UNUSEDi DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values Input-integer-default=0. Unused. 9-124 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.66 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/ XO,CVALO,R1VALO,R2VALO,PROPO,R3VALO/ OBJIN/S,N,OBJOUT/PROTYP/PROPTN $ Input Data Blocks: XINIT DESTAB CONSBL* DPLDXI* XZ DXDXI DPLDXT* DEQATN DEQIND DXDXIT PLIST2* OPTPRMG R1VALRG RSP2RG R1TABRG CNTABRG Matrix of initial values of the design variable Table of design variable attributes Family of matrices of constant property values Family of matrices of coefficients in the property to independent design variable relationship. Matrix containing the constant portion of the dependent to independent design variable linking relationship Matrix relating linked and independent design variables Family of matrix transposes of DPLDXI Table of DEQATN Bulk Data entry images. Output by IFP. Index table to DEQATN data block. Output by IFP. Matrix transpose of DXDXI Family of tables of type two properties on DVPREL2 Bulk Data entries Table of optimization parameters Matrix of initial values of the retained first level responses Table of attributes of the retained second level responses Table of attributes of the retained first level responses Table of retained constraint attributes NX Nastran DMAP Programmer’s Guide 9-125 Chapter 9 Descriptions of DMAP Modules and Statements DSCMG DVPTAB* PROPI* CONS1T OBJTBG COORDO CON SHPVEC DCLDXT TABDEQ EPTTAB* DBMLIB BCON0 BCONXI BCONXT DNODEL RR2IDR RESP3RG Unnormalized design sensitivity matrix Family of tables of attributes of the designed properties by internal property identification number order Family of matrices of initial property values Matrix transpose of relationship between dependent and independent design variables Design objective table. Objective attributes with retained response identification number. Updated (optimized) table of designed coordinate values Matrix of constants that relates design variables and design coordinates Matrix of basis vectors – coefficients relating designed grid coordinates and design variables Matrix of coefficients in the grid to independent design variable relationship Table of unique design variable identification numbers. Family of tables of designed property attributes Table of designed beam library data Table of constant terms in the beam section constraint relationship Matrix relating beam library constraints to the independent design variables Matrix transpose of BCONXI Table of designed and non-designed locations Table of retained referenced type two response identification list Table of attributes of the retained third level responses Output Data Blocks: XO CVALO R1VALO R2VALO PROPO R3VALO Matrix of final (optimized) values of the design variables Matrix of final (optimized) constraint values Matrix of final (optimized) values of the retained first level responses Matrix of final (optimized) values of the second level responses Matrix of final (optimized) property values Matrix of final (optimized) values of the third level responses 9-126 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: OBJIN OBJOUT PROTYP Input-real-no default. Initial objective value. Output-real-no default. Final objective value. Input-integer-default=0. Designed property type code. 1 2 4 >0 PROPTN DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values Input-integer-default=0. In order to support a pre-Version 68 capability, if PROPTN=-1, an EPT data block which is based on the values and the property to design variable relations is produced. Input-integer-default=0. Unused. UNUSEDi 9.67 DOPFS 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/ XO,PROPO $ Input Data Blocks: R1TABRG CNTABRG DESELM DVPTAB* CVALRG PROPI OPTPRMG Table of attributes of the retained first level (direct) responses Table of retained constraint attributes Table of designed elements Table family of attributes of the designed properties by internal property identification number order Matrix of initial constraint values Matrix of initial property values Table of optimization parameters NX Nastran DMAP Programmer’s Guide 9-127 Chapter 9 Descriptions of DMAP Modules and Statements DPLDXT* CONSBL* DESTAB XINIT DPLDXI* PLIST2* DEQIND DEQATN EPTTAB* DBMLIB XZ DXDXI DXDXIT Matrix family of transpose of DPLDXI Matrix family of constant property values Table of design variable attributes Matrix of initial values of the design variables Matrix family of coefficients in the property to independent design variable relationship Table family of type two properties on DVPREL2 Bulk Data entries Index table to DEQATN data block Table of DEQATN Bulk Data entry images Table family of designed property attributes Table of designed beam library data Matrix containing the constant portion of the dependent to independent design variable linking relationship Matrix relating linked and independent design variables Matrix transpose of DXDXI. Output Data Blocks: XO PROPO Matrix of final (optimized) values of the design variables Matrix of final (optimized) property values Remarks: None. 9.68 DOPR1 Preprocesses design variables and designed property values Format: DOPR1 EDOM,EPT,DEQATN,DEQIND,GEOM2,MPT/ DESTAB,XZ,DXDXI,DTB,DVPTAB*,EPTTAB*,CONSBL*, DPLDXI*,PLIST2*,XINIT,PROPI*,DSCREN,DTOS2J*, OPTPRM,CONS1T,DBMLIB,BCON0,BCONXI,DMATCK,DISTAB/ S,N,MODEPT/S,N,MODGEOM2/S,N,MODMPT/DPEPS/ S,N,PROTYP/S,N,DISVAR $ 9-128 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: EDOM EPT DEQATN DEQIND GEOM2 MPT Table of Bulk Data entries related to design sensitivity and optimization Table of Bulk Data entry images related to element properties Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to material properties Output Data Blocks: DESTAB XZ DXDXI DTB DVPTAB* EPTTAB* CONSBL* DPLDXI* PLIST2* XINIT PROPI* DSCREN DTOS2J* OPTPRM CONS1T DBMLIB Table of design variable attributes Matrix containing the constant portion of the dependent to independent design variable linking relationship Matrix relating linked and independent design variables Table of constants from the DTABLE Bulk Data entry Family of tables of attributes of the designed properties by internal property identification number order Family of tables of designed property attributes Family of matrices of constant property values Family of matrices of coefficients in the property to independent design variable relationship Family of tables of type two properties on DVPREL2 Bulk Data entries Matrix of initial values of the design variables Family of matrices of initial property values Table of constants from the DSCREEN Bulk Data entry Family of tables identifying independent design variables and property Table of optimization parameters Matrix transpose of relationship between dependent and independent design variables Table of designed beam library data NX Nastran DMAP Programmer’s Guide 9-129 Chapter 9 Descriptions of DMAP Modules and Statements BCON0 BCONXI DMATCK DISTAB Table of constant terms in the beam section constraint relationship Matrix relating beam library constraints to the independent design variables Table of designed material consistency check Table of discrete optimization value sets Parameters: MODEPT Output-logical-default=FALSE. Analysis model element property modification flag. When the flag is set to TRUE, the design model overrides element properties in the analysis model. Output-logical-default=FALSE. Analysis model connectivity modification flag. When the flag is set to TRUE,the design model overrides connectivity in the analysis model. Output-logical-default=FALSE. Analysis model material property modification flag. When the flag is set to TRUE, the design model overrides material properties in the analysis model. Input-real-default=1.0E-4. Tolerance for design model override of analysis model properties. See further description in the NX Nastran Quick Reference Guide. Input-integer-default=0. Designed property type code. 1 2 4 >0 DISVAR DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values MODGEOM2 MODMPT DPEPS PROTYP Output-logical-default=FALSE. Discrete optimization variable flag. Set to TRUE if discrete optimization design variables are specified. 9.69 DOPR2 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 $ 9-130 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: EDOM BGPDT CSTM BASVEC DESTAB DXDXI XINIT CASECC AMLIST DVIDS Table of Bulk Data entries related to design sensitivity and optimization Basic grid point definition table Table of coordinate system transformation matrices Auxiliary displacement matrix Table of design variable attributes Matrix relating linked and independent design variables Matrix of initial values of the design variables Table of Case Control command images List of auxiliary model identification numbers List of shape variable identification numbers to be used for the boundary dvgrid option Output Data Blocks: DESGID COORDO SHPVEC DCLDXT CON DTOS4J DESVCP CASEP DNODEL Table of designed grid coordinate attributes Matrix of initial designed coordinate values at the beginning of each design cycle Matrix of basis vectors – coefficients relating designed grid coordinates and design variables Matrix of coefficients in the grid to design variable relationship Matrix of constants that relates design variables and design coordinates Designed grid perturbation vector in basic coordinate system Global shape basis vector matrix with incorporation of DLINK relations with extra columns for property/dummy variables Residual superelement Case Control table for plotting basis vectors Table of designed and non-designed locations Parameters: LUSET NOUGD Input-integer-default=0. The number of degrees-of-freedom in the g-set. Input-integer-default=-1. Flag for external input of auxiliary model displacement matrix. If NOUGD>0, the matrix exists. NX Nastran DMAP Programmer’s Guide 9-131 Chapter 9 Descriptions of DMAP Modules and Statements PEXIST DVGRDN Input-logical-default=FALSE. Set to TRUE if p-elements are present. Input-character-default=‘NO’ Flag for skipping basis vector components associated with all GRIDNs in DESVCP. If DVGRDN=‘YES‘, components are skipped. Remarks: 1. BASVEC can be DBLOCATE‘d or internally generated. 2. CON is an offset vector that ensures that the geometry at the beginning of a design cycle is the same as that in the analysis model. It is in the basic coordinate system. Examples: 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 $ 9.70 DOPR3 Preprocesses DCONSTR, DRESP1, and DRESP2 Preprocesses DCONSTR, DRESP1, and DRESP2 Bulk Data entries per analysis type and superelement. Creates tables related to the design objective and a Case Control table for recovering design responses. Format: DOPR3 CASE,EDOM,DTB,ECT,EPT,DESTAB,EDT,OL,DEQIND,DEQATN, DESGID,DVPTAB,VIEWTB,OINT,PELSET/ OBJTAB,CONTAB,R1TAB,RESP12,RSP1CT,FRQRSP,CASEDS, OINTDS,PELSETDS,DESELM,RESP3/ 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 $ 9-132 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: CASE EDOM DTB ECT EPT DESTAB EDT Table of Case Control commands for the current analysis type and superelement Table of Bulk Data entries related to design sensitivity and optimization Table of constants from the DTABLE Bulk Data entry Element connectivity table Table of Bulk Data entry images related to element properties Table of design variable attributes Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list. Output by FRLG, TRLG, CEAD, and READ. Index table to DEQATN Table of DEQATN Bulk Data entry images Table relating the designed grid coordinates and a reduced basis vector Table of attributes of the designed properties by internal property identification number order. Output by DOPR1. View information table, contains the relationship between each p-element and its view-elements and view-grids P-element output control table. Contains OUTPUT Bulk Data entries. Output by IFP. P-element set table, contains SETS DEFINITIONS OL DEQIND DEQATN DESGID DVPTAB VIEWTB OINT PELSET Output Data Blocks: OBJTAB CONTAB R1TAB RESP12 RSP1CT Design objective table for a given analysis type and superelement. Objective attributes with retained response identification number. Table of constraint attributes Table of first level (DRESP1 Bulk Data entry) attributes Table of second level responses Table of the count of type 1 responses per response type per subcase in R1TAB NX Nastran DMAP Programmer’s Guide 9-133 Chapter 9 Descriptions of DMAP Modules and Statements FRQRSP CASEDS OINTDS PELSETDS DESELM RESP3 Table of the count of type 1 frequency/time responses per response type per frequency or time step Case control table for the data recovery of design responses P-element output control table for constrained elements P-element set table for constrained elements Table of designed elements Table of third level responses Parameters: DMRESD DESGLB DESOBJ R1CNT R2CNT CNCNT SOLAPP SEID EIGNFREQ Input-integer-default=-1. Design model flag. If set to -1, the design model is limited to the residual structure. Output-integer-default=0. DESGLB Case Control command set identification number. Output-integer-default=0. DESOBJ Case Control command set identification number. Input/output-integer-default=0. Counter for type 1 responses in data block R1TAB. Input/output-integer-default=0. Counter for type 2 responses in data block RESP12. Input/output-integer-default=0. Counter for constraints in CONTAB. Input-character-no default. Design optimization analysis type. Input-integer-default=-1. Superelement identification number. Output-integer-default=0. Eigenvalue/frequency response type flag. 1 2 PROTYP Eigenvalue (radian/time) Frequency (cycle/time) Input-integer-default=0. Designed property type code. 1 2 4 >0 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values 9-134 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DSNOKD SHAPES Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling design sensitivity analysis. Usually specified as a user parameter. Input-logical-no default. Shape optimization Bulk Data entry presence flag. Must be TRUE if DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present. Input/output-integer-default=0. Counter for type 3 responses in the RESP3 table. R3CNT 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. 9.71 DOPR4 Creates design sensitivity tables for property and/or shape variables Format: DOPR4 DTOS2J*,DTOS4J,DESTAB/ TABDEQ,DTOS2K*,DTOS4K/ PROTYP $ Input Data Blocks: DTOS2J* DTOS4J DESTAB Family of tables identifying independent design variables and property Designed grid perturbation vector in basic coordinate system Table of design variable attributes Output Data Blocks: TABDEQ DTOS2K* Table of unique design variable identification numbers Family of tables. These tables are the same as DTOS2J* except that the dvid in each entry refers to the position of an internal design variable ID in the first TABDEQ record. Same as DTOS4J except that the ID in each five-word entry is the position of an internal design variable ID in the first TABDEQ record. DTOS4K NX Nastran DMAP Programmer’s Guide 9-135 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: PROTYP Input-integer-default=0. Designed property type code. 1 2 4 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist >0 For combinations, add above values 9.72 DOPR5 Updates design sensitivity tables Format: DOPR5 XINIT,EPTTAB*,PROPI*,DESTAB,DTOS2K*,DTOS4K, TABDEQ,DELBSH,GEOM4,DESGID/ DTOS2*,DTOS4,DELBSX/ STPSCL/S,N,RGSENS/PROTYP $ Input Data Blocks: XINIT EPTTAB* PROPI* DESTAB DTOS2K* Matrix of initial values of the design variables Family of tables of designed property attributes Family of matrices of initial property values Table of design variable attributes Family of tables. These tables are the same as DTOS2J* except that the dvid in each entry refers to the position of an internal design variable ID in the first TABDEQ record. Same as DTOS4J except that the ID in each five-word entry is the position of an internal design variable ID in the first TABDEQ record. Table of unique design variable identification numbers Matrix of finite difference shape step sizes Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of designed grid coordinate attributes DTOS4K TABDEQ DELBSH GEOM4 DESGID 9-136 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: 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. Same as DTOS4K except that the last three words in each entry contain the product of those in DTOS4K and the shape step size. Updated DELBSH, where the numerical zero terms are replaced by a prescribed small value. DTOS4 DELBSX Parameters: STPSCL RGSENS PROTYP Input-real-default=1.0. Shape step size scaling factor. Output-logical-default=FALSE. Rigid element sensitivity flag. Input-integer-default=1. Designed property type code. 1 2 4 DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist >0 For combinations, add above values 9.73 DOPR6 Generates tables relating to grid perturbations Format: DOPR6 DTOS4,GPECT,EQEXIN,DESGID,EST,GEOM4,MIDLIS/ DGTAB,ESTDVS,TABEVS/ RSONLY/RGSENS $ Input Data Blocks: DTOS4 GPECT EQEXIN DESGID EST Table relating design variable to grid perturbation Grid point element connection table Equivalence table between external and internal grid/scalar identification numbers Table of designed grid coordinate attributes Element summary table NX Nastran DMAP Programmer’s Guide 9-137 Chapter 9 Descriptions of DMAP Modules and Statements GEOM4 MIDLIS Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of pairs of user-supplied material property identification numbers (MIDs) and internal baseline MIDs Output Data Blocks: DGTAB ESTDVS TABEVS Table relating DTOS4 records and designed grid data EST with grid design variable perturbations Cross reference table between ESTDVS records and element/ design variable identification numbers Parameters: RSONLY Input-logical-no default. Residual structure only flag. FALSE : Superelements are specified. TRUE : Superelements are not specified. RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag. Remarks: 1. DOPR6 prepares tables to generate new stiffness matrix, mass matrix, load vector, and so on, taking into account shape design variable perturbations, that is, K+DELTAK, M+DELTAM and so on. 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. 9.74 DOPRAN Preprocess RMS responses Preprocess RMS responses in design optimization. Format: DOPRAN DYNAMIC,DIT,OL,R1TAB,BGPDT,CASE/ RMSTAB,CFSAB,PPVR/ LUSET $ 9-138 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: DYNAMIC DIT OL R1TAB BGPDT CASE Table of Bulk Data entry images related to dynamics, specifically RANDPS Table of TABLEij Bulk Data entry images, specifically TABRND1 Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list Table of first level (direct) (DRESP1 Bulk Data entry) attributes Basic grid point definition table Table of Case Control commands for the current analysis type and superelement Output Data Blocks: RMSTAB CFSAB PPVR Table of RMS responses Matrix of spectral densities – weighting factors for RMS calculations Partitioning vector for random responses Parameters: LUSET Input-integer-default=-1. The number of degrees-of-freedom in the g-set. Remarks: None. 9.75 DPD Creates tables from Bulk Data entry images specified for dynamic analysis Format: DPD DYNAMIC,GPL,SIL,USET,CASECC,PG,PKYG,PBYG,PMYG,YG/ GPLD,SILD,USETD,TFPOOL,DLT,PSDL,RCROSSL,NLFT,TRL, EED,EQDYN/LUSET/S,N,LUSETD/S,N,NOTFL/S,N,NODLT/ S,N,NOPSDL/DATAREC/ S,N,NONLFT/S,N,NOTRL/S,N,NOEED/UNUSED10/S,N,NOUE/ UNUSED12/SEID $ Input Data Blocks: DYNAMIC Table of Bulk Data entry images related to dynamics NX Nastran DMAP Programmer’s Guide 9-139 Chapter 9 Descriptions of DMAP Modules and Statements GPL SIL USET CASECC PG PKYG PBYG PMYG YG External grid/scalar point identification number list Scalar index list Degree-of-freedom set membership table for g-set Table of case control command images Static load matrix for the g-set Matrix of equivalent static loads due to enforced displacement for the g-set Matrix of equivalent static loads due to enforced velocity for the g-set Matrix of equivalent static loads due to enforced acceleration for the g-set Matrix of enforced displacements or temperatures for the g-set Output Data Blocks: GPLD SILD USETD TFPOOL DLT PSDL RCROSSL UNUSED7 NLFT TRL EED EQDYN External grid/scalar/extra point identification number list. (GPL appended with extra point data.) Scalar index list for p-set. (SIL appended with extra point data.) Degree-of-freedom set membership table for p-set. (USET appended with extra point data.) Table of TF Bulk Data entry images Table of dynamic loads Power spectral density list Table of RCROSS Bulk Data entry images Unused Nonlinear Forcing function table Transient response list Table of eigenvalue extraction parameters Equivalence table between external and internal grid/scalar/extra point identification numbers. (EQEXIN appended with extra point data.) Parameters: LUSET LUSETD Input-integer-no default. The number of degrees-of-freedom in the g-set. Output-integer-no default. The number of degrees-of-freedom in the p-set. 9-140 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOTFL NODLT NOPSDL DATAREC Output-integer-no default. The number of transfer function Bulk Data entries. Set to -1 if no sets are defined. Output-integer-no default. Set to 1 if dynamics loads Bulk Data entries are processed, -1 otherwise. 1 also means that DLT is created. Output-integer-no default. Set to 1 if random analysis Bulk Data entries are processed, -1 otherwise. 1 also means that PSDL is created. Input-integer-default=0. Data recovery flag. If DATAREC>0, DPD does not perform UFM 2071 checks for DELAY and DPHASE, which are not needed in data recovery. Input-integer-default=0. Unused. Output-integer-no default. Set to 1 if nonlinear forcing function Bulk Data entries are processed, -1 otherwise. 1 also means that PSDL is created. Output-integer-no default. Set to 1 if transient time step parameter Bulk Data entries are processed, -1 otherwise. 1 also means that TRL is created. Output-integer-no default. Set to 1 if eigenvalue extraction Bulk Data entries are processed, -1 otherwise. 1 also means that EED is created. Input-integer-no default. Unused. Output-integer-no default. Number of extra points. Set to -1 if there are no extra points. Input-integer-default=0. Unused. Input-integer-default=0. Superelement identification number. UNUSED6 NONLFT NOTRL NOEED UNUSED10 NOUE UNUSED12 SEID 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. 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 can be purged if USETD, DLT, and EED are purged. 9.76 DRMH1 Converts data recovery tables to matrices and associated directory tables Converts data recovery tables (for example, displacements, stresses, strains, forces, SPCforces, and MPCforces) to matrices and associated directory tables. Similar to the DRMS1 module. NX Nastran DMAP Programmer’s Guide 9-141 Chapter 9 Descriptions of DMAP Modules and Statements Format: DRMH1 OFP1,OFP2,OFP3,OFP4/ TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4/ NCOL/NULLROW/TRL5T1/TRL5T2/TRL5T3/TRL5T4 $ Input Data Blocks: OFPi Output table in SORT1 format usually created by the SDR2 module Output Data Blocks: TOFPi MOFPi Directory table for MOFPi Matrix form of the i-th output table Parameters: NCOL Input-integer-default=0. Number of columns (that is; subcases, modes, time steps or frequencies) desired in the output matrices. By default, all data records are converted into the output matrices. If NCOL is less than the number of data records in the input table, the first NCOL records are converted and the remaining records are ignored. Input-integer-default=1. Flag to insert null rows in the output matrices for nonlinear quantities. See Remark 1. 0: Insert null rows. Compatible with DRMS1 output format 1: Do not insert null rows. Required for DRMH3 processing TRL5Ti Output-integer-default=0. Specifies value for the fifth word in TOFPi‘s trailer. NULLROW Remarks: 1. DRMH1 is a similar to the DRMS1 module except that only the linear quantities (for example, axial stress) are output to the matrix. However, if NULLROW=0, null rows are inserted for the nonlinear quantities (for example, margin-of-safety). 2. DRMH1 converts 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 want to double the stress output in the OES1 table. SOL 108 MALTER ’, ETC. DATA RECOVERY, SORT1’(,-1) DRMH1 OES1,,,/TES,MES,,,,,, $ 9-142 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ADD5 DRMH3 OFP CEND MES,,,,/MES2/2. $ TES,MES2,,,,,,,OL2,CASEDR/OES12,,,/APP1 $ OES12/ $ 9.77 DRMH3 Partitions tables for each superelement Converts data recovery matrices and associated directory tables (DRMH1 module outputs) to SORT1 formatted tables suitable for printing by the OFP module or processing by other modules; for example, DDRMM and SDR3. Format: DRMH3 TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4, OL,CASECC/ OFP1,OFP2,OFP3,OFP4/ APP/DTM1/DTM2/DTM3/DTM4 $ Input Data Blocks: TOFPi MOFPi OL Directory table for MOFPi Matrix form of the i-th output table Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list. Output by FRLG, TRLG, CEAD, and READ. May also be output by MODACC, if truncated via the OFREQ and OTIME Case Control commands. Table of Case Control command images CASECC Output Data Blocks: OFPi Output table in SORT1 format. Identical in format to data blocks created by the SDR2 module. Parameters: APP Input-character-default=‘STATICS’ Analysis type. Allowable types are: ‘STATICS’ : statics ‘REIG’ : normal modes ‘CEIGEN’ : complex modes ‘FREQRESP’: frequency response ‘TRANRESP’: transient response NX Nastran DMAP Programmer’s Guide 9-143 Chapter 9 Descriptions of DMAP Modules and Statements DTMi Input-integer-default=0. Mode acceleration based displacement matrix flag. If DTMi<>0, MOPFi is a mode acceleration based displacement matrix and, therefore, velocities and accelerations are not output to OFPi. For APP=‘TRANRESP‘, MOFPi must have only one column per time step instead of the usual three. Remarks: 1. If CASECC is purged, all input data blocks are converted. Otherwise, the inputs are 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 occurs: If the number of rows (output quantities; for example, stresses) does not match, a warning message is printed with the identification of the matrix and table name. If the number of columns (for example, subcases or mode) does not match, a warning message is printed and the module continues. This allows you 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” module description. 9.78 DRMS1 Data recovery by mode superposition, Phase 1 To compute output transformation matrices for displacements, SPC forces, stresses, and element forces. The input data blocks are the type generated by the SDR2 module and formatted for the OFP module. Format: DRMS1 OFP1,OFP2,OFP3,OFP4/ TOFP1,MOFP1,TOFP2,MOFP2,TOFP3,MOFP3,TOFP4,MOFP4/ NCOL $ Input Data Blocks: OFPi Output table in SORT1 format. Usually created by the SDR2 module. Output Data Blocks: TOFPi MOFPi Directory table for MOFPi. Matrix form of the i-th output table 9-144 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameter: NCOL Input-integer-default=0. Number of columns (that is; subcases, modes, time steps or frequencies) desired in the output matrices. By default, all data records are converted into the output matrices. If NCOL is less than the number of data records in the input table, the first NCOL records are converted and the remaining records are ignored. 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 cannot be given linear combination operations, such as margins of safety and principal stresses. This irrelevant data is 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 have as many columns as the number of modes or loading conditions specified in PARAM, NCOL. Each column contains all the relevant components of GRIDs (T1, T2, and so on) or elements (σx, σy, and so on) for all the GRIDs or elements retained in the input data blocks. 4. Directory tables contain the mapping information as follows: • RECORD 0 - Header record, indicating: – – • Type of data (φ, q, σ, or F) Format code (real, real/imaginary or magnitude/phase) RECORD 1 - Identification of the columns, providing: – – Column numbers of the associated matrix Natural frequencies (fn) • RECORD 2 - Identification of the rows, providing: – – – – Type code of points or elements ID number of points or elements Number of components of the point or element retained in the associated matrix Starting row number of the point or element with reference to the associated matrix. See the OES, OEF, OUG, and OQG table descriptions in “+”. • Matrix trailer output, indicating the size of the associated matrix 9.79 DSABO Incorporates element property design variable perturbations NX Nastran DMAP Programmer’s Guide 9-145 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: ECT EPT EST DTOS2* Element connectivity table Table of Bulk Data entry images related to element properties Element summary table Family of tables. These tables 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. Element temperature table Table of TABLEij Bulk Data entry images Table of Bulk Data entry images related to material properties Table of designed material consistency check Table containing LAM option input and expanded information from the PCOMP Bulk Data entry ETT DIT MPT DMATCK PCOMPT Output Data Blocks: ESTDVP MPTX EPTX TABEVP MIDLIS ESTDVM PCOMPTX EST with element property design variable perturbations MPT with design variable perturbations EPT with design variable perturbations Cross-reference table between ESTDVP records and element and design variable identification numbers Table of pairs of user-supplied material property identification numbers (MIDs) and internal baseline MIDs EST with updated material property identification numbers PCOMPT with design variable perturbations 9-146 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: PROPOPT DELTAB PROTYP Output-integer-default=0. Property optimization flag. Set to 1 if element properties are defined as design variables. Input-real-no default. Relative finite difference move parameter as specified on the DOPTPRM Bulk Data entry and stored in the OPTPRM data block. Input-integer-default=0. Designed property type code. 1 2 4 >0 PEXIST DVPRELi entries exist DVCRELi entries exist DVMRELi entries exist For combinations, add above values Input-logical-default=FALSE. P-element flag. Set to TRUE if p-elements are present. Remarks: 1. The main purpose of module DSABO is to prepare tables that generate a new stiffness matrix, mass matrix, load vector, and so on, while taking into account the design variable perturbations, that is, K + DELTAK, M + DELTAM, and so on. These calculations are completed by generating an EST for all elements. These ESTs are referred to by the design variables and are 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, and so on. 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 and so on. 2. If central difference is requested, 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‘ 9.80 DSAD Processes tables related to design sensitivity response evaluation Processes tables related to design sensitivity response evaluation, constraint screening and load case deletion. NX Nastran DMAP Programmer’s Guide 9-147 Chapter 9 Descriptions of DMAP Modules and Statements Format: DSAD RSP1CT,R1TAB,RESP12,OBJTAB,CONTAB, BLAMA,clama,LAMA,DIVTAB,AUXTAB,STBTAB, FLUTAB,OUG1DS,OES1DS,OSTR1DS,OEF1DS, OEFITDS,OES1CDS,OSTR1CDS,OQG1DS,DSCREN, XINIT,COORDN,OL,FRQRSP,CASEDS, CASERS,UGX,OPTPRM,DVPTAB*,PROPI*, BGPDT,DNODEL,WGTM,ONRGYDS, GLBTABDS,GLBRSPDS,RESP3,RMSTAB,RMSVAL/ 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/ 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 $ Input Data Blocks: RSP1CT R1TAB RESP12 OBJTAB CONTAB BLAMA CLAMA LAMA DIVTAB AUXTAB STBTAB FLUTAB OUG1DS OES1DS OSTR1DS Table of the count of type 1 responses per response type per subcase in R1TAB. Output by DOPR3. Table of first level (DRESP1 Bulk Data entry) attributes Table of second level responses Design objective table for a given analysis type and superelement. Objective attributes with retained response identification number. Table of constraint attributes Buckling eigenvalue summary table Complex eigenvalue summary table Normal modes eigenvalue summary table Table of aerostatic divergence data for all subcases Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments for all subcases Table of aerostatic stability derivatives for all subcases Flutter summary table for all subcases Table of displacements in SORT1 format for design responses Table of element stresses in SORT1 format for design responses Table of element strains in SORT1 format for design responses 9-148 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OEF1DS OEFITDS OES1CDS OSTR1CDS OQG1DS DSCREN XINIT COORDN OL Table of element forces, excluding non-composite elements, in SORT1 format for design responses Table of composite element failure indices for design responses Table of composite element stresses in SORT1 format for design responses Table of composite element strains in SORT1 format for design responses. Table of single point forces-of-constraint in SORT1 format for design responses Table of constants from the DSCREEN Bulk Data entry Matrix of initial values of the design variables Matrix of initial or final designed coordinate values Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list. Output by FRLG, TRLG, CEAD, and READ. Table of the count of type 1 frequency/time responses per response type per frequency or time step. Case Control table for the data recovery of design responses Matrix of analysis model displacements in g-set or p-set Table of optimization parameters Family of tables of attributes of the designed properties by internal property identification number order Family of matrices of initial property values Basic grid point definition table Table of designed and non-designed locations Table of 6x6 rigid body mass matrix Table of element strain energies in SORT1 format for design responses Global results correlation table Global results matrix Table of third level responses Table of RMS responses Matrix of initial RMS values FRQRSP CASEDS UGX OPTPRM DVPTAB* PROPI* BGPDT DNODEL WGTM ONRGYDS GLBTABDS GLBRSPDS RESP3 RMSTAB RMSVAL NX Nastran DMAP Programmer’s Guide 9-149 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: R1VAL R2VAL RSP12R R2VALR CVAL CVALR OBJTBR CNTABR R1TABR R1VALR DRSTBL FRQRPR UGX1 AUG1 R1MAPR R2MAPR CASDSN CASDSX DRDUG DRDUTB CASADJ LCDVEC Matrix of initial values of the retained first level responses Matrix of initial values of the retained second level responses Table of retained second level responses in RESP12 Matrix of retained second level responses Matrix of constraint values Matrix of retained constraint values Table of design objective attributes with retained response identification number Table of retained constraint attributes Table of retained first level (DRESP1 Bulk Data entry) attributes Matrix of retained type one responses Table containing the number of retained responses for each subcase for each of the response types Table containing the number of first level retained responses per response type and per frequency or time step Copy of UGX matrix with null columns in place of the deleted responses Displacement matrix in g-set for aerostatic analysis Table of mapping from original first level retained responses Table of mapping from original second level retained responses Case Control table with unneeded analysis subcase(s) deleted, excluding static aeroelastic subcases Case Control table with unneeded analysis subcase deleted Matrix of adjoint loads for the g-set Table of adjoint load attributes Case Control table associated with adjoint method 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. Table of retained referenced type two response identification list RR2IDR 9-150 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements R3VAL R3VALR RESP3R RMSTABR RMSVALR Matrix of initial values of the retained third level responses Matrix of initial values of the retained third level responses Table of retained third level responses in RESP3 Table of retained RMS responses in RMSTAB Matrix of initial values of the retained RMS responses in RMSVAL Parameters: WGTS VOLS OBJVAL NR1OFFST Input-real-default=0.0. Total weight of analysis model. Input-real-default=0.0. Total volume of analysis model. Output-real-default=0.0. Objective value. Input/output-integer-default=0. Counter for retained type 1 responses. The value is initialized to 1 and is incremented by the number of records in R1TABR. Input/output-integer-default=0. Counter for retained type 2 responses. The value is initialized to 1 and is incremented by the number of records in RSP12R. Input/output-integer-default=0. Counter for retained constraints. The value is initialized to 1 and is incremented by the number of records in CNTABR. Input-character-default=’ ’ Analysis type. Allowable values are: ‘STATICS’: statics= ‘FREQRESP’: frequency response ‘TRANRESP’: transient respsonse DMRESD SEID DESITER EIGNFREQ Input-integer-default=-1. Design model flag. If set to -1, the design model is limited to the residual structure. Input-integer-default=0. Superelement identification number. Input-integer-default=0. Design optimization iteration number. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 ADJFLG Eigenvalue (radian/time) Frequency (cycle/time) NR2OFFST NCNOFFST APP Output-integer-default=0. Adjoint sensitivity method flag. 0 No adjoint sensitivity NX Nastran DMAP Programmer’s Guide 9-151 Chapter 9 Descriptions of DMAP Modules and Statements 1 2 PEXIST MBCFLG Adjoint sensitivity for static analysis Adjoint sensitivity for frequency response analysis Input-logical-default=FALSE. P-element existence flag. Set to TRUE if p-elements are present. Input-logical-default=FALSE. Multiple boundary condition in static analysis flag. Set to TRUE if multiple boundary conditions are specified in static analysis. Input-logical-default=FALSE. Rigid element sensitivity flag. Input-integer-default=0. Designed property type code. 1 2 4 >0 1: DVPRELi entries exist 2: DVCRELi entries exist 4: DVMRELi entries exist >0: For combinations, add above values RGSENS PROTYP AUTOADJ Input-character-no default. Adjoint sensitivity automatic selection flag. If set to ‘YES‘, adjoint sensitivity is automatically selected if appropiate. Usually input via user parameter. Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if this is a fully stressed design cycle. 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. FSDCYC NR3OFFST 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. Therefore many of the inputs, outputs, and data blocks are qualified by superelement and/or analysis type. See subDMAP DESCON for an example. 9.81 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. 9-152 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: DSADJ XDICTDS,XELMDS,BGPDT,CSTM,XDICTX,XELMX,UGX,ADJG, DRDUTB,DSPT1/ ADELX/ NOK4GG/WTMASS/XTYPE/CDIF/COUPMASS/SHAPEOPT $ Input Data Blocks: XDICTDS XELMDS BGPDT CSTM XDICTX XELMX UGX ADJG DRDUTB DSPT1 Perturbed element matrix dictionary table Table of perturbed element matrices Basic grid point definition table Table of coordinate system transformation matrices Baseline element matrix dictionary table or backward perturbed element matrix dictionary if CDIF=‘YES’ Baseline element matrices or backward perturbed element matrices if CDIF=‘YES’ Matrix of analysis model displacements in g-set or p-set Adjoint sensitivity displacement matrix in the g-set or p-set Table of adjoint load attributes Design sensitivity processing table Output Data Blocks: ADELX Matrix of adjoint sensitivities Parameters: NOK4GG Input-integer-default=-1. Structural damping generation flag. -1 0 WTMASS XTYPE Do not generate Generate Input-real-default=1.0. Specifies scale factor on structural mass matrix. Input-integer-default=0. Type of element matrix data: 0 1 2 Stiffness Damping Mass NX Nastran DMAP Programmer’s Guide 9-153 Chapter 9 Descriptions of DMAP Modules and Statements CDIF Input-character-no default. Finite difference scheme. ‘YES’ ‘NO’ Central Forward COUPMASS Input-integer-default=0. Coupled mass generation flag. -1 0 Lumped Coupled SHAPEOPT Input-integer-default=0. Shape optimization flag. Set to 1 if shape optimization is activated. 9.82 DSAE Merges tables to evaluate responses for the perturbed configuration Merges tables for the two sets of design variables in order to evaluate responses for the perturbed configuration for each load case and for each design variable. Format: DSAE ESTDVP,ESTDVS,TABEVP,TABEVS,TABDEQ/ ESTDV2,TABEV2 $ Input Data Blocks: ESTDVP ESTDVS TABEVP TABEVS TABDEQ EST with element property design variable perturbations EST with grid design variable perturbations Cross-reference table between ESTDVP records and element and design variable identification numbers Cross reference table between ESTDVS records and element and design variable identification numbers Table of unique design variable identification numbers Output Data Blocks: ESTDV2 TABEV2 Merged EST with grid and element property design variable perturbations Merged cross reference table of TABEVP and TABEVS Parameters: None. 9-154 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Remarks: 1. TABEV2 is in the ascending alphanumeric EST sort. IVEIDs are assigned to ensure that internal element IDs 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, for example, the cross-sectional area of a rod, thickness of a plate, and so on. The second set consists of those variables which can affect the responses, but have no effect on stiffness and mass matrices, for example, recovery points in a beam or plate. 3. If central difference is requested, DSAE must be executed for the backward tables. For example, in subDMAP PSLGDV, DSAE is used as follows: DSAE ESTDVP,ESTDVS,TABEVP,TABEVS,TABDEQ/ ESTDV2F,TABEV2 $ IF ( CDIFX=‘YES’) DSAE, ESTDVPB,ESTDVS,TABEVP,TABEVS,TABDEQ/ ESTDV2B,TABEV2 $ 9.83 DSAF Generates tables incorporating effect of retained first level responses Generates element summary and temperature tables that incorporate the effect of retained first level responses. Format: DSAF R1TABR,EST,ESTDV2,TABEV2,ETT,MIDLIS,KELM,KDICT, PTELEM,KELMDS,KDICTDS,PTELMDSX,ECT,VELEM,VELEMN/ ESTDCN,TABECN,ETTDCN,KELMDCN,KDICTDCN,PTELMDCN, VELEMDCN/ NDVTOT/PESE $ Input Data Blocks: R1TABR EST ESTDV2 TABEV2 ETT MIDLIS KELM Table of retained first level (DRESP1 Bulk Data entry) attributes Element summary table Merged element summary table with grid and element property design variable perturbations Merged cross reference table of TABEVP and TABEVS Element temperature table Table of pairs of user-supplied material property identification numbers (MIDs) and internal baseline MIDs Table of element matrices for stiffness, heat conduction, differential stiffness, or follower stiffness NX Nastran DMAP Programmer’s Guide 9-155 Chapter 9 Descriptions of DMAP Modules and Statements KDICT PTELEM KELMDS KDICTDS PTELMDSX ECT VELEM VELEMN KELM dictionary table Table of thermal loads in the elemental coordinate system Table of perturbed element stiffness matrices. If CDIF=‘YES‘, this is the forward perturbed element matrix dictionary. Perturbed element stiffness matrix dictionary table. If CDIF=‘YES, this is the forward perturbed element matrix dictionary. Table of thermal loads in the elemental coordinate system for the central, forward, or backward perturbed configuration. Element connectivity table Table of element lengths, areas, and volumes Table of element lengths, areas, and volumes for the perturbed configuration Output Data Blocks: ESTDCN TABECN ETTDCN KELMDCN Element summary table which incorporates combined constraints and design variables Table of relationship between internal identification numbers of constraints in ESTDCN and elements and responses in R1TABR Table of design variable and constraint internal identification numbers for the effects of temperature Table of element matrices for stiffness, heat conduction, differential stiffness, or follower stiffness which incorporates combined constraints and design variables KELM dictionary table which incorporates combined constraints and design variables Table of thermal loads in the elemental coordinate system which incorporates combined constraints and design variables Table of element lengths, areas, and volumes which incorporates combined constraints and design variables KDICTDCN PTELMDCN VELEMDCN Parameters: NDVTOT PESE Input-integer-default=0. Number of unique referenced design variables. Input-integer-default=0. Element strain energy flag for static analysis. 9-156 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.84 DSAH 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/ DBUG,DPHG,CASEDSF,LBTAB,BDIAG,LFTAB,COGRID,COELEM, DSEDV,OINTDSF,PELSDSF,DGEOM2,DGEOM3/ APP/DMRESD/NDVTOT/ADJFLG/SEID/DSNOKD/S,N,NNDFRQ $ Input Data Blocks: DRSTBL R1TABR CASDSN TABECN BLAMA* LAMA* OL DIVTAB FRQRPR VIEWTBDS CASERS CSNMB BUG* PHG* GEOM2 Table containing the number of retained responses for each subcase for each of the response types. Output by DSAD Table of retained first level (DRESP1 Bulk Data entry) attributes Case Control table with unneeded analysis subcase(s) deleted, excluding static aeroelastic subcase Table of relationship between internal identification numbers of constraints in ESTDCN and elements and responses in R1TABR Family of buckling eigenvalue summary tables Family of normal modes eigenvalue summary tables Transient response time output list or frequency response frequency output list Table of aerostatic divergence data for all subcases Table containing the number of first level retained responses per response type and per frequency or time step View information table, contains the relationship between each p-element and its view-elements and view-grids for the perturbed model Case Control table for the residual structure and a given analysis type Case Control table for a given superelement and all analysis types Family of buckling eigenvector matrices in the g-set Family of normal modes eigenvector matrices in the g-set Table of Bulk Data entry images related to element connectivity and scalar points NX Nastran DMAP Programmer’s Guide 9-157 Chapter 9 Descriptions of DMAP Modules and Statements GEOM3 FRQRMF DFFDNF CASEFREQ Table of Bulk Data entry images related to static loads FRQRPR table for frequency response Table containing the derivatives of forcing frequencies with respect to natural frequencies Case Control table for modal or direct frequency response analysis and based on ANALYSIS=MFREQ or DFREQ Output Data Blocks: DBUG DPHG CASEDSF LBTAB BDIAG LFTAB COGRID COELEM DSEDV OINTDSF PELSDSF DGEOM2 DGEOM3 Buckling eigenvector matrix in the g-set associated with designed (active) eigenvalues Normal modes eigenvector matrix in the g-set associated with designed (active) eigenvalues Case Control table for all load cases and all design variables for the perturbed configuration Table of eigenvalues and generalized masses for retained buckling eigenvalue responses Diagonal matrix of buckling divided by buckling generalized differential stiffness matrix Table of eigenvalues and generalized masses for retained normal mode eigenvalue responses Correlation table between idcid/gid component for displacement responses Correlation table between idcid/eid/component for element responses Partitioning vector for retained divergence responses P-element output control table for the perturbed configuration P-element set table for the perturbed configuration Table of Bulk Data entry images related to element connectivity and scalar points for the perturbed configuration Table of Bulk Data entry images related to static loads for the perturbed configuration Parameters: APP Input-character-default=’ ’ Analysis type. Allowable values are: 9-158 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements STATICS’statics ‘FREQRESP’frequency response ‘TRANRESP’transient respsonse DMRESD NDVTOT ADJFLG Input-integer-default=0. Design model flag. If set to -1, the design model is limited to the residual structure. Input-integer-default=0. Number of unique referenced design variables. Output-integer-default=-1. Adjoint sensitivity method flag. 0 1 2 SEID DSNOKD No adjoint sensitivity Adjoint sensitivity for static analysis Adjoint sensitivity for frequency response analysis Input-integer-default=0. Superelement identification number. Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling design sensitivity analysis. Usually specified as a user parameter. Output-integer-default=0. Number of forcing frequencies which depend upon natural frequencies. NNDFRQ 9.85 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 $ Input Data Blocks: EDOM EQEXIN BGPDT CSTM Table of Bulk Data entries related to design sensitivity and optimization Equivalence table between external and internal grid/scalar identification numbers Basic grid point definition table Table of coordinate system transformation matrices NX Nastran DMAP Programmer’s Guide 9-159 Chapter 9 Descriptions of DMAP Modules and Statements SIL BASVEC0 CASECC GEOM4 Scalar index list Auxiliary displacement matrix. Optional user input. Table of Case Control command images Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Output Data Blocks: 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. List of shape variable identification numbers to be used for the boundary DVGRID option Case Control table with number of basis vectors in the DESVEC as the number of Case Control records 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. DVIDS CASEP DESVECP Parameter: LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set. 9.86 DSAL Generates design sensitivity coefficient matrix Generates the design sensitivity coefficient matrix; for example, 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,R1VALR, OQGDSN,ONRGYDSN,TABDEQ,OL,DSDIV, DELX,DELS,DELFL,DELCE,FRQRPR,DELBSH, DRDUTB,ADELX,R1TABR,DRMSVL/ DSCM/NDVTOT/DELTAB/EIGNFREQ/ADJFLG/SEID $ Input Data Blocks: DRSTBL Table containing the number of retained responses for each subcase for each of the response types 9-160 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DELWS DELVS DELB1 DELF1 COGRID COELEM OUGDSN OESDSN OSTRDSN OEFDSN OEFITDSN OESCDSN OSTRCDSN R1VALR OQGDSN ONRGYDSN TABDEQ OL DSDIV DELX DELS DELFL DELCE Matrix of delta weight for all design variables Matrix of delta volume for all design variables Matrix of delta buckling load factor for all design variables Matrix of delta eigenvalue for all design variables Correlation table between idcid/gid component for displacement responses Correlation table between idcid/eid/component for element responses Table of displacements in SORT1 format for design responses for the perturbed configuration Table of element stresses in SORT1 format for the perturbed configuration Table of element strains in SORT1 format for the perturbed configuration Table of element forces, excluding non-composite elements, in SORT1 format for the perturbed configuration Table of composite element failure indices for the perturbed configuration Table of composite element stresses in SORT1 format for the perturbed configuration Table of composite element strains in SORT1 format for the perturbed configuration Matrix of retained type one responses Table of single forces-of-constraint in SORT1 format for design responses for the perturbed configuration Table of element strain energies and energy densities in SORT1 format for design responses for the perturbed configuration Table of unique design variable identification numbers Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list Matrix of delta divergence speed for all design variables Matrix of delta trim variable responses for all design variables Matrix of delta stability derivative responses for all design variables Matrix of delta flutter responses for all design variables Matrix of delta complex eigenvalue for all design variables NX Nastran DMAP Programmer’s Guide 9-161 Chapter 9 Descriptions of DMAP Modules and Statements FRQRPR DELBSH DRDUTB ADELX R1TABR DRMSVL Table containing the number of first level retained responses per response type and per frequency or time step Matrix of finite difference shape step sizes Table of adjoint load attributes Matrix of adjoint sensitivities Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes Table of the RMS response values with respect to the design variables Output Data Blocks: DSCM Design sensitivity coefficient matrix Parameters: NDVTOT DELTAB EIGNFREQ Input-integer-no default. Number of unique referenced design variables. Input-real-no default. Relative finite difference move parameter as specified on the DOPTPRM Bulk Data entry and stored in the OPTPRM data block. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 ADJFLG Eigenvalue (radian/time) Frequency (cycle/time) Input-integer-default=0. Adjoint sensitivity method flag. 0 1 2 No adjoint sensitivity Adjoint sensitivity for static analysis Adjoint sensitivity for frequency response analysis SEID Input-integer-default=0. Superelement identification number. Remarks: DSAL is intended to be executed for each analysis type and superelement. Hence, many of the inputs, outputs, and data blocks are qualified by superelement and/or analysis type. See subDMAP RESPSEN for an example. 9.87 DSAM Creates geometry for backward and forward (or central) perturbation 9-162 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: DSAM DTOS4,DGTAB,BGPDT/ BGPDVP,BGPDVB/ S,N,SHAPEOPT/CDIF $ Input Data Blocks: DTOS4 Table relating design variable to grid perturbation. Same as DTOS4K except that the last three words in each entry contain the product of those in DTOS4K and the shape step size. Table relating DTOS4 records and designed grid data. Correlation table of internal grid sequence for the baseline and perturbed configuration. DGTAB Output Data Blocks: BGPDVP BGPDVB Basic grid point definition table for the forward (or central) perturbed configuration Basic grid point definition table for the backward perturbed configuration Parameters: SHAPEOPT CDIF Output-integer-default=0. Shape optimization flag. Set to 1 if shape design variables are defined. Input-character-no default. Finite difference scheme. ‘YES’ ‘NO’ Central Forward 9.88 DSAN Generates design sensitivity processing table Generates design sensitivity processing table and update element temperature table. Format: DSAN TABEV2,ETT/ DSPT1,ETTDV $ Input Data Blocks: TABEV2 Merged cross reference table of TABEVP and TABEVS NX Nastran DMAP Programmer’s Guide 9-163 Chapter 9 Descriptions of DMAP Modules and Statements ETT Element temperature table Output Data Blocks: DSPT1 ETTDV Design sensitivity processing table. Element temperature table where the original element identification numbers have been converted to new design variable identification numbers Parameters: None. 9.89 DSAP Computes an inertial or pseudo-load matrix Computes an inertial or pseudo-load matrix according to the following summation for frequency response and normal modes: where: or for complex eigenvalues: where: Format: DSAP MUX,BUX,KUX,OL,DSPT1/ PX/ APP $ 9-164 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: MUX BUX KUX OL DSPT1 Matrix of mass multiplied by displacements or eigenvectors Matrix of damping multiplied by displacement or eigenvectors Matrix of stiffness multiplied by displacement or eigenvectors Complex or real eigenvalue summary table, or frequency response frequency output list Design sensitivity processing table. See Remarks. Output Data Block: PX Inertial or pseudo-load matrix Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘FREQ’Frequency response ‘CEIG’Complex eigenvalue ‘REIG’Normal modes 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, PX is truncated accordingly. 3. Any of the inputs can be purged except OL. If DSPT1 is specified, APP can only be equal to ‘FREQ,’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 can relate to a degree-of-freedom set. 9.90 DSAPRT Prints the normalized design sensitivity coefficient matrix Prints the normalized design sensitivity coefficient matrix according to the DSAPRT Case Control command request. NX Nastran DMAP Programmer’s Guide 9-165 Chapter 9 Descriptions of DMAP Modules and Statements Format: DSAPRT CASECC,DESTAB,DSCMCOL,DSCM2,R1VALRG,R2VALRG,R3VALRG, DSIDLBL// DSZERO/EIGNFREQ/XYUNIT/DESCYCLE $ Input Data Blocks: CASECC DESTAB DSCMCOL DSCM2 R1VALRG R2VALRG R3VALRG DSIDLBL Table of Case Control command images Table of design variable attributes Correlation table for normalized design sensitivity coefficient matrix Normalized design sensitivity coefficient matrix Matrix of initial values of the retained first level (direct) responses Matrix of initial values of the retained second level (synthetic) responses Matrix of initial values of the retained third level responses Table of design response labels Output Data Blocks: None. Parameters: DSZERO Input-real-default=0.0. Design sensitivity coefficient print threshold. If the absolute value of the coefficient is greater than DSZERO, the coefficient is printed. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 XYUNIT DESCYCLE Eigenvalue (radian/time) Frequency (cycle/time) EIGNFREQ Input-integer-default=0. Fortran unit number to which the DOM12 module writes design optimization x-y plot data. Input-integer-default=0. Design cycle analysis counter. 9.91 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. 9-166 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: DSAR UXT,TOL,TOL1,PXT/ UDISP,UVELO,UACCE,UXT1,PXT1/ EXTRPL/NDEL $ Input Data Blocks: UXT TOL TOL1 PXT Solution matrix from transient response analysis Transient response time output list consistent with columns in UXT and PXT Reduced transient response time output list. Subset of time steps in TOL and consistent with columns in outputs Transient load matrix in the h-set (modal) or d-set for time steps in TOL Output Data Blocks: UDISP UVELO UACCE UXT1 PXT1 Reduced displacement solution matrix from transient response analysis Reduced velocity solution matrix from transient response analysis Reduced acceleration solution matrix from transient response analysis Reduced solution matrix from transient response analysis Reduced transient response load matrix in the h-set (modal) or d-set Parameters: EXTRPL Input-integer-default=1. Extra solution column flag. An extra column is or is not appended to UDISP, UVELO, and UACCE accordingly: 0 1 2 NDEL Not appended From the last time step By extrapolation Input-integer-default=3. If NDEL is -1, an unneeded load vector is deleted for the final time step for each design variable. Remarks: 1. PXT, UXT1 and PXT1 can be purged. 2. If no truncation is desired, specify TOL for TOL1. For example: DSAR UXT,TOL,TOL,/ UDISP,UVELO,UACCE,,/0 $ NX Nastran DMAP Programmer’s Guide 9-167 Chapter 9 Descriptions of DMAP Modules and Statements 3. UXT and PXT can have any number of rows. For example, the number of rows can relate to a degree-of-freedom set. 4. All outputs have columns which are consistent with time steps in TOL1. 9.92 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 $ Input Data Blocks: DRSTBL R1TABR AECTRL CASECC EDT Table containing the number of retained responses for each subcase for each of the response types Table of retained first level (direct) (DRESP1 Bulk Data entry) attribute. Table of aerodynamic model‘s control definition Table of Case Control command images 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 Data Blocks: CASEA UXU UXR A single record (subcase) of CASECC for aerodynamic analysis Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of unrestrained stability derivatives Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of restrained 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. 9-168 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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. 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. Input/output-integer-no default. Trim subcase counter. 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. Output-real-no default. Mach number. Output-real-no default. Dynamic pressure. Output-real-no default. Aeroelastic feedback dynamic pressure ratio. SDFLG NSKIP LPFLG MACH Q AEQRATIO Remarks: DSARLP performs a function for static aeroelastic sensitivity analysis that is similar to the AELOOP module for static aeroelastic analysis. 9.93 DSARME Computes RMS values Computes the RMS values for random response analysis in design sensitivity. Format: DSARME UPDST,RMSTAB,CFSAB/ RMSVAL $ Input Data Blocks: UPDST RMSTAB CFSAB Table of transfer function data needed for RMS calculations Table of RMS responses Matrix of spectral densities–weighting factors for RMS calculations Output Data Blocks: RMSVAL Matrix of initial RMS values NX Nastran DMAP Programmer’s Guide 9-169 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: None. Remarks: None. 9.94 DSARSN Calculates delta response values for trim variables and stability derivatives Format: DSARSN CASEA,R1TABR,AECTRL,DUX,TR,AERO,DSTABU,DSTABR/ DELX1,DELS1/ TFLG/SDFLG/Q $ Input Data Blocks: CASEA R1TABR AECTRL DUX TR AERO DSTABU DSTABR A single record (subcase) of CASECC for aerodynamic analysis Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes Table of aerodynamic model‘s control definition Matrix of aerodynamic extra point displacements for the perturbed configuration Matrix to transform forces from the support point to the aerodynamic reference point Table of control information for aerodynamic analysis Matrix of unrestrained perturbed dimensional stability derivatives Matrix of restrained perturbed dimensional stability derivatives Output Data Blocks: DELX1 DELS1 Matrix of delta trim variable responses for all design variables for a single trim subcase Matrix of delta stability derivative responses for all design variables for a single trim subcase 9-170 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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. 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. Input-real-no default. Dynamic pressure. SDFLG Q Remarks: 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. 9.95 DSAW Calculates delta-weight and/or delta-volume for each design variable Format: DSAW DRSTBL,TABEV2,VELEM,VELEMN,R1TABR/ DELVS,WTCRID,WTDSCP/ CFDFLG $ Input Data Blocks: DRSTBL TABEV2 VELEM VELEMN R1TABR Table containing the number of retained responses for each subcase for each of the response types Merged cross reference table of TABEVP and TABEVS Table of element lengths, areas, and volumes Table of element lengths, areas, and volumes for the perturbed configuration Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes Output Data Blocks: DELVS WTCRID WTDSCP Matrix of delta volume for all design variables Table of retained weight responses with column and row numbers in rigid mass matrix Partitioning vector for weight NX Nastran DMAP Programmer’s Guide 9-171 Chapter 9 Descriptions of DMAP Modules and Statements Parameter: CFDFLG Input-integer-default=0. Central finite difference flag. 1 means forward and -1 backward. 9.96 DSDVRG Computes weighting factors to calculate retained divergence response sensitivities Format: DSDVRG DSEDV,DIVTAB,PHIDRLR,PHIDLLR,QLLX/ DELDV $ Input Data Blocks: DSEDV DIVTAB PHIDRL PHIDLL QLL Partitioning vector for retained divergence responses Table of aerostatic divergence data for all subcases Retained right divergence eigenvector responses Retained left divergence eigenvector responses Aerodynamic matrix for divergence analysis Output Data Blocks: DELDV Matrix of divergence sensitivity Parameters: None. 9.97 DSFLTE Calculates right and left eigenvectors for a given eigenvalue Calculates the right and left eigenvectors for a given eigenvalue that has been extracted in a flutter analysis and has been flagged for sensitivity analysis. Selected complex scalar quantities required for flutter sensitivity analysis are also computed. Format: DSFLTE KHH,BHH,MHH,QHHL,FLUTAB,R1TABR,CASECC,CPHP,LCPHP/ CPHFL,CPHFR,VTQU/FCSENS $ 9-172 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: KHH BHH MHH QHHL FLUTAB R1TABR CASECC CPHP LCPHP Generalized (modal) stiffness matrix Generalized (modal) damping matrix Generalized (modal) mass matrix Aerodynamic matrix list Flutter summary table for all subcases Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes Table of Case Control command images Complex eigenvector matrix in the p-set Left-handed complex eigenvector matrix in the p-set Output Data Blocks: CPHFL CPHFR VTQU Left flutter eigenvector - h-set Right flutter eigenvector - h-set Table of flutter sensitivity data Parameters: FCSENS Input-integer-default=1. Flutter/complex eigenvalue sensitivity flag. 1: Flutter sensitivity 2: Complex eigenvalue sensitivity Remarks: The calculations in DSFLTE closely follow those used in module FA1 to perform the p-k method of flutter analysis. 9.98 Format: DSFLTF DSFLTF Calculates sensitivity of active flutter responses VTQU,CDELK,CDELB,CDELM/DELFL/FCSENS $ NX Nastran DMAP Programmer’s Guide 9-173 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: CDELK CDELB CDELM VTQU Triple matrix product for flutter stiffness sensitivity Triple matrix product for flutter damping sensitivity Triple matrix product for flutter mass sensitivity Table of flutter sensitivity data Output Data Block: DELFL Matrix of delta flutter responses for all design variables Parameters: FCSENS Input-integer-default=1. Flutter/complex eigenvalue sensitivity flag. 1: Flutter sensitivity 2: Complex eigenvalue sensitivity 9.99 DSMA 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 $ Format for statics: Format for normal modes: DSMA DSPT2,DSEGM,,,,/ DSCMR,/ APP $ Input Data Blocks: DSPT2 DSEGM Old design sensitivity processor table two Old design sensitivity eigenvalue gradient matrix 9-174 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OUG1DS OES1DS OEF1DS OES1CDS OEFITDS UNUSED2 Table of displacements in SORT1 format for design responses Table of element stresses in SORT1 format for design responses Table of element forces in SORT1 format for design responses Table of composite element stresses in SORT1 format for design responses Table of composite element failure indices for design responses Unused and can be purged Output Data Blocks: DSCMR Old combined design sensitivity/constraint matrix Parameters: APP Input-character-default=‘STATICS’ Analysis type. Allowable values are: ‘STATICS’: Statics ‘BUCKL’: Buckling ‘MODES’: Normal modes Remarks: 1. DSMA is applicable only to old sensitivity analysis. 2. DSPT2 cannot 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. 9.100 DSPRM Sets design sensitivity parameters Sets design sensitivity parameters based on retained responses for DMAP flow control. Format: DSPRM DRSTBL// S,N,WGTVOL/S,N,DOBUCK/S,N,DOMODES/S,N,DOSTAT/ S,N,FAILI/S,N,CSTRES/S,N,CSTRN/S,N,DOFREQ/ S,N,DOCEIG/S,N,DOMTRAN/S,N,DODIVG/S,N,DOSAERO/S,N, DOFLUT/ S,N,DOANALY/S,N,DOSASTAT/ADJFLGG/S,N,DOFSPCF/ S,N,DOTSPCF/S,N,DOWGHT/S,N,DOESE/S,N,DOSSPCF/ S,N,DORMS $ NX Nastran DMAP Programmer’s Guide 9-175 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Block: DRSTBL Table containing the number of retained responses for each subcase for each of the response types Output Data Blocks: None. Parameters: WGTVOL Output-integer-default=0. Weight/volume retained response flag. Set to >0 if any retained response. 1 2 3 DOBUCK DOMODES DOSTAT FAILI CSTRES CSTRN DOFREQ DOCEIG DOMTRAN DODIVG DOSAERO DOFLUT Weight only Volume only Weight and volume Output-integer-default=0. Buckling constraint flag. Set to >0 if any constraint. Output-integer-default=0. Normal modes constraint flag. Set to >0 if any constraint. Output-integer-default=0. Statics constraint flag. Set to >0 if any constraint. Output-integer-default=0. Composite failure index constraint flag. Set to >0 if any constraint. Output-integer-default=0. Composite lamina stress constraint flag. Set to >0 if any constraint. Output-integer-default=0. Composite lamina strain constraint flag. Set to >0 if any constraint. Output-integer-default=0. Frequency response retained response flag. Set to >0 if any retained response. Output-integer-default=0. Complex eigenvalue response retained response flag. Set to >0 if any retained response. Output-integer-default=0. Transient response retained response flag. Set to >0 if any retained response. Output-integer-default=0. Divergence analysis retained response flag. Set to >0 if any retained response. Output-integer-default=0. Aerostatic trim or stability derivative retained response flag. Set to >0 if any retained response. Output-integer-default=0. Flutter analysis retained response flag. Set to >0 if any retained response. 9-176 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DOANALY DOSASTAT ADJFLG Output-integer-default=0. Any analysis retained response flag. Set to >0 if any retained response. Output-integer-default=0. Statics or aerostatic retained response flag. Set to >0 if any retained response. Input-integer-default=0. Adjoint sensitivity flag. 0 1 2 No adjoint sensitivity Adjoint sensitivity for static analysis Adjoint sensitivity for frequency response analysis DOFSPCF DOTSPCF DOWGHT DOESE DOSSPCF DORMS Output-integer-default=0. Frequency response retained SPCforce response flag. Set to >0 if any retained response. Output-integer-default=0. Transient response retained SPCforce response flag. Set to >0 if any retained response. Output-integer-default=0. Weight retained response flag. Set to >0 if any retained response. Output-integer-default=0. Static analysis retained element strain energy response flag. Set to >0 if any retained response. Output-integer-default=0. Static analysis retained SPCforce response flag. Set to >0 if any retained response. Output-integer-default=0. RMS response retained response flag. Set to >0 if any retained response. Remarks: RSP1CT can be specified as input to DSPRM. 9.101 DSTA Creates tables for Old Design Sensitivity Analysis only Creates tables related to the design perturbation in Old Design Sensitivity Analysis only. NX Nastran DMAP Programmer’s Guide 9-177 Chapter 9 Descriptions of DMAP Modules and Statements Format: DSTA Input Data Blocks: ECT EPT EST CASECC EDOM UG LAMA BLAMA CASECCX ETT DIT MPT Element connectivity table Table of Bulk Data entry images related to element properties Element summary table Table of Case Control command images. of static loads Table of Bulk Data entries related to design sensitivity and optimization Displacement matrix in g-set from static analysis Normal modes eigenvalue summary table Buckling eigenvalue summary table Table of Case Control command images used to generate static loads Element temperature table Table of TABLEij Bulk Data entry images Table of Bulk Data entry images related to material properties Output Data Blocks: ESTDVP ESTDCN CASEDS EST with element property design variable perturbations Element summary table which incorporates combined constraints and design variables Case control table for the data recovery of design responses 9-178 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DSESM Design sensitivity eigenvector selection matrix – Boolean operator to select eigenvectors which are referenced by constraints (buckling and normal modes only). Table of design variable and constraint internal identification numbers for the effects of temperature Design sensitivity processing table Old Design sensitivity processor table two Table of design sensitivity row labels for design sensitivity matrix, DSCMR Table of design sensitivity column labels for design sensitivity matrix, DSCMR Element temperature table where the original element identification numbers have been converted to new design variable identification numbers. Copy of MPT except MAT8 records are replaced by equivalent MAT2 records Copy of EPT except PCOMP records are replaced by equivalent PSHELL records ETTDCN DSPT1 DSPT2 DSROWL DSCOLL ETTDV MPTC EPTC Parameters: APP Input-character-default=‘STATICS’ Analysis type. Allowable values are: ‘STATICS’: statics ‘BUCKL’: buckling ‘MODES’: normal modes NOPRT NOSAVE NOFORT NEIG 0 >0 Output-integer-default=0. Print flag. Set to 1 if PRINT is requested on the SENSITY Case Control command. Output-integer-default=-1. Data base store flag. Set to 0 if SAVE is requested on the SENSITY Case Control command. Output-integer-default=-1. OUTPUT4 flag. Set to 0 if FORT is requested on the SENSITY Case Control command. Input-integer-default=0. Number of eigenvalues to keep. Keep all eigenvalues Keep first NEIG-th eigenvalues Remarks: 1. ETT, ETTDV, and ETTDC can be purged if no element temperature data exists. NX Nastran DMAP Programmer’s Guide 9-179 Chapter 9 Descriptions of DMAP Modules and Statements 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. 9.102 Format: DSTAP2 DSTAP2 Creates correlation table for normalized design sensitivity coefficient matrix R1TABRG,RSP2RG,RSP3RG/ DSCMCOL,DSIDLBL/ UNUSED1/UNUSED2/UNUSED3 $ Input Data Blocks: R1TABRG RSP2RG RSP3RG Table of attributes of the retained first level (direct) responses Table of attributes of the retained second level (synthetic) responses Table of attributes of the retained third level responses Output Data Blocks: DSCMCOL DSIDLBL Correlation table for normalized design sensitivity coefficient matrix Table of design response labels Parameters: UNUSEDi Input-integer-default=0. Unused. 9.103 Format: DSVG1 DSVG1 Creates pseudo loads or scalar terms required in sensitivity analysis 9-180 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: XDICTDS XELMDS BGPDT SIL CSTM XDICT XELM UGX AGX VG LAMA DSPT1 Perturbed element matrix dictionary table. If CDIF=‘YES,’this is the forward or backward perturbed element matrix dictionary. Table of perturbed element matrices. If CDIF=‘YES,’this is the forward or backward perturbed element matrices. Basic grid point definition table Scalar index list Table of coordinate system transformation matrices Baseline element matrix dictionary table Baseline element matrices Displacement matrix in g-set. For transient response analysis, UGX can also represent velocity or acceleration. Gravity/thermal load matrix due to volumetric changes for the central, forward, or backward perturbed configuration Left-handed displacement matrix in g-set. Divergence and flutter analysis only. Normal modes or buckling eigenvalue summary table Design sensitivity processing table Output Data Blocks: EGX Pseudo-load (equilibrium variation) matrix in the g-set Parameters: NOK4GG Input-integer-default=-1. Structural damping generation flag. -1 Do not generate 0 WTMASS IAPP Generate Input-real-default=1.0. Specifies scale factor on structural mass matrix. Input-integer-default=1. Analysis type. Allowable values are: 1 2 4 Statics, aerostatic, frequency, or transient response Buckling or normal modes Flutter or divergence NX Nastran DMAP Programmer’s Guide 9-181 Chapter 9 Descriptions of DMAP Modules and Statements DSVGF Input-integer-default=0. Specifies scaling of solution vector by eigenvalue. 0 1 No scaling Scale NOPSLG Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load generation is requested for the current superelement based on the SEDV Case Control command. 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, a null EGX matrix is generated. 9.104 Format: DSVG1P DSVG1P Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis ESTDVM,ESTDV2,BGPDVP,CSTM,MPTX,DIT,DEQATN,DEQIND, UGX,LFTAB,DSPT1,GPSNT,ESTDVB/ EGK,EGM/ COUPMASS/K6ROT/ALTSHAPE/WTMASS/NOPSLG/OPTFLG/ UNUSED7 $ Input Data Blocks: ESTDVM ESTDV2 BGPDVP CSTM MPTX DIT DEQATN DEQIND EST with updated material property identification numbers Merged EST with grid and element property design variable perturbations. If CDIF=‘YES,’this is the forward perturbation. Basic grid point definition table for the forward (or central) perturbed configuration Table of coordinate system transformation matrices MPT with design variable perturbations Table of TABLEij Bulk Data entry images Table of DEQATN Bulk Data entry images Index table to DEQATN data block 9-182 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UGX DSPT1 LFTAB GPSNT ESTDVB Matrix of analysis model displacements in g-set or p-set Design sensitivity processing table Table of eigenvalues and generalized masses for retained normal mode eigenvalue responses Grid point shell normal table Element summary table for the backward perturbed configuration. Required only if CDIF=‘YES’ Output Data Blocks: EGK EGM Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness Pseudo-load (equilibrium variation) matrix in the g-set due to mass Parameters: COUPMASS Input-integer-default=-1. Coupled mass generation flag. -1 Lumped 0 K6ROT ALTSHAPE Coupled Input-real-default=-1.0. Normal rotational stiffness factor for CQUAD4 and CTRIA3 elements. 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. Input-real-default=-1.0. Specifies scale factor on structural mass matrix. Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load generation is requested for the current superelement based on the SEDV Case Control command. Input-integer-default=0. DSVG1P application method: 1 2 3 Statics Normal modes Acceleration load WTMASS NOPSLG OPTFLG UNUSED7 Input-integer-default=0. Unused. NX Nastran DMAP Programmer’s Guide 9-183 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: If NOPSLG ≠ 0, a null EGX matrix is generated. 9.105 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 Input Data Blocks: BGPDVX CSTM SIL KDICTX CASDSN PTELEM PTELMDSX UGX AGX DSPT1 Basic grid point definition table for the central, forward, or backward perturbed configuration Table of coordinate system transformation matrices Scalar index list Baseline element stiffness matrix dictionary table for h-elements or p-elements Case Control table with unneeded analysis subcase(s) deleted, excluding static aeroelastic subcases Table of thermal loads in the elemental coordinate system Table of thermal loads in the elemental coordinate system for the central, forward, or backward perturbed configuration Matrix of analysis model displacements in g-set or p-set Gravity/thermal load matrix due to volumetric changes for the central, forward, or backward perturbed configuration Design sensitivity processing table 9-184 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: EGTX Pseudo-load matrix (variation in equilibrium) due to changes in the thermal load/design variables for the central, forward, or backward perturbed configuration Parameters: PEXIST HPFLAG Input-logical-default=FALSE. Set to TRUE if p-elements are present. Input-integer-default=1. Element type processing flag. 1 2 h-element p-element Remarks: CSTM and BGPDT can be purged. 9.106 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 $ Input Data Blocks: UG UGDS Displacement matrix in g-set from the analysis Displacement matrix in g-set due to pseudo-loads Output Data Block: UGDS1 Displacement matrix in g-set for the total variation Parameters: None. NX Nastran DMAP Programmer’s Guide 9-185 Chapter 9 Descriptions of DMAP Modules and Statements 9.107 DSVGP4 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/ DELTGM,DVSLIS/ LUSET/NDVTOT/S,N,RGSENS $ Input Data Blocks: DGTAB EQEXIN GEOM4 RMG GM USET CSTM BGPDVP Table relating DTOS4 records and designed grid data. Correlation table of internal grid sequence for the baseline and perturbed configuration. Equivalence table between external and internal grid/scalar identification numbers Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Multipoint constraint equation matrix Multipoint constraint transformation matrix, m-set by n-set Degree-of-freedom set membership table for g-set Table of coordinate system transformation matrices Basic grid point definition table for the forward (or central) perturbed configuration Output Data Blocks: DELTGM DVSLIS Multipoint constraint transformation matrix for the perturbed configuration List of design variables affected by shape variations Parameters: LUSET NDVTOT RGSENS Input-integer-default=0. The number of degrees-of-freedom in the g-set. Input-integer-default=0. Number of unique referenced design variables. Output-logical-default=FALSE. Rigid element sensitivity flag. 9-186 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Remarks: 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. 9.108 DSVGP5 Performs multiplication of two matrices Performs multiplication of two matrices with one matrix having multiple submatrices and, optionally, the addition of a third matrix to the product. For example, the default (IOPT=0 or T=0) result is: [ A1 * B | A2 * B | A3 * B | . . . An * B ] + [ C1 | C2 | C3 | . . . | Cn ] Format: DSVGP5 A,B,C,DVSLIS/ D/ NSMATS/T/IOPT $ Input Data Blocks: A B C DVSLIS Matrix with NSMATS number of submatrices Submatrix multiplier Additive matrix to be added to product of A and B. Used only if IOPT=0 or 2. List of design variables affected by shape variations Output Data Block: D Matrix product Parameters: NSMATS T Input-integer-default=0. Number of submatrices in A. Input-integer-default=0. Ai submatrix transpose flag. Applicable only when IOPT=0. 0 1 IOPT No transpose of Ai (default) Transpose Ai Input-integer-default=0. DSVGP5 method. T is ignored when IOPT>0. 0 1 Ai * B + Ci (default) B * Ai NX Nastran DMAP Programmer’s Guide 9-187 Chapter 9 Descriptions of DMAP Modules and Statements 2 Same as 0 except diagonal is extracted from Ai * B + Ci and stored as a column in D. Remarks: 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. 9.109 DTIIN Input DTI entries to DMAP Input tables referenced on DTI Bulk Data entries. Format: DTIIN DTI,DTINDX/DTI1,DTI2,DTI3,DTI4,DTI5,DTI6,DTI7, DTI8,DTI9,DTI10/PARM1/PARM2/PARM3/PARM4/PARM5/ PARM6/PARM7/PARM8/PARM9/PARM10 $ Input Data Blocks: DTI DTlNDX Collection of tables specified on DTI Bulk Data entries (from IFP) Index into DTI (from IFP) Output Data Blocks: DTIi Names that appear on field 2 of the DTI entries (that is, the DTI table called DTI1) is output on data block DTI1. Parameters: PARMi Output-logical-default = FALSE. If the i-th output data block is generated, PARMi=TRUE. Remarks: 1. The input data blocks DTI and DTINDX are output from the preface module IFP. 2. Any output data block can be purged. Example: Assume the Bulk Data contains three DTI tables named T1, T2, and T3. The following DMAP instruction creates the data blocks T1 and T3. DTIIN DTI,DTINDX/T1,T3,,,,,,,,/S,N,YEST1/S,N,YEST3 $ 9-188 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.110 Format: DUMMOD1 DUMMOD1 Provides dummy module for inclusion of user written subroutines and modules 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 $ Input Data Blocks: IDBi Table or matrix Output Data Blocks: ODBi Table or matrix Parameters: IPARMi RPARMi CHPARM RDPARM CPARM CDPARM Input/output-integer-default=-1 Input/output-real-default=-1.0 Input/output-character-default=‘ABCDEFGH’ Input/output-real double precision-default=-1.D0 Input/output-complex-default=(-1.0,-1.0) Input/output-complex double precision-default=(-1.D0, 1.0D0) 9.111 Format: DUMMOD2 DUMMOD2 Provides dummy module for inclusion of user written subroutines and modules 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 $ Input Data Blocks: IDBi Table or matrix NX Nastran DMAP Programmer’s Guide 9-189 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: ODBi Table or matrix Parameters: IPARMi RPARMi CHPARM RDPARM CPARM CDPARM Input/output-integer-default=-1 Input/output-real-default=-1.0 Input/output-character-default=‘ABCDEFGH’ Input/output-real double precision-default=-1.D0 Input/output-complex-default=(-1.0,-1.0) Input/output-complex double precision-default=(-1.D0, 1.0D0) 9.112 Format: DUMMOD3 DUMMOD3 Provides dummy module for inclusion of user written subroutines and modules 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 $ Input Data Blocks: IDBi Table of matrix Output Data Blocks: ODBi Table of matrix Parameters: IPARMi RPARMi CHPARM RDPARM CPARM Input/output-integer-default=-1 Input/output-real-default=-1.0 Input/output-character-default=‘ABCDEFGH’ Input/output-real double precision-default=-1.D0 Input/output-complex-default=(-1.0,-1.0) 9-190 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0) 9.113 DUMMOD4 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 $ Input Data Blocks: IDBi Table of matrix Output Data Blocks: ODBi Table of matrix Parameters: IPARMi RPARMi CHPARM RDPARM CPARM CDPARM Input/output-integer-default=-1 Input/output-real-default=-1.0 Input/output-character-default=‘ABCDEFGH’ Input/output-real double precision-default=-1.D0 Input/output-complex-default=(-1.0,-1.0) Input/output-complex double precision-default=(-1.D0, 1.0D0) 9.114 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. NX Nastran DMAP Programmer’s Guide 9-191 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: CASECC OINT PELSET ESTDCN TABECN BGPDVP CSTM Table of Case Control command images P-element output control table. Contains OUTPUT and OUTRCV Bulk Data entries. P-element set table, contains SETS DEFINITIONS Element summary table which incorporates combined constraints and design variables Table of relationship between internal identification numbers of constraints in ESTDCN and elements and responses in R1TABR Basic grid point definition table for the forward (or central) perturbed configuration Table of coordinate system transformation matrices Output Data Blocks: VIEWTBDS View information table, contains the relationship between each p-element and its view-elements and view-grids for the perturbed model Parameters: VUGNEXT VUENEXT VUGJUMP VUELJUMP VUHEXA VUPENTA VUTETRA Input/output-integer-default=0. Starting identification number for next view-grid. Input/output-integer-default=0. Starting identification number for next view-element Input-integer-default=1000. Delta between view-grid identification numbers. Input-integer-default=1000. Delta between view-element identification numbers. Input-character-default=‘VUHEXA’ Name for VUHEXA element. Input-character-default=‘VUPENTA’ Name for VUPENTA element. Input-character-default=‘VUTETRA’ Name for VUTETRA element. 9-192 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements VUQUAD4 VUTRIA3 VUBEAM VUEXIST Input-character-default=‘VUQUAD4’ Name for VUQUAD4 element. Input-character-default=‘VUTRIA3’ Name for VUTRIA3 element. Input-character-default=‘VUBEAM’ Name for VUBEAM element. Output-logical-default=FALSE. View-element flag. Set to TRUE if view-elements exist. 9.115 DYNREDU Computes approximate eigenvectors Format: DYNREDU LXX,MXX,CASECC,DYNAMIC/ PHZ,MZZ/ NOZSET/NOYSET/EPSMALC/EPSBIG/S,N,NOBSET0/NORSET $ Input Data Blocks: LXX MXX CASECC DYNAMIC Lower triangular factor/diagonal of shifted stiffness matrix Mass matrix in any set. Usually v-set. Table of Case Control command images Table of Bulk Data entry images related to dynamics Output Data Blocks: PHZ MZZ Generalized degree-of-freedom transformation matrix Generalized mass matrix based on PHZ Parameters: NOZSET NOYSET EPSMALC EPSBIG Input-integer-no default. Number of generalized degrees-of-freedom. Also number of columns in PHZ. Input-integer-no default. Number of generalized degrees-of-freedom with non-null columns in PHZ. Input-real-no default. Small number for tuning. Input-real-no default. Large number for tuning. NX Nastran DMAP Programmer’s Guide 9-193 Chapter 9 Descriptions of DMAP Modules and Statements NOBSET0 NORSET Output-integer-default=0. Number of null columns in PHZ in front of non-null columns. Input-integer-default=0. Number of degrees-of-freedom in the r-set. Remarks: UGS recommends that NOZSET be equal to NOYSET and NOBSET not be specified; that is, DYNREDU LXX,MXX,CASECC,DYNAMIC/ PHY,MYY/ NOYSET/NOYSET/EPSMALC/EPSBIG//NORSET $ 9.116 EFFMASS Computes modal effective mass Compute the modal effective mass based on the normal modes. Format: EFFMASS CASECC,MAA,PHA,LAMA,USET,BGPDT,UNUSED,CSTM,VGQ/ TEMF,EMM,DMA,MEMF,MPFEM,MEM,MEW/ SEID/WTMASS/S,N,CARDNO/SETNAM/IUNIT/EFOPT $ Input Data Blocks: CASECC MAA PHA LAMA USET BGPDT UNUSED CSTM VGQ Table of Case Control command images Mass matrix in a-set or g-set Normal modes eigenvector matrix in the a-set or g-set Normal modes eigenvalue summary table Degree-of-freedom set membership table for g-set Basic grid point definition table Unused Table of coordinate system transformation matrices Partitioning vector which is g-set size and contains values of 1.0 at rows corresponding to degrees-of-freedom in the q-set Output Data Blocks: TEMF EMM Total effective mass fraction table Effective mass matrix 9-194 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MA MEMF MPFEM MEM MEW Rigid body mass matrix for the a-set Modal effective mass fraction table Modal participation factors for effective mass Modal effective mass matrix Modal effective weight matrix Parameters: SEID WTMASS CARDNO Input-integer-no default. Superelement identification number. Input-real-no default. Scale factor on structural mass matrix. See the NX Nastran Quick Reference Guide. Input/output-integer-default=0. Punch file line counter. CARDNO is incremented by one for each line written to the punch file and is also written into columns 73-80 of each line. Input-character-default=‘g’ Degree-of-freedom set name. Input-integer-no default. IUNIT is the Fortran unit number on which the data blocks are to be written if the PLOT option is requested. Input-integer-default=0. When set to 1, ignores case control parameters and forces output of all results. SETNAM IUNIT EFOPT Remarks: None. 9.117 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 $ Input Data Blocks: OGPFB1 Table of grid point forces in SORT1 format NX Nastran DMAP Programmer’s Guide 9-195 Chapter 9 Descriptions of DMAP Modules and Statements GPECT CSTM SIL GPL BGPDT Grid point element connection table Table of coordinate system transformation matrices Scalar index list External grid/scalar point identification number list Basic grid point definition table Output Data Blocks: OELOF1 OELOP1 Table of element oriented forces connected to common grid points in SORT1 format Table of element-oriented forces oriented along adjacent element edge directions and summations of these components on equivalent edges in SORT1 format Parameters: NOELOF Input-integer-default=0. OELOF1 generation flag. <0 0 NOELOP Do not generate Generate Input-integer-default=0. OELOP1 generation flag. <0 0 Do not generate Generate UNUSED3 Input-integer-default=0. Unused. 9.118 Format: ELTPRT ELTPRT Prints element summary information ECT,GPECT,BGPDT,UNUSED4,EST,CSTM,MPT,DIT,CASECC/ VELEM/ PROUT/S,N,ERROR/WTMASS $ Input Data Blocks: ECT Element connectivity table 9-196 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GPECT BGPDT UNUSED4 EST CSTM MPT DIT CASECC Grid point element connection table Basic grid point definition table Unused and can be purged Element summary table Table of coordinate system transformation matrices Table of Bulk Data entry images related to material properties for ELSUM command Table of TABLEij Bulk Data entry images for ELSUM command Table of Case Control command images Output Data Block: VELEM Table of element lengths, areas, and volumes Parameters: PROUT Input-integer-default = 0. Print control for options 1, 2, and 4 is listed in Remark 1. This parameter is meaningful only if the input data block ECT is specified. For options 1 and 2, if PROUT is set to a positive integer value or to zero (default), the output includes a list of the element types and the identification numbers of all elements. For option 4, if PROUT = 0 or 1, VELEM is computed and printed. If PROUT = 2, VELEM is computed but not printed. ERROR Integer-output-default = 0. If duplicate element identification numbers exist, ERROR is set to -1. This parameter is meaningful only when the input data block ECT is not purged. Input-real-default=1.0. Scale factor on structural mass matrix. WTMASS Remarks: 1. Selected combinations of the input data blocks can be omitted in order to suppress the output of one or more of the four output options listed below. These combinations are indicated in the table below. Option 1: A sorted list of element identification numbers Option 2: A list of duplicate element identification numbers Option 3: A list of grid points with the elements that connect to each grid point. Both the element type and element identification number are listed. NX Nastran DMAP Programmer’s Guide 9-197 Chapter 9 Descriptions of DMAP Modules and Statements Option 4: 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, it is also printed. Create data block with element volumes. Option ECT 1 2 3 4 2. For Options 1 and 2 the output contains the following items. • Identify all duplicate elements, for example, **** 10 ROD. 10 BAR. Data blocks to be included to activate output options GPECT BGPDT EST CSTM • Identify each element type and the range of element IDs for the element type, for example, "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 causes the run to terminate if duplicate IDs exist (options 1 and 2). ELTPRT ECT,,,,//1/S,N,ERROR $ IF (ERROR <0) EXIT $ If no duplicate IDs exist, the run proceeds 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/ $ 9.119 Format: EMA EMA Assembles global g-set size matrix from elemental matrices GPECT,XDICT,XELM,BGPDT,SIL,CSTM,XDICTP,XELMP/ XGG,UNUSED2/ NOK4GG/WTMASS $ 9-198 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: GPECT XDICT XELM BGPDT SIL CSTM XDICTP XELMP Grid point element connection table Element matrix dictionary table Table of element matrices Basic grid point definition table Scalar index list Table of coordinate system transformation matrices Element matrix dictionary table for p-elements Table of element matrices for p-elements Output Data Blocks: XGG UNUSED2 Global matrix of g-set size Not used and can be purged Parameters: NOK4GG Input-integer-default=-1. Structural damping generation flag. -1 Do not generate 0 WTMASS Generate; that is, apply GE (on MATi entry) to stiffness Input-real-default=1.0. Specifies scale factor on structural mass matrix. Remarks: EMA is used to generate stiffness (KGG), mass (MGG), damping (BGG), and structural damping (K4GG) matrices. 9.120 EMAKFR 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 $ NX Nastran DMAP Programmer’s Guide 9-199 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: BGPDT CSTM SLT MGG CSTM0 SCSTM Basic grid point definition table Table of coordinate system transformation matrices Table of static loads Mass matrix in g-size Table of coordinate system transformation matrices for the residual structure Table of global transformation matrices for partitioned superelements Output: KRFGG Stiffness matrix due to follower rotational forces in g-set Parameters: LOADID LOADIDP SEID LOADFACR SYS66 Input-integer-no default. Load set identification number for the current subcase. Input-integer-default=0. Load set identification number for the previous subcase. Input-integer-default=0. Superelement identification number. Input-real-default=1.0. Load factor in nonlinear static analysis. (Same as LOADFAC except real.) 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: Ptotal = LOADFACR • PLOADID + (1.0 − LOADFACR) • PLOADID 9.121 Format: EMC EMC Create final contact stiffness for current status CNELM,ECSTAT,ELCNST,ELCTST/KELMC,KDICTC/ S,N,NOKGGC/CONV/CITO 9-200 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: CNELM ECSTAT ELCNST ELCTST Contact element definition table. Contact element status table Contact element normal stiffness table. Contact element tangential stiffness table. Output Data Blocks: KELMC KDICTC Contact element matrix dictionary table. Table of contact element matrices. Parameters: NOKGGC Input-integer. KELMC and KDICTC generation flag. > -1 CONV Generated Not generate Input-integer. Converged solution flag. 0: Converged 1: Not converged CITO Input-integer. Contact outer (status) loop counter. 9.122 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,EBOLT/ KELM,KDICT,MELM,MDICT,BELM,BDICT/ 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,UNUSED $ NX Nastran DMAP Programmer’s Guide 9-201 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: EST CSTM MPT DIT UNUSED5 UG ETT EDT DEQATN DEQIND BGPDT GPSNT ECTA EPTA EHTA DITID EBOLT Element summary table Table of coordinate system transformation matrices Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Unused and can be purged Displacement matrix in g-set. Required only for differential stiffness generation. Element temperature table Table of Bulk Data entry images related to element deformation. Required only for differential stiffness generation. Table of DEQATN Bulk Data entry images Index table to DEQATN data block Basic grid point definition table Grid point shell normal table Secondary element connectivity table Secondary table of Bulk Data entry images related to element properties Secondary element hierarchical table Table of identification numbers in DIT Table of element ids of bolt elements Output Data Blocks: KELM KDICT MELM MDICT BELM BDICT Table of element matrices for stiffness, heat conduction, differential, or follower stiffness KELM dictionary table Table of element mass matrices MELM dictionary table Table of element damping or heat capacity matrices BELM dictionary table 9-202 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: NOKGG Input/output-integer-default=-1. KELM and KDICT generation flag. Input ≥ -1 Generate Do not generate Output > -1 NOMGG NOBGG NOK4GG Generated Not generated Input/output-integer-default=-1. Same as NOKGG except for MELM and MDICT. Input/output-integer-default=-1. Same as NOKGG except for BELM and BDICT. Input/output-integer-default=1. Structural damping generation flag. Set to -1 if a nonzero damping constant (GE field on MATi Bulk Data entry) is not found for any element. Output-integer-default=-1. Nonlinear heat transfer or differential stiffness generation flag. Set to 1 if nonlinear heat transfer elements are detected. On input: >3 <3 Compute geometric nonlinear effects Do not compute geometric nonlinear effects NONLHT On output: -1 1 COUPMASS if no nonlinear material was found in a heat transfer problem Otherwise Input-integer-default=-1. Coupled mass generation flag. -1 0 Lumped Coupled TEMPSID Input-integer-default=-1. Temperature set identification number. Usually obtained from the TEMPERATURE Case Control command. Required for use in stress recovery of differential stiffness. Input-integer-default=-1. Element deformation set identification number. Usually obtained from the DEFORM Case Control command. Required for use in stress recovery of differential stiffness. DEFRMID NX Nastran DMAP Programmer’s Guide 9-203 Chapter 9 Descriptions of DMAP Modules and Statements PENFAC NOPNLT LUMPB LUMPM MATCPX KDGEN Input-real-default=0.0. Penalty factor for electromagnetic elements. Input-integer-default=-1. Penalty function flag for electromagnetic elements. Input-real-default=0.0. Lumping factor for electromagnetic damping. Input-real-default=0.0. Lumping factor for electromagnetic mass. Input-integer-default=-1. Complex material properties flag for electromagnetic elements. Input-integer-default=0. Differential or follower stiffness matrix generation flag. Usually the column number in UG to use in differential stiffness matrix generation. If KDGEN is negative, follower stiffness is generated. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit. Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input-real-default=0.0. Normal rotational stiffness factor for CQUAD4 and CTRIA3 elements. Input-integer-default=1. Large rotation calculation method: 1 2 Fimbal angle Rotation vector TABS SIGMA K6ROT LANGLE NOBKGG ALTSHAPE Input-integer-default=0. Slideline contact stiffness generation flag. Set to 1 to generate slideline contact stiffness. 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. Input-logical-default=FALSE. P-element flag. Set to TRUE if p-elements are present and to be processed. Input-character-default=’ ’ Frequency dependent element processing mode ‘ESTF’Compute frequency dependent stiffness ‘ESTNF’Compute nominal frequency dependent stiffness PEXIST FREQTYP FREQVAL FREQWA Input-real-default=0.0. Frequency value for frequency dependent element generation. Input-real-default=0.0. Parameter for electromagnetic analysis. 9-204 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UNSYMF Input-character-default=‘NO’ Unsymmetric stiffness generation for slideline contact stiffness. If set to ‘YES‘, stiffness matrix is unsymmetric for slideline contact. Output-logical-default=FALSE. Bad geometry was detected. Unused parameter.. BADMESH UNUSED Remarks: 1. CSTM can be purged. MPT can be purged only if elements which do not reference any material data are used. The DIT can 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 is not formed. 9.123 EMR Assemble the Lagrange multiplier partitions into KGG for the Lagrange rigid elements. Format: EMR GEOM4,EQEXIN,SIL,BGPDT,CSTM,KGGBL/KGG/LMFACT/NROWS $ Input Data Block: GEOM4 EQEXIN SIL BGPDT CSTM KGGPL Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity. Equivalence table between external and internal grid/scalar identification numbers. Scalar index list. Basic grid point definition list. Table of coordinate system transformation matrices. Stiffness matrix in G-set before Lagrange Multiplier partition inclusions. Output Data Block: KGG Assembled stiffness matrix in G-set. NX Nastran DMAP Programmer’s Guide 9-205 Chapter 9 Descriptions of DMAP Modules and Statements Parameter: LMFACT NROWS Input-real-default = 1.0. Lagrange multiplier. Input-integer-no default. Number of rows in G-set. 9.124 EQUIVX Data block name equivalence Attaches a second name to an existing data block. Format: EQUIVX DBP/DBS/PARM $ Input Data Block: DBP Primary data block Output Data Block: DBS Secondary data block Parameter: PARM Input-integer-default = 0. Equivalence flag. See Remark 3. 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 PARM < 0, 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, UGS recommends 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: Status with PARM < 0 DBP prior to EQUIVX Generated Purged or Not Generated DBS prior to EQUIVX Any Any DBS after EQUIVX Equivalenced Purged and not equivalenced 9-206 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Status with PARM ≥ 0 DBP prior to EQUIVX Generated Generated Purged or Not Generated DBS prior to EQUIVX Not Equivalenced Equivalenced Any DBS after EQUIVX Unchanged Purged and Not Generated Unchanged 4. If DBS is also declared on the FILE DBS=APPEND statement, User Warning Message 81 is issued. If the EQUIVX.../DBS statement is executed only once and is not re-executed in the DMAP loop, the message can be safely ignored. However, if the EQUIVX statement is potentially re-executed, 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. 9.125 ESTINDX Creates an index, keyed by element identification number Creates an index for the EST table, keyed by element identification number. Format: ESTINDX /EST $ Input Data Blocks: None. Output Data Blocks: EST Element summary table. NX Nastran DMAP Programmer’s Guide 9-207 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: None. Remarks: EST must be declared as an append file on the FILE statement. 9.126 FA1 Prepares the modal matrices for flutter eigenvalue analysis Prepares the modal matrices for flutter eigenvalue analysis. Also performs the eigenvalue analysis for the KE or PK method. Format: FA1 KHH,BHH,MHH,QHHL,CASECC,EDT/ FSAVE,KHH1,BHH1,MHH1/ S,N,FLOOP/S,N,TSTART/S,N,NOCEAD/LPRINT $ Input Data Blocks: KHH BHH MHH QHHL CASECC EDT Generalized (modal) stiffness matrix Generalized (modal) damping matrix Generalized (modal) mass matrix Aerodynamic matrix list Table of Case Control command images 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 Data Blocks: FSAVE KHH1 BHH1 MHH1 Flutter storage save or answer table Modified generalized (modal) stiffness matrix. Modified generalized (modal) damping matrix Modified generalized (modal) mass matrix 9-208 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: FLOOP Input/output-integer-no default. Flutter eigenvalue analysis loop counter. Set to zero for initial entry and incremented by one for each loop until the last loop, then set to -1. Output-integer-no default. CPU clock time at entry to module. Output-integer-default=0. Complex eigenvalue analysis flag. Set to 1 if complex eigenvalue analysis needs to be performed, otherwise, set to -1. Input-logical-default=TRUE. Print flag for flutter analysis. TSTART NOCEAD LPRINT Remarks: BHH can be purged for the K and PK methods. BHH is ignored for the KE method. If BHH is purged, BHH1 can be purged for the K method. 9.127 FA2 Collects aeroelastic flutter data Collects aeroelastic flutter data for reduction and presentation for each loop through the configuration parameters. Format: FA2 CPH1,CLAMA1,FSAVE/ CPH2,CLAMA2,CASEYY,OVG/ S,N,TSTART/VREF/AECONFIG/SYMXY/SYMXY/LPRINT $ Input Data Blocks: CPH1 CLAMA1 FSAVE Complex eigenvector matrix for h-set in flutter analysis Complex eigenvalue summary table in flutter analysis Flutter storage save table Output Data Blocks: CPH2 CLAMA2 CASEYY OVG Appended complex eigenvector matrix for h-set in flutter analysis Appended complex eigenvalue summary table in flutter analysis Appended Case Control table in flutter analysis Table of aeroelastic x-y plot data for V-g or V-f curves NX Nastran DMAP Programmer’s Guide 9-209 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: TSTART Input/output-integer-no default. On input, TSTART is the CPU clock time at entry to FA1. On output, set to -1 if there is insufficient time for another DMAP loop. Input-real-no default. Flutter velocity divisor to obtain flutter indices. Input-character-no default. Aerodynamic configuration. Input-integer-no default. Aerodynamic z-y symmetry flag. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-logical-default=TRUE. Print flag for flutter analysis. VREF AECONFIG SYMXZ SYMXY LPRINT Remarks: All output data blocks must be declared on the FILE statement with the APPEND keyword in order to append outputs from previous loops. 9.128 FBS Matrix forward/backward substitution Solves the matrix equation [A][X] = ±[B] (right-hand solution) or [X]T[A] = [B]T (left-hand solution) using the triangular factors computed by DCMP or DECOMP. Forward-only and backward-only of right-hand solutions can also be provided for factors of symmetric matrices (see Remark 6). Format: FBS LD,U,B/X/KSYM/SIGN/FBTYP $ Input Data Blocks: LD U B Lower triangular factor/diagonal, or Cholesky factor Upper triangular factor. Purged unless [A] is unsymmetric. Rectangular matrix Output Data Block: X Rectangular matrix having the same dimensions as [B] Parameters: KSYM Input-integer-default = -1. Symmetry flag. 9-210 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements -1 0 1 2 SIGN Choose symmetric if [U] is purged, otherwise unsymmetric (default). Matrix [A] is unsymmetric. Matrix [A] is symmetric. Perform left-handed solution. Input-integer-default = 1. Sign of [B]. 1 -1 Solve [A] [X] = [B] (default). Solve [A] [X] = -[B] (default). FBTYP Input-integer-default = 0. Forward or backward pass selection. -1 0 1 Perform backward pass only. Perform forward and backward passes (default). Perform forward pass only. 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, FBS uses the sparse method. The default decomposition and FBS method is sparse. There are also submethods (FBSOPT<>0) which apply only 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 are 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 can be used for FBS method selection (non-sparse only). If the FBSOPT keyword is not used, the program selects the FBS method, which results in the lower sum of CPU and I/O time. FBSOPT -2 -1 0 +1 Non-sparse submethod selection Method 1A Method 1 Automatic selection method based on minimum of l/O + CPU time Method 2 NX Nastran DMAP Programmer’s Guide 9-211 Chapter 9 Descriptions of DMAP Modules and Statements 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, FBS solves [L][U] = ±[BT. If n=1, FBS solves [X]T[L][U] = ±[B]T. 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” module description. 10. See the NX Nastran Numerical Methods User’s Guide for further details on the FBS module and related topics. Examples: 1. Solve [A] [X] = [B] where [A] can be either symmetric or unsymmetric. DECOMP FBS MATPRN A/LD,U, $ LD,U,B/X/ $ X// $ 2. Solve [A] [X] = [B] assuming [A] is symmetric (form = 6 in matrix trailer). DECOMP FBS MATPRN A/LD,, $ LD,,B/X/ $ X// $ 3. Solve [LD] [X] = [C] where [LD] is the lower triangular factor obtained in Example 2. FBS LD,,C/X///1 $ FORWARD PASS ONLY 4. Solve [LD]T[X] = [C] where [LD] is the lower triangular factor obtained in Example 2. FBS LD,,C/X///-1 $ BACKWARD PASS ONLY 5. Given that [M] and [K] are symmetric and [M] is also positive definite, find [[LD]T]-1 [K] [LD]T, where [M] = [LD] [LD]T. DECOMP FBS FBS M/LD,,//1 $ CHOLESKY LD,,K/Y///1 $ FWD.ONLY,Y AN INTERMEDIATE RESULT LD,,Y/J/2//1 $ FWD.ONLY, LEFT-HAND 9.129 FILE Data block declaration Declares special characteristics of a data block(s). 9-212 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: FILE DB1=[SAVE,APPEND,OVRWRT]/DB2=[SAVE,APPEND, OVRWRT]/... $ Data Blocks: DBi Names of the data blocks possessing special characteristics Parameters: SAVE APPEND OVRWRT Indicates that the data block is to be saved for possible looping in DMAP program Same as SAVE. Also allows a module to append other data blocks to DBi on successive passes through a DMAP loop. 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 can appear anywhere in subDMAP. It is also a local declaration; that is, it must be declared in all subDMAPs where the SAVE, APPEND, or OVRWRT is needed. 2. A data block name can appear only once in all FILE statements within a subDMAP; otherwise, the first appearance determines 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. UGS also recommends that the APPEND keyword not be applied to data blocks that appear as output on the EQUIVX module. See the “EQUIVX” 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 ) $ IF ( COUNT=1 ) MPYAD A,B,/C $ . . . ADD A,C/D/R $ R=R+(1.,0.) $ COUNT=COUNT+1 $ ENDDO $ NX Nastran DMAP Programmer’s Guide 9-213 Chapter 9 Descriptions of DMAP Modules and Statements 2. For an example of the APPEND keyword see the “APPEND” module description. 9.130 Format: FOCODS FOCODS Form contact element displacements. CNELM,USET,UA/ECDISP $ Input Data Blocks: CNELM USET UA Contact element definition table. Degree-of-freedom set membership table for g-set. Displacement vector -a set. Output Data Blocks: ECDISP Contact element displacements. 9.131 Format: FOCOEL FOCOEL Form contact elements CASECC,BGPDT,CSTM,GEOM2,EST,MPT,CONTACT,SIL/ CNELMS,GPECTC/ S,N,NSKIP/S,N,OPTION/S,N,NLHEAT/S,N,CNTSET/S,N,NCELS/S,N,MAXS/ S,N,MAXF/S,N,CTOL/S,N,AITK/S,N,MPER/S,N,RESET$ Input Data Blocks: CASECC BGPDT CSTM GEOM2 EST MPT Table of case control command images. Basic grid point definition table. Table of coordinate system transformation matrices Table of Bulk Data entry images related to element connectivity and scalar points. Element summary table. Material property table. 9-214 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CONTACT SIL Contact data table. Scalar index list. Output Data Blocks: CNELM GPECTC Contact element definition table. Grid point contact element connection table. Parameters: NSKIP OPTION Input-integer-no default. Record number in CASECC corresponding to the first subcase of the current boundary condition. Input-integer-no default. OPTION=1 to form contact elements. OPTION=2 to form glue elements. NLHEAT CNTSET NCELS MAXS MAXF CTOL AITK MPER RESET Input-logical-no default. TRUE if nonlinear heat transfer analysis. Output-integer. Contact set ID. Output-integer. Number of contact elements. Output-integer. Maximum number of iterations for status loop. Output-integer. Maximum number of iterations for force loop. Output-real. Contact force convergence tolerance. Output-integer. Aitken iteration flag. Output-integer. Minimum contact set percentage. Output-integer. Reset flag. Remarks: NCELS will equal -1 if error is encountered forming the contact element. 9.132 FOCOST Form contact status NX Nastran DMAP Programmer’s Guide 9-215 Chapter 9 Descriptions of DMAP Modules and Statements Format: FOCOST CNELM,ECSTAT,ELAMDA,DLAMDA,ECDISP/ECSTAT2/ S,N,CITO/NOFAC/S,N,NCS0/S,N,NCS1/S,N,NCS2/S,N,NCS3/S,N,NCSC $ Input Data Blocks: CNELM ECSTAT ELAMDA DLAMDA ECDISP Contact element definition table. Contact element status table from previous iteration. Previous tractions. Change of tractions. Contact element displacements. Output Data Blocks: ECSTAT2 Contact element status table. Parameters: CITO NOFAC NCS0 NCS1 NCS2 NCS3 NCSC Input-integer. Contact outer (status) loop counter Input - integer. Percent of initially open contacts to make active. Output-integer. Number of inactive contact elements. Output-integer. Number of active open contact elements Output - integer. Number of sticking contact elements. Output-integer. Number of sliding contact elements. Output-integer. Number of contact element changes. 9.133 FOELCF Form contact forces Format: FOELCF CNELM,ECSTAT,ECDISP,ECDISO,ELAMDA,DLAMDA,XYDISP/ DLAMUP,CONFOR,TLAMCK,XYDISU/ S,N,NROW/S,N,CONV/S,N,CITO $ 9-216 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: CNELM ECSTAT ECDISP ECDISO ELAMDA DLAMDA XYDISP Contact element definition table. Contact element status table. Contact element displacements. Contact element displacements from previous load case. Previous contact element tractions. Previous contact element change in tractions. XY relative displacements. Output Data Blocks: DLAMUP CONFOR TLAMCK XUDISU Update change in contact element tractions. Contact element force vector. Contact element tractions including spring forces. Updated XY relative displacements. Parameters: NROW CONV CITO Input-integer. Number of rows for contact force vector. Input-integer. Converged solution flag. Input-integer. Contact outer (status) loop counter. 9.134 Format: FOELCS FOELCS Form contact element stiffness. CNELM,BGPDT,CSTM,USET/ELCNST,ELCTST $ S,N,NLHEAT$ Input Data Blocks: CNELM Contact element definition table. NX Nastran DMAP Programmer’s Guide 9-217 Chapter 9 Descriptions of DMAP Modules and Statements BGPDT CSTM USET Basic grid point data table. Table of coordinate system transformation matrices. Degree-of-freedom set membership table for g-set. Output Data Blocks: ELCNST ELCTST Contact element normal stiffness table. Contact element tangential stiffness table. Parameters: NLHEAT Input-logical-no default. TRUE if nonlinear heat transfer analysis. 9.135 Format: FONOTR FONOTR Form contact tractions and pressures CNELM,ECSTAT,ELAMDA,CASESX/OQGCFF1,OBC1,CONFON, ELTRCT/NROW/NVEC Input Data Blocks: CNELM ECSTAT ELAMDA CASESX Contact element definition table. Contact element status table. Contact element tractions. Table of case control command images. Output Data Blocks: OQGCF1 OBC1 CONFON ELTCT Contact force at grid point. Contact pressures and tractions at grid points. Contact forces on elements. Contact tractions on elements. 9-218 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: NROW NVEC Input-integer. Number of rows in contact force vector. Input-integer. Number of solution results to process. 9.136 Format: FORTIO FORTIO Opens or closes a FORTRAN file //OPERATN/UNITNO/CLOSEOPT/IOSTAT $ Input Data Blocks: None. Output Data Blocks: None. Parameters: OPERATN Input-character-no default. FORTIO operation. ‘EXISTS’: Check for assigned physical file existence ‘OPEN’: Open file ‘CLOSE’: Close file UNITNO CLOSEOPT Input-integer-no default. Specifies FORTRAN unit number. Input-integer-default=2. FORTIO close options. 1 2 3 IOSTAT Rewind (leaves file open, if open) Close/keep (default) Close/delete Output-integer-no default. FORTIO status return code. For OPERATN=‘OPEN’or ‘CLOSE’: 0 1 Successful Unsuccessful For OPERATN=‘EXISTS’: NX Nastran DMAP Programmer’s Guide 9-219 Chapter 9 Descriptions of DMAP Modules and Statements 0 1 Assigned physical file exists. Assigned physical file does not exist. Remarks: 1. Units must be assigned a physical file name using an ASSIGN statement. 2. Errors encountered in FORTIO do not terminate the NX Nastran execution. However, IOSTAT returns a nonzero value in the event of error(s) that terminate the request. Example: Close FORTRAN unit 24. FORTIO //‘CLOSE‘/24/2/S,N,IOSTAT $ 9.137 FRLG Generates frequency-dependent loads or time-dependent loads Generates frequency-dependent loads or time-dependent loads via Fourier transform for frequency response analysis. Format: FRLG CASECC,USETD,DLT,FRL,GMD,GOD,DIT,PHDH/ PPF,PSF,PDF,FOL,PHF,YPF/ SOLTYP/OPT/S,N,FOURIER/S,N,APP $ Input Data Blocks: CASECC USETD DLT FRL GMD GOD DIT PHDH Table of Case Control command images Degree-of-freedom set membership table for p-set Table of dynamic loads Frequency response list Multipoint constraint transformation matrix with extra points, m-set by ne-set Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set Table of TABLEij Bulk Data entry images Transformation matrix from d-set to modal coordinates 9-220 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: PPF PSF PDF FOL PHF YPF Frequency response load matrix in the p-set Frequency response load matrix in the s-set Frequency response load matrix in the d-set Frequency response frequency output list Frequency response load matrix in the h-set (modal) Frequency response enforced motion matrix in the p-set Parameters: SOLTYP Input-character-no default. Solution method. ‘MODAL’Modal: that is, compute PH ‘DIRECT’Direct: that is, do not compute PH OPT Input-integer-default=0. Processing option. 0 = generate frequency-or time-dependent loads 1 = generate load scale function only (FRL not used) 2 = generate frequency-or time-dependent load table values only Output-integer-default=-1. Fourier transform. Set to 1 if TLOADi Bulk Data entries are referenced by the DLOAD set identification number in CASECC. Output-character-default=‘FREQ’ Dynamic load type. Set to ‘FREQ‘, if RLOAD1 or RLOAD2 entries are referenced. Set to ‘TRAN‘, if TLOAD1 or TLOAD2 entries are referenced. FOURIER APP 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, 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, the loads are computed and transformed to the frequency domain. NX Nastran DMAP Programmer’s Guide 9-221 Chapter 9 Descriptions of DMAP Modules and Statements 9.138 Format: FRLGEN FRLGEN Creates frequency response list from the FREQi Bulk Data entries DYNAMIC,LAMAS,LAMAF/ FRL,FRL1,DFFDNF/ S,N,NOFRL/S,N,NOOPT/DFREQ $ Input Data Blocks: DYNAMIC LAMAS LAMAF Table of Bulk Data entry images related to dynamics Normal modes eigenvalue summary table for the structural portion of the model Normal modes eigenvalue summary table for the fluid portion of the model Output Data Blocks: FRL FRL1 DFFDNF Frequency response list Frequency response list for the current processor if distributed processing is requested Table containing the derivatives of forcing frequencies with respect to natural frequencies Parameters: NOFRL NOOPT DFREQ Output-integer-default=0. FRL generation flag. Set to -1 if FRL is not generated. Output-integer-default=0. FRLGEN reexecution flag. Set to -1 for no re-execution. Input-real-default=1.E-5. Duplicate frequency threshold. Two frequencies, f1 and f2, are considered duplicates if Equation 9-21. where fmax and fmin are the maximum and minimum frequencies across all FREQi Bulk Data entries. Remarks: LAMAF can be purged. 9-222 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.139 FRQDRV Drives loop on frequencies defined on FREQi Bulk Data entries Drives loop on frequencies defined on FREQi Bulk Data entries and is intended for frequency-dependent element processing. Format: FRQDRV CASECC,FRL/ FRLI/ S,N,FRQLOOP/S,N,FREQVAL $ Input Data Blocks: CASECC FRL Table of Case Control command images Frequency response list Output Data Blocks: FRLI Frequency response list for a single frequency Parameters: FRQLOOP Input/output-integer-no default. Frequency loop counter. On input, FRQLOOP should be initialized to 0 before the loop. On output, FRQLOOP is incremented by one and at the last frequency, FRQLOOP is negated. For example, if the fifth frequency is the last, FRQLOOP is output as -5. Output-real-no default. Frequency value for frequency dependent element generation. FREQVAL Example: TYPE PARM,,I,N,FRQLOOP=0 $ DO WHILE ( FRQLOOP>=0 ) $ FRQDRV CASES,FRL/FRLI/S,N,FRQLOOP/S,N,FREQVAL $ . . . ENDDO $ FRQLOOP>=0 9.140 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. NX Nastran DMAP Programmer’s Guide 9-223 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: CASECC DIT KXX BXX MXX K4XX FRL FOL PXF EDT Table of Case Control command images Table of TABLEij Bulk Data entry images Stiffness matrix in any set. Usually h- or d-set. Viscous damping in any set. Usually h- or d-set. Mass matrix in any set. Usually h- or d-set. Structural damping in any set. Usually h- or d-set. Frequency response list Frequency response frequency output list Frequency response load matrix in h-set (modal) or d-set Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Scalar index list for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Degree-of-freedom set membership table for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Partitioning vector with values of 1.0 at the rows corresponding to degrees of freedom which were eliminated in the partition to obtain KXX, and so on. 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. SILD USETD PARTVEC Output Data Blocks: UXF FOLT Solution matrix from frequency response analysis in d- or h-set Frequency response frequency output list with first frequency truncated if first frequency is zero. UXF is also similarly truncated. 9-224 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: SOLTYP Input-character-no default. Solution method. ‘MODAL’: modal, usually for h-set matrices ‘DIRECT’: direct, usually for d-set matrices NONCUP Input-integer-no default. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if SOLTYP=‘MODAL’and KXX, BXX, and MXX are diagonal. NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX is ignored. Input-integer-default=0. Power of ten for convergence parameter epsilon for iterative solution method. Input-integer-default=0. Maximum number of iterations for iterative solution method. Input-integer-default=1. Record number of current subcase in CASECC. Used only if the SMETHOD command selects the ITER Bulk Data entry which specifies values for the desired iteration parameters. If NSKIP=-1, CASECC is not required and the values are taken from the module specification of the values. Input-integer-default=0. Zero frequency truncation selection. If set to 1, the zero frequency, if any, is truncated from UXF and FOL. Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if first frequency is truncated. Input-character-default=‘H’ Degree-of-freedom set name represented by KXX, and so on. If KXX represents, or is a subset of, the d-set, for maximum efficiency, the rows and columns KXX and MXX must correspond to or be a partition of the displacement set specified by SETNAME. If KXX and MXX are a partition, PARTVEC must also be specified. Input-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE if processing frequency-dependent elements. ITSEPS ITSMAX NSKIP ZFREQ FIRSTBAD SETNAME FREQDEP Remarks: 1. CASECC, FRL, FOL, and PXF cannot be purged. KXX, BXX, and MXX can be purged. 2. If SOLTYP=‘DIRECT‘, K4XX can be used to simulate viscoelastic materials. (See the NX Nastran User‘s Guide.) Otherwise, it can be purged. If SOLTYP=‘MODAL‘, K4XX is ignored and can 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 if NSKIP>0 and the SMETHOD Case Control command selects the ITER Bulk Data entry. Otherwise it can be purged. NX Nastran DMAP Programmer’s Guide 9-225 Chapter 9 Descriptions of DMAP Modules and Statements 9.141 FRRD2 Solves for the steady-state frequency response displacement solution Solves for the steady-state, modal or direct, frequency response, displacement solution using iterative or direct methods. Format: 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 $ Input Data Blocks: KXX BXX MXX QHHL PXF FOL CASECC EDT Stiffness matrix in any set. Usually h- or d-set. Viscous damping in any set. Usually h- or d-set. Mass matrix in any set. Usually h- or d-set. Aerodynamic matrix list Frequency response load matrix in h-set (modal) or d-set Frequency response frequency output list Table of Case Control command images Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Scalar index list for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Degree-of-freedom set membership table for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Partitioning vector with values of 1.0 at the rows corresponding to degrees of freedom which were eliminated in the partition to obtain KXX, and so on. 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. SILD USETD PARTVEC Output Data Blocks: UXF Solution matrix from frequency response analysis in d- or h-set 9-226 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements FOLT Frequency response frequency output list with first frequency truncated if first frequency is zero. UXF is also similarly truncated. Parameters: BOV Q MACH NONCUP Input-real-no default. Conversion from frequency to reduced frequency. Output-real-default=0.0. Dynamic pressure. Output-real-default=0.0. Mach number. Input-integer-default=-1. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if KXX, BXX, and MXX are diagonal. NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX is ignored. Input-integer-default=0. Power of ten for convergence parameter epsilon for iterative solution method. Input-integer-default=0. Maximum number of iterations for iterative solution method. Input-character-default=‘H’ Degree-of-freedom set name represented by KXX, and so on. If KXX represents, or is a subset of, the d-set, for maximum efficiency, the rows and columns KXX and MXX must correspond to or be a partition of the displacement set specified by SETNAME. If KXX and MXX are a partition, PARTVEC must also be specified. Input-integer-default=0. Zero frequency truncation selection. If set to 1, the zero frequency, if any, is truncated from UXF and FOL. Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if first frequency is truncated. ITSEPS ITSMAX SETNAME ZFREQ FIRSTBAD 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 if the iterative solver is NSKIP>0 and the SMETHOD Case Control command selects the ITER Bulk Data entry. Otherwise it can be purged. 9.142 GENTRAN Generates a transformation matrix Generates a transformation matrix that converts the upstream boundary coordinate system to the downstream coordinate system. NX Nastran DMAP Programmer’s Guide 9-227 Chapter 9 Descriptions of DMAP Modules and Statements Format: GENTRAN SEMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/ MAPS/ SEID $ Input Data Blocks: SEMAP BGPDTS CSTMS BGPDTD CSTMD SCSTM Superelement map table Basic grid point definition table for the current superelement Table of coordinate system transformation matrices for the current superelement Basic grid point definition table for the downstream superelement Table of coordinate system transformation matrices for the downstream superelement Table of global transformation matrices for partitioned superelements Output Data Block: MAPS Superelement upstream to downstream boundary coordinate transformation matrix Parameter: SEID Input-integer-default=0. Superelement identification number. Example: Excerpt from subDMAP PHASE0: DO WHILE ( NOT(RSONLY) AND LPFLG<>-1 AND SEBULK ) $ SEP2DR SLIST,EMAP//S,N,SEID/S,N,PEID/S,N,SEDWN/ S,N,LPFLG/////////SEP2CNTL//-1/S,N,PARTSE/ S,N,SETYPE/S,N,REID $ IF ( PARTSE ) THEN $ NP=SEDWN $ DBVIEW BGPDTD=BGPDTS WHERE ( PEID=NP ) $ DBVIEW CSTMD =CSTMS WHERE ( PEID=NP ) $ GENTRAN EMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/ MAPS/SEID $ ENDIF $ PARTSE ENDDO $ NOT(RSONLY) AND LPFLG<>-1 AND SEBULK 9.143 GETCOL Reads STATSUB Case Control command subcase ID number 9-228 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: CASEBUCK CASESTAT Table of Case Control command images for buckling analysis Table of Case Control command images for static analysis Output Data Blocks: None. Parameters: NSKIP BCKCOL Input-integer-default=1. Subcase record number to read in CASEBUCK for the STATSUB subcase identification number. Output-integer-no default. Subcase record number in CASESTAT referenced by the STATSUB(BUCKLE) subcase identification number. BCKCOL also corresponds to the column number of static solution vector. Output-integer-default-0. Subcase record number in CASESTAT referenced by the STATSUB(PRELOAD) subcase identification number. PRECOL also corresponds to the column number of static solution vector. PRECOL Remarks: If the STATSUB subcase identification number is not found in CASEBUCK, BCKCOL is set to 1. If the subcase identification number specified by the STATSUB command is not found in CASESTAT, a fatal message is issued. 9.144 GETMKL Create list of Mach numbers on reduced frequency pairs Format: GETMKL EDT/MKLIST/S,N,NMK $ NX Nastran DMAP Programmer’s Guide 9-229 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: 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 Data Blocks: MKLIST Table of Mach number and reduced frequency pairs Parameters: NMK Output-integer-default=0. Number of Mach number and reduced frequency pairs. 9.145 GI Generates aerodynamic spline transformation matrix Format: GI Input Data Blocks: AERO SPLINE AMSPLINE BGPDT AEBGPDT AEUSET AECOMP CSTMA Table of control information for aerodynamic analysis. Output by APD. Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external grid identification numbers Table of aerodynamic splines for display Basic grid point definition table The basic grid point definition table with the aerodynamic degrees of freedom added (ks-set in AEUSET) Aerodynamic USET table Aerodynamic component definition table Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points 9-230 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: GPGK GDGK Aerodynamic transformation matrix for loads from the k-set to g-set Aerodynamic transformation matrix for displacements from the k-set to g-set Parameters: None. Example: Excerpt from subDMAP AERO0: DBVIEW AEUSET=USET0 WHERE (MODLTYPE=‘AEROSTRC’AND WILDCARD) $ DBVIEW AEBGPDT=BGPDTS WHERE (MODLTYPE=‘AEROSTRC’AND WILDCARD) $ GI AERO,SPLINE,XBGPDT,AEBGPDT,AEUSET,AECOMP,CSTMA/ GPGK0,GDGK0 $ 9.146 Format: GKAM GKAM Assembles modal mass, damping and stiffness matrices USETD,PHA,MI,LAMA,DIT,M2DD,B2DD,K2DD,CASECC/ MHH,BHH,KHH,PHDH/ NOUE/LMODES/LFREQ/HFREQ/UNUSED5/UNUSED6/UNUSED7/ S,N,NONCUP/S,N,FMODE/KDAMP/FLUID/UNUSED12 $ Input Data Blocks: USETD PHA MI LAMA DIT M2DD B2DD Degree-of-freedom set membership table for p-set Normal modes eigenvector matrix in the a-set Modal mass matrix. See Remark 5. Normal modes eigenvalue summary table Table of TABLEij Bulk Data entry images Mass matrix contribution from the M2PP Case Control command and reduced to the d-set Total damping matrix from viscous damping elements and the B2PP Case Control command and reduced to the d-set. In transient response analysis, B2DD can also include structural damping effects. Stiffness matrix contribution from the K2PP Case Control command and reduced to the d-set. In frequency response analysis, K2DD can also include structural damping effects. K2DD NX Nastran DMAP Programmer’s Guide 9-231 Chapter 9 Descriptions of DMAP Modules and Statements CASECC Table of Case Control command images Output Data Blocks: BHH MHH KHH PHDH Generalized (modal) damping matrix Generalized (modal) mass matrix Generalized (modal) stiffness matrix. Transformation matrix from d-set to h-set (modal) Parameters: NOUE LMODES LFREQ HFREQ UNUSED5 UNUSED6 UNUSED7 NONCUP FMODE KDAMP Input-integer-no default. The number of EXTRA points. Set to -1 if there are no extra points. Input-integer-no default. The number of lowest modes to use in modal transformation. All outputs have LMODES number of columns. Input-real-no default. Lower frequency limit of modes to use in modal transformation. Input-real-no default. Upper frequency limit of modes to use in modal transformation. Input-integer-no default. Unused. Input-integer-no default. Unused. Input-integer-no default. Unused. Output-integer-no default. If K2DD, B2DD, and M2DD are purged. the model is considered uncoupled and NONCUP is set to -1. Output-integer-default=1. The lowest mode number resulting from LMODES or LFREQ and HFREQ. Input-integer-default=1. Viscous modal to structural damping flag. If set to -1, viscous modal damping (SDAMPING Case Control command) is included in the stiffness matrix as structural damping. Input-logical-default=FALSE. Fluid damping processing flag. If TRUE, the modal damping set identification number is obtained from the SDAMPING(FLUID) Case Control command. Input-logical-default=FALSE. Unused. FLUID UNUSED12 Remarks: 1. USETD can be purged if there are no extra points (NOUE<0). 9-232 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2. PHA and LAMA cannot be purged. 3. CASECC and DIT cannot be purged if SDAMPING is specified. 4. M2DD, B2DD, K2DD, and MI can be purged. 5. MI can be purged. MI must be purged if generalized mass is to be extracted from LAMA. 6. No output matrix can be purged. 7. HFREQ and LFREQ are ignored if LMODES>0. 8. See the NX Nastran User‘s Guide for further details. 9.147 GMERGE Global mode collection for dmp solution Format: GMERGE PHIX1,LAMA,EQMAP,GAPAR,VF01,EQEXINS,COLMAP,BNDMAP/ PHIX/NUMCPU/S,N,ERROR $ Input Data Blocks: PHIX1 LAMA COLMAP BNDMAP NUMCPU Local eigenvector file (required). Local eigenvalue file (required) Color map from GPARTN Local boundary map from GPARTN Number of dmp processors parameter (required) Output Data Blocks: PHIX ERROR Global eigenvector file Merging error 9.148 GNFM Computes element forces due to large displacements Computes the element forces due to large displacements and optionally computes the elemental stiffness matrices associated with incremental deflections. NX Nastran DMAP Programmer’s Guide 9-233 Chapter 9 Descriptions of DMAP Modules and Statements Format: GNFM KELM,KDICT,KDELM,KDDICT,EST,CSTM,UG,BGPDT/ FG,KELM1,KDICT1/ SKPMTX/LUSET/NSKIP $ Input Data Blocks: KELM KDICT KDELM KDDICT EST CSTM UG BGPDT Table of element matrices for stiffness KELM dictionary table Table of element matrices for differential stiffness KDELM dictionary table Element summary table Table of coordinate system transformation matrices Displacement matrix in g-set Basic grid point definition table Output Data Blocks: FG KELM1 KDICT1 Element forces due to large displacements Table of element matrices for incremental stiffness KELM1 dictionary table Parameters: SKPMTX LUSET NSKIP Input-integer-default=0. If SKPMTX<>0, KELM1 and KDICT1 are generated. Input-integer-default=0. The number of degrees-of-freedom in the g-set. Input-integer-default=0. Loop counter in old geometric nonlinear analysis (SOL 4). Remarks: 1. FG cannot be purged. 2. KELM1 and KDICT1 can be purged if SKPMTX<>0. 9.149 GP0 Modifies tables to include p-element information 9-234 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Modifies geometry, connectivity, loads, and constraints tables to include p-element information. Also creates 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 $ Input Data Blocks: CASECC GEOM1 GEOM2 GEOM3 GEOM4 EPT EDT Table of Case Control command images Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Table of DEQATN Bulk Data entry images Index table to DEQATN data block P-element set table, contains SETS DEFINITIONS. Output by PLTSET. P-value table generated by the ADAPT module in previous superelement, adaptivity cycle, or run. DEQATN DEQIND PELSET PVAL0 Output Data Blocks: GEOM1M GEOM2M GEOM2A Table of Bulk Data entry images related to geometry and updated for the current p-level Table of Bulk Data entry images related to element connectivity and scalar points and updated for the current p-level. Table of secondary Bulk Data entry images related to element connectivity and updated for the current p-level NX Nastran DMAP Programmer’s Guide 9-235 Chapter 9 Descriptions of DMAP Modules and Statements GEOM3M GEOM4M EHT EHTA MEDGE MFACE GDNTAB MBODY Table of Bulk Data entry images related to static and thermal loads and updated for the current p-level Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity and updated for the current p-level Element hierarchical table for p-element analysis Secondary element hierarchical table for p-element analysis Edge table for p-element analysis Face table for p-element analysis Table of grid points generated for p-element analysis Body table for p-element analysis Parameters: 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. Input-integer-default=0. Fortran unit number containing edge table information. Input-integer-default=0. Fortran unit number containing face table information. Output-integer-default=0. P-value set identification number. Output-logical-default=TRUE. Set to FALSE if p-elements are not present. Input-integer-default=0. First grid identification number in GEOM1M. Output-integer-no default. Maximum grid identification number in GEOM1M. Input-real-default=1.E-5. Geometric tolerance. Input-logical-default=TRUE. API flag. Input-integer-default=0. Input-logical-default=TRUE. Grid-n processing flag. If set to TRUE, grid-n information is processed. UNIT1 UNIT2 PVALID PEXIST GNSTART GNMAX GMTOL INITAPI PEDGEP GNPROC 9.150 GP1 Performs basic geometry processing 9-236 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: GP1 GEOM1,GEOM2,geom3,GDNTAB,MEDGE,SGPDT,DYNAMIC/ GPL,EQEXIN,GPDT,CSTM,BGPDT,SIL,VGF,GEOM3B, DYNAMICB/ S,N,LUSET/S,N,NOCSTM/S,N,NOPOINTS/ UNIT/UPERM/UPRMT/NUFLAG/SEID/NUMLM $ Input Data Blocks: GEOM1 GEOM2 GEOM3 UNUSED GDNTAB MEDGE SGPDT DYNAMIC Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Unused and can be purged Table of grid points generated for p-element analysis Edge table for p-element analysis Superelement basic grid point definition table Table of Bulk Data entry images related to dynamics Output Data Blocks: GPL EQEXIN GPDT CSTM BGPDT SIL VGF GEOM3B External grid/scalar point identification number list Equivalence table between external and internal grid/scalar identification numbers Grid point definition table Table of coordinate system transformation matrices Basic grid point definition table Scalar index list Fluid/structure partitioning vector with ones at the rows corresponding to fluid degrees-of-freedom Table of Bulk Data entry images related to static and thermal loads with DAREA entry images converted to equivalent FORCE and MOMENT entry images Table of Bulk Data entry images related to dynamics without DAREA entry images DYNAMICB NX Nastran DMAP Programmer’s Guide 9-237 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: LUSET NOCSTM NOPOINTS UNIT UPERM UPRMT NUFLAG SEID NUMLM Output-integer-default=0. The number of degrees-of-freedom in the g-set. Output-integer-no default. Number of coordinate systems found in GEOM1. Set to -1 if none are found. Output-integer-no default. Grid point flag. Set to -1 if none are found. Otherwise, set to 1. Input-real-default=1.0. AUNIT record factor for electromagnetic analysis. Input-real-default=1.2566E-06. Permeability for electromagnetic analysis. Input-real-default=8.8542E-12. Permittivity for electromagnetic analysis. Input-integer-default=10. Unit type for electromagnetic analysis. Input-integer-default=-1. Superelement identification number. Input-integer-default=0. Number of Lagrange Multiplies from Lagrange rigid elements. 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, can be purged. 9.151 Format: GP1LM GP1LM Add Lagrange rigids to geom2 table GEOM2,GEOM4/GEOMN/SEID/NUMLM $ Input Data Blocks: GEOM2 GEOM4 Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Output Data Blocks: GEOM2N Updated GEOM2 TABLE 9-238 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: SEID NUMLM Input-integer. Superelement identification number. Output – integer. Number of Lagrange multipliers. 9.152 GP2 Processes element connectivity Format: GP2 GEOM2,EQEXIN,EPT,GEOM2A,UNUSED5/ ECT,ECTA/ S,N,ACOUSTIC $ Input Data Blocks: GEOM2 EQEXIN EPT GEOM2A UNUSED5 Table of Bulk Data entry images related to element connectivity and scalar points Equivalence table between external and internal grid/scalar identification numbers Element property table Table of secondary Bulk Data entry images related to element connectivity and updated for the current p-level Unused and can be purged Output Data Blocks: ECT ECTA Element connectivity table Secondary element connectivity table Parameter: ACOUSTIC Output-integer-default=0. Fluid-structure analysis flag. 0 1 2 No fluid elements exist. Penalty or fluid acoustic elements exists. Fluid/structure coupling exists. NX Nastran DMAP Programmer’s Guide 9-239 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: 1. EQEXIN and ECT cannot be purged. 2. ECTA can be purged if GEOM2A is purged. 9.153 Format: GP3 GP3 Processes static and thermal loads GEOM3,BGPDT,GEOM2,EDT,UGH,ESTH,BGPDTH,CASEHEAT/ SLT,ETT/ S,N,NOLOAD/S,N,NOGRAV/S,N,NOTEMP $ Input Data Blocks: GEOM3 BGPDT GEOM2 EDT Table of Bulk Data entry images related to static and thermal loads Basic grid point definition table Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Temperature matrix in g-set from a heat transfer analysis Element summary table from a heat transfer analysis Basic grid point definition table from a heat transfer analysis Case Control table from a heat transfer analysis UGH ESTH BGPDTH CASEHEAT Output Data Blocks: SLT ETT Table of static loads Element temperature table Parameters: NOLOAD NOGRAV Output-integer-no default. Static load existence flag. Set to -1 if no static loads and SLT is not created, +1 otherwise. Output-integer-no default. Gravity load existence flag. Set to -1 if no GRAV Bulk Data entry images, +1 otherwise. 9-240 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOTEMP Output-integer-no default. Thermal load existence flag. Set to -1 if no TEMP or TEMPD Bulk Data entry images in GEOM3 and ETT is not created, +1 otherwise. Remarks: 1. BGPDTH cannot be purged. 2. SLT can be purged if there are no static loads. 3. ETT can be purged if there are no thermal loads 4. If UGH is present in structural analysis run, GP3 creates 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. ESTH is not required for h-elements. For p-elements ESTH is appended to element ETT record for interpolation purposes in element decks. The DBVIEW statements that are used to define these inputs in SOLs 101-200 are listed below: DBVIEW UGH=UG DBVIEW ESTH=EST DBVIEW BGPDTH=BGPDTS (WHERE APRCH=‘HEAT ’AND WILDCARD) $ (WHERE APRCH=‘HEAT ’) $ (WHERE APRCH=‘HEAT ‘) $ CASEHEAT can come from the CASE module or DBLOCATE DATABLK= (CASECCR/CASEHEAT) in the FMS. 9.154 GP4 Generates the degree-of-freedom set table Generates the degree-of-freedom set table based on single point constraints, multipoint constraints, rigid elements, and set membership assignment Bulk Data entries (for example, ASET). Also generates the enforced displacement matrix, the multipoint constraint equation matrix, and the enforced motion partitioning vector. Format: GP4 CASECC,GEOM4,EQEXIN,SIL,GPDT,BGPDT,CSTM, MEDGE,MFACE,MBODY,GEOM2,GDNTAB,GPECTO/ RMG,YS0,USET0,PARTV/ 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/DMAPNO/AUTOMPC $ Input Data Blocks: CASECC Table of Case Control command images. NX Nastran DMAP Programmer’s Guide 9-241 Chapter 9 Descriptions of DMAP Modules and Statements GEOM4 EQEXIN SIL GPDT BGPDT CSTM MEDGE MFACE MBODY GEOM2 GDNTAB GPECT0 Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Equivalence table between external and internal grid/scalar identification numbers Scalar index list Grid point definition table Basic grid point definition table Table of coordinate system transformation matrices Edge table for p-element analysis Face table for p-element analysis Body table for p-element analysis Table of Bulk Data entry images related to element connectivity and scalar points Table of grid points generated for p-element analysis Grid point element connection table. Output Data Blocks: RMG YS0 USET0 PARTV Multipoint constraint equation matrix Matrix of enforced displacements Degree-of-freedom set membership table for g-set Partitioning vector of enforced motion dof. Parameters: LUSET NOMSET MPCF2 Input-integer-default=0. The number of degrees-of-freedom in the g-set. Output-integer-no default. Number of degrees-of-freedom in the m-set or multipoint constraint and rigid element flag. Set to -1 if there are none. Output-integer-no default. Multipoint constraint set identification number change flag. Set to 1 if the current subcase contains a different multipoint constraint set from the previous subcase. Set to -1 otherwise or if there are no multipoint constraints in the current subcase. Output-integer-no default. Number of degrees-of-freedom in the s-set. or single point constraint flag. Set to -1 if there are none. NOSSET 9-242 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOOSET NORSET NSKIP REPEAT NOSET Output-integer-no default. Number of degrees-of-freedom in the o-set or omitted degree-of-freedom flag. Set to -1 if there are none. Output-integer-no default. Number of degrees-of-freedom in the r-set. or supported degree-of-freedom flag. Set to -1 if there are none. Input/output-integer-no default. The record number in CASECC corresponding to the first subcase of the current boundary condition. Output-integer-no default. Last boundary condition flag. Set to -1 at the last boundary condition; +1 otherwise. Output-integer-no default. Constraint, omit, and support set flag. Set to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-freedom defined in the a-set (for example, ASETi, QSETi Bulk Data entries); +1 otherwise. Output-integer-default=1. Dependent set flag. Set to -1 if all degrees-of-freedom belong to m-set, s-set, o-set, and/or r-set; otherwise, the degrees-of-freedom in the l-set. Output-integer-default=1. Constraint and omit set flag. Set to -1 if NOMSET=-1, NOSSET=-1, and NOOSET=-1; otherwise the number of degrees-of-freedom in the a-set. Input-integer-default=0. Superelement identification number. 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. Input-logical-default=FALSE. Partitioned superelement presence flag. Set to TRUE if partitioned superelements are present or BEGIN SUPER is specified for the first BEGIN BULK Case Control command. NOL NOA SEID ALTSHAPE SEBULK Remarks: 1. YS is purged if SPCD or SPC Bulk Data entries do not specify nonzero values for displacement. 2. GEOM4 can be purged. 3. CSTM can be purged if no coordinate systems are used. 9.155 GP5 Creates table of static loads for panels in coupled fluid/structure analysis NX Nastran DMAP Programmer’s Guide 9-243 Chapter 9 Descriptions of DMAP Modules and Statements Format: GP5 ECT,BGPDT,EQEXIN,EDT,SIL/ PANSLT,EQACST,NORTAB/ S,N,MPNFLG/S,N,NUMPAN/S,N,MATCH/NASOUT/GETNUMPN $ Input Data Blocks: ECT BGPDT EQEXIN EDT Element connectivity table Basic grid point definition table Equivalence table between external and internal grid/scalar identification numbers Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Scalar index list SIL Output Data Blocks: PANSLT EQACST NORTAB Panel static load table Equivalence table between internal fluid grid points and internal structural grid points which lie on the fluid/structure boundary. Output by GP5. Table containing fluid face and the maximum of eight structural grids which lie within the acoustic face Parameters: MPNFLG NUMPAN MATCH Output-integer-default=0. Set to 1 if multiple panels exist. Output-integer-default=1. Number of panels. Output-integer-default=0. Type of fluid/structural mesh matching. 0 1 NASOUT GETNUMPN Matching mesh Non-meshing mesh Input-logical-default=TRUE. Print flag for fluid/structural mesh matching summary. Input-logical-default=FALSE. Panel static load computation flag. If TRUE, get number of panels flag only and do not compute panel static loads. 9-244 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.156 GPARTN Graph partitioning used for DMP solutions. Format: GPARTN KXX,MXX,USET,SILS,EQEXINS/KXX1,MXX1,EQMAP,GAPAR,VFO1,USET1,SIL1,EQEXIN1,SPCCOL,MAPFIL,CO Input Data Blocks: KXX MXX USETS SILS EQEXINS NUMCPU Global stiffness matrix file (required) Global mass matrix file (required) Global set definition data (required only for OPTION=1) Global scalar index list (required only for OPTION=1) Global external/internal list (required only for OPTION=1) Number of dmp processors parameter (required) Output Data Blocks: KXX1 MXX1 USET1 SIL1 EQEXIN1 EQMAP GAPAR VF01 SPCCOL MAPFILE Local stiffness matrix partition file (including global boundary) Local mass matrix partition file (including global boundary) Local set definition data. Local scalar index list Local external/internal list Local interior/boundary information data Local a-set partitioning vector Local f-set partitioning vector Local spc dof partitioning vector Containing 4 distinct components (only for OPTION=2): • • • • DOFMAP - degrees of freedom vs. nodal data map, see AMLS specification XADJ - points to stiffness matrix adjacency list, see AMLS specification ADJ - stiffness matrix adjacency list, see AMLS specification NODELIST - user requested displacement nodes, see AMLS specification NX Nastran DMAP Programmer’s Guide 9-245 Chapter 9 Descriptions of DMAP Modules and Statements COLMAP BNDMAP GLOBDOF LOCDOF BNDDOF OPTION Color map from GPARTN Local boundary map from GPARTN Global degrees of freedom parameter Local degrees of freedom parameter Boundary degrees of freedom parameter Partitioning (1) or graph information generation (2) parameter 9.157 GPFDR Computes grid point forces and element strain energy Format: GPFDR Input Data Blocks: CASECC UG KELM KDICT ECT EQEXIN GPECT PG QG Table of Case Control command images Displacement matrix in g-set Table of element matrices for stiffness KELM dictionary table Element connectivity table Equivalence table between external and internal grid/scalar identification numbers Grid point element connection table Static load matrix for the g-set Single-point constraint forces of constraint matrix in the g-set 9-246 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements BGPDT LAMA FOL TOL OLF SIL CSTM VELEM PTELEM QMG NFDICT FENL MELM MDICT BELM BDICT Basic grid point definition table Eigenvalue summary table for normal modes. Required for APP=‘REIG’ Frequency output list. Required for APP=‘FREQRESP’ Time output list. Required for APP=‘TRANRESP’ Nonlinear static load factor list. Required for APP=‘NLST’ Scalar index list Table of coordinate system transformation matrices Table of element lengths, areas, and volumes Table of thermal loads in the elemental coordinate system Multipoint constraint forces of constraint matrix in the g-set Nonlinear element energy/force index table Element energy and forces in nonlinear matrix format Elemental matrices for mass Dictionary table for MELM Elemental matrices for damping Dictionary table for BELM Output Data Blocks: ONRGY1 OGPFB1 OEKE1 OEDE1 Table of element strain energies and energy densities Table of grid point forces Elemental kinetic energy Elemental energy loss Parameters: APP Input-character-no default. Analysis type. Allowable types are: ‘STATICS’ ‘REIG’ ‘FREQRESP’ Linear statics Normal modes Frequency response NX Nastran DMAP Programmer’s Guide 9-247 Chapter 9 Descriptions of DMAP Modules and Statements ‘TRANRESP’ ‘NLST’ TINY XFLAG Transient response Nonlinear static Input-real-default=1.E-03. Small element strain energy value. Element strain energies less than TINY are not printed. Input-integer-default=0. Strain energy method selection. 0 1 Elemental force Cross displacement. See Remark 2. CYCLIC WTMASS Input-logical-default=FALSE. Set to TRUE for cyclic symmetry models. Input-real-default=1.0. Specifies scale factor on elemental mass matrix. 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): Equation 9-22. If XFLAG=1: Equation 9-23. where {u1e} is the displacement for the first subcase or mode and where {uie} 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. 9-248 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.158 Format: GPJAC GPJAC Checks element Jacobians ECT,BGPDT//S,N,JACDET $ Input Data Blocks: ECT BGPDT Element connectivity table Basic grid point definition table Output Data Blocks: None. Parameter: JACDET Output-integer-default=0. Bad Jacobian detection flag. Set to 1 if a bad Jacobian is detected. Remarks: By default the run terminates if bad Jacobians are detected. If system cell 213 is equal to 1, the run does not terminate. 9.159 GPSP Performs auto-SPC operation Performs auto-SPC operation; that is, identifies and automatically constrains singularities. Format: GPSP Input Data Blocks: KNN Stiffness matrix in n-set; after multipoint constraint reduction NX Nastran DMAP Programmer’s Guide 9-249 Chapter 9 Descriptions of DMAP Modules and Statements KGG KMM RMG USET0 SIL GPL YS0 GEOM4 EQEXIN Stiffness matrix in g-set Stiffness matrix in m-set Multipoint constraint equation matrix Degree-of-freedom set membership table for g-set Scalar index list External grid/scalar point identification number list Matrix of enforced displacements Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Equivalence table between external and internal grid/scalar identification numbers Output Data Blocks: USET YS BD3X3 Degree-of-freedom set membership table for g-set Matrix of enforced displacements in the s-set 3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel domain decomposition Parameters: NOSSET AUTOSPC PRGPST SPCGEN Output-integer-default=0. Number of degrees-of-freedom in the s-set. or single point constraint flag. Set to -1 if there are none. Input-character-default=‘YES’ Automatic constraint flag. If set to ‘YES‘, singularities are constrained. Input-character-default=‘YES’ Singularity summary print flag. If set to ‘YES‘, the summary is printed. Input-integer-default=0. SPC Bulk Data entry punch flag. If set to >0, singularities identified by this module are written to the PUNCH file as SPC Bulk Data entries. Input-real-default=1.E-8. Singularity test parameter. Singularities greater than EPZERO are not constrained. Input-integer-default=0. B-set constraint flag. If ACON<0, b-set degrees-of-freedom are constrained if AUTOSPC=‘YES’ EPZERO ACON 9-250 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SING EPPRT NOSET Output-integer-default=0. Singularity flag. If singularities are found, SING is set to -1; otherwise +1. Input-real-default=0.0. Singularity print parameter. Singularities greater than EPPRT are not printed if PRGPST=‘YES’ Input/output-integer-default=0. Constraint, omit, and support set flag. Set to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-freedom defined in the a-set (for example, ASETi, QSETi Bulk Data entries); +1 otherwise. Output-integer-default=0. Error flag. If errors are encountered, NGERR is set to -1; otherwise +1. Input-character-default=‘RG’ Multipoint constraint processing method. Also indicates the type of matrix in the second input position: ‘RG’for RMG and ‘KMM’for KMM. See Remarks 2 and 3. NGERR MPCMETH Remarks: 1. YS0 and YS can be purged. 2. For the most reliable identification and constraint of singularities on independent degrees-of-freedom connected multipoint constraints or rigid elements, GPSP should be executed after MCE1 and MCE2. KNN and KMM should then be specified for the first two inputs and ‘KMM’should be specified for MPCMETH. For example, from subDMAP SEKR0: UPARTN MCE2 GPSP USET0,KGG/KMM,,,/‘G‘/‘M‘/‘N’$ USET0,GM,KGG,,,/KNN,,, $ KNN,KMM,... ...S,N,NGERR/‘KMM’$ If KMM is purged, some singular rotational independent degrees-of-freedom cannot be identified unless all rotations at a given point are independent. 3. If GPSP is executed before MCE1 and MCE2, KGG and RMG should be specified. Also, the default for MPCMETH should be used. GPSP KGG,RMG,... If RMG is purged, singular independent degrees-of-freedom connected to multipoint constraints or rigid elements are not identified or constrained. 4. ACON should be set to -1 if processing a superelement. 9.160 Format: GPSTR1 GPSTR1 Computes element to grid point interpolation factors POSTCDB,BGPDT,EST,CSTM,ELSET,ESTNL,UNUSED7,CASECC/ EGPSF/ S,N,NOEGPSF $ NX Nastran DMAP Programmer’s Guide 9-251 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: POSTCDB BGPDT EST CSTM ELSET ESTNL UNUSED7 CASECC Table of commands from the OUTPUT(POST) section of Case Control Basic grid point definition table Element summary table Table of coordinate system transformation matrices Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section of Case Control Nonlinear element summary table Unused and can be purged Table of Case Control command images Output Data Block: EGPSF Table of element to grid point interpolation factors Parameter: NOEGPSF Output-integer-default=-1. EGPSF creation flag. Set to zero if EGPSF is created. Remarks: CSTM can be purged. 9.161 GPSTR2 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,OGSR1/ S,N,NOOGS1/S,N,NOEGPSTR/APP/NLSTRAIN $ Input Data Blocks: CASECC EGPSF Table of Case Control command images Table of element to grid point interpolation factors 9-252 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements BGPDT OES1 OESNLXR Basic grid point definition table Table of element stresses or strains in SORT1 format Table of nonlinear element stresses in SORT1 format and appended for all subcases Output Data Blocks: OGS1 EGPSTR OGSR1 Table of grid point stresses or strains in SORT1 format Table of grid point stresses or strains for post-processing in the DBC module Table of raw grid point stresses or strains in SORT1 format. Parameters: NOOGS1 NOEGPSTR APP Output-integer-default=-1. OGS1 creation flag. Set to 0 if OGS1 is created. Output-integer-default=-1. EGPSTR creation flag. Set to 0 if EGPSTR is created. Input-character-default=‘STATICS’ Analysis type. Allowable values are: ‘STATICS’: statics ‘REIGEN’: normal modes ‘TRANRESP’: transient response NLSTRAIN Logical-input-default=FALSE. Nonlinear strain data recovery, otherwise the flag at word 11 of OES1 takes precedence. Set to TRUE if nonlinear strains are to be processed. Remarks: 1. The GPSTRESS Case Control command controls the contents of OGS1. 2. The STRFIELD Case Control command controls the contents of EGPSTR. 9.162 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. NX Nastran DMAP Programmer’s Guide 9-253 Chapter 9 Descriptions of DMAP Modules and Statements Format: GPWG BGPDT,CSTM,UNUSED3,MGG,MEDGE,UNUSED6/ OGPWG/ GRDPNT/WTMASS/ALTSHAPE/SEID $ Input Data Blocks: BGPDT CSTM UNUSED3 MGG MEDGE UNUSED6 Basic grid point definition table Table of coordinate system transformation matrices Unused and can be purged Mass matrix in g-size Edge table for p-element analysis Unused and can be purged Output Data Blocks: OGPWG Grid point weight generator table in weight units Parameters: GRDPNT Input-integer-default=-1. Reference grid point identification number. Inertias are computed GRDPNT. If GRDPNT=-1, the origin of the basic coordinate system is used. Input-real-default=1.0. Specifies scale factor on structural mass matrix. 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. Input-integer-default=-1. Superelement identification number. WTMASS ALTSHAPE SEID Remarks: 1. BGPDT and OGPWG cannot be purged. If MGG is purged or null, GPWG returns. 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. 9-254 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 4. Because of the scalar mass effects, the total mass can have directional properties, and the center of gravity cannot 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 cannot 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 are equal, the center of gravity is unique, and the axes of the inertia terms intersect at the center of gravity. 9.163 GUST Computes loads for aerodynamic analysis Computes loads for aerodynamic analysis that are associated with aerodynamic flow. Format: GUST CASECC,DLT,FRL,DIT,QHJL,UNUSED6,UNUSED7,ACPT, CSTMA,PHF/ PHF1,WJ,QHJK,PFP/ S,N,NOGUST/BOV/MACH/Q $ Input Data Blocks: CASECC DLT FRL DIT QHJL UNUSED6 UNUSED7 ACPT CSTMA PHF Table of Case Control command images Table of dynamic loads Frequency response list Table of TABLEij Bulk Data entry images Aero transformation matrix between h and j sets Unused and can be purged Unused and can be purged Aerodynamic connection and property table Table of aerodynamic coordinate system transformation matrices for g-set and ks-set grid points Frequency response load matrix in the h-set (modal) Output Data Blocks: PHF1 WJ Frequency response load matrix in the h-set (modal) combined with gust loads Gust matrix NX Nastran DMAP Programmer’s Guide 9-255 Chapter 9 Descriptions of DMAP Modules and Statements QHJK PFP Aero transformation matrix between h and j sets Frequency response load matrix in the p-set combined with gust loads Parameters: NOGUST BOV MACH Q Output-integer-no default. Gust load flag. Set to -1 if no gust loads exist; otherwise set to 1. Input-real-default=0.0. Conversion from frequency to reduced frequency. Input-real-default=0.0. Mach number. Input-real-default=0.0. Dynamic pressure. Remarks: 1. If DIT is purged, GUST returns (setting NOGUST = - 1). 2. CSTMA can be purged. 3. Often the shape (time dependence) of the gust is unknown, except for certain statistical information, for example, 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 is 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.) 9.164 IFP Reads Bulk Data Section Reads in the Bulk Data and outputs the finite element model in table form. 9-256 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: IFP BULK/ GEOM1,EPT,MPT,EDT,DIT,DYNAMIC,GEOM2, GEOM3,GEOM4,EPTA,UNUSED11,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 $ Input Data Block: BULK Table of all Bulk Data entries Output Data Blocks: GEOM1 EPT MPT EDT Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to material properties Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Table of TABLEij Bulk Data entry images Table of Bulk Data entry images related to dynamics Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Secondary table of Bulk Data entry images related to element properties Unused and can be purged Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Table of Bulk Data entry images related to conical shell, hydroelastic, and acoustic cavity analysis Table containing parameter values from PARAM Bulk Data entry images Table of all matrices specified on DMI Bulk Data entries DIT DYNAMICS GEOM2 GEOM3 GEOM4 EPTA UNUSED11 MATPOOL AXIC PVT DMI NX Nastran DMAP Programmer’s Guide 9-257 Chapter 9 Descriptions of DMAP Modules and Statements DMINDX DTI DTlNDX DEFUSET EDOM DEQATN DEQIND CONTACT OINT UNUSED25 Index into DMI Table of all matrices specified on DTI Bulk Data entries Index into DTI Table of DEFUSET Bulk Data entry images Table of Bulk Data entries related to design sensitivity and optimization Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of Bulk Data entries related to contact regions P-element output control table. Contains OUTPUT Bulk Data entries. Unused and can be purged Parameters: NOGOIFP RUNIFPi SEID RUNMEPT Logical-output-default=FALSE. Set to TRUE if an error is detected. Logical-output-default=FALSE. Set to TRUE if IFPi module execution is required. Integer-input-default=-1. Superelement identification number. Logical-output-default=FALSE. Set to TRUE if MODEPT module execution is required. Remarks: 1. IFP does not terminate 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 BULK/ GEOM1.1,EPT.1,MPT.1,EDT,DIT,DYNAMIC,GEOM2.1,GEOM3.1,GEOM4.1, EPTA,,MATPOL.1,AXIC,PVT,DMI,DMINDX,DTI,DTINDX,DEFUSET,EDOM, DEQATN,DEQIND,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 $ IF ( RUNIFP3 ) THEN $ IFP3 AXIC/GEOM1.3,GEOM2.3,GEOM3,GEOM4.3/S,N,NOGOIFP3 $ 9-258 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ELSE $ EQUIVX GEOM1.1/GEOM1.3/-1 $ EQUIVX GEOM2.1/GEOM2.3/-1 $ EQUIVX GEOM3.1/GEOM3/-1 $ EQUIVX GEOM4.1/GEOM4.3/-1 $ ENDIF $ IF ( RUNIFP4 ) THEN $ IFP4 AXIC,GEOM1.3,GEOM2.3,GEOM4.3,MATPOL.1/ GEOM1.4,GEOM2.4,GEOM4,MATPOOL/S,N,NOGOIFP4 $ ELSE $ EQUIVX GEOM1.3 /GEOM1.4/-1 $ EQUIVX GEOM2.3 /GEOM2.4/-1 $ EQUIVX GEOM4.3 /GEOM4/-1 $ EQUIVX MATPOL.1/MATPOOL/-1 $ ENDIF $ IF ( RUNIFP5 ) THEN $ IFP5 AXIC,GEOM1.4,GEOM2.4/GEOM1.5,GEOM2.5/S,N,NOGOIFP5 $ ELSE $ EQUIVX GEOM1.4/GEOM1/-1 $ EQUIVX GEOM2.4/GEOM2.5/-1 $ ENDIF $ IF ( RUNIFP6 ) THEN $ IFP6 EPT.1,MPT.1,DIT/EPT.6,MPT.6/S,N,NOGOIFP6/NOCOMP $ ELSE $ EQUIVX EPT.1/EPT.6/-1 $ EQUIVX MPT.1/MPT.6/-1 $ ENDIF $ IF ( RUNIFP7 ) THEN $ IFP7 GEOM2.5,EPT.6,MPT.6,DIT/EPT.7/S,N,NOGOIFP7 $ ELSE $ EQUIVX EPT.6/EPT.7/-1 $ ENDIF $ IF ( RUNIFP8 ) THEN $ IFP8 MPT.6,DIT/MPT/S,N,NOGOIFP8 $ ELSE $ EQUIVX MPT.6/MPT/-1 $ ENDIF $ IF ( RUNIFP9 ) THEN $ IFP9 EPT.7/EPT.9/S,N,NOGOIFP9 $ ELSE $ EQUIVX EPT.7/EPT.9/-1 $ ENDIF $ IF ( RUNMEPT ) THEN $ MODEPT EPT.9,DIT/EPT $ ELSE $ EQUIVX EPT.9/EPT/-1 $ ENDIF $ MODGM2 EPT,GEOM2.5/GEOM2 $ 9.165 IFP1 Reads Case Control Section Format: IFP1 /CASECC,PCDB,XYCDB,POSTCDB,FORCE/S,N,NOGOIFP1/ S,N,LASTCC/S,N,BEGSUP/DMAPNO $ NX Nastran DMAP Programmer’s Guide 9-259 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: CASECC PCDB XYCDB POSTCDB FORCE Table of Case Control command images. Table of model (undeformed and deformed) plotting commands Table of x-y plotting commands Table of commands from the OUTPUT(POST) section of Case Control Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS) section in CASE CONTROL and MSGMESH field information Parameter: NOGOIFP1 LASTCC BEGSUP DMAPNO Logical-output-default=FALSE. Set to TRUE if an error is detected in the Case Control Section. Integer-output-default=0. Set to 2 if the last auxiliary model Case Control section is being processed. Logical-output-default=FALSE. BEGIN SUPER flag. Set to TRUE if the first Bulk Data section begins with BEGIN SUPER instead of BEGIN BULK. Integer-input-default=0 Solution sequence number stored in word 244 of the case control record. The SOL 601 analysis option (106 or 129) is stored in word 245. Remarks: 1. IFP1 does not terminate if an error is detected in the Case Control section. Therefore, the following statement should appear after the module: IF (NOGOIFP1) EXIT $ 2. IFP1 can 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 $ XCASECC//‘DTI‘/1/258//S,N,AUXMID $ PARAML EQUIVX XCASECC/CASEXX/-1 $ EQUIVX XPCDB/PCDB/-1 $ XXYCDB/XYCDB/-1 $ EQUIVX EQUIVX XPOSTCDB/POSTCDB/-1 $ EQUIVX XFORCE/FORCE/-1 $ ENDDO $ 9-260 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.166 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 $ Input Data Block: AXIC Table of Bulk Data entry images related to axisymmetric conical shell, hydroelastic, and acoustic cavity analysis Output Data Blocks: GEOM1X GEOM2X GEOM3X GEOM4X GEOM1 table related to axisymmetric conical shell analysis GEOM2 table related to axisymmetric conical shell analysis GEOM3 table related to axisymmetric conical shell analysis GEOM4 table related to axisymmetric conical shell analysis Parameter: NOGOIFP3 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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 AXIC CCONEAX FORCEAX MOMAX MPCAX Output records None CCONE FORCE MOMENT MPC Output data blocks None GEOM2 GEOM3 GEOM3 GEOM4 NX Nastran DMAP Programmer’s Guide 9-261 Chapter 9 Descriptions of DMAP Modules and Statements Bulk data entry record OMITAX POINTAX Output records OMIT MPC GRID Output data blocks GEOM4 GEOM4 GEOM1 GEOM3 GEOM4 GEOM1 GEOM4 GEOM1 GEOM4 GEOM4 GEOM3 PRESAX RINGAX PLOAD SPC GRID SECTAX MPC GRID SPCAX SUPAX TEMPAX SPC SUPORT TEMP 4. The other Bulk Data entries recognized and processed by IFP3 are: FORCE GRAV LOAD MOMENT TEMPD TEMP GRID MPCADD OMIT SEQGP SPC SPCADD SUPORT Example See the example in the “IFP” module description. 9-262 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.167 IFP4 Processes hydroelastic-related Bulk Data entry records Format: IFP4 AXIC,GEOM1,GEOM2,GEOM4,MATPOOL/ GEOM1X,GEOM2X,GEOM4X,MATPOOLX/S,N,NOGOIFP4 $ Input Data Blocks: AXIC GEOM1 GEOM2 GEOM4 MATPOOL Table of Bulk Data entry images related to axisymmetric conical shell, hydroelastic, and acoustic cavity analysis Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Output Data Blocks: GEOM1X GEOM2X GEOM4X MATPOOLX GEOM1 table related to hydroelastic analysis GEOM2 table related to hydroelastic analysis GEOM3 table related to hydroelastic analysis MATPOOL table related to hydroelastic analysis Parameter: NOGOIFP4 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. Remarks: 1. IFP4 does not terminate the run if an error is detected in the Bulk Data entries. NOGOIFP4 should be checked before proceeding to the GP1 module 2. IFP4 must appear after the IFP3 and before the IFP5 modules. 3. The following is a list of Bulk Data entry records generated or modified by IFP4: NX Nastran DMAP Programmer’s Guide 9-263 Chapter 9 Descriptions of DMAP Modules and Statements Bulk data entry record AXIF BDYLIST CFLUID2 CFLUID3 CFLUID4 FLSYM FREEPT Output tecords None Various CFLUID2 CFLUID3 CFLUID4 Various SPOINT MPC Output data blocks None MATPOOLX GEOM2X GEOM2X GEOM2X MATPOOLX GEOM2X GEOM4X GEOM2X GEOM4X GEOM1X GEOM2X GEOM4X GEOM1X GEOM1X MATPOOLX FSLIST CFSMASS SPC GRIDB PRESPT GRID SPOINT MPC RINGFL GRID SEQGP DMIAX DMIG Example: See the example in the “IFP” module description. 9.168 IFP5 Process acoustic cavity-related Bulk Data entry records Format: IFP5 AXIC,GEOM1,GEOM2/ GEOM1X,GEOM2X/S,N,NOGOIFP5 $ 9-264 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: AXIC GEOM1 GEOM2 Table of Bulk Data entry images related to axisymmetric conical shell, hydroelastic, and acoustic cavity analysis Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Output Data Blocks: GEOM1X GEOM2X GEOM1 table related to acoustic cavity analysis GEOM2 table related to acoustic cavity analysis Parameter: NOGOIFP5 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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 AXSLOT CAXIF2 CAXIF3 CSLOT3 CSLOT4 CAXIF4 GRIDF GRIDS SLBDY Input data block AXIC GEOM2 GEOM2 GEOM2 GEOM2 GEOM2 AXIC AXIC AXIC Output record None PLOTEL PLOTEL PLOTEL PLOTEL PLOTEL GRID GRID CELAS2 Output data block None GEOM2X GEOM2X GEOM2X GEOM2X GEOM2X GEOM1X GEOM1X GEOM2X NX Nastran DMAP Programmer’s Guide 9-265 Chapter 9 Descriptions of DMAP Modules and Statements Example: See the example in the “IFP” module description. 9.169 IFP6 Creates PSHELL and MAT2 Bulk Data entry records Create PSHELL and MAT2 Bulk Data entry records based upon data on PCOMP and MAT8 bulk data entry records. Format: IFP6 EPT,MPT,DIT,PCOMPT/ EPTC,MPTC,PCOMPTC/ S,N,NOGOIFP6/S,N,NOCOMP/DSFLAG $ Input Data Blocks: EPT MPT DIT PCOMPT Table of Bulk Data entry images related to element properties, in particular, PSHELL and PCOMP entries Table of Bulk Data entry images related to material properties, in particular, MAT2 and MAT8 entries Table of TABLEij Bulk Data entry images Table containing LAM option input from the PCOMP Bulk Data entry Output Data Blocks: EPTC MPTC PCOMPTC A copy of EPT except that PCOMP records are replaced by equivalent PSHELL records A copy of MPT except that MAT8 records are replaced by equivalent MAT2 records A table containing LAM option input and expanded information from the PCOMP Bulk Data entry Parameter: NOGOIFP6 NOCOMP DSFLAG Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry records are found. Input-logical-default=FALSE. Design sensitivity flag. Set to TRUE for design sensitivity job. 9-266 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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” module description. 9.170 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 $ Input Data Blocks: GEOM2 EPT MPT DIT Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to element properties; in particular, PBCOMP entries Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Output Data Blocks: EPTX A copy of EPT except that PBCOMP records are replaced by equivalent PBEAM records. Parameter: NOGOIFP7 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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. NX Nastran DMAP Programmer’s Guide 9-267 Chapter 9 Descriptions of DMAP Modules and Statements Example: See the example in the “IFP” module description. 9.171 IFP8 Creates MATHP Bulk Data entry records Create MATHP Bulk Data entry records based upon data on the TABLES1 Bulk Data entry records for use in hyperelastic analysis. Format: IFP8 MPT,DIT/MPTX/S,N,NOGOIFP8 $ Input Data Blocks: MPT DIT Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Output Data Blocks: MPTX A copy of MPT except that applicable MATHP records are updated to include referenced TABLSE1 Bulk Data entry information Parameter: NOGOIFP8 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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” module description. 9-268 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.172 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/EPTX/S,N,NOGOIFP9 $ Input Data Block: EPT Table of Bulk Data entry images related to element properties; in particular, PBARL and PBEAML entries. Output Data Blocks: EPTX A copy of EPT except that PBARL and PBEAML records are replaced by equivalent PBAR and PBEAM records Parameter: NOGOIFP9 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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. Example: See the example in the “IFP” module description. 9.173 Format: IFPINDX IFPINDX Creates an IFP table index keyed by identification number /IFPDB $ Input Data Blocks: None. NX Nastran DMAP Programmer’s Guide 9-269 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: 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. 9.174 IFT 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 $ Input Data Blocks: UXF CASECC TRL FOL Solution matrix from frequency response analysis in d- or h-set Table of Case Control command images Transient response list Frequency response frequency output list Output Data Blocks: UXT TOL Solution matrix from transient response analysis in d- or h-set Transient response time output list Parameters: IFTM Input-integer-default=1. Fourier transform method. 9-270 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 0 1 2 Constant Piecewise linear (default) Cubic spline 9.175 INPUTT2 Input tables of matrices from a FORTRAN unit Recovers up to five tables or matrices from a FORTRAN unit. This unit can have been written either by a FORTRAN program or by the companion module OUTPUT2. Format: INPUTT2 /DB1,DB2,DB3,DB4,DB5/ITAPE/IUNIT/LABL $ Output Data Blocks: DBi Data blocks to be input from the FORTRAN unit Parameters: ITAPE Input-integer-default = 0. ITAPE controls the status of the unit before INPUTT2 attempts to extract any data blocks. The following controls are available. Action Skip forward n data blocks before reading. Data blocks are read starting at the current position. Rewind before reading, position tape past label (LABL). Print data block names and rewind before reading (checks LABL). Input-integer-no default. IUNIT is the FORTRAN unit number from which the data blocks are to be read. UGS does not recommend using IUNIT = 0. 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. Tape label checked? No ITAPE value +n 0 -1 -3 IUNIT LABL ITAPE value +n NX Nastran DMAP Programmer’s Guide 9-271 Chapter 9 Descriptions of DMAP Modules and Statements ITAPE value 0 -1 -3 Tape label checked? No Yes Yes (Warning Check) Remarks: 1. Any or all of the output data blocks can be purged. Only nonpurged data blocks are taken from the tape. The data blocks are 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. UGS recommends using the ASSIGN FMS statement for assigning the FORTRAN unit. Certain FORTRAN units are reserved, see “Making File Assignments” in the NX Nastran Installation and Operations Guide for a listing of reserved FORTRAN units. 3. Data blocks are 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, 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. 9.176 INPUTT4 Inputs a matrix from a FORTRAN unit Reads an ASCII or binary file from a FORTRAN unit and creates a matrix suitable for input to other modules. OUTPUT4 module output can also be used as input. Format: INPUTT4 /M1,M2,M3,M4,M5/NMAT/IUNIT/ITAPE/UNUSED4/BIGMAT $ Output Data Blocks: Mi Matrices Parameters: NMAT IUNIT Input-integer-default=1. NMAT is the number of matrices that have been written on the user-supplied unit. Must be less than or equal to 5. Input-integer-no default. The value of IUNIT is the FORTRAN unit number on which the user-supplied matrix was written. 9-272 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ITAPE Input-integer-default=-1. ITAPE controls the status of the unit before INPUTT4 tries to extract any matrices as follows: Action None Rewind IUNIT before read Rewind IUNIT at end Both Input-integer-default=1. Unused. Input-logical-default=FALSE. BIGMAT = FALSE selects the format that uses a string header as described under Remark 1. But if the matrix has more than 65535 rows, BIGMAT is automatically set to TRUE regardless of the value specified. ITAPE 0 -1 -2 -3 UNUSED4 BIGMAT Remarks: 1. Each matrix is read from IUNIT according to its ASSIGN FMS statement, and the BIGMAT as shown in the remarks of the OUTPUT4 description. 2. Each real or complex matrix must have been written on IUNIT according to the format below. • For example, in the nonsparse format and binary format (ASSIGN FORM=UNFORMATTED), each matrix can be created (assumed on FORTRAN unit 8) as follows: Record 1-four word record WRITE(8) NCOL,NROW,NF,NTYPE Record 2,3,and so on WRITE(8) ICOL,IROW,NW,(X(I),I=1,NW) • If the ASCII format (ASSIGN FORM=FORMATTED) and the nonsparse format is desired, each matrix must be created as follows: Record 1 100 WRITE(8,100) NCOL,NROW,NF,NTYPE FORMAT(4I8) Record 2,3, and so on 200 WRITE(8,200) ICOL,IROW,NW,(X(I),I=1,NW) 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. NX Nastran DMAP Programmer’s Guide 9-273 Chapter 9 Descriptions of DMAP Modules and Statements • The NX Nastran "util" directory contains a utility subroutine called MAKIDS in a file called mattst.f (or .for) which writes a matrix into the format suitable for INPUTT4. (See the NX Nastran 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 are properly handled if they are input). • • 3. UGS recommends using the ASSIGN FMS statement for assigning the FORTRAN unit. Selection of a proper value for IUNIT is machine dependent. If the ASSIGN statement is not provided, 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 the NX Nastran 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. 6. If you select any of the options for endianness using the ASSIGN FMS statement, the resulting files are Fortran-readable only on systems that have the same endianness. 9.177 INTERR Generates modal components of base motion from a response spectrum Format: INTERR CASECC,DIT,DYNAMIC,ZETAH,FN,SPECSEL,PSI/ UHR/ CLOSE/OPTION $ Input Data Blocks: CASECC DIT DYNAMIC ZETAH FN SPECSEL PSI Table of Case Control command images Table of TABLEij Bulk Data entry images Table of Bulk Data entry images related to dynamics Mass-normalized damping Matrix of natural frequencies (mass normalized stiffness) Response spectra input correlation table Modal partitioning factor matrix 9-274 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: UHR Modal displacement vector for spectral analysis Parameters: CLOSE Input-real-no default. Close natural frequency scale factor. Under the OPTION=‘ABS’method, close natural frequencies are summed if the natural frequencies satisfy: fi+1 < CLOSE * fi OPTION Input-character-no default. Response summation method for scaled response spectra analysis only. Possible values are: ‘ABS’: Absolute ‘SRSS’: Square root of the sum of the squares ‘NRL’: Naval Research Laboratory (new) “NRLO’: Naval Research Laboratory (old) Remarks: Only FN can be purged, in which case INTERR returns. 9.178 Format: ISHELL ISHELL Invokes an external program //PRGNAME/S,N,IRTN/NOINT/NOREAL/NOCMPX/NOCHAR/NOUNIT/ INT1 /INT2 /INT3 /INT4 / REAL1/REAL2/REAL3/REAL4/ CMPX1/CMPX2/CMPX3/CMPX4/ CHAR1/CHAR2/CHAR3/CHAR4/ IUNIT1/IUNIT2/IUNIT3/IUNIT4 $ Input Data Blocks: None. Output Data Blocks: None. Parameters: PRGNAME Input-character-no default. Name of external program. NX Nastran DMAP Programmer’s Guide 9-275 Chapter 9 Descriptions of DMAP Modules and Statements IRTN NOINT NOREAL NOCMPX NOCHAR NOUNIT INTi REALi CMPXi CHARi IUNITi Output-integer-default=0. External program return code. -1 indicates failure. Input-integer-default=0. Number of integer value inputs. Input-integer-default=0. Number of real value inputs. Input-integer-default=0. Number of complex value inputs. Input-integer-default=0. Number of character value inputs. Input-integer-default=0. Number of Fortran input units. Input-integers-default=0. Integer values. Input-real-default=-1.0. Real values. Input-complex-default=(-1.0,0.0). Complex values. Input-character-default=‘NULLNULL’ Character values. Input-character-default=0. Fortran unit numbers. Remarks: 1. The external program identified by PRGNAME is passed arguments from NX 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 NX Nastran‘s data structures. 2. NX 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. ISHELL capability is supported on UNIX platforms only. 5. The name of external program must be uppercase and limited to 8 characters. 6. The unit numbers must have associated ASSIGN statements. Based on the ASSIGN statements, the module automatically passes the physical filenames associated with unit numbers to the external program. These filenames are passed at positions 31 through 34. 7. Errors encountered in ISHELL do not terminate the NX Nastran execution. 8. 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. 9. You need a utility program to parse the arguments for your external program. For example, use set -A argarray "$@" or a similar technique. 10. The FORTIO module must be used with ISHELL to OPEN and CLOSE FORTRAN units referenced by the external program. 9-276 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Example: Invoke user executable DOITPGM. ISHELL //‘DOITPGM’$ 9.179 LAMX Eigenvalue Table Editor Modifies, creates, or converts to matrices the LAMA (real eigenvalues) and CLAMA (complex eigenvalues) tables. Formats: Modify LAMA: LAMX EMAT, LAMA/LAMAX/NLAM/RESFLG $ Create LAMA from a matrix: LAMX FREQMASS,/LAMA/NLAM/RESFLG $ Convert LAMA into a matrix: LAMX ,,LAMA/LMAT/-1/RESFLG $ Create CLAMA from a matrix: LAMX CLAMMAT,/CLAMA/-1 $ Convert CLAMA into a matrix: LAMX ,,CLAMA/CLAMMAT/-2 $ Input Data Blocks: EMAT LAMA FREQMASS CLAMA CLAMMAT Matrix of editing parameters. See Remark 1. Normal modes eigenvalue summary table Matrix of frequencies and generalized masses. See Remark 2. Complex eigenvalue summary table Diagonal matrix with complex eigenvalues on the diagonal NX Nastran DMAP Programmer’s Guide 9-277 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: LAMAX LAMA LMAT CLAMMAT Modified LAMA table Normal modes eigenvalue summary table created from FREQMASS Normal modes eigenvalue summary table converted to a matrix. See Remark 3. Diagonal matrix with complex eigenvalues on the diagonal Parameters: NLAM Integer-input-default=0. The maximum number of modes in the output data block LAMAX. If NLAM = 0, the number of modes in LAMAX is the same as that of LAMA or FREQMASS. If NLAM = -1, the matrix LMAT is produced instead. Integer-input-default=0. Subheading print flag used by the OFP module for residual vector eigenvalues. 1 2 0 ”Print “BEFORE AUGMENTATION OF RESIDUAL VECTORS Print “AFTER AUGMENTATION OF RESIDUAL VECTORS” No print RESFLG Remarks: 1. The EMAT matrix has three rows and one column for each mode which are used to modify the frequency and generalized mass. Figure 9-1. • If R3j ≥ 0, the frequency f0j and generalized mass m0j are extracted from LAMA and modified accordingly: – frequency: fj = Rij + (1.0 + R2j)f0jfixed shift: R1j = shift and R2j = −1.0 fractional change: R1j = 0.0 and R2j = fraction 9-278 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements – • Generalized mass: Then eigenvalue, radians, and generalized stiffness are based on the modified frequency and generalized mass: radians: ωj = 2πfj eigenvalue: λj = ω2j generalized stiffness: Kj = λj mj • • If R3j = −1, mode j is not copied to LAMAX. If R1j = 0, R2j = 0 and R3j = 0, mode j is copied from LAMA to LAMAX without modification. 2. The FREQMASS matrix has three rows and one column for each mode. The first row contains the frequencies and the third row contains the generalized masses. The second row is null. Then eigenvalue, radians, and generalized stiffness are computed as in Remark 3. 3. In the LMAT matrix, each row corresponds to a mode. Each column corresponds to eigenvalue, radians, frequency, generalized mass, and generalized stiffness. Number of Modes: 5. Examples: 1. For LAMA (real) tables: • Assume that 10 modes are defined in the LAMA table. We now want to modify the frequency data of the LAMA table in the following way: NX Nastran DMAP Programmer’s Guide 9-279 Chapter 9 Descriptions of DMAP Modules and Statements Mode(s) 1 through 3 4 5 6 7 8 9 10 Desired modification none multiply f4 by 0.8 none delete replace f7 by 173.20 replace m8 by 2.98 none delete DMl format for EMAT — DMI,EMAT,4,2,-0.2 — DMI,EMAT,6,3,-1.0 DMI,EMAT,7,1,173.20,-1.0 DMI,EMAT,8,3,2.98 — DMI,EMAT,10,3,-1.0 The DMI header record entry is also required: DMI,EMAT,0,2,1,1,,3,10 The DMAP is: DMIIN LAMX EQUIVX DMI,DMINDX/EMAT,,,,,,,,, $ EMAT,LAMA/LAMB/9 $ LAMB/LAMA/ALWAYS $ • Create a LAMB table with fj = 10.0, 20,0, 30.0, 40, and mj = 1.0, 1.0, 1.0, 2.0. DMI, DMI, DMI, DMI, DMI, FREQMASS, FREQMASS, FREQMASS, FREQMASS, FREQMASS, 0, 1, 2, 3, 4, 2, 1, 1, 1, 1, 1, 1, 10.0, 20.0, 30.0, 40.0, , 3, 4 00, 1.0 0.0, 1.0 0.0, 1.0 0.0, 2.0 The DMAP is: DMIIN LAMX OFP DMI,DMINDX/,,,,,,,,,$ FREQMASS,/LAMB $ LAMB//$ • Generate a matrix LMAT from a LAMA table. The DMAP is: LAMX, ,LAMA/LMAT/-1 $ 2. For CLAMA (complex) tables: • Create a CLAMA table with eigenvalues -1.0, -1.0, -2.0, -2.0, and -3.0, +1.0. The DMI data for CLAMMAT is: DMI, DMI, DMI, DMI, CLAMMAT, CLAMMAT, CLAMMAT, CLAMMAT, 0,6,3,3, ,3,3 1,1,-1.0,-1.0 2,2, -2.0, -2.0 3,3, -3.0, +1.0 The DMAP is: DMIIN DMI,DMINDX/CLAMMAT,,,,,,,,,/$ 9-280 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements LAMX CLAMMAT,/CLAMB/-1 $ • Generate a matrix CLAMMAT from a CLAMA table. The DMAP is: LAMX, ,CLAMA/CLAMMAT/-2 $ 9.180 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 $ Input Data Blocks: KGG MGG RMG CASECC USET CSTM CASECC EQEXIN SIL DYNAMIC INVEC Stiffness matrix in g-set Mass matrix in g-set Multipoint constraint equation matrix Table of Case Control command images Degree-of-freedom set membership table for g-set Table of coordinate system transformation matrices Table of Case Control command images Equivalence table between external and internal grid/scalar identification numbers Scalar index list Table of Bulk Data entry images related to dynamics Starting vector(s) NX Nastran DMAP Programmer’s Guide 9-281 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: PHG LAMA LAMMAT MI QG QMG Normal modes eigenvector matrix in the g-set Normal modes eigenvalue summary table Diagonal matrix containing eigenvalues on the diagonal Modal mass matrix Single-point constraint forces of constraint matrix in the g-set Multipoint constraint forces of constraint matrix in the g-set Parameters: FORMAT NEIGV NSKIP FLUID Input-character-no default. Problem type. Must specify ‘MODES’ Buckling problems are not supported. Output-integer-no default. The number of eigenvectors found. Set to -1 if none were found. Input-integer-default=1. Subcase record number to read in CASECC for the METHOD set identification number. Input-logical-default=FALSE. METHOD command option (FLUID or STRUCTURE). If FLUID=TRUE, the EIGRL entry is selected from METHOD(FLUID) Case Control command. Input-real-default=1.0E-10. Unused. Input-integer-default=0. Alternate set identification number. If SID=0, the set identification number is obtained from the METHOD command in CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMICS. If SID>0, the METHOD command is ignored and the EIGR, EIGB, or EIGRL is selected by this parameter value. All subsequent parameter values (METH, F1, and so on) are ignored. If SID<0, both the METHOD command and all EIGR, EIGB, or EIGRL entries are ignored and the subsequent parameter values (METH, F1, and so on) are used to control the eigenvalue extraction. F1 F2 NDES Input-real-default=0.0. The lower frequency bound in cycles per unit time. Input-real-default=0.0. The upper frequency bound in cycles per unit time. The default value of 0.0 indicates machine infinity. Input-integer-default=0. The number of desired eigenvalues. If the last mode is repeated, nDes + m (where m is the multiplicity of the last mode) solutions are found. EPSORTH SID 9-282 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MSGLVL Input-integer-default=1. The level of diagnostic output for the Lanczos method only. 0 1 2 3 4 No output Warning and fatal messages Summary output Detailed output on cost and convergence More detailed output on orthogonalizations and some extraarithmetic to check on orthogonality MAXSET Input-integer-default=7. Vector block size for Lanczos method only. The actual value of block size can be reduced depending on available memory and problem size. Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL must be greater than 0.0. Input-character-default=’ ’ Method for normalizing eigenvectors. By default (or NORM=‘MASS‘), MASS normalization is performed. NORM=‘MAX’selects normalization by maximum displacement. Input-integer-default=-1. Number of eigensolutions to check and the quantity of error checking output. If left at its default value, only the highest epsilon for the first ten or NEIGV modes (whichever is less) are printed. If EPSNO is greater than zero, the epsilons for the first EPSNO are printed. Input-integer-default=1. Single point forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. Input-integer-default=1. Multipoint forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. SHFSCL NORM EPSNO NOQG NOQMG Remarks: 1. Buckling is not supported. 2. KGG and MGG must be real and symmetric 3. INVEC can be purged. 4. QG and QMG are created only if USET is specified and NOQG and NOQMG are specified to 1. 9.181 LCGEN Expands Case Control table based on LSEQ Bulk Data entries NX Nastran DMAP Programmer’s Guide 9-283 Chapter 9 Descriptions of DMAP Modules and Statements Format: LCGEN CASECC,SLT,ETT,DYNAMIC,GEOM4/ CASESX/ NSKIP/IOPT/APP $ Input Data Blocks: CASECC SLT ETT DYNAMIC Table of Case Control command images Table of static loads Element temperature table Table of Bulk Data entry images related to dynamics without DAREA entry images. LCGEN reads the RLOADi and TLOADi records to determine unique DAREA identification numbers. Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity. LCGEN matches the SPCD and SPC IDs with TLOADi and RLOADi images for possible enforced motion. GEOM4 Output Data Block: CASESX Expanded Case Control table Parameters: NSKIP IOPT Input-integer-default=0. Subcase record number to read in CASECC for the LOADSET set identification number. Input-integer-default=0. LOADSET Case Control command processing flag. If IOPT =0, the LOADSET command is ignored and all LSEQ entries are used to expand CASECC. If IOPT=1, only those LSEQ entries selected by the LOADSET command are used. Input-character-no default. Analysis type. Allowable types are: Blank ‘FREQRESP’ ‘TRANRESP’ Not dynamics Frequency response Transient response APP 9.182 LMATPRT Prints combined design sensitivity/constraint matrix 9-284 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Prints the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity Analysis only. Format: LMATPRT DSCMR,DSROWL,DSCOLL// DSZERO $ Input Data Blocks: DSCMR DSROWL DSCOLL Old combined design sensitivity/constraint matrix Table of design sensitivity row labels for design sensitivity matrix, DSCMR Table of design sensitivity column labels for design sensitivity matrix, DSCMR Output Data Blocks: None. Parameter: DSZERO Input-real-default=0.0. Design sensitivity coefficient print threshold. If the absolute value of the coefficient is greater than DSZERO, the coefficient is printed. 9.183 LRFORCE Takes Lagrange rigid forces from the displacement vector and stores them in the MPC force vector. Format: LRFORCE UG,KDICT,KELM/QMX/LMFACT/NOLM $ Input Data Blocks: UG KDICT KELM Displacements in G set KELM dictionary table Table of element matrices for stiffness. Output Data Blocks: QMX M set constraint forces NX Nastran DMAP Programmer’s Guide 9-285 Chapter 9 Descriptions of DMAP Modules and Statements Parameter: LMFACT NOLM Real, LM scaling factor Integer, Number of LM 9.184 MACOFP Creates FORTRAN file containing OFP module output Creates a FORTRAN file containing selected output normally printed by the OFP module. Format: MACOFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7// ITAPE/IUNIT/UNUSED3 $ Input Data Blocks: OFPi Any table that is suitable for printing by the OFP module Output Data Blocks: None. Parameters: ITAPE Input-integer-default=0. FORTRAN unit positioning option. 0 No action before write. -1 Rewind before write. -2 A new unit is mounted before write and rewind at end. -3 Rewind at start and end. -4 Dismount old unit and mount new unit. IUNIT UNUSED3 Input-integer-default=0. FORTRAN unit number. Input-character-default=‘XXXXXXXX’ Unused. 9.185 MAKAEFA Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries Extracts data specified on the AEDW, AEPRESS and AEFORCE Bulk Data entries that reference UXVEC, DMIJ and DMIK Bulk Data entries. 9-286 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MAKAEFA EDT,MATPOOL,AECTRL,AEBGPDTJ*,AEBGPDTI*,AEBGPDTK*/ AEDWIDX,UXVW,AEDW,AEIDW,AEPRSIDX,UXVP,AEPRE, AEIPRE,AEFIDX,UXVF,AEFRC/ MACHNO/SYMXZ/SYMXY $ Input Data Blocks: EDT MATPOOL AECTRL AEBGPDTJ* AEBGPDTI* AEBGPDTK* Table of Bulk Data entry images related to aerodynamics Table of Bulk Data entry images containing DMIJ, DMIJI and DMIK entries Table of aeroelastic model controls Family of basic grid point definition tables for the js-set aerodynamic degrees of freedom Family of basic grid point definition tables for the interference js-set aerodynamic degrees of freedom Family of basic grid point definition tables for the ks-set aerodynamic degrees of freedom Output Data Blocks: AEDWIDX UXVW AEDW AEIDW AEPRSIDX UXVP AEPRE AEIPRE AEFIDX UXVF AEFRC Index to the AEDW tables Matrix of UXVEC vectors defined by the AEDW Bulk Data entries Matrix of downwash vectors contained on DMIJ Bulk Data entries referenced by the AEDW entries Matrix of interference downwash vectors contained on DMIJ Bulk Data entries referenced by the AEDW entries Index to the AEPRESS tables Matrix of UXVEC vectors defined by the AEPRESS Bulk Data entries Matrix of pressure vectors contained on DMIJ Bulk data entries referenced by the AEPRESS entries Matrix of interference pressure vectors contained on DMIJ Bulk data entries referenced by the AEPRESS entries Index to the AEFORCE tables Matrix of UXVEC vectors defined by the AEFORCE Bulk Data entries Matrix of force vectors contained on DMIK Bulk data entries referenced by the AEFORCE entries NX Nastran DMAP Programmer’s Guide 9-287 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: MACH SYMXZ SYMXY Input-real-no default. Mach number. Input-integer-no default. Aerodynamic x-z symmetry flag. Input-integer-no default. Aerodynamic x-y symmetry flag. Remarks: None. 9.186 MAKAEFS Generates an index and associated matrices Generates an index and the associated matrices based on the AEFORCE Bulk Data entry with MESH=‘STRUCT’ Format: MAKAEFS EDT,AECRTL,BGPDT,GEOM3,CSTMA/ AEDBIDX,UXVST,PGVST/ MACH/SYMXZ/SYMXY $ Input Data Blocks: EDT AECTRL BGPDT GEOM3 CSTMA Table of Bulk Data entry images related to aerodynamics Table of aeroelastic model controls Basic grid point definition table Table of Bulk Data entry images related to static and thermal loads Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points Output Data Blocks: AEDBIDX UXVST PGVST Index table consisting of the triples Aerodynamic extra point displacement matrix Static load vector matrix (g-set) Parameters: MACH Input-real-no default. Mach number. 9-288 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SYMXZ SYMXY Input-integer-no default. Aerodynamic x-z symmetry flag. Input-integer-no default. Aerodynamic x-y symmetry flag. Remarks: None. 9.187 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 $ Input Data Blocks: AERO EDT AEMONOLD Table of control information for aerodynamic analysis Element deformation table. Contains aerodynamic model records, specifically AESURF and AESURFS. Table of HM monitor points Output Data Blocks: AEMONPT MONITOR Table of aerodynamic monitor points (COEF and HM only) Table of structural monitor points (COEF and HM only) Parameters: AECONFIG Input-character-default=‘REFCSTOT’ Aerodynamic configuration. Remarks: None. 9.188 MAKCOMP Extracts components from EDT NX Nastran DMAP Programmer’s Guide 9-289 Chapter 9 Descriptions of DMAP Modules and Statements Extract components from EDT and merge with previously defined components if OLDCMP is present. Format: MAKCOMP Input Data Blocks: EDT AECOMP AECMPOLD Element deformation table. Contains aerodynamic model records, specifically monitor and component input. Aerodynamic component definition table (CAEROi Bulk Data entries). Previously generated AECOMP. Output Data Blocks: AEROCOMP STRUCOMP Table of aerodynamic components when MESH=‘AERO’ Table of structural components when MESH=‘STRU’ Parameters: MESH Input-character-no default. Mesh type. Remarks: None. 9.189 MAKENEW Converts tables from pre-Version 69 to 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 $ 9-290 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: OLDDBi Output table in pre-Version 69 format. See Remarks. Output Data Blocks: NEWDBi Input table in Version 69 (or greater) format. See Remarks. Parameters: OLDNAMi NEWNAMi Input-character-default=’ ’ The generic name of the corresponding output; for example, OLDNAM3 corresponds to OLDDB3, and so on. See Remarks. Input-character-default=’ ’ The generic name of the corresponding input table; for example, NEWNAM3 corresponds to NEWDB3, and so on. See Remarks. Remarks: 1. The allowable values for NEWNAMi and OLDNAMi are: AXIC BGPDT CSTM EQEXIN EST GEOM1 GEOM4 GPDT GPL SIL EPT Table of axisymmetric and fluid Bulk Data entries Basic grid point definition table Table of coordinate system transformation matrices. Equivalence table between external and internal grid/scalar identification numbers Element summary table Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to degree-of-freedom set membership and constraints Grid point definition table External grid/scalar point identification number list Scalar index list Element property table 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 MAKENEW GEOM1,AXIC,,,/NGEOM1,NAXIC,,,/ ‘GEOM1‘/‘AXIC‘///‘GEOM1‘/‘AXIC’$ AXIC,GEOM1,,,/NAXIC,NGEOM1,,,/ ‘AXIC‘/‘GEOM1‘///‘AXIC‘/‘GEOM1’$ NX Nastran DMAP Programmer’s Guide 9-291 Chapter 9 Descriptions of DMAP Modules and Statements 3. In order to create BGPDT, EST, and CSTM, MAKENEW requires multiple inputs. For example, MAKENEW MAKENEW MAKENEW BGPDT,EQEXIN,SIL,GPL,/NBGPDT,,,,/ ‘BGPDT‘/‘EQEXIN‘/‘SIL‘/‘GPL‘//‘BGPDT’ $ EST,EQEXIN,SIL,,,/NEST,,,,/ ‘EST‘/‘EQEXIN‘/‘SIL‘///‘EST’$ 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. 9.190 Format: MAKEOLD MAKEOLD Converts tables from Version 69 (or greater) to pre-Version 69 format NEWDB1,NEWDB2,NEWDB3,NEWDB4,NEWDB5/ OLDDB1,OLDDB2,OLDDB3,OLDDB4,OLDDB5/ NEWNAM1/NEWNAM2/NEWNAM3/NEWNAM4/NEWNAM5/ OLDNAM1/OLDNAM2/OLDNAM3/OLDNAM4/OLDNAM5 $ Input Data Blocks: NEWDBi Input table in Version 69 (or greater) format. See Remarks. Output Data Blocks: OLDDBi Output table in pre-Version 69 format. See Remarks. Parameters: NEWNAMi OLDNAMi Input-character-default=’ ’ The generic name of the corresponding input table; for example, NEWNAM3 corresponds to NEWDB3, and so on. See Remarks. Input-character-default=’ ’ The generic name of the corresponding output; for example, OLDNAM3 corresponds to OLDDB3, and so on. See Remarks. Remarks: 1. The allowable values for NEWNAMi and OLDNAMi are: AXIC BGPDT Table of axisymmetric and fluid Bulk Data entries Basic grid point definition table 9-292 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CSTM EQEXIN EST GEOM1 GPDT GPL SIL EPT Table of coordinate system transformation matrices Equivalence table between external and internal grid/scalar identification numbers Element summary table Table of Bulk Data entry images related to geometry Grid point definition table External grid/scalar point identification number list Scalar index list Element property table 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 MAKEOLD GEOM1,AXIC,,,/OGEOM1,OAXIC,,,/ ‘GEOM1‘/‘AXIC‘///‘GEOM1‘/‘AXIC’$ AXIC,GEOM1,,,/OAXIC,OGEOM1,,,/ ‘AXIC‘/‘GEOM1‘///‘AXIC‘/‘GEOM1’$ 3. If BGPDT is specified as input, MAKEOLD creates four tables BGPDT, EQEXIN, SIL, and GPL. For example, MAKEOLD BGPDT,,,,/OBGPDT,OEQEXIN,OSIL,OGPL,/ ‘BGPDT‘/////‘BGPDT‘/‘EQEXIN‘/‘SIL‘/‘GPL’$ 4. Heat transfer and p-elements in EST cannot be processed by MAKEOLD. 9.191 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 $ Input Data Blocks: AERO CSTMA Table of control information for aerodynamic analysis Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points NX Nastran DMAP Programmer’s Guide 9-293 Chapter 9 Descriptions of DMAP Modules and Statements BGPDT USET TRX Basic grid point definition table Degree-of-freedom set membership table for g-set Acceleration selection matrix for the list of aerodynamic extra-points (6 rows by NX columns) Output Data Block: TR PRBDOFS Matrix to transform forces from the support point to the aerodynamic reference point 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 An instance of an ADBINDX that describes the acceleration entries UX vector states for the active URDDi. These are rows of TRX that are non-null. Null rows occur either because AESTAT and URDDi were not defined, or because the associated URDDi is invalid for this symmetry condition (for example, URDD1,3,5 are invalid for antisymmetric analysis). 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. URDDIDX URDDUXV TRANTR Parameters: AUNITS Input-real-no default. Used to convert accelerations expressed in gravity units to units of length per time squared. Example: Excerpt from subDMAP AESTATRS: DBVIEW STBGPDT=BGPDTS WHERE (MODLTYPE=‘STRUCTUR‘) $ DBVIEW STUSET=USET WHERE (MODLTYPE=‘STRUCTUR‘) $ MAKETR AERO,CSTMA,STBGPDT,STUSET/TR $ 9.192 MAKMON Builds table of monitor points 9-294 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MAKMON Input Data Blocks: EDT AEROCOMP STRUCOMP Element deformation table. Contains aerodynamic model records, specifically monitor and component input. Table of aerodynamic components when MESH=‘AERO’ Table of structural components when MESH=‘STRU’ Output Data Blocks: AEMONPT MONITOR Table of aerodynamic monitor points Table of structural monitor points Parameters: None. Remarks: None. 9.193 MATGEN Matrix generator Generates different kinds of matrices for subsequent use in other matrix operation modules. Format: MATGEN T/MAT/P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P13 $ Input Data Block: T Optional tabular data for use in generating the matrix NX Nastran DMAP Programmer’s Guide 9-295 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Block: MAT Matrix data block Parameters: P1 P2 through P11 P12 P13 Input-integer-no default. Option selection parameter as described below. Input-integer-default=0. Provide parametric data depending on P1. Input-character-default=‘A’ See Option P1 = 11. Input-character-default=‘L’ See Option P1 = 11. 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 $ Input Data Blocks: None. Output Data Block: MAT Real identity matrix Parameters: P2 P3 P4 Order of matrix Skew flag. If nonzero, generate a skew-diagonal matrix. Precision (1 or 2). If zero, use machine precision. Example: Generate a real 10 x 10 identity matrix. MATGEN ,/I10X10/1/10 $ 9-296 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Option P1 = 2 Generates an identity matrix trailer. Format: MATGEN ,/MAT/2/P2 $ Input Data Blocks: None. Output Data Block: MAT Real identity matrix. See Remarks. 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 (for example, MPYAD, FBS, CEAD). P1 = 1 is the preferred option. Example: Generate a real 10 x 10 identity matrix trailer. MATGEN ,/TI10X10/2/10 $ Option P1 = 3 Generate a data block of prescribed size. Format: MATGEN ,/DB/3/P2 $ Input Data Blocks: None. Output Data Block: DB Data block. See Remarks. Parameters: P2 Number of GINO blocks to be written NX Nastran DMAP Programmer’s Guide 9-297 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: None. Output Data Block: MAT Pattern matrix Parameters: P2 P3 P4 P5 P6 P7 P8 Number of columns Number of rows Precision Number of values in nonzero string Row number increment between nonzero strings after first nonzero string (P7-1). Produces (P6-1) zeros. Row number of first nonzero value in first column. Produces (P7-1) zero values. Row number increment to first nonzero string in second and subsequent 9-298 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements P9 Number of columns in overall pattern. Overall pattern is repeated at column number P9+1. Remarks: The nonzero values in each column are the column number. Examples: 1. Generate a 10 x 10 diagonal matrix with the column number in each diagonal position. MATGEN ,/DIAG/4/10/10/0/1/10/1/1/10 $ 2. Generate a 12x1 partitioning (Boolean) vector with a nonzero value at every third row. MATGEN ,/ASTRIP/4 /1 /12/ /1 /3 /3 $ 3. Generate a 5x5 matrix with nonzero values in its lower triangle. NX Nastran DMAP Programmer’s Guide 9-299 Chapter 9 Descriptions of DMAP Modules and Statements MATGEN ,/LOW/4/5 /5 / / / /2 /1 /5 $ Option P1 = 5 Generate a matrix of pseudorandom numbers. The numbers span the range 0 to 1.0, with a uniform distribution. Format: MATGEN ,/MAT/5/P2/P3/P4/P5/P6 $ Input Data Blocks: None. Output Data Block: MAT Matrix of pseudorandom numbers Parameters: P2 Number of columns 9-300 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements P3 P4 P5 P6 Number of rows Precision (1 or 2). If zero, use machine precision. Seed for random number generation. If P5 ≤ 0, the time of day (seconds past midnight) is used. 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 $ Input Data Blocks: None. Output Data Block: CP Column partitioning vector Parameters: P2 P3, P5, P7, P9 P4, P6, P8, P10 Number of rows Number of rows with zero coefficients Number of rows with unit coefficients Remarks: 1. If Pi < P2, the remaining terms contain zeros. 2. If Pi > P2, the terms are ignored after P2. NX Nastran DMAP Programmer’s Guide 9-301 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: None. Output Data Block: MAT Null matrix Parameters: P2 P3 P4 P5 Number of rows Number of columns Form; if P4 = 0 and P2 = P3, the form is 6 (symmetric). If P4 = 0 and P2 = P3, the form is 2 (rectangular). Type: if P5 = 0, the type is the machine precision. Example: Generate a 20 row by 15 column null matrix. MATGEN ,/N20X15/7/20/15 $ Option P1 = 8 Generate a matrix from equations based on its indices. The matrix is in single precision. Format: MATGEN ,/MAT/8/P2/P3/P4/P5/P6 $ Input Data Blocks: None. 9-302 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: MAT Matrix with element values based on its indices Parameters: T P2 DTI table input = 0 generate all terms ≠ 0 generate only diagonal terms P3 P4 P5 Number of rows Number of columns Number of the record in field 3 of the DTI entry used to define real coefficients P5<0 Coefficient taken from DTI trailer: C(t1) = float (t2) all trailer items are integer. C(t3) = float (t4) all trailer items are integer. C(t5) = float (t6) all trailer items are integer. P5=0 P5>0 P6 Data pairs from record 0 (data block header record) are interpreted as definingC(ν1) = (ν2)(ν1) is integer; (ν2) is real Data pairs from record P5 interpreted as above. Number of the record in field 3 of the DTI entry used to define imaginary coefficients D1 P6 ≤ 0 P6 > 0 No coefficients defined. Data pairs from record P6 interpreted as above where D(ν1) = (ν2). P7 Form of output matrix P7 ≤ 0 P7 > 0 Form chosen to be 1 or 2, depending on P3 and P4. Form set to P7. P8 Coefficient print flag P8 = 0 P8 ≠ 0 Do not print coefficient lists. Print coefficients lists C and D from the DTI input. (Print D list only if P6 > 0.) The equation used to determine the coefficient of the (l,J)th term of the output matrix is: NX Nastran DMAP Programmer’s Guide 9-303 Chapter 9 Descriptions of DMAP Modules and Statements Equation 9-24. 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 can be input using only the first physical entry of the DTI entry (P5 < 0). The coefficients are defined by adjacent pairs of numbers on the DTI entry. The first number of the pair is an integer that names the coefficient being defined. For example, a value of 9 means the C9 value is to follow. The second number of a pair is a real number that defines the value of the coefficient. Zero coefficients need not be defined. Bulk Data Entry: 1 DTI 2 AB 2 DTI DTI DTI AB AB AB 3 0 3.5 1 2 3 4 7 1 3 12 9 5 1 -5.2 0.01 -21.8 1.0 4 13 7.9 6.6 6 8 7 4 8 9 10 For F1(I,J = 4J; 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 ; I = 100 and J = 1200: MATGEN AB/M3/8//100/200/2/1 $ For HILBERT(I,J) = 1.0/(I + J − 1); I,J = 1, 10: MATGEN AB/HILBERT/8//10/10/3 $ 3RD RECORD Option P1 = 9 Generate a transformation between external and internal sequence matrices for g-set size matrices. 9-304 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MATGEN EQEXIN/TRANS/9/P2/P3 $ Input Data Block: EQEXIN Equivalence table between external and internal grid/scalar identification numbers Output Data Block: TRANS Transformation matrix Parameters: T P2 EQEXIN table output by module GP1 0 1 P3 Output nontransposed factor where [UINT]=[MAT][UEXT] Output transposed factor where [UEXT]=[MAT][UINT] Number of terms in g-set. The parameter LUSET, which is output by the GP1 module, contains this number in most solution sequences. 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 $ GSIZE, INTERNAL SORT MATGEN EQEXIN/INTEXT/9/0/LUSET $ SMPYAD INTEXT,KAGG,INTEXT,,/KAAGEXT/3////1////6 $ $ (KAAGEXT) = TRANSPOSE(INTEXT)*(KAAG)* $ (INTEXT) ITS FORM IS 6 (SYMMETRIC) By default in SOLs 1 through 200, PARAM, OLDSEQ is -1, which means this operation is not required. Option P1 = 10 Not used. Option P1 = 11 Generate a rectangular matrix, driven by USET table NX Nastran DMAP Programmer’s Guide 9-305 Chapter 9 Descriptions of DMAP Modules and Statements Format: MATGEN USET/MAT/11/P2/P3/////////SET1/SET2 $ Input Data Block: USET Degree-of-freedom set membership table for g-set Output Data Block: MAT Rectangular matrix based on the USET table Parameters:. T P2 =1 ≠0 P3 SET1 SET2 USET table output by module GP4 Input-integer-default=0. Null matrix generation option flag. Generate a null matrix P3 columns and a-set size rows. Generate a null matrix with an identity sub-matrix based on SET1 and SET2 degree-of-freedom sets. Input-integer-default=0. Number of columns in MAT. Applies only to P2=1. Input-character-default=‘A’ Degree-of-freedom set name which corresponds to the number of rows in MAT. Applies only when P2≠1. Input-character-default=‘L’ Degree-of-freedom set name which corresponds to the number of columns in MAT. Applies only when P2≠1. Remarks: If P2≠1, and one or both of the sets requested in SET1 and SET2 does not exist, 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. Option P1 = 12 Generate a rectangular matrix of prescribed properties. Format: MATGEN ,/MAT/12/P2/P3/P4/P5/P6/P7/P8/P9 $ Input Data Blocks: None. 9-306 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: MAT Rectangular matrix Parameters: P2 P3 P4 Number of columns Number of rows Type of elements in the matrix: 1 2 3 4 P5 P6 P7 P8 P9 Real single precision Real double precision Complex single precision Complex double precision Density of the matrix times 10000 Average string length Total number of strings in the matrix Number of null columns Average bandwidth 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 used only 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. 9.194 MATGPR Degree-of-freedom matrix printer Prints nonzero terms of matrices along with the external grid point and component identification numbers corresponding to the row and column position of each term. NX Nastran DMAP Programmer’s Guide 9-307 Chapter 9 Descriptions of DMAP Modules and Statements Formats: 1. For matrices with degrees of freedom that relate to grid or scalar points (g-set): MATGPR MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1$ GPL,USET,SIL,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1 $ 2. For matrices with degrees of freedom that relate to grid, scalar or extra points (p-set): MATGPR GPLD,USETD,SILD,MATRIX//COLNAM/ROWNAM/PRNTOPT/ TINY/F1 $ 3. For matrices with degrees of freedom that relate to aerodynamic elements (ks-set): MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/ TINY/F1 $ 4. Print a matrix in the format similar to DISPLACEMENT output with a user-defined column label and page header. MATGPR BGPDT,USET,,MATRIX// ‘OFP‘/ROWNAM/PRNTOPT/TINY//// LCOLLBL1/LCOLLB2/LCOLLBL3/LCOLLBL4/ RCOLLBL1/RCOLLB2/RCOLLBL3/RCOLLBL4/ HDRLBL1/HDRLBL2/HDRLBL3/HDRLBL4/ HDRLBL5/HDRLBL6/HDRLBL7/HDRLBL8/ PUNCH/S,N,CARDNO $ Input Data Blocks: GPL GPLD USET USETD SIL SILD MATRIX BGPDT BGPDT* USET* External grid/scalar point identification number list External grid/scalar/extra point identification number list. (GPL appended with extra point data.) Degree-of-freedom set membership table for g-set Degree-of-freedom set membership table for p-set Scalar index list Scalar index list for the p-set Any matrix related to degrees-of-freedom Basic grid point definition table Family of basic grid point definition tables for all superelements Family of USET tables 9-308 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: COLNAM ROWNAM PRNTOPT Input-character-no default. Set name for columns in MATRIX. Input-character-default = ’ ’ Set name for rows in MATRIX. If ROWNAM is blank, it defaults to COLNAM. Input-character-default = ’ALL’. Must be one of the following values: Option NULL ALL ALLP TINY Action Only null columns are identified. Print all nonzero terms in matrix. Print numbers converted to magnitude/phase. Real-default = 0.0. If F1 = 0 and TINY ≥ 0, printed output is provided only for those matrix terms, aij, that satisfy the relation |aij| ≥ TINY. If F1 = 0 and TINY ≤ 0, printed output is provided only for those matrix terms, aij, that satisfy the relation |aij| ≤ TINY. If TINY = 1.E37, MATGPR returns. If F1 is nonzero, see the following description of F1. Real-default = 0.0. If F1 is not zero, printed output is provided for only those matrix terms that satisfy aij > TINY or aij <F1. Input-character-default=’ ’ Label with up to 32 characters to be printed left-justified in upper left corner of each page. Input-character-default=’ ’ If RCOLLBLi is blank, ‘COLUMN’is printed. Label with up to 32 characters to be printed right-justified in upper right corner of each page. RCOLLBLi is followed by column number. 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. 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. Input-logical-default=FALSE. Punch file write control flag. (DELAY) Input/output-integer-default=0. Punch file line counter. CARDNO is incremented by one for each line written to the punch file and is also written into columns 73-80 of each line. (DELAY) F1 LCOLLBLi RCOLLBLi HDRLBLi HDRLBLi PUNCH CARDNO Remarks: The supersets formed by the union of other sets have the following definitions: NX Nastran DMAP Programmer’s Guide 9-309 Chapter 9 Descriptions of DMAP Modules and Statements 1. If the value specified for COLNAM is not one of the names shown in Remark 1, the columns are labeled 1,2,3..., and so on, without grid and component labels. 2. If the value specified for R is not one of the names shown in Remark 1, the terms in each column are labeled “1 H”, “2 H”, “3 H”, and so on, without grid and component labels. You 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. 3. When using Format 1, this module cannot be scheduled until after GPSP because data blocks generated by GPSP are required inputs. (This module can be scheduled after GP4 if USET0 is specified for input to MATGPR instead of USET.) When using Format 2, this module cannot be scheduled until after DPD because data blocks generated by DPD are required inputs. When using Format 3, MATGPR must be scheduled after the APD module. 4. If MATRIX is purged, no printing is done. 5. The rows and columns of A must correspond to the order of the degrees-of-freedom defined in GPL, USET, SIL, BGPDT, and so on; that is, internal sequence. Examples: 1. Print terms of KGG. MATGPR BGPDT,USET,,KGG//’G’ $ 2. Print null columns of KLL. MATGPR BGPDT,USET,,KLL//’L’/’L’/’NULL’ $ 3. Print small terms on diagonal of LOO. DIAGONAL MATGPR LOO/LOOD $ BGPDT,USET,,LOOD//’H’/’O’//-1.E-2 $ 9-310 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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. BGPDT,USET,,GCF//‘ofp‘/‘g’$ COLUMN 1 T3 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 R1 .0 .0 .0 .0 .0 .0 .0 R2 1.862645E-09 1.862645E-09 .0 -4.656613E-10 4.656613E-10 .0 .0 R3 MATGPR MATRIX GCF POINT ID. TYPE T1 T2 1 G .0 .0 3 G -1.303852E-08 -4.656613E-10 4 G -1.490116E-08 4.656613E-10 6 G 1.862645E-09 .0 7 G 1.862645E-09 .0 9 G -3.725290E-09 .0 10 G -3.725290E-09 .0 8. Same as example 7 except modify header labeling. MATGPR BGPDTS,USET,,GCFF//‘OFP‘/‘G‘////// ‘DIRECTIO‘/‘N‘/// //// ‘G R O U ‘/‘N D C ‘/‘H E C K ‘/’ F O R ‘/ ‘C E S (‘/’G - S E‘/’T )’$ DIRECTION 1 G R O U N D C H E C K F O R C E S ( G POINT ID. TYPE T1 T2 1 G .0 .0 3 G -1.303852E-08 -4.656613E-10 4 G -1.490116E-08 4.656613E-10 6 G 1.862645E-09 .0 7 G 1.862645E-09 .0 9 G -3.725290E-09 .0 10 G -3.725290E-09 .0 S E T ) T3 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 .0 R1 .0 .0 .0 .0 .0 .0 .0 R2 1.862645E-09 1.862645E-09 .0 -4.656613E-10 4.656613E-10 .0 .0 R3 9.195 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,I7,I8,I9/ O1,O2/ P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/p13/p14/p15 $ NX Nastran DMAP Programmer’s Guide 9-311 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: Ii Input data blocks. I1 is required; I2 through I9 may not be necessary depending on the value P1. Output Data Blocks: Oi Output data blocks Parameters: P1 P2, P3, P4 P5, P6 P7 through P11 P12 P13 P14 P15 Input-integer-no default. Option selection described in the table that follows. Input/output-integer-default=0. Parametric data depending on P1. Input/output-real-default=0. Parametric data depending on P1. Input/output-integer-default=0. Parametric data depending on P1. Input/output-character-default=blank. Parametric data depending on P1. Input/output-character-default=” Parametric data depending on P1. Input/output-character-default=” Parametric data depending on P1. Input/output-character-default=” Parametric data depending on P1. Remarks: 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,/1/STARTCOL/ENDCOL/COLINC $ Input Data Block: I1 Any matrix (real or complex) Output Data Block: O1 Column vector containing column P2 of I1 9-312 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameter: STARTCOL ENDCOL COLINC Input-integer. Starting column number to extract from I1. Input-integer. Ending column number to extract from I1 Input-integer. Column increment. Extract every COLINC‘th column between STARTCOL and ENDCOL. Remarks: 1. If ENDCOL is zero, ENDCOL=STARTCOL. 2. If COLINC is zero, every column between STARTCOL and ENDCOL is extracted. 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 $ Option P1 = 2 Filter small magnitude terms of a matrix. Format: MATMOD I1,,,,,,,,/O1,/2/PURGE///FILTER $ Input Data Block: I1 Any matrix (real or complex) Output Data Block: O1 A copy of I1 with terms smaller in magnitude than P5 set to 0.0 Parameter: PURGE Input-integer-default=0. If PURGE=0, and the input matrix has no nonzero terms, the output matrix is purged. If PURGE≠ 0, and the input matrix has no nonzero terms, the output matrix is null. Input-real-default=0.0. Value of filter. Terms in I1 with an absolute magnitude less than the absolute value of FILTER are set to zero. FILTER NX Nastran DMAP Programmer’s Guide 9-313 Chapter 9 Descriptions of DMAP Modules and Statements Example: Print terms in A smaller in magnitude than 100.0. MATMOD ADD MATPRN A,,,,,,,,/AFILTER,/2////100.0 $ A,AFILTER/ASMALL//-1 $ ASMALL// $ Option P1 = 3 Zeros out rows and columns of a matrix according to degree of freedom component number. Format: MATMOD I1,,,,,,,,/O1,/3/CODE $ Input Data Block: I1 Any matrix (real or complex) Output Data Block: O1 I1 with rows and columns according to DOFs described by P2. Parameter: CODE Input-integer-default=0. Packed DOF code that identifies rows and columns of I1 to be made null (for example, 136 means that degrees of freedom 1, 3, and 6 for each grid point are set to zero). Remarks: 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, and so on, of matrix I1. You 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 EQUIVX KGG,,,,,,,,/KGG1,/3/126 $ KGGQ/KGG/ALWAYS $ Option P1 = 4 Replicates a matrix six rows by N columns row-wise to a g-row by N-column matrix. The input matrix is replicated for each grid point. Format: Form 1 9-314 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MATMOD I1,SIL,,,,,,,/O1,/4 $ Form 2 MATMOD I1,,,,,,,,/O1,/4/LUSET $ Input Data Blocks: I1 SIL Any six-row by N-column matrix (real or complex) Scalar index list (SIL) table generated by the GP1 module Output Data Block: O1 g-row by N-column matrix containing I1 at every grid point Parameter: LUSET Integer-input-default=0. Used to supply the length of the g-set when SIL is purged. Remarks: 1. If SIL is purged, 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, 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 outputs either a g-row by g-column matrix where the input matrix is inserted at the diagonal 6x6 of each grid point, or a g-row by g-column transform matrix. 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 $ Form 3 (generates a global-to-basic coordinate system transformation matrix) MATMOD CSTM,SIL,BGPDT,,,,,,/01,/5//-1 $ NX Nastran DMAP Programmer’s Guide 9-315 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: I1 SIL BGPDT Any six-row by six-column matrix (real or complex) Scalar index list table output from the GP1 module Basic grid point definition table Output Data Block: O1 g-row by N-column matrix containing I1 at every grid point Parameter: LUSET P3 Integer-input-default=0. Used to supply the length of the g-set when SIL is purged. This parameter is valid for Forms 1 and 2 only. Integer-input-default=0. Coordinate system identification number. This parameter is valid for Form 3 only. 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 is 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, the transformation location is at the origin of the P3 system. Scalar and extra points contain 1.0. If P3 = -1, the 6 x 6 single-precision matrix is 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 TRNSP SMPYAD TRANS,SIL,,,,,,,/TRANSG,/5 $ TRANS/TRANSGT $ 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 TRNSP SMPYAD CSTM,SIL,,,,,,,/TRANSG,/5//10 $ TRANSG/TRANSGT $ TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $ 9-316 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 TRNSP SMPYAD CSTM,SIL,BGPDT,,,,,,/TRANSG,/5//-1 $ TRANSG/TRANSGT $ 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 $ Input Data Block: I1 Any matrix (real only) Output Data Block: 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 $ Input Data Block: I1 Any matrix (real only) NX Nastran DMAP Programmer’s Guide 9-317 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Block: 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 $ Input Data Block: I1 Any matrix (real or complex) Output Data Block: O1 Matrix shaped like I1 with every term divided by the term in I1 with the largest absolute value Parameters: NORMREAL NORMIMAG Output-real single precision. Set to the real part of the normalizing factor. 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 of the three columns of the UHT-transient response solution matrix. (The columns of UHT represent displacement, velocity, and acceleration for each output time step.) Format: MATMOD I1,,,,,,,,/O1,/9 $ 9-318 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Block: I1 Transient response solution matrix consisting of H rows by three column matrices (which represent displacement, velocity, and acceleration for each output time step) appended to form a matrix H rows by three times the number of output time steps columns. (Real only). [[{u1} {ν1} {a1}] [{u2} {ν2} {a2}]...[{ui} {#i} {ai}]] Output Data Block: O1 H-row by three column matrix of peak displacements, velocities, and accelerations Example: Find and output maximum transient response. MATMOD UHT,,,,,,,,/UHTMAX,/9 $ DDRMM CASEXX,UHTMAX,PHIP1,,,,/OUPMAX,,,,/ $ OFP OUPMAX,,,,// $ Option P1 = 10 Convert matrix I1 into its complex conjugate. Format: MATMOD I1,,,,,,,,/O1,/10 $ Input Data Block: I1 Any matrix (real or complex) Output Data Block: O1 Matrix shaped like I1 with every term converted to its complex conjugate 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 Basic Grid Point Definition Table (BGPDT) with grid locations that are given by I1. NX Nastran DMAP Programmer’s Guide 9-319 Chapter 9 Descriptions of DMAP Modules and Statements Format: MATMOD LOCVEC,BGPDT,,,,,,,/BGPDTN,/11 $ Input Data Blocks: LOCVEC BGPDT G-size vector with values that represent grid locations in the basic coordinate system Basic grid point definition table Output Data Block: BGPDTN New BGPDT table with grid point locations that are displaced by LOCVEC Example: Build new BGPDT table based on the deformed state. $ Convert displacement vector to basic $ coordinate system PARAML CSTM//’PRESENCE’////S,N,NOCSTM IF (NOCSTM > -1) THEN $ MATMOD CSTM,SIL,BGPDT,,,,,,/TRANS,/5//-1 $ MPYAD TRANS,UG/UGBASIC $ ELSE $ EQUIVX UG/UGBASIC/ALWAYS $ ENDIF $ $ Form vector containing new grid locations in $ basic coordinate system VECPLOT UGBASIC,BGPDT,SCSTM,CSTM,,,,/ LOCVEC/0/0/3 $ $ Generate new BGPDT MATMOD LOCVEC,BGPDT,,,,,,,/BGPDTNEW,/11 $ Option P1 = 12 Perform simultaneous null column search on up to three matrices. Format: MATMOD I1,I2,I3,,,,,,/O1,O2/12/S,N,NONULL/ NMATRIX $ Input Data Blocks: I1, I2, I3 Matrices to search for simultaneous null columns (real or complex) Output Data Blocks: O1 Column vector which has 1.0 at those rows where all matrices selected for searching have null columns 9-320 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements O2 Square symmetric matrix which has 1.0 on the diagonal of those columns where all matrices selected for searching have null columns Parameters: NONULL NMATRIX Output-integer. Set to -1 if no simultaneous null columns found; otherwise, it is set to the number of simultaneous null columns. Input-integer-default=0. Number of matrices to be included in null column search. Remarks: 1. I2 and I3 can be purged. 2. O2 can be purged. Example: Search for simultaneous null columns in the g-size mass, damping, and stiffness matrices and remove rows and columns corresponding to these columns. MATMOD MGG,BGG,KGG,,,,,,/PARTNULL,/12/S,N,NONULL/3 $ IF (NONULL > 0) THEN $ PARTN MGG,PARTNULL,/MGGNEW,,,/-1 $ EQUIVX MGGNEW/MGG/ALWAYS $ PARTN BGG,PARTNULL,/BGGNEW,,,/-1 $ EQUIVX BGGNEW/BGG/ALWAYS $ PARTN KGG,PARTNULL,/KGGNEW,,,/-1 $ EQUIVX KGGNEW/KGG/ALWAYS $ ENDIF $ Option P1 = 13 Copies any data block. Format: MATMOD I1,,,,,,,,/O1,/13 $ Input Data Block: I1 Any data block (table or matrix) Output Data Block: O1 Copy of I1 Remarks: COPY module is preferred over this option. NX Nastran DMAP Programmer’s Guide 9-321 Chapter 9 Descriptions of DMAP Modules and Statements Option P1 = 14 Filter small magnitude terms from a matrix; more capabilities than option 2. Format: MATMOD I1,,,,,,,,/O1,/14/PURGE/UPLOW/STRTR/ FILTER/RELFLT/TRUNC $ Input Data Block: I1 Matrix to be filtered (real or complex) Output Data Block: O1 I1 is modified according to specifications set by parameters. Parameters: PURGE Input-integer-default=0. If PURGE = 0, and the input matrix has no nonzero terms, the output matrix is purged. If PURGE≠ 0, and the input matrix has no nonzero terms, the output matrix is null. Input-integer-default=0. If UPLOW < 0, all lower triangular terms are set to zero. If UPLOW > 0, all upper triangular terms are set to zero. If UPLOW = 0, the action of this parameter is ignored. Input-integer-default=0. If STRTR=0, string trailer is written. Input-real single precision-default=0.0. Terms in I1 with an absolute magnitude less than the absolute value of FILTER are set to zero. Input-real single precision-default=0.0. If RELFLT≠ 0.0, terms of I1 are set to zero when UPLOW STRTR FILTER RELFLT Equation 9-25. I1 must be square for this option 9-322 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements TRUNC Input-integer-default=0. If TRUNC ≠ 0, truncate terms of I1 accordingly Equation 9-26. Remarks: 1. If FILTER = 0.0, O1 is a copy of I1. 2. If relative filtering is desired, FILTER must be zero (default). 3. If FILTER ≠ 0 or RELFLT < 0, the absolute filter technique is used. 4. If I1 is not square and the relative filtering option is selected, FILTER is set to RELFLT and the absolute filtering technique is used. A user warning message is also issued. Option P1 = 15 Not implemented. Option P1 = 16 Put matrix into MATPOOL format, optional DMIG punched output. Format: MATMOD I1,I2,,,,,,,/O1,/16/PNDMIG// TYPOUT////////CCHAR $ Input Data Blocks: I1 I2 Any matrix of g-rows arranged in external (ascending by GRID ID) sequence. (Real or complex). EQEXIN table from module GP1 Output Data Block: O1 Table data block in MATPOOL format containing I1 Parameters: PNDMIG Input-integer-default=0. If PNDMIG≠ 0, I1 is printed in DMIG format to the punch output file (.pch). NX Nastran DMAP Programmer’s Guide 9-323 Chapter 9 Descriptions of DMAP Modules and Statements TYPOUT 1 2 3 4 CCHAR Input-integer-default=0. Default is to set DMIG precision to machine precision. The default can be overridden by specifying: Real single-precision output Real double-precision output Complex single-precision output Complex double-precision output Input-character-default = blank. Continuation characters to be used for DMIG output. If nonblank continuation characters are specified, a maximum of 9999 DMIG entries can be printed for any single matrix. Only the first two characters of the nonblank mnemonic are used for the continuation string. Remarks: 1. I1 must be a g-row size matrix arranged in external sequence (see PARAM, OLDSEQ, and MATGEN Option 9). The rows are always labeled with the external sequence (grid or scalar IDs and component numbers). If the input matrix form is 1 (square) or 6 (symmetric) the columns are also labeled with the external sequence, and the IFO entry on the generated DMIG entry is set to 1 or 6. If the form is 6, only the terms in one triangle are output. If the input matrix form is 2 (rectangular form), the columns are labeled sequentially, starting with unity. The IFO is set to 9. If the form is not 1, 2, or 6, the module returns with no output. 2. EQEXIN table must not be purged. Example: Output KGG and PG matrices in MATPOOL formatted table and punch to DMIG Bulk Data entries (MATGEN Option 9 is being used to resequence them from internal to external sort). MATGEN MPYAD MPYAD MATMOD MPYAD MATMOD EQEXIN/INTEXT/9/0/LUSET $ INTEXT,KGG,/KGGE/1 $ KGGE,INTEXT,/KGGEXT $ KGGEXT,EQEXIN,,,,,,,/MATPOOL1,/16/1 $ INTEXT,PG,/PGEXT/1 $ PGEXT,EQEXIN,,,,,,,/MATPOOL2,/16/1 $ Option P1 = 17 Generate a g-size partitioning vector from a user-defined set of grid and/or scalar points or from a user-supplied bit position that designates one of the USET sets. Format: MATMOD EQEXIN,USET,SIL,CASECC,,,,,/CP/17/UBIT/SETFLG/ S,N,NOCP////////SETSTR1/SETSTR2/SETSTR3/SETSTR4 $ 9-324 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: EQEXIN USET SIL CASECC Equivalence table between external and internal grid/scalar identification numbers Degree-of-freedom set membership table for g-set Scalar index list Table of Case Control command images Output Data Block: CP Column partitioning vector 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 M, 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. SetName Q BE C K SA E SB SG R O BF M DecimalEquivalentNumber 4194304 2097152 1048576 262144 131072 2048 1024 512 8 4 2 1 NX Nastran DMAP Programmer’s Guide 9-325 Chapter 9 Descriptions of DMAP Modules and Statements SETFLG Input-integer-default=0. If SETFLG ≠ 0, SETFLG selects a set of grid point identification numbers of which all degrees of freedom associated with each point are assigned a value of 1.0 in the corresponding row of CP. If no SET command is found, the UBIT parameter is used. If SETFLG>0, the PARTN=SID Case Control command selects the SET command. If SETFLG<0, absolute value of SETFLG selects the SET command. NOCP SETSTRi Output-integer. NOCP is set to -1 if the partitioning vector is null or cannot be generated. Otherwise, it is set to zero. 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 can 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 $ If no set had been selected in the Case Control Section, the vector VECX would have been generated using the a-set degrees of freedom since UBIT=128. The Case Control Section contains: SET 10 = 1 THRU 50 PARTN = 10 Option P1 = 18 Insert or modify a GEOM3 table temperature record. Format: MATMOD GEOM,GPL,UG,,,,,,/GEOM3T,/18/SID $ Input Data Blocks: GEOM3 GPL Table of Bulk Data entry images related to static and thermal loads External grid/scalar point identification number list 9-326 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UG Temperature matrix in g-set Output Data Block: GEOM3T GEOM3 table with new or modified temperatures Parameter: SID Input-integer. Temperature set to be modified or added. Remarks: 1. This option should only be used in heat transfer analysis. 2. None of the data blocks can 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 Input Data Blocks: GEOM3 EQEXIN Table of Bulk Data entry images related to static and thermal loads Equivalence table between external and internal grid/scalar identification numbers Output Data Block: UGT Updated temperature matrix in g-set Parameter: SID Input-integer. Temperature set to extract. NX Nastran DMAP Programmer’s Guide 9-327 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: 1. This option should only be used in heat transfer analysis. 2. None of the data blocks can 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////S,N,SUM $ Input Data Blocks: I1 though I6 Any matrix (real or complex) Output Data Block: O1 Dummy output data block Parameter: SUM Output-real. Sum of the absolute values of the largest terms in the input matrices. Remarks: 1. Any input matrix can be purged. 2. All computations are performed in single or double precision depending on the matrix type. The magnitudes of the largest terms and SUM are converted to single precision for output. Option P1 = 21 Extracts the components of a factor matrix and converts them to a standard form suitable for input to any matrix module. Format: MATMOD LD,,,,,,,,/T,LP/21 $ 9-328 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Block: LD Lower triangular factor/diagonal matrix Output Data Blocks: T LP Diagonal from symmetric decomposition Lower triangular [L] and permutation matrix appended together Remarks: Symmetric decomposition forms the equivalent matrix representation of a symmetric matrix. [A] =[P}T [L] [D] [L]T[P] where P is a permutation matrix (row and column interchange used to improve efficiency), L, a lower triangular matrix, and D, a tridiagonal matrix. Option 21 extracts P, L, and D and converts them to a standard form, suitable for input to any matrix module. L and P are appended column-wise in output D. Example: Extract components of 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 $ Input Data Blocks: MKLIST Qij Table of Mach number and reduced frequency pairs Aerodynamic matrix Output Data Block: QijL Special aerodynamic matrix with modified trailers NX Nastran DMAP Programmer’s Guide 9-329 Chapter 9 Descriptions of DMAP Modules and Statements 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,NFOUND/ICASE////S,N,EIGRFLD $ S,N,METHTYP/S,N,LANCZOS/S,N,EIGRVALI/S,N,EIGRVALR/ Input Data Blocks: CASECC DYNAMIC Table of Case Control command images Table of Bulk Data entry images related to dynamics Parameters: METHTYP LANCZOS EIGRVALI EIGRVALR NFOUND ICASE EIGRFLD Output-integer. Set to 1 if Inverse Power or Lanczos method selected; otherwise, set to zero. Output-integer. Set to -1 if Lanczos method selected; otherwise, set to zero. Output-integer-default=0. Extracted integer value from the EIGR or EIGRL entry. Output-real-default=0.0. Extracted real value from the EIGR or EIGRL entry Output-integer-default=0. EIGR* entry found flag; 0 if entry was found and -1 if entry was not found. Input-integer-default=1. Case Control record number which contains the METHOD command. 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 $ IF ( METHTYP=1 ) THEN $ MESSAGE //’LANCZOS OR SINV IS SELECTED.’$ ELSE $ MESSAGE //’GIVENS OR HOUSEHOLDER IS SELECTED.’$ ENDIF $ 2. Extract the F2 field value from the EIGR entry: MATMOD CASECC,DYNAMIC,,,,,,,/,/23////S,N,F2///////‘F2’$ 3. Extract the NORM field value from the EIGR entry: NORM=‘NORM’$ initialize and will change on output 9-330 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MATMOD CASECC,DYNAMIC,,,,,,,/,/23///////////S,N,NORM $ Option P1 = 24 Generate a square matrix that has a 1.0 at the intersection of every null row and null column of I1, I2, and I3 simultaneously. Format: MATMOD I1,I2,I3,,,,,,/O1,/24/S,N,NOOUT/NMATX/S,N,NRNENC $ Input Data Blocks: I1, I2, I3 Square, commensurate matrices (real or complex) Output Data Block: 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: NOOUT NMATX NRNENC Output-integer. Set to -1 if O1 is null. Input-integer-default=1. Number of input matrices to be used for search, starting from the first input. Output-integer. Set to -1 if the number of null rows does not equal the number of null columns. Remarks: Any two input matrices can be purged. 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 $ NX Nastran DMAP Programmer’s Guide 9-331 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: I1, I2, I3 Square, commensurate matrices (real or complex) Output Data Blocks: O1 O2 Vector that has 1.0 corresponding to each null row in I1, I2, and I3 simultaneously. See Remark 1. Vector that has 1.0 corresponding to each null column in I1, I2, and I3 simultaneously. Parameters: NOOUT NMATX NRNENC SYM Output-integer. Set to -1 if both output vectors are null, set to zero otherwise. Input-integer-default=1. Number of input matrices to be used for search, starting from the first input. Output-integer. Set to -1 if number of null rows does not equal the number of null columns; otherwise zero. Output-integer. Set to -1 if I1, I2, and I3 are symmetric; otherwise zero. See Remark 2. Remarks: 1. Any two input matrices can be purged. 2. If I1, I2, and I3 are symmetric, O2 is purged. Example: Remove null rows and columns from matrix A. MATMOD IF (NOOUT PARTN EQUIVX ENDIF $ A,,,,,,,,/RPARTN,CPARTN/25/S,N,NOOUT/1////S,N,SYM $ > -1) THEN $ A,CPARTN,RPARTN/ANEW/SYM $ ANEW/A/ALWAYS $ 9-332 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Option P1 = 26 Used internally for development testing. Option P1 = 27 Convert a diagonal matrix (form 3) to a symmetric matrix (form 6). Format: MATMOD I1,,,,,,,,/O1,/27 $ Input Data Block: I1 Diagonal matrix of form 3 (real or complex) Output Data Block: O1 Symmetric matrix of form 6 containing diagonal terms of I1 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 do not accept form 3 matrices. The matrices should now be converted to form 6 before use in these modules. Example: DMIIN MATMOD DMI,DMINDX/A3,,,,,,,,, $ A3,,,,,,,,/A6,/27 $ where A3 is the DMI matrix defined by the Bulk Data entries DMI,A3,0,3,1,1,,4,1 DMI,A3,1,2,2.0,3.0,4.0 and A6 is the matrix Option P1 = 28 Convert the first column of a matrix to a symmetric matrix (form 6) with the terms of the first column along the diagonal and off-diagonal terms set to zero. NX Nastran DMAP Programmer’s Guide 9-333 Chapter 9 Descriptions of DMAP Modules and Statements Format: MATMOD I1,,,,,,,,/O1,/28 $ Input Data Block: I1 Any matrix of form 1, 2, or 6 (real or complex) Output Data Block: O1 Symmetric matrix (form 6) with terms of the first column of I1 along the diagonal and off-diagonal terms set to zero. Example: MATMOD B,,,,,,,,/BDIAG,/28 $ If B is the matrix Figure 9-2. BDIAG is Figure 9-3. Option P1 = 29 Used internally 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 $ Input Data Block: Ii Any data block (matrix or table) 9-334 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: BBLK EBLK Input-integer-default=1. Beginning GINO block number. Input-integer-default=-1. Ending GINO block number. Default value implies the total number of blocks. Option P1=31 Writes the bit map of a matrix to the punch file. Format: MATMOD MAT,,,,,,,,/,/31/MAXSIZ $ Input Data Block: MAT Any matrix Output Data Block: None. Parameter: MAXSIZ Input-integer-default=0. Maximum size of the bit map matrix (row and/or column) 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 $ Input Data Block: TXY DRMH1 directory table in DTI or table data block format Output Data Block: TOUT DRMH1 directory table in table data block format or DTI format NX Nastran DMAP Programmer’s Guide 9-335 Chapter 9 Descriptions of DMAP Modules and Statements Parameter: CONVERT Input-integer-default=0. Convert option. 0 1 Table data block format to DTI format DDTI to table data block format Remarks: Table record 3 is all character and reading DTI entries produces all numbers. Therefore, CONVERT=1 converts the DTI numbers 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 $ Input Data Block: FOL Frequency response frequency output list Output Data Block: FOLMAT Matrix of frequencies in radian units 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 $ Input Data Block: CMAT Complex matrix 9-336 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: RMAT IMAT Matrix containing real part of CMAT Matrix containing imaginary part of CMAT Parameter: PREC Input-integer-default=0. Precision of output matrices. 0 1 2 Mmachine-precision (default) Single Double Option P1=35 Sorts row term values in a selected column of the input matrix and produces a list vector and/or a Boolean matrix that contains the indices of the sorted terms. Format: MATMOD IM,,,,,,,,/ SORTLIST,SORTBOOL/S,N,P1/COLNUM/S,N,PRESORT/ SORTOPT/// NKEYS $ Input Data Block: IM Any matrix Output Data Blocks: SORTLIST SORTBOOL Vector consisting of the row numbers of the original positions of the sorted terms Square matrix containing unity at a row position in the column associated with the sorted row terms Parameters: P1 COLNUM Input/output-integer-no default. On output, P1=-1 if the input matrix is purged or both output data blocks are purged. Input-integer-default=0. Selects the column number of the input matrix that is sorted to produce SORTLIST and SORTBOOL. Default selects the first column. Output-integer-default=0 Pre-sort flag. Set to -1 if column is already sorted. PRESORT NX Nastran DMAP Programmer’s Guide 9-337 Chapter 9 Descriptions of DMAP Modules and Statements SORTOPT Input-integer-default=0. Sort option specification. -2 -1 0 1 2 Absolute value in descending order Algebraic value in descending order Implies SORTOPT=1 if IM is real, and SORTOPT=2 if IM is complex. Algebraic value in ascending order Absolute value in ascending order NKEYS Input-integer-default=1. Duplicate value sort option specification. 1 2 Single key sort Double key sort to maintain original order of terms in case of duplicate terms Remarks: For complex matrices, only SORTOPT=2 or -2 is allowed. Example: Given the input matrix, IM, generate an algebraic ascending order sort. The input matrix and its sorted order (algebraically ascending) are: IM = The MATMOD call looks like this: P1=35 $ MATMOD IM,,,,,,,,/LIST,BOOL/S,N,P1//S,N,SORTED////2 $ and the output matrix LIST for NKEYS=2 contains 9-338 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements LIST = For NKEYS=1, it is equally likely that the indices for equal values are 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 $ the output matrix LIST for NKEYS=1 contain either LIST = or LIST = since there are duplicate terms (0.0‘s) in the input matrix column and a single key sort was used. The Boolean square matrix contains unit values in the appropriate positions so that it can be used to create the sorted input matrix by means of a simple matrix multiply as in: MPYAD BOOL,IM,/IMS/1 $ producing the sorted IM matrix, IMS, as NX Nastran DMAP Programmer’s Guide 9-339 Chapter 9 Descriptions of DMAP Modules and Statements IMS = 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 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 is 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. Format: MATMOD GEOM1,CASECC,,,,,,,/GEOM1R,/36/GRIDSET/S,N,NOGEOM1 $ Input Data Blocks: GEOM1 CASECC Table of Bulk Data entry images related to geometry Table of Case Control command selections Output Data Block: GEOM1R GEOM1 table with reduced GRID record Parameters: GRIDSET Input-integer. SET Case Control command identification number which contains a list grid point identification numbers. 9-340 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOGEOM1 Output-integer. Processing status flag. +1 No grid data found matching gridset. 0 GRIDSET found and contents match some GRIDs in GEOM1. -1 GRIDSET found and contents matches all GRIDs in GEOM1. Remarks: Only the GRID record is processed and all other GEOM1 records are copied as is to GEOM1R. 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 $ Input Data Blocks: GEOM2 CASECC Table of Bulk Data entry images related to geometry Table of Case Control command selections Output Data Block: GEOM2R GEOM2 table with reduced element record Parameters: ELEMSET GRIDSET NOGEOM2 Input-integer. SET Case Control command identification number which contains a list element point identification numbers. Input-integer. SET Case Control command identification number which contains a list SPOINT identification numbers. Output-integer. Processing status flag. +1 No element and SPOINTs found matching ELEMSET and GRIDSET. 0 ELEMSET and GRIDSET found and contents match some elements and SPOINTs in GEOM2. -1 ELEMSET and GRIDSET found and contents match all elements and SPOINTs in GEOM2. NX Nastran DMAP Programmer’s Guide 9-341 Chapter 9 Descriptions of DMAP Modules and Statements Option P1=38 Reduce the records in the EST table to the entries corresponding to element numbers specified in a Case Control set. Format: MATMOD EST,CASECC,,,,,,,/ESTR,/38/ ELEMSET/GRIDSET/S,N,NOEST $ Input Data Blocks: EST CASECC Table of Bulk Data entry images related to geometry Table of Case Control command selections. Output Data Block: ESTR EST table with reduced records Parameters: ELEMSET GRIDSET NOEST Input-integer. SET Case Control command identification number that contains a list element point identification numbers. Input-integer. SET Case Control command identification number which contains a list grid point identification numbers. Output-integer. Processing status flag. +1 No element found matching contents of ELEMSET 0 ELEMSET found and contents match some elements in EST -1 ELEMSET and contents match all elements and SPOINTs in EST Option P1=39 Remove and identify explicit zero terms in a matrix. Format: MATMOD I1,,,,,,,,/O1,O2/39/S,N,NOXPLZER $ Input Data Block: I1 Any matrix 9-342 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: O1 O2 Matrix I1 with explicit zero terms removed Matrix containing a 1.0 at the row and column, where an explicit zero was found in I1 Parameter: NOXPLZER Output-integer. Explicit zero existence flag. Set to -1 if no explicit zeros are found. Option P1=40 Remove unused q-set degrees-of-freedom from USET. Format: MATMOD USET,VAXW,,,,,,,/USETN,/40 $ Input Data Block: USET VAXW Degree-of-freedom set membership table for g-set. Column vector for a-set degrees of freedom which has a 1.0 at those locations where a-set structural matrices are null. Output Data Blocks: USETN New degree-of-freedom set membership table for g-set (with unused q-set degrees of freedom removed). Option P1=41 Generate a partitioning vector from a set of grid points defined in the Bulk Data Section on a ROTORG card. Format: MATMOD EQEXIN,USET,SIL,CASECC,DYNAMICS,,,,/PARTG,/41/0/ROTGID/NOVEC $ Input Data Block: EQEXIN Equivalence table between external and internal grid/scalar identification numbers. NX Nastran DMAP Programmer’s Guide 9-343 Chapter 9 Descriptions of DMAP Modules and Statements USET Degree-of-freedom set membership table for g-set. SIL Scalar index list. CASECC Table of Case Control command images. DYNAMICS Table of Bulk Data entry images related to dynamics. Output Data Blocks: PARTG Column partitioning vector. Parameters: Parameter 2 not used at this time. ROTGID Input-integer. ROTGID must be less than zero. The absolute value of ROTGID selects the ROTORG Bulk Data card containing a set of grid point identification numbers. Six degrees of freedom will be associated to each point by assigning six values of 1.0 in the corresponding row of PARTG. Output-integer. NOVEC will be set to -1 if the partitioning vector is null or cannot be generated. Otherwise, it will be set to zero. NOVEC Remarks: 1. None of the data blocks may be purged. 2. ROTGID parameter must be a negative integer value less than zero. Example: MATMOD EQEXIN,USET,SIL,CASECC,DYNAMICS,,,,/PARTG,/41/0/-11/NOVEC $ The Bulk Data Section contains: ROTORG 11 1 3 THRU 5 7 The resulting partitioning vector PARTG: 1 0 1 1 1 0 1 Option P1=42 Generate a partitioning vector from a set of data defined in the Bulk Data Section on SOL 200. 9-344 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MATMOD BGPDT,EQEXIN,SIL,CASECC,EDOM,EPT,EPTABF,GEOM2,GEOM2A/ RGPV,/42/NEPT/NOSE $ Input Data Block: BGPDT EQEXIN SIL Basic grid point definition table. Equivalence table between external and internal grid/scalar identification numbers. Scalar index list. CASECC Table of Case Control command images. EDOM Table of Bulk Data entries related to design sensitivity and optimization. EPT Table of Bulk Data entry related to element properties. EPTABF Family of tables of designed property attributes. GEOM2 Table of Bulk Data entry images related to element connectivity and scalar point. Table of secondary Bulk Data entry images related to element connectivity and updated for the current p-level. GEOM2A Output Data Blocks: RGPV Row partitioning vector. Parameters: NEPT NOSE Input-integer-default=0. The number of EPOINT used in FE model. Input-integer default=0. NOSE should be set to 1 if superelement is used. NX Nastran DMAP Programmer’s Guide 9-345 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: 1. The partitioning vector RGPV is generated from the following data defined in the Bulk Data: - grids and elements defined in set - properties defined in DESVAR - grids, elements, properties defined in DRESP. 2. Option 42 does not support shape optimization. 3. Option 42 does not support material optimization. 4. Option 42 does not support XYPLOT, PLOT, POST output request. Example: The partitioning vector RGPV includes 0 or 1: 1011101 Option P1=43 Generate a partitioning vector from a set of modal indices defined in the Case Control Section on a SET card referenced to by a MODSEL card. Format: MATMOD EQEXIN,USET,SIL,CASECC,DYNAMICS,,,,/PARTMS1,/43/NEIGV/MODSEL/NOVEC $ Input Data Block: EQEXIN USET Equivalence table between external and internal grid/scalar identification numbers. Degree-of-freedom set membership table for g-set. SIL Scalar index list. CASECC Table of Case Control command images. DYNAMICS Table of Bulk Data entry images related to dynamics. 9-346 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: PARTMS1 Column partitioning vector. Parameters: Parameter 2 not used at this time. NEIGV Input-integer. When the Case Control MODSEL card references a Case Control "SET = ALL" card the value of NEIGV will be used to determine the set of grid point identification numbers. Thus the set will contain grids 1 to n where n equals the value of NEIGV. Input-integer. MODSEL must be less than zero. The absolute value of MODSEL selects a Case Control MODSEL card which points to a Case Control SET card containing a set of grid point identification numbers. Each point in the set will be assigned a value of 1.0 in the corresponding row of PARTMS1. Output-integer. NOVEC will be set to -1 if the partitioning vector is null or cannot be generated. Otherwise, it will be set to zero. MODSEL NOVEC Remarks: 1. None of the data blocks may be purged. 2. MODSEL parameter must be a negative integer value less than zero. Example: MATMOD EQEXIN,USET,SIL,CASECC,DYNAMICS,,,,/PARTMS1,/43/0/-10/NOVEC $ The Case Control Section contains: SET 10 = 1, 3 THRU 5, 7 MODSEL = 10 The resulting partitioning vector PARTMS1: 1 0 1 1 1 0 1 Option P1=44 Create a g-set partitioning vector for sparse data recovery based on the output requests in the case control section. This option is only valid for frequency and transient response output requests. Format: MATMOD BGPDTS,SILS,CASES,USETS,EPTS,GEOM2S,EQEXINS,XYCDB,GMTG/PARTV,/44/NOEPT/NOSE/IWHO $ NX Nastran DMAP Programmer’s Guide 9-347 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: BGPDTS SILS Basic grid point definition table. Scalar index list. CASES Table of Case Control command images. USETS Table of degree-of-freedom sets. EPTS Element property table. GEOM2S Table of bulk data entries related to element connectivity. EQEXINS Table of external and internal grid/scalar numbers. XYCDB Table of XY plotting commands. GMTG Transpose of GM (multipoint constraint transformation matrix; m-set by n-set) where the n-set dimension has been expanded to g-set size. Output Data Block: PARTV Sparse data recovery partitioning vector (length is g-set). Values of 1 indicate retained dof; values of 0 indicate ignored dof. Parameters: NOEPT NOSE IWHO Input-integer default=0. Number of EPOINTs to process. Input-integer default=0. NOSE should be set to 1 if superelement is used. Input-integer default=0. IWHO should be set to 0 for enforced motion; set to 1 for SOL 111 or SOL 112 with superelements. Remarks: 1. All data blocks must exist except for GMTG. If any of the required data blocks are purged, the module will not produce PARTV. 9-348 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2. GMTG must exist in order to process m-set degrees-of-freedom. 3. If the user requests ‘ALL’ for any of the supported case control output requests, PARTV will contain all values of 1 and the SPARSEDR system cell (421) will be reset to 0, indicating that sparse data recovery is OFF. 4. The supported case control output requests are: a. b. c. d. e. f. g. h. I. j. k. l. m. n. DISPLACEMENT VELOCITY ACCELERATION OLOAD STRESS/ELSTRESS STRAIN/ELSTRAIN FORCE/ELFORCE EDE EKE ESE XYPEAK XYPRINT XYPLOT XYPUNCH Option P1=45 Construct XCASECC by selecting the desired records of CASECC. Format: MATMOD CASECC,,,,,,,,/XCASECC,/45/P2/P3/P4 $ Input Data Blocks: CASECC Table of Case Control command images. Output Data Block: XCASECC Table of Case Control command images for each processor in DMP environment Parameters: P2 Input-integer default=0. Skip P2 records from the beginning of CASECC. NX Nastran DMAP Programmer’s Guide 9-349 Chapter 9 Descriptions of DMAP Modules and Statements P3 P4 Input-integer default=0. Copy the subsequent P3 records to XCASECC after P2 records. Input-integer default=0. The remaining number of records after P3 records is copied to XCASECC. Remarks: Example: Extract 2, 3, and 4th record from CASECC that has 6 records. MATMOD CASECC,,,,,,,,/XCASECC,/45/1/3/2 $ 9.196 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 $ Input Data Blocks: Ii Any real matrix data block Output Data Blocks: None. Parameters: IVNIT Input-integer-default=0. Fortran unit number. If this parameter is negative, an echo of the DMI Bulk Data entries generated is printed on the FORTRAN unit given by the absolute value of PRINTOPT. Input-character-default=blank. Continuation entry prefix. Used to form a unique continuation string for the DMI Bulk Data entries. For example, if Ni=’xx’, this produces continuations of the form (xx 1), (xx 2), and so on. The default value causes the blank continuation option to be used. See Remark 4 if explicit continuations are desired. Ni 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 9-350 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements and an incremented integer record count in columns 77 through 80 if nondefault values are used for the Ni parameters. 2. Double precision matrices are converted to single precision. Only the real part of complex matrices are used. 3. All matrices are output on double-field entries in single precision. 4. If Ni is specified, Ni must be different for each corresponding input matrix. Also, the maximum number of records that can 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. 5. Only sufficiently small nonpurged data blocks are punched onto DMI Bulk Data entries. Example: Let the data block MAT contain the matrix Figure 9-4. The DMAP statement MATPCH MAT// $ produces the following DMI entries: 1 DMI DMI * DMI* * DMI* * DMI* 2 MAT MAT 3 MAT 5.000000E 00 MAT 7.000000E 00 MAT 3 5 6 1 8.000000E 00 4 9.000000E 00 6.000000E 00 3 0 4 2 1 2.000000E 00 2 5 1 6 2 1 5 3 7 8 5 9 6 10 1.000000E 00 3.000000E 00 4.000000E 00 NX Nastran DMAP Programmer’s Guide 9-351 Chapter 9 Descriptions of DMAP Modules and Statements 9.197 MATPRN General matrix printer Prints general matrix data blocks. Format: MATPRN M1,M2,M3,M4,M5/ $ Input Data Blocks: Mi Matrix data blocks, any of which can be purged (real or complex) Remarks: 1. Any or all input data blocks can be purged. 2. If any data block is not a matrix, it is printed as if it were a table. 3. MATPRN prints the row index for the term that begins each line of printout. 4. MATPRN does not print out two or more consecutive lines of zeroes, but instead issues a message of the form: ROW POSITIONS xxxx THRU yyyy NOT PRINTED – ALL = 0.0. 5. If DIAG 30 is set by the DIAGON function before MATPRN (see Example 3), and turned off after MATPRN, most of the digits of the internal representations are printed. Normally, the output is truncated to five or six digits. 6. For large, sparse matrices with scattered terms, UGS recommends using either the MATPRT or MATGPR modules. Examples: 1. MATPRN 2. MATPRN 3. DIAGON(30) $ PRINT EXTENDED PRECISION MATPRN KGG/$ DIAGOFF(30) $ KGG,PL,PG,BGG,UPV//$ KGG/$ 9.198 MATPRT Matrix printer 9-352 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MATPRT MATRIX//PRNTLABL/PRNTFLAG $ Input Data Block: MATRIX Matrix data block to be printed. If [X] is purged, nothing is done. Parameters: PRNTLABL PRNTFLAG Integer-input-default=0. Print label. If PRNTFLG=1, the matrix is labeled with “ROW n”; otherwise it is labeled with “COLUMN n.” Integer-input-default=0. Print flag. If PRNTFLAG < 0, do not print [X]; Y ≥ 0, print [X]. Remarks: 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// $ 9.199 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: MATREDU NX Nastran DMAP Programmer’s Guide 9-353 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: XGG XPP USET USETD GM GMD GOA GOD Square matrix in g-set Square matrix in p-set Degree-of-freedom set membership table for g-set Degree-of-freedom set membership table for p-set Multipoint constraint transformation matrix, m-set by n-set Multipoint constraint transformation matrix with extra points, m-set by ne-set Omitted degree-of-freedom transformation matrix, o-set by a-set Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set Output Data Blocks: XAA XDD XSF XSS Reduced square matrix in a-set Reduced square matrix in d-set S-set by f-set matrix partition of XGG or XPP after multipoint constraint elimination and reduction S-set by s-set matrix partition of XGG or XPP after multipoint constraint elimination and reduction Parameters: NOXGG NOXPP Output-integer-default=1. XGG existence flag. Set to -1 if XGG does not exist. Output-integer-default=1. XPP existence flag. Set to -1 if XPP does not exist. Remarks: 1. If XGG or XPP is not symmetric, the unsymmetric formulation of reduction is used. 2. XGG or XPP can be purged, in which case MATREDU returns with NOXAA=-1 or NOXDD=-1. 3. GM (or GMD) and GOA (or GOD) cannot be purged unless their m-set and o-set degrees-of-freedom do not exist. 4. XSF can be purged. 5. The method of reduction is equivalent to a combination of the DMAP modules UPARTN, UMERGE1, SMPYAD, and MCE2. 9-354 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.200 MCE1 Creates multipoint constraint transformation matrix Format: MCE1 USET,RMG/ GM $ Input Data Blocks: USET RMG Degree-of-freedom set membership table for g-set Multipoint constraint equation matrix Output Data Block: GM Multipoint constraint transformation matrix, m-set by n-set Parameters: None. 9.201 MCE2 Performs multipoint constraint elimination and reduction Performs multipoint constraint elimination and reduction on up to four g-set size square matrices. Format: MCE2 USET,GM,XGG1,XGG2,XGG3,XGG4/ XNN1,XNN2,XNN3,XNN4 $ Input Data Blocks: USET GM XGGi Degree-of-freedom set membership table for g-set Multipoint constraint transformation matrix, m-set by n-set Square matrices in g-set Output Data Blocks: XNNi Square matrices in n-set NX Nastran DMAP Programmer’s Guide 9-355 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: None. Remarks: Any or all of XGGi and XNNi can be purged. However, if any of XGGi is specified, the corresponding XNNi must also be specified. Example: Reduce Kgg to Knn. MCE2 USET,GM,KGG,,,/KNN,,, $ 9.202 Format: MDATA MDATA Computes pressures for selected elements associated with virtual fluid mass CASECC,XYCDB,MAR,MEA,UAX,OL/ OEP/ APP/S,N,NOSORT2/FREQINDX $ Input Data Blocks: CASECC XYCDB MAR MEA UA Table of Case Control command images for the primary model Table of x-y plotting commands Table of virtual mass element areas Matrix of element forces per unit motion of the a-set Displacement or eigenvector matrix in the a-set Output Data Block: OEP Table of element pressures due to virtual mass in SORT1 or SORT2 format Parameters: APP Input-character-no default. Type of analysis. Allowable values are: ‘REIG’: Normal modes ‘CEIG’: Complex eigenvalues ‘FREQ’: Frequency response ‘TRAN’: Transient response 9-356 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOSORT2 FREQINDX Input-integer-default=-1. Set to 1 if SORT2 format is requested. Input-integer-default=0. Frequency or time step index. Selects frequency associated with UA. Remarks: 1. XYCDB can be purged. 2. MDATA is available only for normal modes, complex modes, frequency response, and transient response using direct methods only. 9.203 MDCASE Partitions the Case Control table Partitions the Case Control table into separate Case Control tables based on the ANALYSIS Case Control command. Format: MDCASE CASECC,EDOM/ 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 $ Input Data Blocks: CASECC EDOM Table of Case Control command images Table of Bulk Data entries related to design sensitivity and optimization Output Data Blocks: CASESTAT CASEMODE CASEBUCK CASEFREQ Case Control table for static analysis and based on ANALYSIS=STATICS Case Control table for normal modes analysis and based on ANALYSIS=MODES Case Control table for buckling analysis and based on ANALYSIS=BUCK Case Control table for modal or direct frequency response analysis and based on ANALYSIS=MFREQ or DFREQ NX Nastran DMAP Programmer’s Guide 9-357 Chapter 9 Descriptions of DMAP Modules and Statements CASECEIG CASEMTRN CASESAER CASEDVRG CASEFLUT CASESMST CASESMEM CASEHEAT CASEUPSE CASESADV CASESNMB CASEXX Case Control table for modal or direct complex eigenvalue analysis and based on ANALYSIS=MCEIG or DCEIG Case Control table for modal transient analysis and based on ANALYSIS=MTRAN Case Control table for aerostatic analysis and based on ANALYSIS=SAERO Case Control table for aerostatic divergence analysis and based on ANALYSIS=DIVERG Case Control table for flutter and based on ANALYSIS=FLUTTER Case Control table for structural analysis and based on ANALYSIS=STRU Case Control table for electromagnetic analysis and based on ANALYSIS=ELEC Case Control table for heat transfer analysis and based on ANALYSIS=HEAT Case Control table for upstream superelements only Combined Case Control table which includes CASESAER or CASEDVRG Combined Case Control table which includes CASESTAT, CASEMODE, CASEBUCK, CASESAER, CASEDVRG, and CASEFLUT Case Control table intended for Phase 1 matrix generation, assembly and reduction Parameters: STATCC Output-logical-default=FALSE. Static analysis subcase flag. Set to TRUE if at least one ANALYSIS=STATICS command is found in CASECC, and CASESTAT is specified in the output list. Output-logical-default=FALSE. Normal modes analysis subcase flag. Set to TRUE if at least one ANALYSIS=MODES command is found in CASECC, and CASEMODE is specified in the output list. Output-logical-default=FALSE. Buckling analysis subcase flag. Set to TRUE if at least one ANALYSIS=BUCK command is found in CASECC, and CASEBUCK is specified in the output list. Output-logical-default=FALSE. Direct frequency response analysis subcase flag. Set to TRUE if at least one ANALYSIS=DFREQ command is found in CASECC, and CASEFREQ is specified in the output list. Output-logical-default=FALSE. Modal frequency response analysis subcase flag. Set to TRUE if at least one ANALYSIS=MFREQ command is found in CASECC, and CASEFREQ is specified in the output list. MODECC BUCKCC DFRQCC MFRQCC 9-358 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DCEIGCC Output-logical-default=FALSE. Direct complex eigenvalue analysis subcase flag. Set to TRUE if at least one ANALYSIS=DCEIG command is found in CASECC, and CASECEIG is specified in the output list. Output-logical-default=FALSE. Modal complex eigenvalue analysis subcase flag. Set to TRUE if at least one ANALYSIS=MCEIG command is found in CASECC, and CASECEIG is specified in the output list. Output-logical-default=FALSE. Modal transient response analysis subcase flag. Set to TRUE if at least one ANALYSIS=MTRAN command is found in CASECC, and CASEMTRN is specified in the output list. Output-logical-default=FALSE. Aerostatic analysis subcase flag. Set to TRUE if at least one ANALYSIS=SAERO command is found in CASECC, and CASESAER is specified in the output list. Output-logical-default=FALSE. Aerostatic divergence analysis subcase flag. Set to TRUE if at least one ANALYSIS=DIVERG command is found in CASECC, and CASEDVRG is specified in the output list. Output-logical-default=FALSE. Flutter analysis subcase flag. Set to TRUE if at least one ANALYSIS=FLUTTER command is found in CASECC, and CASEFLUT is specified in the output list. Output-logical-default=FALSE. Structural analysis subcase flag. Set to TRUE if at least one ANALYSIS=STRUCT command is found in CASECC, and CASESMST is specified in the output list. Output-logical-default=FALSE. Electromagnetic analysis subcase flag. Set to TRUE if at least one ANALYSIS=ELECT command is found in CASECC, and CASESAER is specified in the output list. Output-logical-default=FALSE. Heat transfer analysis subcase flag. Set to TRUE if at least one ANALYSIS=HEAT command is found in CASECC, and CASEHEAT is specified in the output list. Output-logical-default=FALSE. Superelement analysis subcase flag. Set to TRUE if SUPER=ALL or SUPER>0 in CASECC, and CASEUPSE is specified in the output list. Output-integer-default=0. DESOBJ Case Control command set identification number. Output-integer-default=0. DESGLB Case Control command set identification number. Output-integer-default=-1. Superelement identification number associated with DESOBJ. Set to -1 for all cases unless you specify the DESOBJ command in a particular superelement subcase. Input-logical-default=FALSE. SUPER command processing flag. Set to TRUE to ignore SUPER command. MCEIGCC MTRNCC SAERCC DVRGCC FLUTCC SMSTCC SMEMCC HEATCC UPSECC DESOBJ DESGLB OBJSID SEPRTN NX Nastran DMAP Programmer’s Guide 9-359 Chapter 9 Descriptions of DMAP Modules and Statements WVFLG Output-integer-default=0. Weight/volume response flag. If CASECC does not contain any subcases for statics, normal modes, or buckling subcase, set to 1 if there is a weight or volume response specified on the DRESP1 Bulk Data entry image in EDOM. Remarks: 1. Any output data block can be purged. 2. EDOM can be purged if 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 9.204 MERGE Matrix merge Forms a matrix from its partitions. Format: MERGE A11,A21,A12,A22,CP,RP/A/SYM/TYPE/FORM $ Input Data Blocks: Aij CP RP Matrix partitions (real or complex) Column partitioning vector Row partitioning vector Output Data Block: A Merged matrix from Aij 9-360 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: SYM TYPE FORM Input-integer-default=-1. SYM < 0, {CP} is used for {RP}. SYM ≥ 0, {CP} and {RP} are distinct. Input-integer-default=0. Type of [A]. If TYPE is 0, the type of the output matrix is the maximum type of [A11], [A21], [A12], and [A22]. Input-integer-default=0. Form of [A]. (See Remark 3.) Remarks: 1. MERGE is the inverse of PARTN in the sense that if [A11], [A12], [A21], [A22] are produced by PARTN using {RP}, {CP}, FORM, SYM and TYPE from [A], MERGE produces [A]. The operation of MERGE is dependent upon the partitioning vectors, {CP} and {RP}, and the symmetry flag, SYM. Figure 9-5. 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] consists of all elements Aij of [A] for which CPj = RPi = 0.0 in the same order as they appear in [A]. Partition [A12] consists 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] consists of all elements Aij of [A] for which CPj = 0.0 and RPi ≠ 0.0 in the same order as they appear in [A]. The following describes the operations: Let NC = number of nonzero terms in {CP} NR = number of nonzero terms in {RP} NROWA = number of rows in [A] NCOLA = number of columns in [A] Case 1: {CP} is purged and SYM ≥ 0: MERGE A11,A21,,,,RP/A/1 $ [A11] is a (NROWA-NR) by NCOLA matrix. [A21] is a NR by NCOLA matrix. [A12] is not written. [A22] is not written. NX Nastran DMAP Programmer’s Guide 9-361 Chapter 9 Descriptions of DMAP Modules and Statements Case 2: (RP) is purged and SYM ≥ 0: MERGE A11,,A12,,CP,/A/1 $ [A11] is a NROWA by (NCOLA - NC) matrix. [A21] is not written. [A12] is a NROWA by NC matrix. [A22] is not written. Case 3: {RP} is purged and SYM < 0: MERGE A11,A21,A12,A22,CP,/A $ [A11] is a (NROWA-NC) by (NCOLA-NC) matrix. [A21] is a NC by (NCOLA – NC) matrix. [A12] is a (NROWA – NR) by NC matrix. [A22] is a NC by NC matrix. Case 4: Neither {CP} nor {RP} are purged and SYM ≥ 0: MERGE A11,A21,A12,A22,CP,RP/A/1 $ [A11] is a (NROWA – NR) by (NCOLA – NC) matrix.[A21] is a NR by (NCOLA – NC) matrix.[A12] is a (NROWA – NR) by NC matrix[A22] is a NR by NC matrix. 2. [A11], [A12], [A21], and [A22] must be unique matrices. 3. When FORM = 0, a compatible matrix [A] results as shown in the following table: Form of [A22] Square Square Form of [A11] Rectangular Symmetric Square Rectangular Rectangular Rectangular Rectangular Rectangular Rectangular Symmetric Rectangular Rectangular Symmetric 4. Any or all of [A11], [A12], [A21], [A22] can be purged. When all are purged, this implies [A] = 0. 5. Both {RP} and {CP} cannot be purged. Examples: 1. Let A11, A12, A21, A22, {CP} and {RP} be defined as follows: 9-362 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements The DMAP instruction MERGE A11,A21,A12,A22,CP,RP/A/1 $ creates the real matrix: 2. If, in Example 1, the DMAP instruction was written as MERGE A11,A12,,,CP,/A/1 $ RP,CP distinct the input matrices would be 3. If, in Example 1, the DMAP instruction was written as MERGE A11,A21,,,,RP/A/1 $ the input matrices would be NX Nastran DMAP Programmer’s Guide 9-363 Chapter 9 Descriptions of DMAP Modules and Statements 4. If the DMAP instruction is written as MERGE A11,A21,A12,A22,,RP/A/-1 $ and the input matrices are: the resulting matrix would be 9.205 MERGEOFP Merges linear and nonlinear stress output Merges OESL (linear element stresses from SDR2) with OESNL (nonlinear element stresses from SDRNL). Format: MERGEOFP OES1,OESN1/OES1X $ Input Data Blocks: OES1 OESNL1 Table of element stresses in SORT1 Table of nonlinear element stresses in SORT1 format Output Data Block: OES1X Table of linear and nonlinear element stresses in the SORT1 and linear element format 9-364 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Remarks: 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 ID appear on each input file, the linear element stress data block for the element immediately precedes the nonlinear element stress data block on the output file. 9.206 MESSAGE Prints messages Prints messages to the standard NX Nastran output file. Format: MESSAGE //P1/P2/.../Pn $ Parameter: Pi Input-default is blank. Cannot exceed 80 characters in length. Remarks: 1. Parameter inputs can 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 NX 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. Example: MESSAGE //’USER DMAP MSG’/10/’ERROR IN ITER. NO.’/COUNT $ 9.207 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 $ NX Nastran DMAP Programmer’s Guide 9-365 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: CASECC MATPOOL EST CSTM BGPDT Table of Case Control command images Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Element summary table Table of coordinate system transformation matrices Basic grid point definition table Output Data Blocks: MCHI MLAM GEG MAR MCHI2 MLAM2 Matrix relating displacements to source strengths Matrix relating element forces to source strengths Element displacement interpolation matrix Table of virtual mass element areas Secondary matrix relating displacements to source strengths Secondary matrix relating element forces to source strengths Parameters LUSET NOMGEN unused3 WTMASS unused5 Input-integer-no default. The number of degrees-of-freedom in the g-set. Output-integer-default=-1. Fluid mass existence flag. Set to the MFLUID set identification number if MFLUID is specified in CASECC. Input-real-default=0.0. Unused. Input-real-default=1.0. Specifies scale factor on structural mass matrix. Input-integer-default=-1. Unused. 9.208 Format: MKCNTRL MKCNTRL Assembles a description of aerodynamic controllers sets EDT,CSTMA,AEBGPDT/ AECTRL,TRX,AECSTMHG/ SYMXZ/AUNITS $ 9-366 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: EDT CSTMA AEBGPDT Element deformation table Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points Basic grid point definition table for the aerodynamic degrees-of-freedom Output Data Blocks: AECTRL TRX AECSTMHG Table of aeroelastic model controls Boolean matrix to select accelerations from the list of aerodynamic extra points Table of aerodynamic coordinate system transformation matrices that contains only the hinge moment referenced coordinates systems, if not null. Parameters: SYMXZ AUNITS Input-real-no default. x-z symmetry flag. Input-real-no default. Used to convert accelerations expressed in gravity units to units of length per time squared. Remarks: None. 9.209 Format:. MKCSTMA MKCSTMA Merge coordinate system tables; usually tables from structural and aerodynamic models. CSTM1,CSTM2/CSTMM $ Input Data Block: CSTMi Tables of coordinate system transformation matrices Output Data Block: CSTMM Merged table of coordinate system transformation matrices NX Nastran DMAP Programmer’s Guide 9-367 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: None. 9.210 MKSPLINE Generates splines to interpolated results from structural to aero model Format: MKSPLINE EDT,CSTMA,AEGRID,AECOMP/ SPLINE $ Input Data Blocks: 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. Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points Basic grid point definition tables for the aerodynamic model Aerodynamic component definition table CSTMA AEGRID AECOMP Output Data Block: SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external grid identification numbers Parameters: None. Example: Excerpt from subDMAP PHASE0: DBVIEW AEGRID=BGPDTS WHERE (MODLTYPE=‘AEROMESH’AND WILDCARD) $ MKSPLINE EDT,CSTMA,AEGRID,AECOMP/SPLINE $ 9.211 MODACC OFREQ and OTIME command processor Removes columns in solution and load matrices based on the OTIME and OFREQ Case Control commands. 9-368 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MODACC CASECC,OL,U,P1,P2,P3/ OL1,U1,P11,P21,P31/APP $ Input Data Blocks: CASECC OL U Pi Table of Case Control command images Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list Solution matrix from normal modes, complex modes, transient response, or frequency response Any matrix with the same number of columns as there are eigenvalues, frequencies, or time steps in OL Output Data Blocks: OL1 U1 Pi1 OL truncated by the OFREQ or OTIME command U truncated by the OFREQ or OTIME command Pi truncated by the OFREQ or OTIME command Parameter: APP Character-input-default=‘TRAN’ Analysis type. ‘REIGEN’ ‘FREQRESP’ ‘TRANRESP’ ‘CEIGEN’ Normal modes Frequency response Transient response Complex eigenvalues 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: LAMA CLAMA APP = ‘REIG’ APP = ‘CEIG’ NX Nastran DMAP Programmer’s Guide 9-369 Chapter 9 Descriptions of DMAP Modules and Statements FOL TOL APP = ‘FREQ’ APP = ‘TRAN’ 3. If APP=’CEIGEN,’ P11 must not be purged. 9.212 MODEPF 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 $ Input Data Blocks: BGPDT USET Basic grid point definition table. Degree-of-freedom set membership table for g-set CASECC EDT ABESF* PHASH2 UHFS PHDFH MFHH BFHH KFHH Table of Case Control command images Table of Bulk Data entry images containing SET1 entries Family of a-set size panel area matrices Structural partition (row-wise) of eigenvector matrix PHDH. Also partitioned column-wise according to parameter STRUCTMP. Structural partition (row-wise) of solution matrix UHF. Also partitioned column-wise according to parameter STRUCTMP. Fluid partition (row-wise) of eigenvector matrix PHDH Fluid partition of modal mass matrix MHH Fluid partition of modal damping matrix BHH Fluid partition of modal stiffness matrix KHH 9-370 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements FOL ABEH* PHDFH1 PHDFH2 UHFF AH PFHF UNUSED PNLLST VGA Table of forcing frequencies Family of signed modally reduced area matrices Fluid partition (row-wise) of eigenvector matrix PHDH reduced to a-set size PHDFH1 partitioned by parameter FLUIDMP Fluid partition (row-wise) of solution matrix UHF. Also partitioned column-wise according to parameter FLUIDMP. Signed global modally reduced area matrix Fluid partition of frequency response modally reduced load matrix Unused Table of triplets defining panel names and their associated IPANEL qualifier values G-set size partitioning vector with values of 1.0 at the rows corresponding to the a-set Output Data Blocks: GPMPF FMPF SMPF PMPF LMPF MPFMAP Matrix of grid panel mode participation factors Matrix of fluid mode participation factors Matrix of contribution of structure to fluid mode participation factors Matrix of contribution of structural panels to fluid mode participation factors Matrix of fluid force to fluid mode participation factors Table describing content of mode participation factor matrices Parameters: NOFREQ NOLOADF GRIDFMP Input-integer-no default. Number of excitation frequencies. Input-integer-no default. Number of load cases per frequency. Input-integer-no default. Case Control set identification number of fluid grids that are output: <0 -1 Print matrices; if -999, print matrices for -1 (set = all) All fluid grid a-set NX Nastran DMAP Programmer’s Guide 9-371 Chapter 9 Descriptions of DMAP Modules and Statements 0 >0 NUMPAN PNQALNAM SYMFLG MPNFLG FLUIDMP No fluid grid a-set Case Control set that contains grid list to be output Input-integer-no default. Number of panels. Input-character-default=” Name of qualifier for panels. Input-complex-default=(1.,0.). Scale factor. Input-integer-no default. Panel existence flag. Input-integer-default=-1. Number of fluid modes to use in computing factors. If FLUIDMP>0, compute factors for the first FLUIDMP modes. Input-integer-default=-1. Number of structure modes to use computing factors. Input-integer-default=-1. Flag to compute panel participation factors. See Remark 2. Input-integer-default=-1. Case Control set identification number for a set of fluid grids. Input-integer-default=-1. Number of degrees-of-freedom in the a-set of the structure. Input-real-default=0.95. Filter for fluid factor matrices. Input-real-default=0.95. Filter for structure factor matrices. STRUCTMP PANELMP GRIDMP NOSASET FILTERF FILTERS Remarks: 1. VGA can be purged if no diagnostic printouts are desired. 2. If STRUCTMP>0, these are the output options: • • • • Compute structural mode participation factors. If MPNFLG>0 and PANELMP>-1, compute panel mode participation factors, PMPF. Compute load mode participation factors, LMPF. If MPNFLG>0 and GRIDMP>-1, compute fluid grid mode participation factors, GMPF. 9.213 MODEPOUT Filter, sort, and printout mode participation factor matrices. Also create table data blocks suitable for XY plots and power spectral density calculations. 9-372 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MODEPOUT LAMAF,LAMAS,CASECC,FMPF,SMPF, PMPF,LMPF,GMPF,MPFMAP/ OFMPF2E,OFMPF2M,OSMPF2E,OSMPF2M,OPMPF2E, OPMPF2M,OLMPF2E,OLMPF2M,OGMPF2E,OGMPF2M, UNUSED1,UNUSED2,UNUSED3,UNUSED4,UNUSED5/ OUTFMP/OUTSMP/FMPFEPS/SMPFEPS/MPFSORT/ NOMPF2E $ Input Data Blocks: LAMAF LAMAS CASECC FMPF SMPF PMPF LMPF GPMPF MPFMAP Normal modes eigenvalue summary table for the fluid portion of the model Normal modes eigenvalue summary table for the structural portion of the model Table of Case Control command images Matrix of fluid mode participation factors Matrix of contribution of structure to fluid mode participation factors Matrix of contribution of structural panels to fluid mode participation factors Matrix of fluid force to fluid mode participation factors Matrix of grid panel mode participation factors Table describing content of mode participation factor matrices Output Data Blocks: OFMPF2E OFMPF2M OSMPF2E OSMPF2M OPMPF2E OPMPF2M OLMPF2E OLMPF2M OGMPF2E Table of fluid mode participation factors by excitation frequencies Table of fluid mode participation factors by normal mode Table of structure mode participation factors by excitation frequencies Table of structure mode participation factors by normal mode Table of panel mode participation factors by excitation frequencies Table of panel mode participation factors by normal mode Table of load mode participation factors by excitation frequencies Table of load mode participation factors by normal mode Table of grid mode participation factors by excitation frequencies NX Nastran DMAP Programmer’s Guide 9-373 Chapter 9 Descriptions of DMAP Modules and Statements OGMPF2M UNUSEDi Table of grid mode participation factors by normal mode Unused Parameters: OUTFMP OUTSMP FMPFEPS SMPFEPS MPFSORT Input-integer-default=0. Number of fluid modes to output. Input-integer-default=0. Number of structure modes to output. Input-real-default=0.0. Threshold for filtering out small fluid factor magnitudes. Input-real-default=0.0. Threshold for filtering out small structure factor magnitudes. Input-integer-default=11. Sort flag. 10 20 30 40 1 2 NOMPF2E Sort on absolute value (magnitude) Sort on real portion Sort on complex portion Sort on phase angle (must convert) Descending sort Ascending sort Input-integer-default=-1. 0 -1 Generate Do not generate 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. 9.214 MODEPT Updates PACABS and PACABR Bulk Data entry records based upon data on TABLEDi Bulk Data entry records. 9-374 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: MODEPT EPT,DIT/EPTX/S,N,NOGOMEPT $ Input Data Blocks: EPT DIT Table of Bulk Data entry images related to element properties; in particular, PACABS and PACABR entries Table of TABLEij Bulk Data entry images Output Data Blocks: EPTX Copy of EPT except that PACABS and PACABR entries are updated with TABLEij references Parameter: NOGOMEPT Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk Data entries. 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. 9.215 Format: MODGDN MODGDN Updates geometry table for existence of p-elements and superelements GEOM1,SEMAP,MFACE,MEDGE,MBODY/ GEOM1P/ S,N,NOSEMAP $ Input Data Blocks: GEOM1 SEMAP Table of Bulk Data entry images related to geometry Superelement map table NX Nastran DMAP Programmer’s Guide 9-375 Chapter 9 Descriptions of DMAP Modules and Statements MFACE MEDGE MBODY Face table for p-element analysis Edge table for p-element analysis Body table for p-element analysis Output Data Block: GEOM1P Table of Bulk Data entry images related to geometry updated for p-elements and superelements Parameter: NOEMAP Output-integer-default=0. Superelement map table flag. Set to -1 if SEMAP does not exist. 9.216 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/ GEOM2X,GEOM1X/ S,N,ACFLAG/OSWPPT/OSWELM/S,N,NSWPPT/ S,N,NSWELM/S,N,SWEXIST/S,N,NOGOMGM2 $ Input Data Blocks: EPT GEOM2 GEOM1 Table containing element properties Bulk Data entry records Table containing element connectivity Bulk Data entry records Table of Bulk Data entry images related to geometry Output Data Block: EPTX GEOM1X Copy of EPT except for the records shown in Remark 2 GEOM1 table related to axisymmetric conical shell, hydroelastic, acoustic cavity, and spot weld element analysis 9-376 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameter: ACFLAG Integer-output-default=0. ACFLAG>0 indicates fluid elements: 0 No fluid elements 1 Fluid elements 2 Fluid/structure coupling OSWPPT OSWELM NSWPPT NSWELM SWEXIST NOGOMGM2 Input-integer-default=0. Offset for spot weld projection point IDs. Input-integer-default=0. Offset for spot weld element IDs. Output-integer-default=0. Current spot weld projection point ID. Output-integer-default=0. Current spot weld element ID. Output-logical-no default. Spot weld element existence flag. Set to TRUE if spot weld elements exist. Output-logical-no default. MODGM2 module error return flag. Set to TRUE if an error is found. Remarks: 1. MODGM2 must appear after the IFP. 2. The following GEOM2 Bulk Data entry records are replaced by the internal records in GEOM2X: GEOM2 Record -----CQUAD4 CQUAD8 CTRIA3 CTRIA6 CQUAD CTRIAX CQUADX CHEXA CPENTA CTETRA GEOM2X record Fluid Hyperelastic -------------------n/a QUAD4FD n/a QUAD8FD n/a TRIA3FD n/a TRIA3FD n/a QUADFD n/a TRIAXFD n/a QUADXFD HEXPR HEXAFD PENPR PENTAFD TETPR TETRAFD Example: See the example in the IFP module description. 9.217 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. NX Nastran DMAP Programmer’s Guide 9-377 Chapter 9 Descriptions of DMAP Modules and Statements Format: MODGM4 CASECC,GEOM2M,GEOM4M,DEQATN,DEQIND,DIT,BGPDTM,EPT/ GEOM4P/ GNSTART/S,N,MODGM4/ALTSHAPE/S,N,NSWELM $ Input Data Blocks: CASECC GEOM2M GEOM4M DEQATN DEQIND DIT BGPDTM EPT Table of Case Control command images Table of Bulk Data entry images related to element connectivity and scalar points and updated for the current p-level Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity and updated for the current p-level Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of TABLEij Bulk Data entry images Basic grid point definition table and updated for the current p-level Table containing element properties Bulk Data entry records Output Data Blocks: 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: GNSTART MODGM4 ALTSHAPE Input-integer-default=0. First grid identification number in GEOM1M. Output-logical-default=FALSE. GEOM4P update flag. Set to TRUE if GEOM4M is updated. Input-integer-no default. Specifies set of displacement functions in p-element analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product Space set. Output-integer-default=0. Current spot weld element ID. NSWELM 9.218 MODTRK Reorders eigenvalues and eigenvectors to be consistent with previous design cycle 9-378 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: CASECC EDOM R1TABR LAMA MGG MAA PHG PHA PHGREF PHAREF Table of Case Control command images Table of Bulk Data entries related to design sensitivity and optimization Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes Normal modes eigenvalue summary table Mass matrix in g-size Mass matrix in a-set Normal modes eigenvector matrix in the g-set Normal modes eigenvector matrix in the a-set Designed normal modes eigenvector matrix in the g-set from the prior design cycle output of MODTRK Designed normal modes eigenvector matrix in the a-set from the prior design cycle output of MODTRK Output Data Blocks: MTRAK LAMA1 PHG1 PHA1 PHGREF1 PHAREF1 Table of updated DRESP1 Bulk Data entry images corresponding to the new mode numbering Normal modes eigenvalue summary table updated for mode tracking Normal modes eigenvector matrix in the g-set updated for mode tracking Normal modes eigenvector matrix in the a-set updated for mode tracking Designed normal modes eigenvector matrix in the g-set updated for mode tracking Designed normal modes eigenvector matrix in the a-set updated for mode tracking NX Nastran DMAP Programmer’s Guide 9-379 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: DESCYCLE NOTRACK Input-integer-no default. Design cycle analysis counter. Output-logical-default=FALSE. Mode tracking success flag. Set to TRUE if mode tracking was successful. 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 $ 9.219 MODTRL Modify trailer Modify data block trailer data. Format: MODTRL DB//P1/P2/P3/P4/P5/P6 $ Input Data Block: DB Data block with trailer that is to be modified Parameters: Pi Input-integer-default=-1. New value for i-th trailer word. 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 MODTRL EQUIVX I1,I2/O1 $ O1////6 $ Ol/O2/ALWAYS $ 9-380 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 3. If MODTRL is used to increase the number of columns in a matrix, 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: Parameter P1 P2 P3 P5 Matrix trailer Number of columns Number of rows Form Number of nonzero words For matrices, P4 and P6 must be -1 or unspecified. See Examples 2 and 3. 5. For table trailer contents, see the data block descriptions. Examples: 1. Make KAA symmetric (form=6) (MPYAD labels it square (form=1)). MPYAD MODTRL GO,KOA,KAAB/KAA/1 $ KAA////6/ $ 2. Use ADD5 to change the precision of a matrix. If the new precision does not match the machine precision, specify PUTSYS (newprecision,55) before ADD5. For example, on a double-word machine: • Single to double ADD5 SINGLE,,,,/DOUBLE $ • Double to single PUTSYS(1,55) $ ADD5 DOUBLE,,,,/SINGLE $ PUTSYS(2,55) $ 3. In order to change the type (complex or real) of a matrix, use ADD to convert real to complex and MATMOD(34) for complex to real. For example, • Real to complex ADD REAL,/CMPLX//(0.,1.) $ • Complex to real MATMOD CMPLX,,,,,/REAL,/34 $ 9.220 MODUSET Modifies the degree-of-freedom set membership table (USET) NX Nastran DMAP Programmer’s Guide 9-381 Chapter 9 Descriptions of DMAP Modules and Statements Format: MODUSET UNUSED1,USET/ USETM/ USETOP/MAJOR/SET0/SET1/USETADD/UNUSED6/UNUSED7 $ Input Data Blocks: EDITVEC USET Vector with zeros in rows to be removed under USETOP=‘FILTER’ See Remark 2. Degree-of-freedom set membership table for g-set Output Data Block: USETM Modified degree-of-freedom set membership table for g-set Parameters: USETOP MAJOR SET0 SET1 USETADD UNUSED6 UNUSED7 Input-character-default=‘UNION’ Name of desired operation. See Remark 1. Input-character-default=‘U3’ Name of the major set. The major set must be larger than the subsets defined by SET0 and SET1. Input-character-default=‘U2’ Name of the "zeros" subset of MAJOR. Input-character-default=‘U1’ Name of the "ones" subset of MAJOR. Input-integer-default=1. USET length extension. If USETOP=‘EXPAND‘, extend the size of the USET by this amount. Input-integer-default=0. Unused. Input-integer-default=0. Unused. Remarks: 1. The values and actions for USETOP are: UNION COMP0 COMP1 DELETE TURNON COPY Combine SET0 and SET1 into MAJOR Form SET0 from complement of MAJOR and SET1 Form SET1 from complement of MAJOR and SET0 Remove degrees-of-freedom from MAJOR Add degrees-of-freedom from MAJOR Copy degrees-of-freedom from SET0 to MAJOR 9-382 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements EXPAND MOVE FILTER Extend USET length by USETADD. Move SET0 degrees-of-freedom to MAJOR Remove degrees-of-freedom from USET that correspond to zero rows in EDITVEC 2. EDITVEC can be purged if USETOP≠‘FILTER’ Examples: 1. Scalar degrees-of-freedom 1 through 5 are 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 is empty. The u2-set contains the a-set and the u3-set contains the f-set. MODUSET MODUSET MODUSET ,,USET/VSET/‘COMP0‘/‘F’/‘U1‘/‘A’ $ ,,VSET/WSET/‘COMP1‘/‘F’/ /‘U2’$ ,,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 $ 9.221 MONVEC Forms monitor point rigid body vectors NX Nastran DMAP Programmer’s Guide 9-383 Chapter 9 Descriptions of DMAP Modules and Statements Format: MONVEC Input Data Blocks: AEMONPT MONITOR AEROCOMP STRUCOMP AEBGPDT CSTMA Table of aerodynamic monitor points Table of structural monitor points Table of aerodynamic components when MESH=‘AERO’ Table of structural components when MESH=‘STRU’ Basic grid point definition table for the aerodynamic degrees-of-freedom Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points Output Data Blocks: SRKS Matrix of monitor point rigid body vectors Parameters: None. 9.222 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: MPP 9-384 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: AECTRL UXDAT MONITOR AEMONPT MPSR MPAR MPSER MPAER MPEU MPSIR MPSRP MPSERP UXV ADBINDX Table of aeroelastic model controls. Table of aerodynamic extra point identification numbers, displacements, labels, type, status, position and hinge moments Monitor point table Aerodynamic monitor point table Rigid aerodynamic loads on structural monitor points at trim (excluding inertial loads and static applied loads) Rigid aerodynamic loads on aerodynamic monitor points at trim Elastic restrained loads on structural monitor points at trim (excluding inertial loads and static applied loads) Elastic restrained loads on aerodynamic monitor points at trim Elastic unrestrained loads on monitor points either at trim or across ADB/AEDB Inertial loads on structural monitor points at trim Rigid loads on structural monitor points due to static applied loads Elastic restrained loads on structural monitor points due to static applied loads Control state matrix for ADB or AEDB Index of ADB or AEDB Output Data Blocks: None. Parameters: MACH Q AECONFIG SYMXY SYMXZ MESH Input-real-no default. Mach number. Input-real-no default. Dynamic pressure. Input-character-no default. Aerodynamic configuration. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-integer-no default. Aerodynamic x-z symmetry flag. Input-character-no default. Mesh type NX Nastran DMAP Programmer’s Guide 9-385 Chapter 9 Descriptions of DMAP Modules and Statements Examples: 1. Print structural monitor point loads at trim. MPP AECTRL,UXDAT,MONITOR,MPSR,MPSER,,MPSIR,MPSRP,MPSERP,,// MACH/Q/AECONFIG/SYMXY/SYMXZ/‘STRUCT’$ 2. Print aerodynamic monitor point loads at trim. MPP AECTRL,UXDAT,AEMONPT,MPAR,MPAER,,,,,,// MACH/Q/AECONFIG/SYMXY/SYMXZ/‘AERO’$ 9.223 MPYAD Matrix multiply and add Perform the multiplication of two matrices and optionally, the addition of a third matrix to the product. Format: MPYAD A,B,C/X/T/SIGNAB/SIGNC/PREC/FORM $ Input Data Blocks: A B C Left-hand matrix in the matrix product Right-hand matrix in the matrix product Matrix to be added to the product Output Data Block: X Matrix product Parameters: T Integer-input-default = 0. Transpose flag. T = 1, perform [A]T [B] T = 0, perform [A][B] SIGNAB Integer-input-default = 1. Sign of product flag. SIGNAB = +1, perform [A] [B] SIGNAB = -1, perform −[A][B] 9-386 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SIGNC Integer-input-default = 1. Sign of [C] flag. SIGNC = +1, add [C] SIGNC = -1, subtract [C] PREC Integer-input-default = 0. Precision. PREC = 1, element of [X] are output in single precision PREC = 2, elements of [X] are output in double precision PREC = 0, elements of [X] are output in the precision of the computer FORM Integer-input-default = 0. Form of [X]. FORM = 0, form of [X] is 1 (square) or 2 (rectangular) Remarks: 1. If no matrix is to be added, [C] must be purged. [A] can be Form 3. 2. [A] and [B] can be the same data block, but both must be different from [C]. 3. If [A] or [B] is purged, and [C] is purged, [X] is purged. [C] cannot be Form 3. 4. If [A] and/or [B] is purged, but [C] exists, the purged matrices are equivalent to null matrices, and [X] are output. 5. [X] cannot be purged. 6. if the precision of the computer is double precision and B is single precision, and Methods 1, 2, 3 are deselected, PREC must be set equal to 1. 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, the method that results in the lowest CPU and I/O time is selected. If all transpose methods are deselected, T must be equal to zero (default). If all nontranspose methods are deselected, T must be equal to 1. Method 1 Nontranspose 1 Transpose 2 Nontranspose 2 Transpose 3 Nontranspose Storage technique 1 1 — — — MPYAD keyword deselection value 1 2 4 8 16 NX Nastran DMAP Programmer’s Guide 9-387 Chapter 9 Descriptions of DMAP Modules and Statements Method 3 Transpose 4 Nontranspose 4 Transpose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Transpose 1 Transpose 1 Transpose 1 Transpose • Storage technique — — — A B C D E F A B C D MPYAD keyword deselection value 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536 131072 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. For Method 1 Submethods (storage techniques), a combination of methods is selected accordingly. First, sum their Deselection Values then add 1 (if Nontranspose) and/or 2 (if Transpose). This total is then subtracted from 262143. See examples below. Example 1: If only Method l Nontranspose with storage techniques D, E, and F are desired, NASTRAN MPYAD=247806 (which is obtained from 262143-(2048 + 4096 + 8192 + 1)). If Method 2 is also desired in Example 1, NASTRAN MPYAD=247794 (which is obtained from 262143-(2048 + 4096 + 8192 + 8 + 4 + 1)). • Example 2: 8. As an alternative to the deselection procedure described above, the MPYAD keyword value can 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, MPYAD = 1048586; computed from 1048576 + 10. 9-388 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Method Method 1 Nontranspose 1 Transpose 2 Nontranspose 2 Transpose 3 Nontranspose 3 Transpose 4 Nontranspose 4 Transpose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Nontranspose 1 Transpose 1 Transpose 1 Transpose 1 Transpose Storage submethod StorageSubmethod 1 1 — — — — — — A B C D E F A B C D Selection value SelectionValue 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 If a Storage Submethod under Method 1 is selected in this manner, a printout of timing estimates for the other submethods can 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, specify SPARSE = 0 or 6. • In order to select or force one or both methods below, add l to its value(s) below. NX Nastran DMAP Programmer’s Guide 9-389 Chapter 9 Descriptions of DMAP Modules and Statements Sparse method Nontranspose Transpose SPARSE keyword value 2 4 Example 1: Example 2: To force the sparse nontranspose method, specify SPARSE = 3, computed from 1 + 2. To force the sparse methods, specify SPARSE = 7, computed from 1 + 2 + 4. Note that if SPARSE = 2, 3, 4, 5, or 7, 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; for example, 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 causes an “ILLEGAL INPUT” fatal message. [A] can be transposed with the TRNSP module. 11. Parallel processing in this module (Methods 1 Nontranspose Storage E and Transpose Storage C only) is selected with the NASTRAN statement keyword PARALLEL (or SYSTEM(107)) which is set to the number of parallel processors (default = 0). To force parallel processing, the MPYAD keyword must be set to one of the following values: MPYAD keyword 1048592 1048588 192512 Storage technique Transpose C Nontranspose E Both Examples: 1. [X] = [A][B] + [C] MPYAD A,B,C/X/ $ 2. [X]=[A]T [B] - [C] MPYAD A,B,C/X/1//-1/ $ 3. [X] = -[A] [B] MPYAD A,B,/X//-1 $ 9-390 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.224 MRGCOMP Merges two existing aerodynamic or structural component tables Format: MRGCOMP COMP1,COMP2/ COMP/ COMPRPLC $ Input Data Blocks: COMPi Table of aerodynamic or structural components Output Data Block: COMP Merged table of components Parameter: COMPRPLC Input-logical-default=FALSE. If TRUE, components with duplicate names are copied from COMP1 into COMP. Remarks: Duplicate component names causes a fatal message to be issued unless COMPRPLC is true. 9.225 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 $ Input Data Blocks: MONi SZRi Monitor tables Associated monitor matrices NX Nastran DMAP Programmer’s Guide 9-391 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: MON SZR Merged monitor table Merged monitor matrices Parameter: MONRPLC Input-logical-default=FALSE. If TRUE, components with duplicate names are copied from MON1 into MON. Remarks: 1. Duplicate monitor points causes a fatal message to be issued unless MONRPLC is true. 2. SZR1, SZR2, and SZR can be purged. 3. SZR is created only if both SZR1 and SZR2 exist. 9.226 Format: MSGHAN MSGHAN Passes message number for processing by MSGPOP API //MSGNUM/MSGINP1/MSGINP2/S,N,MSGOUT $ Input Data Blocks: None. Output Data Blocks: None. Parameters: MSGNUM MSGINP1 MSGINP2 MSGOUT Input-integer-default=0. Message number. Input-integer-default=0. Optional integer input. Input-integer-default=0. Optional integer input. Output-integer-default=0. Optional integer output. 9.227 MSGSTRES Computes data based on fields generated by MSGMESH 9-392 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Blocks: FORCE Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS) section in CASE CONTROL and MSGMESH field information Table of element stresses or strains in SORT1 format OES1 Output Data Blocks: None. Parameters: PLTNUM NOMSGSTR Input/output-integer-default=0. Plot frame counter. Input-integer-default=0. MSGSTRES execution flag. Set to -1 if MSGSTRES execution is not desired. 9.228 MTRXIN Converts matrices input on DMIG Bulk Data entries to matrix data blocks. Format: Form 1 – Simplified (CASECC is purged) MTRXIN Form 2 – Case Control Command Selection of stiffness, mass, and damping (or square) matrices (IOPT=1 for K2GG, and so on, and IOPT=0 for K2PP, and so on, and TF) NX Nastran DMAP Programmer’s Guide 9-393 Chapter 9 Descriptions of DMAP Modules and Statements MTRXIN Form 3 – Case Control Command selection of load (or rectangular) matrix (IOPT=2) MTRXIN Form 4 – Selection of DMIK, DMIJ and DMIJI by data block names MATKi, MATJi, and MATJIi. MTRXIN Form 5 – Selection of stiffness, mass, damping, and loads (or square) matrices by K2PNAM, and so on, input parameter values (IOPT=10 through 12). MTRXIN 9-394 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Form 6 - Selection of DMIK, DMIJ, and DMIJI matrices by the MATNAMi input parameter values (IOPT=13 through 15) MTRXIN Input Data Blocks: CASECC MATPOOL EQEXIN EQDYN TFPOOL AEBGPDTK AEBGPDTJ AEBGPDTI Table of Case Control command images Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Equivalence table between external and internal grid/scalar identification numbers Equivalence table between external and internal grid/scalar/extra point identification numbers. (EQEXIN appended with extra point data) Table of TF Bulk Data entry images Basic grid point definition table for the aerodynamic ks-set degrees of freedom. Basic grid point definition table for the aerodynamic js-set degrees of freedom Basic grid point definition table for the aerodynamic js-set interference degrees of freedom Output Data Blocks: NAMEi K2GG, etc. MATPi MATGi Matrices defined on DMIG Bulk Data entries Matrices defined on DMIG Bulk Data entries and referenced by the K2GG, M2GG, B2GG, K42GG, K2PP, M2PP, B2PP, or P2G Case Control commands Matrices defined on DMIG Bulk Data entries and intended for the p-set Matrices defined on DMIG Bulk Data entries and intended for the g-set NX Nastran DMAP Programmer’s Guide 9-395 Chapter 9 Descriptions of DMAP Modules and Statements RMATG MATKi MATJi MATIi Rectangular matrix defined on DMIG Bulk Data entries and can have an arbitrary number of columns but g-set rows, similar to P2G Matrices defined on DMIK Bulk Data entries Matrices defined on DMIJ Bulk Data entries Matrices defined on DMIJI Bulk Data entries Parameters: LUSET LUSETD NONAMEi NOK2, etc. IOPT Input-integer-no default. The number of degrees-of-freedom in the g-set. Input-integer-no default. The number of degrees-of-freedom in the p-set. Output-integer-default=-1. NAMEi generation flag. Set to +1 if NAMEi is generated; -1 otherwise. Output-integer-default=-1. K2GG, and so on, generation flag. Set to +1 if K2GG, and so on is generated; -1 otherwise. Input-integer-default=0. Case Control command selection flag. 0 1 2 3 4 5 10 11 12 13 14 15 LKSET LJSET, LISET No Case Control command selection (see Form 1) or K2GG, and so on, and TFL Case Control command selection (see Form 2) K2GG, and so on, Case Control command selection (see Form 2) P2G Case Control command selection (see Form 3) DMIK selection by output data block name (see Form 4) DMIJ selection by output data block name (see Form 4) DMIJI selection by output data block name (see Form 4) K2PP, M2PP, and B2PP selection by input parameter value (see Form 5) K2GG, M2GG, B2GG, and K42GG selection by input parameter value (see Form 5) P2G selection by input parameter value (see Form 5) DMIK selection by input parameter value (see Form 6) DMIJ selection by input parameter value (see Form 6) DMIJI selection by input parameter value (see Form 6) Output-integer-default=0. Size of ks-set, js-set, and inteference js-set extracted from the AEBGPTK, AEBGPDTJ and AEBGPDTI tables. 9-396 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOMATi MATNAMi TFLID NFEXIT Output-integer-default=1. Generation flag. Set to +1 if MAT* is generated; 1 otherwise. Input-character-default=’ ’ Matrix name found on DMIG, DMIJ, DMIK, and DMIJI Bulk Data entries. Input-integer-default=0. Transfer function set identification number. TFLID is ignored if IOPT=3, 4, 5, 13, 14, or 15. Input-logical-default=TRUE. Termination flag. If FALSE, do not issue User Fatal Message 2070 and do not terminate the module if the matrix is not found. Remarks: 1. Any output data block can 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, K42GG, 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, 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 generate these two matrices in matrix format, multiply them, 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 generate these two matrices in matrix format and add them to the structural mass and stiffness. Case Control: M2GG = MASS K2GG = STIFF DMAP instructions: MTRXIN CASECC,MATPOOL,EQEXIN,,/STIFF,MASS,,/ LUSET/S,N,NOSTIFF/S,N,NOMASS///1 $ IF (NOSTIFF > -1) THEN $ ADD KGG,STIFF/KGGNEW $ EQUIVX KGGNEW/KGG/ALWAYS $ NX Nastran DMAP Programmer’s Guide 9-397 Chapter 9 Descriptions of DMAP Modules and Statements ENDIF $ IF (NOMASS > -1) THEN $ ADD MGG,MASS/MGGNEW $ EQUIVX MGGNEW/MGG/ALWAYS $ ENDIF 9.229 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 $ Input Data Blocks: CASECC ELSET EDT Table of Case Control command images Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section of Case Control 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 Data Blocks: SET Table of combined sets Parameter: MESHSET Input-integer-default=0. MSGMESH set processing flag. If nonzero, combine mesh sets defined in the MSGMESH punch file. 9.230 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. 9-398 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: NLCOMB Input Data Blocks: CASECC EST KDICTNL BKDICT ETT PTELEM0 PTELEM UNUSED8 MPT EQEXIN SLT DLT BGPDT Table of Case Control command images Element summary table containing geometric and/or material nonlinear elements KELMNL dictionary table BKELM dictionary table Element temperature table Table of thermal loads in the elemental coordinate system from prior subcase Table of thermal loads in the elemental coordinate system for the current subcase Not used and can be purged Table of Bulk Data entry images related to material properties Equivalence table between external and internal grid/scalar identification numbers Table of static loads Table of dynamic loads Basic grid point definition table Output Data Blocks: ELDATA SLT1 DLT1 Table of combined nonlinear information data Table of static loads updated for nonlinear analysis Table of dynamic loads updated for nonlinear analysis NX Nastran DMAP Programmer’s Guide 9-399 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: NSKIP LSTEP LINC STATIC LGDISP OSTEP Input-integer-no default. Subcase record number to read in CASECC. Input-integer-no default. Load step. The current iteration step at the subcase level for static solutions. Input-integer-no default. Number of load increments for this subcase. Input-integer-default=0. Static analysis flag. Set to zero for static analysis and one for dynamic analysis. Input-integer-default=0. Large displacement flag. Set to 1 for large displacement analysis. Input-integer-default=0. Restart step number. 9.231 NLITER Computes nonlinear analysis solution matrices and tables Computes nonlinear analysis solution matrices and tables. Applicable to static structural or steady state heat transfer analysis. Format: NLITER CASECC,CNVTST,PLMAT,YSMAT,KAAL, ELDATA,KELMNL,LLLT,GM,MPT, DIT,MGG,SLT1,CSTM,BGPDT, SIL,USET,RDEST,RECM,KGGNL, ULLT,GPSNT,EDT,DITID,DEQIND, DEQATN,FENL,EPT,PCOMPT/ UGNI,FGNL,ESTNLH,CIDATA,QNV, FFGH,MUGNI,MESTNL,DUGNI,BTOPCNV, BTOPSTF,FENL1/ S,N,LOADFAC/S,N,CONV/S,N,RSTEP/S,N,NEWP/ S,N,NEWK/S,N,POUTF/S,N,NSKIP/LGDISP/ S,N,NLFLAG/S,N,ITERID/S,N,KMATUP/S,N,LSTEP/ S,N,KTIME/S,N,SOLCUR/TABS/ S,N,KFLAG/S,N,NBIS/NORADMAT/S,N,LASTCNMU/ SIGMA/S,N,ARCLG/S,N,ARCSIGN/S,N,TWODIV/ LANGLE/S,N,ITOPT/S,N,ITSEPS/ITSMAX/ S,N,PLSIZE/IPAD/IEXT/ S,N,ADPCON/PBCONT/S,N,NBCONT/GPFORCE $ Input Data Blocks: CASECC CNVTST PLMAT YSMAT Table of Case Control command images Convergence test matrix Initial and final load matrices for subcase Initial and final enforced displacement matrices 9-400 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements KAAL ELDATA KELMNL LLLT GM MPT DIT MGG SLT1 CSTM BGPDT SIL USET RDEST RECM KGGNL ULLT GPSNT EDT Element stiffness matrix for linear elements only reduced to a-set Table of combined nonlinear information data Table of element matrices for stiffness for nonlinear elements Lower triangular factor for nonlinear elements including material, slideline, and differential stiffness effects Multipoint constraint transformation matrix, m-set by n-set Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Radiation matrix in g-size Table of static loads updated for nonlinear analysis Table of coordinate system transformation matrices Basic grid point definition table Scalar index list Degree-of-freedom set membership table for g-set Radiation element summary table Radiation exchange coefficient matrix Stiffness matrix in g-set for material nonlinear elements only Upper triangular factor for nonlinear elements including material, slideline, and differential stiffness effects Grid point shell normal table Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Table of identification numbers in DIT Index table to DEQATN data block Table of DEQATN Bulk Data entry images Strain energy and grid point force at every element from the previous load step in nonlinear matrix format Table of Bulk Data entry images related to element properties DITID DEQIND DEQATN FENL EPT NX Nastran DMAP Programmer’s Guide 9-401 Chapter 9 Descriptions of DMAP Modules and Statements PCOMPT Table containing LAM option input and expanded information from the PCOMP Bulk Data entry Output Data Blocks: UGNI FGNL ESTNLH CIDATA QNV FFGH MUGNI MESTNL DUGNI BTOPOCNV BTOPOSTF FENL1 Displacement matrix at converged step in the g-set Nonlinear element force matrix from the last iteration Nonlinear element summary table at converged step Miscellaneous data for controlled increment method Quasi-Newton sweeping vectors Follower force for OLOAD output Displacement matrix for stiffness update Nonlinear element summary table at current step Incremental displacement matrix between the last two converged steps Updated contact regions input information table Updated contact regions topological information table Strain energy and grid point force at every element at the current load step in nonlinear matrix format Parameters: LOADFAC CONV 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. Input/output-integer-default=0. Nonlinear analysis convergence flag. On input: 0 Initialization On output: -1 1 RSTEP NEWP Convergence has not been achieved. Convergence has been achieved. Input/output-integer-default=0. Controlled increments counter. Input/output-integer-default=1. New subcase flag. -1 Current subcase has not been completed. 9-402 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 1 NEWK Current subcase has been completed. Output-integer-default=1. Stiffness update flag. -1 1 2 Do not update stiffness. Update stiffness. Update stiffness, the solution is diverging and MAXBIS has been reached. POUTF NSKIP Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate output is not requested. Input/output-integer-no default. On input: Subcase record number to read in CASECC. On output: Set to -2 if run is to be fatally terminated. LGDISP Input-integer-no default. Large displacement and follower force flag. -1 1 2 No large displacement and follower force effects are considered. Large displacement and follower force effects are considered. Only large displacement effects are considered. NLFLAG ITERID KMATUP LSTEP KTIME Output-integer-default=0 Input/output-integer-no default. Nonlinear analysis iteration count. Input/output-integer-default=1. Stiffness matrix update count within the increment. Input/output-integer-default=0. Load step. The current iteration step at the subcase level for static solutions. Input/output-real-no default. CPU time remaining. If KTIME is positive, KTIME is the time remaining at the start of the stiffness update. If negative, no stiffness update was done since the last exit from NLITER. KTIME still holds the negative of the stiffness update time from the last stiffness update. Input/output-integer-default=0. Nonlinear loop identification number. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit. Input/output-integer-default=1. Stiffness update flag. Set to -1 to update stiffness before starting bisection. It reflects the NEWK and CONV status at the last converged solution or stiffness update. See Remark 6. Input/output-integer-default=0. Current bisection counter. SOLCUR TABS KFLAG NBIS NX Nastran DMAP Programmer’s Guide 9-403 Chapter 9 Descriptions of DMAP Modules and Statements NORADMAT Input-integer-default=0. Radiation flag. -2 -1 1 2 3 No radiation Initial radiation Single band radiation with constant emissivity Radiation with temperature dependent emissivity Multiple band radiation with constant emissivity LASTCNMU SIGMA ARCLG ARCSGN TWODIV Input/output-real-default=0.0. Last converged value of the arc-length load factor. Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input/output-real-default=1.0. The arc length at the last converged step. Input/output-integer-default=1. The sign of PDDP at the beginning of the subcase. This is used in restarts in the post-buckling region. Input/output-integer-default=0. Nonlinear analysis divergence flag. 0 1 No previous divergence on this load step One previous divergence on this load step LANGLE Input-integer-default=1. Large rotation calculation method: 1 2 Gimbal angle Rotation vector ITOPT ITSEPS Input-integer-default=0. Preconditioner method for iterative solver. See the “SOLVIT” module description. Input/output-integer-default=0. Power of ten for convergence parameter epsilon for iterative solution method. On output, set to 0 for convergence and 1 for no convergence. Input-integer-default=0. Maximum number of iterations for iterative solution method. Input/output-integer-default=0. Size of the load matrix. Compared to the size of load matrix in the previous subcase in order to detect boundary condition changes in the current subcase. Boundary condition changes are not allowed in the arc-length method. Input-integer-default=0. Padding level for reduced incomplete Cholesky factorization. See the “SOLVIT” module description. ITSMAX PLSIZE IPAD 9-404 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements IEXT ADPCON PBCONT NBCONT GPFORCE Input-integer-default=0. Extraction level for reduced incomplete Coolest factorization. See the “SOLVIT” module description. Input-real-default=0.0. Contact penalty value. Scale factor for adjusting penalty values on restart. Update penalty values if positive. Input-integer-default=0. Slideline contact flag. Output-integer-default=0. Number of bisections due to slideline contact. Input-integer-default=-1. The number of columns in FENL. If GPFORCE is less than or equal to zero, no GPFORCE or ESE command is present. 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 can be purged. 3. MGG, RDEST, RECM are required only for heat transfer analysis. Otherwise, they can be purged. 4. ULLT is required only for unsymmetric stiffness. Otherwise, it can be purged. 5. TABS is required for creep analysis. 6. KFLAG is explained iln more detail 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. Solution had converged and a stiffness update had been made. No new stiffness matrix is required before starting bisection. 1 9.232 NLTRD Computes transient nonlinear analysis solution matrices and tables Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural analysis only. NX Nastran DMAP Programmer’s Guide 9-405 Chapter 9 Descriptions of DMAP Modules and Statements Format: NLTRD CASECC,MESTNL,PDT,YS,KRDD, ELDATA,KELMNL,LAM1DD,GM,MPT, DIT,UAM1DD,DLT1,CSTM,BGPDT, SIL,USETD,AM2,AM3,NLFT, KSGG,DITID/ ULNT,IFG,ESTNLH,IFD,OESNL1, PNL,TEL/ BETA/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/ S,N,OLDDT/S,N,NSTEP/LGDISP/S,N,CONSEC/S,N,ITERID/ S,N,MU/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/ S,N,NOTIME/MAXLP/UNUSED17/UNUSE18/UNUSE19/ TABS/LANGLE $ Input Data Blocks: CASECC MESTNL PDT YS KRDD ELDATA KELMNL LAM1DD GM MPT DIT UAM1DD DLT1 CSTM BGPDT SIL USETD AM2 Table of Case Control command images Nonlinear element summary table at current step Dynamic load vectors for transient analysis in the d-set Matrix of enforced displacements or temperatures Combined linear and material nonlinear stiffness matrix in the d-set Table of combined nonlinear information data Table of element matrices for stiffness for nonlinear elements Lower triangular factor of the dynamic tangential matrix in the d-set Multipoint constraint transformation matrix, m-set by n-set Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Upper triangular factor of the dynamic tangential matrix in the d-set Table of dynamic loads updated for nonlinear analysis Table of coordinate system transformation matrices Basic grid point definition table Scalar index list Degree-of-freedom set membership table for the p-set Damping matrix in the d-set for linear elements multiplied by the negative of the time step delta 9-406 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements AM3 NLFT KSGG DITID 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 Nonlinear Forcing function table 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 Table of identification numbers in DIT Output Data Blocks: ULNT IFG ESTNLH IFD OESNL1 PNL TEL Solution matrix from nonlinear transient response analysis in the d-set Matrix of nonlinear element forces for the g-set at the output time steps Nonlinear element summary table at converged step Matrix of nonlinear element forces at constrained points at the output time steps Table of nonlinear element stresses in SORT1 format Nonlinear load matrix appended from each output time step Transient response time output list appended from each subcase Parameters: BETA CONV Input-complex-default=(.33333,0.0). Integration parameter. Input/output-integer-default=1. Nonlinear analysis convergence flag. On input: 0 Initialization On output: -1 1 STIME NEWP -1 1 Convergence has not been achieved. Convergence has been achieved. Input/output-real-default=0.0. On initial input, starting time step and on output, accumulated time used for restarts. Output-integer-default=1. New subcase flag. Current subcase has not been completed. Current subcase has been completed. NX Nastran DMAP Programmer’s Guide 9-407 Chapter 9 Descriptions of DMAP Modules and Statements NEWK Input/output-integer-default=1. Stiffness update flag. -1 >0 Do not update stiffness. Update stiffness. Represents the number of consecutive time steps which have shown divergence. If this number reaches 5, the solution process is terminated. OLDDT NSTEP LGDISP Input/output-real-default=0.0. Time step increment used in the previous iteration or time step to be used after the matrix update or subcase switch. Input/output-integer-default=0. Current time step position for subcase, set to 0 at the beginning of the subcase. Input-integer-no default. Large displacement and follower force flag. -1 1 2 No large displacement and follower force effects aree considered. Large displacement and follower force effects are considered. Only large displacement effects are considered. CONSEC Input/output-integer-default=0. A composite number equal to 10*(value of NSTEP the last time MAXBIS was reached) + (the number of consecutive time steps which have reached MAXBIS). If CONSEC=5, solution process is terminated. Input/output-integer-no default. Nonlinear analysis iteration count. Input/output-real-default=0.0. The magnitude of the last g-set displacement matrix. Input/output-real-no default. CPU time remaining. If KTIME is positive, KTIME is the time remaining at the start of the stiffness update. If negative, no stiffness update was done since the last exit from NLITER. KTIME still holds the negative of the stiffness update time from the last stiffness update. Input/output-integer-default=0. The time step number of the last stiffness update. Set to 0 if the stiffness update is performed due to the CGAP element during the iteration. Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to terminate. Output-integer-default=0. Time out flag. Set to 1 if there is no time left for further iterations but enough time to perform data recovery. Input-integer-default=0. Maximum limit allowed for element relaxation iteration and the material subincrement processes. Input-integer-default=0. Unused. Input-integer-default=0. Unused. ITERID MU KTIME LASTUPD NOGONL NOTIME MAXLP UNUSED17 UNUSED18 9-408 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UNUSED19 TABS LANGLE Input-integer-default=0. Unused. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit. Input-integer-default=1. Large rotation calculation method: 1 2 Gimbal angle Rotation vector 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. 9.233 NLTRD2 Computes transient nonlinear analysis solution matrices and tables Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural or transient heat transfer analysis. Format: 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/ ULNT,IFS,ESTNLH,IFD,OESNL1, PNL,TEL,MULNT,MESTNL,BTOPCNV, BTOPSTF,OESNLB1/ KRATIO/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/ S,N,OLDDT/S,N,NSTEP/LGDISP /S,N,CONSEC/S,N,ITERID/ ITIME/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/S,N,NBIS/ MAXLP/TSTATIC/LANGLE/NDAMP/TABS/ SIGMA/NORADMAT/S,N,ADPCON/PBCONT/ S,N,NBCONT $ Input Data Blocks: CASECC PDT YS Table of Case Control command images Dynamic load vectors for transient analysis in the d-set Matrix of enforced displacements or temperatures NX Nastran DMAP Programmer’s Guide 9-409 Chapter 9 Descriptions of DMAP Modules and Statements ELDATA KELMNL KDD GM MPT DIT KBDD DLT1 CSTM BGPDT SIL USETD BRDD MDD NLFT RDEST RECM BDD GPSNT DITID DEQIND DEQATN Table of combined nonlinear information data Table of element matrices for stiffness for nonlinear elements Stiffness matrix for the d-set, linear elements only Multipoint constraint transformation matrix, m-set by n-set Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Tangential stiffness in d-set Table of dynamic loads updated for nonlinear analysis Table of coordinate system transformation matrices Basic grid point definition table Scalar index list Degree-of-freedom set membership table for the p-set Damping matrix in the d-set for linear elements only or heat capacitance matrix for both linear and nonlinear elements in the d-set Mass (or radiation) matrix for the d-set Nonlinear Forcing function table Radiation element summary table Radiation exchange coefficient matrix Damping (or heat capacitance) matrix for the d-set for linear elements only Grid point shell normal table Table of identification numbers in DIT Index table to DEQATN data block Table of DEQATN Bulk Data entry images Output Data Blocks: ULNT IFS ESTNLH Solution matrix from nonlinear transient response analysis in the d-set Matrix of nonlinear element forces at constrained points at the output time steps Nonlinear element summary table at converged step 9-410 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements IFD OESNL1 PNL TEL MULNT MESTNL BTOPOCNV BTOPOSTF OESNLB1 Matrix of nonlinear element forces at constrained points at the output time steps Table of nonlinear element stresses in SORT1 format Nonlinear load matrix appended from each output time step Transient response time output list appended from each subcase Solution matrix from nonlinear transient response analysis in the d-set from the previous subcase Nonlinear element summary table at current step Updated contact regions input information table Updated contact regions topological information table Table of slideline contact element stresses in SORT1 format Parameters: KRATIO CONV Input/output-complex-default=(1.,0.). Stiffness ratio to be used for time step adjustment. Input/output-integer-default=1. Nonlinear analysis convergence flag. On input: 0 Initialization On output: -1 Convergence has not been achieved. 1 STIME NEWP Convergence has been achieved. Input/output-real-default=0.0. On initial input, starting time step and on output, accumulated time used for restarts. Output-integer-default=1. New subcase flag. -1 Current subcase has not been completed. 1 Current subcase has been completed. NEWK Input/output-integer-default=1. Stiffness update flag. -1 Do not update stiffness. >0 Update stiffness. Represents the number of consecutive time steps which have shown divergence. If this number reaches 5, the solution process is terminated. NX Nastran DMAP Programmer’s Guide 9-411 Chapter 9 Descriptions of DMAP Modules and Statements OLDDT NSTEP LGDISP Input/output-real-default=0.0. Time step increment used in the previous iteration or time step to be used after the matrix update or subcase switch. Input/output-integer-default=0. Current time step position for subcase, set to 0 at the beginning of the subcase. Input-integer-no default. Large displacement and follower force flag. -1 No large displacement and follower force effects are considered. 1 2 Large displacement and follower force effects are considered. Only large displacement effects are considered. CONSEC Input/output-integer-default=0. A composite number equal to 10*(value of NSTEP the last time MAXBIS was reached) + (the number of consecutive time steps which have reached MAXBIS). If CONSEC=5, the solution process is terminated. Input/output-integer-no default. Nonlinear analysis iteration count. Input-real-default=0.0. Initial time step at the beginning of a subcase. Input/output-real-no default. CPU time remaining. If KTIME is positive, KTIME is the time remaining at the start of the stiffness update. If negative, no stiffness update was done since the last exit from NLITER. KTIME still holds the negative of the stiffness update time from the last stiffness update. Input/output-integer-default=0. The time step number of the last stiffness update. Set to 0 if the stiffness update is performed due to the CGAP element during the iteration. Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to terminate. Input/output-integer-default=0. Current bisection counter. Input-integer-default=0. Maximum limit allowed for element relaxation iteration and the material subincrement processes. Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and damping forces. Input-integer-default=1. Large rotation calculation method: 1 2 Gimbal angle Rotation vector ITERID ITIME KTIME LASTUPD NOGONL NBIS MAXLP TSTATIC LANGLE NDAMP TABS Input-real-default=0.0. Numerical damping. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit. 9-412 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SIGMA NORADMAT Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input-integer-default=0. Radiation flag. -2 No radiation -1 Initial radiation 1 2 3 Single band radiation with constant emissivity Radiation with temperature dependent emissivity Multiple band radiation with constant emissivity ADPCON PBCONT NBCONT Input-real-default=0.0. Contact penalty value. Scale factor for adjusting penalty values on restart. Update penalty values if positive. Input-integer-default=0. Slideline contact flag. Input/output-integer-default=0. Number of bisections due to slideline contact. 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. 9.234 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 $ NX Nastran DMAP Programmer’s Guide 9-413 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Block: A Any matrix (real or complex) Output Data Block: ANORM Normalized matrix Parameters: NCOL NROW XNORM IOPT Number of columns in A Integer-output-default=0. Number of rows in A. Real-output-default=0.0. Maximum absolute normalizing value over all columns. Integer-input-default=1. Normalization option. 1 2 XNORMD PRTSWM Normalize by largest element Compute SRSS Real double precision-output-default=0.D0. Same as XNORM except in double precision. Logical-input-default=TRUE. If PRTSUM=FALSE, System Warning Message 6991 is suppressed. This message is printed when the maximum term exceeds the single precision limit for the machine type. When it is TRUE, the message is printed. Remarks: 1. If IOPT=1, ANORM is the same as A except each column has been normalized by its maximum absolute value. 2. If IOPT=2, 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. Examples: 1. Normalize PHIG so that the maximum deflection is 1.0 (or -1.0). NORM PHIG/PHIG1 $ 2. Compute complex eigenvectors that have been normalized such that the product[CPHG]T [CPHG] produces a square matrix with off-diagonal terms of computational zero, and complex diagonal terms whose magnitude is unity. TRNSP NORM MATMOD DIAGONAL MPYAD CPHG/CPHGT $ CPHGT/CX2////2 $ CX2,,,,,/INORM22,/28 $ DIAGONALIZE INORM22/NORM22/‘WHOLE‘/-1.0 $ INVERT CPHG,NORM22,/CPHGNORM $ NORMALIZE 9-414 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MPYAD CPHGNORM,CPHGNORM,/N22/1 $ SHOULD BE IDENTITY IN MAGNITUDE DIAGONAL N22/N22MAG/‘WHOLE‘/1.0 $ FIND MAGNITUDES 9.235 NXNADAMS Creates an ADAMS MNF for a superelement. Creates an ADAMS Modal Neutral File (MNF) for a superelement. The output is based on the definitions in the ADAMSMNF case control command and the DTI,UNITS bulk data entry. Format: NXNADAMS UNITS,CASES,BGPDTS,GEOM2,GEOM4,USET,LAMA,PHIG, MGGDIAG,PCDB,OGPWG,OGSR1,OGSTRR1,CSTMS// SEID/FLXONL/FLXERR/WTMASS/GRDPNT $ Input Data Blocks: UNITS CASES BGPDTS GEOM2 GEOM4 USET LAMA PHIG MGGDIAG PCDB OGPWG OGSR1 OGSTRR1 CSTMS UNITS data block from the DTI,UNITS bulk data entry Case Control table associated with superelement Basic Grid Point Definition Table associated with superelement Table of Bulk Data entries related to element connectivity Table of Bulk Data entries related to constraints Table of degree-of-freedom sets Eigenvalue summary table for superelement Matrix of eigenvectors (g-set size) corresponding to LAMA Column vector of diagonal values from superelement mass matrix (g-set size) Plot Control Data Block from OUTPUT(PLOT) case control Output table of Grid Point Weight Generator of superelement Output table of grid point stresses of superelement Output table of grid point strains of superelement Coordinate System Transformation Matrices for superelement Parameters: SEID Input-integer-default=0. Superelement ID number (0 for residual-only analysis). NX Nastran DMAP Programmer’s Guide 9-415 Chapter 9 Descriptions of DMAP Modules and Statements FLXONL Output-integer-no default. Value of FLEXONLY keyword from ADAMSMNF case control command. Options are: 0: Continue with solution of residual structure 1: Do not perform solution of residual structure FLXERR Output-integer-no default. Error flag. Options are: 0: No error 1: Error occurred creating MNF. Terminate processing. WTMASS GRDPNT Input-real-default=1.0. Value of WTMASS parameter from PARAM,WTMASS,value. Input-integer-default=-1. Value of GRDPNT parameter from PARAM,GRDPNT,value. Remarks: The MNF naming convention is as follows: ‘jid_SEID.mnf’, where jid is the “job ID” of the run (that is, the name of the job input file) and SEID is the superelement ID number (that is, the SEID parameter). The location of the created MNF is the same as the jid.f06 file. 9.236 NXNRFI Creates a RecurDyn Flex Input (RFI) file for a superelement. Creates a RecurDyn Flex Input (RFI) file for a superelement. The output is based on the definitions in the RECURDYNRFI case control command and the DTI,UNITS bulk data entry. Format: NXNRFI UNITS,CASES,BGPDTS,GEOM2,GEOM4,USET,LAMA,PHIG, MGGDIAG,PCDB,OGPWG,OGSR1,OGSTRR1,CSTMS// SEID/FLXONL/FLXERR/WTMASS/GRDPNT $ Input Data Blocks: UNITS CASES BGPDTS GEOM2 GEOM4 USET UNITS data block from the DTI,UNITS bulk data entry Case Control table associated with superelement Basic Grid Point Definition Table associated with superelement Table of Bulk Data entries related to element connectivity Table of Bulk Data entries related to constraints Table of degree-of-freedom sets 9-416 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements LAMA PHIG MGGDIAG PCDB OGPWG OGSR1 OGSTRR1 CSTMS Eigenvalue summary table for superelement Matrix of eigenvectors (g-set size) corresponding to LAMA Column vector of diagonal values from superelement mass matrix (g-set size) Plot Control Data Block from OUTPUT(PLOT) case control Output table of Grid Point Weight Generator of superelement Output table of grid point stresses of superelement Output table of grid point strains of superelement Coordinate System Transformation Matrices for superelement Parameters: SEID FLXONL Input-integer-default=0. Superelement ID number (0 for residual-only analysis). Output-integer-no default. Value of FLEXONLY keyword from RECURDYNRFI case control command. Options are: 0: Continue with solution of residual structure 1: Do not perform solution of residual structure FLXERR Output-integer-no default. Error flag. Options are: 0: No error 1: Error occurred creating RFI. Terminate processing. WTMASS GRDPNT Input-real-default=1.0. Value of WTMASS parameter from PARAM,WTMASS,value. Input-integer-default=-1. Value of GRDPNT parameter from PARAM,GRDPNT,value. Remarks: The RFI naming convention is as follows: ‘jid_SEID.rfi’, where jid is the “job ID” of the run (that is, the name of the job input file) and SEID is the superelement ID number (that is, the SEID parameter). The location of the created RFI is the same as the jid.f06 file. 9.237 OFP Output file processor Outputs (print or punch) data blocks prepared by other modules in user-oriented, self-explanatory formats. NX Nastran DMAP Programmer’s Guide 9-417 Chapter 9 Descriptions of DMAP Modules and Statements Format: OFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6, CSTM,BGPDTVU,ERROR1,DEQATN,DEQIND,DIT// S,N,CARDNO/ODCODE/PVALID/DFLAG/VFLAG/AFLAG/ABSEM $ Input Data Blocks: OFPi CSTM EHT BGPDTVU ERROR1 DEQATN DEQIND DIT Output table suitable for processing by the OFP module. See Remark 2. Table of coordinate system transformation matrices Element hierarchical table for p-element analysis Basic grid point definition table for a superelement and related to geometry with view-grids added Error-estimate table updated for current superelement or adaptivity loop Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of TABLEDi Bulk Data entry images Output Data Blocks: None. Parameters: CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is incremented by one for each line written to the punch file and is also written into columns 73-80 of each line. Input-integer-default=-1. Output device code override. See Remark 4. ODCODE overrides the code stored in the DBi‘s according to the following table: ODCODE 1 2 3 4 5 6 Output directed to: Print Plot Print and Plot Punch Print and Punch Plot and Punch ODCODE 9-418 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 7 PVALID DFLAG Print, Plot, and Punch Input-integer-default=0. P-element adaptivity loop identification number. Input-integer-default=0. Displacement output flag. = 0 output displacement “as is” = 1 output displacement as “relative motion” = 2 do not output displacement Input-integer-default=0. Velocity output flag. = 0 output velocity “as is” = 1 output velocity as “relative motion” = 2 do not output velocity Input-integer-default=0. Acceleration output flag. = 0 output acceleration “as is” = 1 output acceleration as “relative motion” = 2 do not output acceleration Input-integer-default=1. Enforced motion code for header labeling (0=constraint modes method; 1=absolute displacement method). VFLAG AFLAG ABSEM Remarks: 1. Any or all data blocks can 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, VDRE, 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; that is, displacement, stress, strain, and so on. 5. CSTM, DEQATN, DEQIND, and DIT are required if the CORD3G Bulk Data entry is present and only for element data recovery; that is, displacement, stress, strain, and so on. Example: Print the OUG1 table from the SDR2 module. OFP OUG1/ $ 9.238 OPTGP0 p-element analysis preprocessor Preprocesses the input design optimization shape basis vectors for p-element analysis. NX Nastran DMAP Programmer’s Guide 9-419 Chapter 9 Descriptions of DMAP Modules and Statements Format: OPTGP0 GEOM1M,GEOM2M,MEDGE,EDOM,UNUSED5,UNUSED6,UNUSED7, DEQATN,DEQIND/ EDOMM/ DELG $ Input Data Blocks: GEOM1M GEOM2M MEDGE EDOM unused5 unused6 unused7 DEQATN DEQIND Table of Bulk Data entry images related to geometry and updated for the current p-level Table of Bulk Data entry images related to element connectivity and scalar points and updated for the current p-level Edge table for p-element analysis Table of Bulk Data entries related to design sensitivity and optimization Unused and can be purged Unused and can be purged Unused and can be purged Table of DEQATN Bulk Data entry images Index table to DEQATN data block Output Data Block: EDOMM Table of Bulk Data entries related to design sensitivity and optimization updated for p-element analysis Parameter: DELG Input-real-default=0.1. Scale factor on perturbed length. Remarks: 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). 9.239 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. 9-420 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: ORTHOG A,M/ Q,R/ ORTHOPT/ORTHCON/S,N,ORTHEPS/ORTHREPT/ORTHTOL $ Input Data Blocks: A M Rectangular matrix of m columns (vectors) by n rows to be orthogonalized where m≤n Weighting matrix: symmetric and positive definite Output Data Blocks: Q R Rectangular matrix of orthogonalized vectors Rectangular matrix whose m by m upper triangle contains an intermediate factor of the process Parameters: ORTHOPT Input-integer-default=1. Orthogonalization method. 1 2 ORTHCON And M is purged, perform Householder Orthogonalization. Or M is not purged, perform Matrix Modified Gram-Schmidt method. If ORTHOPT=2 and M is purged, an identity matrix is created for M. Input-integer-default=1. Matrix Modified Gram-Schmidt termination flag or Householder partitioning vector generation flag. For Householder: 0 1 R contains the upper triangular matrix. R contains the partitioning vector. For Matrix Modified Gram-Schmidt termination: 0 1 ORTHEPS Exit the program if M is not at least a positive semi-definite matrix. R is not used and can be purged. Let Rii = -Rii and continue, if M is not at least a positive semi-definite matrix. R contains the partitioning vector Output-real-no default. Level of orthogonality. ORTHEPS is the largest lower triangular term of the matrix R and is computed with the Householder method. NX Nastran DMAP Programmer’s Guide 9-421 Chapter 9 Descriptions of DMAP Modules and Statements ORTHREPT ORTHTOL Input-real-default=0.707. Matrix Modified Gram-Schmidt algorithm repeat flag. The default is approximately the square root of 0.5. Input-real-default=0.0. Linear dependence tolerance. By default, ORTHTOL is set to the square root of the minimum machine value. Remarks: ORTHOG generates an orthonormal set of vectors [Q] from a given set of vectors [A] such that: [A] = [Q][R] and if [M] is not given: [Q]T[M] [Q] = [I] or if [M] is not given: [Q]T[Q] = [I] where [I] is an identity matrix. 9.240 Format: OUTPRT OUTPRT Constructs sparse load reduction and sparse data recovery partitioning vectors CASECC,ECT,BGPDT,SIL,XYCDB,DYNAMIC,MATPOOL,PG,VGFD, TABEVP,TABEVS/ PVGRID,PVSPC,PVMPC,PVLOAD/ S,N,SDRMETH/NOSE/SDROVR/SDRDENS $ Input Data Blocks: CASECC ECT BGPDT SIL XYCDB DYNAMIC MATPOOL PG VGFD TABEVP Table of Case Control command images Element connectivity table Basic grid point definition table Scalar index list Table of x-y plotting commands Table of Bulk Data entry images related to dynamics Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Static load matrix applied to the g-set Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to frequency-dependent elements Cross-reference table between ESTDVP records and element and design variable identification numbers 9-422 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements TABEVS Cross reference table between ESTDVS records and element and design variable identification numbers Output Data Blocks: PVGRID Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to elements or grids specified on the following Case Control commands: • • • • • • • • • • • • • • PVSPC DISPLACEMENT VELOCITY ACCELERATION FORCE STRESS STRAIN SPCFORCE MPCFORCE MPRES GPFORCE ESE EKE EDE GPKE Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to elements or grids specified on the SPCFORCE Case Control command Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to elements or grids specified on the MPCFORCE Case Control command Partitioning vector with ones at rows corresponding to degrees-of-freedom at which static and dynamic loads are applied. PVMPC PVLOAD NX Nastran DMAP Programmer’s Guide 9-423 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: SDRMETH Output-integer-no default. Data recovery method flag: -1 0 1 NOSE Sparse data recovery Full (or standard) data recovery No data recovery is requested or required. 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 FULL SPARSE Choose full or sparse data recovery based on SDRDENS. Choose full data recovery. 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, choose full data recovery. 9.241 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 NX Nastran run. Format: OUTPUT2 DB1,DB2,DB3,DB4,DB5//ITAPE/IUNIT/LABL/MAXR/ NDDLNAM1/NDDLNAM2/NDDLNAM3/NDDLNAM4/ NDDLNAM5 $ Input Data Blocks: 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 can be purged. 9-424 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: ITAPE Input-integer-default=0. ITAPE is used to select the file positioning option as follows: +n 0 -1 -3 -9 IUNIT Skip forward n data blocks before writing (used only if file has no label). Data blocks are written starting at the current position. If this is the first use, no label is written. Rewind IUNIT before writing, and label file. Rewind IUNIT, print data block names and write after the last data block on IUNIT (file must have a label). Write a final EOF on IUNIT (must be used before -3 option and as last I/O use of unit), then rewind IUNIT. Input-integer-no default. IUNIT is the FORTRAN unit number on which the data blocks are to be written. UGS does not recommend IUNIT=0. See Remark 7. Input-character-default = ‘XXXXXXXX’ LABL is used for file identification. The label is written only if ITAPE=-1, and is checked only if ITAPE=-3. Input-integer-default=2 * BUFFS IZE words. Maximum physical record size. (See Remarks.) Input-character-default=blank. NDDL names corresponding to DB1 through DB5. If DBi is a matrix, the corresponding NDDLNAMi is ‘MATRIX’ (See Remarks.) LABL MAXR NDDLNAMi 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 the data block descriptions. • 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 indicates one of the following depending on its location in the binary file: KEY >0 Description The length of the next physical record. It can also indicate the start of a new logical record. NX Nastran DMAP Programmer’s Guide 9-425 Chapter 9 Descriptions of DMAP Modules and Statements KEY 0 <0 Description End-of-File (data block) (EOF) or End-of-Data (EOD) End-of-Logical record (EOR) or a null column. The absolute value indicates the logical record number. 3. The End-of-Data (EOD) follows the last end-of-file (data block) written to the binary file. 4. If possible, each logical record of the data block is written to one physical record of the FORTRAN binary file. However, the length of a logical record can exceed the maximum length of a physical record (see MAXR parameter). If this occurs, the logical record spans more than one physical record. In other words, the logical record is 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 can be processed as sequential data blocks. 7. UGS recommends the ASSIGN FMS statement (in the NX Nastran Quick Reference Guide) for assigning the FORTRAN unit. Selection of a proper value for IUNIT is machine dependent. See “Making File Assignments” in the NX Nastran Installation and Operations Guide. 8. No physical record exceeds 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 “Keywords” in the NX Nastran Installation and Operations Guide for the maximum allowable values. 9. When the neutral format option is selected via FORM=FORMATTED or an endianness conversion is selected via FORM=LITTLEENDIAN or FORM=BIGENDIAN on the ASSIGN FMS statement (associated with OUTPUT2 parameter IUNIT), MAXR and NDDLNAMi are interpreted as follows: Represents the maximum physical record size (in words) on the target machine(s) for the machine binary-formatted file. For neutral files, this applies to the binary file after it has been converted from neutral to binary via the supplied conversion utility RCOUT2. Correlates the DMAP data block name with the corresponding NDDL-defined name. If this parameter is left blank, the corresponding DMAP name (DB1 through DB5) is assumed to be the NDDL-defined name. MAXR NDDLNAMi 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. AXIC CASES CLAMA GEOM1 GEOM1Q GEOM2 GPLS LAMA MATPOOL OEIGS OEP OES1 OESNL2 OESNLX OGPWG OQG2 OSTR1 OSTR2 9-426 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CSTMS DIT DYNAMICS EPT EPTS FOL GEOM2S GEOM3 GEOM3S GEOM4 GEOM4S GPDTS MPT MPTS OEF1 OEF1X OEF2 OES1C OES1X OES1X1 OES2 OESNL1 OGS1 OPG1 OPG2 OPNL1 OQG1 OUGV1 OUGV2 PSDF PVT USET In addition, all matrices defined with a TYPE DB can be neutral formatted. If a matrix is not an NDDL data block, the NDDLNAMi=‘MATRIX’should be used. For example, to write the matrix MYMATRIX, use OUTPUT2 MYMATRIX,,,,//ITAPE/IUNIT/LABL/MAXR/‘MATRIX’$ Note that the neutral format is a machine-neutral format that allows the transfer of the OUTPUT2-generated files between different machine types. See “RCOUT2” in the NX Nastran Installation and Operations Guide for a discussion of this transfer process and the supplied conversion utility RCOUT2. 10. The following formats describe each physical record. • Format for Table and Matrix Labels (written only if ITAPE=-1) Physical record number 1 2 3 4 5 6 7 8 Length Contents Description 1 KEY 1 KEY 1 KEY 1 1 KEY = 3 Date (3 words, month-day-year) – integer KEY = 7 NASTRAN Header (7 words, Character-A4) KEY = 2 LABEL (2 words, Character-A4 = LABL) KEY = -1 (EOR) KEY = 0 (EOF) End of Label One Logical Record Word 1 = NAST, Word 2 = RAN, Word 3 = FORT, Word 4 = TAP, Word 5 = EID, Word 6 = COD, Word 7 = E • Format for Tables and Matrices NX Nastran DMAP Programmer’s Guide 9-427 Chapter 9 Descriptions of DMAP Modules and Statements Physical record number 9 10 11 12 13 14 15 16 Length Contents Description 1 KEY 1 1 KEY 1 1 KEY KEY = 2 Data Block Name (2 words, Character-A4) KEY = -1 (EOR) KEY = 7 NASTRAN Trailer (7 words, integer) KEY = -2 (EOR) KEY = 1 (Start new logical record) Logical Record Type:0 : table1 : matrix column (string records)2 : factor matrix (string record)3 : factor matrix (matrix record) KEY Š 2. Data Block Name (2 words, Character-A4) and data (if any) KEY=-3 (EOR). Logical Record 3 of Data Block Trailer: Logical Record 2 of Data Block Header: Logical. Record1 of Data Block 17 18 19 • 1 KEY 1 Format for Tables (Records 20 through n) Physical record number 20 21 22 23 24 Length Contents Description 1 KEY 1 KEY 1 KEY=1 (Start new logical record) Next Logical Record Type=0 for table record KEY > 0 Data KEY < 0 (EOR)** Logical Record 4 of Table 9-428 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Physical record number 25 26 27 28 29 . . . n-7 n-6 n-5 n-4 n-3 n-2 n-1 n Length Contents Description 1 KEY 1 KEY 1 . . . 1 KEY 1 KEY 1 1 KEY 1 KEY = 1 (Start new logical record) Next Logical Record Type = 0 KEY > 0 Data KEY < 0 (EOR)** Repeat Physical Records 25-29 for Additional Records in Table Logical Record 5 of Table Additional Records of Table KEY = 1 (Start new logical record) Next Logical Record Type = 0 KEY > 0 Data KEY < 0 (EOR)** KEY = 1 (Start new logical record) Next Logical Record Type = 0 KEY = 0 (EOF) Last Logical Record of Table If Last “Next Logical Record Type" = 0, this is the end of the table. *If more data exists for the column or logical record, KEY>0 and the physical records 22, 23, and 24 are repeated as many times as necessary to complete the column or logical record. • Format for Matrices (Records 20 though n) Physical record number 20 21 Length Contents Description 1 KEY KEY=1 (Start new logical record) Next Logical Record Type 1 : matrix column (string records)2 : factor matrix 3 : factor matrix Logical Record 4 of Matrix=first column NX Nastran DMAP Programmer’s Guide 9-429 Chapter 9 Descriptions of DMAP Modules and Statements Physical record number 22 23 24 25 Length Contents Description 1 KEY+1 1 KEY+1 KEY > 0 Number of non-zero terms in next string in word unit First non-zero row, followed by non-zero terms KEY > 0 Number of non-zero terms in next string in word unit First non-zero row, followed by non-zero terms. Repeat String Records 22-23 for Additional Strings in Column First Column First String Record First Column Second String Record n-2 n-1 n 1 KEY+1 1 KEY > 0 Number of non-zero terms in next string in word unit First non-zero row, followed by non-zero terms. KEY<0 (EOR) 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 First Column Last String Record End of First Column n n+1 1 KEY KEY=1 (Start new logical record) Next Logical Record Type (See Record 21 above) Null Column n+2 m-5 m-4 m-3 m-2 m-1 m 1 1 KEY+1 1 1 KEY 1 KEY<0 (EOR) KEY > 0 Number of non-zero terms in next string in word unit First non-zero row, followed by non-zero terms KEY<0 KEY=1 (Start new logical record)TD> Next Logical Record type=0 KEY = 0 (EOF) End of Null Column Last Column Last String Record End of Last Column If Last "Next Logical Record Type" = 0 End of Matrix 9-430 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements • Format for Tables and Matrix-End-of-Data Physical Length Contents record number n+1 1 If No Data Blocks Follow, KEY = 0 (EOD) Description End-of-Data 11. OUTPUT2 files can be read using three utility subroutines provided in the utility ("util") directory. (See “Building and Using TABTST” in the NX Nastran Installation and Operations Guide. See Remark 12. IOPEN IHEADR IREAD Once per FORTRAN unit Once per data block As many times as desired These routines are contained in a file called tabtst.f (or.for). These routines are coded in machine-independent FORTRAN. Major benefits that result in using this standard interface are: • • • Easier initial usage of OUTPUT2. Most users make several errors while becoming familiar with the formats. User code is not burdened/concerned with physical record boundaries. Data can be processed in logical groups rather than in a "blast" read mode. Major limitations include: • • • Matrices cannot be processed in this manner. Multiple FORTRAN units cannot be simultaneously processed. BACKSPACE operations are not permitted. Following are descriptions and use of the three OUTPUT2 service routines. NX Nastran DMAP Programmer’s Guide 9-431 Chapter 9 Descriptions of DMAP Modules and Statements Entry point IOPEN Description Initializes an OUTPUT2 file and read the label (NX Nastran). Format: CALL IOPEN(IUN,L) where IUN = An input integer, which specifies the unit number to be read. L = An output two-word array (2A4) containing the label written on the unit (L comes from the third parameter in the DMAP call). Method: IOPEN rewinds IUN and reads in the data, title, and label. The keys are checked. A key check failure results in the message IOPEN BAD KEYX = XXXX. IHEADR Processes the data block name and trailer. Format: CALL IHEADR(IUN,NAM,T) where IUN = As described in IOPEN. NAM = An output two-word array (2A4) containing the data block trailer in words two through seven. Word one contains the location in the DMAP call (101,102, and so on) Method: IHEADR reads the name and trailer. It checks KEY lengths. It also skips the data block header (which unfortunately can 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. Entry point IREAD Description Supplies data to the calling program in a logical (as opposed to a physical) manner. Format: CALL IREAD(IUN,ARRY,NARY,IMETH,NT,IRTN) where IUN is as described in IOPEN. ARRY is the array into which a record is transmitted. NARY is an integer input that requests the number of words to be transmitted. If NARY is zero, no words are transmitted. If NARY is negative, the words are skipped but not transmitted. If (NARY is greater than the number of words remaining, the remaining words are processed (skipped or transmitted) and NT is set to this number and IRTN is set to 1. 9-432 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Entry point Description IMETH is an integer input that specifies how to proceed through the logical record. If IMETH = 0, the current logical record is continuously processed until an end-of-record return (IRTN =1) is given. If IMETH = 1, the remaining data (if any) at the conclusion of IREAD, in the current logical record, is skipped. NT is an integer output value which contains the number of words transmitted or skipped if IRTN is 1 on return from IREAD. IRTN is an integer output value which indicates the status on return from IREAD. IRTN = 0 Normal return. IRTN = 1 End of logical record reached while trying to process NARY words. IRTN = 2 End-of-file reached for this data block. Method: OUTPUT2 physical records are read into a buffer area. These records are at most 2 * BUFFSIZE words long. The current position is maintained and data is transmitted (or skipped) from the buffer to the ARRY array. If the NX Nastran logical record spans several physical FORTRAN records, these are transparent (no end-of-record returns) to the user. 12. If you select any of the options for endianness using the ASSIGN FMS statement, the resulting files are fortran readable only on systems that have the same endianness. 9.242 OUTPUT4 Output matrices onto a FORTRAN readable file Write matrices in ASCII or binary format onto a FORTRAN readable file. Format: OUTPUT4 M1,M2,M3,M4,M5//ITAPE/IUNIT/UNUSED3/BIGMAT/DIGITS $ Input Data Blocks: Mi Matrices. Mi cannot be a factor matrix (forms 4, 5, 10, 11, 13, and 15). Parameters: ITAPE Input-integer-default = -1. ITAPE controls the status of the unit before OUTPUT4 starts to write any matrices as follows: NX Nastran DMAP Programmer’s Guide 9-433 Chapter 9 Descriptions of DMAP Modules and Statements ITAPE 0 -1 -2 -3 IUNIT ACTION None Rewind IUNIT before Write. End File and Rewind IUNIT after Write. Both Input-integer-no default. The absolute value of IUNIT is the FORTRAN unit number on which the matrices are written. If IUNIT is negative, the sparse output option is used, which means that only nonzero items in the matrix are written to the unit. UGS does not recommend IUNIT = 0. See Remark 1. Input-integer-default=1. Unused. UNUSED3 BIGMAT Input-logical-default=FALSE. BIGMAT is applicable only when IUNIT < 0. BIGMAT=FALSE selects the format that uses a string header as described under Remark 1. However, if the matrix has more than 65535 rows, BIGMAT is automatically set to TRUE regardless of the value specified. Input-integer-default = 9. DIGITS is the requested number of digits for the fractional part of the real values written for the ASCII format option (FORMATTED on the ASSIGN FMS statement). The FORTRAN Format Specification used internally by OUTPUT4 to write real values is formed as follows: FORTRAN Format Specification: P,rEw.d d = DIGITS w = d + 7 r = 80/w (integer portion) DIGITS For example, if DIGITS = 9, the format is 1P,5E16.9 or if DIGITS = 16, the format is 1P,3E23.16 Remarks: 1. Each matrix is written on IUNIT as follows: • Record 1: Word number 1 2 3 Type Integer Integer Integer Meaning Number of columns (NCOL) Number of rows (NR, if BIGMAT=TRUE, NR < 0) Form of matrix (NF). See Remark 11 and Section 1.4. 9-434 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Word number 4 5 and 6 7 Type Integer Character Character Meaning Type of matrix (NTYPE). See Remark 11 and Section 1.4. Name of matrix (2A4 format) If ASCII format, this is the FORTRAN format specification based on DIGITS parameter value. If binary format, this is blank. • Records 2, 3, 4, and so on for nonsparse and binary format, (IUNIT > 0 and binary format) and repeated for each nonzero column, i=ICOL through NCOL. Word number 1 2 3 4 through (NW+3) Type Integer Integer Integer Real or Complex Meaning Column number (ICOL) Row position of first nonzero term (IROW) Number of words in the column (NW). See Remark 3. Column element values, single or double precision • Records 2, 3, 4, and so on for nonsparse and ASCII format, (IUNIT > 0), are repeated for each nonzero column, ICOL through NCOL. Records 3, 4, and so on, are also repeated for each group of r values (see DIGITS parameter). Record number 2 Word number 1 2 3 3, 4, and so on 1 through NW Type Integer Integer Integer Real or Complex Meaning Column number (ICOL) Row position of first nonzero term (IROW) Number of words in the column (NW). See Remark 3. Column element values, single or double precision • Records 2, 3, 4, and so on for sparse, binary, and string header format (IUNIT < 0, and BIGMAT = FALSE). NX Nastran DMAP Programmer’s Guide 9-435 Chapter 9 Descriptions of DMAP Modules and Statements Word number 1 2 3 4 through (NW+3) Type Integer Integer Integer Integer Real or Complex Meaning Column number (ICOL) Zero Number of words in the column (NW). See Remark 3. String header (IS)* A string of nonzero values, single or double precision *IS = IROW + 65536(L + 1) where IROW is the row position of the first term in the string and L is the length of the string, see Remark 3. For example, a string of six words beginning in row 4 has IS=458756. L and IROW can be derived from IS by: • Records 2, 3, 4, and so on for sparse, binary, and regular string format (IUNIT < 0, and BIGMAT = TRUE). Word number 1 Type Integer Meaning Column number (ICOL) 2 3 4 through (NW+3) Integer Integer Integer Integer Real or complex Zero Number of words in the column (NW). See Remark 3. Length of string, L, plus 1. See Remark 3. Row position of first term in string (IROW) A string of nonzero values, single or double precision Repeated for each string. • Records 2, 3, 4, and so on 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. Record 4 is also repeated for each group of r values (see DIGITS parameter). 9-436 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Record number 2 Word number 1 2 3 Type Integer Integer Integer Integer Real or Complex Meaning Column number (ICOL) Zero Number of words in the column (NW). See Remark 3. String header (IS)* A string of nonzero values, single or double precision 3 4 1 1 through NW • Records 2, 3, 4, and so on 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. Record 4 is also repeated for each group of r values (see DIGITS parameter). Record number 2 Word number 1 2 3 3 1 2 4 1 through NW Type Integer Integer Integer Integer Integer Real or Complex Meaning Column number (ICOL) Zero Number of words in the column (NW). See Remark 3. Length of string, L, plus 1. See Remark 3. Row position of first term in string (IROW) A string of nonzero values, single or double precision 2. A record with the last column number plus +1 and at least one value in the next record is written on IUNIT. 3. The number of words in the column, NW (or string, L), is the number of elements in the column (or string) times the number of words per type. Number of words per type is given in the table below. For example, a column with seven real double precision elements is 14 words long. Type 1 – Real single precision 2 – Real double precision Number of words 1 2 NX Nastran DMAP Programmer’s Guide 9-437 Chapter 9 Descriptions of DMAP Modules and Statements Type 3 – Complex single precision 4 – Complex double precision Number of words 2 4 4. UGS recommends the ASSIGN FMS statement for assigning the FORTRAN unit (see “Making File Assignments” in the NX Nastran Installation and Operations Guide). Selection of a proper value for IUNlT is machine dependent. 5. If the nonsparse format (IUNIT > 0) is selected, zero terms are explicitly present after the first nonzero term in any column until the last nonzero term. 6. Null columns are not 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 = FORMATTED 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 can be read using a utility FORTRAN subroutine called GETIDS, which is provided in the utility directory. (See “Building and Using MATTST ” in the NX Nastran 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. 12. If you select any of the options for endianness using the ASSIGN FMS statement, the resulting files are fortran readable only on systems having the same endianness. The only way to read these files on the same machines is to use the INPUTT4 command. 9.243 PARAML Sets parameters from a data block Format: PARAML DB/DBNAME/P1/S,N,P2/S,N,P3/S,N,P4/S,N,P5/S,N,P6/ S,N,SET1/S,N,F1/S,N,SET2/S,N,F2/ S,N,SET3/S,N,F3/S,N,SET4/S,N,F4/ S,N,SET5/S,N,F5/S,N,SET6/S,N,F6/ S,N,SET7/S,N,F7/S,N,SET8/S,N,F8/ S,N,SET9/S,N,F9/S,N,SET10/S,N,F10/ S,N,SET11/S,N,F11/S,N,SET12/S,N,F12 $ 9-438 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Block: DB Any matrix or table Output Data Block: DBNAME Any data block. Used only when P1 = ‘NAME’; otherwise DBname must not be specified. Parameters: P1 P2 P3 P4 P5 P6 SETi Fi Input-character-no default. Only the first 4 characters are required. For example, ‘PRES’ and ‘PRESENCE’ are equivalent. Input/output-integer-default = 1 Input/output-integer-default = 1 Output-real-default = 0.0 Output-integer-default = 0.0 Output-real-default = 0.0 Input/output-character-default = ’ ’ Output-integer-default = 0 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 is set to -1, if the input data block does not exist, and no other parameters are set. 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 $ Input Data Block: IFPDB Table with trailer bits indicating existence of Bulk Data entry records NX Nastran DMAP Programmer’s Guide 9-439 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: BULKNMi BULKFGi Input-character. Name of Bulk Data entry. Output-integer. Set to -1 if Bulk Data entry exists. Remarks: To determine which table contains BULKNMi, see the data block description. Example: Check for the presence of the rigid elements. PARAML GEOM4//‘BULK‘//////‘RBE1‘/S,N,RBE1/‘RBE2‘/S,N,RBE2/ ‘RBE3‘/S,N,RBE3/‘RROD‘/S,N,RROD/‘RBAR‘/S,N,RBAR/ ‘RTRPLT‘/S,N,RTRPLT/‘RSPLINE‘/S,N,RSPLINE $ Option P1 = ‘DMI’ Extract an element from a matrix. Format: PARAML MAT//’DMI’/ICOL/IROW/S,N,REAL/ S,N,NROW/S,N,IMAG $ Input Data Block: MAT Any matrix (real or complex) Parameters: ICOL IROW REAL IMAG Input-integer-default=1. Column number of matrix element. Input-integer-default=1. Row number of matrix element. Output-real. Real part of matrix element. Output-real. Imaginary part of matrix element, if element is complex. Remarks: If IROW is greater than the number of rows in the matrix, NROW is set to the number of rows, and REAL and IMAG are set to zero. Example: Obtain the value in column 6, row 11 of matrix KGG and save in parameter TERM. 9-440 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Block: TAB Any table Parameters: RECNUM WRDNUM REAL INTGR IMAG CHAR RECNEW INTNEW Input/output-integer. Record number of value. Input/output-integer. Word number of value. Output-real. Real part of value. Output-integer. Integer value. Output-real. Imaginary part of value. Output-character. Character value. The first four characters in CHAR contain the table value. The second four characters are blank. Output-integer. Record number in which table value at WORDNM-th word is nonzero for RECNUM=-1 or changes for RECNUM=-2. Output-integer. Nonzero (RECNUM=-1) or changed (RECNUM=-2) value of WORDNM-th word in RECNEW-th record. Remarks: 1. If RECNUM is greater than the number of records in table, RECNUM is set to -1. All other parameters remain unchanged. 2. If WRDNUM is greater than the number of words in RECNUM record, WRDNUM is set to -1. All other parameters remain unchanged. 3. If RECNUM = -1, the WRDNUM-th word in all records is scanned for a nonzero value. If any exist, INTGR is set to -1. 4. If RECNUM = -2, all records are scanned for changes in the value of the WRDNUM-th word. If the value changes, INTGR is set to -1. NX Nastran DMAP Programmer’s Guide 9-441 Chapter 9 Descriptions of DMAP Modules and Statements Example: 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. SPCFORCE requests are declared in word 135 of the CASECC data block. PARAML CASECC//’DT1’/-1/135//S,N,SPCREQ $ Option P1 = ‘DTI2’ Extract double precision load factor stored in two consecutive words of the ESTNL data block and truncate to single precision. Format: PARAML ESTNL//‘DTI2‘/S,N,RECNUM/S,N,WRDNUM/S,N,REAL $ Input Data Block: ESTNL Material nonlinear element summary table Parameters: RECNUM WRDNUM REAL Input/output-integer. Record number of value. Input/output-integer. First word number of value. Output-real. Real part of value. Remarks: 1. This option is applicable only to the load factor stored in the ESTNL data block. 2. If RECNUM is greater than the number of records in table, RECNUM is set to -1. All other parameters remain unchanged. 3. If WRDNUM is greater than the number of words in RECNUM record, WRDNUM is set to -1. All other parameters remain unchanged. 9-442 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ Input Data Block: TAB Any table Parameters: RECNUM WRDNUM INTGR CHAR2 Input/output-integer. Record number of value. Input/output-integer. First word number of value. Output-integer. Integer value and search flag when RECNUM<0. Output-character. Character value concatenated from the values in the WRDNUM and (WRDNUM+1)-th position. Remarks: 1. If RECNUM is greater than the number of records in table, 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, WRDNUM is set to -1. All other parameters remain unchanged. 3. If RECNUM = -1, the WRDNUM-th word in all records is scanned for a nonzero value. If any exist, INTGR is set to -1. 4. If RECNUM = -2, all records are scanned for changes in the value in the WRDNUM-th word. If the value changes, INTGR is set to -1. Example: Extract the K2PP Case Control DMIG name specification words 139 and 140 of the Case Control data block. PARAML CASECC//‘DTI2C‘/1/139////S,N,K2PP $ NX Nastran DMAP Programmer’s Guide 9-443 Chapter 9 Descriptions of DMAP Modules and Statements Option P1 = ‘IMATCH’ Search for a specific integer value in a table record. Format: PARAML TAB//‘IMATCH‘/RECNUM/IVALUE/S,N,FOUND $ Input Data Block: TAB Any table Parameter: RECNUM IVALUE FOUND Input-integer. Record number for search. Input-integer. Value to search. Output-integer. Set to -1 if value is found, set to +1 otherwise. Example: Search for value of HINDEX in record 1 of KVAL table. HINDEX = HINDEX +1 $ PARAML KVAL//‘IMATCH‘/HINDEX//S,N,NOKVAL $ Option P1 = ‘NAME’ Return the name and purge status of a data block. Format: PARAML /DBNAME/‘NAME‘////S,N,NODB//S,N,NAME $ Input Data Block: None. Output Data Block: DBNAME Any data block Parameters: NODB NAME Output-integer. Set to -1 if the data block is purged. Output-character. Name of the data block. Set to blank if data block is purged. 9-444 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Remarks: 1. This option is useful for checking whether the data block is purged on the CALL statement(s) in the calling subDMAP(s). 2. If DBNAME is specified on the SUBDMAP statement, NAME is the name appearing on the corresponding CALL statement. This process is repeated until 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. Format: PARAML MAT//‘NULL‘////S,N,NULLMAT $ Input Data Block: MAT Any matrix Parameter: NULLMAT Output-integer. Set to -1 if matrix is null. Example: Determine whether 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 $ NX Nastran DMAP Programmer’s Guide 9-445 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Block: PVT Parameter value table Parameters: PARAMi NOPARMi Input-character. Parameter name. Output-integer. If parameter exists, NOPARMi=1, otherwise, -1. Remarks: 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 $ Input Data Block: DB Any data block Parameter: NODB Output-integer. Set to -1 if the data block does not exist. Remarks: See the “DBSTATUS” 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. 9-446 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: PARAML CASECC//‘SET‘/S,N,RECNUM/S,N,WRDNUM/S,N,REAL/ S,N,INTGR//S,N,CHAR/S,N,SETKNTR $ Input Data Block: CASECC Table of Case Control selections Parameters: RECNUM WRDNUM REAL INTGR IMAG CHAR SETKNTR Input/output-integer. Record number. Input/output-integer. Word number of Case Control command selection which references the desired set. Output-real. Real part of value in the set. Output-integer. Integer value in the set. Output-real. Imaginary part in the set. Output-character. Character value in the set. Input/output-integer. Pointer to desired member in set; that is, 1 means the first member in the set, 2 means the second member, and so on. If the set is exhausted, SETKNTR is reset to -1. 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 = ‘TRAILER’ Extract a value from the trailer of a data block. Format: PARAML DB//‘TRAILER‘/WRDNUM/S,N,TVALUE/S,N,REAL/ S,N,USETBIT/SETNAME $ Input Data Block: DB Any data block NX Nastran DMAP Programmer’s Guide 9-447 Chapter 9 Descriptions of DMAP Modules and Statements Parameter: WRDNUM TVALUE REAL NOSET SETNAME Input-integer. Word number of trailer. Output-integer. Trailer value. See Table in Remark 1. If the data block has the format of a USET table, TVALUE is not used; see NOSET. Output-real. Trailer value as a real number. Used only if WRDNUM=6. See Remark 2. Output-integer. USET flag for existence for the set specified by SETNAME. NOSET is set to -1 if the set does not exist. Input-character. Degree-of-freedom set name. Used only if USETBIT=0. See table in Remark 2. Remarks: 1. Meaning of TVALUE: WRDNUM 1 2 3 4 5 6 7 8 9 10 11 12 Meaning of TVALUE Number of columns in matrix Number of rows in matrix Form of the matrix Type of matrix Largest number of nonzero words among all columns Density of the matrix multiplied by 10000 Size in blocks Maximum string length over all strings Number of strings Average bandwidth Maximum bandwidth Number of null columns 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. 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 $ 9-448 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2. Check for the presence of single-point constraints (s-set). PARAML USET//’TRAILER’////S,N,SINGLE//’S’ $ Option P1 = ‘USET’ Search for a specific integer value in a table record. 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 $ Input Data Block: USET Degree-of-freedom set membership table Parameter: SETi NOSETi Input-character. Degree-of-freedom Set name. Output-integer. Degree-of-freedom set existence flag. NOSETi = -1 if set does not exist. NOSETi = number of degrees of freedom in the set if the set exists. Remarks: See TRAILER option for allowable set names. Example: Check for the existence of multipoint constraints (MPCs), rigid elements, and single-point constraints (SPCs). PARAML USET//’USET’//////’M’/S,N,NOMSET/’S’/S,N,NOSSET $ Option P1=‘XYCDB’ Check for the presence of a response types specified on xy plotting commands: XYPAPLOT, XYPEAK, XYPLOT, XYPRINT and XYPUNCH. NX Nastran DMAP Programmer’s Guide 9-449 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Input Data Block: XYCDB Table of x-y plotting commands. Response type. Parameters: RESPi Input-character. The valid names are: • • • • • • • • • • • • • • • • • • 9-450 DISP VELO ACCE SPCF OLOAVG STRE FORC SDIS SVELSACC NFOR ORES BOUT STRAMPCF FPRE FMPF SMPF PMPF LMPF NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements • GMPF See the XYPLOT command in the NX Nastran Quick Reference Guide for a description of the types. NORESPi Output-integer. If the response type was is specified on an xy plotting command, NORESPi=1, otherwise, -1. Example: Check for the presence of the MPCF response type. PARAML XYCDBS//‘XYCDB‘//////‘MPCF‘/S,N,NOMPCF $ 9.244 PARTN Matrix partition To partition [A] into [A11], [A12], [A21] and [A22]: Format: PARTN A,CP,RP/A11,A21,A12,A22/SYM/TYPE/Fll/F2l/F12/F22 $ Input Data Blocks: A CP RP Matrix to be partitioned Column partitioning vector – single precision column vector Row partitioning vector – single precision column vector Output Data Blocks: Aij Matrix partitions. See Remarks below. NX Nastran DMAP Programmer’s Guide 9-451 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: SYM Input-integer-default=-1. SYM chooses between a symmetric partition and one unsymmetric partition. If SYM < 0, {CP} is used as {RP}, and {RP} must be purged. If SYM ≥ 0, {CP} and {RP} are distinct. Input-integer-default=0. Type of output matrices. If TYPE = 0, the type of the output matrices is the type of the input matrix [A]. Input-integer-default=0. Form of [Aij]. See Remarks. TYPE Fij 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: Let NC = number of nonzero terms in {CP}. NR = number of nonzero terms in {RP}. NROWA = number of rows in [A]. NCOLA = number of columns in [A]. {CP} is purged and SYM ≥ 0: PARTN A,,RP/A11,A21,,/1 $ Case 1: [A11] is a (NROWA-NR) by NCOLA matrix. [A21] is a NR by NCOLA matrix. [A12] is not written. [A22] is not written. Case 2: (RP) is purged and SYM ≥ 0: PARTN A,CP,/A11,,A12,/1 $ [A11] is a NROWA by (NCOLA – NC) matrix. [A21] is not written. [A12] is a NROWA by NC matrix. [A22] is not written. Case 3: {RP} is purged and SYM < 0: PARTN A,CP,/A11,A21,A12,A22 $ [A11] is a (NROWA-NC) by (NCOLA-NC) matrix. [A21] is a NC by (NCOLA – NC) matrix. [A12] is a (NROWA – NR) by NC matrix. [A22] is a NC by NC matrix. Case 4: Neither {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. 2. Any of all output data blocks can be purged. 9-452 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 3. If [A] is purged, PARTN causes all output data blocks to be purged. 4. If {CP} is purged, [A] is partitioned as follows: 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: where {CP} is used as both the row and column partitioner. 7. {RP} and {CP} cannot both be purged. 8. Let [A] be an m by n matrix, {CP} be an nx1 vector containing q zero elements; and {RP} be an mx1 vector containing p zero elements. Partition [A11] consists of all elements Aij of [A] for which CPj = RPi = 0.0 in the same order as they appear in [A]. Partition [A12] consists 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] consists 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: NX Nastran DMAP Programmer’s Guide 9-453 Chapter 9 Descriptions of DMAP Modules and Statements The DMAP instruction PARTN A,CP,RP/A11,A21,A12,A22/1 $ creates the real matrices: 2. If, in Example 1, the DMAP instruction was written as PARTN A,CP,/A11,A21,A12,A22/1 $ RP,CP distinct the resulting matrices would be 3. If, in Example 1, the DMAP instruction was written as PARTN A, ,RP/A11,A21,A12,A22/1 $ the resulting matrices would be 9-454 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 4. If and the DMAP instruction was written as PARTN A,RP,/A11,A21,A12,A22/-1 $ the resulting partitions would be 9.245 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 $ Input Data Blocks: CASECC EDT Table of Case Control command images. Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries Table of static loads Static load matrix for the g-set and in the residual structure due to static loads in upstream superelements only Static load matrix for the g-set of the residual structure and applied to its interior points only SLT PGUP PJ Output Data Blocks: CVECT Load combination factor matrix NX Nastran DMAP Programmer’s Guide 9-455 Chapter 9 Descriptions of DMAP Modules and Statements PG1 Combined static load matrix for the g-set and in the residual structure Parameters: NSKIP NVECT MODE Input-integer-default=0. Subcase record number to read in CASECC. Output-integer-default=0. Number of columns in CVECT and PG1. Input-character-no default. Boundary condition change ignore flag. See Remark 2. NONLINEAR Ignore boundary condition changes STATICS Do not ignore boundary condition changes Remarks: 1. Any input data block except CASEXX can be purged. 2. If MODE=‘STATICS‘, all of the records of CASECC, beginning at the NSKIP-th record, are processed until a boundary change occurs. 9.246 PCOPY Tests parallel copy Tests parallel copy in a parallel GINO environment on a multiprocessing machine. Format: PCOPY INDB/ OUTDB1,OUTDB2,OUTDB3,OUTDB4,OUTDB5,OUTDB6,OUTDB7, OUTDB8/ PCOPY1/PCOPY2 $ Input Data Blocks: INDB Any table or matrix Output Data Blocks: OUTDBi Copies of INDB Parameters: PCOPY1 Input-integer-default=-1. Execute parallel copy flag. <0 Perform copy 9-456 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements >0 PCOPY2 Do not perform copy Input-integer-default=1. Parallel copy method. >0 <0 Perform standard copy using CPYFIL Perform copy using single buffer for input and output Remarks: PCOPY is a reserved for internal development purposes and should not be used. 9.247 PLOT Creates a table of plot instructions Creates a table of plot instructions for undeformed and deformed shapes and writes the table to Fortran unit 14. Format: PLOT Input Data Blocks: PLTPAR GPSETS ELSET CASECC BGPDT PUGS USET PUGD ECT GPECT Table of plot parameters and plot control Table of grid point sets related to the element plot sets Table of element plot set connections Table of Case Control command images. Basic grid point definition table. Matrix of translational displacements in static analysis Degree-of-freedom set membership table for g-set Matrix of translational displacements in dynamic analysis Element connectivity table Grid point element connection table NX Nastran DMAP Programmer’s Guide 9-457 Chapter 9 Descriptions of DMAP Modules and Statements OES1 Table of element stresses or strains in SORT1 format Output Data Blocks: PLOTMSG Table of user informational messages generated during the plot process Parameters: NGP LUSET JPLOT DEFORMED Input-integer-no default. Number of grid points and scalar points in the structure Input-integer-no default. The number of degrees-of-freedom in the g-set. If LUSET=0, its value is extracted from the trailer of BGPDT. Input-integer-no default. Number of element plot sets. Set to -1 if there are none. 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, only undeformed shapes can be drawn. 2. If either PUGS or PUGD is purged, that type of deformed shape is not drawn. 3. If GPECT or OES1 are purged, contour plots or outlines are not drawn. 4. The plot instructions are written to Fortran unit 14. 5. If USET and ECT are input, the plot labels the grid points with numbers indicating the degrees-of-freedom constrained to zero. For example, a label of 126 indicates that the grid is constrained in the first and second translational and third rotational degrees-of-freedom. Also, the elements are labeled with their property identification numbers. These features are available in undeformed plotting only. 9.248 PLTHBDY Supports plotting of CHBDYi elements Updates the geometry and connectivity tables to support plotting of CHBDYi elements. 9-458 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: PLTHBDY GEOM2,ECT,EPT,BGPDT,CSTM/ PECT,PBGPDT/ S,N,NHBDY/MESH $ Input Data Blocks: GEOM2 ECT BGPDT CSTM Table of Bulk Data entry images related to element connectivity and scalar points Element connectivity table Basic grid point definition table Table of coordinate system transformation matrices Output Data Blocks: PECT PBGPDT Element connectivity table updated to support plotting CHBDYi elements Basic grid point definition table updated to support plotting CHBDYi elements Parameters: NHBDY MESH Output-integer-no default. Number of CHBDYi elements. Set to -1 if none exist. Input-character-no default. Shading summary print flag. Set to ‘YES’to print summary; ‘NO’otherwise. 9.249 PLTSET Generates element sets for plotting Format: PLTSET NX Nastran DMAP Programmer’s Guide 9-459 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: PCDB POSTCDB BGPDT PBGPDT ECT PECT GEOM2 Table of model (undeformed and deformed) plotting commands Table of commands from the OUTPUT(POST) section of Case Control Basic grid point definition table Basic grid point definition table updated to support plotting CHBDYi elements Element connectivity table Element connectivity table updated to support plotting CHBDYi elements Table of Bulk Data entry images related to element connectivity and scalar points Output Data Blocks: PLSETMSG PLTPAR GPSETS ELSET PELSET Table of user informational messages generated during the definition of element plot sets Table of plot parameters and plot control Table of grid point sets related to the element plot sets Table of element plot set connections P-element set table, contains SETS DEFINITIONS Parameters: NGP JPLOT ECTYPE Output-integer-no default. Number of grid points and scalar points in the structure. Output-integer-no default. Number of element plot sets. Set to -1 if there are none. Input-integer-default=0. Type of element connectivity input and plot set output: 0 1 2 ECT and ELSET GEOM2 and ELSET ECT and PELSET Remarks: PCDB can be purged if ECTYPE>0. 9-460 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ 9.250 PRESOL Prepares special tables for the distributed parallel solution Prepares special tables for the distributed parallel solution using the domain decomposition method. Format: PRESOL GEQMAP,USET,SIL,PARFIL,PFA,PJXL/ EQMAP,GAPAR,PARTF,PFA1/ UNUSED1/UNUSED2 $ Input Data Blocks: GEQMAP USET SIL PARTVEC PFA PJXL Table of grid based local equation map indicating which grid resides on which processors/partitions for domain decomposition Degree-of-freedom set membership table for g-set Scalar index list Partitioning vector with values of 1.0 at the rows corresponding to degrees-of-freedom that are locally constrained Static load matrix with partial boundary loads in the a-set Static load matrix for boundary load contribution from the residual structure Output Data Blocks: EQMAP GAPAR Table of degree-of-freedom global-to-local maps for domain decomposition 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. Updated PARTVEC indicating for all constraints; local and boundary Updated PFA with complete boundary loads PARTVEC1 PFA1 NX Nastran DMAP Programmer’s Guide 9-461 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: Unusedi Input-integer-default=0. Unused and can be unspecified. 9.251 Format: PROJVER PROJVER Set or query project identification numbers //PRJVEROP/S,N,PROJNO/S,N,VERSION/S,N,EXISTS $ Input Data Blocks: None. Output Data Blocks: None. Parameters: PRJVEROP Input-character-no default. Operation name. ‘GET’ ‘NEXT’ ‘SET’ ‘LAST’ ‘RESTART’ PROJNO VERSION EXISTS Get current project and version Get next non-deleted project and version Set current project and version Get the last (bottom) project and version Get restart project and version Input/output-integer-no default. Project number. Input/output-integer-no default. Version number. Output-character-no default. Project and version status. ‘EXISTS’ ‘DELETED’ ‘NONE’ If project and version exists If project and version is deleted If project and version never existed 9.252 PRTMSG Prints plotting information messages 9-462 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Prints user information messages related to plot set definition and plotting. Format: PRTMSG Input Data Blocks: PLOTMSG PLSETMSG Table of user informational messages generated during the plot process Table of user informational messages generated during the definition of element plot sets Output Data Blocks: None. Parameter: PDRMSG Input-integer-default=1. Message print flag. Set to 0 to suppress printout. 9.253 PRTPARM Parameter and DMAP message printer Prints non-NDDL parameter values and DMAP messages. For NDDL parameters (see TYPE statement), use the MESSAGE statement. Format: PRTPARM //a/b/c/SUBDMAP $ Input Data Blocks: None. Output Data Blocks: None. Parameters: a Input-integer-default=0. a=0 requests the print of a single parameter value or all parameter values. a>0 requests the print of diagnostic messages 4401 through 4425. NX Nastran DMAP Programmer’s Guide 9-463 Chapter 9 Descriptions of DMAP Modules and Statements b c SUBDMAP Input-character-default = ‘XXXXXXXX’ Name of a parameter enclosed by single quotation marks. See Remark 1. Input-integer-default=0. If c=1, parameters are sorted alphabetically. Input-character-default=blank. The name of a subDMAP. Remarks: 1. As a parameter printer, use a = 0. There are two options: • If b is equal to a parameter name enclosed by quotation marks, the value of that parameter in the subDMAP identified by SUBDMAP is printed. b must be a non-NDDL parameter (see TYPE statement). Example: PRTPARM //0/‘LUSET’$ • If b = ‘XXXXXXXX‘, the values of all variable and constant parameters in the Variable Parameter Table of the subDMAP identified by SUBDMAP are printed. Examples: PRTPARM // $ Unsorted PRTPARM ////1 $ Sorted If no value is entered for SUBDMAP, the parameter value or values (depending on b) is for the current subDMAP. Otherwise, the value or values is for the subDMAP identified by SUBDMAP. 2. As a DMAP message printer, parameter is nonzero. 3. Meaningless values of a, b, and SUBDMAP result in diagnostic messages from PRTPARM. 9.254 PURGEX Explicit data block purge Flags a data block as empty. Format: PURGEX /DB1,DB2,DB3,DB4,DB5/PARM $ Output Data Blocks: DBi Any data block Parameter: PARM Input-integer-default=0. 9-464 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements < 0 ≥ 0 Data blocks are deleted and marked empty No action is taken Remarks: 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, any existing data is deleted and the data block is marked as empty. If the data block has not been previously output from a module, it is simply 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 to avoid the execution of the EMA module on restart. PURGEX /MGGX,,,,/NOMGGX $ 9.255 PVT Sets parameter values Sets parameter values from Case Control and/or Bulk Data sections. Format: PVT PVT,CASECC/PVTS/LOADFLT $ Input Data Blocks: PVT CASECC Parameter value table from IFP module (Bulk Data PARAM entries) Table of Case Control Command images Output Data Block: PVTS Parameter Variable Table from Case Control merged with the Bulk Data input parameters Parameter: LOADFLT Logical-input-default=TRUE. If LOADFLT = TRUE, all parameters that appear in the Parameter Defaults Table but do not appear in the PVT or CASECC data block, are added to the PVTS data block. See Remark 4. NX Nastran DMAP Programmer’s Guide 9-465 Chapter 9 Descriptions of DMAP Modules and Statements 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 can be purged. If the input data block is purged, the user input parameter settings do not contain parameters from the input. If both input data blocks are purged, and LOADFLT is FALSE, no values are entered. 3. The output data block can be purged. The PVT module always internally updates the user input parameters. The output data block is primarily used for restart purposes. • • • First, the default parameters are added if requested. Next, the PVT user input parameters from the Bulk Data Section are set. Next, 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. Lastly, 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. 9.256 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/ PSDF,AUTO, OUGPSD2,OUGATO2,OUGRMS2,OUGNO2,OUGCRM2, OPGPSD2,OPGATO2,OPGRMS2,OPGNO2,OPGCRM2, OQGPSD2,OQGATO2,OQGRMS2,OQGNO2,OGGCRM2, OESPSD2,OESATO2,OESRMS2,OESNO2,OESCRM2, OEFPSD2,OEFATO2,OEFRMS2,OEFNO2,OEFCRM2, OEEPSD2,OEEATO2,OEERMS2,OEENO2,OEECRM2, OQMPSD2,OQMATO2,OQMRMS2,OQMNO2,OGMCRM2, OCPSDF,OCCORF/ S,N,NORAND/RMSINT/CPLX $ Input Data Blocks: XYCDB Table of x-y plotting commands 9-466 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DIT PSDL OUG2 OPG2 OQG2 OES2 OEF2 CASECC OSTR2 OQMG2 RCROSSL OFMPF2M OSMPF2M OLMPF2M OPMPF2M OGPMPF2M Table of TABLEij Bulk Data entry images Power spectral density list Table of displacements in SORT2 format Table of applied loads in SORT2 format Table of single point forces of constraint in SORT2 format Table of element stresses or strains in SORT2 format Table of element forces in SORT2 format Table of Case Control command images Table of element strains in SORT2 format Table of multipoint forces of constraint in SORT2 format Table of RCROSS Bulk Data entry images Table of fluid modal participation factors by natural modes in SORT2 format Table of structural modal participation factors by natural modes in SORT2 format Table of load modal participation factors by natural modes in SORT2 format Table of panel modal participation factors by natural modes in SORT2 format Table of panel grid modal participation factors by natural modes in SORT2 format Output Data Blocks: PSDF AUTO OUGPSD2 OUGATO2 OUGRMS2 OUGNO2 OUGCRM2 OPGPSD2 OPGATO2 Power spectral density table Autocorrelation function table Table of displacements in SORT2 format for the PSD function Table of displacements in SORT2 format for the autocorrelation function Table of displacements in SORT2 format for the RMS function Table of displacements in SORT2 format for the NO function Table of displacements in SORT2 format for the cross correlation function Table of applied loads in SORT2 format for the PSD function Table of applied loads in SORT2 format for the autocorrelation function NX Nastran DMAP Programmer’s Guide 9-467 Chapter 9 Descriptions of DMAP Modules and Statements OPGRMS2 OPGNO2 OPGCRM2 OQGPSD2 OQGATO2 OQGRMS2 OQGNO2 OQGCRM2 OESPSD2 OESATO2 OESRMS2 OESNO2 OESCRM2 OEFPSD2 OEFATO2 OEFRMS2 OEFNO2 OEFCRM2 OEEPSD2 OEEATO2 OEERMS2 OEENO2 OEECRM2 OQMPSD2 OQMATO2 OQMRMS2 Table of applied loads in SORT2 format for the RMS function Table of applied loads in SORT2 format for the NO function Table of applied loads in SORT2 format for the cross correlation function Table of single point forces of constraint in SORT2 format for the PSD function Table of single point forces of constraint in SORT2 format for the autocorrelation function Table of single point forces of constraint in SORT2 format for the RMS function Table of single point forces of constraint in SORT2 format for the NO function Table of single point forces of constraint in SORT2 format for the cross correlation Table of element stresses in SORT2 format for the PSD function Table of element stresses in SORT2 format for the autocorrelation function Table of element stresses in SORT2 format for the RMS function Table of element stresses in SORT2 format for the NO function Table of element stresses in SORT2 format for the cross correlation function Table of element forces in SORT2 format for the PSD function Table of element forces in SORT2 format for the autocorrelation function Table of element forces in SORT2 format for the RMS function Table of element forces in SORT2 format for the NO function Table of element forces in SORT2 format for the cross correlation function Table of element strains in SORT2 format for the PSD function Table of element strains in SORT2 format for the autocorrelation function Table of element strains in SORT2 format for the RMS function Table of element strains in SORT2 format for the NO function Table of element strains in SORT2 format for the cross correlation function Table of multipoint forces of constraint in SORT2 format for the PSD function Table of multipoint forces of constraint in SORT2 format for the autocorrelation function Table of multipoint forces of constraint in SORT2 format for the RMS function 9-468 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OQMNO2 OQMCRM2 OCPSDF OCCORF Table of multipoint forces of constraint in SORT2 format for the NO function Table of multipoint forces of constraint in SORT2 format for the cross correlation function Output table of cross-power-spectral-density functions Output table of cross-correlation functions Parameters: NORAND RMSINT CPLX Output-integer-default=-1. Set to -1 if no random analysis is requested; 0 otherwise. Input-character-default=‘LINEAR’ Power-spectral-density function interpolation option. A log-log option can be selected with RMSINT=‘LOGLOG’ Input-integer-default=0. Set to 1 if complex data is requested. Set to 0 for real data. 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. 9.257 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 $ Input Data Blocks: LLL ULL KLR KRR Lower triangular factor/diagonal for the l-set from KLL Upper triangular factor/diagonal for the l-set from KLL Stiffness matrix partition (l-set by r-set) from KTT Stiffness matrix partition (r-set by r-set) from KTT NX Nastran DMAP Programmer’s Guide 9-469 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Block: DM Rigid body transformation matrix for the r-set to the l-set Parameters: None. Remarks: 1. The rigid body transformation matrix is computed from: Equation 9-27. 2. The rigid body error ratio, e, is computed from: Equation 9-28. 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 Equation 9-29. 3. ULL can be purged if KLL is symmetric. 9.258 RBMG4 Computes rigid body mass matrix Format: RBMG4 DM,MLL,MLR,MRR/ MR $ 9-470 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: DM MLL MLR MRR Rigid body transformation matrix for the r-set to the l-set Mass matrix reduced to the l-set Mass matrix partition (l-set by r-set) from MTT Mass matrix partition (r-set by r-set) from MTT Output Data Blocks: MR Rigid body mass matrix (r-set by r-set) Parameters: None. Remarks The rigid body mass matrix is computed from: Equation 9-30. 9.259 READ Extracts real symmetric system eigenvaules Extracts eigenvalues from a real symmetric system. Solves the following equations for eigenvalues and their associated eigenvectors: NX Nastran DMAP Programmer’s Guide 9-471 Chapter 9 Descriptions of DMAP Modules and Statements Format: READ Input Data Blocks: KAA K matrix in MAA M matrix in or Kd matrix in MR DAR DYNAMIC USET CASECC PARTVEC Rigid body mass matrix Rigid body transformation matrix Eigenvalue Extraction Data (output by IFP module) Degree-of-freedom set membership table Case Control Data Table (selects EIGR, EIGRL, or EIGB entries, output by IFP module) Partitioning vector with values of 1.0 at the rows corresponding to degrees of freedom which were eliminated in the partition to obtain KAA and MAA. Required for maximum efficiency. See SETNAME parameter description below. Scalar index list. Required for maximum efficiency. SIL 9-472 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements VACOMP Partitioning vector of size of a-set with a value of 1.0 at the rows corresponding to r-set degrees-of-freedom. The USET table can be specified here as well. If VACOMP is purged and DAR does not have the same number of rows as KAA, the partitioning vector is determined from the size of MR. Local f-size partitioning vector with 1.0 for the local boundary‘s s-set degrees-of-freedom. Required only for geometric domain decomp. Starting vector(s) for Lanczos method only Table of degree-of-freedom global-to-local maps for domain decomposition. Required only for geometric domain decomp. Lower triangular factor from decomposition of KAA. Use to enhance shift logic for buckling eigenvalue extraction. 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. Equivalence between external and internal grid identification numbers. Required for maximum efficiency. 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. SPCCOL INVEC EQMAP LLL VFO1 EQEXIN GAPAR Output Data Blocks: LAMA PHA OEIGS MI LAMMAT OUTVEC Normal modes eigenvalue summary table Normal modes eigenvector matrix in the a-set Real eigenvalue extraction report Modal mass matrix Diagonal matrix containing eigenvalues on the diagonal (Lanczos only) Last vector block (Lanczos only) Parameters: FORMAT Input-Character-no default. If FORMAT≠ ’MODES’, READ solves a buckling problem, that is, ([K] + λ[Kd using EIGB Bulk Data. However, it is the DMAP writer’s responsibility to multiply Kd by -1 before entering the READ module. Output-integer-no default. NEIGV is the number of eigenvectors found. 0 No eigenvectors found NEIGV NX Nastran DMAP Programmer’s Guide 9-473 Chapter 9 Descriptions of DMAP Modules and Statements >0 <0 NSKIP FLUID SETNAME NEIGV eigenvectors found NEIGV eigenvectors found but there was an error encountered during the extraction Input-integer-default=1. The method used by READ is taken from the NSKIP record of CASECC. Input-logical-default=FALSE. If FLUID = TRUE, the EIGRL or EIGR entry is selected from METHOD(FLUID) Case Control command. 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, PARTVEC must be specified. Input-integer-default=0. Alternate set identification number. If SID=0, the set identification number is obtained from the METHOD command in CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMIC. If SID>0, METHOD command is ignored and the EIGR, EIGB, or EIGRL is selected by this parameter value. All subsequent parameter values (METH, F1, and so on) are ignored. If SID=-1, both the METHOD command and all EIGR, EIGB, or EIGRL entries are ignored and the subsequent parameter values (METH, F1, and so on) are used to control the eigenvalue extraction. If SID=-2, take action similar to SID=0 except fields on the Case Control selection of EIGR/EIGRL can be overridden by parameters F1 through NORM described below. SID METH Input-character-default=‘LAN’ If SID<0, METH specifies the method of eigenvalue extraction. LAN INV SINV GIV MGIV HOU MHOU AGIV AHOU Lanczos Inverse power Inverse power with Sturm sequence Givens (tridiagonalization) Modified Givens Householder Modified Householder Automatic selection of GIV or MGIV Automatic selection of HOU or MHOU F1 Input-real-default=0.0. The lower frequency bound. 9-474 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements F2 NE Input-real-default=0.0. The upper frequency bound. The default value of 0.0 indicates machine infinity. 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 using. NE default changed from 0 to 20 ND MSGLVL Input-integer-default=0. The number of desired eigenvalues. Input-integer-default=0. The level of diagnostic output for the Lanczos method only. 0 1 2 3 4 No output Warning and fatal messages Ssummary output Detailed output on cost and convergence Detailed output on orthogonalization MAXSET SHFSCL NORM Input-integer-default=0. Vector block size for Lanczos method only. Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL must be greater than 0.0. Input-character-default=’ ’ Method for normalizing eigenvectors. By default (or NORM=‘MASS‘), MASS normalization is performed. NORM=‘MAX’selects normalization by maximum displacement. Inpput-logical-default=TRUE. Lanczos eigenvalue summary print flag. Input-real-default=1.0E7. Minimum value of factor diagonal ratio which causes termination of decomposition. PRTSUM MAXRATIO 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 an 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, and so on. • SID=0 - DYNAMIC and CASECC data blocks must be specified. METHOD command and EIGR, or EIGRL, entries must be specified in the input file. READ KAA,MAA,,,DYNAMIC,,CASECC,,,,/ LAMA,PHA,MI,OEIGS,/ FORMAT/S,N,NEIGV $ NX Nastran DMAP Programmer’s Guide 9-475 Chapter 9 Descriptions of DMAP Modules and Statements • SID>0 - Only DYNAMIC data blocks must be specified. The EIGR or EIGRL entry is selected by the SID parameter. The CASECC data block can be purged and is ignored. READ KAA,MAA,,,DYNAMIC,,,,,,/ LAMA,PHA,MI,OEIGS,/ FORMAT/S,N,NEIGV////SID $ • SID<0 - DYNAMIC and CASECC are not required. SID=-1 and METH through NORM parameters are specified. For more detailed information on parameters F1 through NORM, refer to the descriptions of Bulk Data entries EIGR and EIGRL in the NX Nastran Quick Reference Guide. The CASECC and DYNAMIC data blocks can be purged and are ignored. READ KAA,MAA,,,,,,,,,/ LAMA,PHA,MI,OEIGS,/ FORMAT/S,N,NEIGV////-1// F1/F2/NE/ND/MSGLVL/MAXSET/SHFSCL/NORM $ 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 calculates 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. READ KXX,MXX,MR,DXR,DYNAMIC,USET,CASECC,PARTVEC,SIL, ,,LLL,EQEXIN/ LAMA,PHA,MI,OEIGS/ FORMAT/S,N,NEIGV//FLUID $ • Obsolete r-set processing as in Version 70: 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. READ KXX,MXX,MR,DMX,DYNAMIC,USET,CASECC,PARTVEC,SIL, VACOMP,,LLL,EQEXIN/ LAMA,PHA,MI,OEIGS/ FORMAT/S,N,NEIGV//FLUID $ 9-476 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UGS recommends that you no longer use this obsolete format. Provisions for it can 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 can be indefinite and MAA must be at least positive semidefinite. For the unmodified tridiagonal methods (for example, HOU) KAA can be indefinite, but MAA must be non-singular. For the modified and auto tridiagonal methods (for example, MHOU and AHOU), MAA can be singular when [KAA + lambda*MAA] is non-singular. Lambda is an internally calculated shift. The matrix sum is singular or approaches 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 can also be input if the APPEND mode is being used. 6. LAMA and OElGS are suitable for OFP output. 7. MI cannot be purged. 8. Parallel processing in this module (Householder method only) is selected with the NASTRAN statement keyword PARALLEL (or SYSTEM(107)). (See the NX Nastran Quick Reference Guide. 9. If an r-set is present and special processing of rigid body modes is desired, UGS recommends that DAR have the same number of rows as KAA. If not, either MR, USET, or VACOMP should be specified. 10. For more detailed information on parameters F1 through NORM, refer to the descriptions of the “EIGR” and “EIGRL” Bulk Data entries in the NX Nastran Quick Reference Guide. 11. For the Lanczos method: • By default, the Lanczos method uses sparse matrix methods. To use regular matrix methods, specify SPARSE = 1 on the NASTRAN statement or specify PUTSYS (126,1) just prior to the READ module. In vibration analysis, MAA must be positive semidefinite. In buckling analysis, KAA must be positive semidefinite. For either type of analysis, the other input matrix can be indefinite. Performance-enhancing options can be requested on system cells 193 through198. Use the NASTRAN statement or the PUTSYS DMAP statement. See the NX 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, specify NASTRAN SYSTEM(273)=1 in the File Management Section or PUTSYS(1,273) in the DMAP before the READ module. • • • NX Nastran DMAP Programmer’s Guide 9-477 Chapter 9 Descriptions of DMAP Modules and Statements • For maximum efficiency in the Lanczos method, UGS recommends that the USET, SIL, and EQEXIN data blocks and SETNAME parameters are specified. If the size of KAA is not the same as the size of the set indicated by SETNAME, PARTVEC should also be specified. 12. If SID=-2, 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, a "QL" Householder eigensolution is performed. If the problem cannot fit in memory, 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 automatically switches to AHOU when the size of the problem is less than or equal to NE. if METH=‘HOU‘, ‘MHOU‘, and ‘AHOU,’the program automatically switches to the "QL" solution if the problem fits in memory. Examples: 1. Suppose you have a matrix [A] for which you want to extract eigenvalues via the classical equation [A − λI] {u} = 0. Presuming that [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 is sufficient: PARAML MATGEN READ A//’TRAILER’/1/S,N,NCOLA $ ,/IDEN/1/NCOLA $ A,IDEN,,,DYNAMICS,,CASECC,,,,,,,,/LAMA,VECTOR,MI, OEIGS,/’MODES’/S,N,NEIGS/1 $ OFP LAMA,OEIGS//$ IF (NEIGS > -1) MATPRN VECTOR// $ 2. Suppose that you now want to 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// $ 9.260 RESTART Data block comparison Compares two data blocks and invokes dependencies. Format: RESTART DB1,DB2,DLSTIN/DLSTOUT/ INVOKE/SPEXP/DPEXP/NDDLNAM $ 9-478 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: DBi DLSTIN Data blocks to be compared A list of data blocks and the associated pathnames. DLSTIN was built as DLSTOUT during prior executions of the RESTART module. DLSTIN is used to invoke the same restart dependencies, but with different qualifiers, as done during previous RESTART comparisons. Output Data Block: 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, DLSTOUT contains the list of data blocks deleted (or marked for deletion during this) from prior executions of the module. Parameters: INVOKE Input-logical-default=FALSE. If INVOKE = TRUE, restart deletions are performed. If INVOKE = FALSE (default), no deletions are performed, but data blocks are marked within DLSTOUT. Input-integer-default=6. Single-precision tolerance exponent. Two single-precision numbers x and y are considered equal if SPEXP DBEXP Input-logical-default=12. Double-precision tolerance component. Two double-precision numbers, x and y are considered equal if NDDLNAM Input-character-default=’ ’ NDDL is the name of the DATABLK statement to use for a description in the comparison that overrides the name of DB1. Remarks: 1. Any or all input data blocks can 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, RESTART also deletes data blocks according to the data dependencies. 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, all intersecting qualifiers use the current value and the remaining nonintersecting qualifiers use the wildcard (*) to determine deletion. NX Nastran DMAP Programmer’s Guide 9-479 Chapter 9 Descriptions of DMAP Modules and Statements Example: In this example, GEOM1 and GEOM2 are compared to the restart versions defined in the DBVIEW statement. Changes are marked within the HIST file. Deletions are performed after SEID is set. FILE HIST=APPEND $ PROJVER //’RESTART’/S,N,RESPRJ/S,N,RESVER/S,N,EXIST $ DBVIEW GEOM1R = GEOM1 (WHERE VERSION=RESVER) $ DBVIEW GEOM2R = GEOM2 (WHERE VERSION=RESVER) $ RESTART GEOM1,GEOM1R,/HIST/ $ RESTART GEOM2,GEOM2R,/HIST/ $ SEID = SEDWN $ RESTART ,,,HIST//TRUE $ 9.261 RMAXMIN Searches result tables during SOL 12 and 112. Searches stress, force and displacement tables during SOL 12 and 112 for extreme values. Format: RMAXMIN OUGV1,OEF1,OES1/OUGV1MX,OEF1MX,OES1MX/IFABS,IAPPN,IDIAG $ Input Data Blocks: OUGV1 OEF1 OES1 Table of displacements or accelerations in SORT1 format Table of element forces in SORT1 format Table of element stress in SORT1 format Output Data Blocks: OUGV1MX OEF1MX OES1MX Displacement output datablock Force output datablock Stress output datablock Parameters: IFABS Input parameter to determine how output is calculated: IFABS = 0 algebraic maximum values calculated. (Default)IFABS = 1 absolute maximum values calculated. IFABS = 2 algebraic minimum values calculated. Input parameter to modify how approach code is written: IAPPN = 0 write approach code found in datablock header. (Default)IAPPN > 0 write approach code iappn. IAPPN 9-480 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements IDIAG Determines what diagnostic output is written to f06 file: IDIAG = 0 send no diagnostic output to .f06 file. (Default)IDIAG ≥ 1 send brief summary of module input to .f06 file. IDIAG ≥ 2 send operations trace to .f06 file. IDIAG ≥ 3 send i/o statistics to .f06 file. IDIAG ≥ 4 send grid point statistics to .f06 file. IDIAG ≥ 5 not used. IDIAG ≥ 6 dump data read to .f06 file. Remarks: 1. If PARAM POST is not enabled, the output datablocks OUGV1MX, OEF1MX, and OES1MX are not written to the .op2 file. To send results to the .op2 file, you must supply the following alter: COMPILE SUBDMAP=SEDRCVR ALTER RMAXMIN OUTPUT2 OES1MX,OEF1MX,OUGV1MX,// \$ If PARAM POST is enabled, the default is to send the output datablocks to the .op2 file, but not the transient results OUGV1, OEF1 and OES1. To send the transient results to the .op2 file, you must add the following to your Bulk Data: PARAM, RMXTRAN,YES 2. Since you can use the RMAXMIN case control command only in SOL 12 and 112, you can provide a DMAP alter for other solution sequences to generate the output datablocks OUGV1MX, OEF1MX and OES1MX. 9.262 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 $ Input Data Blocks: EST MPOOL MUGNI KGGNL MPT DIT Element summary table Table of RADSET, RADLST, and RADMTX Bulk Data entry images Temperature matrix for stiffness update Conduction matrix in g-set for material nonlinear elements only Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images NX Nastran DMAP Programmer’s Guide 9-481 Chapter 9 Descriptions of DMAP Modules and Statements BGPDT SIL USET Basic grid point definition table Scalar index list Degree-of-freedom set membership table for g-set Output Data Blocks: RDEST RECM RGG KGGNL1 Radiation element summary table Radiation exchange coefficient matrix Radiation transfer matrix in the g-set Conduction matrix in g-set for material nonlinear elements only and updated for radiation Parameters: TABS Input-real-default=0.0. Absolute temperature conversion. For example, this is set to 273.16 when specifying temperatures in Celsius, and is set to 459.69 when specifying temperatures in Fahrenheit. Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input/output-integer-default=-1. Radiation flag. 2 -1 1 2 3 LUSET No radiation Initial radiation Single band radiation with constant emissivity Radiation with temperature dependent emissivity Multiple band radiation with constant emissivity SIGMA NORADMAT Input-integer-no default. The number of degrees-of-freedom in the g-set. Remarks: If KGGNL is not purged, LUSET is determined from KGGNL. 9.263 ROTCDA Generates output data for Campbell’s diagram from rotor dynamic analysis. Data is written to OP2 or punch file. Also, generates a comma-separated ASCII file that can be imported into Microsoft Excel to display Campbell’s diagrams. 9-482 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: ROTCDA OMGMTDR,CLAMTRDR,CLAMTIDR,WHRDIR,SLAMTRDR, SLAMTIDR,SWHRDIR/CDDATA/ ROTGPF/ROTCSV/IREFS/IRSPEED/IRFREQ/ROTPRNT $ Input Data Blocks: OMGMTDR CLAMTRDR CLAMTIDR WHRDIR SLAMTRDR SLAMTIDR SWHRDIR Vector of rotor speeds. Real part of solutions. Imaginary part of solutions. Whirl directions. Real part of synchronous solution. Imaginary part of synchronous solution. Whirl directions of synchronous solution. Output Data Blocks: CDDATA Output table of solution data for Campbell’s diagram. Parameters: ROTGPF ROTCSV IREFS IRSPEED IRFREQ ROTPRNT Output unit for GAROS post-processing file. Output unit for comma-separated Excel file. Reference system (1: fixed, 2: rotating) Unit for speed (1: rpm, 2: Hz, 3: rad/sec) Unit for frequency (1:rpm, 2: Hz, 3: rad/sec) Flag for extra printing 9.264 Format: ROTCZG ROTCZG Calculates the gyroscopic/coriolis matrix and centrifugal matrix in the g-set for a rotor. SILS,CSTMS,BGPDTS,MGGDI,XYZ/CGGR,ZGGR/ IREFS/IFSTEIN/RCORD $ NX Nastran DMAP Programmer’s Guide 9-483 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: SILS CSTMS BGPDTS MGGDI XYZ Scalar index list. Coordinate system transformation matrices. Basic grid point definition table. Diagonal mass matrix input as vector. g-set by 3 matrix of x,y,z coordinates transformed to the rotor system. Output Data Blocks: CGGR ZGGR Coriolis/gyroscopic, velocity-dependent matrix of size g-set. Centrifugal, displacement-dependent matrix of size g-set. Parameters: IREFS IFSTEIN RCORD Reference system (1: fixed, 2: rotating) Flag for calculating Steiner’s terms (1: calculate) Coordinate system ID for rotor definition. 9.265 ROTUTL Performs various utility functions for rotor dynamics. Format: ROTUTL I1,I2,I3,I4,I5/O1,O2/IOPT1/IOPT2/IOPT3/IOPT4/ROPT5 $ Input Data Blocks: IOPT1=1 Calculate whirl direction I1=real part of modal matrix I2=imaginary part of modal matrix I3, I4, I5 are not used IOPT1=2 Print small, dense, generalized matrices in a more readable way. I1 through I5 = up to 5 matrices to be printed 9-484 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements IOPT1=3 Edit a table I1 = input table I2, I3, I4, I5 are not used IOPT1=4 IOPT1=5 Not used at this time. Print the results of synchronous analysis I1=real part of eigensolution I2=imaginary part of eigensolution I3=whirl direction vector found with ROTUTL using IOPT1=1 I4, I5 are not used Output Data Blocks: IOPT1=1 O1=whirl directions for each solution O2 is not used IOPT1=2 IOPT1=3 O1,O2 are not used O1=modified table O2 is not used IOPT1=4 IOPT1=5 Not yet implemented. O1,O2 are not used Parameters: IOPT1 IOPT1=1 Function controlling parameter (see above) IOPT2, IOPT3, IOPT4 are not used ROPT5=epsilon value for decision of whirl IOPT1=2 IOPT1=3 IOPT2, IOPT3, IOPT5, ROPT5 are not used IOPT2=record number IOPT3=word number IOPT4=value to be placed in the specified record/word position ROPT5 is not used IOPT1=4 Not yet implemented. NX Nastran DMAP Programmer’s Guide 9-485 Chapter 9 Descriptions of DMAP Modules and Statements IOPT1=5 IOPT2=reference system (1:fixed, 2:rotating) IOPT3=unit for rotor speed (1:RPM, 2: Hz, 3: rad/sec) IOPT4, ROPT5 are not used 9.266 RSPEC Converts transient response motion for plotting Converts transient response motion to response spectra output suitable for plotting. Format: RSPEC FRL,OUG2,SPSEL/ OXRESP/ S,N,SPSELREC $ Input Data Blocks: FRL OUG2 SPSEL Frequency response list Table of displacements in SORT1 format from transient response analysis Table of response spectra generation correlation selections Output Data Blocks: OXRESP Table of response spectra in SORT2 format Parameters: SPSELREC Input/output-integer-default=0. Last record number processed in SPSEL. Set to -1 when processing last record. Example: Excerpt from subDMAP SEDRCVR: DO WHILE ( RECORD<>-1 ) $ RSPEC FRL,OUGV2,SPSEL/OXRESP/S,N,RECORD $ IF ( RECORD>=0 ) THEN $ IF ( RSPRINT>=0 ) OFP OXRESP//S,N,CARDNO $ XYTRAN XYCDBDR,OXRESP,,,,/XYPLTSS/‘RSPEC‘/‘PSET‘/ S,N,PFILE/S,N,CARDNO/S,N,NOXYPLT/TABID $ IF ( NOXYPLT>=0 ) XYPLOT XYPLTSS// $ ENDIF $ RECORD>=0 ENDDO $ RECORD<>-1 9-486 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.267 SCALAR Matrix element extractor Extracts a specified element from a matrix for use as a parameter. Format: SCALAR A//S,N,NROW/S,N,NCOL/S,N,VALUED $ Input Data Block: A Any matrix (real or complex) Output Data Blocks: None. Parameters: IROW ICOL VALUED Input/output-integer-default=1. Row number of element to be extracted from [A]. See Remark 4. Input/output-integer-default=1. Column number of element. See Remark 4. Output-complex double precision-default=(0.D0,0.D0). Contents of element at IROW-th row and ICOL-th column in matrix [A]. Remarks: 1. If the input is purged, the module returns with a VALUE = (0.,0.). 2. See also the PARAML A//’DMI’ option. 3. Prior to Version 2001, VALUED was a single precision parameter. To convert an old DMAP that uses the SCALAR module for Version 2001, see Example 2. 4. If IROW (or ICOL) is greater than the number of rows (or columns) in A, IROW or (ICOL) is 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 assign it to the parameter VALUE. SCALAR A//1/2/S,N,VALUE $ 2. Convert a pre-Version 2001 SCALAR module call to Version 2001. SCALAR A//1/2/S,N,CDVALUE $ $ Add following statements TYPE PARM,,CS,N,CSVALUE $ CSVALUE = SINGL(CDVALUE) $ NX Nastran DMAP Programmer’s Guide 9-487 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ 9.268 SDP Calculates nondimensional stability and control derivatives Calculates and prints the nondimensional stability and control derivatives and the intercepts of the quasi-steady stability derivatives. Format: SDP CASEA,AECTRL,AERO,CSTMA,EDT, AEDBUXV,AEMONPT,MONITOR,MPARV,MPAERV,MPAEUV, MPSRV,MPSERV,MPSIERV,MPSEUV,MPSIEUV,UXTRIM,AEDBINDX, PRBDOFS/ STBDER,UXDIFV/ MACH/Q/AECONFIG/SYMXY/SYMXZ/LPRINT $ Input Data Blocks: CASEA AECTRL AERO CSTMA EDT AEDBUXV AEMONPT MONITOR MPARV MPAERV MPAEUV MPSRV MPSERV A single record (subcase) of CASECC for aerodynamic analysis Table of aerodynamic model‘s control definition Table of control information for aerodynamic analysis Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid points Element deformation table. Contains aerodynamic model records. Matrix of vehicle states Aerodynamic monitor points Structural monitor points Rigid monitor point loads on aerodynamic model Elastic restrained monitor point loads on aerodynamic model Elastic unrestrained monitor point loads on aerodynamic model Rigid splined monitor point loads on structural model Elastic restrained monitor point loads on structural model 9-488 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements MPSIRV MPSEUV MPSIUV UXTRIM AEDBINDX PRBDOFS Inertial restrained monitor point loads on structural model Elastic unrestrained monitor point loads on structural model Inertial unrestrained monitor point loads on structural model UX vector at trim Aeroelastic database index for monitor point data 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 Data Block: STBDER UXDIFV Table of aerostatic stability derivatives for a single subcase Derivative interpolation factors matrix at UX = UXREF Parameters: MACH Q AECONFIG SYMXY SYMXZ LPRINT Input-real-default=no default. Mach number. Input-real-default=no default. Dynamic pressure. Input-character-no default. Aerodynamic configuration. Input-integer-no default. Aerodynamic x-y symmetry flag. Input-integer-no default. Aerodynamic x-z symmetry flag. Input-logical-default=TRUE. Print flag for stability derivatives. Remarks: 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. • NX Nastran DMAP Programmer’s Guide 9-489 Chapter 9 Descriptions of DMAP Modules and Statements 9.269 SDR1 Computes solution and single-point forces Computes and appends the solution (displacements, velocities, acceleration) and single-point forces of constraint at the g-set for each boundary condition. Also appends applied loads. Format: SDR1 USET,PG,UL,UOO,YS,GOA,GM,PS,KFS,KSS,QR/ UG,PGT,QG/ NSKIP/APP/NOQG $ Input Data Blocks: USET PG UL UOO YS GOA GM PS KFS KSS QR Degree-of-freedom set membership table for g-set Static load matrix applied to the g-set Displacement matrix in l-set Displacement matrix in o-set due to applied loads on the o-set with the a-set fixed (set to zero) Matrix of enforced displacements or temperatures Omitted degree-of-freedom transformation matrix, o-set by a-set Multipoint constraint transformation matrix, m-set by n-set Static load matrix partitioned to the s-set Stiffness matrix partition (f-set by s-set) from KNN Stiffness matrix partition (s-set by s-set) from KNN Matrix of determinate support forces Output Data Blocks: UG PGT QG Displacement matrix in the g-set appended for all boundary conditions Static load matrix applied to the g-set appended for all boundary conditions Single-point constraint forces of constraint matrix in the g-set appended for all boundary conditions Parameters: NSKIP Input-integer-no default. The first subcase of the current boundary condition. 9-490 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements APP Input-character-no default. Analysis type. Allowable values: ‘STATICS’ ‘REIG’ ‘FREQRESP’ ‘TRANRESP’ ‘CEIGEN’ ‘MMREIG’ ‘BKL0’ ‘BKL1’ ‘DYNAMIC’ Statics Normal modes Frequency response Transient response Complex eigenvalues Normal modes for matrix method Pre-buckling (statics) Buckling 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. Remarks: 1. If NSKIP is greater than 1 and the outputs are declared APPEND on the FILE statement, the outputs are appended to outputs from prior executions of SDR1. 2. PG, YS, QR, and PS can be purged. 3. If PG is present, PGT must be present. 4. UOO must be present if the o-set exists and APP is equal to ‘STATICS’or ‘BLK0’ 5. GM must be present if the m-set exists. 6. KFS must be present if the s-set exists and QG is present. 7. KSS must be present if YS is present, the s-set exists, and QG is present. 8. UOO, KSS and YS are ignored if APP is not equal to ‘STATICS’or ‘BLK0’ 9. See the NX Nastran User‘s Guide for further discussion of the matrix operations in SDR1. 10. SDR1 can also process matrices with extra points. 9.270 SDR2 Creates output tables NX Nastran DMAP Programmer’s Guide 9-491 Chapter 9 Descriptions of DMAP Modules and Statements 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: SDR2 Input Data Blocks: CASECC CSTM MPT DIT EQEXIN EQDYN SILD ETT OL Table of Case Control command images Table of coordinate system transformation matrices Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Equivalence table between external and internal grid/scalar identification numbers. See Remark 5. Equivalence table between external and internal grid/scalar/extra point identification numbers. (EQEXIN appended with extra point data.) Scalar index list for the p-set. See Remark 5. Element temperature table Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list 9-492 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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. Basic grid point definition table Static load matrix applied to the g-set Single-point (or mutipoint-QMG) constraint forces of constraint matrix in the g-set Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG can also represent velocity or acceleration. Element summary table Table of x-y plotting commands P-element output control table. Contains OUTPUT Bulk Data entries. P-element set table, contains SETS DEFINITIONS. Output by PLTSET. View information table, contains the relationship between each p-element and its view-elements and view-grids. Grid point shell normal table Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of identification numbers in DIT Table containing LAM option input and expanded information from the PCOMP Bulk Data entry Matrix of grid point kinetic energies Bolt force data BGPDT PG QG UG EST XYCDB OINT PELSET VIEWTB GPSNT DEQATN DEQIND DITID PCOMPT GPKE BOLTFOR Output Data Blocks: OPG1 OQG1 OUG1 OES1 OEF1 PUG Table of applied loads in SORT1 format Table of single or multipoint forces-of-constraint in SORT1 format Table of displacements in SORT1 format Table of element stresses or strains in SORT1 format Table of element forces in SORT1 format Matrix of translational displacements for plotting purposes NX Nastran DMAP Programmer’s Guide 9-493 Chapter 9 Descriptions of DMAP Modules and Statements OGPKE1 Table of grid point kinetic energies in SORT1 format Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘STATICS’ ‘REIGEN’ ‘FREQRESP’ ‘TRANRESP’ ‘CEIGEN’ ‘MMREIG’ ‘BKL0’ ‘BKL1’ ‘NLST’ ‘GNST’ NOSORT2 NOCOMP Statics Normal modes Frequency response Transient response Complex eigenvalues Normal modes for matrix method Pre-buckling (statics) Buckling Nonlinear statics Geometric nonlinear statics Output-integer=default=0. SORT2 format flag. Set to 1 if SORT2 format is requested or XYCDB is present; -1 otherwise. Input-integer-default=-1. Composite stress/strain flag. -5 -2 -1 0 1 2 3 4 5 Forces of composites in STRAIN=sid Forces of composites in STRESS=sid Stresses for all elements (same as 0 except in DMAP) Stresses for all elements Stresses for non-composites only Strain/curvature and forces of composites in STRESS=sid Strains for all elements and MPC forces Strains for non-composites only Strain/curvature of composites in STRAIN=sid ACOUSTIC Input-integer-default=0. Fluid-structure analysis flag. If set to 2, acoustic pressure is computed for fluid elements. 0 No fluid elements exist 9-494 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 1 2 METRIK ISOFLG GPF ACOUT Penalty or fluid acoustic elements exists Fluid/structure coupling exists Input-integer-default=-1. Parameter for electromagnetic analysis. Input-integer-default=-1. Parameter for electromagnetic analysis. Input-integer-default=-1. Parameter for electromagnetic analysis. Input-character-default=‘PEAK’ Type of acoustic pressure output in fluid-structural analysis. ‘RMS’ ‘PEAK’ Root-mean-square Peak PREFDB TABS Input-real-default=1.0. Peak pressure reference for pressure level in units of dB or dBA. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying temperatures in Fahrenheit. Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input-integer-default=-1. P-version analysis adaptivity index. Output-logical-default=FALSE. Set to TRUE if this is the final. Input-logical-default=TRUE. Pre-buckling subcase skip flag. If TRUE, skip the first subcase in CASECC. Input-real-default=0.0. Parameter for electromagnetic analysis. Input-real-default=0.0. Parameter for electromagnetic analysis. Input-integer-default=1. Large rotation calculation method: 1 2 Gimbal angle Rotation vector SIGMA ADPTINDX ADPTEXIT BSKIP FREQWA BTBRS LANGLE OMID Input-character-default=‘NO’ Material output coordinate system flag. If OMID=‘YES,’stresses, strains, and forces are output in the material coordinate system of CQUAD4, CTRIA3, CQUAD8, and CTRIA6 elements. Remarks: 1. Any output can be purged. 2. CSTM can be purged if no coordinate systems are referenced, or if stresses and/or forces are not requested. NX Nastran DMAP Programmer’s Guide 9-495 Chapter 9 Descriptions of DMAP Modules and Statements 3. MPT and EST can be purged if there are no requests for element stresses, strains, or forces. 4. DIT can 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 can be purged. 6. ETT can be purged if no thermal loading exists, or there are no requests for stresses or forces. 7. EDT can 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 can 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 is not computed. 9. LAMA or CLAMA cannot be purged if an eigenvalue or frequency response problem exists. 10. EQEXIN and XYCDB can be purged. 9.271 Format: SDR3 SDR3 Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format OFP1,OFP2,OFP3,OFP4,OFP5,OFP6/ OFP1X,OFP2X,OFP3X,OFP4X,OFP5X,OFP6X $ Input Data Blocks: OFPi Output table in SORT1 (or SORT2) format Output Data Block: OFPiX Output table in SORT2 (or SORT1) format Parameters: None. Remarks: The SORT1 format created by modules like SDR2 is sorted accordingly: element type subcase ( or time step, frequency, and so on element identification number But the SORT1 format which has been reordered from SORT2 inputs by SDR3 is sorted accordingly: subcase ( or time step, frequency, and so on element type element identification number 9-496 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.272 SDRCOMP Calculates laminar stresses Calculates laminar stresses, or strains, and failure indices in composite elements. Format: SDRCOMP CASECC,MPT,EPT,ETT,EST,OES1A,OEF1A,DIT,BGPDT,PCOMPT/ OES1C,OEFIT,OEF1AA,OESRT/ STRNFLG/DESOPT/LOADFAC/SRCOMPS $ Input Data Blocks: CASECC MPT EPT ETT EST OES1A OEF1A DIT BGPDT PCOMPT Table of Case Control command images Table of Bulk Data entry images related to material properties Table of Bulk Data entry images related to element properties Element temperature table Element summary table Table of element strain/curvatures in SORT1 format for the composite elements only Table of element forces in SORT1 format for the composite elements only Table of TABLEij Bulk Data entry images Basic grid point definition table Table containing LAM option input and expanded information from the PCOMP Bulk Data entry Output Data Blocks: OES1C OEFIT OEF1AA OESRT Table of composite element stresses or strains in SORT1 format Table of composite element failure indices Table of element forces in SORT1 format for the non-composite elements only Table of composite element strength ratios Parameters: LSTRN Input-integer-default=0. Laminar strain flag. 0 Compute laminar stresses NX Nastran DMAP Programmer’s Guide 9-497 Chapter 9 Descriptions of DMAP Modules and Statements 1 DESOPT Compute laminar strains Input-integer-default=0. Non-composite element force flag. If set to 1, the non-composite element forces are extracted from OEF1A and copied to OEF1AA. Input-real-default=0.0. Load factor in nonlinear static analysis. Input-character-default=’NO’ Flag to request output table of ply strength ratios (OESRT). LOADFACR SRCOMPS Remarks: 1. ETT can be purged. However, temperature effects are not included. 2. OEF1AA can be purged if DESOPT=0. 3. LOADFACR is required only for including its value in the header record of OES1C for nonlinear static analysis. This is necessary for proper processing by the DBC module. 9.273 Format: SDRHT SDRHT Combines heat flow for CHBDYi elements with heat flux of other elements UG,OEF1,SLT,EST,DIT,RDEST,RECM,DLT, OEFNL1,MPT,BGPDT,CSTM,SIL,USET,CASECC/ HOEF1/ TABS/SIGMA/NORADMAT $ Input Data Blocks: UG OEF1 SLT EST DIT RDEST RECM DLT OEFNL1 MPT Temperature matrix in g-set Table of element fluxes in SORT1 format Table of static loads Element summary table Table of TABLEij Bulk Data entry images Radiation element summary table Radiation exchange coefficient matrix Table of dynamic loads Table of nonlinear element fluxes in SORT1 format Table of Bulk Data entry images related to material properties 9-498 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements BGPDT CSTM SIL USET CASECC Basic grid point definition table Table of coordinate system transformation matrices Scalar index list Degree-of-freedom set membership table for g-set Table of Case Control command images Output Data Block: HOEF1 Table of element fluxes in SORT1 format updated for CHBDYi elements. Parameters: TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius. or set to 459.69 when specifying temperatures in Fahrenheit. Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant heat flux. Input-integer-default=-1. Radiation flag. -2 -1 1 2 3 No radiation Initial radiation (default) Single band radiation with constant emissivity Radiation with temperature dependent emissivity Multiple band radiation with constant emissivity SIGMA NORADMAT Remarks: 1. For linear steady state heat transfer, OEF1 is also specified for OEFNL1 and RDEST, RECM, and DLT can 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. 9.274 SDRNL Performs stress data recovery for nonlinear elements NX Nastran DMAP Programmer’s Guide 9-499 Chapter 9 Descriptions of DMAP Modules and Statements Format: SDRNL CASECC,ESTNL,ELDATA,UNUSED4,UNUSED5,UNUSED6,UNUSED7, CSTM,UGNI,BGPDT/ OESNL1,OESNLB1,UNUSED3/ NLTYPE/UNUSED2/UNUSED3/NSKIP/LINC/UNUSED6/UNUSED7/ UNUSED8 $ Input Data Blocks: CASECC ESTNL ELDATA UNUSED4 UNUSED5 UNUSED6 UNUSED7 CSTM UGNI BGPDT Table of Case Control command images Nonlinear element summary table Table of combined nonlinear information data Unused and can be purged Unused and can be purged Unused and can be purged Unused and can be purged Table of coordinate system transformation matrices Displacement matrix at converged step in the g-set Basic grid point definition table Output Data Blocks: OESNL1 OESNLB1 UNUSED3 Table of nonlinear element stresses in SORT1 format Table of slideline contact element stresses in SORT1 format Unused and can be purged Parameters: NLTYPE Input-integer-no default. Nonlinear analysis type. 0 1 UNUSED2 UNUSED3 NSKIP LINC Statics Transient response Input-integer-no default. Unused. Input-integer-no default. Unused. Input-integer-no default. Subcase record number to read in CASECC. Input-integer-no default. Number of load increments for this subcase 9-500 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UNUSED6 UNUSED7 UNUSED8 Input-integer-default=0.0. Unused. Input-integer-default=0.0. Unused. Input-integer-default=0.0. Unused. 9.275 SDRP Computes data for p-elements Computes displacements, element forces, element stresses, and element strains of p-elements at the view-grid points and merges with corresponding output for h-elements. Format: SDRP CASECC,EST ,VIEWTB,UG ,OUG1, OES1,OSTR1 ,OEF1,DEQATN,DEQIND, DIT,MPT,MPT,CSTM,ETT,OINT, PELSET,BGPDT,BGPDT,OL,GPSNT,ERROR1, RSQUERY// OUG1VU,OES1VU,OEE1VU,OEF1VU,STATDATA, RSLTSTAT,RSLTDATA,GLBTAB,GLBRSP / ADPTEXIT/ALTSHAPE/APP/SDRPOPT/PVALID/ DESCYCLE/ADPTINDX/ODESMAX/OADPMAX/SEID $ Input Data Blocks: CASECC EST VIEWTB UG OUG1 OES1 OSTR1 OEF1 DEQATN DEQIND DIT MPT Table of Case Control command images Element summary table View information table. Contains the relationship between each p-element and its view-elements and view-grids. Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG can also represent velocity or acceleration. Table of displacements in SORT1 format Table of element stresses in SORT1 format Table of element strains in SORT1 format Table of element forces in SORT1 format. Table of DEQATN Bulk Data entry images Index table to DEQATN data block Table of TABLEij Bulk Data entry images Table of Bulk Data entry images related to material properties NX Nastran DMAP Programmer’s Guide 9-501 Chapter 9 Descriptions of DMAP Modules and Statements CSTM ETT OINT PELSET BGPDT OL GPSNT ERROR1 RSQUERY Table of coordinate system transformation matrices Element temperature table p-element output control table. Contains OUTPUT Bulk Data entries. p-element set table. Contains SETS DEFINITIONS. Basic grid point definition table Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list Grid point shell normal table Error-estimate table updated for current superelement or adaptivity loop Table of results state query Output Data Blocks: OUG1VU OES1VU OSTR1VU OEF1VU STATDATA RSTLSTAT RSLTDATA GLBTAB GLBRSP Table of displacements in SORT1 format for view grids Table of element stresses in SORT1 format for view elements Table of element strains in SORT1 format for view elements Table of element forces in SORT1 format for view elements Table of state information when system cell 297=1 Table of result-state information when system cell 297=2 Table of actual results data when system cell 297=3 Table of global responses when system cell 297=-1 Matrix of global responses when system cell 297=-1 Parameters: ADPTEXIT ALTSHAPE Input-logical-no default. Set to TRUE if this is the final adaptivity loop. 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. Input-character-no default. Analysis type. Allowable values: ‘STATICS’ ‘REIGEN’ Statics Normal modes APP 9-502 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ‘FREQ’ ‘TRANSNT’ ‘CEIGEN’ SDRPOPT Frequency response Transient response Complex eigenvalues Input-character-no default. Principal stress/strain computation selection: ‘SDRP’ ‘OFP’ Compute in SDRP Compute in OFP PVALID DESCYCLE ADPTINDX ODESMAX OADPMAX SEID Input-integer-no default. p-value set identification number. Input-integer-no default. Design cycle analysis counter. Input-integer-no default. p-version analysis adaptivity index. Input-integer-no default. Total number of design cycles performed. Input-integer-no default. Total number of adaptivity cycles performed. Input-integer-no default. Superelement identification number. Remarks: 1 2 If disk space is critical, SDRPOPT can set to ‘OFP’to delay computation of principal stresses and strains to the OFP module. 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 -1 Global Response (that is, find the minimum/maximum values of certain data recovery quantities) 9.276 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. NX Nastran DMAP Programmer’s Guide 9-503 Chapter 9 Descriptions of DMAP Modules and Statements Format: SDRX CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,BGPDT, OSTR1/ OEF1X,OES1X,OSTR1X/ S,N,NOXOUT/ICAM $ Input Data Blocks: CASECC OEF1 OES1 GEOM2 GEOM3 EST CSTM MPT DIT BGPDT OSTR1 Table of Case Control command images Table of element forces in SORT1 format Table of element stresses in SORT1 format Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Element summary table Table of coordinate system transformation matrices Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Basic grid point definition table Table of element strains in SORT1 format Output Data Blocks: OEF1X OES1X OSTR1X Table of displacements in SORT1 format for view grids Table of element stresses in SORT1 format updated for PLOAD1 loads and intermediate station output Table of element strains in SORT1 format augmented with strains for 1-D elements Parameter: NOXOUT Output-integer-no default. SDRX update flag. 0 -1 OEF1X, OES1X, and OSTR1X are updated OEF1X, OES1X, and OSTR1X are not updated 9-504 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ICAM Input-Integer-Default=0 When set to 1, process all constraint and attachment modes 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 $ 9.277 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 $ Input Data Blocks: CASECC OEF1 OES1 GEOM2 GEOM3 EST CSTM MPT DIT UG DLT Table of Case Control command images Table of element forces in SORT1 format Table of element stresses in SORT1 format Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Element summary table Table of coordinate system transformation matrices Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Displacement matrix in g-set Table of dynamic loads NX Nastran DMAP Programmer’s Guide 9-505 Chapter 9 Descriptions of DMAP Modules and Statements OL BGPDT OSTR1 Transient response time output list or frequency response frequency output list Basic grid point definition table Table of element strains in SORT1 format Output Data Blocks: OEF1X OES1X OSTR1X Table of displacements in SORT1 format for view grids Table of element stresses in SORT1 format updated for PLOAD1 loads and intermediate station output Table of element strains in SORT1 format augmented with strains for 1-D elements Parameters: NOXOUT Output-integer-no default. SDRX update flag. 0 -1 APP OEF1X, OES1X, and OSTR1X are updated OEF1X, OES1X, and OSTR1X are not updated Input-character-no default. Analysis type. Allowable values: ‘FREQRESP’ ‘TRANRESP’ Frequency response Transient response COUPMASS Input-integer-default=-1. Coupled mass generation flag. -1 0 Lumped Coupled 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 $ 9.278 SDSA Partitions design model to superelements Partitions the design model (that is, the design optimization Bulk Data entries) to superelements. 9-506 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: SDSA EDOM,EPTS,EQEXINS,SEMAP,MPTS/ EDOMS/ SEID/PEID/S,N,OBJSID/DESOBJ/S,N,DESVAR/ S,N,DRESP/S,N,TWGTFL/S,N,TVOLFL $ Input Data Blocks: EDOM EPTS EQEXINS SEMAP MPTS Table of Bulk Data entries related to design sensitivity and optimization Table of Bulk Data entry images related to element properties for the superelement specified by SEID Equivalence table between external and internal grid/scalar identification numbers for the superelement specified by SEID Superelement map table Table of Bulk Data entry images related to material properties for the current superelement Output Data Block: EDOMS Table of Bulk Data entries related to design sensitivity and optimization for the superelement specified by SEID Parameters: SEID PEID OBJSID Input-integer-default=0. Superelement identification number. Input-integer-default=0. Primary superelement identification number. Output-integer-default=-1. Superelement identification number associated with DESOBJ. Set to -1 for all cases unless you specify the DESOBJ command in a particular superelement subcase. Input-integer-default=0. DESOBJ Case Control command set identification number. Output-integer-default=0. Retained DVPRELi or DVGRID entry flag for superelement SEID. Set to -1 if there are retained design variable perturbations. Output-integer-default=0. Retained DRESP1 entry flag for superelement SEID. Set to -1 if there are retained design responses. Output-integer-default=0. Total weight flag. Output-integer-default=0. Total volume flag. DESOBJ DESVAR DRESP TWGTFL TVOLFL NX Nastran DMAP Programmer’s Guide 9-507 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: SDSA is intended to be executed in a superelement DMAP loop driven by SEP2DR. See subDMAP DESINIT for an example. 9.279 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 $ Input Data Blocks: CASECC SLIST EDOM* unused4 unused5 Table of Case Control command images Superelement processing list to matrix generation, assembly, and reduction Family of EDOM tables for all superelements Unused and can be purged Unused and can be purged Output Data Block: DSLIST Superelement processing list to direct the pseudo-load and response sensitivity calculations Parameters: DMRESD NOSEDV Output-integer-default=-1. Design model flag. If set to -1, the design model is limited to the residual structure. Output-integer-default=0. Pseudo-load generation flag based on the SEDV Case Control command. Set to -1 if pseudo-loads are not requested for any superelement. Output-integer-default=0. Response sensitivity calculation flag based on the SERESP Case Control command. Set to -1 if response sensitivities are not requested for any superelement. NOSERESP Example: Excerpt from subDMAP DESINIT: 9-508 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DBVIEW EDOMF=EDOMS WHERE (wildcard) $ IF ( NOT(RSONLY) AND NOEDOM>0 ) SDSB SLIST,EDOMF,CASEXX,,/DSLIST/S,N,DMRESD/ S,N,NOSEDV/S,N,NOSERESP $ 9.280 Format: SDSC SDSC Prints correlation table for normalized design sensitivity coefficient matrix DSCMCOL// OBJSID/DESOBJ/UNUSED3/EIGNFREQ $ Input Data Block: DSCMCOL Correlation table for normalized design sensitivity coefficient matrix Output Data Blocks: None. Parameters: OBJSID Input-integer-default=0. Superelement identification number associated with DESOBJ. Set to -1 for all cases unless you specify the DESOBJ command in a particular superelement subcase. Input-integer-default=0. DESOBJ Case Control command set identification number. Input-integer-default=1. Unused. Input-integer-default=0. Eigenvalue/frequency response type flag. 1 2 Eigenvalue (radian/time) Frequency (cycle/time) DESOBJ UNUSED3 EIGNFREQ 9.281 SECONVRT Modifies Bulk Data entry records Modifies those Bulk Data entry records which define coordinate systems, orientation vectors, and load vectors by grid point identification number; for example, 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/ NX Nastran DMAP Programmer’s Guide 9-509 Chapter 9 Descriptions of DMAP Modules and Statements GEOM1N,GEOM2N,GEOM3N $ Input Data Blocks: BGPDT GEOM1 GEOM2 GEOM3 Basic grid point definition table Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Output Data Blocks: GEOM1N GEOM2N GEOM3N Modified GEOM1 with CORD1j records converted to CORD2j records Modified GEOM2 with GO replaced by X1, X2, and X3 on CBAR, CBEAM, CBEND, CBUSH and CGAP records Modified GEOM3 with FORCEi and MOMENTi records converted to FORCE and MOMENT records Parameters: None. Remarks: System cell 350 controls execution of the SECONVRT module. -1 0 >0 No converson Convert and echo all converted entries in the f06 Convert and echo the first n converted entries in the f06 where n is the value of system cell 350 9.282 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/ UA,CASEDR,PCDBDR,XYCDBDR/ APP/SEID/S,N,NOUP/S,N,NOSORT1/S,N,NOUG/ S,N,NOOUT/S,N,NOPLOT/S,N,NOXYPLOT/QUALNAM/NCUL $ 9-510 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Input Data Blocks: SEMAP CASECC PCDB DRLIST XYCDB SLT ETT MAPS* Superelement map table Table of Case Control command images Table of model (undeformed and deformed) plotting commands Superelement processing list for data recovery Table of x-y plotting commands Table of static loads Element temperature table Family of MAPS (superelement upstream to downstream boundary coordinate system, secondary (mirror, identical, and repeated), and release transformation matrix) Displacement matrix in g-set for the downstream superelement Basic grid point definition table Table of grid points generated for p-element analysis UGD BGPDT GDNTAB Output Data Blocks: UA CASEDR PCDBDR XYCDBDR Solution matrix on the boundary (a-set) of the superelement (identification number equal to output value of SEID) Table of Case Control command images for the superelement (identification number equal to output value of SEID) Table of model (undeformed and deformed) plotting commands for the superelement (identification number equal to output value of SEID) Table of x-y plotting commands for a superelement (identification number equal to output value of SEID) Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘STATICS’ ≠‘STATICS’ SEID NOUP Statics Not statics Input-integer-default=0. Superelement identification number. Output-integer-default=0. Upstream superelement flag. Set to -1 if there are no superelements connected upstream from the current superelement. NX Nastran DMAP Programmer’s Guide 9-511 Chapter 9 Descriptions of DMAP Modules and Statements NOSORT1 NOUG NOOUT NOPLOT NOXYPLOT QUALNAM NCUL Output-integer-default=0. SORT1 format flag. Set to -1 if SORT1 format is not requested for current superelement. Output-integer-default=0. UG presence flag. Set to -1 if UG already exists for the current superelement. Output-integer-default=0. Output request flag. Set to -1 if no output requests are specified for the current superelement. Output-integer-default=0. Plot request flag. Set to -1 if no deformed plot requests are specified for the current superelement. Output-integer-default=0. X-Y plot request flag. Set to -1 if no x-y plot requests are specified for the current superelement. Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS. Input-integer-no default. Number of columns desired in the solution matrix for the residual structure. Usually determined by the PARAML module. 9.283 Format: SEDRDR SEDRDR Drives superelement data recovery loop 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 $ Input Data Blocks: DRLIST SEMAP Superelement processing list for data recovery Superelement map table Output Data Blocks: None. Parameters: LASTSE SEID Output-integer-default=0. Last superelement flag. Set to -1 if the current superelement is the last to process. Input/output-integer-default=0. Superelement identification number and initialization flag. On input: 9-512 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements -1 -2 ≥0 On output: ≥0 PEID SEDWN NODR NOSE SETYPE Initialization Same as -1 except do not print UIM 7321 Previous superelement identification number Current superelement identification number Output-integer-default=0. Primary superelement identification number. Output-integer-default=0. Downstream superelement identification number. Output-integer-default=0. Data recovery request flag. Set to -1 if there is no data recovery requested for any superelement. Input-integer-default=0. Superelement presence flag. Set to -1 if there are no superelements. Output-character-default=’ ’ Superelement type as specified on the SEBULK Bulk Data entry. ‘REPEAT’ ‘MIRROR’ ‘COLLTR’ ‘EXTRNA’ ‘PRIMARY’ Repeated Mirror Collector External Primary RSEID SCNDRY Output-integer-default=0. Repeated superelement identification number as specified on the SEBULK Bulk Data entry. Output-integer-default=0. Secondary (identical or mirror) superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0. Output-integer-default=0. External superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID=0. Input-character-default=’ ’ Processing list selection. ’‘ ‘CURR‘ All superelements are processed (default). Only the superelements specified by the SEID parameter are processed. EXTRN SEDRCNTL NOPGHD Input-integer-default=0. Page header superelement label print control. 0 Print page header and UIM 7321. NX Nastran DMAP Programmer’s Guide 9-513 Chapter 9 Descriptions of DMAP Modules and Statements -1 -2 -3 Do not print page header and UIM 7321. Same as -1 and do not print .f04 label. Same as -2 and do not print superelement label in SUBTITLE line of page header. Remarks: SEDRDR processes each superelement, specified in DRLIST, in the order of data recovery; that is, 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 $ 9.284 SELA 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 $ Input Data Blocks: PJ SLIST SEMAP BGPDTS Static load matrix for the g-set of the current superelement and applied to its interior points only Superelement processing list to matrix generation, assembly, and reduction Superelement map table Basic grid point definition table for the current superelement 9-514 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements PA* MAPS* Family of static load matrices (PA) applied on the boundary (a-set) of all upstream superelements Family of MAPS (superelement upstream to downstream boundary coordinate system, secondary (mirror, identical, and repeated), and release transformation matrix) Table of grid points generated for p-element analysis GDNTAB Output Data Block: PG Static load matrix for the g-set of the current superelement including loads from upstream superelements Parameters: SEID QUALNAM LDSEQ Input-integer-default=0. Superelement identification number. Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS and PA. Input/output-integer-default=0. PG column number. On input, last column number of PG on previous SELA execution. On output, last column number of PG on current execution. Output-integer-default=0. Upstream load presence flag. Set to -1 if there are no loads due to upstream superelements. Input-logical-default=TRUE. UIM 4570 print control flag in SELA module. NOPG PRTUIM Remarks: PJ can 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 $ 9.285 SEMA Assembles square symmetric matrices from upstream superelements Assembles square symmetric matrices (for example, stiffness, mass, damping) from upstream superelements into the current superelement. NX Nastran DMAP Programmer’s Guide 9-515 Chapter 9 Descriptions of DMAP Modules and Statements Format: SEMA BGPDTS,SLIST,SEMAP,XJJ,XAA*,MAPS*,GDNTAB/ XGG/ SEID/LUSETS/QUALNAM/UPFM $ Input Data Blocks: BGPDTS SLIST SEMAP XJJ XAA* MAPS* Basic grid point definition table for the current superelement Superelement processing list to matrix generation, assembly, and reduction Superelement map table Square matrix for the g-set of the current superelement and applied to its interior points only Family of reduced square matrices in a-set pertaining to the upstream superelements Family of MAPS (superelement upstream to downstream boundary coordinate system, secondary (mirror, identical, and repeated), and release transformation matrix) Table of grid points generated for p-element analysis GDNTAB Output Data Block: XGG Square matrix in g-set including contributions from upstream superelements. Parameters: SEID LUSETS QUALNAM UPFM Input-integer-default=0. Superelement identification number. Input-integer-default=0. The number of degrees-of-freedom in the g-set of the current superelement. Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS and PA. Input-integer-default=0. UFM 4252 print flag. Set to -1 to print UFM 4252 and set NOGO=-1 if there are missing upstream boundary matrices. Remarks: XJJ can 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) $ 9-516 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements DBVIEW MAPUP = MAPS WHERE (SEID=* AND PEID=*) $ SEMA BGPDTS,SLIST,SEMAP,KJJ,KAAUP,MAPUP,GDNTAB/ KGG/ SEID/LUSETS/‘SEID‘/-1 $ IF ( NOGO=-1 ) EXIT $ 9.286 Format: SEP1 SEP1 Constructs superelement map table GEOM1,GEOM2,GEOM4,EQEXIN,BGPDT,CSTM,CASECC,SETREE/ SEMAP/ S,N,NOSE/CONFAC/LST2REC/AUTOSEEL $ Input Data Blocks: GEOM1 GEOM2 GEOM4 EQEXIN BGPDT CSTM CASECC SETREE Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Equivalence table between external and internal grid/scalar identification numbers Basic grid point definition table Table of coordinate system transformation matrices Table of Case Control command images Superelement tree table usually input via the DTI,SETREE Bulk Data entry Output Data Block: SEMAP Superelement map table Parameters: NOSE CONFAC LST2REC Output-integer=default=0. Superelement presence flag. Set to -1 if there are no superelements. Input-integer-default=1.E-5. Image superelement congruence tolerance for the location of boundary grid points and displacement coordinate systems. Input-integer-default=TRUE. Last two records write flag. Set to TRUE to write last two records. NX Nastran DMAP Programmer’s Guide 9-517 Chapter 9 Descriptions of DMAP Modules and Statements AUTOSEEL Input-character-default=NO. If AUTOSEEL=YES, activate auto-SEELT capability. 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, and so on), the exterior grid points, the structural and rigid elements, and for certain secondary superelements, sequencing information. 2. SEP1 supports only superelements defined by the SESET Bulk Data entry, CSUPER Bulk Data entry or on the SEID field on the GRID Bulk Data entry; that is, grid-list superelements. SEP1X is a more recently developed module intended for superelements defined in separate Bulk Data sections; that is, partitioned superelements. 9.287 SEP1X Constructs superelement map table Constructs the superelement map table and "corrects" the grid point locations at RSSCON element connections. Format: SEP1X SELIST,GEOM1*,GEOM2*,GEOM4*,SETREE,SGPDTS*,BNDFIL/ SEMAP,SGPDT,SCSTM/ S,N,NOSE/CONFAC/QUALNAM/QUALVAL/S,N,RSFLAG/ NQSET/EXTNAME/SEP1XOVR/NQMAX/SEBULK/TOLRSC $ Input Data Blocks: SELIST GEOM1* GEOM2* GEOM4* SETREE SGPDTS* BNDFIL Table containing the list of partitioned superelements defined in separate Bulk Data sections Family of GEOM1 tables for all partitioned superelements defined in separate Bulk Data sections Family of GEOM2 tables for all partitioned superelements defined in separate Bulk Data sections Family of GEOM4 tables for all partitioned superelements defined in separate Bulk Data sections Superelement tree table usually input via the DTI,SETREE Bulk Data entry Family of SGPDTS tables created in previous runs Table containing the local and global boundary grids in the order given by extreme for domain decomposition 9-518 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Blocks: SEMAP SGPDT SCSTM Superelement map table Global superelement basic grid point definition table including RSSCON grid point location corrections Table of global transformation matrices for partitioned superelements Parameters: NOSE CONFAC QUALNAM QUALVAL RSFLAG NQSET Output-integer=default=0. Superelement presence flag. Set to -1 if there are no superelements. Set to number of superelements if superelements exist. Input-integer-default=1.E-5. Image superelement congruence tolerance for the location of boundary grid points and displacement coordinate systems. Input-character-default=‘SEID’ Name of qualifier to be used in selecting GEOM1, GEOM2, GEOM4, and SGPDT. Input-integer-default=-1. QUALNAM value assigned to the main Bulk Data section. Output-logical-default=FALSE. Main Bulk Data superelement presence flag. Set to TRUE if superelements are defined in the main Bulk Data section. Input-integer-default=0. Number of automatic q-set degrees-of-freedom (auto-q-set). Each superelement has NQSET number of q-set degrees-of-freedom. Input-character-default=‘XEID’ Name of the qualifier used to identify External Superelements. Note linkage to the SEBULK data entry. Input-integer-default=0. Override bits for module processing. Bit(s) 1-3 4 5 6 7 8 NQMAX Value(s) 1-5 8 16 32 64 128 Description Override Search Algorithm Selection Disable Automatic Main Bulk Scalar Linkages via internal SECONCT entries Print RSSCON old/new locations Print Boundary Search Sequence SEP1X "Diag 30" Debugging Output Auto-SET in Residual place in OSET when other sets present in the Residual EXTNAME SEP1XOVR Input-integer-default=3000. Maximum number of auto-q-set‘s allowed per partitioned superelement. See NQSET. NX Nastran DMAP Programmer’s Guide 9-519 Chapter 9 Descriptions of DMAP Modules and Statements SEBULK Input-logical-default=FALSE. Partitioned superelement presence flag. Set to TRUE if partitioned superelements are present or BEGIN SUPER is specified for the first BEGIN BULK Case Control command. If TRUE, superelement processing is performed. Otherwise, only the RSSCON element corrections are performed. Input-real-default=1.0E-4. RSSCON element alignment tolerance factor. TOLRSC Examples: 1. Excerpt from subDMAP PHASE0: DBVIEW DBVIEW DBVIEW DBVIEW SEP1X GEOM1F=GEOM1QS WHERE ( PEID<>0 ) $ GEOM2F=GEOM2S WHERE ( PEID<>0 ) $ GEOM4F=GEOM4QS WHERE ( PEID<>0 ) $ SGPDTF=SGPDTS WHERE ( PEID<>0 ) $ SELIST,GEOM1F,GEOM2F,GEOM4F,SETREE,SGPDTF/ EMAP,SGPDT,SCSTM/ S,N,NOSE/CONFAC/‘PEID‘//S,N,PARTRS/NQSET/‘XEID‘/SEP1XOVR// SEBULK/TOLRSC $ 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 $ 9.288 Format: SEP2 SEP2 Partitions tables for each superelement GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT, SLIST,SEMAP,CASES,DYNAMIC,GPSNT/ GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS, MAPS,UNUSED8,UNUSED9,DYNAMICS,GPSNTS/ SEID/METHCMRS Input Data Blocks: GEOM1 GEOM2 GEOM3 GEOM4 EPT MPT Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to material properties. 9-520 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements SLIST SEMAP CASES DYNAMIC GPSNT Superelement processing list to matrix generation, assembly, and reduction Superelement map table Table of Case Control commands for the current superelement Table of Bulk Data entry images related to dynamics Grid point shell normal table Output Data Blocks: GEOM1S GEOM2S GEOM3S GEOM4S EPTS MPTS MAPS Table of Bulk Data entry images related to geometry for the current superelement Table of Bulk Data entry images related to element connectivity and scalar points for the current superelement Table of Bulk Data entry images related to static and thermal loads for the current superelement Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity for the current superelement Table of Bulk Data entry images related to element properties for the current superelement Table of Bulk Data entry images related to material properties for the current superelement Superelement boundary transformation matrix for secondary superelements (mirror, identical, and repeated), boundary resequencing and releases Unused and can be purged Unused and can be purged Table of Bulk Data entry images related to dynamics for the current superelement Grid point shell normal table for the current superelement UNUSED8 UNUSED9 DYNAMICS GPSNTS Parameters: SEID METHCMRS Input-integer-default=0. Superelement identification number. Input-integer-default=0. Residual structure METHOD set identification (SID) override. METHCMRS>0 overrides SID value specified in CASES. NX Nastran DMAP Programmer’s Guide 9-521 Chapter 9 Descriptions of DMAP Modules and Statements 9.289 SEP2CT Partitions Case Control and Plot Control tables for each superelement Format: SEP2CT SLIST,CASECC,PCDB,UNUSED4,XYCDB/ CASES,PCDBS,XYCDBS/ APP/SEID $ Input Data Blocks: SLIST CASECC PCDB UNUSED4 XYCDB Superelement processing list to matrix generation, assembly, and reduction Table of Case Control command images Table of model (undeformed and deformed) plotting commands Unused and can be purged Table of x-y plotting commands Output Data Blocks: CASES PCDBS XYCDBS Table of Case Control command images for the current superelement (identification number equal to output value of SEID) Table of model (undeformed and deformed) plotting commands for the current superelement (identification number equal to output value of SEID) Table of x-y plotting commands for the current superelement (identification number equal to output value of SEID) Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘STATICS’ ≠‘STATICS’ SEID Statics Not statics Input-integer-default=0. Superelement identification number. 9.290 SEP2DR Drives superelement generation, assembly, and reduction loop Drives the superelement generation, assembly, and reduction loop. Also drives the pseudo-load generation loop. 9-522 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: SEP2DR Input Data Blocks: SEMAP SLIST DSLIST Superelement map table Superelement processing list to matrix generation, assembly, and reduction Superelement processing list to direct the pseudo-load and response sensitivity calculations Output Data Blocks: None. Parameters: SEID Input/output-integer-default=0. Superelement identification number and initialization flag. On input: -1 -2 ≥0 On output: ≥0 PEID SEDWN LASTSE Current superelement identification number Initialization Same as -1 except do not print UIM 7321 Previous superelement identification number Output-integer-default=0. Primary superelement identification number. Output-integer-default=0. Downstream superelement identification number. Output-integer-default=0. Last superelement flag. Set to -1 if the current superelement is the last to process. NX Nastran DMAP Programmer’s Guide 9-523 Chapter 9 Descriptions of DMAP Modules and Statements NOMAT Output-integer-default=0. Matrix generation flag. Set to -1 if no matrix generation is requested for the current superelement based on the SEMG or SEALL Case Control commands. Output-integer-default=0. Matrix assembly flag. Set to -1 if no matrix assembly and reduction is requested for the current superelement based on the SEKR or SEALL Case Control commands. Output-integer-default=0. Load generation flag. Set to -1 if no load generation is requested for the current superelement based on the SELG or SEALL Case Control commands. Output-integer-default=0. Load assembly flag. Set to -1 if no load assembly and reduction is requested for the current superelement based on the SELR or SEALL Case Control commands. Output-integer-default=0. Upstream superelement flag. Set to -1 if there are no superelements connected upstream from the current superelement. Output-integer-default=0. Secondary (identical or mirror) superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0. Output-integer-default=0. External superelement flag. Set to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID=0. Output-integer-default=0. Mass and damping assembly flag. Set to -1 if no mass and damping assembly and reduction is requested for the current superelement based on the SEMR or SEALL Case Control commands. Input-character-default=‘SLIST’ Processing list selection. ‘ALL’ ‘PSLGDV’ ‘DSLIST’ ‘SLIST’ ‘SEDWN’ ‘CURR’ All superelements are processed. Only superelements specified on the SEDV Case Control commands Only superelements specified on the SERESP Case Control commands Only superelements specified on the SEALL, SEMG, SEKR, SELG, SELR, or SEMR Case Control commands All superelements that have SEDWN as their downstream superelement Only the superelement specified by SEID parameter is processed NOASM NOLOAD NOLASM NOUP SCNDRY EXTRN NOMR SEP2CNTL NOPSLG Output-integer-default=0. Pseudo-load generation flag. Set to -1 if no load generation is requested for the current superelement based on the SEDV or SERESP Case Control commands. 9-524 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements NOPGHD Input-integer-default=0. Page header and eject flag. 0 -1 -2 Print page header in f06 and label in f04. Do not print page header in f06. Do not print page header in f06 and label in f04 PARTSE SETYPE Output-logical-default=FALSE. Partitioned superelement flag. Set to TRUE if the current superelement is a partitioned superelement. Output-character-default=’ ’ Superelement type as specified on the SEBULK Bulk Data entry. ‘REPEAT’ ‘MIRROR’ ‘COLLTR’ ‘EXTRNA’ ‘PRIMARY’ Repeated Mirror Collector External Primary RSEID NSENQSET Output-integer-default=0. Repeated superelement identification number as specified on the SEBULK Bulk Data entry. Output-integer-default=0. Number of SENQSET degrees-of-freedom allocated to the current superelement. Remarks: 1. SEP2DR processes each superelement, specified in SLIST or DSLIST, in the order of matrix generation; that is, upstream to downstream or tip superelements to the residual structure. 2. If SEP2CNTL=‘PSLGDV’or ‘DSLIST‘, 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 $ NX Nastran DMAP Programmer’s Guide 9-525 Chapter 9 Descriptions of DMAP Modules and Statements 9.291 Format: SEP2X SEP2X Partitions tables for each superelement GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,SLIST,SEMAP,CASES, DYNAMIC,UNUSED11,SGPDT,SCSTM,MATPOOL/ GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS, MAPS,SGPDTS,UNUSED9,DYNAMICS,MATPOOLS,UNUSED12/ SEID/METHCMRS $ Input Data Blocks: GEOM1 GEOM2 GEOM3 GEOM4 EPT MPT SLIST SEMAP CASES DYNAMIC UNUSED11 SGPDT SCSTM MATPOOL Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Table of Bulk Data entry images related to static and thermal loads Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to material properties Superelement processing list to matrix generation, assembly, and reduction Superelement map table Table of Case Control commands for the current superelement Table of Bulk Data entry images related to dynamics Unused and can be purged Superelement basic grid point definition table Table of global transformation matrices for partitioned superelements Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entrie Output Data Blocks: GEOM1S GEOM2S Table of Bulk Data entry images related to geometry for the current superelement Table of Bulk Data entry images related to element connectivity and scalar points for the current superelement 9-526 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GEOM3S GEOM4S EPTS MPTS MAPS SGPDTS UNUSED9 DYNAMICS MATPOOLS UNUSED12 Table of Bulk Data entry images related to static and thermal loads for the current superelement Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity for the current superelement Table of Bulk Data entry images related to element properties for the current superelement Table of Bulk Data entry images related to material properties for the current superelement Superelement boundary transformation matrix for secondary superelements (mirror, identical, and repeated), boundary resequencing and releases Superelement basic grid point definition table for the current superelement Unused and can be purged Table of Bulk Data entry images related to dynamics for the current superelement MATPOOL table for the current superelement Unused and can be purged Parameters: SEID METHCMRS Input-integer-default=0. Superelement identification number. Input-integer-default=0. Residual structure METHOD set identification (SID) override. METHCMRS>0 overrides SID value specified in CASES. 9.292 SEP3 Examines Case Control and determines superelement processing Examines Case Control and determines which superelements are to be processed for generation, assembly, and reduction of stiffness, mass, and damping, and load matrices. Format: SEP3 CASECC,EMAP/ SLIST/ S,N,NOSECOM/S,N,SEID/NOSE/S,N,NOMAT/S,N,NOASM/ S,N,NOLOAD/S,N,NOLASM/S,N,NOMR/UNUSED9 $ Input Data Blocks: CASECC Table of Case Control command images NX Nastran DMAP Programmer’s Guide 9-527 Chapter 9 Descriptions of DMAP Modules and Statements SEMAP Superelement map table Output Data Block: SLIST Superelement processing list for matrix generation, assembly, and reduction Parameters: NOSECOM Output-integer-default=0. Superelement Case Control command flag. Set to -1 if there are no SEALL, SEMG, SEKR, SELG, SELR, or SEMR commands specified in CASECC. Output-integer-default=0. Initialization flag. If there are superelements, SEID is set to -1 to initialize SEP2DR; otherwise 0. Input-integer=default=0. Superelement presence flag. Set to -1 if there are no superelements. Output-integer-default=0. Matrix generation flag. If there are no superelements, NOMAT is set to -1 if no SEMG and no SEALL Case Control commands are specified. Output-integer-default=0. Matrix assembly flag. If there are no superelements, NOASM is set to -1 if no SEKR and no SEALL Case Control commands are specified. Output-integer-default=0. Load generation flag. If there are no superelements, NOLOAD is set to -1 if no SELG and no SEALL Case Control commands are specified. Output-integer-default=0. Load assembly flag. If there are no superelements, NOLASM is set to -1 if no SELR and no SEALL Case Control commands are specified. Output-integer-default=0. Mass and damping assembly flag. If there are no superelements, NOMR is set to -1 if no SEMR and no SEALL Case Control commands are specified. Input-integer-default=0. Unused. SEID NOSE NOMAT NOASM NOLOAD NOLASM NOMR UNUSED9 Remarks: If there are no superelements, SLIST is not created and can be purged. 9.293 SEP4 Examines table and data base information for superelement processing Examines the Case Control and Plot Control tables, queries the data base for existing solution matrices, and determines which superelements are to be processed for data recovery. 9-528 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: SEP4 CASECC,PCDB,EMAP,XYCDB,UG*,PUG*,QG*/ DRLIST/ UNUSED1/QUALNAM/S,N,NODR/S,N,SEID/S,N,NOSEPLOT/ SEP4CNTL $ Input Data Blocks: CASECC PCDB SEMAP XYCDB UG* PUG* QG* Table of Case Control command images Table of model (undeformed and deformed) plotting commands Superelement map table Table of x-y plotting commands Family of displacement matrices in g-set for all superelements Family of matrices of translational displacements for all superelements Family of single-point constraint forces of constraint matrices in the g-set for all superelements Output Data Block: DRLIST Superelement processing list for data recovery Parameters: UNUSED1 QUALNAM NODR SEID NOSEPLOT Input-character-no default. Specify ’ ’ Input-character-default=‘SEID’ Name of qualifier to be used in selecting UG, PUG, and QG. Output-integer-default=0. Data recovery request flag. Set to -1 if there is no data recovery requested for any superelement. Input-integer-default=0. Initialization flag. If there are superelements, SEID is set to -1 to initialize SEDRDR; otherwise 0. Output-integer-default=0. SEPLOT or SEUPPLOT request flag. Set to -1 if there are no SEPLOT or SEUPPLOT commands specified in the OUTPUT(PLOT) section. Output-integer-default=’ ’ Processing list selection. ‘ALL’ ≠‘ALL’ All superelements are processed. Only superelements specified on the SEDR Case Control command SEP4CNTL NX Nastran DMAP Programmer’s Guide 9-529 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ 9.294 SEPLOT Assembles plot displacement matrices for superelements Assembles plot displacement matrices for superelements based on the SEPLOT and SEUPPLOT commands. Format: SEPLOT PCDB,SEMAP,SCSTM,BGPDT*,ECT*,PUG*/ BGPDTX,PUGX,PLSETMSG,PLTPAR,GPSETS,ELSET/ QUALNAM/QUALNAMP/S,N,PLTCNT/S,N,NGP/S,N,JPLOT $ Input Data Blocks: PCDB SEMAP SCSTM BGPDT* ECT* PUG* Table of model (undeformed and deformed) plotting commands Superelement map table Table of global transformation matrices for partitioned superelements Family of basic grid point definition tables for all superelements Family of element connectivity tables for all superelements Family of matrices of translational displacements for all superelements Output Data Blocks: BGPDTX PUGX PLSETMSG PLTPAR GPSETS ELSET BGPDT assembled for superelements defined on the SEPLOT or SEUPPLOT command PUG assembled for superelements defined on the SEPLOT or SEUPPLOT command Table of user informational messages generated during the definition of element plot sets Table of plot parameters and plot control Table of grid point sets related to the element plot sets Table of element plot set connections 9-530 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: QUALNAM QUALNAMP PLTCNT Input-character-default=‘SEID’ Name of qualifier to be used in selecting BGPDT and ECT. Input-character-default=‘PEID’ Name of qualifier to be used in selecting PUG. Input/output-integer-no default. SEPLOT (or SEUPPLOT) command counter. On input: 0 Initialization On output: ≥0 NGP JPLOT Current SEPLOT (or SEUPPLOT) command Output-integer-no default. Number of grid points and scalar points in the BGPDTX. Output-integer-no default. Number of element plot sets. Set to -1 if there are none. Example: Excerpt from subDMAP SUPER3: DBVIEW BGPDTF=BGPDTS WHERE (PEID=* AND MODLTYPE=‘STRUCTUR‘) $ DBVIEW ECTF=ECTS WHERE (PEID=* AND MODLTYPE=‘STRUCTUR‘) $ DO WHILE ( PLTCNT>-1 ) $ SEPLOT PCDB,EMAP,scstm,BGPDTF,ECTF,PUGF/ BGPDTX,PUGX,PLTXY,PLTPARY,GPSETSY,ELTSETSY/ ‘PEID‘/‘SEID‘/S,N,PLTCNT/S,N,NSILS/S,N,JPLOT $ PRTMSG PLTXY//PDRMSG $ IF ( JPLOT>=0 ) THEN $ PLOT PLTPARY,GPSETSY,ELTSETSY,CASECC,BGPDTX, PUGX,PUGX,gpect,oes1x/ PLOTY2/NSILS/0/JPLOT/-1/S,N,PFILE $ PRTMSG PLOTY2//PDRMSG $ ENDIF $ JPLOT>=0 ENDDO $ PLTCNT>-1 9.295 SEPR1 Builds a list of partitioned superelement Bulk Data sections Format: SEPR1 BULK*/ SELIST/ QUALNAM/S,N,SEFLAG $ NX Nastran DMAP Programmer’s Guide 9-531 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Blocks: BULK* Family of partitioned superelement Bulk Data sections Output Data Blocks: SELIST List of partitioned superelement identification numbers Parameters: QUALNAM SEFLAG Input-character-default=‘SEID’ Name of qualifier to be used in selecting BULK. Output-logical-default=FALSE. Set to TRUE if partitioned superelements are present. Example: Excerpt from subDMAP IFPL: DBVIEW IBULKSF = IBULK WHERE (SEID>0 AND PEID=*) $ SEPR1 IBULKSF/SELIST//S,N,SELIST $ 9.296 SEQP Resequencing processor Generates SEQGP entries or a mapping matrix for use in resequencing matrices for efficient matrix decomposition. Format 1: Geometry Table input SEQP GEOM1,GEOM2,GEOM4,EPT,MATPOOL,DYNAMIC,CASECC/ GEOM1Q,TIMSIZ,GEQMAP,BNDFIL,SPCPART,LGPART,GEOM2X, GEOM4X/ SEQOUT/SEQMETH//SUPER/FACTOR/ MPCFLG/START/MSGLVL/PEXIST/PSEQOPT/S,N,NTIPS/APP/ S,N,ZCOLLCT/S,N,TIPSCOL/ACMS/S,N,FLUIDSE $ Format 2: Matrix input SEPQ MAT,GPL,USET,SIL/SEQMAP,,,,,/SEQOUT/METHOD/SETNAME $ Input Data Blocks: GEOM1 GEOM2 Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points 9-532 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements GEOM4 EPT MATPOOL Table of Bulk Data entry images related to constraints, degree-of-freedom membership, and rigid element connectivity Table of Bulk Data entry images related to element properties Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries. Required for DMIG and virtual mass partitioning with domain solver ACMS=‘YES’ Table of Bulk Data entry images related to dynamics. Grid points on DPHASE, DELAY, TIC, and DAREA records are assigned to the residual structure if ACMS=‘YES’ Table of Case Control command images. Required for MFLUID set identification number. Matrix. Must be square and symmetric. External grid/scalar point identification number list Degree-of-freedom set membership table for g-set Scalar index list DYNAMIC CASECC MAT GPL USET SIL Output Data Block: GEOM1Q TIMSIZ GEQMAP BNDFIL SPCPART SEQMAP LGPART GEOM2X GEOM4X Same as GEOM1 except SEQGP Bulk Data entry records have been added and any pre-existing SEQGP records are removed Table of CPU and disk space estimation parameters Table of grid based local equation map indicating which grid resides on which processors/partitions for domain decomposition Table containing the local and global boundary grids in the order given by extreme for domain decomposition Partitioning vector for domain decomposition Mapping matrix for resequencing Same as SPCPART except it includes disjoint grid points GEOM2 table augmented with fluid data and SPOINTS if ACMS=‘YES‘ 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’ NX Nastran DMAP Programmer’s Guide 9-533 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: SEQOUT Input-integer-default=0. Output options: 0 1 2 3 SEQMETH No output Print a formatted table of the internal vs. external grid identification number Write the SEQGP entries to the punch file (.pch) Combines 1 and 2 Input/output-integer-default=3. Resequencing method: -1 1 2 3 No resequencing is performed. Active/passive Band For the active/passive and the band options, select the option giving the lowest RMS value of the active columns for each group of grid points (default). Wavefront (Levy) Gibbs-King. See Remark 4. Automatic nested dissection. See Remark 4. Multiple Minimum Degree of Freedom. See Remarks 3 and 4. Semiautomatic selection. See Remark 5. 4 5 6 7 8 On output, METHOD is set to -1 if new sequence results in a lower decomposition time estimate. Otherwise it is set to 0. SETNAME SUPER FACTOR MPCFLG Input-character-default=‘G’ Degree-of-freedom set name corresponding to the size of MAT (Format 2 only). Input-integer-default=0. Selects coupled or uncoupled sequencing or special handling of multipoint constraints. Input-integer-default=0. Factor in the computation of the sequenced identification number (SEQID) on the SEQGP. See Remark 7. Input-integer-default=0. Controls whether the grid point connectivity created by multipoint constraint Bulk Data entries (MPC, MPCADD, and MPCAX and the rigid element entries; for example, RBAR) is considered during resequencing. -1 Do not consider 9-534 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 0 >0 Consider (default) Consider only the MPC, MPCADD, and MPCAX entries with a set identification number equal to this parameter‘s value as well as the of the rigid element entries START MSGLVL Input-integer-default=0. The number of the grid points at the beginning of the input sequence. See Remark 8. Input-integer-default=0. Diagnostic output flag. 0 >0 No Yes PEXIST PSEQOPT Input-logical-default=FALSE. If set to TRUE, it specifies the existence of p-elements. Input-character-default=’ ’ Specifies append (default) or insert option for p-elements. See Remark 9. Input/output-integer-default=0. The number of domains (tip superelements to be created automatically when ACMS=‘YES’ If NTIPS=0, the number of domains is set equal to the number of processors. Input-character-default=” Analysis type. Allowable values: STATICS REIGEN FREQRESP TRANRESP CEIGEN Statics Normal modes Frequency response Transient response Complex eigenvalues NTIPS APP ZCOLLCT Input/output-integer-default=-1. The absolute value is the number of collectors in the last level of a multilevel tree (see ACMS=‘YES). If ZCOLLCT<0, a single final collector is added. Input/output-integer-default=-1. The number of tip superelements upstream of each downstream collector superelement. See ACMS=‘YES’ Input-character-default=” Automatic Component Mode Synthesis flag. If ACMS=‘YES‘, the model is automatically partitioned into superelements according to NTIPS, TIPSCOL, and ZCOLLCT. Output-integer-default=0. Fluid superelement identification number. Set to a value greater than zero if ACMS=‘YES’and fluid elements are present. TIPSCOL ACMS FLUIDSE NX Nastran DMAP Programmer’s Guide 9-535 Chapter 9 Descriptions of DMAP Modules and Statements Remarks: 1. In the geometry table option, SEQP generates SEQGP Bulk Data entries to be appended to 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 can be purged if SEQOUT=0. 3. UGS recommends SEQMETH=7 for sparse decomposition and sparse forward-backward substitution only. The assembly of stiffness, mass, and damping matrices by the EMA module can be less efficient under this option. Also, if there is insufficient memory available to perform sparse decomposition, regular decomposition is performed and regular decomposition is inefficient under this option. 4. SEQMETH=5, 6, or 7, resequencing is performed even if the CPU estimate is higher than for no resequencing. 5. For SEQMETH=8, the estimates are computed for two sequencing methods that are suitable for the decomposition method selected by the PARALLEL and SPARSE keywords on the NASTRAN statement. Also selects the sequencing method with the lowest estimate. The following table shows the suitable methods for each decomposition method. Decomposition method Non-sparse and non-parallel Parallel Sparse 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, all points that are connected to multipoint constraints (via MPC entries) or rigid elements (for example, the RBAR entry) are placed in a special group at the end of the sequence. This option also forces SEQMETH=6 and cannot 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; for example, a model with disjoint structures connected only by MPCs or rigid elements. See the NX Nastran Numerical Methods User’s Guide for a further discussion of sequencing operations. Suitable SEQMETH 1 and 4 2 and 5 6 and 7 • • 7. FACTOR is used as follows: SEQID = FACTOR * GRP + SEQ where SEQ is a generated sequence number and GRP is a group sequence number. 9-536 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements If GRP=0, use GRP(MAX)+1 where GRP(MAX) is the largest group sequence number previously processed. 8. START specifies that the input sequence is 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 is 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, that is, 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, that is, SEQMETH = -1, 1, 2, 3 or 4. • Example: The following example generates a mapping matrix (SEQMAP) to resequence the matrix KAA. The following SMPYAD module resequences the rows and columns of KAA. Following the decomposition of the resequenced matrix (KAAX), the MPYAD resequences the right-hand side (PA) and FBS performs the forward/backward substitution on the resequenced right-hand side (PAX). The final MPYAD operation returns the solution (UAX) to the original sequence (UA). SEQP SMPYAD DECOMP MPYAD FBS MPYAD KAA,,,/SEQMAP,//METHOD $ SEQMAP,KAA,SEQMAP,,,/KAAX/3////1////6 $ KAAX/LAA,/ $ SEQMAP,PA,/PAX/1 $ LAA,, PAX/UAX/ $ SEQMAP,UAX,/UA/ $ 9.297 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 $ Input Data Blocks: CASECC YGBNDR Table of Case Control command images for the primary model Boundary shape matrices appended for all auxiliary or geometric models NX Nastran DMAP Programmer’s Guide 9-537 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: CASECC1 CVEC Primary model Case Control table appended with extra subcases to account for the boundary shapes Partitioning vector for separating the primary model solutions from boundary shape induced solutions Parameters: None. 9.298 SMA3 Assembles global stiffness based on general elements in GENEL Bulk Data entry Assembles the global stiffness based on general elements as defined on the GENEL Bulk Data entry and optionally adding to stiffness from regular elements. Format: SMA3 GEI,KGG/ KGG1/ LUSET/NOGENL/NOSIMP $ Input Data Blocks: GEI KGG Table of general element data Stiffness matrix in g-set with general elements Output Data Block: 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: LUSET NOGENL NOSIMP Input-integer-no default. The number of degrees-of-freedom in the g-set. Input-integer-no default. The number of general elements. Input-integer-no default. The number of simple elements. Set to -1 if there are no elements. Remarks: KGG can be purged. 9-538 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.299 SMPYAD Matrix series multiply and add Multiplies a series of matrices together: [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 Input Data Blocks: A, B, C, D, E F Matrices multiplied from left to right (real or complex) Matrix to be added to the above product (real or complex) Output Data Block: X Resultant matrix Parameters: NMAT SIGNP SIGNF PREC TA, TB, TC, TD FORM Integer-input-no default. Number of matrices involved in the product; that is, [A][B][C][D][E]. Integer-input-default=1. Sign of the product matrix (that is, [A] [B] [C] [D] [E]): -1 for minus. Integer-input-default=1. Sign of the matrix. [F], to be added to the product matrix: -1 for minus. Integer-input-default=0. Output precision of the final result: 0 for choose proper precision, 1 for single precision, 2 for double precision. Integer-input-default=0. Transpose indicators for the [A] [B] [C] and [D] matrices: 1 if transposed matrix to be used in the product, 0 if untransposed. The last nonpurged matrix must be untransposed. Integer-input-default=0. Form of the X matrix. If FORM is zero, the form of [X] is 1 if the result is square, 2 otherwise. If [X] is known to be symmetric from physical principles, FORM can be set to 6. Remarks: 1. Except for the final product, all intermediate matrix products are computed in machine precision. NX Nastran DMAP Programmer’s Guide 9-539 Chapter 9 Descriptions of DMAP Modules and Statements 2. The matrices are post-multiplied from right to left; that is, 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, 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; that is, [X] = [A]T[B][A] ± [F], a method that is more efficient than two equivalent MPYAD operations is employed. See Example 3. However, two equivalent MPYAD operations are 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, the module does not create any output. Examples: 1. Compute [X] = [A] [B]T [C] - [F]. SMPYAD A,B,C,,,F/X/3/1/-1/0/0/1 $ 2. Compute [Z] = -[U]T [V]T [W]T [X]T [Y]. SMPYAD U,V,W,X,Y,/Z/5/-1/0/0/1/1/1/1 $ 3. Compute [φ]T[M] [φ]. SMPYAD PHI,MAA,PHI, ,,/X/3////1////6 $ 9.300 SOLVE Linear system solver Solves the matrix equation [A] [X] = ± [B] or the left-hand solution [X]T[A] = ± [B]T. Format: SOLVE A,B,SIL,USET,PARTVEC/ X/ SYM/SIGN/SETNAME $ Input Data Blocks: A B SIL USET Square, symmetric or unsymmetric, matrix (real or complex) Rectangular matrix (real or complex) Scalar index list Degree-of-freedom set membership table 9-540 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements PARTVEC Partitioning vector which is specified when A and B are the zero-th partitions of the set specified by SETNAME Output Data Block: X Rectangular matrix. See Remark 1. Parameters: SYM Input integer default = 0 selects solution method. 0 1 -1 2 3 SIGN Use either symmetric or unsymmetric method consistent with symmetric or unsymmetric [A]. Use symmetric method Use unsymmetric method Solve left-hand solution for [X]T Compute inverse of [A]. See Remark 2. Input integer default = 1. Sign of right-hand side flag. 1 -1 Solve [A] [X] = [B] Solve [A] [X] = [-B] SETNAME Input-character-default = ‘H.’ Degree-of-freedom set name corresponding to A and B. 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, [B] is ignored. If SYM≠ 3 and [B] is purged, [X] is purged; or if [B] is a null matrix, [X] is 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. PVEC is required only if A is not the same size as SETNAME. NX Nastran DMAP Programmer’s Guide 9-541 Chapter 9 Descriptions of DMAP Modules and Statements Examples: 1. Solve a system of equations [A] [X] = [P]. SOLVE A,P,,,/X/ $ 2. Invert [A]. SOLVE A,,,,/AINV/3 $ 3. Solve [X]T [A] = [P]T. SOLVE A,P,,,/X/2 $ 9.301 SOLVIT Iterative solver Solves the matrix equation [A] [X] = ± [B] for [X] using a preconditioned conjugate gradient method. Format for global non-p-version solution: SOLVIT A,B,XS,PC,USET,KGG,GM,SIL,EQEXIN,EDT,CASECC,EQMAP/ X,R,PC1,EPSSE/ SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/ NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID $ Format for global p-version solution: SOLVIT A,B,XS,PS,USET,USET0,SIL0,SIL,EQEXIN,EDT,CASECC, EQMAP/ X,R,PG,EPSSE/ SIGN/ITSOPT/ITSEPS/ITSMAX/IPAD/IEXT/ADPTINDX/ NSKIP/MSGLVL/PREFONLY/S,N,ITSERR/SEID $ Input Data Blocks: A B XS PC USET KGG GM USET0 SIL SIL0 Square matrix (real or complex, symmetric or unsymmetric) Rectangular matrix (real or complex), the right-hand side Optional starting vector, same type as B (can be purged) Optional stepwise preconditioner, same type as A (can be purged. Degree-of-freedom set membership table. See Remark 3. Stiffness matrix - g-set. See Remark 3. Multipoint constraint transformation matrix. See Remark 3. USET table from previous adaptivity index in p-version analysis Scalar index list SIL table from previous adaptivity index in p-version analysis 9-542 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements EQEXIN EDT CASECC EQMAP Equivalence table between external and internal grid/scalar identification numbers. Required for p-version preconditioning only. Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Table of Case Control command images. Required if SMETHOD Case Control command is used and NSIP=-1. Table of degree-of-freedom global-to-local maps for domain decomposition Output Data Blocks: X R PC1 EPSSE Solution matrix. Rectangular matrix having the same dimensions and type as [B]. Residual matrix. Rectangular matrix having the same dimensions and type as [B], the residual [R] = [B] - [A][X]. Updated stepwise preconditioner matrix. See Remark 6. Table of epsilon and external work Parameters: SIGN Input-integer-default = 0. Sign flag for [B]. 0 : + [B] 1 : - [B] ITSOPT Input-integer-default = 0. Preconditioner flag. 0 Choose optimal method based on type of problem: ITSOPT Type of problem 6 p-version and real [A] and [B] 10 complex [A] and/or [B] 11 non p-version and real [A] and [B] 1 2 3 4 5 6 Jacobi preconditioning (default) for real, complex, symmetric and unsymmetric A Incomplete Cholesky preconditioning or user-given preconditioner Reduced incomplete Cholesky preconditioning. preconditioner (available for real symmetric A only) User supplied for real, complex, symmetric A Incomplete geometric, Jacobi hierarchic for real symmetric A Complete geometric, Jacobi hierarchic for real symmetric A NX Nastran DMAP Programmer’s Guide 9-543 Chapter 9 Descriptions of DMAP Modules and Statements 7 10 11 <0 ITSEPS ITSMAX IPAD Complete geometric, incomplete hierarchic for real symmetric A Block incomplete Cholesky for well-conditioned real symmetric A (default for real A) Block incomplete Cholesky for well-conditioned complex symmetric A (default for complex A) Same as above with diagonal scaling Input-real-default = 1.0E-6. Convergence parameter epsilon. Input-integer-default = 0. Maximum number of iterations. The default value implies N/4 (N = dimension of [A]). Input-integer-default = 0 (see table below). Padding level for reduced or block incomplete Cholesky factorization (0, 1, 2, ...). See Remarks 1 and 2. See also . Method Reduced incomplete Cholesky Block incomplete Cholesky Block incomplete Cholesky Block incomplete Cholesky ITSOPT 3 10,11 10,11 10,11 Model type all 3-D 2-D or mixed all Type of [A] real real real complex IPAD default 0 2 3 5 IEXT Input-integer-default = 0. Extraction level in reduced or block incomplete Cholesky factorization. See Remarks 1 and 2. See also . Reduced 0 solid bodies, no rigid elements. 1 shells only 2 mixed including rigid elements Block Requires USET and SIL Heuristic block structure (default) N/A IPAD default 0 1 2 ADPTINDX NSKIP Input-integer-default=0. P-version analysis adaptivity index. See Remark 7. Input-integer-default=1. Record number of current subcase in CASECC and used only if the SMETHOD command selects the ITER Bulk Data entry which specifies values for the desired iteration parameters. If NSKIP=-1, CASECC is not required and the values are taken from the module specification of the values. Input-integer-default=0. Message level output. See . MSGLVL 9-544 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 0 1 PREFONLY ITSERR Minimal; that is, UIM 6447 (default) UIM 6447, convergence ratios, and residual norms Input-integer-default=0. Preface execution only. If set to -1, SOLVIT is terminated after the preface information is computed and printed. Output-integer-default=0. Iterative solver return code. 1 2 No convergence Insufficent memory SEID Input-integer-default=0. Superelement identification number. Remarks: 1. If ITSOPT = 3, UGS recommends that the IPAD level is 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 can 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, the results are still printed but can be inaccurate. 5. The system cell SYSTEM (69) is equivalent to the SOLVE keyword and controls some special options for the module: SOLVE 2 8 Action Suppresses the user information message at each iteration Use alternative convergence criterion (less conservative than default) 6. If data block PC1 is specified, the CPU time increases slightly. 7. If SOLVIT is to be used for p-element analysis and ADPTINDX>1, 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 $ NX Nastran DMAP Programmer’s Guide 9-545 Chapter 9 Descriptions of DMAP Modules and Statements 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 $ Format for element based solution: SOLVIT KELM,PG,KDICT,SIL,ECT,BGPDT,CSTM,EDT,CASECC,USETB,RG,MPT, YGB,SLT,MDICT,MELM,EPT,CNELM,ELCNST,ELCTST/UGV1,QG1,/V,Y,ISIGN/V,Y,IOPT/ S,N,ITSEPS/V,Y,ITSMAX/V,Y,IPAD/V,Y,IEXT//NSKIP/V,Y,IMSGFL/ V,Y,IDEBUG/V,Y,IERROR $ Input Data Blocks: KELM PG KDICT SIL ECT BGPDT CSTM EDT CASECC USETB RG MPT YGB SLT MDICT MELM EPT Element stiffness matrix Load vector in g set Element stiffness dictionary Scalar index list Element connectivity table Basic grid point data table Coordinate system transformation matrix Element data table Case control command images Degree-of-freedom set membership table Constraint matrix in g set Material property table Specified non-zero displacements in g set Static load table Mass dictionary Element mass matrix Element property table 9-546 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CNELM ELCNST ELCTST Glue element definition Element normal stiffness Element tangential stiffness Output Data Blocks: UGV1 QG1 Displacements - g set SPC forces - g set Parameters: ITSEPS ITSMAX ITSERR Input-real-default = 1.0E-6. Convergence parameter epsilon. Input-integer-default = 1000. Maximum number of iterations. Output-integer-default = 0. Iterative solver return code. 9.302 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 Input Data Blocks: SLT BGPDT Table of static loads Basic grid point definition table NX Nastran DMAP Programmer’s Guide 9-547 Chapter 9 Descriptions of DMAP Modules and Statements CSTM MEDGE EST MPT ETT EDT Table of coordinate system transformation matrices Edge table for p-element analysis Element summary table Table of Bulk Data entry images related to material properties Element temperature table Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver. Also contains SET1 entries. Mass or radiation matrix in g-set. Table of Case Control command images Table of TABLEij Bulk Data entry images Displacement matrix in g-set Table of DEQATN Bulk Data entry images Index table to DEQATN data block Grid point shell normal table Table of coordinate system transformation matrices for the residual structure Table of global transformation matrices for partitioned superelements Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid element connectivity. Required for selected SPCD existence checks. Table of Bulk Data entry images related to element properties Table containing LAM option input and expanded information from the PCOMP Bulk Data entry MGG CASECC DIT UG DEQATN DEQIND GPSNT CSTM0 SCSTM GEOM4 EPT PCOMPT Output Data Blocks: PG AG PTELEM SLTH Static load matrix applied to the g-set Acceleration matrix due to inertial loads in the g-set. See DSENS. Table of thermal loads in the elemental coordinate system Table of static loads updated for heat transfer analysis 9-548 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: LUSET NSKIP DSENS APP Input-integer-no default. The number of degrees-of-freedom in the g-set Input-integer-default=1. The record number in CASECC corresponding to the first subcase of the current boundary condition. Input-integer-default=-1. Acceleration matrix creation flag. Set to 1 to generate AG, accelerations due to inertial loads. Input-character-default=‘STATICS’ Analysis type. ‘STATICS’ ‘BUCK’ ‘NLST’ ‘ALL’ ALTSHAPE Generate loads for current boundary condition only Generate loads for first subcase only Generate loads for nonlinear static or steady state heat transfer analysis Generate loads for all subcases 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. Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying temperatures in Fahrenheit. Input-integer-default=0. Superelement identification number. TABS SEID Remarks: 1. One static load is built for each CASECC record starting with NSKIP + 1 as long as the boundary conditions are constant. IF NSKIP ≤ 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. NX Nastran DMAP Programmer’s Guide 9-549 Chapter 9 Descriptions of DMAP Modules and Statements 9. DIT cannot be purged if temperature-dependent materials are present. 10. UG can be purged, but geometric nonlinear effects are ignored. 11. PTELEM can be purged. 12. CSTM0 and SCSTM are required to support the MB=-1 on the GRAV and RFORCE Bulk Data entries. 9.303 Format: SSG2 SSG2 Reduces static load and enforced displacement matrices USET,GM,YS,KFS,GOA,DM,PG/ QR,PO,PS,PA,PL $ Input Data Blocks: USET GM YS KFS GOA DM PG Degree-of-freedom set membership table for g-set Multipoint constraint transformation matrix, m-set by n-set Matrix of enforced displacements or temperatures Stiffness matrix partition (f-set by s-set) from KNN Omitted degree-of-freedom transformation matrix, o-set by a-set Rigid body transformation matrix for the r-set to the l-set Static load matrix applied to the g-set Output Data Blocks: QR PO PS PA PL Matrix of determinate support forces Static load matrix partitioned to the o-set Static load matrix partitioned to the s-set Static load matrix reduced to the a-set Static load matrix reduced to the l-set Parameters: None. 9-550 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 can be purged. 6. If there is no m-set, s-set, o-set, or r-set. no outputs are produced. 7. If QR or PS are computed to be null, QR or PS are purged. 8. If there is no r-set and PL is specified, PA is copied to PL. 9. If KFS or YS is purged, the outputs do not include the effect of enforced displacements. 9.304 SSG3 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 $ Input Data Blocks: LLL UNUSED2 KLL PL LOO UNUSED6 KOO PO LSEQ Lower triangular factor/diagonal for the l-set from KLL Unused and can be purged Stiffness matrix reduced to the l-set Static load matrix reduced to the l-set Lower triangular factor/diagonal for the o-set from KOO Unused and can be purged Stiffness matrix partitioned to the o-set from KFF Static load matrix partitioned to the o-set Resequencing matrix based on internal resequencing of KLL in DCMP NX Nastran DMAP Programmer’s Guide 9-551 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: UL UO RUL RUO EPSSE Displacement matrix in l-set Displacement matrix in o-set Residual matrix for the l-set Residual matrix for the o-set Table of epsilon and external work. Parameters: NOOSET UNUSED2 NSKIP EPSI EXTWORK SEID Input-integer-no default. Number of degrees-of-freedom in the o-set or omitted degree-of-freedom flag. Set to -1 if there are none. Input-integer-no default. Not used, but specify 0. Input-integer-default=1. The record number in CASECC corresponding to the first subcase of the current boundary condition. Output-integer-default=1. Static solution error ratio flag. Set to -1 if the error ratio is greater than 1.E-3. Output-real-default=0.0. External work. Input-integer-default=0. Superelement identification number. Remarks: 1. KLL can be purged if RUL is purged. 2. LOO, PO and UO can be purged if NOOSET<0. 3. KOO can be purged if NOOSET<0 or RUO is purged. 4. LLL or LOO can be purged. 5. PO or PL can be purged. 6. RUL and RUO can be purged. 9.305 SSG4 Updates static loads with inertial loads 9-552 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: SSG4 PL,QR,PO,MR,MLR,DM,MLL,MOO,MOA,GOA,USET/ PLI,POI/ NOOSET $ Input Data Blocks: PL QR PO MR MLR DM MLL MOO MOA GOA USET Static load matrix reduced to the l-set Matrix of determinate support forces Static load matrix partitioned to the o-set Rigid body mass matrix (r-set by r-set) Mass matrix partition (l-set by r-set) from MTT Rigid body transformation matrix for the r-set to the l-set Mass matrix reduced to the l-set Mass matrix partitioned to the o-set from KFF Mass matrix partition (o-set by a-set) from MFF Omitted degree-of-freedom transformation matrix, o-set by a-set Degree-of-freedom set membership table for g-set Output Data Blocks: PLI POI Static load matrix with inertial loads and reduced to the l-set Static load matrix with inertial loads and reduced to the o-se Parameter: NOOSET Input-integer-no default. Number of degrees-of-freedom in the o-set or omitted degree-of-freedom flag. Set to -1 if there are none. 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. 2. All input and output matrices must be present if their corresponding degree-of-freedom set is present. If PLI is purged, PL, MLR, and MLL can be purged. NX Nastran DMAP Programmer’s Guide 9-553 Chapter 9 Descriptions of DMAP Modules and Statements 9.306 STATICS Performs static analysis on real symmetric stiffness matrix Performs static analysis on real symmetric stiffness matrix using the iterative or direct methods for the solution and Lagrange Multiplier techniques for constraint processing. Also designed and implemented to take advantage of distributed memory parallelism (DMP) or networked computers. Format: 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 $ Input Data Blocks: KGG PG YS RMG CASECC USET EQEXIN SIL XS PC EDT Stiffness matrix in g-set Static load matrix applied to the g-set Matrix of enforced displacements Multipoint constraint equation matrix Table of Case Control command images Degree-of-freedom set membership table for g-set Equivalence table between external and internal grid/scalar identification numbers Scalar index list Optional starting vector, same as PG Optional stepwise preconditioner, same as KGG Table which contains ITER Bulk Data entries. Required for NSKIP=-1 only. Output Data Blocks: UG PC1 RUG QG QMG Displacement matrix in g-set Updated stepwise preconditioner matrix. Residual matrix for the g-set Single-point constraint forces of constraint matrix in the g-set Multipoint constraint forces of constraint matrix in the g-set 9-554 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: STATOPT Input-character-no default. Static solution method. ‘DRCT’ ‘ITER’ SIGN Direct Iterative Input-integer-default=1. Sign of right hand side matrix, PG. 1 -1 Positive Negative ITSOPT ITSMAX ITSEPSR NSKIP Input-integer-default=1. Preconditioner flag. See the “SOLVIT” module. Input-integer-default=1. Maximum number of iterations for iterative solution method. Input-real-default=1.E-6. Convergence parameter epsilon for iterative solution method. Input-integer-default=1. Record number of current subcase in CASECC and used only if the SMETHOD command selects the ITER Bulk Data entry which specifies values for the desired iteration parameters. If NSKIP=-1, CASECC and EDT are not required and the values are taken ITSOPT, ITSMAX, and ITSEPSR. Input-integer-default=1. Single-point forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. Input-integer-default=1. Multipoint forces of constraint matrix creation flag. Default of 1 requests computation of the forces. Specify -1 to request no computation. Input-integer-default=-1. Number of solutions to check and the quantity of error checking output. If left at its default value, only the highest epsilon for the first ten solutions (whichever is less) are printed. If EPSNO is greater than zero, the epsilons for the first EPSNO are printed. NOQG NOQMG EPSNO Remarks: 1. See the “SOLVIT” module for further discussion related to the iterative method. 2. PC, XS, PC1, and RUG can be purged. 3. CASECC and EDT can be purged if NSKIP=-1. 4. ITSOPT, ITSMAX, and ITSEPSR are ignored if NSKIP>0. NX Nastran DMAP Programmer’s Guide 9-555 Chapter 9 Descriptions of DMAP Modules and Statements 9.307 Format: STDCON STDCON Calculate stress discontinuities across elements and grid points CASECC,EGPSF,EQEXIN,OES1,EGPSTR,ECT/ OEDS1,OGDS1,ELDCT,GPDCT/ S,N,NOEDS1/S,N,NOGDS1/S,N,NOELDCT/S,N,NOGDCT/APP $ Input Data Blocks: CASECC EGPSF EQEXIN GPL OES1 EGPSTR ECT Table of Case Control command images Table of element to grid point interpolation factors Equivalence table between external and internal grid/scalar identification numbers External grid/scalar point identification number list Table of element stresses or strains in SORT1 format Table of grid point stresses or strains for post-processing in the DBC module Element connectivity table Output Data Blocks: OEDS1 OGDS1 ELDCT GPDCT Table of element stress discontinuities Table of grid point stress discontinuities Table of element stress discontinuities for post-processing in the DBC module Table of grid point stress discontinuities for post-processing in the DBC module Parameters: NOEDS1 NOGDS1 NOELDCT NOGPDCT Output-integer-default=-1. OEDS1 generation flag. Set to 0 if OEDS1 is generated. Output-integer-default=-1. OGDS1 generation flag. Set to 0 if OGDS1 is generated. Output-integer-default=-1. ELDCT generation flag. Set to 0 if ELDCT is generated. Output-integer-default=-1. GPDCT generation flag. Set to 0 if GPDCT is generated. 9-556 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements APP Input-character-default=‘STATICS. Analysis type. Allowable values: ‘STATICS’ ‘REIGEN’ Statics Normal modes 9.308 STRSORT Filters and sorts element data recovery tables Format: STRSORT OFPE,INDTA/ OFPES/ NUMOUT/BIGER/SRTOPT/SRTELTYP/SRTTYP $ Input Data Blocks: OFPE INDTA Element data recovery table in SORT1 or SORT2 format Table of element stress/strain or force item code overrides Output Data Blocks: OFPES Filtered and sorted element data recovery table Parameters: NUMOUT Input-integer-default=-1. Output element quantity flag. >0 0 -1 -2 BIGER SRTOPT Number of element quantities per element type to be output Output all quantities for elements in a group if the absolute value of one or more elements is greater than BIGER Output sorted quantities with absolute value greater than BIGER Output filtered quantities with absolute value greater than BIGER Input-real-default=0.0. Minimum absolute value of element quantity to be output. Input-integer-default=0. Filter/sort option based on NUMOUT and BIGER. 0 1 Maximum magnitude Minimum magnitude NX Nastran DMAP Programmer’s Guide 9-557 Chapter 9 Descriptions of DMAP Modules and Statements 2 3 SRTELTYP SRTTYP Maximum algebraic Minimum algebraic Input-integer-default=0. Element type to be filtered and sorted. By default, all element types are filtered and sorted. Input-integer-default=0. Item code 1 sort flag. Set to 1 to perform an integer sort on item code 1 which is usually an integer quantity. Remarks: 1. For further discussion see the DTI,INDTA and PARAM,S1 descriptions in the NX Nastran Quick Reference Guide. 2. SRTTYP=1 is used primarily to sort slideline element output by slave grid point identification number. 9.309 TA1 Combines element data into tables Combines all of the element data (geometry, connection, and properties) into a table(s) convenient for generation of the element matrices (stiffness, mass, and so on) and output quantities (stress, force, and so on). Format: MPT,ECT,EPT,BGPDT,SIL,ETT,CSTM,DIT,ECTA,EHT/ EST,ESTNL,GEI,GPECT,ESTL,VGFD,DITID,NFDICT/ LUSET/S,N,NOESTL/S,N,NOSIMP/NOSUP/S,N,NOGENL/SEID/ LGDISP/NLAYERS/S,N,FREQDEP $ TA1 Input Data Blocks: MPT ECT EPT BGPDT SIL ETT CSTM DIT Table of Bulk Data entry images related to material properties Element connectivity table Table of Bulk Data entry images related to element properties Basic grid point definition table Scalar index list Element temperature table Table of coordinate system transformation matrices Table of TABLEij Bulk Data entry images 9-558 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements ECTA EHT Secondary element connectivity table Element hierarchical table for p-element analysis Output Data Blocks: EST ESTNL GEI GPECT ESTL VGFD DITID NFDICT Element summary table Nonlinear element summary table Table of general element data Grid point element connection table Linear element summary table Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to frequency-dependent elements Table of identification numbers in DIT Nonlinear element energy/force index table Parameters: LUSET NOESTL NOSIMP NOSUP Input-integer-no default. The number of degrees-of-freedom in the g-set. Output-integer-no default. ESTL generation output flag. Set to 1 if ESTL is generated; -1 otherwise. Output-integer-no default. The number of elements exclusive of general elements. Set to -1 if there are no simple elements. Input-integer-no default. Element summary table request flag. 1 2 NOGENL SEID LGDISP Generate EST only (usually for linear analysis) Form EST, ESTNL and ESTL (usually for nonlinear analysis) Output-integer-no default. The number of general elements.Set to -1 if there are no general elements. Input-integer-no default. Superelement identification number. Input-integer-default=1. Large displacement and follower force flag. -1 1 2 No large displacement and follower force effects are considered Large displacement and follower force effects are considered Only large displacement effects are considered NX Nastran DMAP Programmer’s Guide 9-559 Chapter 9 Descriptions of DMAP Modules and Statements NLAYERS FREQDEP Input-integer-default=6. Number of layers to integrate through the thickness of CQUAD4 and CTRIA3 elements in nonlinear analysis. Output-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE if frequency-dependent elements are present. Remarks: 1. MPT, ESTL, and ESTNL can be purged if NOSUP=1. 2. ECTA and EHT can be purged if p-elements or interface elements are not present. 3. GEI, ESTL, ESTNL, and DITID can be purged as long as EST is purged. 4. VGFD can be purged. 5. DITID can be purged as long as DIT is purged. 9.310 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 comes 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 $ Input Data Blocks: TOLD CONTROL Table data block to be edited. Cannot be purged, and in general, contains string-formatted records. Table data block containing directives that control the editing process as described under Remarks (it usually comes from DTI input). If CONTROL is purged, TNEW is copied from TOLD. Secondary tables to be merged into TOLD. Can be purged. TA,TB,TC 9-560 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Output Data Block: TNEW Updated table data block from the edit process. Cannot be purged. Parameters: MSGLVL Input-integer-default=0. Print activity option. <0 =0 >0 DUPWG Print information messages and trace editing process Print information messages only No print activity occurs Input-integer-default=0. Duplicate word group option and applicable only to the Merge-Edit option. =0 =1 Duplicate word groups are dropped from TOLD. Duplicate word groups are added after TOLD version. UNUSED3 UNUSED4 Input-integer-default=0. Unused. Input-integer-default=0. Unused. 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 ER QR, i DR, i or DR ,i ,j IR, i CR, i, options Remarks End Record-Edit processing by copying rest of TOLD to TNEW. This directive is optional. Quit Record-Edit processing by copying rest of TOLD onto TNEW through record i and exiting Delete Record i (or records i through j) from TOLD after copying up to record i Insert Records from TOLD after copying up to record i 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 NX Nastran DMAP Programmer’s Guide 9-561 Chapter 9 Descriptions of DMAP Modules and Statements TABEDIT directives Directive KRA,n KRB,n KRC,n SRA,n SRB,n SRC,n MEA,i,n MEB,i,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. Merge-Edit the next record on TA, TB, or TC into record i according to IFP specifications for fixed-length word groups of length n. Skip n Records forward on TA, TB, or TC. Used to position secondary data block TA, TB, or TC for a subsequent KR* operation. Remarks Copy n Records from TA, TB, or TC onto TNEW 2. The CR directive requires at least one subdirective from the table below: CR sub-directives Sub-directive QW, i DW, i, j, n,n words Remarks Quit after copying Word i. Record specified by CR directive is copied through word i and the rest of the record is ignored. Delete Words i through j of the record specified by the CR directive and replace by the n words that follows on the CR directive record Insert after Word i of the record specified by the CR directive the n words that follow on the CR directive record Copy n Words from TA, TB, or TC onto TNEW IW, i, n,n words KWA,n KWB,n KWC,n SWA,n SWB,n SWC,n Skip n words forward on TA, TB, or TC. Used to position secondary data block TA, TB or TC for a subsequent KW* operation. 9-562 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements CR sub-directives Sub-directive AWA,n AWB,n AWC,n KRA,n KRB,n KRC,n ARA ARB ARC 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. Append the Remaining contents of the current record from TA, TB, or TC onto TNEW after copying the rest of the record specified by the CR directive Copy the Remaining contents of the current record from TA, TB, or TC onto TNEW Remarks Append n Words from TA, TB, or TC onto TNEW after copying the rest of the record specified by the CR directive. Examples: Let GEOM1 generated by a previous run have a third record consisting of the five GRID entries. GRID,10,0,0.0,0.0,0.0,0,3456,0 GRID,20,0,1.0,1.0,0.0,0,3456,0 GRID,30,0,2.0,2.5,0.0,0,3456,0 GRID,40,0,3.0,3.0,0.0,0,3456,0 GRID,50,0,4.0,4.0,0.0,0,3456,0 A printout of GEOM1 using the TABPRT module (with OPT3=1) shows the following for record 1: 1. Note that the GRID entry for grid point 30 has an error in the y-location coordinate, which should be 2.0 instead of 2.5. Make this correction without going through the conventional NX Nastran DMAP Programmer’s Guide 9-563 Chapter 9 Descriptions of DMAP Modules and Statements 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 that 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 $ 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 that 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 9.311 TABPRT Formatted table printer Formatted print of selected table data blocks. 9-564 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format 1: TABPRT TABLE//KEY/OPT1//OPT3 $ Format 2: (KEY=’USET’) g-set TABPRT TABPRT USET,BGPDT//USET/OPT1/OPT2// SETSTR1/SETSTR2/SETSTR3/SETSTR4 $ 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 $ Input Data Blocks: TABLE USET EQEXIN SIL BGPDT USETD EQDYN SILD AEUSET AEBGPDT ESTDATA TIMSIZ SGPDT Table data block Degree-of-freedom set membership table for g-set Equivalence table between external and internal grid/scalar identification numbers Scalar index list Basic grid point definition table Degree-of-freedom set membership table for p-set Equivalence table between external and internal grid/scalar/extra point identification numbers Scalar index list for p-set Degree-of-freedom set membership table for ks-set Basic grid point definition table for the ks-set Table of superelement estimation data overrides Table of CPU and disk space estimation parameters Superelement basic grid point definition table NX Nastran DMAP Programmer’s Guide 9-565 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: KEY OPTi Input-character-default=‘FINDIT’. Identifies the generic name of the data block. Input-integer-default=0. Print control 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). -1 0 >0 All sets in the following table Mutually exclusive sets only; that is, sets M, SB, SG, O, Q, R, C, BE, BF, E, SA, K, and A. Obsolete method for selecting mutually exclusive sets only according to the sum of their decimal equivalent numbers in the following table. For supersets and a more user-friendly method, use SETSTRi. In order to select specific sets to be printed, add the corresponding decimal equivalent numbers. For example, sets R, O, and M, OPT2=8+4+1=13. SetName Q BE C K SA E SB SG R O BF M EquivalentDecimalNumber 4194304 2097152 1048576 262144 131072 2048 1024 512 8 4 2 1 9-566 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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) that is 32 characters in length. For example, SETSTR1=‘M R N SG’and SETSTR2=‘A Q’specifies that the m, r, n, sg, a, and q sets be printed. There are two table print options controlled by OPT3. If OPT3=0 (default); TABPRT TABLE//KEY/OPT1 $ format statements built into TABPRT are used to print TABLE, as selected by KEY. These formats are limited to only those values of KEY listed in the table below. TABLE BGPDT CSTM EQDYN EQEXIN ETT GPDT GPL GPLD GPTT SEMAP any USET If OPT3≠ 0; TABPRT TABLE//NDDLNAME/OPT1//OPT3 $ KEY BDPDT CSTM EQEXIN EQEXIN ETT GPDT GPL GPLD GPTT SEMAP FINDIT USET 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, the printout contains no item name labels. OPT3 Input-integer-default=0. If OPT3≠0, the table is printed in a format similar to the TABPT module with the following options: 1 Print with labels defined under the DATABLK statement for data block name specified for parameter KEY NX Nastran DMAP Programmer’s Guide 9-567 Chapter 9 Descriptions of DMAP Modules and Statements 2 3 -1 Same as OPT3=1 and any data with an undefined format is printed as "???" Same as OPT3=2 except only print records with undefined formats Print without labels Format 2: (KEY=’USET’): Input-integer-default=0. OPT1 Controls the tabular printout of the degree of freedom sets. Print None (default) Row sort only Internal Column sort only Row and column sort Row sort only External Column sort only Row and column sort USETPRT -1 0 1 2 10 11 12 Sequence None 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 can be printed: row sort and column sort. For row sort, a table is printed for each set selected by USETSEL. An example of row sort (USETPRT = 0 or 10) is shown below: U S E T -11= 2-1 D E F I N I T I O N -22-2 -3T A B L E -4( 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 -6-7-8-9-10- -5- For column sort, a single table is printed for the following sets: SB, SG, L, A, F, N, G, R, O, S, M, E. An example of column sort (USETPRT = 1 or 11) is shown below: U S E T D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , C O L U M N S O R T ) EXT GP. DOF INT DOF INT GP. SB SG L A F N G R O S M E -------------------------------------------------------------------------------------------------------1 - 1 11 G 1 1 1 1 - 2 22 2 2 2 - 3 31 3 3 3 - 4 42 4 4 4 - 5 53 5 5 5 - 6 64 6 6 6 9-568 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OPT2 Input-integer-default = 0. Specifies the sets that are printed in the row sort (OPT1 = 0 or 10). In order to select specific sets to be printed, you must sum their corresponding decimal equivalent numbers. For example, sets A, L, and R are selected with OPT2 = 128+256+8 = 392. Sets printed All sets in the following table Mutually exclusive sets only; that is, sets M, SB, SG, O, Q, R, C, B, E, SA, K, and A. Selected sets according to the sum of their decimal equivalent numbers in the following table OPT2 -1 0 >0 Table 9-1. Set Names and Their Decimal Equivalents. Set name Decimal equivalent number Set name Decimal equivalent number V FR T Q B C J K SA KS D FE NE 33554432 16777216 8388608 4194304 2097152 1048576 524288 262144 131072 65536 32768 16384 8192 P E 4096 2048 1024 512 256 128 64 32 16 8 4 2 1 SB SG L A F N G R O S M NX Nastran DMAP Programmer’s Guide 9-569 Chapter 9 Descriptions of DMAP Modules and Statements Format 3: Input-integer-default = 0. OPT1 If OPT2=0, 2, 3, or 5, OPT1 chooses a subset of record 2 for printing as follows: Selection within record 2 All parts (GRID list and summaries of GRID list) Only GRID List Only Summaries of GRID List GRID List for Pattern Starting with Entry GRID ID = G (if any) Same as 0 or 2 but with Summary List.Selection based on X X = 0, 1, 3, 5, or 7 - 1st Summary (sorted by 1st GRID) X = 0, 2, 3, 6, or 7 - 2nd Summary (sorted by count) X = 0, 4, 5, 6, or 7 - 3rd Summary (sorted by superelement) 100+X 200+X 300+X 400+X 500+X 600+X List all point IDs for any unique connection list produced by X Same as 100+X except that additional pure interior points are not listed. Same as 200+X except that additional nonresidual points are not listed Same as 100+X except that additional scalar points are not listed. Same as 200+X except that additional scalar points are not listed Same as 300+X except that additional scalar points are not listed OPT1 value 0 1 2 -g 10X+010X+2 If OPT2 = 4, OPT1 chooses CSUPER entry as follows: OPT1 value >0 ≤ 0 Meaning Write CSUPER Bulk Data entries for superelement OPT1 Write CSUPER Bulk Data entries for residual structure but give SEID = - OPT1 Integer-default = 0. Print/punch selection as follows: Meaning of selection No output (1, 2 and a record for each superelement) OPT2 OPT2 value -1 9-570 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OPT2 value 0 1 2 3 Meaning of selection Print contents of all records (1, 2 and a record for each superelement) of SEMAP except last two Print only Record 1 contents Print contents of Records 1 (except for OPT1 < 0) and 2 (see OPT1 for selection options within Record 2) Print contents of Records 1, 2 and a record for each superelement giving a list of internal points, a list of external points, a list of elements, and estimation data for the superelement. The third part of each superelement record (containing the lists of primary superelement points to which a secondary superelement is connected) is omitted. Punch CSUPER entries according to OPT1 (see Remarks) Print only Records 1 (except for OPT1 < 0), 2 (see OPT1 for selection options within Record 2), and estimation data for each superelement 4 5 Remarks: 1. If OPT2 = 4, CSUPER entries are written on the punch file according to OPT1. Field 2 (SEID) is selected by OPT1. Field 3 is 0. All other data fields contain the sorted list of grid points for either the selected superelement (OPT1 > 0) or the residual structure (OPT1 ≤ 0). Continuation mnemonics are generated in the form +xxxxyyy where xxxx is the left-adjusted SEID and yyy is a right-adjusted record count. Two examples are shown below. TABPRT TABPRT 1 CSUPER CSUPER EMAP//’SEMAP’/1/4 $ EMAP//’SEMAP’/-100/4 $ 2 1 100 21 64 3 0 0 24 71 4 11 1 31 74 5 13 3 34 230 6 14 4 51 330 11 53 630 13 54 730 14 61 7 8 9 10 2. If OPT2 = 0,3 or 5 and TIMSIZ is supplied, TABPRT produces an estimation printout for each superelement except the residual structure. The equations used along with the semi-empirical constants are printed as well as dominant CPU time estimates, space estimates, and wall clock estimates. These estimates are valid for “large” superelements only and should be adjusted for anomalous characteristics. Estimate totals are also provided at the end of the SEMAP printout. If ESTDATA is also supplied, 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 NX Nastran DMAP Programmer’s Guide 9-571 Chapter 9 Descriptions of DMAP Modules and Statements can be printed with TABPRT. If ‘FINDIT’ (default) is specified, the KEY is taken from the header of the data block. Examples: 1. Print coordinate system transformation matrix table. TABPRT CSTM//’CSTM’ $ 2. Print grid point list table. TABPRT GPL//’GPL’ $ 3. Print basic grid point definition table. TABPRT BGPDT// $ 4. Print GEOM3X table with labels taken from DATABLK statement in the NDDL. TABPRT GEOM3X//’GEOM3’///1 $ 5. Print USET list for g-set and s-set in internal order using row sort. TABPRT USET,BGPDT//’USET’/0/18 $ 6. Print USET for the mutually exclusive sets in internal order using column sort. TABPRT USET,BGPDT//’USET’/1 $ 7. Print all SEMAP information except the grid list and secondary superelement boundary sequencing list. TABPRT EMAP//’SEMAP’/2/3 $ 8. Punch CSUPER entries for the residual structure with SEID field set to 100. TABPRT EMAP//’SEMAP’/-100/4 $ 9. Print only estimation data for all superelements. TABPRT EMAP,,TIMSIZ//’SEMAP’/-99999999/5 $ 9.312 TABPT Table printer Prints table or matrix data blocks. Format: TABPT TAB1,TAB2,TAB3,TAB4,TAB5/ $ Input Data Blocks: TABi Data block name 9-572 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 can be used to print matrices. 5. TABPT can occasionally misidentify real numbers or character values. The TABPRT module with OPT3 ≠ 0 properly identifies real numbers and character values. 6. The TABPRT module with OPT3 ≠ 0 also prints tables like TABPT with labels above each item. Examples: TABPT TABPT GEOM1/ $ GEOM1,GEOM2,GEOM3,GEOM4/ $ 9.313 Format: TAFF TAFF Creates tables for follower force stiffness SLT,BGPDT/ ESTF,GPECTF/ LUSET/LOADID/LOADIDP/LOADFACR/NBLOCK $ Input Data Blocks: SLT BGPDT Table of static loads Basic grid point definition table Output Data Blocks: ESTF GPECTF Element summary table for follower force stiffness Grid point element connection table for follower force stiffness Parameters: LUSET LOADID Input-integer-default=0. The number of degrees-of-freedom in the g-set. Input-integer-default=0. Load set identification number for the current subcase. NX Nastran DMAP Programmer’s Guide 9-573 Chapter 9 Descriptions of DMAP Modules and Statements LOADIDP LOADFACR NBLOCK Input-integer-default=0. Load set identification number for the previous subcase. Input-real-default=0.0. Load factor in nonlinear static analysis. Input-integer-default=10. Number of spill blocks to form if “out-of-memory” algorithm is used. 9.314 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: TAHT Input Data Blocks: SLTH DLTH EPT SIL ESTNL GPECT DIT Table of static loads updated for heat transfer analysis Table of dynamic loads updated for heat transfer analysis Table of Bulk Data entry images related to element properties Scalar index list Nonlinear element summary table Grid point element connection table Table of TABLEij Bulk Data entry images Output Data Blocks: ESTNL1 GPECT1 Nonlinear element summary table updated for heat transfer analysis Grid point element connection table for heat transfer analysis 9-574 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: LUSET NOSIMP LOADID STIME Input-integer-no default. The number of degrees-of-freedom in the g-set. Output-integer-no default. The number of elements exclusive of general elements. Set to -1 if there are no simple elements. Input-integer-no default. Load set identification number for the current subcase. Input-real-default=0.0. On initial input, starting time step and on output, accumulated time used for restarts. Remarks: DIT can be purged if DLTH does not reference tables in DIT. 9.315 Format: TASNP1 TASNP1 Computes the shell normal vectors on a superelement‘s boundary BGPDTS,GPECTS,GEOM1S,CSTMS/ SNORMS $ Input Data Blocks: BGPDTS GPECTS GEOM1S CSTMS Basic grid point definition table for a superelement Grid point element connection table for a superelement Table of Bulk Data entry images related to geometry for a superelement Table of coordinate system transformation matrices for a superelement Output Data Block: SNORMS Table of shell normal vectors on a superelement‘s boundary Parameters: None. Remarks: TASNP1 is intended to be executed for each superelement if partitioned superelements are present. NX Nastran DMAP Programmer’s Guide 9-575 Chapter 9 Descriptions of DMAP Modules and Statements 9.316 TASNP2 Computes grid point shell normal vectors at superelement boundaries Computes the grid point shell normal vectors and, if superelements are present, processes shell normals at superelement boundaries. Format: Format without or ignoring superelements: TASNP2 BGPDT,GPECT,GEOM1,CSTM,,,/ GPSNT/ SNORM/SNORMPRT/-1/’’$ Format for superelement: TASNP2 BGPDTS,GPECTS,GEOM1S,CSTMS,SEMAP,SCSTM,SNORM*/ GPSNTS/ SNORM/SNORMPRT/SEID/QUALNAM $ Input Data Blocks: BGPDT BGPDTS GPECT GPECTS GEOM1 GEOM1S CSTM CSTMS SEMAP SCSTM SNORM* Basic grid point definition table Basic grid point definition table for a superelement Grid point element connection table Grid point element connection table for a superelement Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to geometry for a superelement Table of coordinate system transformation matrices Table of coordinate system transformation matrices for a superelement Superelement map table Table of global transformation matrices for partitioned superelements Family of shell normal vectors at superelement boundaries Output Data Blocks: GPSNT GPSNTS Grid point shell normal table Grid point shell normal table for a superelement 9-576 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Parameters: SNORM SNORMPRT Input-real-no default. Maximum angle between grid point normal and shell normal. If angle is less than SNORM, grid point normal is computed. 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 QUALNAM Input-character-no default. Name of qualifier to be used in selecting SNORMS. Input-integer-no default. Superelement identification number. Remarks: If there are partitioned superelements present, TASNP1 must be executed for all superelements. When this is complete, TASNP2 is executed in a separate superelement loop for all superelements. 9.317 TIMETEST Provide timing data Provides timing data for various unit operations that can be used to compare and evaluate computer and compiler performance. Format: TIMETEST TIMTS,A,B,C/TOUT,/N/M/T/OPT/CASE $ Option 1: I/O timing TIMETEST ,,,,/,/N/M/T/2/CASE $ Option 2: Arithmetic timing TIMETEST ,,,,/,/N/M/T/2/CASE $ Option 3: Matrix timing TIMETEST TIMTS3,,,/T3OUT,/N/M/T/3 $ NX Nastran DMAP Programmer’s Guide 9-577 Chapter 9 Descriptions of DMAP Modules and Statements Option 4: Kernel timing TIMETEST TIMTS4,,,/T4OUT,/N/M/T/4 $ Option 5: MPYAD timing for CASE=1 TIMETEST TIMTS5,,,/TOUT5,/N/5/1 $ MPYAD timing CASE=2 (new) TIMETEST TIMTS5,A,B,C/TOUT5,/N/M/T/5/2 $ Option 6: KERNBD generation TIMETEST T3OUT,T4OUT,T7OUT,T8OUT/TOUT6,/ / / /6/CASE $ Option 7: Sparse kernel timing TIMETEST TIMTS3,,,,/TOUT7,/N/M/ /7 $ Option 8: Element timing TIMETEST TIMTS8,,,/TOUT8,/ / / /8/CASE $ Input Data Blocks: TIMTS3 1 DTI 2 TIMTS3 Table created with DTI entries as follows: 3 IREC 4 CASE 5 M 6 N 7 P 8 9 10 CASE CASE = = Record number (null records are ignored so records can be numbered by tens for convenience in making changes) IREC “L” normal case definition.“K” indicates the last case to be used in the least squares solution for timing constants. Note: If no case value of K is found by the time the tenth case value is read, the tenth case is treated as the last case to be used in the least squares solution for timing constants. M N = = Number of terms in inner loop Number of terms in outer loop 9-578 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements P TIMTS4 1 DTI = Number of times kernel is called Table created with DTI entries as follows: 2 TIMTS4 3 IREC 4 CASE 5 ROWS 6 COLS 7 DENS 8 STRL 9 10 IREC CASE Record number (null records are ignored so records can be numbered by tens for convenience in making in making changes) “A” normal case definition.“B” indicates the last case to be used in the least squares solution for timing constants. If no case value of B is found by the time the tenth case value is read, the tenth case is treated as the last case to be used in the least squares solution for timing constants. ROWS COLS DENS STRL TIMTS5 1 DTI 2 Number of rows the matrix is to have Number of columns the matrix is to have Density to be used in building the matrix String length to be used in building the matrix (for CASE=1 only) Table created with DTI entries as follows: 3 IREC 4 CASE 5 ROWS 6 COLS 7 DENS 8 TYPE 9 STRL 10 TIMTS5 TIMTS5 1 DTI 2 (for both cases) Table created with DTI entries as follows: 3 IREC 4 CASE 5 T 6 CORE 7 METHOD 8 9 10 TIMTS5 IREC CASE Record number (null records are ignored so records can be numbered by tens for convenience in making in making changes) “CASE” normal case definition.“END” indicates the last case to be used. The T, CORE, and METHOD field are not populated when this form of the case is used. T CORE Value to be used Size of the core to be used NX Nastran DMAP Programmer’s Guide 9-579 Chapter 9 Descriptions of DMAP Modules and Statements METHOD TlMTS8 Method to be used Element generation and assembly timing. Output Data Blocks: TOUT, TOUTi N Timing results Options 1 and 2: n* - Default = 50. External loop index. Options 3, 4, and 5: Scale Factor. Negative value means scale down. Value 0 or 1 means do not change. Positive value means scale up. Options 6 and 8: Not used. M Options 1 and 2: m* - Default = 200. Internal loop index. Options 3, 4, and 7: Size - Contains the size of various needed arrays (recommended value range: 128 to 1024). (For example, Workstation machines: 128. Low-end minicomputer (VAX): 256. High-end minicomputer (CONVEX): 512.Super computer (CRAY): 1024). Options 5, 6, and 8: Not used. T Options 1 and 2: Default = 2. Data item type (1 = RSP, 2 = RDP, 3 = CSP, 4 = CDP). Options 3-8: Not used. OPT All Options: Type of timing data required. 1 2 3 4 5 Input/Output Operations (default) (old) Arithmetic Operations (old) Matrix Timing Operations (new) Kernel Timing Operations (new) MPYAD Timing Operations CASE = 1 (new). Uses data in DTI file. MPYAD Timing Operations CASE = 2 (new). Uses data defined by remaining arguments. 6 7 8 CASE KERNDB Data Block Generation (new) Sparse Kernel Timing (new) Element Timing (new) Options 1 and 2: Default = 0. Code indicating which unit operations are to be tested. 9-580 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements If OPT = 1, CASE means: 1 2 4 8 16 32 64 128 256 WRITE READ READ BACKWARDS BLDPK INTPK PACK UNPACK PUTSTR GETSTR If OPT = 2, CASE means: 1 2 4 8 RSP RDP CSP CDP Options 3 and 4: Not used. Option 5: If CASE = 1, use the DTI table. If CASE = 2, use the data defined by the remaining arguments. Option 6: Number of elements Option 7: Not used. Option 8: If CASE = 0, the T8OUT data block is initialized. If CASE = 1, record the cumulated CPU time on the T8OUT data block. Set CASE = 1 before executing the EMG module. If CASE = 2, record the cumulated CPU time on the T8OUT data block. Set CASE = 2 after executing the EMA module. 9.318 TOLAPP Appends nonlinear data and Case Control for data recovery NX Nastran DMAP Programmer’s Guide 9-581 Chapter 9 Descriptions of DMAP Modules and Statements Format: Format for nonlinear transient analysis (TOLAPPF=0): TOLAPP CASEXX,MPT,TEL/ TOL,,TOL1/ TOLAPPF/NSOUT $ Format for nonlinear statics analysis (TOLAPPF=1): TOLAPP CASECC,MPT,ESTNL/ OLF,CASECCR,/ TOLAPPF//S,N,NSKIP/S,N,NEWP/S,N,POUTF $ Input Data Blocks: CASECC CASEXX MPT TEL ESTNL Table of Case Control command images Subset of CASECC for current loop Table of Bulk Data entry images related to material properties Transient response time output list appended from each subcase Nonlinear element summary table Output Data Blocks: TOL OLF TOL1 CASECCR Transient response time output list for all subcases Nonlinear load factors for all subcases Transient response time output list for the current subcase Table of Case Control command images for data recovery Parameters: TOLAPPF Input-integer-no default. Nonlinear analysis type: 0 1 NSOUT NSKIP NEWP Nonlinear transient Nonlinear statics Input-integer-default=0. Number of time steps to output. By default, all time steps are output. Input/output-integer-default=1. CASECC record counter or nonlinear transient loop identification number. Input/output-integer-default=1. New subcase flag. 9-582 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements -1 1 POUTF Current subcase has not been completed. Current subcase has been completed. Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate output is not requested. Remarks: 1. If TOLAPPF=0, TOLAPP reads the time values from TEL and appends every NSOUT-th one to TOL. The last time value from TEL is appended regardless of the value of NSOUT. If NSOUT>0, 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. 9.319 TRD1 Solves for modal/direct, transient, displacement, velocity, and acceleration solution Format: TRD1 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,SILD,USETD, PARTVEC/ UXT,PNL/ SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/SETNAME $ Input Data Blocks: CASECC TRL NLFT DIT KXX BXX MXX PXT SILD Table of Case Control command images Transient response list Nonlinear Forcing function table Table of TABLEij Bulk Data entry images Stiffness matrix in any set. Usually h- or d-set. Viscous damping in any set. Usually h- or d-set. Mass matrix in any set. Usually h- or d-set. Transient response load matrix in h-set (modal) or d-set Scalar index list for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). NX Nastran DMAP Programmer’s Guide 9-583 Chapter 9 Descriptions of DMAP Modules and Statements USETD Degree-of-freedom set membership table for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Partitioning vector with values of 1.0 at the rows corresponding to degrees of freedom which were eliminated in the partition to obtain KXX, and so on. 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. PARTVEC Output Data Blocks: UXT PNL Solution matrix from transient response analysis in d- or h-set Nonlinear load matrix appended from each output time step Parameters: SOLTYP Input-character-no default. Solution method. ‘MODAL’ ‘DIRECT’ ‘IC’ NOUE Usually for h-set matrices Usually for d-set matrices Initial conditions for nonlinear transient analysis Input-integer-no default. Number of extra points. Set to -1 if there are no extra points. NONCUP Input-integer-default=0. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if SOLTYP=‘MODAL’and KXX, BXX, and MXX are diagonal. NONCUP=-2 requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX is ignored. Input/output-integer-default=0. Number of time steps in the solution matrix UXT prior to execution of TRD1. Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step increment. Input-character-default=‘H’ Degree-of-freedom set name represented by KXX, and so on. If KXX represents, or is a subset of, the d-set, for maximum efficiency, the rows and columns KXX and MXX must correspond to or be a partition of the displacement set specified by SETNAME. If KXX and MXX are a partition, PARTVEC must also be specified. NCOL FAC3 SETNAME Remarks: 1. NLFT and PNLD1 cannot be purged if nonlinear loads are selected in CASEXX. 2. NCOL>0 indicates a restart. 9-584 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.320 Format: TRD2 TRD2 Solves for modal/direct, transient, displacement, velocity, and acceleration solution CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,DSPT1,SILD, USETD,PARTVEC/ UXT,PNL,TOL/ SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/TRD2OPT/SETNAME $ Input Data Blocks: CASECC TRL NLFT DIT KXX BXX MXX PXT DSPT1 SILD Table of Case Control command images Transient response list Nonlinear Forcing function table Table of TABLEij Bulk Data entry images Stiffness matrix in any set. Usually h- or d-set. Viscous damping in any set. Usually h- or d-set. Mass matrix in any set. Usually h- or d-set. Transient response load matrix in h-set (modal) or d-set Design sensitivity processing table Scalar index list for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Degree-of-freedom set membership table for the p-set. Required for maximum efficiency during symmetric decomposition and if KXX represents the d-set or a subset of the d-set (SETNAME=‘D‘). Partitioning vector with values of 1.0 at the rows corresponding to degrees of freedom which were eliminated in the partition to obtain KXX, and so on. 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. USETD PARTVEC Output Data Blocks: UXT PNL TOL Solution matrix from transient response analysis in d- or h-set Nonlinear load matrix appended from each output time step Transient response time output list NX Nastran DMAP Programmer’s Guide 9-585 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: SOLTYP Input-character-no default. Solution method. ‘MODAL’ ‘DIRECT’ ‘IC’ NOUE NONCUP Modal; usually for h-set matrices Direct; usually for d-set matrices Initial conditions for nonlinear transient analysis Input-integer-no default. Number of extra points. Set to -1 if there are no extra points. Input-integer-default=0. Algorithm selection. NONCUP=-1 requests uncoupled algorithm if SOLTYP=‘MODAL’and KXX, BXX, and MXX are diagonal. NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX, and MXX are ignored. Input/output-integer-default=0. Number of time steps in the solution matrix UXT prior to execution of TRD1. Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step increment. Input-integer-default=1. TRD2 output option. 1 2 Output based on TSTEP Bulk Data entry Output based on every time step NCOL FAC3 TRD2OPT SETNAME Input-character-default=‘H’ Degree-of-freedom set name represented by KXX, and so on. If KXX represents, or is a subset of, the d-set, for maximum efficiency, the rows and columns KXX and MXX must correspond to or be a partition of the displacement set specified by SETNAME. If KXX and MXX are a partition, PARTVEC must also be specified. 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. 9.321 TRLG Generates applied loads in transient analysis 9-586 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Format: TRLG Input Data Blocks: CASECC USETD DLT SLT BGPDT SIL CSTM TRL DIT GMD GOD PHDH RPX EST MPT MGG V01P Table of Case Control command images Degree-of-freedom set membership table for p-set Table of dynamic loads Table of static loads Basic grid point definition table Scalar index list Table of coordinate system transformation matrices Transient response list Table of TABLEij Bulk Data entry images Multipoint constraint transformation matrix with extra points, m-set by ne-set Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set Transformation matrix from d-set to h-set (modal) Reduction matrix from p-set to h-set (modal) or d-set Element summary table. Table of Bulk Data entry images related to material properties Mass or radiation matrix in g-size Partitioning vector for sparse load reduction NX Nastran DMAP Programmer’s Guide 9-587 Chapter 9 Descriptions of DMAP Modules and Statements Output Data Blocks: PPT PST PDT PDT1 PHT PXT TOL DLTH YPT YPO Transient response load matrix in the p-set for output time steps Transient response load matrix in the s-set for output time steps Transient response load matrix in the d-set for output time steps Transient response load matrix in the d-set for all time steps Transient response load matrix in the h-set (modal) for all time steps Transient response load matrix in the h-set (modal) or d-set for all time steps only when RPX is input and TOUT=2 Transient response time output list Table of dynamic loads updated for heat transfer analysis Transient response enforced motion matrix in the p-set Transient response enforced motion matrix in the p-set and for the output time steps Parameters: NOSET Output-integer-default=-1. Constraint, omit, and support set flag. Set to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no degrees-of-freedom are defined in the a-set (for example, ASETi, QSETi Bulk Data entries); +1 otherwise Output-integer-default=-1. Skip factor flag. See NOi on TSTEP Bulk Data entry. 0 Skip factor is >1. Skip factor is 1. IMETHOD Input-integer-default=0. Nonlinear transient analysis flag. 0 Linear analysis PDEPDO -1 AUTO or TSTEP method (NLTRD module) 2 STIME BETA FAC1 ADAPT method (NLTRD2 module) Input-real-default=0.0. Accumulated time used for restarts. Input-complex-default=(.33333,0.0). Integration parameter. Output-complex-default=(0.0,0.0). Square of the reciprocal of the time step increment. Imaginary part is always zero. 9-588 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements FAC2 FAC3 TOUT Output-complex-default=(0.0,0.0). Reciprocal of twice the time step increment. Imaginary part is always zero. Output-complex-default=(0.0,0.0). Negative of the reciprocal of the time step increment. Imaginary part is always zero. Input-integer-default=-1. Processing flag. <1 Use NOi on TSTEP Bulk Data entry 1 2 All time steps Same as <1 except RPX is input TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to 273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying temperatures in Fahrenheit. Input-integer-default=0. Processing option (linear analysis only). 0 = generate full time-dependent loads 1 = generate load scale factor only (TRL not used) 2 = generate time-dependent load table values only OPT Remarks: 1. PPT, PST, PDT, PDT1, PHT, PXT, and DLTH can be purged except in the following cases: If TOUT<2 and PST, PDT, and PDT1 are specified, 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, PHDH must be present. If TOUT=2 and PXT is specified, PPT and RPX must be present. GMD, GOD, PST, PDT, and PDT1 can be purged. 2. MGG and MPT can be purged if there are no GRAV or RFORCE and PLOAD1 records in SLT, respectively, or SLT is purged. 3. DLTH and SLT can be purged. 4. If LSEQ entries exist, SLT should be purged in order to avoid doubling of the LSEQ loads. 9.322 TRNSP Matrix transpose Computes [X] = [A]T. Format: TRNSP A/X $ NX Nastran DMAP Programmer’s Guide 9-589 Chapter 9 Descriptions of DMAP Modules and Statements Input Data Block: A Matrix [A] Output Data Block: 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] is also purged. 9.323 TYPE Declares NDDL data blocks, qualifiers, and parameters. The TYPE DMAP statement performs three different functions, depending on its format: 1. Identifies NDDL data blocks 2. Specifies the type and authorization of NDDL parameters, qualifiers, and location parameters 3. Specifies the type and authorization of local parameters The TYPE statement is a nonexecutable statement, but must appear before any NDDL data block, parameter, qualifier, or location parameter; or any local parameter that relies on the TYPE statement to identify its type and authorization. The TYPE statement has the following formats: Formats: 1. Data blocks: TYPE DB, dblist $ 2. NDDL parameters, qualifiers and location parameters: TYPE PARM, NDDL, ptype, 3. Local parameters: , prmlist $ TYPE PARM,,ptype, , prmlist = [default] $ 9-590 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Describers: dblist ptype Description Integer Real single precision Real double precision Complex single precision Complex double precision Character Logical A list of NDDL data blocks. Each data block must be separated by a comma or a space. Parameter type. Possible parameter types are as follows: ptype I RS RD CS CD CHARi, where i = 1-80 LOGICAL Remarks: N, Y Parameter authorization. Y allows user input of the parameter value via the PARAM Bulk Data entry or Case Control command. N disallows PARAM input. If neither N nor Y is specified, authorization or user override of the parameters contained in the prmlist are determined at DMAP compilation time by the parameter’s first appearance in a DMAP Module. A list of parameters. Each parameter must be separated by a comma or a space. In Format 3 only, parameters can be assigned a default value. This value overrides the MPL default value (if there are any). Character values must be enclosed in single quotation marks. Keyword that identifies parameters or qualifiers defined in the NDDL. prmlist default NDDL 1. Within any subDMAP, parameters are typed at first occurrence in either a TYPE statement or a DMAP module. Parameters occurring in Assignment(=) statements must be defined in a previous DMAP module or TYPE statement. 2. A TYPE statement is required for a parameter if it appears first in one of the following instructions: • • • CALL MESSAGE Assignment NX Nastran DMAP Programmer’s Guide 9-591 Chapter 9 Descriptions of DMAP Modules and Statements • • 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 the 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. UGS recommends 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, a fatal error occurs. 9. If data blocks not defined in the NDDL appear in a TYPE DB statement, a fatal error occurs. 10. If the parameter type and authorization specified on a TYPE statement do not match those specified in a DMAP module, a fatal error occurs. 11. If the parameter type specified on a TYPE statement does not match the type required by a DMAP module, a fatal error occurs. 12. Character parameters which appear on TYPE statements and module instructions must be defined with ptype CHAR8. For example: TYPE PARM,,CHAR8,N,MAJOR,SETJ,COMP=‘COMP’$ MAJOR=‘G’$ SETJ=‘A’$ VEC USET/VGACOMP1/MAJOR/SETJ/COMP $ Use of other lengths, such as CHAR4, results in fatal termination. Examples: The following TYPE PARM statements show how parameters are typed in a subDMAP. Note the use of comments. $ $ QUALS TYPE PARM,NDDL,I,Y,MODEL,SOLlD,SElD,BASE $ $ IFP PARAMETERS TYPE PARM,NDDL,I,Y,ERROR,NOTRED,ASING,MODACC,FIXEDB, BAILOUT $ TYPE PARM,NDDL,RS,,MAXRATIO $ $ LOCAL PARAMETERS PASSED IN OR OUT TYPE PARM,,I,,GO,NOSSET,NOOSET,UNSYM=6,NORC,NOQSET, DONOGO,LOOPERR,NOTSET,ERRNO,RESlD,ACON,NOASM, NORSET,NOLSET $ $ LOCAL PARAMETERS TO THIS SUB DMAP TYPE PARM,,I, ,NOKFF,QNOTNULL,NOKQQl $ 9-592 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements TYPE PARM,,CHAR8,N,APP,F=’F’ $ $ A typical TYPE DB statement is as follows: TYPE DB A,B,C,D, U,V,W,X,Y,Z $ 9.324 Format: UEIGL UEIGL Solves both linear and quadratic real unsymmetric eigenvalue problems KXX,QXX,MXX,DYNAMIC,CASECC,SVEC,BP,APL,APU/ PHX,ULAMA,PHXL,XORTH,LAMMAT,CLAMMAT,LAMA/ S,N,NEIGV/SID/F1/F2/ND/EPS $ Input Data Blocks: KXX QXX MXX DYNAMIC CASECC SVEC BP APL APU Stiffness matrix in any set Aerodynamic matrix in any set for the linear unsymmetric eigensolution Mass matrix in any set for the quadratic unsymmetric eigensolution Table of Bulk Data entry images related to dynamics Table of Case Control command images Starting "random" eigenvector matrix Null space B matrix Lower triangular factor of null space A matrix Upper triangular factor of null space A matrix Output Data Blocks: PHX ULAMA PHXL XORTH LAMMAT CLAMMAT LAMA Right eigenvector matrix for real eigenvalues only Unsymmetric eigenvalue summary table Left eigenvector matrix for real eigenvalues only Cross-orthogonality matrix Diagonal matrix with real eigenvalues on the diagonal Diagonal matrix with complex eigenvalues on the diagonal Normal modes eigenvalue summary table NX Nastran DMAP Programmer’s Guide 9-593 Chapter 9 Descriptions of DMAP Modules and Statements Parameters: NEIGV SID Output-integer-no default. The number of eigenvectors found. Set to -1 if none were found. Input-integer-default=0. Alternate set identification number. If SID=0, the set identification number is obtained from the UMETHOD command in CASECC and used to select the EIGUL Bulk Data entry in DYNAMIC. If SID>0, the UMETHOD command is ignored and the EIGUL entry is selected by this parameter‘s value. All subsequent parameter values (F1, F2, and so on) are ignored. If SID<0, both the UMETHOD command and all EIGUL entries are ignored and the subsequent parameter values (F1, F2, and so on) are used to control the eigenvalue extraction. F1 F2 ND EPS Input-real-default=0.0. The lower frequency/eigenvalue bound. Input-real-default=0.0. The upper frequency/eigenvalue bound. The default value of 0.0 indicates machine infinity. Input-integer-default=0. The number of desired eigenvalues. Input-real-default=0.0. Convergence criterion. By default, EPS is set to N/10000 where N is the size of KXX, and so on. Remarks: 1. In certain NX Nastran applications, the eigenvalue problem presented contains real, unsymmetric matrices. One such application, the direct structural acoustic problem is formulated as: where the stiffness and mass matrices are both real unsymmetric, containing coupled blocks of structural and fluid matrices. Another case of an unsymmetric but real eigenvalue problem is given in the aeroelastic divergence solution posed as: where Kll is the structural stiffness matrix, real, symmetric positive definite. However, the Qll divergence matrix is real, unsymmetric. 2. The left-handed solutions of the two problems presented before are: for acoustics and 9-594 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements for aeroelastic divergence. Based on the physical principals of the above problems, the eigenvectors are real and the eigenvalues are either real (aeroelastic divergence) or imaginary (acoustics). 3. QXX is required if MXX is purged, and vice versa. 4. XORTH, CLAMMAT, SVEC, BP, APL and, APU can be purged. 9.325 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 $ Input Data Blocks: UGNI DUGNI SIL Displacement matrix at converged step in the g-set Incremental displacement matrix between the last two converged steps Scalar index list Output Data Block: UGNT Total displacement matrix in the g-set Parameters: None. Remarks: 1. SIL cannot be purged. 2. If either UGNI or DUGNI is null, the addition is done directly. 3. UGVADD is used only in SOL 4. NX Nastran DMAP Programmer’s Guide 9-595 Chapter 9 Descriptions of DMAP Modules and Statements 9.326 UMERGE Merges two matrices based on USET Merge two matrices with the same number of columns and with the rows based on degrees-of-freedom sets defined in the USET table into a single matrix. Format: UMERGE USET,A11,A21/A/MAJOR/SET1/SET2 $ Input Data Blocks: USET Aij USET table output from module GP4 or GPSP (or USETD table from DPD for dynamics or AEUSET table from APD for aerodynamics) Matrix partitions Output Data Block: A Assembled matrix Parameters: MAJOR SETi Character-input-no default. Major degree-of-freedom set name. See Remarks. Character-input-default=‘COMP’ Subset degree-of-freedom names. See Remarks. Remarks: 1. The supersets formed by the union of other sets have the following definitions. 9-596 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2. SET1 or SET2, but not both, can 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), 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, the SET2 partition is assumed to be SET2=‘COMP’ For example, if MAJOR=‘G‘, SET1=‘A‘, and SET2=‘S‘, SET2 is assumed to be ‘COMP’(See Remark 2) and not just the s-set. 4. The set names MAJOR, SET1, and SET2, can 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. This resultant set is then joined with the m-set. 5. USET and A cannot be purged. 6. A11 or A21 can be purged, in which case, they are assumed to be null. Examples: Merge four matrices into a single matrix based on degrees-of-freedom sets. 1. Append PHO to PHA. a. UMERGE USET,PHA,PHO/PHF/‘F‘/‘A’$ b. UMERGE USET,PHO,PHA/PHF/‘F‘//‘O’$ Expand PHA to g-set size. a. UMERGE USET,PHA,/PHG/‘G‘/‘A’$ b. UMERGE USET,,PHA/PHG/‘G‘//‘A’$ Expand PHRC with rows corresponding to the r and c-set to the union of the t, o, and m-sets. 2. 3. NX Nastran DMAP Programmer’s Guide 9-597 Chapter 9 Descriptions of DMAP Modules and Statements UMERGE USET,PHRC,/PHTOM/‘T+O+M‘/‘R+C’$ 9.327 UMERGE1 Merges two matrices based on USET Format: UMERGE1 USET,A11,A21,A12,A22/A/MAJOR/SET1/SET2/IOPT $ Input Data Blocks: USET Aij USET table output from module GP4 or GPSP (or USETD table from DPD for dynamics or AEUSET table from APD for aerodynamics) Matrix partitions with rows and columns that correspond to degrees-of-freedom in the USET table Output Data Block: A Assembled matrix Parameters: MAJOR SETi IOPT Character-input-no default. Major degree-of-freedom set name. See Remarks. Character-input-default=‘COMP’ Subset degree-of-freedom names. See Remarks. Integer-input-default = 0. IOPT chooses between square and rectangular. IOPT = 0 IOPT = 1 IOPT = 2 Remarks: The supersets formed by the union of other sets have the following definitions: 9-598 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 1. SET1 or SET2, but not both, can 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), SET2 is assumed to be those degrees-of-freedom in the g-set that are not in the a-set. 2. 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, the SET2 partition is assumed to be SET2=‘COMP’ For example, if MAJOR=‘G‘, SET1=‘A‘, and SET2=‘S‘, SET2 is assumed to be ‘COMP’(see Remark 2) and not just the s-set. 3. The set names MAJOR, SET1, and SET2, can 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. This resultant set is then joined with the m-set. 4. USET and A cannot be purged. 5. If an input matrix is purged, it is assumed to be null. Examples: 1. Merge submatrices of KFF. a. UMERGE1 USET,KAA,KOA,KAO,KOO/KFF/‘F‘/‘A’$ b. UMERGE1 USET,KAA,KOA,KAO,KOO/KFF/‘F‘//‘O’$ c. UMERGE1 USET,KOO,KAO,KOA,KAA/KFF/‘F‘//‘O’$ 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. NX Nastran DMAP Programmer’s Guide 9-599 Chapter 9 Descriptions of DMAP Modules and Statements 9.328 UPARTN Partitions a matrix based on USET Partition matrix based on degrees of freedom defined in the USET table. Format: UPARTN USET,A/A11,A21,A12,A22/MAJOR/SET1/SET2/IOPT $ Input Data Blocks: USET A USET table output from module GP4 or GPSP (or USETD table from DPD for dynamics or AEUSET table from APD for aerodynamics) Any matrix with rows or columns that correspond to degrees-of-freedom in the USET table Output Data Blocks: Aij Matrix partitions Parameters: MAJOR SETi IOPT Character-input-no default. Major degree-of-freedom set name. See Remarks. Character-input-default=‘COMP’ Subset degree-of-freedom names. See Remarks. Integer-input-default = 0. IOPT chooses between a symmetric partition and a vector partition. A vector partition is performed if IOPT = 1 or 2. IOPT = 1 IOPT = 2 IOPT = 0 Remarks: 1. The supersets formed by the union of other sets have the following definitions: 9-600 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 2. SET1 or SET2, but not both, can 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), 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, the SET2 partition is assumed to be SET2=‘COMP’ For example, if MAJOR=‘G‘, SET1=‘A‘, and SET2=‘S,’SET2 is assumed to be ‘COMP’(see Remark 2) and not just the s-set. 4. The set names MAJOR, SET1, and SET2, can 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. This resultant set is then joined with the m-set. 5. USET cannot be purged. 6. “A” can be purged, in which case UPARTN simply returns, causing the output matrices to be purged. 7. Any or all output data block(s) can be purged. Examples: 1 Partition KFF into its submatrices. a. UPARTN USET,KFF/KAA,KOA,KAO,KOO/‘F‘/‘A’$ b. UPARTN USET,KFF/KAA,KOA,KAO,KOO/‘F‘//‘O’$ UPARTN USET,KFF/KOO,KAO,KOA,KAA/‘F‘/‘O’$ c. 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. 2 NX Nastran DMAP Programmer’s Guide 9-601 Chapter 9 Descriptions of DMAP Modules and Statements UPARTN USET,PHTOM/PHRC,,/‘T+O+M‘/‘R+C‘//1 $ 3 Partition [KGG] into the q-set and its complement, columns only. UPARTN USET,KGG/KGQ,,KGCOMP,/’G’/’Q’//2 $ 9.329 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: UREDUC XD,XH,XS $ Input Data Blocks: XP XG USETD USET GMD GM GOD GOA PHDH PHA Rectangular matrix of displacements or loads in the p-set Rectangular matrix of displacements or loads in the g-set Degree-of-freedom set membership table for p-set Degree-of-freedom set membership table for g-set Multipoint constraint transformation matrix with extra points, m-set by ne-set Multipoint constraint transformation matrix, m-set by n-set Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set Omitted degree-of-freedom transformation matrix, o-set by a-set Transformation matrix from d-set to h-set (modal) Normal modes eigenvector matrix in the a-set Output Data Blocks: XD Rectangular matrix of displacements or loads in the p-set 9-602 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements XH XS Rectangular matrix of displacements or loads in the h-set (modal) Rectangular matrix of displacements or loads in the s-set Parameters: None. Remarks: 1. If PHDH is purged, PH is not output. 2. GM (or GMD) and GOA (or GOD) cannot 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. 9.330 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: VDR Input Data Blocks: CASECC EQDYN EQEXIN USETD USET Table of Case Control command images Equivalence table between external and internal grid/scalar/extra point identification numbers. (EQEXIN appended with extra point data). Equivalence table between external and internal grid/scalar identification numbers Degree-of-freedom set membership table for p-set Degree-of-freedom set membership table for g-set NX Nastran DMAP Programmer’s Guide 9-603 Chapter 9 Descriptions of DMAP Modules and Statements UXY OL XYCDB PNL Solution matrix from dynamic analysis (transient, frequency, normal or complex modes) in the d- or h-set Complex or real eigenvalue summary table, transient response time output list or frequency response frequency output list Table of x-y plotting commands Nonlinear load matrix appended from each output time step Output Data Blocks: OUXY1 OPNL1 Table of displacements in SORT1 format for h-set or d-set Table of nonlinear loads in SORT1 format for the h-set or d-set Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘REIGEN’ ‘FREQRESP’ ‘TRANRESP’ ‘CEIGEN’ SOLTYP Normal modes Frequency response Transient response Complex eigenvalues Input-character-no default. Solution method. ‘MODAL’ ‘DIRECT’ Modal Direct NOSORT2S NOSOUT NOSDR2 FMODE NOSORT2 Output-integer-no default. Solution set SORT2 format flag. Set to 1 if SORT2 format or x-y plotting is requested for the solution set; -1 otherwise. Output-integer-default=0. Solution set (d- or h-set) output flag. Set to 1 if any solution set output is requested; -1 otherwise. Output-integer-no default. Physical set (g-set) output flag. Set to 1 if any physical set output is requested in CASECC or XYCDB; -1 otherwise. Input-integer-no default. The lowest mode number resulting from LMODES or LFREQ and HFREQ. Output-integer-default=0. Physical set SORT2 format flag. Set to 1 if SORT2 format is requested or XYCDB is present; -1 otherwise. 9-604 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements Remarks: 1. PP can be purged only if UDV is purged. 2. PNL, XYCDB, OUXY1, and OPNL1 can be purged. 9.331 VDRE Creates modal energy tables Creates modal energy tables on the MODALE case control entry. Format: VDRE CASECC,EQDYN,USET,MDEN,OL/OMDEN2/APP/SOLTYP/ETYPE/ S,N,NOSORT1S/S,N,NOOUT/FMODE $ Input Data Blocks: CASECC EQDYN USET MDEN Table of Case Control command images Equivalence table between external and internal grid/scalar/extra point identification numbers. Degree-of-freedom set membership table for g-set. Modal energy matrix from modal frequency analysis in the d-set. The results of summing energy values across all frequencies for a mode must be the last row of the matrix. Modal frequency response frequency output list. OL Output Data Blocks: OMDEN2 Table of modal energies in SORT2 format for d-set. Parameters: APP Input-character-no default. Analysis type. Allowable values: ‘FREQRESP’ Frequency response SOLTYP Input-character-no default. Analysis type. Allowable values: ‘MODAL’ Modal NX Nastran DMAP Programmer’s Guide 9-605 Chapter 9 Descriptions of DMAP Modules and Statements ETYPE Input-character-no default. Energy type. Allowable values: ‘SEC’ Strain energy - constant ‘SEO’ Strain energy - oscillating ‘KEC’ Kinetic energy - constant ‘KEO’ Kinetic energy - oscillating ‘TOTC’ Total energy - constant ‘TOTO’ Total energy - oscillating NOSORT1S NOOUT FMODE Output-integer-no default. SORT1 format flag. Set to 1 if SORT1 format is requested; -1 otherwise Output-integer-default=0. OFP output flag. Set to 1 if any OFP output is requested; -1 otherwise. Input-integer-no default. The lowest mode number resulting from LMODES or LFREQ and HFREQ parameters. 9.332 VEC Creates partitioning vector based on USET Creates a partitioning vector based on degree-of-freedom sets. The vector can be used by the MERGE and PARTN modules. Format: VEC USET/CP/MAJOR/SET1/SET2/UNUSED4/SET3 $ Input Data Block: USET USET table output from module GP4 or GPSP (or USETD table from DPD for dynamics or AEUSET table from APD for aerodynamics) Output Data Block: CP Partitioning vector Parameters: MAJOR SETi Character-input-no default. Major degree-of-freedom set name. See Remarks. Character-input-default=‘COMP’ Subset degree-of-freedom names. See Remarks. 9-606 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements UNUSED4 SET3 Integer-input-default=0. Unused and can be unspecified. Character-input-default=’ ’ Remarks: The supersets formed by the union of other sets have the following definitions: 1. If MAJOR = ‘BITID‘, 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. 2. If SET1 (or SET2, but not both) is set to ‘COMP’(or left blank), SET1 (or SET2) is assumed to be the complement of SET2 (or SET1). 3. The set names MAJOR, SET1, and SET2, can 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. This resultant set is then joined with the m-set. 4. USET cannot be purged. Examples: 1. To partition [Kff] into a- and o-set based matrices, use VEC PARTN USET/V/‘F‘/‘O’$ 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’$ NX Nastran DMAP Programmer’s Guide 9-607 Chapter 9 Descriptions of DMAP Modules and Statements 2. Example 1 can be accomplished by: VEC USET/V/‘F‘/‘O’$ or VEC USET/V/‘F‘/‘A’$ 3. Example 1 can also be accomplished by: VEC USET/V/‘BITID‘////‘A’$ 9.333 VECPLOT Transforms, searches, and computes resultants of matrices Performs utility functions on g-set size matrices, including computation of resultants, transformation from one coordinate system to another, and generation of rigid body matrices. Format: VECPLOT Input Data Blocks: XG BGPDT SCSTM CSTM CASECC LAMA USET MEDGE X66P VGQ 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. Basic grid point definition table Table of global transformation matrices for partitioned superelements Table of coordinate system transformation matrices Table of Case Control command images Normal modes eigenvalue summary table Degree-of-freedom set membership table for g-set Edge table for p-element analysis 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. Partitioning vector with values of 1.0 at rows corresponding to degrees-of-freedom in the q-set. 9-608 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements RBF UNUSED8 Rigid body force matrix Unused and can be purged Output Data Block: XOUT RESMAX HEADCNTL x66 Output matrix or table as described in Remark 1 Resultant or maxima matrix that is printed out with IOPT=1 or 5 List of integer codes for header print control in the DISUTIL module under IOPT=1 or 5 Triple-product of XG with rigid body modes for IOPT=9 or 10 Parameters: GRDPNT Input/output-integer-default=0. Identification number of the grid point about which resultant moments are computed. If GRDPNT = 0 or the grid point does not exist, the origin of the basic coordinate system is used and GRDPNT=-1 is output from the module. Input-integer-default=-1. Identification number of the coordinate system into which XG is transformed. The default (-1 or 0) indicates the basic coordinate system. Used only with IOPT = 1 and 5. Input-integer-default=-1. Output option. See Remark 1. IOPT=9 is intended for processing of the WEIGHTCHECK Case Control command. Similar to IOPT=7 except XG is a mass matrix: 1) Allows other sets 2) Compares x66 (for non-g-set) with x66p IOPT=10 is intended for processing of the GROUNDCHECK Case Control command. Similar to IOPT=7 except XG is a stiffness matrix: 1) Allows other sets 2) Prints UIM indicating strain energy in each rigid body direction COORID IOPT NX Nastran DMAP Programmer’s Guide 9-609 Chapter 9 Descriptions of DMAP Modules and Statements TITLEi Input-character. Title which appears above the printed output. See Remark 1. TITLE1 default = ’VECTOR ’TITLE2 default = ’RESULTAN’ TITLE3 default = ’T ’ ALTSHAPE WTMASS SEID SETNAM RBFAIL Input-integer-default=0. Set of displacement functions in p-element analysis. See “Parameters” in the NX Nastran Quick Reference Guide. Input-real-default=1.0. Scale factor on structural mass matrix. Used only in IOPT=7. See “Parameters” in the NX Nastran Quick Reference Guide. Input-integer-default=-1. Superelement identification number. Input-character-default=‘g’ Degree-of-freedom set name used by IOPT=9 and 10. Output-logical-default=‘false’ Set to TRUE if grounding check does not pass the strain energy threshold used by IOPT=10. Remarks: 1. The table below describes the contents of XOUT and the printed output for each IOPT. IOPT <0 1 Contents of XOUT Displacement vector file suitable for input to the PLOT module XG converted to the coordinate system specified by COORID Printed output None Resultants of the input vectors about GRDPNT in the basic coordinate system Same as IOPT = 1 2 Same as IOPT=1 and for each grid point,u′x = u′y = θ′x = θ′y = θ′z = 0 and u′zux + uy + uz + θx + θy + θz, where ui and θi are the translations and rotations of XG. 3 The coordinate locations (x, y, z) in BGPDT converted to a matrix and translated by XG: x′ = ux + x y′ = uy + y z ′ = uz + z where ux, uy, uz are the translations and rotations of XG in the basic coordinate system. BGPDT contains the location of each grid point in the basic coordinate system. COORID is ignored. None 9-610 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements IOPT 4 Contents of XOUT A six-row by g-column rigid body matrix where each row represents the motion, in the global coordinate system, of all grid points due to the unit motion of the grid point listed on PARAM,GRDPNT. Grid point GRDPNT is given a unit translation or rotation in each direction of the basic coordinate system. XOUT represents the rigid body modes of the structure with no mechanisms. The motion is output in the global coordinate system. XG and COORID are ignored. Same as IOPT=1 A g-row by six-column rigid body matrix where each column represents the motion of all grid points due to a unit motion of an r-set degrees of freedom (see SUPORTi Bulk Data entries). [XOUT] = [XOUT4]T [DRR−1] where [XOUT4] is the rigid body matrix generated under PLOTFORM = 4, and [DRR] is the partition of [XOUT4] corresponding to the six r-set degrees of freedom defined in the USET table. There must be six and only six r-set degrees of freedom which completely describe the six rigid body modes. The r-set degrees of freedom can be defined on more than one grid point. If the r-set degrees of freedom belong to a single grid point, the result is the same as IOPT=4, except that the unit motions of the grid point listed on PARAM, GRDPNT are in its global, rather than basic coordinate system. Printed output None 5 6 None 7 Grid point weight generator summary table suitable for printing by the OFP module. Same as GPWG module. Same as IOPT=1 None 8 Same as IOPT=1 except output includes contributions from each direction None User Information Message 7570, which shows grounding check strain energies and pass/fail report None 9 10 Same as IOPT=7 Same as IOPT=7 11 Same as IOPT=1 NX Nastran DMAP Programmer’s Guide 9-611 Chapter 9 Descriptions of DMAP Modules and Statements 2. If displacement coordinate systems exist, or COORID = 0, CSTM cannot be purged and SCSTM cannot be purged if partitioned superelements are present. 3. CASECC and LAMA can be purged. 4. BGPDT and XOUT cannot be purged. 5. XG can be purged if IOPT=3, 4, or 6. 6. MEDGE can be purged if p-elements are not present. 7. USET can be purged except for IOPT=6, 9, and 10. Examples: 1. Convert a displacement vector in a global coordinate system that is cylindrical to the basic system, and print it. VECPLOT MATGPR UG,BGPDT,SCSTM,CSTM,,,,/UGBASIC/0/0/1 $ 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 TRNSP VECPLOT ,,BGPDT,SCSTM,CSTM,,,,/RBGLOBAL//4 $ RBGLOBAL/RBT $ 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 MATPRN PG,BGPDT,SCSTM,CSTM,,,,/PGBASIC//0/5 $ PG,PGBASIC//$ 9.334 Format: VIEW VIEW Computes heat transfer radiation view factors EST,BGPDT,EQEXIN,EPT,EDT,MATPOOL/ MPOOL $ Input Data Blocks: EST BGPDT EQEXIN EPT Element summary table Basic grid point definition table Equivalence table between external and internal grid/scalar identification numbers Table of Bulk Data entry images related to element properties 9-612 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements EDT MATPOOL Table of Bulk Data entry images related to element deformation. Required only for differential stiffness generation Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation, virtual mass, DMIG, and DMIAX entries Output Data Block: MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images Parameters: None. 9.335 VIEWP Generates geometry tables for 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 $ Input Data Blocks: GEOM1 GEOM2 EST CASECC OINT EDT EPT PELSET BGPDT Table of Bulk Data entry images related to geometry Table of Bulk Data entry images related to element connectivity and scalar points Element summary table Table of Case Control command images p-element output control table Table of Bulk Data entry images related to element deformation, aerodynamics, p-element analysis, divergence analysis, and the iterative solver Table of Bulk Data entry images related to element properties p-element set table, contains SETS DEFINITIONS Basic grid point definition table NX Nastran DMAP Programmer’s Guide 9-613 Chapter 9 Descriptions of DMAP Modules and Statements EQEXIN CSTM PVAL0 Equivalence table between external and internal grid/scalar identification numbers Table of coordinate system transformation matrices p-value table generated by the ADAPT module in a previous run or superelement Output Data Blocks: ELEMVOL GEOM1VU GEOM2VU VIEWTB Element volume table, contains p-element volumes and the p-value dependencies of each P-element grid, edge, face and body Table of Bulk Data entry images related to geometry with view-grids added Table of Bulk Data entry images related to element connectivity and scalar points p-elements removed and view-elements added View information table, contains the relationship between each p-element and its view-elements and view-grids Parameters: VUGNEXT VUENEXT VUGJUMP VUELJUMP VUHEXA VUPENTA VUTETRA VUQUAD4 VUTRIA3 VUBEAM VUEXIST Input/output-integer-default=0. Starting identification number for next view-grid. Input/output-integer-default=0. Starting identification number for next view-element. Input-integer-default=1000. Delta between view-grid identification numbers. Input-integer-default=1000. Delta between view-element identification numbers. Input-character-default=‘VUHEXA’ Name for VUHEXA element. Input-character-default=‘VUPENTA’ Name for VUPENTA element. Input-character-default=‘VUTETRA’ Name for VUTETRA element. Input-character-default=‘VUQUAD4’ Name for VUQUAD4 element. Input-character-default=‘VUTRIA3’ Name for VUTRIA3 element. Input-character-default=‘VUBEAM’ Name for VUBEAM element. Output-logical-default=FALSE. View-element flag. Set to TRUE if view-elements exist. 9-614 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 9.336 WEIGHT Calculates model‘s volume and/or weight Format: WEIGHT VELEM,EST,MPT,DIT,mOPTPRM,OGPWG/ WMID,WGTM/ WGTVOL/S,N,VOLS/SEID $ Input Data Blocks: VELEM EST MPT DIT OPTPRM OGPWG Table of element lengths, areas, and volumes Element summary table Table of Bulk Data entry images related to material properties Table of TABLEij Bulk Data entry images Table of optimization parameters Grid point weight generator table in weight units Output Data Blocks: WMID WGTM Table of weight as a function of material identification number Table of the 6x6 rigid body mass matrix Parameters: WGTVOL Input-integer-default=0. Weight/volume retained response flag. Set to >0 if any retained response. 1 Weight only 2 Volume only 3 Weight And volume VOLS SEID Output-real-default=0.0. Total volume of analysis model. Input-integer-default=0. Superelement identification number. 9.337 XSORT Reads and sorts Bulk Data section NX Nastran DMAP Programmer’s Guide 9-615 Chapter 9 Descriptions of DMAP Modules and Statements Format: XSORT FORCE,BULKOLD/BULK/S,N,NOGOXSRT/ S,N,QUALNAM/S,N,NEXTID/S,N,LASTBULK/S,N,EQVBLK $ Input Data Blocks: FORCE BULKOLD Table of MSGSTRESS plotting commands Bulk table from a prior run, to be merged into BULK Output Data Block: BULK Table of all Bulk Data entries Parameter: NOGOXSRT QUALNAM NEXTID Logical-output-default=FALSE. Set to TRUE an error is detected in the Bulk Data. Output-character-default=’ ’ Keyword which appears on the BEGIN BULK command of the next Bulk Data section; usually SUPER or AUXMODEL. Input/output-integer-default=0. Identification number which appears on the BEGIN BULK command of the next Bulk Data section. Usually indicates superelement or auxiliary model identification number. Output-logical-default=FALSE. Flag to indicate that the current Bulk Data section is the last section in the input file. Input/output-logical-default=FALSE. Copy/equivalence flag of BULKOLD to BULK. If on input EQVBLK=FALSE, and no new Bulk Data, copy BULKOLD to BULK. If on input and output EQVBLK=TRUE and no new Bulk Data, BULKOLD must be equivalenced to BULK in a subsequent EQUIVX statement. If there are any new Bulk Data, EQVBLK is set to FALSE on output. LASTBULK EQVBLK Remarks: 1. XSORT does not terminate on error detection; therefore, the following statement should appear after the module: IF (NOGOXSRT) EXIT $ 2. If BULKOLD is purged or empty, 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. 9-616 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements 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 $ 9.338 Format: XYPLOT XYPLOT Writes plot information to plot file (.plt) XYPLOT// $ Input Data Blocks: XYPLOT Table of x-y plot control values Output Data Block: None. Parameters: None. 9.339 XYTRAN Creates table of plot instructions for x-y plots Format for SDR2 Outputs: XYTRAN XYCDB,OPG2,OQG2,OUG2,OES2,OEF2,OSTR2,OQMG2/ XYPLOT/ APP/XYSET/S,N,PLTNUM/S,N,CARDNO/S,N,NOXYPLOT/ S,N,TABID $ Format for RPSEC Outputs: XYTRAN XYCDB,OXRESP,,,,,,/ XYPLOT/ ’RSPEC’/XYSET/S,N,PLTNUM/S,N,CARDNO/S,N,NOXYPLOT/ S,N,TABID $ NX Nastran DMAP Programmer’s Guide 9-617 Chapter 9 Descriptions of DMAP Modules and Statements Format for MODEPOUT Outputs: XYTRAN Format for VDR Outputs: XYTRAN XYCDB,OUXY2,OPNL2,,,,,/ XYPLOT/ APP/XYSET/S,N,PLTNUM/S,N,CARDNO/S,N,NOXYPLOT/ S,N,TABID $ Format for RANDOM Outputs: XYTRAN XYCDB,PSDF/AUTO,,,,,/ XYPLOT/ APP/XYSET/S,N,PLTNUM/S,N,CARDNO/S,N,NOXYPLOT/ S,N,TABID $ Input Data Blocks: XYCDB PSDF AUTO OVG OXRESP OUXY2 OPNL2 OFMPF2M OFMPF2E OSMPF2M OSMPF2E OPMPF2M Table of x-y plotting commands Power spectral density table Autocorrelation function table Table of aeroelastic x-y plot data for V-g or V-f curves Table of response spectra in SORT2 format Table of displacements in SORT2 format for h-set or d-set. Table of nonlinear loads in SORT2 format for the h-set or d-set. Table of fluid mode participation factors by normal mode. Table of fluid mode participation factors by excitation frequencies. Table of structure mode participation factors by normal mode. Table of structure mode participation factors by excitation frequencies. Table of panel mode participation factors by normal mode. 9-618 NX Nastran DMAP Programmer’s Guide Descriptions of DMAP Modules and Statements OPMPF2E OLMPF2M OLMPF2E OGMPF2M OGMPF2E Table of panel mode participation factors by excitation frequencies. Table of load mode participation factors by normal mode. Table of load mode participation factors by excitation frequencies. Table of grid mode participation factors by normal mode. Table of grid mode participation factors by excitation frequencies. Output Data Blocks: XYPLOT Table of x-y plot control values Parameters: APP Input-character-default=‘TRANRESP’ Analysis type.Allowable values are: ‘REIGEN’ ‘FREQRESP’ ‘TRANRESP’ ‘CEIGEN’ ‘VG’ ‘CONTACT’ ‘RANDOM’ ‘RANDMPF’ ‘SET1’ ‘RSPEC’ XYSET Normal modes Frequency response Transient response Complex eigenvalues Aeroelastic V-g or V-f data Slideline contact Process all random results excluding acoustic modal ’RANDOM’ participation factor outputs from MODEPOUT. Process only MODEPOUT outputs. Abscissa points are specified on SET1 Bulk Data entries Response spectra Input-character-default=‘SOL’ Degree-of-freedom set type. ‘SOL’ ‘DSET’ ‘HSET’ ‘PSET’ Solution set (d-set or h-set) d-set h-set p-set PLTNUM Input/output-integer-default=0. Plot frame counter. NX Nastran DMAP Programmer’s Guide 9-619 Chapter 9 Descriptions of DMAP Modules and Statements CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is incremented by one for each line written to the punch file and is also written into columns 73-80 of each line. Output-integer-default=1. Set to 1 if XYPLOT is created; -1 otherwise. Input/output-integer-default=0. TABLED1 punch flag. If IDTAB is greater than zero, all requests for XYPUNCH produce TABLED1 Bulk Data entries for the curve. The table identification number starts at TABID and increases by one for each table punched. NOXYPLOT TABID Remarks: 1. OFPi2 can 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 can be specified in any order. 3. If APP=‘RAND‘, PSDF and AUTO must be specified. 4. If APP=‘RSPEC,’OXRESP must be specified. 5. If APP=‘VG‘, 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; that is, 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 $ 9-620 NX Nastran DMAP Programmer’s Guide