Download as pdf or txt
Download as pdf or txt
You are on page 1of 2008

SIEMENS

DMAP Programmer's
Guide
Contents

Proprietary & Restricted Rights Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Direct Matrix Abstraction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1


Introduction to DMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
The NX Nastran DMAP Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Constant Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Variable Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Expressions and Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
Data Block Type and Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
Output from a Previous Module Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-30
Automatic Deletion of Scratch Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-30
Preface Modules and SOLution 100 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31
Processing User Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31
SubDMAPs DBMGR, DBSTORE, and DBFETCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32
WHERE and CONVERT Clauses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-34

Overview of Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Matrix Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Table Data Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
IFP Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
OFP Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Approach_Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Table_code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Format_code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Stress_code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Element Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11

Data Block Descriptions A-E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1


AXIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
RECORD – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
RECORD – AXIC(515,5,144) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
RECORD – AXIF(8815,88,212) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
RECORD – AXSLOT(1115,11,223) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
RECORD – BDYLIST(8915,89,213) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
RECORD – CCONEAX(2315,23,146) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
RECORD – CFLUID2(8515,85,209) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

DMAP Programmer's Guide 3


Contents
Contents

RECORD – CFLUID3(8615,86,210) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3


RECORD – CFLUID4(8715,87,211) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
RECORD – FLSYM(9115,91,222) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
RECORD – FORCE(4201,42,18) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
RECORD – FORCEAX(2115,21,156) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
RECORD – FREEPT(9015,90,214) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
RECORD – FSLIST(8215,82,206) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
RECORD – GRAV(4401,44,26) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
RECORD – GRIDB(8115,81,205) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
RECORD – GRIDF(1215,12,229) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
RECORD – GRIDS(1315,13,230) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
RECORD – LOAD(4551,61,84) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
RECORD – MOMAX(3815,38,157) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
RECORD – MOMENT(4801,48,19) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
RECORD – MPCADD(4891,60,83) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
RECORD – MPCAX(4015,40,149) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
RECORD – OMITAX(4315,43,150) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
RECORD – POINTAX(4915,49,152) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
RECORD – PRESAX(5215,52,154) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
RECORD – PRESPT(8415,84,208) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
RECORD – RINGAX(5615,56,145) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
RECORD – RINGFL(8315,83,207) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
RECORD – SECTAX(6015,70,153) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
RECORD – SEQGP(5301,53,4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
RECORD – SLBDY(1415,14,231) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
RECORD – SPCADD(5491,59,13) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
RECORD – SPCAX(6215,62,148) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
RECORD – SUPAX(6415,64,151) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
RECORD – TEMPAX(6815,68,155) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
RECORD – TEMPD(5641,65,98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
AXIC68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
RECORD – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
RECORD – AXIC(515,5,144) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
RECORD – AXIF(8815,88,212) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
RECORD – AXSLOT(1115,11,223) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
RECORD – BDYLIST(8915,89,213) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
RECORD – CCONEAX(2315,23,146) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
RECORD – CFLUID2(8515,85,209) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
RECORD – CFLUID3(8615,86,210) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
RECORD – CFLUID4(8715,87,211) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
RECORD – FLSYM(9115,91,222) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
RECORD – FORCE(4201,42,18) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
RECORD – FORCEAX(2115,21,156) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
RECORD – FREEPT(9015,90,214) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
RECORD – FSLIST(8215,82,206) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
RECORD – GRAV(4401,44,26) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
RECORD – GRIDB(8115,81,205) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18

4 DMAP Programmer's Guide


Contents

RECORD – GRIDF(1215,12,229) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18


RECORD – GRIDS(1315,13,230) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
RECORD – LOAD(4551,61,84) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
RECORD – MOMAX(3815,38,157) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
RECORD – MOMENT(4801,48,19) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
RECORD – MPCADD(4891,60,83) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20
RECORD – MPCAX(4015,40,149) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20
RECORD – OMITAX(4315,43,150) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
RECORD – POINTAX(4915,49,152) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
RECORD – PRESAX(5215,52,154) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
RECORD – PRESPT(8415,84,208) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
RECORD – RINGAX(5615,56,145) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
RECORD – RINGFL(8315,83,207) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
RECORD – SECTAX(6015,70,153) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
RECORD – SEQGP(5301,53,4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
RECORD – SLBDY(1415,14,231) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
RECORD – SPCADD(5491,59,13) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
RECORD – SPCAX(6215,62,148) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
RECORD – SUPAX(6415,64,151) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
RECORD – TEMPAX(6815,68,155) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
RECORD – TEMPD(5641,65,98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
BGPDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
Record 1 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
Record 2 – XIDMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-26
Record 3 – BIDMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-26
Record 4 – NORMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-26
Record 5 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-26
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-27
BGPDT68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-27
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-27
Record 1 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-27
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-28
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-28
CASECC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-28
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-28
Record – REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-29
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-50
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-50
CDDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-52
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-52
Record 1 – List of rotor speeds (METH=1 only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-52
Record 2 – List of eigenfrequencies in the analysis system (METH=1 only) . . . . . . . . . . . 3-53
Record 3 – List of Lehr damping values (METH=1 only) . . . . . . . . . . . . . . . . . . . . . . . . 3-53
Record 4– List of real eigenvalues (METH=1 only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-53
Record 5 – List of whirl direction codes (2.0=backwards, 3.0 forward, 4.0=linear) (METH=1
only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-53

DMAP Programmer's Guide 5


Contents
Contents

Record 6 – List of converted frequencies in analysis system (METH=1 only) . . . . . . . . . . 3-54


Record 7– List of whirl direction codes for converted solution (2.0=backwords, 3.0 forward,
4.0=linear) (METH=1 only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-54
Record 1 – Data (METH=2 only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-54
Record 8 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55
CLAMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-56
Record 1 – OFPID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-56
Record 2 – LAMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-56
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57
CONTAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57
Record 1 – Repeat – Repeated for each design constraint . . . . . . . . . . . . . . . . . . . . . . 3-57
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58
CONTACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58
Record – BCMATL (7310,73,590) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58
Record – BCONP (0124,01,435) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58
Record – BCPROP (7210,72,589) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59
Record – BEDGE (8920,89,614) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59
Record – BFLUID(9001,90,964) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59
Record – BCPROPS (8301,83,605) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59
Record – BCRPARA (7710,77,594) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-60
Record – BCTADD (7510,75,592) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-60
Record – BCTPARA (7610,76,593) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-60
Record – BCTPARM (8110,81,598) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-60
Record – BCTSET (7410,74,591) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-61
Record – BGADD (8810,88,603) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-61
Record – BGPARM (8710,87,449) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-61
Record – BGSET (1224,12,446) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-62
Record – BLSEG (0224,02,436) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-62
Record – BSURF (724,7,441) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-62
Record – BSURFS (7110,71,588) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63
Record – EBDADD (8610,86,448) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63
Record – EBDSET (8510,85,447) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63
Record – NXSTRAT (7810,78,595) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63
Record – TMCPARA (7910,79,989) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64
CSTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64
Record 1 – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64
Record 2 – REALDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65
Record 3 – INTDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65
Record 4 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65
CSTM68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-66
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-66
Record 1 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-66
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-72

6 DMAP Programmer's Guide


Contents

Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-72
DBCOPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
Record 1 – EXACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
Record 2 – APPRX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
Record 3 – MAXIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
Record 4 – DVIDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
Record 5 – INITV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
Record 6 – COL17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
Record 7 – DVLABEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
Record 8 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
DESCYC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
Record – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
DESTAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76
Record – Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76
DISTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-77
Record – REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-77
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-77
DIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-77
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-77
Record – GUST(1005,10,174) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-78
Record – TABDMP1(15,21,162) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-78
Record – TABLE3D(4000,40,460) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-78
Record – TABLED1(1105,11,133) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79
Record – TABLED2(1205,12,134) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79
Record – TABLED3(1305,13,140) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79
Record – TABLED4(1405,14,141) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-80
Record – TABLEM1(105,1,93) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-80
Record – TABLEM2(205,2,94) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-80
Record – TABLEM3(305,3,95) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-81
Record – TABLEM4(405,4,96) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-81
Record – TABLES1(3105,31,97) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-81
Record – TABLEST(1905,19,178) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-82
Record – TABRND1(55,25,191) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-82
Record – TABRNDG(56,26,303) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-82
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
DSCMCOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
Record – Type 1 Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83
Record – Type 2 Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-94
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-95

DMAP Programmer's Guide 7


Contents
Contents

Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-95
DVPTAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-95
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-95
Record – REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-95
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-96
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
DYNAMIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
Record – ACSRCE(5307,53,379) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
Record – CBEAR(9010,90,569) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97
Record – DAREA(27,17,182) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-98
Record – DELAY(37,18,183) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-98
Record – DLOAD(57,5,123) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-98
Record – DPHASE(77,19,184) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-99
Record – EIGB(107,1,86) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-99
Record – EIGC(207,2,87) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-99
Record – EIGP(257,4,158) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-100
Record – EIGR(307,3,85) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-100
Record – EIGRL(308,8,348) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-101
Record – EPOINT(707,7,124) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-102
Record – FREQ(1307,13,126) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-102
Record – FREQ1(1007,10,125) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-102
Record – FREQ2(1107,11,166) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-102
Record – FREQ3(1407,14,39) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103
Record – FREQ4(1507,15,40) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103
Record – FREQ5(1607,16,41) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103
Record – NLRGAP(3707,37,556) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103
Record – NOLIN1(3107,31,127) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-104
Record – NOLIN2(3207,32,128) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-104
Record – NOLIN3(3307,33,129) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-105
Record – NOLIN4(3407,34,130) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-105
Record – PBEAR(9110,91,570) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-106
Record – RANDPS(2107,21,195) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109
Record – RANDT1(2207,22,196) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109
Record – RLOAD1(5107,51,131) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109
Record – RLOAD2(5207,52,132) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-110
Record – ROTORB (8910,89,606) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-110
Record – ROTORD(8210,82,599) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-110
Record – ROTORG(8410,84,600) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112
Record – ROTSE(9210,92,622) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112
Record – SEQEP(5707,57,135) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112
Record – TF(6207,62,136) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112
Record – TIC(6607,66,137) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-113
Record – TLOAD1(7107,71,138) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-113
Record – TLOAD2(7207,72,139) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-113
Record – TSTEP(8307,83,142) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-114
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-114
EDOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-114
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-115

8 DMAP Programmer's Guide


Contents

Record – DCONADD(5106,51,471) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-115


Record – DCONSTR(4106,41,362) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-115
Record – DDVAL(7000,70,563) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-115
Record – DESVAR(3106,31,352) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-116
Record – DLINK(3206,32,353) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-116
Record – DOPTPRM(4306,43,364) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-117
Record – DRESP1(3806,38,359) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-119
Record – DRESP2(3906,39,360) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-131
Record – DRESP3(6700,67,433) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-133
Record – DSCREEN(4206,42,363) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-135
Record – DTABLE(3706,37,358) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-135
Record – DVBSHAP(5806,58,474) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-135
Record – DVCREL1(6100,61,429) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-136
Record – DVCREL2(6200,62,430) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-136
Record – DVGEOM(5906,59,356) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-137
Record – DVGRID(4406,44,372) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-137
Record – DVMREL1(6300,63,431) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-138
Record – DVMREL2(6400,64,432) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-138
Record – DVPREL1(3306,33,354) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-139
Record – DVPREL2(3406,34,355) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-140
Record – DVSHAP(5006,50,470) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-140
Record – ERP( , , ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-141
Record – MAT1DOM(103,1,9944) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-141
Record – MAT10DOM(2801,28,9945) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-141
Record – MODTRAK(6006,60,477) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-141
Record – EODB(65535,65535,65535) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-142
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-142
EDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-142
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-142
Record – ACMODL(5201,52,373) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-142
Record – ADAPT(6301,63,397) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-143
Record – AECOMP(7801,78,582) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-144
Record – AECOMPL(7901,79,583) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-144
Record – AEDW(7301,73,574) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-144
Record – AEFACT(4002,40,273) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-145
Record – AEFORCE(7501,75,576) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-145
Record – AELINK(2602,26,386) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-146
Record – AELIST(2302,23,341) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-146
Record – AEPARM(7001,70,571) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-146
Record – AEPRESS(7401,74,575) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-147
Record – AERO(3202,32,265) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-147
Record – AEROS(2202,22,340) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-148
Record – AESTAT(2102,21,339) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-148
Record – AESURF(2002,20,338) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-148
Record – AESURFS(7701,77,581) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-149
Record – BOLT(7108,82,251) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-150
Record – CAERO1(3002,30,263) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-150
Record – CAERO2(4301,43,167) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-151
Record – CAERO3(4401,44,168) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-152

DMAP Programmer's Guide 9


Contents
Contents

Record – CAERO4(4501,45,169) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-153


Record – CAERO5(5001,50,175) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-153
Record – CLOAD(6201,62,143) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-154
Record – CSSCHD(6401,64,307) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-155
Record – DEFORM(104,1,81) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-155
Record – DIVERG(2702,27,387) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-155
Record – FLFACT(4102,41,274) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-155
Record – FLUTTER(3902,39,272) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-156
Record – GROUP(17400,174,616) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-156
Record – ITER(5808,58,220) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-157
Record – MKAERO1(3802,38,271) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-158
Record – MKAERO2(3702,37,270) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-158
Record – MONPNT1(7601,76,577) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-159
Record – PAERO1(3102,31,264) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-159
Record – PAERO2(4601,46,170) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-160
Record – PAERO3(4701,47,171) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-161
Record – PAERO4(4801,48,172) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-164
Record – PAERO5(5101,51,176) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-164
Record – PANEL(5301,53,378) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-165
Record – SET1(3502,35,268) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-165
Record – SET2(3602,36,269) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-166
Record – SET3(4302,43,607) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-166
Record – SPLINE1(3302,33,266) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-166
Record – SPLINE2(3402,34,267) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-167
Record – SPLINE3(4901,49,173) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-168
Record – SPLINE4(6501,65,308) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-168
Record – SPLINE5(6601,66,309) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-169
Record – SWLDPRM(14000,140,568) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-170
Record – TRIM(2402,24,342) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-170
Record – UXVEC(7201,72,573) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-171
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-171
EGPSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-171
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-171
Record 1 – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-171
Record 2 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-172
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-174
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-174
EGPSTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-176
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-176
Record 1 – Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-176
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-178
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-178
ELDCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-178
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-179
Record 1 – Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-179
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-180
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-180
EPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-181
RECORD – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-181

10 DMAP Programmer's Guide


Contents

RECORD – BOLTS(7108,71,251) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-181


RECORD – MATCID(17006,170,901) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-181
RECORD – NSM(3201,32,991) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-182
RECORD – NSM1(3301,33,992) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-183
RECORD – NSMADD(3401,34,993) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-184
RECORD – NSML(3501,35,994) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-184
RECORD – NSML1(3701,37,995) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-184
RECORD – PAABSF(1502,15,36) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-185
RECORD – PACABS(8300,83,382) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-185
RECORD – PACBAR(8500,85,384) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-186
RECORD – PBAR(52,20,181) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-186
RECORD – PBARL(9102,91,52) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-187
RECORD – PBCOMP(5403,55,349) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-188
RECORD – PBEAM(5402,54,262) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-195
RECORD – PBEAML(9202,92,53) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-197
RECORD – PBEND(2502,25,248) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-197
RECORD – PBUSH(1402,14,37) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-199
RECORD – PBUSH1D(3101,31,219) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-199
RECORD – PBUSHT(702,7,38) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-201
RECORD – PCOMP(2706,27,287) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-202
RECORD – PCOMPG(15006,150,604) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-202
RECORD – PCOMPS(16006,160,903) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-203
RECORD – PCONEAX(152,19,147) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-204
RECORD – PCONV(11001,110,411) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-204
RECORD – PCONVM(2902,29,420) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-205
RECORD – PDAMP(202,2,45) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-205
RECORD – PDAMPT(1202,12,33) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-205
RECORD – PDAMP5(8702,87,412) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-205
RECORD – PDUM1(6102,61,116) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM2(6202,62,117) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM3(6302,63,118) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM4(6402,64,159) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM5(6502,65,160) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM6(6602,66,161) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-206
RECORD – PDUM7(6702,67,163) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-207
RECORD – PDUM8(6802,68,164) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-207
RECORD – PDUM9(6902,69,165) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-207
RECORD – PELAS(302,3,46) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-207
RECORD – PELAST(1302,13,34) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-207
RECORD – PFAST(3601,36,55) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-208
RECORD – PGAP(2102,21,121) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-208
RECORD – PGPLSN(4102,41,904) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-208
RECORD – PHBDY(2802,28,236) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-209
RECORD – PINTC(12001,120,480) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-209
RECORD – PINTS(12101,121,484) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-210
RECORD – PLPLANE(4606,46,375) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-210
RECORD – PLSOLID(4706,47,376) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-210
RECORD – PMASS(402,4,44) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-211
RECORD – PPLANE(3801,38,979) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-211

DMAP Programmer's Guide 11


Contents
Contents

RECORD – PROD(902,9,29) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-211


RECORD – PSHEAR(1002,10,42) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-211
RECORD – PSHELL(2302,23,283) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-212
RECORD – PSHL3D(3901,39,969) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-212
RECORD – PSOLID(2402,24,281) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-213
RECORD – PSOLIDL(7602,76,370) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-213
RECORD – PTRIA6(6202,62,117) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-214
RECORD – PTUBE(1602,16,30) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-214
RECORD – PSET(10301,103,399) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-214
RECORD – PVAL(10201,102,400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-215
RECORD – PVISC(1802,18,31) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-215
RECORD – PWELD(11801,118,560) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-215
RECORD – VIEW(2606,26,289) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-216
RECORD – VIEW3D(3002,30,415) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-216
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-217
EPT705 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-217
RECORD – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-217
RECORD – BOLTS(7108,71,251) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-217
RECORD – NSM(3201,32,991) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-218
RECORD – NSM1(3301,33,992) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-218
RECORD – NSMADD(3401,34,993) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-219
RECORD – NSML(3501,35,994) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-219
RECORD – NSML1(3701,37,995) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-220
RECORD – PAABSF(1502,15,36) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-221
RECORD – PACABS(8300,83,382) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-221
RECORD – PACBAR(8500,85,384) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-222
RECORD – PBAR(52,20,181) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-222
RECORD – PBARL(9102,91,52) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-223
RECORD – PBCOMP(5403,55,349) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-223
RECORD – PBEAM(5402,54,262) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-230
RECORD – PBEAML(9202,92,53) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-232
RECORD – PBEND(2502,25,248) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-233
RECORD – PBUSH(1402,14,37) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-234
RECORD – PBUSH1D(3101,31,219) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-234
RECORD – PBUSHT(702,7,38) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-236
RECORD – PCOMP(2706,27,287) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-237
RECORD – PCOMPG(15006,150,604) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-237
RECORD – PCONEAX(152,19,147) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-238
RECORD – PCONV(11001,110,411) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-238
RECORD – PCONVM(2902,29,420) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-239
RECORD – PDAMP(202,2,45) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-239
RECORD – PDAMPT(1202,12,33) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-239
RECORD – PDAMP5(8702,87,412) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM1(6102,61,116) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM2(6202,62,117) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM3(6302,63,118) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM4(6402,64,159) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM5(6502,65,160) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-240
RECORD – PDUM6(6602,66,161) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-241

12 DMAP Programmer's Guide


Contents

RECORD – PDUM7(6702,67,163) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-241


RECORD – PDUM8(6802,68,164) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-241
RECORD – PDUM9(6902,69,165) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-241
RECORD – PELAS(302,3,46) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-241
RECORD – PELAST(1302,13,34) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-242
RECORD – PFAST(3601,36,55) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-242
RECORD – PGAP(2102,21,121) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-242
RECORD – PGPLSN(4102,41,904) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-243
RECORD – PHBDY(2802,28,236) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-243
RECORD – PINTC(12001,120,480) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-244
RECORD – PINTS(12101,121,484) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-244
RECORD – PLPLANE(4606,46,375) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-244
RECORD – PLSOLID(4706,47,376) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-245
RECORD – PMASS(402,4,44) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-245
RECORD – PPLANE(3801,38,979) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-245
RECORD – PROD(902,9,29) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-245
RECORD – PSHEAR(1002,10,42) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-246
RECORD – PSHELL(2302,23,283) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-246
RECORD – PSHL3D(3901,39,969) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-247
RECORD – PSOLID(2402,24,281) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-247
RECORD – PSOLIDL(7602,76,370) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-247
RECORD – PTRIA6(6202,62,117) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-248
RECORD – PTUBE(1602,16,30) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-248
RECORD – PSET(10301,103,399) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-249
RECORD – PVAL(10201,102,400) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-249
RECORD – PVISC(1802,18,31) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-249
RECORD – PWELD(11801,118,560) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-250
RECORD – VIEW(2606,26,289) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-250
RECORD – VIEW3D(3002,30,415) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-251
TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-251
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-251
RECORD – PCOMPS(16006,160,903) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-251
RECORD – MATCID(17006,170,901) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-252
EQEXIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-253
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-253
Record 1 – EXT2INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-253
Record 2 – EXT2SIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
Record 1 – ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-255
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-255
EST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-255

Data Block Descriptions F-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

FOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

DMAP Programmer's Guide 13


Contents
Contents

Record 1 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1


GEOM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Record – CORD1C(1701,17,6) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Record – CORD1R(1801,18,5) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Record – CORD1S(1901,19,7) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Record – CORD2C(2001,20,9) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Record – CORD2R(2101,21,8) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Record – CORD2S(2201,22,10) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Record – CORD3G(501,5,43) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Record – CORD3R(14301,143,651) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Record – CSUPER(2301,23,304) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Record – CSUPER1(5701,57,323) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Record – CSUPEXT(5501,55,297) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Record – CSUPUP(5801,58,324) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Record – EXTRN(1627,16,463) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Record – FEEDGE(6101,61,388) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Record – FEFACE(6201,62,389) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Record – GMCORD(6401,64,402) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Record – GMCURV(6601,66,392) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Record – GMSURF(10101,101,394) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Record – GRID(4501,45,1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Record – POINT(6001,60,377) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Record – SEBNDRY(1527,15,466) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Record – SEBULK(1427,14,465) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Record – SECONCT(427,4,453) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Record – SEELT(7902,79,302) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Record – SEEXCLD(527,72,454) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Record – SELABEL(1027,10,459) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Record – SELOAD(1127,11,461) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Record – SELOC(827,8,457) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Record – SEMPLN(927,9,458) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Record – SENQSET(1327,13,464) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Record – SEQGP(5301,53,4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Record – SEQSEP(5401,54,305) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Record – SESET(5601,56,296) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Record – SETREE(1227,12,462) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Record – SNORM(5678,71,475) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
GEOM2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
RECORD – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
RECORD – BEAMAERO(2601,26,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
RECORD – CAABSF(2708,27,59) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
RECORD – CAXIF2(2108,21,224) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
RECORD – CAXIF3(2208,22,225) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
RECORD – CAXIF4(2308,23,226) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
RECORD – CBAR(2408,24,180) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
RECORD – CBARAO(4001,40,275) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

14 DMAP Programmer's Guide


Contents

RECORD – CBEAM(5408,54,261) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18


RECORD – CBEAMP(11401,114,9016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
RECORD – CBEND(4601,46,298) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
RECORD – CBUSH(2608,26,60) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
RECORD – CBUSH1D(5608,56,218) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
RECORD – CCONE(2315,23,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
RECORD – CDAMP1(201,2,69) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
RECORD – CDAMP2(301,3,70) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
RECORD – CDAMP3(401,4,71) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
RECORD – CDAMP4(501,5,72) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
RECORD – CDAMP5(10608,106,404) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
RECORD – CDUM2(6208,62,108) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
RECORD – CDUM3(6308,63,109) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM4(6408,64,110) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM5(6508,65,111) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM6(6608,66,112) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM7(6708,67,113) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM8(6808,68,114) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
RECORD – CDUM9(6908,69,115) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
RECORD – CELAS1(601,6,73) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
RECORD – CELAS2(701,7,74) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
RECORD – CELAS3(801,8,75) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
RECORD – CELAS4(901,9,76) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
RECORD – CFAST(13801,138,566) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
RECORD – CFLUID2(8515,85,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
RECORD – CFLUID3(8615,86,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
RECORD – CFLUID4(8715,87,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
RECORD – CGAP(1908,19,104) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
RECORD – CGPLSTN3(13101,131,9901) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
RECORD – CGPLSTN8(13401,134,9904) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
RECORD – CGPLSTN6(13301,133,9903) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
RECORD – CGPLSTN4(13201,132,9902) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
RECORD – CHACAB(8100,81,381) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
RECORD – CHACBR(8200,82,383) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
RECORD – CHBDYE(8308,83,405) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
RECORD – CHBDYG(10808,108,406) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
RECORD – CHBDYP(10908,109,407) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
RECORD – CHEXA(7308,73,253) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
RECORD – CHEXA20F(16300,163,9989) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
RECORD – CHEXAFD(14000,140,9990) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
RECORD – CHEXAL(7708,77,9944) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
RECORD – CHEXP(12001,120,9011) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
RECORD – CHEXPR(7409,74,9991) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
RECORD – CMASS1(1001,10,65) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
RECORD – CMASS2(1101,11,66) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
RECORD – CMASS3(1201,12,67) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
RECORD – CMASS4(1301,13,68) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
RECORD – CMFREE(2508,25,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
RECORD – CONM1(1401,14,63) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36

DMAP Programmer's Guide 15


Contents
Contents

RECORD – CONM2(1501,15,64) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37


RECORD – CONROD(1601,16,47) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
RECORD – CONV(12701,127,408) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-38
RECORD – CONVM(8908,89,422) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-38
RECORD – CPENP(12101,121,9012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
RECORD – CPENTA(4108,41,280) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
RECORD – CPENTAL(7108,71,9943) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
RECORD – CPENPR(7509,75,9992) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
RECORD – CPENT15F(16500,165,9987) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
RECORD – CPENT6FD(16000,160,9988) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
RECORD – CPLSTN3(1701,17,980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
RECORD – CPLSTN4(5701,57,981) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
RECORD – CPLSTN6(5801,58,982) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
RECORD – CPLSTN8(7201,72,983) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41
RECORD – CPLSTS3(8801,88,984) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41
RECORD – CPLSTS4(8401,84,985) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41
RECORD – CPLSTS6(1801,18,986) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42
RECORD – CPLSTS8(3601,36,987) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42
RECORD – CPYRAM(17200,172,1000) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CPYRA5FD(25700,257,9948) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CPYRA13F(25800,258,9947) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CPYRAMPR(7909,79,9946) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CQDX4FD(17000,170,9980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CQDX9FD(17100,171,9979) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
RECORD – CQDX4FDN(25110,170,9951) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
RECORD – CQDX8FDN(25310,171,9949) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
RECORD – CQUAD(9108,91,507) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
RECORD – CQUAD4(2958,51,177) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
RECORD – CQUAD4FD(13900,139,9984) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
RECORD – CQUAD8(4701,47,326) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
RECORD – CQUAD9FD(16400,164,9983) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
RECORD – CQUADP(11101,111,9014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
RECORD – CQUADR(8009,80,367) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
RECORD – CQUADX(9008,90,508) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
RECORD – CQUADX4(6112,61,997) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
RECORD – CQUADX8(6114,61,999) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
RECORD – CROD(3001,30,48) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
RECORD – CSBOLT(3501,35,1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
RECORD – CSHEAR(3101,31,61) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
RECORD – CSLOT3(4408,44,227) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
RECORD – CSLOT4(4508,45,228) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48
RECORD – CTETP(12201,122,9013) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48
RECORD – CTETRA(5508,55,217) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48
RECORD – CTETPR(7609,76,9993) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
RECORD – CTETR10F(16600,166,9985) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
RECORD – CTETR4FD(16100,161,9986) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
RECORD – CTRAX3FDN(25010,168,9952) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
RECORD – CTRAX6FDN(25210,169,9950) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
RECORD – CTRIA3(5959,59,282) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50

16 DMAP Programmer's Guide


Contents

RECORD – CTRIA3FD(16200,162,9982) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50


RECORD – CTRIA6(4801,48,327) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
RECORD – CTRIA6FD(16700,167,9981) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-51
RECORD – CTRIAP(11301,113,9015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-51
RECORD – CTRIAR(9200,92,385) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-51
RECORD – CTRIAX(10108,101,512) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-51
RECORD – CTRIAX6(6108,61,107) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
RECORD – CTRAX3(6111,61,996) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
RECORD – CTRAX6(6113,61,998) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
RECORD – CTRIX3FD(16800,168,9978) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
RECORD – CTRIX6FD(16900,169,9977) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
RECORD – CTUBE(3701,37,49) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
RECORD – CVISC(3901,39,50) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
RECORD – CWELD(11701,117,559) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
RECORD – CWELDC(13501,135,564) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-55
RECORD – CWELDP(13701,137,565) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-55
RECORD – This record is no longer used– CWELDG(13601,136,562) . . . . . . . . . . . . . . 4-57
RECORD – GENEL(4301,43,28) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
RECORD – GMBNDC(3201,32,478) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
RECORD – GMBNDS(12901,129,482) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
RECORD – GMINTC(3301,33,479) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
RECORD – GMINTS(13001,130,483) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
RECORD – PLOTEL(5201,52,11) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
RECORD – Q4AERO(3002,46,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
RECORD – RADBC(12801,128,417) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
RECORD – SINT(7801,78,8883) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
RECORD – SPOINT(5551,49,105) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
RECORD – T3AERO(2701,27,0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
RECORD – VUBEAM(11601,116,9942) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
RECORD – VUHEXA(12301,123,145) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
RECORD – VUPENTA(12401,124,146) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
RECORD – VUQUAD4(11201,112,9940) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
RECORD – VUTETRA(12501,125,147) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
RECORD – VUTRIA3(11501,115,9941) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
RECORD – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
GEOM3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
Record – ACCEL(7401,74,601) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
Record – ACCEL1(7501,75,602) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
Record – BOLTFOR(7002,85,254) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-66
Record – BOLTLD(7601,76,608) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-66
Record – CRAKTP(7801,78,968) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-66
Record – DTEMP(7701,77,619) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-66
Record – DTEMPEX(8001,80,620) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
Record – FORCE(4201,42,18) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
Record – FORCE1(4001,40,20) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
Record – FORCE2(4101,41,22) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-68
Record – GMLOAD(6309,63,391) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-68

DMAP Programmer's Guide 17


Contents
Contents

Record – GRAV(4401,44,26) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-69


Record – LOAD(4551,61,84) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-70
Record – LOADCYH(3709,37,331) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-70
Record – LOADCYN(3809,38,332) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-70
Record – LOADCYT(3909,39,333) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-71
Record – LSEQ(3609,36,188) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-71
Record – MOMENT(4801,48,19) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-71
Record – MOMENT1(4601,46,21) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Record – MOMENT2(4701,47,23) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Record – PLOAD(5101,51,24) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Record – PLOAD1(6909,69,198) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Record – PLOAD2(6802,68,199) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-73
Record – PLOAD3(7109,71,255) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-73
Record – PLOAD4(7209,72,299) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-73
Record – PLOADE1(6701,67,978) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74
Record – PLOADX(7001,70,278) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74
Record – PLOADX1(7309,73,351) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74
Record – PRESAX(5215,52,154) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-75
Record – QBDY1(4509,45,239) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-75
Record – QBDY2(4909,49,240) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-75
Record – QBDY3(2109,21,414) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-75
Record – QHBDY(4309,43,233) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
Record – QVECT(2209,22,241) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
Record – QVOL(2309,23,416) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
Record – RFORCE(5509,55,190) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-77
Record – RFORCE1(17300,173,615) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-77
Record – SLOAD(5401,54,25) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
Record – TEMP(5701,57,27) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
Record – TEMPD(5641,65,98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
Record – TEMPEST(11109,111,424) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
Record – TEMPEX(8601,86,621) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Record – TEMPF(6209,62,390) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Record – TEMPIC(11209,112,425) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Record – TEMPP1(8109,81,201) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Record – TEMPP2(8209,82,202) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Record – TEMPP3(8309,83,203) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80
Record – TEMPRB(8409,84,204) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80
Record – PFACE(6409,64,9032) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-81
Record – PEDGE(6609,66,9031) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-81
Record – TEMPEX(8601,86,621) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-82
Record – VCEV(7901,79,967) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-82
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-83
GEOM4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-83
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-83
Record – ASET(5561,76,215) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-83
Record – ASET1(5571,77,216) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-83
Record – BLTMPC(12001,120,601) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84
Record – BNDFIX(110,1,584) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84
Record – BNDFIX1(210,2,585) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84

18 DMAP Programmer's Guide


Contents

Record – BNDFREE(310,3,586) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-85


Record – BNDFREE1(410,4,587) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-85
Record – BNDGRID(10200,102,473) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-85
Record – BSET(110,1,311) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-86
Record – BSET1(210,2,312) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-86
Record – CSET(310,3,313) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-86
Record – CSET1(410,4,314) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-86
Record – CYAX(1510,15,328) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-87
Record – CYJOIN(5210,52,257) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-87
Record – CYSUP(1610,16,329) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-87
Record – CYSYM(1710,17,330) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-87
Record – EGENDT(8801,88,9022) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-88
Record – FCENDT(9001,90,9024) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-89
Record – GMBC(8001,80,395) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-91
Record – GMSPC(7801,78,393) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-92
Record – MPC(4901,49,17) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-92
Record – MPCADD(4891,60,83) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-92
Record – OMIT(5001,50,15) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-92
Record – OMIT1(4951,63,92) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-93
Record – QSET(510,5,315) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-93
Record – QSET1(610,6,316) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-93
Record – RBAR(6601,66,292) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94
Record – RBE1(6801,68,294) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94
Record – RBE2(6901,69,295) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-95
Record – RBE3(7101,71,187) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-95
Record – RELEASE(1310,13,247) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-96
Record – RROD(6501,65,291) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-96
Record – RSPLINE(7001,70,186) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-96
Record – RSSCON(7201,72,398) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-97
Record – RTRPLT(6701,67,293) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-98
Record – RVDOF(9801,98,609) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99
Record – RVDOF1(9901,99,610) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99
Record – RWELD(11901,119,561) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99
Record – SEBSET(710,7,317) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99
Record – SEBSET1(810,8,318) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-100
Record – SECSET(910,9,319) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-100
Record – SECSET1(1010,10,320) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-100
Record – SEQSET(1110,11,321) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-101
Record – SEQSET1(1210,12,322) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-101
Record – SESUP(1410,14,325) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-102
Record – SEUSET(1810,18,334) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-102
Record – SEUSET1(1910,19,335) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-102
Record – SPC(5501,55,16) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-103
Record – SPC1(5481,58,12) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-103
Record – SPCADD(5491,59,13) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-103
Record – SPCD(5110,51,256) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-103
Record – SPCDE(8701,87,9021) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104
Record – SPCDF(8901,89,9023) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104
Record – SPCDG(9701,97,9030) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104

DMAP Programmer's Guide 19


Contents
Contents

Record – SPCE(9301,93,9027) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-105


Record – SPCEB(9101,91,9025) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-105
Record – SPCF(9401,94,9028) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-105
Record – SPCFB(9201,92,9026) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-106
Record – SPCGB(9601,96,9029) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-106
Record – SPCGRID(8601,86,9031) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-106
Record – SPCOFF(6110,61,343) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-106
Record – SPCOFF1(6210,62,344) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-107
Record – SUPORT(5601,56,14) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-107
Record – SUPORT1(10100,101,472) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-107
Record – TEMPBC(11309,113,426) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-107
Record – USET(2010,20,193) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-108
Record – USET1(2110,21,194) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-108
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-108
GEOM168 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-109
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-109
Record – CORD1C(1701,17,6) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-109
Record – CORD1R(1801,18,5) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-109
Record – CORD1S(1901,19,7) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-109
Record – CORD2C(2001,20,9) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-110
Record – CORD2R(2101,21,8) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-110
Record – CORD2S(2201,22,10) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-111
Record – CORD3G(501,5,43) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-112
Record – CSUPER(2301,23,304) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-112
Record – CSUPEXT(5501,55,297) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-112
Record – EXTRN(1627,16,463) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-112
Record – FEEDGE(6101,61,388) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-113
Record – GMCURV(6601,66,392) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-113
Record – FEFACE(6201,62,389) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-113
Record – POINT(6001,60,377) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114
Record – GMSURF(10101,101,394) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114
Record – GMCORD(6401,64,402) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-114
Record – GRID(4501,45,1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-115
Record – SEBNDRY(1527,15,466) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-115
Record – SEBULK(1427,14,465) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-115
Record – SECONCT(427,4,453) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-116
Record – SEELT(7902,79,302) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-116
Record – SEEXCLD(527,72,454) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-116
Record – SELABEL(1027,10,459) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-117
Record – SELOC(827,8,457) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-117
Record – SEMPLN(927,9,458) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-117
Record – SENQSET(1327,13,464) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-118
Record – SEQGP(5301,53,4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-118
Record – SEQSEP(5401,54,305) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-118
Record – SESET(5601,56,296) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-119
Record – SETREE(1227,12,462) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-119
Record – SNORM(5678,71,475) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-119
Record – CSUPER1(5701,57,323) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-119
Record – CSUPUP(5801,58,324) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-120

20 DMAP Programmer's Guide


Contents

Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-121


Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-121
GEOM4705 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-122
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-122
Record 1 – ASET(5561,76,215) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-122
Record 2 – ASET1(5571,77,216) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-122
Record 3 – BNDFIX(110,1,584) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-123
Record 4 – BNDFIX1(210,2,585) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-123
Record 5 – BNDFREE(310,3,586) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-123
Record 6 – BNDFREE1(410,4,587) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-123
Record 7 – BNDGRID(10200,102,473) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124
Record 8 – BSET(110,1,311) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124
Record 9 – BSET1(210,2,312) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124
Record 10 – CSET(310,3,313) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-125
Record 11 – CSET1(410,4,314) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-125
Record 12 – CYAX(1510,15,328) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-125
Record 13 – CYJOIN(5210,52,257) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-125
Record 14 – CYSUP(1610,16,329) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-126
Record 15 – CYSYM(1710,17,330) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-126
Record 16 – EGENDT(8801,88,9022) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-126
Record 17 – FCENDT(9001,90,9024) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-127
Record 18 – GMBC(8001,80,395) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-129
Record 19 – GMSPC(7801,78,393) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-130
Record 20 – MPC(4901,49,17) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-130
Record 21 – MPCADD(4891,60,83) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-131
Record 22 – OMIT(5001,50,15) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-131
Record 23 – OMIT1(4951,63,92) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-131
Record 24 – QSET(510,5,315) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-131
Record 25 – QSET1(610,6,316) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-132
Record 26 – RBAR(6601,66,292) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-132
Record 27 – RBE1(6801,68,294) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-132
Record 28 – RBE2(6901,69,295) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-133
Record 29 – RBE3(7101,71,187) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-133
Record 30 – RELEASE(1310,13,247) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134
Record 31– RROD(6501,65,291) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-134
Record 32– RSPLINE(7001,70,186) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-135
Record 33– RSSCON(7201,72,398) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-135
Record 34 – RTRPLT(6701,67,293) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-136
Record 35 – RWELD(11901,119,561) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-137
Record 36 – SEBSET(710,7,317) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-137
Record 37 – SEBSET1(810,8,318) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-137
Record 38 – SECSET(910,9,319) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-138
Record 39 – SECSET1(1010,10,320) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-138
Record 40 – SEQSET(1110,11,321) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-139
Record 41 – SEQSET1(1210,12,322) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-139
Record 42 – SESUP(1410,14,325) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-139
Record 43 – SEUSET(1810,18,334) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-139
Record 44 – SEUSET1(1910,19,335) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-140
Record 45 – SPC(5501,55,16) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-140

DMAP Programmer's Guide 21


Contents
Contents

Record 46 – SPC1(5481,58,12) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-140


Record 47 – SPCADD(5491,59,13) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-141
Record 48 – SPCD(5110,51,256) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-141
Record 49 – SPCDE(8701,87,9021) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-141
Record 50 – SPCDF(8901,89,9023) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-142
Record 51 – SPCDG(9701,97,9030) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-142
Record 52 – SPCE(9301,93,9027) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-142
Record 53 – SPCEB(9101,91,9025) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-143
Record 54 – SPCF(9401,94,9028) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-143
Record 55 – SPCFB(9201,92,9026) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-143
Record 56 – SPCGB(9601,96,9029) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144
Record 57 – SPCGRID(8601,86,9031) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144
Record 58 – SPCOFF(6110,61,343) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144
Record 59 – SPCOFF1(6210,62,344) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-144
Record 60 – SUPORT(5601,56,14) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-145
Record 61 – SUPORT1(10100,101,472) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-145
Record 62 – TEMPBC(11309,113,426) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-145
Record 63 – USET(2010,20,193) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-145
Record 64 – USET1(2110,21,194) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-146
Record 65 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-146
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-146
GPDT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147
Record 1 – POINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-147
GPDT68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-148
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-148
Record 1 – POINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-148
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-148
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-149
GPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-149
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-149
Record 1 – GRID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-149
Record 2 – GRIDSIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-149
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-150
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-150
HIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-150
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-150
Record 1 – Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-150
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-151
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-151
KDICT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-151
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-151
Record 1 – Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-151
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-152
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-153
LAMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-153
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-153

22 DMAP Programmer's Guide


Contents

Record 1 – OFPID – OFP Header Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-153


Record 2 – LAMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154
MPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154
Record – CREEP(1003,10,245) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154
Record – MAT1(103,1,77) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-155
Record – MAT2(203,2,78) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-155
Record – MAT3(1403,14,122) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-156
Record – MAT4(2103,21,234) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-157
Record – MAT5(2203,22,235) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-157
Record – MAT8(2503,25,288) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-157
Record – MAT9(2603,26,300) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-158
Record – MAT10(2801,28,365) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-159
Record – MAT11(2903,29,371) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-159
Record – MATCRP(4603,46,623) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-160
Record – MATFT(3403,34,902) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-161
Record – MATG (8310,83,403) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-163
Record – MATHE(7910,79,596) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-164
Record – MATHEM(3501,35,977) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-169
Record – MATHEV(3601,36,976) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-170
Record – MATHP(4506,45,374) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-170
Record – MATOVR(4703,47,624) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-172
Record – MATPLCY(3801,38,970) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-173
Record – MATS1(503,5,90) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-173
Record – MATSMA(6001,60,990) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-174
Record – MATSR(4201,42,966) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-175
Record – MATT1(703,7,91) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-175
Record – MATT2(803,8,102) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-175
Record – MATT3(1503,15,189) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-175
Record – MATT4(2303,23,237) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-175
Record – MATT5(2403,24,238) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-176
Record – MATT8(903,9,336) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-176
Record – MATT9(2703,27,301) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-177
Record – MATT11(3303,33,988) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-177
Record – MATTC(2008,20,249) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-178
Record – MATVE(3701,37,975) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-178
Record – NLPARM(3003,30,286) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-179
Record – NLPCI(3104,32,350) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-180
Record – PLCYISO(3901,39,971) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-180
Record – PLCYKIN(4001,40,972) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-181
Record – PLCYRUP(4101,41,973) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-181
Record – RADBND(9002,90,410) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-182
Record – RADM(8802,88,413) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-182
Record – RADMT(8902,89,423) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-182
Record – TSTEP1(17500,175,618) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-183
Record – TSTEPNL(3103,31,337) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-183
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-184

Data Block Descriptions O-V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

DMAP Programmer's Guide 23


Contents
Contents

OBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Record – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Record – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
OBG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Record – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Record – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
OBJTAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Record 1 – REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
OCCORF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Record 1 – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Record 2 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Record 3– TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
OCONST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
OCPSDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
Record 1 – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
Record 2 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Record 3– TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
OEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Record 3- TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
OEF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-86
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-86
OEFMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-87
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-87
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-87
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-88
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-89
OERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-89
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-89
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-89
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-91
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-91

24 DMAP Programmer's Guide


Contents

OERPEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-91
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-91
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-92
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-92
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-93
OERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-93
OES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-94
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-94
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-98
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-328
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-328
OESMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-328
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-328
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-329
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-330
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-331
OESVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-331
OESXRMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-499
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-499
Record – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-499
Record – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-501
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-567
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-567
OGF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-567
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-567
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-567
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-569
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-571
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-572
OGK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-572
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-572
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-572
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-573
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-574
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-574
OGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-574
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-574
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-574
Record 2 – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-575
Record 3 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-580
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-580
OJINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-581
OMECON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-582
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-582
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-583
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-583
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-584
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-584

DMAP Programmer's Guide 25


Contents
Contents

OMEOSC . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-584
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-585
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-585
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-585
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-586
Notes: . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-586
OMKEC . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-587
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-587
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-587
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-588
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-588
Notes: . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-588
OMKEO . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-589
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-589
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-589
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-590
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-590
Notes: . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-591
OMSEC . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-591
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-591
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-592
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-592
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-593
Notes: . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-593
OMSEO . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-593
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-594
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-594
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-594
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-595
Notes: . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-595
OPG . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-596
Record – HEADER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-596
Record – IDENT . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-596
Record – DATA . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-598
Record – TRAILER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-600
OPRESS . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-601
OPTPRM . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-602
Record - HEADER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
Record - PARAMS . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
Record - TRAILER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
OQG . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
Record – HEADER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
Record – IDENT . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-603
Record - DATA . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-606
Record – TRAILER . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-609
OQGMC . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-609
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-609
Record 1 - IDENT . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-609
Record 2 - DATA . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-611

26 DMAP Programmer's Guide


Contents

Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-611


OSDISP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
Record 1 – OSINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
Record 2 - OSNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
Record 3- Trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-612
OSHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-613
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-613
Record – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-613
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-613
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-614
OSLIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-614
OSPDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-619
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-619
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-619
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-620
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-620
OSTRMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-621
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-621
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-621
Record 2 - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-622
Record 3 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-623
OTEMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-623
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-623
Record – IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-623
Record – DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-624
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-624
OUG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-624
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-625
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-625
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-627
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-637
OUGGC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-637
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-637
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-637
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-638
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-639
OUGMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-639
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-640
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-640
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-641
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-644
OUGPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-644
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-644
Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-644
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-646
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-647
OUGRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-647

DMAP Programmer's Guide 27


Contents
Contents

Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-647


Record - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-647
Record - DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-648
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-649
R1MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-649
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-649
Record 1 – RESPONSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-649
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-650
R1TAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-650
Record - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-650
Record - Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-650
Record - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-659
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-659
RESP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-659
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-660
Record 1 - Repeat - for each Type 3 response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-660
Record 2 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-662
RESP12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-662
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-662
Record 1 - Repeat - for each Type 2 response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-662
Record 2 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-665
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-665
SEMAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-665
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-666
Record 1 - DEFINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-666
Record 2 - MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-666
Record 3 - INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-667
Record 4 - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-667
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-668
SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-669
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
Record 1 – (*) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
Record 2 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
SETMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-670
Record 1 - IDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-671
Record N - TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-671
SIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-671
Record – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-671
Record – SIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-671
Record – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-672
TOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-672
Record 0 – HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-672
Record 1 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-673
VIEWTB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-673
Record 0 - HEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-673
Record 1 - BEAMP(10500,105,14) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-673
Record 2 - HEXAP(14100,141,18) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-674

28 DMAP Programmer's Guide


Contents

Record 3 – PENTAP(14200,142,16) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-674


Record 4 - QUADP(10300,103,16) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-675
Record 5 – TETRAP(14300,143,14) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-676
Record 6 - TRIAP(10400,104,15) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-676
Record 7 – TRAILER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-677
Notes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-677

Data Block Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1


Data Block Naming Conventions . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-52
Stiffness, Damping, and Mass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-52
Superelements . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-52
Loads and Solutions . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-53
Solutions . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-53
Loads . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-53
Solution Output Tables . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-54
Miscellaneous . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-54
Inconsistent Names . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-55

NASTRAN Data Definition Language (NDDL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1


NDDL Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Descriptions of NDDL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Detailed Description of NDDL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Syntactical Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Overview of DMAP Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1


DMAP Module and Statement List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Matrix Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Utility Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1
Executive Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
Miscellaneous Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
DMAP Module and Statement Description Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
Matrix Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5
Utility Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6
Executive Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
Obsolete Modules and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

DMAP Module and Statement Descriptions A-D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1


ACMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1
ADAPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3
ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5
ADD5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7
ADDVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9
ADG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10
ADR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11
AELOOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12
AEMODEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14
AMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14
AMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16

DMAP Programmer's Guide 29


Contents
Contents

APD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17
APPEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
ASDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22
ASG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24
AXMDRV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-25
AXMPR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26
AXMPR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-27
BCDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-28
BDRYINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-29
BGCASO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-32
BGP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-32
BMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-33
BNDSPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-34
BOLTFOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-36
BOLTSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-36
CASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-37
CEAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-42
CHKCOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-45
CHKCOMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-46
CHKCVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-47
CHKPNL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-47
CKROTCN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-48
CMPZPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-49
CNTGLUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-49
CNTITER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-50
CNTMAPTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-52
CNTSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-53
CNTXTRAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-54
COMBOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-55
CONSTF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-56
CONTOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-56
COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-57
CURV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-58
CURVPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-59
CYCLIC1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-61
CYCLIC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-63
CYCLIC3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-64
CYCLIC4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-65
DBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-68
DBDELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-75
DBDICT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-76
DBEQUIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-88
SubDMAP DBFETCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-90
SubDMAP DBMGR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-91
DBSTATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-93
SubDMAP DBSTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-94
DBVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-96
DCMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-98
DDR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-101

30 DMAP Programmer's Guide


Contents

DDR2N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-104
DDRMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-107
DECOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-109
DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-113
DIAGONAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-114
DISDCMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-116
DISFBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-117
DISOFPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-118
DISOFPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-119
DISOPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-119
DISUTIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-122
DIVERG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-125
DLT2SLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-126
DMIIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-127
DOM6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-128
DOM9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-129
DOM10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-133
DOM11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-136
DOM12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-138
DOPFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-141
DOPR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-142
DOPR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-145
DOPR3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-146
DOPR4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-150
DOPR5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-150
DOPR6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-152
DOPRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-153
DPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-154
DRMH1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-156
DRMH2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-157
DRMH3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-158
DRMS1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-160
DSABO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-161
DSAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-163
DSADJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-169
DSAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-171
DSAF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-172
DSAH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-173
DSAJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-176
DSAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-177
DSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-179
DSAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-180
DSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-181
DSAPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-182
DSAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-183
DSARLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-185
DSARME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-186
DSARMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-187
DSARSN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-187

DMAP Programmer's Guide 31


Contents
Contents

DSAW . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-188
DSDVRG . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-189
DSFLTE . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-190
DSFLTF . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-191
DSMA . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-191
DSPRM . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-193
DSTA . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-195
DSTAP2 . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-197
DSVG1 . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-197
DSVG1P . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-199
DSVG2 . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-201
DSVG3 . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-202
DSVGP4 . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-202
DSVGP5 . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-204
DTIIN . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-205
DUMMOD1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-205
DUMMOD2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-206
DUMMOD3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-207
DUMMOD4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-208
DVIEWP . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-208
DYNREDU .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-210

DMAP Module and Statement Descriptions E-M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1

EFFMAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1
ELFDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
ELTPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3
EMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
EMADM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7
EMAKFR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7
EMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8
EMG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9
EMR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15
EQUIVX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15
ESTINDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-17
EXTSEIDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-17
FA1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18
FA2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-19
FBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20
FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-23
FOCOASET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-24
FOCODS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-24
FOCOEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-25
FOCOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-26
FOELCCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-27
FOELCF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-28
FOELCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-29
FOGLEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-30
FONOTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-32
FORTIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-32

32 DMAP Programmer's Guide


Contents

FRLG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-34
FRLGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-35
FRQDRV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-36
FRRD1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-37
FRRD2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-39
FRRDRU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-41
GENTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-43
GETCOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-44
GETMKL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-45
GETSCF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-46
GI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-46
GKAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-47
GKAMW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-49
GLFONOTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-51
GMERGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-52
GNFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-53
GP0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-54
GP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-55
GP1EX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-57
GP1LM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-58
GP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-58
GP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-59
GP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-61
GP5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-64
GP6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-65
GP7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-66
GPARTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-67
GPFDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-68
GPFTOTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-71
GPFXPND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-71
GPJAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-72
GPSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-72
GPSTR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-75
GPSTR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-75
GPWG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-77
GUST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-78
IFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-79
IFP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-82
IFP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-84
IFP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-86
IFP5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-87
IFP6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-88
IFP7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-90
IFP8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-91
IFP9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-91
IFPINDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-92
IFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-93
IN4WA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-94
INPUTT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-94

DMAP Programmer's Guide 33


Contents
Contents

INPUTT4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-96
INTERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-98
ISHELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-99
LAMX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-101
LANCZOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-104
LCGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-107
LMATPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-108
LRFORCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-109
MACOFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-109
MAKAEFA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-110
MAKAEFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-112
MAKAEMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-112
MAKCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-113
MAKENEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-114
MAKEOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-115
MAKETR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-118
MAKMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-119
MATGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-120
MATGPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-132
MATINIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-136
MATMOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-137
MATPCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-185
MATPRN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-187
MATPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-188
MATREDU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-188
MCE1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-190
MCE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-190
MDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-191
MDCASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-192
MERGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-195
MERGEOFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-199
MESSAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-200
MGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-200
MKCNTRL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-201
MKCSTMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-202
MKSPLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-203
MODACC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-203
MODEPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-205
MODEPOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-208
MODEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-210
MODGDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-210
MODGMRB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-211
MODGM2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-212
MODGM2B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-214
MODGM4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-215
MODTRK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-216
MODTRL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-217
MODUSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-219
MONVEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-221

34 DMAP Programmer's Guide


Contents

MPP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-221
MPYAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-223
MRGCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-228
MRGMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-229
MSGHAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-229
MSGSTRES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-230
MTRXIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-230

DMAP Module and Statement Descriptions N-X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1

NASSETS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1
NLCBRFOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1
NLCOMB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
NLCPRM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
NLITER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
NLTRD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-10
NLTRD2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
NLTRD3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-18
NORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-26
NXNADAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-27
NXNMATLB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-28
NXNRFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-29
NXNSMPK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-31
OFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-32
OPRESSDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-34
OPTGP0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-35
ORTHOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-36
OUTPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-37
OUTPUT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-40
OUTPUT4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-49
PANELERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-54
PARAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-55
PARAML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-58
Option P1 = ‘BULK’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-60
Option P1 = ‘DMI’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-61
Option P1 = ‘DTI’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-62
Option P1 = ‘DTI2’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-63
Option P1 = ‘DTI2C’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-64
Option P1 = ‘IMATCH’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-65
Option P1 = ‘NAME’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-66
Option P1 = ‘NULL’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-66
Option P1=‘PARAM’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-67
Option P1 = ‘PRESENCE’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-67
Option P1=‘SET’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-68
Option P1=‘TABDEL’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-69
Option P1=’TABINSR’, ‘TABINSI’, ‘TABINSC’, and ‘TABINS2C’ . . . . . . . . . . . . . . . . . . 11-69
Option P1=’TABREPR’, ‘TABREPI’, ‘TABREPC’, and ‘TABREP2C’ . . . . . . . . . . . . . . . . 11-71
Option P1 = ‘TRAILER’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-72
Option P1 = ‘USET’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-73
Option P1=‘XYCDB’ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-74

DMAP Programmer's Guide 35


Contents
Contents

PARTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-76
PCOMB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-80
PCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-81
PLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-82
PLTHBDY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-83
PLTSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-84
PRESOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-85
PROJVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-86
PRTMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-87
PRTPARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-88
PURGEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-89
PVT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-90
RANDOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-91
RBMG3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-94
RBMG4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-95
READ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-96
RESTART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-103
RMAXMIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-105
RMG2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-106
ROTCDA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-108
ROTCZG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-109
ROTSDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-110
ROTUTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-116
RSPEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-117
RSVECEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-118
SCALAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-119
SDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-120
SDR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-122
SDR2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-124
SDR2CVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-129
SDR3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-130
SDRCOMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-130
SDREE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-132
SDRHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-133
SDRNL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-134
SDRP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-135
SDRX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-138
SDRXD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-139
SDSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-141
SDSB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-142
SDSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-143
SECONVRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-144
SEDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-145
SEDRDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-147
SELA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-149
SEMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-150
SEP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-151
SEP1X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-153
SEP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-155

36 DMAP Programmer's Guide


Contents

SEP2CT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-156
SEP2DR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-157
SEP2X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-161
SEP3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-162
SEP4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-164
SEPDIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-165
SEPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-165
SEPR1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-167
SEQP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-168
SETMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-173
SHPCAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-173
SMA3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-174
SMPYAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-175
SOLVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-176
SOLVIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-178
SSG1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-184
SSG2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-186
SSG3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-188
SSG4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-189
STATICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-190
STDCON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-192
STRSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-193
TA1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-195
TABEDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-197
TABPRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-201
TABPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-209
TAFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-210
TAHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211
TASNP1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-212
TASNP2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-212
TEMPATT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-214
TIMETEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-216
TOLAPP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-220
TOPOPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-222
TRD1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-223
TRD2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-225
TRLG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-227
TRNSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-230
TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-230
UEIGL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-233
UGVADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-235
UMERGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-236
UMERGE1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-238
UPARTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-240
UPGLSTF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-242
UREDUC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-242
VDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-244
VDRE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-245
VDRMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-246

DMAP Programmer's Guide 37


Contents
Contents

VDRPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-248
VEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-250
VECPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-252
VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-257
VIEWP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-257
WEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-259
XSELOADS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-260
XSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-260
XYPLOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-262
XYTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-262

38 DMAP Programmer's Guide


Proprietary & Restricted Rights Notice

© 2014 Siemens Product Lifecycle Management Software Inc. All Rights Reserved.
This software and related documentation are proprietary to Siemens Product Lifecycle Management
Software Inc. Siemens and the Siemens logo are registered trademarks of Siemens AG. NX is a
trademark or registered trademark of Siemens Product Lifecycle Management Software Inc. or its
subsidiaries in the United States and in other countries.
NASTRAN is a registered trademark of the National Aeronautics and Space Administration. NX
Nastran is an enhanced proprietary version developed and maintained by Siemens Product Lifecycle
Management Software Inc.
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.
TAUCS Copyright and License
TAUCS Version 2.0, November 29, 2001. Copyright (c) 2001, 2002, 2003 by Sivan Toledo, Tel-Aviv
University, stoledo@tau.ac.il. All Rights Reserved.
TAUCS License:
Your use or distribution of TAUCS or any derivative code implies that you agree to this License.
THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED OR
IMPLIED. ANY USE IS AT YOUR OWN RISK.
Permission is hereby granted to use or copy this program, provided that the Copyright, this License,
and the Availability of the original version is retained on all copies. User documentation of any code
that uses this code or any derivative code must cite the Copyright, this License, the Availability note,
and "Used by permission." If this code or any derivative code is accessible from within MATLAB, then
typing "help taucs" must cite the Copyright, and "type taucs" must also cite this License and the
Availability note. Permission to modify the code and to distribute modified code is granted, provided
the Copyright, this License, and the Availability note are retained, and a notice that the code was
modified is included. This software is provided to you free of charge.
Availability (TAUCS)
As of version 2.1, we distribute the code in 4 formats: zip and tarred-gzipped (tgz), with or without
binaries for external libraries. The bundled external libraries should allow you to build the test
programs on Linux, Windows, and MacOS X without installing additional software. We recommend
that you download the full distributions, and then perhaps replace the bundled libraries by higher
performance ones (e.g., with a BLAS library that is specifically optimized for your machine). If you
want to conserve bandwidth and you want to install the required libraries yourself, download the
lean distributions. The zip and tgz files are identical, except that on Linux, Unix, and MacOS,
unpacking the tgz file ensures that the configure script is marked as executable (unpack with tar
zxvpf), otherwise you will have to change its permissions manually.

DMAP Programmer's Guide 39


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

DMAP Programmer's Guide 1-1


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
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 (Siemens
PLM Software 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 Scalar quantities used to control the flow of DMAP execution and to
communicate options and/or values to modules or functions.

Data Blocks Tables or matrices represented by a symbolic name.

Instructions Statements or modules that process parameters and/or data blocks


as input and/or output.

The basic syntax of the DMAP language is:

• The DMAP language uses free-field input format and is case insensitive.

1-2 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. Siemens PLM Software 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 Description Example(s)

Integer Whole number 10 or -4

Real Decimal number that is a whole number and a decimal 27000. or 2.7E5 or
point, with an optional decimal fraction. 2.7D5

Complex A pair of real numbers representing the real and imaginary (1.1,2.3) or
parts of a complex quantity (1.D0,3.5D1)

Logical Represents either TRUE or FALSE TRUE or FALSE

Character A string of 1 to 80 characters '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 Number of words

Integer 1

Real single precision 1

Real double precision 2

Complex single precision 2

Complex double precision 4

DMAP Programmer's Guide 1-3


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Type Number of words

Logical 1

Character 1 to 20

The type of a parameter must be declared in at least one of three ways:

Constant Inherent in its specification or construction

Explicit On a TYPE statement for variable parameters

Implicit 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 = a sign, plus (+) or minus (-)

nn = 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 For single precision

snn.ddDsee For double precision

where:

s = A sign, plus (+) or minus (-)

nn, dd, = Strings of digits (0 through 9)


ee

1-4 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.

DMAP Programmer's Guide 1-5


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
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 name=vfrom its first occurrence MPL default of parameter
in a TYPE statement first occurrence

NDDL default value TYPE statement default

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. Siemens
PLM Software does not recommend changing these parameter values. The predefined variable
parameters are:

NAME VALUE TYPE

ALWAYS -1 Integer

NEVER +1 Integer

TRUE TRUE Logical

FALSE FALSE Logical

NOGO 0 Integer

Initial values for variable parameters can be specified using the PARAM Bulk Data entry or the
PARAM Case Control command.

1-6 DMAP Programmer's Guide


Direct Matrix Abstraction

Parameter values from the Bulk Data Section are brought into the DMAP sequence via the IFP
module. Parameter values from case control are brought into the DMAP sequence via the PVT
module. The PVT module reads the case control PARAM commands and resolves parameter values
specified in both the Case Control and Bulk Data Sections.

Recommended Parameter Type 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, Siemens PLM Software 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 $

Siemens PLM Software does not recommend the following:


IF( FLAG ) PARAMR //'COMPLEX'//BETA/GAMMA/S,Y,ALPHA $
.
.

DMAP Programmer's Guide 1-7


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

.
ADD A,B/C/V,Y,ALPHA=(1.,1.) $

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 Sample expressions Interpreted as

–,+ Negative or Positive X–Y X(–Y)


immediately preceded by
exponentiation

** Exponentiation –X**Y –(X**Y)

–,+ Negative or Positive –X – Y (–X) – Y

*, / Multiplication or Division X*Y+Z (X*Y)+Z

+,– Addition or Subtraction X+Y X+Y

In general, mixed mode expressions are not supported. For example, to compute A = B*C, where A
and B are complex, but C is real, it is necessary to convert C to a complex number: A = B*CMPLX
(C), where CMPLX is described under “Intrinsic Functions” in this section.

Character Operator
The only character operation is concatenation. Its form is shown below.

Operator Operation Sample expressions

& Concatenation ‘ABC’ & ‘DE’ = ‘ABCDE’

1-8 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 Relation tested Expression

= Equality X=Y

<>,>< Inequality X<>Y, X><Y

< Less than X<Y

> Greater than X>Y

≤ Less than or equal X≤Y

≥ Greater than or equal X≥Y

Logical Operators

Logical operators perform tests on multiple relations or Boolean operations. A logical operator returns
a result that is either TRUE or FALSE. The outcome of a logical operation is determined as shown
in the table below. These outcomes are listed in order of precedence. Parentheses are used
to change the order of precedence.
Operations within parentheses are performed first, with the usual order of precedence being
maintained within the parentheses.

Operator X Y Output

NOT TRUE n/a FALSE

FALSE n/a TRUE

X AND Y TRUE TRUE TRUE

TRUE FALSE FALSE

FALSE TRUE FALSE

FALSE FALSE FALSE

X OR Y TRUE TRUE TRUE

TRUE FALSE TRUE

FALSE TRUE TRUE

FALSE FALSE FALSE

DMAP Programmer's Guide 1-9


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Operator X Y Output

X XOR Y TRUE TRUE FALSE

TRUE FALSE TRUE

FALSE TRUE TRUE

FALSE FALSE FALSE

X EQV Y TRUE TRUE TRUE

TRUE FALSE FALSE

FALSE TRUE FALSE

FALSE FALSE TRUE

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 Contents

1 Number of columns in matrix

2 Number of rows in matrix

3 Form of the matrix

1-10 DMAP Programmer's Guide


Direct Matrix Abstraction

Word Contents

4 Type of matrix

5 Largest number of nonzero words among all columns

6 Density of the matrix multiplied by 10000

7 Size in blocks

8 Maximum string length over all strings

9 Number of strings

10 Average bandwidth

11 Maximum bandwidth

12 Number of null columns

Form is defined as one of the following:

Form Meaning

1 Square

2 Rectangular

3 Diagonal

4 Lower triangular factor

5 Upper triangular factor

6 Symmetric

8 Identity

9 Pseudo identity

10 Cholesky factor

11 Trapezoidal factor

13 Sparse lower triangular factor

15 Sparse upper triangular factor

Type is defined as one of the following:

Type Meaning

1 Real, single precision

DMAP Programmer's Guide 1-11


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Type Meaning

2 Real, double precision

3 Complex, single precision

4 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 Referenced on a TYPE DB statement and assigned to a permanent


DBset through the NDDL

Scratch NDDL Referenced on a TYPE DB statement and assigned to the SCRATCH


DBset through the NDDL

Local 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 The data block has been created

Not generated The data block has been deleted or is not yet created

Empty The data block has been created but has no data (or purged). In other
words, the name of the data block is stored on a permanent DBset
without any associated data.

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 also

1-12 DMAP Programmer's Guide


Direct Matrix Abstraction

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. 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

DMAP Programmer's Guide 1-13


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

The MPL listing contains useful information under the following column headers:

Header Description

MOD-NAME Module name

IN Number of input data blocks

OUT Number of output data blocks

ID Parameter position

TYP type of parameter:


INT - integer
RSP - real single precision
RDP - real double precision
CSP - complex single precision
CDP - complex double precision
BCD - character
LOG - logical

DEFAULT Default value of parameter

The other column headers are less important to the DMAP programmer.
Some or all data blocks and parameters can be left unspecified (or purged), according to the module
description. 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 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. 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

DMAP Programmer's Guide 1-15


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Assignment Statement

The assignment statement evaluates an expression and assigns the resulting value to a variable
parameter. This statement has the following form:
v = e $

where v is a variable parameter name, and e is an expression. The dollar sign [$] is required to
terminate the statement. Assignment statements are arithmetic, logical, or character, depending on
the type of the variable parameter. The type of the variable and the expression must be the same. In
other words, no mixed mode specification is allowed.

Type conversions can be performed with the INT, REAL, CMPLX, ITOL, and LTOI DMAP functions.

For character assignment statements, if the length of the expression does not match the size of the
variable, the expression is adjusted as follows:

• If the expression is shorter than the variable, the expression is padded with enough blanks on the
right before the assignment takes place to make the sizes equal.

• If the expression is longer than the variable, characters on the right are truncated to make the
sizes the same.

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 ACOS(X)

I RS

RS RS

RD RD

CS CS

CD 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:

1-16 DMAP Programmer's Guide


Direct Matrix Abstraction

Abbreviation Type

I Integer

R, RS, or RD Real

C, CS, or CD Complex

A Character

L Logical

Format Definition Result Argument type to result type

ABS(x) absolute value |x| I to IR and C to R

if x is I or

R ,
if x = a + ib

ACOS(x) arccosine cos−1(x) where −1 ≤ x ≤ 1, if x is I I and R to CC to C


or R

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 I, R, and C to L

FALSE otherwise

ASIN(x) arcsin sin−1(x) where−1 ≤ x ≤ 1, if x is I or I and R to RC to C


R

The result is computed in radians.

ASINH(x) hyperbolic sine sinh−1(x) I and R to RC to C

ATAN(x) arctangent tan−1(x) I and R to RC to C

The result is computed in radians.

ATAN2(x1, x2) arctangent of tan−1(x1/x2) I and R to RC to C


quotient

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.

DMAP Programmer's Guide 1-17


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Format Definition Result Argument type to result type

(sign of a) ≠ (sign of b) and c = d = 0, the result is −π/2.

ATANH(x) hyperbolic tan−1(x) where −1 ≤ x≤ 1, if x is I or I and R to RC to C


arctangent R

ATANH2(x1, x2) hyperbolic tan−1(x1, x2) I and R to RC to C


arctangent of
quotient

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 A to I


of 4.

CLOCK( ) CPU time in sec. I


since job started

CMPLX(a, b) CMPLX(x) convert to complex a + ib See below

x, if complex

x+i

0, otherwise

For real arguments, if one value is specified, the result is (value, 0). The precision of the complex
number is dependent on the precision of the argument; 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 a1 & a2 A to A


concatenation

CONCAT2(a1, a2) concatenation a1 & a2 A to A

Any trailing blanks of a1 are compressed to a single blank before a2 is concatenated.

CONCAT3(a1, a2) concatenation a1 & a2 A to A

The result is argument 1, with trailing blanks removed and argument 2 concatenated together.

1-18 DMAP Programmer's Guide


Direct Matrix Abstraction

Format Definition Result Argument type to result type

CONJG (x) complexconjugate a − ib is conjugate to a + ib C to C

COS(x) cosine cos(x) 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 I to RD, R to RDC to CD


precision

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 I to L

FALSE otherwise

DIAGON(x1, ..) turn on DIAG TRUE if 0 < x1...xn<65 I to L

FALSE otherwise

DIM(x1, x2) positive difference x1 - MIN(x1,x2) I to I, R to RC not allowed

Mixed arguments are allowed, but function result depends solely on type of first argument. The
second argument is converted to the type of the first argument prior to application of the function.

DLABLANK(x) remove all blanks ’AB’ = DLABLANK(’A B’) A to A


(collapse string)

DLXBLANK(x) replace multiple ’AB’ = DLXBLANK(’A B’) A to A


blanks with blank
(compress string)

DPROD(x1,x2) double product 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) exponential ex I,R to R, C to C

GETDIAG(x) get DIAG cell I to I

Function returns the value of DIAG cell x, where x = 1 or 2. See “PUTDIAG, GETDIAG”.

DMAP Programmer's Guide 1-19


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Format Definition Result Argument type to result type

GETSYS(x,y) get value of SYSTEM I to I


cell y

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 2 = INDEX(’ABC’,’B’) A to I


a1

The result is zero if the second string is not found in the first string.

INDEXSTR (a1,a2,x1,x2) start position of a2 A,I to I


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 I,R,C to I


of x

For complex arguments the function is applied to the real component.

ITOL(x) type to L TRUE, if x < 0 I,R to L

FALSE, if x ≥ 0

LEQ(a1, a2) lexical equality TRUE, if a1 = a2 A to L

FALSE otherwise

1-20 DMAP Programmer's Guide


Direct Matrix Abstraction

Format Definition Result Argument type to result type

LGE(a1, a2) lexical greater than TRUE, if a1 ≥ a2 A to L


or equal to
FALSE, if a1 < a2

LGT(a1, a2) lexical greater than TRUE, if a1 > a2 A to L

FALSE, if a1 ≤ a2

LLE(a1,a2) lexical lessthan or TRUE, if a1 ≤ a2 A to L


equal
FALSE otherwise

LLT(a1, a2) lexical lessthan TRUE, if a1 ≤ a2 A to L

FALSE otherwise

LNE(a1, a2) lexical notequal to TRUE, if a1 ≠ a2 A to L

FALSE otherwise

Both arguments must be character strings. For arguments of the same length, the results are TRUE if
the strings satisfy the lexical comparison, and FALSE otherwise.

For strings of different lengths, the shorter string is padded with blanks on the right to the same size.
The strings are then compared as equal length strings.

LOG(x) natural logarithm 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) type to I -1, if x is TRUE L to I

+1, if x is FALSE

MCGETSYS(x,y) MODCOM get I output

The value of y ranges from 1 to 10.

Returns the value of system cell 70 + y. The command is similar in operation to GETSYS(x,70 + y).

MCPUTSYS(x,y) MODCOM put I output

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).

DMAP Programmer's Guide 1-21


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Format Definition Result Argument type to result type

MAX( 1,x2,...) choosing the largest max(x1,x2,...) I to I, R to R


argument

The argument list must have at least two arguments and can have up to the system limit (100) of
arguments.

Mixed argument types are allowed. Complex argument types are not allowed.

The results are integer if all arguments are integer, real single if at least one argument is real single
and no arguments are real double, and real double if at least one argument is real double.

MIN( 1,x2,...) choosing the min(x1,x2,...) I to I, R to R


smallest

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 I,R,C to L


nonequivalence

The result is TRUE if the signs of the arguments are different, FALSE otherwise.

NINT(x) type to I with INT(x + 0.5), if x ≥ 0INT(x − 0.5), I,R,C to I


Round-off if x < 0

For complex arguments the function is applied to the real component.

NOOP() no-operation returns TRUE logical output no input

NORMAL(x) normalize C to R

if x = a + bi

NOTL(x) numeric not FALSE if x < 0 I,R,C to L

TRUE otherwise

NUMEQ(x1,x2) equality TRUE, if x1 = x2 I,R,C to L

FALSE otherwise

NUMGE(x1,x2) greater than or equal TRUE if x1 ≥ x2 I,R,C to L


to
FALSE, if x1 < x2

NUMGT(x1,x2) greater than TRUE, if x1 > x2 I,R,C to L

FALSE, if x1 ≤ x2

1-22 DMAP Programmer's Guide


Direct Matrix Abstraction

Format Definition Result Argument type to result type

NUMLE(x1,x2) less than or equal to TRUE if x1 ≤ x2 I,R,C to L

FALSE otherwise

NUMLT(x1,x2) less than TRUE, if x1 < x2 I,R,C to L

FALSE otherwise

NUMNE(x1,x2) not equal to TRUE, if x1 ≠ x2 I,R,C to L

FALSE otherwise

ORL(x1,x2) numeric or TRUE, if x1 <0 or x2 < 0 I,R,C to L

FALSE otherwise

PI(x) multiples of pi xπ I,R to R, C to C

Complex arguments of (a,b) form return aπ, bπ results.

PRECISON() current analysis integer output


precision

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 x = seed if x>0. Use last RAND(x) I,R to R


generator as seed if x=0. If x<0 use wall clock
as seed.

Result precision determined by argument precision. Real double arguments return real double results.
Integer and real single arguments return real single results.

If the argument is greater than 0, calculate new random seed value, based on this value, before
generating random number. Provides reproducible random sequence.

If the argument equals 0, generate new random number from last random number generated.

If the argument is less than 0, calculate new random seed value, based on this value and current wall
clock time, before generating random number. Provides non-reproducible random sequence.

RDIAGON(x,y) turns on DIAGover TRUE if x>0, and y<65 I to L


range x to y
FALSE otherwise

The function turns on the DIAGs within the range x,y.

The value of TRUE is returned if the operation was successful.

DMAP Programmer's Guide 1-23


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

Format Definition Result Argument type to result type

REAL(x) Type to R real(x)a, if x=a+ib 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 I,RS,L


value x

SIGN(x1,x2) transfer of sign |x1|, if x2 > 0−|x1|, if x2 < 0 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) convert to single I,R to RS, C to CS

SPROD(x1,x2) single prec product x1 * x2 RD to RS, CD to CS

The results are real single if both arguments are real double and complex single if at least one of the
arguments is complex double.

SQRT(x) square root 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) tangent tan(x) I,R to R, C to C

TANH(x) hyperbolic tangent tanh(x) I,R to R, C to C

TIMETOGO() remaining CPU Time returns I

Returns the remaining CPU time in integer seconds. Time remaining is found by subtracting the
current CPU time from the value on the TIME executive control statement.

1-24 DMAP Programmer's Guide


Direct Matrix Abstraction

Format Definition Result Argument type to result type

WLEN(x) VPS word length Returns VPS word length of A,I,R,C,L to I


argument

Returns VPS word length of argument. Constant for all types, except character data that ranges
from 1-20.

XORL(x1,x2) numeric exclusive TRUE, if x1 or x2 < 0 I,R,C to L


OR
FALSE otherwise

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 $

DMAP Programmer's Guide 1-25


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
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 IF

Unconditional Branching JUMP and LABEL

Conditional Branching IF()THEN, ELSE IF()THEN, ELSE, and ENDIF

Looping DO WHILE and ENDDO

Calling SubDMAP Operations SUBDMAP, CALL, and RETURN

Termination 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, Siemens PLM Software recommends
using an IF()THEN statement.

Conditional Branching—IF ( ) THEN Statement

The IF ( ) THEN operation has the following form:

1-26 DMAP Programmer's Guide


Direct Matrix Abstraction

1. IF(expression)THEN $
.
. DMAP executed if expression is TRUE
.
ENDIF $

2. IF(expression)THEN $
.
. DMAP executed if expression is TRUE
.
ELSE $
.
. DMAP executed if expression is FALSE
.
ENDIF $

3. IF(expression 1)THEN $
.
. DMAP executed if expression 1 is TRUE
.
ELSE IF(expression 2)THEN $
.
. DMAP executed if expression 1 is FALSE
. and expression 2 is TRUE
ELSE IF(expression n)THEN $
.
. DMAP executed if expression 1 through expression
. n-1 are FALSE and expression n is TRUE
ELSE $
.
. DMAP executed if expression 1 through expression
. n are FALSE
ENDIF $

The expressions in the above examples are relational and/or logical operations that result in a logical
output of either TRUE or FALSE. The allowable relational operators are discussed in “Expressions
and Operators”

Looping—DO WHILE ( ) Statement


DO WHILE(expression) $
.
.
.

DMAP Programmer's Guide 1-27


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
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/... $]

CALL subDMAP-name [I1,I2,I3,.../


O1,O2,O3,.../
[S,]P1/[S,]P2/[S,]P3/...] $

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 RETURN
statement is not specified in the subDMAP, all DMAP execution is terminated at the END statement
(discussed in the next section).

1-28 DMAP Programmer's Guide


Direct Matrix Abstraction

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)

DMAP Programmer's Guide 1-29


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
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 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 DMI,DMINDX/A,B,C,D,E,,,,,/ $
DMIIN 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. The DMAP writer’s DMAP sequence can now be inserted.

4. TYPE statements that reference data blocks or parameters defined in the NDDL of the
structured solution sequences (SOLutions 101 through 200) can also be inserted.

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 Programmer's Guide 1-31


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

DMAP writer can choose to branch to the end of a loop or take other 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 $ ERROR FOUND IN CURRENT SE
.
.
.
PUTSYS (0,82) $ DISALLOWS DMAP TO FIELD NOGO FLAGS

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 MGEN

DECOMP MTRXIN

DYCNTRL SEDR

EMG SELA

GP2 SEMA

GP3 SSG1

GP4 TA1

LCGEN

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 DBMGR //OPT/P2/P3/P4/P5/P6/DB1/DB2/DB3/DB4/DB5 $
CALL DBSTORE DB1,DB2,DB3,DB4,DB5//Q1/Q2/DBSET/COND $
CALL DBFETCH /DB1,DB2,DB3,DB4,DB5/Q1/Q2/FLAG/0/S,SUCCESS $

1-32 DMAP Programmer's Guide


Direct Matrix Abstraction

The complete descriptions can be found in “DMAP Modules and Statements” under subDMAPs
DBFETCH, DBMGR, and DBSTORE.
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 Store data blocks on the database

CALL DBFETCH Retrieve data blocks from the database

CALL DBMGR 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 DBSTORE OES1,,,,//0/SEID/’ ’/0 $
CEND

These subDMAPs are also used in a user’s solution sequence.


SOL MYDMAP
COMPILE MYDMAP
SUBDMAP MYDMAP $
.
.
.
CALL DBSTORE A,,,,//0/1/’ ’/0 $
.
.
.
END $
CEND

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

DMAP Programmer's Guide 1-33


Chapter
Chapter 1: 1: Direct
Direct Matrix
Matrix Abstraction
Abstraction

COMPILE FNAME REF LIST


COMPILE DBMGR REF LIST
CEND

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.

1-34 DMAP Programmer's Guide


Direct Matrix Abstraction

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[;...])
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)

DMAP Programmer's Guide 1-35


Chapter 2: Overview of Data Blocks

• Introduction

• Matrix Data Blocks

• Table 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.

DMAP Programmer's Guide 2-1


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Analysis type Columns correspond to ascending

Linear statics Subcase identification number

Nonlinear statics Loop identification number

Normal or complex eigenvalues Mode number

Frequency response Subcase ID and Forcing frequency value

Transient response 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 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 DLOAD subcases, 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

2-2 DMAP Programmer's Guide


Overview of Data Blocks

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 Location in trailer

Word Position

1 – 16 1 16 – 1

17 – 32 2 16 – 1

33 – 48 3 16 – 1

49 – 64 4 16 – 1

65 – 80 5 16 – 1

81 – 96 6 16 – 1

97 – 112 1 32 – 17

113 – 128 2 32 – 17

129 – 144 3 32 – 17

145 – 160 4 32 – 17

161 – 176 5 32 – 17

For example, the GRID record in the GEOM1 data block is assigned to trailer bit 45 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.

DMAP Programmer's Guide 2-3


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Word Name Contains

1 approach_code Analysis type and output device type(s)

2 table_code Header, labeling, and sort types

9 format_code Data types (real or complex)

11 stress_code Stress/strain, von Mises/max. shear,


strain-curvature/strain-fiber flags. Also,
SPCForce/MPCForce flag.

12 jflag Acoustic element output flag

13 iacflg Acoustic displacement (pressure) output request flag:


2 = Yes and 0 = No.

14 q4cstr CQUAD4 corner output stress option

21 metrik Electromagnetic units code (1 thru 6 or 10, default=10)

22 emssol Electromagnetic static solution code


(0=CF+MAG,1=CF,2=ELEC,3=MAGN)

23 thermal Thermal (heat transfer) element output

Note

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 Operation

1 if (item_name/1000 = 2,3,6) then return 2, else return 1

2 mod(item_name,100)

3 mod(item_name,1000)

4 item_name/10

5 mod(item_name,10)

6 if iand(item_name,8)<> then set to 0, else set to 1

7 if item_name/1000
= 0 or 2, then set to 0

2-4 DMAP Programmer's Guide


Overview of Data Blocks

= 1 or 3, then set to 1
> 3, 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.

Approach_Code
Approach_code indicates the analysis type and device type(s).

1. Analysis type is equal to approach_code/10 indicates:

Type Description

1 Statics

2 Normal modes or buckling (real eigenvalues)

3 Differential stiffness 0

4 Differential stiffness 1

5 Frequency

6 Transient

7 Pre-buckling

8 Post-buckling

9 Complex eigenvalues

10 Nonlinear statics

11 Geometric nonlinear statics

12 NX Response Simulation

13 NX Response Simulation Random

14 NX Response Simulation Shock Response Spectrum

15 NX Response Simulation Quasi-Static Event

2. Device type(s) are extracted from the bit pattern equal to MOD(approach_code,10). The bits
numbered from the right are:

DMAP Programmer's Guide 2-5


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Bit Description

1 Print

2 Plot

3 Punch

Therefore, MOD(approach_code,10) can be one of the following values:

Value Device type(s)

0 None

1 Print

2 Plot

3 Print and plot

4 Punch

5 Print and punch

6 Plot and punch

7 Print, plot, and punch

Examples:

Approach_code Description

61 Print transient response results

15 Print and punch statics results

106 Plot and punch nonlinear statics results

Table_code
Table_code indicates basic table content (displacements, stresses, 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


Description
Name

1 OUG Displacement Vector

2-6 DMAP Programmer's Guide


Overview of Data Blocks

Type Data Block Description


Description
Name

2 OPG Load Vector

3 OQG SPCforce or MPCforceVector

4 OEF Element Force (or Flux)

5 OES Element Stress (or Strain)

6 LAMA Eigenvalue Summary

7 OUG Eigenvector

8 None Grid Point Singularity Table (Obsolete)

9 OEIGS Eigenvalue Analysis Summary

10 OUG Velocity Vector

11 OUG Acceleration Vector

12 OPG Nonlinear Force Vector

13 OGPWG Grid Point Weight Generator

14 OUG Eigenvector (Solution Set)

15 OUG Displacement Vector (Solution Set)

16 OUG Velocity Vector (Solution Set)

17 OUG Acceleration Vector (Solution Set)

18 OEE Element Strain Energy

19 OGF Grid Point Force Balance

20 Stresses at grid points

21 OES Strain / Curvature at Grid Points

22 OELOF1 Element Internal Forces and Moments

23 OELOP1 Summation of Element Oriented Forces on Adjacent Elements

24 OEP Element Pressures

25 OEF Composite Failure Indices

26 OGS Grid Point Stresses (Surface)

DMAP Programmer's Guide 2-7


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Data Block Description


Description
Name

27 OGS Grid Point Stresses (Volume – Direct)

28 OGS Grid Point Stresses (Volume – Principal)

29 OGS Element Stress Discontinuities (Surface)

30 OGS Element Stress Discontinuities (Volume – Direct)

31 OGS Element Stress Discontinuities (Volume – Principal)

32 OGS Grid Point Stress Discontinuities (Surface)

33 OGS Grid Point Stress Discontinuities (Volume – Direct)

34 OGS Grid Point Stress Discontinuities (Volume – Principal)

35 OGS Grid Point Stresses (Plane Strain)

36 OEE Element Kinetic Energy

37 OEE Element Energy Loss

38 OMSEC Constant modal strain energy

39 OMSED Oscillating modal strain energy

40 OMKEC Constant modal kinetic energy

41 OMKED Oscillating modal kinetic energy

42 OMECON Constant total modal energy

43 OMEOSC Oscillating total modal energy

44 OUGMC Displacement/velocity/acceleration modal contributions

45 OEFMC Element force modal contributions

46 OESMC Element stress modal contributions

47 OSTRMC Element strain modal contributions

48 OQGMC SPC force modal contributions

49 OUGPC Panel contributions

50 OUGGC Grid contributions

51 OUGRC Reciprocal panel contributions

2-8 DMAP Programmer's Guide


Overview of Data Blocks

Type Data Block Description


Description
Name

61 OGK Gasket Element Results

62 OBC Contact Pressure and Traction Results

63 OQG Contact Force Results

64 OSPDSI Contact Separation Distance - Initial

65 OSPDS Contact Separation Distance

66 OBG Glue force results (normal and in-plane tractions)

67 OQG Glue force results

68 Tosca normalized material properties

2. Data format and sort types are extracted from the bit pattern equal to table_code/1000. Bits
numbered from the right are:

Bit Description

1 Complex (on) flag

2 SORT2 (on) flag

3 Random (on) flag

Therefore, table_code/1000 can be one of the following values:

Value Sort type Data format Random

0 SORT1 Real No

1 SORT1 Complex No

2 SORT2 Real No

3 SORT2 Complex No

4 SORT1 Real Yes

6 SORT2 Real Yes

Examples:

table_code Description

4 Real Force in SORT1

DMAP Programmer's Guide 2-9


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

table_code Description

5 Real Stress/Strain in SORT1

1005 Complex Stress/Strain in SORT1

2010 Real Displacements in SORT2

3005 Complex Stress/Strain in SORT2

6003 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 Data format

1 Real

2 Real/Imaginary

3 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 Description

1 Hencky von Mises (on) flag

2 Strain (on) flag

3 Strain/fiber (on) flag

4 Same as bit 2

5 Material coordinate system (on) flag

2-10 DMAP Programmer's Guide


Overview of Data Blocks

Therefore, stress_code can be one of the following values:

Value On bits Description

0 0000 Stress maximum shear or octahedral

1 0001 Stress von Mises

10 1010 Strain Curvature maximum shear or octahedral

11 1011 Strain Curvature von Mises

14 1110 Strain Fibre maimum shear or octahedral

15 1111 Strain Fibre von Mises

In the OQG data block description, stress_code can be one of the following values:

Value Description

0 SPCForce

1 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 Name Description

00 Grid

01 CROD Rod

02 CBEAM Beam

03 CTUBE Tube

04 CSHEAR Shear panel

05 FORCE1, MOMENTi FORCEi/MOMENTi follower stiffness

06 Unused (Pre-V69 CTRIA1)

07 PLOAD4 PLOAD4 follower stiffness

08 PLOADX1 PLOADX1 follower stiffness

09 PLOAD/PLOAD2 PLOAD/PLOAD2 follower stiffness

DMAP Programmer's Guide 2-11


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

10 CONROD Rod with properties

11 CELAS1 Scalar spring

12 CELAS2 Scalar spring with properties

13 CELAS3 Scalar spring to scalar points only

14 CELAS4 Scalar spring to scalar points only with properties

15 AEROT3

16 AEROBEAM

17 Unused (Pre-V69 CTRIA2)

18 Unused (Pre-V69 CQUAD2)

19 Unused (Pre-V69 CQUAD1)

20 CDAMP1 Scalar damper

21 CDAMP2 Scalar damper with properties

22 CDAMP3 Scalar damper to scalar points only

23 CDAMP4 Scalar damper to scalar points only with properties

24 CVISC Viscous damper

25 CMASS1 Scalar mass

26 CMASS2 Scalar mass with properties

27 CMASS3 Scalar mass to scalar points only

28 CMASS4 Scalar mass to scalar points only with properties

29 CONM1 Concentrated mass – general form

30 CONM2 Concentrated mass – rigid body form

31 PLOTEL Plot

32 Unused

33 CQUAD4 Quadrilateral plate with centroid force and stress recovery

34 CBAR Simple beam (see also Type=100)

35 CONE Axisymmetric shell

36 Unused (Pre-V69 CTRIARG)

2-12 DMAP Programmer's Guide


Overview of Data Blocks

Type Name Description

37 Unused (Pre-V69 CTRAPRG)

38 CGAP Gap

39 CTETRA Four-sided solid

40 CBUSH1D Rod type spring and damper

41 Unused (Pre-V69 CHEXA1)

42 Unused (Pre-V69 CHEXA2)

43 CFLUID2 Fluid with 2 points

44 CFLUID3 Fluid with 3 points

45 CFLUID4 Fluid with 4 points

46 FLMASS

47 CAXIF2 Fluid with 2 points

48 CAXIF3 Fluid with 3 points

49 CAXIF4 Fluid with 4 points

50 CSLOT3 Three-point slot

51 CSLOT4 Four-point slot

52 HBDY Heat transfer plot for CHBDYG and CHBDYP

53 CTRIAX6 Axisymmetric triangular

54 Unused (Pre-V69 TRIM6)

55 CDUM3 Three-point dummy

56 CDUM4 Four-point dummy

57 CDUM5 Five-point dummy

58 CDUM6 Six-point dummy

59 CDUM7 Seven-point dummy

60 CDUM8 Eight-point dummy (also two-dimensional crack tip


CRAC2D)

61 CDUM9 Nine-point dummy (also three-dimensional crack tip


CRAC3D)

DMAP Programmer's Guide 2-13


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

62 Unused (Pre-V69 CQDMEM1)

63 Unused (Pre-V69 CQDMEM2)

64 CQUAD8 Curved quadrilateral shell

65 Unused (Pre-V69 CHEX8)

66 Unused (Pre-V69 CHEX20)

67 CHEXA Six-sided solid

68 CPENTA Five-sided solid

69 CBEND Curved beam or pipe

70 CTRIAR Triangular plate with corner force and stress recovery

71 Unused

72 AEROQ4

73 Unused (Pre-V69 CFTUBE)

74 CTRIA3 Triangular plate

75 CTRIA6 Curved triangular shell

76 HEXPR Acoustic velocity/pressures in six-sided solid

77 PENPR Acoustic velocity/pressures in five-sided solid

78 TETPR Acoustic velocity/pressures in four-sided solid

79 Unused

80 Unused

81 Unused

82 CQUADR Quadrilateral plate with corner force and stress recovery

83 CHACAB Acoustic absorber

84 CHACBR Acoustic barrier

85 CTETRA Nonlinear data recovery four-sided solid

86 CGAP Nonlinear data recovery gap

87 CTUBE Nonlinear data recovery tube

88 CTRIA3 Nonlinear data recovery triangular plate

2-14 DMAP Programmer's Guide


Overview of Data Blocks

Type Name Description

89 CROD Nonlinear data recovery rod

90 CQUAD4 Nonlinear data recovery quadrilateral plate

91 CPENTA Nonlinear data recovery five-sided solid

92 CONROD Nonlinear data recovery rod with properties

93 CHEXA Nonlinear data recovery six-sided solid

94 CBEAM Nonlinear data recovery beam

95 CQUAD4 Composite data recovery quadrilateral plate

96 CQUAD8 Composite data recovery curved quadrilateral shell

97 CTRIA3 Composite data recovery triangular shell

98 CTRIA6 Composite data recovery curved triangular shell

99 Unused

100 CBAR Simple beam with intermediate station data recovery

101 CAABSF Acoustic absorber with frequency dependence

102 CBUSH Generalized spring and damper

103 QUADP p-version quadrilateral shell

104 TRIAP p-version triangular shell

105 BEAMP p-version beam

106 CDAMP5 Heat transfer scalar damper with material property

107 CHBDYE Heat transfer geometric surface – element form

108 CHBDYG Heat transfer geometric surface – grid form

109 CHBDYP Heat transfer geometric surface – property form

110 CONV Heat transfer boundary with free convection

111 CONVM Heat transfer boundary with forced convection

112 QBDY3 Heat transfer boundary heat flux load for a surface

113 QVECT Heat transfer thermal vector flux load

114 QVOL Heat transfer volume heat addition

115 RADBC Heat transfer space radiation

DMAP Programmer's Guide 2-15


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

116 SLIF1D Slideline contact

117 Unused

118 Unused

119 Unused

120 Unused

121 Unused

122 Unused

123 Unused

124 Unused

125 Unused

126 Unused

127 Unused

128 Unused

129 Unused

130 Unused

131 Unused

132 Unused

133 Unused

134 Unused

135 Unused

136 Unused

137 Unused

138 Unused

139 QUAD4FD Hyperelastic 4-noded quadrilateral shell

140 HEXA8FD Hyperelastic 8-noded solid

141 HEXAP p-version six-sided solid

142 PENTAP p-version five-sided solid

2-16 DMAP Programmer's Guide


Overview of Data Blocks

Type Name Description

143 TETRAP p-version four-sided solid

144 QUAD144 Quadrilateral plate with data recovery for corner forces
and stresses

145 VUHEXA p-version six-sided solid display

146 VUPENTA p-version five-sided solid display

147 VUTETRA p-version four-sided solid display

148 Unused

149 Unused

150 Unused

151 Unused

152 Unused

153 Unused

154 Unused

155 Unused

156 Unused

157 Unused

158 Unused

159 Unused

160 PENTA6FD Hyperelastic pentahedron 6-noded

161 TETRA4FD Hyperelastic tetrahedron 4-noded

162 TRIA3FD Hyperelastic triangular 3-noded

163 HEXAFD Hyperelastic hexahedron 20-noded

164 QUADFD Hyperelastic quadrilateral 9-noded

165 PENTAFD Hyperelastic pentahedron 15-noded

166 TETRAFD Hyperelastic tetrahedron 10-noded

167 TRIAFD Hyperelastic triangular 6-noded

168 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded

DMAP Programmer's Guide 2-17


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

169 TRIAXFD Hyperelastic axisymmetric triangular 6-noded

170 QUADX4FD Hyperelastic axisymmetric quadrilateral 4-noded

171 QUADXFD Hyperelastic axisymmetric quadrilateral 9-noded

172 Unused

173 Unused

174 Unused

175 Unused

176 Unused

177 Unused

178 Unused

179 Unused

180 Unused

181 Unused

182 Unused

183 Unused

184 Unused

185 Unused

186 Unused

187 Unused

188 Unused

189 VUQUAD p-version quadrilateral shell display

190 VUTRIA p-version triangular shell display

191 VUBEAM p-version beam display

192 CVINT Curve interface

193 Unused

194 Unused

195 Unused

2-18 DMAP Programmer's Guide


Overview of Data Blocks

Type Name Description

196 Unused

197 SFINT Surface interface

198 CNVPEL

199 VUHBDY p-version HBDY display

200 CWELD Weld or fastener

201 QUAD4FD Hyperelastic quadrilateral 4-noded nonlinear d.r.


Gaus/Grid

202 HEXA8FD Hyperelastic hexahedron 8-noded nonlinear d.r.


Gaus/Grid

203 SLIF1D Slideline contact

204 PENTA6FD Hyperelastic pentahedron 6-noded nonlinear format


Gaus/Grid

205 TETRA4FD Hyperelastic tetrahedron 4-noded nonlinear format Gaus

206 TRIA3FD Hyperelastic triangular 3-noded nonlinear format Gaus

207 HEXAFD Hyperelastic hexahedron 20-noded nonlinear format


Gaus

208 QUADFD Hyperelastic quadrilateral 8-noded nonlinear format Gaus

209 PENTAFD Hyperelastic pentahedron 15-noded nonlinear format


Gaus

210 TETRAFD Hyperelastic tetrahedron 10-noded nonlinear format Grid

211 TRIAFD Hyperelastic triangular 6-noded nonlinear format


Gaus/Grid

212 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded nonlinear


format Gaus

213 TRIAXFD Hyperelastic axisymmetric triangular 6-noded nonlinear


format Gaus/Grid

214 QUADX4FD Hyperelastic axisymmetric quadrilateral 4-noded


nonlinear format Gaus/Grid

215 QUADXFD Hyperelastic axisymmetric quadrilateral 8-noded


nonlinear format Gaus

216 TETRA4FD Hyperelastic tetrahedron 4-noded nonlinear format Grid

DMAP Programmer's Guide 2-19


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

217 TRIA3FD Hyperelastic triangular 3-noded nonlinear format Grid

218 HEXAFD Hyperelastic hexahedron 20-noded nonlinear format Grid

219 QUADFD Hyperelastic quadrilateral 8-noded nonlinear format Grid

220 PENTAFD Hyperelastic pentahedron 15-noded nonlinear format


Grid

221 TETRAFD Hyperelastic tetrahedron 10-noded nonlinear format


Gaus

222 TRIAX3FD Hyperelastic axisymmetric triangular 3-noded nonlinear


format Grid

223 QUADXFD Hyperelastic axisymmetric quadrilateral 8-noded


nonlinear format Grid

224 CELAS1 Nonlinear ELAS1

225 CELAS3 Nonlinear ELAS3

226 CBUSH Nonlinear BUSH

227 CTRIAR New quadrilateral plate with data recovery for center
forces and stresses

228 QUADR New quadrilateral plate with data recovery for center
forces and stresses

229 Reserved

230 Reserved

231 Reserved

232 CQUADR – Composite Composite data recovery for new quadrilateral plate

233 CTRIAR – Composite Composite data recovery for new quadrilateral plate

234 Reserved

235 Reserved

236 Reserved

237 Reserved

238 Reserved

239 Reserved

2-20 DMAP Programmer's Guide


Overview of Data Blocks

Type Name Description

240 CTRIA6 Nonlinear Format (Center and Corners)

241 CQUAD8 Nonlinear Format (Center and Corners)

242 CTRAX3 Linear Format, Grid or Gauss (Center and Corners)

243 CQUADX4 Linear Format, Grid and Gauss (Center and Corners)

244 CTRAX6 Linear Format, Grid and Gauss (Center and Corners)

245 CQUADX8 Linear Format, Grid and Gauss (Center and Corners)

246 CTRAX3 Nonlinear Format (Center and Corners)

247 CQUADX4 Nonlinear Format (Center and Corners)

248 CTRAX6 Nonlinear Format (Center and Corners)

249 CQUADX8 Nonlinear Format

255 CPYRAM Linear Format

256 CPYRAM Nonlinear Format

257 CPYRAMFD Pyramid with 5-grids

258 CPYRAMFD Pyramid with 13-grids hyperelastic

261 CTRAX3FD Hyperelastic (261) Grid and Gauss

262 CQUADX4FD Hyperelastic, Grid or Gauss (Center and Corners)

263 CTRAX6FD Grid or Gauss hyperelastic (Center and Corners)

264 CQUADX8FD Hyperelastic (Center and Corners)

266 CQUADX8FD Hyperelastic GAUSS Locations

271 CPLSTN3 Triangle plane strain linear format (Center Only)

272 CPLSTN4 Quadrilateral plane strain linear format (Center and


Corners)

273 CPLSTN6 Triangle plane strain linear format (Center and Corners)

274 CPLSTN8 Quadrilateral plane strain linear format (Center and


Corners)

275 CPLSTS3 Triangle plane stress linear Format (Center Only)

DMAP Programmer's Guide 2-21


Chapter
Chapter 2: 2: Overview
Overview of Data
of Data Blocks
Blocks

Type Name Description

276 CPLSTS4 Quadrilateral plane stress linear format (Center and


Corners)

277 CPLSTS6 Triangle plane stress linear format (Center and Corners)

278 CPLSTS8 Quadrilateral plane stress linear format (Center and


Corners)

280 CBEAR Generalized bearing element

281 CPLSTN3 Triangle plane strain nonlinear format (Center Only)

283 CPLSTN6 Triangle plane strain nonlinear format (Center and


Corners)

284 CPLSTN8 Quadrilateral plane strain nonlinear format (Center and


Corners)

285 CPLSTS3 Triangle plane stress nonlinear format (Center Only)

287 CPLSTS6 Triangle plane stress nonlinear format (Center and


Corners)

288 CPLSTS8 Quadrilateral plane stress nonlinear format (Center and


Corners)

289 CPLSTN4 Quadrilateral plane strain nonlinear format (Center and


Corners)

290 CPLSTS4 Quadrilateral plane stress nonlinear format (Center and


Corners)

291 CPLSTN3 Triangle plane strain hyperelastic (Grid)

292 CPLSTN4 Quadrilateral plane strain hyperelastic (Grid)

293 CPLSTN6 Triangle plane strain hyperelastic (Grid)

294 CPLSTN8 Quadrilateral plane strain hyperelastic (Grid)

295 CPLSTS3 Triangle plane stress hyperelastic (Grid)

296 CPLSTS4 Quadrilateral plane stress hyperelastic (Grid)

297 CPLSTS6 Triangle plane stress hyperelastic (Grid)

298 CPLSTS8 Quadrilateral plane stress hyperelastic (Grid)

2-22 DMAP Programmer's Guide


Chapter 3: Data Block Descriptions A-E

3.1 AXIC
Element property table.

RECORD – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

RECORD – AXIC(515,5,144)

Conical shell problem flag.

Word Name Type Description

1 H I Highest harmonic

2 UNDEF None

RECORD – AXIF(8815,88,212)

Fluid related axisymmetric parameters.

Word Name Type Description

1 FCID I Fluid coordinate system identification

2 GRAV RS Value of gravity in axial direction

3 DRHO RS Default mass density for fluid elements

4 DBULK RS Default bulk modulus for fluid elements

5 NOSYM I Request for nonsymmetric series terms

6 NHARM I Number of harmonic numbers

7 N I Harmonic numbers

Words 7 repeats until -1 occurs

DMAP Programmer's Guide 3-1


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – AXSLOT(1115,11,223)
Axisymmetric slot analysis parameters.

Word Name Type Description

1 RHOD RS Density of fluids

2 BD RS Bulk modulus

3 N I Harmonic index

4 WD RS Slot width

5 MD I Number of slots

RECORD – BDYLIST(8915,89,213)
Fluid boundary list.

Word Name Type Description

1 RHO RS Fluid density at boundary

2 IDF I Identification number of a RINGFL entry

Word 2 repeats until -1 occurs

RECORD – CCONEAX(2315,23,146)
Axisymmetric shell element connection.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 RA I RINGAX identification number

4 RB I RINGAX identification number

RECORD – CFLUID2(8515,85,209)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3-2 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 IDF2 I RINGFL identification number

4 RHO RS Mass density

5 B RS Bulk modulus

RECORD – CFLUID3(8615,86,210)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3 IDF2 I RINGFL identification number

4 IDF3 I RINGFL identification number

5 RHO RS Mass density

6 B RS Bulk modulus

RECORD – CFLUID4(8715,87,211)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3 IDF2 I RINGFL identification number

4 IDF3 I RINGFL identification number

5 IDF4 I RINGFL identification number

6 RHO RS Mass density

7 B RS Bulk modulus

RECORD – FLSYM(9115,91,222)
Axisymmetric symmetry control.

DMAP Programmer's Guide 3-3


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 M I Number of symmetric sections

2 S1 I Boundary constraint

3 S2 I Boundary constraint

RECORD – FORCE(4201,42,18)
Static force.

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 F RS Scale factor

5 N1 RS Vector component in the coordinate system


defined by CID

6 N2 RS Vector component in the coordinate system


defined by CID

7 N3 RS Vector component in the coordinate system


defined by CID

RECORD – FORCEAX(2115,21,156)
Conical shell static force.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID1 I Harmonic identification number (starting value if a


sequence)

4 HID2 I Harmonic identification number (ending value if a


sequence)

5 S RS Scale factor for force

6 FR RS Force component (radial)

3-4 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 FP RS Force component (phi)

8 FZ RS Force component (z)

RECORD – FREEPT(9015,90,214)
Fluid free surface point.

Word Name Type Description

1 IDF I RINGFL identification number

2 IDP I Free point

3 PHI RS Azimuthal position

RECORD – FSLIST(8215,82,206)
Free surface list.

Word Name Type Description

1 RHO RS Mass density

2 IDF I RINGFL identification number

Word 2 repeats until -1 occurs

RECORD – GRAV(4401,44,26)
Acceleration or gravity load.

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 A RS Acceleration scale factor

4 N1 RS Vector component in the coordinate system defined


by CID

5 N2 RS Vector component in the coordinate system defined


by CID

6 N3 RS Vector component in the coordinate system defined


by CID

DMAP Programmer's Guide 3-5


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 MB I Bulk data section with CID definition: -1=main,


0=partitioned

RECORD – GRIDB(8115,81,205)
Axisymmetric grid point.

Word Name Type Description

1 ID I Grid identification number

2 CD I Coordinate system identification number

3 PA I Permanent single-point constraint

4 IDF I RINGFL identification number

5 PHI RX Azimuthal position

RECORD – GRIDF(1215,12,229)
Fluid point.

Word Name Type Description

1 ID I Point identification number

2 R RX Radial location of point

3 Z RX Axial location of point

RECORD – GRIDS(1315,13,230)
Slot surface point.

Word Name Type Description

1 ID I Slot identification number

2 IDF I GRIDF identification number

3 R RX Radial location of point

4 Z RX Axial location of point

5 W RX Slot width

3-6 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – LOAD(4551,61,84)
Static load combination.

Word Name Type Description

1 SID I Load set identification number

2 S RS Overall scale factor

3 Si RS Scale factor on Li

4 Li I Load set identification number

Words 3 and 4 repeat until (-1,-1) occurs

RECORD – MOMAX(3815,38,157)
Conical shell static moment.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID1 I Harmonic identification number (starting value if a


sequence)

4 HID2 I Harmonic identification number (ending value if a


sequence)

5 S RS Scale factor for moment

6 MR RS Moment component (radial)

7 MP RS Moment component (phi)

8 MZ RS Moment component (z)

RECORD – MOMENT(4801,48,19)
Static moment.

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

DMAP Programmer's Guide 3-7


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 M RS Moment scale factor

5 N1 RS Vector component in the coordinate system defined


by CID

6 N2 RS Vector component in the coordinate system defined


by CID

7 N3 RS Vector component in the coordinate system defined


by CID

RECORD – MPCADD(4891,60,83)
Multipoint constraint set combination.

Word Name Type Description

1 SID I Set identification number

2 S I Set identification number of multipoint constraint


set

Word 2 repeats until -1 occurs

RECORD – MPCAX(4015,40,149)
Conical shell multipoint constraint.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID I Harmonic identification number

4 C I Component number of dependent degree-of-freedom

5 A RX Coefficient

6 RID1 I RINGAX identification number

7 HID1 I Harmonic identification number

8 C I Component number of independent


degree-of-freedom

9 A RX Coefficient

Words 6 through 9 repeat until (-1,-1,-1,-1) occurs

3-8 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – OMITAX(4315,43,150)
Omitted conical shell degrees-of-freedom.

Word Name Type Description

1 RID I Ring identification number

2 HID I Harmonic identification number

3 C I Component number

RECORD – POINTAX(4915,49,152)
Conical shell point.

Word Name Type Description

1 ID I Point identification number

2 RID I RINGAX identification number

3 PHI RX Azimuthal angle

RECORD – PRESAX(5215,52,154)
Conical shell pressure load.

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure value

3 RID1 I Ring identification number

4 RID2 I Ring identification number

5 PHI1 RS Azimuthal angle

6 PHI2 RS Azimuthal angle

RECORD – PRESPT(8415,84,208)
Fluid pressure point.

Word Name Type Description

1 IDF I Fluid point identification number

2 IDP I Pressure point identification number

DMAP Programmer's Guide 3-9


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 PHI RS Azimuthal angle

RECORD – RINGAX(5615,56,145)
Conical shell ring.

Word Name Type Description

1 ID I Ring identification number

2 R RX Ring radius

3 Z RX Ring axial location

4 PS I Permanent single-point constraint

RECORD – RINGFL(8315,83,207)
Axisymmetric fluid point.

Word Name Type Description

1 IDF I Fluid identification number

2 UNDEF None

3 X1 RX Coordinate of point

4 X2 RX Coordinate of point

5 X3 RX Coordinate of point

RECORD – SECTAX(6015,70,153)
Conical shell sector.

Word Name Type Description

1 ID I Sector identification number

2 RID I Ring identification number

3 R RX Effective radius

4 PHI1 RX Azimuthal angle limit of sector

5 PHI2 RX Azimuthal angle limit of sector

3-10 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – SEQGP(5301,53,4)
Grid and scalar point resequencing.

Word Name Type Description

1 ID I Grid or scalar point identification number

2 SEQID I Sequenced identification number

RECORD – SLBDY(1415,14,231)
Slot boundary list.

Word Name Type Description

1 RHO RS Density of fluid

2 M I Number of slots

3 ID I Identification number of GRIDS slot point

Word 3 repeats until -1 occurs

RECORD – SPCADD(5491,59,13)
Single-point constraint set combination.

Word Name Type Description

1 SID I Set identification number

2 S I Single-point constraint set identification number

Word 2 repeats until -1 occurs

RECORD – SPCAX(6215,62,148)
Conical shell single-point constraint.

Word Name Type Description

1 SID I Set identification number

2 RID I Ring identification number

3 HID I Harmonic identification number

4 C I Component identification number

5 D RS Enforced displacement value

DMAP Programmer's Guide 3-11


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – SUPAX(6415,64,151)
Conical shell fictitious support.

Word Name Type Description

1 RID I Ring identification number

2 HID I Harmonic identification number

3 C I Component identification number

RECORD – TEMPAX(6815,68,155)
Conical shell temperature.

Word Name Type Description

1 SID I Temperature set identification number

2 RID I Ring identification number

3 PHI RS Azimuthal angle

4 TEMP RS Temperature

RECORD – TEMPD(5641,65,98)
Grid point temperature field default.

Word Name Type Description

1 SID I Temperature set identification number

2 T RS Temperature

TRAILER
Word Name Type Description

1-6 UNDEF(6) None

Notes:
1. The following records are used with conical shell elements: AXIC, CCONEAX, FORCEAX,
MOMAX, MPCAX, OMITAX, POINTAX, PRESAX, RINGAX, SECTAX, SPCAX, SUPAX, and
TEMPAX.

2. The following records are used with hydroelastic elements: AXIF, BDYLIST, CFLUID2, CFLUID3,
CFLUID4, FLSYM, FREEPT, FSLIST, GRIDB, PRESPT, and RINGFL.

3-12 DMAP Programmer's Guide


Data Block Descriptions A-E

3. The following records are used with acoustic cavity elements: AXSLOT, GRIDF, GRIDS, and
SLBDY.

3.2 AXIC68
Element property table (Pre-MSC Nastran Version 69).
Note

See the Note 4 for a listing of the differences between AXIC68 and AXIC.

RECORD – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

RECORD – AXIC(515,5,144)
Conical shell problem flag.

Word Name Type Description

1 H I Highest harmonic

2 UNDEF None

RECORD – AXIF(8815,88,212)
Fluid related axisymmetric parameters.

Word Name Type Description

1 FCID I Fluid coordinate system identification

2 GRAV RS Value of gravity in axial direction

3 DRHO RS Default mass density for fluid elements

4 DBULK RS Default bulk modulus for fluid elements

5 NOSYM I Request for nonsymmetric series terms

6 NHARM I Number of harmonic numbers

7 N I Harmonic numbers

Words 7 repeats until -1 occurs

DMAP Programmer's Guide 3-13


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – AXSLOT(1115,11,223)
Axisymmetric slot analysis parameters.

Word Name Type Description

1 RHOD RS Density of fluids

2 BD RS Bulk modulus

3 N I Harmonic index

4 WD RS Slot width

5 MD I Number of slots

RECORD – BDYLIST(8915,89,213)
Fluid boundary list.

Word Name Type Description

1 RHO RS Fluid density at boundary

2 IDF I Identification number of a RINGFL entry

Word 2 repeats until -1 occurs

RECORD – CCONEAX(2315,23,146)
Axisymmetric shell element connection.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 RA I RINGAX identification number

4 RB I RINGAX identification number

RECORD – CFLUID2(8515,85,209)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3-14 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 IDF2 I RINGFL identification number

4 RHO RS Mass density

5 B RS Bulk modulus

RECORD – CFLUID3(8615,86,210)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3 IDF2 I RINGFL identification number

4 IDF3 I RINGFL identification number

5 RHO RS Mass density

6 B RS Bulk modulus

RECORD – CFLUID4(8715,87,211)
Fluid element connections.

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL identification number

3 IDF2 I RINGFL identification number

4 IDF3 I RINGFL identification number

5 IDF4 I RINGFL identification number

6 RHO RS Mass density

7 B RS Bulk modulus

RECORD – FLSYM(9115,91,222)
Axisymmetric symmetry control.

DMAP Programmer's Guide 3-15


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 M I Number of symmetric sections

2 S1 I Boundary constraint

3 S2 I Boundary constraint

RECORD – FORCE(4201,42,18)
Static force.

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 F RS Scale factor

5 N1 RS Vector component in the coordinate system


defined by CID

6 N2 RS Vector component in the coordinate system


defined by CID

7 N3 RS Vector component in the coordinate system


defined by CID

RECORD – FORCEAX(2115,21,156)
Conical shell static force.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID1 I Harmonic identification number (starting value if a


sequence)

4 HID2 I Harmonic identification number (ending value if a


sequence)

5 S RS Scale factor for force

6 FR RS Force component (radial)

3-16 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 FP RS Force component (phi)

8 FZ RS Force component (z)

RECORD – FREEPT(9015,90,214)
Fluid free surface point.

Word Name Type Description

1 IDF I RINGFL identification number

2 IDP I Free point

3 PHI RS Azimuthal position

RECORD – FSLIST(8215,82,206)
Free surface list.

Word Name Type Description

1 RHO RS Mass density

2 IDF I RINGFL identification number

Word 2 repeats until -1 occurs

RECORD – GRAV(4401,44,26)
Acceleration or gravity load.

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 A RS Acceleration scale factor

4 N1 RS Vector component in the coordinate system defined


by CID

5 N2 RS Vector component in the coordinate system defined


by CID

6 N3 RS Vector component in the coordinate system defined


by CID

DMAP Programmer's Guide 3-17


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 MB I Bulk data section with CID definition: -1=main,


0=partitioned

RECORD – GRIDB(8115,81,205)
Axisymmetric grid point.

Word Name Type Description

1 ID I Grid identification number

2 PHI RS Azimuthal position

3 CD I Coordinate system identification number

4 PA I Permanent single-point constraint

5 IDF I RINGFL identification number

RECORD – GRIDF(1215,12,229)
Fluid point.

Word Name Type Description

1 ID I Point identification number

2 R RS Radial location of point

3 Z RS Axial location of point

RECORD – GRIDS(1315,13,230)
Slot surface point.

Word Name Type Description

1 ID I Slot identification number

2 R RS Radial location of point

3 Z RS Axial location of point

4 W RS Slot width

5 IDF I GRIDF identification number

3-18 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – LOAD(4551,61,84)
Static load combination.

Word Name Type Description

1 SID I Load set identification number

2 S RS Overall scale factor

3 Si RS Scale factor on Li

4 Li I Load set identification number

Words 3 and 4 repeat until (-1,-1) occurs

RECORD – MOMAX(3815,38,157)
Conical shell static moment.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID1 I Harmonic identification number (starting value if a


sequence)

4 HID2 I Harmonic identification number (ending value if a


sequence)

5 S RS Scale factor for moment

6 MR RS Moment component (radial)

7 MP RS Moment component (phi)

8 MZ RS Moment component (z)

RECORD – MOMENT(4801,48,19)
Static moment.

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

DMAP Programmer's Guide 3-19


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 M RS Moment scale factor

5 N1 RS Vector component in the coordinate system defined


by CID

6 N2 RS Vector component in the coordinate system defined


by CID

7 N3 RS Vector component in the coordinate system defined


by CID

RECORD – MPCADD(4891,60,83)
Multipoint constraint set combination.

Word Name Type Description

1 SID I Set identification number

2 S I Set identification number of multipoint constraint


set

Word 2 repeats until -1 occurs

RECORD – MPCAX(4015,40,149)
Conical shell multipoint constraint.

Word Name Type Description

1 SID I Load set identification number

2 RID I RINGAX identification number

3 HID I Harmonic identification number

4 C I Component number of dependent degree-of-freedom

5 A RS Coefficient

6 RID1 I RINGAX identification number

7 HID1 I Harmonic identification number

8 C I Component number of independent


degree-of-freedom

9 A RS Coefficient

Words 6 through 9 repeat until (-1,-1,-1,-1) occurs

3-20 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – OMITAX(4315,43,150)
Omitted conical shell degrees-of-freedom.

Word Name Type Description

1 RID I Ring identification number

2 HID I Harmonic identification number

3 C I Component number

RECORD – POINTAX(4915,49,152)
Conical shell point.

Word Name Type Description

1 ID I Point identification number

2 RID I RINGAX identification number

3 PHI RS Azimuthal angle

RECORD – PRESAX(5215,52,154)
Conical shell pressure load.

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure value

3 RID1 I Ring identification number

4 RID2 I Ring identification number

5 PHI1 RS Azimuthal angle

6 PHI2 RS Azimuthal angle

RECORD – PRESPT(8415,84,208)
Fluid pressure point.

Word Name Type Description

1 IDF I Fluid point identification number

2 IDP I Pressure point identification number

DMAP Programmer's Guide 3-21


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 PHI RS Azimuthal angle

RECORD – RINGAX(5615,56,145)

Conical shell ring.

Word Name Type Description

1 ID I Ring identification number

2 R RS Ring radius

3 Z RS Ring axial location

4 PS I Permanent single-point constraint

RECORD – RINGFL(8315,83,207)

Axisymmetric fluid point.

Word Name Type Description

1 IDF I Fluid identification number

2 X1 RS Coordinate of point

3 X2 RS Coordinate of point

4 X3 RS Coordinate of point

RECORD – SECTAX(6015,70,153)

Conical shell sector.

Word Name Type Description

1 ID I Sector identification number

2 RID I Ring identification number

3 R RS Effective radius

4 PHI1 RS Azimuthal angle limit of sector

5 PHI2 RS Azimuthal angle limit of sector

3-22 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – SEQGP(5301,53,4)
Grid and scalar point resequencing.

Word Name Type Description

1 ID I Grid or scalar point identification number

2 SEQID I Sequenced identification number

RECORD – SLBDY(1415,14,231)
Slot boundary list.

Word Name Type Description

1 RHO RS Density of fluid

2 M I Number of slots

3 ID I Identification number of GRIDS slot point

Word 3 repeats until -1 occurs

RECORD – SPCADD(5491,59,13)
Single-point constraint set combination.

Word Name Type Description

1 SID I Set identification number

2 S I Single-point constraint set identification number

Word 2 repeats until -1 occurs

RECORD – SPCAX(6215,62,148)
Conical shell single-point constraint.

Word Name Type Description

1 SID I Set identification number

2 RID I Ring identification number

3 HID I Harmonic identification number

4 C I Component identification number

5 D RS Enforced displacement value

DMAP Programmer's Guide 3-23


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – SUPAX(6415,64,151)
Conical shell fictitious support.

Word Name Type Description

1 RID I Ring identification number

2 HID I Harmonic identification number

3 C I Component identification number

RECORD – TEMPAX(6815,68,155)
Conical shell temperature.

Word Name Type Description

1 SID I Temperature set identification number

2 RID I Ring identification number

3 PHI RS Azimuthal angle

4 TEMP RS Temperature

RECORD – TEMPD(5641,65,98)
Grid point temperature field default.

Word Name Type Description

1 SID I Temperature set identification number

2 T RS Temperature

TRAILER
Word Name Type Description

1-6 UNDEF(6) None

Notes:
1. The following records are used with conical shell elements: AXIC, CCONEAX, FORCEAX,
MOMAX, MPCAX, OMITAX, POINTAX, PRESAX, RINGAX, SECTAX, SPCAX, SUPAX, and
TEMPAX.

2. The following records are used with hydroelastic elements: AXIF, BDYLIST, CFLUID2, CFLUID3,
CFLUID4, FLSYM, FREEPT, FSLIST, GRIDB, PRESPT, and RINGFL.

3-24 DMAP Programmer's Guide


Data Block Descriptions A-E

3. The following records are used with acoustic cavity elements: AXSLOT, GRIDF, GRIDS, and
SLBDY.

4. AXIC68 is the same as AXIC except that:


• In RECORD - GRIDB, PHI is converted from RX to RS and is moved from Word 5 to Word 2.
CD, PA, and IDF are moved to Words 3, 4, and 5, respectively.

• In RECORD - GRIDF, R and Z are converted from RX to RS.

• In RECORD - GRIDS, R, Z, and W are converted from RX to RS and are moved from Words
3, 4, and 5 to Words 2, 3, and 4, respectively.

• In RECORD - MPCAX, A is converted from RX to RS in both Word 5 and Word 9.

• In RECORD - POINTAX, PHI is converted from RX to RS.

• In RECORD - RINGAX, R, and Z are converted from RX to RS.

• In RECORD - RINGFL, X1, X2, and X3 are converted from RX to RS and UNDEF is stripped
from the record. The record size is reduced from 5 words to 4 words.

• In RECORD - SECTAX, R, PHI1, and PHI2 are converted from RX to RS.

3.3 BGPDT
Basic grid point definition table.
Contains a list of all grid points in internal sort, with (for grid points) their x, y, z locations in the basic
coordinate system along with a displacement coordinate system identification number.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – DATA

Word Name Type Description

1 CID I Coordinate system identification number

2 SIL I Internal (scalar) identification number

3 EXTID I External (User) identification number

4 DOF_TYPE I Degree of freedom/Point Type

5 PSC I Permanent Set Constraint

DMAP Programmer's Guide 3-25


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

6 BGID I Boundary Grid ID of –EXTID

7 XCOORD RX x in basic coordinate system

8 YCOORD RX y in basic coordinate system

9 ZCOORD RX z in basic coordinate system

Words 1 through 9 repeat until End of Record

Record 2 – XIDMAP

Word Name Type Description

1 EXTID I External identification number

2 INTID I Internal identification number

Words 1 through 2 repeat until End of Record

Record 3 – BIDMAP

Word Name Type Description

1 BGID I Boundary (System) identification number

2 INTID I Internal identification number

Words 1 through 2 repeat until End of Record

Record 4 – NORMAL

Word Name Type Description

1 XNORM RX X normal in aerodynamic system

2 YNORM RX Y normal in aerodynamic system

3 ZNORM RX Z normal in aerodynamic system

Words 1 through 3 repeat until End of Record

Record 5 – TRAILER

Word Name Type Description

1 WORD1 I Number of grid points and scalar points

3-26 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 WORD2 I Number of boundary points

3 WORD3 I Number of degrees-of-freedom

4 WORD4 I Precision of the real values; for example, type=RX

5 WORD5 I Number of scalar points

6 WORD6 I Maximum external identification number

Notes:
1. For partitioned superelements the locations are in the 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. PARAM,OMACHPR,YES can 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.4 BGPDT68
Basic grid point definition table (Pre-MSC Nastran Version 69).
Contains a list of all grid points in internal sort, with (for grid points) their x, y, z locations in the basic
coordinate system along with a displacement coordinate system identification number.
Note

See the Note 3 for a listing of the differences between BGPDT68 and BGPDT.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – DATA

Word Name Type Description

1 CID I Coordinate system identification number

DMAP Programmer's Guide 3-27


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

2 XCOORD RS x in basic coordinate system

3 YCOORD RS y in basic coordinate system

4 ZCOORD RS z in basic coordinate system

Words 1 through 4 repeat until End of Record

Record 2 – TRAILER
Word Name Type Description

1 WORD1 I Number of grid and scalar points

2 UNDEF(5 ) None

Notes:
1. Scaler points are identified by CID=-1 and XCOORD = YCOORD = ZCOORD = 0.

2. When the BGPDT68 data block is written by the MAKEOLD module, the data is named BGPDT
although the BGPDT68 format is written.

3. BGPDT68 is the same as BGPDT except that:


• In Record - DATA, X1, X2, and X3 are converted from RX to RS.

• SIL, EXTID, DOF_TYPE, PSC, and BGID are stripped from Record - DATA. The record
size is reduced from 9 words to 4 words.

• Record - XIDMAP is removed.

• Record - BIDMAP is removed.

• Record - NORMAL is removed.

• In Record - TRAILER, WORD2 through WORD6 are undefined.

3.5 CASECC
Case control information

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3-28 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – REPEAT

Word Name Type Description

1 SID I Subcase identification number

2 MPCSET I Multipoint constraint set (MPC)

3 SPCSET I Single point constraint set (SPC)

4 ESLSET I External static load set (LOAD)

5 REESET I Real eigenvalue extraction set


(METHOD(STRUCTURE))

6 ELDSET I Element deformation set (DEFORM)

7 THLDSET I Thermal load set (TEMP(LOAD))

8 THMATSET I Thermal material set TEMP(MAT or INIT)

9 TIC I Transient initial conditions (IC)

10 NONPTSET I Nonlinear load output set (NLLOAD)

11 NONMEDIA I Nonlinear load output media (NLLOAD)

12 NONFMT I Nonlinear load output format (NLLOAD)

13 DYMLDSET I Dynamic load set (DLOAD)

14 FEQRESET I Frequency response set (FREQUENCY)

15 TFSET I Transfer function set (TFL)

16 SYMFLG I Symmetry flag (SYMSEQ and SUBSEQ)

17 LDSPTSET I Load output set (OLOAD)

18 LDSMEDIA I Load output media (OLOAD)

19 LDSFMT I Load output format (OLOAD)

20 DPLPTSET I Displ., temp., or pressure output set


(DISP,THERM,PRES)

21 DPLMEDIA I Displ., temp., or pressure output media


(DISP,THERM,PRES)

22 DPLFMT I Displ., temp., or pressure output format


(DISP,THERM,PRES)

23 STSPTSET I Stress output set (STRESS)

DMAP Programmer's Guide 3-29


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

24 STSMEDIA I Stress output media (STRESS)

25 STSFMT I Stress output format (STRESS)

26 FCEPTSET I Force (or flux) output set (FORCE or FLUX)

27 FCEMEDIA I Force (or flux) output media (FORCE or FLUX)

28 FCEFMT I Force (or flux) output format (FORCE or FLUX)

29 ACCPTSET I Acceleration (or enthalpy delta) output set


(ACCEL or HDOT)

30 ACCMEDIA I Acceleration (or enthalpy delta) output media


(ACCE, HDOT)

31 ACCFMT I Acceleration (or enthalpy delta) output format


(ACCE, HDOT)

32 VELPTSET I Velocity (or enthalpy) output set (VELOCITY


or ENTHALPY)

33 VELMEDIA I Velocity (or enthalpy) output media


(VELOCITY) or ENTHALPY)

34 VELFMT I Velocity (or enthalpy) output format


(VELOCITY) or ENTHALPY)

35 FOCPTSET I Forces of single-point constraint output set


(SPCFORCE)

36 FOCMEDIA I Forces of single-point constraint output media


(SPCFORCE)

37 FOCFMT I Forces of single-point constraint output format


(SPCFORCE)

38 TSTEPTRN I Time step set for transient analysis (TSTEP)

39 TITLE(32) CHAR4 Title character string (TITLE)

71 SUBTITLE(32) CHAR4 Subtitle character string (SUBTITLE)

103 LABEL(32) CHAR4 LABEL character string (LABEL)

135 STPLTFLG I Model plot flag: set to 1 if OUTPUT(PLOT) is


specified

136 AXSYMSET I Axisymmetric set (AXISYMMETRIC)

137 NOHARMON I Number of harmonics to output (HARMONICS)

3-30 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

138 TSTRV I Need definition

139 K2PP(2) CHAR4 Name of direct input (p-set) stiffness matrix


(K2PP)

141 M2PP(2) CHAR4 Name of direct input (p-set) mass matrix


(M2PP)

143 B2PP(2) CHAR4 Name of direct input (p-set) damping matrix


(B2PP)

145 OUTRESPV I Output frequencies or times (OFREQ or


OTIME)

146 SEDR I Data recovery superelement list (SEDR)

147 FLDBNDY I Fluid boundary element selection (MFLUID)

148 CEESET I Complex eigenvalue extraction set


(CMETHOD)

149 DAMPTBL I Structural damping table set


(SDAMP(STRUCT)

151 SSDSET I Solution set displacements output set (SDISP)

152 SSDMEDIA I Solution set displacements output media


(SDISP)

153 SSDFMT I Solution set displacements output format


(SDISP)

154 SSVSET I Solution set velocities output set (SVELO)

155 SSVMEDIA I Solution set velocities output media (SVELO)

156 SSVFMT I Solution set velocities output format (SVELO)

157 SSASET I Solution set accelerations output set (SACCE)

158 SSAMEDIA I Solution set accelerations output media


(SACCE)

159 SSAFMT I Solution set accelerations output format


(SACCE)

160 NONLINLD I Nonlinear load set in transient problems


(NONLINEAR)

161 PARTIT I Partitioning set (PARTN)

DMAP Programmer's Guide 3-31


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

162 CYCLIC I Symmetry option in cyclic symmetry (DSYM)

163 RANDOM I Random analysis set (RANDOM)

164 NONPARAM I Nonlinear static analysis control parameters


(NLPARM)

165 FLUTTER I Flutter set (FMETHOD)

166 LCC I Number of words in this record up to LSEM

167 GPFSET I Grid point force output set (GPFORCE)

168 GPFMEDIA I Grid point force output media (GPFORCE)

169 GPFFMT I Grid point force output format (GPFORCE)

170 ESESET I Strain energy output set (ESE)

171 ESEMEDIA I Strain energy output media (ESE)

172 ESEFMT I Strain energy output format (ESE)

173 ARFPTSET I Aerodynamic force output set (AEROF)

174 ARFMEDIA I Aerodynamic force output media (AEROF)

175 ARFFMT I Aerodynamic force output format (AEROF)

176 SEID I Superelement ID (SUPER)

177 LCN I Load column number (SUPER)

178 GUST I Gust load selection (GUST)

179 SEFINAL I Final Superelement ID (SEFINAL)

180 SEMG I Generate matrices (K,M,B,K4) for


superelement set or ID (SEMG)

181 SEKR I Reduce stiffness matrix (K) for superelement


set or ID (SEKR)

182 SELG I Generate static loads for superelement set or


ID (SELG)

183 SELR I Reduce static loads for superelement set or


ID (SELR)

184 SEEX I Superelement set or ID to be excluded


(SEEXCLUDE)

3-32 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

185 K2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix


(K2GG)

187 M2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix


(M2GG)

189 B2GG(2) CHAR4 Name of direct input (g-set) stiffness matrix


(B2GG)

191 SVSET I Solution eigenvector output set (SVECTOR)

192 SVMEDIA I Solution eigenvector output media (SVECTOR)

193 SVFMT I Solution eigenvectors output format


(SVECTOR)

194 FLUPTSET I Fluid pressure output set (MPRES)

195 FLUMEDIA I Fluid pressure output media (MPRES)

196 FLUFMT I Fluid pressure output format (MPRES)

197 HOUT(3) I Cyclic symmetry harmonic output (HOUTPUT)

200 NOUT(3) I Cyclic symmetry physical output (NOUTPUT)

203 P2G(2) CHAR4 Name of direct input (g-set) static loads matrix
(P2G)

205 LOADSET I Sequence of static loads sets (LOADSET)

206 SEMR I Generate matrices (M,B,K4) for superelement


set or ID (SEMG)

207 VONMISES I von Mises fiber (STRESS)

208 SECMDFLG I Superelement command existence flag

209 GPSPTSET I Grid point stress output set (GPSTRESS)

210 GPSMEDIA I Grid point stress output media (GPSTRESS)

211 GPSFMT I Grid point stress output format (GPSTRESS)

212 STFSET I Grid point stress field output set (STRFIELD)

213 STFMEDIA I Grid point stress field output media (STRFIELD

214 STFFMT I Grid point stress field output format


(STRFIELD)

DMAP Programmer's Guide 3-33


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

215 CLOAD I Superelement static load combination set


(CLOAD)

216 SET2ID I Legacy design sensitivity contraint and


variable set (SET2)

217 DSAPRT I Legacy design sensitivity analysis print option


(SENSITY)

218 DSASTORE I Legacy design sensitivity analysis store option


(SENSITY)

219 DSAOUTPT I Legacy design sensitivity analysis OUTPUT4


option (SENSITY)

220 STNSET I Strain output set (STRAIN)

221 STNMEDIA I Strain output media (STRAIN)

222 STNFMT I Strain output format (STRAIN)

223 APRESS I Aerodynamic pressure output set


(APRESSURE)

224 TRIM I Aerostatic trim variable constrain set (TRIM)

225 MODLIST I Output modes list set (OMODES)

226 REESETF I Real eigenvalue extraction set for fluid


(METHOD(FLUID))

227 ESDPTSET I Element stress discontinuity output set


(ELSDCON)

228 ESDMEDIA I Element stress discontinuity output media


(ELSDCON)

229 ESDFMT I Element stress discontinuity output format


(ELSDCON)

230 GSDPTSET I Grid point stress discontinuity output set


(GPSDCON)

231 GSDMEDIA I Grid point stress discontinuity output media


(GPSDCON)

232 GSDFMT I Grid point stress discontinuity output format


(GPSDCON)

233 SEDV I Generate pseudo-loads for superelement set


or identification number (SEDV)

3-34 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

234 SERE I Generate responses for superelement set or


ID (SERESP)

235 SERS I Restart processing for superelement set or ID


(SERS)

236 CNTSET I Slideline contact output set (BOUTPUT)

237 CNTMEDIA I Slideline contact output media (BOUTPUT)

238 CNTFMT I Slideline contact output format (BOUTPUT)

239 DIVERG I Aerostatic divergence control parameter set


(DIVERG)

240 OUTRCV I P-element output control parameters


(OUTRCV)

241 STATSUBP I Static subcase identification number for


pre-load (STATSUB(PRELOAD))

242 MODESELS I Mode selection set identification number for


the structure (MODESELECT)

243 MODESELF I Mode selection set identification number for


the fluid (MODESELECT)

244 SOLNUM I Solution sequence number

245 ANLOPT I SOL 601 analysis option: 106, 129, 153 or 159

246 ADAPT I P-element adaptivity control parameter set


(ADAPT)

247 DESOBJ I Design objective set (DESOBJ)

248 DESSUB I Design constraint set for current subcase


(DESSUB)

249 SUBSPAN I DRSPAN defined set ID of DRESP1 responses


specific to this subcase.

250 DESGLB I Design constraint set for all subcases


(DESGLB)

251 ANALYSIS CHAR4 Type of analysis (ANALYSIS)

252 GPQSTRS I CQUAD4 grid point corner stress option


(STRESS)

DMAP Programmer's Guide 3-35


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

253 GPQFORC I CQUAD4 grid point corner force option


(STRESS)

254 GPQSTRN I CQUAD4 grid point corner strain option


(STRESS)

255 SUPORT1 I Supported degree-of-freedom set (SUPORT1)

256 STATSUBB I Static subcase ID for buckling


(STATSUB(BUCKLE))

257 BCID I Boundary condition ID (BC)

258 AUXMODEL I Auxiliary model ID (AUXMODEL)

259 ADACT I P-element adaptivity active subcase flag


(ADACT)

260 DATSET I P-element output set (DATAREC)

261 DATMEDIA I P-element output media (DATAREC)

262 DATFMT I P-element output format (DATAREC)

263 VUGSET I View-grid and element output set (VUGRID)

264 VUGMEDIA I View-grid and element output media (VUGRID)

265 VUGFMT I View-grid and element output format


(VUGRID)

266 MPCFSET I Forces of multipoint constraint output set


(MPCFORCE)

267 MPCMEDIA I Forces of multipoint constraint output media


(MPCFORCE)

268 MPCFFMT I Forces of multipoint constraint output format


(MPCFORCE)

269 REUESET I Real unsymmetric eigenvalue extraction set


(UMETHOD)

270 DAMPTBLF I Structural damping table set for the fluid


(SDAMP(FLUID)

271 ITERMETH I Iterative solver control parameters


(SMETHOD)

272 NLSSET I Nonlinear stress output set (NLSTRESS)

3-36 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

273 NLSMEDIA I Nonlinear stress output media (NLSTRESS)

274 NLSFMT I Nonlinear stress output format (NLSTRESS)

275 MODTRKID I Mode tracking control parameter set


(MODTRAK)

276 DSAFORM I Design sensitivity output format: 1=yes,2=no


(DSAPRT)

277 DSAEXPO I Design sensitivity output export: 1=no,2=yes


(DSAPRT)

278 DSABEGIN I Design sensitivity output start iteration


(DSAPRT)

279 DSAINTVL I Design sensitivity output interval (DSAPRT)

280 DSAFINAL I Design sensitivity output final iteration


(DSAPRT)

281 DSASETID I Design sensitivity output set (DSAPRT)

282 SORTFLG I Overall SORT1/SORT2 flag: 1 means SORT1


and 2 means SORT2.

283 RANDBIT I Random analysis request bit pattern


(DISP,VELO, and so on)

284 AECONFIG(2) CHAR4 Aerodynamic configuration name

286 AESYMXY I Symmetry flag for aerodynamic xy plane

287 AESYMXZ I Symmetry flag for aerodynamic xz plane

288 UNDEF None

289 UNDEF None

290 UNDEF None

291 GPEPTSET I Grid point strain output set (GPSTRAIN)

292 GPEMEDIA I Grid point strain output media (GPSTRAIN)

293 GPEFMT I Grid point strain output format (GPSTRAIN)

294 TEMPMAT I Thermal material set TEMP(MAT).

295 AECSSSET I Aerodynamic Control Surface Schedule


(CSSCHD)

DMAP Programmer's Guide 3-37


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

296 EKEPTSET I Element kinetic energy output set (EKE)

297 EKEMEDIA I Element kinetic energy media (EKE)

298 EKEFMT I Element kinetic energy format (EKE)

299 EKETHRSH RS Element kinetic energy threshold (EKE)

300 EDEPTSET I Element damping energy output set (EDE)

301 EDEMEDIA I Element damping energy media (EDE)

302 EDEFMT I Element damping energy format (EDE)

303 EDETHRSH RS Element damping energy threshold (EDE)

304 PANCON I Panel contributions set (PANCON)

305 PCMEDIA I Panel contributions media (PANCON)

306 PCFMT I Panel contributions format (PANCON)

307 PCFORM I Panel contributions form (PANCON)

308 PCTOPP I Panel contributions TOPP (PANCON)

309 PCTOPG I Panel contributions TOPG (PANCON)

310 PCSOL I Panel contributions SOLUTION (PANCON)

311 PCPAN I Panel contributions PANEL (PANCON)

312 PCGRID I Panel contributions GRID (PANCON)

313 MODSLF I Mode selection set (fluid)

314 EFFMASET I Modal effective mass output set (MEFFMASS)

315 EFFMAGID I Modal effective mass GID (MEFFMASS)

316 EFFMATHR RS Modal effective mass fraction threshold


(MEFFMASS)

317 A2GG(2) CHAR4 Name of direct input (g-set) acoustic coupling


matrix (A2GG)

319 RCRSET I RCROSS output set

320 RCRFMT I RCROSS format

321 AEUXREF I AEUXREF

3-38 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

322 GCHK I Ground Check Flag (GROUNDCHECK)

323 GCHKOUT I Ground Check Output (GROUNDCHECK)

324 GCHKSET I Ground Check Set (GROUNDCHECK)

325 GCHKGID I Ground Check Gid (GROUNDCHECK)

326 GCHKTHR RS Ground Check Thresh (GROUNDCHECK)

327 GCHKRTHR RS Ground Check RThresh (GROUNDCHECK)

328 GCHKDREC I Ground Check Data recovery


(GROUNDCHECK)

329 ASPCMED I Output Media Request (AUTOSPC)

330 ASPCEPS RS EPS value for fixup (AUTOSPC)

331 ASPCPRT I EPS value for printing (AUTOSPC)

332 ASPCPCH I Punch Set Id (AUTOSPC)

333 EXSEGEOM I External superelement geometry flag


(EXTSEOUT)

334 NA2GG I Internal set id for A2GG

335 NK2PP I Internal set id for K2PP

336 NM2PP I Internal set id for M2PP

337 NB2PP I Internal set id for B2PP

338 NK2GG I Internal set id for K2GG

339 NM2GG I Internal set id for M2GG

340 NB2GG I Internal set id for B2GG

341 NP2G I Internal set id for P2G

342 GEODSET I Geometry Check DISP Set identification


number (GEOMCHECK)

343 GEODMXMN I Geometry Check DISP Max/Min


(GEOMCHECK)

344 GEODOCID I Geometry Check DISP Max/Min Output Cor.


Sys. (GEOMCHECK)

DMAP Programmer's Guide 3-39


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

345 GEODNUMB I Geometry Check No. of DISP Max/Min Output


(GEOMCHECK)

346 GEOLSET I Geometry Check OLOAD Set identification


number (GEOMCHECK)

347 GEOLMXMN I Geometry Check OLOAD Max/Min


(GEOMCHECK)

348 GEOLOCID I Geometry Check OLOAD Max/Min Output


Cor. Sys. (GEOMCHECK)

349 GEOLNUMB I Geometry Check No. of OLOAD Max/Min


Output (GEOMCHECK)

350 GEOSSET I Geometry Check SPCF Set identification


number (GEOMCHECK)

351 GEOSMXMN I Geometry Check SPCF Max/Min


(GEOMCHECK)

352 GEOSOCID I Geometry Check SPCF Max/Min Output Cor.


Sys. (GEOMCHECK)

353 GEOSNUMB I Geometry Check No. of SPCF Max/Min


Output (GEOMCHECK)

354 GEOMSET I Geometry Check MPCF Set identification


number (GEOMCHECK)

355 GEOMMXMN I Geometry Check MPCF Max/Min


(GEOMCHECK)

356 GEOMOCID I Geometry Check MPCF Max/Min Output Cor.


Sys. (GEOMCHECK)

357 GEOMNUMB I Geometry Check No. of MPCF Max/Min


Output (GEOMCHECK)

358 GEOASET I Geometry Check ACCE Set identification


number (GEOMCHECK)

359 GEOAMXMN I Geometry Check ACCE Max/Min


(GEOMCHECK)

360 GEOAOCID I Geometry Check ACCE Max/Min Output Cor.


Sys. (GEOMCHECK)

361 GEOANUMB I Geometry Check No. of ACCE Max/Min


Output (GEOMCHECK)

3-40 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

362 GEOVSET I Geometry Check VELO Set identification


number (GEOMCHECK)

363 GEOVMXMN I Geometry Check VELO Max/Min


(GEOMCHECK)

364 GEOVOCID I Geometry Check VELO Max/Min Output Cor.


Sys. (GEOMCHECK)

365 GEOVNUMB I Geometry Check No. of VELO Max/Min


Output (GEOMCHECK)

366 NTFL I Internal set id for TFL

367 BCONTACT I BCONTACT Set identification number

368 GPKESET I Grid point kinetic energy output set (GPKE)

369 GPKEMEDI I Grid point kinetic energy media (GPKE)

370 GPKEFMT I Grid point kinetic energy format (GPKE)

371 ELMSUM I Element Summary Output (ELSUM)

372 WCHK I Weight Check Flag (WEIGHTCHECK)

373 WCHKOUT I Weight Check Output (WEIGHTCHECK)

374 WCHKSET I Weight Check Set identification number


(WEIGHTCHECK)

375 WCHKGID I Weight Check GID (WEIGHTCHECK)

376 WCHKCGI I Weight Check CGI (WEIGHTCHECK)

377 WCHKWM I Weight Check Weight/Mass units


(WEIGHTCHECK)

378 EXSEOUT I External Superelement Output Flag

379 EXSEMED I External Superelement Output Media

380 EXSEUNIT I External Superelement Output Unit

381 EXSEASMB I External Superelement Output ASMBULK


Flag

382 EXSEEXTB I External Superelement Output EXTBULK Flag

383 K42GG(2) CHAR4 Name of direct input (g-set) structural damping


matrix K42GG

DMAP Programmer's Guide 3-41


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

385 NK42GG I Internal set id for K42GG

386 EXSESTIF I External Superelement Output STIFFNESS


Flag

387 EXSEMASS I External Superelement Output MASS Flag

388 EXSEDAMP I External Superelement Output DAMPING Flag

389 EXSEK4DA I External Superelement Output K4DAMP Flag

390 EXSELOAD I External Superelement Output LOADS Flag

391 EXSESEID I External Superelement Output SE ID

392 EXSEDMFX(2) CHAR4 External Superelement DMIGSFIX String

394 NSMID I Non-Structural Mass Set ID

395 NSELD I Internal SID for SELOAD

396 FSELD I Internal SID for SELOAD scale factor

397 OP4UNIT I MBDEXPORT OP4 logical unit number

398 RPOSTS1 I Random RPOSTS1 parameter

399 CHECK I ADAMSMNF/MBDEXPORT CHECK flag

400 ADMOUT I ADAMSMNF ADMOUT flag//MBDEXPORT


RECVROP2 flag

401 FLEXBODY I ADAMSMNF/MBDEXPORT FLEXBODY flag

402 FLEXONLY I ADAMSMNF/MBDEXPORT FLEXONLY flag

403 MINVAR I ADAMSMNF/MBDEXPORT MINVAR


parameter

404 PSETID I ADAMSMNF/MBDEXPORT PSETID


parameter

405 OUTGSTRS I ADAMSMNF/MBDEXPORT OUTGSTRS flag

406 OUTGSTRN I ADAMSMNF/MBDEXPORT OUTGSTRN flag

407 RMSBIT I Random analysis RMS required bit pattern

408 RANCPLX I Random RANCPLX parameter

409 RMSSF RS Random RMSSF parameter

3-42 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

410 UNDEF(3) None

413 BCSET I Contact Set ID

414 BCRESU I Contact results output

415 BCMEDIA I Contact results media code

416 BCFMT I Contact results format code

417 BCTYPE I Traction=1, Force=2, Both=3

418 GKRESU I Gasket results output

419 GKMEDIA I Gasket results media code

420 GKFMT I Gasket results format code

421 UNDEF(5) None

426 RSMETHOM I RSMETHOD parameter

427 ESETHRSH I ESE THRESHOLD

428 MDESET I Modal energy output set (MODALE)

429 MDEMEDI I Modal energy media (MODALE)

430 MCSOL I Modal contributions SOLUTION (MODCOM)

431 MCPAN I Modal contributions PANELMC (MODCOM)

432 MDEFMT I Modal energy output format (MODALE)

433 UNDEF None

434 MDECMPT I Modal energy computation set (MODALE)

435 MDESORT I Modal energy sort flag (MODALE)

436 MDETYPE I Modal energy type flag (MODALE)

437 MDECALC I Modal energy calculation flag (MODALE)

438 RMETSET I RMETHOD set id

439 RIGID I Rigid element type

440 BOLTPRE I Bolt preload set

441 BGSET I Glue set id

442 MCTOPF I Modal contributions TOPF (MODCON)

DMAP Programmer's Guide 3-43


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

443 IPRPU I RANDOM print/punch option

444 ADMCHK I ADMRECVR ADMCHK flag

445 MODSEL I Mode selection set (structural)

446 ADMREC I ADMRECVR activation flag

447 ADMFORM I ADMRECVR ADMFORM parameter

448 MSRMODE I ADMRECVR MSRMODE parameter

449 RGBODY I ADMRECVR RGBODY flag

450 MSGLVL I ADMRECVR MSGLVL parameter

451 EBDSET I Element birth/death set

452 SHELLTHK I Shell thickness results output flag

453 STMEDIA I Shell thickness results media code

454 STFMT I Shell thickness results format code

455 ICTYPE I Transient IC type

456 RMXMN I RMAXMIN flag to indicate presence of card

457 ROPT I RMAXMIN print, plot, punch flag

458 RINP I RMAXMIN stress, force, displacement flag

459 RABS I RMAXMIN maximum, absolute, minimum flag

460 RAPP I RMAXMIN approach flag

461 RMXTRN I Alternate request of RMXTRN parameter

462 NPAVG I Number of maximum peaks to average

463 RSTAR RS Start time step for desired interval

464 RSTOP RS End time step for desired interval

465 MODCON I Modal contribution set

466 MCMEDIA I Modal contribution media

467 MCFMT I Modal contribution format

3-44 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

468 MCFORM I Modal contribution FORM

469 MCTOPS I Modal contributions TOPS (MODCON)

470 PSDD I SOL200: int. set no. for grids w/ PSDDISP


design response

471 PSDV I SOL200: int. set no. for grids w/ PSDVELO


design response

472 PSDA I SOL200: int. set no. for grids w/ PSDACCL


design response

473 ISTAR I Start subcase id (RMAXMIN)

474 ISTOP I End subcase id (RMAXMIN)

475 FK2PP I Internal set id for K2PP scale factor

476 FM2PP I Internal set id for M2PP scale factor

477 FB2PP I Internal set id for B2PP scale factor

478 FK2GG I Internal set id for K2GG scale factor

479 FM2GG I Internal set id for M2GG scale factor

480 FB2GG I Internal set id for B2GG scale factor

481 FK42GG I Internal set id for K42GG scale factor

482 FP2G I Internal set id for P2G scale factor

483 FA2GG I Internal set id for A2GG scale factor

484 GPRSORT I Global ply results sorted with global ply ID


numbers

485 EFLOAD1 I External field load orientation

486 EFLOAD2 I External field coordinate system

487 BGRESU I Glue results output

488 BGMEDIA I Glue results media code

489 UNDEF None

490 BGTYPE I Glue results type

491 RSVCOMP I Residual vector component flag

DMAP Programmer's Guide 3-45


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

492 RSVOPTC I Residual vector component options

493 RSVSYST I Residual vector system flag

494 RSVOPTS I Residual vector system options

495 PLSLOC I Ply strain or stress locations

496 ELSMOP I ELSUM output option

497 ERPSET I ERP set

498 ERPSORT I SORT1/SORT2

499 ERPMEDIA I ERP output media

500 ERPFMT I ERP output format

501 ERPSOL I ERP SOLUTION set

502 ERPELEM I ERP element output

503 ERPCSV I Unused. Reserved for ERP

504 ERPCOEFF RS ERP coefficient

505 UNDEF(9) None

514 RMETCMR I Rotor dynamics CMR method

515 EFFMAT1 RS Modal effective mass minimum total value in X


displacement

516 EFFMAT2 RS Modal effective mass minimum total value in Y


displacement

517 EFFMAT3 RS Modal effective mass minimum total value in Z


displacement

518 EFFMAMIT I Modal effective mass maximum number of


additional iterations

519 SEQDEP CHAR4 Sequence dependency on or off (SEQDEP)

520 NLCSET I Set Identification nonlinear control (NLCNTL)

521 GSTRESET I Gauss point stress output set (GSTRESS)

522 GSTMEDIA I Gauss point stress output media (GSTRESS)

523 GSTREFMT I Gauss point stress output format (GSTRESS)

3-46 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

524 GSTRNSET I Gauss point total strain output set (GSTRAIN)

525 GSNMEDIA I Gauss point total strain output media


(GSTRAIN)

526 GSTRNFMT I Gauss point total strain output format


(GSTRAIN)

527 ELSTNSET I Nodal elastic strain on elements, output set


(ELSTRN)

528 ELNMEDIA I Nodal elastic strain on elements, output media


(ELSTRN)

529 ELSTNFMT I Nodal elastic strain on elements, output format


(ELSTRN)

530 GELSSET I Gauss point elastic strains on elements, output


set (GELSTRN)

531 GESMEDIA I Gauss point elastic strains on elements, output


media (GELSTRN)

532 GELSFMT I Gauss point elastic strains on elements, output


format (GELSTRN)

533 CRSTSET I Nodal creep strains on elements, output set


(CRSTRN)

534 CRSMEDIA I Nodal creep strains on elements, output media


(CRSTRN)

535 CRSTFMT I Nodal creep strains on elements, output


format (CRSTRN)

536 GCRSSET I Gauss point creep strains on elements, output


set (GCRSTRN)

537 GCRMEDIA I Gauss point creep strains on elements, output


media (GCRSTRN)

538 GCRSFMT I Gauss point creep strains on elements, output


format (GCRSTRN)

539 PLSTSET I Nodal plastic strains on elements, output set


(PLSTRN)

540 PLSMEDIA I Nodal plastic strains on elements, output


media (PLSTRN)

DMAP Programmer's Guide 3-47


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

541 PLSTFMT I Nodal plastic strains on elements, output


format (PLSTRN)

542 GPLSSET I Gauss point plastic strains on elements, output


set (GPLSTRN)

543 GPLMEDIA I Gauss point plastic strains on elements, output


media (GPLSTRN)

544 GPLSFMT I Gauss point plastic strains on elements, output


format (GPLSTRN)

545 THSTSET I Nodal thermal strains on elements, output set


(THSTRN)

546 THSMEDIA I Nodal thermal strains on elements, output


media (THSTRN)

547 THSTFMT I Nodal thermal strains on elements, output


format (THSTRN)

548 GTHSSET I Gauss point thermal strains on elements,


output set (GTHSTRN)

549 GTHMEDIA I Gauss point thermal strains on elements,


output media (GTHSTRN)

550 GTHSFMT I Gauss point thermal strains on elements,


output format (GTHSTRN)

551 OTEMPSET I Temperatures used at solution points, output


set (OTEMP)

552 OTEMEDIA I Temperatures used at solution points, output


media (OTEMP)

553 OTEMPFMT I Temperatures used at solution points, output


format (OTEMP)

554 NONCUP I ADAMSMNF/MBDEXPORT

555 DTEMPSET I Time dependent temperature load (DTEMP)

556 JINSET I J integral output set (JINTEG)

557 JINMEDIA I J integral output media (JINTEG)

558 ADAPTRESU I Adaptive Meshing set, output error estimator

559 ADAPTMEDIA I Error Estimator media code

3-48 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

560 ADAPTPYE I Error Estimator based on ENERGY FORM or


STRESS FORM and STEP

561 INISTN I Initial strain (INISTN)

562 INISTS I Initial stress (INISTS)

563 OPRESSET I Pressures used at solution points, output set


(OPRESS)

564 OPRESDIA I Pressures used at solution points, output


media (OPRESS)

565 OPRESFMT I Pressures used at solution points, output


format (OPRESS)

566 UNDEF(34) None

600 LSEM(C) I Number of symmetry subcase coefficients


from item SYMFLG

601 COEF RS Symmetry subcase coefficients (SUBSEQ or


SYMSEQ)

Word 601 repeats LSEM times

602 (See SETID I Set identification number


Note 13)

603 SETLEN(C) I Length of this set

604 SETMEM I Set member identification number

Word 604 repeats SETLEN times

Words 602 through 604 repeat NSETS times

605 PARA CHAR4 Hard-coded to "PARA"

606 PARLEN(C) I Length of this parameter value specification

607 CHTYPE(C) I Character type flag: 3 means character, 2


otherwise

608 PARAM(2) CHAR4 Hard-coded to "PARA" and "M "

610 PNAME(2) CHAR4 Name of parameter

PARLEN =8 Length

612 INTEGER I Integer value

DMAP Programmer's Guide 3-49


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

PARLEN =9 Real-double parameter value

612 TYPE I Real type - hard-coded to -4

613 REAL RD Real-double value

PARLEN =10 Complex-single parameter value

612 RTYPE I Real part type - hard-coded to -2

613 REAL RS Real part value

614 ITYPE I Imaginary part type - hard-coded to -2

615 IMAG RS Imaginary part value

PARLEN =12 Complex-double parameter value

612 RTYPE I Real part type - hard-coded to -4

613 REAL RD Real part value

614 ITYPE I Imaginary part type - hard-coded to -4

615 IMAG RD Imaginary part value

End PARLEN

Words 605 through max repeat until NANQ occurs

Words 605 through 615 repeat until End of Record

Record – TRAILER

Word Name Type Description

1 WORD1 I Number of records

2 WORD2 I Number of records

3 WORD3 I Maximum record length

4 WORD4 I Plot flag

5 UNDEF(2) None

Notes:
1. Possible values for output media (___MEDIA) are:
• 1 = print

3-50 DMAP Programmer's Guide


Data Block Descriptions A-E

• 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)

• 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.

DMAP Programmer's Guide 3-51


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

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

13. The actual starting position of any SET information is CASECC(166) + LSEM + 1. The default for
CASECC(166) is 600. Therefore, for example, if LSEM=0, SETs will start at CASECC(601). All
other following information simply continues beyond where the previous one ends.

3.6 CDDATA
Campbell diagram data table.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 METH I Mode tracking method.


= 1 : method 1 is used
= 2 : method 2 is used

Record 1 – List of rotor speeds (METH=1 only)

Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=10001

4 ROTS(NVAL) RS List of rotor speeds in user-defined units

3-52 DMAP Programmer's Guide


Data Block Descriptions A-E

Record 2 – List of eigenfrequencies in the analysis system (METH=1 only)

Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=20000+SOLN, where SOLN=solution number

4 EIGF(NVAL) RS Eigenfrequencies for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 3 – List of Lehr damping values (METH=1 only)

Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=30000+SOLN, where SOLN=solution


number

4 DAMP(NVAL) RS Damping values for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 4– List of real eigenvalues (METH=1 only)

Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=40000+SOLN, where SOLN=solution


number

4 EIGV(NVAL) RS Eigenvalues for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 5 – List of whirl direction codes (2.0=backwards, 3.0 forward, 4.0=linear)


(METH=1 only)

Word Name Type Description

1 NVAL I Number of values

DMAP Programmer's Guide 3-53


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

2 UNDEF None

3 KEYW I Keyword=50000+SOLN, where SOLN=solution


number

4 WHRD(NVAL) RS Whirl direction codes for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 6 – List of converted frequencies in analysis system (METH=1 only)


Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=60000+SOLN, where SOLN=solution


number

4 FREQ(NVAL) RS Converted frequencies for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 7– List of whirl direction codes for converted solution (2.0=backwords,


3.0 forward, 4.0=linear) (METH=1 only)
Word Name Type Description

1 NVAL I Number of values

2 UNDEF None

3 KEYW I Keyword=70000+SOLN, where SOLN=solution


number

4 CWHRD(NVAL) RS Whirl direction codes for solution SOLN

Words 3 and 4 repeat for all solutions.

Record 1 – Data (METH=2 only)


Word Name Type Description

1 NVAL I Number of values

2 NCRV I Number of sections/solution (i.e., number of


curves)

3-54 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 KEYW I Keyword=10000+(SOLN*10)+DATTYP,
where:
SOLN=solution number
DATTYP=1 for list of rotor speeds in
user-defined units
DATTYP=2 for list of eigenfrequencies in the
analysis system
DATTYP=3 for list of Lehr damping values
DATTYP=4 for list of real part of eigenvalues
DATTYP=5 for list of imaginary part of
eigenvalues
DATTYP=6 for list of whirl direction codes
(2.0=backwards, 3.0=forward, 4.0=linear)
DATTYP=7 for list of converted frequencies
in analysis system
DATTYP=8 for list of whirl directions codes
for converted solution (2.0=backwards,
3.0=forward, 4.0=linear)

4 VALS(NVAL) RS List of values

Words 1–4 repeat for NCRV curves. For DATTYP≠1, NVAL and NCRV=0

Record 1 repeats NSOL times.

Record 8 – TRAILER

Word Name Type Description

1 NOMG I Number of speed values

2 NSOL I Number of solutions

3 WORD3 I Number of records (METH=1); number of


sections per solution (i.e. NCRV, METH=2)

4 UNDEF None

5 METH I Mode tracking method.


= 1 : method 1 is used
= 2 : method 2 is used

6 UNDEF None

3.7 CLAMA
Complex eigenvalue summary table

DMAP Programmer's Guide 3-55


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – OFPID

Word Name Type Description

1 RECID(2) I Constants 90 and 1006

3 UNDEF(7) None

10 SIX I Constant 6

11 RSPEED RS Rotor speed in RUNIT units

12 RUNIT CHAR4 RSPEED units; RPM, CPS, HZ, or RAD;


blank or integer 0 in a non-rotor dynamic
analyses

13 UNDEF(38) None

51 TITLE(32) CHAR4 Title character string (TITLE)

83 SUBTITLE(32) CHAR4 Subtitle character string (SUBTITLE)

115 LABEL(32) CHAR4 LABEL character string (LABEL)

Record 2 – LAMA
Repeats for each eigenvalue.

Word Name Type Description

1 MODE I Mode number

2 ORDER I Extraction order

3 REIGEN RS Eigenvalue – real part

4 IEIGEN RS Eigenvalue – imaginary part

5 FREQ RS Frequency: ABS(IEIGEN)/(2*Pi)

6 DAMP RS Damping Coefficient: (-2*REIGEN)/ABS(IEIGEN)

3-56 DMAP Programmer's Guide


Data Block Descriptions A-E

Record 3 – TRAILER

Word Name Type Description

1 WORD1 I 1006

2 UNDEF(3 ) None

5 SIX I Constant 6

6 UNDEF None

3.8 CONTAB
Design constraint table
Contains a record for each design constraint. Records are sorted by the internal constraint
identification number.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – Repeat – Repeated for each design constraint

Word Name Type Description

1 IDCID I Internal design constraint identification number

2 DCID I DCONSTR Bulk Data entry identification number

3 IRID I Internal response identification number

4 RTYPE I Response type

5 TYPE I Type of response (1 or 2)

6 LUFLAG I Bound Type (1=lower,2=upper)

7 BOUND RS Bound value

8 REGION I Internal region identification number

9 SCID I Subcase identification number

DMAP Programmer's Guide 3-57


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record 2 – TRAILER

Word Name Type Description

1 WORD1 I Number of records; that is, design constraints

2 UNDEF(5 ) None

3.9 CONTACT
Table of Bulk Data entry related to surface contact

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – BCMATL (7310,73,590)

Word Name Type Description

1 ID I Identification number

2-n IPi I Material ID

n+1 -1 I Delimiter

Record – BCONP (0124,01,435)

Word Name Type Description

1 ID I

2 SLAVE I

3 MASTER I

4 NPENID I

5 SFAC RS

6 FRICID I

7 PTYPE I

8 CID I

9 CTYPE I

3-58 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

10 METHOD I

11 ORDER I

12 TTYPE I

Record – BCPROP (7210,72,589)

Word Name Type Description

1 ID I Identification number

2-n IPi I Physical Property ID

n+1 -1 I Delimiter

Record – BEDGE (8920,89,614)

Word Name Type Description

1 CSID I Edge region identification number

2 EID I Element identification number

3 G1 I Grid point 1

4 G2 I Grid point 2

5 -1 I Delimiter

Record – BFLUID(9001,90,964)

Word Name Type Description

1 BID I Fluid boundary identification number

2 TYPE I FLUID=1 ,STRUC=2, FREE=3. RIGID=4

3 ID I ID for BSURFS, BCPROPS or BEDGE

5 -1 I Delimiter

Record – BCPROPS (8301,83,605)

Word Name Type Description

1 ID I Identification number

DMAP Programmer's Guide 3-59


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

2-n IPi I Physical Property ID

n+1 -1 I Delimiter

Record – BCRPARA (7710,77,594)

Word Name Type Description

1 CRID I Region ID

2 SURF I TOP=1, BOT=2

3 OFFSET RS ≥ 0.0 offset distance

4 TYPE I FLEX=1, RIGID=2

5 MGP I Master grid point

Record – BCTADD (7510,75,592)

Word Name Type Description

1 CSID I Combined contact set ID

2-n Si I Contact set ID

n+1 -1 I Delimiter

Record – BCTPARA (7610,76,593)


Note: entry 2-5 repeats for each parameter

Word Name Type Description

1 CSID I Contact set ID

2-3 Param(i) CHAR4 Parameter name

4 TYPE I Parameter data type

5 Value(i) I or RS Parameter value

6 -1 I Delimiter

Record – BCTPARM (8110,81,598)


Note: entry 2-5 repeats for each parameter

3-60 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

1 CSID I Contact set ID

2-3 Param(i) CHAR4 Parameter name

4 TYPE I Parameter data type

5 Value(i) I or RS Parameter value (See Note 1 below)

6 -1 I Delimiter

Note:
1. The parameter NCHG can now be entered as a real or an integer value, but is always written to
the OP2 file as a real value. For example, the integer value NCHG=1 is written to the OP2 file
as NCHG=1.0.

Record – BCTSET (7410,74,591)


Note: entry 2-6 repeats for each additional region pair.

Word Name Type Description

1 CSID I Contact set ID

2 SIDi I Source region ID

3 TIDi I Target region ID

4 FRICi RS Coefficient of Friction

5 MIND RS Minimum search distance

6 MAXD RS Maximum search distance

7 -1 I Delimiter

Record – BGADD (8810,88,603)

Word Name Type Description

1 GSID I Combined glue set ID

2-n Si I Glue set ID

n+1 -1 I Delimiter

Record – BGPARM (8710,87,449)


Note: entry 2-5 repeats for each parameter

DMAP Programmer's Guide 3-61


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 CSID I Contact set ID

2-3 Param(i) CHAR4 Parameter name

4 TYPE I Parameter data type

5 Value(i) I or RS Parameter value

6 -1 I Delimiter

Record – BGSET (1224,12,446)

Word Name Type Description

1 CSID I Contact set ID

2 SIDi I Source region ID

3 TIDi I Target region ID

4 SDIST RS Search distance

5 PEN RS Penalty value

6 EXT RS Extension factor for target region

7 -1 I Delimiter

Record – BLSEG (0224,02,436)

Word Name Type Description

1 ID I Identification number.

2-n Gi I Grid point identification numbers.

n+1 -1 I Delimiter

Record – BSURF (724,7,441)

Word Name Type Description

1 ID I Identification number

2-n EIDi I Element ID

n+1 -1 I Delimiter

3-62 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – BSURFS (7110,71,588)


Note: entry 2-5 repeats for each element/grids

Word Name Type Description

1 ID I Identification number

2 EIDi I Element ID

3-5 G1 - G3 I Grid point ID

6 -1 I Delimiter

Record – EBDADD (8610,86,448)


Word Name Type Description

1 ID I Resulting Birth/Death set ID number

2-n BDID I Birth/Death set ID's defined via EBDSET entries

n+1 -1 I Delimiter

Record – EBDSET (8510,85,447)


Word Name Type Description

1 ID I Birth/Death set ID number

2 TBIRTH RS Element birth time

3 TDEATH RS Element death time

4 EID I Element ID's

6 -1 I Delimiter

Record – NXSTRAT (7810,78,595)


Note: entry 2-5 repeats for each parameter

Word Name Type Description

1 ID I ID (not used)

2-3 Param (i) CHAR4 Parameter name

4 TYPE I Parameter data type

5 Value(i) I or RS Parameter value

DMAP Programmer's Guide 3-63


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

6 -1 I Delimiter

Record – TMCPARA (7910,79,989)


Note: entry 2-5 repeats for each parameter

Word Name Type Description

1 CSID I Contact set ID

2-3 Param(i) CHAR4 Parameter name

4 TYPE I Parameter data type

5 Value(i) I or RS Parameter value

6 -1 I Delimiter

TRAILER

Word Name Type Description

1-6 UNDEF(6) None

3.10 CSTM
Coordinate system transformation matrices table
The transformation is from global to basic.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – IDENT

Word Name Type Description

1 CID I Coordinate system identification number

2 TYPE I Type of system

3 IINDEX I Index into INTDATA record

3-64 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

4 RINDEX I Index into REALDATA record

Record 2 – REALDATA

Word Name Type Description

1 REALDATA RX Real data

Record 3 – INTDATA

Word Name Type Description

1 INTDATA I Integer data

Record 4 – TRAILER

Word Name Type Description

1 WORD1 I Number of grid points + number of scalar points

2 WORD2 I Number of coordinate systems

3 WORD3 I Type of systems present – see Note 1.

4 WORD4 I Precision of REALDATA record - 1 or 2

5 WORD5 I Length of REALDATA record

6 WORD6 I 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

DMAP Programmer's Guide 3-65


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

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.

3.11 CSTM68
Coordinate system transformation matrices table (Pre-MSC Nastran Version 69).
The transformation is from global to basic.
Note

See the Note 2 for a listing of the differences between CSTM68 and CSTM.

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record 1 – HEADER
Word Name Type Description

1 CID I Coordinate system identification number

2 CIDTYPE I Coordinate system type

Word Name Type Description

CIDTYPE =0 Unknown

3 TR1 RS Translation in direction 1

4 TR2 RS Translation in direction 2

5 TR3 RS Translation in direction 3

6 R11 RS Direction cosine in 1-1

7 R12 RS Direction cosine in 1-2

8 R13 RS Direction cosine in 1-3

9 R21 RS Direction cosine in 2-1

10 R22 RS Direction cosine in 2-2

11 R23 RS Direction cosine in 2-3

3-66 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

12 R31 RS Direction cosine in 3-1

13 R32 RS Direction cosine in 3-2

14 R33 RS Direction cosine in 3-3

Word Name Type Description

CIDTYPE =1 Rectanglar

3 TR1 RS Translation in direction 1

4 TR2 RS Translation in direction 2

5 TR3 RS Translation in direction 3

6 R11 RS Direction cosine in 1-1

7 R12 RS Direction cosine in 1-2

8 R13 RS Direction cosine in 1-3

9 R21 RS Direction cosine in 2-1

10 R22 RS Direction cosine in 2-2

11 R23 RS Direction cosine in 2-3

12 R31 RS Direction cosine in 3-1

13 R32 RS Direction cosine in 3-2

14 R33 RS Direction cosine in 3-3

Word Name Type Description

CIDTYPE =2 Cylindrical

3 TR1 RS Translation in direction 1

4 TR2 RS Translation in direction 2

5 TR3 RS Translation in direction 3

6 R11 RS Direction cosine in 1-1

7 R12 RS Direction cosine in 1-2

8 R13 RS Direction cosine in 1-3

DMAP Programmer's Guide 3-67


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 R21 RS Direction cosine in 2-1

10 R22 RS Direction cosine in 2-2

11 R23 RS Direction cosine in 2-3

12 R31 RS Direction cosine in 3-1

13 R32 RS Direction cosine in 3-2

14 R33 RS Direction cosine in 3-3

Word Name Type Description

CIDTYPE =3 Spherical

3 TR1 RS Translation in direction 1

4 TR2 RS Translation in direction 2

5 TR3 RS Translation in direction 3

6 R11 RS Direction cosine in 1-1

7 R12 RS Direction cosine in 1-2

8 R13 RS Direction cosine in 1-3

9 R21 RS Direction cosine in 2-1

10 R22 RS Direction cosine in 2-2

11 R23 RS Direction cosine in 2-3

12 R31 RS Direction cosine in 3-1

13 R32 RS Direction cosine in 3-2

14 R33 RS Direction cosine in 3-3

Word Name Type Description

CIDTYPE =4 Convective defined on a GMCURV+GMSURF pair

3 UNDEF(2 ) None Reserved

5 CURVID I GMCURV identification number

6 SURFID I GMSURF identification number

3-68 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 CURCID I Coordinate System where GMCURV is defined

8 SURCID I Coordinate System where GMSURF is defined

9 UNDEF(6 ) None Reserved

Word Name Type Description

CIDTYPE =5 Convective defined on a GMSURF

3 UNDEF(2 ) None Reserved

5 SURFID I GMSURF identification number

6 SURCID I Coordinate System where GMSURF is defined

7 UNDEF(8 ) None Reserved

Word Name Type Description

CIDTYPE =6 Convective defined on a FEEDGE+FEFACE pair

3 RECINDX I Record index number

RECINDX =1 Index 1

4 RECTOTAL I Total number of records ( = 8 )

5 EDGEID I FEEDGE identification number

6 FACEID I FEFACE identification number

7 GP(4) I Grid identification numbers of 4 FEEDGE grids

11 GFACE(4) I Grid identification numbers of 1st 4 of 12


FEFACE grids

RECINDX =2 Index 2

4 RECTOTAL I Total number of records ( = 8 )

5 GFACE(8) I Grid identification number of next 8 of 12


FEFACE grids

13 UNDEF(2 ) None Reserved

RECINDX =3 Index 3

4 RECTOTAL I Total number of records ( = 8 )

DMAP Programmer's Guide 3-69


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

5 XYZ1(3) RS Basic Coordinates of FEEDGE grid 1

8 XYZ2(3) RS Basic Coordinates of FEEDGE grid 2

11 XYZ(3) RS Basic Coordinates of FEEDGE grid 3

14 UNDEF None Reserved

RECINDX =4 Index 4

4 RECTOTAL I Total number of records ( = 8 )

5 XYZ1(3) RS Basic Coordinates of FEEDGE grid 4

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 1

11 XYZ(3) RS Basic Coordinates of FEFACE grid 2

14 UNDEF None Reserved

RECINDX =5 Index 5

4 RECTOTAL I Total number of records ( = 8 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 3

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 4

11 XYZ(3) RS Basic Coordinates of FEFACE grid 5

14 UNDEF None Reserved

RECINDX =6 Index 6

4 RECTOTAL I Total number of records ( = 8 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 6

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 7

11 XYZ(3) RS Basic Coordinates of FEFACE grid 8

14 UNDEF None Reserved

RECINDX =7 Index 7

4 RECTOTAL I Total number of records ( = 8 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 9

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 10

11 XYZ(3) RS Basic Coordinates of FEFACE grid 11

3-70 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

14 UNDEF None Reserved

RECINDX =8 Index 8

4 RECTOTAL I Total number of records ( = 8 )

5 XYZ(3) RS Basic Coordinates of FEFACE grid 12

8 UNDEF(7 ) None Reserved

End RECINDX

Word Name Type Description

CIDTYPE =7 Convective defined on a FEFACE

3 RECINDX I Record index number

RECINDX =1 Index 1

4 RECTOTAL I Total number of records ( = 6 )

5 FACEID I FEFACE identification number

6 GFACE(9) I Grid IDs of first 9 of 12 FEFACE grids

RECINDX =2 Index 2

4 RECTOTAL I Total number of records ( = 6 )

5 GFACE(3) I Grid IDs of next 3 of 12 FEFACE grids

8 XYZ1(3) RS Basic Coordinates of FEFACE grid 1

11 XYZ2(3) RS Basic Coordinates of FEFACE grid 2

14 UNDEF None Reserved

RECINDX =3 Index 3

4 RECTOTAL I Total number of records ( = 6 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 3

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 4

11 XYZ(3) RS Basic Coordinates of FEFACE grid 5

14 UNDEF None Reserved

RECINDX =4 Index 4

DMAP Programmer's Guide 3-71


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 RECTOTAL I Total number of records ( = 6 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 6

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 7

11 XYZ(3) RS Basic Coordinates of FEFACE grid 8

14 UNDEF None Reserved

RECINDX =5 Index 5

4 RECTOTAL I Total number of records ( = 6 )

5 XYZ1(3) RS Basic Coordinates of FEFACE grid 9

8 XYZ2(3) RS Basic Coordinates of FEFACE grid 10

11 XYZ(3) RS Basic Coordinates of FEFACE grid 11

14 UNDEF None Reserved

RECINDX =6 Index 6

4 RECTOTAL I Total no of records. Should be 6

5 XYZ(3) RS Basic Coordinates of FEFACE grid 12

8 UNDEF(7 ) None Reserved

End RECINDX

End CIDTYPE

Record 2 – TRAILER

Word Name Type Description

1 WORD1 I Number of grid and scalar points

2 WORD2 I Number of coordinate systems

3 UNDEF(4 ) None

Notes:
1. Coordinate system type:
• 1 = rectangular

• 2 = cylindrical

3-72 DMAP Programmer's Guide


Data Block Descriptions A-E

• 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

2. CSTM68 contains the same data as CSTM. However, CSTM68 and CSTM are organized
differently. For details, compare individual records between CSTM68 and CSTM.

3.12 DBCOPT
Design optimization history table for postprocessing

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record 1 – EXACT
Word Name Type Description

1 REAL RS Objective function values, exact from analysis

Word 1 repeats until End of Record

Record 2 – APPRX
Word Name Type Description

1 REAL RS Objective function values, optimal w.r.t


approximation

Word 1 repeats until End of Record

Record 3 – MAXIM
Word Name Type Description

1 REAL RS Objective function values, maximum values of


constraints

Word 1 repeats until End of Record

DMAP Programmer's Guide 3-73


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record 4 – DVIDS
Word Name Type Description

1 INTGR I Design variable identification number

Word 1 repeats until End of Record

Record 5 – INITV
Word Name Type Description

1 REAL RS Design variable values, 1st cycle ?

Word 1 repeats until End of Record

Record 6 – COL17
Word Name Type Description

1 REAL RS Design variable value, Nth cycle ?

Word 1 repeats until End of Record

Record 7 – DVLABEL
Word Name Type Description

1 IDVID I Internal design variable identification number

2 DVID I External design variable identification number

3 LABEL1 CHAR4 First part of design variable

4 LABEL2 CHAR4 Second part of design variable

Record 8 – TRAILER
Word Name Type Description

1 NFEA I Number of finite element analyses

2 NAOP I Number of optimization cycles w.r.t. approximate


model

3 NDV I Number of design variables

4 NCC I Convergence criterion

5 UNDEF(2 ) None

3-74 DMAP Programmer's Guide


Data Block Descriptions A-E

Notes:
Convergence criterion
1 = Hard convergence
2 = Soft convergence
3 = Compromise
4 = Maximum design cycles reached

3.13 DESCYC
Defines the design cycle to which the results data blocks that follow belong, up to the next design
cycle data block (i.e. the next DESCYC).

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record – DATA

Word Name Type Description

1 DESCYCL I Design cycle number

2 CONDIS(2) CHAR4 Design cycle type; “D” for discretized design cycle;
Blank for continuous design cycle

Record – TRAILER

Word Name Type Description

1 “1” I Always “1”

2 DESCYCL I Design cycle number

3 CYCTYP I Design cycle type; “0” for a continuous design


cycle; “1” for a discretized design cycle

4 UNDEF(3) None

3.14 DESTAB
Design variable attributes

DMAP Programmer's Guide 3-75


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record – Repeat

Word Name Type Description

1 IDVID I Internal design variable identification number

2 DVID I External design variable identification number

3 LABEL1 CHAR4 First part of design Variable

4 LABEL2 CHAR4 Second part of design Variable

5 VMIN RS Lower bound

6 VMAX RS Upper bound

7 DELX RS Move limit for a design cycle

Record – TRAILER

Word Name Type Description

1 NDV I Number of design variables

2 NDVI I Number of independent design variables

3 NDVD I Number of dependent design variables

4 UNDEF(3 ) None

Notes:

Independent design variables are given first in ascending IDVID followed by dependent design
variables in ascending IDVID order.

3.15 DISTL
Direct table input table for RS

Contains the load set labels on DTI bulk data entries.

3-76 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – REPEAT

Word Name Type Description

1 ID I Load set identification number

2 STRING(2) CHAR4 String label

Words 2 and 3 repeat until End of Record

Record – TRAILER

Word Name Type Description

1 WORD1 I = 32767

2 WORD2 I = 32767

3 WORD3 I = 32767

4 WORD4 I = 32767

5 WORD5 I = 32767

6 WORD6 I = 32767

3.16 DIT
Direct input tables
Contains images of TABLEij, TABDMP1 and GUST Bulk Data entries.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

DMAP Programmer's Guide 3-77


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – GUST(1005,10,174)
Word Name Type Description

1 SID I Gust load identification number

2 DLOAD I TLOADi or RLOADi identification number

3 WG RS Scale factor

4 X0 RS Streamwise location of the gust reference point

5 V RS Velocity of vehicle

Record – TABDMP1(15,21,162)
Word Name Type Description

1 ID I Table identification number

2 UNDEF(7 ) None

9 F RS Natural frequency

10 G RS Damping

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLE3D(4000,40,460)
Word Name Type Description

1 ID I Table identification number

2 X0 RS X offset of the independent variable

3 Y0 RS Y offset of the independent variable

4 Z0 RS Z offset of the independent variable

5 F0 RS Offset of the dependent variable

6 UNDEF(3 ) None

9 XI RS X independent variable

10 YI RS Y independent variable

11 ZI RS Z independent variable

12 FI RS Dependent variable

Words 9 through 12 repeat until End of Record

3-78 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – TABLED1(1105,11,133)

Word Name Type Description

1 ID I Table identification number

2 CODEX I Type of interpolation for the x-axis

3 CODEY I Type of interpolation for the y-axis

4 FLAG I Extrapolation on/off flag

5 UNDEF(4) None

9 X RS X tabular value

10 Y RS Y tabular value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLED2(1205,12,134)

Word Name Type Description

1 ID I Table identification number

2 X1 RS X-axis shift

3 FLAG I Extrapolation on/off flag

4 UNDEF(5) None

9 X RS X value

10 Y RS Y value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLED3(1305,13,140)

Word Name Type Description

1 ID I Table identification number

2 X1 RS X-axis shift

3 X2 RS X-axis normalization

4 FLAG I Extrapolation on/off flag

5 UNDEF(4) None

DMAP Programmer's Guide 3-79


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 X RS X value

10 Y RS Y value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLED4(1405,14,141)
Word Name Type Description

1 ID I Table identification number

2 X1 RS X-axis shift

3 X2 RS X-axis normalization

4 X3 RS X value when x is less than X3

5 X4 RS X value when x is greater than X4

6 UNDEF(3 ) None

9 A RS

Word 9 repeats until End of Record

Record – TABLEM1(105,1,93)
Word Name Type Description

1 ID I Table identification number

2 CODEX I Type of interpolation for the x-axis

3 CODEY I Type of interpolation for the y-axis

4 UNDEF(5) None

9 X RS X tabular value

10 Y RS Y tabular value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLEM2(205,2,94)
Word Name Type Description

1 ID I Table identification number

3-80 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 X1 RS X-axis shift

3 UNDEF(6) None

9 X RS X value

10 Y RS Y value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLEM3(305,3,95)

Word Name Type Description

1 ID I Table identification number

2 X1 RS X-axis shift

3 X2 RS X-axis normalization

4 UNDEF(5) None

9 X RS X value

10 Y RS Y value

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABLEM4(405,4,96)
Same as Record – TABLED4(1405,14,141).

Record – TABLES1(3105,31,97)

Word Name Type Description

1 ID I Table identification number

2 UNDEF(7 ) None

9 X RS X value

10 Y RS Y value

Words 9 through 10 repeat until (-1,-1) occurs

DMAP Programmer's Guide 3-81


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – TABLEST(1905,19,178)

Word Name Type Description

1 ID I Table identification number

2 FLAG I Extrapolation on/off flag

3 UNDEF(6) None

9 TI RS Temperature

10 TIDI I TABLES1 Bulk Data entry identification number

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABRND1(55,25,191)

Word Name Type Description

1 ID I Table identification number

2 CODEX I Type of interpolation for the x-axis

3 CODEY I Type of interpolation for the y-axis

4 UNDEF(5 ) None

9 F RS Frequency

10 G RS Power spectral density

Words 9 through 10 repeat until (-1,-1) occurs

Record – TABRNDG(56,26,303)
Power spectral density for gust loads in aeroelastic analysis

Word Name Type Description

1 ID I Table identification number

2 TYPE I Power spectral density type

3 LU RS Scale of turbulence divided by velocity

4 WG RS Root-mean-square gust velocity

5 UNDEF(4 ) None

Words 1 through 8 repeat until (-1,-1) occurs

3-82 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – TRAILER
Word Name Type Description

1 WORD1 I Record presence trailer word 1

2 WORD2 I Record presence trailer word 2

3 UNDEF(4 ) None

Notes:
Type of interpolation (CODEX and CODEY):
0 = linear
1 = log

3.17 DSCMCOL
Design sensitivity parameters

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record – Type 1 Responses


Word Name Type Description

1 IRID I Internal response identification number

2 RID I External response identification number

3 RTYPE I Response Type

Word Name Type Description

RTYPE =1 Weight

4 UNDEF(5 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =2 Volume

DMAP Programmer's Guide 3-83


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 UNDEF(5 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =3 Buckling

4 MODE I Mode number

5 UNDEF None

6 SUBCASE I Subcase identification number

7 UNDEF(2 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =4 Normal modes

4 MODE I Mode number

5 UNDEF None

6 SUBCASE I Subcase identification number

7 UNDEF(2 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =5 Static displacement

4 GRID I Grid identification number

5 COMP I Displacement component number

6 SUBCASE I Subcase identification number

7 UNDEF(2 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =6 Static stress

3-84 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

4 EID I Element identification number

5 COMP I Stress component number

6 SUBCASE I Subcase identification number

7 UNDEF(2 ) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =7 Static strain

4 EID I Element identification number

5 COMP I Strain component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 VIEWID I View element identification number

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =8 Static force

4 EID I Element identification number

5 COMP I Force component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 VIEWID I View element identification number

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =9 Composite failure

4 EID I Element identification number

5 COMP I Failure component number

DMAP Programmer's Guide 3-85


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

6 SUBCASE I Subcase identification number

7 UNDEF None

8 PLY I Ply number

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =10 Composite stress

4 EID I Element identification number

5 COMP I Stress component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 PLY I Ply number

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =11 Composite strain

4 EID I Element identification number

5 COMP I Strain component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 PLY I Ply number

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =13 Static SPC force

4 GRID I Grid identification number

5 COMP I SPC force component number

6 SUBCASE I Subcase identification number

3-86 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 UNDEF(2) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =14 Element static strain energy

4 EID I Element identification number

5 COMP I Strain energy component number

6 SUBCASE I Subcase identification number

7 UNDEF(2) None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =19 Equivalent radiated power

4 PANEL I Element identification number

5 FLAG I A subcase ID based code. +: magnitude; –:


density

6 SUBCASE I Subcase identification number

7 FREQUENCY RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =20 Frequency response displacement

4 GRID I Grid identification number

5 COMP I Displacement component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

DMAP Programmer's Guide 3-87


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

RTYPE =21 Frequency response velocity

4 GRID I Grid identification number

5 COMP I Velocity component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =22 Frequency response acceleration

4 GRID I Grid identification number

5 COMP I Acceleration component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =23 Frequency response SPC Force

4 GRID I Grid identification number

5 COMP I SPC Force component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =24 Frequency response stress

3-88 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

4 EID I Element identification number

5 COMP I Stress component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =25 Frequency response force

4 EID I Element identification number

5 COMP I Force component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =26 RMS displacement

4 GRID I Grid identification number

5 COMP I RMS displacement component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =27 RMS velocity

4 GRID I Grid identification number

DMAP Programmer's Guide 3-89


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

5 COMP I RMS velocity component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =28 RMS acceleration

4 GRID I Grid identification number

5 COMP I RMS acceleration component number

6 SUBCASE I Subcase identification number

7 UNDEF None

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =29 PSD displacement

4 GRID I Grid identification number

5 COMP I PSD displacement component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =30 PSD velocity

4 GRID I Grid identification number

5 COMP I PSD velocity component number

3-90 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =31 PSD acceleration

4 GRID I Grid identification number

5 COMP I PSD acceleration component number

6 SUBCASE I Subcase identification number

7 FREQ RS Frequency

8 RANDPS I RANDPS ID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =60 Transient response displacement

4 GRID I Grid identification number

5 COMP I Displacement component number

6 SUBCASE I Subcase identification number

7 TIME RS Time

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =61 Transient response velocity

4 GRID I Grid identification number

5 COMP I Velocity component number

6 SUBCASE I Subcase identification number

DMAP Programmer's Guide 3-91


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 TIME RS Time

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =62 Transient response acceleration

4 GRID I Grid identification number

5 COMP I Acceleration component number

6 SUBCASE I Subcase identification number

7 TIME RS Time

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =63 Transient response SPC Force

4 GRID I Grid identification number

5 COMP I SPC force component number

6 SUBCASE I Subcase identification number

7 TIME RS Time

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =64 Transient response stress

4 EID I Element identification number

5 COMP I Stress component number

6 SUBCASE I Subcase identification number

7 TIME RS Time

3-92 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =65 Transient response force

4 EID I Element identification number

5 COMP I Force component number

6 SUBCASE I Subcase identification number

7 TIME RS Time

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =81 Aeroelastic divergence

4 SUBCASE I Subcase identification number

5 UNDEF None

6 ROOT I Root

7 MACH RS Mach number

8 UNDEF None

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =82 Aeroelastic trim

4 SUBCASE I Subcase identification number

5 UNDEF None

6 XID I XID

7 UNDEF(2) None

9 SEID I Superelement identification number

DMAP Programmer's Guide 3-93


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

RTYPE =83 Aeroelastic stability derivative

4 SUBCASE I Subcase identification number

5 RU I R/U

6 COMP I Component number

7 UNDEF None

8 XID I XID

9 SEID I Superelement identification number

Word Name Type Description

RTYPE =84 Aeroelastic flutter damping

4 SUBCASE I Subcase identification number

5 MODE I Mode number

6 DENSITY RS Density

7 MACH RS Mach number

8 VEL RS Velocity

9 SEID I Superelement identification number

End RTYPE

Record – Type 2 Responses

Word Name Type Description

1 IRID I Internal response identification number

2 RID I External response identification number

3 SUBCASE I Subcase identification number

4 DFLAG I Dynamic response flag (See Note)

5 FREQTIME RS Frequency or time step

6 SEID I Superelement identification number

3-94 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – TRAILER
Word Name Type Description

1 NR1 I Number of Type 1 responses

2 NR2 I Number of Type 2 responses

3 UNDEF(4 ) None

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.18 DVPTAB
Designed property table

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record – REPEAT
By ascending internal property identification number order. Type one properties are first and type
two follow.

Word Name Type Description

1 IPID I Internal property identification number

2 DVTYP I DVPRELi Bulk Data entry identification number

DMAP Programmer's Guide 3-95


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 EPPNT I Property type (1 or 2 or 3) (Type 1 includes


both DVPREL1 defined properties and internally
generated PBAR/PBEAM properties that are
linearly dependent on designed PBARL/PBEAML
dimensions. Type 2 is for DVPREL2 defined
properties. Type 3 is for internally generated
PBAR/PBEAM properties that are nonlinearly
dependent on designed PBARL/PBEAML
dimensions.)

4 PTYP1 CHAR4 First word of the property type

5 PTYP2 CHAR4 Second word of the property type

6 PID I Property identification number

7 FID I Property field position

8 PMIN RS Minimum property value

9 PMAX RS Maximum property value

10 PNAME1 CHAR4 First word of property name

11 PNAME2 CHAR4 Second word of property name

12 FREQ RS Frequency, if relevant, for which the property is


defined

Record – TRAILER

Word Name Type Description

1 NPROP I Number of designed properties (number of


“Repeat” records in table)

2 NENT1 I Number of Type 1 entries (see definition of


EPPNT in “Repeat” record above)

3 NENT2 I Number of Type 2 entries (see definition of


EPPNT in “Repeat” record above)

4 NENT3 I Number of Type 3 entries (see definition of


EPPNT in “Repeat” record above)

5 UNDEF(2) None

3-96 DMAP Programmer's Guide


Data Block Descriptions A-E

Notes:
There are as many records as there are designed properties. (NPROP = NENT1 + NENT2 + NENT3)

3.19 DYNAMIC
Table of Bulk Data entry images related to dynamics

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record – ACSRCE(5307,53,379)
Power vs. frequency for a simple acoustic source

Word Name Type Description

1 SID I Load set identification number

2 DAREA I DAREA Bulk Data entry identification number

3 DELAYI I DELAY Bulk Data entry identification number

4 DPHASEI I DPHASE Bulk Data entry identification number

5 TCI I TABLEDi Bulk Data entry identification number for


C(f)

6 RHO RS Density of the fluid

7 B RS Bulk modulus of the fluid

8 DELAYR RS If DELAYI = 0, constant value for delay

9 DPHASER RS If DPHASEI = 0, constant value for phase

10 TCR RS If TCI = 0, constant value for C(f)

Record – CBEAR(9010,90,569)
CBEAR definition.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

DMAP Programmer's Guide 3-97


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 GA I Grid point at end A

4 GB I Grid point at end B

5 UNDEF(6) None

Record – DAREA(27,17,182)
Scale factor for dynamic loads

Word Name Type Description

1 SID I Load set identification number

2 P I Grid, scalar, or extra point identification number

3 C I Component number

4 A RS Scale factor

Record – DELAY(37,18,183)
Time delay parameter for dynamic loads

Word Name Type Description

1 SID I Set identification number

2 P I Grid, scalar, or extra point identification number

3 C I Component number

4 T RS Time delay

Record – DLOAD(57,5,123)
Linear combination of dynamic loads

Word Name Type Description

1 SID I Load set identification number

2 S RS Overall scale factor

3 SI RS Scale factor i

4 LI I Load set identification number i

Words 3 through 4 repeat until (-1,-1) occurs

3-98 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – DPHASE(77,19,184)
Phase lead parameter in dynamic loading

Word Name Type Description

1 SID I Set identification number

2 P I Grid, scalar, or extra point identification number

3 C I Component number

4 TH RS Phase lead

Record – EIGB(107,1,86)

Word Name Type Description

1 SID I Set identification number

2 METHOD(2) CHAR4 Method of eigenvalue extraction

4 L1 RS Lower bound of eigenvalue range of interest

5 L2 RS Upper bound of eigenvalue range of interest

6 NEP I Estimate of number of roots in positive range

7 NDP I Desired number of positive roots

8 NDN I Desired number of negative roots

9 UNDEF None

10 NORM(2) CHAR4 Method for normalizing eigenvectors

12 G I Grid or scalar point identification number

13 C I Component number

14 UNDEF(5 ) None

Record – EIGC(207,2,87)

Word Name Type Description

1 SID I Set identification number

2 METHOD(2) CHAR4 Method of eigenvalue extraction

4 NORM(2) CHAR4 Method for normalizing eigenvectors

DMAP Programmer's Guide 3-99


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

6 G I Grid or scalar point identification number

7 C I Component number

8 E RS Convergence criterion

9 ND1 I Number of desired eigenvectors

10 CONTFLG I Continuation flag

CONTFLG =0 With continuation

11 AAJ RS Location of A on real axis

12 WAJ RS Location of A on imaginary axis

13 ABJ RS Location of B on real axis

14 WBJ RS Location of B on imaginary axis

15 LJ RS Width of search region

16 NEJ I Number of estimated roots

17 NDJ I Number of desired eigenvectors

Words 11 through 17 repeat until (-1,-1,-1,-1,-1,-1,-1) occ

CONTFLG =–1 Without continuation

End CONTFLG

Record – EIGP(257,4,158)

Word Name Type Description

1 SID I Set identification number

2 ALPHA RS Location of pole on real axis

3 OMEGA RS Location of pole on imaginary axis

4 M I Multiplicity of complex root at pole

Record – EIGR(307,3,85)

Word Name Type Description

1 SID I Set identification number

3-100 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 METHOD(2) CHAR4 Method of eigenvalue extraction

4 F1 RS Lower bound of frequency range of interest

5 F2 RS Upper bound of frequency range of interest

6 NE I Number of estimated roots

7 ND I Number of desired roots

8 UNDEF(2 ) None

10 NORM(2) CHAR4 Method for normalizing eigenvectors

12 G I Grid or scalar point identification number

13 C I Component number

14 UNDEF(5 ) None

Record – EIGRL(308,8,348)

Word Name Type Description

1 SID I Set identification number

2 V1 RS Lower bound of frequency range of interest

3 V2 RS Upper bound of frequency range of interest

4 ND I Number of desired eigenvectors

5 MSGLVL I Diagnostic level

6 MAXSET I Number of vectors in block or set

7 SHFSCL RS Estimate of first flexible mode

8 FLAG1 I V1 specification flag – set to 1 if V1 is specified

9 FLAG2 I V2 specification flag – set to 1 if V2 is specified

10 NORM(2) CHAR4 Method for normalizing eigenvectors

12 ALPH RS Constant for quadratic frequency segment


distribution

13 NUMS I Number of frequency segments

14 FI RS Frequency at the upper boundary of the i-th


segment

DMAP Programmer's Guide 3-101


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

Word 14 repeats NUMS times

Record – EPOINT(707,7,124)

Word Name Type Description

1 ID I Extra point identification number

Record – FREQ(1307,13,126)

Word Name Type Description

1 SID I Set identification number

2 F RS Frequency

Word 2 repeats until End of Record

Record – FREQ1(1007,10,125)

Word Name Type Description

1 SID I Set identification number

2 F1 RS First frequency

3 DF RS Frequency increment

4 NDF I Number of frequency increments

Record – FREQ2(1107,11,166)

Word Name Type Description

1 SID I Set identification number

2 F1 RS First frequency

3 F2 RS Last frequency

4 NF I Number of logarithmic intervals

3-102 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – FREQ3(1407,14,39)
Word Name Type Description

1 SID I Set identification number

2 F1 RS Lower bound of modal frequency range

3 F2 RS Upper bound of modal frequency range

4 TYPE CHAR4 Type of interpolation: LINE or LOG

5 NEF I Number of frequencies

6 BIAS RS Clustering bias parameter

Record – FREQ4(1507,15,40)
Word Name Type Description

1 SID I Set identification number

2 F1 RS Lower bound of modal frequency range

3 F2 RS Upper bound of modal frequency range

4 FSPD RS Frequency spread

5 NFM I Number of evenly spaced frequencies per spread

Record – FREQ5(1607,16,41)
Word Name Type Description

1 SID I Load set identification number

2 F1 RS Lower bound of modal frequency range

3 F2 RS Upper bound of modal frequency range

4 FRI RS Fractions of natural frequencies

Word 4 repeats until End of Record

Record – NLRGAP(3707,37,556)
Defines a nonlinear transient radial gap.

Word Name Type Description

1 SID I Load set identification number

DMAP Programmer's Guide 3-103


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

2 GA I Inner grid identification number

3 GB I Outer grid identification number

4 PLANE I Radial gap orientation plane (xy = 100; yz = 200, zx


= 300)

5 TABK I Table identification number for gap stiffness vs. time

6 TABG I Table identification number for radial gap clearance

7 TABU I Table identification number for radial coefficient

8 RADIUS RS Shaft radius

Record – NOLIN1(3107,31,127)

Word Name Type Description

1 SID I Load set identification number

2 GI I Grid, scalar, or extra point identification number of I

3 CI I Component number for GI.

4 S RS Scale factor

5 GJ I Grid, scalar, or extra point identification number


of J

6 CJ I Component number for GJ

7 T I Identification number of a TABLEDi Bulk Data


entry.

8 UNDEF None

Record – NOLIN2(3207,32,128)

Word Name Type Description

1 SID I Load set identification number

2 GI I Grid, scalar, or extra point identification number of I

3 CI I Component number for GI.

4 S RS Scale factor

3-104 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

5 GJ I Grid, scalar, or extra point identification number of J

6 CJ I Component number for GJ

7 GK I Grid, scalar, or extra point identification number of K

8 CK I Component number for GK

Record – NOLIN3(3307,33,129)

Word Name Type Description

1 SID I Load set identification number

2 GI I Grid, scalar, or extra point identification number of I

3 CI I Component number for GI.

4 S RS Scale factor

5 GJ I Grid, scalar, or extra point identification number of J

6 CJ I Component number for GJ

7 A RS Exponent of the forcing function

8 UNDEF None

Record – NOLIN4(3407,34,130)

Word Name Type Description

1 SID I Load set identification number

2 GI I Grid, scalar, or extra point identification number of I

3 CI I Component number for GI.

4 S RS Scale factor

5 GJ I Grid, scalar, or extra point identification number of J

6 CJ I Component number for GJ

7 A RS Exponent of the forcing function

8 UNDEF None

DMAP Programmer's Guide 3-105


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – PBEAR(9110,91,570)
PBEAR definition.

Word Name Type Description

1 PID I Property identification number

2 TYPE1(2) CHAR4 Data type name (K, B, KD, BD, KF, or BF)

4 ITXX1 I Integer table ID for TXX values

5 ITXY1 I Integer table ID for TXY values

6 ITYX1 I Integer table ID for TYX values

7 ITYY1 I Integer table ID for TYY values

8 ITXZ1 I Integer table ID for TXZ values

9 ITYZ1 I Integer table ID for TYZ values

10 ITZX1 I Integer table ID for TZX values

11 ITZY1 I Integer table ID for TZY values

12 ITZZ1 I Integer table ID for TZZ values

13 ITRXRX1 I Integer table ID for TRXRX values

14 ITRXRY1 I Integer table ID for TRXRY values

15 ITRYRX1 I Integer table ID for TRYRX values

16 ITRYRY1 I Integer table ID for TRYRY values

17 NOMVAL1 RS Nominal value 1 for displacement or force

18 NOMVAL2 RS Nominal value 2 for displacement or force

19 NOMVAL3 RS Nominal value 3 for displacement or force

20 C1R RS Coefficient multiplying radial relative


displacement/force in the composite radial
relative displacement/force equation

21 C1Z RS Coefficient multiplying axial relative


displacement/force in the composite radial
relative displacement/force equation

22 C2R RS Coefficient multiplying radial relative


displacement/force in the composite axial
relative displacement/force equation

3-106 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

23 C2Z RS Coefficient multiplying axial relative


displacement/force in the composite axial
relative displacement/force equation

24 C3R RS Coefficient multiplying radial relative


displacement/force in the composite rotational
relative displacement/force equation

25 C3Z RS Coefficient multiplying axial relative


displacement/force in the composite rotational
relative displacement/force equation

26 D1O RS Constant preload term in the composite radial relative


displacement/force equation

27 D2O RS Constant preload term in the composite axial relative


displacement/force equation

28 D3O RS Constant preload term in the composite rotational


relative displacement/force equation

29 RTXX1 RS Real constant TXX value

30 RTXY1 RS Real constant TXY value

31 RTYX1 RS Real constant TYX value

32 RTYY1 RS Real constant TYY value

33 RTXZ1 RS Real constant TXZ value

34 RTYZ1 RS Real constant TYZ value

35 RTZX1 RS Real constant TZX value

36 RTZY1 RS Real constant TZY value

37 RTZZ1 RS Real constant TZZ value

38 RTRXRX1 RS Real constant TRXRX value

39 RTRXRY1 RS Real constant TRXRY value

40 RTRYRX1 RS Real constant TRYRX value

41 RTRYRY1 RS Real constant TRYRY value

42 TYPE2(2) CHAR4 Data type name (K, B, KD, BD, KF, or BF)

44 ITXX2 I Integer table ID for TXX values

DMAP Programmer's Guide 3-107


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

45 ITXY2 I Integer table ID for TXY values

46 ITYX2 I Integer table ID for TYX values

47 ITYY2 I Integer table ID for TYY values

48 ITXZ2 I Integer table ID for TXZ values

49 ITYZ2 I Integer table ID for TYZ values

50 ITZX2 I Integer table ID for TZX values

51 ITZY2 I Integer table ID for TZY values

52 ITZZ2 I Integer table ID for TZZ values

53 ITRXRX2 I Integer table ID for TRXRX values

54 ITRXRY2 I Integer table ID for TRXRY values

55 ITRYRX2 I Integer table ID for TRYRX values

56 ITRYRY2 I Integer table ID for TRYRY values

57 RTXX2 RS Real constant TXX value

58 RTXY2 RS Real constant TXY value

59 RTYX2 RS Real constant TYX value

60 RTYY2 RS Real constant TYY value

61 RTXZ2 RS Real constant TXZ value

62 RTYZ2 RS Real constant TYZ value

63 RTZX2 RS Real constant TZX value

64 RTZY2 RS Real constant TZY value

65 RTZZ2 RS Real constant TZZ value

66 RTRXRX2 RS Real constant TRXRX value

67 RTRXRY2 RS Real constant TRXRY value

68 RTRYRX2 RS Real constant TRYRX value

69 RTRYRY2 RS Real constant TRYRY value

3-108 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – RANDPS(2107,21,195)
Word Name Type Description

1 SID I Set identification number

2 J I Subcase identification number of the excited set

3 K I Subcase identification number of the applied load set

4 X RS X component

5 Y RS Y component

6 TIDI I Identification number of a TABRNDi entry that defines


G(f)

7 TIDR RS If TIDI = 0, constant value for G(f)

Record – RANDT1(2207,22,196)
Word Name Type Description

1 SID I Set identification number

2 N I Number of time lag intervals

3 TO RS Starting time lag

4 TMAX RS Maximum time lag

Record – RLOAD1(5107,51,131)
Word Name Type Description

1 SID I Load set identification number

2 DAREA I DAREA Bulk Data entry identification number

3 DELAYI I DELAY Bulk Data entry identification number

4 DPHASEI I DPHASE Bulk Data entry identification number

5 TCI I TABLEDi Bulk Data entry identification number for


C(f)

6 TDI I TABLEDi Bulk Data entry identification number for


D(f)

7 TYPE I Nature of the dynamic excitation

8 DELAYR RS If DELAYI = 0, constant value for delay

DMAP Programmer's Guide 3-109


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 DPHASER RS If DPHASEI = 0, constant value for phase

10 TCR RS If TCI = 0, constant value for C(f)

11 TDR RS If TDI = 0, constant value for D(f)

Record – RLOAD2(5207,52,132)

Word Name Type Description

1 SID I Load set identification number

2 DAREA I DAREA Bulk Data entry identification number

3 DELAYI I DELAY Bulk Data entry identification number

4 DPHASEI I DPHASE Bulk Data entry identification number

5 TBI I TABLEDi Bulk Data entry identification number for


B(f)

6 TPI I TABLEDi Bulk Data entry identification number for


Phi(f)

7 TYPE I Nature of the dynamic excitation

8 DELAYR RS If DELAYI = 0, constant value for delay

9 DPHASER RS If DPHASEI = 0, constant value for phase

10 TBR RS If TBI = 0, constant value for B(f)

11 TPR RS If TPI = 0, constant value for PHI(f)

Record – ROTORB (8910,89,606)

Word Name Type Description

1 SID I Set identification number of rotor

2 ID I Grid or scalar point ID’s which define bearing


locations on a rotor

Record – ROTORD(8210,82,599)

Word Name Type Description

1 SID I Set identification number

3-110 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 NUMROT I Number of rotors (i=1, NUMROT below)

3 RSTART RS Starting rotor speed (in RPM)

4 RSTEP RS Rotor speed step size (in RPM)

5 NUMSTEP I Number of steps for rotor speed

6,7 REFSYS CHAR8 Rotational reference system (YHROT,YH or


YHFIX,YH

8 CMOUT RS Complex mode output request

9,10 RUNIT CHAR8 Revolution input/output units for rotor (YHRPM or


YHRAD or YHCPS or YHHZ)

11,12 FUNIT CHAR8 Frequency output units (YHRPM or YHRAD or


YHCPS or YHHZ)

13,14 ZSTEIN CHAR8 Flag to incorpoate Steiner inertia terms (YHYES,YH


or YHNO,YH)

15 ORBEPS RS Threshold value for detection of whirl direction

16 ROTPRT I Optional printout flag

17 SYNC I Synchronous analysis selection flag

18 ETYPE I Excitation type

19 EORDER RS Excitation order

20–21 (not used)

22+8*(i-1) RIDi I Rotor ID for ith rotor

23+8*(i-1) RSETi I Set number for rotor speed for multiple rotors

24+8*(i-1) RSPEEDi RS Relative rotor speed for multiple rotors

25+8*(i-1) RCOORDI I Coordinate system ID number specifying rotation


axis as Z

26+8*(i-1) W3i RS Damping coefficient like PARAM,W3

27+8*(i-1) W4i RS Damping coefficient like PARAM,W4

28+8*(i-1) RFORCEi I RFORCE bulk data ID number specifying rotational


force to be applied

29+8*(i-1) BRGSETi I CBEAR bearing set GROUP ID number

DMAP Programmer's Guide 3-111


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – ROTORG(8410,84,600)

Word Name Type Description

1 SID I Set identification number of rotor

2 ID I Grid or scalar point ID's which define a rotor

Record – ROTSE(9210,92,622)
ROTSE definition.

Word Name Type Description

1 RSETID I Rotor ID (RSETi on ROTORD bulk entry)

2 TYPE CHAR4 “RL” for real modal reduction; “CX” for complex
modal reduction

3 EVID I EIGRL bulk entry ID if TYPE=”RL”; EIGC bulk entry


ID if TYPE=”CX”

4 GRID I Additional rotor grid ID to be added to a-set

Word 4 repeats until –1 occurs.

Record – SEQEP(5707,57,135)

Word Name Type Description

1 ID I Extra point identification number

2 SEQID I Sequenced identification number

Record – TF(6207,62,136)

Word Name Type Description

1 SID I Set identification number

2 GD I Grid, scalar, or extra point identification number

3 CD I Component number for point GD

4 B0 RS Transfer function coefficient

5 B1 RS Transfer function coefficient

6 B2 RS Transfer function coefficient

3-112 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 GI I Grid, scalar, or extra point identification number

8 CI I Component number for point GI

9 A0I RS Transfer function coefficient

10 A1I RS Transfer function coefficient

11 A2I RS Transfer function coefficient

Words 7 through 11 repeat until (-1,-1,–1,-1,-1) occurs

Record – TIC(6607,66,137)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid, scalar, or extra point identification number

3 C I Component number for point GD

4 U0 RS Initial displacement

5 V0 RS Initial velocity

Record – TLOAD1(7107,71,138)

Word Name Type Description

1 SID I Load set identification number

2 DAREA I DAREA Bulk Data entry identification number

3 DELAYI I DELAY Bulk Data entry identification number

4 TYPE I Nature of the dynamic excitation

5 TID I Identification number of TABLEDi entry that gives


F(t)

6 DELAYR RS If DELAYI = 0, constant value for delay

Record – TLOAD2(7207,72,139)

Word Name Type Description

1 SID I Load set identification number

DMAP Programmer's Guide 3-113


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

2 DAREA I DAREA Bulk Data entry identification number

3 DELAYI I DELAY Bulk Data entry identification number

4 TYPE I Nature of the dynamic excitation

5 T1 RS Time constant 1

6 T2 RS Time constant 2

7 F RS Frequency

8 P RS Phase angle

9 C RS Exponential coefficient

10 B RS Growth coefficient

11 DELAYR RS If DELAYI = 0, constant value for delay

Record – TSTEP(8307,83,142)

Word Name Type Description

1 SID I Set identification number

2 N I Number of time steps of value DTi

3 DT RS Time increment

4 NO I Skip factor for output

Words 2 through 4 repeat until (-1,-1,-1) occurs

TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

3.20 EDOM
SOL 200 design optimization and sensitivity analysis bulk entries.

3-114 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – DCONADD(5106,51,471)
Design constraint set combinations.

Word Name Type Description

1 DCID I Design constraint set identification number

2 DCi I DCONSTR entry identification number

Word 2 repeats until -1 occurs

Record – DCONSTR(4106,41,362)
Design constraints.

Word Name Type Description

1 DCID I Design constraint set identification number

2 RID I DRESPi entry identification number

3 LALLOW RS Lower bound on the response quantity. Undefined


if LTID is nonzero

4 UALLOW RS Upper bound on the response quantity. Undefined


if UTID is nonzero

5 LOWFQ RS Low end of frequency range in Hz

6 HIGHFQ RS High end of frequency range in Hz

7 LTID I Identification number of TABLEDi entry giving lower


bound on the response quantity as a function of
frequency or 0 if not specified

8 UTID I Identification number of TABLEDi entry giving upper


bound on the response quantity as a function of
frequency or 0 if not specified

Record – DDVAL(7000,70,563)
Discrete design variable values.

DMAP Programmer's Guide 3-115


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 ID I Unique discrete value set identification number

2 DVALi RS Discrete values for the variable

Word 2 repeats until -1 occurs

Record – DESVAR(3106,31,352)
Design variables.

Word Name Type Description

1 ID I Unique design variable identification number

2 LABEL(2) CHAR4 User-supplied name for printing purposes

4 XINIT RS Initial value

5 XLB RS Lower bound

6 XUB RS Upper bound

7 DELXV RS Fractional change allowed for the design variable


during approximate optimization

8 DDVAL I ID of a DDVAL entry that provides a set of allowable


discrete values

Record – DLINK(3206,32,353)
Multiple design variable linking.

Word Name Type Description

1 ID I Unique identification number

2 DDVID I Dependent design variable identification number

3 C0 RS Constant term

4 CMULT RS Constant multiplier

5 IDVi I Independent design variable identification number

6 Ci RS Coefficient corresponding to IDV

Words 5 and 6 repeat until -1 occurs

3-116 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – DOPTPRM(4306,43,364)
Design optimization parameters.

Word Name Type Description

1 APRCOD I Approximation method

2 IPRINT I Print control during approximate optimization phase


with DOT

3 DESMAX I Maximum number of design cycles

4 METHOD I DOT optimization method

5 DELP RS Fractional change allowed in each property during


any optimization design cycle

6 DPMIN RS Minimum move limit imposed

7 PTOL RS Maximum tolerance on differences allowed between


the property values on property entries and the
property values calculated from the design variable
values on the DESVAR entry

8 CONV1 RS Relative objective function convergence criterion

9 CONV2 RS Absolute objective function convergence criterion

10 GMAX RS Maximum constraint violation allowed at the


converged optimum

11 DELX RS Fractional change allowed in each design variable


during any optimization cycle

12 DXMIN RS Minimum absolute limit on design variable move

13 DELB RS Relative finite difference move parameter

14 GSCAL RS Constraint normalization factor

15 CONVDV RS Relative convergence criterion on design variables

16 CONVPR RS Relative convergence criterion on properties

17 P1 I Design cycles in which output is printed

18 P2 I Items to be printed at the design cycles defined by


P1

19 CT RS Constraint tolerance

20 CTMIN RS Constraint violation threshold

DMAP Programmer's Guide 3-117


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

21 DABOBJ RS DOT absolute objective function convergence


criterion

22 DELOBJ RS DOT relative objective function convergence


criterion

23 DOBJ1 RS DOT 1–D search absolute objective limit

24 DOBJ2 RS DOT 1–D search relative objective limit

25 DX1 RS DOT 1–D search absolute DV limit

26 DX2 RS DOT 1–D search relative DV limit

27 ISCAL I Design variables are rescaled every ISCAL


iterations

28 ITMAX I Maximum DOT MFD iterations per cycle

29 ITRMOP I Maximum consecutive DOT MFD iterations at


convergence

30 IWRITE I File number for DOT optimizer printout

31 IGMAX I Active constraint counter

32 JTMAX I Maximum DOT SLP iterations per cycle

33 ITRMST I Maximum consecutive DOT SLP iterations at


convergence

34 JPRINT I SLP subproblem print within DOT

35 IPRNT1 I Print scaling factors for design variable vector within


DOT

36 IPRNT2 I DOT 1–D search or miscellaneous information print

37 JWRITE I File number on which iteration history is written


within DOT

38 STPSCL RS Scale factor for shape finite difference step sizes


applied to all shape design variables

39 FSDMAX I Number of FSD cycles to be performed

40 FSDALP RS Relaxation parameter applied in FSD

41 DISCOD I Discrete processing method code

3-118 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

42 DISBEG I Design cycle ID for discrete variable processing


initiation

43 PLVIOL I Flag for handling property limit violation

44 P2RSET I ID of a SET1 entry listing constrained responses


to be printed if retained

Record – DRESP1(3806,38,359)

First level design response quantities. (If applicable, see the Quick Reference Guide for detailed
information on response attributes.)

Word Name Type Description

1 ID I Unique entry identifier

2 LABEL(2) CHAR4 User-defined label

4 FLAG I Flag indicating response type

FLAG = 1 WEIGHT

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 2 VOLUME

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 3 LAMA

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

DMAP Programmer's Guide 3-119


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 4 EIGN

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 5 DISP

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 6 STRESS

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 7 STRAIN

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

3-120 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 8 FORCE

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 9 CFAILURE

5 PTYPE(2) CHAR4 Element flag (ELEM) or composite property entry


name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or composite


property IDs

Word 10 repeats until -1 occurs

FLAG = 10 CSTRESS

5 PTYPE(2) CHAR4 Element flag (ELEM) or composite property entry


name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

DMAP Programmer's Guide 3-121


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

10 ATTi I Element numbers (if Word 5 is ELEM) or composite


property IDs

Word 10 repeats until -1 occurs

FLAG = 11 CSTRAIN

5 PTYPE(2) CHAR4 Element flag (ELEM) or composite property entry


name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or composite


property IDs

Word 10 repeats until -1 occurs

FLAG = 12 FREQ

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 13 SPCFORCE

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 14 ESE

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

3-122 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 15 CEIG

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 MONE I Entry is -1

FLAG = 19 ERP

5 UNDEF(2) None

7 REGION I Region identifier

8 ATTA I Response attribute

9 ATTB I Frequency or real code for character input, or -1 =


spawn)

10 ATTi I Panel SET3 IDs

Word 10 repeats until -1 occurs

FLAG = 20 FRDISP

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

DMAP Programmer's Guide 3-123


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

Word 10 repeats until -1 occurs

FLAG = 21 FRVELO

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 22 FRACCL

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 23 FRSPCF

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

3-124 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 24 FRSTRE

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 25 FRFORC

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 26 RMSDISP

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Random ID

DMAP Programmer's Guide 3-125


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 27 RMSVELO

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Random ID

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 28 RMSACCL

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Random ID

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 29 PSDDISP

5 UNDEF None

6 PTYPE I Random ID

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

3-126 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

FLAG = 30 PSDVELO

5 UNDEF None

6 PTYPE I Random ID

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 31 PSDACCL

5 UNDEF None

6 PTYPE I Random ID

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Frequency value; -1 (integer) spawn for all


frequencies in set; -1.10000E+08 for SUM;
-1.20000E+08 for AVG; -1.30000E+08 for SSQ;
-1.40000E+08 for RSS; -1.50000E+08 for MAX;
-1.60000E+08 for MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 60 TDISP

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

DMAP Programmer's Guide 3-127


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 61 TVELO

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 62 TACCL

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 63 TSPCF

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

3-128 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 ATTA I Response attribute

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Grid point IDs

Word 10 repeats until -1 occurs

FLAG = 64 TSTRE

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 65 TFORC

5 PTYPE(2) CHAR4 Element flag (ELEM) or property entry name

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB RS Time value; -1 (integer) spawn for all time steps


in set; -1.10000E+08 for SUM; -1.20000E+08 for
AVG; -1.30000E+08 for SSQ; -1.40000E+08 for
RSS; -1.50000E+08 for MAX; -1.60000E+08 for
MIN

10 ATTi I Element numbers (if Word 5 is ELEM) or property


IDs

Word 10 repeats until -1 occurs

FLAG = 81 DIVERG

DMAP Programmer's Guide 3-129


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATT1 RS Mach number

11 MONE I Entry is -1

FLAG = 82 TRIM

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Entry is 0

10 ATT1 I Entry is 0

11 MONE I Entry is -1

FLAG = 83 STABDER

5 UNDEF(2) None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

10 ATT1 I Component

11 MONE I Entry is -1

FLAG = 84 FLUTTER

5 METHOD CHAR4 Analysis type: PK or PKNL

6 UNDEF None

7 REGION I Region identifier for constraint screening

8 ATTA I Response attribute

9 ATTB I Response attribute

3-130 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

10 ATTi I ATT1 is the identification number of a SET1


entry that specifies a set of modes; ATT2 is
the identification number of an FLFACT entry
that specifies a list of densities; ATT3 is the
identification number of an FLFACT entry that
specifies a list of Mach numbers; ATT4 is the
identification number of an FLFACT entry that
specifies a list of velocities

Word 10 repeats until -1 occurs

Record – DRESP2(3906,39,360)
Design equation response quantities.

Word Name Type Description

1 ID I Unique entry identifier

2 LABEL(2) CHAR4 User-defined label

4 EQID I DEQATN entry identification number if integer >


0. Function to be applied to arguments (FUNC) if
integer < 0: -2 for AVG; -3 for SSQ; -4 for RSS;
-5 for MAX; -6 for MIN

5 REGION I Region identifier for constraint screening

6 FLAG I

FLAG = 1000 DESVAR

7 DVIDi I DESVAR entry identification number

Word 7 repeats until -1000

FLAG = 2000 DTABLE

7 LABLi(2) CHAR4 Label for a constant in the DTABLE entry

Word 7 repeats until -2000

FLAG = 3000 DFRFNC

7 DFRFIDi I Identification number for a DFRFNC record in the


DTI, DFRFNC table

Word 7 repeats until -3000

FLAG = 4000 DRESP1

DMAP Programmer's Guide 3-131


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 NRi I DRESP1 entry identification number

Word 7 repeats until -4000

FLAG = 5000 DNODE

7 Gi I Grid point identification number

8 Ci I Component number of grid point

Words 7 and 8 repeat until -5000

FLAG = 6000 DVPREL1

7 DPIPi I DVPREL1 entry identification number

Word 7 repeats until -6000

FLAG = 7000 DVCREL1

7 DCICi I DVCREL1 entry identification number

Word 7 repeats until -7000

FLAG = 8000 DVMREL1

7 DMIMi I DVMREL1 entry identification number

Word 7 repeats until -8000 occurs

FLAG = 9000 DVPREL2

7 DPI2Pi I DVPREL2 entry identification number

Word 7 repeats until -9000 occurs

FLAG = 10000 DVCREL2

7 DCI2Ci I DVCREL2 entry identification number

Word 7 repeats until -10000 occurs

FLAG = 11000 DVMREL2

7 DMI2Mi I DVMREL2 entry identification number

Word 7 repeats until -11000 occurs

FLAG = 12000 DRESP2

7 NRRi I Nested DRESP2 entry identification number

Word 7 repeats until -12000 occurs

3-132 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

End entry when -1 occurs

Record – DRESP3(6700,67,433)

Externally computed design responses.

Word Name Type Description

1 ID I Unique entry identifier

2 LABEL(2) CHAR4 User-defined label referenced by a constraint bulk


entry or by the objective function

4 GROUP(2) CHAR4 Selects a specific external response routine

6 TYPE(2) CHAR4 Refers to a specific user-created response


calculation type in the external function evaluator

8 REGION I Region identifier for constraint screening

9 FLAG I

FLAG = 1000 DESVAR

10 DVIDi I DESVAR entry identification number

Word 10 repeats until -1000

FLAG = 2000 DTABLE

10 LABLi(2) CHAR4 Label for a constant in the DTABLE entry

Word 10 repeats until -2000

FLAG = 3000 DFRFNC

10 DFRFIDi I Identification number for a DFRFNC record in the


DTI, DFRFNC table

Word 10 repeats until -3000

FLAG = 4000 DRESP1

10 NRi I DRESP1 entry identification number

Word 10 repeats until -4000

FLAG = 5000 DNODE

10 Gi I Grid point identification number

DMAP Programmer's Guide 3-133


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

11 Ci I Component number of grid point

Words 10 and 11 repeat until -5000

FLAG = 6000 DVPREL1

10 DPIPi I DVPREL1 entry identification number

Word 10 repeats until -6000

FLAG = 7000 DVCREL1

10 DCICi I DVCREL1 entry identification number

Word 10 repeats until -7000

FLAG = 8000 DVMREL1

10 DMIMi I DVMREL1 entry identification number

Word 10 repeats until -8000 occurs

FLAG = 9000 DVPREL2

10 DPI2Pi I DVPREL2 entry identification number

Word 10 repeats until -9000 occurs

FLAG = 10000 DVCREL2

10 DCI2Ci I DVCREL2 entry identification number

Word 10 repeats until -10000 occurs

FLAG = 11000 DVMREL2

10 DMI2Mi I DVMREL2 entry identification number

Word 10 repeats until -11000 occurs

FLAG = 12000 DRESP2

10 NRRi I Nested DRESP2 entry identification number

Word 10 repeats until -12000 occurs

FLAG = 13000 USRDATA

10 USRDATA(2) CHAR4 Character strings in user-defined format for any


use in the evaluator

Words 10 and 11 repeat until -13000 occurs

3-134 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

End entry when -1 occurs

Record – DSCREEN(4206,42,363)
Design constraint screening data.

Word Name Type Description

1 RTYPE I Response type for which the screening criteria


apply

2 TRS RS Truncation threshold

3 NSTR I Maximum number of constraints to be retained


per region per load case

Record – DTABLE(3706,37,358)
Table constants.

Word Name Type Description

1 LABLi(2) CHAR4 Label for the constant

3 VALUi RS Value of the constant

Words 1 thru 3 repeat until -1 occurs

Record – DVBSHAP(5806,58,474)
Design variable to boundary shapes.

Word Name Type Description

1 DVID I Design variable identification number of a DESVAR


entry

2 AUXMID I Auxiliary model identification number

3 COLi I Load sequence identification number from


AUXMODEL command

4 SFi RS Scaling factor for load sequence identification


number

Words 1 thru 4 repeat for i = 2 and 3

DMAP Programmer's Guide 3-135


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – DVCREL1(6100,61,429)
Design variable to connectivity property relation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of an element connectivity entry

4 EID I Element identification number

5 FID I Entry is 0

6 CPMIN RS Minimum value allowed for this property

7 CPMAX RS Maximum value allowed for this property

8 C0 RS Constant term of relation

9 CPNAME(2) CHAR4 Name of connectivity property

11 DVIDi I DESVAR entry identification number

12 COEFi RS Coefficient of linear relation

Words 11 and 12 repeat until -1 occurs

Record – DVCREL2(6200,62,430)
Design variable to connectivity property relation based on a user-supplied equation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of an element connectivity entry

4 EID I Element identification number

5 FID I Entry is 0

6 CPMIN RS Minimum value allowed for this property

7 CPMAX RS Maximum value allowed for this property

8 EQID I DEQATN entry identification number

9 CPNAME(2) CHAR4 Name of connectivity property

11 FLAG I DESVAR/DTABLE

FLAG = 1000 DESVAR

3-136 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

12 DVIDi I A DESVAR entry identification number

Word 12 repeats until -1000

FLAG = 2000 DTABLE

12 LABLi(2) CHAR4 Label for a constant on the DTABLE entry

Words 12 and 13 repeat until -2000

End flag when -1 occurs

Record – DVGEOM(5906,59,356)
Design variable to geometry relation.

Word Name Type Description

1 DVID I DESVAR entry identification number

2 ENTITY(2) CHAR4 Designed entity

4 ID I Identification number of the parent entity specified


by ENTITY

5 IDPRTB I Identification number of the perturbed entity


specified by ENTITY

Record – DVGRID(4406,44,372)
Design variable to grid point relation.

Word Name Type Description

1 DVID I DESVAR entry identification number

2 GID I Grid point or geometric point identification number

3 CID I Coordinate system identification number

4 COEFF RS Multiplier of the vector defined by N(3)

5 N1 RS Component of the vector measured in the


coordinate system defined by CID

6 N2 RS Component of the vector measured in the


coordinate system defined by CID

7 N3 RS Component of the vector measured in the


coordinate system defined by CID

DMAP Programmer's Guide 3-137


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – DVMREL1(6300,63,431)
Design variable to material relation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of a material property entry

4 MID I Material identification number

5 FID I Entry is 0

6 MPMIN RS Minimum value allowed for this property

7 MPMAX RS Maximum value allowed for this property

8 C0 RS Constant term of relation

9 MPNAME(2) CHAR4 Name of material property

11 DVIDi I DESVAR entry identification number

12 COEFi RS Coefficient of linear relation

Words 11 and 12 repeat until -1 occurs

Record – DVMREL2(6400,64,432)
Design variable to material relation based on a user-supplied equation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of a material property entry

4 MID I Material identification number

5 FID I Entry is 0

6 MPMIN RS Minimum value allowed for this property

7 MPMAX RS Maximum value allowed for this property

8 EQID I DEQATN entry identification number

9 MPNAME(2) CHAR4 Name of material property

11 FLAG I DESVAR/DTABLE

FLAG = 1000 DESVAR

3-138 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

12 DVIDi I A DESVAR entry identification number

Word 12 repeats until -1000

FLAG = 2000 DTABLE

12 LABLi(2) CHAR4 Label for a constant on the DTABLE entry

Words 12 and 13 repeat until -2000

End flag when -1 occurs

Record – DVPREL1(3306,33,354)
Design variable to property relation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of a property entry

4 PID I Property entry identification number

5 FID I FID number input. Otherwise, either 0 if property


name is input, or frequency (RS) if entry is for
frequency dependent property. (See Words 9 and
10)

6 PMIN RS Minimum value allowed for this property

7 PMAX RS Maximum value allowed for this property

8 C0 RS Constant term of relation

9 PNAME1 CHAR4 First word of property name, if any, or blanks if FID


number is nonzero in Word 5

10 PNAME2 CHAR4 Second word of property name, if any. Otherwise,


either blanks if FID number is nonzero in Word 5, or
frequency (RS) if entry is for frequency dependent
property. (See Word 5)

11 DVIDi I DESVAR entry identification number

12 COEFi RS Coefficient of linear relation

Words 11 and 12 repeat until -1 occurs

DMAP Programmer's Guide 3-139


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – DVPREL2(3406,34,355)
Design variable to property relation based on a user-supplied equation.

Word Name Type Description

1 ID I Unique identification number

2 TYPE(2) CHAR4 Name of a property entry

4 PID I Property entry identification number

5 FID I FID number input. Otherwise, either 0 if property


name is input, or frequency (RS) if entry is for
frequency dependent property. (See Words 9 and
10)

6 PMIN RS Minimum value allowed for this property

7 PMAX RS Maximum value allowed for this property

8 EQID I DEQATN entry identification number

9 PNAME1 CHAR4 First word of property name, if any, or blanks if FID


number is nonzero in Word 5

10 PNAME2 CHAR4 Second word of property name, if any. Otherwise,


either blanks if FID number is nonzero in Word 5, or
frequency (RS) if entry is for frequency dependent
property. (See Word 5)

11 FLAG I DESVAR/DTABLE

FLAG = 1000 DESVAR

12 DVIDi I A DESVAR entry identification number

Word 12 repeats until -1000

FLAG = 2000 DTABLE

12 LABLi(2) CHAR4 Label for a constant on the DTABLE entry

Words 12 and 13 repeat until -2000

End flag when -1 occurs

Record – DVSHAP(5006,50,470)
Design variable to basis vectors.

3-140 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

1 DVID I Design variable identification number on the


DESVAR entry

2 COLi I Column number of the displacement matrix

3 SFi RS Scaling factor applied to the COL column of the


displacement matrix

Words 1 thru 3 repeat until (-1,-1,-1) occurs

Record – ERP( , , )
This is a para in the topic template.

Record – MAT1DOM(103,1,9944)
If one or more properties from a MAT1 entry are used as design variables, the MAT1DOM record is
written to the EDOM data block. This is different than the MAT1 record in the MPT data block.

Word Name Type Description

1 MID I MAT1 identification number

2 FTE I Format code for Young’s modulus

3 FTG I Format code for shear modulus

4 FTNU I Format code for Poisson’s ratio

Record – MAT10DOM(2801,28,9945)
If one or more properties from a MAT10 entry are used as design variables, the MAT10DOM record is
written to the EDOM data block. This is different than the MAT10 record in the MPT data block.

Word Name Type Description

1 MID I MAT10 identification number

2 FTBULK I Format code for bulk modulus

3 FTRHO I Format code for mass density

4 FTC I Format code for speed of sound

Record – MODTRAK(6006,60,477)
Mode tracking parameters.

DMAP Programmer's Guide 3-141


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 SID I Set identification number that is selected with a


MODTRAK command

2 LOWRNG I Lowest mode number in range to search

3 HIGHRNG I Highest mode number in range to search

4 MTFILTER RS Filtering parameter used in mode cross-orthogonality


check

Record – EODB(65535,65535,65535)
End of data block.

Record – TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

3.21 EDT
Aero and element deformations.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – ACMODL(5201,52,373)
Fluid-structure interface modeling parameters.

Word Name Type Description

1 INTER(2) CHAR4 IDENT or DIFF method specification

3 INFO(2) CHAR4 Allowable values are ALL, ELEMENTS, PID,


SET3, and NONE

5 FSET I Fluid set ID

6 SSET I Structure set ID

3-142 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

7 NORML RS Outward normal search distance to detect


fluid-structure interface

8 METHOD(2) CHAR4 Interface calculation method

10 OVPLANG RS Angular tolerance in degrees used to decide


whether a fluid free face and a structural face are
overlapping

11 SRCHUNIT(2) CHAR4 Search unit

13 INTOL RS Inward normal search distance to detect


fluid-structure interface

14 AREAOPT I Area option

15 SKNEPS RS SKNEPS option. Only used when AREAOPT = 0

16 INTORD I Integration order

Record – ADAPT(6301,63,397)
Version adaptivity control.

Word Name Type Description

1 SID I Adapt entry identification number selected by


ADAPT case control command

2 ADGEN I Identification number of the first PVAL entry


generated in the adaptive process

3 MAXITER I Number of analyses performed before adaptive


process is stopped

4 PSTRTID I Identification number of the PVAL entry describing


the starting p-order distribution

5 PMINID I Identification number of the PVAL entry describing


the minimum p-order distribution

6 PMAXID I Identification number of the PVAL entry describing


the maximum p-order distribution

7 PART(2) CHAR4 Part name of the elements defined in ELSET and


controlled by TYPE, ERREST, ERRTOL, SIGTOL,
and EPSTOL

9 ELSET I Identification number of the SET command under


the SETS DEFINITION command

DMAP Programmer's Guide 3-143


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

10 TYPE CHAR4 p-order adjustment

11 ERREST I Error estimator activation flag

12 ERRTOL RS Error tolerance

13 SIGTOL RS Stress tolerance

14 EPSTOL RS Strain tolerance

15 UNDEF(4) None

Words 7 thru 18 repeat until -1 occurs

Record – AECOMP(7801,78,582)

Component for an integrated load monitor point.

Word Name Type Description

1 NAME(2) CHAR4 Character string identifying the component

3 LISTTYPE(2) CHAR4 CAERO or AELIST for aerodynamic components


and SET1 for structural components

5 LISTID I CAERO, AELIST, or SET1 entry identification


number

Word 5 repeats until -1 occurs

Record – AECOMPL(7901,79,583)

Component for an integrated load monitor point.

Word Name Type Description

1 NAME(2) CHAR4 Character string identifying the component

3 LABEL(2) CHAR4 Character string identifying other components


defined by AECOMP or AECOMPL entries

Words 3 and 4 repeat until (-1,-1) occurs

Record – AEDW(7301,73,574)

Parametric normal wash loading for aerodynamics.

3-144 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

1 MACH RS Mach number

2 SYMXZ(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

4 SYMXY(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

6 UXID I The identification number of a UXVEC entry

7 DMIJ(2) CHAR4 The name of a DMI or DMIJ entry that defines the
downwash

9 DMIJI(2) CHAR4 The name of a DMIJI entry that defines the


CAERO2 interference element downwashes

Record – AEFACT(4002,40,273)
Aerodynamic lists.

Word Name Type Description

1 SID I Set identification number

2 D RS Number

Word 2 repeats until -1 occurs

Record – AEFORCE(7501,75,576)
Parametric force for aerodynamics.

Word Name Type Description

1 MACH RS Mach number

2 SYMXZ(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

4 SYMXY(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

6 UXID I The identification number of a UXVEC entry

DMAP Programmer's Guide 3-145


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 MESH(2) CHAR4 Character string identifying whether the force is


defined on the aerodynamic mesh or structural
mesh. Allowable values are AERO and STRUCT

9 FORCE I The identification number of a FORCE/MOMENT


set

10 DMIK(2) CHAR4 The name of a DMIK entry that defines the


aerodynamic force vector

Record – AELINK(2602,26,386)
Links aeroelastic variables.

Word Name Type Description

1 ID I Trim set identification number

2 LABLD(2) CHAR4 Character string identifying the dependent


aerodynamic variable

4 LABL(2) CHAR4 Character string identifying the aerodynamic variable

6 C RS Linking coefficient for the aerodynamic variable

Words 4 thru 6 repeat until (-1,-1,-1) occurs

Record – AELIST(2302,23,341)
Aerodynamic element list.

Word Name Type Description

1 SID I Set identification number

2 E I List of aerodynamic boxes generated by


CAERO1 entries to define a surface

Word 2 repeats until -1 occurs

Record – AEPARM(7001,70,571)
General controller for use in trim.

Word Name Type Description

1 ID I Controller identification number

3-146 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 LABEL(2) CHAR4 Controller name

4 UNIT(2) CHAR4 Label used to describe the units of the controller


values

Record – AEPRESS(7401,74,575)
Parametric pressure loading for aerodynamics.

Word Name Type Description

1 MACH RS Mach number

2 SYMXZ(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

4 SYMXY(2) CHAR4 Character string for identifying symmetry of the


force vector. Allowable values are SYMM, ASYMM,
and ANTI

6 UXID I The identification number of a UXVEC entry

7 DMIJ(2) CHAR4 The name of a DMI or DMIJ entry that defines the
pressure per unit dynamic pressure

9 DMIJI(2) CHAR4 The name of a DMIJI entry that defines the


CAERO2 interference element downwashes

Record – AERO(3202,32,265)
Aerodynamic physical data.

Word Name Type Description

1 ACSID I Aerodynamic coordinate system identification


number

2 VELOCITY RS Velocity for aerodynamic force data recovery


and to calculate the BOV parameter

3 REFC RS Reference length for reduced frequency

4 RHOREF RS Reference density

5 SYMXZ I Symmetry key for the aero coordinate xz plane

6 SYMXY I Symmetry key for the aero coordinate xy plane


that can be used to simulate ground effects

DMAP Programmer's Guide 3-147


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – AEROS(2202,22,340)
Static aeroelasticity physical data.

Word Name Type Description

1 ACSID I Aerodynamic coordinate system identification


number

2 RCSID I Reference coordinate system identification


number for rigid body motions

3 REFC RS Reference chord length

4 REFB RS Reference span

5 REFS RS Reference wing area

6 SYMXZ I Symmetry key for the aero coordinate xz plane

7 SYMXY I Symmetry key for the aero coordinate xy plane


that can be used to simulate ground effects

Record – AESTAT(2102,21,339)
Static aeroelasticity trim variables.

Word Name Type Description

1 ID I Identification number of an aerodynamic trim


variable dof

2 LABEL(2) CHAR4 An alphanumeric string identifying the dof

Record – AESURF(2002,20,338)
Aerodynamic control surface.

Word Name Type Description

1 ID I Controller identification number

2 LABEL(2) CHAR4 Controller name

4 CID1 I Identification number of a rectangular coordinate


system with a y-axis defining the hinge line of the
control surface component

5 ALID1 I Identification number of an AELIST entry identifying


all aerodynamic elements that make up the control
surface component

3-148 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

6 CID2 I Identification number of a rectangular coordinate


system with a y-axis defining the hinge line of the
control surface component

7 ALID2 I Identification number of an AELIST entry identifying


all aerodynamic elements that make up the control
surface component

8 EFF RS Control surface effectiveness. Default = 1.0

9 LDW I Linear downwash flag

10 CREFC RS Reference chord length for the control surface

11 CREFS RS Reference surface area for the control surface

12 PLLIM RS Lower deflection limit for the control surface in rad

13 PULIM RS Upper deflection limit for the control surface in rad

14 HMLLIM RS Lower hinge moment limit for the control surface


in force-length units

15 HMULIM RS Upper hinge moment limit for the control surface


in force-length units

16 TQLLIM RS Set identification number of TABLED entry providing


the lower deflection limit for the control surface as a
function of dynamic pressure

17 TQULIM RS Set identification number of TABLED entry providing


the upper deflection limit for the control surface as
a function of dynamic pressure

Record – AESURFS(7701,77,581)
Aerodynamic control surface.

Word Name Type Description

1 ID I Identification number of an aerodynamic trim


variable DOF

2 LABEL(2) CHAR4 Control surface name

4 LIST1 I Identification number of a SET1 entry that contains


the grid IDs associated with this control surface

5 LIST2 I Identification number of a SET1 entry that contains


the grid IDs associated with this control surface

DMAP Programmer's Guide 3-149


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – BOLT(7108,82,251)
Bolt definition.

Word Name Type Description

1 BID I Bolt identification number

2 FLAG I

FLAG = 1

3 BMID I Beam identification number

Word 3 repeats until -1

FLAG = 2

3 CID I Coordinate system identification number defining


bolt direction

4 C I Component number defining the bolt direction

5 GID I Grid point identification number

Word 5 repeats until -1

FLAG = 3

3 CID I Coordinate system identification number defining


bolt direction

4 IDIR I Direction of bolt axis relative to CID

5 GID I Grid point identification number

6 EID I Element identification number

Word 6 repeats until -1

Record – CAERO1(3002,30,263)
Aerodynamic panel element connection.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number of a PAERO1 entry

3 CP I Coordinate system for locating points 1 and 4

4 NSPAN I Number of spanwise boxes

3-150 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

5 NCHORD I Number of chordwise boxes

6 LSPAN I Identification number of an AEFACT entry


containing a list of division points for spanwise
boxes

7 LCHORD I Identification number of an AEFACT entry


containing a list of division points for chordwise
boxes

8 IGID I Interference group identification number

9 X1 RS X-coordinate of point 1 in coordinate system CP

10 Y1 RS Y-coordinate of point 1 in coordinate system CP

11 Z1 RS Z-coordinate of point 1 in coordinate system CP

12 X12 RS Edge chord length in aerodynamic coordinate


system

13 X4 RS X-coordinate of point 4 in coordinate system CP

14 Y4 RS Y-coordinate of point 4 in coordinate system CP

15 Z4 RS Z-coordinate of point 4 in coordinate system CP

16 X43 RS Edge chord length in aerodynamic coordinate


system

Record – CAERO2(4301,43,167)
Aerodynamic body connection.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number of a PAERO2 entry

3 CP I Coordinate system for locating point 1

4 NSP I Number of slender body elements

5 NINT I Number of interference elements

6 LSP I Identification number of an AEFACT entry for


slender body division points

DMAP Programmer's Guide 3-151


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

7 LINT I Identification number of an AEFACT entry


containing a list of division points for interference
elements

8 IGID I Interference group identification number

9 X1 RS X-coordinate of point 1 in coordinate system CP

10 Y1 RS Y-coordinate of point 1 in coordinate system CP

11 Z1 RS Z-coordinate of point 1 in coordinate system CP

12 X12 RS Length of body in the x-direction of the aerodynamic


coordinate system

13 UNDEF(4) None

Record – CAERO3(4401,44,168)
Aerodynamic panel element configuration.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number of a PAERO3 entry

3 CP I Coordinate system for locating points 1 and 4

4 LISTW I Identification number of an AEFACT entry that lists


coordinate pairs for structural interpolation of the
wing

5 LISTC1 I Identification number of an AEFACT entry that lists


coordinate pairs for control surfaces

6 LISTC2 I Identification number of an AEFACT entry that lists


coordinate pairs for control surfaces

7 UNDEF(2) None

9 X1 RS X-coordinate of point 1 in coordinate system CP

10 Y1 RS Y-coordinate of point 1 in coordinate system CP

11 Z1 RS Z-coordinate of point 1 in coordinate system CP

12 X12 RS Edge chord length in aerodynamic coordinate


system

3-152 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

13 X4 RS X-coordinate of point 4 in coordinate system CP

14 Y4 RS Y-coordinate of point 4 in coordinate system CP

15 Z4 RS Z-coordinate of point 4 in coordinate system CP

16 X43 RS Edge chord length in aerodynamic coordinate


system

Record – CAERO4(4501,45,169)
Aerodynamic macro-strip element connection.

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number of a PAERO4 entry

3 CP I Coordinate system for locating points 1 and 4

4 NSPAN I Number of strips

5 LSPAN I Identification number of an AEFACT entry


containing a list of division points for strips

6 UNDEF(3) None

9 X1 RS X-coordinate of point 1 in coordinate system CP

10 Y1 RS Y-coordinate of point 1 in coordinate system CP

11 Z1 RS Z-coordinate of point 1 in coordinate system CP

12 X12 RS Edge chord length in aerodynamic coordinate


system

13 X4 RS X-coordinate of point 4 in coordinate system CP

14 Y4 RS Y-coordinate of point 4 in coordinate system CP

15 Z4 RS Z-coordinate of point 4 in coordinate system CP

16 X43 RS Edge chord length in aerodynamic coordinate


system

Record – CAERO5(5001,50,175)
Aerodynamic panel element configuration.

DMAP Programmer's Guide 3-153


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number of a PAERO5 entry

3 CP I Coordinate system for locating points 1 and 4

4 NSPAN I Number of strips

5 LSPAN I Identification number of an AEFACT entry


containing a list of division points for strips

6 NTHRY I Parameter to select Piston or van Dyke’s theory

7 NTHICK I Parameter to select thickness integrals input

8 UNDEF None

9 X1 RS X-coordinate of point 1 in coordinate system CP

10 Y1 RS Y-coordinate of point 1 in coordinate system CP

11 Z1 RS Z-coordinate of point 1 in coordinate system CP

12 X12 RS Edge chord length in aerodynamic coordinate


system

13 X4 RS X-coordinate of point 4 in coordinate system CP

14 Y4 RS Y-coordinate of point 4 in coordinate system CP

15 Z4 RS Z-coordinate of point 4 in coordinate system CP

16 X43 RS Edge chord length in aerodynamic coordinate


system

Record – CLOAD(6201,62,143)

Static load combination for superelement loads.

Word Name Type Description

1 CID I Combination identification number

2 S RS Scale factor

3 SI RS Scale factors

4 IDVI I Identification numbers of load vectors

Words 3 and 4 repeat until (-1,-1) occurs

3-154 DMAP Programmer's Guide


Data Block Descriptions A-E

Record – CSSCHD(6401,64,307)
Aerodynamic control surface schedule input.

Word Name Type Description

1 SID I Set identification number

2 AESID I Identification number of an AESURF entry to which


the schedule is attached

3 LALPHA I Identification number of an AEFACT entry


containing a list of angles of attack at which
schedule information is provided

4 LMACH I Identification number of an AEFACT entry


containing a list of Mach numbers at which
schedule information is provided

5 LSCHD I Identification number of an AEFACT entry which


contains the scheduling information

Record – DEFORM(104,1,81)
Static element deformation.

Word Name Type Description

1 SID I Deformation set identification number

2 EID I Element number

3 D RS Deformation

Record – DIVERG(2702,27,387)
Divergence analysis data.

Word Name Type Description

1 SID I Unique set identification number

2 NROOT I Number of divergence roots to output

3 M RS Mach number

Word 3 repeats until -1 occurs

Record – FLFACT(4102,41,274)
Aerodynamic physical data.

DMAP Programmer's Guide 3-155


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 SID I Set identification number

2 F RS Aerodynamic factor

Word 2 repeats until -1 occurs

Record – FLUTTER(3902,39,272)
Aerodynamic flutter data.

Word Name Type Description

1 SID I Set identification number

2 METHOD(2) CHAR4 Flutter analysis method

4 DENS I Identification number of an FLFACT entry


specifying density ratios for flutter analysis

5 MACH I Identification number of an FLFACT entry


specifying Mach numbers for flutter analysis

6 RFREQ I Identification number of an FLFACT entry


specifying reduced frequencies for flutter analysis

7 IMETH(2) CHAR4 Interpolation method for aerodynamic matrix


interpolation

9 NEIGN I Number of eigenvalues beginning with the first


eigenvalue

10 EPS RS Convergence parameter

Words 1 thru 10 repeat until -1 occurs

Record – GROUP(17400,174,616)
Group definition.

Word Name Type Description

1 GID I Group identification number

2 NDESC(C) I Length of group description

3 GDESC(2) CHAR4 Group description

Word 3 repeats NDESC times

3-156 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

NDESC+3 GTYPE I Group type


-2 = Meta data
-3 = Property identification numbers
-4 = Grid identification numbers
-5 = Element identification numbers

GTYPE = -2 Meta data

NDESC+4 NMETA I Length of meta data

NDESC+5 MDESC(2) CHAR4 Meta data

Word NDESC+5 repeats NMETA times

GTYPE = -3 Property identification numbers

NDESC+5 ID I Property identification numbers


+NMETA > 0 for ID
= 0 for THRU
= -6 for BY
= -7 for ALL

Word NDESC+5+NMETA repeats until -1 occurs

GTYPE = -4 Grid identification numbers

NDESC+5 ID I Property identification numbers


+NMETA > 0 for ID
= 0 for THRU
= -6 for BY
= -7 for ALL

Word NDESC+5+NMETA repeats until -1 occurs

GTYPE = -5 Element identification numbers

NDESC+5 ID I Property identification numbers


+NMETA > 0 for ID
= 0 for THRU
= -6 for BY
= -7 for ALL

Word NDESC+5+NMETA repeats until -1 occurs

Record – ITER(5808,58,220)
Iterative solver options.

DMAP Programmer's Guide 3-157


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 SID I Set identification number

2 PRECOND I Preconditioner option for global and element


iterative solution

3 CONV I Convergence criterion

4 MSGFLG I Message flag

5 ITSEPS RS User-given convergence parameter epsilon

6 ITSMAX I Maximum number of iterations

7 IPAD I Global iterative solution padding value

8 IEXT I Global iterative solution extraction level in reduced


or block incomplete Cholesky factorization

9 PREFONLY I Specifies early termination of the global iterative


solver

10 ZPIVOT RS Singularity tolerance adjustment during the


preconditioner phase of an element iterative
solution

Record – MKAERO1(3802,38,271)
Mach number and reduced frequency table.

Word Name Type Description

1 M(16) RS List of from 1 to 8 Mach numbers and their


corresponding 1 to 8 reduced frequencies

Record – MKAERO2(3702,37,270)
Mach number and reduced frequency table.

Word Name Type Description

1 M1 RS Mach number

2 K1 RS Reduced frequency

3 M2 RS Mach number

4 K2 RS Reduced frequency

3-158 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

5 M3 RS Mach number

6 K3 RS Reduced frequency

7 M4 RS Mach number

8 K4 RS Reduced frequency

Record – MONPNT1(7601,76,577)
Integrated load monitor point.

Word Name Type Description

1 NAME(2) CHAR4 Character string identifying the monitor point

3 LABEL(14) CHAR4 Character string identifying and labeling the


monitor point

17 AXES I Component axes about which to sum

18 COMP(2) CHAR4 The name of an AECOMP or AECOMPL entry


that defines the set of grid points over which the
monitor point is defined

20 CID I Coordinate system identification number

21 X RS X-coordinate in the CID coordinate system

22 Y RS Y-coordinate in the CID coordinate system

23 Z RS Z-coordinate in the CID coordinate system

Record – PAERO1(3102,31,264)
Aerodynamic panel property.

Word Name Type Description

1 PID I Property identification number referenced by a


CAERO1 entry

2 B1 I Identification number of CAERO2 entries for an


associated body

3 B2 I Identification number of CAERO2 entries for an


associated body

DMAP Programmer's Guide 3-159


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 B3 I Identification number of CAERO2 entries for an


associated body

5 B4 I Identification number of CAERO2 entries for an


associated body

6 B5 I Identification number of CAERO2 entries for an


associated body

7 B6 I Identification number of CAERO2 entries for an


associated body

8 UNDEF None

Record – PAERO2(4601,46,170)
Aerodynamic body properties.

Word Name Type Description

1 PID I Property identification number

2 ORIENT CHAR4 Orientation flag

3 UNDEF None

4 WIDTH RS Reference half-width of body and the width of the


constant width interference tube

5 AR RS Aspect ratio of the interference tube (height/width)

6 LRSB I Identification number of an AEFACT entry


containing a list of slender body half-widths at the
end points of the slender body elements

7 LRIB I Identification number of an AEFACT entry


containing a list of slender body half-widths at the
end points of the interference elements

8 LTH1 I Identification number of an AEFACT entry defining


theta arrays for interference calculations

9 LTH2 I Identification number of an AEFACT entry defining


theta arrays for interference calculations

10 THI1 I The first interference element of a body to use the


theta1 array; others use the theta2 array

11 THN1 I The last interference element of a body to use the


theta1 array; others use the theta2 array

3-160 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

12 THI2 I The first interference element of a body to use the


theta1 array; others use the theta2 array

13 THN2 I The last interference element of a body to use the


theta1 array; others use the theta2 array

14 THI3 I The first interference element of a body to use the


theta1 array; others use the theta2 array

15 THN3 I The last interference element of a body to use the


theta1 array; others use the theta2 array

Record – PAERO3(4701,47,171)
Aerodynamic panel property.

Word Name Type Description

1 PID I Property identification number

2 NBOX I Number of Mach boxes in the flow direction

3 FLAG I

FLAG = 0

4 UNDEF None

5 X5 RS X-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

6 Y5 RS Y-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

7 X6 RS X-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

8 Y6 RS Y-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

FLAG = 1

4 UNDEF None

DMAP Programmer's Guide 3-161


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

5 X5 RS X-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

6 Y5 RS Y-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

7 X6 RS X-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

8 Y6 RS Y-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

9 X7 RS X-coordinate of point 7 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

10 Y7 RS Y-coordinate of point 7 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

11 X8 RS X-coordinate of point 8 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

12 Y8 RS Y-coordinate of point 8 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

13 X9 RS X-coordinate of point 9 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

14 Y9 RS Y-coordinate of point 9 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

15 X10 RS X-coordinate of point 10 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

16 Y10 RS Y-coordinate of point 10 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

FLAG = 2

3-162 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

4 UNDEF None

5 X5 RS X-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

6 Y5 RS Y-coordinate of point 5 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

7 X6 RS X-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

8 Y6 RS Y-coordinate of point 6 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

9 X7 RS X-coordinate of point 7 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

10 Y7 RS Y-coordinate of point 7 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

11 X8 RS X-coordinate of point 8 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

12 Y8 RS Y-coordinate of point 8 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

13 X9 RS X-coordinate of point 9 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

14 Y9 RS Y-coordinate of point 9 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

15 X10 RS X-coordinate of point 10 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

16 Y10 RS Y-coordinate of point 10 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

DMAP Programmer's Guide 3-163


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

17 X11 RS X-coordinate of point 11 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

18 Y11 RS Y-coordinate of point 11 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

19 X12 RS X-coordinate of point 12 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

20 Y12 RS Y-coordinate of point 12 in the aerodynamic


coordinate system defining the cranks and control
surface geometry

Record – PAERO4(4801,48,172)
Aerodynamic strip properties.

Word Name Type Description

1 PID I Property identification number

2 CLA I Select Prandtl-Glauert correction

3 LCLA I Identification number of the AEFACT entry that lists


the lift curve slope on all strips for each Mach number
on the MKAERO entry

4 CIRC I Select Theodorsen’s function C(k) or the number of


exponential coefficients used to approximate C(k)

5 LCIRC I Identification number of the AEFACT entry that lists


the b, beta values for each Mach number

6 DOC RS Distance of the control surface hinge aft of the


quarter-chord divided by the strip chord

7 CAOC RS Control surface chord divided by the strip chord

8 GAPOC RS Control surface gap divided by the strip chord

Words 6 thru 8 repeat until -1 occurs

Record – PAERO5(5101,51,176)
Aerodynamic panel property.

3-164 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

1 PID I Property identification number

2 NALPHA I Number of angle of attack values input for each Mach


number on the MKAERO1 or MKAERO2 entry

3 LALPHA I Identification number of the AEFACT entry that lists


the angle of attack values for the strips at each Mach
number in the MKAERO1 or MKAERO2 entry

4 NXIS I Number of dimensionless chord coordinates to be


input

5 LXIS I Identification number of the AEFACT entry that lists


the dimensionless chord coordinates for the strip in
order indicated by values of NXIS and NTHICK

6 NTAUS I Number of thickness ratio values to be input

7 LTAUS I Identification number of the AEFACT entry that lists


the number of thickness ratio values

8 CAOC RS Control surface chord divided by the strip chord

Word 8 repeats until -1 occurs

Record – PANEL(5301,53,378)
Panel definition for coupled fluid-structural analysis.

Word Name Type Description

1 NAME(2) CHAR4 Panel label

3 SETID I Identification number of a SET1 entry that lists the


grid points of the panel

Words 1 thru 3 repeat until -1 occurs

Record – SET1(3502,35,268)
Set definition.

Word Name Type Description

1 SID I Unique identification number

2 G I Structural grid point identification number

Word 2 repeats until -1 occurs

DMAP Programmer's Guide 3-165


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record – SET2(3602,36,269)
Grid point list.

Word Name Type Description

1 SID I Unique identification number

2 MACRO I Identification number of an aerodynamic macro


element

3 SP1 RS Lower span division point defining the prism


containing the set

4 SP2 RS Higher span division point defining the prism


containing the set

5 CH1 RS Lower chord division point defining the prism


containing the set

6 CH2 RS Higher chord division point defining the prism


containing the set

7 ZMAX RS Z-coordinate of the top of the prism containing the set

8 ZMIN RS Z-coordinate of the bottom of the prism containing


the set.

Record – SET3(4302,43,607)
Set definition.

Word Name Type Description

1 SID I Set identification number

2 TYPE I Set type


1 = element
2 = grid
3 = property

3 ID I Identifying number for either structural grids,


elements, or physical properties

Word 3 repeats until -1 occurs

Record – SPLINE1(3302,33,266)
Surface spline methods.

3-166 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

1 EID I Element identification number

2 CAERO I CAERO entry defining the plane of the spline

3 BOX1 I First box with motions interpolated using this spline

4 BOX2 I Last box with motions interpolated using this spline

5 SETG I The SETi entry listing the structural grid points to


which the spline is attached

6 DZ RS Linear attachment flexibility

7 METH(2) CHAR4 Method for the spline fit: IPS, TPS, or FPS

9 USAGE(2) CHAR4 Spline usage flag to determine whether this spline


applies to force transformation, displacement
transformation, or both: FORCE, DISP, or BOTH

11 NELEM I Number of elements on x-axis for FPS

12 MELEM I Number of elements on y-axis for FPS

Record – SPLINE2(3402,34,267)
Linear spline.

Word Name Type Description

1 EID I Element identification number

2 CAERO I CAERO entry that is to be interpolated

3 ID1 I First box or body element with motions interpolated


using this spline

4 ID2 I Last box or body element with motions interpolated


using this spline

5 SETG I The SETi entry listing the structural grid points to


which the spline is attached

6 DZ RS Linear attachment flexibility

7 DTOR RS Torsional flexibility ratio

8 CID I Rectangular coordinate system for which the


y-axis defines the axis of the spline

DMAP Programmer's Guide 3-167


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 DTHX RS Rotational attachment flexibility for rotation about


the x-axis of the spline

10 DTHY RS Rotational attachment flexibility for rotation about


the y-axis of the spline

11 USAGE(2) CHAR4 Spline usage flag to determine whether this spline


applies to force transformation, displacement
transformation, or both: FORCE, DISP, or BOTH

Record – SPLINE3(4901,49,173)
Aeroelastic constraint equation.

Word Name Type Description

1 EID I Element identification number

2 CAERO I Identification number of the macro-element on


which the element to be interpolated lies

3 BOXID I Identification number of the aerodynamic element

4 COMP I The component of motion to be interpolated

5 USAGE(2) CHAR4 Spline usage flag to determine whether this spline


applies to the force transformation, displacement
transformation, or both: FORCE, DISP, or BOTH

7 G I Identification number of the independent grid point

8 C I Component number in the displacement coordinate


system

9 A RS Coefficient of the constraint relationship

Words 7 thru 9 repeat until -1 occurs

Record – SPLINE4(6501,65,308)
Surface spline methods.

Word Name Type Description

1 EID I Element identification number

2 CAERO I Aero panel identification number defining the


interpolation surface

3-168 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 AELIST I Identification number of an AELIST entry listing


boxes with motions that are interpolated using this
spline

4 SETG I The SETi entry listing the structural grid points to


which the spline is attached

5 DZ RS Linear attachment flexibility

6 METH(2) CHAR4 Method for the spline fit: IPS, TPS, or FPS

8 USAGE(2) CHAR4 Spline usage flag to determine whether this spline


applies to force transformation, displacement
transformation, or both: FORCE, DISP, or BOTH

10 NELEM I Number of elements along the local spline x-axis


for FPS

11 MELEM I Number of elements along the local spline y-axis


for FPS

Record – SPLINE5(6601,66,309)
Linear spline.

Word Name Type Description

1 EID I Element identification number

2 CAERO I CAERO entry that is to be interpolated

3 AELIST I Identification number of an AELIST entry listing


aerodynamic boxes with motions that are
interpolated using this spline

4 SETG I The SETi entry listing the structural grid points to


which the spline is attached

5 DZ RS Linear attachment flexibility

6 DTORXY RS Torsional flexibility ratio in xy-plane

7 CID I Rectangular coordinate system that defines the


y-axis of the spline and the xy- and yz-planes for
bending

8 DTHX RS Rotational attachment flexibility for rotation about


the x-axis of the spline

DMAP Programmer's Guide 3-169


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 DTHY RS Rotational attachment flexibility for rotation about


the y-axis of the spline

10 DTHZ RS Set to 0.0

11 USAGE(2) CHAR4 Spline usage flag to determine whether this spline


applies to the force transformation, displacement
transformation, or both: FORCE, DISP, or BOTH

13 METHOD(2) CHAR4 Set to IPS

15 DTORZY RS Set to 1.0

Record – SWLDPRM(14000,140,568)
Parameters for CWELD/CFAST connectors.

Word Name Type Description

1 PARAM(2) CHAR4 Parameter name

3 FLAG I

FLAG = 1 Integer parameters

4 IVAL I Integer parameter value

Word 4 repeats until -1

FLAG = 2 Real parameters

4 RVAL RS Real parameter value

Word 4 repeats until -1

Record – TRIM(2402,24,342)
Trim variable constraint.

Word Name Type Description

1 SID I Trim set identification number

2 MACH RS Mach number

3 Q RS Dynamic pressure

4 AEQR RS Flag to request rigid trim analysis

3-170 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

5 LABEL(2) CHAR4 AESTAT or AESURF entry identifying aerodynamic


trim variables

7 UX RS Magnitude of aerodynamic extra point dof

Words 5 thru 7 repeat until (-1,-1,-1) occurs

Record – UXVEC(7201,72,573)
Control parameter state.

Word Name Type Description

1 ID I Control vector identification number

2 LABEL(2) CHAR4 Controller name

4 UX RS Magnitude of aerodynamic extra point dof

Words 2 thru 4 repeat until (-1,-1) occurs

Record – TRAILER
Word Name Type Description

1 UNDEF(6) None

3.22 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 Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record 1 – IDENT
Word Name Type Description

1 SRFTYP(C) I Entity Type: 2=surface and 3=volume. See


Note 1.

DMAP Programmer's Guide 3-171


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record 2 – DATA

Word Name Type Description

SRFTYP =2 Surface definition

1 SURFID I Surface identification number

2 NKEYS(C) I Number of keywords in surface data

3 SURFID I Surface identification number

4 SETID I Set identification number

5 FIBRE I Fibre code for surfaces

6 OCID I Output coordinated system identification number

7 AXIS I Axis code

8 NORMAL I Normal code

9 METH I Method of calculation

10 TOL RS Tolerance

11 MSG I Branch message flag

12 BREAK I Break flag

13 ECID I Element coordinate system usage flag

14 UNDEF(7 ) None

21 UWMREF I Reference message flag

22 GPELREC I Record number of GPEL

23 NELS(C) I Number of elements in surface

24 EID I Element identification numbers in surface

Word 24 repeats NELS times

25 NG(C) I Number of grid points in surface

26 GRID I Grid point identification number (internal)

27 REFID I Reference element identification number

28 NE(C) I No. of elements contributing to stress at this grid

29 ELTYPE I Element type

30 ELID I Element identification number

3-172 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

31 THETA RS Angle stress point flag

32 FLAG I Angle stress point flag

33 FACTOR RS Stress Factor

Words 29 through 33 repeat NE times

Words 26 through 33 repeat NG times

SRFTYP =3 Volume definition

1 VOLID I Volume identification number

2 NKEYS(C) I Number of keywords in volume data

3 VOLIDN I Negative of volume identification number

4 SETID I Set identification number

5 STRESS I Stress code

6 UNDEF(7 ) None

13 ECID I Element coordinate system usage flag

14 UNDEF(8 ) None

22 GPELREC I Record number of GPEL

23 NELS(C) I Number of elements in volume

24 EID I Element identification numbers in volume

Word 24 repeats NELS times

25 NG(C) I Number of grid points in volume

26 GRID I Grid point identification number (internal)

27 REFID I Reference element identification number

28 NE(C) I No. of elements contributing to stress at this grid

29 ELTYPE I Element type

30 ELID I Element identification number

31 TOE(9) RS Element stress output 3x3 trans. matrix

40 FLAG I 10*connectivity+identity flag. See Note 2.

41 FACTOR RS Factor to apply to stress

DMAP Programmer's Guide 3-173


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

Words 29 through 41 repeat NE times

Words 26 through 41 repeat NG times

SRFTYP =–1 End of Data

End SRFTYP

Record 3 – TRAILER
Word Name Type Description

1 NSV I Number of surfaces and volumes

2 UNDEF(5 ) None

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 All (Z1,Z2,MID) (default)

1 Z1 only

2 Z2 only

3 Z1 and Z2

4 MID only

5 Z1 and MID

6 Z2 and MID

7 All

STRESS Stress code for volumes

2 Principal

1 Direct

0 Both

3-174 DMAP Programmer's Guide


Data Block Descriptions A-E

OCID Output coordinate system ID

0 Basic system (default)

>0 User defined coordinate system

AXIS Axis code (surfaces only)

0 X axis (default)

1 Y axis

2 Z axis

NORMAL Normal code (surfaces only)

0 Radius

1 X axis

2 Y axis

3 Z axis

-1 -X axis

-2 -Y axis

-3 -Z axis

10 Radius vector normal

METH Method of calculation (surfaces only)

0 Topological (default)

1 Geometric

MSG Branch message flag (surfaces only)

0 No message (default)

1 Issue messages

BREAK Break flag (surfaces only)

0 No break

1 Break

ECID Element coordinate system usage flag

0 Not used

-1 Used

DMAP Programmer's Guide 3-175


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

4. GPELREC is nonzero if warning messages concerning the reference normal or reference axis
have been issued.

3.23 EGPSTR
Element grid point stress table
Provides grid point stress data for postprocessing.

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – Repeat
See “EGPSF” for a description of surface and volume definition data.

Word Name Type Description

1 SUBVEC I Subcase or vector identification number

2 TSEIG RS Eigenvalue or time step value

3 TYPE(C) I Surface/volume type

4 SVID I Surface/volume identification number

5 NE(C) I Number of elements

6 EID I Element identification numbers

Word 6 repeats NE times

7 NS(C) I Number of words of in surface or volume data

8 DATA I Surface/volume definition data (See note above)

Word 8 repeats NS times

9 NG(C) I Number of grid points

10 GRID I Grid point identification number

11 ELID I Element identification number

TYPE =2 Surface stresses

12 FIBRE CHAR4 Fibre name

13 SX RS Normal x

3-176 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

14 SY RS Normal y

15 TXY RS Shear xy

16 A RS Shear angle

17 SMAJ RS Major principal

18 SMIN RS Minor principal

19 TMAX RS Maximum shear

20 HVM RS Hencky/Von Mises

Words 12 through 20 repeat NF times

TYPE =3 Volume stresses

12 SX RS Normal x

13 SY RS Normal y

14 SZ RS Normal z

15 TXY RS Shear xy

16 TYZ RS Shear yz

17 TZX RS Shear zx

18 MP RS Mean pressure

19 HVM RS Hencky-von Mises

20 SA RS Principal stresses in a-direction

21 SB RS Principal stresses in b-direction

22 SC RS Principal stresses in c-direction

23 LXA RS x-a direction cosine

24 LXB RS x-b direction cosine

25 LXC RS x-c direction cosine

26 LYA RS y-a direction cosine

27 LYB RS y-b direction cosine

28 LYC RS y-c direction cosine

29 LZA RS z-a direction cosine

DMAP Programmer's Guide 3-177


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

30 LZB RS z-b direction cosine

31 LZC RS z-c direction cosine

End TYPE

Words 10 through max repeat NG times

Record 2 – TRAILER
Word Name Type Description

1 UNDEF(6 ) None

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 subcase ID 0.0

Cyclic statics vector ID 0.0

Nonlinear statics subcase ID load factor

Normal Modes vector ID eigenvalue

Buckling vector ID critical load

Transient vector ID 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.24 ELDCT
Element stress discontinuity table

3-178 DMAP Programmer's Guide


Data Block Descriptions A-E

Similar in format to “EGPSTR” .

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – Repeat
See “EGPSF” for a description of surface and volume definition data

Word Name Type Description

1 SUBVEC I Subcase or vector identification number

2 TSEIG RS Eigenvalue or time step value

3 TYPE(C) I Surface/volume type

4 SVID I Surface/volume identification number

5 NS(C) I Number of words of in surface or volume data

6 DATA I Surface/volume definition data (See note


above)

Word 6 repeats NS times

7 NE(C) I Number of elements

8 EID I Element identification number

9 TYPE I Element type

TYPE =2 Surface stress discontinuities

10 FIBRE CHAR4 Fibre name

11 SX RS Normal x

12 SY RS Normal y

13 TXY RS Shear xy

14 A RS Shear angle

15 SMAJ RS Major principal

16 SMIN RS Minor principal

17 TMAX RS Maximum shear

DMAP Programmer's Guide 3-179


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

18 HVM RS Hencky/Von Mises

19 ERR RS Error estimate

Words 10 through 19 repeat NF times

TYPE =3 Volume stresse discontinuities

10 SX RS Normal x

11 SY RS Normal y

12 SZ RS Normal z

13 TXY RS Shear xy

14 TYZ RS Shear yz

15 TZX RS Shear zx

16 MP RS Mean pressure

17 HVM RS Hencky-von Mises

18 SA RS Principal stresses in a-direction

19 SB RS Principal stresses in b-direction

20 SC RS Principal stresses in c-direction

21 ERRN RS Error estimate for normal stress

22 ERRP RS Error estimate for principal stress

End TYPE

Words 8 through max repeat NE times

Record 2 – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

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

3-180 DMAP Programmer's Guide


Data Block Descriptions A-E

• If stress FIBRE=1, 2, or 4, NF=1.

• If stress FIBRE=0, 3, 5, 6, or 7, NF=3.

3.25 EPT
Element property table.

RECORD – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

RECORD – BOLTS(7108,71,251)

Word Name Type Description

1 BID I Bolt identification number

ETYPE=1

2 BMID I Beam identification number

ETYPE=2

2 CID I Bolt direction component number

3 G1 I First grid point defining bolt direction

4 G2 I Second grid point defining bolt direction

5 EID I Solid element identification number

RECORD – MATCID(17006,170,901)
Defines material coordinate system for solid elements.

Word Name Type Description

1 CID I Material coordinate system identification number

2 SPECOPT I Specification option

SPECOPT=1 Select individual element identification numbers

3 EID I Element identification number

Word 3 repeats until -1 occurs

DMAP Programmer's Guide 3-181


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

SPECOPT=2 Select all element identification numbers

3 ALL(2) CHAR4 Keyword for selecting ‘ALL’ option

Words 3 repeats until -1 occurs

SPECOPT=3 Select element identification numbers using a ‘THRU’ range


without the ‘BY’ option

3 EID I Element identification number

4 THRU(2) CHAR4 Keyword for selecting ‘THRU’ option

6 EID I Element identification number

Words 3 through 5 repeat until -1 occurs

SPECOPT=4 Select element identification numbers using a ‘THRU’ range with


the ‘BY’ option

3 EID I Element identification number

4 THRU(2) CHAR4 Keyword for selecting ‘THRU’ option

6 EID I Element identification number

7 BY(2) CHAR4 Keyword for selecting ‘BY’ option

9 N I Element selection increment

Words 3 through 9 repeat until -1 occurs

RECORD – NSM(3201,32,991)
Defines the properties of a nonstructural mass.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ORIGIN I Entry origin

5 ID I Property or element identification number

6 VALUE RS Nonstructural mass value

Words 5 through 6 repeat until End of Record

3-182 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – NSM1(3301,33,992)
Defines the properties of a nonstructural mass.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ORIGIN I Entry origin

5 VALUE RS Nonstructural mass value

6 SPECOPT I Specification option

SPECOPT=1 By IDs

7 ID I

Word 7 repeats until -1 occurs

SPECOPT=2 All

7 ALL(2) CHAR4

Words 7 and 8 repeat until -1 occurs

SPECOPT=3 Thru range

7 ID I

8 THRU(2) CHAR4

10 ID I

Words 7 through 10 repeat until -1 occurs

SPECOPT=4 Thru range with by

7 ID I

8 THRU(2) CHAR4

10 ID I

11 BY(2) CHAR4

13 N I

Words 7 through 13 repeat until -1 occurs

DMAP Programmer's Guide 3-183


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – NSMADD(3401,34,993)
Combines the nonstructural mass inputs.

Word Name Type Description

1 SID I Set identification number

2 ID I Set of properties or elements

Word 2 repeats until End of Record

RECORD – NSML(3501,35,994)
Defines a set of lumped nonstructural mass by ID.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ID I Property of element identification number

5 VALUE RS Lumped nonstructural mass value

Words 4 and 5 repeat until -1 occurs

RECORD – NSML1(3701,37,995)
Alternate form of NSML entry. Defines lumped nonstructural mass entries by VALUE, ID list.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 VALUE RS Lumped nonstructural mass value

5 SPECOPT I Specification option

SPECOPT=1 By IDs

6 ID I Property of element identification number

Word 6 repeats until -1 occurs

SPECOPT=2 All

6 ALL(2) CHAR4 Keyword ALL

3-184 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Words 6 and 7 repeat until -1 occurs

SPECOPT=3 Thru range

6 ID1 I Starting identification number

7 THRU(2) CHAR4 Keyword THRU

9 ID2 I Ending identification number

Words 6 through 9 repeat until -1 occurs

SPECOPT=4 Thru range with by

6 ID1 I Starting identification number

7 THRU(2) CHAR4 Keyword THRU

9 ID2 I Ending identification number

10 BY(2) CHAR4 Keyword BY

12 N I Increment

Words 6 through 12 repeat until -1 occurs

RECORD – PAABSF(1502,15,36)
Defines the properties of a frequency-dependent acoustic absorber

Word Name Type Description

1 PID I Property identification number

2 TZREID I TABLEDi entry identification number for resistance

3 TZMID I TABLEDi entry identification number for reactance

4 S RS Impedance scale factor

5 A RS Area factor when only 1 or 2 grid points are specified

6 B RS Equivalent structural damping

7 K RS Equivalent stiffness

8 RHOC RS Constant used for absorption coefficient

RECORD – PACABS(8300,83,382)
Defines the properties of the acoustic absorber element

DMAP Programmer's Guide 3-185


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

1 PID I Property identification number

2 SYNTH I Request the calculation of B, K, and M

3 TID1 I TABLEDi entry identification number for resistance

4 TID2 I TABLEDi entry identification number for reactance

5 TID3 I TABLEDi entry identification number for weighting


function

6 TESTAR RS Area of the test specimen

7 CUTFR RS Cutoff frequency for tables referenced above

8 B RS Equivalent structural damping values

9 K RS Equivalent structural stiffness

10 M RS Equivalent mass

RECORD – PACBAR(8500,85,384)
Acoustic barrier element.

Word Name Type Description

1 PID I Property identification number

2 MBACK RS Mass per unit area of the backing material

3 MSEPTM RS Mass per unit area of the septum material

4 FRESON RS Resonant frequency of the sandwich construction

5 KRESON RS Resonant stiffness of the sandwich construction

RECORD – PBAR(52,20,181)
Simple beam element.

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

3-186 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

5 I2 RS Area moment of inertia in plane 2

6 J RS Torsional constant

7 NSM RS Nonstructural mass per unit length

8 FE RS

9 C1 RS Stress recovery location at point C in element y-axis

10 C2 RS Stress recovery location at point C in element z-axis

11 D1 RS Stress recovery location at point D in element y-axis

12 D2 RS Stress recovery location at point D in element z-axis

13 E1 RS Stress recovery location at point E in element y-axis

14 E2 RS Stress recovery location at point E in element z-axis

15 F1 RS Stress recovery location at point F in element y-axis

16 F2 RS Stress recovery location at point F in element z-axis

17 K1 RS Area factor for shear in plane 1

18 K2 RS Area factor for shear in plane 2

19 I12 RS Area product of inertia for plane 1 and 2

RECORD – PBARL(9102,91,52)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 GROUP(2) CHAR4 Cross-section group name

5 TYPE(2) CHAR4 Cross section type

7 VALUE RS Cross-section dimensions and NSM

Word 7 repeats until End of Record

DMAP Programmer's Guide 3-187


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PBCOMP(5403,55,349)
Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

5 I2 RS Area moment of inertia in plane 2

6 I12 RS Area product of inertia for plane 1 and 2

7 J RS Torsional constant

8 NSM RS Nonstructural mass per unit length

9 K1 RS Area factor for shear in plane 1

10 K2 RS Area factor for shear in plane 2

11 M1 RS Location center of gravity of nonstructural mass


along y-axis

12 M2 RS Location center of gravity of nonstructural mass


along y-axis

13 N1 RS Location neutral axis along element’s y-axis

14 N2 RS Location neutral axis along element’s y-axis

15 NSECT(C) I Number of lumped areas

Word Name Type Description

NSECT =0

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 UNDEF(3 ) None

Words 16 through 20 repeat 4 times

Word Name Type Description

NSECT =1

16 Y RS Lumped area location along element’s y-axis

3-188 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =2

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =3

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =4

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

DMAP Programmer's Guide 3-189


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =5

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =6

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =7

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

3-190 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =8

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =9

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =10

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

DMAP Programmer's Guide 3-191


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =11

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =12

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =13

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

3-192 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =14

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =15

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =16

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

DMAP Programmer's Guide 3-193


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

NSECT =17

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =18

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =19

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =20

3-194 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

End NSECT

RECORD – PBEAM(5402,54,262)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 NSEGS I Number of segments*

4 CCF I Constant cross-section flag: 1=yes and 0=no

5 X RS

6 SO RS Stress output request

7 XXB RS Distance ratio from end A

8 A RS Area

9 I1 RS Area moment of inertia in plane 1

10 I2 RS Area moment of inertia in plane 2

11 I12 RS Area product of inertia for plane 1 and 2

12 J RS Torsional constant

13 NSM RS Nonstructural mass per unit length

14 C1 RS Stress recovery location at point C in element


y-axis

15 C2 RS Stress recovery location at point C in element


z-axis

DMAP Programmer's Guide 3-195


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

16 D1 RS Stress recovery location at point D in element


y-axis

17 D2 RS Stress recovery location at point D in element


z-axis

18 E1 RS Stress recovery location at point E in element


y-axis

19 E2 RS Stress recovery location at point E in element


z-axis

20 F1 RS Stress recovery location at point F in element y-axis

21 F2 RS Stress recovery location at point F in element z-axis

Words 6 through 21 repeat 11 times

22 K1 RS Area factor for shear in plane 1

23 K2 RS Area factor for shear in plane 2

24 S1 RS Shear relief coefficient due to taper for plane 1

25 S2 RS Shear relief coefficient due to taper for plane 1

26 NSIA RS Nonstructural mass moment of inertia per unit


length at end A

27 NSIB RS Nonstructural mass moment of inertia per unit


length at end B

28 CWA RS Warping coefficient for end A

29 CWB RS Warping coefficient for end B

30 M1A RS Location of C.G. of nonstructural mass at end A


along y-axis

31 M2A RS Location of C.G. of nonstructural mass at end A


along z-axis

32 M1B RS Location of C.G. of nonstructural mass at end B


along y-axis

33 M2B RS Location of C.G. of nonstructural mass at end B


along z-axis

34 N1A RS Location of neutral axis at end A along element’s


y-axis

3-196 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

35 N2A RS Location of neutral axis at end A along element’s


z-axis

36 N1B RS Location of neutral axis at end B along element’s


y-axis

37 N2B RS Location of neutral axis at end B along element’s


z-axis

RECORD – PBEAML(9202,92,53)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 GROUP(2) CHAR4 Cross-section group name

5 TYPE(2) CHAR4 Cross section type

7 VALUE RS Cross section values for XXB, SO, NSM, and


dimensions

Word 7 repeats until (–1) occurs

RECORD – PBEND(2502,25,248)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

5 I2 RS Area moment of inertia in plane 2

6 J RS Torsional constant

7 FSI I Flexibility and stress intensification factors

8 RM RS Mean cross-sectional radius of the curved pipe

9 T RS Wall thickness of the curved pipe

10 P RS Internal pressure

DMAP Programmer's Guide 3-197


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

11 RB RS Bend radius of the line of centroids

12 THETAB RS Arc angle of element

13 C1 RS Stress recovery location at point C in element y-axis

14 C2 RS Stress recovery location at point C in element z-axis

15 D1 RS Stress recovery location at point D in element y-axis

16 D2 RS Stress recovery location at point D in element z-axis

17 E1 RS Stress recovery location at point E in element y-axis

18 E2 RS Stress recovery location at point E in element z-axis

19 F1 RS Stress recovery location at point F in element y-axis

20 F2 RS Stress recovery location at point F in element z-axis

21 K1 RS Area factor for shear in plane 1

22 K2 RS Area factor for shear in plane 2

23 NSM RS Nonstructural mass per unit length

24 RC RS Radial offset of the geometric centroid

25 ZC RS Offset of the geometric centroid

26 DELTAN RS Radial offset of the neutral axis from the geometric


centroid

27 SACL RS Miter spacing at center line.

28 ALPHA RS One-half angle between the adjacent miter axis


(Degrees).

29 FLANGE I For FSI=5, defines the number of flanges attached.

30 KX RS For FSI=6, the user defined flexibility factor for the


torsional moment.

31 KY RS For FSI=6, the user defined flexibility factor for the


out-of-plane bending moment.

32 KZ RS For FSI=6, the user defined flexbility factor for the


in-plane bending moment.

33 Not used

3-198 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

34 SY RS For FSI=6, the user defined stress intensification


factor for the out-of-plane bending.

35 SZ RS For FSI=6, the user defined stress intensification


factor for the in-plane bending.

RECORD – PBUSH(1402,14,37)

Word Name Type Description

1 PID I Property identification number

2 K(6) RS Nominal stiffness values

8 B(6) RS Nominal damping coefficient

14 GE(6) RS Nominal structural damping constant

20 SA RS Stress recovery coefficient in the translational


component

21 ST RS Stress recovery coefficient in the rotational


component

22 EA RS Strain recovery coefficient in the translational


component

23 ET RS Strain recovery coefficient in the rotational


component

RECORD – PBUSH1D(3101,31,219)

Word Name Type Description

1 PID I Property identification number

2 K RS Stiffness

3 C RS Viscous Damping

4 M RS Mass

5 ALPHA RS Temperature coefficient

6 SA RS Stress recovery coefficient

7 EA RS Strain recovery coefficient

8 TYPEA I Shock data type: 0=Null, 1=Table, 2=Equation

DMAP Programmer's Guide 3-199


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 CVT RS Coefficient of translation velocity tension

10 CVC RS Coefficient of translation velocity compression

11 EXPVT RS Exponent of velocity tension

12 EXPVC RS Exponent of velocity compression

13 IDTSU I TABLEDi or DEQATN entry identification number


for scale factor vs displacement

14 IDTCU I DEQATN entry identification number for scale factor


vs displacement

15 IDTSUD I DEQATN entry identification number for derivative


tension

16 IDCSUD I DEQATN entry identification number for derivative


compression

17 TYPES I Spring data type: 0=Null, 1=Table, 2=Equation

18 IDTS I TABLEDi or DEQATN entry identification number


for tension compression

19 IDCS I DEQATN entry identification number for


compression

20 IDTDU I DEQATN entry identification number for scale factor


vs displacement

21 IDCDU I DEQATN entry identification number for force vs


displacement

22 TYPED I Damper data type: 0=Null, 1=Table, 2=Equation

23 IDTD I TABLEDi or DEQATN entry identification number


for tension compression

24 IDTD I DEQATN entry identification number for


compression

25 IDTDV I DEQATN entry identification number for scale factor


versus velocity

26 IDCDV I DEQATN entry identification number for force


versus velocity

27 TYPEG I General data type: 0=Null, 1=Table, 2=Equation

3-200 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

28 IDTG I TABLEDi or DEQATN entry identification number


for tension compression

29 IDCG I DEQATN entry identification number for


compression

30 IDTDU I DEQATN entry identification number for scale factor


versus displacement

31 IDCDU I DEQATN entry identification number for force


versus displacement

32 IDTDV I DEQATN entry identification number for scale factor


versus velocity

33 IDCDV I DEQATN entry identification number for force vs


velocity

34 TYPEF I Fuse data type: 0=Null, 1=Table

35 IDTF I TABLEDi entry identification number for tension

36 IDCF I TABLEDi entry identification number for


compression

37 UT RS Ultimate tension

38 UC RS Ultimate compression

RECORD – PBUSHT(702,7,38)

Word Name Type Description

1 PID I Property identification number

2 TKID(6) I TABLEDi entry identification numbers for stiffness

8 TBID(6) I TABLEDi entry identification numbers for viscous


damping

14 TGEID(6) I TABLEDi entry identification number for structural


damping

20 TKNID(6) I TABLEDi entry IDs for force versus deflection

DMAP Programmer's Guide 3-201


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PCOMP(2706,27,287)

Word Name Type Description

1 PID I Property identification number

2 N(C) I Number of plies

3 Z0 RS Distance from the reference plane to the bottom


surface

4 NSM RS Nonstructural mass per unit area

5 SB RS Allowable shear stress of the bonding material

6 FT I Failure theory

7 TREF RS Reference temperature

8 GE RS Damping coefficient

9 MID I Material identification number

10 T RS Thicknesses of the ply

11 THETA RS Orientation angle of the longitudinal direction of the


ply

12 SOUT I Stress or strain output request of the ply

Words 9 through 12 repeat N times

RECORD – PCOMPG(15006,150,604)

Word Name Type Description

1 PID I Property identification number

2 LAMOPT I Laminate option

3 Z0 RS Distance from the reference plane to the bottom


surface

4 NSM RS Nonstructural mass per unit area

5 SB RS Allowable shear stress of the bonding material

6 FT I Failure theory

7 TREF RS Reference temperature

8 GE RS Damping coefficient

3-202 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

9 GPLYIDi I Global ply IDs.

10 MID I Material identification number

11 T RS Thicknesses of the ply

12 THETA RS Orientation angle of the longitudinal direction of the


ply

13 SOUT I Stress or strain output request of the ply

Words 9 through 13 repeat N times

RECORD – PCOMPS(16006,160,903)
Defines the properties of an n-ply composite material laminate for solid elements.

Word Name Type Description

1 PID I Property identification number

2 CORDM I Material coordinate system identification number

3 PSDIR I Stack and ply directions in the material coordinate


system

4 SB RS Allowable shear stress of the bonding material

5 NB RS Allowable normal stress of the bonding material

6 TREF RS Reference temperature

7 GE RS Damping coefficient

8 UNDEF None

9 GPLYIDi I Global ply identification number

10 MID I Material identification number

11 TR RS Thicknesses of the ply

12 THETA RS Orientation angle of the longitudinal direction of the


ply

13 FT I Failure theory

14 ILFT I Inter-laminar failure theory

15 SOUT I Stress or strain output request of the ply

DMAP Programmer's Guide 3-203


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

16 TFLAG I Flag of ‘ABS’ or ‘REL’

Words 9 through 16 repeat until (-1,-1,-1,-1,-1,-1,-1,-1) occurs

RECORD – PCONEAX(152,19,147)

Word Name Type Description

1 PID I Property identification number

2 MID1 I Material identification number for membrane

3 T1 RS Membrane thickness

4 MID2 I Material identification number for bending

5 I RS Moment of inertia per unit width

6 MID3 I Material identification number for transverse shear

7 T2 RS Transverse shear thickness

8 NSM RS Nonstructural mass per unit area

9 Z1 RS Fiber distance 1 from the middle surface for stress


recovery

10 Z2 RS Fiber distance 2 from the middle surface for stress


recovery

11 PHI RS Azimuthal angle for stress recovery

Word 11 repeats 14 times

RECORD – PCONV(11001,110,411)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 FORM I Type of formula used for free convection

4 EXPF RS Free convection exponent

3-204 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PCONVM(2902,29,420)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 FORM I Type of formula used for free convection

4 FLAG I Flag for mass flow convection

5 COEF RS Constant coefficient used for forced convection

6 EXPR RS Reynolds number convection exponent

7 EXPPI RS Prandtl number convection exponent into the


working fluid

8 EXPPO RS Prandtl number convection exponent out of the


working fluid

RECORD – PDAMP(202,2,45)

Word Name Type Description

1 PID I Property identification number

2 B RS Force per unit velocity

RECORD – PDAMPT(1202,12,33)

Word Name Type Description

1 PID I Property identification number

2 TBID I TABLEDi entry identification number for viscous


damping

RECORD – PDAMP5(8702,87,412)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 B RS Damping multiplier

DMAP Programmer's Guide 3-205


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PDUM1(6102,61,116)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM2(6202,62,117)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM3(6302,63,118)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM4(6402,64,159)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM5(6502,65,160)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM6(6602,66,161)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

3-206 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PDUM7(6702,67,163)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM8(6802,68,164)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM9(6902,69,165)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PELAS(302,3,46)

Word Name Type Description

1 PID I Property identification number

2 K RS Elastic property value

3 GE RS Damping coefficient

4 S RS Stress coefficient

RECORD – PELAST(1302,13,34)

Word Name Type Description

1 PID I Property identification number

2 TKID I TABLEDi entry identification number for stiffness

3 TGEID I TABLEDi entry identification number for structural


damping

4 TKNID I TABLEDi entry identification number for force vs.


deflection

DMAP Programmer's Guide 3-207


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PFAST(3601,36,55)

Word Name Type Description

1 PID I Property identification number

2 D RS Diameter of the spot weld

3 MCID I Element stiffness coordinate system

4 MFLAG I Defines MCID as absolute or relative

5-7 KT(3) RS Translational stiffness

8-10 KR(3) RS Rotational stiffness

11 MASS RS Lumped mass

12 GE RS Structural damping

RECORD – PGAP(2102,21,121)

Word Name Type Description

1 PID I Property identification number

2 UO RS Initial gap opening

3 FO RS Preload

4 KA RS Axial stiffness for the closed gap

5 KB RS Axial stiffness for the open gap

6 KT RS Transverse stiffness when the gap is closed

7 MU1 RS Coefficient of static friction

8 MU2 RS Coefficient of kinetic friction

9 TMAX RS Maximum allowable penetration

10 MAR RS Maximum allowable adjustment ratio

11 TRMIN RS Fraction of TMAX for the lower bound of penetration

RECORD – PGPLSN(4102,41,904)

Word Name Type Description

1 PID I Property identification number

3-208 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 MID I Material identification number

3 CGID I Control grid point identification number

4 T RS Original thickness through control grid point

5–8 UNDEF(4)

9 TYPE I Integer flag indicating the data type for KNR (word
10)
TYPE=0, KNR will be undefined
TYPE=1, KNR will be an integer
TYPE=2, KNR will be a real value

10 KNR I, RS, blank

KNR=INTEGER I TABLE ID for time dependent user specified


stiffness

KNR=REAL RS User specified additive stiffness

Words 9 and 10 repeat 3 times

15 CSOPT I Reserved for coordinate system definition of plane

16 UNDEF

RECORD – PHBDY(2802,28,236)

Word Name Type Description

1 PID I Property identification number

2 AF RS Area factor of the surface

3 D1 RS Diameter 1 associated with the surface

4 D2 RS Diameter 1 associated with the surface

RECORD – PINTC(12001,120,480)

Word Name Type Description

1 PID I Property identification number

2 TOL RS Tolerance between interface elements and


subdomain boundaries

3 DSCALE RS Scaling parameter for Lagrange multiplier functions

DMAP Programmer's Guide 3-209


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 UNDEF(5 ) None

RECORD – PINTS(12101,121,484)

Word Name Type Description

1 PID I Property identification number

2 TOL RS Tolerance between interface elements and


subdomain boundaries

3 DSCALE RS Scaling parameter for Lagrange multiplier functions

4 UNDEF(5 ) None

RECORD – PLPLANE(4606,46,375)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 CID I Coordinate system identification number

4 STR CHAR4 Location of stress and strain output

5 T RS Default membrane thickness for Ti on the


connection entry

6 CSOPT I Reserved for coordinate system definition of plane

7 UNDEF(5) None

RECORD – PLSOLID(4706,47,376)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 STR CHAR4 Location of stress and strain output

4 CSOPT I Reserved for coordinate system definition of plane

5 UNDEF(3) None

3-210 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PMASS(402,4,44)

Word Name Type Description

1 PID I Property identification number

2 M RS Mass

RECORD – PPLANE(3801,38,979)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 T RS Default membrane thickness for Ti on the


connection entry

4 NSM RS Nonstructural mass per unit area

5 FOROPT I Formulation option number

6 CSOPT I Reserved for coordinate system definition of plane

7 UNDEF(2) None

RECORD – PROD(902,9,29)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 J RS Torsional constant

5 C RS Coefficient to determine torsional stress

6 NSM RS Nonstructural mass per unit length

RECORD – PSHEAR(1002,10,42)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

DMAP Programmer's Guide 3-211


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 T RS Thickness o

4 NSM RS Nonstructural mass per unit area.

5 F1 RS Effectiveness factor for stiffness along edges 1-2


and 3-4

6 F2 RS Effectiveness factor for stiffness along edges 2-3


and 1-4

RECORD – PSHELL(2302,23,283)

Word Name Type Description

1 PID I Property identification number

2 MID1 I Material identification number for the membrane

3 T RS Default membrane thickness for Ti on the connection


entry

4 MID2 I Material identification number for bending

5 BK RS Bending moment of inertia ratio

6 MID3 I Material identification number for transverse shear

7 TS RS Transverse shear thickness ratio

8 NSM RS Nonstructural mass per unit area

9 Z1 RS Fiber distance 1 for stress calculation

10 Z2 RS Fiber distance 1 for stress calculation

11 MID4 I Material identification number for membrane-bending


coupling

RECORD – PSHL3D(3901,39,969)

Word Name Type Description

1 PID I Property identification number

2 MID I Identification number of a MAT1, MATPLCY,


MATHP or MATHE entry

3 T RS Default shell thickness

3-212 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

4 WARP CHAR4 Flag for warping rotational degrees of freedom

5 NELPRS I Number of pressure degrees of freedom in the r-s


plane of the element

6 NELPT I Number of pressure degrees of freedom used in


the t-direction of the element

7 TYING CHAR4 Flag indicating whether tying is used

8 UNDEF

RECORD – PSOLID(2402,24,281)
Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 CORDM I Material coordinate system identification number

4 IN I Integration network

5 STRESS I Location selection for stress output

6 ISOP I Integration scheme

7 FCTN CHAR4 Fluid element flag

RECORD – PSOLIDL(7602,76,370)
Word Name Type Description

1 PID I Property identification number

2 FT I

3 TREF RS

4 GE RS

5 NSM RS

6 NLAY I

7 MID I Material identification number

8 T1 RS

DMAP Programmer's Guide 3-213


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 THETA RS

10 SOUT I

Words 7 through 10 repeat 40 times

RECORD – PTRIA6(6202,62,117)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 REAL(4) RS

RECORD – PTUBE(1602,16,30)
This record is slightly unstructured: OD2 is only written out if heat transfer

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 OD RS Outside diameter of tube

4 T RS Thickness of tube

5 NSM RS Nonstructural mass per unit length

6 OD2 RS Heat transfer only: Outside diameter of tube

RECORD – PSET(10301,103,399)

Word Name Type Description

1 ID I p-value set identification number

2 POLY1 I Polynomial order in 1 direction of the CID system

3 POLY2 I Polynomial order in 2 direction of the CID system

4 POLY3 I Polynomial order in 2 direction of the CID system

5 CID I Coordinate system identification number

3-214 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

6 TYPE CHAR4 Type of set provided: "SET" or "ELID"

7 TYPEID I SET identification number or element identification


number with this p-value specification.

Words 1 through 7 repeat until End of Record

RECORD – PVAL(10201,102,400)

Word Name Type Description

1 ID I p-value set identification number

2 POLY1 I Polynomial order in 1 direction of the CID system

3 POLY2 I Polynomial order in 2 direction of the CID system

4 POLY3 I Polynomial order in 2 direction of the CID system

5 CID I Coordinate system identification number

6 TYPE CHAR4 Type of set provided: "SET" or "ELID"

7 TYPEID I SET identification number or element identification


number with this p-value specification.

Words 1 through 7 repeat until End of Record

RECORD – PVISC(1802,18,31)

Word Name Type Description

1 PID I Property identification number

2 CE RS Viscous damping for extension

3 CR RS Viscous damping for rotation

RECORD – PWELD(11801,118,560)

Word Name Type Description

1 PID I Property identification number

2 MID I Material property identification number

3 D RS Diameter of the spot weld

DMAP Programmer's Guide 3-215


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 CONNBEH I Connection behavior (0=FF/F, 1=FR, 10=RF/R,


11=RR)

5 CONNTYPE I Connection type (0=clamp, 1=hinge, 2=bolt)

6 EXTCON I External constraint flag (0=off, 1=on)

7 CONDTYPE I Condition type (0=rigid, 1=equivalent)

8 WELDTYPE I Weld type (0=spot weld, 1=but seam,


2=T-seam)

9 MINLEN RS Minimum length of spot weld

10 MAXLEN RS Maximum length of spot weld

11 GMCHK I Perform geometry check

12 SPCGS I SPC the master grid GS

13 CMASS RS Concentrated mass

14 UNDEF(1) None

RECORD – VIEW(2606,26,289)

Word Name Type Description

1 IVIEW I View identification number

2 ICAVITY I Cavity identification number

3 SHADE I Shadowing flag for the face of CHBDYi element

4 NB I Subelement mesh size in the beta direction

5 NG I Subelement mesh size in the gamma direction

6 DISLIN RS Displacement of a surface perpendicular to the


surface

RECORD – VIEW3D(3002,30,415)

Word Name Type Description

1 ICAVITY I Radiant cavity identification number

2 GITB I Gaussian integration order for third-body


shadowing

3-216 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 GIPS I Gaussian integration order for self-shadowing

4 CIER I Discretization level

5 ETOL RS Error estimate

6 ZTOL RS Zero tolerance

7 WTOL RS Warpage tolerance

8 RADCHK I Radiation exchange diagnostic output level

TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

3.26 EPT705
Element property table (Pre-MSC Nastran 2001).
Note

See the Note 1 for a listing of the differences between EPT705 and EPT.

RECORD – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

RECORD – BOLTS(7108,71,251)

Word Name Type Description

1 BID I Bolt identification number

ETYPE=1

2 BMID I Beam identification number

ETYPE=2

2 CID I Bolt direction component number

3 G1 I First grid point defining bolt direction

DMAP Programmer's Guide 3-217


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 G2 I Second grid point defining bolt direction

5 EID I Solid element identification number

RECORD – NSM(3201,32,991)
Defines the properties of a nonstructural mass.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ORIGIN I Entry origin

5 ID I Property or element identification number

6 VALUE RS Nonstructural mass value

Words 5 through 6 repeat until End of Record

RECORD – NSM1(3301,33,992)
Defines the properties of a nonstructural mass.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ORIGIN I Entry origin

5 VALUE RS Nonstructural mass value

6 SPECOPT I Specification option

SPECOPT=1 By IDs

7 ID I

Word 7 repeats until End of Record

SPECOPT=2 All

7 ALL(2) CHAR4

Words 7 and 8 repeat until End of Record

3-218 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

SPECOPT=3 Thru range

7 ID I

8 THRU(2) CHAR4

10 ID I

Words 7 through 10 repeat until End of Record

SPECOPT=4 Thru range with by

7 ID I

8 THRU(2) CHAR4

10 ID I

11 BY(2) CHAR4

13 N I

Words 7 through 13 repeat until End of Record

End SPECOPT

RECORD – NSMADD(3401,34,993)
Combines the nonstructural mass inputs.

Word Name Type Description

1 SID I Set identification number

2 ID I Set of properties or elements

Word 2 repeats until End of Record

RECORD – NSML(3501,35,994)
Defines a set of lumped nonstructural mass by ID.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 ID I Property of element identification number

DMAP Programmer's Guide 3-219


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

5 VALUE RS Lumped nonstructural mass value

Words 4 and 5 repeat until -1 occurs

RECORD – NSML1(3701,37,995)
Alternate form of NSML entry. Defines lumped nonstructural mass entries by VALUE, ID list.

Word Name Type Description

1 SID I Set identification number

2 PROP(2) CHAR4 Set of properties or elements

4 VALUE RS Lumped nonstructural mass value

5 SPECOPT I Specification option

SPECOPT=1 By IDs

6 ID I Property of element identification number

Word 6 repeats until -1 occurs

SPECOPT=2 All

6 ALL(2) CHAR4 Keyword ALL

Words 6 and 7 repeat until -1 occurs

SPECOPT=3 Thru range

6 ID1 I Starting identification number

7 THRU(2) CHAR4 Keyword THRU

9 ID2 I Ending identification number

Words 6 through 9 repeat until -1 occurs

SPECOPT=4 Thru range with by

6 ID1 I Starting identification number

7 THRU(2) CHAR4 Keyword THRU

9 ID2 I Ending identification number

10 BY(2) CHAR4 Keyword BY

12 N I Increment

3-220 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Words 6 through 12 repeat until -1 occurs

RECORD – PAABSF(1502,15,36)
Defines the properties of a frequency-dependent acoustic absorber

Word Name Type Description

1 PID I Property identification number

2 TZREID I TABLEDi entry identification number for resistance

3 TZMID I TABLEDi entry identification number for reactance

4 S RS Impedance scale factor

5 A RS Area factor when only 1 or 2 grid points are specified

6 B RS Equivalent structural damping

7 K RS Equivalent stiffness

8 RHOC RS Constant used for absorption coefficient

RECORD – PACABS(8300,83,382)
Defines the properties of the acoustic absorber element

Word Name Type Description

1 PID I Property identification number

2 SYNTH I Request the calculation of B, K, and M

3 TID1 I TABLEDi entry identification number for resistance

4 TID2 I TABLEDi entry identification number for reactance

5 TID3 I TABLEDi entry identification number for weighting


function

6 TESTAR RS Area of the test specimen

7 CUTFR RS Cutoff frequency for tables referenced above

8 B RS Equivalent structural damping values

9 K RS Equivalent structural stiffness

10 M RS Equivalent mass

DMAP Programmer's Guide 3-221


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PACBAR(8500,85,384)
Acoustic barrier element.

Word Name Type Description

1 PID I Property identification number

2 MBACK RS Mass per unit area of the backing material

3 MSEPTM RS Mass per unit area of the septum material

4 FRESON RS Resonant frequency of the sandwich construction

5 KRESON RS Resonant stiffness of the sandwich construction

RECORD – PBAR(52,20,181)
Simple beam element.

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

5 I2 RS Area moment of inertia in plane 2

6 J RS Torsional constant

7 NSM RS Nonstructural mass per unit length

8 FE RS

9 C1 RS Stress recovery location at point C in element y-axis

10 C2 RS Stress recovery location at point C in element z-axis

11 D1 RS Stress recovery location at point D in element y-axis

12 D2 RS Stress recovery location at point D in element z-axis

13 E1 RS Stress recovery location at point E in element y-axis

14 E2 RS Stress recovery location at point E in element z-axis

15 F1 RS Stress recovery location at point F in element y-axis

16 F2 RS Stress recovery location at point F in element z-axis

3-222 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

17 K1 RS Area factor for shear in plane 1

18 K2 RS Area factor for shear in plane 2

19 I12 RS Area product of inertia for plane 1 and 2

RECORD – PBARL(9102,91,52)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 GROUP(2) CHAR4 Cross-section group name

5 TYPE(2) CHAR4 Cross section type

7 VALUE RS Cross-section dimensions and NSM

Word 7 repeats until End of Record

RECORD – PBCOMP(5403,55,349)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

5 I2 RS Area moment of inertia in plane 2

6 I12 RS Area product of inertia for plane 1 and 2

7 J RS Torsional constant

8 NSM RS Nonstructural mass per unit length

9 K1 RS Area factor for shear in plane 1

10 K2 RS Area factor for shear in plane 2

11 M1 RS Location center of gravity of nonstructural mass


along y-axis

DMAP Programmer's Guide 3-223


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

12 M2 RS Location center of gravity of nonstructural mass


along y-axis

13 N1 RS Location neutral axis along element’s y-axis

14 N2 RS Location neutral axis along element’s y-axis

15 NSECT(C) I Number of lumped areas

Word Name Type Description

NSECT =0

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 UNDEF(3 ) None

Words 16 through 20 repeat 4 times

Word Name Type Description

NSECT =1

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =2

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

3-224 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =3

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =4

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =5

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

DMAP Programmer's Guide 3-225


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =6

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =7

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =8

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

3-226 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

NSECT =9

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =10

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =11

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =12

DMAP Programmer's Guide 3-227


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =13

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =14

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =15

16 Y RS Lumped area location along element’s y-axis

3-228 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =16

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =17

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =18

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

DMAP Programmer's Guide 3-229


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =19

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

Word Name Type Description

NSECT =20

16 Y RS Lumped area location along element’s y-axis

17 Z RS Lumped area location along element’s z-axis

18 C RS Fraction of the total area for the lumped area

19 MID I Material identification number

20 UNDEF None

Words 16 through 20 repeat NSECT times

End NSECT

RECORD – PBEAM(5402,54,262)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3-230 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

3 NSEGS I Number of segments*

4 CCF I Constant cross-section flag: 1=yes and 0=no

5 X RS

6 SO RS Stress output request

7 XXB RS Distance ratio from end A

8 A RS Area

9 I1 RS Area moment of inertia in plane 1

10 I2 RS Area moment of inertia in plane 2

11 I12 RS Area product of inertia for plane 1 and 2

12 J RS Torsional constant

13 NSM RS Nonstructural mass per unit length

14 C1 RS Stress recovery location at point C in element


y-axis

15 C2 RS Stress recovery location at point C in element


z-axis

16 D1 RS Stress recovery location at point D in element


y-axis

17 D2 RS Stress recovery location at point D in element


z-axis

18 E1 RS Stress recovery location at point E in element


y-axis

19 E2 RS Stress recovery location at point E in element


z-axis

20 F1 RS Stress recovery location at point F in element y-axis

21 F2 RS Stress recovery location at point F in element z-axis

Words 6 through 21 repeat 11 times

22 K1 RS Area factor for shear in plane 1

23 K2 RS Area factor for shear in plane 2

24 S1 RS Shear relief coefficient due to taper for plane 1

DMAP Programmer's Guide 3-231


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

25 S2 RS Shear relief coefficient due to taper for plane 1

26 NSIA RS Nonstructural mass moment of inertia per unit


length at end A

27 NSIB RS Nonstructural mass moment of inertia per unit


length at end B

28 CWA RS Warping coefficient for end A

29 CWB RS Warping coefficient for end B

30 M1A RS Location of C.G. of nonstructural mass at end A


along y-axis

31 M2A RS Location of C.G. of nonstructural mass at end A


along z-axis

32 M1B RS Location of C.G. of nonstructural mass at end B


along y-axis

33 M2B RS Location of C.G. of nonstructural mass at end B


along z-axis

34 N1A RS Location of neutral axis at end A along element’s


y-axis

35 N2A RS Location of neutral axis at end A along element’s


z-axis

36 N1B RS Location of neutral axis at end B along element’s


y-axis

37 N2B RS Location of neutral axis at end B along element’s


z-axis

RECORD – PBEAML(9202,92,53)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 GROUP(2) CHAR4 Cross-section group name

5 TYPE(2) CHAR4 Cross section type

7 VALUE RS Cross section values for XXB, SO, NSM, and


dimensions

3-232 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Word 7 repeats until (–1) occurs

RECORD – PBEND(2502,25,248)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 I1 RS Area moment of inertia in plane 1

5 I2 RS Area moment of inertia in plane 2

6 J RS Torsional constant

7 FSI I Flexibility and stress intensification factors

8 RM RS Mean cross-sectional radius of the curved pipe

9 T RS Wall thickness of the curved pipe

10 P RS Internal pressure

11 RB RS Bend radius of the line of centroids

12 THETAB RS Arc angle of element

13 C1 RS Stress recovery location at point C in element y-axis

14 C2 RS Stress recovery location at point C in element z-axis

15 D1 RS Stress recovery location at point D in element y-axis

16 D2 RS Stress recovery location at point D in element z-axis

17 E1 RS Stress recovery location at point E in element y-axis

18 E2 RS Stress recovery location at point E in element z-axis

19 F1 RS Stress recovery location at point F in element y-axis

20 F2 RS Stress recovery location at point F in element z-axis

21 K1 RS Area factor for shear in plane 1

22 K2 RS Area factor for shear in plane 2

23 NSM RS Nonstructural mass per unit length

DMAP Programmer's Guide 3-233


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

24 RC RS Radial offset of the geometric centroid

25 ZC RS Offset of the geometric centroid

26 DELTAN RS Radial offset of the neutral axis from the geometric


centroid

RECORD – PBUSH(1402,14,37)

Word Name Type Description

1 PID I Property identification number

2 K(6) RS Nominal stiffness values

8 B(6) RS Nominal damping coefficient

14 GE RS Nominal structural damping constant

15 SA RS Stress recovery coefficient in the translational


component

16 ST RS Stress recovery coefficient in the rotational


component

17 EA RS Strain recovery coefficient in the translational


component

18 ET RS Strain recovery coefficient in the rotational


component

RECORD – PBUSH1D(3101,31,219)

Word Name Type Description

1 PID I Property identification number

2 K RS Stiffness

3 C RS Viscous Damping

4 M RS Mass

5 ALPHA RS Temperature coefficient

6 SA RS Stress recovery coefficient

7 EA RS Strain recovery coefficient

3-234 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 TYPEA I Shock data type: 0=Null, 1=Table, 2=Equation

9 CVT RS Coefficient of translation velocity tension

10 CVC RS Coefficient of translation velocity compression

11 EXPVT RS Exponent of velocity tension

12 EXPVC RS Exponent of velocity compression

13 IDTSU I TABLEDi or DEQATN entry identification number


for scale factor vs displacement

14 IDTCU I DEQATN entry identification number for scale factor


vs displacement

15 IDTSUD I DEQATN entry identification number for derivative


tension

16 IDCSUD I DEQATN entry identification number for derivative


compression

17 TYPES I Spring data type: 0=Null, 1=Table, 2=Equation

18 IDTS I TABLEDi or DEQATN entry identification number


for tension compression

19 IDCS I DEQATN entry identification number for


compression

20 IDTDU I DEQATN entry identification number for scale factor


vs displacement

21 IDCDU I DEQATN entry identification number for force vs


displacement

22 TYPED I Damper data type: 0=Null, 1=Table, 2=Equation

23 IDTD I TABLEDi or DEQATN entry identification number


for tension compression

24 IDTD I DEQATN entry identification number for


compression

25 IDTDV I DEQATN entry identification number for scale factor


versus velocity

26 IDCDV I DEQATN entry identification number for force


versus velocity

27 TYPEG I General data type: 0=Null, 1=Table, 2=Equation

DMAP Programmer's Guide 3-235


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

28 IDTG I TABLEDi or DEQATN entry identification number


for tension compression

29 IDCG I DEQATN entry identification number for


compression

30 IDTDU I DEQATN entry identification number for scale factor


versus displacement

31 IDCDU I DEQATN entry identification number for force


versus displacement

32 IDTDV I DEQATN entry identification number for scale factor


versus velocity

33 IDCDV I DEQATN entry identification number for force vs


velocity

34 TYPEF I Fuse data type: 0=Null, 1=Table

35 IDTF I TABLEDi entry identification number for tension

36 IDCF I TABLEDi entry identification number for


compression

37 UT RS Ultimate tension

38 UC RS Ultimate compression

RECORD – PBUSHT(702,7,38)

Word Name Type Description

1 PID I Property identification number

2 TKID(6) I TABLEDi entry identification numbers for stiffness

8 TBID(6) I TABLEDi entry identification numbers for viscous


damping

14 TGEID I TABLEDi entry identification number for structural


damping

15 TKNID(6) I TABLEDi entry IDs for force versus deflection

3-236 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PCOMP(2706,27,287)

Word Name Type Description

1 PID I Property identification number

2 N(C) I Number of plies

3 Z0 RS Distance from the reference plane to the bottom


surface

4 NSM RS Nonstructural mass per unit area

5 SB RS Allowable shear stress of the bonding material

6 FT I Failure theory

7 TREF RS Reference temperature

8 GE RS Damping coefficient

9 MID I Material identification number

10 T RS Thicknesses of the ply

11 THETA RS Orientation angle of the longitudinal direction of the


ply

12 SOUT I Stress or strain output request of the ply

Words 9 through 12 repeat N times

RECORD – PCOMPG(15006,150,604)

Word Name Type Description

1 PID I Property identification number

2 LAMOPT I Laminate option

3 Z0 RS Distance from the reference plane to the bottom


surface

4 NSM RS Nonstructural mass per unit area

5 SB RS Allowable shear stress of the bonding material

6 FT I Failure theory

7 TREF RS Reference temperature

8 GE RS Damping coefficient

DMAP Programmer's Guide 3-237


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

9 GPLYIDi I Global ply IDs.

10 MID I Material identification number

11 T RS Thicknesses of the ply

12 THETA RS Orientation angle of the longitudinal direction of the


ply

13 SOUT I Stress or strain output request of the ply

Words 9 through 13 repeat N times

RECORD – PCONEAX(152,19,147)

Word Name Type Description

1 PID I Property identification number

2 MID1 I Material identification number for membrane

3 T1 RS Membrane thickness

4 MID2 I Material identification number for bending

5 I RS Moment of inertia per unit width

6 MID3 I Material identification number for transverse shear

7 T2 RS Transverse shear thickness

8 NSM RS Nonstructural mass per unit area

9 Z1 RS Fiber distance 1 from the middle surface for stress


recovery

10 Z2 RS Fiber distance 2 from the middle surface for stress


recovery

11 PHI RS Azimuthal angle for stress recovery

Word 11 repeats 14 times

RECORD – PCONV(11001,110,411)

Word Name Type Description

1 PID I Property identification number

3-238 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 MID I Material identification number

3 FORM I Type of formula used for free convection

4 EXPF RS Free convection exponent

RECORD – PCONVM(2902,29,420)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 FORM I Type of formula used for free convection

4 FLAG I Flag for mass flow convection

5 COEF RS Constant coefficient used for forced convection

6 EXPR RS Reynolds number convection exponent

7 EXPPI RS Prandtl number convection exponent into the


working fluid

8 EXPPO RS Prandtl number convection exponent out of the


working fluid

RECORD – PDAMP(202,2,45)

Word Name Type Description

1 PID I Property identification number

2 B RS Force per unit velocity

RECORD – PDAMPT(1202,12,33)

Word Name Type Description

1 PID I Property identification number

2 TBID I TABLEDi entry identification number for viscous


damping

DMAP Programmer's Guide 3-239


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PDAMP5(8702,87,412)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 B RS Damping multiplier

RECORD – PDUM1(6102,61,116)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM2(6202,62,117)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM3(6302,63,118)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM4(6402,64,159)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM5(6502,65,160)

Word Name Type Description

1 UNDEF None

3-240 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Word 1 repeats until End of Record

RECORD – PDUM6(6602,66,161)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM7(6702,67,163)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM8(6802,68,164)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PDUM9(6902,69,165)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – PELAS(302,3,46)

Word Name Type Description

1 PID I Property identification number

2 K RS Elastic property value

3 GE RS Damping coefficient

4 S RS Stress coefficient

DMAP Programmer's Guide 3-241


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PELAST(1302,13,34)

Word Name Type Description

1 PID I Property identification number

2 TKID I TABLEDi entry identification number for stiffness

3 TGEID I TABLEDi entry identification number for structural


damping

4 TKNID I TABLEDi entry identification number for force vs.


deflection

RECORD – PFAST(3601,36,55)

Word Name Type Description

1 PID I Property identification number

2 D RS Diameter of the spot weld

3 MCID I Element stiffness coordinate system

4 MFLAG I Defines MCID as absolute or relative

5-7 KT(3) RS Translational stiffness

8-10 KR(3) RS Rotational stiffness

11 MASS RS Lumped mass

12 GE RS Structural damping

RECORD – PGAP(2102,21,121)

Word Name Type Description

1 PID I Property identification number

2 UO RS Initial gap opening

3 FO RS Preload

4 KA RS Axial stiffness for the closed gap

5 KB RS Axial stiffness for the open gap

6 KT RS Transverse stiffness when the gap is closed

7 MU1 RS Coefficient of static friction

3-242 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

8 MU2 RS Coefficient of kinetic friction

9 TMAX RS Maximum allowable penetration

10 MAR RS Maximum allowable adjustment ratio

11 TRMIN RS Fraction of TMAX for the lower bound of penetration

RECORD – PGPLSN(4102,41,904)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 CGID I Control grid point identification number

4 T RS Original thickness through control grid point

5–8 UNDEF(4)

9 TYPE I Integer flag indicating the data type for KNR (word
10)
TYPE=0, KNR will be undefined
TYPE=1, KNR will be an integer
TYPE=2, KNR will be a real value

10 KNR I, RS, blank

KNR=INTEGER I TABLE ID for time dependent user specified


stiffness

KNR=REAL RS User specified additive stiffness

Words 9 and 10 repeat 3 times

15 CSOPT I Reserved for coordinate system definition of plane

16 UNDEF

RECORD – PHBDY(2802,28,236)

Word Name Type Description

1 PID I Property identification number

2 AF RS Area factor of the surface

DMAP Programmer's Guide 3-243


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 D1 RS Diameter 1 associated with the surface

4 D2 RS Diameter 1 associated with the surface

RECORD – PINTC(12001,120,480)

Word Name Type Description

1 PID I Property identification number

2 TOL RS Tolerance between interface elements and


subdomain boundaries

3 DSCALE RS Scaling parameter for Lagrange multiplier functions

4 UNDEF(5 ) None

RECORD – PINTS(12101,121,484)

Word Name Type Description

1 PID I Property identification number

2 TOL RS Tolerance between interface elements and


subdomain boundaries

3 DSCALE RS Scaling parameter for Lagrange multiplier functions

4 UNDEF(5 ) None

RECORD – PLPLANE(4606,46,375)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 CID I Coordinate system identification number

4 STR CHAR4 Location of stress and strain output

5 T RS Default membrane thickness for Ti on the


connection entry

6 UNDEF(6) None

3-244 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PLSOLID(4706,47,376)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 STR CHAR4 Location of stress and strain output

4 UNDEF(4 ) None

RECORD – PMASS(402,4,44)

Word Name Type Description

1 PID I Property identification number

2 M RS Mass

RECORD – PPLANE(3801,38,979)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 T RS Default membrane thickness for Ti on the


connection entry

4 NSM RS Nonstructural mass per unit area

5 FOROPT I Formulation option number

6 UNDEF(3) None

RECORD – PROD(902,9,29)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 A RS Area

4 J RS Torsional constant

5 C RS Coefficient to determine torsional stress

DMAP Programmer's Guide 3-245


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

6 NSM RS Nonstructural mass per unit length

RECORD – PSHEAR(1002,10,42)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 T RS Thickness o

4 NSM RS Nonstructural mass per unit area.

5 F1 RS Effectiveness factor for stiffness along edges 1-2


and 3-4

6 F2 RS Effectiveness factor for stiffness along edges 2-3


and 1-4

RECORD – PSHELL(2302,23,283)

Word Name Type Description

1 PID I Property identification number

2 MID1 I Material identification number for the membrane

3 T RS Default membrane thickness for Ti on the connection


entry

4 MID2 I Material identification number for bending

5 BK RS Bending moment of inertia ratio

6 MID3 I Material identification number for transverse shear

7 TS RS Transverse shear thickness ratio

8 NSM RS Nonstructural mass per unit area

9 Z1 RS Fiber distance 1 for stress calculation

10 Z2 RS Fiber distance 1 for stress calculation

11 MID4 I Material identification number for membrane-bending


coupling

3-246 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PSHL3D(3901,39,969)

Word Name Type Description

1 PID I Property identification number

2 MID I Identification number of a MAT1, MATPLCY,


MATHP or MATHE entry

3 T RS Default shell thickness

4 WARP CHAR4 Flag for warping rotational degrees of freedom

5 NELPRS I Number of pressure degrees of freedom in the r-s


plane of the element

6 NELPT I Number of pressure degrees of freedom used in


the t-direction of the element

7 TYING CHAR4 Flag indicating whether tying is used

8 UNDEF

RECORD – PSOLID(2402,24,281)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 CORDM I Material coordinate system identification number

4 IN I Integration network

5 STRESS I Location selection for stress output

6 ISOP I Integration scheme

7 FCTN CHAR4 Fluid element flag

RECORD – PSOLIDL(7602,76,370)

Word Name Type Description

1 PID I Property identification number

2 FT I

3 TREF RS

DMAP Programmer's Guide 3-247


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

4 GE RS

5 NSM RS

6 NLAY I

7 MID I Material identification number

8 T1 RS

9 THETA RS

10 SOUT I

Words 7 through 10 repeat 40 times

RECORD – PTRIA6(6202,62,117)

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 REAL(4) RS

RECORD – PTUBE(1602,16,30)
This record is slightly unstructured: OD2 is only written out if heat transfer

Word Name Type Description

1 PID I Property identification number

2 MID I Material identification number

3 OD RS Outside diameter of tube

4 T RS Thickness of tube

5 NSM RS Nonstructural mass per unit length

6 OD2 RS Heat transfer only: Outside diameter of tube

3-248 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – PSET(10301,103,399)

Word Name Type Description

1 ID I p-value set identification number

2 POLY1 I Polynomial order in 1 direction of the CID system

3 POLY2 I Polynomial order in 2 direction of the CID system

4 POLY3 I Polynomial order in 2 direction of the CID system

5 CID I Coordinate system identification number

6 TYPE CHAR4 Type of set provided: "SET" or "ELID"

7 TYPEID I SET identification number or element identification


number with this p-value specification.

Words 1 through 7 repeat until End of Record

RECORD – PVAL(10201,102,400)

Word Name Type Description

1 ID I p-value set identification number

2 POLY1 I Polynomial order in 1 direction of the CID system

3 POLY2 I Polynomial order in 2 direction of the CID system

4 POLY3 I Polynomial order in 2 direction of the CID system

5 CID I Coordinate system identification number

6 TYPE CHAR4 Type of set provided: "SET" or "ELID"

7 TYPEID I SET identification number or element identification


number with this p-value specification.

Words 1 through 7 repeat until End of Record

RECORD – PVISC(1802,18,31)

Word Name Type Description

1 PID I Property identification number

2 CE RS Viscous damping for extension

3 CR RS Viscous damping for rotation

DMAP Programmer's Guide 3-249


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

RECORD – PWELD(11801,118,560)

Word Name Type Description

1 PID I Property identification number

2 MID I Material property identification number

3 D RS Diameter of the spot weld

4 CONNBEH I Connection behavior (0=FF/F, 1=FR, 10=RF/R,


11=RR)

5 CONNTYPE I Connection type (0=clamp, 1=hinge, 2=bolt)

6 EXTCON I External constraint flag (0=off, 1=on)

7 CONDTYPE I Condition type (0=rigid, 1=equivalent)

8 WELDTYPE I Weld type (0=spot weld, 1=but seam,


2=T-seam)

9 MINLEN RS Minimum length of spot weld

10 MAXLEN RS Maximum length of spot weld

11 GMCHK I Perform geometry check

12 SPCGS I SPC the master grid GS

13 CMASS RS Concentrated mass

14 UNDEF(1) None

RECORD – VIEW(2606,26,289)

Word Name Type Description

1 IVIEW I View identification number

2 ICAVITY I Cavity identification number

3 SHADE I Shadowing flag for the face of CHBDYi element

4 NB I Subelement mesh size in the beta direction

5 NG I Subelement mesh size in the gamma direction

6 DISLIN RS Displacement of a surface perpendicular to the


surface

3-250 DMAP Programmer's Guide


Data Block Descriptions A-E

RECORD – VIEW3D(3002,30,415)

Word Name Type Description

1 ICAVITY I Radiant cavity identification number

2 GITB I Gaussian integration order for third-body


shadowing

3 GIPS I Gaussian integration order for self-shadowing

4 CIER I Discretization level

5 ETOL RS Error estimate

6 ZTOL RS Zero tolerance

7 WTOL RS Warpage tolerance

8 RADCHK I Radiation exchange diagnostic output level

TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

Notes:
1. EPT705 is the same as EPT except that:
• SACL, ALPHA, FLANGE, KX, KY, KZ, undefined word 33, SY, and SZ are stripped from
RECORD - PBEND. The record size is reduced from 35 words to 26 words.

• Five GE entries are stripped from RECORD - PBUSH. The record size is reduced from 23
words to 18 words.

• Five TGEID entries are stripped from RECORD - PBUSHT. The record size is reduced
from 20 words to 15 words.

RECORD – PCOMPS(16006,160,903)
Defines the properties of an n-ply composite material laminate for solid elements.

Word Name Type Description

1 PID I Property identification number

2 CORDM I Material coordinate system identification number

DMAP Programmer's Guide 3-251


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Word Name Type Description

3 PSDIR I Stack and ply directions in the material coordinate


system

4 SB RS Allowable shear stress of the bonding material

5 NB RS Allowable normal stress of the bonding material

6 TREF RS Reference temperature

7 GE RS Damping coefficient

8 UNDEF None

9 GPLYIDi I Global ply identification number

10 MID I Material identification number

11 TR RS Thicknesses of the ply

12 THETA RS Orientation angle of the longitudinal direction of the


ply

13 FT I Failure theory

14 ILFT I Inter-laminar failure theory

15 SOUT I Stress or strain output request of the ply

16 TFLAG I Flag of ‘ABS’ or ‘REL’

Words 9 through 16 repeat until (-1,-1,-1,-1,-1,-1,-1,-1) occurs

RECORD – MATCID(17006,170,901)
Defines material coordinate system for solid elements.

Word Name Type Description

1 CID I Material coordinate system identification number

2 SPECOPT I Specification option

SPECOPT=1 Select individual element identification numbers

3 EID I Element identification number

Word 3 repeats until -1 occurs

SPECOPT=2 Select all element identification numbers

3 ALL(2) CHAR4 Keyword for selecting ‘ALL’ option

3-252 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

Words 3 repeats until -1 occurs

SPECOPT=3 Select element identification numbers using a ‘THRU’ range


without the ‘BY’ option

3 EID I Element identification number

4 THRU(2) CHAR4 Keyword for selecting ‘THRU’ option

6 EID I Element identification number

Words 3 through 5 repeat until -1 occurs

SPECOPT=4 Select element identification numbers using a ‘THRU’ range with


the ‘BY’ option

3 EID I Element identification number

4 THRU(2) CHAR4 Keyword for selecting ‘THRU’ option

6 EID I Element identification number

7 BY(2) CHAR4 Keyword for selecting ‘BY’ option

9 N I Element selection increment

Words 3 through 9 repeat until -1 occurs

3.27 EQEXIN
Equivalence between external and internal grid/scalar numbers

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – EXT2INT
Contains pairs of external grid and scalar identification numbers and internal numbers in external sort.

Word Name Type Description

1 GRIDID I External grid or scalar identification number

2 INTID I Internal identification number

DMAP Programmer's Guide 3-253


Chapter
Chapter 3: 3: Data Data
BlockBlock Descriptions
Descriptions A-E A-E

Record 2 – EXT2SIL
Contains pairs of external grid and scalar numbers and coded SIL numbers in external sort.

Word Name Type Description

1 GRIDID I External grid or scalar identification number

2 TENXSIL I 10*SIL number + code (See Note)

Record 3 – TRAILER
Word Name Type Description

1 NGS I Total number of grid scalar points

2 UNDEF(5 ) None

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 for grid point

2 for scalar point

3 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.28 ERROR
Table of p-element error tolerances

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

Record 1 – ERROR
Word Name Type Description

1 EID I Element identification number

3-254 DMAP Programmer's Guide


Data Block Descriptions A-E

Word Name Type Description

2 ERRMAX RS Accumulated Maximum error for all subcases

3 P(3) I Polynomial order in x,y,z directions

6 ERRCAS RS Calculated error for current subcase

7 WHYCAS I Why an element is excluded from error analysis

8 WHYALL I Accumulation over all subcases of previous item

Words 1 through 8 repeat until End of Record

Record 2 – TRAILER

Word Name Type Description

1 NWERRN I Used by OFPVUI subroutine

2 ERRPRN I Accumulates error print requests

3 PVALDV I Accumulates PVAL card print/punch requests.

4 ILOOP I To check with current ILOOP for new adaptivity


loop

5 PVALID I To be used as old PVAL identification number.


Updated only when SEID=0

6 UNDEF None

Notes:
WHYCAS is composed of bits for internal use only. Bits include values for
ERRTOL,SIGTOL,EPSTOL,ERRGRD,ERRELM

3.29 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 format of the EPT data block which contributes to EST is included. The format
of EST can be viewed by opening est.ddl in a text editor: install_path\nxnr\nast\del\est.ddl.

DMAP Programmer's Guide 3-255


Chapter 4: Data Block Descriptions F-M

4.1 FOL
Frequency response frequency output list

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 FREQ RS Frequency

Word 3 repeats until End of Record

Record 1 – TRAILER
Word Name Type Description

1 WORD1 I Number of frequencies

2 WORD2 I Frequency set record number

3 WORD3 I Number of loads

4 UNDEF(3 ) None

4.2 GEOM1
Table of Bulk Data entry images related to geometry.

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – CORD1C(1701,17,6)
Word Name Type Description

1 CID I Coordinate system identification number

DMAP Programmer's Guide 4-1


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 TWO I Constant 2

3 ONE I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD1R(1801,18,5)

Word Name Type Description

1 CID I Coordinate system identification number

2 ONE1 I Constant 1

3 ONE2 I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD1S(1901,19,7)

Word Name Type Description

1 CID I Coordinate system identification number

2 THREE I Constant 3

3 ONE I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD2C(2001,20,9)

Word Name Type Description

1 CID I Coordinate system identification number

4-2 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 TWO1 I Constant 2

3 TWO2 I Constant 2

4 RID I Reference coordinate system identification


number

5 A1 RX Location of A in coordinate 1 of RID

6 A2 RX Location of A in coordinate 2 of RID

7 A3 RX Location of A in coordinate 3 of RID

8 B1 RX Location of B in coordinate 1 of RID

9 B2 RX Location of B in coordinate 2 of RID

10 B3 RX Location of B in coordinate 3 of RID

11 C1 RX Location of C in coordinate 1 of RID

12 C2 RX Location of C in coordinate 2 of RID

13 C3 RX Location of C in coordinate 3 of RID

Record – CORD2R(2101,21,8)

Word Name Type Description

1 CID I Coordinate system identification number

2 ONE I Constant 1

3 TWO I Constant 2

4 RID I Reference coordinate system identification


number

5 A1 RX Location of A in coordinate 1 of RID

6 A2 RX Location of A in coordinate 2 of RID

7 A3 RX Location of A in coordinate 3 of RID

8 B1 RX Location of B in coordinate 1 of RID

9 B2 RX Location of B in coordinate 2 of RID

10 B3 RX Location of B in coordinate 3 of RID

11 C1 RX Location of C in coordinate 1 of RID

DMAP Programmer's Guide 4-3


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

12 C2 RX Location of C in coordinate 2 of RID

13 C3 RX Location of C in coordinate 3 of RID

Record – CORD2S(2201,22,10)

Word Name Type Description

1 CID I Coordinate system identification number

2 SIXTY5 I Constant 65 or 3?

3 EIGHT I Constant 8 or 2?

4 RID I Reference coordinate system identification number

5 A1 RX Location of A in coordinate 1 of RID

6 A2 RX Location of A in coordinate 2 of RID

7 A3 RX Location of A in coordinate 3 of RID

8 B1 RX Location of B in coordinate 1 of RID

9 B2 RX Location of B in coordinate 2 of RID

10 B3 RX Location of B in coordinate 3 of RID

11 C1 RX Location of C in coordinate 1 of RID

12 C2 RX Location of C in coordinate 2 of RID

13 C3 RX Location of C in coordinate 3 of RID

Record – CORD3G(501,5,43)

Word Name Type Description

1 CID I Coordinate system identification number

2 METHOD(2) CHAR4 Methods

4 FORM(2) CHAR4 Forms

6 THETAID(3) I Identification number for DEQATN or TABLE

9 CIDREF I Coordinate system identification number

4-4 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – CORD3R(14301,143,651)

Word Name Type Description

1 CID I Coordinate system identification number

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CSUPER(2301,23,304)

Word Name Type Description

1 SSID I Coded identification number for secondary


superelement

2 PSID I Primary superelement identification number

3 G I Exterior grid or scalar point identificaiton numbers

Word 3 repeats until End of Record

Record – CSUPER1(5701,57,323)
This record is obsolete.

Word Name Type Description

1 SEID I Superelement identification number

2 PSID I Primary superelement identification number

3 TYPE I ,{

4 VIEW I ,{

5 DIROPT I ,{

6 DIRTOL RS ,{

7 GEOMTOL RS ,{

8 CARDID I ,{

9 MODEL I ,{

10 SOLID I ,{

11 DBSET I ,{

DMAP Programmer's Guide 4-5


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

12 COPY I ,{

13 DELETE I ,{

14 GRIDLIST I ,{

15 XX I xx

XX =0 xx

16 G I ,{

17 C I ,{

Words 16 through 17 repeat until (-1,-1,-1) occurs

XX =–1 yy

End XX

Record – CSUPEXT(5501,55,297)

Word Name Type Description

1 SEID I Superelement identification number

2 G I Grid or scalar point IDs in the downstream


superelement

Word 2 repeats until End of Record

Record – CSUPUP(5801,58,324)

This record is obsolete.

Word Name Type Description

1 SEUP1 I ,{

2 PSID I Primary superelement identification number

3 SEDOWN1 I ,{

4 SEUP2 I ,{

5 PSID I Primary superelement identification number

6 SEDOWN2 I ,{

4-6 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – EXTRN(1627,16,463)

Word Name Type Description

1 GID I Grid point identification numbers to connect external


SE

2 C I Component numbers

Words 1 through 2 repeat until (-1,-1) occurs

Record – FEEDGE(6101,61,388)

Word Name Type Description

1 EDGEID I Edge identification number

2 GRID1 I Identification number of end GRID 1

3 GRID2 I Identification number of end GRID 2

4 CID I Coordinate system identification number

5 GEOMIN CHAR4 Type of referencing entry: "GMCURV" or "POINT"

6 GEOMID1 I Identification number of a POINT or GMCURV


entry

7 GEOMID2 I Identification number of a POINT or GMCURV


entry

Record – FEFACE(6201,62,389)

Word Name Type Description

1 FACEID I Face identification number

2 GRID1 I Identification number of end GRID 1

3 GRID2 I Identification number of end GRID 2

4 GRID3 I Identification number of end GRID 3

5 GRID4 I Identification number of end GRID 4

6 CIDBC I Coordinate system identification number for the


constraints

7 SURFID(2) I Alternate method used to specify the geometry

DMAP Programmer's Guide 4-7


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – GMCORD(6401,64,402)

Word Name Type Description

1 CID I Coordinate system identification number

2 ENTITY CHAR4 Bulk Data entry used to define the coordinate


system

3 ID1 I Entity identification number 1

4 ID2 I Entity identification number 2

Record – GMCURV(6601,66,392)

Word Name Type Description

1 CURVID I Curve identification number

2 GROUP(2) CHAR4 Group of curves/surfaces to which this curve


belongs

4 CIDIN I Coordinate system identification number for the


geometry

5 CIDBC I Coordinate system identification number for the


constraints

6 DATA CHAR4 Geometry evaluator specific data

Word 6 repeats until End of Record

Record – GMSURF(10101,101,394)

Word Name Type Description

1 ID I Surface Identification number

2 GROUP(2) CHAR4 Group of curves/surfaces to which this curve


belongs

4 CIDIN I Coordinate system identification number for the


geometry

5 CIDBC I Coordinate system identification number for the


constraints

6 DATA CHAR4 Geometry evaluator specific data

Word 6 repeats until End of Record

4-8 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – GRID(4501,45,1)

Word Name Type Description

1 ID I Grid point identification number

2 CP I Location coordinate system identification number

3 X1 RX Location of the point in coordinate 1 of CP

4 X2 RX Location of the point in coordinate 2 of CP

5 X3 RX Location of the point in coordinate 3 of CP

6 CD I Degree-of-freedom coordinate system identification


number

7 PS I Permanent single-point constraints

8 SEID I Superelement identification number

Record – POINT(6001,60,377)

Word Name Type Description

1 ID I Point identification number

2 CID I Coordinate system identification number

3 X1 RX Location of the point in coordinate 1 of CID

4 X2 RX Location of the point in coordinate 2 of CID

5 X3 RX Location of the point in coordinate 3 of CID

Record – SEBNDRY(1527,15,466)

Word Name Type Description

1 SEIDA I Superelement A identification number

2 SEIDB I Superelement B identification number

3 G I Boundary grid point identification number in SEIDA

Word 3 repeats until End of Record

DMAP Programmer's Guide 4-9


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – SEBULK(1427,14,465)

Word Name Type Description

1 SEID I Superelement identification number

2 TYPE I Superelement type

3 RSEID I Reference superelement identification number

4 METHOD I Boundary point search method: 1=automatic or


2=manual

5 TOL RS Location tolerance

6 LOC I Coincident location check option: yes=1 or no=2

7 MEDIA I Media format of boundary data of external SE

8 UNIT I FORTRAN unit number of OP2 and OP4 input of


external SE

Record – SECONCT(427,4,453)

Word Name Type Description

1 SEIDA I Superelement A identification number

2 SEIDB I Superelement B identification number

3 TOL RS Location tolerance

4 LOC I Coincident location check option: yes=1 or no=2

5 UNDEF(4 ) None

9 GA I Grid point identification number in SEIDA

10 GB I Grid point identification number in SEIDB

Words 9 through 10 repeat until (-1,-1) occurs

Record – SEELT(7902,79,302)

Word Name Type Description

1 SEID I Superelement identification number

2 EID I Element identification number

Word 2 repeats until End of Record

4-10 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – SEEXCLD(527,72,454)

Word Name Type Description

1 SEIDA I Superelement A identification number

2 SEIDB I Superelement B identification number or -1 for all

3 GA I Grid point identification number in SEIDA

Word 3 repeats until End of Record

Record – SELABEL(1027,10,459)

Word Name Type Description

1 SEID I Superelement identification number

2 LABEL(14) CHAR4 Label associated with superelement SEID

Record – SELOAD(1127,11,461)

Word Name Type Description

1 LID0 I New mapped load set identification number to be


used in the residual structure

2 SEID I Superelement identification number of the external


superelement

3 LIDSE I Load set identification number in the external


superelement

Record – SELOC(827,8,457)

Word Name Type Description

1 SEID I Superelement identification number

2 GA1 I Grid point 1 identification number in SEID

3 GA2 I Grid point 2 identification number in SEID

4 GA3 I Grid point 3 identification number in SEID

5 GB1 I Grid point 1 identification number in the main Bulk


Data

6 GB2 I Grid point 2 identification number in the main Bulk


Data

DMAP Programmer's Guide 4-11


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 GB3 I Grid point 3 identification number in the main Bulk


Data

Record – SEMPLN(927,9,458)

Word Name Type Description

1 SEID I Superelement identification number

2 MIRRTYPE I Mirror type

MIRRTYPE=1 Plane

3 G1 I Grid point 1 identification number in the main


Bulk Data

4 G2 I Grid point 2 identification number in the main


Bulk Data

5 G3 I Grid point 3 identification number in the main


Bulk Data

6 UNDEF(2 ) None Not Defined

MIRRTYPE=2 Normal

3 G I Grid point identification number in the main Bulk


Data

4 CID I Coordinate system identification number

5 N1 RS Normal component in direction 1 of CID

6 N2 RS Normal component in direction 2 of CID

7 N3 RS Normal component in direction 3 of CID

End MIRRTYPE

Record – SENQSET(1327,13,464)

Word Name Type Description

1 SEID I Superelement identification number

2 NQSET I Number of internally generated scalar points

4-12 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – SEQGP(5301,53,4)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 SEQID I Sequenced identification number

Record – SEQSEP(5401,54,305)

Word Name Type Description

1 SSID I Secondary superelement identification number

2 PSID I Primary superelement identification number

3 G I Exterior grid or scalar point identificaiton numbers

Word 3 repeats until End of Record

Record – SESET(5601,56,296)

Word Name Type Description

1 SEID I Superelement identification number

2 G I Grid or scalar point identification number

Word 2 repeats until End of Record

Record – SETREE(1227,12,462)

Word Name Type Description

1 SEID I Superelement identification number

2 SEUPI I Upstream superelement identification number

Word 2 repeats until End of Record

Record – SNORM(5678,71,475)

Word Name Type Description

1 GID I Grid point identification number

2 CID I Coordinate system identification number

3 N1 RS Normal component in direction 1 of CID

DMAP Programmer's Guide 4-13


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 N2 RS Normal component in direction 2 of CID

5 N3 RS Normal component in direction 3 of CID

Record – TRAILER

Word Name Type Description

1 BIT(6) I 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

• 6=MIRROR

4.3 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.

4-14 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data Block Name

RECORD – BEAMAERO(2601,26,0)

Word Name Type Description

1 EID I Box identification number

2 COMPID I Component number in AECOMP

3 COMPTYPE(2) CHAR4 Component type: SLBD (slender body)

5 G(2) I Grid identification numbers in AEGRID


defining perimeter

RECORD – CAABSF(2708,27,59)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

5 G3 I Grid point 3 identification number

6 G4 I Grid point 4 identification number

RECORD – CAXIF2(2108,21,224)

Word Name Type Description

1 EID I Element identification number

2 IDF1 I GRIDF point 1 identification number

3 IDF2 I GRIDF point 2 identification number

4 RHO RS Fluid density in mass units

5 B RS Fluid bulk modulus

6 UNDEF None

DMAP Programmer's Guide 4-15


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CAXIF3(2208,22,225)

Word Name Type Description

1 EID I Element identification number

2 IDF1 I GRIDF point 1 identification number

3 IDF2 I GRIDF point 2 identification number

4 IFD3 I GRIDF point 2 identification number

5 RHO RS Fluid density in mass units

6 B RS Fluid bulk modulus

7 UNDEF None

RECORD – CAXIF4(2308,23,226)

Word Name Type Description

1 EID I Element identification number

2 IDF1 I GRIDF point 1 identification number

3 IDF2 I GRIDF point 2 identification number

4 IFD3 I GRIDF point 2 identification number

5 IDF4 I GRIDF point 4 identification number

6 RHO RS Fluid density in mass units

7 B RS Fluid bulk modulus

8 UNDEF None

RECORD – CBAR(2408,24,180)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GA I Grid point End A identification number

4 GB I Grid point End B identification number

F =0 Z

4-16 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 1

F =1 XYZ option - global cooridnate system

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 1

F =2 Grid option

5 GO I Grid point ID at end of orientation vector

6 UNDEF(2 ) None

8 F I Orientation vector flag = 2

End F

9 PA I Pin flags for end A

10 PB I Pin flags for end B

11 W1A RS T1 component of offset vector from GA

12 W2A RS T2 component of offset vector from GA

13 W3A RS T3 component of offset vector from GA

14 W1B RS T1 component of offset vector from GB

15 W2B RS T2 component of offset vector from GB

16 W3B RS T3 component of offset vector from GB

RECORD – CBARAO(4001,40,275)

Word Name Type Description

1 EID I Element identification number

2 SCALE I Scale of Xi values

DMAP Programmer's Guide 4-17


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 X1 RS 1st intermediate station for data recovery

4 X2 RS 2nd intermediate station for data recovery

5 X3 RS 3rd intermediate station for data recovery

6 X4 RS 4th intermediate station for data recovery

7 X5 RS 5th intermediate station for data recovery

8 X6 RS 6th intermediate station for data recovery

9 UNDEF None

RECORD – CBEAM(5408,54,261)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GA I Grid point End A identification number

4 GB I Grid point End B identification number

5 SA I Scalar or grid point End A identification number


for warping

6 SB I Scalar or grid point End B identification number


for warping

F =0 Y

7 X1 RS T1 component of orientation vector from GA

8 X2 RS T2 component of orientation vector from GA

9 X3 RS T3 component of orientation vector from GA

10 F I Orientation vector flag = 0

F =1 XYZ option - global coordinate system

7 X1 RS T1 component of orientation vector from GA

8 X2 RS T2 component of orientation vector from GA

9 X3 RS T3 component of orientation vector from GA

10 F I Orientation vector flag =1

4-18 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

F =2 Grid option

7 GO I Grid point ID at end of orientation vector

8 UNDEF(2 ) None

10 F I Orientation vector flag = 2

End F

11 PA I Pin flags for end A

12 PB I Pin flags for end B

13 W1A RS T1 component of offset vector from GA

14 W2A RS T2 component of offset vector from GA

15 W3A RS T3 component of offset vector from GA

16 W1B RS T1 component of offset vector from GB

17 W2B RS T2 component of offset vector from GB

18 W3B RS T3 component of offset vector from GB

RECORD – CBEAMP(11401,114,9016)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Internal indices of grid points

7 SA I Scalar or grid point End A identification number


for warping

8 SB I Scalar or grid point End B identification number


for warping

F =0 Z

9 X1 RS T1 component of orientation vector from GA

10 X2 RS T2 component of orientation vector from GA

11 X3 RS T3 component of orientation vector from GA

12 F I Orientation vector flag

DMAP Programmer's Guide 4-19


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

F =1 XYZ option - global cooridnate system

9 X1 RS T1 component of orientation vector from GA

10 X2 RS T2 component of orientation vector from GA

11 X3 RS T3 component of orientation vector from GA

12 F I Orientation vector flag = 1

F =2 Grid option

9 GO I Grid point ID at end of orientation vector

10 UNDEF(2 ) None

12 F I Orientation vector flag = 2

End F

13 BIT RS Built In Twist

14 PA I Pin flags for end A

15 PB I Pin flags for end B

16 W1A RS T1 component of offset vector from GA

17 W2A RS T2 component of offset vector from GA

18 W3A RS T3 component of offset vector from GA

19 W1B RS T1 component of offset vector from GB

20 W2B RS T2 component of offset vector from GB

21 W3B RS T3 component of offset vector from GB

22 UNDEF(2 ) None

RECORD – CBEND(4601,46,298)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GA I Grid point End A identification number

4 GB I Grid point End B identification number

4-20 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

F =0 Z

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 0

F =1 XYZ option - global cooridnate system

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 1

F =2 Grid option

5 GO I Grid point ID at end of orientation vector

6 UNDEF(2 ) None

8 F I Orientation vector flag = 2

End F

9 UNDEF(4 ) None

13 GEOM I Element geometry option

RECORD – CBUSH(2608,26,60)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GA I Grid point End A identification number

4 GB I Grid point End B identification number

F =-1 Use Element CID below for orientation

5 UNDEF(3 ) None

8 F I Orientation vector flag = -1

DMAP Programmer's Guide 4-21


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

F =0 XYZ option - Basic coordinate system - SECONVRT module

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 0

F =1 XYZ option

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 1

F =2 Grid option

5 GO I Grid point identification number at end of


orientation vector

6 UNDEF(2 ) None

8 F I Orientation vector flag = 2

End F

9 CID I Element coordinate system identification

10 S RS Location of spring damper

11 OCID I Coordinate system for spring offset

12 S1 RS T1 component of spring-damper offset in the


OCID system

13 S2 RS T2 component of spring-damper offset in the


OCID system

14 S3 RS T3 component of spring-damper offset in the


OCID system

RECORD – CBUSH1D(5608,56,218)

Word Name Type Description

1 EID I Element identification number

4-22 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 PID I Property identification number

3 G(2) I Grid point identification numbers

5 CID I Coordinate system identification number

6 UNDEF(3 ) None

RECORD – CCONE(2315,23,0)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 RINGA I Ringa + 1000000 * n

4 RINGB I Ringb + 100000 * n

RECORD – CDAMP1(201,2,69)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

RECORD – CDAMP2(301,3,70)

Word Name Type Description

1 EID I Element identification number

2 B RS Value of the scalar damper

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

DMAP Programmer's Guide 4-23


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

RECORD – CDAMP3(401,4,71)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CDAMP4(501,5,72)

Word Name Type Description

1 EID I Element identification number

2 B RS Value of the scalar damper

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CDAMP5(10608,106,404)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CDUM2(6208,62,108)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

4-24 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CDUM3(6308,63,109)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CDUM4(6408,64,110)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CDUM5(6508,65,111)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CDUM6(6608,66,112)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CDUM7(6708,67,113)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CDUM8(6808,68,114)

Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

DMAP Programmer's Guide 4-25


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CDUM9(6908,69,115)
Word Name Type Description

1 UNDEF None

Word 1 repeats until End of Record

RECORD – CELAS1(601,6,73)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

RECORD – CELAS2(701,7,74)
Word Name Type Description

1 EID I Element identification number

2 K RS Stiffness of the scalar spring

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

7 GE RS Damping coefficient

8 S RS Stress coefficient

RECORD – CELAS3(801,8,75)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

4-26 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CELAS4(901,9,76)

Word Name Type Description

1 EID I Element identification number

2 K RS Stiffness of the scalar spring

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CFAST(13801,138,566)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GS I Spot weld master node identification number GS

4 FORMAT(C) I Connection format (9=elpat, 10=partpat)

5 GA I Identification number of GA

6 GB I Identification number of GB

7–8 UNDEF(2)

9 GUPPER(8) I Grid identification numbers of the upper shell

17 GLOWER(8) I Grid identification numbers of the lower shell

Unique set of grid IDs of the active shells in


25 GUACT(32) I
upper patch

Unique set of grid IDs of the active shells in


57 GLACT(32) I
lower patch

89 NUG I Number of active grids in upper patch

90 NLG I Number of active grids in lower patch

91 GUELE(32) I Grid IDs of the active shells in upper patch

DMAP Programmer's Guide 4-27


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

123 GLELE(32) I Grid IDs of the active shells in lower patch

155 GHA(12) RS Coordinates of 4 GHA points

167 GHB(12) RS Coordinates of 4 GHB points

179 TAVG RS Average shell thickness

FORMAT=9 ELPAT

180 EIDUP I Element ID of upper shell

181 EIDLOW I Element ID of lower shell

FORMAT=PARTPAT PARTPAT

180 PIDUP I Property ID of upper shell

181 PIDLOW I Property ID of lower shell

END FORMAT

182 TMIN RS Minimum shell thickness

183 XS RS X coordinate of spot weld location

184 YS RS Y coordinate of spot weld location

185 ZS RS Z coordinate of spot weld location

186 XGA RS X coordinate of point ga

187 YGA RS Y coordinate of point ga

188 ZGA RS Z coordinate of point ga

189 XGB RS X coordinate of point gb

190 YGB RS Y coordinate of point gb

191 ZGB RS Z coordinate of point gb

RECORD – CFLUID2(8515,85,0)

Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL point 1 identification number

3 IDF2 I RINGFL point 2 identification number

4-28 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 RHO RS Mass density

5 B RS Bulk modulus

6 HARMINDX I Harmonic index

RECORD – CFLUID3(8615,86,0)
Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL point 1 identification number

3 IDF2 I RINGFL point 2 identification number

4 IDF3 I RINGFL point 3 identification number

5 RHO RS Mass density

6 B RS Bulk modulus

7 HARMINDX I Harmonic index

RECORD – CFLUID4(8715,87,0)
Word Name Type Description

1 EID I Element identification number

2 IDF1 I RINGFL point 1 identification number

3 IDF2 I RINGFL point 2 identification number

4 IDF3 I RINGFL point 3 identification number

5 IDF4 I RINGFL point 4 identification number

6 RHO RS Mass density

7 B RS Bulk modulus

8 HARMINDX I Harmonic index

RECORD – CGAP(1908,19,104)
Word Name Type Description

1 EID I Element identification number

DMAP Programmer's Guide 4-29


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 PID I Property identification number

3 GA I Grid point End A identification number

4 GB I Grid point End B identification number

F =0 Z

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 0

F =1 XYZ option - global cooridnate system

5 X1 RS T1 component of orientation vector from GA

6 X2 RS T2 component of orientation vector from GA

7 X3 RS T3 component of orientation vector from GA

8 F I Orientation vector flag = 1

F =2 Grid option

5 GO I Grid point ID at end of orientation vector

6 UNDEF(2 ) None

8 F I Orientation vector flag = 2

End F

9 CID I Element coordinate system identification number

RECORD – CGPLSTN3(13101,131,9901)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3–5 G(3) I Grid point identification numbers

6 CGID I Control grid point identification number

4-30 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

7 THETA RS or I Material property orientation angle or coordinate


system ID

8-17 UNDEF(10)

RECORD – CGPLSTN8(13401,134,9904)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3-10 G(8) I Grid point identification numbers

11 CGID I Control grid point identification number

12 THETA RS or I Material property orientation angle or coordinate


system ID

13-17 UNDEF(5) Grid point End B identification number

RECORD – CGPLSTN6(13301,133,9903)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3–8 G(6) I Grid point identification numbers

9 CGID I Control grid point identification number

10 THETA RS or I Material property orientation angle or coordinate


system ID

11-17 UNDEF(7)

RECORD – CGPLSTN4(13201,132,9902)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3–6 G(4) I Grid point identification numbers

DMAP Programmer's Guide 4-31


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 CGID I Control grid point identification number

8 THETA RS or I Material property orientation angle or coordinate


system ID

9-17 UNDEF(9)

RECORD – CHACAB(8100,81,381)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(20) I Grid point identification numbers of connection


points

RECORD – CHACBR(8200,82,383)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(20) I Grid point identification numbers of connection


points

RECORD – CHBDYE(8308,83,405)
Word Name Type Description

1 EID I Element identification number

2 EID2 I Heat conduction element identification number

3 SIDE I Consistent element side identification number

4 IVIEWF I VIEW entry identification number for the front


face

5 IVIEWB I VIEW entry identification number for the back


face

6 RADMIDF I RADM entry identification number for front face

7 RADMIDB I RADM entry identification number for back face

4-32 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CHBDYG(10808,108,406)

Word Name Type Description

1 EID I Element identification number

2 UNDEF None

3 TYPE I Surface type

4 IVIEWF I VIEW entry identification number for the front


face

5 IVIEWB I VIEW entry identification number for the back


face

6 RADMIDF I RADM entry identification number for front face

7 RADMIDB I RADM entry identification number for back face

8 UNDEF None

9 G(8) I Grid point identification numbers of connection


points

RECORD – CHBDYP(10908,109,407)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 TYPE I Surface type

4 IVIEWF I VIEW entry identification number for the front


face

5 IVIEWB I VIEW entry identification number for the back


face

6 G1 I Grid point 1 identification number

7 G2 I Grid point 2 identification number

8 GO I Grid point ID at end of orientation vector

9 RADMIDF I RADM entry identification number for front face

10 RADMIDB I RADM entry identification number for back face

11 DISLIN I

DMAP Programmer's Guide 4-33


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

12 CE I Coordinate system for defining orientation vector

13 E1 RS T1 components of the orientation vector in the


CE system

14 E2 RS T2 components of the orientation vector in the


CE system

15 E3 RS T3 components of the orientation vector in the


CE system

RECORD – CHEXA(7308,73,253)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(20) I Grid point identification numbers of connection


points

RECORD – CHEXA20F(16300,163,9989)
Same as record CHEXA description.

RECORD – CHEXAFD(14000,140,9990)
Same as record CHEXA description.

RECORD – CHEXAL(7708,77,9944)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 UNDEF None

4 G(20) I Grid point identification numbers of connection


points

4-34 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CHEXP(12001,120,9011)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

11 E1(24) I

35 F(6) I

41 B1 I

42 E2(24) I

RECORD – CHEXPR(7409,74,9991)
Same as record CHEXA description.

RECORD – CMASS1(1001,10,65)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

RECORD – CMASS2(1101,11,66)

Word Name Type Description

1 EID I Element identification number

2 M RS Scalar mass value

3 G1 I Grid point 1 identification number

4 G2 I Grid point 2 identification number

DMAP Programmer's Guide 4-35


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 C1 I Component number at grid point 1

6 C2 I Component number at grid point 2

RECORD – CMASS3(1201,12,67)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CMASS4(1301,13,68)

Word Name Type Description

1 EID I Element identification number

2 M RS Scalar mass value

3 S1 I Scalar point 1 identification number

4 S2 I Scalar point 2 identification number

RECORD – CMFREE(2508,25,0)

Word Name Type Description

1 EID I Element identification number

2 S I

3 S2 I

4 Y RS

5 N I

RECORD – CONM1(1401,14,63)

Word Name Type Description

1 EID I Element identification number

4-36 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 M1(1) RS Mass matrix term M11

5 M2(2) RS Mass matrix terms M21 through M22

7 M3(3) RS Mass matrix terms M31 through M33

10 M4(4) RS Mass matrix terms M41 through M44

14 M5(5) RS Mass matrix terms M51 through M55

19 M6(6) RS Mass matrix terms M61 through M66

RECORD – CONM2(1501,15,64)

Word Name Type Description

1 EID I Element identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 M RS Mass

5 X1 RS T1 offset from the grid point to the center of


gravity

6 X2 RS T2 offset from the grid point to the center of


gravity

7 X3 RS T3 offset from the grid point to the center of


gravity

8 I1(1) RS Mass moments of inertia term I11

9 I2(2) RS Mass moments of inertia term I21 through I22

11 I3(3) RS Mass moments of inertia term I31 through I33

RECORD – CONROD(1601,16,47)

Word Name Type Description

1 EID I Element identification number

DMAP Programmer's Guide 4-37


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 G1 I Grid point 1 identification number

3 G2 I Grid point 2 identification number

4 MID I Material identification number

5 A RS Area

6 J RS Torsional constant

7 C RS Coefficient for torsional stress

8 NSM RS Nonstructural mass per unit length

RECORD – CONV(12701,127,408)

Word Name Type Description

1 EID I Element identification number

2 PCONID I Convection property identification number

3 FLMND I Point for film convection fluid property


temperature

4 CNTRLND I Control point for free convection boundary


condition

5 TA I Ambient points used for convection

Word 5 repeats 8 times

RECORD – CONVM(8908,89,422)

Word Name Type Description

1 EID I Element identification number

2 PCONID I Convection property identification number

3 FLMND I Point for film convection fluid property


temperature

4 CNTMDOT I Control point used for controlling mass flow.

5 TA I Ambient points used for convection

Word 5 repeats 2 times

4-38 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CPENP(12101,121,9012)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

9 E1(18) I

27 F(5) I

32 B1 I

33 E2(14) I

RECORD – CPENTA(4108,41,280)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(15) I Grid point identification numbers of connection


points

RECORD – CPENTAL(7108,71,9943)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 UNDEF None

4 G(15) I Grid point identification numbers of connection


points

RECORD – CPENPR(7509,75,9992)
Same as record CPENTA description.

RECORD – CPENT15F(16500,165,9987)
Same as record CPENTA description.

DMAP Programmer's Guide 4-39


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CPENT6FD(16000,160,9988)
Same as record CPENTA description.

RECORD – CPLSTN3(1701,17,980)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

6 THETA RS Material property orientation angle or coordinate


system ID

7 UNDEF(10) None

RECORD – CPLSTN4(5701,57,981)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

7 THETA RS Material property orientation angle or coordinate


system ID

8 UNDEF(9) None

RECORD – CPLSTN6(5801,58,982)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

9 THETA RS Material property orientation angle or coordinate


system ID

10 UNDEF(7) None

4-40 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CPLSTN8(7201,72,983)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

11 THETA RS Material property orientation angle or coordinate


system ID

12 UNDEF(5) None

RECORD – CPLSTS3(8801,88,984)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

6 UNDEF None

7 THETA RS Material property orientation angle or coordinate


system ID

8 UNDEF(4) None

12 TFLAG I Flag signifying meaning of T(3) values

13 T(3) RS Membrane thickness of element at grid points

16 UNDEF None

RECORD – CPLSTS4(8401,84,985)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

DMAP Programmer's Guide 4-41


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 THETA RS Material property orientation angle or coordinate


system ID

8 UNDEF(4) None

12 TFLAG I Flag signifying meaning of T(4) values

13 T(4) RS Membrane thickness of element at grid points

RECORD – CPLSTS6(1801,18,986)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

9 UNDEF(2) None

11 THETA RS Material property orientation angle or coordinate


system ID

12 TFLAG I Flag signifying meaning of T(3) values

13 T(3) RS Membrane thickness of element at grid points

16 UNDEF None

RECORD – CPLSTS8(3601,36,987)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

11 THETA RS Material property orientation angle or coordinate


system ID

12 TFLAG I Flag signifying meaning of T(4) values

13 T(4) RS Membrane thickness of element at grid points

17 UNDEF(8) None

4-42 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CPYRAM(17200,172,1000)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(13) I Grid point identification numbers of connection


points

16 UNDEF None

RECORD – CPYRA5FD(25700,257,9948)
Same as record CPYRAM description.

RECORD – CPYRA13F(25800,258,9947)
Same as record CPYRAM description.

RECORD – CPYRAMPR(7909,79,9946)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(13) I Grid point identification numbers of connection


points

16 UNDEF None

RECORD – CQDX4FD(17000,170,9980)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(9) I Grid point identification numbers of connection


points

RECORD – CQDX9FD(17100,171,9979)
Same as record CQDX4FD description.

DMAP Programmer's Guide 4-43


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CQDX4FDN(25110,170,9951)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

4 UNDEF

RECORD – CQDX8FDN(25310,171,9949)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

4 UNDEF

RECORD – CQUAD(9108,91,507)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(9) I Grid point identification numbers of connection


points

RECORD – CQUAD4(2958,51,177)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

7 THETA RS Material property orientation angle or coordinate


system ID

4-44 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

8 ZOFFS RS Offset from the surface of grid points reference


plane

9 UNDEF None

10 TFLAG I Alternate thickness flag

11 T(4) RS Membrane thickness of element at grid points

RECORD – CQUAD4FD(13900,139,9984)
Same as record CQUAD description.

RECORD – CQUAD8(4701,47,326)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

11 T(4) RS Membrane thickness of element at grid points

15 THETA RS Material property orientation angle or coordinate


system ID

16 ZOFFS RS Offset from the surface of grid points reference


plane

17 TFLAG I Alternate thickness flag

RECORD – CQUAD9FD(16400,164,9983)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(9) I Grid point identification numbers of connection


points

DMAP Programmer's Guide 4-45


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CQUADP(11101,111,9014)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(17) I Internal indices of connection points

20 UNDEF(7 ) None

27 INORM I Flag for normals

28 THETA RS Material property orientation angle or coordinate


system ID

29 ZOFFS RS Offset from the surface of grid points reference


plane

30 UNDEF(2 ) None

32 T(4) RS Membrane thickness of element at grid points

RECORD – CQUADR(8009,80,367)
Same as record CQUAD4 description.

RECORD – CQUADX(9008,90,508)
Same as record CQUAD description.

RECORD – CQUADX4(6112,61,997)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

4 THETA RS Material property orientation angle

RECORD – CQUADX8(6114,61,999)

Word Name Type Description

1 EID I Element identification number

4-46 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

4 THETA RS Material property orientation angle

RECORD – CROD(3001,30,48)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(2) I Grid point identification numbers of connection


points

RECORD – CSBOLT(3501,35,1)
Word Name Type Description

1 EID I Element identification number

2 G(2) I Grid point identification numbers of connection


points

3 K RS Stiffness in global X-direction

RECORD – CSHEAR(3101,31,61)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

RECORD – CSLOT3(4408,44,227)
Word Name Type Description

1 EID I Element identification number

2 IDS(3) I GRIDS identification numbers

DMAP Programmer's Guide 4-47


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 RHO RS Fluid density in mass units

6 B RS Fluid bulk modulus

7 M I Number of slots in circumferential direction

8 HARMINDX I Harmonic index

RECORD – CSLOT4(4508,45,228)

Word Name Type Description

1 EID I Element identification number

2 IDS(4) I GRIDS identification numbers

6 RHO RS Fluid density in mass units

7 B RS Fluid bulk modulus

8 M I Number of slots in circumferential direction

9 HARMINDX I Harmonic index

RECORD – CTETP(12201,122,9013)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

7 E1(12) I

19 F(4) I

23 B1 I

24 E2(4) I

RECORD – CTETRA(5508,55,217)

Word Name Type Description

1 EID I Element identification number

4-48 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 PID I Property identification number

Grid point identification numbers of connection


3 G(10) I
points

RECORD – CTETPR(7609,76,9993)
Same as record CTETRA description.

RECORD – CTETR10F(16600,166,9985)
Same as record CTETRA description.

RECORD – CTETR4FD(16100,161,9986)
Same as record CTETRA description.

RECORD – CTRAX3FDN(25010,168,9952)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

4 UNDEF

RECORD – CTRAX6FDN(25210,169,9950)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

4 UNDEF

DMAP Programmer's Guide 4-49


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CTRIA3(5959,59,282)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

6 THETA RS Material property orientation angle or coordinate


system identification number

7 ZOFFS RS Offset from the surface of grid points reference


plane

8 UNDEF(2) None

10 TFLAG I Alternate thickness flag

11 T(3) RS Membrane thickness of element at grid points

RECORD – CTRIA3FD(16200,162,9982)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

RECORD – CTRIA6(4801,48,327)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

9 THETA RS Material property orientation angle or coordinate


system identification number

10 ZOFFS RS Offset from the surface of grid points reference


plane

4-50 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

11 T(3) RS Membrane thickness of element at grid points

14 TFLAG I Alternate thickness flag

RECORD – CTRIA6FD(16700,167,9981)
Same as record CTRIA3FD description.

RECORD – CTRIAP(11301,113,9015)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(11) I Internal indices of grid points

14 UNDEF(3 ) None

17 THETA RS Material property orientation angle or coordinate


system identification number

18 UNDEF None

19 ZOFFS RS Offset from the surface of grid points reference


plane

20 UNDEF(2 ) None

22 T(3) RS Membrane thickness of element at grid points

RECORD – CTRIAR(9200,92,385)
Same as record CTRIA3 description.

RECORD – CTRIAX(10108,101,512)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

9 UNDEF None

DMAP Programmer's Guide 4-51


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – CTRIAX6(6108,61,107)

Word Name Type Description

1 EID I Element identification number

2 MID I Material identification number

3 G(6) I Grid point identification numbers of connection


points

9 THETA RS Material property orientation angle

10 UNDEF(2 ) None

RECORD – CTRAX3(6111,61,996)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

4 THETA RS Material property orientation angle

RECORD – CTRAX6(6113,61,998)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

4 THETA RS Material property orientation angle

RECORD – CTRIX3FD(16800,168,9978)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

4-52 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 G(3) I Grid point identification numbers of connection


points

6 UNDEF(3 ) None

RECORD – CTRIX6FD(16900,169,9977)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

RECORD – CTUBE(3701,37,49)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(2) I Grid point identification numbers of connection


points

RECORD – CVISC(3901,39,50)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(2) I Grid point identification numbers of connection


points

RECORD – CWELD(11701,117,559)

Word Name Type Description

1 EID I Element ID for FORM="ALIGN", "ELEMID" or


"GRIDID"

2 PID I Property ID

DMAP Programmer's Guide 4-53


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 GS I Spot weld master node ID GS

4 FORMAT(C) I Connection format (0 GRIDID, 1 ALIGN, 2


elemid

5 GA I ID of GA

6 GB I ID of GB

7 TYPE I Types of upper and lower elements for


FORM="GRIDID"

8 UNDEF None

FORMAT =0 GRIDID

9 GUPPER(8) I Grid identification numbers of the upper shell

17 GLOWER(8) I Grid identification numbers of the lower shell

FORMAT =1 ALIGN

9 UNDEF(16 ) None

FORMAT =2 ELEMID

9 EIDUP I Element identification number of the upper shell

10 EIDLOW I Element identification number of the lower shell

11 UNDEF(14 ) None

End FORMAT

25 TAVG RS Average shell thickness

26 RID1 I RBE2 ID for the rigid connection between the


spot weld and the upper shell

27 RID2 I RBE2 ID for the rigid connection between the


spot weld and the lower shell

28 TMIN RS Minimum shell thickness

29 XS RS X coordinate of spot weld location

30 YS RS Y coordinate of spot weld location

31 ZS RS Z coordinate of spot weld location

4-54 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – CWELDC(13501,135,564)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GS I Spot weld master node identification number GS

Connection format (0=GRIDID, 1=ALIGN,


4 FORMAT(C) I
2=ELEMID, 9=ELPAT, 10=PARTPAT)

5 GA I Identification number of GA

6 GB I Identification number of GB

7 UNDEF(2) None

9 GUPPER(8) I Grid identification numbers of the upper shell

17 GLOWER(8) I Grid identification numbers of the lower shell

25 TAVG RS Average shell thickness

26 RID1 I RBE2 ID for the rigid connection between the


spot weld and the upper shell

27 RID2 I RBE2 ID for the rigid connection between the


spot weld and the lower shell

28 TMIN RS Minimum shell thickness

29 XS RS X coordinate of spot weld location

30 YS RS Y coordinate of spot weld location

31 ZS RS Z coordinate of spot weld location

RECORD – CWELDP(13701,137,565)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 GS I Spot weld master node identification number GS

4 FORMAT(C) I Connection format (9=elpat, 10=partpat)

5 GA I Identification number of GA

DMAP Programmer's Guide 4-55


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

6 GB I Identification number of GB

7–8 UNDEF(2)

9 GUPPER(8) I Grid identification numbers of the upper shell

17 GLOWER(8) I Grid identification numbers of the lower shell

Unique set of grid IDs of the active shells in


25 GUACT(32) I
upper patch

Unique set of grid IDs of the active shells in


57 GLACT(32) I
lower patch

89 NUG I Number of active grids in upper patch

90 NLG I Number of active grids in lower patch

91 GUELE(32) I Grid IDs of the active shells in upper patch

123 GLELE(32) I Grid IDs of the active shells in lower patch

155 GHA(12) RS Coordinates of 4 GHA points

167 GHB(12) RS Coordinates of 4 GHB points

179 TAVG RS Average shell thickness

FORMAT=9 ELPAT

180 EIDUP I Element ID of upper shell

181 EIDLOW I Element ID of lower shell

FORMAT=PARTPAT PARTPAT

180 PIDUP I Property ID of upper shell

181 PIDLOW I Property ID of lower shell

END FORMAT

182 TMIN RS Minimum shell thickness

183 XS RS X coordinate of spot weld location

184 YS RS Y coordinate of spot weld location

185 ZS RS Z coordinate of spot weld location

186 XGA RS X coordinate of point ga

4-56 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

187 YGA RS Y coordinate of point ga

188 ZGA RS Z coordinate of point ga

189 XGB RS X coordinate of point gb

190 YGB RS Y coordinate of point gb

191 ZGB RS Z coordinate of point gb

RECORD – This record is no longer used– CWELDG(13601,136,562)

Word Name Type Description

1 EID I Shell element identification number

2 PID I Property identification number

3 GS I Spot weld master node identification number GS

4 FORMAT(C) I Connection format (3=TRIA3, 4=QUAD4,


6=TRIA6, 8=QUAD8)

5 GA I Identification number of GA

6 GB I Identification number of GB

7 TYPE I Types of upper and lower elements for


FORM="GRIDID"

8 CID I C

FORMAT =3 TRIA3

9 EIDSH I Element identification number

10 PIDSH I Property identification number of PSHELL

11 GIDSH(3) I Grid Iidentification numbers of element

14 TH RS MCID or THETA

15 ZOFFS RS ZOFFS

16 UNDEF(3 ) None

19 T(3) RS Membrane thickness

22 UNDEF(3 ) None

FORMAT =4 QUAD4

DMAP Programmer's Guide 4-57


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

9 EIDSH I Element identification number

10 PIDSH I Property identification number of PSHELL

11 GIDSH(4) I Grid identification numbers of element

15 TH RS MCID or THETA

16 ZOFFS RS ZOFFS

17 UNDEF(2 ) None

19 T(4) RS Membrane thickness

23 UNDEF(2 ) None

FORMAT =6 TRIA6

9 EIDSH I Element identification number

10 PIDSH I Property identification number of PSHELL

11 GIDSH(6) I Grid identification numbers of element

17 TH RS MCID or THETA

18 ZOFFS RS ZOFFS

19 T(3) RS Membrane thickness

22 UNDEF(3 ) None

FORMAT =8 QUAD8

9 EIDSH I Element identification number

10 PIDSH I Property identification number of PSHELL

11 GIDSH(8) I Grid identification numbers of element

19 T(4) RS Membrane thickness

23 TH RS MCID or THETA

24 ZOFFS RS ZOFFS

End FORMAT

25 EID2 I CWELD or RBAR element identification number

26 RID1 I R

27 RID2 I R

4-58 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – GENEL(4301,43,28)

Word Name Type Description

1 EID I Element identification number

2 UI I Independent grid point identification number

3 CI I Component number

Words 2 through 3 repeat until End of Record

4 M(C) I Number of rows and columns in K or Z and rows


in S

5 UD I Dependent grid point identification number

6 CD I Component number

Words 5 through 6 repeat until End of Record

7 N(C) I Number of columns in S

8 F I 1 => Z 2=> K

9 KZIJ RS Lower triangular terms of the K or Z matrix. See


Notes.

Word 9 repeats MM times

10 NZERO(C) I

NZERO =1 Actually " 0"

11 SIJ 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 – GMBNDC(3201,32,478)

Word Name Type Description

1 BID I Boundary identification number

DMAP Programmer's Guide 4-59


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 GRIDI I Initial grid identification number for boundary

3 GRIDF I Final grid identification number for boundary

4 ENTITY(2) CHAR4 Entity type for defining boundary

6 EID I Entity identification numbers for boundary of


subdomain

Word 6 repeats until End of Record

RECORD – GMBNDS(12901,129,482)
Word Name Type Description

1 BID I Boundary identification number

2 GRIDC(4) I Corner grid 1

6 ENTITY(2) CHAR4 Entity type for defining boundary

8 EID I Entity identification numbers for boundary of


subdomain

Word 8 repeats until End of Record

RECORD – GMINTC(3301,33,479)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 IBOUND(6) I Boundary identification number

9 UNDEF(42 ) None

RECORD – GMINTS(13001,130,483)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 IBOUND(4) I Boundary identification number

7 UNDEF(44 ) None

4-60 DMAP Programmer's Guide


Data Block Descriptions F-M

RECORD – PLOTEL(5201,52,11)

Word Name Type Description

1 EID I Element identification number

2 G(2) I Grid point identification numbers of connection


points

RECORD – Q4AERO(3002,46,0)

Word Name Type Description

1 EID I Box identification number

2 COMPID I Component number in AECOMP

3 COMPTYPE(2) CHAR4 Component type: SLBD (slender body)

5 G(4) I Grid identification numbers in AEGRID defining


perimeter

RECORD – RADBC(12801,128,417)

Word Name Type Description

1 EID I Element identification number

2 FAMB RS Radiation view factor between the face and the


ambient point

3 CNTRLND I Control point for radiation boundary condition

4 NODAMB I

RECORD – SINT(7801,78,8883)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 PTELE I Pointer to element identification number

4 NSEG I Number of segments

5 STSC I Stride for segment displacement data

6 PTSC I Pointer to segment displacements

DMAP Programmer's Guide 4-61


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 NBOUND I Number of boundaries

8 BID I Boundary identification number

9 NFACE I Number of faces

10 STBC I Stride for boundary displacement data

11 NSEG I Number of segments

12 STLC1 I Stride for Boundary Lagrange Multiplier data

13 PTBND I Pointer to boundary identification number

14 PTBC I Pointer to boundary displacements

15 PTLC I Pointer to boundary Lagrange Multipliers

Words 8 through 15 repeat 5 times

16 UNDEF(3 ) None

RECORD – SPOINT(5551,49,105)

Word Name Type Description

1 ID I Scalar point identification number

RECORD – T3AERO(2701,27,0)

Word Name Type Description

1 EID I Box identification number

2 COMPID I Component number in AECOMP

3 COMPTYPE(2) CHAR4 Component type: SLBD (slender body)

5 G(3) I Grid identification numbers in AEGRID


defining perimeter

RECORD – VUBEAM(11601,116,9942)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

4-62 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 G(2) I Grid point identification numbers of connection


points

RECORD – VUHEXA(12301,123,145)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(8) I Grid point identification numbers of connection


points

RECORD – VUPENTA(12401,124,146)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(6) I Grid point identification numbers of connection


points

RECORD – VUQUAD4(11201,112,9940)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

RECORD – VUTETRA(12501,125,147)

Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(4) I Grid point identification numbers of connection


points

DMAP Programmer's Guide 4-63


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

RECORD – VUTRIA3(11501,115,9941)
Word Name Type Description

1 EID I Element identification number

2 PID I Property identification number

3 G(3) I Grid point identification numbers of connection


points

RECORD – TRAILER
Word Name Type Description

1 BIT(6) I 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)

• 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.

4-64 DMAP Programmer's Guide


Data Block Descriptions F-M

• WAKE are Wake Boxes.

• MFLO are Flow-Thru Surfaces like Inlets (Mass-Flow).

5. In GENEL record, MM=((M*(M+1)/2)-1).

4.4 GEOM3
Table of Bulk Data entry images related to static and thermal loads

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – ACCEL(7401,74,601)

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 N(3) RS Components of a vector coordinate system defined


by CID

6 DIR CHAR1 Component direction of acceleration variation

7 LOCi RS Location along direction DIR in coordinate system

8 VALi RS The load scale factor associated with location LOCi

Words 7 through 8 repeat until (-1,-1) occurs.

Record – ACCEL1(7501,75,602)

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 A RS Acceleration vector scale factor

4 N(3) RS Components of a vector coordinate system defined


by CID

7 GRIDID I Grid ID or THRU or BY code

DMAP Programmer's Guide 4-65


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

Words 7 repeats until (-1) occurs.

Record – BOLTFOR(7002,85,254)

Word Name Type Description

1 SID I Bolt force set identification number

2 FORCE RS Bolt force

3 BOLTID I Bolt identification number

Record – BOLTLD(7601,76,608)

Word Name Type Description

1 SID I Set identification number of BOLTLD bulk entry

2 S RS Overall scale factor

3 Si RS Scale factor on Li

4 Li I Set identification number of BOLTFOR bulk entries

Word 4 repeats until (-1,-1) occurs

Record – CRAKTP(7801,78,968)

Word Name Type Description

1 SID I Crack tip identification number

2 NR I Number of rings to compute J-integral

3 G I Grid point identification number

4 VCEV I Q vector identification number

Words 3 and 4 repeat until -1 occurs.

Record – DTEMP(7701,77,619)

Word Name Type Description

1 SID I DTEMP set identification number

2 UNDEF(7)

4-66 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

9 TIME RS Time

10 TEMPi I Temperature set identification number

Words 9 and 10 repeat until -1,-1 occurs.

Record – DTEMPEX(8001,80,620)

Word Name Type Description

1 SID I DTEMPEX set identification number

2 UNITID I Fortran unit number

3 UNDEF(6)

Record – FORCE(4201,42,18)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 F RS Scale factor

5 N(3) RS Components of a vector coordinate system defined


by CID

Record – FORCE1(4001,40,20)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 F RS Scale factor

4 G(2) I Grid point identification numbers

DMAP Programmer's Guide 4-67


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – FORCE2(4101,41,22)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 F RS Scale factor

4 G(4) I Grid point identification numbers

Record – GMLOAD(6309,63,391)

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 N1 RS Component 1 of a vector coordinate system


defined by CID

4 N2 RS Component 2 of a vector coordinate system


defined by CID

5 N3 RS Component 3 of a vector coordinate system


defined by CID

6 ENTITY CHAR4 Entity type that is being loaded

7 ENTID I Entity identification number

8 METHTYP I Method

METHTYP =1 TABLE3D

9 TABLID I TABLE3D identification number

10 UNDEF(8 ) None

METHTYP =2 DEQATN

9 EQTNID I DEQATN identification number

10 UNDEF(8 ) None

METHTYP =3 CONSTANT

9 FIELD(9) RS Load magnitude data

METHTYP =4 LINEAR

4-68 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

9 FIELD(9) RS Load magnitude data

METHTYP =5 QUAD

9 FIELD(9) RS Load magnitude data

METHTYP =6 CUBIC

9 FIELD(9) RS Load magnitude data

METHTYP=11

9 MTABLID I

10 UNDEF(8) None

METHTYP=12

9 MEQTNID I

10 UNDEF(8) 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

Record – GRAV(4401,44,26)

Word Name Type Description

1 SID I Load set identification number

2 CID I Coordinate system identification number

3 A RS Acceleration vector scale factor

DMAP Programmer's Guide 4-69


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 N(3) RS Components of a vector coordinate system defined


by CID

7 MB I Bulk Data Section with CID definition: -1=main,


0=partitioned

Record – LOAD(4551,61,84)

Word Name Type Description

1 SID I Load set identification number

2 S RS Overall scale factor

3 SI RS Scale factor on LI

4 LI I Load set identification number

Words 3 through 4 repeat until (-1,-1) occurs

Record – LOADCYH(3709,37,331)

Word Name Type Description

1 SID I Load set identification number

2 S RS Scale factor

3 HID I Harmonic index

4 HTYPE I Harmonic type

5 SI RS Scale factor on LI

6 LI I Load set identification number

Words 5 through 6 repeat 2 times

Record – LOADCYN(3809,38,332)

Word Name Type Description

1 SID I Load set identification number

2 S RS Scale factor

3 SEGID I Segment identification number

4-70 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 SEGTYPE I Segment type

5 SI RS Scale factor on LI

6 LI I Load set identification number

Words 5 through 6 repeat 2 times

Record – LOADCYT(3909,39,333)

Word Name Type Description

1 SID I Load set identification number

2 TABLEID I TABLEDi identification number

3 LOADSET I Load set identification number

4 METHOD I Method of interpolation

Words 2 through 4 repeat 2 times

Record – LSEQ(3609,36,188)

Word Name Type Description

1 SID I Load set identification number

2 DAREA I DAREA set identification number

3 LID I Load set identification number

4 TID I Temperature set identification number

5 UNDEF None

Record – MOMENT(4801,48,19)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 M RS Moment scale factor

DMAP Programmer's Guide 4-71


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 N(3) RS Components of a vector coordinate system defined


by CID

Record – MOMENT1(4601,46,21)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 M RS Moment scale factor

4 G(2) I Grid point identification numbers

Record – MOMENT2(4701,47,23)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 M RS Moment scale factor

4 G(4) I Grid point identification numbers

Record – PLOAD(5101,51,24)

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure

3 G(4) I Grid point identification numbers

Record – PLOAD1(6909,69,198)

Word Name Type Description

1 SID I Load set identification number

2 EID I Element identification number

3 TYPE I Load type

4-72 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 SCALE I Scale factor for X1 and X2

5 X1 RS Distance to position 1 along the element axis from


end A

6 P1 RS Pressure at position 1

7 X2 RS Distance to position 2 along the element axis from


end A

8 P2 RS Pressure at position 2

Record – PLOAD2(6802,68,199)

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure

3 EID I Element identification number

Record – PLOAD3(7109,71,255)

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure

3 EID I Element identification number

4 G(2) I Grid point identification numbers

Record – PLOAD4(7209,72,299)

Word Name Type Description

1 SID I Load set identification number

2 EID I Element identification number

3 P(4) RS Pressures

7 G1 I Grid point identification number at a corner of the


face

DMAP Programmer's Guide 4-73


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

8 G34 I Grid point ID at a diagonal from G1 or CTETRA


corner

9 CID I Coordinate system identification number

10 N(3) RS Components of a vector coordinate system defined


by CID

Record – PLOADE1(6701,67,978)

Word Name Type Description

1 SID I Load set identification number

2 EID I Element identification number

3 PA RS Surface traction at grid point GA

4 PB RS Surface traction at grid point GB

5 G(2) I Corner grid point identification numbers

7 THETA RS Angle between surface traction and inward normal

Record – PLOADX(7001,70,278)
This record is obsolete

Word Name Type Description

1 SID I Load set identification number

2 P(2) RS Pressure

4 G(3) I Grid point identification numbers

Record – PLOADX1(7309,73,351)

Word Name Type Description

1 SID I Load set identification number

2 EID I Element identification number

3 PA RS Surface traction at grid point GA

4 PB RS Surface traction at grid point GB

4-74 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

5 G(2) I Corner grid point identification numbers

7 THETA RS Angle between surface traction and inward normal

Record – PRESAX(5215,52,154)

Word Name Type Description

1 SID I Load set identification number

2 P RS Pressure

3 RID(2) I Ring identification numbers

5 PHI1 RS Azimuthal angles in degrees

6 UNDEF None

Record – QBDY1(4509,45,239)

Word Name Type Description

1 SID I Load set identification number

2 Q0 RS Heat flux into element

3 EID I Element identification number

Record – QBDY2(4909,49,240)

Word Name Type Description

1 SID I Load set identification number

2 EID I Element identification number

3 Q0(8) RS Heat flux at the i-th grid point on the referenced


CHBDYj

Record – QBDY3(2109,21,414)

Word Name Type Description

1 SID I Load set identification number

2 Q0 RS Thermal heat flux load, or load multiplier

DMAP Programmer's Guide 4-75


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 CNTRLND I Control point for thermal flux load

4 EID I Element identification number

Record – QHBDY(4309,43,233)

Word Name Type Description

1 SID I Load set identification number

2 FLAG I Face type

3 Q0 RS Magnitude of thermal flux into face

4 AF RS Area factor

5 G(8) I Grid point identification numbers

Record – QVECT(2209,22,241)

Word Name Type Description

1 SID I Load set identification number

2 Q0 RS Magnitude of thermal flux vector into face

3 TSOUR RS Temperature of the radiant source

4 CE I Coordinate system identification number for


thermal vector flux

5 FLAG I

6 E RS Vector component of flux in coordinate system CE

Words 5 through 6 repeat 3 times

7 CNTRLND I Control point

8 EID I Element identification number

Record – QVOL(2309,23,416)

Word Name Type Description

1 SID I Load set identification number

4-76 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 QVOL RS Power input per unit volume produced by a


conduction element

3 CNTRLND I Control point used for controlling heat generation

4 EID I Element identification number

Record – RFORCE(5509,55,190)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 A RS Scale factor of the angular velocity

5 R(3) RS Rectangular components of rotation vector

8 METHOD I Method used to compute centrifugal forces

9 RACC RS Scale factor of the angular acceleration

10 MB I Bulk Data Section with CID definition: -1=main,


0=partitioned

Record – RFORCE1(17300,173,615)

Word Name Type Description

1 SID I Load set identification number

2 G I Grid point identification number

3 CID I Coordinate system identification number

4 A RS Scale factor of the angular velocity

5 R(3) RS Rectangular components of rotation vector

8 METHOD I Method used to compute centrifugal forces

9 RACC RS Scale factor of the angular acceleration

10 MB I Bulk Data Section with CID definition: -1=main,


0=partitioned

DMAP Programmer's Guide 4-77


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

11 GROUPID I Identification number of the GROUP bulk entry that


specifies the grids to which this RFORCE1 bulk
entry is applied

Record – SLOAD(5401,54,25)

Word Name Type Description

1 SID I Load set identification number

2 G I Scalar or grid point identification number

3 F RS Scale factor

Record – TEMP(5701,57,27)

Word Name Type Description

1 SID I Temperature set identification number

2 G I Grid point identification number

3 T RS Temperature

Record – TEMPD(5641,65,98)

Word Name Type Description

1 SID I Temperature set identification number

2 T RS Temperature

Record – TEMPEST(11109,111,424)

Word Name Type Description

1 SID I Temperature set identification number

2 TEMP RS Temperature

3 EID I Element identification number

4-78 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – TEMPEX(8601,86,621)

Word Name Type Description

1 SID I TEMPEX set identification number

2 UNITID I Fortran unit number

3 UNDEF(6)

Record – TEMPF(6209,62,390)

Word Name Type Description

1 SID I Temperature set identification number

2 EID I Element identification number

3 FTEMP I DEQATN identification number

4 FTABID I TABLE3D identification number

Record – TEMPIC(11209,112,425)

Word Name Type Description

1 SID I Temperature set identification number

2 TEMP RS Temperature

3 EID I Element identification number

Record – TEMPP1(8109,81,201)

Word Name Type Description

1 SID I Temperature set identification number

2 EID I Element identification number

3 T RS Temperature at the element’s reference plane

4 TPRIME RS Effective linear thermal gradient

5 TS(2) RS Temperatures for stress calculation

Record – TEMPP2(8209,82,202)
This record is obsolete

DMAP Programmer's Guide 4-79


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

1 SID I Temperature set identification number

2 EID I Element identification number

3 T RS S,{

4 MX RS S,{

5 MY RS S,{

6 MXY RS S,{

7 T(2) RS S,{

Record – TEMPP3(8309,83,203)
This record is obsolete

Word Name Type Description

1 SID I Temperature set identification number

2 EID I Element identification number

3 Z RS S,{

4 T RS S,{

Words 3 through 4 repeat 11 times

Record – TEMPRB(8409,84,204)

Word Name Type Description

1 SID I Temperature set identification number

2 EID I Element identification number

3 TA RS Temperature at end A on the neutral axis

4 TB RS Temperature at end B on the neutral axis

5 TP1A RS Effective linear gradient in direction 1 on end A

6 TP1B RS Effective linear gradient in direction 1 on end B

7 TP2A RS Effective linear gradient in direction 2 on end A

8 TP2B RS Effective linear gradient in direction 2 on end B

4-80 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

9 TS(8) RS Temperatures for stress calculation

Record – PFACE(6409,64,9032)
This record is created by the GP0 module; not by the user.

Word Name Type Description

1 SID I Load set identification number

2 FACEID I Face identification number

3 CID I Coordinate system identification number

4 N(3) RS Components of a vector coordinate system defined


by CID

7 EQTNID I DEQATN identification number

8 TABLID I TABLE3D identification number

9 FIELD(9) RS See GMLOAD record

18 G(4) I Grid point identification numbers

22 GNIDA I Side i grid-n A identification number

23 GNIDB I Side i grid-n B identification number

24 PSEL I Computed p value

25 MAXNDF I Maximum number of degrees-of-freedom or stride

Words 22 through 25 repeat 4 times

26 FACFID I Grid-n identification number for the face

27 NDOF I Number of degrees-of-freedom for the face

28 LDISTFG I Load distribution flag

29 UNDEF(2 ) None

31 CIDF I Coordinate system ID of the face

32 NDOFF(4) I NDOF flags

Record – PEDGE(6609,66,9031)
This record is created by the GP0 module; not by the user.

DMAP Programmer's Guide 4-81


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

1 SID I Load set identification number

2 EDGEID I Edge identification number

3 CID I Coordinate system identification number

4 N(3) RS Components of a vector coordinate system defined


by CID

7 EQTNID I DEQATN identification number

8 TABLID I TABLE3D identification number

9 FIELD(4) RS See GMLOAD record

13 G(2) I Grid point identification numbers

15 F1ID I Grid-n 1 identification number

16 F2ID I Grid-n 2 identification number

17 PSEL I Computed p value

18 MAXNDF I Maximum number of degrees-of-freedom or stride

19 INTFL I 1 or 2

20 UNDEF(13 ) None

33 CIDE I Coordinate system identification number of the edge

Record – TEMPEX(8601,86,621)
Word Name Type Description

1 SID I TEMPEX set identification number

2 UNITID I Fortran unit number

3 UNDEF(6)

Record – VCEV(7901,79,967)
Word Name Type Description

1 SID I Q vector set identification number

2 CRID I Coordinate system identification number

3–8 UNDEF(6)

4-82 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

9 VEC1 I First vector component

10 VEC2 I Second vector component

11 VEC3 I Third vector components

12–16 UNDEF(5)

Words 9 and 17 repeat for each vector defined, up to a maximum of 7 vectors

Record – TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

4.5 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.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – ASET(5561,76,215)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – ASET1(5571,77,216)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

DMAP Programmer's Guide 4-83


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – BLTMPC(12001,120,601)

Word Name Type Description

1 CID I Constraint identification number

2 C I Component numbers

3 GID1 I Grid point identification numbers

4 GID2 I Grid point identification numbers

5 C(3) I Component directions

Record – BNDFIX(110,1,584)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – BNDFIX1(210,2,585)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

4-84 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – BNDFREE(310,3,586)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – BNDFREE1(410,4,587)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – BNDGRID(10200,102,473)

Word Name Type Description

1 GPI I Shape boundary grid point identification number

DMAP Programmer's Guide 4-85


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – BSET(110,1,311)
Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – BSET1(210,2,312)
Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – CSET(310,3,313)
Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – CSET1(410,4,314)
Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

4-86 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – CYAX(1510,15,328)

Word Name Type Description

1 G I Grid point identification number on the axis of


symmetry

Word 1 repeats until End of Record

Record – CYJOIN(5210,52,257)

Word Name Type Description

1 SIDE I Side identification number: 1 or 2

2 C(2) CHAR4 Coordinate system type on symetry booundary

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

Record – CYSUP(1610,16,329)

Word Name Type Description

1 GID I Grid or scalar point identification number

2 C I Component numbers

Record – CYSYM(1710,17,330)

Word Name Type Description

1 NSEG I Number of segments

2 STYPE(2) CHAR4 Symmetry type

DMAP Programmer's Guide 4-87


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – EGENDT(8801,88,9022)

Word Name Type Description

1 LOADID I Load set identification number

2 SPCID I SPC set identification number

3 EDGEID I Edge identification number

4 C I Component numbers

5 DISTFLG I Distribution flag

6 DISFUN I Distribution function (DEQATN)

7 DISTAB I Distribution table (TABLE3D)

8 FIELD(4) RS See GMBC record

Words 4 through 11 repeat 6 times

12 ELTYPE I Element type

13 EID I Element identification number

14 EORD I Edge order

15 EDGEID I Edge identification number

16 FACEID I Face identification number

17 CURVID I Curve identification number

18 SURFID I Surface identification number

19 G(2) I Grid point identification numbers

21 MIDG I

22 POINT(2) I Point identification numbers

24 F1ID I Grid-n 1 identification number

25 F2ID I Grid-n 2 identification number

26 NDOF I I,{

27 CIDE I Coordinate system identification number for the


edge

28 MAXNDFE I Maximum number of degrees-of-freedom, or stride,


for the edge

4-88 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

29 MAXNDFB I Maximum number of degrees-of-freedom, or stride,


for the body

30 PUSER I p-level specified by user

31 PSEL I p-level selected by program

32 BODYFID I Grid-n identification number for the body

33 NDOFB I Number of degrees-of-freedom for the body

34 F1ID I Grid-n 1 identification number

35 CID I Coordinate system identification number

36 X RS S,{

37 Y RS S,{

38 Z RS S,{

Words 34 through 38 repeat 7 times

Record – FCENDT(9001,90,9024)

Word Name Type Description

1 LOADID I Load set identification number

2 SID I Set identification number

3 FACEID I Face identification number

4 C I Component numbers

5 DISTFLG I Distribution flag

6 DISFUN I Distribution function (DEQATN)

7 DISTAB I Distribution table (TABLE3D)

8 FIELD(9) RS See GMBC record

Words 4 through 16 repeat 6 times

17 F1ID I Grid-n 1 identification number

18 F2ID I Grid-n 2 identification number

19 NDOF I Number of degrees-of-freedom for the face

DMAP Programmer's Guide 4-89


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

20 MAXNDF I Maximum number of degrees-of-freedom or stride

21 CIDE I Coordinate system identification number of the


edge

Words 17 through 21 repeat 4 times

22 FACFID I Grid-n identification number for the face

23 NDOF I Number of degrees-of-freedom for the face

24 MAXNDFF I Maximum number of degrees-of-freedom for the


face

25 CIDF I Coordinate system identification number for the


face

26 ELTYPE I Element type

27 EID I Element identification number

28 EORD I Edge order

29 FACEID I Face identification number

30 SURFID I Surface identification number

31 G(4) I Grid point identification numbers

35 CIDF I Coordinate system identification number for the


face

36 MAXNDIF I

37 UNDEF None

38 PUSER(4) I p-level specified by user

42 PSEL(4) I p-level selected by program

46 FACFID I Grid-n identification number for the face

47 NDOF I Number of degrees-of-freedom for the face

48 F1ID I Grid-n 1 identification number

49 CID I Coordinate system identification number

50 X RS

51 Y RS

4-90 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

52 Z RS

Words 48 through 52 repeat 13 times

Record – GMBC(8001,80,395)

Word Name Type Description

1 LID I Load set identification number

2 SPCID I SPC set identification number

3 C I Component number

4 ENTITY CHAR4 Entity type that is being loaded

5 ENTID I Entity identification number

6 METHOD I Method of data specification

METHOD =1 TABLE3D

7 TABLID I TABLE3D identification number

8 UNDEF(8 ) None

METHOD =2 DEQATN

7 EQTNID I DEQATN identification number

8 UNDEF(8 ) None

METHOD =3 CONSTANT

7 FIELD(9) RS Enforced displacement data

METHOD =4 LINEAR

7 FIELD(9) RS Enforced displacement data

METHOD =5 QUAD

7 FIELD(9) RS Enforced displacement data

METHOD =6 CUBIC

7 FIELD(9) RS Enforced displacement data

End METHOD

DMAP Programmer's Guide 4-91


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – GMSPC(7801,78,393)

Word Name Type Description

1 ID I Set identification number

2 C I Component number

3 ENTITY CHAR4 Entity type that is being loaded

4 ENTID I Entity identification number

Record – MPC(4901,49,17)

Word Name Type Description

1 SID I Set identification number

2 G I Grid point identification number

3 C I Component number

4 A RX Coefficient

5 GI I Grid point identification number

6 CI I Component number

7 AI RX Coefficient

Words 5 through 7 repeat until (-1,-1,-1) occurs

Record – MPCADD(4891,60,83)

Word Name Type Description

1 SID I Set identification number

2 S I Set identification number

Word 2 repeats until End of Record

Record – OMIT(5001,50,15)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

4-92 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – OMIT1(4951,63,92)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – QSET(510,5,315)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – QSET1(610,6,316)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

DMAP Programmer's Guide 4-93


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – RBAR(6601,66,292)

Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 CNA I Component numbers of independent


degrees-of-freedom at end A

5 CNB I Component numbers of independent


degrees-of-freedom at end B

6 CMA I Component numbers of dependent


degrees-of-freedom at end A

7 CMB I Component numbers of dependent


degrees-of-freedom at end B

8 ALF RS Coefficient of thermal expansion

Record – RBE1(6801,68,294)

Word Name Type Description

1 EID I Element identification number

2 GN I Grid point identification number for independent


degrees-of-freedom

3 CN I Component numbers of independent


degrees-of-freedom

Words 2 through 3 repeat until (-2,-2) occurs

4 GM I Grid point identification number for dependent


degrees-of-freedom

5 CM I Component numbers of dependent


degrees-of-freedom

Words 4 through 5 repeat until (-1,-1) occurs

6 ALF RS Coefficient of thermal expansion

7 UNDEF None

4-94 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – RBE2(6901,69,295)

Word Name Type Description

1 EID I Element identification number

2 GN I Grid point identification number for independent


degrees-of-freedom

3 CM I Component numbers of dependent


degrees-of-freedom

4 GM I Grid point identification number for dependent


degrees-of-freedom

Word 4 repeats until -1 occurs

5 ALF RS Coefficient of thermal expansion

Record – RBE3(7101,71,187)

Word Name Type Description

1 EID I Element identification number

2 REFG I Reference grid point identification number

3 REFC I Component numbers at the reference grid point

4 WT1 RS Weighting factor for components of motion at G

5 C I Component numbers

6 G I Grid point identification number

Word 6 repeats until -1 occurs

Words 4 through 6 repeat until -2 occurs

7 GM I Grid point identification number for dependent


degrees-of-freedom

8 CM I Component numbers of dependent


degrees-of-freedom

Words 7 through 8 repeat until -3 occurs

9 ALF RS Coefficient of thermal expansion

DMAP Programmer's Guide 4-95


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – RELEASE(1310,13,247)
Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – RROD(6501,65,291)
Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 CMA I Component numbers of dependent


degrees-of-freedom at end A

5 CMB I Component numbers of dependent


degrees-of-freedom at end B

6 ALF RS Coefficient of thermal expansion

Record – RSPLINE(7001,70,186)
Word Name Type Description

1 EID I Element identification number

2 DBYL RS Ratio of the diameter to the sum of the segments


lengths

3 G1 I Grid point identification number

4-96 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 G2 I Grid point identification number

5 C2 I Components to be constrained

Words 4 through 5 repeat until (-1,-1) occurs

Record – RSSCON(7201,72,398)

Word Name Type Description

1 EID I Element identification number

2 TYPE(C) I Type of connectivity

TYPE =0 GRID style 1

3 GRID1 I Grid identification number 1

4 GRID2 I Grid identification number 2

5 GRID3 I Grid identification number 3

6 UNDEF(3 ) None

TYPE =01 GRID style 2

3 GRID1 I Grid identification number 1

4 GRID2 I Grid identification number 2

5 GRID3 I Grid identification number 3

6 GRID4 I Grid identification number 4

7 GRID5 I Grid identification number 5

8 GRID6 I Grid identification number 6

TYPE =02 Edge style

3 EDGE1 I Edge identification number 1

4 EDGE2 I Edge identification number 2

5 EDGE3 I Edge identification number 3

6 UNDEF(3 ) None

TYPE =03 Element style

3 ELID1 I Element identification number 1

DMAP Programmer's Guide 4-97


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 ELID2 I Element identification number 2

5 UNDEF(4 ) None

TYPE =04 CINTERF

3 CBID I

4 SBID I

5 CBPID I

6 UNDEF(3) None

End TYPE

Record – RTRPLT(6701,67,293)

Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 GC I Grid point C identification number

5 CNA I Component numbers for independent


degrees-of-freedom at vertex A

6 CNB I Component numbers for independent


degrees-of-freedom at vertex B

7 CNC I Component numbers for independent


degrees-of-freedom at vertex C

8 UNDEF None

9 CMA I Component numbers for dependent


degrees-of-freedom at vertex A

10 CMB I Component numbers for dependent


degrees-of-freedom at vertex B

11 CMC I Component numbers for dependent


degrees-of-freedom at vertex C

12 ALF RS Coefficient of thermal expansion

4-98 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – RVDOF(9801,98,609)
DOF specification for residual vector computations.

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – RVDOF1(9901,99,610)
DOF specification for residual vector computations.

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru flag range

THRUFLAG = 0 No

3 ID I Grid or scalar point identification number

THRUFLAG = 1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – RWELD(11901,119,561)
Word Name Type Description

1 EID I Element ID

2 GA I Grid ID of GA

3 TYPE I Type of shell element

4 GI(8) I Grid IDs of shell element

12 GS I Grid ID of GS

Record – SEBSET(710,7,317)
Word Name Type Description

1 SEID I Superelement identification number

DMAP Programmer's Guide 4-99


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record – SEBSET1(810,8,318)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – SECSET(910,9,319)

Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record – SECSET1(1010,10,320)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

4-100 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – SEQSET(1110,11,321)

Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record – SEQSET1(1210,12,322)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

DMAP Programmer's Guide 4-101


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – SESUP(1410,14,325)

Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record – SEUSET(1810,18,334)

Word Name Type Description

1 SEID I Superelement identification number

2 SNAME I Set name

3 ID I Grid or scalar point identification number

4 C I Component numbers

Record – SEUSET1(1910,19,335)

Word Name Type Description

1 SEID I Superelement identification number

2 SNAME I Set name

3 C I Component numbers

4 THRUFLAG I Thru range flag

THRUFLAG=0 No

5 ID I Grid or scalar point identification number

Word 5 repeats until End of Record

THRUFLAG=1 Yes

5 ID1 I First grid or scalar point identification number

6 ID2 I Second grid or scalar point identification number

End THRUFLAG

4-102 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – SPC(5501,55,16)
Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

Record – SPC1(5481,58,12)
Word Name Type Description

1 SID I Set identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – SPCADD(5491,59,13)
Word Name Type Description

1 SID I Set identification number

2 S I Set identification number

Word 2 repeats until End of Record

Record – SPCD(5110,51,256)
Word Name Type Description

1 SID I Superelement identification number

DMAP Programmer's Guide 4-103


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

Record – SPCDE(8701,87,9021)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 EDGEID I Edge identification number

6 SID I Set identification number

Record – SPCDF(8901,89,9023)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 FACEID I Face identification number

6 SID I Set identification number

Record – SPCDG(9701,97,9030)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4-104 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 METHOD I Method

5 D RS Enforced displacement

6 SID I Set identification number

Record – SPCE(9301,93,9027)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 EDGID I Grid or scalar point identification number

Record – SPCEB(9101,91,9025)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 EDGEID I Edge identification number

Record – SPCF(9401,94,9028)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 FACEID I Face identification number

DMAP Programmer's Guide 4-105


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – SPCFB(9201,92,9026)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 LOADID I Load set identification number

Record – SPCGB(9601,96,9029)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 METHOD I I,{

5 D RS Enforced displacement

6 SID I Set identification number

Record – SPCGRID(8601,86,9031)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 UNDEF(2 ) None

Record – SPCOFF(6110,61,343)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

4-106 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – SPCOFF1(6210,62,344)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – SUPORT(5601,56,14)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record – SUPORT1(10100,101,472)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid point identification number

3 C I Component numbers

Words 2 through 3 repeat until (-1,-1) occurs

Record – TEMPBC(11309,113,426)

Word Name Type Description

1 SID I Temperature set identification number

2 TYPE I Type of temperature boundary condition: STAT or


TRAN

DMAP Programmer's Guide 4-107


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 TEMP RS Temperature

4 GID I Grid or scalar point identification number

Record – USET(2010,20,193)

Word Name Type Description

1 SNAME I Set name

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record – USET1(2110,21,194)

Word Name Type Description

1 SNAME I Set name

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record – TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

4-108 DMAP Programmer's Guide


Data Block Descriptions F-M

4.6 GEOM168
Table of Bulk Data entry images related to geometry (Pre-MSC Nastran Version 69).
Note

See Note 6 for a listing of the differences between GEOM168 and GEOM1.

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – CORD1C(1701,17,6)
Word Name Type Description

1 CID I Coordinate system identification number

2 TWO I Constant 2

3 ONE I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD1R(1801,18,5)
Word Name Type Description

1 CID I Coordinate system identification number

2 ONE1 I Constant 1

3 ONE2 I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD1S(1901,19,7)
Word Name Type Description

1 CID I Coordinate system identification number

DMAP Programmer's Guide 4-109


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 THREE I Constant 3

3 ONE I Constant 1

4 G1 I Grid point 1 identification number

5 G2 I Grid point 2 identification number

6 G3 I Grid point 3 identification number

Record – CORD2C(2001,20,9)
Word Name Type Description

1 CID I Coordinate system identification number

2 TWO1 I Constant 2

3 TWO2 I Constant 2

4 RID I Reference coordinate system identification


number

5 A1 RS Location of A in coordinate 1 of RID

6 A2 RS Location of A in coordinate 2 of RID

7 A3 RS Location of A in coordinate 3 of RID

8 B1 RS Location of B in coordinate 1 of RID

9 B2 RS Location of B in coordinate 2 of RID

10 B3 RS Location of B in coordinate 3 of RID

11 C1 RS Location of C in coordinate 1 of RID

12 C2 RS Location of C in coordinate 2 of RID

13 C3 RS Location of C in coordinate 3 of RID

Record – CORD2R(2101,21,8)
Word Name Type Description

1 CID I Coordinate system identification number

2 ONE I Constant 1

3 TWO I Constant 2

4-110 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 RID I Reference coordinate system identification


number

5 A1 RS Location of A in coordinate 1 of RID

6 A2 RS Location of A in coordinate 2 of RID

7 A3 RS Location of A in coordinate 3 of RID

8 B1 RS Location of B in coordinate 1 of RID

9 B2 RS Location of B in coordinate 2 of RID

10 B3 RS Location of B in coordinate 3 of RID

11 C1 RS Location of C in coordinate 1 of RID

12 C2 RS Location of C in coordinate 2 of RID

13 C3 RS Location of C in coordinate 3 of RID

Record – CORD2S(2201,22,10)

Word Name Type Description

1 CID I Coordinate system identification number

2 SIXTY5 I Constant 65 or 3?

3 EIGHT I Constant 8 or 2?

4 RID I Reference coordinate system identification number

5 A1 RS Location of A in coordinate 1 of RID

6 A2 RS Location of A in coordinate 2 of RID

7 A3 RS Location of A in coordinate 3 of RID

8 B1 RS Location of B in coordinate 1 of RID

9 B2 RS Location of B in coordinate 2 of RID

10 B3 RS Location of B in coordinate 3 of RID

11 C1 RS Location of C in coordinate 1 of RID

12 C2 RS Location of C in coordinate 2 of RID

13 C3 RS Location of C in coordinate 3 of RID

DMAP Programmer's Guide 4-111


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – CORD3G(501,5,43)

Word Name Type Description

1 CID I Coordinate system identification number

2 METHOD(2) CHAR4 Methods

4 FORM(2) CHAR4 Forms

6 THETAID(3) I Identification number for DEQATN or TABLE

9 CIDREF I Coordinate system identification number

Record – CSUPER(2301,23,304)

Word Name Type Description

1 SSID I Coded identification number for secondary


superelement

2 PSID I Primary superelement identification number

3 G I Exterior grid or scalar point identificaiton numbers

Word 3 repeats until End of Record

Record – CSUPEXT(5501,55,297)

Word Name Type Description

1 SEID I Superelement identification number

2 G I Grid or scalar point IDs in the downstream


superelement

Word 2 repeats until End of Record

Record – EXTRN(1627,16,463)

Word Name Type Description

1 GID I Grid point identification numbers to connect external


SE

2 C I Component numbers

Words 1 through 2 repeat until (-1,-1) occurs

4-112 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – FEEDGE(6101,61,388)

Word Name Type Description

1 EDGEID I Edge identification number

2 GRID1 I Identification number of end GRID 1

3 GRID2 I Identification number of end GRID 2

4 CID I Coordinate system identification number

5 GEOMIN CHAR4 Type of referencing entry: "GMCURV" or "POINT"

6 GEOMID1 I Identification number of a POINT or GMCURV


entry

7 GEOMID2 I Identification number of a POINT or GMCURV


entry

Record – GMCURV(6601,66,392)

Word Name Type Description

1 CURVID I Curve identification number

2 GROUP(2) CHAR4 Group of curves/surfaces to which this curve


belongs

4 CIDIN I Coordinate system identification number for the


geometry

5 CIDBC I Coordinate system identification number for the


constraints

6 DATA CHAR4 Geometry evaluator specific data

Word 6 repeats until End of Record

Record – FEFACE(6201,62,389)

Word Name Type Description

1 FACEID I Face identification number

2 GRID1 I Identification number of end GRID 1

3 GRID2 I Identification number of end GRID 2

4 GRID3 I Identification number of end GRID 3

DMAP Programmer's Guide 4-113


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 GRID4 I Identification number of end GRID 4

6 CIDBC I Coordinate system identification number for the


constraints

7 SURFID(2) I Alternate method used to specify the geometry

Record – POINT(6001,60,377)
Word Name Type Description

1 ID I Point identification number

2 CID I Coordinate system identification number

3 X1 RS Location of the point in coordinate 1 of CID

4 X2 RS Location of the point in coordinate 2 of CID

5 X3 RS Location of the point in coordinate 3 of CID

Record – GMSURF(10101,101,394)
Word Name Type Description

1 ID I Surface Identification number

2 GROUP(2) CHAR4 Group of curves/surfaces to which this curve


belongs

4 CIDIN I Coordinate system identification number for the


geometry

5 CIDBC I Coordinate system identification number for the


constraints

6 DATA CHAR4 Geometry evaluator specific data

Word 6 repeats until End of Record

Record – GMCORD(6401,64,402)
Word Name Type Description

1 CID I Coordinate system identification number

2 ENTITY CHAR4 Bulk Data entry used to define the coordinate


system

4-114 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 ID1 I Entity identification number 1

4 ID2 I Entity identification number 2

Record – GRID(4501,45,1)

Word Name Type Description

1 ID I Grid point identification number

2 CP I Location coordinate system identification number

3 X1 RS Location of the point in coordinate 1 of CP

4 X2 RS Location of the point in coordinate 2 of CP

5 X3 RS Location of the point in coordinate 3 of CP

6 CD I Degree-of-freedom coordinate system identification


number

7 PS I Permanent single-point constraints

8 SEID I Superelement identification number

Record – SEBNDRY(1527,15,466)

Word Name Type Description

1 SEIDA I Superelement A identification number

2 SEIDB I Superelement B identification number

3 G I Boundary grid point identification number in SEIDA

Word 3 repeats until End of Record

Record – SEBULK(1427,14,465)

Word Name Type Description

1 SEID I Superelement identification number

2 TYPE I Superelement type

3 RSEID I Reference superelement identification number

DMAP Programmer's Guide 4-115


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 METHOD I Boundary point search method: 1=automatic or


2=manual

5 TOL RS Location tolerance

6 LOC I Coincident location check option: yes=1 or no=2

7 MEDIA I Media format of boundary data of external SE

8 UNIT I FORTRAN unit number of OP2 and OP4 input of


external SE

Record – SECONCT(427,4,453)

Word Name Type Description

1 SEIDA I Superelement A identification number

2 SEIDB I Superelement B identification number

3 TOL RS Location tolerance

4 LOC I Coincident location check option: yes=1 or no=2

5 UNDEF(4 ) None

9 GA I Grid point identification number in SEIDA

10 GB I Grid point identification number in SEIDB

Words 9 through 10 repeat until (-1,-1) occurs

Record – SEELT(7902,79,302)

Word Name Type Description

1 SEID I Superelement identification number

2 EID I Element identification number

Word 2 repeats until End of Record

Record – SEEXCLD(527,72,454)

Word Name Type Description

1 SEIDA I Superelement A identification number

4-116 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 SEIDB I Superelement B identification number or –1 for all

3 GA I Grid point identification number in SEIDA

Word 3 repeats until End of Record

Record – SELABEL(1027,10,459)

Word Name Type Description

1 SEID I Superelement identification number

2 LABEL(14) CHAR4 Label associated with superelement SEID

Record – SELOC(827,8,457)

Word Name Type Description

1 SEID I Superelement identification number

2 GA1 I Grid point 1 identification number in SEID

3 GA2 I Grid point 2 identification number in SEID

4 GA3 I Grid point 3 identification number in SEID

5 GB1 I Grid point 1 identification number in the main Bulk


Data

6 GB2 I Grid point 2 identification number in the main Bulk


Data

7 GB3 I Grid point 3 identification number in the main Bulk


Data

Record – SEMPLN(927,9,458)

Word Name Type Description

1 SEID I Superelement identification number

2 MIRRTYPE I Mirror type

MIRRTYPE=1 Plane

3 G1 I Grid point 1 identification number in the main


Bulk Data

DMAP Programmer's Guide 4-117


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 G2 I Grid point 2 identification number in the main


Bulk Data

5 G3 I Grid point 3 identification number in the main


Bulk Data

6 UNDEF(2 ) None Not Defined

MIRRTYPE=2 Normal

3 G I Grid point identification number in the main Bulk


Data

4 CID I Coordinate system identification number

5 N1 RS Normal component in direction 1 of CID

6 N2 RS Normal component in direction 2 of CID

7 N3 RS Normal component in direction 3 of CID

End MIRRTYPE

Record – SENQSET(1327,13,464)

Word Name Type Description

1 SEID I Superelement identification number

2 NQSET I Number of internally generated scalar points

Record – SEQGP(5301,53,4)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 SEQID I Sequenced identification number

Record – SEQSEP(5401,54,305)

Word Name Type Description

1 SSID I Secondary superelement identification number

2 PSID I Primary superelement identification number

3 G I Exterior grid or scalar point identification numbers

4-118 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

Word 3 repeats until End of Record

Record – SESET(5601,56,296)
Word Name Type Description

1 SEID I Superelement identification number

2 G I Grid or scalar point identification number

Word 2 repeats until End of Record

Record – SETREE(1227,12,462)
Word Name Type Description

1 SEID I Superelement identification number

2 SEUPI I Upstream superelement identification number

Word 2 repeats until End of Record

Record – SNORM(5678,71,475)
Word Name Type Description

1 GID I Grid point identification number

2 CID I Coordinate system identification number

3 N1 RS Normal component in direction 1 of CID

4 N2 RS Normal component in direction 2 of CID

5 N3 RS Normal component in direction 3 of CID

Record – CSUPER1(5701,57,323)
This record is obsolete and is removed eventually.

Word Name Type Description

1 SEID I Superelement identification number

2 PSID I Primary superelement identification number

3 TYPE I ,{

DMAP Programmer's Guide 4-119


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 VIEW I ,{

5 DIROPT I ,{

6 DIRTOL RS ,{

7 GEOMTOL RS ,{

8 CARDID I ,{

9 MODEL I ,{

10 SOLID I ,{

11 DBSET I ,{

12 COPY I ,{

13 DELETE I ,{

14 GRIDLIST I ,{

15 XX I xx

XX =0 xx

16 G I ,{

17 C I ,{

Words 16 through 17 repeat until (-1,-1,-1) occurs

XX =-1 yy

End XX

Record – CSUPUP(5801,58,324)
This record is obsolete and is removed eventually.

Word Name Type Description

1 SEUP1 I ,{

2 PSID I Primary superelement identification number

3 SEDOWN1 I ,{

4 SEUP2 I ,{

5 PSID I Primary superelement identification number

4-120 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

6 SEDOWN2 I ,{

Record - TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

Notes:
1. CSUPER1 and CSUPUP records are recognized only by the 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.

5. On the SEBULK entry, the allowable values for superelement type are:
• 1=PRIMARY

• 2=COLLECTOR

• 3=IDENTICAL

• 4=REPEATED

• 5=EXTERNAL

• 6=MIRROR

6. GEOM168 is the same as GEOM1 except that:


• In Record - CORD2C, the locations of A, B, and C in coordinates 1, 2, and 3 of RID are
converted from RX to RS.

• In Record - CORD2R, the locations of A, B, and C in coordinates 1, 2, and 3 of RID are


converted from RX to RS.

• In Record - CORD2S, the locations of A, B, and C in coordinates 1, 2, and 3 of RID are


converted from RX to RS.

• In Record - POINT, the location of the point in coordinate 1, 2, or 3 of CID are converted
from RX to RS.

DMAP Programmer's Guide 4-121


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

• In Record - GRID, the location of the point in coordinate 1, 2, and 3 of CP are converted
from RX to RS.

4.7 GEOM4705
Table of Bulk Data entry images related to constraints (Pre-MSC Nastran 2001).
Table of Bulk Data entry images related to constraints, degree-of-freedom membership and rigid
element connectivity.
Note

See the Note 1 for a listing of the differences between GEOM4705 and GEOM4.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – ASET(5561,76,215)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 2 – ASET1(5571,77,216)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

4-122 DMAP Programmer's Guide


Data Block Descriptions F-M

Record 3 – BNDFIX(110,1,584)
Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 4 – BNDFIX1(210,2,585)
Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 5 – BNDFREE(310,3,586)
Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 6 – BNDFREE1(410,4,587)
Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

DMAP Programmer's Guide 4-123


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 7 – BNDGRID(10200,102,473)

Word Name Type Description

1 GPI I Shape boundary grid point identification number

Record 8 – BSET(110,1,311)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 9 – BSET1(210,2,312)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

4-124 DMAP Programmer's Guide


Data Block Descriptions F-M

Record 10 – CSET(310,3,313)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 11 – CSET1(410,4,314)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 12 – CYAX(1510,15,328)

Word Name Type Description

1 G I Grid point identification number on the axis of


symmetry

Word 1 repeats until End of Record

Record 13 – CYJOIN(5210,52,257)

Word Name Type Description

1 SIDE I Side identification number: 1 or 2

2 C(2) CHAR4 Coordinate system type on symetry booundary

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

DMAP Programmer's Guide 4-125


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record 14 – CYSUP(1610,16,329)

Word Name Type Description

1 GID I Grid or scalar point identification number

2 C I Component numbers

Record 15 – CYSYM(1710,17,330)

Word Name Type Description

1 NSEG I Number of segments

2 STYPE(2) CHAR4 Symmetry type

Record 16 – EGENDT(8801,88,9022)

Word Name Type Description

1 LOADID I Load set identification number

2 SPCID I SPC set identification number

3 EDGEID I Edge identification number

4 C I Component numbers

5 DISTFLG I Distribution flag

6 DISFUN I Distribution function (DEQATN)

7 DISTAB I Distribution table (TABLE3D)

8 FIELD(4) RS See GMBC record

Words 4 through 11 repeat 6 times

12 ELTYPE I Element type

13 EID I Element identification number

14 EORD I Edge order

15 EDGEID I Edge identification number

16 FACEID I Face identification number

17 CURVID I Curve identification number

18 SURFID I Surface identification number

4-126 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

19 G(2) I Grid point identification numbers

21 MIDG I

22 POINT(2) I Point identification numbers

24 F1ID I Grid-n 1 identification number

25 F2ID I Grid-n 2 identification number

26 NDOF I I,{

27 CIDE I Coordinate system identification number for the


edge

28 MAXNDFE I Maximum number of degrees-of-freedom, or stride,


for the edge

29 MAXNDFB I Maximum number of degrees-of-freedom, or stride,


for the body

30 PUSER I p-level specified by user

31 PSEL I p-level selected by program

32 BODYFID I Grid-n identification number for the body

33 NDOFB I Number of degrees-of-freedom for the body

34 F1ID I Grid-n 1 identification number

35 CID I Coordinate system identification number

36 X RS S,{

37 Y RS S,{

38 Z RS S,{

Words 34 through 38 repeat 7 times

Record 17 – FCENDT(9001,90,9024)

Word Name Type Description

1 LOADID I Load set identification number

2 SID I Set identification number

3 FACEID I Face identification number

DMAP Programmer's Guide 4-127


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

4 C I Component numbers

5 DISTFLG I Distribution flag

6 DISFUN I Distribution function (DEQATN)

7 DISTAB I Distribution table (TABLE3D)

8 FIELD(9) RS See GMBC record

Words 4 through 16 repeat 6 times

17 F1ID I Grid-n 1 identification number

18 F2ID I Grid-n 2 identification number

19 NDOF I Number of degrees-of-freedom for the face

20 MAXNDF I Maximum number of degrees-of-freedom or stride

21 CIDE I Coordinate system identification number of the


edge

Words 17 through 21 repeat 4 times

22 FACFID I Grid-n identification number for the face

23 NDOF I Number of degrees-of-freedom for the face

24 MAXNDFF I Maximum number of degrees-of-freedom for the


face

25 CIDF I Coordinate system identification number for the


face

26 ELTYPE I Element type

27 EID I Element identification number

28 EORD I Edge order

29 FACEID I Face identification number

30 SURFID I Surface identification number

31 G(4) I Grid point identification numbers

35 CIDF I Coordinate system identification number for the


face

36 MAXNDIF I

4-128 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

37 UNDEF None

38 PUSER(4) I p-level specified by user

42 PSEL(4) I p-level selected by program

46 FACFID I Grid-n identification number for the face

47 NDOF I Number of degrees-of-freedom for the face

48 F1ID I Grid-n 1 identification number

49 CID I Coordinate system identification number

50 X RS

51 Y RS

52 Z RS

Words 48 through 52 repeat 13 times

Record 18 – GMBC(8001,80,395)

Word Name Type Description

1 LID I Load set identification number

2 SPCID I SPC set identification number

3 C I Component number

4 ENTITY CHAR4 Entity type that is being loaded

5 ENTID I Entity identification number

6 METHOD I Method of data specification

METHOD =1 TABLE3D

7 TABLID I TABLE3D identification number

8 UNDEF(8 ) None

METHOD =2 DEQATN

7 EQTNID I DEQATN identification number

8 UNDEF(8 ) None

METHOD =3 CONSTANT

DMAP Programmer's Guide 4-129


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 FIELD(9) RS Enforced displacement data

METHOD =4 LINEAR

7 FIELD(9) RS Enforced displacement data

METHOD =5 QUAD

7 FIELD(9) RS Enforced displacement data

METHOD =6 CUBIC

7 FIELD(9) RS Enforced displacement data

End METHOD

Record 19 – GMSPC(7801,78,393)

Word Name Type Description

1 ID I Set identification number

2 C I Component number

3 ENTITY CHAR4 Entity type that is being loaded

4 ENTID I Entity identification number

Record 20 – MPC(4901,49,17)

Word Name Type Description

1 SID I Set identification number

2 G I Grid point identification number

3 C I Component number

4 A RS Coefficient

5 GI I Grid point identification number

6 CI I Component number

7 AI RS Coefficient

Words 5 through 7 repeat until (-1,-1,-1) occurs

4-130 DMAP Programmer's Guide


Data Block Descriptions F-M

Record 21 – MPCADD(4891,60,83)

Word Name Type Description

1 SID I Set identification number

2 S I Set identification number

Word 2 repeats until End of Record

Record 22 – OMIT(5001,50,15)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 23 – OMIT1(4951,63,92)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 24 – QSET(510,5,315)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

DMAP Programmer's Guide 4-131


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record 25 – QSET1(610,6,316)

Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 26 – RBAR(6601,66,292)

Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 CNA I Component numbers of independent


degrees-of-freedom at end A

5 CNB I Component numbers of independent


degrees-of-freedom at end B

6 CMA I Component numbers of dependent


degrees-of-freedom at end A

7 CMB I Component numbers of dependent


degrees-of-freedom at end B

Record 27 – RBE1(6801,68,294)

Word Name Type Description

1 EID I Element identification number

4-132 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 GN I Grid point identification number for independent


degrees-of-freedom

3 CN I Component numbers of independent


degrees-of-freedom

Words 2 through 3 repeat until (-2,-2) occurs

4 GM I Grid point identification number for dependent


degrees-of-freedom

5 CM I Component numbers of dependent


degrees-of-freedom

Words 4 through 5 repeat until (-1,-1) occurs

Record 28 – RBE2(6901,69,295)

Word Name Type Description

1 EID I Element identification number

2 GN I Grid point identification number for independent


degrees-of-freedom

3 CM I Component numbers of dependent


degrees-of-freedom

4 GM I Grid point identification number for dependent


degrees-of-freedom

Word 4 repeats until -1 occurs

Record 29 – RBE3(7101,71,187)

Word Name Type Description

1 EID I Element identification number

2 REFG I Reference grid point identification number

3 REFC I Component numbers at the reference grid point

4 WT1 RS Weighting factor for components of motion at G

5 C I Component numbers

6 G I Grid point identification number

DMAP Programmer's Guide 4-133


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

Word 6 repeats until -1 occurs

Words 4 through 6 repeat until -2 occurs

7 GM I Grid point identification number for dependent


degrees-of-freedom

8 CM I Component numbers of dependent


degrees-of-freedom

Words 7 through 8 repeat until -3 occurs

Record 30 – RELEASE(1310,13,247)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 31– RROD(6501,65,291)

Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 CMA I Component numbers of dependent


degrees-of-freedom at end A

4-134 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

5 CMB I Component numbers of dependent


degrees-of-freedom at end B

Record 32– RSPLINE(7001,70,186)

Word Name Type Description

1 EID I Element identification number

2 DBYL RS Ratio of the diameter to the sum of the segments


lengths

3 G1 I Grid point identification number

4 G2 I Grid point identification number

5 C2 I Components to be constrained

Words 4 through 5 repeat until (-1,-1) occurs

Record 33– RSSCON(7201,72,398)

Word Name Type Description

1 EID I Element identification number

2 TYPE(C) I Type of connectivity

TYPE =0 GRID style 1

3 GRID1 I Grid identification number 1

4 GRID2 I Grid identification number 2

5 GRID3 I Grid identification number 3

6 UNDEF(3 ) None

TYPE =01 GRID style 2

3 GRID1 I Grid identification number 1

4 GRID2 I Grid identification number 2

5 GRID3 I Grid identification number 3

6 GRID4 I Grid identification number 4

7 GRID5 I Grid identification number 5

DMAP Programmer's Guide 4-135


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

8 GRID6 I Grid identification number 6

TYPE =02 Edge style

3 EDGE1 I Edge identification number 1

4 EDGE2 I Edge identification number 2

5 EDGE3 I Edge identification number 3

6 UNDEF(3 ) None

TYPE =03 Element style

3 ELID1 I Element identification number 1

4 ELID2 I Element identification number 2

5 UNDEF(4 ) None

TYPE =04 CINTERF

3 CBID I

4 SBID I

5 CBPID I

6 UNDEF(3) None

End TYPE

Record 34 – RTRPLT(6701,67,293)

Word Name Type Description

1 EID I Element identification number

2 GA I Grid point A identification number

3 GB I Grid point B identification number

4 GC I Grid point C identification number

5 CNA I Component numbers for independent


degrees-of-freedom at vertex A

6 CNB I Component numbers for independent


degrees-of-freedom at vertex B

4-136 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

7 CNC I Component numbers for independent


degrees-of-freedom at vertex C

8 UNDEF None

9 CMA I Component numbers for dependent


degrees-of-freedom at vertex A

10 CMB I Component numbers for dependent


degrees-of-freedom at vertex B

11 CMC I Component numbers for dependent


degrees-of-freedom at vertex C

Record 35 – RWELD(11901,119,561)

Word Name Type Description

1 EID I Element ID

2 GA I Grid ID of GA

3 TYPE I Type of shell element

4 GI(8) I Grid IDs of shell element

12 GS I Grid ID of GS

Record 36 – SEBSET(710,7,317)

Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record 37 – SEBSET1(810,8,318)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

DMAP Programmer's Guide 4-137


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 38 – SECSET(910,9,319)

Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record 39 – SECSET1(1010,10,320)

Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

4-138 DMAP Programmer's Guide


Data Block Descriptions F-M

Record 40 – SEQSET(1110,11,321)
Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record 41 – SEQSET1(1210,12,322)
Word Name Type Description

1 SEID I Superelement identification number

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 42 – SESUP(1410,14,325)
Word Name Type Description

1 SEID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

Record 43 – SEUSET(1810,18,334)
Word Name Type Description

1 SEID I Superelement identification number

2 SNAME I Set name

DMAP Programmer's Guide 4-139


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 ID I Grid or scalar point identification number

4 C I Component numbers

Record 44 – SEUSET1(1910,19,335)

Word Name Type Description

1 SEID I Superelement identification number

2 SNAME I Set name

3 C I Component numbers

4 THRUFLAG I Thru range flag

THRUFLAG=0 No

5 ID I Grid or scalar point identification number

Word 5 repeats until End of Record

THRUFLAG=1 Yes

5 ID1 I First grid or scalar point identification number

6 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 45 – SPC(5501,55,16)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

Record 46 – SPC1(5481,58,12)

Word Name Type Description

1 SID I Set identification number

4-140 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 47 – SPCADD(5491,59,13)

Word Name Type Description

1 SID I Set identification number

2 S I Set identification number

Word 2 repeats until End of Record

Record 48 – SPCD(5110,51,256)

Word Name Type Description

1 SID I Superelement identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

Record 49 – SPCDE(8701,87,9021)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

DMAP Programmer's Guide 4-141


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 C I Component numbers

4 D RS Enforced displacement

5 EDGEID I Edge identification number

6 SID I Set identification number

Record 50 – SPCDF(8901,89,9023)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 FACEID I Face identification number

6 SID I Set identification number

Record 51 – SPCDG(9701,97,9030)

Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 METHOD I Method

5 D RS Enforced displacement

6 SID I Set identification number

Record 52 – SPCE(9301,93,9027)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

4-142 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 C I Component numbers

4 D RS Enforced displacement

5 EDGID I Grid or scalar point identification number

Record 53 – SPCEB(9101,91,9025)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 EDGEID I Edge identification number

Record 54 – SPCF(9401,94,9028)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 FACEID I Face identification number

Record 55 – SPCFB(9201,92,9026)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 D RS Enforced displacement

5 LOADID I Load set identification number

DMAP Programmer's Guide 4-143


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record 56 – SPCGB(9601,96,9029)
Word Name Type Description

1 LOADID I Load set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 METHOD I I,{

5 D RS Enforced displacement

6 SID I Set identification number

Record 57 – SPCGRID(8601,86,9031)
Word Name Type Description

1 SID I Set identification number

2 ID I Grid or scalar point identification number

3 C I Component numbers

4 UNDEF(2 ) None

Record 58 – SPCOFF(6110,61,343)
Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 59 – SPCOFF1(6210,62,344)
Word Name Type Description

1 C I Component numbers

2 THRUFLAG I Thru range flag

THRUFLAG=0 No

3 ID I Grid or scalar point identification number

Word 3 repeats until End of Record

THRUFLAG=1 Yes

4-144 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

3 ID1 I First grid or scalar point identification number

4 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 60 – SUPORT(5601,56,14)

Word Name Type Description

1 ID I Grid or scalar point identification number

2 C I Component numbers

Record 61 – SUPORT1(10100,101,472)

Word Name Type Description

1 SID I Set identification number

2 ID I Grid point identification number

3 C I Component numbers

Words 2 through 3 repeat until (-1,-1) occurs

Record 62 – TEMPBC(11309,113,426)

Word Name Type Description

1 SID I Temperature set identification number

2 TYPE I Type of temperature boundary condition: STAT or


TRAN

3 TEMP RS Temperature

4 GID I Grid or scalar point identification number

Record 63 – USET(2010,20,193)

Word Name Type Description

1 SNAME I Set name

2 ID I Grid or scalar point identification number

DMAP Programmer's Guide 4-145


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 C I Component numbers

Record 64 – USET1(2110,21,194)
Word Name Type Description

1 SNAME I Set name

2 C I Component numbers

3 THRUFLAG I Thru range flag

THRUFLAG=0 No

4 ID I Grid or scalar point identification number

Word 4 repeats until End of Record

THRUFLAG=1 Yes

4 ID1 I First grid or scalar point identification number

5 ID2 I Second grid or scalar point identification number

End THRUFLAG

Record 65 – TRAILER
Word Name Type Description

1 BIT(6) I Record presence trailer words

Notes:
1. GEOM4705 is the same as GEOM4 except that:
• In Record - MPC, coefficients A and AI are converted from RX to RS.

• ALF is stripped from Record - RBAR. The record size is reduced from 8 words to 7 words.

• ALF and UNDEF are stripped from Record - RBE1. The record size is reduced from 7 words
to 5 words.

• ALF is stripped from Record - RBE2. The record size is reduced from 5 words to 4 words.

• ALF is stripped from Record - RBE3. The record size is reduced from 9 words to 8 words.

• ALF is stripped from Record - RROD. The record size is reduced from 6 words to 5 words.

4-146 DMAP Programmer's Guide


Data Block Descriptions F-M

• ALF is stripped from Record - RTRPLT. The record size is reduced from 12 words to 11 words.

4.8 GPDT
Grid point definition table.
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 Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – POINT
Word Name Type Description

1 ID I Internal grid point identification number

2 CP I Location coordinate system identification number

3 X1 RX Location of the point in coordinate 1 of CP (X, R or Rho)

4 X2 RX Location of the point in coordinate 2 of CP (Y, Theta or


Theta)

5 X3 RX Location of the point in coordinate 3 of CP (Z, Phi or Phi)

6 CD I Degree-of-freedom coordinate system identification


number

7 PS I Permanent single-point constraints

Record 2 – TRAILER
Word Name Type Description

1 WORD1 I Number of grid points and scalar points

2 UNDEF(5 ) None

Notes:
1. Scalar points are identified by CP=-1 and words X1 through PS are zero.

DMAP Programmer's Guide 4-147


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

2. See the “GRID” bulk entry in the NX Nastran Quick Reference Guide for a description of the
PS constraint code.

3. For fluid grid points, CD=-1.

4.9 GPDT68
Grid point definition table (Pre-MSC Nastran 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.
Note

See the Note 4 for a listing of the differences between GPDT68 and GPDT.

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – POINT
Word Name Type Description

1 ID I Internal grid point identification number

2 CP I Location coordinate system identification number

3 X1 RS Location of the point in coordinate 1 of CP (X, R or Rho)

4 X2 RS Location of the point in coordinate 2 of CP (Y, Theta or


Theta)

5 X3 RS Location of the point in coordinate 3 of CP (Z, Phi or Phi)

6 CD I Degree-of-freedom coordinate system identification


number

7 PS I Permanent single-point constraints

Record 2 – TRAILER
Word Name Type Description

1 WORD1 I Number of grid points and scalar points

2 UNDEF(5 ) None

4-148 DMAP Programmer's Guide


Data Block Descriptions F-M

Notes:

1. Scalar points are identified by CP=-1 and words X1 through PS are zero.

2. See the “GRID” bulk entry in the NX Nastran Quick Reference Guide for a description of the
PS constraint code.

3. For fluid grid points, CD=-1.

4. GPDT68 is the same as GPDT except that:

• In Record - POINT, X1, X2, and X3 are converted from RX to RS.

4.10 GPL
Grid point list.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 SEID I Superelement identification number

Record 1 – GRID

Contains a list of external grid and scalar identification numbers in internal sort.

Word Name Type Description

1 GRIDID I 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 Name Type Description

1 GRIDID I External grid or scalar identification number

2 SEQNO I Sequence number = 1000 * external identification


number

DMAP Programmer's Guide 4-149


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record 3 – TRAILER

Word Name Type Description

1 NGS I Total number of grid and scalar points

2 UNDEF(5) None

Notes:
1. SEQNO, sequence number, can be overridden by the SEQGP Bulk Data entry.

2. With OMACHPR = NO, the MAKEOLD module removes the extra grids associated with Lagrange
rigids.

4.11 HIS
Table of design iteration history
Contains a compilation of information from the convergence checks.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – Repeat

Word Name Type Description

1 DSITER I Design iteration number

2 CVTYP I Convergence type: 1=soft or 2=hard

3 CVPROV I Convergence result: 0=no, 1=soft, or 2=hard

4 OBJ1 RS Initial objective value

5 OBJO RS Final objective value

6 GMAX RS Maximum constraint value

7 IRMAX I Row of the maximum constraint value

8 XVAL RS Design variable value

Word 8 repeats until End of Record

4-150 DMAP Programmer's Guide


Data Block Descriptions F-M

Record 2 – TRAILER

Word Name Type Description

1 NDV I Number of design variables

2 UNDEF(5 ) None

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.12 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 Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – Repeat
Repeats for each element type.

Word Name Type Description

1 ELTYPE I Element type

2 NUMWDS I Number of words per entry

3 NUMGRID(C) I Number of defined grid points

4 DOFPERG I Degrees of freedom per grid point

5 FORM(C) I Form of element matrix

Words 6 through max repeat until End of Record

6 EID I Element identification number

DMAP Programmer's Guide 4-151


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

7 NACTIVEG I Number of active grid points

8 GE RS Material damping constant

9 ADDRESS1 I GINO address of matrix

10 ADDRESS2 I GINO address of matrix

FORM =3 Lower left triangle in global coord. system

11 SIL I SIL values of connected grid points

Word 11 repeats NUMGRID times

FORM =4 Lower left triangle and transformation matrices

11 SIL I SIL values of connected grid points

Word 11 repeats NUMGRID times

12 E11 RX Element to basic transformation

13 E21 RX Element to basic transformation

14 E31 RX Element to basic transformation

15 E12 RX Element to basic transformation

16 E22 RX Element to basic transformation

17 E32 RX Element to basic transformation

18 E13 RX Element to basic transformation

19 E23 RX Element to basic transformation

20 E33 RX Element to basic transformation

FORM =5 Lower left triangle in basic coordinate system

11 SIL I SIL values of connected grid points

Word 11 repeats NUMGRID times

End FORM

Record 2 – TRAILER

Word Name Type Description

1 PREC I Precision of element matrices (1 or 2)

4-152 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

2 MAXROW I Maximum number of rows in an element matrix

3 MAXGRID I Maximum number of grid points in a FORM=4


record

4 UNDEF(3 ) None

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.13 LAMA
Normal modes or buckling eigenvalue summary table

Record 0 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – OFPID – OFP Header Record


Word Name Type Description

1 RECID(2) I Constants 21 and 6

3 UNDEF(7 ) None

10 SEVEN I Constant 7

11 RESFLG I Residual vector augmentation flag

12 UNDEF(39 ) None

51 TITLE(32) CHAR4 Title character string (TITLE)

83 SUBTITLE(32) CHAR4 Subtitle character string (SUBTITLE)

115 LABEL(32) CHAR4 LABEL character string (LABEL)

DMAP Programmer's Guide 4-153


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record 2 – LAMA
Repeats for each eigenvalue.

Word Name Type Description

1 MODE I Mode number

2 ORDER I Extraction order

3 EIGEN RS Eigenvalue

4 OMEGA RS Square root of eigenvalue

5 FREQ RS Frequency

6 MASS RS Generalized mass

7 STIFF RS Generalized stiffness

Record 3 – TRAILER

Word Name Type Description

1 NMODES I Number of modes

2 UNDEF(6 ) None

4.14 MPT
Table of Bulk Data entry images related to material properties

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – CREEP(1003,10,245)

Word Name Type Description

1 MID I Material identification number

2 T0 RS Reference temperature

3 EXP RS Temperature-dependent term in the creep rate


expression

4-154 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 FORM I Form of the input data: "CRLAW" or "TABLE"

5 TIDKP I TABLES1 ID which defines creep model parameter Kp

6 TIDCP I TABLES1 ID which defines creep model parameter Cp

7 TIDCS I TABLES1 ID which defines creep model parameter Cs

8 THRESH RS Threshold limit for creep process

9 TYPE I Empirical creep law identification number

10 AG(7) RS Coefficients of the empirical creep law

Record – MAT1(103,1,77)

Word Name Type Description

1 MID I Material identification number

2 E RS Young’s modulus

3 G RS Shear modulus

4 NU RS Poisson’s ratio

5 RHO RS Mass density

6 A RS Thermal expansion coefficient

7 TREF RS Reference temperature

8 GE RS Structural element damping coefficient

9 ST RS Stress limit for tension

10 SC RS Stress limit for compression

11 SS RS Stress limit for shear

12 MCSID I Material coordinate system identification number

Record – MAT2(203,2,78)

Word Name Type Description

1 MID I Material identification number

2 CIJ(6) RS Material property matrix

DMAP Programmer's Guide 4-155


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

8 RHO RS Mass density

9 AJ(3) RS Thermal expansion coefficients

12 TREF RS Reference temperature

13 GE RS Structural element damping coefficient

14 ST RS Stress limit for tension

15 SC RS Stress limit for compression

16 SS RS Stress limit for shear

17 MCSID I Material coordinate system identification number

Record – MAT3(1403,14,122)

Word Name Type Description

1 MID I Material identification number

2 EX RS Young’s modulus in the x direction

3 ETH RS Young’s modulus in the theta direction

4 EZ RS Young’s modulus in the z direction

5 NUXTH RS Poisson’s ratios in x-theta direction

6 NUTHZ RS Poisson’s ratios in theta-z direction

7 NUZX RS Poisson’s ratios in z-x direction

8 RHO RS Mass density

9-10 UNDEF(2) None

11 GZX RS Shear modulus in the z-x direction

12 AX RS Thermal expansion coefficient in the x direction

13 ATH RS Thermal expansion coefficient in the theta direction

14 AZ RS Thermal expansion coefficient in the z direction

15 TREF RS Reference temperature

16 GE RS Structural element damping coefficient

4-156 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – MAT4(2103,21,234)

Word Name Type Description

1 MID I Material identification number

2 K RS Thermal conductivity

3 CP RS Heat capacity per unit mass at constant pressure

4 RHO RS Mass density

5 H RS Free convection heat transfer coefficient

6 MU RS Dynamic viscosity

7 HGEN RS Heat generation capability used with QVOL entries

8 REFENTH RS Reference enthalpy

9 TCH RS Lower temperature limit for phase change region

10 TDELTA RS Total temperature change range

11 QLAT RS Latent heat of fusion per unit mass

Record – MAT5(2203,22,235)

Word Name Type Description

1 MID I Material identification number

2 KIJ(6) RS Thermal conductivity matrix

8 CP RS Heat capacity per unit mass

9 RHO RS Mass density

10 HGEN RS Heat generation capability used with QVOL entries

Record – MAT8(2503,25,288)

Word Name Type Description

1 MID I Material identification number

2 E1 RS Modulus of elasticity in longitudinal direction

3 E2 RS Modulus of elasticity in lateral direction

4 NU12 RS Poisson’s ratio

DMAP Programmer's Guide 4-157


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

5 G12 RS In-plane shear modulus

6 G1Z RS Transverse shear modulus for shear in 1-Z plane

7 G2Z RS Transverse shear modulus for shear in 2-Z plane

8 RHO RS Mass density

9 A1 RS Thermal expansion coefficient in longitudinal direction

10 A2 RS Thermal expansion coefficient in lateral direction

11 TREF RS Reference temperature for the calculation of thermal


loads

12 XT RS Allowable longitudinal stress or strain in tension

13 XC RS Allowable longitudinal stress or strain in compression

14 YT RS Allowable lateral stress or strain in tension

15 YC RS Allowable lateral stress or strain in compression

16 S RS Allowable stress or strain for in-plane shear

17 GE RS Structural damping coefficient

18 F12 RS Interaction term in the tensor polynomial theory of


Tsai-Wu

19 STRN RS For the maximum strain theory only

Record – MAT9(2603,26,300)

Word Name Type Description

1 MID I Material identification number

2 G(21) RS Material property matrix

23 RHO RS Mass density

24 A(6) RS Thermal expansion coefficients

30 TREF RS Reference temperature for the calculation of


thermal loads

31 GE RS Structural damping coefficient

32 UNDEF(4 ) None

4-158 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – MAT10(2801,28,365)

Word Name Type Description

1 MID I Material identification number

2 BULK RS Bulk modulus

3 RHO RS Mass density

4 C RS Speed of sound

5 GE RS Structural damping coefficient

6 ALPHA RS Temporal damping coefficient

7 TIDBULK I Identification number of TABLEDi bulk entry that


defines frequency-dependent bulk modulus

8 TIDRHO I Identification number of TABLEDi bulk entry that


defines frequency-dependent mass density

9 TIDGE I Identification number of TABLEDi bulk entry that


defines frequency-dependent structural damping
coefficient

10 TIDALPHA I Identification number of TABLEDi bulk entry that


defines frequency-dependent temporal damping
coefficient

Record – MAT11(2903,29,371)

Solid element orthotropic material property definition.

Defines the material properties for a 3-D orthotropic material for isoparametric solid elements.

Word Name Type Description

1 MID I Material identification number

2 E1 RS Modulus of elasticity in the longitudinal direction or


1-direction

3 E2 RS Modulus of elasticity in the lateral direction or


2-direction

4 E3 RS Modulus of elasticity in the thickness direction or


3-direction

5 NU12 RS Poisson's ratio (ε2/ε1 for uniaxial loading in the


1-direction)

DMAP Programmer's Guide 4-159


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

6 NU13 RS Poisson's ratio (ε3/ε1 for uniaxial loading in the


1-direction)

7 NU23 RS Poisson's ratio (ε3/ε2 for uniaxial loading in the


2-direction)

8 G12 RS In-plane shear modulus

9 G13 RS Transverse shear modulus for shear in the 1–3 plane

10 G23 RS Transverse shear modulus for shear in the 2–3 plane

11 RHO RS Mass density

12 A1 RS Thermal expansion coefficient in the longitudinal


direction

13 A2 RS Thermal expansion coefficient in the lateral direction

14 A3 RS Thermal expansion coefficient in the thickness


direction

15 TREF RS Reference temperature for calculation of thermal


loads

16 GE RS Structural damping coefficient

17 UNDEF(16) None

Record – MATCRP(4603,46,623)

Word Name Type Description

1 MID I Material identification number

2 TYPE I Identification of creep law

3 THRESH RS Threshold limit for creep process

4 HARD Char4 Hardening rule: "STRAIN" or "TIME"

5 TID I TABLE ID

6 T0 RS Reference temperature at which creep


characteristics are defined

9 EXP RS Temperature-dependent term in the creep rate


expression

4-160 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

TCODE(C) If TCODE(C)=1, integer data follows defining a table ID defining


temperature dependent material coefficient data
If TCODE(C)=2, real data follows defining a creep coefficient

10 TCODE(C) 1, 2 Defines data type

11 A I or RS Creep coefficient data

12 TCODE(C) 1, 2 Defines data type

13 B I or RS Creep coefficient data

14–15 UNDEF(2)

16 TCODE(C) 1, 2 Defines data type

17 C I or RS Creep coefficient data

18–25 UNDEF(8)

Record – MATFT(3403,34,902)

Word Name Type Description

1 MID I Material identification number

2 FTOPT I Failure theory option

FTOPT=1 Hill failure theory

3 XT RS Allowable longitudinal stress in tension

4 XC RS Allowable longitudinal stress in compression

5 YT RS Allowable lateral stress in tension

6 YC RS Allowable lateral stress in compression

7 ZT RS Allowable transverse stress in tension

8 ZC RS Allowable transverse stress in compression

9 SXY RS Allowable shear stress in the xy-plane

10 SXZ RS Allowable shear stress in the xz-plane

11 SYZ RS Allowable shear stress in the yz-plane

FTOPT=2 Hoffman failure theory

DMAP Programmer's Guide 4-161


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 XT RS Allowable longitudinal stress in tension

4 XC RS Allowable longitudinal stress in compression

5 YT RS Allowable lateral stress in tension

6 YC RS Allowable lateral stress in compression

7 ZT RS Allowable transverse stress in tension

8 ZC RS Allowable transverse stress in compression

9 SXY RS Allowable shear stress in the xy-plane

10 SXZ RS Allowable shear stress in the xz-plane

11 SYZ RS Allowable shear stress in the yz-plane

FTOPT=3 Tsai-Wu failure theory

3 XT RS Allowable longitudinal stress in tension

4 XC RS Allowable longitudinal stress in compression

5 YT RS Allowable lateral stress in tension

6 YC RS Allowable lateral stress in compression

7 ZT RS Allowable transverse stress in tension

8 ZC RS Allowable transverse stress in compression

9 SXY RS Allowable shear stress in the xy-plane

10 SXZ RS Allowable shear stress in the xz-plane

11 SYZ RS Allowable shear stress in the yz-plane

12 F12 RS Interaction term in the tensor polynomial theory

13 F13 RS Interaction term in the tensor polynomial theory

14 F23 RS Interaction term in the tensor polynomial theory

FTOPT=4 Maximum strain failure theory

3 XT RS Allowable longitudinal strain in tension

4 XC RS Allowable longitudinal strain in compression

5 YT RS Allowable lateral strain in tension

6 YC RS Allowable lateral strain in compression

4-162 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

7 ZT RS Allowable transverse strain in tension

8 ZC RS Allowable transverse strain in compression

9 SXY RS Allowable shear strain in the xy-plane

10 SXZ RS Allowable shear strain in the xz-plane

11 SYZ RS Allowable shear strain in the yz-plane

FTOPT=5 Maximum stress failure theory

3 XT RS Allowable longitudinal stress in tension

4 XC RS Allowable longitudinal stress in compression

5 YT RS Allowable lateral stress in tension

6 YC RS Allowable lateral stress in compression

7 ZT RS Allowable transverse stress in tension

8 ZC RS Allowable transverse stress in compression

9 SXY RS Allowable shear stress in the xy-plane

10 SXZ RS Allowable shear stress in the xz-plane

11 SYZ RS Allowable shear stress in the yz-plane

FTOPT=6 Maximum transverse shear stress failure theory

3 SXZ RS Allowable shear stress in the xz-plane

4 SYZ RS Allowable shear stress in the yz-plane

Words 2 thru the last word of the selected option repeat until -1 is reached

Record – MATG (8310,83,403)

Word Name Type Description

1 MID I Material identification number

2 IDMEM I ID of MAT1

3 BEHAV I Behavior type (not used)

4 TABLD I ID of TABLES1

5 TABLUi I ID of TABLES1 (I=1 to 10)

DMAP Programmer's Guide 4-163


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

15 YPRS RS Initial yield pressure

16 EPL RS Tensile modulus

17 GPL RS Transverse shear modulus

18 GAP RS Initial gap (not used)

19 TABYPRS I ID of TABLES1 (not used)

20 TABEPL I ID of TABLES1 (not used)

21 TABGPL I ID of TABLES1 (not used)

22 TABGAP I ID of TABLES1 (not used)

Record – MATHE(7910,79,596)
MATHE format for Mooney-Rivlin (default) model (Model = Mooney in MATHE bulk entry):

Word Name Type Description

1 MID I Material identification number

2 MODEL I MODEL = 1 for Mooney-Rivlin model

3 UNDEF None

4 K RS Bulk Modulus

5 RHO RS Mass density

6 TEXP RS Coefficient of thermal expansion

7 TREF RS Reference temperature (not used)

8 GE RS Structural damping (not used)

9 C10 RS Material constant

10 C01 RS Material constant

11 UNDEF None

12 TAB1 I Table ID (not used)

13 TAB2 I Table ID (not used)

14 TAB3 I Table ID (not used)

15 TAB4 I Table ID (not used)

4-164 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

16 TABD I Table ID (not used)

17 C20 RS Material constant

18 C11 RS Material constant

19 C02 RS Material constant

20 C30 RS Material constant

21 C21 RS Material constant

22 C12 RS Material constant

23 C03 RS Material constant

24 -1 I Delimiter

MATHE format for Ogden model (Model = Ogden in MATHE bulk entry):

Word Name Type Description

1 MID I Material identification number

2 MODEL I MODEL = 2 for Ogden model

3 NOT I Curve fitting terms (not used)

4 K RS Bulk Modulus

5 RHO RS Mass density

6 TEXP RS Coefficient of thermal expansion

7 TREF RS Reference temperature (not used)

8 GE RS Structural damping (not used)

9 MU1 RS Coefficient

10 ALPHA1 RS Coefficient

11 BETA1 None Coefficient

12 TAB1 I Table ID (not used)

13 TAB2 I Table ID (not used)

14 TAB3 I Table ID (not used)

15 TAB4 I Table ID (not used)

DMAP Programmer's Guide 4-165


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

16 TABD I Table ID (not used)

17 MU2 RS Coefficient

18 ALPHA2 RS Coefficient

19 BETA2 RS Coefficient

20 MU3 RS Coefficient

21 ALPHA3 RS Coefficient

22 BETA3 RS Coefficient

23 MU4 RS Coefficient

24 ALPHA4 RS Coefficient

25 BETA4 RS Coefficient

26 MU5 RS Coefficient

27 ALPHA5 RS Coefficient

28 BETA5 RS Coefficient

29 MU6 RS Coefficient

30 ALPHA6 RS Coefficient

31 BETA6 RS Coefficient

32 MU7 RS Coefficient

33 ALPHA7 RS Coefficient

34 BETA7 RS Coefficient

35 MU8 RS Coefficient

36 ALPHA8 RS Coefficient

37 BETA8 RS Coefficient

38 MU9 RS Coefficient

39 ALPHA9 RS Coefficient

40 BETA9 RS Coefficient

41 -1 I Delimiter

4-166 DMAP Programmer's Guide


Data Block Descriptions F-M

MATHE format for Hyperfoam model (Model = Foam in MATHE bulk entry):

Word Name Type Description

1 MID I Material identification number

2 MODEL I MODEL = 3 for Hyperfoam model

3 NOT I Curve fitting terms (not used)

4 K RS Bulk Modulus

5 RHO RS Mass density

6 TEXP RS Coefficient of thermal expansion

7 TREF RS Reference temperature (not used)

8 GE RS Structural damping (not used)

9 MU1 RS Coefficient

10 ALPHA1 RS Coefficient

11 BETA1 None Coefficient

12 TAB1 I Table ID (not used)

13 TAB2 I Table ID (not used)

14 TAB3 I Table ID (not used)

15 TAB4 I Table ID (not used)

16 TABD I Table ID (not used)

17 MU2 RS Coefficient

18 ALPHA2 RS Coefficient

19 BETA2 RS Coefficient

20 MU3 RS Coefficient

21 ALPHA3 RS Coefficient

22 BETA3 RS Coefficient

23 MU4 RS Coefficient

24 ALPHA4 RS Coefficient

25 BETA4 RS Coefficient

26 MU5 RS Coefficient

DMAP Programmer's Guide 4-167


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

27 ALPHA5 RS Coefficient

28 BETA5 RS Coefficient

29 MU6 RS Coefficient

30 ALPHA6 RS Coefficient

31 BETA6 RS Coefficient

32 MU7 RS Coefficient

33 ALPHA7 RS Coefficient

34 BETA7 RS Coefficient

35 MU8 RS Coefficient

36 ALPHA8 RS Coefficient

37 BETA8 RS Coefficient

38 MU9 RS Coefficient

39 ALPHA9 RS Coefficient

40 BETA9 RS Coefficient

41 -1 I Delimiter

MATHE format for Arruda-Boyce model (Model = Aboyce in MATHE bulk entry):

Word Name Type Description

1 MID I Material identification number

2 MODEL I MODEL = 4 for Arruda-Boyce model

3 UNDEF None

4 K RS Bulk Modulus

5 RHO RS Mass density

6 TEXP RS Coefficient of thermal expansion

7 TREF RS Reference temperature (not used)

8 GE RS Structural damping (not used)

9 NKT RS Material constant

4-168 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

10 N RS Material constant

11 UNDEF None

12 TAB1 I Table ID (not used)

13 TAB2 I Table ID (not used)

14 TAB3 I Table ID (not used)

15 TAB4 I Table ID (not used)

16 TABD I Table ID (not used)

17 -1 I Delimiter

MATHE format for Sussman-Bathe model (Model=Sussbat in MATHE bulk entry):

Word Name Type Description

1 MID I Material identification number

2 MODEL I MODEL = 5 for Sussman-Bathe model

3 UNDEF None

4 K RS Bulk Modulus

5 RHO RS Mass density

6 TEXP RS Coefficient of thermal expansion

7 TREF RS Reference temperature (not used)

8 GE RS Structural damping (not used)

9 TAB1 I Table ID

10 SSTYPE I Type of stress-strain data entered in TAB1

11 RELERR RS Relative error

12 UNDEF(5) None

17 -1 I Delimiter

Record – MATHEM(3501,35,977)
Word Name Type Description

1 MID I Material identification number

DMAP Programmer's Guide 4-169


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 R RS Material constant of Ogden-Roxburgh model for


Mullins effect

3 M RS Material constant of Ogden-Roxburgh model for


Mullins effect

4 HGEN RS Fraction of energy dissipated by Mullins effect model

5 UNDEF(4) None

Record – MATHEV(3601,36,976)

Word Name Type Description

1 MID I Material identification number

2 SHIFT I Time-temperature superposition shift law

3 C1 RS Material constant for the WLF or Arrhenius shift


functions

4 C2 RS Material constant for the WLF or Arrhenius shift


functions

5 TREF RS Reference temperature used by the WLF or


Arrhenius shift functions

6 UNDEF(3) None

9 BETA RS Beta factor for chain of the viscoelastic model

10 TAU RS Relaxation time for chain of the viscoelastic model

11 HGEN RS Fraction of energy dissipation that is considered as


heat generation

12 USAGE I Usage of chain

Words 9 through 12 repeat until -1 occurs

Record – MATHP(4506,45,374)

Word Name Type Description

1 MID I Material identification number

2 A10 RS Material constant related to distortional deformation

3 A01 RS Material constant related to distortional deformation

4-170 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

4 D1 RS Material constant related to volumetric deformation

5 RHO RS Mass density

6 ALPHA RS Coefficient of volumetric thermal expansion

7 TREF RS Reference temperature

8 GE RS Structural damping element coefficient

9 SF I ???

10 NA I Order of the distortional strain energy polynomial


function

11 ND I Order of the volumetric strain energy polynomial


function

12 KP RS ???

13 A20 RS Material constant related to distortional deformation

14 A11 RS Material constant related to distortional deformation

15 A02 RS Material constant related to distortional deformation

16 D2 RS Material constant related to volumetric deformation

17 A30 RS Material constant related to distortional deformation

18 A21 RS Material constant related to distortional deformation

19 A12 RS Material constant related to distortional deformation

20 A03 RS Material constant related to distortional deformation

21 D3 RS Material constant related to volumetric deformation

22 A40 RS Material constant related to distortional deformation

23 A31 RS Material constant related to distortional deformation

24 A22 RS Material constant related to distortional deformation

25 A13 RS Material constant related to distortional deformation

26 A04 RS Material constant related to distortional deformation

27 D4 RS Material constant related to volumetric deformation

28 A50 RS Material constant related to distortional deformation

DMAP Programmer's Guide 4-171


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

29 A41 RS Material constant related to distortional deformation

30 A32 RS Material constant related to distortional deformation

31 A23 RS Material constant related to distortional deformation

32 A14 RS Material constant related to distortional deformation

33 A05 RS Material constant related to distortional deformation

34 D5 RS Material constant related to volumetric deformation

35 CONTFLG I Continuation flag

CONTFLG =1 With continuation

36 TAB1 I TABLES1 identification number which defines


tension/compression

37 TAB2 I TABLES1 identification number which defines


equibiaxial tension

38 TAB3 I TABLES1 identification number which defines


simple shear

39 TAB4 I TABLES1 identification number which defines pure


shear

40 UNDEF(3 ) None

43 TAB5 I TABLES1 identification number which defines


volumetric compression

CONTFLG =0 Without continuation

End CONTFLG

Record – MATOVR(4703,47,624)
Word Name Type Description

1 GRPID I ID of group of elements or group of physical


properties

2 PL I Include Plastic Effects, 0=YES, -1=NO

3 CR I Include Creep Effects, 0=YES, -1=NO

4-8 UNDEF(5)

4-172 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – MATPLCY(3801,38,970)

Word Name Type Description

1 MID I Material identification number

2 E RS Young’s modulus

3 NU RS Poisson’s ratio

4 RHO RS Mass density

5 A RS Coefficient of thermal expansion

6 ISO I Identification number of isotropic hardening rule

7 KIN I Identification number of kinematic hardening rule

8 RUP I Identification number of rupture criterion

9 BETA RS Factor used in the stress integration

10 MAXITE I Maximum number of iterations used for solving


the incremental plastic strains

11 RTOL RS Relative tolerance used to assess convergence


of the iterations

12 UNDEF(5) None

Record – MATS1(503,5,90)

Word Name Type Description

1 MID I Material identification number

2 TID I TABLES1 or TABLEST entry identification number

3 TYPE I Type of material nonlinearity

4 H RS Work hardening slope

5 YF I Yield function criterion

6 HR I Hardening Rule

7 LIMIT1 RS Initial yield point

8 LIMIT2 RS Internal friction angle

9 UNDEF(3 ) None

DMAP Programmer's Guide 4-173


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – MATSMA(6001,60,990)

Word Name Type Description

1 MID I Material identification number

2 EM RS Young's modulus for martensite phase

3 EA RS Young's modulus for austenite phase}

4 NUM RS Poisson's ratio for martensite

5 NUA I Poisson's ratio for austenite

6 ETMAX I Maximum residual transformation strain

7 VTM0 RS Initial volumetric fraction of martensite

8 RHO RS Mass density

9 AM None Mean coefficient of thermal expansion for martensite

10 AA RS Mean coefficient of thermal expansion for austenite

11 TREF RS Reference temperature for thermal expansion


calculation

12 MS RS Temperature at which the transformation to


martensite starts

13 MF RS Temperature at which the transformation to


martensite is finished

14 AS RS Temperature at which the transformation to austenite


starts

15 AF RS Temperature at which the transformation to austenite


is finished

16 UNDEF

17 CM RS Slope of the martensite transformation conditions

18 CA RS Slope of the austenite transformation conditions

19 SIGMAR RS Martensite re-orientation yield property

20 CR RS Slope of the martensite re-orientation yield function

4-174 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – MATSR(4201,42,966)

Word Name Type Description

1 MID I Identification number of a MATS1 entry

2 BVALUE RS Strain-rate hardening parameter

3 TSRATE RS Transition strain rate

4 TID I Identification number of a TABLESR entry

5–9 UNDEF(4) I

Record – MATT1(703,7,91)

Word Name Type Description

1 MID I Material identification number

2 TID(10) I TABLEMi entry identification numbers

12 UNDEF None

Record – MATT2(803,8,102)

Word Name Type Description

1 MID I Material identification number

2 TID(15) I TABLEMi entry identification numbers

17 UNDEF None

Record – MATT3(1503,15,189)

Word Name Type Description

1 MID I Material identification number

2 TID(15) I Entry identification numbers

Record – MATT4(2303,23,237)

Word Name Type Description

1 MID I Material identification number

DMAP Programmer's Guide 4-175


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

2 TK I TABLEMi identification number for thermal


conductivity

3 TCP I TABLEMi identification number for heat capacity


per unit mass

4 UNDEF None

5 TH I TABLEMi identification number for free convection


heat transfer coefficient

6 TMU I TABLEMi identification number for dynamic viscosity

7 THGEN I TABLEMi identification number for heat generation


with QVOL entries

Record – MATT5(2403,24,238)

Word Name Type Description

1 MID I Material identification number

2 TK(6) I TABLEMi identification numbers for thermal


conductivity

8 TCP I TABLEMi identification number for heat capacity


per unit mass

9 UNDEF None

10 THGEN I TABLEMi identification number for heat generation


with QVOL entries

Record – MATT8(903,9,336)

Word Name Type Description

1 MID I

2 TID(9) I TABLEMi entry identification numbers

11 UNDEF None

12 TID(7) I TABLEMi entry identification numbers

19 UNDEF None

4-176 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – MATT9(2703,27,301)
Word Name Type Description

1 MID I Material identification number

2 TC(21) I TABLEMi identification numbers for material


property matrix

23 TRHO I TABLEMi identification number for mass density

24 TA(6) I TABLEMi identification numbers for thermal


expansion coefficients

30 UNDEF None

31 TGE I TABLEMi identification number for structural


damping coefficient

32 UNDEF(4 ) None

Record – MATT11(3303,33,988)
Solid orthotropic material temperature dependence.
Defines the temperature dependent material property for a 3-D orthotropic material for isoparametric
solid elements.

Word Name Type Description

1 MID I Material identification number

2 TE1 I TABLEMi ID for modulus of elasticity in the


1-direction

3 TE2 I TABLEMi ID for modulus of elasticity in the


2-direction

4 TE3 I TABLEMi ID for modulus of elasticity in the


3-direction

5 TNU12 I TABLEMi ID for Poisson's ratio (ε2/ε1 for uniaxial


loading in the 1-direction)

6 TNU13 I TABLEMi ID for Poisson's ratio (ε3/ε1 for uniaxial


loading in the 1-direction)

7 TNU23 I TABLEMi ID for Poisson's ratio (ε3/ε2 for uniaxial


loading in the 2-direction)

8 TRHO I TABLEMi ID for mass density

9 TG12 I TABLEMi ID for shear modulus in 1–2 plane

DMAP Programmer's Guide 4-177


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

10 TG13 I TABLEMi ID for shear modulus in 1–3 plane

11 TG23 I TABLEMi ID for shear modulus in 2–3 plane

12 TA1 I TABLEMi ID for thermal expansion coefficient in the


1-direction

13 TA2 I TABLEMi ID for thermal expansion coefficient in the


2-direction

14 TA3 I TABLEMi ID for thermal expansion coefficient in the


3-direction

15 UNDEF None

16 TGE RS TABLEMi ID for structural damping coefficient

17 UNDEF(16) None

Record – MATTC(2008,20,249)

Word Name Type Description

1 MID I Material identification number

2 TID(6) I TABLEMi identification numbers for creep


coefficients

Record – MATVE(3701,37,975)

Word Name Type Description

1 MID I Material identification number

2 GFUNC I TABVE ID for shear modulus relaxation function

3 KFUNC I TABVE ID for bulk modulus relaxation function

4 RHO RS Mass density

5 ALPHA RS Coefficient of thermal expansion

6 UNDEF(3) None

9 SHIFT I Time-temperature superposition shift law

10 C1 RS Material constant for the WLF or Arrhenius shift


functions

4-178 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

11 C2 RS Material constant for the WLF or Arrhenius shift


functions

12 T0 RS Reference temperature used by the WLF or


Arrhenius shift functions

13 UNDEF(4) None

Record – NLPARM(3003,30,286)

Word Name Type Description

1 SID I Set identification number

2 NINC I Number of increments

3 DT RS Incremental time interval for creep analysis

4 KMETHOD I Method for controlling stiffness updates

5 KSTEP I Number of iterations before the stiffness update

6 MAXITER I Limit on number of iterations for each load


increment

7 CONV I Flags to select convergence criteria

8 INTOUT I Intermediate output flag

9 EPSU RS Error tolerance for displacement U criterion

10 EPSP RS Error tolerance for displacement P criterion

11 EPSW RS Error tolerance for displacement W criterion

12 MAXDIV I Limit on probable divergence conditions

13 MAXQN I Maximum number of quasi-Newton correction


vectors

14 MAXLS I Maximum number of line searches

15 FSTRESS RS Fraction of effective stress

16 LSTOL RS Line search tolerance

17 MAXBIS I Maximum number of bisections

18 MAXR RS Maximum ratio for the adjusted arc-length increment

19 RTOLB RS Maximum value of incremental rotation

DMAP Programmer's Guide 4-179


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Record – NLPCI(3104,32,350)

Word Name Type Description

1 SID I Set identification number

2 TYPE CHAR4 Constraint type

3 MINALR RS Minimum allowable arc-length adjustment ratio

4 MAXALR RS Maximum allowable arc-length adjustment ratio

5 SCALE RS Scale factor (w) for controlling the loading


contribution

6 UNDEF None

7 DESITER I Desired number of iterations for convergence

8 MXINC I Maximum number of controlled increment steps

Record – PLCYISO(3901,39,971)

Word Name Type Description

1 HID I Isotropic hardening identification number

2 HMODEL I Hardening model

HMODEL=1 Bilinear hardening

3 YIELD RS Yield strength

4 EP RS Hardening modulus

5 UNDEF(4) None

HMODEL=2 Multilinear hardening

3 AEPS RS Accumulated effective plastic strain at data point i

4 SR RS Radius of yield surface corresponding to aeps(i)

Words 3 and 4 repeat until -1 is reached

HMODEL=3 Exponential hardening

3 YIELD RS Yield strength

4 Q RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

4-180 DMAP Programmer's Guide


Data Block Descriptions F-M

Word Name Type Description

5 B RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

6 UNDEF(3) None

HMODEL=4 Memory exponential hardening

3 YIELD RS Yield strength

4 Q0 RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

5 QM RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

6 MU RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

7 B RS Parameter giving the change in yield stress with


respect to accumulated effective plastic strain

8 ETA RS Strain memory surface parameter

Record – PLCYKIN(4001,40,972)
Word Name Type Description

1 HID I Kinematic hardening identification number

2 TYPE I Type of kinematic hardening, currently only


TYPE=1 (Armstrong-Fredrick/AF) is allowed

3 H RS Linear kinematic hardening constant at data point


i

4 ZETA RS Nonlinear kinematic hardening constant at data


point i

Words 3 and 4 repeat until -1 is reached

Record – PLCYRUP(4101,41,973)
Word Name Type Description

1 RID I Rupture criterion identification number

2 TYPE I Type of rupture criterion, currently only TYPE=1


(Accumulated effective plastic strain/AEPS) is
allowed

DMAP Programmer's Guide 4-181


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

3 RSTR RS Accumulated effective plastic strain at which the


material ruptures

4 UNDEF(5) None

Record – RADBND(9002,90,410)

Word Name Type Description

1 NUMBER I Number of radiation wave bands

2 PLANCK2 RS Planck’s second radiation constant

3 LAMBDA RS Highest wavelength of the i-th wave band

Word 3 repeats until End of Record

Record – RADM(8802,88,413)

Word Name Type Description

1 NUMBER(C) I Number of emissivities including absorptivity

2 MID I Material identification number

3 EMISI RS Surface emissivity at wavelength LAMBDAi

Word 3 repeats NUMBER times

Words 2 through 3 repeat until End of Record

Record – RADMT(8902,89,423)

Word Name Type Description

1 NUMBER(C) I Number of emissivities

2 MID I Material identification number

3 TEMISI I TABLEMi ID for surface emissivity

Word 3 repeats NUMBER times

Words 2 through 3 repeat until End of Record

4-182 DMAP Programmer's Guide


Data Block Descriptions F-M

Record – TSTEP1(17500,175,618)

Word Name Type Description

1 SID I Set identification number

2 TEND RS End time

3 NINC I Number of load increments

4 NOUT I >0, output at each NOUT; =-1, YES; =-2, END;


=-3, ALL

Words 2 through 4 repeat until (-1,-1,-1) occurs

Record – TSTEPNL(3103,31,337)

Word Name Type Description

1 SID I Set identification number

2 NDT I Number of time steps of value DT

3 DT RS Time increment

4 NO I Time step interval for output

5 METHOD I Method for dynamic matrix update

6 KSTEP I Time step interval or number of converged


bisections

7 MAXITER I Limit on number of iterations

8 CONV I Flags to select convergence criteria

9 EPSU RS Error tolerance for displacement U criterion

10 EPSP RS Error tolerance for displacement P criterion

11 EPSW RS Error tolerance for displacement W criterion

12 MAXDIV I Limit on probable divergence conditions

13 MAXQN I Maximum number of quasi-Newton correction


vectors

14 MAXLS I Maximum number of line searches

15 FSTRESS RS Fraction of effective stress

16 MAXBIS I Maximum number of bisections

DMAP Programmer's Guide 4-183


Chapter
Chapter 4: 4: Data Data
BlockBlock Descriptions
Descriptions F-M F-M

Word Name Type Description

17 ADJUST I Time step skip factor for automatic time step


adjustment

18 MSTEP I Number of steps to obtain the dominant period


response

19 RB RS Define bounds for maintaining the same time step

20 MAXR RS Maximum ratio for the adjusted arc-length increment

21 UTOL RS Tolerance on displacement or temperature


increment

22 RTOLB RS Maximum value of incremental rotation

23 KDAMP I Flags to include differential stiffness to form


structural damping

24 KUPDATE I Method for dynamic matrix update

25 KUSTEP I Number of iterations before the stiffness update

26 TINTOPT I Time integration method

27 GAMMA RS Amplitude decay factor for 2nd order transient


integration

Record – TRAILER

Word Name Type Description

1 BIT(6) I Record presence trailer words

4-184 DMAP Programmer's Guide


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 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name, for example, OBC1

Record – IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10* Approach Code

2 TCODE(C) I Table code, 62

3 UNDEF None

4 SUBCASE I

TCODE=1 SORT1

ACODE=01 SOL 101 Linear Statics

5 LOADSET I Load set or zero

ACODE=10 601 & 701 Nonlinear

5 TIME RS Time Step

End ACODE

TCODE=2 SORT2

5 EKEY I Device code + 10 * point identification number

End TCODE

6 UNDEF(2) none

8 LOADSET I Load set or zero

DMAP Programmer's Guide 5-1


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 FCODE I 1

10 NUMWDE I Number of words per entry in DATA record

11-50 UNDEF None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record – DATA

Word Name Type Description

TCODE=1 SORT1

1 EKEY I Device code + 10 * point identification number

TCODE=2 SORT2

ACODE=01 SOL 101 Linear Statics

1 LOADSET I Load set or zero

ACODE=10 601 & 701 Nonlinear

1 TIME RS Time Step

End ACODE

End TCODE

2 P RS Contact Pressure

3 T1 RS Contact tangential traction in direction X (Base


C.S.)

4 T2 RS Contact tangential traction in direction Y (Base


C.S.)

5 T3 RS Contact tangential traction in direction Z (Base


C.S.)

Repeat word 1-5 for each grid point.

5-2 DMAP Programmer's Guide


Data Block Descriptions O-V

Record – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

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.

5.2 OBG
Output glue normal and in-plane tractions for SOLs 101, 103, 105, and 401. SORT1 and SORT2
formats are supported.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name, for example, OBG1

Record – IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10* Approach Code

2 TCODE(C) I Table code (66 for Glue tractions)

3 UNDEF None

4 SUBCASE I

TCODE=1 SORT1

ACODE=01 Statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=02 Real Eigenvalues

5 MODE I Mode number

DMAP Programmer's Guide 5-3


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or cycle

ACODE=03 Differential stiffness 0

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=04 Differential stiffness 1

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=05 Frequency

5 FREQ RS Frequency

6 UNDEF(2) None

ACODE=06 Transient

5 TIME RS Time step

6 UNDEF(2) None

ACODE=07 Buckling Phase 0 (pre-buckling)

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=08 Buckling Phase 1 (post-buckling)

5 LSDVMN I Mode number

6 EIGN RS Eigenvalue

7 UNDEF None

ACODE=09 Complex eigenvalues

5 MODE I Mode

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE=10 Nonlinear statics

5 LFTSFQ RS Time step

5-4 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 UNDEF(2) None

ACODE=11 Old geometric nonlinear statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=12 CONTRAN (may appear as ACODE = 6)

5 TIME RS Time

6 UNDEF(2) None

End ACODE

TCODE=2 SORT2

5 LSDVMN I Load set, mode number

6 UNDEF(2) None

End TCODE

8 LSDVMN I Load set

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF None

12 PID I Physical property identification number

13 UNDEF(38) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record – DATA

Word Name Type Description

TCODE=1 SORT1

1 EKEY I Device code + 10 * point identification number

TCODE=2 SORT2

DMAP Programmer's Guide 5-5


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE=01 SOL 101 Linear Statics

1 LOADSET I Load set or zero

End ACODE

End TCODE

2 P RS Glue normal traction

3 T1 RS Glue tangential traction in direction X (Base C.S.)

4 T2 RS Glue tangential traction in direction Y (Base C.S.)

5 T3 RS Glue tangential traction in direction Z (Base C.S.)

Repeat word 1-5 for each grid point.

Record – TRAILER

Word Name Type Description

1 UNDEF(6) None

Notes:
1. Glue results are grid point based results.

2. Glue tangential traction is expressed as a vector data (magnitude and direction) in X, Y and
Z components of Basic Coordinate System.

5.3 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 Name Type Description

1 NAME(2) CHAR4 Data block name

5-6 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 1 – REPEAT

Word Name Type Description

1 IRID I Response identification number

2 RTYPE1 I Type of response: 1 or 2

3 RTYPE2 I Type of response: 1 or 2

4 MINMAX I Minimum/maximum flag: -1=minimum and


1=maximum

5 SEID I Superelement identification number

6 SID I Subcase identification number

Record 2 – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

5.4 OCCORF
Table of cross-correlation functions.

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code; always 4200

3 UNDEF none

4 RANDID I RANDOM set identification number

5 DCODE I Device code +10*function number

6 RCROSSID I RCROSS identification number

DMAP Programmer's Guide 5-7


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 UNDEF(2) none

9 FCODE I Format Code

10 NUMWDE(C) I Length of entries in RECORD=DATA (always 3)

11 RTYPE1 CHAR4 Type of first response quantity

12 ID1 I Element, grid or scalar point ID number

13 COMP1 I Component code (item) ID number

14 RTYPE2 CHAR4 Type of second response quantity

15 ID2 I Element, grid, or scalar point ID number

16 COMP2 I Component code (item) ID number

17 CURID I Curve ID number

18 UNDEF(33) none

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 – DATA

Word Name Type Description

1 FREQ RS Frequency (Hz)

2 CCORF RS Cross-correlation function

Record 3– TRAILER

Word Name Type Description

1 WORD1 I Number of records

2 WORD2 I Number of data values in record 2.

3 UNDEF(4) none

5-8 DMAP Programmer's Guide


Data Block Descriptions O-V

5.5 OCONST
Table of Contact Node/Grid Status

HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 UNDEF None

4 SUBCASE I Subcase

TCODE=1 Sort 1

ACODE=01 Statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=02 Real eigenvalues

5 MODE I Mode number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or cycle

ACODE=03 Differential stiffness 0

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=04 Differential stiffness 1

5 LSDVMN I Load set number

6 UNDEF(2) None

DMAP Programmer's Guide 5-9


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE=05 Frequency

5 FREQ RS Frequency

6 UNDEF(2) None

ACODE=06 Transient (Used for SOL 401)

5 TIME RS Time step

6 UNDEF(2) None

ACODE=07 Buckling phase 0 (pre-buckling)

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=08 Buckling phase 1 (post-buckling)

5 LSDVMN I Mode number

6 EIGN RS Eigenvalue

7 UNDEF None

ACODE=09 Complex eigenvalues

5 MODE I Mode number

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE=10 Nonlinear statics (SOL 601/701)

5 LFTSFQ RS Time step

6 UNDEF(2) None

ACODE=11 Old geometric nonlinear statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=12 CONTRAN (may appear as ACODE=6)

5 TIME RS Time step

6 UNDEF(2) None

End ACODE

5-10 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE=2 SORT2

5 LSDVMN I Load set, mode number

6 UNDEF(2) None

End TCODE

8 LSDVMN I Load set number

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF None

12 PID I Physical property identification number

13 UNDEF(38) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

DATA

Word Name Type Description

TCODE=1 SORT1

1 EKEY I Device code + 10 * grid/node identification number

TCODE =2 SORT2

ACODE=01 Statics

1 EKEY I Device code + 10 * grid/node identification number

ACODE =02 Normal modes or buckling (real eigenvalues)

1 EKEY I Device code + 10 * grid/node identification number

ACODE=03 Differential Stiffness 0

1 EKEY I Device code + 10 * grid/node identification number

ACODE =04 Differential Stiffness 1

1 EKEY I Device code + 10 * grid/node identification number

DMAP Programmer's Guide 5-11


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE=05 Frequency

1 FREQ RS Frequency

ACODE=06 Transient

1 TIME RS Time step

ACODE =07 Pre-buckling

1 EKEY I Device code + 10 * grid/node identification number

ACODE,4 =08 Post-buckling

1 EKEY I Device code + 10 * grid/node identification number

ACODE,4 =09 Complex Eigenvalues

1 EKEY I Device code + 10 * grid/node identification number

ACODE=10 Nonlinear Statics

1 FQTS RS Frequency or Time step

ACODE=11 Geometric Nonlinear Statics

1 EKEY I Device code + 10 * grid/node identification number

ACODE=12 CONTRAN (may appear as ACODE=6)

1 EKEY RS Device code + 10 * grid/node identification number

End ACODE

End TCODE

2 I1 I Contact node/grid status

3–4 UNDEF(2)

TRAILER

Word Name Type Description

1 UNDEF(6) None

5.6 OCPSDF
Table of cross-power spectral density functions.

5-12 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code; always 4100

3 UNDEF none

4 RANDID I RANDOM set identification number

5 DCODE I Device code +10*function number

6 RCROSSID I RCROSS identification number

7 UNDEF(2) none

9 FCODE I Format code

10 NUMWDE(C) I Length of entries in RECORD=DATA (always 3)

11 RTYPE1 CHAR4 Type of first response quantity

12 ID1 I Element, grid or scalar point ID number

13 COMP1 I Component code (item) ID number

14 RTYPE2 CHAR4 Type of second response quantity

15 ID2 I Element, grid, or scalar point ID number

16 COMP2 I Component code (item) ID number

17 CURID I Curve ID number

18 UNDEF(33) none

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

DMAP Programmer's Guide 5-13


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 2 – DATA

Word Name Type Description

1 FREQ RS Frequency (Hz)

2 CPSDFR RS Real part of cross-power spectral density function


value

3 CPSDFI RS Imaginary part of cross-power spectral density


function value

Record 3– TRAILER

Word Name Type Description

1 WORD1 I Number of records

2 WORD2 I Number of data values in record 2.

3 UNDEF(4) none

5.7 OEE
Output element energy (strain, kinetic, loss)

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code +


10*approach code

2 TCODE(C) I 18 for strain, 36 for


kinetic, and 37 for
energy loss

3 ETOTAL RS Total strain energy


of all elements in
subcase/mode

4 SUBCASE I Subcase number

5-14 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ACODE,4 =0

5 UNDEF None Not defined

ACODE,4 =01 Statics

5 UNDEF None See word 8

ACODE,4 =02 Real Eigenvalues

5 MODE I Mode Number

ACODE,4 =03 Differential Stiffness

5 UNDEF None See word 8

ACODE,4 =04 Differential Stiffness

5 UNDEF None See word 8

ACODE,4 =05 Frequency

5 FREQ RS Frequency

ACODE,4 =06 Transient

5 TIME RS Time Step

ACODE,4 =07 Buckling 0 ( Pre buckling )

5 UNDEF None See word 8

ACODE,4 =08 Buckling 1 ( Post buckling )

5 MODE I Mode Number

ACODE,4 =09 Complex Eigenvalues

5 MODE I Mode Number

ACODE,4 =10 Nonlinear Statics ( Sol 106 )

5 LOADFAC RS Load factor

ACODE,4 =11 Geometric Nonlinear Statics

5 UNDEF None See word 8

ACODE,4 =12 CONTRAN ? ( Can appear as ACODE=6 )

5 TIME RS Time Step

End ACODE,4

DMAP Programmer's Guide 5-15


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 ELNAME(2) CHAR4 Element type name

8 LOADSET I Load set or zero

9 APROACH I Approach

10 NUMWDE I Number of words per


entry in DATA record

11 CVALRES I C

12 ESUBT RS Subtotal of Strain


Energy in the Set
identification number

13 SETID I Set identification


number Number

14 EIGENR RS Natural eigenvalue -


real part

15 EIGENI RS Natural eigenvalue -


imaginary part

16 FREQ RS Natural frequency

17 RMSSF RS RMS and CRMS scale


factor

18 ETOTPOS RS Total positive energy

19 ETOTNEG RS Total negative energy

20 FCODE I Format Code


1 – Real
2 – Real/Imaginary
3 – Magnitude/Phase

21 ELTYPE I Element Type

22 THRESH RS Energy Threshold

23 UNDEF(28) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

5-16 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 2 - DATA

Word Name Type Description

TCODE,1 =1 Sort 1

1 EKEY I

TCODE,1 =02 Sort 2 - Swap with word 5 of IDENT

ACODE,4 =0

1 UNDEF None Not defined

ACODE,4 =01

1 EKEY I

ACODE,4 =02

1 EKEY I

ACODE,4 =03

1 EKEY I

ACODE,4 =04

1 EKEY I

ACODE,4 =05

1 FREQ RS Frequency

ACODE,4 =06

1 TIME RS Time step

ACODE,4 =07

1 EKEY I

ACODE,4 =08

1 EKEY I

ACODE,4 =09

1 EKEY I

ACODE,4 =10

1 FQTS RS Frequency or Time step

ACODE,4 =11

DMAP Programmer's Guide 5-17


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

1 EKEY I

ACODE,4 =12

1 EKEY I

End ACODE,4

End TCODE,1

2 ENERGY RS Element Energy or


Subtotal after all elements

3 PCT RS Percent of Total Energy

4 DEN RS Element Energy Density,


or '-1' after all elements

TCODE,7=0 (Real) Real

1 ID I (depends on TCODE,1)

2 ENERGY RS Element Energy

3 PCT RS Percent of Total Energy

4 DEN RS Element Energy Density

TCODE,7=1 (Real/Imaginary or
Magnitude/Phase)

CVALRES=1,2

1 ID I (depends on TCODE,1)

2 ENERGY.R RS Element Energy (real/mag


part)

3 ENERGY.I RS Element Energy


(imag/phase part)

4 PCT RS Percent of Total Energy

5 DEN RS Element Energy Density

CVALRES=4

1 ID I (depends on TCODE,1)

2 ENERGY.R RS Element Ave Energy


(real/mag part)

5-18 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 ENERGY.I RS Element Ave Energy


(imag/phase part)

4 ENERGY.R RS Element Amp Energy


(real/mag part)

5 ENERGY.I RS Element Amp Energy


(imag/phase part)

6 PCT RS Percent of Total Energy

7 DEN RS Element Energy Density

End CVALRES

End TCODE,7

Record 3- TRAILER

Word Name Type Description

1 WORD1 I Number of element types output

2 UNDEF(5 ) None

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

DMAP Programmer's Guide 5-19


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 = ceigen
9 = pla

4. Nonexistent element energy densities are flagged by integer '-1' in the field.

5.8 OEF
Table of element forces
Also contains composite failure indices and analysis types (real and complex), and SORT1 and
SORT2 formats.

Record - HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2 ) None

Record - IDENT
Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 ELTYPE(C) I Element type

4 SUBCASE I Subcase or Random identification number

TCODE,1 =1 SORT1 format

ACODE,4 =01 Statics

5 LOADID I Load set identification number

6 UNDEF(2) None

ACODE,4 =02 Normal modes or buckling (real eigenvalues)

5 MODE I Mode number

6 EIGN RS Eigenvalue

5-20 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 UNDEF None

ACODE,4 =03 Differential Stiffness 0

5 LOADID I Load set identification number

6 UNDEF(2) None

ACODE,4 =04 Differential Stiffness 1

5 LOADID I Load set identification number

6 UNDEF(2) None

ACODE,4 =05 Frequency

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE,4 =06 Transient

5 TIME RS Time step

6 UNDEF(2) None

ACODE,4 =07 Pre-buckling

5 LOADID I Load set identification number

6 UNDEF(2) None

ACODE,4 =08 Post-buckling

5 LOADID I Load set identification number

6 EIGR RS Eigenvalue

7 RANDOM ID I Random identification number

ACODE,4 =09 Complex Eigenvalues

5 MODE I Mode number

6 EIGR RS Eigenvalue - real part

7 EIGI RS Eigenvalue - imaginary part

ACODE,4 =10 Nonlinear Statics

5 LOADSTEP RS Load step

DMAP Programmer's Guide 5-21


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 UNDEF(2) None

ACODE,4 =11 Geometric Nonlinear Statics

5 LOADID I Load set identification number

6 UNDEF None

7 RANDOM ID I Random identification number

End ACODE,4

TCODE,1 =02 SORT2 format

5 LOADID I Load set identification number

6 UNDEF(2) None

End TCODE,1

8 DLOADID I Dynamic load set or Random code


identification number

9 FCODE(C) I Format code

10 NUMWDE(C) I Number of words per entry

11 OCODE I

12 PID (SOL 601 I Physical Property ID for SOL 601 & 701
and 701 only) only. UNDEF for all other SOLs

13 UNDEF None

14 Q4CSTR(C) I Corner Stress Flag

15 PLSLOC(C) I Ply stress/strain location

16 UNDEF None

17 RMSSF RS RMS and CRMS scale factor

18 UNDEF(2) None

20 RSPEED RS Rotor speed in RUNIT units

21 RUNIT CHAR4 RSPEED units; RPM, CPS, HZ, or RAD;


blank or integer 0 in a non-rotor dynamic
analyses

22 UNDEF None

5-22 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

23 THERMAL(C) I =1 for heat transfer and 0 otherwise

24 UNDEF(27) None

51 TITLE(32) CHAR4 Title character string (TITLE)

83 SUBTITLE(32) CHAR4 Subtitle character string (SUBTITLE)

115 LABEL(32) CHAR4 LABEL character string (LABEL)

Record - DATA

Word Name Type Description

TCODE,1 =1 SORT1 Format

1 EID I Element identification number

TCODE,1 =02 SORT2 Format

ACODE,4 =01 Statics

1 LOADID I Load set identification number

ACODE,4 =02 Normal modes or buckling (real eigenvalues)

1 MODE I Mode number

ACODE,4 =03 Differential Stiffness 0

1 LOADID I Load set identification number

ACODE,4 =04 Differential Stiffness 1

1 LOADID I Load set identification number

ACODE,4 =05 Frequency

1 FREQ RS Frequency

ACODE,4 =06 Transient

1 TIME RS Time step

ACODE,4 =07 Pre-buckling

1 LOADID I Load set identification number

ACODE,4 =08 Post-buckling

1 LOADID I Load set identification number

DMAP Programmer's Guide 5-23


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE,4 =09 Complex Eigenvalues

1 MODE I Mode number

ACODE,4 =10 Nonlinear Statics

1 LOADSTEP RS Load step

ACODE,4 =11 Geometric Nonlinear Statics

1 LOADID I Load set identification number

End ACODE,4

End TCODE,1

Word Name Type Description

THERMAL =1 Thermal data

NUMWDE =10 2-D and 3-D elements

2 NAME(2) CHAR4 Element type

4 XGRAD RS x gradient or '1'

5 YGRAD RS y gradient or '1'

6 ZGRAD RS z gradient or '1'

7 XFLUX RS x flux or '1'

8 YFLUX RS y flux or '1'

9 ZFLUX RS z flux or '1'

10 ZED I zero

NUMWDE =8 (CHBDY) thermal 107,108,109

2 NAME(2) CHAR4 Element name

4 FAPPLIED RS Applied load

5 FREECONV RS Free convection

6 FORCECON RS Forced convection

7 FRAD RS Radiation

8 FTOTAL RS Total

5-24 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

NUMWDE =2 conv elements

2 FTOTAL RS Total

NUMWDE =9 1-D elements; for example, CBEAM, CBEND, CTUBE

2 NAME(2) CHAR4 Element type

4 XGRAD RS x gradient or '1'

5 YGRAD RS y gradient or '1'

6 ZGRAD RS z gradient or '1'

7 XFLUX RS x flux or '1'

8 YFLUX RS y flux or '1'

9 ZFLUX RS z flux or '1'

NUMWDE =58 VUHEXA 145 Thermal

2 PARENT I Parent C

3 VUGRID I VU Grid identification number

4 XGRAD RS x gradient or '1'

5 YGRAD RS y gradient or '1'

6 ZGRAD RS z gradient or '1'

7 XFLUX RS x flux or '1'

8 YFLUX RS y flux or '1'

9 ZFLUX RS z flux or '1'

Words 3 through 9 repeat 8 times

NUMWDE =44 VUPENTA 146 Thermal

2 PARENT I Parent identification number

3 VUGRID I VU Grid identification number

4 XGRAD RS x gradient or '1'

5 YGRAD RS y gradient or '1'

6 ZGRAD RS z gradient or '1'

7 XFLUX RS x flux or '1'

DMAP Programmer's Guide 5-25


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 YFLUX RS y flux or '1'

9 ZFLUX RS z flux or '1'

Words 3 through 9 repeat 6 times

NUMWDE =30 VUTETRA 147 Thermal

2 PARENT I Parent identification number

3 VUGRID I VU Grid identification number

4 XGRAD RS x gradient or '1'

5 YGRAD RS y gradient or '1'

6 ZGRAD RS z gradient or '1'

7 XFLUX RS x flux or '1'

8 YFLUX RS y flux or '1'

9 ZFLUX RS z flux or '1'

Words 3 through 9 repeat 4 times

NUMWDE =34 VUQUAD 189 Thermal

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

5 THETA I Material angle

6 UNDEF None

7 VUGRID I VU Grid identification number

8 XGRAD RS x gradient or '1'

9 YGRAD RS y gradient or '1'

10 ZGRAD RS z gradient or '1'

11 XFLUX RS x flux or '1'

12 YFLUX RS y flux or '1'

13 ZFLUX RS z flux or '1'

Words 7 through 13 repeat 4 times

5-26 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

NUMWDE =27 VUTRIA 190 Thermal

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

5 THETA I Material angle

6 UNDEF None

7 VUGRID I VU Grid Id

8 XGRAD RS x gradient or '1'

9 YGRAD RS y gradient or '1'

10 ZGRAD RS z gradient or '1'

11 XFLUX RS x flux or '1'

12 YFLUX RS y flux or '1'

13 ZFLUX RS z flux or '1'

Words 7 through 13 repeat 3 times

NUMWDE =18 VUBEAM 191 Thermal

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

5 VUGRID I VU Grid Id

6 XGRAD RS x gradient or '1'

7 YGRAD RS y gradient or '1'

8 ZGRAD RS z gradient or '1'

9 XFLUX RS x flux or '1'

10 YFLUX RS y flux or '1'

11 ZFLUX RS z flux or '1'

Words 5 through 11 repeat 2 times

End NUMWDE

DMAP Programmer's Guide 5-27


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

THERMAL =00 Non-thermal element output

ELTYPE =01 Rod element (CROD)

TCODE,7 =0 or 2 Real or Random Response

2 AF RS Axial Force

3 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 AFR RS Axial Force - real/mag. part

3 AFI RS Axial Force - imag./phase part

4 TRQR RS Torque - real/mag. part

5 TRQI RS Torque - imag./phase part

End TCODE,7

ELTYPE =02 Beam element (CBEAM)

TCODE,7 =0 or 2 Real or Random Response

2 GRID I Grid point identification number

3 SD RS Station Distance divided by element's length

4 BM1 RS Bending moment plane 1

5 BM2 RS Bending moment plane 2

6 TS1 RS Shear Plane 1

7 TS2 RS Shear Plane 2

8 AF RS Axial Force

9 TTRQ RS Total Torque

10 WTRQ RS Warping Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 GRID I Grid point identification number

3 SD RS Station Distance divided by element's length

4 BM1R RS Bending moment plane 1 - real/mag. part

5 BM2R RS Bending moment plane 2 - real/mag. part

5-28 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 TS1R RS Shear plane 1 - real/mag. part

7 TS2R RS Shear plane 2 - real/mag. part

8 AFR RS Axial force - real/mag. part

9 TTRQR RS Total torque - real/mag. part

10 WTRQR RS Warping torque - real/mag. part

11 BM1I RS Bending moment plane 1 - imag./phase part

12 BM2I RS Bending moment plane 2 - imag./phase part

13 TS1I RS Shear plane 1 - imag./phase part

14 TS2I RS Shear plane 2 - imag./phase part

15 AFI RS Axial force - imag./phase part

16 TTRQI RS Total torque - imag./phase part

17 WTRQI RS Warping torque - imag./phase part

End TCODE,7

Words 2 through max repeat 011 times

ELTYPE =03 Tube element (CTUBE)

TCODE,7 =0 or 2 Real or Random Response

2 AF RS Axial Force

3 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 AFR RS Axial Force - real/mag. part

3 AFI RS Axial Force - imag./phase part

4 TRQR RS Torque - real/mag. part

5 TEQI RS Torque - imag./phase part

End TCODE,7

ELTYPE =04 Shear panel element (CSHEAR)

TCODE,7 =0 or 2 Real or Random Response

2 F41 RS Force 4 to 1

DMAP Programmer's Guide 5-29


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 F21 RS Force 2 to 1

4 F12 RS Force 1 to 2

5 F32 RS Force 3 to 2

6 F23 RS Force 2 to 3

7 F43 RS Force 4 to 3

8 F34 RS Force 3 to 4

9 F14 RS Force 1 to 4

10 KF1 RS Kick Force on 1

11 S12 RS Shear 1 2

12 KF2 RS Kick Force on 2

13 S23 RS Shear 2 3

14 KF3 RS Kick Force on 3

15 S34 RS Shear 3 4

16 KF4 RS Kick Force on 4

17 S41 RS Shear 4 1

TCODE,7 =1 Real/imaginary or magnitude/phase

2 F41R RS Force 4 to 1 - real/mag. part

3 F21R RS Force 2 to 1 - real/mag. part

4 F12R RS Force 1 to 2 - real/mag. part

5 F32R RS Force 3 to 2 - real/mag. part

6 F23R RS Force 2 to 3 - real/mag. part

7 F43R RS Force 4 to 3 - real/mag. part

8 F34R RS Force 3 to 4 - real/mag. part

9 F14R RS Force 1 to 4 - real/mag. part

10 F41I RS Force 4 to 1 - imag./phase part

11 F21I RS Force 2 to 1 - imag./phase part

12 F12I RS Force 1 to 2 - imag./phase part

5-30 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 F32I RS Force 3 to 2 - imag./phase part

14 F23I RS Force 2 to 3 - imag./phase part

15 F43I RS Force 4 to 3 - imag./phase part

16 F34I RS Force 3 to 4 - imag./phase part

17 F14I RS Force 1 to 4 - imag./phase part

18 KF1R RS Kick Force on 1 - real/mag. part

19 S12R RS Shear 1 2 - real/mag. part

20 KF2R RS Kick Force on 2 - real/mag. part

21 S23R RS Shear 2 3 - real/mag. part

22 KF3R RS Kick Force on 3 - real/mag. part

23 S34R RS Shear 3 4 - real/mag. part

24 KF4R RS Kick Force on 4 - real/mag. part

25 S41R RS Shear 4 1 - real/mag. part

26 KF1I RS Kick Force on 1 - imag./phase part

27 S12I RS Shear 1 2 - imag./phase part

28 KF2I RS Kick Force on 2 - imag./phase part

29 S23I RS Shear 2 3 - imag./phase part

30 KF3I RS Kick Force on 3 - imag./phase part

31 S34I RS Shear 3 4 - imag./phase part

32 KF4I RS Kick Force on 4 - imag./phase part

33 S41I RS Shear 4 1 - imag./phase part

End TCODE,7

ELTYPE =05 FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness)

2 UNDEF None

ELTYPE =06 Unused

2 UNDEF None

ELTYPE =07 PLOAD4 (follower stiffness)

DMAP Programmer's Guide 5-31


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =08 PLOADX1 (follower stiffness)

2 UNDEF None

ELTYPE =09 PLOAD and PLOAD2 (follower stiffness)

2 UNDEF None

Word Name Type Description

ELTYPE =10 Rod element connection and property (CONROD)

TCODE,7 =0 or 2 Real or Random Response

2 AF RS Axial Force

3 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 AFR RS Axial Force - real/mag. part

3 AFI RS Axial Force - imag./phase part

4 TRQR RS Torque - real/mag. part

5 TRQI RS Torque - imag./phase part

End TCODE,7

ELTYPE =11 Scalar spring element (CELAS1)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force - real/mag. part

3 FI RS Force - imag./phase part

End TCODE,7

ELTYPE =12 Scalar spring element with properties (CELAS2)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

5-32 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force - real/mag. part

3 FI RS Force - imag./phase part

End TCODE,7

ELTYPE =13 Scalar spring element to scalar points only (CELAS3)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force - real/mag. part

3 FI RS Force - imag./phase part

End TCODE,7

ELTYPE =14 Scalar spring element to scalar pts. only with prop. (CELAS4)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force - real/mag. part

3 FI RS Force - imag./phase part

End TCODE,7

ELTYPE =15 AEROT3

2 UNDEF None

ELTYPE =16 AEROBEAM

2 UNDEF None

ELTYPE =17 Unused (Pre-V69 CTRIA2)

2 UNDEF None

ELTYPE =18 Unused (Pre-V69 CQUAD2)

2 UNDEF None

ELTYPE =19 Unused (Pre-V69 CQUAD1)

DMAP Programmer's Guide 5-33


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

Word Name Type Description

ELTYPE =20 Scalar damper (CDAMP1)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force

3 FI RS Force

End TCODE,7

ELTYPE =21 Scalar damper with properties (CDAMP2)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force

3 FI RS Force

End TCODE,7

ELTYPE =22 Scalar damper to scalar points only (CDAMP3)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force

3 FI RS Force

End TCODE,7

ELTYPE =23 Scalar damper to scalar points only with prop (CDAMP4)

TCODE,7 =0 or 2 Real or Random Response

2 F RS Force

5-34 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR RS Force

3 FI RS Force

End TCODE,7

ELTYPE =24 Viscous damper (CVISC)

TCODE,7 =1 Real/imaginary or magnitude/phase

2 AFR RS Axial Force - real/mag. part

3 AFI RS Axial Force - imag./phase part

4 TRQR RS Torque - real/mag. part

5 TRQI RS Torque - imag./phase part

TCODE,7 =0 or 2 Real or Random Response

2 AF RS Axial Force

3 TRQ RS Torque

ELTYPE =25 Scalar mass (CMASS1)

2 UNDEF None

ELTYPE =26 Scalar mass with properties (CMASS2)

2 UNDEF None

ELTYPE =27 Scalar mass to scalar pts. only (CMASS3)

2 UNDEF None

ELTYPE =28 Scalar mass to scalar pts. only with properties (CMASS4)

2 UNDEF None

ELTYPE =29 Concentrated mass element - general form (CONM1)

2 UNDEF None

Word Name Type Description

ELTYPE =30 Concentrated mass element - rigid body form (CONM2)

2 UNDEF None

DMAP Programmer's Guide 5-35


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =31 Dummy plot element (PLOTEL)

2 UNDEF None

ELTYPE =32 Unused

2 UNDEF None

ELTYPE =33 Quadrilateral plate element (CQUAD4)

TCODE,7 =0 or 2 Real or Random Response

2 MX RS Membrane in x

3 MY RS Membrane in y

4 MXY RS Membrane in xy

5 BMX RS Bending in x

6 BMY RS Bending in y

7 BMXY RS Bending in xy

8 TX RS Transverse Shear in x

9 TY RS Transverse Shear in y

TCODE,7 =1 Real/imaginary or magnitude/phase

2 MXR RS Membrane in x - real/mag. part

3 MYR RS Membrane in y - real/mag. part

4 MXYR RS Membrane in xy - real/mag. part

5 BMXR RS Bending in x - real/mag. part

6 BMYR RS Bending in y - real/mag. part

7 BMXYR RS Bending in xy - real/mag. part

8 TXR RS Transverse Shear in x - real/mag. part

9 TYR RS Transverse Shear in y - real/mag. part

10 MXI RS Membrane in x - imag./phase part

11 MYI RS Membrane in y - imag./phase part

12 MXYI RS Membrane in xy - imag./phase part

13 BMXI RS Bending in x - imag./phase part

5-36 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 BMYI RS Bending in y - imag./phase part

15 BMXYI RS Bending in xy - imag./phase part

16 TXI RS Transverse Shear in x - imag./phase part

17 TYI RS Transverse Shear in y - imag./phase part

End TCODE,7

ELTYPE =34 Simple beam element (CBAR and see also ELTYPE=100)

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

DMAP Programmer's Guide 5-37


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

17 TRQI RS Torque - imaginary part

End TCODE,7

ELTYPE =35 Axisymmetric shell element (CCONEAX)

2 HOPA RS Harmonic or point angle

3 BMU RS Bending Moment u

4 BMV RS Bending Moment v

5 TM RS Twisting Moment

6 SU RS Shear u

7 SV RS Shear v

ELTYPE =36 Unused (Pre-V69 CTRIARG)

2 UNDEF None

ELTYPE =37 Unused (Pre-V69 CTRAPRG)

2 UNDEF None

ELTYPE =38 Gap element (CGAP)

TCODE,7 =0 Real

2 FX RS Comp. Force in x

3 SFY RS Shear Force in y

4 SFZ RS Shear Force in z

5 U RS Axial Disp in u

6 V RS Shear Disp in v

7 W RS Shear Disp in w

8 SV RS Slip Disp in v

9 SW RS Slip Disp in w

5-38 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FX RS Comp. Force in x

3 SFY RS Shear Force in y

4 SFZ RS Shear Force in z

5 U RS Axial Disp in u

6 V RS Shear Disp in v

7 W RS Shear Disp in w

8 SV RS Slip Disp in v

9 SW RS Slip Disp in w

End TCODE,7

ELTYPE =39 Acoustics - Tetra

2 AXR RS Acceleration in x (real)

3 AYR RS Acceleration in y (real)

4 AZR RS Acceleration in z (real)

5 VXR RS Velocity in x (real)

6 VYR RS Velocity in y (real)

7 VXR RS Velocity in z (real)

8 AXI RS Acceleration in x (imaginary)

9 AYI RS Acceleration in y (imaginary)

10 AZI RS Acceleration in z (imaginary)

11 VXI RS Velocity in x (imaginary)

12 VYI RS Velocity in y (imaginary)

13 VXI RS Velocity in z (imaginary)

14 DB RS Pressure

Word Name Type Description

ELTYPE =40 Rod type spring and damper (CBUSH1D)

DMAP Programmer's Guide 5-39


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 FE RS Element Force

3 UE RS Axial Displacement

4 VE RS Axial Velocity*

5 AS RS Axial Stress*

6 AE RS Axial Strain*

7 EP RS Plastic Strain*

8 FAIL I Failed Element Flag

ELTYPE =41 Unused (Pre-V69 CHEXA1)

2 UNDEF None

ELTYPE =42 Unused (Pre-V69 CHEXA2)

2 UNDEF None

ELTYPE =43 Fluid element with 2 points (CFLUID2)

2 UNDEF None

ELTYPE =44 Fluid element with 3 points (CFLUID3)

2 UNDEF None

ELTYPE =45 Fluid element with 4 points (CFLUID4)

2 UNDEF None

ELTYPE =46 Cflmass

2 UNDEF None

ELTYPE =47 Fluid element with 2 points (CAXIF2)

2 UNDEF None

ELTYPE =48 Fluid element with 3 points (CAXIF3)

2 UNDEF None

ELTYPE =49 Fluid element with 4 points (CAXIF4)

2 UNDEF None

5-40 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =50 Three-point slot element (CSLOT3)

2 UNDEF None

ELTYPE =51 Four-point slot element (CSLOT4)

2 UNDEF None

ELTYPE =52 Heat transfer plot element for CHBDYG and CHBDYP

2 UNDEF None

ELTYPE =53 Axisymmetric triangular element (CTRIAX6)

2 UNDEF None

ELTYPE =54 Unused (Pre-V69 CTRIM6)

2 UNDEF None

ELTYPE =55 Three-point dummy element (CDUM3)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =56 Four-point dummy element (CDUM4)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =57 Five-point dummy element (CDUM5)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

DMAP Programmer's Guide 5-41


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =58 Six-point dummy element (CDUM6)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =59 Seven-point dummy element (CDUM7)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

Word Name Type Description

ELTYPE =60 Two-dimensional crack tip element (CRAC2D or CDUM8)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

5-42 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =61 Three-dimensional crack tip element (CRAC3D or CDUM9)

TCODE,7 =0 or 2 Real or Random Response

2 F(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FR(9) RS User defined - real/mag.

11 FI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =62 Unused (Pre-V69 CQDMEM1)

2 UNDEF None

ELTYPE =63 Unused (Pre-V69 CQDMEM2)

2 UNDEF None

ELTYPE =64 Curved quadrilateral shell element (CQUAD8)

2 TERM CHAR4 Character string "CEN/"

3 GRID I Number of active grids or corner grid


identification number

TCODE,7 =0 or 2 Real or Random Response

4 MX RS Membrane force in x

5 MY RS Membrane force in y

6 MXY RS Membrane force in xy

7 BMX RS Bending moment in x

8 BMY RS Bending moment in y

9 BMXY RS Bending moment in xy

10 TX RS Shear force in x

11 TY RS Shear force in y

TCODE,7 =1 Real/imaginary or magnitude/phase

4 MXR RS Membrane force in x - real/mag. part

5 MYR RS Membrane force in y - real/mag. part

DMAP Programmer's Guide 5-43


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 MXYR RS Membrane force in xy - real/mag. part

7 BMXR RS Bending moment in x - real/mag. part

8 BMYR RS Bending moment in y - real/mag. part

9 BMXYR RS Bending moment in xy - real/mag. part

10 TXR RS Shear force in x - real/mag. part

11 TYR RS Shear force in y - real/mag. part

12 MXI RS Membrane force in x - imag./phase part

13 MYI RS Membrane force in y - imag./phase part

14 MXYI RS Membrane force in xy - imag./phase part

15 BMXI RS Bending moment in x - imag./phase part

16 BMYI RS Bending moment in y - imag./phase part

17 BMXYI RS Bending moment in xy - imag./phase part

18 TXI RS Shear force in x - imag./phase part

19 TYI RS Shear force in y - imag./phase part

End TCODE,7

Words 3 through max repeat 005 times

ELTYPE =65 Unused (Pre-V69 CHEX8)

2 UNDEF None

ELTYPE =66 Unused (Pre-V69 CHEX20)

2 UNDEF None

ELTYPE =67 Acoustics in HEXA

2 AXR RS

3 AYR RS

4 AZR RS

5 VXR RS

6 VYR RS

7 VXR RS

5-44 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 AXI RS

9 AYI RS

10 AZI RS

11 VXI RS

12 VYI RS

13 VXI RS

14 DB RS

ELTYPE =68 Acoustics in PENTA

2 AXR RS

3 AYR RS

4 AZR RS

5 VXR RS

6 VYR RS

7 VXR RS

8 AXI RS

9 AYI RS

10 AZI RS

11 VXI RS

12 VYI RS

13 VXI RS

14 DB RS

ELTYPE =69 Curved beam or pipe element (CBEND - see note.)

TCODE,7 =0 or 2 Real or Random Response

2 GRID I Grid point identification number

3 BM1 RS Bending moment plane 1

4 BM2 RS Bending moment plane 1

5 TS1 RS Shear plane 1

DMAP Programmer's Guide 5-45


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 TS2 RS Shear plane 2

7 AF RS Axial force

8 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 GRID I Grid point identification number - real/mag. part

3 BM1R RS Bending moment plane 1 - real/mag. part

4 BM2R RS Bending moment plane 1 - real/mag. part

5 TS1R RS Shear plane 1 - real/mag. part

6 TS2R RS Shear plane 2 - real/mag. part

7 AFR RS Axial force - real/mag. part

8 TRQR RS Torque - real/mag. part

9 BM1I RS Bending moment plane 1 - imag./phase part

10 BM2I RS Bending moment plane 1 - imag./phase part

11 TS1I RS Shear plane 1 - imag./phase part

12 TS2I RS Shear plane 2 - imag./phase part

13 AFI RS Axial force - imag./phase part

14 TRQI RS Torque - imag./phase part

End TCODE,7

Words 2 through max repeat 002 times

Word Name Type Description

ELTYPE =70 Triangular plate element (CTRIAR)

2 TERM CHAR4 Character string "CEN/"

3 GRID I Number of active grids or corner grid ID

TCODE,7 =0 or 2 Real or Random Response

4 MX RS Membrane force in x

5 MY RS Membrane force in y

5-46 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 MXY RS Membrane force in xy

7 BMX RS Bending moment in x

8 BMY RS Bending moment in y

9 BMXY RS Bending moment in xy

10 TX RS Shear force in x

11 TY RS Shear force in y

TCODE,7 =1 Real/imaginary or magnitude/phase

4 MXR RS Membrane force in x - real/mag. part

5 MYR RS Membrane force in y - real/mag. part

6 MXYR RS Membrane force in xy - real/mag. part

7 BMXR RS Bending moment in x - real/mag. part

8 BMYR RS Bending moment in y - real/mag. part

9 BMXYR RS Bending moment in xy - real/mag. part

10 TXR RS Shear force in x - real/mag. part

11 TYR RS Shear force in y - real/mag. part

12 MXI RS Membrane force in x - imag./phase part

13 MYI RS Membrane force in y - imag./phase part

14 MXYI RS Membrane force in xy - imag./phase part

15 BMXI RS Bending moment in x - imag./phase part

16 BMYI RS Bending moment in y - imag./phase part

17 BMXYI RS Bending moment in xy - imag./phase part

18 TXI RS Shear force in x - imag./phase part

19 TYI RS Shear force in y - imag./phase part

End TCODE,7

Words 3 through max repeat 004 times

ELTYPE =71 Unused

2 UNDEF None

DMAP Programmer's Guide 5-47


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =72 AEROQ4

2 UNDEF None

ELTYPE =73 Unused (Pre-V69 CFTUBE)

2 UNDEF None

ELTYPE =74 Triangular shell element (CTRIA3)

TCODE,7 =0 or 2 Real or Random Response

2 MX RS Membrane in x

3 MY RS Membrane in y

4 MXY RS Membrane in xy

5 BMX RS Bending in x

6 BMY RS Bending in y

7 BMXY RS Bending in xy

8 TX RS Transverse Shear in x

9 TY RS Transverse Shear in y

TCODE,7 =1 Real/imaginary or magnitude/phase

2 MXR RS Membrane in x - real/mag. part

3 MYR RS Membrane in y - real/mag. part

4 MXYR RS Membrane in xy - real/mag. part

5 BMXR RS Bending in x - real/mag. part

6 BMYR RS Bending in y - real/mag. part

7 BMXYR RS Bending in xy - real/mag. part

8 TXR RS Transverse Shear in x - real/mag. part

9 TYR RS Transverse Shear in y - real/mag. part

10 MXI RS Membrane in x - imag./phase part

11 MYI RS Membrane in y - imag./phase part

12 MXYI RS Membrane in xy - imag./phase part

13 BMXI RS Bending in x - imag./phase part

5-48 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 BMYI RS Bending in y - imag./phase part

15 BMXYI RS Bending in xy - imag./phase part

16 TXI RS Transverse Shear in x - imag./phase part

17 TYI RS Transverse Shear in y - imag./phase part

End TCODE,7

ELTYPE =75 Curved triangular shell element (CTRIA6)

2 TERM CHAR4 Character string "CEN/"

3 GRID I Number of active grids or corner grid ID

TCODE,7 =0 or 2 Real or Random Response

4 MX RS Membrane force in x

5 MY RS Membrane force in y

6 MXY RS Membrane force in xy

7 BMX RS Bending moment in x

8 BMY RS Bending moment in y

9 BMXY RS Bending moment in xy

10 TX RS Shear force in x

11 TY RS Shear force in y

TCODE,7 =1 Real/imaginary or magnitude/phase

4 MXR RS Membrane force in x - real/mag. part

5 MYR RS Membrane force in y - real/mag. part

6 MXYR RS Membrane force in xy - real/mag. part

7 BMXR RS Bending moment in x - real/mag. part

8 BMYR RS Bending moment in y - real/mag. part

9 BMXYR RS Bending moment in xy - real/mag. part

10 TXR RS Shear force in x - real/mag. part

11 TYR RS Shear force in y - real/mag. part

12 MXI RS Membrane force in x - imag./phase part

DMAP Programmer's Guide 5-49


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 MYI RS Membrane force in y - imag./phase part

14 MXYI RS Membrane force in xy - imag./phase part

15 BMXI RS Bending moment in x - imag./phase part

16 BMYI RS Bending moment in y - imag./phase part

17 BMXYI RS Bending moment in xy - imag./phase part

18 TXI RS Shear force in x - imag./phase part

19 TYI RS Shear force in y - imag./phase part

End TCODE,7

Words 3 through max repeat 004 times

ELTYPE =76 Acoustic velocity/pressures in six-sided solid element (CHEXA)

2 ELNAME(2) CHAR4 Element name: "HEXPR"

TCODE,7 = 1 Real/imaginary or magnitude/phase

4 AXR RS Acceleration in x - real/mag. part

5 AYR RS Acceleration in y - real/mag. part

6 AZR RS Acceleration in z - real/mag. part

7 VXR RS Velocity in x - real/mag. part

8 VYR RS Velocity in y - real/mag. part

9 VZR RS Velocity in z - real/mag. part

10 PRESSURE RS Pressure in dB

11 AXI RS Acceleration in x - imag./phase part

12 AYI RS Acceleration in y - imag./phase part

13 AZI RS Acceleration in z - imag./phase part

14 VXI RS Velocity in x - imag./phase part

15 VYI RS Velocity in y - imag./phase part

16 VXI RS Velocity in z - imag./phase part

TCODE,7 =0 or 2 Real or Random Response

4 AX RS Acceleration in x - real/mag. part

5-50 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 AY RS Acceleration in y - real/mag. part

6 AZ RS Acceleration in z - real/mag. part

7 VX RS Velocity in x - real/mag. part

8 VY RS Velocity in y - real/mag. part

9 VZ RS Velocity in z - real/mag. part

10 PRESSURE RS Pressure in dB

ELTYPE =77 Acoustic velocity/pressures in five-sided solid element (CPENTA)

2 ELNAME(2) CHAR4 Element name: "PENPR"

TCODE,7 =0 or 2 Real or Random Response

4 AX RS Acceleration in x

5 AY RS Acceleration in y

6 AZ RS Acceleration in z

7 VX RS Velocity in x

8 VY RS Velocity in y

9 VZ RS Velocity in z

10 PRESSURE RS Pressure in dB

TCODE,7 =1 Complex

4 AXR RS Acceleration in x - real/mag. part

5 AYR RS Acceleration in y - real/mag. part

6 AZR RS Acceleration in z - real/mag. part

7 VXR RS Velocity in x - real/mag. part

8 VYR RS Velocity in y - real/mag. part

9 VZR RS Velocity in z - real/mag. part

10 PRESSURE RS Pressure in dB

11 AXI RS Acceleration in x - imag./phase part

12 AYI RS Acceleration in y - imag./phase part

13 AZI RS Acceleration in z - imag./phase part

DMAP Programmer's Guide 5-51


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

14 VXI RS Velocity in x - imag./phase part

15 VYI RS Velocity in y - imag./phase part

16 VZI RS Velocity in z - imag./phase part

End TCODE,7

ELTYPE =78 Acoustic velocity/pressures in four-sided solid element (CTETRA)

2 ELNAME(2) CHAR4 Element name: "TETPR"

TCODE,7 =0 or 2 Real or Random Response

4 AX RS Acceleration in x

5 AY RS Acceleration in y

6 AZ RS Acceleration in z

7 VX RS Velocity in x

8 VY RS Velocity in y

9 VZ RS Velocity in z

10 PRESSURE RS Pressure in dB

TCODE,7 =1

4 AXR RS Acceleration in x - real/mag. part

5 AYR RS Acceleration in y - real/mag. part

6 AZR RS Acceleration in z - real/mag. part

7 VXR RS Velocity in x - real/mag. part

8 VYR RS Velocity in y - real/mag. part

9 VZR RS Velocity in z - real/mag. part

10 PRESSURE RS Pressure in dB

11 AXI RS Acceleration in x - imag./phase part

12 AYI RS Acceleration in y - imag./phase part

13 AZI RS Acceleration in z - imag./phase part

14 VXI RS Velocity in x - imag./phase part

15 VYI RS Velocity in y - imag./phase part

5-52 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

16 VZI RS Velocity in z - imag./phase part

End TCODE,7

ELTYPE =79 Acoustic velocity/pressures in five-sided solid element


(CPYRAM)

2 ELNAME(2) CHAR4 Element name: “PYRAMPR”

TCODE,7 = 0 or 2 Real or Random Response

4 AX RS Acceleration in x

5 AY RS Acceleration in y

6 AZ RS Acceleration in z

7 VX RS Velocity in x

8 VY RS Velocity in y

9 VZ RS Velocity in z

10 PRESSURE RS Pressure in dB

TCODE,7 = 1

4 AXR RS Acceleration in x – real/mag. part

5 AYR RS Acceleration in y – real/mag. part

6 AZR RS Acceleration in z – real/mag. part

7 VXR RS Velocity in x – real/mag. part

8 VYR RS Velocity in y– real/mag. part

9 VZR RS Velocity in z– real/mag. part

10 PRESSURE RS Pressure in dB

11 AXI RS Acceleration in x – imag./phase part

12 AYI RS Acceleration in y – imag./phase part

13 AZI RS Acceleration in z – imag./phase part

14 VXI RS Velocity in x – imag./phase part

15 VYI RS Velocity in y – imag./phase part

16 VZI RS Velocity in z – imag./phase part

DMAP Programmer's Guide 5-53


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

Word Name Type Description

ELTYPE =80 Unused

2 UNDEF None

ELTYPE =81 Unused

2 UNDEF None

ELTYPE =82 Quadrilateral plate element (CQUADR)

2 TERM CHAR4 Character string "CEN/"

3 GRID I Number of active grids (4) or corner grid


identification number

TCODE,7 =0 or 2 Real or Random Response

4 MX RS Membrane force in x

5 MY RS Membrane force in y

6 MXY RS Membrane force in xy

7 BMX RS Bending moment in x

8 BMY RS Bending moment in y

9 BMXY RS Bending moment in xy

10 TX RS Shear force in x

11 TY RS Shear force in y

TCODE,7 =1 Real/imaginary or magnitude/phase

4 MXR RS Membrane force in x - real/mag. part

5 MYR RS Membrane force in y - real/mag. part

6 MXYR RS Membrane force in xy - real/mag. part

7 BMXR RS Bending moment in x - real/mag. part

8 BMYR RS Bending moment in y - real/mag. part

9 BMXYR RS Bending moment in xy - real/mag. part

5-54 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 TXR RS Shear force in x - real/mag. part

11 TYR RS Shear force in y - real/mag. part

12 MXI RS Membrane force in x - imag./phase part

13 MYI RS Membrane force in y - imag./phase part

14 MXYI RS Membrane force in xy - imag./phase part

15 BMXI RS Bending moment in x - imag./phase part

16 BMYI RS Bending moment in y - imag./phase part

17 BMXYI RS Bending moment in xy - imag./phase part

18 TXI RS Shear force in x - imag./phase part

19 TYI RS Shear force in y - imag./phase part

End TCODE,7

Words 3 through max repeat 005 times

ELTYPE =83 Acoustic absorber element (CHACAB)

2 UNDEF None

ELTYPE =84 Acoustic barrier element (CHACBR)

2 UNDEF None

ELTYPE =85 Nonlinear TETRA

2 UNDEF None

ELTYPE =86 Nonlinear GAP

2 UNDEF None

ELTYPE =87 Nonlinear TUBE

2 UNDEF None

ELTYPE =88 Nonlinear TRIA3

2 UNDEF None

ELTYPE =89 Nonlinear ROD

2 UNDEF None

DMAP Programmer's Guide 5-55


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =90 Nonlinear QUAD4

2 UNDEF None

ELTYPE =91 Nonlinear PENTA

2 UNDEF None

ELTYPE =92 Nonlinear CONROD

2 UNDEF None

ELTYPE =93 Acoustics in HEXA

2 AXR RS

3 AYR RS

4 AZR RS

5 VXR RS

6 VYR RS

7 VXR RS

8 AXI RS

9 AYI RS

10 AZI RS

11 VXI RS

12 VYI RS

13 VXI RS

14 DB RS

ELTYPE =94 Nonlinear BEAM

2 UNDEF None

ELTYPE =95 Composite quadrilateral plate element (CQUAD4)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

5-56 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

ELTYPE =96 Composite curved quadrilateral shell element (CQUAD8)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

ELTYPE =97 Composite triangular shell element (CTRIA3)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

ELTYPE =98 Composite curved triangular shell element (CTRIA6)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

DMAP Programmer's Guide 5-57


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =99 Unused

2 UNDEF None

Word Name Type Description

ELTYPE =100 Simple beam element w/stations (CBAR with CBARAO or


PLOAD1)

TCODE,7 =0 or 2 Real or Random Response

2 SD RS Station distance divided by length

3 BM1 RS Bending moment plane 1

4 BM2 RS Bending moment plane 2

5 TS1 RS Shear plane 1

6 TS2 RS Shear plane 2

7 AF RS Axial force

8 TRQ RS Torque

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SD RS Station distance divided by length

3 BM1R RS Bending moment plane 1 - real/mag. part

4 BM2R RS Bending moment plane 2 - real/mag. part

5 TP1R RS Shear plane 1 - real/mag. part

6 TP2R RS Shear plane 2 - real/mag. part

7 AFR RS Axial force - real/mag. part

8 TRQR RS Torque - real/mag. part

9 BM1I RS Bending moment plane 1 - imag./phase part

10 BM2I RS Bending moment plane 2 - imag./phase part

11 TS1I RS Shear plane 1 - imag./phase part

12 TS2I RS Shear plane 2 - imag./phase part

13 AFI RS Axial force - imag./phase part

5-58 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 TRQI RS Torque - imag./phase part

End TCODE,7

ELTYPE =101 Acoustic absorber element with freq. dependence (CAABSF)

2 IMPEDR RS Impedance - real/mag. part

3 IMPEDI RS Impedance - imag./phase part

4 ABSORB RS Absorption coefficient

ELTYPE =102 Generalized spring and damper element (CBUSH)

TCODE,7 =0 or 2 Real or Random Response

2 FX RS Force x

3 FY RS Force y

4 FZ RS Force z

5 MX RS Moment x

6 MY RS Moment y

7 MZ RS Moment z

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FXR RS Force x - real/mag. part

3 FYR RS Force y - real/mag. part

4 FZR RS Force z - real/mag. part

5 MXR RS Moment x - real/mag. part

6 MYR RS Moment y - real/mag. part

7 MZR RS Moment z - real/mag. part

8 FXI RS Force x - imag./phase part

9 FYI RS Force y - imag./phase part

10 FZI RS Force z - imag./phase part

11 MXI RS Moment x - imag./phase part

12 MYI RS Moment y - imag./phase part

13 MZI RS Moment z - imag./phase part

DMAP Programmer's Guide 5-59


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

ELTYPE =103 Quadrilateral shell element (QUADP)

2 UNDEF None

ELTYPE =104 Triangular shell p-element (TRIAP)

2 UNDEF None

ELTYPE =105 Beam p-element (BEAMP)

2 UNDEF None

ELTYPE =106 Scalar damper with material property (CDAMP5)

2 UNDEF None

ELTYPE =107 Heat transfer boundary condition element - (CHBDYE)

2 NAME(2) CHAR4 Element name

4 FAPPLIED RS Applied load

5 FREECONV RS Free convection

6 FORCECON RS Forced convection

7 FRAD RS Radiation

8 FTOTAL RS Total

ELTYPE =108 Heat transfer boundary condition element (CHBDYG)

2 NAME(2) CHAR4 Element name

4 FAPPLIED RS Applied load

5 FREECONV RS Free convection

6 FORCECON RS Forced convection

7 FRAD RS Radiation

8 FTOTAL RS Total

ELTYPE =109 Heat transfer boundary condition element (CHBDYP)

2 NAME(2) CHAR4 Element name

4 FAPPLIED RS Applied load

5 FREECONV RS Free convection

5-60 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 FORCECON RS Forced convection

7 FRAD RS Radiation

8 FTOTAL RS Total

Word Name Type Description

ELTYPE =110 CONV

2 UNDEF None

ELTYPE =111 CONVM

2 UNDEF None

ELTYPE =112 QBDY3

2 UNDEF None

ELTYPE =113 QVECT

2 UNDEF None

ELTYPE =114 QVOL

2 UNDEF None

ELTYPE =115 Radbc

2 UNDEF None

ELTYPE =116 Slideline contact (SLIF1D)

2 UNDEF None

Word Name Type Description

ELTYPE =117 CWELDC

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

DMAP Programmer's Guide 5-61


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real / Imaginary

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

17 TRQI RS Torque - imaginary part

End TCODE,7

Word Name Type Description

ELTYPE =118 CWELDP

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

5-62 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real / Imaginary

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

17 TRQI RS Torque - imaginary part

End TCODE,7

Word Name Type Description

ELTYPE =119 CFAST

DMAP Programmer's Guide 5-63


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real / Imaginary

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

17 TRQI RS Torque - imaginary part

End TCODE,7

5-64 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =127 CQUAD

2 UNDEF None

ELTYPE =128 CQUADX

2 UNDEF None

ELTYPE =129 RELUC

2 UNDEF None

Word Name Type Description

ELTYPE =130 RES

2 UNDEF None

ELTYPE =131 TETRAE

2 UNDEF None

ELTYPE =132 CTRIA

2 UNDEF None

ELTYPE =133 CTRIAX

2 UNDEF None

ELTYPE =134 LINEOB

2 UNDEF None

ELTYPE =135 LINXOB

2 UNDEF None

ELTYPE =136 QUADOB

2 UNDEF None

ELTYPE =137 TRIAOB

2 UNDEF None

ELTYPE =138 LINEX

2 UNDEF None

ELTYPE =139 Hyperelastic QUAD4FD

DMAP Programmer's Guide 5-65


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

Word Name Type Description

ELTYPE =140 HEXA8FD

2 UNDEF None

ELTYPE =141 Six-sided solid p-element (HEXAP)

2 UNDEF None

ELTYPE =142 Five-sided solid p-element (PENTAP)

2 UNDEF None

ELTYPE =143 Four-sided solid p-element (TETRAP)

2 UNDEF None

ELTYPE =144 Quadrilateral plate element for corner stresses (QUAD144)

2 TERM CHAR4 Character string "CEN/"

3 GRID I Number of active grids (4) or corner grid ID

TCODE,7 =0 or 2 Real or Random Response

4 MX RS Membrane x

5 MY RS Membrane y

6 MXY RS Membrane xy

7 BMX RS Bending x

8 BMY RS Bending y

9 BMXY RS Bending xy

10 TX RS Shear x

11 TY RS Shear y

TCODE,7 =1 Real/imaginary or magnitude/phase

4 MXR RS Membrane x - real/mag. part

5 MYR RS Membrane y - real/mag. part

6 MXYR RS Membrane xy - real/mag. part

5-66 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 BMXR RS Bending x - real/mag. part

8 BMYR RS Bending y - real/mag. part

9 BMXYR RS Bending xy - real/mag. part

10 TXR RS Shear x - real/mag. part

11 TYR RS Shear y - real/mag. part

12 MXI RS Membrane x - imag./phase part

13 MYI RS Membrane y - imag./phase part

14 MXYI RS Membrane xy - imag./phase part

15 BMXI RS Bending x - imag./phase part

16 BMYI RS Bending y - imag./phase part

17 BMXYI RS Bending xy - imag./phase part

18 TXI RS Shear x - imag./phase part

19 TYI RS Shear y - imag./phase part

End TCODE,7

Words 3 through max repeat 005 times

ELTYPE =145 Six-sided solid display element (VUHEXA)

2 UNDEF None

ELTYPE =146 Five-sided solid display element (VUPENTA)

2 UNDEF None

ELTYPE =147 Four-sided solid display element (VUTETRA)

2 UNDEF None

ELTYPE =148 HEXAM

2 UNDEF None

ELTYPE =149 PENTAM

2 UNDEF None

DMAP Programmer's Guide 5-67


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =150 TETRAM

2 UNDEF None

ELTYPE =151 QUADM

2 UNDEF None

ELTYPE =152 TRIAM

2 UNDEF None

ELTYPE =153 QUADXM

2 UNDEF None

ELTYPE =154 TRIAXM

2 UNDEF None

ELTYPE =155 QUADPW

2 UNDEF None

ELTYPE =156 TRIAPW

2 UNDEF None

ELTYPE =157 LINEPW

2 UNDEF None

ELTYPE =158 QUADOBM

2 UNDEF None

ELTYPE =159 TRIAOBM

2 UNDEF None

Word Name Type Description

ELTYPE =160 Five-sided finite deformation solid element (PENTA6FD)

2 UNDEF None

ELTYPE =161 Five-sided finite deformation solid element (TETRA4FD)

2 UNDEF None

ELTYPE =162 Triangular finite deformation shell element (TRIA3FD)

5-68 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =163 HEXAFD

2 UNDEF None

ELTYPE =164 QUADFD

2 UNDEF None

ELTYPE =165 PENTAFD

2 UNDEF None

ELTYPE =166 TETRAFD

2 UNDEF None

ELTYPE =167 TRIAFD

2 UNDEF None

ELTYPE =168 TRIAX3FD

2 UNDEF None

ELTYPE =169 TRIAXFD

2 UNDEF None

Word Name Type Description

ELTYPE =170 QUADX4FD

2 UNDEF None

ELTYPE =171 QUADXFD

2 UNDEF None

ELTYPE =174 LINEOBM

2 UNDEF None

ELTYPE =175 LINXOBM

2 UNDEF None

ELTYPE =176 QUADWGM

2 UNDEF None

DMAP Programmer's Guide 5-69


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =177 TRIAWGM

2 UNDEF None

ELTYPE =178 QUADIB

2 UNDEF None

ELTYPE =179 TRIAIB

2 UNDEF None

Word Name Type Description

ELTYPE =180 LINEIB

2 UNDEF None

ELTYPE =181 LINXIB

2 UNDEF None

ELTYPE =182 QUADIBM

2 UNDEF None

ELTYPE =183 TRIAIBM

2 UNDEF None

ELTYPE =184 LINEIBM

2 UNDEF None

ELTYPE =185 LINXIBM

2 UNDEF None

ELTYPE =186 QUADPWM

2 UNDEF None

ELTYPE =187 TRIAPWM

2 UNDEF None

ELTYPE =188 LINEPWM

2 UNDEF None

ELTYPE =189 Quadrilateral plate view element (VUQUAD)

5-70 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

5 THETA I Material angle

6 UNDEF None

TCODE,7 =0 Real

7 VUID I VU-grid identification number ID for corner

8 MFX RS Membrane force x

9 MFY RS Membrane force y

10 MFXY RS Membrane force xy

11 UNDEF(3 ) None

14 BMX RS Bending moment x

15 BMY RS Bending moment y

16 BMXY RS Bending moment xy

17 SYZ RS Shear yz

18 SZX RS Shear zx

19 UNDEF None

Words 7 through 19 repeat 004 times

TCODE,7 =1 Real/imaginary or magnitude/phase

7 VUID I VU-grid identification number for corner

8 MFXR RS Membrane force x real/mag.

9 MFYR RS Membrane force y real/mag.

10 MFXYR RS Membrane force xy real/mag.

11 UNDEF(3 ) None

14 BMXR RS Bending moment x real/mag.

15 BMYR RS Bending moment y real/mag.

16 BMXYR RS Bending moment xy real/mag.

DMAP Programmer's Guide 5-71


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 SYZR RS Shear yz real/mag.

18 SZXR RS Shear zx real/mag.

19 UNDEF None

20 MFXI RS Membrane force x imag./phase

21 MFYI RS Membrane force y imag./phase

22 MFXYI RS Membrane force xy imag./phase

23 UNDEF(3 ) None

26 BMXI RS Bending moment x imag./phase

27 BMYI RS Bending moment y imag./phase

28 BMXYI RS Bending moment xy imag./phase

29 SYZI RS Shear yz imag./phase

30 SZXI RS Shear zx imag./phase

31 UNDEF None

Words 7 through 31 repeat 004 times

End TCODE,7

Word Name Type Description

ELTYPE =190 Triangular shell view element (VUTRIA)

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

5 THETA I Material angle

6 UNDEF None

TCODE,7 =0 Real

7 VUID I VU grid ID for this corner

8 MFX RS Membrane force x

9 MFY RS Membrane force y

5-72 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 MFXY RS Membrane force xy

11 UNDEF(3 ) None

14 BMX RS Bending moment x

15 BMY RS Bending moment y

16 BMXY RS Bending moment xy

17 SYZ RS Shear yz

18 SZX RS Shear zx

19 UNDEF None

Words 7 through 19 repeat 003 times

TCODE,7 =1 Real/imaginary or magnitude/phase

7 VUID I VU grid ID this corner

8 MFXR RS Membrane force x real/mag.

9 MFYR RS Membrane force y real/mag.

10 MFXYR RS Membrane force xy real/mag.

11 UNDEF(3 ) None

14 BMXR RS Bending moment x real/mag.

15 BMYR RS Bending moment y real/mag.

16 BMXYR RS Bending moment xy real/mag.

17 SYZR RS Shear yz real/mag.

18 SZXR RS Shear zx real/mag.

19 UNDEF None

20 MFXI RS Membrane force x imag./phase

21 MFYI RS Membrane force y imag./phase

22 MFXYI RS Membrane force xy imag./phase

23 UNDEF(3 ) None

26 BMXI RS Bending moment x imag./phase

27 BMYI RS Bending moment y imag./phase

DMAP Programmer's Guide 5-73


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

28 BMXYI RS Bending moment xy imag./phase

29 SYZI RS Shear yz imag./phase

30 SZXI RS Shear zx imag./phase

31 UNDEF None

Words 7 through 31 repeat 003 times

End TCODE,7

ELTYPE =191 Beam view element (VUBEAM)

2 PARENT I Parent p-element identification number

3 COORD I Coordinate system identification number

4 ICORD CHAR4 Flat/curved and so on

TCODE,7 =0 Real

5 VUGRID I VU grid ID for output grid

6 POSIT RS x/L position of VU grid identification number

7 FORCEX RS Force x

8 SHEARY RS Shear force y

9 SHEARZ RS Shear force z

10 TORSION RS Torsional moment x

11 BENDY RS Bending moment y

12 BENDZ RS Bending moment z

TCODE,7 =1 Real/imaginary or magnitude/phase

5 VUGRID I VU grid identification number for output grid

6 POSIT RS x/L position of VU grid identification number

7 FORCEXR RS Force x real/mag.

8 SHEARYR RS Shear force y real/mag.

9 SHEARZR RS Shear force z real/mag.

10 TORSINR RS Torsional moment x real/mag.

11 BENDYR RS Bending moment y real/mag.

5-74 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

12 BENDZR RS Bending moment z real/mag.

13 FORCEXI RS Force x imag./phase

14 SHEARYI RS Shear force y imag./phase

15 SHEARZI RS Shear force z imag./phase

16 TORSINI RS Torsional moment x imag./phase

17 BENDYI RS Bending moment y imag./phase

18 BENDZI RS Bending moment z imag./phase

End TCODE,7

Words 5 through max repeat 2 times

ELTYPE =192 CVINT

2 UNDEF None

ELTYPE =193 QUADFR

2 UNDEF None

ELTYPE =194 TRIAFR

2 UNDEF None

ELTYPE =195 LINEFR

2 UNDEF None

ELTYPE =196 LINXFR

2 UNDEF None

ELTYPE =197 GMINTS

2 UNDEF None

ELTYPE =198 CNVPEL

2 UNDEF None

ELTYPE =199 VUHBDY

2 UNDEF None

DMAP Programmer's Guide 5-75


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =200 CWELD

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real / Imaginary

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

17 TRQI RS Torque - imaginary part

5-76 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End TCODE,7

ELTYPE =201 Nonlinear hyperelastic QUAD4FD

TCODE,7 =0 or 2 Real or Random Response

2 BM1A RS Bending moment end A plane 1

3 BM2A RS Bending moment end A plane 2

4 BM1B RS Bending moment end B plane 1

5 BM2B RS Bending moment end B plane 2

6 TS1 RS Shear plane 1

7 TS2 RS Shear plane 2

8 AF RS Axial Force

9 TRQ RS Torque

TCODE,7 =1 Real / Imaginary

2 BM1AR RS Bending moment end A plane 1 - real part

3 BM2AR RS Bending moment end A plane 2 - real part

4 BM1BR RS Bending moment end B plane 1 - real part

5 BM2BR RS Bending moment end B plane 2 - real part

6 TS1R RS Shear plane 1 - real part

7 TS2R RS Shear plane 2 - real part

8 AFR RS Axial force - real part

9 TRQR RS Torque - real part

10 BM1AI RS Bending moment end A plane 1 - imaginary part

11 BM2AI RS Bending moment end A plane 2 - imaginary part

12 BM1BI RS Bending moment end B plane 1 - imaginary part

13 BM2BI RS Bending moment end B plane 2 - imaginary part

14 TS1I RS Shear plane 1 - imaginary part

15 TS2I RS Shear plane 2 - imaginary part

16 AFI RS Axial Force - imaginary part

DMAP Programmer's Guide 5-77


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 TRQI RS Torque - imaginary part

End TCODE,7

ELTYPE =202 Nonlinear hyperelastic HEXA4FD

2 UNDEF None

ELTYPE =203 Slideline contact (SLIF1D)

2 UNDEF None

ELTYPE =204

2 UNDEF None

ELTYPE =205

2 UNDEF None

ELTYPE =206 Hyperelastic triangular 3-noded nonlinear format (TRIA3FD)


Gaus

2 UNDEF None

ELTYPE =207 Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD)


Gaus

2 UNDEF None

ELTYPE =208

2 UNDEF None

ELTYPE =209

2 UNDEF None

Word Name Type Description

ELTYPE =210

2 UNDEF None

ELTYPE =211

2 UNDEF None

ELTYPE =212

2 UNDEF None

5-78 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =213

2 UNDEF None

ELTYPE =214

2 UNDEF None

ELTYPE =215

2 UNDEF None

ELTYPE =216

2 UNDEF None

ELTYPE =217 Hyperelastic triangular 3-noded nonlinear format (TRIA3FD) Grid

2 UNDEF None

ELTYPE =218 Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD)


Grid

2 UNDEF None

ELTYPE =219

2 UNDEF None

Word Name Type Description

ELTYPE =220

2 UNDEF None

ELTYPE =221

2 UNDEF None

ELTYPE =222

2 UNDEF None

ELTYPE =223

2 UNDEF None

ELTYPE =224 Nonlinear ELAS1

2 UNDEF None

ELTYPE =225 Nonlinear ELAS3

DMAP Programmer's Guide 5-79


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =226 Nonlinear BUSH

2 UNDEF None

ELTYPE =227 Triangular shell element (CTRIAR)

TCODE,7 =0 or 2 Real or Random Response

2 MX RS Membrane in x

3 MY RS Membrane in y

4 MXY RS Membrane in xy

5 BMX RS Bending in x

6 BMY RS Bending in y

7 BMXY RS Bending in xy

8 TX RS Transverse Shear in x

9 TY RS Transverse Shear in y

TCODE,7 =1 Real/imaginary or magnitude/phase

2 MXR RS Membrane in x - real/mag. part

3 MYR RS Membrane in y - real/mag. part

4 MXYR RS Membrane in xy - real/mag. part

5 BMXR RS Bending in x - real/mag. part

6 BMYR RS Bending in y - real/mag. part

7 BMXYR RS Bending in xy - real/mag. part

8 TXR RS Transverse Shear in x - real/mag. part

9 TYR RS Transverse Shear in y - real/mag. part

10 MXI RS Membrane in x - imag./phase part

11 MYI RS Membrane in y - imag./phase part

12 MXYI RS Membrane in xy - imag./phase part

13 BMXI RS Bending in x - imag./phase part

14 BMYI RS Bending in y - imag./phase part

5-80 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

15 BMXYI RS Bending in xy - imag./phase part

16 TXI RS Transverse Shear in x - imag./phase part

17 TYI RS Transverse Shear in y - imag./phase part

End TCODE,7

ELTYPE =228 Quadrilateral plate element (CQUADR)

TCODE,7 =0 or 2 Real or Random Response

2 MX RS Membrane in x

3 MY RS Membrane in y

4 MXY RS Membrane in xy

5 BMX RS Bending in x

6 BMY RS Bending in y

7 BMXY RS Bending in xy

8 TX RS Transverse Shear in x

9 TY RS Transverse Shear in y

TCODE,7 =1 Real/imaginary or magnitude/phase

2 MXR RS Membrane in x - real/mag. part

3 MYR RS Membrane in y - real/mag. part

4 MXYR RS Membrane in xy - real/mag. part

5 BMXR RS Bending in x - real/mag. part

6 BMYR RS Bending in y - real/mag. part

7 BMXYR RS Bending in xy - real/mag. part

8 TXR RS Transverse Shear in x - real/mag. part

9 TYR RS Transverse Shear in y - real/mag. part

10 MXI RS Membrane in x - imag./phase part

11 MYI RS Membrane in y - imag./phase part

12 MXYI RS Membrane in xy - imag./phase part

13 BMXI RS Bending in x - imag./phase part

DMAP Programmer's Guide 5-81


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

14 BMYI RS Bending in y - imag./phase part

15 BMXYI RS Bending in xy - imag./phase part

16 TXI RS Transverse Shear in x - imag./phase part

17 TYI RS Transverse Shear in y - imag./phase part

End TCODE,7

Word Name Type Description

ELTYPE =232 Composite quadrilateral plate element (CQUADR)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

ELTYPE =233 Composite triangular shell element (CTRIAR)

2 THEORY(2) CHAR4 Theory

4 LAMID I Lamina number

5 FP RS Failure index for direct stresses

6 FM CHAR4 Failure mode for maximum strain theory

7 FB RS Failure index for interlaminar shear stress or -1

8 FMAX RS Maximum of FP and FB or -1.

9 FFLAG CHAR4 Failure flag

End ELTYPE

End THERMAL

Word Name Type Description

ELTYPE =267 Ply failure for HEXAL

5-82 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 PLY I Lamina number

PLSLOC=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 V1 RS Failure value 1

7 V2 RS Failure value 2

8 V3 RS Failure value 3

9 V4 RS Failure value 4

10 V5 RS Failure value 5

11 V6 RS Failure value 6

PLSLOC=1 Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 V1 RS Failure value 1

7 V2 RS Failure value 2

8 V3 RS Failure value 3

9 V4 RS Failure value 4

10 V5 RS Failure value 5

11 V6 RS Failure value 6

Words 3 thru 11 repeat 5 times

Word Name Type Description

ELTYPE =268 Ply failure for PENTAL

2 PLY I Lamina number

PLSLOC=0 Center option

DMAP Programmer's Guide 5-83


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 V1 RS Failure value 1

7 V2 RS Failure value 2

8 V3 RS Failure value 3

9 V4 RS Failure value 4

10 V5 RS Failure value 5

11 V6 RS Failure value 6

PLSLOC=1 Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 V1 RS Failure value 1

7 V2 RS Failure value 2

8 V3 RS Failure value 3

9 V4 RS Failure value 4

10 V5 RS Failure value 5

11 V6 RS Failure value 6

Words 3 thru 11 repeat 4 times

Word Name Type Description

ELTYPE =269 Inter-laminar failure for HEXAL

2 PLY I Lamina number

PLSLOC=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5-84 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 THEORY CHAR4 Failure theory

6 FSV RS Failure value

PLSLOC=1 Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 FSV RS Failure value

Words 3 thru 6 repeat 5 times

Word Name Type Description

ELTYPE =270 Inter-laminar failure for PENTAL

2 PLY I Lamina number

PLSLOC=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 FSV RS Failure value

PLSLOC=1 Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, and TOP)

4 GRID I Edge grid ID (0=center)

5 THEORY CHAR4 Failure theory

6 FSV RS Failure value

Words 3 thru 6 repeat 4 times

Word Name Type Description

ELTYPE =280 Generalized bearing element (CBEAR)

TCODE,7 =0 or 2 Real or Random Response

2 FX RS Force x

DMAP Programmer's Guide 5-85


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 FY RS Force y

4 FZ RS Force z

5 MX RS Moment about x

6 MY RS Moment about y

7 MZ RS Moment about z

TCODE,7 =1 Real/imaginary or magnitude/phase

2 FXR RS Force x - real/mag. part

3 FYR RS Force y - real/mag. part

4 FZR RS Force z - real/mag. part

5 MXR RS Moment about x - real/mag. part

6 MYR RS Moment about y - real/mag. part

7 MZR RS Moment about z - real/mag. part

8 FXI RS Force x - imag./phase part

9 FYI RS Force y - imag./phase part

10 FZI RS Force z - imag./phase part

11 MXI RS Moment about x - imag./phase part

12 MYI RS Moment about y - imag./phase part

13 MZI RS Moment about z - imag./phase part

Record - TRAILER

Word Name Type Description

1 UNDEF(6 ) None

Notes:
1. The RECORD=IDENT and DATA pair is repeated for each subcase.

2. 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.

5-86 DMAP Programmer's Guide


Data Block Descriptions O-V

5.9 OEFMC
Table of modal contributions of element forces.
For all analysis types (real and complex), and SORT1 and SORT2 formats.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 MCODE I Modal contributions code: 1=absolute,


2=normalized

4 SUBCASE I Subcase number

5 EICODE I Element item code (1000*element ID + item code)

TCODE,1 =1 Sort 1

ACODE,4 = 05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

ACODE,4 =06 Transient

6 TIME RS Time step

7 UNDEF None

ACODE,4 =09 Complex Eigenvalues

6 EIGR RS Eigenvalue – real part

7 EIGI RS Eigenvalue – imaginary part

End ACODE,4

DMAP Programmer's Guide 5-87


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,1 =02 Sort 2

6 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

7 MFREQ RS Modal frequency (Hz)

End TCODE,1

8 UNDEF None

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE,1 =01 Sort 1

1 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

2 MFREQ RS Modal frequency (Hz)

TCODE,1 =02 Sort 2

ACODE,4 =05

1 FREQ RS Frequency (Hz)

2 UNDEF None

ACODE,4 =06

1 TIME RS Time step

2 UNDEF None

ACODE,4 =09

5-88 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

1 EIGR RS Eigenvalue – real part

2 EIGI RS Eigenvalue – imaginary part

End ACODE,4

End TCODE,1

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 =1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

Record 3 - TRAILER
Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

5.10 OERP
Equivalent radiated power output.

Record - HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No def or month, year, one, one

Word 3 repeats until End of Record

Record - IDENT
Word Name Type Description

1 ACODE I Device code + 10*Approach code

DMAP Programmer's Guide 5-89


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TCODE(C) I Table code = 69 + n*1000

TCODE=1 SORT1 format

3 UNDEF None

4 SUBCASE I Subcase identification number

5 FREQ RS Frequency

6 UNDEF None

TCODE=2 SORT2 format

3 ERPMAX I Max ERP across all frequencies for a panel

4 SUBCASE I Subcase identification number

5 NAME(2) CHAR4 Name of panel

End TCODE

7 FLTKEY I Key = 1 FREQ Key = 2 FRAC

8 UNDEF None

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(12) None

TCODE=1 SORT1 format

23 UNDEF None

TCODE=2 SORT2 format

23 AREA RS Panel area

End TCODE

24 UNDEF(27) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

5-90 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - DATA

Word Name Type Description

TCODE,1 = 1 SORT1 Format

1 NAME(2) CHAR4 ERP panel name

3 ERPVAL RS ERP value

4 ERPFRA RS ERP fraction (fraction of total ERP)

5 AREA RS Panel normal area

6 ERPDENS RS ERP density (ERP / area)

TCODE,1 = 2 SORT2 Format

3 FREQ RS Excitation frequency

4 ERPVAL RS ERP value

5 ERPFRA RS ERP fraction (ERP / ERP normalized)

6 ERPDENS RS ERP density (ERP / area)

End TCODE

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

5.11 OERPEL
Element equivalent radiated power output.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No def or month, year, one, one

Word 3 repeats until End of Record

DMAP Programmer's Guide 5-91


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record - IDENT

Word Name Type Description

1 ACODE I Device code + 10*Approach code

2 TCODE(C) I Table code = 70 + n*1000

3 ELTYPE(C) I Element type

4 SUBCASE I Subcase identification number

TCODE=1 SORT1 format

5 FREQ RS Frequency

TCODE=2 SORT2 format

5 ELEMID I Element identification number

End TCODE

6 UNDEF(3) None

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1 = 1 SORT1 Format

1 ELEMID I Element identification number

TCODE,1 = 2 SORT2 Format

1 FREQ RS Excitation frequency

2 ERPVAL RS ERP value - absolute

3 ERPDENS RS ERP density (ERP / area)

End TCODE

5-92 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

5.12 OERR
Error estimator table.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No def or month, year, one, one

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code =


60+iand(print,plot)

2 TCODE(C) I Table code = 76

3 ELTYPE(C) I Element type

4 SUBCASE I Subcase or random identification number

5 TIME RS Time step

6 UNDEF(4) None

10 NUMWDE I Number of words per entry in DATA record

11 ESTOPT I Strain energy/stress code: 0=strain energy,


1=stress

12 FLAG(C) I Stepping/max code: 0=stepping results,


1=maximum results

13 UNDEF(38) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

DMAP Programmer's Guide 5-93


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

1 ELID I Element ID*10 + device code

FLAG = 0 Stepping results

2 ERREST RS Energy/stress error norm

3 EST RS Energy/stress norm

FLAG = 1 Maximum results

2 ERREST RS Energy/stress error norm at TIMMAX

3 EST RS Energy/stress norm

4 TIMMAX RS Time point of MAX error estimators

End of Record

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

5.13 OES
Table of element stresses or strains

For all analysis types (real and complex) and SORT1 and SORT2 formats.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block Name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

5-94 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 ELTYPE(C) I Element Type

4 SUBCASE I Subcase or Random identification number

TCODE,1 = 1 Sort 1

ACODE,4 = 01 Statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE,4 = 02 Real Eigenvalues

5 MODE I Mode Number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or Cycle

ACODE,4 = 03 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE,4 = 04 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE,4 = 05 Frequency

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE,4 = 06 Transient

5 TIME RS Time Step

6 UNDEF(2) None

ACODE,4 = 07 Buckling Phase 0 (Pre-buckling)

DMAP Programmer's Guide 5-95


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 LSDVMN I Load set

6 UNDEF(2) None

ACODE,4 = 08 Buckling Phase 1 (Post-buckling)

5 LSDVMN I Mode Number

6 EIGR RS Eigenvalue

7 RANDID I Random ID number

ACODE,4 = 09 Complex Eigenvalues

5 MODE I Mode

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE,4 = 10 Nonlinear statics

5 LFTSFQ RS Load step

6 UNDEF(2) None

ACODE,4 = 11 Old geometric nonlinear statics

5 LSDVMN I Load set

6 UNDEF None

7 RANDID I Random ID number

ACODE,4 = 12 CONTRAN (Can appear as ACODE=6)

5 TIME RS Time step

6 UNDEF(2) None

End ACODE,4

TCODE,1 = 02 Sort 2

5 LSDVMN I Load set, mode number, time step, and so on

6 UNDEF(2) None

End TCODE,1

8 LOADSET I Load set number, Random code ID or Zero

9 FCODE I Format Code

5-96 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 NUMWDE(C) I Number of words per entry in DATA record

11 SCODE(C) I Stress/Strain code

12 PID (SOL 601 I Physical Property ID for SOL 601 & 701 only.
and 701 only) UNDEF for all other SOLs

13 ELRESCS I 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 Q4CSTR(C) I Corner Stress Flag

15 PLSLOC(C) I Ply stress/strain location for elements


referencing PCOMPS property entries.
= 1 Middle of each ply.
= 2 Bottom and top of each ply.
= 3 Bottom, middle, and top of each ply.

16 CSOPT I Plane designation for axisymmetric and


plane stress/strain elements
CSOPT=13 indicates these elements are in
the XZ-plane of the basic coordinate system.
For axisymmetric elements, Z is axial and X
is radial.
CSOPT=21 indicates these elements are in
the XY-plane of the basic coordinate system.
For axisymmetric elements, X is axial and
Y is radial.

17 RMSSF RS RMS and CRMS scale factor.

18 EPSTYPE(C) I Designates the type of strain.


0 = Total Strain
1 = Elastic Strain
2 = Thermal Strain

19 VMFLAG I 0 = von Mises results are not present for


complex results

20 RSPEED RS Rotor speed in RUNIT units

21 RUNIT CHAR4 RSPEED units; RPM, CPS, HZ, or RAD;


blank or integer 0 in a non-rotor dynamic
analyses

DMAP Programmer's Guide 5-97


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

22 UNDEF(29) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

SORTCODE=1 Sort 1 - SortCode=((TCODE/1000)+2)/2

TCODE,1 =1 o

1 EKEY I Device code + 10*Point identification number

TCODE,1 =02 Sort 2

ACODE/10=01 Analysis type

ACODE,4 =01 n

1 EKEY I 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

5-98 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

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

End ACODE,4

End ACODE/10

Word Name Type Description

ELTYPE =00 Grid - OES1G table

2 MATID I Material identification number

3 NX1 RS Normal in x at d1

4 NY1 RS Normal in y at d1

5 TXY1 RS Shear in xy at d1

6 SA1 RS Theta ( Shear Angle ) at d1

7 MJRP1 RS Major Principal at d1

8 MNRP1 RS Minor Principal at d1

9 TMAX1 RS Maximum Shear at d1

10 PCODE I 10*interpolation points + projection code

11 NX2 RS Normal in x at d2

12 NY2 RS Normal in y at d2

13 TXY2 RS Shear in xy at d2

14 SA2 RS Theta ( Shear Angle ) at d2

DMAP Programmer's Guide 5-99


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

15 MJRP2 RS Major Principal at d2

16 MNRP2 RS Minor Principal at d2

17 TMAX2 RS Maximum Shear at d2

ELTYPE =01 Rod element (CROD)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 AE RS Axial Strain

3 MSA RS Axial Safety Margin*

4 TE RS Torsional Strain

5 MST RS Torsional Safety Margin*

TCODE,7 =1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

TCODE,7 =2 Random Response

2 AE RS Axial Strain

3 TE RS Torsional Strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 AS RS Axial Stress

3 MSA RS Axial Safety Margin*

4 TS RS Torsional Stress

5 MST RS Torsional Safety Margin*

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

5-100 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Random Response

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

End SCODE,6

ELTYPE =02 Beam element (CBEAM)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 EXC RS Long. Strain at Point C

5 EXD RS Long. Strain at Point D

6 EXE RS Long. Strain at Point E

7 EXF RS Long. Strain at Point F

8 EMAX RS Maximum stress

9 EMIN RS Minimum stress

10 MST RS Margin of Safety in Tension

11 MSC RS Margin of Safety in Compression

Words 2 through 11 repeat 011 times

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 ERCR RS Long. Strain at Point C

5 EXDR RS Long. Strain at Point D

DMAP Programmer's Guide 5-101


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 EXER RS Long. Strain at Point E

7 EXFR RS Long. Strain at Point F

8 EXCI RS Long. Strain at Point C

9 EXDI RS Long. Strain at Point D

10 EXEI RS Long. Strain at Point E

11 EXFI RS Long. Strain at Point F

Words 2 through 11 repeat 011 times

TCODE,7 =2 Random Response

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 EXC RS Long. Strain at Point C

5 EXD RS Long. Strain at Point D

6 EXE RS Long. Strain at Point E

7 EXF RS Long. Strain at Point F

Words 2 through 7 repeat 011 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SXC RS Long. Stress at Point C

5 SXD RS Long. Stress at Point D

6 SXE RS Long. Stress at Point E

7 SXF RS Long. Stress at Point F

8 SMAX RS Maximum stress

9 SMIN RS Minimum stress

10 MST RS Margin of Safety in Tension

5-102 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 MSC RS Margin of Safety in Compression

Words 2 through 11 repeat 011 times

TCODE,7=1 Real/Imaginary

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SRCR RS Long. Stress at Point C

5 SXDR RS Long. Stress at Point D

6 SXER RS Long. Stress at Point E

7 SXFR RS Long. Stress at Point F

8 SXCI RS Long. Stress at Point C

9 SXDI RS Long. Stress at Point D

10 SXEI RS Long. Stress at Point E

11 SXFI RS Long. Stress at Point F

Words 2 through 11 repeat 011 times

TCODE,7 =2 Random Response

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SXC RS Long. Stress at Point C

5 SXD RS Long. Stress at Point D

6 SXE RS Long. Stress at Point E

7 SXF RS Long. Stress at Point F

Words 2 through 7 repeat 011 times

End
TCODE,7

End
SCODE,6

ELTYPE=03 Tube element (CTUBE)

DMAP Programmer's Guide 5-103


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

SCODE,6=0 Strain

TCODE,7 =0 Real

2 AE RS Axial Strain

3 MSA RS Axial Safety Margin*

4 TE RS Torsional Strain

5 MST RS Torsional Safety Margin*

TCODE,7=1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

TCODE,7 =2 Random Response

2 AE RS Axial Strain

3 TE RS Torsional Strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 AS RS Axial Stress

3 MSA RS Axial Safety Margin*

4 TS RS Torsional Stress

5 MST RS Torsional Safety Margin*

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Random Response

5-104 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

End SCODE,6

ELTYPE =04 Shear panel element (CSHEAR)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 ETMAX RS Maximum Shear

3 ETAVG RS Average Shear

4 MS RS Safety Margin*

TCODE,7 =1 Real / Imaginary

2 ETMAXR RS Maximum Shear

3 ETMAXI RS Maximum Shear

4 ETAVGR RS Average Shear

5 ETAVGI RS Average Shear

TCODE,7 =2 Random
Response

2 ETMAX RS Maximum Shear

3 ETAVG RS Average Shear

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TMAX RS Maximum Shear

3 TAVG RS Average Shear

4 MS RS Safety Margin*

TCODE,7 =1 Real / Imaginary

2 TMAXR RS Maximum Shear

DMAP Programmer's Guide 5-105


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 TMAXI RS Maximum Shear

4 TAVGR RS Average Shear

5 TAVGI RS Average Shear

TCODE,7 =2 Random
Response

2 TMAX RS Maximum Shear

3 TAVG RS Average Shear

End TCODE,7

End SCODE,6

ELTYPE =05 FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness)

2 UNDEF None

ELTYPE =06 Unused

2 UNDEF None

ELTYPE =07 PLOAD4 (follower stiffness)

2 UNDEF None

ELTYPE =08 PLOADX1 (follower stiffness)

2 UNDEF None

ELTYPE =09 PLOAD and PLOAD2 (follower stiffness)

2 UNDEF None

Word Name Type Description

ELTYPE =10 Rod element connection and property (CONROD)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 AE RS Axial Strain

3 MSA RS Axial Safety Margin*

4 TE RS Torsional Strain

5-106 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 MST RS Torsional Safety Margin*

TCODE,7 =1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

TCODE,7 =2 Random
Response

2 AE RS Axial Strain

3 TE RS Torsional Strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 AS RS Axial Stress

3 MSA RS Axial Safety Margin*

4 TS RS Torsional Stress

5 MST RS Torsional Safety Margin*

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Random Response

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

End SCODE,6

DMAP Programmer's Guide 5-107


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =11 Scalar spring element (CELAS1)

SCODE,6 =0 Strain

TCODE,7 =0 or 2 Real or Random Response

2 E RS

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 or 2 Real or Random Response

2 S RS Stress

TCODE,7 =1 Real / Imaginary

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =12 Scalar spring element with properties (CELAS2)

SCODE,6 =0 Strain

TCODE,7 =0 or 2 Real or Random Response

2 E RS

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 or 2 Real or Random Response

2 S RS Stress

5-108 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/Imaginary

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =13 Scalar spring element to scalar points only (CELAS3)

SCODE,6 =0 Strain

TCODE,7 =0 or 2 Real or Random Response

2 E RS

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 or 2 Real or Random Response

2 S RS Stress

TCODE,7 =1

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =14 Scalar spring element to scalar points only with properties
(CELAS4)

2 UNDEF None

ELTYPE =15 AEROT3

2 UNDEF None

ELTYPE =16 AEROBEAM

DMAP Programmer's Guide 5-109


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =17 Unused (pre-V69 TRIA2 Same as TRIA1)

2 UNDEF None

ELTYPE =18 Unused (pre-V69 QUAD2 Same as TRIA1)

2 UNDEF None

ELTYPE =19 Unused (pre-V69 QUAD1 Same as TRIA1)

2 UNDEF None

Word Name Type Description

ELTYPE =20 Scalar damper (CDAMP1)

2 UNDEF None

ELTYPE =21 Scalar damper with properties (CDAMP2)

2 UNDEF None

ELTYPE =22 Scalar damper to scalar points only (CDAMP3)

2 UNDEF None

ELTYPE =23 Scalar damper to scalar points only with properties (CDAMP4)

2 UNDEF None

ELTYPE =24 Viscous damper (CVISC)

TCODE,7 =0 Real

2 UNDEF None

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TAUR RS Torque

5 TAUI RS Torque

TCODE,7 =2 Random Response

2 AS RS Axial Stress

5-110 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 TAU RS Torque

End TCODE,7

ELTYPE =25 Scalar mass (CMASS1)

2 UNDEF None

ELTYPE =26 Scalar mass with properties (CMASS2)

2 UNDEF None

ELTYPE =27 Scalar mass to scalar points only (CMASS3)

2 UNDEF None

ELTYPE =28 Scalar mass to scalar pts. only with properties (CMASS4)

2 UNDEF None

ELTYPE =29 Concentrated mass element - general form (CONM1)

2 UNDEF None

Word Name Type Description

ELTYPE =30 Concentrated mass element - rigid body form (CONM2)

2 UNDEF None

ELTYPE =31 Dummy plot element (PLOTEL)

2 UNDEF None

ELTYPE =32 Unused

2 UNDEF None

ELTYPE =33 Quadrilateral plate element (CQUAD4)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

DMAP Programmer's Guide 5-111


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 EA1 RS Theta ( Shear Angle ) at Z1

7 EMJRP1 RS Major Principal at Z1

8 EMNRP1 RS Minor Principal at Z1

9 EMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2 RS Normal in x at Z2

12 EY2 RS Normal in y at Z2

13 EXY2 RS Shear in xy at Z2

14 EA2 RS Theta (Shear Angle) at Z2

15 EMJRP2 RS Major Principal at Z2

16 EMNRP2 RS Minor Principal at Z2

17 EMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 EX2R RS Normal in x at Z2

11 EX2I RS Normal in x at Z2

12 EY2R RS Normal in y at Z2

13 EY2I RS Normal in y at Z2

14 EXY2R RS Shear in xy at Z2

15 EXY2I RS Shear in xy at Z2

5-112 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 EX2 RS Normal in x at Z2

8 EY2 RS Normal in y at Z2

9 EXY2 RS Shear in xy at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 SA1 RS Theta ( Shear Angle ) at Z1

7 SMJRP1 RS Major Principal at Z1

8 SMNRP1 RS Minor Principal at Z1

9 SMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2 RS Normal in x at Z2

12 SY2 RS Normal in y at Z2

13 TXY2 RS Shear in xy at Z2

14 SA2 RS Theta (Shear Angle) at Z2

15 SMJRP2 RS Major Principal at Z2

16 SMNRP2 RS Minor Principal at Z2

DMAP Programmer's Guide 5-113


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 SMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 SX2R RS Normal in x at Z2

11 SX2I RS Normal in x at Z2

12 SY2R RS Normal in y at Z2

13 SY2I RS Normal in y at Z2

14 TXY2R RS Shear in xy at Z2

15 TXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 SX2 RS Normal in x at Z2

8 SY2 RS Normal in y at Z2

9 TXY2 RS Shear in xy at Z2

End TCODE,7

End SCODE,6

5-114 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =34 Simple beam element (CBAR and see also ELTYPE=100)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 EX1A RS SA1

3 EX2A RS SA2

4 EX3A RS SA3

5 EX4A RS SA4

6 AE RS Axial

7 EBMAXA RS SA maximum

8 EBMINA RS SA minimum

9 MST RS Safety Margin in Tension*

10 EXIB RS SB1

11 EX2B RS SB2

12 EX3B RS SB3

13 EX4B RS SB4

14 EBMAXB RS SB maximum

15 EBMINB RS SB minimum

16 MSC RS Safety Margin in Comp*

TCODE,7 =1 Real / Imaginary

2 EX1AR RS SA1

3 EX2AR RS SA2

4 EX3AR RS SA3

5 EX4AR RS SA4

6 AER RS Axial

7 EX1AI RS SA1

8 EX2AI RS SA2

9 EX3AI RS SA3

DMAP Programmer's Guide 5-115


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 EX4AI RS SA4

11 AEI RS Axial

12 EX1BR RS SB1

13 EX2BR RS SB2

14 EX3BR RS SB3

15 EX4BR RS SB4

16 EX1BI RS SB1

17 EX2BI RS SB2

18 EX3BI RS SB3

19 EX4BI RS SB4

TCODE,7 =2 Random Response

2 EX1A RS SA1

3 EX2A RS SA2

4 EX3A RS SA3

5 EX4A RS SA4

6 AE RS Axial

7 EX1B RS SB1

8 EX2B RS SB2

9 EX3B RS SB3

10 EX4B RS SB4

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 SX1A RS SA1

3 SX2A RS SA2

4 SX3A RS SA3

5 SX4A RS SA4

5-116 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 AS RS Axial

7 BMAXA RS SA maximum

8 BMINA RS SA minimum

9 MST RS Safety Margin in Tension

10 SX1B RS SB1

11 SX2B RS SB2

12 SX3B RS SB3

13 SX4B RS SB4

14 BMAXB RS SB maximum

15 BMINB RS SB minimum

16 MSC RS Safety Margin in Comp*

TCODE,7 =1 Real / Imaginary

2 SX1AR RS SA1

3 SX2AR RS SA2

4 SX3AR RS SA3

5 SX4AR RS SA4

6 ASR RS Axial

7 SX1AI RS SA1

8 SX2AI RS SA2

9 SX3AI RS SA3

10 SX4AI RS SA4

11 ASI RS Axial

12 SX1BR RS SB1

13 SX2BR RS SB2

14 SX3BR RS SB3

15 SX4BR RS SB4

16 SX1BI RS SB1

DMAP Programmer's Guide 5-117


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 SX2BI RS SB2

18 SX3BI RS SB3

19 SX4BI RS SB4

TCODE,7 =2 Random Response

2 SX1A RS SA1

3 SX2A RS SA2

4 SX3A RS SA3

5 SX4A RS SA4

6 AS RS Axial

7 SX1B RS SB1

8 SX2B RS SB2

9 SX3B RS SB3

10 SX4B RS SB4

End TCODE,7

End SCODE,6

ELTYPE =35 Axisymmetric shell element (CCONEAX)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 HOPA RS Harmonic or point angle

3 FD1 RS Z1=Fibre Distance

4 EU1 RS Normal in u at z1

5 EV1 RS Normal in v at z1

6 ET1 RS Shear in uv at z1

7 A1 RS Theta (Shear Angle) at z1

8 EMJRP1 RS Major Principal at z1

9 EMNRP1 RS Minor Principal at z1

10 ETMAX1 RS Maximum Shear at z1

5-118 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 FD2 RS Z2=Fibre Distance

12 EU2 RS Normal in u at z2

13 EV2 RS Normal in v at z2

14 ET2 RS Shear in uv at z2

15 A2 RS Theta (Shear Angle) at z2

16 EMJRP2 RS Major Principal at z2

17 EMNRP2 RS Minor Principal at z2

18 ETMAX2 RS Maximum Shear at z2

TCODE,7 =1 Real / Imaginary

2 UNDEF None

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 HOPA RS Harmonic or point angle

3 FD1 RS Z1=Fibre Distance

4 SU1 RS Normal in u at z1

5 SV1 RS Normal in v at z1

6 ST1 RS Shear in uv at z1

7 A1 RS Theta (Shear Angle) at z1

8 SMJRP1 RS Major Principal at z1

9 SMNRP1 RS Minor Principal at z1

10 STMAX1 RS Maximum Shear at z1

11 FD2 RS Z2=Fibre Distance

12 SU2 RS Normal in u at z2

13 SV2 RS Normal in v at z2

DMAP Programmer's Guide 5-119


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

14 ST2 RS Shear in uv at z2

15 A2 RS Theta (Shear Angle) at z2

16 SMJRP2 RS Major Principal at z2

17 SMNRP2 RS Minor Principal at z2

18 STMAX2 RS Maximum Shear at z2

TCODE,7 =1 Real / Imaginary

2 UNDEF None

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

End SCODE,6

ELTYPE =36 Unused (Pre-V69 CTRIARG)

2 UNDEF None

ELTYPE =37 Unused (Pre-V69 CTRAPRG)

2 UNDEF None

ELTYPE =38 Gap element (CGAP)

2 FX RS

3 SFY RS

4 SFZ RS

5 U RS

6 V RS

7 W RS

8 SV RS

9 SW RS

ELTYPE =39 Tetra

SCODE,6 =0 Strain

TCODE,7 =0 Real

5-120 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EX RS Normal in x

7 ETXY RS Shear in xy

8 EP1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 EPR RS Mean pressure

13 EOCT RS Octahedral shear stress

14 EY RS Normal in y

15 ETYZ RS Shear in yz

16 EP2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 EZ RS Normal in z

21 ETZX RS Shear in zx

22 EP3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

DMAP Programmer's Guide 5-121


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

Words 5 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EX RS Normal in x

7 EY RS Normal in y

8 EZ RS Normal in z

9 ETXY RS Shear in xy

10 ETYZ RS Shear in yz

11 ETZX RS Shear in zx

5-122 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 5 through 11 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 TXY RS Shear in xy

8 P1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 PR RS Mean pressure

13 OCT RS Octahedral shear stress

14 SY RS Normal in y

15 TYZ RS Shear in yz

16 P2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 SZ RS Normal in z

21 TZX RS Shear in zx

22 P3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

DMAP Programmer's Guide 5-123


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

Words 5 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

5-124 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

Words 5 through 11 repeat 005 times

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =40 Rod type spring and damper (CBUSH1D)

TCODE,7 =0 Real

2 FE RS Element Force

3 UE RS Axial Displacement

4 VE RS Axial Velocity*

5 AS RS Axial Stress*

6 AE RS Axial Strain*

7 EP RS Plastic Strain*

8 FAIL I Failed Element Flag

TCODE,7 =1 Real / Imaginary

2 FER RS Element Force

3 UER RS Axial Displacement

4 ASR RS Axial Stress*

5 AER RS Axial Strain*

6 FEI RS Element Force

7 UEI RS Axial Displacement

8 ASI RS Axial Stress*

9 AEI RS Axial Strain*

DMAP Programmer's Guide 5-125


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =2 Random Response

2 FE RS Element Force

3 UE RS Axial Displacement

4 AS RS Axial Stress*

5 AE RS Axial Strain*

End TCODE,7

ELTYPE =41 Unused (Pre-V69 CHEXA1)

2 UNDEF None

ELTYPE =42 Unused (Pre-V69 CHEXA2)

2 UNDEF None

ELTYPE =43 Fluid element with 2 points (CFLUID2)

2 UNDEF None

ELTYPE =44 Fluid element with 3 points (CFLUID3)

2 UNDEF None

ELTYPE =45 Fluid element with 4 points (CFLUID4)

2 UNDEF None

ELTYPE =46 Cflmass

2 UNDEF None

ELTYPE =47 Fluid element with 2 points (CAXIF2)

TCODE,7 =0 or 2 Real or Random Response

2 RA RS Radial Axis

3 AA RS Axial Axis

4 TE RS Tangential Edge

5 CE RS Circumferential Edge

TCODE,7 =1 Real / Imaginary

2 RAR RS Radial Axis

3 AAR RS Axial Axis

5-126 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 TER RS Tangential Edge

5 CER RS Circumferential Edge

6 RAI RS Radial Axis

7 AAI RS Axial Axis

8 TEI RS Tangential Edge

9 CEI RS Circumferential Edge

End TCODE,7

ELTYPE =48 Fluid element with 3 points (CAXIF3)

TCODE,7 =0 or 2 Real or Random Response

2 RC RS Radial centroid

3 CC RS Circumferential centroid

4 AC RS Axial centroid

5 TE1 RS Tangential edge 1

6 CE1 RS Circumferential edge 1

7 TE2 RS Tangential edge 2

8 CE2 RS Circumferential edge 2

9 TE3 RS Tangential edge 3

10 CE3 RS Circumferential edge 3

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

DMAP Programmer's Guide 5-127


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 CE3R RS Circumferential edge 3

11 RCI RS Radial centroid

12 CCI RS Circumferential centroid

13 ACR RS Axial centroid

14 TE1I RS Tangential edge 1

15 CE1I RS Circumferential edge 1

16 TE2I RS Tangential edge 2

17 CE2I RS Circumferential edge 2

18 TE3I RS Tangential edge 3

19 CE3I RS Circumferential edge 3

End TCODE,7

ELTYPE =49 Fluid element with 4 points (CAXIF4)

TCODE,7 =0 or 2 Real or Random Response

2 RC RS Radial centroid

3 CC RS Circumferential centroid

4 AC RS Axial centroid

5 TE1 RS Tangential edge 1

6 CE1 RS Circumferential edge 1

7 TE2 RS Tangential edge 2

8 CE2 RS Circumferential edge 2

9 TE3 RS Tangential edge 3

10 CE3 RS Circumferential edge 3

11 TE4 RS Tangential edge 4

12 CE4 RS Circumferential edge 4

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

5-128 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

10 CE3R RS Circumferential edge 3

11 TE4R RS Tangential edge 4

12 CE4R RS Circumferential edge 4

13 RCI RS Radial centroid

14 CCI RS Circumferential centroid

15 ACR RS Axial centroid

16 TE1I RS Tangential edge 1

17 CE1I RS Circumferential edge 1

18 TE2I RS Tangential edge 2

19 CE2I RS Circumferential edge 2

20 TE3I RS Tangential edge 3

21 CE3I RS Circumferential edge 3

22 TE4I RS Tangential edge 4

23 CE4I RS Circumferential edge 4

End TCODE,7

Word Name Type Description

ELTYPE =50 Three-point slot element (CSLOT3)

TCODE,7 =0 or 2 Real or Random Response

2 RC RS Radial centroid

3 AC RS Axial centroid

DMAP Programmer's Guide 5-129


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 TE1 RS Tangential edge 1

5 TE2 RS Tangential edge 2

6 TE3 RS Tangential edge 3

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

7 RCI RS Radial centroid

8 ACI RS Axial centroid

9 TE1I RS Tangential edge 1

10 TE2I RS Tangential edge 2

11 TE3I RS Tangential edge 3

End TCODE,7

ELTYPE =51 Four-point slot element (CSLOT4)

TCODE,7 =0 or 2 Real or Random Response

2 RC RS Radial centroid

3 AC RS Axial centroid

4 TE1 RS Tangential edge 1

5 TE2 RS Tangential edge 2

6 TE3 RS Tangential edge 3

7 TE4 RS Tangential edge 4

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5-130 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

7 TE4R RS Tangential edge 4

8 RCI RS Radial centroid

9 ACI RS Axial centroid

10 TE1I RS Tangential edge 1

11 TE2I RS Tangential edge 2

12 TE3I RS Tangential edge 3

13 TE4I RS Tangential edge 4

End TCODE,7

ELTYPE =52 Heat transfer plot element for CHBDYG and CHBDYP

2 UNDEF None

ELTYPE =53 Axisymmetric triangular element (CTRIAX6)

TCODE,7 =0 Real

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 MAXP RS Maximum Principal

8 TMAX RS Maximum Shear

9 OCTS RS Octahedral

Words 2 through 9 repeat 004 times

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – real part

4 SXI RS Normal stress in X – imaginary part

DMAP Programmer's Guide 5-131


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 SYR RS Normal stress in Y – real part

6 SYI RS Normal stress in Y – imaginary part

7 SZR RS Normal stress in Z – real part

8 SZI RS Normal stress in Z – imaginary part

9 SPR RS In-plane shear stress – real part

10 SPI RS In-plane shear stress – imaginary part

Words 2 through 10 repeat 004 times

TCODE,7 =2 Random Response

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 MAXP RS Maximum Principal

8 TMAX RS Maximum Shear

9 OCTS RS Octahedral

Words 2 through 9 repeat 004 times

End TCODE,7

ELTYPE =54 Unused (Pre-V69 CTRIM6)

2 UNDEF None

ELTYPE =55 Three-point dummy element (CDUM3)

TCODE,7 =0 or 2 Real or Random Response

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

5-132 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =56 Four-point dummy element (CDUM4)

TCODE,7 =0 or 2 Real or Random Response

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =57 Five-point dummy element (CDUM5)

TCODE,7 =0 or 2 Real or Random Response

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =58 Six-point dummy element (CDUM6)

TCODE,7 =0 or 2 Real or Random Response

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =59 Seven-point dummy element (CDUM7)

TCODE,7 =0 or 2 Real or Random Response

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

DMAP Programmer's Guide 5-133


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

Word Name Type Description

ELTYPE =60 Two-dimensional crack tip element (CRAC2D or CDUM8)

2 X RS X coordinate

3 Y RS Y coordinate

4 SX RS Normal X

5 SY RS Normal Y

6 TXY RS Shear XY

7 KI RS Stress Intensity Factor KI

8 KII RS Stress Intensity Factor KII

9 S8 RS

10 S9 RS

ELTYPE =61 Three-dimensional crack tip element (CRAC3D or CDUM9)

2 X RS Normal X

3 Y RS Normal Y

4 Z RS Normal Z

5 TXY RS Shear XY

6 TYZ RS Shear YZ

7 TZX RS Shear ZX

8 KI RS Stress Intensity Factor KI

9 KII RS Stress Intensity Factor KII

10 KIII RS Stress Intensity Factor KIII

ELTYPE =62 Unused (Pre-V69 CQDMEM1)

2 UNDEF None

ELTYPE =63 Unused (Pre-V69 CQDMEM2)

2 UNDEF None

5-134 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =64 Curved quadrilateral shell element (CQUAD8)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 EMJRP1 RS Major Principal at Z1

10 EMNRP1 RS Minor Principal at Z1

11 ETMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 EX2 RS Normal in x at Z2

14 EY2 RS Normal in y at Z2

15 ETXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 EMRPJ2 RS Major Principal at Z2

18 EMNRP2 RS Minor Principal at Z2

19 ETMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

DMAP Programmer's Guide 5-135


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 EX2R RS Normal in x at Z2

13 EX2I RS Normal in x at Z2

14 EY2R RS Normal in y at Z2

15 EY2I RS Normal in y at Z2

16 ETXY2R RS Shear in xy at Z2

17 ETXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 EX2 RS Normal in x at Z2

10 EY2 RS Normal in y at Z2

11 ETXY2 RS Shear in xy at Z2

5-136 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 3 through 11 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 SMJRP1 RS Major Principal at Z1

10 SMNRP1 RS Minor Principal at Z1

11 TMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 SX2 RS Normal in x at Z2

14 SY2 RS Normal in y at Z2

15 TXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 SMJRP2 RS Major Principal at Z2

18 SMNRP2 RS Minor Principal at Z2

19 TMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

DMAP Programmer's Guide 5-137


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 GRID I Number active grids identification numbers or


grid identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 EX2 RS Normal in x at Z2

5-138 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 EY2 RS Normal in y at Z2

11 ETXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 005 times

End TCODE,7

End SCODE,6

ELTYPE =65 Unused (Pre-V69 CHEX8)

2 UNDEF None

ELTYPE =66 Unused (Pre-V69 CHEX20)

2 UNDEF None

ELTYPE =67 Hexa

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EX RS Normal in x

7 ETXY RS Shear in xy

8 EP1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 EPR RS Mean pressure

13 EOCT RS Octahedral shear stress

14 EY RS Normal in y

15 ETYZ RS Shear in yz

16 EP2 RS Second principal stress

DMAP Programmer's Guide 5-139


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 EZ RS Normal in z

21 ETZX RS Shear in zx

22 EP3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 009 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

5-140 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 5 through 17 repeat 009 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EX RS Normal in x

7 EY RS Normal in y

8 EZ RS Normal in z

9 ETXY RS Shear in xy

10 ETYZ RS Shear in yz

11 ETZX RS Shear in zx

Words 5 through 11 repeat 009 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 TXY RS Shear in xy

8 P1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 PR RS Mean pressure

DMAP Programmer's Guide 5-141


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 OCT RS Octahedral shear stress

14 SY RS Normal in y

15 TYZ RS Shear in yz

16 P2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 SZ RS Normal in z

21 TZX RS Shear in zx

22 P3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 009 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

5-142 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

Words 5 through 17 repeat 009 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

Words 5 through 11 repeat 009 times

End TCODE,7

End SCODE,6

ELTYPE =68 Penta

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EX RS Normal in x

DMAP Programmer's Guide 5-143


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 ETXY RS Shear in xy

8 EP1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 EPR RS Mean pressure

13 EOCT RS Octahedral shear stress

14 EY RS Normal in y

15 ETYZ RS Shear in yz

16 EP2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 EZ RS Normal in z

21 ETZX RS Shear in zx

22 EP3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 007 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

5-144 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

Words 5 through 17 repeat 007 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EX RS Normal in x

7 EY RS Normal in y

8 EZ RS Normal in z

9 ETXY RS Shear in xy

10 ETYZ RS Shear in yz

11 ETZX RS Shear in zx

Words 5 through 11 repeat 007 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 CID I Stress Coordinate System

DMAP Programmer's Guide 5-145


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 CTYPE CHAR4 Coordinate Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 TXY RS Shear in xy

8 P1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 PR RS Mean pressure

13 OCT RS Octahedral shear stress

14 SY RS Normal in y

15 TYZ RS Shear in yz

16 P2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 SZ RS Normal in z

21 TZX RS Shear in zx

22 P3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 repeat 007 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

5-146 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

Words 5 through 17 repeat 007 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

Words 5 through 11 repeat 007 times

DMAP Programmer's Guide 5-147


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

End SCODE,6

ELTYPE =69 Curved beam or pipe element (CBEND)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 EC RS Long. strain at Point C

5 ED RS Long. strain at Point D

6 EE RS Long. strain at Point E

7 EF RS Long. strain at Point F

8 EMAX RS Maximum strain

9 EMIN RS Minimum strain

10 MST RS Margin of Safety in Tension

11 MSC RS Margin of Safety in Compression

Words 2 through 11 repeat 002 times

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 ECR RS Long. strain at Point C

5 EDR RS Long. strain at Point D

6 EER RS Long. strain at Point E

7 EFR RS Long. strain at Point F

8 ECI RS Long. strain at Point C

9 EDI RS Long. strain at Point D

10 EEI RS Long. strain at Point E

5-148 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 EFI RS Long. strain at Point F

Words 2 through 11 repeat 002 times

TCODE,7 =2 Random Response

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 EC RS Long. strain at Point C

5 ED RS Long. strain at Point D

6 EE RS Long. strain at Point E

7 EF RS Long. strain at Point F

Words 2 through 7 repeat 002 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 SC RS Long. Stress at Point C

5 SD RS Long. Stress at Point D

6 SE RS Long. Stress at Point E

7 SF RS Long. Stress at Point F

8 SMAX RS Maximum stress

9 SMIN RS Minimum stress

10 MST RS Margin of Safety in Tension

11 MSC RS Margin of Safety in Compression

Words 2 through 11 repeat 002 times

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

DMAP Programmer's Guide 5-149


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 SCR RS Long. Stress at Point C

5 SDR RS Long. Stress at Point D

6 SER RS Long. Stress at Point E

7 SFR RS Long. Stress at Point F

8 SCI RS Long. Stress at Point C

9 SDI RS Long. Stress at Point D

10 SEI RS Long. Stress at Point E

11 SFI RS Long. Stress at Point F

Words 2 through 11 repeat 002 times

TCODE,7 =2 Random Response

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 SC RS Long. Stress at Point C

5 SD RS Long. Stress at Point D

6 SE RS Long. Stress at Point E

7 SF RS Long. Stress at Point F

Words 2 through 7 repeat 002 times

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =70 Triangular plate element (CTRIAR)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids ID or grid identification


number

5-150 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 EMJRP1 RS Major Principal at Z1

10 EMNRP1 RS Minor Principal at Z1

11 ETMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 EX2 RS Normal in x at Z2

14 EY2 RS Normal in y at Z2

15 ETXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 EMJRP2 RS Major Principal at Z2

18 EMNRP2 RS Minor Principal at Z2

19 ETMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 004 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

DMAP Programmer's Guide 5-151


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 ETXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 EX2R RS Normal in x at Z2

13 EX2I RS Normal in x at Z2

14 EY2R RS Normal in y at Z2

15 EY2I RS Normal in y at Z2

16 ETXY2R RS Shear in xy at Z2

17 ETXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 004 times

TCODE,7 =2 Random Response

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 EX2 RS Normal in x at Z2

10 EY2 RS Normal in y at Z2

11 ETXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 004 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

5-152 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 MJRP1 RS Major Principal at Z1

10 MNRP1 RS Minor Principal at Z1

11 TMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 SX2 RS Normal in x at Z2

14 SY2 RS Normal in y at Z2

15 TXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 MJRP2 RS Major Principal at Z2

18 MNRP2 RS Minor Principal at Z2

19 TMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 004 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

DMAP Programmer's Guide 5-153


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 004 times

TCODE,7 =2 Random Response

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 SX2 RS Normal in x at Z2

10 SY2 RS Normal in y at Z2

11 TXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 004 times

End TCODE,7

End SCODE,6

ELTYPE =71 Unused

5-154 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =72 AEROQ4

2 UNDEF None

ELTYPE =73 Unused (Pre-V69 CFTUBE)

2 UNDEF None

ELTYPE =74 Triangular shell element (CTRIA3)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 EA1 RS Theta ( Shear Angle ) at Z1

7 EMJRP1 RS Major Principal at Z1

8 EMNRP1 RS Minor Principal at Z1

9 EMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2 RS Normal in x at Z2

12 EY2 RS Normal in y at Z2

13 EXY2 RS Shear in xy at Z2

14 EA2 RS Theta (Shear Angle) at Z2

15 EMJRP2 RS Major Principal at Z2

16 EMNRP2 RS Minor Principal at Z2

17 EMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

DMAP Programmer's Guide 5-155


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 EX2R RS Normal in x at Z2

11 EX2I RS Normal in x at Z2

12 EY2R RS Normal in y at Z2

13 EY2I RS Normal in y at Z2

14 EXY2R RS Shear in xy at Z2

15 EXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 EX2 RS Normal in x at Z2

8 EY2 RS Normal in y at Z2

9 EXY2 RS Shear in xy at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5-156 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 TXY1 RS Shear in xy at Z1

6 SA1 RS Theta ( Shear Angle ) at Z1

7 SMJRP1 RS Major Principal at Z1

8 SMNRP1 RS Minor Principal at Z1

9 SMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2 RS Normal in x at Z2

12 SY2 RS Normal in y at Z2

13 TXY2 RS Shear in xy at Z2

14 SA2 RS Theta (Shear Angle) at Z2

15 SMJRP2 RS Major Principal at Z2

16 SMNRP2 RS Minor Principal at Z2

17 TMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 SX2R RS Normal in x at Z2

11 SX2I RS Normal in x at Z2

12 SY2R RS Normal in y at Z2

13 SY2I RS Normal in y at Z2

14 TXY2R RS Shear in xy at Z2

DMAP Programmer's Guide 5-157


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

15 TXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 SX2 RS Normal in x at Z2

8 SY2 RS Normal in y at Z2

9 TXY2 RS Shear in xy at Z2

End TCODE,7

End SCODE,6

ELTYPE =75 Curved triangular shell element (CTRIA6)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 EMJRP1 RS Major Principal at Z1

10 EMNRP1 RS Minor Principal at Z1

11 ETMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

5-158 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 EX2 RS Normal in x at Z2

14 EY2 RS Normal in y at Z2

15 ETXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 EMJRP2 RS Major Principal at Z2

18 EMNRP2 RS Minor Principal at Z2

19 ETMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 004 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 EX2R RS Normal in x at Z2

13 EX2I RS Normal in x at Z2

14 EY2R RS Normal in y at Z2

15 EY2I RS Normal in y at Z2

16 ETXY2R RS Shear in xy at Z2

17 ETXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 004 times

DMAP Programmer's Guide 5-159


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =2 Random Response

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 EX2 RS Normal in x at Z2

10 EY2 RS Normal in y at Z2

11 ETXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 004 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 SMJRP1 RS Major Principal at Z1

10 SMNRP1 RS Minor Principal at Z1

11 TMAX1 RS Maximum Shear at Z1

5-160 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

12 FD2 RS Fiber distance at Z2

13 SX2 RS Normal in x at Z2

14 SY2 RS Normal in y at Z2

15 TXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 SMJRP2 RS Major Principal at Z2

18 SMNRP2 RS Minor Principal at Z2

19 TMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 004 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

DMAP Programmer's Guide 5-161


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

Words 3 through 17 repeat 004 times

TCODE,7 =2 Random Response

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

9 SX2 RS Normal in x at Z2

10 SY2 RS Normal in y at Z2

11 TXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 004 times

End TCODE,7

End SCODE,6

ELTYPE =76 Acoustic velocity/pressures in six-sided solid element (CHEXA)

2 UNDEF None

ELTYPE =77 Acoustic velocity/pressures in five-sided solid element (CPENTA)

2 UNDEF None

ELTYPE =78 Acoustic velocity/pressures in four-sided solid element (CTETRA)

2 UNDEF None

ELTYPE =79 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =80 Undef

5-162 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =81 Undef

2 UNDEF None

ELTYPE =82 Quadrilateral plate element (CQUADR)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS

7 ETXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 EMJRP1 RS Major Principal at Z1

10 EMNRP1 RS Minor Principal at Z1

11 ETMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 EX2 RS Normal in x at Z2

14 EY2 RS Normal in y at Z2

15 ETXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 EMJRP2 RS Major Principal at Z2

18 EMNRP2 RS Minor Principal at Z2

19 ETMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 005 times

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-163


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 EX2R RS Normal in x at Z2

13 EX2I RS Normal in x at Z2

14 EY2R RS Normal in y at Z2

15 EY2I RS Normal in y at Z2

16 ETXY2R RS Shear in xy at Z2

17 ETXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

8 FD2 RS Fiber distance at Z2

5-164 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 EX2 RS Normal in x at Z2

10 EY2 RS Normal in y at Z2

11 ETXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TERM CHAR4 "CEN"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 A1 RS Theta (Shear Angle) at Z1

9 MJRP1 RS Major Principal at Z1

10 MNRP1 RS Minor Principal at Z1

11 TMAX1 RS Maximum Shear at Z1

12 FD2 RS Fiber distance at Z2

13 SX2 RS Normal in x at Z2

14 SY2 RS Normal in y at Z2

15 TXY2 RS Shear in xy at Z2

16 A2 RS Theta (Shear Angle) at Z2

17 MJRP2 RS Major Principal at Z2

18 MNRP2 RS Minor Principal at Z2

19 TMAX2 RS Maximum Shear at Z2

Words 3 through 19 repeat 005 times

DMAP Programmer's Guide 5-165


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

5-166 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 FD2 RS Fiber distance at Z2

9 SX2 RS Normal in x at Z2

10 SY2 RS Normal in y at Z2

11 TXY2 RS Shear in xy at Z2

Words 3 through 11 repeat 005 times

End TCODE,7

End SCODE,6

ELTYPE =83 Acoustic absorber element (CHACAB)

2 UNDEF None

ELTYPE =84 Acoustic barrier element (CHACBR)

2 UNDEF None

ELTYPE =85 TETRA - Nonlinear

2 CTYPE CHAR4

3 GRID I Grid / Gauss

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Effective plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

DMAP Programmer's Guide 5-167


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 005 times

ELTYPE =86 GAP - Nonlinear

2 CPX RS Comp x

3 SHY RS Shear in y

4 SHZ RS Shear in z

5 AU RS Axial in u

6 SHV RS Shear in v

7 SHW RS Shear in w

8 SLV RS Slip in v

9 SLP RS Slip in w

10 FORM1 CHAR4 No definition

11 FORM2 CHAR4 No definition

ELTYPE =87 Nonlinear tube element (CTUBE)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

7 LTS RS Linear torsional stress

ELTYPE =88 TRIA3 - Nonlinear (Same as QUAD4)

NUMWDE =13

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 SZ1 RS Stress in z at Z1

5-168 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 EZ1 RS Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

NUMWDE =25

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 UNDEF None Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 UNDEF None Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

14 FD2 RS Z2 = Fiber distance

15 SX2 RS Stress in x at Z2

16 SY2 RS Stress in y at Z2

17 UNDEF None Stress in z at Z2

18 TXY2 RS Shear stress in xy at Z2

19 ES RS Equivalent stress at Z2

DMAP Programmer's Guide 5-169


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

20 EPS2 RS Effective plastic/inelastic strain at Z2

21 ECS2 RS Effective creep strain at Z2

22 EX2 RS Strain in x at Z2

23 EY2 RS Strain in y at Z2

24 UNDEF None Strain in z at Z2

25 ETXY2 RS Shear strain in xy at Z2

End NUMWDE

ELTYPE =89 Nonlinear rod element (CROD)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

7 LTS RS Linear torsional stress

Word Name Type Description

ELTYPE =90 QUAD4 - Nonlinear

NUMWDE =13

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 SZ1 RS Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

5-170 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 EY1 RS Strain in y at Z1

12 EZ1 RS Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

NUMWDE =25

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 UNDEF None Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 UNDEF None Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

14 FD2 RS Z2 = Fiber distance

15 SX2 RS Stress in x at Z2

16 SY2 RS Stress in y at Z2

17 UNDEF None Stress in z at Z2

18 TXY2 RS Shear stress in xy at Z2

19 ES RS Equivalent stress at Z2

20 EPS2 RS Effective plastic/inelastic strain at Z2

21 ECS2 RS Effective creep strain at Z2

22 EX2 RS Strain in x at Z2

23 EY2 RS Strain in y at Z2

24 UNDEF None Strain in z at Z2

DMAP Programmer's Guide 5-171


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

25 ETXY2 RS Shear strain in xy at Z2

End NUMWDE

ELTYPE =91 Nonlinear five-sided solid element (CPENTA)

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Extermal Grid identification number; 0 = Center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Equivalent plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 007 times

ELTYPE =92 Nonlinear rod element connection and property (CONROD)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

5-172 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 LTS RS Linear torsional stress

ELTYPE =93 Nonlinear six-sided solid element (CHEXA)

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Extermal Grid identification number; 0 = Center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Equivalent plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 009 times

ELTYPE =94 Nonlinear beam element (CBEAM)

2 GRIDA I External Grid point Id at A

3 LOCCA CHAR4 'C' (BCD Value) at A

4 NSXCA RS Long. Stress at point C at A

5 NSECA RS Equivalent Stress at A

6 TECA RS Total Strain at A

7 EPECA RS Effective Plastic strain at A

DMAP Programmer's Guide 5-173


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 ECECA RS Effective Creep strain at A

9 LOCDA CHAR4 'D' (BCD Value) at A

10 NSXDA RS Long. Stress at point D at A

11 NSEDA RS Equivalent Stress at A

12 TEDA RS Total Strain at A

13 EPEDA RS Effective Plastic strain at A

14 ECEDA RS Effective Creep strain at A

15 LOCEA CHAR4 'E' (BCD Value) at A

16 NSXEA RS Long. Stress at point E at A

17 NSEEA RS Equivalent Stress at A

18 TEEA RS Total Strain at A

19 EPEEA RS Effective Plastic strain at A

20 ECEEA RS Effective Creep strain at A

21 LOCFA CHAR4 'F' (BCD Value) at A

22 NSXFA RS Long. Stress at point F at A

23 NSEFA RS Equivalent Stress at A

24 TEFA RS Total Strain at A

25 EPEFA RS Effective Plastic strain at A

26 ECEFA RS Effective Creep strain at A

27 GRIDB I External Grid point identification number at B

28 LOCCB CHAR4 'C' (BCD Value) at B

29 NSXCB RS Long. Stress at point C at B

30 NSECB RS Equivalent Stress at B

31 TECB RS Total Strain at B

32 EPECB RS Effective Plastic strain at B

33 ECECB RS Effective Creep strain at B

34 LOCDB CHAR4 'D' (BCD Value) at B

5-174 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

35 NSXDB RS Long. Stress at point D at B

36 NSEDB RS Equivalent Stress at B

37 TEDB RS Total Strain at B

38 EPEDB RS Effective Plastic strain at B

39 ECEDB RS Effective Creep strain at B

40 LOCEB CHAR4 'E' (BCD Value) at B

41 NSXEB RS Long. Stress at point E at B

42 NSEEB RS Equivalent Stress at B

43 TEEB RS Total Strain at B

44 EPEEB RS Effective Plastic strain at B

45 ECEEB RS Effective Creep strain at B

46 LOCFB CHAR4 'F' (BCD Value) at B

47 NSXFB RS Long. Stress at point F at B

48 NSEFB RS Equivalent Stress at B

49 TEFB RS Total Strain at B

50 EPEFB RS Effective Plastic strain at B

51 ECEFB RS Effective Creep strain at B

ELTYPE =95 QUAD4 composite

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

DMAP Programmer's Guide 5-175


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

5-176 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major principal

10 MNRP1 RS Minor principal

11 TMAX1 RS von Mises or maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

DMAP Programmer's Guide 5-177


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

End SCODE,6

ELTYPE =96 QUAD8 composite (Same as QUAD4 composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

5-178 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

DMAP Programmer's Guide 5-179


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

End TCODE,7

End SCODE,6

ELTYPE =97 TRIA3 composite (Same as QUAD4 composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

5-180 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

DMAP Programmer's Guide 5-181


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

End TCODE,7

End SCODE,6

ELTYPE =98 TRIA6 composite (Same as QUAD4 composite)

5-182 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 EX1 RS Normal-1

DMAP Programmer's Guide 5-183


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

5-184 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

End TCODE,7

End SCODE,6

ELTYPE =99 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =100 Simple beam element w/stations (CBAR with CBARAO or


PLOAD1)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 SD RS % along bar for output

3 EXC RS Strain at point c

4 EXD RS Strain at point d

5 EXE RS Strain at point e

6 EXF RS Strain at point f

7 AE RS Axial strain

8 EMAX RS Maximum strain

9 EMIN RS Minimum strain

DMAP Programmer's Guide 5-185


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 MS RS Margin of Safety

TCODE,7 =1 Real / Imaginary

2 SD RS % along bar for output

3 EXCR RS Strain at point c

4 EXDR RS Strain at point d

5 EXER RS Strain at point e

6 EXFR RS Strain at point f

7 AER RS Axial strain

8 EMAXR RS Maximum strain

9 EMINR RS Minimum strain

10 EXCI RS Strain at point c

11 EXDI RS Strain at point d

12 EXEI RS Strain at point e

13 EXFI RS Strain at point f

14 AEI RS Axial strain

15 EMAXI RS Maximum strain

16 EMINI RS Minimum strain

TCODE,7 =2 Random Response

2 SD RS % along bar for output

3 EXC RS Strain at point c

4 EXD RS Strain at point d

5 EXE RS Strain at point e

6 EXF RS Strain at point f

7 AE RS Axial strain

8 EMAX RS Maximum strain

9 EMIN RS Minimum strain

End TCODE,7

5-186 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 SD RS % along bar for output

3 SXC RS Stress at point c

4 SXD RS Stress at point d

5 SXE RS Stress at point e

6 SXF RS Stress at point f

7 AS RS Axial stress

8 SMAX RS Maximum stress

9 SMIN RS Minimum stress

10 MS RS Margin of Safety

TCODE,7 =1 Real / Imaginary

2 SD RS % along bar for output

3 SXCR RS Stress at point c

4 SXDR RS Stress at point d

5 SXER RS Stress at point e

6 SXFR RS Stress at point f

7 ASR RS Axial stress

8 SMAXR RS Maximum stress

9 SMINR RS Minimum stress

10 SXCI RS Stress at point c

11 SXDI RS Stress at point d

12 SXEI RS Stress at point e

13 SXFI RS Stress at point f

14 ASI RS Axial stress

15 SMAXI RS Maximum stress

16 SMINI RS Minimum stress

DMAP Programmer's Guide 5-187


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =2 Random Response

2 SD RS % along bar for output

3 SXC RS Stress at point c

4 SXD RS Stress at point d

5 SXE RS Stress at point e

6 SXF RS Stress at point f

7 AS RS Axial stress

8 SMAX RS Maximum stress

9 SMIN RS Minimum stress

End TCODE,7

End SCODE,6

ELTYPE =101 Acoustic absorber element with freq. dependence (CAABSF)

TCODE,7 =0 or 2 Real or Random Response

2 IMPED RS Impedance

3 ABSORB RS Absorption Coefficient

TCODE,7 =1 Real / Imaginary

2 IMPEDR RS Impedance

3 IMPEDI RS Impedance

4 ABSORB RS Absorption Coefficient

End TCODE,7

ELTYPE =102 Generalized spring and damper element (CBUSH)

TCODE,7 =0 or 2 Real or Random Response

2 TX RS Translation x

3 TY RS Translation y

4 TZ RS Translation z

5 RX RS Rotation x

6 RY RS Rotation y

5-188 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 RZ RS Rotation z

TCODE,7 =1 Real / Imaginary

2 TXR RS Translation x R

3 TYR RS Translation y R

4 TZR RS Translation z R

5 RXR RS Rotation x R

6 RYR RS Rotation y R

7 RZR RS Rotation z R

8 TXI RS Translation x I

9 TYI RS Translation y I

10 TZI RS Translation z I

11 RXI RS Rotation x I

12 RYI RS Rotation y I

13 RZI RS Rotation z I

End TCODE,7

ELTYPE =103 Quadrilateral shell element (QUADP)

2 UNDEF None

ELTYPE =104 Triangular shell p-element (TRIAP)

2 UNDEF None

ELTYPE =105 Beam p-element (BEAMP)

2 UNDEF None

ELTYPE =106 Scalar damper with material property (CDAMP5)

2 UNDEF None

ELTYPE =107 Heat transfer boundary condition element - (CHBDYE)

2 UNDEF None

ELTYPE =108 Heat transfer boundary condition element (CHBDYG)

2 UNDEF None

DMAP Programmer's Guide 5-189


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =109 Heat transfer boundary condition element (CHBDYP)

2 UNDEF None

Word Name Type Description

ELTYPE =110 CONV

2 UNDEF None

ELTYPE =111 CONVM

2 UNDEF None

ELTYPE =115 RADBC

2 UNDEF None

ELTYPE =112 QBDY3

2 UNDEF None

ELTYPE =113 QVECT

2 UNDEF None

ELTYPE =114 QVOL

2 UNDEF None

ELTYPE =115 Radbc

2 UNDEF None

ELTYPE =116 Slideline contact (SLIF1D)

2 UNDEF None

Word Name Type Description

ELTYPE =127 CQUAD

ELTYPE =128 CQUADX

ELTYPE =129 RELUC

Word Name Type Description

ELTYPE =130 RES

5-190 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =131 TETRAE

ELTYPE =132 CTRIA

ELTYPE =133 CTRIAX

ELTYPE =134 LINEOB

ELTYPE =135 LINXOB

ELTYPE =136 QUADOB

ELTYPE =137 TRIAOB

ELTYPE =138 LINEX

ELTYPE =139 Hyperelastic QUAD4FD

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 004 times

Word Name Type Description

ELTYPE =140 Hyperelastic 8-noded hexahedron element linear format


(HEXAFD)

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

DMAP Programmer's Guide 5-191


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 008 times

ELTYPE =141 Six-sided solid p-element (HEXAP)

2 UNDEF None

ELTYPE =142 Five-sided solid p-element (PENTAP)

2 UNDEF None

ELTYPE =143 Four-sided solid p-element (TETRAP)

2 UNDEF None

ELTYPE =144 Quadrilateral plate element for corner stresses (CQUAD4)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 TERM CHAR4

5-192 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 GRID I

4 FD1 RS Fiber distance at z1

5 EX1 RS Normal in x at z1

6 EY1 RS Normal in y at z1

7 ETXY1 RS Shear in xy at z1

8 A1 RS Shear angle at z1

9 EMJRP1 RS Major Principal at z1

10 EMNRP1 RS Minor Principal at z1

11 ETMAX1 RS von Mises or max shear at z1

12 FD2 RS Fiber distance at z2

13 EX2 RS Normal in x at z2

14 EY2 RS Normal in y at z2

15 ETXY2 RS Shear in xy at z2

16 A2 RS Shear angle at z2

17 EMJRP2 RS Major Principal at z2

18 EMNRP2 RS Minor Principal at z2

19 ETMRP2 RS von Mises or max shear at z2

Words 3 through 19 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 EX1R RS Normal in x at z1

6 EX1I RS Normal in x at z1

7 EY1R RS Normal in y at z1

8 EY1I RS Normal in y at z1

9 ETXY1R RS Shear in xy at z1

DMAP Programmer's Guide 5-193


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 ETXY1I RS Shear in xy at z1

11 FD2 RS Fiber distance at z2

12 EX2R RS Normal in x at z2

13 EX2I RS Normal in x at z2

14 EY2R RS Normal in y at z2

15 EY2I RS Normal in y at z2

16 ETXY2R RS Shear in xy at z1

17 ETXY2I RS Shear in xy at z1

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 EX1 RS Normal in x at z1

6 EY1 RS Normal in y at z1

7 ETXY1 RS Shear in xy at z1

8 FD2 RS Fiber distance at z2

9 EX2 RS Normal in x at z2

10 EY2 RS Normal in y at z2

11 ETXY2 RS Shear in xy at z1

Words 3 through 11 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5-194 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 SX1 RS Normal in x at z1

6 SY1 RS Normal in y at z1

7 TXY1 RS Shear in xy at z1

8 A1 RS Shear angle at z1

9 MJRP1 RS Major Principal at z1

10 MNRP1 RS Minor Principal at z1

11 TMAX1 RS von Mises or max shear at z1

12 FD2 RS Fiber distance at z2

13 SX2 RS Normal in x at z2

14 SY2 RS Normal in y at z2

15 TXY2 RS Shear in xy at z2

16 A2 RS Shear angle at z2

17 MJRP2 RS Major Principal at z2

18 MNRP2 RS Minor Principal at z2

19 TMAX2 RS von Mises or max shear at z2

Words 3 through 19 repeat 005 times

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 SX1R RS Normal in x at z1

6 SX1I RS Normal in x at z1

7 SY1R RS Normal in y at z1

8 SY1I RS Normal in y at z1

9 TXY1R RS Shear in xy at z1

10 TXY1I RS Shear in xy at z1

11 FD2 RS Fiber distance at z2

DMAP Programmer's Guide 5-195


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

12 SX2R RS Normal in x at z2

13 SX2I RS Normal in x at z2

14 SY2R RS Normal in y at z2

15 SY2I RS Normal in y at z2

16 TXY2R RS Shear in xy at z2

17 TXY2I RS Shear in xy at z2

Words 3 through 17 repeat 005 times

TCODE,7 =2 Random Response

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 SX1 RS Normal in x at z1

6 SY1 RS Normal in y at z1

7 TXY1 RS Shear in xy at z1

8 FD2 RS Fiber distance at z2

9 SX2 RS Normal in x at z2

10 SY2 RS Normal in y at z2

11 TXY2 RS Shear in xy at z2

Words 3 through 11 repeat 005 times

End TCODE,7

End SCODE,6

ELTYPE =145 Six-sided solid display element (VUHEXA)

2 PARENTID I

NUMWDE =98 Len=2+ 12 * No. of points

3 GRIDID I

4 XNORM RS

5 YNORM RS

5-196 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 008 times

NUMWDE =58 Len= 2 + 7 * No. of points

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 008 times

NUMWDE =106 Len= 2 + 13 * No. of points

3 GRIDID I

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

9 TZXR RS

DMAP Programmer's Guide 5-197


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 008 times

End NUMWDE

ELTYPE =146 Five-sided solid display element (VUPENTA)

2 PARENTID I

NUMWDE =74

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 006 times

NUMWDE =44

3 GRIDID I

4 XNORM RS

5-198 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 006 times

NUMWDE =80 2 + 6*13

3 GRIDID I

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

9 TZXR RS

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 006 times

End NUMWDE

ELTYPE =147 Four-sided solid display element (VUTETRA)

2 PARENTID I

NUMWDE =50

3 GRIDID I

4 XNORM RS

DMAP Programmer's Guide 5-199


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 004 times

NUMWDE =30

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 004 times

NUMWDE =54 2 + 4*13

3 GRIDID I

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

5-200 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 TZXR RS

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 004 times

End NUMWDE

ELTYPE =148 HEXAM

2 UNDEF None

ELTYPE =149 PENTAM

2 UNDEF None

Word Name Type Description

ELTYPE =150 TETRAM

2 UNDEF None

ELTYPE =151 QUADM

2 UNDEF None

ELTYPE =152 TRIAM

2 UNDEF None

ELTYPE =153 QUADXM

2 UNDEF None

ELTYPE =154 TRIAXM

2 UNDEF None

ELTYPE =155 QUADPW

2 UNDEF None

DMAP Programmer's Guide 5-201


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =156 TRIAPW

2 UNDEF None

ELTYPE =157 LINEPW

2 UNDEF None

ELTYPE =158 QUADOBM

2 UNDEF None

ELTYPE =159 TRIAOBM

2 UNDEF None

Word Name Type Description

ELTYPE =160 Hyperelastic 5-sided 6-noded solid element (PENTAFD) Linear


form

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

5-202 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 006 times

ELTYPE =161 Linear form for hyperelastic 4 node TETRA

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

DMAP Programmer's Guide 5-203


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

21 CY RS

22 CZ RS

Words 3 through 22 repeat 001 times

ELTYPE =162 Linear form for hyperelastic 3 node TRIA (strain)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 001 times

ELTYPE =163 Linear form for hyperelastic 20 node HEXAFD

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

5-204 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 027 times

ELTYPE =164 Hyperelastic quadrilateral 9-noded element (QUADFD) Linear

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 009 times

ELTYPE =165 Hyperelastic 5-sided 15-noded solid element (PENTAFD) Linear

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

DMAP Programmer's Guide 5-205


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 021 times

ELTYPE =166 Linear form for hyperelastic 10 node TETRA

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

5-206 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 005 times

ELTYPE =167 Linear form for hyperelastic 6 node TRIA (plane strain)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 003 times

ELTYPE =168 Linear form for hyperelastic 3 node TRIA (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

DMAP Programmer's Guide 5-207


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 001 times

ELTYPE =169 Linear form for hyperelastic 6 node TRIA (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 003 times

Word Name Type Description

ELTYPE =170 Linear form for hyperelastic 4 node QUAD (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

5-208 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 3 through 9 repeat 004 times

ELTYPE =171 Linear form for hyperelastic 9 node QUAD (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 009 times

Word Name Type Description

ELTYPE =189 Quadrilateral plate view element (VUQUAD)

SCODE,6 =0 Strain

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =0 Real

7 VUID I VU grid identification number for this corner

8 NONE(2) I Nothing

10 MSX RS Membrane stain x

11 MSY RS Membrane strain y

12 MXY RS Membrane strain xy

13 NONE(3) RS Nothing

DMAP Programmer's Guide 5-209


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

16 BCX RS Bending curvature x

17 BCY RS Bending curvature y

18 BCXY RS Bending curvature xy

19 TYZ RS Shear yz

20 TZX RS Shear zx

21 UNDEF(3 ) None

Words 7 through 23 repeat 004 times

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number this corner

8 UNDEF(2 ) None

10 MSXR RS Membrane strain x RM

11 MSYR RS Membrane strain y RM

12 MXYR RS Membrane strain xy RM

13 UNDEF(3 ) None

16 BCXR RS Bending curvature x RM

17 BCYR RS Bending curvature y RM

18 BCXYR RS Bending curvature xy RM

19 TYZR RS Shear yz RM

20 TZXR RS Shear zx RM

21 UNDEF None

22 MSXI RS Membrane strain x IP

23 MSYI RS Membrane strain y IP

24 MXYI RS Membrane strain xy IP

25 UNDEF(3 ) None

28 BCXI RS Bending curvature x IP

29 BCYI RS Bending curvature y IP

30 BCXYI RS Bending curvature xy IP

5-210 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

31 TYZI RS Shear yz IP

32 TZXI RS Shear zx IP

33 UNDEF None

Words 7 through 33 repeat 004 times

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

SCODE,6 =01 Stress

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =0 Real

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1 RS Normal x at Z1

11 NY1 RS Normal y at Z1

12 TXY1 RS Shear xy at Z1

13 ANGLE1 RS Shear Angle at Z1 or n/a

14 MJRP1 RS Major principal at Z1 or n/a

15 MNRP1 RS Minor principal at Z1 or n/a

16 MAXSV1 RS vonMises/Max.Shear at Z1 or n/a

17 NX2 RS Normal x at Z2

18 NY2 RS Normal y at Z2

19 TXY2 RS Shear xy at Z2

DMAP Programmer's Guide 5-211


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

20 ANGLE2 RS Shear Angle at Z2 or n/a

21 MJRP2 RS Major principal at Z2 or n/a

22 MNRP2 RS Minor principal at Z2 or n/a

23 MAXSV2 RS vonMises/Max.Shear at Z2 or n/a

Words 7 through 23 repeat 004 times

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1R RS Normal x rm at Z1

11 NX1I RS Normal x ip at Z1

12 NY1R RS Normal y rm at Z1

13 NY1I RS Normal y ip at Z1

14 TXY1R RS Shear xy rm at Z1

15 TXY1I RS Shear xy ip at Z1

16 NZ1R RS Normal z rm at Z1 or n/a

17 NZ1I RS Normal z ip at Z1 or n/a

18 TYZ1R RS Shear yz rm at Z1 or n/a

19 TYZ1I RS Shear yz ip at Z1 or n/a

20 TZX1R RS Shear zx rm at Z1 or n/a

21 TZX1I RS Shear zx ip at Z1 or n/a

22 NX2R RS Normal x rm at Z2

23 NX2I RS Normal x ip at Z2

24 NY2R RS Normal y rm at Z2

25 NY2I RS Normal y ip at Z2

26 TXY2R RS Shear xy rm at Z2

27 TXY2I RS Shear xy ip at Z2

5-212 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

28 NZ1R RS Normal z rm at Z1 or n/a

29 NZ1I RS Normal z ip at Z1 or n/a

30 TYZ1R RS Shear yz rm at Z1 or n/a

31 TYZ1I RS Shear yz ip at Z1 or n/a

32 TZX1R RS Shear zx rm at Z1 or n/a

33 TZX1I RS Shear zx ip at Z1 or n/a

Words 7 through 33 repeat 004 times

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =190 Triangular shell view element (VUTRIA)

SCODE,6 =0 Strain

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =0 Real

7 VUID I VU grid identification number for this corner

8 NONE(2) I Nothing

10 MSX RS Membrane stain x

11 MSY RS Membrane strain y

12 MXY RS Membrane strain xy

13 NONE(3) RS Nothing

DMAP Programmer's Guide 5-213


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

16 BCX RS bending curvature x

17 BCY RS Bending curvature y

18 BCXY RS Bending curvature xy

19 TYZ RS Shear yz

20 TZX RS Shear zx

21 NONE(3) RS Nothing

Words 7 through 23 repeat 003 times

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number this corner

8 UNDEF(2 ) None

10 MSXR RS Membrane strain x RM

11 MSYR RS Membrane strain y RM

12 MXYR RS Membrane strain xy RM

13 UNDEF(3 ) None

16 BCXR RS Bending curvature x RM

17 BCYR RS Bending curvature y RM

18 BCXYR RS Bending curvature xy RM

19 TYZR RS Shear yz RM

20 TZXR RS Shear zx RM

21 UNDEF None

22 MSXI RS Membrane strain x IP

23 MSYI RS Membrane strain y IP

24 MXYI RS Membrane strain xy IP

25 UNDEF(3 ) None

28 BCXI RS Bending curvature x IP

29 BCYI RS Bending curvature y IP

30 BCXYI RS Bending curvature xy IP

5-214 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

31 TYZI RS Shear yz IP

32 TZXI RS Shear zx IP

33 UNDEF None

Words 7 through 33 repeat 003 times

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

SCODE,6 =01 Stress

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =0 Real

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1 RS Normal x at Z1

11 NY1 RS Normal y at Z1

12 TXY1 RS Shear xy at Z1

13 ANGLE1 RS Shear Angle at Z1 or n/a

14 MJRP1 RS Major principal at Z1 or n/a

15 MNRP1 RS Minor principal at Z1 or n/a

16 MAXSV1 RS vonMises/Max.Shear at Z1 or n/a

17 NX2 RS Normal x at Z2

18 NY2 RS Normal y at Z2

19 TXY2 RS Shear xy at Z2

DMAP Programmer's Guide 5-215


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

20 ANGLE2 RS Shear Angle at Z2 or n/a

21 MJRP2 RS Major principal at Z2 or n/a

22 MNRP2 RS Minor principal at Z2 or n/a

23 MAXSV2 RS vonMises/Max.Shear at Z2 or n/a

Words 7 through 23 repeat 003 times

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1R RS Normal x rm at Z1

11 NX1I RS Normal x ip at Z1

12 NY1R RS Normal y rm at Z1

13 NY1I RS Normal y ip at Z1

14 TXY1R RS Shear xy rm at Z1

15 TXY1I RS Shear xy ip at Z1

16 NZ1R RS Normal z rm at Z1 or n/a

17 NZ1I RS Normal z ip at Z1 or n/a

18 TYZ1R RS Shear yz rm at Z1 or n/a

19 TYZ1I RS Shear yz ip at Z1 or n/a

20 TZX1R RS Shear zx rm at Z1 or n/a

21 TZX1I RS Shear zx ip at Z1 or n/a

22 NX2R RS Normal x rm at Z2

23 NX2I RS Normal x ip at Z2

24 NY2R RS Normal y rm at Z2

25 NY2I RS Normal y ip at Z2

26 TXY2R RS Shear xy rm at Z2

27 TXY2I RS Shear xy ip at Z2

5-216 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

28 NZ1R RS Normal z rm at Z1 or n/a

29 NZ1I RS Normal z ip at Z1 or n/a

30 TYZ1R RS Shear yz rm at Z1 or n/a

31 TYZ1I RS Shear yz ip at Z1 or n/a

32 TZX1R RS Shear zx rm at Z1 or n/a

33 TZX1I RS Shear zx ip at Z1 or n/a

Words 7 through 33 repeat 003 times

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

End SCODE,6

ELTYPE =191 Beam view element (VUBEAM)

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

TCODE,7 =0 Real

5 VUGRID I VU grid ID for output grid

6 POSIT RS x/L position of VU grid identification number

7 POS(3) RS Y, Z, W coordinate of output point

10 NX RS Normal x

11 TXY RS Shear xy

12 TZX RS Shear zx

Words 7 through 12 repeat 4 times

13 MAXLONG RS Max longitudinal

14 MINLONG RS Min longitudinal

Words 5 through 14 repeat 2 times

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-217


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 VUGRID I VU grid ID for output grid

6 POSIT RS x/L position of VU grid identification number

7 POS(3) RS Y, Z, W coordinate of output point

10 NXR RS Normal x RM

11 NXI RS Normal x IP

12 TXYR RS Shear xy RM

13 TXYI RS Shear xy IP

14 TZXR RS Shear zx RM

15 TZXI RS Shear zx IP

Words 7 through 15 repeat 4 times

Words 5 through 15 repeat 2 times

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

ELTYPE =192 CVINT

2 UNDEF None

ELTYPE =193 QUADFR

2 UNDEF None

ELTYPE =194 TRIAFR

2 UNDEF None

ELTYPE =195 LINEFR

2 UNDEF None

ELTYPE =196 LINXFR

2 UNDEF None

ELTYPE =197 GMINTS

2 UNDEF None

ELTYPE =198 CNVPEL

5-218 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =199 VUHBDY

2 UNDEF None

Word Name Type Description

ELTYPE =200 CWELD

2 UNDEF None

ELTYPE =201 Hyperelastic quadrilateral 4-noded, nonlinear format (QUAD4FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =202 Hyperelastic hexahedron 8-noded, nonlinear format (HEXA8FD)

2 TYPE CHAR4 Grid or Gaus

3 ID I

4 SX RS

5 SY RS

6 SZ RS

DMAP Programmer's Guide 5-219


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 008 times

ELTYPE =203 Slideline contact (SLIF1D)

2 REGIONID I Contact region identification number

3 MGRID1 I Master grid 1

4 MGRID2 I Master grid 2

5 SCOORD RS Surface coordinate

6 F RS Normal force

7 S RS Shear force

8 SIGMA RS Normal stress

9 TAU RS Shear stress

10 NGAP RS Normal gap

11 SLIP RS Slip

12 SLIPRAT RS Slip ratio

13 SLIPCODE(2) CHAR4 Slip code

ELTYPE =204 Hyperelastic pentahedron 6-noded, nonlinear format


(PENTA6FD)

5-220 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 TYPE CHAR4 Grid or Gaus

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 006 times

ELTYPE =205 Hyperelastic tetrahedron 4-noded, nonlinear format (TETRA4FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

DMAP Programmer's Guide 5-221


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 001 times

ELTYPE =206 Hyperelastic triangular 3-noded, nonlinear format (TRIA3FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 001 times

ELTYPE =207 Hyperelastic hexahedron 20-noded, nonlinear format (HEXAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

5-222 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 027 times

ELTYPE =208 Hyperelastic quadrilateral 8-noded, nonlinear format (QUADFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 009 times

DMAP Programmer's Guide 5-223


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =209 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 021 times

Word Name Type Description

ELTYPE =210 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

5-224 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 005 times

ELTYPE =211 Hyperelastic triangular 6-noded, nonlinear format (TRIAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

DMAP Programmer's Guide 5-225


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =212 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 001 times

ELTYPE =213 Hyperelastic axi. triangular 6-noded nonlinear format (TRIAXFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

5-226 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =214 Hyperelastic axi. quadrilateral 4-noded nonlinear


format(QUADX4FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =215 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

DMAP Programmer's Guide 5-227


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 009 times

ELTYPE =216 Hyperelastic tetrahedron 4-noded nonlinear format (TETRA4FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 004 times

ELTYPE =217 Hyperelastic triangular 3-noded nonlinear format (TRIA3FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5-228 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =218 Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

DMAP Programmer's Guide 5-229


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

Words 3 through 17 repeat 008 times

ELTYPE =219 Hyperelastic quadrilateral 8-noded nonlinear format (QUADFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

Word Name Type Description

ELTYPE =220 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

5-230 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 006 times

ELTYPE =221 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 004 times

DMAP Programmer's Guide 5-231


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =222 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =223 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

5-232 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =224 Nonlinear ELAS1

2 F RS Force

3 S RS Stress

ELTYPE =225 Nonlinear ELAS3

2 F RS Force

3 S RS Stress

ELTYPE =226 Nonlinear BUSH

2 FX RS Force X

3 FY RS Force Y

4 FZ RS Force Z

5 STX RS Stress Translational X

6 STY RS Stress Translational Y

7 STZ RS Stress Translational Z

8 ETX RS Strain Rotational X

9 ETY RS Strain Rotational Y

10 ETZ RS Strain Rotational Z

11 MX RS Moment X

12 MY RS Moment Y

13 MZ RS Moment Z

14 SRX RS Stress Rotational X

15 SRY RS Stress Rotational Y

16 SRZ RS Stress Rotational Z

17 ERX RS Strain Rotational X

18 ERY RS Strain Rotational Y

DMAP Programmer's Guide 5-233


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

19 ERZ RS Strain Rotational Z

ELTYPE =227 Triangular shell element (CTRIAR)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 EA1 RS Theta ( Shear Angle ) at Z1

7 EMJRP1 RS Major Principal at Z1

8 EMNRP1 RS Minor Principal at Z1

9 EMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2 RS Normal in x at Z2

12 EY2 RS Normal in y at Z2

13 EXY2 RS Shear in xy at Z2

14 EA2 RS Theta (Shear Angle) at Z2

15 EMJRP2 RS Major Principal at Z2

16 EMNRP2 RS Minor Principal at Z2

17 EMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

5-234 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 EXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 EX2R RS Normal in x at Z2

11 EX2I RS Normal in x at Z2

12 EY2R RS Normal in y at Z2

13 EY2I RS Normal in y at Z2

14 EXY2R RS Shear in xy at Z2

15 EXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 EX2 RS Normal in x at Z2

8 EY2 RS Normal in y at Z2

9 EXY2 RS Shear in xy at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 SA1 RS Theta ( Shear Angle ) at Z1

7 SMJRP1 RS Major Principal at Z1

8 SMNRP1 RS Minor Principal at Z1

DMAP Programmer's Guide 5-235


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 SMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2 RS Normal in x at Z2

12 SY2 RS Normal in y at Z2

13 TXY2 RS Shear in xy at Z2

14 SA2 RS Theta (Shear Angle) at Z2

15 SMJRP2 RS Major Principal at Z2

16 SMNRP2 RS Minor Principal at Z2

17 TMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 SX2R RS Normal in x at Z2

11 SX2I RS Normal in x at Z2

12 SY2R RS Normal in y at Z2

13 SY2I RS Normal in y at Z2

14 TXY2R RS Shear in xy at Z2

15 TXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

5-236 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 SX2 RS Normal in x at Z2

8 SY2 RS Normal in y at Z2

9 TXY2 RS Shear in xy at Z2

End TCODE,7

End SCODE,6

ELTYPE =228 Quadrilateral plate element (CQUADR)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 EA1 RS Theta ( Shear Angle ) at Z1

7 EMJRP1 RS Major Principal at Z1

8 EMNRP1 RS Minor Principal at Z1

9 EMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2 RS Normal in x at Z2

12 EY2 RS Normal in y at Z2

13 EXY2 RS Shear in xy at Z2

14 EA2 RS Theta (Shear Angle) at Z2

15 EMJRP2 RS Major Principal at Z2

16 EMNRP2 RS Minor Principal at Z2

17 EMAX2 RS Maximum Shear at Z2

DMAP Programmer's Guide 5-237


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 EX2R RS Normal in x at Z2

11 EX2I RS Normal in x at Z2

12 EY2R RS Normal in y at Z2

13 EY2I RS Normal in y at Z2

14 EXY2R RS Shear in xy at Z2

15 EXY2I RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 EX1 RS Normal in x at Z1

4 EY1 RS Normal in y at Z1

5 EXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 EX2 RS Normal in x at Z2

8 EY2 RS Normal in y at Z2

9 EXY2 RS Shear in xy at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

5-238 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 SA1 RS Theta ( Shear Angle ) at Z1

7 SMJRP1 RS Major Principal at Z1

8 SMNRP1 RS Minor Principal at Z1

9 SMAX1 RS Maximum Shear at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2 RS Normal in x at Z2

12 SY2 RS Normal in y at Z2

13 TXY2 RS Shear in xy at Z2

14 SA2 RS Theta (Shear Angle) at Z2

15 SMJRP2 RS Major Principal at Z2

16 SMNRP2 RS Minor Principal at Z2

17 SMAX2 RS Maximum Shear at Z2

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 FD2 RS Z2 = Fibre Distance

10 SX2R RS Normal in x at Z2

11 SX2I RS Normal in x at Z2

DMAP Programmer's Guide 5-239


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

12 SY2R RS Normal in y at Z2

13 SY2I RS Normal in y at Z2

14 TXY2R RS Shear in xy at Z2

TCODE,7 =2 Random Response

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 FD2 RS Z2 = Fibre Distance

7 SX2 RS Normal in x at Z2

8 SY2 RS Normal in y at Z2

9 TXY2 RS Shear in xy at Z2

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =232 QUADR composite

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

5-240 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

DMAP Programmer's Guide 5-241


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 ST1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

End TCODE,7

5-242 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End SCODE,6

ELTYPE =233 TRIAR composite (Same as TRIAR composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

TCODE,7 =2 Random Response

DMAP Programmer's Guide 5-243


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

5-244 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

TCODE,7 =2 Random Response

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 ST1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =240 CTRIA6 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

DMAP Programmer's Guide 5-245


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

Words 3 through 27 process 4 times

Word Name Type Description

ELTYPE =241 CQUAD8 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

5-246 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

Words 3 through 27 process 5 times

ELTYPE =242 Axisymmetric triangular element (CTRAX3) – Linear


Stress/Strain - Center and corners

TCODE,7 =0 Real

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

DMAP Programmer's Guide 5-247


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 MAXP RS Maximum Principal

9 TMAX RS Maximum Shear

10 OCTS RS Octahedral

Words 3 through 10 process 4 times

TCODE,7 =1 Real / Imaginary

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SXR RS Normal stress in X – Real part

5 SXI RS Normal stress in X – Imaginary part

6 SYR RS Normal stress in Y – Real part

7 SYI RS Normal stress in Y – Imaginary part

8 SZR RS Normal stress in Z – Real part

9 SZI RS Normal stress in Z – Imaginary part

10 SPR RS In-plane shear stress – Real part

11 SPI RS In-plane shear stress – Imaginary part

Words 3 through 11 process 4 times

TCODE,7 =2 Random Response

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

Words 3 through 7 process 4 times

End TCODE,7

5-248 DMAP Programmer's Guide


Data Block Descriptions O-V

ELTYPE =243 Axisymmetric quad element (CQUADX4) – Linear Stress/Strain -


Center and corners

TCODE,7 =0 Real

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 MAXP RS Maximum Principal

9 TMAX RS Maximum Shear

10 OCTS RS Octahedral

Words 3 through 10 process 5 times

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

Words 2 through 10 process 5 times

TCODE,7 =2 Random Response

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

DMAP Programmer's Guide 5-249


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

Words 2 through 6 process 5 times

End TCODE,7

ELTYPE =244 Axisymmetric triangle element (CTRAX6) – Linear Stress/Strain


- Center and corners

TCODE,7 =0 Real

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 MAXP RS Maximum Principal

9 TMAX RS Maximum Shear

10 OCTS RS Octahedral

Words 3 through 10 process 4 times

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

5-250 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 2 through 10 process 4 times

TCODE,7 =2 Random Response

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

Words 2 through 6 process 4 times

End TCODE,7

ELTYPE =245 Axisymmetric quad element (CQUADX8) – Linear Stress/Strain -


Center and corners

TCODE,7 =0 Real

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 MAXP RS Maximum Principal

9 TMAX RS Maximum Shear

10 OCTS RS Octahedral

Words 3 through 10 process 5 times

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

DMAP Programmer's Guide 5-251


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

Words 2 through 10 process 5 times

TCODE,7 =2 Random Response

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

Words 2 through 6 process 5 times

End TCODE,7

ELTYPE =246 Axisymmetric triangle element (CTRAX3) – Nonlinear


Stress/Strain - Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

5-252 DMAP Programmer's Guide


Data Block Descriptions O-V

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

Words 3 through 14 process 4 times

ELTYPE =247 Axisymmetric quad element (CQUADX4) – Nonlinear Stress/Strain


- Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

Words 3 through 14 process 5 times

ELTYPE =248 Axisymmetric triangle element (CTRAX6) – Nonlinear


Stress/Strain - Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

DMAP Programmer's Guide 5-253


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 SE RS In-plane shear strain

Words 3 through 14 process 4 times

ELTYPE =249 Axisymmetric quad element (CQUADX8) – Nonlinear Stress/Strain


- Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

Words 3 through 14 process 5 times

ELTYPE =250 Axisymmetric triangle element (CTRAX3) – Linear form of


hyperelastic – Gauss Location

2 LOC I Location Code

5-254 DMAP Programmer's Guide


Data Block Descriptions O-V

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 3 times

ELTYPE =251 Axisymmetric quad element (CQUADX4) – Linear form of


hyperelastic – Gauss Locations

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 4 times

ELTYPE =252 Axisymmetric triangle element (CTRAX6) – Linear form of


hyperelastic – Gauss Locations

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 3 times

DMAP Programmer's Guide 5-255


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =253 Axisymmetric quad element (CQUADX8) – Linear form of


hyperelastic – Gauss Locations

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 9 times

Word Name Type Description

ELTYPE =254 CQUAD4 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

5-256 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

Words 3 through 27 process 5 times

ELTYPE = 255 CPYRAM – Linear Strain/Stress

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EX RS Normal in x

7 ETXY RS Shear in xy

8 EP1 RS First principal strain

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

11 P3X RS Third principal x cosine

12 EPR RS Mean pressure

DMAP Programmer's Guide 5-257


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

13 EOCT RS Octahedral shear strain

14 EY RS Normal in y

15 ETYZ RS Shear in yz

16 EP2 RS Second principal strain

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 EZ RS Normal in z

21 ETZX RS Shear in zx

22 EP3 RS Third principal strain

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 process 6 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

5-258 DMAP Programmer's Guide


Data Block Descriptions O-V

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

Words 5 through 17 process 6 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EX RS Normal in x

7 EY RS Normal in y

8 EZ RS Normal in z

9 ETXY RS Shear in xy

10 ETYZ RS Shear in yz

11 ETZX RS Shear in zx

Words 5 through 11 process 6 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 TXY RS Shear in xy

8 P1 RS First principal stress

9 P1X RS First principal x cosine

10 P2X RS Second principal x cosine

DMAP Programmer's Guide 5-259


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

11 P3X RS Third principal x cosine

12 PR RS Mean pressure

13 OCT RS Octahedral shear stress

14 SY RS Normal in y

15 TYZ RS Shear in yz

16 P2 RS Second principal stress

17 P1Y RS First principal y cosine

18 P2Y RS Second principal y cosine

19 P3Y RS Third principal y cosine

20 SZ RS Normal in z

21 TZX RS Shear in zx

22 P3 RS Third principal stress

23 P1Z RS First principal z cosine

24 P2Z RS Second principal z cosine

25 P3Z RS Third principal z cosine

Words 5 through 25 process 6 times

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

5-260 DMAP Programmer's Guide


Data Block Descriptions O-V

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

Words 5 through 17 process 6 times

TCODE,7 =2 Random Response

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

Words 5 through 11 process 6 times

End TCODE,7

End SCODE,6

ELTYPE =256 CPYRAM - Nonlinear

2 CTYPE CHAR4 GRID or GAUSS

3 GRID I 0 for center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

DMAP Programmer's Guide 5-261


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Effective plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 process 6 times

ELTYPE =257 CPYRAM (linear element, 5 grids) – Hyperelastic nonlinear


format

2 CTYPE CHAR4 GRID

3 ID I Grid ID

4 SX RS Stress in X

5 SY RS Stress in Y

6 SZ RS Stress in Z

7 SXY RS Stress in XY

8 SYZ RS Stress in YZ

9 SZX RS Stress in ZX

10 PRESSURE RS Pressure

11 VOLSTR RS Volumetric Strain

12 EX RS Strain in X

13 EY RS Strain in Y

14 EZ RS Strain in Z

5-262 DMAP Programmer's Guide


Data Block Descriptions O-V

15 EXY RS Strain in XY

16 EYZ RS Strain in YZ

17 EZX RS Strain in ZX

Words 3 through 17 process 5 times

ELTYPE =258 CPYRAM (parabolic element, 13 grids) – Hyperelastic nonlinear


format

2 TYPE CHAR4 GRID

3 ID I Grid ID

4 SX RS Stress in X

5 SY RS Stress in Y

6 SZ RS Stress in Z

7 SXY RS Stress in XY

8 SYZ RS Stress in YZ

9 SZX RS Stress in ZX

10 PRESSURE RS Pressure

11 VOLSTR RS Volumetric Strain

12 EX RS Strain in X

13 EY RS Strain in Y

14 EZ RS Strain in Z

15 EXY RS Strain in XY

16 EYZ RS Strain in YZ

17 EZX RS Strain in ZX

Words 3 through 17 process 5 times

ELTYPE =259 Reserved for hyperelastic PYRAM 5-noded, linear form.

ELTYPE =260 Reserved for hyperelastic PYRAM 13-noded, linear form.

DMAP Programmer's Guide 5-263


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =261 Axisymmetric triangle element (CTRAX3) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 3 times

ELTYPE =262 Axisymmetric quad element (CQUADX4) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

5-264 DMAP Programmer's Guide


Data Block Descriptions O-V

13 EP RS In-plane shear strain

Words 3 through 13 process 4 times

ELTYPE =263 Axisymmetric triangle element (CTRAX6) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 3 times

ELTYPE =264 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – Grid Locations

2 TYPE CHAR4 GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

DMAP Programmer's Guide 5-265


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 4 times

ELTYPE =266 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – 9 Gauss Locations

2 TYPE CHAR4 GAUS

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 9 times

ELTYPE =269 Composite HEXA element (CHEXAL)

2 PLY I Lamina number

SCODE,6=0 Strain

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

5-266 DMAP Programmer's Guide


Data Block Descriptions O-V

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 4 through 11 repeat 5 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

DMAP Programmer's Guide 5-267


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 16 repeat 5 times.

TCODE,7 =2 Random Response

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

5-268 DMAP Programmer's Guide


Data Block Descriptions O-V

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 10 repeat 5 times.

End TCODE,7

SCODE,6=1 Stress

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

DMAP Programmer's Guide 5-269


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 4 through 11 repeat 5 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

5-270 DMAP Programmer's Guide


Data Block Descriptions O-V

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 16 repeat 5 times.

TCODE,7 =2 Random Response

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

DMAP Programmer's Guide 5-271


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 10 repeat 5 times.

End TCODE,7

End SCODE,6

ELTYPE =270 Composite PENTA element (CPENTAL)

2 PLY I Lamina number

SCODE,6=0 Strain

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

Q4CSTR=1 Center and Corner option

5-272 DMAP Programmer's Guide


Data Block Descriptions O-V

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 4 through 11 repeat 4 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

DMAP Programmer's Guide 5-273


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 16 repeat 4 times.

TCODE,7 =2 Random Response

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5-274 DMAP Programmer's Guide


Data Block Descriptions O-V

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 10 repeat 4 times.

End TCODE,7

SCODE,6=1 Stress

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

DMAP Programmer's Guide 5-275


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 4 through 11 repeat 4 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

5-276 DMAP Programmer's Guide


Data Block Descriptions O-V

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 16 repeat 4 times.

TCODE,7 =2 Random Response

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

For each fiber location requested (PLSLOC), words 4 through 10 repeat 4 times.

End TCODE,7

DMAP Programmer's Guide 5-277


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

End SCODE,6

ELTYPE =271 Triangle plane strain (CPLSTN3) – Center

SCODE,6=0 Strain

TCODE,7=0 Real

2 EX RS Normal strain in x

3 EY RS Normal strain in y

4 EZ RS Normal strain in z

5 EP RS In-plane shear strain

6 EMAX RS Von Mises strain

TCODE,7=1 Real / Imaginary

2 EXR RS Normal strain in x – real part

3 EXI RS Normal strain in x – imaginary part

4 EYR RS Normal strain in y – real part

5 EYI RS Normal strain in y – imaginary part

6 EZR RS Normal strain in z – real part

7 EZI RS Normal strain in z – imaginary part

8 EPR RS In-plane shear strain – real part

9 EPI RS In-plane shear strain – imaginary part

TCODE,7=2 Random response

2 EX RS Normal strain in x

3 EY RS Normal strain in y

4 EZ RS Normal strain in z

5 EP RS In-plane shear strain

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 SX RS Normal stress in x

5-278 DMAP Programmer's Guide


Data Block Descriptions O-V

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

6 SMAX RS Von Mises stress

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

TCODE,7=2 Random response

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

End TCODE,7

End SCODE,6

ELTYPE =272 Quadrilateral plane strain (CPLSTN4) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

DMAP Programmer's Guide 5-279


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

5-280 DMAP Programmer's Guide


Data Block Descriptions O-V

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 5 times

End TCODE,7

DMAP Programmer's Guide 5-281


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

End SCODE,6

ELTYPE =273 Triangle plane strain (CPLSTN6 ) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 4 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 4 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

5-282 DMAP Programmer's Guide


Data Block Descriptions O-V

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 4 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 4 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 4 times

DMAP Programmer's Guide 5-283


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 4 times

End TCODE,7

End SCODE,6

ELTYPE =274 Quadrilateral plane strain (CPLSTN8) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

5-284 DMAP Programmer's Guide


Data Block Descriptions O-V

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

DMAP Programmer's Guide 5-285


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =275 Triangle plane stress (CPLSTS3) – Center

SCODE,6=0 Strain

TCODE,7=0 Real

2 EX RS Normal strain in x

3 EY RS Normal strain in y

4 EZ RS Normal strain in z

5 EP RS In-plane shear strain

6 EMAX RS Von Mises strain

5-286 DMAP Programmer's Guide


Data Block Descriptions O-V

TCODE,7=1 Real / Imaginary

2 EXR RS Normal strain in x – real part

3 EXI RS Normal strain in x – imaginary part

4 EYR RS Normal strain in y – real part

5 EYI RS Normal strain in y – imaginary part

6 EZR RS Normal strain in z – real part

7 EZI RS Normal strain in z – imaginary part

8 EPR RS In-plane shear strain – real part

9 EPI RS In-plane shear strain – imaginary part

TCODE,7=2 Random response

2 EX RS Normal strain in x

3 EY RS Normal strain in y

4 EZ RS Normal strain in z

5 EP RS In-plane shear strain

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

6 SMAX RS Von Mises stress

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

DMAP Programmer's Guide 5-287


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

TCODE,7=1 Random response

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

End TCODE,7

End SCODE,6

ELTYPE =276 Quadrilateral plane stress (CPLSTS4) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

5-288 DMAP Programmer's Guide


Data Block Descriptions O-V

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

DMAP Programmer's Guide 5-289


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =277 Triangle plane stress (CPLSTS6) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

5-290 DMAP Programmer's Guide


Data Block Descriptions O-V

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 4 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 4 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 4 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

DMAP Programmer's Guide 5-291


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 4 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 4 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 4 times

End TCODE,7

End SCODE,6

5-292 DMAP Programmer's Guide


Data Block Descriptions O-V

ELTYPE =278 Quadrilateral plane stress (CPLSTS8) – Center and Corners

SCODE,6=0 Strain

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

8 EMAX RS Von Mises strain

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EX RS Normal strain in x

5 EY RS Normal strain in y

DMAP Programmer's Guide 5-293


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 EZ RS Normal strain in z

7 EP RS In-plane shear strain

Words 3 through 7 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=0 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 SMAX RS Von Mises stress

Words 3 through 8 repeat 5 times

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

Words 3 through 11 repeat 5 times

TCODE,7=2 Random response

2 TERM CHAR4 “CEN”

5-294 DMAP Programmer's Guide


Data Block Descriptions O-V

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

Words 3 through 7 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =281 Triangle plane strain (CPLSTN3) – Nonlinear format – Center

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SXZ RS Shear stress in xz

6 ES RS Equivalent stress

7 EPS RS Effective plastic/inelastic strain

8 ECS RS Effective creep strain

9 EX RS Strain in x

10 EY RS Strain in y

11 EZ RS Strain in z

12 ETXZ RS Shear strain in xz

ELTYPE =283 Triangle plane strain (CPLSTN6) – Nonlinear format – Center and
Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

DMAP Programmer's Guide 5-295


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 4 times

ELTYPE =284 Quadrilateral plane strain (CPLSTN8) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =285 Triangle plane stress (CPLSTS3) – Nonlinear format – Center

2 SX RS Normal stress in x

5-296 DMAP Programmer's Guide


Data Block Descriptions O-V

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SXZ RS Shear stress in xz

6 ES RS Equivalent stress

7 EPS RS Effective plastic/inelastic strain

8 ECS RS Effective creep strain

9 EX RS Strain in x

10 EY RS Strain in y

11 EZ RS Strain in z

12 ETXZ RS Shear strain in xz

ELTYPE =287 Triangle plane stress (CPLSTS6) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 4 times

DMAP Programmer's Guide 5-297


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =288 Quadrilateral plane stress (CPLSTS8) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =289 Quadrilateral plane strain (CPLSTN4) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

5-298 DMAP Programmer's Guide


Data Block Descriptions O-V

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =290 Quadrilateral plane stress (CPLSTS4) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =291 Triangle plane strain (CPLSTN3) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

DMAP Programmer's Guide 5-299


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =292 Quadrilateral plane strain (CPLSTN4) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =293 Triangle plane strain (CPLSTN6) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5-300 DMAP Programmer's Guide


Data Block Descriptions O-V

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =294 Quadrilateral plane strain (CPLSTN8) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =295 Triangle plane stress (CPLSTS3) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

DMAP Programmer's Guide 5-301


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =296 Quadrilateral plane stress (CPLSTS4) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

5-302 DMAP Programmer's Guide


Data Block Descriptions O-V

ELTYPE =297 Triangle plane stress (CPLSTS6) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =298 Quadrilateral plane stress (CPLSTS8) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

DMAP Programmer's Guide 5-303


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =300 HEXA element (CHEXA)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 8 times.

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

5-304 DMAP Programmer's Guide


Data Block Descriptions O-V

11 EVM RS Von Mises strain

Words 4 through 11 repeat 8 times.

End SCODE,6

ELTYPE =301 PENTA element (CPENTA )

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 6 times.

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

DMAP Programmer's Guide 5-305


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 6 times.

End SCODE,6

ELTYPE =302 TETRA element (CTETRA)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

5-306 DMAP Programmer's Guide


Data Block Descriptions O-V

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 4 times.

End SCODE,6

ELTYPE =303 PYRAM element (CPYRAM)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 5 times.

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

DMAP Programmer's Guide 5-307


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 5 times.

End SCODE,6

ELTYPE =304 Linear composite HEXA element (CHEXAL)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

5-308 DMAP Programmer's Guide


Data Block Descriptions O-V

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =305 Linear composite PENTA element (CPENTAL)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

DMAP Programmer's Guide 5-309


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =306 Nonlinear composite HEXA element (CHEXALN)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

5-310 DMAP Programmer's Guide


Data Block Descriptions O-V

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =307 Nonlinear composite PENTA element (CPENTALN)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

DMAP Programmer's Guide 5-311


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =312 Axisymmetric tria element (TRAX3)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-312 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =313 Axisymmetric quad element (QUADX4)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-313


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =314 Axisymmetric tria element (TRAX6)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-314 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =315 Axisymmetric quad element (QUADX8)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-315


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =316 Plane strain tria element (PLSTN3)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-316 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =317 Plane strain quad element (PLSTN4)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-317


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =318 Plane strain tria element (PLSTN6)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-318 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =319 Plane strain quad element (PLSTN8)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-319


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =320 Plane stress tria element (PLSTS3)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-320 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =321 Plane stress quad element (PLSTS4)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-321


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =322 Plane stress tria element (PLSTS6)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-322 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =323 Plane stress quad element (PLSTS8)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-323


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =328 Generalized plane strain tria element (GPLSTN3)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-324 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =329 Generalized plane strain quad element (GPLSTN4)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-325


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =330 Generalized plane strain tria element (GPLSTN6)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

5-326 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =331 Generalized plane strain quad element (GPLSTN8)

SCODE,6=0 Strain

TODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

3 GRID I External grid ID

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

DMAP Programmer's Guide 5-327


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Words 3 through 10 repeat 4 times.

End SCODE,6

Word Name Type Description

End ELTYPE

Record - TRAILER

Word Name Type Description

1 UNDEF(6 ) None

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.14 OESMC
Table of modal contributions of element stresses.
For all analysis types (real and complex), and SORT1 and SORT2 formats.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

5-328 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 MCODE I Modal contributions code: 1=absolute,


2=normalized

4 SUBCASE I Subcase number

5 EICODE I Element item code (1000*element ID + item code)

TCODE,1 =1 Sort 1

ACODE,4 = 05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

ACODE,4 =06 Transient

6 TIME RS Time step

7 UNDEF None

ACODE,4 =09 Complex Eigenvalues

6 EIGR RS Eigenvalue – real part

7 EIGI RS Eigenvalue – imaginary part

End ACODE,4

TCODE,1 =02 Sort 2

6 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

7 MFREQ RS Modal frequency (Hz)

End TCODE,1

8 UNDEF None

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

DMAP Programmer's Guide 5-329


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA
Word Name Type Description

TCODE,1 =01 Sort 1

1 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

2 MFREQ RS Modal frequency (Hz)

TCODE,1 =02 Sort 2

ACODE,4 =05

1 FREQ RS Frequency (Hz)

2 UNDEF None

ACODE,4 =06

1 TIME RS Time step

2 UNDEF None

ACODE,4 =09

1 EIGR RS Eigenvalue – real part

2 EIGI RS Eigenvalue – imaginary part

End ACODE,4

End TCODE,1

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 =1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

5-330 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 3 - TRAILER

Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

5.15 OESVM
Table of element stresses or strains with von Mises for frequency response results.
For all analysis types (real and complex) and SORT1 and SORT2 formats.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block Name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 ELTYPE(C) I Element Type

4 SUBCASE I Subcase or Random identification number

TCODE,1 = 1 Sort 1

ACODE,4 = 05 Frequency

5 FREQ RS Frequency

6 UNDEF(2) None

End ACODE,4

TCODE,1 = 02 Sort 2

5 FREQ RS Frequency

6 UNDEF(2) None

DMAP Programmer's Guide 5-331


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,1

8 LOADSET I Load set number or Zero

9 FCODE I Format Code

10 NUMWDE(C) I Number of words per entry in DATA record

11 SCODE(C) I Stress/Strain code

12 PID (SOL 601 I Physical Property ID for SOL 601 & 701 only.
and 701 only) UNDEF for all other SOLs

13 ELRESCS I 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 Q4CSTR(C) I Corner Stress Flag

15 PLSLOC(C) I Ply stress/strain location for elements


referencing PCOMPS property entries.
= 1 Middle of each ply.
= 2 Bottom and top of each ply.
= 3 Bottom, middle, and top of each ply.

16 CSOPT I Plane designation for axisymmetric and


plane stress/strain elements
CSOPT=13 indicates these elements are in
the XZ-plane of the basic coordinate system.
For axisymmetric elements, Z is axial and X
is radial.
CSOPT=21 indicates these elements are in
the XY-plane of the basic coordinate system.
For axisymmetric elements, X is axial and
Y is radial.

17 UNDEF None

18 EPSTYPE(C) I Designates the type of strain.


0 = Total Strain
1 = Elastic Strain
2 = Thermal Strain

19 VMFLAG I 1 = von Mises results are present for complex


results.

5-332 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

20 UNDEF(31) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

SORTCODE=1 Sort 1 - SortCode=((TCODE/1000)+2)/2

TCODE,1 =1 o

1 EKEY I Device code + 10*Point identification number

TCODE,1 =02 Sort 2

ACODE/10=01 Analysis type

ACODE,4 =05

1 FREQ RS Frequency

End ACODE,4

End ACODE/10

Word Name Type Description

ELTYPE =00 Grid - OES1G table

2 MATID I Material identification number

3 NX1 RS Normal in x at d1

4 NY1 RS Normal in y at d1

5 TXY1 RS Shear in xy at d1

6 SA1 RS Theta ( Shear Angle ) at d1

7 MJRP1 RS Major Principal at d1

8 MNRP1 RS Minor Principal at d1

9 TMAX1 RS Maximum Shear at d1

DMAP Programmer's Guide 5-333


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 PCODE I 10*interpolation points + projection code

11 NX2 RS Normal in x at d2

12 NY2 RS Normal in y at d2

13 TXY2 RS Shear in xy at d2

14 SA2 RS Theta ( Shear Angle ) at d2

15 MJRP2 RS Major Principal at d2

16 MNRP2 RS Minor Principal at d2

17 TMAX2 RS Maximum Shear at d2

ELTYPE =01 Rod element (CROD)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

End TCODE,7

End SCODE,6

ELTYPE =02 Beam element (CBEAM)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

5-334 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 ERCR RS Long. Strain at Point C

5 EXDR RS Long. Strain at Point D

6 EXER RS Long. Strain at Point E

7 EXFR RS Long. Strain at Point F

8 EXCI RS Long. Strain at Point C

9 EXDI RS Long. Strain at Point D

10 EXEI RS Long. Strain at Point E

11 EXFI RS Long. Strain at Point F

Words 2 through 11 repeat 011 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7=1 Real/Imaginary

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SRCR RS Long. Stress at Point C

5 SXDR RS Long. Stress at Point D

6 SXER RS Long. Stress at Point E

7 SXFR RS Long. Stress at Point F

8 SXCI RS Long. Stress at Point C

9 SXDI RS Long. Stress at Point D

10 SXEI RS Long. Stress at Point E

11 SXFI RS Long. Stress at Point F

Words 2 through 11 repeat 011 times

End
TCODE,7

DMAP Programmer's Guide 5-335


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End
SCODE,6

ELTYPE=03 Tube element (CTUBE)

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

End TCODE,7

End SCODE,6

ELTYPE =04 Shear panel element (CSHEAR)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 ETMAXR RS Maximum Shear

3 ETMAXI RS Maximum Shear

4 ETAVGR RS Average Shear

5 ETAVGI RS Average Shear

End TCODE,7

SCODE,6 =01 Stress

5-336 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real / Imaginary

2 TMAXR RS Maximum Shear

3 TMAXI RS Maximum Shear

4 TAVGR RS Average Shear

5 TAVGI RS Average Shear

End TCODE,7

End SCODE,6

ELTYPE =05 FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness)

2 UNDEF None

ELTYPE =06 Unused

2 UNDEF None

ELTYPE =07 PLOAD4 (follower stiffness)

2 UNDEF None

ELTYPE =08 PLOADX1 (follower stiffness)

2 UNDEF None

ELTYPE =09 PLOAD and PLOAD2 (follower stiffness)

2 UNDEF None

Word Name Type Description

ELTYPE =10 Rod element connection and property (CONROD)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 AER RS Axial Strain

3 AEI RS Axial Strain

4 TER RS Torsional Strain

5 TEI RS Torsional Strain

End TCODE,7

DMAP Programmer's Guide 5-337


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

End TCODE,7

End SCODE,6

ELTYPE =11 Scalar spring element (CELAS1)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =12 Scalar spring element with properties (CELAS2)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

5-338 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/Imaginary

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =13 Scalar spring element to scalar points only (CELAS3)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 ER RS

3 EI RS

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1

2 SR RS Stress

3 SI RS Stress

End TCODE,7

End SCODE,6

ELTYPE =14 Scalar spring element to scalar points only with properties
(CELAS4)

2 UNDEF None

ELTYPE =15 AEROT3

2 UNDEF None

ELTYPE =16 AEROBEAM

2 UNDEF None

ELTYPE =17 Unused (pre-V69 TRIA2 Same as TRIA1)

2 UNDEF None

ELTYPE =18 Unused (pre-V69 QUAD2 Same as TRIA1)

DMAP Programmer's Guide 5-339


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =19 Unused (pre-V69 QUAD1 Same as TRIA1)

2 UNDEF None

Word Name Type Description

ELTYPE =20 Scalar damper (CDAMP1)

2 UNDEF None

ELTYPE =21 Scalar damper with properties (CDAMP2)

2 UNDEF None

ELTYPE =22 Scalar damper to scalar points only (CDAMP3)

2 UNDEF None

ELTYPE =23 Scalar damper to scalar points only with properties (CDAMP4)

2 UNDEF None

ELTYPE =24 Viscous damper (CVISC)

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TAUR RS Torque

5 TAUI RS Torque

End TCODE,7

ELTYPE =25 Scalar mass (CMASS1)

2 UNDEF None

ELTYPE =26 Scalar mass with properties (CMASS2)

2 UNDEF None

ELTYPE =27 Scalar mass to scalar points only (CMASS3)

2 UNDEF None

ELTYPE =28 Scalar mass to scalar pts. only with properties (CMASS4)

5-340 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =29 Concentrated mass element - general form (CONM1)

2 UNDEF None

Word Name Type Description

ELTYPE =30 Concentrated mass element - rigid body form (CONM2)

2 UNDEF None

ELTYPE =31 Dummy plot element (PLOTEL)

2 UNDEF None

ELTYPE =32 Unused

2 UNDEF None

ELTYPE =33 Quadrilateral plate element (CQUAD4)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2R RS Normal in x at Z2

12 EX2I RS Normal in x at Z2

13 EY2R RS Normal in y at Z2

14 EY2I RS Normal in y at Z2

DMAP Programmer's Guide 5-341


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

15 EXY2R RS Shear in xy at Z2

16 EXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2R RS Normal in x at Z2

12 SX2I RS Normal in x at Z2

13 SY2R RS Normal in y at Z2

14 SY2I RS Normal in y at Z2

15 TXY2R RS Shear in xy at Z2

16 TXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

End SCODE,6

ELTYPE =34 Simple beam element (CBAR and see also ELTYPE=100)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

5-342 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 EX1AR RS SA1

3 EX2AR RS SA2

4 EX3AR RS SA3

5 EX4AR RS SA4

6 AER RS Axial

7 EX1AI RS SA1

8 EX2AI RS SA2

9 EX3AI RS SA3

10 EX4AI RS SA4

11 AEI RS Axial

12 EX1BR RS SB1

13 EX2BR RS SB2

14 EX3BR RS SB3

15 EX4BR RS SB4

16 EX1BI RS SB1

17 EX2BI RS SB2

18 EX3BI RS SB3

19 EX4BI RS SB4

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 SX1AR RS SA1

3 SX2AR RS SA2

4 SX3AR RS SA3

5 SX4AR RS SA4

6 ASR RS Axial

7 SX1AI RS SA1

DMAP Programmer's Guide 5-343


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 SX2AI RS SA2

9 SX3AI RS SA3

10 SX4AI RS SA4

11 ASI RS Axial

12 SX1BR RS SB1

13 SX2BR RS SB2

14 SX3BR RS SB3

15 SX4BR RS SB4

16 SX1BI RS SB1

17 SX2BI RS SB2

18 SX3BI RS SB3

19 SX4BI RS SB4

End TCODE,7

End SCODE,6

ELTYPE =35 Axisymmetric shell element (CCONEAX)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 UNDEF None

TCODE,7 =2 Random Response

2 UNDEF None

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 UNDEF None

End TCODE,7

End SCODE,6

ELTYPE =36 Unused (Pre-V69 CTRIARG)

5-344 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =37 Unused (Pre-V69 CTRAPRG)

2 UNDEF None

ELTYPE =38 Gap element (CGAP)

2 FX RS

3 SFY RS

4 SFZ RS

5 U RS

6 V RS

7 W RS

8 SV RS

9 SW RS

ELTYPE =39 Tetra

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

DMAP Programmer's Guide 5-345


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 005 times

5-346 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =40 Rod type spring and damper (CBUSH1D)

TCODE,7 =1 Real / Imaginary

2 FER RS Element Force

3 UER RS Axial Displacement

4 ASR RS Axial Stress*

5 AER RS Axial Strain*

6 FEI RS Element Force

7 UEI RS Axial Displacement

8 ASI RS Axial Stress*

9 AEI RS Axial Strain*

End TCODE,7

ELTYPE =41 Unused (Pre-V69 CHEXA1)

2 UNDEF None

ELTYPE =42 Unused (Pre-V69 CHEXA2)

2 UNDEF None

ELTYPE =43 Fluid element with 2 points (CFLUID2)

2 UNDEF None

ELTYPE =44 Fluid element with 3 points (CFLUID3)

2 UNDEF None

ELTYPE =45 Fluid element with 4 points (CFLUID4)

2 UNDEF None

ELTYPE =46 Cflmass

2 UNDEF None

DMAP Programmer's Guide 5-347


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =47 Fluid element with 2 points (CAXIF2)

TCODE,7 =1 Real / Imaginary

2 RAR RS Radial Axis

3 AAR RS Axial Axis

4 TER RS Tangential Edge

5 CER RS Circumferential Edge

6 RAI RS Radial Axis

7 AAI RS Axial Axis

8 TEI RS Tangential Edge

9 CEI RS Circumferential Edge

End TCODE,7

ELTYPE =48 Fluid element with 3 points (CAXIF3)

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

10 CE3R RS Circumferential edge 3

11 RCI RS Radial centroid

12 CCI RS Circumferential centroid

13 ACR RS Axial centroid

14 TE1I RS Tangential edge 1

15 CE1I RS Circumferential edge 1

5-348 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

16 TE2I RS Tangential edge 2

17 CE2I RS Circumferential edge 2

18 TE3I RS Tangential edge 3

19 CE3I RS Circumferential edge 3

End TCODE,7

ELTYPE =49 Fluid element with 4 points (CAXIF4)

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

10 CE3R RS Circumferential edge 3

11 TE4R RS Tangential edge 4

12 CE4R RS Circumferential edge 4

13 RCI RS Radial centroid

14 CCI RS Circumferential centroid

15 ACR RS Axial centroid

16 TE1I RS Tangential edge 1

17 CE1I RS Circumferential edge 1

18 TE2I RS Tangential edge 2

19 CE2I RS Circumferential edge 2

20 TE3I RS Tangential edge 3

21 CE3I RS Circumferential edge 3

DMAP Programmer's Guide 5-349


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

22 TE4I RS Tangential edge 4

23 CE4I RS Circumferential edge 4

End TCODE,7

Word Name Type Description

ELTYPE =50 Three-point slot element (CSLOT3)

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

7 RCI RS Radial centroid

8 ACI RS Axial centroid

9 TE1I RS Tangential edge 1

10 TE2I RS Tangential edge 2

11 TE3I RS Tangential edge 3

End TCODE,7

ELTYPE =51 Four-point slot element (CSLOT4)

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

7 TE4R RS Tangential edge 4

8 RCI RS Radial centroid

5-350 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 ACI RS Axial centroid

10 TE1I RS Tangential edge 1

11 TE2I RS Tangential edge 2

12 TE3I RS Tangential edge 3

13 TE4I RS Tangential edge 4

End TCODE,7

ELTYPE =52 Heat transfer plot element for CHBDYG and CHBDYP

2 UNDEF None

ELTYPE =54 Unused (Pre-V69 CTRIM6)

2 UNDEF None

ELTYPE =55 Three-point dummy element (CDUM3)

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =56 Four-point dummy element (CDUM4)

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =57 Five-point dummy element (CDUM5)

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =58 Six-point dummy element (CDUM6)

TCODE,7 =1 Real/imaginary or magnitude/phase

DMAP Programmer's Guide 5-351


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =59 Seven-point dummy element (CDUM7)

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

Word Name Type Description

ELTYPE =60 Two-dimensional crack tip element (CRAC2D or CDUM8)

2 X RS X coordinate

3 Y RS Y coordinate

4 SX RS Normal X

5 SY RS Normal Y

6 TXY RS Shear XY

7 KI RS Stress Intensity Factor KI

8 KII RS Stress Intensity Factor KII

9 S8 RS

10 S9 RS

ELTYPE =61 Three-dimensional crack tip element (CRAC3D or CDUM9)

2 X RS Normal X

3 Y RS Normal Y

4 Z RS Normal Z

5 TXY RS Shear XY

6 TYZ RS Shear YZ

7 TZX RS Shear ZX

5-352 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 KI RS Stress Intensity Factor KI

9 KII RS Stress Intensity Factor KII

10 KIII RS Stress Intensity Factor KIII

ELTYPE =62 Unused (Pre-V69 CQDMEM1)

2 UNDEF None

ELTYPE =63 Unused (Pre-V69 CQDMEM2)

2 UNDEF None

ELTYPE =64 Curved quadrilateral shell element (CQUAD8)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 EX2R RS Normal in x at Z2

14 EX2I RS Normal in x at Z2

15 EY2R RS Normal in y at Z2

16 EY2I RS Normal in y at Z2

17 ETXY2R RS Shear in xy at Z2

DMAP Programmer's Guide 5-353


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

18 ETXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification numbers or


grid identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 SX2R RS Normal in x at Z2

14 SX2I RS Normal in x at Z2

15 SY2R RS Normal in y at Z2

16 SY2I RS Normal in y at Z2

17 TXY2R RS Shear in xy at Z2

18 TXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 005 times

End TCODE,7

5-354 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End SCODE,6

ELTYPE =65 Unused (Pre-V69 CHEX8)

2 UNDEF None

ELTYPE =66 Unused (Pre-V69 CHEX20)

2 UNDEF None

ELTYPE =67 Hexa

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 009 times

End TCODE,7

DMAP Programmer's Guide 5-355


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 009 times

End TCODE,7

End SCODE,6

ELTYPE =68 Penta

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

5-356 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 007 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

DMAP Programmer's Guide 5-357


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 repeat 007 times

End TCODE,7

End SCODE,6

ELTYPE =69 Curved beam or pipe element (CBEND)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 ECR RS Long. strain at Point C

5 EDR RS Long. strain at Point D

6 EER RS Long. strain at Point E

7 EFR RS Long. strain at Point F

8 ECI RS Long. strain at Point C

9 EDI RS Long. strain at Point D

10 EEI RS Long. strain at Point E

11 EFI RS Long. strain at Point F

Words 2 through 11 repeat 002 times

5-358 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 SCR RS Long. Stress at Point C

5 SDR RS Long. Stress at Point D

6 SER RS Long. Stress at Point E

7 SFR RS Long. Stress at Point F

8 SCI RS Long. Stress at Point C

9 SDI RS Long. Stress at Point D

10 SEI RS Long. Stress at Point E

11 SFI RS Long. Stress at Point F

Words 2 through 11 repeat 002 times

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =70 Triangular plate element (CTRIAR)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

DMAP Programmer's Guide 5-359


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 EX2R RS Normal in x at Z2

14 EX2I RS Normal in x at Z2

15 EY2R RS Normal in y at Z2

16 EY2I RS Normal in y at Z2

17 ETXY2R RS Shear in xy at Z2

18 ETXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 004 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

5-360 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 SX2R RS Normal in x at Z2

14 SX2I RS Normal in x at Z2

15 SY2R RS Normal in y at Z2

16 SY2I RS Normal in y at Z2

17 TXY2R RS Shear in xy at Z2

18 TXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 004 times

End TCODE,7

End SCODE,6

ELTYPE =71 Unused

2 UNDEF None

ELTYPE =72 AEROQ4

2 UNDEF None

ELTYPE =73 Unused (Pre-V69 CFTUBE)

2 UNDEF None

ELTYPE =74 Triangular shell element (CTRIA3)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

DMAP Programmer's Guide 5-361


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 EXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2R RS Normal in x at Z2

12 EX2I RS Normal in x at Z2

13 EY2R RS Normal in y at Z2

14 EY2I RS Normal in y at Z2

15 EXY2R RS Shear in xy at Z2

16 EXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2R RS Normal in x at Z2

12 SX2I RS Normal in x at Z2

13 SY2R RS Normal in y at Z2

14 SY2I RS Normal in y at Z2

5-362 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

15 TXY2R RS Shear in xy at Z2

16 TXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

End SCODE,6

ELTYPE =75 Curved triangular shell element (CTRIA6)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 EX2R RS Normal in x at Z2

14 EX2I RS Normal in x at Z2

15 EY2R RS Normal in y at Z2

16 EY2I RS Normal in y at Z2

17 ETXY2R RS Shear in xy at Z2

18 ETXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

DMAP Programmer's Guide 5-363


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

Words 3 through 19 repeat 004 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 SX2R RS Normal in x at Z2

14 SX2I RS Normal in x at Z2

15 SY2R RS Normal in y at Z2

16 SY2I RS Normal in y at Z2

17 TXY2R RS Shear in xy at Z2

18 TXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 004 times

End TCODE,7

End SCODE,6

ELTYPE =76 Acoustic velocity/pressures in six-sided solid element (CHEXA)

5-364 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =77 Acoustic velocity/pressures in five-sided solid element (CPENTA)

2 UNDEF None

ELTYPE =78 Acoustic velocity/pressures in four-sided solid element (CTETRA)

2 UNDEF None

ELTYPE =79 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =80 Undef

2 UNDEF None

ELTYPE =81 Undef

2 UNDEF None

ELTYPE =82 Quadrilateral plate element (CQUADR)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1R RS Normal in x at Z1

6 EX1I RS Normal in x at Z1

7 EY1R RS Normal in y at Z1

8 EY1I RS Normal in y at Z1

9 ETXY1R RS Shear in xy at Z1

10 ETXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

DMAP Programmer's Guide 5-365


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

12 FD2 RS Fiber distance at Z2

13 EX2R RS Normal in x at Z2

14 EX2I RS Normal in x at Z2

15 EY2R RS Normal in y at Z2

16 EY2I RS Normal in y at Z2

17 ETXY2R RS Shear in xy at Z2

18 ETXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 VM1 RS von Mises at Z1

12 FD2 RS Fiber distance at Z2

13 SX2R RS Normal in x at Z2

14 SX2I RS Normal in x at Z2

15 SY2R RS Normal in y at Z2

5-366 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

16 SY2I RS Normal in y at Z2

17 TXY2R RS Shear in xy at Z2

18 TXY2I RS Shear in xy at Z2

19 VM2 RS von Mises at Z2

Words 3 through 19 repeat 005 times

End TCODE,7

End SCODE,6

ELTYPE =83 Acoustic absorber element (CHACAB)

2 UNDEF None

ELTYPE =84 Acoustic barrier element (CHACBR)

2 UNDEF None

ELTYPE =85 TETRA - Nonlinear

2 CTYPE CHAR4

3 GRID I Grid / Gauss

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Effective plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

DMAP Programmer's Guide 5-367


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 005 times

ELTYPE =86 GAP - Nonlinear

2 CPX RS Comp x

3 SHY RS Shear in y

4 SHZ RS Shear in z

5 AU RS Axial in u

6 SHV RS Shear in v

7 SHW RS Shear in w

8 SLV RS Slip in v

9 SLP RS Slip in w

10 FORM1 CHAR4 No definition

11 FORM2 CHAR4 No definition

ELTYPE =87 Nonlinear tube element (CTUBE)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

7 LTS RS Linear torsional stress

ELTYPE =88 TRIA3 - Nonlinear (Same as QUAD4)

NUMWDE =13

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 SZ1 RS Stress in z at Z1

5-368 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 EZ1 RS Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

NUMWDE =25

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 UNDEF None Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 UNDEF None Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

14 FD2 RS Z2 = Fiber distance

15 SX2 RS Stress in x at Z2

16 SY2 RS Stress in y at Z2

17 UNDEF None Stress in z at Z2

18 TXY2 RS Shear stress in xy at Z2

19 ES RS Equivalent stress at Z2

DMAP Programmer's Guide 5-369


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

20 EPS2 RS Effective plastic/inelastic strain at Z2

21 ECS2 RS Effective creep strain at Z2

22 EX2 RS Strain in x at Z2

23 EY2 RS Strain in y at Z2

24 UNDEF None Strain in z at Z2

25 ETXY2 RS Shear strain in xy at Z2

End NUMWDE

ELTYPE =89 Nonlinear rod element (CROD)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

7 LTS RS Linear torsional stress

Word Name Type Description

ELTYPE =90 QUAD4 - Nonlinear

NUMWDE =13

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 SZ1 RS Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

5-370 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 EY1 RS Strain in y at Z1

12 EZ1 RS Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

NUMWDE =25

2 FD1 RS Z1 = Fiber distance

3 SX1 RS Stress in x at Z1

4 SY1 RS Stress in y at Z1

5 UNDEF None Stress in z at Z1

6 TXY1 RS Shear stress in xy at Z1

7 ES RS Equivalent stress at Z1

8 EPS1 RS Effective plastic/inelastic strain at Z1

9 ECS1 RS Effective creep strain at Z1

10 EX1 RS Strain in x at Z1

11 EY1 RS Strain in y at Z1

12 UNDEF None Strain in z at Z1

13 ETXY1 RS Shear strain in xy at Z1

14 FD2 RS Z2 = Fiber distance

15 SX2 RS Stress in x at Z2

16 SY2 RS Stress in y at Z2

17 UNDEF None Stress in z at Z2

18 TXY2 RS Shear stress in xy at Z2

19 ES RS Equivalent stress at Z2

20 EPS2 RS Effective plastic/inelastic strain at Z2

21 ECS2 RS Effective creep strain at Z2

22 EX2 RS Strain in x at Z2

23 EY2 RS Strain in y at Z2

24 UNDEF None Strain in z at Z2

DMAP Programmer's Guide 5-371


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

25 ETXY2 RS Shear strain in xy at Z2

End NUMWDE

ELTYPE =91 Nonlinear five-sided solid element (CPENTA)

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Extermal Grid identification number; 0 = Center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Equivalent plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 007 times

ELTYPE =92 Nonlinear rod element connection and property (CONROD)

2 AS RS Axial Stress

3 SE RS Equivalent Stress

4 TE RS Total Strain

5 EPS RS Effective Plastic strain

6 ECS RS Effective Creep strain

5-372 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 LTS RS Linear torsional stress

ELTYPE =93 Nonlinear six-sided solid element (CHEXA)

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Extermal Grid identification number; 0 = Center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Equivalent plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 repeat 009 times

ELTYPE =94 Nonlinear beam element (CBEAM)

2 GRIDA I External Grid point Id at A

3 LOCCA CHAR4 'C' (BCD Value) at A

4 NSXCA RS Long. Stress at point C at A

5 NSECA RS Equivalent Stress at A

6 TECA RS Total Strain at A

7 EPECA RS Effective Plastic strain at A

DMAP Programmer's Guide 5-373


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 ECECA RS Effective Creep strain at A

9 LOCDA CHAR4 'D' (BCD Value) at A

10 NSXDA RS Long. Stress at point D at A

11 NSEDA RS Equivalent Stress at A

12 TEDA RS Total Strain at A

13 EPEDA RS Effective Plastic strain at A

14 ECEDA RS Effective Creep strain at A

15 LOCEA CHAR4 'E' (BCD Value) at A

16 NSXEA RS Long. Stress at point E at A

17 NSEEA RS Equivalent Stress at A

18 TEEA RS Total Strain at A

19 EPEEA RS Effective Plastic strain at A

20 ECEEA RS Effective Creep strain at A

21 LOCFA CHAR4 'F' (BCD Value) at A

22 NSXFA RS Long. Stress at point F at A

23 NSEFA RS Equivalent Stress at A

24 TEFA RS Total Strain at A

25 EPEFA RS Effective Plastic strain at A

26 ECEFA RS Effective Creep strain at A

27 GRIDB I External Grid point identification number at B

28 LOCCB CHAR4 'C' (BCD Value) at B

29 NSXCB RS Long. Stress at point C at B

30 NSECB RS Equivalent Stress at B

31 TECB RS Total Strain at B

32 EPECB RS Effective Plastic strain at B

33 ECECB RS Effective Creep strain at B

34 LOCDB CHAR4 'D' (BCD Value) at B

5-374 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

35 NSXDB RS Long. Stress at point D at B

36 NSEDB RS Equivalent Stress at B

37 TEDB RS Total Strain at B

38 EPEDB RS Effective Plastic strain at B

39 ECEDB RS Effective Creep strain at B

40 LOCEB CHAR4 'E' (BCD Value) at B

41 NSXEB RS Long. Stress at point E at B

42 NSEEB RS Equivalent Stress at B

43 TEEB RS Total Strain at B

44 EPEEB RS Effective Plastic strain at B

45 ECEEB RS Effective Creep strain at B

46 LOCFB CHAR4 'F' (BCD Value) at B

47 NSXFB RS Long. Stress at point F at B

48 NSEFB RS Equivalent Stress at B

49 TEFB RS Total Strain at B

50 EPEFB RS Effective Plastic strain at B

51 ECEFB RS Effective Creep strain at B

ELTYPE =95 QUAD4 composite

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

DMAP Programmer's Guide 5-375


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

5-376 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

ELTYPE =96 QUAD8 composite (Same as QUAD4 composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

DMAP Programmer's Guide 5-377


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

5-378 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

ELTYPE =97 TRIA3 composite (Same as QUAD4 composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

DMAP Programmer's Guide 5-379


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

5-380 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

ELTYPE =98 TRIA6 composite (Same as QUAD4 composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

DMAP Programmer's Guide 5-381


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

5-382 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

ELTYPE =99 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =100 Simple beam element w/stations (CBAR with CBARAO or


PLOAD1)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 SD RS % along bar for output

3 EXCR RS Strain at point c

DMAP Programmer's Guide 5-383


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 EXDR RS Strain at point d

5 EXER RS Strain at point e

6 EXFR RS Strain at point f

7 AER RS Axial strain

8 EMAXR RS Maximum strain

9 EMINR RS Minimum strain

10 EXCI RS Strain at point c

11 EXDI RS Strain at point d

12 EXEI RS Strain at point e

13 EXFI RS Strain at point f

14 AEI RS Axial strain

15 EMAXI RS Maximum strain

16 EMINI RS Minimum strain

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 SD RS % along bar for output

3 SXCR RS Stress at point c

4 SXDR RS Stress at point d

5 SXER RS Stress at point e

6 SXFR RS Stress at point f

7 ASR RS Axial stress

8 SMAXR RS Maximum stress

9 SMINR RS Minimum stress

10 SXCI RS Stress at point c

11 SXDI RS Stress at point d

12 SXEI RS Stress at point e

5-384 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 SXFI RS Stress at point f

14 ASI RS Axial stress

15 SMAXI RS Maximum stress

16 SMINI RS Minimum stress

End TCODE,7

End SCODE,6

ELTYPE =101 Acoustic absorber element with freq. dependence (CAABSF)

TCODE,7 =1 Real / Imaginary

2 IMPEDR RS Impedance

3 IMPEDI RS Impedance

4 ABSORB RS Absorption Coefficient

End TCODE,7

ELTYPE =102 Generalized spring and damper element (CBUSH)

TCODE,7 =1 Real / Imaginary

2 TXR RS Translation x R

3 TYR RS Translation y R

4 TZR RS Translation z R

5 RXR RS Rotation x R

6 RYR RS Rotation y R

7 RZR RS Rotation z R

8 TXI RS Translation x I

9 TYI RS Translation y I

10 TZI RS Translation z I

11 RXI RS Rotation x I

12 RYI RS Rotation y I

13 RZI RS Rotation z I

End TCODE,7

DMAP Programmer's Guide 5-385


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =103 Quadrilateral shell element (QUADP)

2 UNDEF None

ELTYPE =104 Triangular shell p-element (TRIAP)

2 UNDEF None

ELTYPE =105 Beam p-element (BEAMP)

2 UNDEF None

ELTYPE =106 Scalar damper with material property (CDAMP5)

2 UNDEF None

ELTYPE =107 Heat transfer boundary condition element - (CHBDYE)

2 UNDEF None

ELTYPE =108 Heat transfer boundary condition element (CHBDYG)

2 UNDEF None

ELTYPE =109 Heat transfer boundary condition element (CHBDYP)

2 UNDEF None

Word Name Type Description

ELTYPE =110 CONV

2 UNDEF None

ELTYPE =111 CONVM

2 UNDEF None

ELTYPE =115 RADBC

2 UNDEF None

ELTYPE =112 QBDY3

2 UNDEF None

ELTYPE =113 QVECT

2 UNDEF None

ELTYPE =114 QVOL

5-386 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =115 Radbc

2 UNDEF None

ELTYPE =116 Slideline contact (SLIF1D)

2 UNDEF None

Word Name Type Description

ELTYPE =127 CQUAD

ELTYPE =128 CQUADX

ELTYPE =129 RELUC

Word Name Type Description

ELTYPE =130 RES

ELTYPE =131 TETRAE

ELTYPE =132 CTRIA

ELTYPE =133 CTRIAX

ELTYPE =134 LINEOB

ELTYPE =135 LINXOB

ELTYPE =136 QUADOB

ELTYPE =137 TRIAOB

ELTYPE =138 LINEX

ELTYPE =139 Hyperelastic QUAD4FD

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

DMAP Programmer's Guide 5-387


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 004 times

Word Name Type Description

ELTYPE =140 Hyperelastic 8-noded hexahedron element linear format


(HEXAFD)

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

5-388 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

22 CZ RS

Words 3 through 22 repeat 008 times

ELTYPE =141 Six-sided solid p-element (HEXAP)

2 UNDEF None

ELTYPE =142 Five-sided solid p-element (PENTAP)

2 UNDEF None

ELTYPE =143 Four-sided solid p-element (TETRAP)

2 UNDEF None

ELTYPE =144 Quadrilateral plate element for corner stresses (CQUAD4)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 EX1R RS Normal in x at z1

6 EX1I RS Normal in x at z1

7 EY1R RS Normal in y at z1

8 EY1I RS Normal in y at z1

9 ETXY1R RS Shear in xy at z1

10 ETXY1I RS Shear in xy at z1

11 VM1 RS von Mises at z1

12 FD2 RS Fiber distance at z2

13 EX2R RS Normal in x at z2

14 EX2I RS Normal in x at z2

15 EY2R RS Normal in y at z2

16 EY2I RS Normal in y at z2

17 ETXY2R RS Shear in xy at z2

DMAP Programmer's Guide 5-389


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

18 ETXY2I RS Shear in xy at z2

19 VM2 RS von Mises at z2

Words 3 through 19 repeat 005 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 SX1R RS Normal in x at z1

6 SX1I RS Normal in x at z1

7 SY1R RS Normal in y at z1

8 SY1I RS Normal in y at z1

9 TXY1R RS Shear in xy at z1

10 TXY1I RS Shear in xy at z1

11 VM1 RS von Mises at z1

12 FD2 RS Fiber distance at z2

13 SX2R RS Normal in x at z2

14 SX2I RS Normal in x at z2

15 SY2R RS Normal in y at z2

16 SY2I RS Normal in y at z2

17 TXY2R RS Shear in xy at z2

18 TXY2I RS Shear in xy at z2

19 VM2 RS von Mises at z2

Words 3 through 19 repeat 005 times

End TCODE,7

End SCODE,6

5-390 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =145 Six-sided solid display element (VUHEXA)

2 PARENTID I

NUMWDE =98 Len=2+ 12 * No. of points

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 008 times

NUMWDE =58 Len= 2 + 7 * No. of points

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 008 times

NUMWDE =106 Len= 2 + 13 * No. of points

3 GRIDID I

DMAP Programmer's Guide 5-391


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

9 TZXR RS

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 008 times

End NUMWDE

ELTYPE =146 Five-sided solid display element (VUPENTA)

2 PARENTID I

NUMWDE =74

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

5-392 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 006 times

NUMWDE =44

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 006 times

NUMWDE =80 2 + 6*13

3 GRIDID I

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

9 TZXR RS

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 006 times

DMAP Programmer's Guide 5-393


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End NUMWDE

ELTYPE =147 Four-sided solid display element (VUTETRA)

2 PARENTID I

NUMWDE =50

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

10 PRIN01 RS

11 PRIN02 RS

12 PRIN03 RS

13 MEAN RS

14 VONOROCT RS

Words 3 through 14 repeat 004 times

NUMWDE =30

3 GRIDID I

4 XNORM RS

5 YNORM RS

6 ZNORM RS

7 TXY RS

8 TYZ RS

9 TZX RS

Words 3 through 9 repeat 004 times

NUMWDE =54 2 + 4*13

5-394 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 GRIDID I

4 XNORMR RS

5 YNORMR RS

6 ZNORMR RS

7 TXYR RS

8 TYZR RS

9 TZXR RS

10 XNORMI RS

11 YNORMI RS

12 ZNORMI RS

13 TXYI RS

14 TYZI RS

15 TZXI RS

Words 3 through 15 repeat 004 times

End NUMWDE

ELTYPE =148 HEXAM

2 UNDEF None

ELTYPE =149 PENTAM

2 UNDEF None

Word Name Type Description

ELTYPE =150 TETRAM

2 UNDEF None

ELTYPE =151 QUADM

2 UNDEF None

ELTYPE =152 TRIAM

2 UNDEF None

DMAP Programmer's Guide 5-395


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =153 QUADXM

2 UNDEF None

ELTYPE =154 TRIAXM

2 UNDEF None

ELTYPE =155 QUADPW

2 UNDEF None

ELTYPE =156 TRIAPW

2 UNDEF None

ELTYPE =157 LINEPW

2 UNDEF None

ELTYPE =158 QUADOBM

2 UNDEF None

ELTYPE =159 TRIAOBM

2 UNDEF None

Word Name Type Description

ELTYPE =160 Hyperelastic 5-sided 6-noded solid element (PENTAFD) Linear


form

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

5-396 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 006 times

ELTYPE =161 Linear form for hyperelastic 4 node TETRA

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

DMAP Programmer's Guide 5-397


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 001 times

ELTYPE =162 Linear form for hyperelastic 3 node TRIA (strain)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 001 times

ELTYPE =163 Linear form for hyperelastic 20 node HEXAFD

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

5-398 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 027 times

ELTYPE =164 Hyperelastic quadrilateral 9-noded element (QUADFD) Linear

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 009 times

DMAP Programmer's Guide 5-399


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =165 Hyperelastic 5-sided 15-noded solid element (PENTAFD) Linear

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 021 times

ELTYPE =166 Linear form for hyperelastic 10 node TETRA

2 TYPE CHAR4 Gaus

3 ID I

4 SX RS

5-400 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 SXY RS

6 PA RS

7 AX RS

8 AY RS

9 AZ RS

10 PRESSURE RS

11 SY RS

12 SYZ RS

13 PB RS

14 BX RS

15 BY RS

16 BZ RS

17 SZ RS

18 SZX RS

19 PC RS

20 CX RS

21 CY RS

22 CZ RS

Words 3 through 22 repeat 005 times

ELTYPE =167 Linear form for hyperelastic 6 node TRIA (plane strain)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

DMAP Programmer's Guide 5-401


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 SMI RS

Words 3 through 9 repeat 003 times

ELTYPE =168 Linear form for hyperelastic 3 node TRIA (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 001 times

ELTYPE =169 Linear form for hyperelastic 6 node TRIA (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 003 times

Word Name Type Description

ELTYPE =170 Linear form for hyperelastic 4 node QUAD (axisymm)

2 TYPE CHAR4

3 ID I

5-402 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 004 times

ELTYPE =171 Linear form for hyperelastic 9 node QUAD (axisymm)

2 TYPE CHAR4

3 ID I

4 SX RS

5 SY RS

6 SXY RS

7 ANGLE RS

8 SMJ RS

9 SMI RS

Words 3 through 9 repeat 009 times

Word Name Type Description

ELTYPE =189 Quadrilateral plate view element (VUQUAD)

SCODE,6 =0 Strain

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-403


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 VUID I VU grid identification number this corner

8 UNDEF(2 ) None

10 MSXR RS Membrane strain x RM

11 MSYR RS Membrane strain y RM

12 MXYR RS Membrane strain xy RM

13 UNDEF(3 ) None

16 BCXR RS Bending curvature x RM

17 BCYR RS Bending curvature y RM

18 BCXYR RS Bending curvature xy RM

19 TYZR RS Shear yz RM

20 TZXR RS Shear zx RM

21 UNDEF None

22 MSXI RS Membrane strain x IP

23 MSYI RS Membrane strain y IP

24 MXYI RS Membrane strain xy IP

25 UNDEF(3 ) None

28 BCXI RS Bending curvature x IP

29 BCYI RS Bending curvature y IP

30 BCXYI RS Bending curvature xy IP

31 TYZI RS Shear yz IP

32 TZXI RS Shear zx IP

33 UNDEF None

Words 7 through 33 repeat 004 times

End TCODE,7

SCODE,6 =01 Stress

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

5-404 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1R RS Normal x rm at Z1

11 NX1I RS Normal x ip at Z1

12 NY1R RS Normal y rm at Z1

13 NY1I RS Normal y ip at Z1

14 TXY1R RS Shear xy rm at Z1

15 TXY1I RS Shear xy ip at Z1

16 NZ1R RS Normal z rm at Z1 or n/a

17 NZ1I RS Normal z ip at Z1 or n/a

18 TYZ1R RS Shear yz rm at Z1 or n/a

19 TYZ1I RS Shear yz ip at Z1 or n/a

20 TZX1R RS Shear zx rm at Z1 or n/a

21 TZX1I RS Shear zx ip at Z1 or n/a

22 NX2R RS Normal x rm at Z2

23 NX2I RS Normal x ip at Z2

24 NY2R RS Normal y rm at Z2

25 NY2I RS Normal y ip at Z2

26 TXY2R RS Shear xy rm at Z2

27 TXY2I RS Shear xy ip at Z2

28 NZ1R RS Normal z rm at Z1 or n/a

29 NZ1I RS Normal z ip at Z1 or n/a

DMAP Programmer's Guide 5-405


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

30 TYZ1R RS Shear yz rm at Z1 or n/a

31 TYZ1I RS Shear yz ip at Z1 or n/a

32 TZX1R RS Shear zx rm at Z1 or n/a

33 TZX1I RS Shear zx ip at Z1 or n/a

Words 7 through 33 repeat 004 times

End TCODE,7

End SCODE,6

Word Name Type Description

ELTYPE =190 Triangular shell view element (VUTRIA)

SCODE,6 =0 Strain

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number this corner

8 UNDEF(2 ) None

10 MSXR RS Membrane strain x RM

11 MSYR RS Membrane strain y RM

12 MXYR RS Membrane strain xy RM

13 UNDEF(3 ) None

16 BCXR RS Bending curvature x RM

17 BCYR RS Bending curvature y RM

18 BCXYR RS Bending curvature xy RM

19 TYZR RS Shear yz RM

5-406 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

20 TZXR RS Shear zx RM

21 UNDEF None

22 MSXI RS Membrane strain x IP

23 MSYI RS Membrane strain y IP

24 MXYI RS Membrane strain xy IP

25 UNDEF(3 ) None

28 BCXI RS Bending curvature x IP

29 BCYI RS Bending curvature y IP

30 BCXYI RS Bending curvature xy IP

31 TYZI RS Shear yz IP

32 TZXI RS Shear zx IP

33 UNDEF None

Words 7 through 33 repeat 003 times

End TCODE,7

SCODE,6 =01 Stress

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1R RS Normal x rm at Z1

11 NX1I RS Normal x ip at Z1

12 NY1R RS Normal y rm at Z1

DMAP Programmer's Guide 5-407


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 NY1I RS Normal y ip at Z1

14 TXY1R RS Shear xy rm at Z1

15 TXY1I RS Shear xy ip at Z1

16 NZ1R RS Normal z rm at Z1 or n/a

17 NZ1I RS Normal z ip at Z1 or n/a

18 TYZ1R RS Shear yz rm at Z1 or n/a

19 TYZ1I RS Shear yz ip at Z1 or n/a

20 TZX1R RS Shear zx rm at Z1 or n/a

21 TZX1I RS Shear zx ip at Z1 or n/a

22 NX2R RS Normal x rm at Z2

23 NX2I RS Normal x ip at Z2

24 NY2R RS Normal y rm at Z2

25 NY2I RS Normal y ip at Z2

26 TXY2R RS Shear xy rm at Z2

27 TXY2I RS Shear xy ip at Z2

28 NZ1R RS Normal z rm at Z1 or n/a

29 NZ1I RS Normal z ip at Z1 or n/a

30 TYZ1R RS Shear yz rm at Z1 or n/a

31 TYZ1I RS Shear yz ip at Z1 or n/a

32 TZX1R RS Shear zx rm at Z1 or n/a

33 TZX1I RS Shear zx ip at Z1 or n/a

Words 7 through 33 repeat 003 times

End TCODE,7

End SCODE,6

ELTYPE =191 Beam view element (VUBEAM)

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

5-408 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

4 ICORD CHAR4 ICORD flat/curved and so on

TCODE,7 =1 Real / Imaginary

5 VUGRID I VU grid ID for output grid

6 POSIT RS x/L position of VU grid identification number

7 POS(3) RS Y, Z, W coordinate of output point

10 NXR RS Normal x RM

11 NXI RS Normal x IP

12 TXYR RS Shear xy RM

13 TXYI RS Shear xy IP

14 TZXR RS Shear zx RM

15 TZXI RS Shear zx IP

Words 7 through 15 repeat 4 times

Words 5 through 15 repeat 2 times

End TCODE,7

ELTYPE =192 CVINT

2 UNDEF None

ELTYPE =193 QUADFR

2 UNDEF None

ELTYPE =194 TRIAFR

2 UNDEF None

ELTYPE =195 LINEFR

2 UNDEF None

ELTYPE =196 LINXFR

2 UNDEF None

ELTYPE =197 GMINTS

2 UNDEF None

ELTYPE =198 CNVPEL

DMAP Programmer's Guide 5-409


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =199 VUHBDY

2 UNDEF None

Word Name Type Description

ELTYPE =200 CWELD

2 UNDEF None

ELTYPE =201 Hyperelastic quadrilateral 4-noded, nonlinear format (QUAD4FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =202 Hyperelastic hexahedron 8-noded, nonlinear format (HEXA8FD)

2 TYPE CHAR4 Grid or Gaus

3 ID I

4 SX RS

5 SY RS

6 SZ RS

5-410 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 008 times

ELTYPE =203 Slideline contact (SLIF1D)

2 REGIONID I Contact region identification number

3 MGRID1 I Master grid 1

4 MGRID2 I Master grid 2

5 SCOORD RS Surface coordinate

6 F RS Normal force

7 S RS Shear force

8 SIGMA RS Normal stress

9 TAU RS Shear stress

10 NGAP RS Normal gap

11 SLIP RS Slip

12 SLIPRAT RS Slip ratio

13 SLIPCODE(2) CHAR4 Slip code

ELTYPE =204 Hyperelastic pentahedron 6-noded, nonlinear format


(PENTA6FD)

DMAP Programmer's Guide 5-411


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TYPE CHAR4 Grid or Gaus

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 006 times

ELTYPE =205 Hyperelastic tetrahedron 4-noded, nonlinear format (TETRA4FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

5-412 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 001 times

ELTYPE =206 Hyperelastic triangular 3-noded, nonlinear format (TRIA3FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 001 times

ELTYPE =207 Hyperelastic hexahedron 20-noded, nonlinear format (HEXAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

DMAP Programmer's Guide 5-413


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 027 times

ELTYPE =208 Hyperelastic quadrilateral 8-noded, nonlinear format (QUADFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 009 times

5-414 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =209 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 021 times

Word Name Type Description

ELTYPE =210 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

DMAP Programmer's Guide 5-415


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 005 times

ELTYPE =211 Hyperelastic triangular 6-noded, nonlinear format (TRIAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

5-416 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =212 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 001 times

ELTYPE =213 Hyperelastic axi. triangular 6-noded nonlinear format (TRIAXFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

DMAP Programmer's Guide 5-417


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =214 Hyperelastic axi. quadrilateral 4-noded nonlinear


format(QUADX4FD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =215 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 TYPE CHAR4 GAUS

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

5-418 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 009 times

ELTYPE =216 Hyperelastic tetrahedron 4-noded nonlinear format (TETRA4FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 004 times

ELTYPE =217 Hyperelastic triangular 3-noded nonlinear format (TRIA3FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

DMAP Programmer's Guide 5-419


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =218 Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

5-420 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 3 through 17 repeat 008 times

ELTYPE =219 Hyperelastic quadrilateral 8-noded nonlinear format (QUADFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

Word Name Type Description

ELTYPE =220 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

DMAP Programmer's Guide 5-421


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 006 times

ELTYPE =221 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 SYZ RS

9 SZX RS

10 PRESSURE RS

11 VOLSTR RS

12 EX RS

13 EY RS

14 EZ RS

15 EXY RS

16 EYZ RS

17 EZX RS

Words 3 through 17 repeat 004 times

5-422 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =222 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 003 times

ELTYPE =223 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 TYPE CHAR4 GRID

3 ID I

4 SX RS

5 SY RS

6 SZ RS

7 SXY RS

8 PRESSURE RS

9 VOLSTR RS

10 EX RS

11 EY RS

DMAP Programmer's Guide 5-423


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

12 EZ RS

13 EXY RS

Words 3 through 13 repeat 004 times

ELTYPE =224 Nonlinear ELAS1

2 F RS Force

3 S RS Stress

ELTYPE =225 Nonlinear ELAS3

2 F RS Force

3 S RS Stress

ELTYPE =226 Nonlinear BUSH

2 FX RS Force X

3 FY RS Force Y

4 FZ RS Force Z

5 STX RS Stress Translational X

6 STY RS Stress Translational Y

7 STZ RS Stress Translational Z

8 ETX RS Strain Rotational X

9 ETY RS Strain Rotational Y

10 ETZ RS Strain Rotational Z

11 MX RS Moment X

12 MY RS Moment Y

13 MZ RS Moment Z

14 SRX RS Stress Rotational X

15 SRY RS Stress Rotational Y

16 SRZ RS Stress Rotational Z

17 ERX RS Strain Rotational X

18 ERY RS Strain Rotational Y

5-424 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

19 ERZ RS Strain Rotational Z

ELTYPE =227 Triangular shell element (CTRIAR)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2R RS Normal in x at Z2

12 EX2I RS Normal in x at Z2

13 EY2R RS Normal in y at Z2

14 EY2I RS Normal in y at Z2

15 EXY2R RS Shear in xy at Z2

16 EXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

DMAP Programmer's Guide 5-425


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2R RS Normal in x at Z2

12 SX2I RS Normal in x at Z2

13 SY2R RS Normal in y at Z2

14 SY2I RS Normal in y at Z2

15 TXY2R RS Shear in xy at Z2

16 TXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

End SCODE,6

ELTYPE =228 Quadrilateral plate element (CQUADR)

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 EX1R RS Normal in x at Z1

4 EX1I RS Normal in x at Z1

5 EY1R RS Normal in y at Z1

6 EY1I RS Normal in y at Z1

7 EXY1R RS Shear in xy at Z1

8 EXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 EX2R RS Normal in x at Z2

5-426 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

12 EX2I RS Normal in x at Z2

13 EY2R RS Normal in y at Z2

14 EY2I RS Normal in y at Z2

15 EXY2R RS Shear in xy at Z2

16 EXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 VM1 RS von Mises at Z1

10 FD2 RS Z2 = Fibre Distance

11 SX2R RS Normal in x at Z2

12 SX2I RS Normal in x at Z2

13 SY2R RS Normal in y at Z2

14 SY2I RS Normal in y at Z2

15 TXY2R RS Shear in xy at Z2

16 TXY2I RS Shear in xy at Z2

17 VM2 RS von Mises at Z2

End TCODE,7

End SCODE,6

DMAP Programmer's Guide 5-427


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =232 QUADR composite

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

5-428 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

DMAP Programmer's Guide 5-429


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =233 TRIAR composite (Same as TRIAR composite)

SCODE,6 =0 Strain

TCODE,7 =0 Real

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 A1 RS Shear angle

9 EMJRP1 RS Major Principal

10 EMNRP1 RS Minor Principal

11 ETMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 EX1 RS Normal-1

4 EY1 RS Normal-2

5 ET1 RS Shear-12

6 EL1 RS Shear-1Z

7 EL2 RS Shear-2Z

8 EX1I RS Normal-1

9 EY1I RS Normal-2

10 ET1I RS Shear-12

11 EL1I RS Shear-1Z

12 EL2I RS Shear-2Z

13 EVM RS von Mises

End TCODE,7

5-430 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

SCODE,6 =01 Stress

TCODE,7 =0 Real

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 A1 RS Shear angle

9 MJRP1 RS Major Principal

10 MNRP1 RS Minor Principal

11 TMAX1 RS von Mises or Maximum shear

TCODE,7 =1 Real/imaginary

2 PLY I Lamina Number

3 SX1 RS Normal-1

4 SY1 RS Normal-2

5 T1 RS Shear-12

6 SL1 RS Shear-1Z

7 SL2 RS Shear-2Z

8 SX1I RS Normal-1

9 SY1I RS Normal-12

10 T1I RS Shear-12

11 SL1I RS Shear-1Z

12 SL2I RS Shear-2Z

13 SVM RS von Mises

End TCODE,7

End SCODE,6

DMAP Programmer's Guide 5-431


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =240 CTRIA6 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

5-432 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Words 3 through 27 process 4 times

Word Name Type Description

ELTYPE =241 CQUAD8 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

DMAP Programmer's Guide 5-433


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

Words 3 through 27 process 5 times

ELTYPE =242 Axisymmetric triangular element (CTRAX3) – Linear


Stress/Strain - Center and corners

TCODE,7 =1 Real / Imaginary

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SXR RS Normal stress in X – Real part

5 SXI RS Normal stress in X – Imaginary part

6 SYR RS Normal stress in Y – Real part

7 SYI RS Normal stress in Y – Imaginary part

8 SZR RS Normal stress in Z – Real part

9 SZI RS Normal stress in Z – Imaginary part

10 SPR RS In-plane shear stress – Real part

11 SPI RS In-plane shear stress – Imaginary part

12 VM RS von Mises stress

Words 3 through 12 process 4 times

End TCODE,7

ELTYPE =243 Axisymmetric quad element (CQUADX4) – Linear Stress/Strain -


Center and corners

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5-434 DMAP Programmer's Guide


Data Block Descriptions O-V

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 VM RS von Mises stress

Words 2 through 11 process 5 times

End TCODE,7

ELTYPE =244 Axisymmetric triangle element (CTRAX6) – Linear Stress/Strain


- Center and corners

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 VM RS von Mises stress

Words 2 through 11 process 4 times

End TCODE,7

ELTYPE =245 Axisymmetric quad element (CQUADX8) – Linear Stress/Strain -


Center and corners

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-435


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 VM RS von Mises stress

Words 2 through 11 process 5 times

End TCODE,7

ELTYPE =246 Axisymmetric triangle element (CTRAX3) – Nonlinear


Stress/Strain - Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

5-436 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 14 process 4 times

ELTYPE =247 Axisymmetric quad element (CQUADX4) – Nonlinear Stress/Strain


- Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

Words 3 through 14 process 5 times

ELTYPE =248 Axisymmetric triangle element (CTRAX6) – Nonlinear


Stress/Strain - Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

DMAP Programmer's Guide 5-437


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 SE RS In-plane shear strain

Words 3 through 14 process 4 times

ELTYPE =249 Axisymmetric quad element (CQUADX8) – Nonlinear Stress/Strain


- Center and corners

2 CTYPE CHAR4 Coordinate Type (GRID)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 ES RS Equivalent Stress

9 EPS RS Effective Plastic Strain

10 ECS RS Effective Creep Strain

11 EX RS Normal strain in X

12 EY RS Normal strain in Y

13 EZ RS Normal strain in Z

14 EP RS In-plane shear strain

Words 3 through 14 process 5 times

ELTYPE =250 Axisymmetric triangle element (CTRAX3) – Linear form of


hyperelastic – Gauss Location

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5-438 DMAP Programmer's Guide


Data Block Descriptions O-V

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 3 times

ELTYPE =251 Axisymmetric quad element (CQUADX4) – Linear form of


hyperelastic – Gauss Locations

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 4 times

ELTYPE =252 Axisymmetric triangle element (CTRAX6) – Linear form of


hyperelastic – Gauss Locations

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 3 times

ELTYPE =253 Axisymmetric quad element (CQUADX8) – Linear form of


hyperelastic – Gauss Locations

DMAP Programmer's Guide 5-439


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 SMJ RS Major Principle

8 SMI RS Minor Principle

Words 3 through 8 process 9 times

Word Name Type Description

ELTYPE =254 CQUAD4 - Nonlinear - Center and corners

2 TERM CHAR4 “CEN”

3 GRID ID I 0 for center

4 FD1 RS Z1 = Fiber distance

5 SX1 RS Stress in x at Z1

6 SY1 RS Stress in y at Z1

7 SZ1 RS Stress in z at Z1

8 TXY1 RS Shear stress in xy at Z1

9 ES RS Equivalent stress at Z1

10 EPS1 RS Effective plastic/inelastic strain at Z1

11 ECS1 RS Effective creep strain at Z1

12 EX1 RS Strain in x at Z1

13 EY1 RS Strain in y at Z1

14 EZ1 None Strain in z at Z1

15 ETXY1 RS Shear strain in xy at Z1

16 FD2 RS Z2 = Fiber distance

17 SX2 RS Stress in x at Z2

18 SY2 RS Stress in y at Z2

5-440 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

19 SZ2 None Stress in z at Z2

20 TXY2 RS Shear stress in xy at Z2

21 ES2 RS Equivalent stress at Z2

22 EPS2 RS Effective plastic/inelastic strain at Z2

23 ECS2 RS Effective creep strain at Z2

24 EX2 RS Strain in x at Z2

25 EY2 RS Strain in y at Z2

26 EZ2 None Strain in z at Z2

27 ETXY2 RS Shear strain in xy at Z2

Words 3 through 27 process 5 times

ELTYPE = 255 CPYRAM – Linear Strain/Stress

SCODE,6 =0 Strain

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid ID (0=center)

6 EXR RS Normal in x

7 EYR RS Normal in y

8 EZR RS Normal in z

9 ETXYR RS Shear in xy

10 ETYZR RS Shear in yz

11 ETZXR RS Shear in zx

12 EXI RS Normal in x

13 EYI RS Normal in y

14 EZI RS Normal in z

DMAP Programmer's Guide 5-441


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

15 ETXYI RS Shear in xy

16 ETYZI RS Shear in yz

17 ETZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 process 6 times

End TCODE,7

SCODE,6 =01 Stress

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

18 VM RS von Mises

Words 5 through 18 process 6 times

End TCODE,7

End SCODE,6

5-442 DMAP Programmer's Guide


Data Block Descriptions O-V

ELTYPE =256 CPYRAM - Nonlinear

2 CTYPE CHAR4 GRID or GAUSS

3 GRID I 0 for center

4 SX RS Stress in x

5 SY RS Stress in y

6 SZ RS Stress in z

7 SXY RS Stress in xy

8 SYZ RS Stress in yz

9 SZX RS Stress in zx

10 SE RS Equivalent stress

11 EPS RS Effective plastic strain

12 ECS RS Effective creep strain

13 EX RS Strain in x

14 EY RS Strain in y

15 EZ RS Strain in z

16 EXY RS Strain in xy

17 EYZ RS Strain in yz

18 EZX RS Strain in zx

Words 3 through 18 process 6 times

ELTYPE =257 CPYRAM (linear element, 5 grids) – Hyperelastic nonlinear


format

2 CTYPE CHAR4 GRID

3 ID I Grid ID

4 SX RS Stress in X

5 SY RS Stress in Y

6 SZ RS Stress in Z

7 SXY RS Stress in XY

DMAP Programmer's Guide 5-443


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 SYZ RS Stress in YZ

9 SZX RS Stress in ZX

10 PRESSURE RS Pressure

11 VOLSTR RS Volumetric Strain

12 EX RS Strain in X

13 EY RS Strain in Y

14 EZ RS Strain in Z

15 EXY RS Strain in XY

16 EYZ RS Strain in YZ

17 EZX RS Strain in ZX

Words 3 through 17 process 5 times

ELTYPE =258 CPYRAM (parabolic element, 13 grids) – Hyperelastic nonlinear


format

2 TYPE CHAR4 GRID

3 ID I Grid ID

4 SX RS Stress in X

5 SY RS Stress in Y

6 SZ RS Stress in Z

7 SXY RS Stress in XY

8 SYZ RS Stress in YZ

9 SZX RS Stress in ZX

10 PRESSURE RS Pressure

11 VOLSTR RS Volumetric Strain

12 EX RS Strain in X

13 EY RS Strain in Y

14 EZ RS Strain in Z

15 EXY RS Strain in XY

5-444 DMAP Programmer's Guide


Data Block Descriptions O-V

16 EYZ RS Strain in YZ

17 EZX RS Strain in ZX

Words 3 through 17 process 5 times

ELTYPE =259 Reserved for hyperelastic PYRAM 5-noded, linear form.

ELTYPE =260 Reserved for hyperelastic PYRAM 13-noded, linear form.

ELTYPE =261 Axisymmetric triangle element (CTRAX3) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 3 times

ELTYPE =262 Axisymmetric quad element (CQUADX4) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

DMAP Programmer's Guide 5-445


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 4 times

ELTYPE =263 Axisymmetric triangle element (CTRAX6) – Nonlinear form of


hyperelastic

2 TYPE CHAR4 GAUS or GRID

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 3 times

ELTYPE =264 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – Grid Locations

2 TYPE CHAR4 GRID

5-446 DMAP Programmer's Guide


Data Block Descriptions O-V

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 4 times

ELTYPE =266 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – 9 Gauss Locations

2 TYPE CHAR4 GAUS

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 PRESSURE RS Pressure

9 VOLSTR RS Volumetric Strain

10 EX RS Normal strain in X

11 EY RS Normal strain in Y

12 EZ RS Normal strain in Z

13 EP RS In-plane shear strain

Words 3 through 13 process 9 times

DMAP Programmer's Guide 5-447


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =269 Composite HEXA element (CHEXAL)

2 PLY I Lamina number

SCODE,6=0 Strain

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 4 through 11 repeat 5 times.

TCODE,7 =1 Real/imaginary

5-448 DMAP Programmer's Guide


Data Block Descriptions O-V

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

17 EVM RS von Mises

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

DMAP Programmer's Guide 5-449


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

17 EVM RS von Mises

For each fiber location requested (PLSLOC), words 4 through 17 repeat 5 times.

End TCODE,7

SCODE,6=1 Stress

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

5-450 DMAP Programmer's Guide


Data Block Descriptions O-V

For each fiber location requested (PLSLOC), words 4 through 11 repeat 5 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

17 SVM RS von Mises

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

DMAP Programmer's Guide 5-451


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

17 SVM RS von Mises

For each fiber location requested (PLSLOC), words 3 through 15 repeat 5 times.

End TCODE,7

End SCODE,6

ELTYPE =270 Composite PENTA element (CPENTAL)

2 PLY I Lamina number

SCODE,6=0 Strain

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 EX1 RS Normal strain in the 1-direction

5-452 DMAP Programmer's Guide


Data Block Descriptions O-V

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 4 through 11 repeat 4 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

17 EVM RS von Mises

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 EX1 RS Normal strain in the 1-direction

DMAP Programmer's Guide 5-453


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 EY1 RS Normal strain in the 2-direction

7 ET1 RS Shear strain in the 12-plane

8 EZ1 RS Normal strain in the 3-direction

9 EL1 RS Shear strain in the 13-plane

10 EL2 RS Shear strain in the 23-plane

11 EX1I RS Normal strain in the 1-direction

12 EY1I RS Normal strain in the 2-direction

13 ET1I RS Shear strain in the 12-plane

14 EZ1I RS Normal strain in the 3-direction

15 EL1I RS Shear strain in the 13-plane

16 EL2I RS Shear strain in the 23-plane

17 EVM RS von Mises

For each fiber location requested (PLSLOC), words 4 through 17 repeat 4 times.

End TCODE,7

SCODE,6=1 Stress

TCODE,7 =0 Real

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

5-454 DMAP Programmer's Guide


Data Block Descriptions O-V

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 4 through 11 repeat 4 times.

TCODE,7 =1 Real/imaginary

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

17 SVM RS von Mises

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

DMAP Programmer's Guide 5-455


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 GRID I Edge grid ID (Center = 0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 SX1I RS Normal stress in the 1-direction

12 SY1I RS Normal stress in the 2-direction

13 ST1I RS Shear stress in the 12-plane

14 SZ1I RS Normal stress in the 3-direction

15 SL1I RS Shear stress in the 13-plane

16 SL2I RS Shear stress in the 23-plane

17 SVM RS von Mises

For each fiber location requested (PLSLOC), words 4 through 17 repeat 4 times.

End TCODE,7

End SCODE,6

ELTYPE =271 Triangle plane strain (CPLSTN3) – Center

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 EXR RS Normal strain in x – real part

3 EXI RS Normal strain in x – imaginary part

4 EYR RS Normal strain in y – real part

5 EYI RS Normal strain in y – imaginary part

6 EZR RS Normal strain in z – real part

7 EZI RS Normal strain in z – imaginary part

8 EPR RS In-plane shear strain – real part

5-456 DMAP Programmer's Guide


Data Block Descriptions O-V

9 EPI RS In-plane shear strain – imaginary part

10 VM RS von Mises strain

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

10 VM RS von Mises stress

End TCODE,7

End SCODE,6

ELTYPE =272 Quadrilateral plane strain (CPLSTN4) – Center and Corners

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

DMAP Programmer's Guide 5-457


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

Words 3 through 12 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =273 Triangle plane strain (CPLSTN6 ) – Center and Corners

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5-458 DMAP Programmer's Guide


Data Block Descriptions O-V

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 4 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

Words 3 through 12 repeat 4 times

End TCODE,7

End SCODE,6

ELTYPE =274 Quadrilateral plane strain (CPLSTN8) – Center and Corners

DMAP Programmer's Guide 5-459


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

5-460 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 12 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =275 Triangle plane stress (CPLSTS3) – Center

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 EXR RS Normal strain in x – real part

3 EXI RS Normal strain in x – imaginary part

4 EYR RS Normal strain in y – real part

5 EYI RS Normal strain in y – imaginary part

6 EZR RS Normal strain in z – real part

7 EZI RS Normal strain in z – imaginary part

8 EPR RS In-plane shear strain – real part

9 EPI RS In-plane shear strain – imaginary part

10 VM RS von Mises strain

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

10 VM RS von Mises stress

DMAP Programmer's Guide 5-461


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

End TCODE,7

End SCODE,6

ELTYPE =276 Quadrilateral plane stress (CPLSTS4) – Center and Corners

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 5 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

5-462 DMAP Programmer's Guide


Data Block Descriptions O-V

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

Words 3 through 12 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =277 Triangle plane stress (CPLSTS6) – Center and Corners

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 4 times

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

DMAP Programmer's Guide 5-463


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

Words 3 through 12 repeat 4 times

End TCODE,7

End SCODE,6

ELTYPE =278 Quadrilateral plane stress (CPLSTS8) – Center and Corners

SCODE,6=0 Strain

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 EXR RS Normal strain in x – real part

5 EXI RS Normal strain in x – imaginary part

6 EYR RS Normal strain in y – real part

7 EYI RS Normal strain in y – imaginary part

8 EZR RS Normal strain in z – real part

9 EZI RS Normal strain in z – imaginary part

10 EPR RS In-plane shear strain – real part

11 EPI RS In-plane shear strain – imaginary part

12 VM RS von Mises strain

Words 3 through 12 repeat 5 times

5-464 DMAP Programmer's Guide


Data Block Descriptions O-V

End TCODE,7

SCODE,6=1 Stress

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 VM RS von Mises stress

Words 3 through 12 repeat 5 times

End TCODE,7

End SCODE,6

ELTYPE =281 Triangle plane strain (CPLSTN3) – Nonlinear format – Center

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SXZ RS Shear stress in xz

6 ES RS Equivalent stress

7 EPS RS Effective plastic/inelastic strain

8 ECS RS Effective creep strain

9 EX RS Strain in x

10 EY RS Strain in y

DMAP Programmer's Guide 5-465


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

11 EZ RS Strain in z

12 ETXZ RS Shear strain in xz

ELTYPE =283 Triangle plane strain (CPLSTN6) – Nonlinear format – Center and
Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 4 times

ELTYPE =284 Quadrilateral plane strain (CPLSTN8) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

5-466 DMAP Programmer's Guide


Data Block Descriptions O-V

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =285 Triangle plane stress (CPLSTS3) – Nonlinear format – Center

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SXZ RS Shear stress in xz

6 ES RS Equivalent stress

7 EPS RS Effective plastic/inelastic strain

8 ECS RS Effective creep strain

9 EX RS Strain in x

10 EY RS Strain in y

11 EZ RS Strain in z

12 ETXZ RS Shear strain in xz

ELTYPE =287 Triangle plane stress (CPLSTS6) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

DMAP Programmer's Guide 5-467


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 4 times

ELTYPE =288 Quadrilateral plane stress (CPLSTS8) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =289 Quadrilateral plane strain (CPLSTN4) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

5-468 DMAP Programmer's Guide


Data Block Descriptions O-V

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =290 Quadrilateral plane stress (CPLSTS4) – Nonlinear format – Center


and Corners

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 ES RS Equivalent stress

9 EPS RS Effective plastic/inelastic strain

10 ECS RS Effective creep strain

11 EX RS Strain in x

12 EY RS Strain in y

13 EZ RS Strain in z

DMAP Programmer's Guide 5-469


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

14 ETXZ RS Shear strain in xz

Words 3 through 14 repeat 5 times

ELTYPE =291 Triangle plane strain (CPLSTN3) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =292 Quadrilateral plane strain (CPLSTN4) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

5-470 DMAP Programmer's Guide


Data Block Descriptions O-V

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =293 Triangle plane strain (CPLSTN6) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =294 Quadrilateral plane strain (CPLSTN8) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

DMAP Programmer's Guide 5-471


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =295 Triangle plane stress (CPLSTS3) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =296 Quadrilateral plane stress (CPLSTS4) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

5-472 DMAP Programmer's Guide


Data Block Descriptions O-V

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =297 Triangle plane stress (CPLSTS6) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 3 times

ELTYPE =298 Quadrilateral plane stress (CPLSTS8) – Hyperelastic - Grid

2 TERM CHAR4 “GRID”

3 ID I Point ID

4 SX RS Normal stress in x

DMAP Programmer's Guide 5-473


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SXZ RS Shear stress in xz

8 PRESSURE RS Pressure

9 VOLSTR RS Volume strain

10 EX RS Strain in x

11 EY RS Strain in y

12 EZ RS Strain in z

13 ETXZ RS Shear strain in xz

Words 3 through 13 repeat 4 times

ELTYPE =300 HEXA element (CHEXA)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 8 times.

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

5-474 DMAP Programmer's Guide


Data Block Descriptions O-V

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 8 times.

End SCODE,6

ELTYPE =301 PENTA element (CPENTA )

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 6 times.

SCODE,6=1 Stress

TCODE,7=0 Real

DMAP Programmer's Guide 5-475


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 6 times.

End SCODE,6

ELTYPE =302 TETRA element (CTETRA)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 4 times.

SCODE,6=1 Stress

5-476 DMAP Programmer's Guide


Data Block Descriptions O-V

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 4 times.

End SCODE,6

ELTYPE =303 PYRAM element (CPYRAM)

SCODE,6=0 Strain

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 5 times.

DMAP Programmer's Guide 5-477


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

SCODE,6=1 Stress

TCODE,7=0 Real

2 CID I Coordinate System

3 CTYPE CHAR4 Grid or Gaus

4 GRID I Corner grid ID

5 EX RS Strain in X

6 EY RS Strain in Y

7 EZ RS Strain in Z

8 EXY RS Strain in XY

9 EYZ RS Strain in YZ

10 EZX RS Strain in ZX

11 EVM RS Von Mises strain

Words 4 through 11 repeat 5 times.

End SCODE,6

ELTYPE =304 Linear composite HEXA element (CHEXAL)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

5-478 DMAP Programmer's Guide


Data Block Descriptions O-V

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =305 Linear composite PENTA element (CPENTAL)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

DMAP Programmer's Guide 5-479


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =306 Nonlinear composite HEXA element (CHEXALN)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

5-480 DMAP Programmer's Guide


Data Block Descriptions O-V

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =307 Nonlinear composite PENTA element (CPENTALN)

1 PLY I Lamina number

SCODE,6=0 Strain

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

3 GRID I Edge grid ID (center=0)

4 EX1 RS Normal strain in the 1-direction

5 EY1 RS Normal strain in the 2-direction

6 ET1 RS Shear strain in the 12-plane

7 EZ1 RS Normal strain in the 3-direction

8 EL1 RS Shear strain in the 13-plane

9 EL2 RS Shear strain in the 23-plane

10 ETMAX1 RS Von Mises strain

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

2 FLOC CHAR4 Fiber location (BOT, MID, TOP)

DMAP Programmer's Guide 5-481


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

3 GRID I Edge grid ID (center=0)

4 SX1 RS Normal stress in the 1-direction

5 SY1 RS Normal stress in the 2-direction

6 ST1 RS Shear stress in the 12-plane

7 SZ1 RS Normal stress in the 3-direction

8 SL1 RS Shear stress in the 13-plane

9 SL2 RS Shear stress in the 23-plane

10 STMAX1 RS Von Mises stress

For each fiber location requested (PLSLOC), words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =312 Axisymmetric TRIA element (TRAX3)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

5-482 DMAP Programmer's Guide


Data Block Descriptions O-V

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =313 Axisymmetric QUAD element (QUADX4)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

DMAP Programmer's Guide 5-483


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =314 Axisymmetric TRIA element (TRAX6)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 6 times.

SCODE,6=1 Stress

5-484 DMAP Programmer's Guide


Data Block Descriptions O-V

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 6 times.

End SCODE,6

ELTYPE =315 Axisymmetric QUAD element (QUADX8)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 8 times.

DMAP Programmer's Guide 5-485


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 8 times.

End SCODE,6

ELTYPE =316 Plane strain TRIA element (PLSTN3)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

5-486 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =317 Plane strain QUAD element (PLSTN4)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

DMAP Programmer's Guide 5-487


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =318 Plane strain TRIA element (PLSTN6)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

5-488 DMAP Programmer's Guide


Data Block Descriptions O-V

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 6 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 6 times.

End SCODE,6

ELTYPE =319 Plane strain QUAD element (PLSTN8)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

DMAP Programmer's Guide 5-489


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 8 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 8 times.

End SCODE,6

ELTYPE =320 Plane stress TRIA element (PLSTS3)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

5-490 DMAP Programmer's Guide


Data Block Descriptions O-V

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =321 Plane stress QUAD element (PLSTS4)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

DMAP Programmer's Guide 5-491


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =322 Plane stress TRIA element (PLSTS6)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5-492 DMAP Programmer's Guide


Data Block Descriptions O-V

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 6 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 6 times.

End SCODE,6

ELTYPE =323 Plane stress QUAD element (PLSTS8)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

DMAP Programmer's Guide 5-493


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 8 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 8 times.

End SCODE,6

ELTYPE =328 Generalized plane strain TRIA element (GPLSTN3)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

5-494 DMAP Programmer's Guide


Data Block Descriptions O-V

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 3 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 3 times.

End SCODE,6

ELTYPE =329 Generalized plane strain QUAD element (GPLSTN4)

SCODE,6=0 Strain

TCODE,7=0 Real

1 CID I Coordinate system

DMAP Programmer's Guide 5-495


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 4 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 4 times.

End SCODE,6

ELTYPE =330 Generalized plane strain TRIA element (GPLSTN6)

SCODE,6=0 Strain

TCODE,7=0 Real

5-496 DMAP Programmer's Guide


Data Block Descriptions O-V

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 6 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 6 times.

End SCODE,6

ELTYPE =331 Generalized plane strain QUAD element (GPLSTN8)

SCODE,6=0 Strain

DMAP Programmer's Guide 5-497


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I External grid ID

4 EX RS Normal strain in the X-direction

5 EY RS Normal strain in the Y-direction

6 EZ RS Normal strain in the Z-direction

7 EXY RS Shear strain in the XY-plane

8 EYZ RS Shear strain in the YZ-plane

9 EZX RS Shear strain in the ZX-plane

10 EVM RS Von Mises strain

Words 3 through 10 repeat 8 times.

SCODE,6=1 Stress

TCODE,7=0 Real

1 CID I Coordinate system

2 CTYPE CHAR4 Grid or Gauss

3 GRID I Edge grid ID (center=0)

4 SX RS Normal stress in the X-direction

5 SY RS Normal stress in the Y-direction

6 SZ RS Normal stress in the Z-direction

7 SXY RS Shear stress in the XY-plane

8 SYZ RS Shear stress in the YZ-plane

9 SZX RS Shear stress in the ZX-plane

10 SVM RS Von Mises stress

Words 3 through 10 repeat 8 times.

End SCODE,6

5-498 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End ELTYPE

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

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.16 OESXRMS
Table of element RMS stresses for random analysis that includes von Mises stress output.
For all analysis types (real and complex) and SORT1 and SORT2 formats.

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block Name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record – IDENT
Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 ELTYPE(C) I Element Type

DMAP Programmer's Guide 5-499


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 RANDID I Random identification number

TCODE,1 = 1 Sort 1

ACODE,4 = 05 Frequency

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

End ACODE,4

TCODE,1 = 02 Sort 2

5 LSDVMN I Frequency step

6 UNDEF(2) None

End TCODE,1

8 LOADSET I Random code ID

9 FCODE I Format Code

10 NUMWDE(C) I Number of words per entry in DATA record

11 SCODE I Stress code

12 PID (SOL 601 I Physical Property ID for SOL 601 & 701 only.
and 701 only) UNDEF for all other SOLs

13 ELRESCS I 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 Q4CSTR(C) I Corner Stress Flag

15 PLSLOC(C) I Ply stress location

16 CSOPT I Plane flag for axisymmetric and plane


stress/strain elements

17 RMSSF RS RMS scale factor.

18 VMFLAG I RMS von Mises presence flag (=1 if present)

5-500 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

19 UNDEF(32) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record – DATA

Word Name Type Description

SORTCODE=1 Sort 1 - SortCode=((TCODE/1000)+2)/2

TCODE,1 =1

1 EKEY I Device code + 10*Point identification number

TCODE,1 =02 Sort 2

ACODE/10=01 Analysis type

ACODE,4 =05

1 FREQ RS Frequency

End ACODE,4

End ACODE/10

Word Name Type Description

ELTYPE =00 Grid - OES1G table

2 UNDEF none

ELTYPE =01 Rod element (CROD)

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Real

DMAP Programmer's Guide 5-501


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

ELTYPE =02 Beam element (CBEAM)

TCODE,7=1 Real/Imaginary

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SRCR RS Long. Stress at Point C

5 SXDR RS Long. Stress at Point D

6 SXER RS Long. Stress at Point E

7 SXFR RS Long. Stress at Point F

8 SXCI RS Long. Stress at Point C

9 SXDI RS Long. Stress at Point D

10 SXEI RS Long. Stress at Point E

11 SXFI RS Long. Stress at Point F

Words 2 through 11 repeat 011 times

TCODE,7 =2 Real

2 GRID I External Grid Point identification number

3 SD RS Station Distance/Length

4 SXC RS Long. Stress at Point C

5 SXD RS Long. Stress at Point D

6 SXE RS Long. Stress at Point E

7 SXF RS Long. Stress at Point F

Words 2 through 7 repeat 011 times

End
TCODE,7

ELTYPE=03 Tube element (CTUBE)

5-502 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Real

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

ELTYPE =04 Shear panel element (CSHEAR)

TCODE,7 =1 Real / Imaginary

2 TMAXR RS Maximum Shear

3 TMAXI RS Maximum Shear

4 TAVGR RS Average Shear

5 TAVGI RS Average Shear

TCODE,7 =2 Real

2 TMAX RS Maximum Shear

3 TAVG RS Average Shear

End TCODE,7

ELTYPE =05 FORCE1/FORCE2/MOMENT1/MOMENT2 (follower stiffness)

2 UNDEF None

ELTYPE =06 Unused

2 UNDEF None

ELTYPE =07 PLOAD4 (follower stiffness)

2 UNDEF None

ELTYPE =08 PLOADX1 (follower stiffness)

2 UNDEF None

DMAP Programmer's Guide 5-503


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =09 PLOAD and PLOAD2 (follower stiffness)

2 UNDEF None

Word Name Type Description

ELTYPE =10 Rod element connection and property (CONROD)

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TSR RS Torsional Stress

5 TSI RS Torsional Stress

TCODE,7 =2 Real

2 AS RS Axial Stress

3 TS RS Torsional Stress

End TCODE,7

ELTYPE =11 Scalar spring element (CELAS1)

TCODE,7 =0 Real

2 S RS Stress

TCODE,7 =1 Real / Imaginary

2 SR RS Stress

3 SI RS Stress

End TCODE,7

ELTYPE =12 Scalar spring element with properties (CELAS2)

TCODE,7 =2 Real

2 S RS Stress

TCODE,7 =1 Real/Imaginary

2 SR RS Stress

3 SI RS Stress

5-504 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End TCODE,7

ELTYPE =13 Scalar spring element to scalar points only (CELAS3)

TCODE,7 =2 Real

2 S RS Stress

TCODE,7 =1

2 SR RS Stress

3 SI RS Stress

End TCODE,7

ELTYPE =14 Scalar spring element to scalar points only with properties
(CELAS4)

2 UNDEF None

ELTYPE =15 AEROT3

2 UNDEF None

ELTYPE =16 AEROBEAM

2 UNDEF None

ELTYPE =17 Unused (pre-V69 TRIA2 Same as TRIA1)

2 UNDEF None

ELTYPE =18 Unused (pre-V69 QUAD2 Same as TRIA1)

2 UNDEF None

ELTYPE =19 Unused (pre-V69 QUAD1 Same as TRIA1)

2 UNDEF None

Word Name Type Description

ELTYPE =20 Scalar damper (CDAMP1)

2 UNDEF None

ELTYPE =21 Scalar damper with properties (CDAMP2)

2 UNDEF None

DMAP Programmer's Guide 5-505


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =22 Scalar damper to scalar points only (CDAMP3)

2 UNDEF None

ELTYPE =23 Scalar damper to scalar points only with properties (CDAMP4)

2 UNDEF None

ELTYPE =24 Viscous damper (CVISC)

TCODE,7 =1 Real / Imaginary

2 ASR RS Axial Stress

3 ASI RS Axial Stress

4 TAUR RS Torque

5 TAUI RS Torque

TCODE,7 =2 Real

2 AS RS Axial Stress

3 TAU RS Torque

End TCODE,7

ELTYPE =25 Scalar mass (CMASS1)

2 UNDEF None

ELTYPE =26 Scalar mass with properties (CMASS2)

2 UNDEF None

ELTYPE =27 Scalar mass to scalar points only (CMASS3)

2 UNDEF None

ELTYPE =28 Scalar mass to scalar pts. only with properties (CMASS4)

2 UNDEF None

ELTYPE =29 Concentrated mass element - general form (CONM1)

2 UNDEF None

Word Name Type Description

ELTYPE =30 Concentrated mass element - rigid body form (CONM2)

5-506 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF None

ELTYPE =31 Dummy plot element (PLOTEL)

2 UNDEF None

ELTYPE =32 Unused

2 UNDEF None

ELTYPE =33 Quadrilateral plate element (CQUAD4)

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 RMSVM1R RS RMS von Mises at Z1

10 RMSVM1I RS RMS von Mises at Z1

11 FD2 RS Z2 = Fibre Distance

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

18 RMSVM2R RS RMS von Mises at Z2

19 RMSVM2I RS RMS von Mises at Z2

TCODE,7 =2 Real

DMAP Programmer's Guide 5-507


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 RMSVM1 RS RMS von Mises at Z1

7 FD2 RS Z2 = Fibre Distance

8 SX2 RS Normal in x at Z2

9 SY2 RS Normal in y at Z2

10 TXY2 RS Shear in xy at Z2

11 RMSVM2 RS RMS von Mises at Z2

End TCODE,7

ELTYPE =34 Simple beam element (CBAR and see also ELTYPE=100)

TCODE,7 =1 Real / Imaginary

2 SX1AR RS SA1

3 SX2AR RS SA2

4 SX3AR RS SA3

5 SX4AR RS SA4

6 ASR RS Axial

7 SX1AI RS SA1

8 SX2AI RS SA2

9 SX3AI RS SA3

10 SX4AI RS SA4

11 ASI RS Axial

12 SX1BR RS SB1

13 SX2BR RS SB2

14 SX3BR RS SB3

5-508 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

15 SX4BR RS SB4

16 SX1BI RS SB1

17 SX2BI RS SB2

18 SX3BI RS SB3

19 SX4BI RS SB4

TCODE,7 =2 Real

2 SX1A RS SA1

3 SX2A RS SA2

4 SX3A RS SA3

5 SX4A RS SA4

6 AS RS Axial

7 SX1B RS SB1

8 SX2B RS SB2

9 SX3B RS SB3

10 SX4B RS SB4

End TCODE,7

ELTYPE =35 Axisymmetric shell element (CCONEAX)

2 UNDEF None

ELTYPE =36 Unused (Pre-V69 CTRIARG)

2 UNDEF None

ELTYPE =37 Unused (Pre-V69 CTRAPRG)

2 UNDEF None

ELTYPE =38 Gap element (CGAP)

2 UNDEF None

ELTYPE =39 Tetra

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-509


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 RMSVMR RS RMS von Mises

13 SXI RS Normal in x

14 SYI RS Normal in y

15 SZI RS Normal in z

16 TXYI RS Shear in xy

17 TYZI RS Shear in yz

18 TZXI RS Shear in zx

19 RMSVMI RS RMS von Mises

Words 5 through 19 repeat 005 times

TCODE,7 =2 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

5-510 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

12 RMSVM RS RMS von Mises

Words 5 through 12 repeat 005 times

End TCODE,7

Word Name Type Description

ELTYPE =40 Rod type spring and damper (CBUSH1D)

TCODE,7 =1 Real / Imaginary

2 FER RS Element Force

3 UER RS Axial Displacement

4 ASR RS Axial Stress*

5 AER RS Axial Strain*

6 FEI RS Element Force

7 UEI RS Axial Displacement

8 ASI RS Axial Stress*

9 AEI RS Axial Strain*

TCODE,7 =2 Real

2 FE RS Element Force

3 UE RS Axial Displacement

4 AS RS Axial Stress*

5 AE RS Axial Strain*

End TCODE,7

ELTYPE =41 Unused (Pre-V69 CHEXA1)

2 UNDEF None

ELTYPE =42 Unused (Pre-V69 CHEXA2)

DMAP Programmer's Guide 5-511


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =43 Fluid element with 2 points (CFLUID2)

2 UNDEF None

ELTYPE =44 Fluid element with 3 points (CFLUID3)

2 UNDEF None

ELTYPE =45 Fluid element with 4 points (CFLUID4)

2 UNDEF None

ELTYPE =46 Cflmass

2 UNDEF None

ELTYPE =47 Fluid element with 2 points (CAXIF2)

TCODE,7 =2 Real

2 RA RS Radial Axis

3 AA RS Axial Axis

4 TE RS Tangential Edge

5 CE RS Circumferential Edge

TCODE,7 =1 Real / Imaginary

2 RAR RS Radial Axis

3 AAR RS Axial Axis

4 TER RS Tangential Edge

5 CER RS Circumferential Edge

6 RAI RS Radial Axis

7 AAI RS Axial Axis

8 TEI RS Tangential Edge

9 CEI RS Circumferential Edge

End TCODE,7

ELTYPE =48 Fluid element with 3 points (CAXIF3)

TCODE,7 =2 Real

5-512 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 RC RS Radial centroid

3 CC RS Circumferential centroid

4 AC RS Axial centroid

5 TE1 RS Tangential edge 1

6 CE1 RS Circumferential edge 1

7 TE2 RS Tangential edge 2

8 CE2 RS Circumferential edge 2

9 TE3 RS Tangential edge 3

10 CE3 RS Circumferential edge 3

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

10 CE3R RS Circumferential edge 3

11 RCI RS Radial centroid

12 CCI RS Circumferential centroid

13 ACR RS Axial centroid

14 TE1I RS Tangential edge 1

15 CE1I RS Circumferential edge 1

16 TE2I RS Tangential edge 2

17 CE2I RS Circumferential edge 2

18 TE3I RS Tangential edge 3

DMAP Programmer's Guide 5-513


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

19 CE3I RS Circumferential edge 3

End TCODE,7

ELTYPE =49 Fluid element with 4 points (CAXIF4)

TCODE,7 =2 Real

2 RC RS Radial centroid

3 CC RS Circumferential centroid

4 AC RS Axial centroid

5 TE1 RS Tangential edge 1

6 CE1 RS Circumferential edge 1

7 TE2 RS Tangential edge 2

8 CE2 RS Circumferential edge 2

9 TE3 RS Tangential edge 3

10 CE3 RS Circumferential edge 3

11 TE4 RS Tangential edge 4

12 CE4 RS Circumferential edge 4

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 CCR RS Circumferential centroid

4 ACR RS Axial centroid

5 TE1R RS Tangential edge 1

6 CE1R RS Circumferential edge 1

7 TE2R RS Tangential edge 2

8 CE2R RS Circumferential edge 2

9 TE3R RS Tangential edge 3

10 CE3R RS Circumferential edge 3

11 TE4R RS Tangential edge 4

12 CE4R RS Circumferential edge 4

5-514 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 RCI RS Radial centroid

14 CCI RS Circumferential centroid

15 ACR RS Axial centroid

16 TE1I RS Tangential edge 1

17 CE1I RS Circumferential edge 1

18 TE2I RS Tangential edge 2

19 CE2I RS Circumferential edge 2

20 TE3I RS Tangential edge 3

21 CE3I RS Circumferential edge 3

22 TE4I RS Tangential edge 4

23 CE4I RS Circumferential edge 4

End TCODE,7

Word Name Type Description

ELTYPE =50 Three-point slot element (CSLOT3)

TCODE,7 =2 Real

2 RC RS Radial centroid

3 AC RS Axial centroid

4 TE1 RS Tangential edge 1

5 TE2 RS Tangential edge 2

6 TE3 RS Tangential edge 3

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

DMAP Programmer's Guide 5-515


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

7 RCI RS Radial centroid

8 ACI RS Axial centroid

9 TE1I RS Tangential edge 1

10 TE2I RS Tangential edge 2

11 TE3I RS Tangential edge 3

End TCODE,7

ELTYPE =51 Four-point slot element (CSLOT4)

TCODE,7 =2 Real

2 RC RS Radial centroid

3 AC RS Axial centroid

4 TE1 RS Tangential edge 1

5 TE2 RS Tangential edge 2

6 TE3 RS Tangential edge 3

7 TE4 RS Tangential edge 4

TCODE,7 =1 Real / Imaginary

2 RCR RS Radial centroid

3 ACR RS Axial centroid

4 TE1R RS Tangential edge 1

5 TE2R RS Tangential edge 2

6 TE3R RS Tangential edge 3

7 TE4R RS Tangential edge 4

8 RCI RS Radial centroid

9 ACI RS Axial centroid

10 TE1I RS Tangential edge 1

11 TE2I RS Tangential edge 2

12 TE3I RS Tangential edge 3

13 TE4I RS Tangential edge 4

5-516 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End TCODE,7

ELTYPE =52 Heat transfer plot element for CHBDYG and CHBDYP

2 UNDEF None

ELTYPE =53 Axisymmetric triangular element (CTRIAX6)

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – real part

4 SXI RS Normal stress in X – imaginary part

5 SYR RS Normal stress in Y – real part

6 SYI RS Normal stress in Y – imaginary part

7 SZR RS Normal stress in Z – real part

8 SZI RS Normal stress in Z – imaginary part

9 SPR RS In-plane shear stress – real part

10 SPI RS In-plane shear stress – imaginary part

11 RMSVMR RS RMS von Mises

12 RMSVMI RS RMS von Mises

Words 2 through 12 repeat 004 times

TCODE,7 =2 Real

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 MAXP RS Maximum Principal

8 TMAX RS Maximum Shear

9 OCTS RS Octahedral

10 RMSVM RS RMS von Mises

DMAP Programmer's Guide 5-517


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

Words 2 through 10 repeat 004 times

End TCODE,7

ELTYPE =54 Unused (Pre-V69 CTRIM6)

2 UNDEF None

ELTYPE =55 Three-point dummy element (CDUM3)

TCODE,7 =2 Real

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =56 Four-point dummy element (CDUM4)

TCODE,7 =2 Real

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =57 Five-point dummy element (CDUM5)

TCODE,7 =2 Real

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =58 Six-point dummy element (CDUM6)

TCODE,7 =2 Real

5-518 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

ELTYPE =59 Seven-point dummy element (CDUM7)

TCODE,7 =2 Real

2 S(9) RS User defined

TCODE,7 =1 Real/imaginary or magnitude/phase

2 SR(9) RS User defined - real/mag.

11 SI(9) RS User defined - mag./phase

End TCODE,7

Word Name Type Description

ELTYPE =60 Two-dimensional crack tip element (CRAC2D or CDUM8)

2 UNDEF none

ELTYPE =61 Three-dimensional crack tip element (CRAC3D or CDUM9)

2 UNDEF none

ELTYPE =62 Unused (Pre-V69 CQDMEM1)

2 UNDEF None

ELTYPE =63 Unused (Pre-V69 CQDMEM2)

2 UNDEF None

ELTYPE =64 Curved quadrilateral shell element (CQUAD8)

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification numbers or


grid identification number

DMAP Programmer's Guide 5-519


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 RMSVM1R RS RMS von Mises at Z1

12 RMSVM1I RS RMS von Mises at Z1

13 FD2 RS Fiber distance at Z2

14 SX2R RS Normal in x at Z2

15 SX2I RS Normal in x at Z2

16 SY2R RS Normal in y at Z2

17 SY2I RS Normal in y at Z2

18 TXY2R RS Shear in xy at Z2

19 TXY2I RS Shear in xy at Z2

20 RMSVM2R RS RMS von Mises at Z2

21 RMSVM2I RS RMS von Mises at Z2

Words 3 through 21 repeat 005 times

TCODE,7 =2 Real

2 TERM CHAR4 "CENTER"

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 EX1 RS Normal in x at Z1

6 EY1 RS Normal in y at Z1

7 ETXY1 RS Shear in xy at Z1

5-520 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 RMSVM1 RS RMS von Mises at Z1

9 FD2 RS Fiber distance at Z2

10 EX2 RS Normal in x at Z2

11 EY2 RS Normal in y at Z2

12 ETXY2 RS Shear in xy at Z2

13 RMSVM2 RS RMS von Mises at Z2

Words 3 through 13 repeat 005 times

End TCODE,7

ELTYPE =65 Unused (Pre-V69 CHEX8)

2 UNDEF None

ELTYPE =66 Unused (Pre-V69 CHEX20)

2 UNDEF None

ELTYPE =67 Hexa

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 RMSVMR RS RMS von Mises

13 SXI RS Normal in x

14 SYI RS Normal in y

DMAP Programmer's Guide 5-521


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

15 SZI RS Normal in z

16 TXYI RS Shear in xy

17 TYZI RS Shear in yz

18 TZXI RS Shear in zx

19 RMSVMI RS RMS von Mises

Words 5 through 19 repeat 009 times

TCODE,7 =2 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

12 RMSVM RS RMS von Mises

Words 5 through 12 repeat 009 times

End TCODE,7

ELTYPE =68 Penta

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

5-522 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

12 RMSVMR RS RMS von Mises

13 SXI RS Normal in x

14 SYI RS Normal in y

15 SZI RS Normal in z

16 TXYI RS Shear in xy

17 TYZI RS Shear in yz

18 TZXI RS Shear in zx

19 RMSVMI RS RMS von Mises

Words 5 through 19 repeat 007 times

TCODE,7 =2 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

12 RMSVM RS RMS von Mises

Words 5 through 12 repeat 007 times

DMAP Programmer's Guide 5-523


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

End TCODE,7

ELTYPE =69 Curved beam or pipe element (CBEND)

TCODE,7 =1 Real / Imaginary

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 SCR RS Long. Stress at Point C

5 SDR RS Long. Stress at Point D

6 SER RS Long. Stress at Point E

7 SFR RS Long. Stress at Point F

8 SCI RS Long. Stress at Point C

9 SDI RS Long. Stress at Point D

10 SEI RS Long. Stress at Point E

11 SFI RS Long. Stress at Point F

Words 2 through 11 repeat 002 times

TCODE,7 =2 Real

2 GRID I External Grid Point identification number

3 CA RS Circumferential Angle

4 SC RS Long. Stress at Point C

5 SD RS Long. Stress at Point D

6 SE RS Long. Stress at Point E

7 SF RS Long. Stress at Point F

Words 2 through 7 repeat 002 times

End TCODE,7

Word Name Type Description

ELTYPE =70 Triangular plate element (CTRIAR)

TCODE,7 =1 Real / Imaginary

5-524 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 FD2 RS Fiber distance at Z2

12 RMSVM1R RS RMS von Mises at Z1

13 RMSVM1I RS RMS von Mises at Z1

14 SX2R RS Normal in x at Z2

15 SX2I RS Normal in x at Z2

16 SY2R RS Normal in y at Z2

17 SY2I RS Normal in y at Z2

18 TXY2R RS Shear in xy at Z2

19 TXY2I RS Shear in xy at Z2

20 RMSVM2R RS RMS von Mises at Z2

21 RMSVM2I RS RMS von Mises at Z2

Words 3 through 21 repeat 004 times

TCODE,7 =2 Real

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

DMAP Programmer's Guide 5-525


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

8 RMSVM1 RS RMS von Mises at Z1

9 FD2 RS Fiber distance at Z2

10 SX2 RS Normal in x at Z2

11 SY2 RS Normal in y at Z2

12 TXY2 RS Shear in xy at Z2

13 RMSVM2 RS RMS von Mises at Z2

Words 3 through 13 repeat 004 times

End TCODE,7

ELTYPE =71 Unused

2 UNDEF None

ELTYPE =72 AEROQ4

2 UNDEF None

ELTYPE =73 Unused (Pre-V69 CFTUBE)

2 UNDEF None

ELTYPE =74 Triangular shell element (CTRIA3)

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 RMSVM1R RS RMS von Mises at Z1

5-526 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 RMSVM1I RS RMS von Mises at Z1

11 FD2 RS Z2 = Fibre Distance

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

18 RMSVM2R RS RMS von Mises at Z2

19 RMSVM2I RS RMS von Mises at Z2

TCODE,7 =2 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 RMSVM1 RS RMS von Mises at Z1

7 FD2 RS Z2 = Fibre Distance

8 SX2 RS Normal in x at Z2

9 SY2 RS Normal in y at Z2

10 TXY2 RS Shear in xy at Z2

11 RMSVM2 RS RMS von Mises at Z2

End TCODE,7

ELTYPE =75 Curved triangular shell element (CTRIA6)

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

DMAP Programmer's Guide 5-527


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 RMSVM1R RS RMS von Mises at Z1

12 RMSVM1I RS RMS von Mises at Z1

13 FD2 RS Fiber distance at Z2

14 SX2R RS Normal in x at Z2

15 SX2I RS Normal in x at Z2

16 SY2R RS Normal in y at Z2

17 SY2I RS Normal in y at Z2

18 TXY2R RS Shear in xy at Z2

19 TXY2I RS Shear in xy at Z2

20 RMSVM2R RS RMS von Mises at Z2

21 RMSVM2I RS RMS von Mises at Z2

Words 3 through 21 repeat 004 times

TCODE,7 =2 Real

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

5-528 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 RMSVM1 RS RMS von Mises at Z1

9 FD2 RS Fiber distance at Z2

10 SX2 RS Normal in x at Z2

11 SY2 RS Normal in y at Z2

12 TXY2 RS Shear in xy at Z2

13 RMSVM2 RS RMS von Mises at Z2

Words 3 through 13 repeat 004 times

End TCODE,7

ELTYPE =76 Acoustic velocity/pressures in six-sided solid element (CHEXA)

2 UNDEF None

ELTYPE =77 Acoustic velocity/pressures in five-sided solid element (CPENTA)

2 UNDEF None

ELTYPE =78 Acoustic velocity/pressures in four-sided solid element (CTETRA)

2 UNDEF None

ELTYPE =79 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =80 Undef

2 UNDEF None

ELTYPE =81 Undef

2 UNDEF None

ELTYPE =82 Quadrilateral plate element (CQUADR)

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

DMAP Programmer's Guide 5-529


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 FD1 RS Fiber distance at Z1

5 SX1R RS Normal in x at Z1

6 SX1I RS Normal in x at Z1

7 SY1R RS Normal in y at Z1

8 SY1I RS Normal in y at Z1

9 TXY1R RS Shear in xy at Z1

10 TXY1I RS Shear in xy at Z1

11 RMSVM1R RS RMS von Mises at Z1

12 RMSVM1I RS RMS von Mises at Z1

13 FD2 RS Fiber distance at Z2

14 SX2R RS Normal in x at Z2

15 SX2I RS Normal in x at Z2

16 SY2R RS Normal in y at Z2

17 SY2I RS Normal in y at Z2

18 TXY2R RS Shear in xy at Z2

19 TXY2I RS Shear in xy at Z2

20 RMSVM2R RS RMS von Mises at Z2

21 RMSVM2I RS RMS von Mises at Z2

Words 3 through 21 repeat 005 times

TCODE,7 =2 Real

2 TERM CHAR4

3 GRID I Number active grids identification number or grid


identification number

4 FD1 RS Fiber distance at Z1

5 SX1 RS Normal in x at Z1

6 SY1 RS Normal in y at Z1

7 TXY1 RS Shear in xy at Z1

5-530 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 RMSVM1 RS RMS von Mises at Z1

9 FD2 RS Fiber distance at Z2

10 SX2 RS Normal in x at Z2

11 SY2 RS Normal in y at Z2

12 TXY2 RS Shear in xy at Z2

13 RMSVM2 RS RMS von Mises at Z2

Words 3 through 13 repeat 005 times

End TCODE,7

ELTYPE =83 Acoustic absorber element (CHACAB)

2 UNDEF None

ELTYPE =84 Acoustic barrier element (CHACBR)

2 UNDEF None

ELTYPE =85 TETRA - Nonlinear

2 UNDEF None

ELTYPE =86 GAP - Nonlinear

2 UNDEF None

ELTYPE =87 Nonlinear tube element (CTUBE)

2 UNDEF None

ELTYPE =88 TRIA3 - Nonlinear (Same as QUAD4)

2 UNDEF None Z1 = Fiber distance

ELTYPE =89 Nonlinear rod element (CROD)

2 UNDEF None

Word Name Type Description

ELTYPE =90 QUAD4 - Nonlinear

2 UNDEF None

ELTYPE =91 Nonlinear five-sided solid element (CPENTA)

DMAP Programmer's Guide 5-531


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =92 Nonlinear rod element connection and property (CONROD)

2 UNDEF None

ELTYPE =93 Nonlinear six-sided solid element (CHEXA)

2 UNDEF None

ELTYPE =94 Nonlinear beam element (CBEAM)

2 UNDEF None

ELTYPE =95 QUAD4 composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

ELTYPE =96 QUAD8 composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

ELTYPE =97 TRIA3 composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5-532 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

ELTYPE =98 TRIA6 composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

ELTYPE =99 Undef

2 UNDEF None

Word Name Type Description

ELTYPE =100 Simple beam element w/stations (CBAR with CBARAO or


PLOAD1)

TCODE,7 =1 Real / Imaginary

2 SD RS % along bar for output

3 SXCR RS Stress at point c

4 SXDR RS Stress at point d

5 SXER RS Stress at point e

6 SXFR RS Stress at point f

7 ASR RS Axial stress

8 SMAXR RS Maximum stress

9 SMINR RS Minimum stress

DMAP Programmer's Guide 5-533


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

10 SXCI RS Stress at point c

11 SXDI RS Stress at point d

12 SXEI RS Stress at point e

13 SXFI RS Stress at point f

14 ASI RS Axial stress

15 SMAXI RS Maximum stress

16 SMINI RS Minimum stress

TCODE,7 =2 Real

2 SD RS % along bar for output

3 SXC RS Stress at point c

4 SXD RS Stress at point d

5 SXE RS Stress at point e

6 SXF RS Stress at point f

7 AS RS Axial stress

8 SMAX RS Maximum stress

9 SMIN RS Minimum stress

End TCODE,7

ELTYPE =101 Acoustic absorber element with freq. dependence (CAABSF)

TCODE,7 =2 Real

2 IMPED RS Impedance

3 ABSORB RS Absorption Coefficient

TCODE,7 =1 Real / Imaginary

2 IMPEDR RS Impedance

3 IMPEDI RS Impedance

4 ABSORB RS Absorption Coefficient

End TCODE,7

ELTYPE =102 Generalized spring and damper element (CBUSH)

5-534 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =2 Real

2 TX RS Translation x

3 TY RS Translation y

4 TZ RS Translation z

5 RX RS Rotation x

6 RY RS Rotation y

7 RZ RS Rotation z

TCODE,7 =1 Real / Imaginary

2 TXR RS Translation x R

3 TYR RS Translation y R

4 TZR RS Translation z R

5 RXR RS Rotation x R

6 RYR RS Rotation y R

7 RZR RS Rotation z R

8 TXI RS Translation x I

9 TYI RS Translation y I

10 TZI RS Translation z I

11 RXI RS Rotation x I

12 RYI RS Rotation y I

13 RZI RS Rotation z I

End TCODE,7

ELTYPE =103 Quadrilateral shell element (QUADP)

2 UNDEF None

ELTYPE =104 Triangular shell p-element (TRIAP)

2 UNDEF None

ELTYPE =105 Beam p-element (BEAMP)

2 UNDEF None

DMAP Programmer's Guide 5-535


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =106 Scalar damper with material property (CDAMP5)

2 UNDEF None

ELTYPE =107 Heat transfer boundary condition element - (CHBDYE)

2 UNDEF None

ELTYPE =108 Heat transfer boundary condition element (CHBDYG)

2 UNDEF None

ELTYPE =109 Heat transfer boundary condition element (CHBDYP)

2 UNDEF None

Word Name Type Description

ELTYPE =110 CONV

2 UNDEF None

ELTYPE =111 CONVM

2 UNDEF None

ELTYPE =112 QBDY3

2 UNDEF None

ELTYPE =113 QVECT

2 UNDEF None

ELTYPE =114 QVOL

2 UNDEF None

ELTYPE =115 Radbc

2 UNDEF None

ELTYPE =116 Slideline contact (SLIF1D)

2 UNDEF None

Word Name Type Description

ELTYPE =127 CQUAD

2 UNDEF None

5-536 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =128 CQUADX

2 UNDEF None

ELTYPE =129 RELUC

2 UNDEF None

Word Name Type Description

ELTYPE =130 RES

2 UNDEF None

ELTYPE =131 TETRAE

2 UNDEF None

ELTYPE =132 CTRIA

2 UNDEF None

ELTYPE =133 CTRIAX

2 UNDEF None

ELTYPE =134 LINEOB

2 UNDEF None

ELTYPE =135 LINXOB

2 UNDEF None

ELTYPE =136 QUADOB

2 UNDEF None

ELTYPE =137 TRIAOB

2 UNDEF None

ELTYPE =138 LINEX

2 UNDEF None

ELTYPE =139 Hyperelastic QUAD4FD

2 UNDEF None

DMAP Programmer's Guide 5-537


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =140 Hyperelastic 8-noded hexahedron element linear format


(HEXAFD)

2 UNDEF None

ELTYPE =141 Six-sided solid p-element (HEXAP)

2 UNDEF None

ELTYPE =142 Five-sided solid p-element (PENTAP)

2 UNDEF None

ELTYPE =143 Four-sided solid p-element (TETRAP)

2 UNDEF None

ELTYPE =144 Quadrilateral plate element for corner stresses (QUAD144)

TCODE,7 =1 Real / Imaginary

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 SX1R RS Normal in x at z1

6 SX1I RS Normal in x at z1

7 SY1R RS Normal in y at z1

8 SY1I RS Normal in y at z1

9 TXY1R RS Shear in xy at z1

10 TXY1I RS Shear in xy at z1

11 RMSVM1R RS RMS von Mises at z1

12 RMSVM1I RS RMS von Mises at z1

13 FD2 RS Fiber distance at z2

14 SX2R RS Normal in x at z2

15 SX2I RS Normal in x at z2

16 SY2R RS Normal in y at z2

17 SY2I RS Normal in y at z2

5-538 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

18 TXY2R RS Shear in xy at z2

19 TXY2I RS Shear in xy at z2

20 RMSVM2R RS RMS von Mises at z2

21 RMSVM2I RS RMS von Mises at z2

Words 3 through 21 repeat 005 times

TCODE,7 =2 Real

2 TERM CHAR4

3 GRID I

4 FD1 RS Fiber distance at z1

5 SX1 RS Normal in x at z1

6 SY1 RS Normal in y at z1

7 TXY1 RS Shear in xy at z1

8 RMSVM1 RS RMS von Mises at z1

9 FD2 RS Fiber distance at z2

10 SX2 RS Normal in x at z2

11 SY2 RS Normal in y at z2

12 TXY2 RS Shear in xy at z2

13 RMSVM2 RS RMS von Mises at z2

Words 3 through 13 repeat 005 times

End TCODE,7

ELTYPE =145 Six-sided solid display element (VUHEXA)

2 UNDEF None

ELTYPE =146 Five-sided solid display element (VUPENTA)

2 UNDEF None

ELTYPE =147 Four-sided solid display element (VUTETRA)

2 UNDEF None

ELTYPE =148 HEXAM

DMAP Programmer's Guide 5-539


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 UNDEF None

ELTYPE =149 PENTAM

2 UNDEF None

Word Name Type Description

ELTYPE =150 TETRAM

2 UNDEF None

ELTYPE =151 QUADM

2 UNDEF None

ELTYPE =152 TRIAM

2 UNDEF None

ELTYPE =153 QUADXM

2 UNDEF None

ELTYPE =154 TRIAXM

2 UNDEF None

ELTYPE =155 QUADPW

2 UNDEF None

ELTYPE =156 TRIAPW

2 UNDEF None

ELTYPE =157 LINEPW

2 UNDEF None

ELTYPE =158 QUADOBM

2 UNDEF None

ELTYPE =159 TRIAOBM

2 UNDEF None

5-540 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =160 Hyperelastic 5-sided 6-noded solid element (PENTAFD) Linear


form

2 UNDEF None

ELTYPE =161 Linear form for hyperelastic 4 node TETRA

2 UNDEF None

ELTYPE =162 Linear form for hyperelastic 3 node TRIA (strain)

2 UNDEF None

ELTYPE =163 Linear form for hyperelastic 20 node HEXAFD

2 UNDEF None

ELTYPE =164 Hyperelastic quadrilateral 9-noded element (QUADFD) Linear

2 UNDEF None

ELTYPE =165 Hyperelastic 5-sided 15-noded solid element (PENTAFD) Linear

2 UNDEF None

ELTYPE =166 Linear form for hyperelastic 10 node TETRA

2 UNDEF None

ELTYPE =167 Linear form for hyperelastic 6 node TRIA (plane strain)

2 UNDEF None

ELTYPE =168 Linear form for hyperelastic 3 node TRIA (axisymm)

2 UNDEF None

ELTYPE =169 Linear form for hyperelastic 6 node TRIA (axisymm)

2 UNDEF None

Word Name Type Description

ELTYPE =170 Linear form for hyperelastic 4 node QUAD (axisymm)

2 UNDEF None

ELTYPE =171 Linear form for hyperelastic 9 node QUAD (axisymm)

2 UNDEF None

DMAP Programmer's Guide 5-541


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =189 Quadrilateral plate view element (VUQUAD)

2 PARENT I Parent p-element identification number

3 COORD I CID coordinate system identification number

4 ICORD CHAR4 ICORD flat/curved and so on

5 THETA I THETA angle

6 ITYPE I ITYPE strcur =0, fiber=1

TCODE,7 =1 Real / Imaginary

7 VUID I VU grid identification number for this corner

8 Z1 RS Z1 fiber distance

9 Z2 RS Z2 fiber distance

10 NX1R RS Normal x rm at Z1

11 NX1I RS Normal x ip at Z1

12 NY1R RS Normal y rm at Z1

13 NY1I RS Normal y ip at Z1

14 TXY1R RS Shear xy rm at Z1

15 TXY1I RS Shear xy ip at Z1

16 NZ1R RS Normal z rm at Z1 or n/a

17 NZ1I RS Normal z ip at Z1 or n/a

18 TYZ1R RS Shear yz rm at Z1 or n/a

19 TYZ1I RS Shear yz ip at Z1 or n/a

20 TZX1R RS Shear zx rm at Z1 or n/a

21 TZX1I RS Shear zx ip at Z1 or n/a

22 NX2R RS Normal x rm at Z2

23 NX2I RS Normal x ip at Z2

24 NY2R RS Normal y rm at Z2

25 NY2I RS Normal y ip at Z2

26 TXY2R RS Shear xy rm at Z2

5-542 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

27 TXY2I RS Shear xy ip at Z2

28 NZ1R RS Normal z rm at Z1 or n/a

29 NZ1I RS Normal z ip at Z1 or n/a

30 TYZ1R RS Shear yz rm at Z1 or n/a

31 TYZ1I RS Shear yz ip at Z1 or n/a

32 TZX1R RS Shear zx rm at Z1 or n/a

33 TZX1I RS Shear zx ip at Z1 or n/a

Words 7 through 33 repeat 004 times

TCODE,7 =2 Real

2 UNDEF None

End TCODE,7

Word Name Type Description

ELTYPE =190 Triangular shell view element (VUTRIA)

2 UNDEF None

ELTYPE =191 Beam view element (VUBEAM)

2 UNDEF None

ELTYPE =192 CVINT

2 UNDEF None

ELTYPE =193 QUADFR

2 UNDEF None

ELTYPE =194 TRIAFR

2 UNDEF None

ELTYPE =195 LINEFR

2 UNDEF None

ELTYPE =196 LINXFR

2 UNDEF None

DMAP Programmer's Guide 5-543


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =197 GMINTS

2 UNDEF None

ELTYPE =198 CNVPEL

2 UNDEF None

ELTYPE =199 VUHBDY

2 UNDEF None

Word Name Type Description

ELTYPE =200 CWELD

2 UNDEF None

ELTYPE =201 Hyperelastic quadrilateral 4-noded, nonlinear format (QUAD4FD)

2 UNDEF None

ELTYPE =202 Hyperelastic hexahedron 8-noded, nonlinear format (HEXA8FD)

2 UNDEF None

ELTYPE =203 Slideline contact (SLIF1D)

2 UNDEF None

ELTYPE =204 Hyperelastic pentahedron 6-noded, nonlinear format


(PENTA6FD)

2 UNDEF None

ELTYPE =205 Hyperelastic tetrahedron 4-noded, nonlinear format (TETRA4FD)

2 UNDEF None

ELTYPE =206 Hyperelastic triangular 3-noded, nonlinear format (TRIA3FD)

2 UNDEF None

ELTYPE =207 Hyperelastic hexahedron 20-noded, nonlinear format (HEXAFD)

2 UNDEF None

ELTYPE =208 Hyperelastic quadrilateral 8-noded, nonlinear format (QUADFD)

2 UNDEF None

5-544 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =209 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 UNDEF None

Word Name Type Description

ELTYPE =210 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 UNDEF None

ELTYPE =211 Hyperelastic triangular 6-noded, nonlinear format (TRIAFD)

2 UNDEF None

ELTYPE =212 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 UNDEF None

ELTYPE =213 Hyperelastic axi. triangular 6-noded nonlinear format (TRIAXFD)

2 UNDEF None

ELTYPE =214 Hyperelastic axi. quadrilateral 4-noded nonlinear


format(QUADX4FD)

2 UNDEF None

ELTYPE =215 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 UNDEF None

ELTYPE =216 Hyperelastic tetrahedron 4-noded nonlinear format (TETRA4FD)

2 UNDEF None

ELTYPE =217 Hyperelastic triangular 3-noded nonlinear format (TRIA3FD)

2 UNDEF None

ELTYPE =218 Hyperelastic hexahedron 20-noded nonlinear format (HEXAFD)

2 UNDEF None

ELTYPE =219 Hyperelastic quadrilateral 8-noded nonlinear format (QUADFD)

2 UNDEF None

DMAP Programmer's Guide 5-545


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE =220 Hyperelastic pentahedron 15-noded nonlinear format


(PENTAFD)

2 UNDEF None

ELTYPE =221 Hyperelastic tetrahedron 10-noded nonlinear format (TETRAFD)

2 UNDEF None

ELTYPE =222 Hyperelastic axi. triangular 3-noded nonlinear format


(TRIAX3FD)

2 UNDEF None

ELTYPE =223 Hyperelastic axi. quadrilateral 8-noded nonlinear format


(QUADXFD)

2 UNDEF None

ELTYPE =224 Nonlinear ELAS1

2 UNDEF None

ELTYPE =225 Nonlinear ELAS3

2 UNDEF None

ELTYPE =226 Nonlinear BUSH

2 UNDEF None

ELTYPE =227 Triangular shell element (CTRIAR)

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 RMSVM1R RS RMS von Mises at Z1

10 RMSVM1I RS RMS von Mises at Z1

5-546 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

11 FD2 RS Z2 = Fibre Distance

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 TXY2I RS Shear in xy at Z2

18 RMSVM2R RS RMS von Mises at Z2

19 RMSVM2I RS RMS von Mises at Z2

TCODE,7 =2 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 RMSVM1 RS RMS von Mises at Z1

7 FD2 RS Z2 = Fibre Distance

8 SX2 RS Normal in x at Z2

9 SY2 RS Normal in y at Z2

10 TXY2 RS Shear in xy at Z2

11 RMSVM2 RS RMS von Mises at Z2

End TCODE,7

ELTYPE =228 Quadrilateral plate element (CQUADR)

TCODE,7 =1 Real / Imaginary

2 FD1 RS Z1 = Fibre Distance

3 SX1R RS Normal in x at Z1

4 SX1I RS Normal in x at Z1

5 SY1R RS Normal in y at Z1

DMAP Programmer's Guide 5-547


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 SY1I RS Normal in y at Z1

7 TXY1R RS Shear in xy at Z1

8 TXY1I RS Shear in xy at Z1

9 RMSVM1R RS RMS von Mises at Z1

10 RMSVM1I RS RMS von Mises at Z1

11 FD2 RS Z2 = Fibre Distance

12 SX2R RS Normal in x at Z2

13 SX2I RS Normal in x at Z2

14 SY2R RS Normal in y at Z2

15 SY2I RS Normal in y at Z2

16 TXY2R RS Shear in xy at Z2

17 RMSVM2R RS RMS von Mises at Z2

18 RMSVM2I RS RMS von Mises at Z2

TCODE,7 =2 Real

2 FD1 RS Z1 = Fibre Distance

3 SX1 RS Normal in x at Z1

4 SY1 RS Normal in y at Z1

5 TXY1 RS Shear in xy at Z1

6 RMSVM1 RS RMS von Mises at Z1

7 FD2 RS Z2 = Fibre Distance

8 SX2 RS Normal in x at Z2

9 SY2 RS Normal in y at Z2

10 TXY2 RS Shear in xy at Z2

11 RMSVM2 RS RMS von Mises at Z2

End TCODE,7

5-548 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

ELTYPE =232 QUADR composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

ELTYPE =233 TRIAR composite

2 PLY I Lamina number

3 SX1 RS Normal – 1

4 SY1 RS Normal – 2

5 T1 RS Shear – 12

6 SL1 RS Shear – 1Z

7 SL2 RS Shear – 2Z

8 TMAX1 RS von Mises

Word Name Type Description

ELTYPE =240 CTRIA6 - Nonlinear - Center and corners

2 UNDEF None

Word Name Type Description

ELTYPE =241 CQUAD8 - Nonlinear - Center and corners

2 UNDEF None

ELTYPE =242 Axisymmetric triangular element (CTRAX3) – Linear Stress -


Center and corners

TCODE,7 =1 Real / Imaginary

DMAP Programmer's Guide 5-549


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SXR RS Normal stress in X – Real part

5 SXI RS Normal stress in X – Imaginary part

6 SYR RS Normal stress in Y – Real part

7 SYI RS Normal stress in Y – Imaginary part

8 SZR RS Normal stress in Z – Real part

9 SZI RS Normal stress in Z – Imaginary part

10 SPR RS In-plane shear stress – Real part

11 SPI RS In-plane shear stress – Imaginary part

12 RMSVMR RS RMS von Mises – Real part

13 RMSVMI RS RMS von Mises – Imaginary part

Words 3 through 13 process 4 times

TCODE,7 =2 Real

2 CTYPE CHAR4 Coordinate Type (BCD)

3 LOC I Location Code

4 SX RS Normal stress in X

5 SY RS Normal stress in Y

6 SZ RS Normal stress in Z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 process 4 times

End TCODE,7

ELTYPE =243 Axisymmetric quad element (CQUADX4) – Linear Stress -


Center and corners

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

5-550 DMAP Programmer's Guide


Data Block Descriptions O-V

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 RMSVMR RS RMS von Mises – Real part

12 RMSVMI RS RMS von Mises – Imaginary part

Words 2 through 12 process 5 times

TCODE,7 =2 Real

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 RMSVM RS RMS von Mises

Words 2 through 7 process 5 times

End TCODE,7

ELTYPE =244 Axisymmetric triangle element (CTRAX6) – Linear Stress -


Center and corners

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

DMAP Programmer's Guide 5-551


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 RMSVMR RS RMS von Mises – Real part

12 RMSVMI RS RMS von Mises – Imaginary part

Words 2 through 12 process 4 times

TCODE,7 =2 Real

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 RMSVM RS RMS von Mises

Words 2 through 7 process 4 times

End TCODE,7

ELTYPE =245 Axisymmetric quad element (CQUADX8) – Linear Stress -


Center and corners

TCODE,7 =1 Real / Imaginary

2 LOC I Location Code

3 SXR RS Normal stress in X – Real part

4 SXI RS Normal stress in X – Imaginary part

5 SYR RS Normal stress in Y – Real part

6 SYI RS Normal stress in Y – Imaginary part

7 SZR RS Normal stress in Z – Real part

8 SZI RS Normal stress in Z – Imaginary part

5-552 DMAP Programmer's Guide


Data Block Descriptions O-V

9 SPR RS In-plane shear stress – Real part

10 SPI RS In-plane shear stress – Imaginary part

11 RMSVMR RS RMS von Mises – Real part

12 RMSVMI RS RMS von Mises – Imaginary part

Words 2 through 12 process 5 times

TCODE,7 =2 Real

2 LOC I Location Code

3 SX RS Normal stress in X

4 SY RS Normal stress in Y

5 SZ RS Normal stress in Z

6 SP RS In-plane shear stress

7 RMSVM RS RMS von Mises

Words 2 through 7 process 5 times

End TCODE,7

ELTYPE =246 Axisymmetric triangle element (CTRAX3) – Nonlinear


Stress/Strain - Center and corners

2 UNDEF None

ELTYPE =247 Axisymmetric quad element (CQUADX4) – Nonlinear Stress/Strain


- Center and corners

2 UNDEF None

ELTYPE =248 Axisymmetric triangle element (CTRAX6) – Nonlinear


Stress/Strain - Center and corners

2 UNDEF None

ELTYPE =249 Axisymmetric quad element (CQUADX8) – Nonlinear Stress/Strain


- Center and corners

2 UNDEF None

DMAP Programmer's Guide 5-553


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =250 Axisymmetric triangle element (CTRAX3) – Linear form of


hyperelastic – Gauss Location

2 UNDEF None

ELTYPE =251 Axisymmetric quad element (CQUADX4) – Linear form of


hyperelastic – Gauss Locations

2 UNDEF None

ELTYPE =252 Axisymmetric triangle element (CTRAX6) – Linear form of


hyperelastic – Gauss Locations

2 UNDEF None

ELTYPE =253 Axisymmetric quad element (CQUADX8) – Linear form of


hyperelastic – Gauss Locations

2 UNDEF None

Word Name Type Description

ELTYPE =254 CQUAD4 - Nonlinear - Center and corners

2 UNDEF None

ELTYPE = 255 CPYRAM – Linear Stress

TCODE,7 =1 Real / Imaginary

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SXR RS Normal in x

7 SYR RS Normal in y

8 SZR RS Normal in z

9 TXYR RS Shear in xy

10 TYZR RS Shear in yz

11 TZXR RS Shear in zx

5-554 DMAP Programmer's Guide


Data Block Descriptions O-V

12 SXI RS Normal in x

13 SYI RS Normal in y

14 SZI RS Normal in z

15 TXYI RS Shear in xy

16 TYZI RS Shear in yz

17 TZXI RS Shear in zx

18 RMSVMR RS RMS von Mises

19 RMSVMI RS RMS von Mises

Words 5 through 19 process 6 times

TCODE,7 =2 Real

2 CID I Stress Coordinate System

3 CTYPE CHAR4 Coordinate System Type (BCD)

4 NODEF I Number of Active Points

5 GRID I External grid identification number (0=center)

6 SX RS Normal in x

7 SY RS Normal in y

8 SZ RS Normal in z

9 TXY RS Shear in xy

10 TYZ RS Shear in yz

11 TZX RS Shear in zx

12 RMSVM RS RMS von Mises

Words 5 through 12 process 6 times

End TCODE,7

ELTYPE =256 CPYRAM - Nonlinear

2 UNDEF None

ELTYPE =257 CPYRAM (linear element, 5 grids) – Hyperelastic nonlinear


format

DMAP Programmer's Guide 5-555


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

2 UNDEF None

ELTYPE =258 CPYRAM (parabolic element, 13 grids) – Hyperelastic nonlinear


format

2 UNDEF None

ELTYPE =259 Reserved for hyperelastic PYRAM 5-noded, linear form.

ELTYPE =260 Reserved for hyperelastic PYRAM 13-noded, linear form.

ELTYPE =261 Axisymmetric triangle element (CTRAX3) – Nonlinear form of


hyperelastic

2 UNDEF None

ELTYPE =262 Axisymmetric quad element (CQUADX4) – Nonlinear form of


hyperelastic

2 UNDEF None

ELTYPE =263 Axisymmetric triangle element (CTRAX6) – Nonlinear form of


hyperelastic

2 UNDEF None

ELTYPE =264 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – Grid Locations

2 UNDEF None

ELTYPE =266 Axisymmetric quad element (CQUADX8) – Nonlinear form of


hyperelastic – 9 Gauss Locations

2 UNDEF None

ELTYPE =269 Composite HEXA element (CHEXAL) – Center and corners

2 PLY I Lamina number

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5-556 DMAP Programmer's Guide


Data Block Descriptions O-V

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS von Mises stress

For each fiber location requested (PLSLOC), words 4 through 11 repeat 5 times.

ELTYPE =270 Composite PENTA element (CPENTAL) – Center and corners

2 PLY I Lamina number

Q4CSTR=0 Center option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

DMAP Programmer's Guide 5-557


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS von Mises stress

Q4CSTR=1 Center and Corner option

3 FLOC CHAR4 Fiber location (BOT, MID, TOP)

4 GRID I Edge grid ID (center=0)

5 SX1 RS Normal stress in the 1-direction

6 SY1 RS Normal stress in the 2-direction

7 ST1 RS Shear stress in the 12-plane

8 SZ1 RS Normal stress in the 3-direction

9 SL1 RS Shear stress in the 13-plane

10 SL2 RS Shear stress in the 23-plane

11 STMAX1 RS von Mises stress

For each fiber location requested (PLSLOC), words 4 through 11 repeat 4 times.

ELTYPE =271 Triangle plane strain (CPLSTN3) – Center

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

10 RMSVMR RS RMS von Mises – real part

11 RMSVMI RS RMS von Mises – imaginary part

TCODE,7=2 Real

5-558 DMAP Programmer's Guide


Data Block Descriptions O-V

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

6 RMSVM RS RMS von Mises

End TCODE,7

ELTYPE =272 Quadrilateral plane strain (CPLSTN4) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 5 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

DMAP Programmer's Guide 5-559


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 repeat 5 times

End TCODE,7

ELTYPE =273 Triangle plane strain (CPLSTN6 ) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 4 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

5-560 DMAP Programmer's Guide


Data Block Descriptions O-V

Words 3 through 8 repeat 4 times

End TCODE,7

ELTYPE =274 Quadrilateral plane strain (CPLSTN8) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 5 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 repeat 5 times

End TCODE,7

DMAP Programmer's Guide 5-561


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =275 Triangle plane stress (CPLSTS3) – Center

TCODE,7=1 Real / Imaginary

2 SXR RS Normal stress in x – real part

3 SXI RS Normal stress in x – imaginary part

4 SYR RS Normal stress in y – real part

5 SYI RS Normal stress in y – imaginary part

6 SZR RS Normal stress in z – real part

7 SZI RS Normal stress in z – imaginary part

8 SPR RS In-plane shear stress – real part

9 SPI RS In-plane shear stress – imaginary part

10 RMSVMR RS RMS von Mises – real part

11 RMSVMI RS RMS von Mises – imaginary part

TCODE,7=1 Real

2 SX RS Normal stress in x

3 SY RS Normal stress in y

4 SZ RS Normal stress in z

5 SP RS In-plane shear stress

6 RMSVM RS RMS von Mises

End TCODE,7

ELTYPE =276 Quadrilateral plane stress (CPLSTS4) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

5-562 DMAP Programmer's Guide


Data Block Descriptions O-V

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 5 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 repeat 5 times

End TCODE,7

ELTYPE =277 Triangle plane stress (CPLSTS6) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

DMAP Programmer's Guide 5-563


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 4 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 repeat 4 times

End TCODE,7

ELTYPE =278 Quadrilateral plane stress (CPLSTS8) – Center and Corners

TCODE,7=1 Real / Imaginary

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SXR RS Normal stress in x – real part

5 SXI RS Normal stress in x – imaginary part

6 SYR RS Normal stress in y – real part

7 SYI RS Normal stress in y – imaginary part

8 SZR RS Normal stress in z – real part

9 SZI RS Normal stress in z – imaginary part

10 SPR RS In-plane shear stress – real part

11 SPI RS In-plane shear stress – imaginary part

5-564 DMAP Programmer's Guide


Data Block Descriptions O-V

12 RMSVMR RS RMS von Mises – real part

13 RMSVMI RS RMS von Mises – imaginary part

Words 3 through 13 repeat 5 times

TCODE,7=2 Real

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 SX RS Normal stress in x

5 SY RS Normal stress in y

6 SZ RS Normal stress in z

7 SP RS In-plane shear stress

8 RMSVM RS RMS von Mises

Words 3 through 8 repeat 5 times

End TCODE,7

ELTYPE =281 Triangle plane strain (CPLSTN3) – Nonlinear format – Center

2 UNDEF None

ELTYPE =283 Triangle plane strain (CPLSTN6) – Nonlinear format – Center and
Corners

2 UNDEF None

ELTYPE =284 Quadrilateral plane strain (CPLSTN8) – Nonlinear format – Center


and Corners

2 UNDEF None

ELTYPE =285 Triangle plane stress (CPLSTS3) – Nonlinear format – Center

2 UNDEF None

ELTYPE =287 Triangle plane stress (CPLSTS6) – Nonlinear format – Center


and Corners

2 UNDEF None

DMAP Programmer's Guide 5-565


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

ELTYPE =288 Quadrilateral plane stress (CPLSTS8) – Nonlinear format – Center


and Corners

2 UNDEF None

ELTYPE =289 Quadrilateral plane strain (CPLSTN4) – Nonlinear format – Center


and Corners

2 UNDEF None

ELTYPE =290 Quadrilateral plane stress (CPLSTS4) – Nonlinear format – Center


and Corners

2 UNDEF None

ELTYPE =291 Triangle plane strain (CPLSTN3) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =292 Quadrilateral plane strain (CPLSTN4) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =293 Triangle plane strain (CPLSTN6) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =294 Quadrilateral plane strain (CPLSTN8) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =295 Triangle plane stress (CPLSTS3) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =296 Quadrilateral plane stress (CPLSTS4) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =297 Triangle plane stress (CPLSTS6) – Hyperelastic - Grid

2 UNDEF None

ELTYPE =298 Quadrilateral plane stress (CPLSTS8) – Hyperelastic - Grid

5-566 DMAP Programmer's Guide


Data Block Descriptions O-V

2 UNDEF None

Word Name Type Description

End ELTYPE

Record – TRAILER

Word Name Type Description

1 UNDEF(6) None

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 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.17 OGF
Table of grid point forces

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code; always 19

3 UNDEF None

4 SUBCASE I Subcase identification number

DMAP Programmer's Guide 5-567


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE,4=0

5 UNDEF None Not defined

ACODE,4=01 Statics

5 UNDEF None See word 8

ACODE,4=02 Real Eigenvalues

5 MODE I Mode Number

ACODE,4=03 Differential Stiffness 0

5 UNDEF None See word 8

ACODE,4=04 Differential Stiffness 1

5 UNDEF None See word 8

ACODE,4=05 Frequency

5 FREQ RS Frequency

ACODE,4=06 Transient

5 TIME RS Time step

ACODE,4=07 Buckling 0 (Pre-buckling)

5 UNDEF None See word 8

ACODE,4=08 Buckling 1 (Post-buckling)

5 MODE I Mode number

ACODE,4=09 Complex Eigenvalues

5 MODE I Mode number

ACODE,4=10 Nonlinear Statics (Sol 106)

5 LOADFAC RS Load factor

ACODE,4=11 Geometric Nonlinear Statics

5 UNDEF None See word 8

ACODE,4=12 CONTRAN

5 TIME RS Time step

End ACODE,4

5-568 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 UNDEF(2) None

8 LOADSET I Load set or zero

9 FCODE I Format Code

10 NUMWDE(C) I Number of words per entry in DATA record

11 UNDEF(2) None

13 SETID I Set identification number

14 EIGENR RS Natural eigenvalue – real part

15 EIGENI RS Natural eigenvalue – imaginary part

16 FREQ RS Natural frequency

17 UNDEF(34) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE,1 =1 Sort 1

1 EKEY I Device code + 10* Point identification number

TCODE,1 =02 Sort 2 - Swap with word 5 of IDENT

ACODE,4 =0

1 UNDEF None Not defined

ACODE,4 =01

1 EKEY I 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

DMAP Programmer's Guide 5-569


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

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 EID I Element identification number if element force;


otherwise zero

3 ELNAME(2) CHAR4

NUMWDE =10 real

5 F1 RS Force in displacement coordinate system


direction 1

6 F2 RS Force in displacement coordinate system


direction 2

5-570 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 F3 RS Force in displacement coordinate system


direction 3

8 M1 RS Moment in displacement coordinate system


direction 1

9 M2 RS Moment in displacement coordinate system


direction 2

10 M3 RS Moment in displacement coordinate system


direction 3

NUMWDE =16 complex

5 F1R RS

6 F2R RS

7 F3R RS

8 M1R RS

9 M2R RS

10 M3R RS

11 F1I RS

12 F2I RS

13 F3I RS

14 M1I RS

15 M2I RS

16 M3I RS

End NUMWDE

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

DMAP Programmer's Guide 5-571


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

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.18 OGK
Output gasket element results
For SOL 601,106 and SOL 601,129.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data Block Name, for example, OGK1

Record - IDENT

Word Name Type Description

1 ACODE I Device code + 10*Approach code

2 TCODE I Table code; 61

5-572 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 ELTYPE I Element Type (for example, linear hexa=67,


linear penta=68, nonlinear penta=91, hexa=93,
....)

4 SUBCASE I

5 TIME RS Time Step

6-7 UNDEF None

8 LOADSET I Load Set or Zero

9 FCODE I 1

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF None

12 PID I Physical Property ID

11-50 UNDEF None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

1 EKEY I Device code + 10* Element identification number

2 GP RS Gasket pressure

3 GC RS Gasket closure

4 GPC RS Gasket plastic closure

5 YS RS Gasket yield stress

6 GS I Gasket status. See Remark 2.

Repeat word 1-6 for each element.

DMAP Programmer's Guide 5-573


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

Notes:
1. Gasket element results are elemental based results.

2. Gasket status is assigned to the following integer values:


Integer – Status
1 – Open
2 – Closed
3 – Sealed
4 – Leaked
5 – Crushed

5.19 OGS
Table of grid point stresses/strains or discontinuities
SORT1, SORT2, and real formats only.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I Month, day, year, 0, 1

Word 3 repeats until End of Record

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table type code

3 ID I Surface or volume identification number

4 SUBCASE I Subcase or mode identification number

ACODE =01 Statics

5 LSDVMN I Load set number

5-574 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 UNDEF None

ACODE =02 Real Eigenvalues

5 MODE I Mode Number

6 EIGN RS Eigenvalue

ACODE =06 Transient

5 TIME RS Time Step

6 UNDEF None

ACODE =10 Nonlinear Statics

5 LOADSTEP RS Load Step

6 UNDEF None

End ACODE

7 UNDEF None

8 REFID I Reference coordinate system identification


number

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 SCODE I Stress/Strain code

12 OCOORD I Output coordinate system code

13 AXIS I Axis specification code

14 NORMAL I Normal Specification code

15 UNDEF(36 ) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 – DATA
Word Name Type Description

TCODE =26 Surface

DMAP Programmer's Guide 5-575


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

1 EKEY I 10*Grid point identification number + Device code

2 ID I Element identification number

3 FIBRE CHAR4 Fibre

4 NX RS Normal in x

5 NY RS Normal in y

6 TXY RS Shear in xy

7 A RS Angle

8 MJRP RS Major principal

9 MNRP RS Minor principal

10 TMAX RS Maximum shear

11 HVM RS Hency-von Mises

TCODE =27 Volume with direct

1 EKEY I 10*Grid point identification number + Device


Code

2 NX RS Normal in x

3 NY RS Normal in y

4 NZ RS Normal in z

5 TXY RS Shear in xy

6 TYZ RS Shear in yz

7 TZX RS Shear in zx

8 PR RS Mean pressure

9 HVM RS Hencky-von Mises or Octahedral

TCODE =28 Volume with principal

1 EKEY I 10*Grid point identification number + Device code

2 LXA RS Direction cosine from x to a

3 LXB RS Direction cosine from x to b

4 LXC RS Direction cosine from x to c

5-576 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 LYA RS Direction cosine from y to a

6 LYB RS Direction cosine from y to b

7 LYC RS Direction cosine from y to c

8 LZA RS Direction cosine from z to a

9 LZB RS Direction cosine from z to b

10 LZC RS Direction cosine from z to c

11 SA RS Principal in a

12 SB RS Principal in b

13 SC RS Principal in c

14 EPR RS Mean pressure

15 EHVM RS Hencky-von Mises or Octahedral

TCODE =29 Element discontinuities for surface

1 EKEY I 10*Grid point identification number + Device code

2 ELTYPE(2) CHAR4 Element type

4 FIBRE CHAR4 Fibre

5 NX RS Normal in x

6 NY RS Normal in y

7 TXY RS Shear in xy

8 MJPR RS Major principal

9 MNPR RS Minor principal

10 TMAX RS Maximum shear

11 HVM RS Hencky-von Mises

12 ERR RS Error estimate

Word Name Type Description

TCODE =30 Element discontinuities for volumes with direct

DMAP Programmer's Guide 5-577


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

1 EKEY I 10*Element identification number + Device


code

2 ELTYPE(2) CHAR4 Element type

4 NX RS Normal in x

5 NY RS Normal in y

6 NZ RS Normal in z

7 SXY RS Shear in xy

8 SYZ RS Shear in yz

9 SZX RS Shear in zx

10 PR RS Mean pressure

11 HVM RS Hencky-von Mises

12 ERR RS Error estimate

TCODE =31 Element discontinuities for volumes with principal

1 EKEY I 10*Element identification number + Device


code

2 ELTYPE(2) CHAR4 Element type

4 SA RS Principal in a

5 SB RS Principal in b

6 SC RS Principal in c

7 MP RS Mean pressure

8 HVM RS Hencky-von Mises or Octahedral

9 ERR RS Error estimate

TCODE =32 Grid point discontinuities for surface

1 EKEY I 10*Grid point identification number + Device


code

2 FIBRE CHAR4 Fibre

3 NX RS Normal in x

4 NY RS Normal in y

5-578 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 NXY RS Shear in xy

6 MJPR RS Major principal

7 MNPR RS Minor principal

8 TMAX RS Maximum shear

9 HVM RS Hencky-von Mises

10 ERR RS Error estimate

TCODE =33 Grid point discontinuities for volumes with direct

1 EKEY I 10*Grid point identification number + Device


Code

2 NX RS Normal in x

3 NY RS Normal in y

4 NZ RS Normal in z

5 TXY RS Shear in xy

6 TYZ RS Shear in yz

7 TZX RS Shear in zx

8 PR RS Mean pressure

9 HVM RS Hencky-von Mises or Octahedral

10 ERR RS Error estimate

TCODE =34 Grid point discontinuities for volumes with principal

1 EKEY I 10*Grid point identification number + Device


Code

2 SA RS Principal in a

3 SB RS Principal in b

4 SC RS Principal in c

5 PR RS Mean pressure

6 HVM RS Hencky-von Mises or Octahedral

7 ERR RS Error estimate

DMAP Programmer's Guide 5-579


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE =35 Grid point stresses for surfaces with plane strain

1 EKEY I 10*Grid point identification number and Grid


Code

2 NX RS Normal in x

3 NY RS Normal in y

4 NZ RS Normal in z (always -1)

5 TXY RS Shear in xy

6 PR RS Mean pressure (always -1)

End TCODE,2

End TABLE

Record 3 – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

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

5-580 DMAP Programmer's Guide


Data Block Descriptions O-V

2 = X Axis
3 = Y Axis
4 = Z Axis
5 = –X Axis
6 = –Y Axis
7 = –Z Axis

8 = –Radius vector

5.20 OJINT
Table of J-integral for a crack defined by CRAKTP.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No def or month, year, one, one

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code = 73

3 UNDEF None

4 SUBCASE I Subcase or random identification number

5 TIME RS Time step

6 UNDEF(4) None

10 NUMWDE I Number of words per entry in DATA record

13 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

DMAP Programmer's Guide 5-581


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record - DATA

Word Name Type Description

1 CRACK I Crack ID

2 CRAGD I Grid ID on the crack front

3 RINGN I Ring number

4 CIVJ(7) RS J-integral at the ith Q-vector

End of Record

Record - TRAILER

Word Name Type Description

1 NGRID I Number of total grids defined in all CRAKTP


bulk entries

2 UNDEF None

3 NOUT I Number of solution time points that have OJINT


output

4 UNDEF(3) None

5.21 OMECON
Table of constant total modal energies.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

5-582 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE=1042 Sort 1

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3042 Sort 2

1 EKEY I Device code + 10*mode number

DMAP Programmer's Guide 5-583


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

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:

1042 = SORT1 complex


3042 = SORT2 complex

Mode number = 0 implies summation results (summation of all modal energy values for a frequency)

5.22 OMEOSC
Table of oscillating total modal energies.

5-584 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE=1043 Sort 1

DMAP Programmer's Guide 5-585


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3043 Sort 2

1 EKEY I Device code + 10*mode number

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

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:
1043 = SORT1 complex

5-586 DMAP Programmer's Guide


Data Block Descriptions O-V

3043 = SORT2 complex

Mode number = 0 implies summation results (summation of all modal energy values for a frequency)

5.23 OMKEC
Table of constant modal kinetic energies.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

DMAP Programmer's Guide 5-587


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA
Word Name Type Description

TCODE=1040 Sort 1

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3040 Sort 2

1 EKEY I Device code + 10*mode number

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER
Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

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

5-588 DMAP Programmer's Guide


Data Block Descriptions O-V

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.24 OMKEO
Table of oscillating modal kinetic energies.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

DMAP Programmer's Guide 5-589


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE=1041 Sort 1

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3041 Sort 2

1 EKEY I Device code + 10*mode number

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

5-590 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 UNDEF(5 ) None

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.25 OMSEC
Table of constant modal strain energies.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

DMAP Programmer's Guide 5-591


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE=1038 Sort 1

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3038 Sort 2

1 EKEY I Device code + 10*mode number

5-592 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

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

6. Mode number = 0 implies summation results (summation of all modal energy values for a
frequency)

5.26 OMSEO
Table of oscillating modal strain energies.

DMAP Programmer's Guide 5-593


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Block Name

3 MONTH I

4 DAY I

5 YEAR I

6 UNDEF(2) None

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 UNDEF None

4 SUBCASE I Subcase identification number

5 MODE/FREQ I/RS Device code + 10*Mode number (SORT1) /


Frequency in Hz (SORT2)

6 UNDEF(3) None

9 FORM I Form of data:


=1 For real/imaginary
=3 For magnitude/phase

10 NUMWDE(C) I Length of entries in RECORD=DATA

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE=1039 Sort 1

5-594 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

1 FREQ RS Frequency in Hz.

2 TYPE I Always 4 for ‘modal’.

3 REAL or MAG RS Real part of energy value (FORM=1) or


magnitude of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

TCODE=3039 Sort 2

1 EKEY I Device code + 10*mode number

2 TYPE I Always 4 for ‘modal’

3 REAL or MAG RS Real part of energy value (FORM=1) or phase


(degrees) of energy value (FORM=3)

4 IMAG or RS Imaginary part of energy value (FORM=1) or


PHASE phase (degrees) of energy value (FORM=3)

Record 3 - TRAILER

Word Name Type Description

1 WORD1 I Number of output line entries

2 UNDEF(5 ) None

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:
1039 = SORT1 complex

DMAP Programmer's Guide 5-595


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

3039 = SORT2 complex

6. Mode number = 0 implies summation results (summation of all modal energy values for a
frequency)

5.27 OPG
Table of applied loads
For all analysis types (real and complex), and SORT1 and SORT2 formats.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record – IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 UNDEF None

4 SUBCASE I Subcase or Random identification number

TCODE =1 Sort 1

ACODE =01 Statics

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =02 Real Eigenvalues

5 MODE I Mode Number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or Cycle

ACODE =03 Differential Stiffness

5-596 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =04 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =05 Frequency

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE =06 Transient

5 TIME RS Time Step

6 UNDEF(2 ) None

ACODE =07 Buckling Phase 0 (Pre-buckling)

5 LSDVMN I Load set

6 UNDEF(2 ) None

ACODE =08 Buckling Phase 1 (Post-buckling)

5 LSDVMN I Mode Number

6 EIGR RS Eigenvalue

7 RANDOM ID I Random identification number

ACODE =09 Complex Eigenvalues

5 MODE I Mode

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE =10 Nonlinear statics

5 LFTSFQ RS Load step

6 UNDEF(2 ) None

ACODE =11 Old geometric nonlinear statics

DMAP Programmer's Guide 5-597


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 LSDVMN I Load set

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE =12 CONTRAN (Can appear as ACODE=6)

5 TIME RS Time

6 UNDEF(2 ) None

End ACODE

TCODE =02 Sort 2

5 LSDVMN I Load set, Mode Number

6 UNDEF(2 ) None

End TCODE

8 RCODE I Random code ID number.

9 FCODE(C) I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(6) None

17 RMSSF RS RMS and CRMS scale factor

18 UNDEF(5) None

23 THERMAL I 1 for heat transfer and 0 otherwise

24 UNDEF(27 ) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record – DATA

Word Name Type Description

TCODE =1 Sort 1

1 EKEY I Device code + 10* Point identification number

5-598 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE =02 Sort 2 - Swap with word 5 of IDENT

ACODE =01

1 EKEY I Device code + 10* Point identification number

ACODE =02

1 EKEY I Device code + 10* Point identification number

ACODE =03

1 EKEY I Device code + 10* Point identification number

ACODE =04

1 EKEY I Device code + 10* Point identification number

ACODE =05

1 FREQ RS Frequency

ACODE =06

1 TIME RS Time step

ACODE =07

1 EKEY I Device code + 10* Point identification number

ACODE =08

1 EKEY I Device code + 10* Point identification number

ACODE =09

1 EKEY I Device code + 10* Point identification number

ACODE =10

1 FQTS RS Frequency or Time step

ACODE =11

1 EKEY I Device code + 10* Point identification number

ACODE =12

1 EKEY I Device code + 10* Point identification number

End ACODE

End TCODE

DMAP Programmer's Guide 5-599


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TYPE I Point type: G for grid and S for scalar

FCODE =0 or 2 Real or Random Response

3 F1 RS Applied force in direction 1

4 F2 RS Applied force in direction 2

5 F3 RS Applied force in direction 3

6 M1 RS Applied moment in direction 1

7 M2 RS Applied moment in direction 2

8 M3 RS Applied moment in direction 3

FCODE =1 Real/Imaginary

3 F1R RS Applied force in direction 1 – Real

4 F2R RS Applied force in direction 2 – Real

5 F3R RS Applied force in direction 3 – Real

6 M1R RS Applied moment in direction 1 – Real

7 M2R RS Applied moment in direction 2 – Real

8 M3R RS Applied moment in direction 3 – Real

9 F1I RS Applied force in direction 1 – Imaginary

10 F2I RS Applied force in direction 2 – Imaginary

11 F3I RS Applied force in direction 3 – Imaginary

12 M1I RS Applied moment in direction 1 – Imaginary

13 M2I RS Applied moment in direction 2 – Imaginary

14 M3I RS Applied moment in direction 3 – Imaginary

End FCODE

Record – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

5-600 DMAP Programmer's Guide


Data Block Descriptions O-V

5.28 OPRESS
Table of grid point pressures.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No def or month, year, one, one

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach code

2 TCODE(C) I Table code

3 PCODE(C) I PLOAD code

4 SUBCASE I Subcase or random identification number

5 TIMESTEP RS Current time step

6 ECODE I Element code

7 UNDEF(2) None

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

13 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

PCODE,5 = 1 PLOAD4

1 EID I Device code + 10*Element ID

2 P1 RS Pressure at corner 1

DMAP Programmer's Guide 5-601


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 P2 RS Pressure at corner 2

4 P3 RS Pressure at corner 3

5 P4 RS Pressure at corner 4

6 G1 I Grid point ID at a corner of the face

7 G34 I Grid point ID at a diagonal from G1 or CTETRA


corner

PCODE,5 = 2 PLOADX1

1 EID I Device code + 10*Element ID

2 P1 RS Pressure at corner 1

3 P2 RS Pressure at corner 2

4 G1 I Grid point ID at a corner of the face

5 G2 I Grid point ID of the corner grid adjacent to G1

PCODE,5 = 3 PLOADE1

1 EID I Device code + 10*Element ID

2 P1 RS Pressure at corner 1

3 P2 RS Pressure at corner 2

4 G1 I Corner grid point ID

5 G2 I Corner grid point ID

End of Record

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

5.29 OPTPRM
Table of optimization parameters

5-602 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record - PARAMS
Word Name Type Description

The PARAMS record of the OPTPRM data block is identical to the DOPTPRM record of the
EDOM data block.

Record - TRAILER
Word Name Type Description

1 UNDEF(6) None

5.30 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 – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record – IDENT
Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 UNDEF None

4 SUBCASE I Subcase or Random identification number

DMAP Programmer's Guide 5-603


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE =1 Sort 1

ACODE =01 Statics

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =02 Real Eigenvalues

5 MODE I Mode Number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or Cycle

ACODE =03 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =04 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE =05 Frequency

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE =06 Transient

5 TIME RS Time Step

6 UNDEF(2 ) None

ACODE =07 Buckling Phase 0 (Pre-buckling)

5 LSDVMN I Load set

6 UNDEF(2 ) None

ACODE =08 Buckling Phase 1 (Post-buckling)

5 LSDVMN I Mode Number

6 EIGR RS Eigenvalue

5-604 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

7 RANDID I Random ID number

ACODE =09 Complex Eigenvalues

5 MODE I Mode

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE =10 Nonlinear statics

5 LFTSFQ RS Load step or time step

6 UNDEF(2 ) None

ACODE =11 Old geometric nonlinear statics

5 LSDVMN I Load set

6 UNDEF None

7 RANDID I Random ID number

ACODE =12 CONTRAN (Can appear as ACODE=6)

5 TIME RS Time

6 UNDEF(2 ) None

End ACODE

TCODE =02 Sort 2

5 LSDVMN I Load set, Mode Number

6 UNDEF(2 ) None

End TCODE

8 RCODE I Load set or Random code ID number

9 FCODE(C) I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 MPCFORCE I 1 for MPCforce output and 0 for SPCforce


output

12 RSPEED RS Rotor speed in RUNIT units

DMAP Programmer's Guide 5-605


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

13 RUNIT CHAR4 RSPEED units; RPM, CPS, HZ, or RAD; blank


or integer 0 in a non-rotor dynamic analyses

14 UNDEF(3) None

17 RMSSF RS RMS and CRMS scale factor

18 UNDEF(5) None

23 THERMAL I =1 for heat transfer and 0 otherwise

24 UNDEF(27) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE =1 Sort 1

1 EKEY I Device code + 10* Point identification number

TCODE =02 Sort 2 - Swap with word 5 of IDENT

ACODE =01

1 EKEY I Device code + 10* Point identification number

ACODE =02

1 EKEY I Device code + 10* Point identification number

ACODE =03

1 EKEY I Device code + 10* Point identification number

ACODE =04

1 EKEY I Device code + 10* Point identification number

ACODE =05

1 FREQ RS Frequency

ACODE =06

5-606 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

1 TIME RS Time step

ACODE =07

1 EKEY I Device code + 10* Point identification number

ACODE =08

1 EKEY I Device code + 10* Point identification number

ACODE =09

1 EKEY I Device code + 10* Point identification number

ACODE =10

1 FQTS RS Frequency or Time step

ACODE =11

1 EKEY I Device code + 10* Point identification number

ACODE =12

1 EKEY I Device code + 10* Point identification number

End ACODE

End TCODE

2 TYPE I Point type: G for grid and S for scalar

FCODE =0 or 2 Real or Random Response

3 QF1 RS Constraint force in direction 1

4 QF2 RS Constraint force in direction 2

5 QF3 RS Constraint force in direction 3

6 QM1 RS Constraint moment in direction 1

7 QM2 RS Constraint moment in direction 2

8 QM3 RS Constraint moment in direction 3

FCODE =1 Real/Imaginary

3 QF1R RS Constraint force in direction 1 – Real

4 QF2R RS Constraint force in direction 2 – Real

5 QF3R RS Constraint force in direction 3 – Real

DMAP Programmer's Guide 5-607


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 QM1R RS Constraint moment in direction 1 – Real

7 QM2R RS Constraint moment in direction 2 – Real

8 QM3R RS Constraint moment in direction 3 – Real

9 QF1I RS Constraint force in direction 1 – Imaginary

10 QF2I RS Constraint force in direction 2 – Imaginary

11 QF3I RS Constraint force in direction 3 – Imaginary

12 QM1I RS Constraint moment in direction 1 – Imaginary

13 QM2I RS Constraint moment in direction 2 – Imaginary

14 QM3I RS Constraint moment in direction 3 – Imaginary

End FCODE

Data Format when Table Code = 63 (OQG contact force results)

1 EKEY I Device code + 10*Point identification number

2 TYPE I Point type, Grid or Scalar (always Grid for contact


force)

3 QF1 RS Contact force in direction X (Base C.S.)

4 QF2 RS Contact force in direction Y (Base C.S.)

5 QF3 RS Contact force in direction Z (Base C.S.)

6 QM1 RS Not used

7 QM2 RS Not used

8 QM2 RS Not used

Repeat word 1-8 for each grid point.

Data Format when Table Code = 67 (OQG glue force results for SOL 101 (ACODE=1) and SOLs
103 and 105 (ACODE=2))

1 EKEY I Device code + 10*Point identification number

2 TYPE I Point type, Grid or Scalar (always Grid for glue


force)

5-608 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 QF1 RS Glue force in direction X (Base C.S.)

4 QF2 RS Glue force in direction Y (Base C.S.)

5 QF3 RS Glue force in direction Z (Base C.S.)

6 QM1 RS Not used

7 QM2 RS Not used

8 QM2 RS Not used

Repeat word 1-8 for each grid point.

Record – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

5.31 OQGMC
Table of modal contributions of single point constraint forces.
For all analysis types (real and complex), and SORT1 and SORT2 formats.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 MCODE I Modal contributions code: 1=absolute,


2=normalized

DMAP Programmer's Guide 5-609


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

4 SUBCASE I Subcase number

5 DCODE I Dof code (10*grid ID + direction)

TCODE,1 =1 Sort 1

ACODE,4 = 05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

ACODE,4 =06 Transient

6 TIME RS Time step

7 UNDEF None

ACODE,4 =09 Complex Eigenvalues

6 EIGR RS Eigenvalue – real part

7 EIGI RS Eigenvalue – imaginary part

End ACODE,4

TCODE,1 =02 Sort 2

6 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

7 MFREQ RS Modal frequency (Hz)

End TCODE,1

8 UNDEF None

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

5-610 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 2 - DATA
Word Name Type Description

TCODE,1 =01 Sort 1

1 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

2 MFREQ RS Modal frequency (Hz)

TCODE,1 =02 Sort 2

ACODE,4 =05

1 FREQ RS Frequency (Hz)

2 UNDEF None

ACODE,4 =06

1 TIME RS Time step

2 UNDEF None

ACODE,4 =09

1 EIGR RS Eigenvalue – real part

2 EIGI RS Eigenvalue – imaginary part

End ACODE,4

End TCODE,1

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 =1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

Record 3 - TRAILER
Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

DMAP Programmer's Guide 5-611


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

5.32 OSDISP2
Table of Modal Contributions

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block Name

Record 1 – OSINT

Word Name Type Description

1–10 OSDNUM I

11–50 UNDEF (40) None

51,52 SOLNM1(2) Char4

53,54 SOLNM2(2) Char4

55–144 UNDEF(90) None

145 INUM I

146 UNDEF None

Record 2 - OSNUM

Word Name Type Description

1 ISTART I

2 IVAL I

3 AVAL RS

Record 3- Trailer

Word Name Type Description

1 UNDEF(6 ) none

Notes:
1. Records 1 and 2 may repeat in order for n number of times followed by the trailer.

5-612 DMAP Programmer's Guide


Data Block Descriptions O-V

5.33 OSHT
Output shell element thickness results
For SOLs 601/701, Sort 1 only.

Record – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block Name, e.g. OSHT1

Record – IDENT

Word Name Type Description

2 TCODE I Table Code, 60

3 ELTYPE I Element Type

11–50 UNDEF None

Record - DATA

Word Name Type Description

ELTYPE=88 TRIA3 - Nonlinear

1 EKEY I

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 THICK RS Thickness

Words 3 through 4 repeat 004 times

ELTYPE=90 QUAD4 - Nonlinear

1 EKEY I

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 THICK RS Thickness

Words 3 through 4 repeat 005 times

DMAP Programmer's Guide 5-613


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ELTYPE=240 TRIA6 - Nonlinear

1 EKEY I

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 THICK RS Thickness

Words 3 through 4 repeat 004 times

ELTYPE=241 QUAD8 - Nonlinear

1 EKEY I

2 TERM CHAR4 “CEN”

3 GRID I Grid identification number; 0 for centroid

4 THICK RS Thickness

Words 3 through 4 repeat 005 times

Record – TRAILER
Word Name Type Description

1 UNDEF(6 ) None

5.34 OSLIDE
Incremental and total slide output for contact/glue.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name, for example, OSLIDE

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

5-614 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 TCODE(C) I Table Code

3 UNDEF None

4 SUBCASE I Subcase

TCODE=1 Sort 1

ACODE=01 Statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=02 Real eigenvalues

5 MODE I Mode number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or cycle

ACODE=03 Differential stiffness 0

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=04 Differential stiffness 1

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=05 Frequency

5 FREQ RS Frequency

6 UNDEF(2) None

ACODE=06 Transient (Used for SOL 401)

5 TIME RS Time step

6 UNDEF(2) None

ACODE=07 Buckling phase 0 (pre-buckling)

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=08 Buckling phase 1 (post-buckling)

DMAP Programmer's Guide 5-615


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 LSDVMN I Mode number

6 EIGN RS Eigenvalue

7 UNDEF None

ACODE=09 Complex eigenvalues

5 MODE I Mode number

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE=10 Nonlinear statics (SOL 601/701)

5 LFTSFQ RS Time step

6 UNDEF(2) None

ACODE=11 Old geometric nonlinear statics

5 LSDVMN I Load set number

6 UNDEF(2) None

ACODE=12 CONTRAN (may appear as ACODE=6)

5 TIME RS Time step

6 UNDEF(2) None

End ACODE

TCODE=2 Sort 2

5 LSDVMN I Load set, mode number

6 UNDEF(2) None

End TCODE

8 LSDVMN I Load set number

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF None

12 PID I Physical property identification number

13 UNDEF(38) None

5-616 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE=1 SORT1

1 EKEY I Device code + 10 * grid identification number

TCODE =2 SORT2

ACODE=01 Statics

1 EKEY I Device code + 10 * grid identification number

ACODE =02 Normal modes or buckling (real eigenvalues)

1 EKEY I Device code + 10 * grid identification number

ACODE=03 Differential Stiffness 0

1 EKEY I Device code + 10 * grid identification number

ACODE =04 Differential Stiffness 1

1 EKEY I Device code + 10 * grid identification number

ACODE=05 Frequency

1 FREQ RS Frequency

ACODE=06 Transient

1 TIME RS Time step

ACODE =07 Pre-buckling

1 EKEY I Device code + 10 * grid identification number

ACODE,4 =08 Post-buckling

1 EKEY I Device code + 10 * grid identification number

ACODE,4 =09 Complex Eigenvalues

1 EKEY I Device code + 10 * grid identification number

DMAP Programmer's Guide 5-617


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE=10 Nonlinear Statics

1 FQTS RS Frequency or Time step

ACODE=11 Geometric Nonlinear Statics

1 EKEY I Device code + 10 * grid identification number

ACODE=12 CONTRAN (may appear as ACODE=6)

1 EKEY RS Device code + 10 * grid identification number

End ACODE

End TCODE

2 T1 RS Incremental slide in the x-direction of the basic


coordinate system

3 T2 RS Incremental slide in the y-direction of the basic


coordinate system

4 T3 RS Incremental slide in the z-direction of the basic


coordinate system

5 TT1 RS Total slide in the x-direction of the basic coordinate


system

6 TT2 RS Total slide in the y-direction of the basic coordinate


system

7 TT3 RS Total slide in the z-direction of the basic coordinate


system

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

Notes:

1. The results are grid point based.

2. Incremental and total slide for contact are expressed as vector quantities (magnitude and
direction) in the basic coordinate system.

5-618 DMAP Programmer's Guide


Data Block Descriptions O-V

5.35 OSPDS
Output contact separation distance results.
When SORT1 data is requested, OSPDSI1 stores the initial separation distance, and OSPDS1 stores
the final. When SORT2 data is requested, OSPDSI2 and OSPDS2 are written. The separation
distance data is output during the statics portion of a solution. For example, a STATSUB being used
when running a normal modes solution (SOL 103).

Record - HEADER

Word Name Type Description

1-2 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code


64 for Initial Separation Distance
65 for Deformed Separation Distance

3 UNDEF None

4 SUBCASE I Subcase

TCODE,1 =1 Sort 1

ACODE,4=01 SOL 101 Linear Statics

5 LSDVMN I Load set number

6 UNDEF(2) None

End ACODE

TCODE,1=02 Sort 2

5 EKEY I Device code + 10*point identification number

End
TCODE

6 UNDEF(2 ) None

DMAP Programmer's Guide 5-619


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 LSDVMN I Load set number

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(1) None

12 PID I Physical Property ID

13 UNDEF(38) None

51 TITLE(32) CHAR4 Title

83 SUBTITLE(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1 =01 Sort 1

1 EKEY I Device code + 10* Point identification number

TCODE,1 =02 Sort 2 - Swap with word 5 of IDENT

ACODE,4 =01

1 EKEY I Device code + 10* Point identification number

ACODE,4 =10 601/701 Nonlinear

1 TIME RS Time step

End ACODE,4

End TCODE,1

2 SDIS RS Contact separation distance

Record - TRAILER

Word Name Type Description

1 UNDEF(6) None

5-620 DMAP Programmer's Guide


Data Block Descriptions O-V

5.36 OSTRMC
Table of modal contributions of element strains.
For all analysis types (real and complex), and SORT1 and SORT2 formats.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record 1 - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 MCODE I Modal contributions code: 1=absolute,


2=normalized

4 SUBCASE I Subcase number

5 EICODE I Element item code (1000*element ID + item code)

TCODE,1 =1 Sort 1

ACODE,4 = 05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

ACODE,4 =06 Transient

6 TIME RS Time step

7 UNDEF None

ACODE,4 =09 Complex Eigenvalues

6 EIGR RS Eigenvalue – real part

7 EIGI RS Eigenvalue – imaginary part

End ACODE,4

DMAP Programmer's Guide 5-621


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,1 =02 Sort 2

6 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

7 MFREQ RS Modal frequency (Hz)

End TCODE,1

8 UNDEF None

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record 2 - DATA

Word Name Type Description

TCODE,1 =01 Sort 1

1 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

2 MFREQ RS Modal frequency (Hz)

TCODE,1 =02 Sort 2

ACODE,4 =05

1 FREQ RS Frequency (Hz)

2 UNDEF None

ACODE,4 =06

1 TIME RS Time step

2 UNDEF None

ACODE,4 =09

5-622 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

1 EIGR RS Eigenvalue – real part

2 EIGI RS Eigenvalue – imaginary part

End ACODE,4

End TCODE,1

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 =1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

Record 3 - TRAILER
Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

5.37 OTEMP
Table of grid point temperatures.

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block Name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record – IDENT
Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

DMAP Programmer's Guide 5-623


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 TCODE(C) I Table Code

3 UNDEF None

4 SUBCASE I Subcase or random identification number

5 TIMESTEP RS Current time step

6 UNDEF(3) None

9 FCODE I Format code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record – DATA

Word Name Type Description

1 EKEY I Device code + 10*Point identification number

2 TEMP RS Grid point temperature

Record – TRAILER

Word Name Type Description

1 UNDEF(6) None

5.38 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.

5-624 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 DATCOD I Data code:


0 = rigid body motion included
1 = rigid body motion excluded

4 SUBCASE I Subcase or Random identification number

TCODE,1 =1 Sort 1

ACODE,4 =01 Statics

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE,4 =02 Real Eigenvalues

5 MODE I Mode Number

6 EIGN RS Eigenvalue

7 MODECYCL RS Mode or Cycle

ACODE,4 =03 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE,4 =04 Differential Stiffness

5 LSDVMN I Load set number

6 UNDEF(2 ) None

ACODE,4 =05 Frequency

DMAP Programmer's Guide 5-625


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 FREQ RS Frequency

6 UNDEF None

7 RANDOM ID I Random identification number

ACODE,4 =06 Transient

5 TIME RS Time Step

6 UNDEF(2 ) None

ACODE,4 =07 Buckling Phase 0 (Pre-buckling)

5 LSDVMN I Load set

6 UNDEF(2 ) None

ACODE,4 =08 Buckling Phase 1 (Post-buckling)

5 LSDVMN I Mode Number

6 EIGR RS Eigenvalue

7 RANDID I Random ID number

ACODE,4 =09 Complex Eigenvalues

5 MODE I Mode

6 EIGR RS Eigenvalue (real)

7 EIGI RS Eigenvalue (imaginary)

ACODE,4 =10 Nonlinear statics

5 LFTSFQ RS Load step

6 UNDEF(2 ) None

ACODE,4 =11 Old geometric nonlinear statics

5 LSDVMN I Load set

6 UNDEF None

7 RANDID I Random ID number

ACODE,4 =12 CONTRAN (Can appear as ACODE=6)

5 TIME RS Time

6 UNDEF(2 ) None

5-626 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

End ACODE,4

TCODE,1 =02 Sort 2

5 LSDVMN I Load set, Mode Number

6 UNDEF(2 ) None

End TCODE,1

8 RCODE I Random code ID number

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(2) None

13 ACFLAG(C) I Acoustic presure flag

14 UNDEF(3) None

17 RMSSF RS RMS and CRMS scale factor

18 UNDEF(5) None

23 THERMAL I 1 for heat transfer and 0 otherwise

24 RSPEED RS Rotor speed in RUNIT units

25 RUNIT CHAR4 RSPEED units; RPM, CPS, HZ, or RAD; blank


or integer 0 in a non-rotor dynamic analyses

26 UNDEF(25) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1 =01 Sort 1

1 EKEY I Device code + 10* Point identification number

TCODE,1 =02 Sort 2 - Swap with word 5 of IDENT

DMAP Programmer's Guide 5-627


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE,4 =01

1 EKEY I 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

Word Name Type Description

1 EKEY I Device code + 10* Point identification number

End ACODE,4

End TCODE,1

5-628 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

2 TYPE I Point type:


=1, GRID Point
=2, Scalar Point
=3, Extra Point
=4, Modal
=5, p-elements, 0–DOF
=6, p-elements, number of DOF

TABLCODE=01 Displacement - TablCode=MOD(TCODE,1000)

TCODE,2 =01

ACFLAG =0 Real

TCODE,7 =0 or 2 Real or Random Response

3 DT1 RS Translation in direction 1

4 DT2 RS Translation in direction 2

5 DT3 RS Translation in direction 3

6 DR1 RS Rotation in direction 1

7 DR2 RS Rotation in direction 2

8 DR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 DT1R RS Translation in direction 1

4 DT2R RS Translation in direction 2

5 DT3R RS Translation in direction 3

6 DR1R RS Rotation in direction 1

7 DR2R RS Rotation in direction 2

8 DR3R RS Rotation in direction 3

9 DT1I RS Translation in direction 1 - imaginary

10 DT2I RS Translation in direction 2 - imaginary

11 DT3I RS Translation in direction 3 - imaginary

12 DR1I RS Rotation in direction 1 - imaginary

13 DR2I RS Rotation in direction 2 - imaginary

DMAP Programmer's Guide 5-629


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

14 DR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

ACFLAG =2 Acoustic Pressure

TCODE,7 =0 or 2 Real or Random Response

3 P RS Sound pressure level

4 PRMS RS RMS Sound pressure level

5 DB RS Sound pressure level in dB

6 DBA RS Sound pressure level in dBA

7 UNDEF(2 ) None

TCODE,7 =1 Real/ Imaginary

3 PR RS Sound pressure level

4 PRMSR RS RMS Sound pressure level

5 DBR RS Sound pressure level in dB

6 DBAR RS Sound pressure level in dBA

7 PI RS Sound pressure level - imaginary

8 PRMSI RS RMS Sound pressure level - imaginary

9 DBI RS Sound pressure level in dB - imaginary

10 DBAI RS Sound pressure level in dBA - imaginary

11 UNDEF(4 ) None

End TCODE,7

End ACFLAG

Word Name Type Description

TCODE,2 =07 Eigenvector Displacement

TCODE,7 =0 or 2 Real or Random Response

5-630 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 DT1 RS Translation in direction 1

4 DT2 RS Translation in direction 2

5 DT3 RS Translation in direction 3

6 DR1 RS Rotation in direction 1

7 DR2 RS Rotation in direction 2

8 DR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 DT1R RS Translation in direction 1

4 DT2R RS Translation in direction 2

5 DT3R RS Translation in direction 3

6 DR1R RS Rotation in direction 1

7 DR2R RS Rotation in direction 2

8 DR3R RS Rotation in direction 3

9 DT1I RS Translation in direction 1 - imaginary

10 DT2I RS Translation in direction 2 - imaginary

11 DT3I RS Translation in direction 3 - imaginary

12 DR1I RS Rotation in direction 1 - imaginary

13 DR2I RS Rotation in direction 2 - imaginary

14 DR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =10 Velocity

TCODE,7 =0 or 2 Real or Random Response

3 VT1 RS Translation in direction 1

4 VT2 RS Translation in direction 2

5 VT3 RS Translation in direction 3

DMAP Programmer's Guide 5-631


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 VR1 RS Rotation in direction 1

7 VR2 RS Rotation in direction 2

8 VR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 VT1R RS Translation in direction 1

4 VT2R RS Translation in direction 2

5 VT3R RS Translation in direction 3

6 VR1R RS Rotation in direction 1

7 VR2R RS Rotation in direction 2

8 VR3R RS Rotation in direction 3

9 VT1I RS Translation in direction 1 - imaginary

10 VT2I RS Translation in direction 2 - imaginary

11 VT3I RS Translation in direction 3 - imaginary

12 VR1I RS Rotation in direction 1 - imaginary

13 VR2I RS Rotation in direction 2 - imaginary

14 VR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =11 Acceleration

TCODE,7 =0 or 2 Real or Random Response

3 AT1 RS Translation in direction 1

4 AT2 RS Translation in direction 2

5 AT3 RS Translation in direction 3

6 AR1 RS Rotation in direction 1

7 AR2 RS Rotation in direction 2

8 AR3 RS Rotation in direction 3

5-632 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7 =1 Real/ Imaginary

3 AT1R RS Translation in direction 1

4 AT2R RS Translation in direction 2

5 AT3R RS Translation in direction 3

6 AR1R RS Rotation in direction 1

7 AR2R RS Rotation in direction 2

8 AR3R RS Rotation in direction 3

9 AT1I RS Translation in direction 1 - imaginary

10 AT2I RS Translation in direction 2 - imaginary

11 AT3I RS Translation in direction 3 - imaginary

12 AR1I RS Rotation in direction 1 - imaginary

13 AR2I RS Rotation in direction 2 - imaginary

14 AR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =14 Eigenvector Displacement (Solution Set)

TCODE,7 =0 or 2 Real or Random Response

3 DT1 RS Translation in direction 1

4 DT2 RS Translation in direction 2

5 DT3 RS Translation in direction 3

6 DR1 RS Rotation in direction 1

7 DR2 RS Rotation in direction 2

8 DR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 DT1R RS Translation in direction 1

4 DT2R RS Translation in direction 2

DMAP Programmer's Guide 5-633


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

5 DT3R RS Translation in direction 3

6 DR1R RS Rotation in direction 1

7 DR2R RS Rotation in direction 2

8 DR3R RS Rotation in direction 3

9 DT1I RS Translation in direction 1 - imaginary

10 DT2I RS Translation in direction 2 - imaginary

11 DT3I RS Translation in direction 3 - imaginary

12 DR1I RS Rotation in direction 1 - imaginary

13 DR2I RS Rotation in direction 2 - imaginary

14 DR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =15 Displacement (Solution Set)

TCODE,7 =0 or 2 Real or Random Response

3 DT1 RS Translation in direction 1

4 DT2 RS Translation in direction 2

5 DT3 RS Translation in direction 3

6 DR1 RS Rotation in direction 1

7 DR2 RS Rotation in direction 2

8 DR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 DT1R RS Translation in direction 1

4 DT2R RS Translation in direction 2

5 DT3R RS Translation in direction 3

6 DR1R RS Rotation in direction 1

7 DR2R RS Rotation in direction 2

5-634 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 DR3R RS Rotation in direction 3

9 DT1I RS Translation in direction 1 - imaginary

10 DT2I RS Translation in direction 2 - imaginary

11 DT3I RS Translation in direction 3 - imaginary

12 DR1I RS Rotation in direction 1 - imaginary

13 DR2I RS Rotation in direction 2 - imaginary

14 DR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =16 Velocity (Solution Set)

TCODE,7 =0 or 2 Real or Random Response

3 VT1 RS Translation in direction 1

4 VT2 RS Translation in direction 2

5 VT3 RS Translation in direction 3

6 VR1 RS Rotation in direction 1

7 VR2 RS Rotation in direction 2

8 VR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 VT1R RS Translation in direction 1

4 VT2R RS Translation in direction 2

5 VT3R RS Translation in direction 3

6 VR1R RS Rotation in direction 1

7 VR2R RS Rotation in direction 2

8 VR3R RS Rotation in direction 3

9 VT1I RS Translation in direction 1 - imaginary

10 VT2I RS Translation in direction 2 - imaginary

DMAP Programmer's Guide 5-635


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

11 VT3I RS Translation in direction 3 - imaginary

12 VR1I RS Rotation in direction 1 - imaginary

13 VR2I RS Rotation in direction 2 - imaginary

14 VR3I RS Rotation in direction 3 - imaginary

End TCODE,7

Word Name Type Description

TCODE,2 =17 Acceleration (Solution Set)

TCODE,7 =0 or 2 Real or Random Response

3 AT1 RS Translation in direction 1

4 AT2 RS Translation in direction 2

5 AT3 RS Translation in direction 3

6 AR1 RS Rotation in direction 1

7 AR2 RS Rotation in direction 2

8 AR3 RS Rotation in direction 3

TCODE,7 =1 Real/ Imaginary

3 AT1R RS Translation in direction 1

4 AT2R RS Translation in direction 2

5 AT3R RS Translation in direction 3

6 AR1R RS Rotation in direction 1

7 AR2R RS Rotation in direction 2

8 AR3R RS Rotation in direction 3

9 AT1I RS Translation in direction 1 - imaginary

10 AT2I RS Translation in direction 2 - imaginary

11 AT3I RS Translation in direction 3 - imaginary

12 AR1I RS Rotation in direction 1 - imaginary

13 AR2I RS Rotation in direction 2 - imaginary

5-636 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

14 AR3I RS Rotation in direction 3 - imaginary

End TCODE,7

End TCODE,2

Record - TRAILER

Word Name Type Description

1 UNDEF(6 ) None

5.39 OUGGC
Table of grid contributions.
For frequency analysis types (complex), and SORT1 and SORT2 formats.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 GCODE I Grid contributions code: 1=absolute (modal),


2=normalized (modal), -1=absolute (direct),
-2=normalized (direct)

4 SUBCASE I Subcase number

5 DCODE I Acoustic dof code (10*grid ID + direction)

TCODE,1=01 Sort 1

DMAP Programmer's Guide 5-637


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

ACODE,4=05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

End ACODE,4

TCODE,1=02 Sort 2

6 GID I Grid ID (0 for TOTAL)

7 UNDEF None

End TCODE,1

8 DATTYP I Data Type (1=pressure, 2=first derivative,


3=second derivative)

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1=01 Sort 1

1 GID I Grid ID (0 for TOTAL)

2 UNDEF None

TCODE,1=02 Sort 2

1 FREQ RS Frequency (Hz)

2 UNDEF None

End TCODE,1

TCODE,2=01 Pressure

5-638 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,7=01 Real/Imaginary

3 GCR RS Grid contribution – real part

4 GCI RS Grid contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=10 First derivative of pressure

TCODE,7=01 Real/Imaginary

3 GCR RS Grid contribution – real part

4 GCI RS Grid contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=11 Second derivative of pressure

TCODE,7=01 Real/Imaginary

3 GCR RS Grid contribution – real part

4 GCI RS Grid contribution – imaginary part

End TCODE,7

Record - TRAILER

Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

5.40 OUGMC
Table of modal contributions for displacements, velocities, accelerations.
For all analysis types (real and complex), and SORT1 and SORT2 formats.

DMAP Programmer's Guide 5-639


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code (TCODE,2 = 1 for displacement;


TCODE,2 = 10 for velocity; TCODE,2 = 11 for
acceleration)

3 MCODE I Modal contributions code: 1=absolute structural,


2=normalized structural; 11=absolute fluid;
12=normalized fluid

4 SUBCASE I Subcase number

5 DCODE I DOF code (10*grid ID + direction)


Direction has the following values:
=0, Pressure
=1, X-displacement
=2, Y-displacement
=3, Z-displacement
=4, RX-displacement
=5, RY-displacement
=6, RZ-displacement

TCODE,1 = 1 Sort 1

ACODE,4 = 05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

ACODE,4 =06 Transient

6 TIME RS Time step

7 UNDEF None

ACODE,4 =09 Complex Eigenvalues

5-640 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 EIGR RS Eigenvalue – real part

7 EIGI RS Eigenvalue – imaginary part

End ACODE,4

TCODE,1 =02 Sort 2

PANFLG = 1 Panel data

6 PNAME(2) CHAR4 Panel name

PANFLG = 0 Not panel data

6 MODE I Mode number (0 for TOTAL; -1 for constraint


modes)

7 MFREQ RS Modal frequency (Hz)

End PANFLG

End TCODE,1

8 DATTYP I Data Type (1=displacement, 2=velocity,


3=acceleration)

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 NOMC(C) I Number of modal contribution data sets

12 NUMPAN(C) I Number of panels

13 PANFLG I Panel flag (1 = panel data; 0 = mode data)

14 UNDEF(37) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1 = 01 Sort 1

1 MODE I Mode number (0 for TOTAL)

DMAP Programmer's Guide 5-641


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

2 MFREQ RS Modal frequency (Hz)

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

4 MODE I Mode number (-1 for constraint modes)

5 MFREQ RS Modal frequency (Hz)

6 MC RS Modal contribution

Words 4–6 repeat NOMC times

End TCODE,7 = 0 or 2

TCODE,7 = 1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

5 MODE I Mode number (-1 for constraint modes)

6 MFREQ RS Modal frequency (Hz)

7 MCR RS Modal contribution – real part

8 MCI RS Modal contribution – imaginary part

Words 5–8 repeat NOMC times

The remaining definitions only exist if NUMPAN > 0

9 MODE I Mode number (-1 for constraint modes)

10 MFREQ RS Modal frequency (Hz)

11 MCR RS Modal contribution - real part

12 MCI RS Modal contribution - imaginary part

13 PNAME(2) CHAR4 Panel name

15 PCR RS Panel contribution – real part

16 PCI RS Panel contribution – imaginary part

Words 13–16 repeat NUMPAN times

Words 9–16 repeat NOMC times

End TCODE,7 = 1

5-642 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

TCODE,1 = 02 Sort 2

ACODE,4 =05 Frequency response

1 FREQ RS Frequency (Hz)

2 UNDEF None

ACODE,4 = 06 Transient response

1 TIME RS Time step

2 UNDEF None

ACODE,4 = 09 Complex eigenvalues

1 EIGR RS Eigenvalue – real part

2 EIGI RS Eigenvalue – imaginary part

End ACODE,4

TCODE,7 =0 or 2 Real

3 MC RS Modal contribution

TCODE,7 =1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2 = 10 Velocity

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 = 1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

DMAP Programmer's Guide 5-643


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TCODE,2 = 11 Acceleration

TCODE,7 = 0 or 2 Real

3 MC RS Modal contribution

TCODE,7 = 1 Real/ Imaginary

3 MCR RS Modal contribution – real part

4 MCI RS Modal contribution – imaginary part

End TCODE,7

Record - TRAILER

Word Name Type Description

1 NREC I Number of records

2 UNDEF(5) None

5.41 OUGPC
Table of panel contributions.
For frequency analysis types (complex), and SORT1 and SORT2 formats.

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT

Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

5-644 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 PCODE I Panel contributions code: 1=absolute (modal),


2=normalized (modal), -1=absolute (direct),
-2=normalized (direct)

4 SUBCASE I Subcase number

5 DCODE I Acoustic dof code (10*grid ID + direction)


Direction has the following values:
=0, Pressure
=1, X-displacement
=2, Y-displacement
=3, Z-displacement
=4, RX-displacement
=5, RY-displacement
=6, RZ-displacement

TCODE,1=01 Sort 1

ACODE,4=05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

End ACODE,4

TCODE,1=02 Sort 2

6 PNAME(2) CHAR4 Panel name (0 for TOTAL)

End TCODE,1

8 DATTYP I Data Type (1=pressure, 2=first derivative,


3=second derivative)

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

DMAP Programmer's Guide 5-645


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record - DATA

Word Name Type Description

TCODE,1=01 Sort 1

1 PNAME(2) CHAR4 Panel name (0 for TOTAL)

TCODE,1=02 Sort 2

1 FREQ RS Frequency (Hz)

2 UNDEF None

End TCODE,1

TCODE,2=01 Pressure

TCODE,7=01 Real/Imaginary

3 PCR RS Panel contribution – real part

4 PCI RS Panel contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=10 First derivative of pressure

TCODE,7=01 Real/Imaginary

3 PCR RS Panel contribution – real part

4 PCI RS Panel contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=11 Second derivative of pressure

TCODE,7=01 Real/Imaginary

3 PCR RS Panel contribution – real part

4 PCI RS Panel contribution – imaginary part

End TCODE,7

5-646 DMAP Programmer's Guide


Data Block Descriptions O-V

Record - TRAILER
Word Name Type Description

1 NREC I Number of records

2 UNDEF(5 ) None

5.42 OUGRC
Table of reciprocal panel contributions.
For frequency analysis types (complex), and SORT1 and SORT2 formats.

Record - HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 WORD I No Def or Month, Year, One, One

Word 3 repeats until End of Record

Record - IDENT
Word Name Type Description

1 ACODE(C) I Device code + 10*Approach Code

2 TCODE(C) I Table Code

3 PCODE I Reciprocal panel contributions code: 1=absolute


(modal), 2=normalized (modal), -1=absolute
(direct), -2=normalized (direct)

4 SUBCASE I Subcase number

5 DCODE I Acoustic dof code (10*grid ID + direction)

TCODE,1=01 Sort 1

ACODE,4=05 Frequency

6 FREQ RS Frequency (Hz)

7 UNDEF None

End ACODE,4

TCODE,1=02 Sort 2

DMAP Programmer's Guide 5-647


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

6 PNAME(2) CHAR4 Panel name (0 for TOTAL)

End TCODE,1

8 DATTYP I Data Type (1=displacement, 2=velocity,


3=acceleration)

9 FCODE I Format Code

10 NUMWDE I Number of words per entry in DATA record

11 UNDEF(40) None

51 TITLE(32) CHAR4 Title

83 SUBTITL(32) CHAR4 Subtitle

115 LABEL(32) CHAR4 Label

Record - DATA

Word Name Type Description

TCODE,1=01 Sort 1

1 PNAME(2) CHAR4 Panel name (0 for TOTAL)

TCODE,1=02 Sort 2

1 FREQ RS Frequency (Hz)

2 UNDEF None

End TCODE,1

TCODE,2=01 Displacement

TCODE,7=01 Real/Imaginary

3 PCR RS Reciprocal panel contribution – real part

4 PCI RS Reciprocal panel contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=02 Velocity

TCODE,7=01 Real/Imaginary

5-648 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

3 PCR RS Reciprocal panel contribution – real part

4 PCI RS Reciprocal panel contribution – imaginary part

End TCODE,7

Word Name Type Description

TCODE,2=03 Acceleration

TCODE,7=01 Real/Imaginary

3 PCR RS Reciprocal panel contribution – real part

4 PCI RS Reciprocal panel contribution – imaginary part

End TCODE,7

Record - TRAILER

Word Name Type Description

1 NREC I Number of records

2 UNDEF(5) None

5.43 R1MAP
Table of mapping from original first level
(Direct) Retained Responses

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – RESPONSE

Word Name Type Description

1 IRID I Internal response identification number

Word 1 repeats until End of Record

DMAP Programmer's Guide 5-649


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 2 – TRAILER

Word Name Type Description

1 WORD1 I Number of responses

2 UNDEF(5 ) None

5.44 R1TAB
Table of type one response attributes

Record - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record - Repeat

Word Name Type Description

1 IRID I Internal response identification number

2 RID I External response identification number

3 TYPE(C) I Response type

4 LABEL(2) CHAR4 Label

6 REGION I Region identifier

7 SCID I Subcase identification number

Word Name Type Description

TYPE =1 WEIGHT

8 ATTA I Weight DRESP1 ATTA entry or default=3

9 ATTB I Weight DRESP1 ATTB entry or default=3

10 UNDEF(3) None

TYPE =2 VOLUME

8 UNDEF(5) None

TYPE =3 LAMA

5-650 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 MODE I Mode number

9 APRX I Approximation code

10 UNDEF(3 ) None

TYPE =4 EIGN or FREQ

8 MODE I Mode number

9 APRX I Approximation code

10 UNDEF(3 ) None

TYPE =5 DISP

8 COMP I Displacement component

9 UNDEF None

10 GRID I Grid identification number

11 UNDEF(2 ) None

TYPE =6 STRESS

8 ICODE I Stress item code

9 UNDEF None

10 ELID I Element identification number

11 UNDEF(2 ) None

TYPE =7 STRAIN

8 ICODE I Strain item code

9 UNDEF None

10 ELID I Element identification number

11 UNDEF(2 ) None

TYPE =8 FORCE

8 ICODE I Force item code

9 UNDEF None

10 ELID I Element identification number

DMAP Programmer's Guide 5-651


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

11 UNDEF(2 ) None

TYPE =9 CFAILURE

8 ICODE I Failure criterion item code

9 PLY I Lamina number

10 ELID I Element identification number

11 UNDEF(2 ) None

TYPE =10 CSTRESS

8 ICODE I Stress item code

9 PLY I Lamina number

10 ELID I Element identification number

11 UNDEF(2 ) None

TYPE =11 CSTRAIN

8 ICODE I Strain item code

9 PLY I Lamina number

10 ELID I Element identification number

11 UNDEF(2 ) None

TYPE =13 SPCFORCE

8 ICODE I SPC force component

9 UNDEF None

10 GRID I Grid identification number

11 UNDEF(2 ) None

TYPE =14 ESE

8 ICODE I Strain energy item code

9 UNDEF None

10 ELID I Element identification number

11 UNDEF(2) None

TYPE =15 CEIG

5-652 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

8 MODE I Mode number

9 ICODE I 1: Real component or 2: Imaginary component

10 UNDEF(3) None

TYPE =19 ERP

8 COMP I Subcase ID + 100

9 UNDEF None

10 SET3 I Panel SET3 identification number

11 FREQ RS Frequency

12 UNDEF None

Word Name Type Description

TYPE =20 FRDISP or PRES

8 COMP I Displacement or Acoustic pressure component

9 UNDEF None

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =21 FRVELO

8 COMP I Velocity component

9 UNDEF None

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

DMAP Programmer's Guide 5-653


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

TYPE =22 FRACCL

8 COMP I Acceleration Component

9 UNDEF None

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =23 FRSPCF

8 COMP I SPCForce Component

9 UNDEF None

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =24 FRSTRE

8 ICODE I Stress item code

9 UNDEF None

10 ELID I Element identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =25 FRFORC

8 ICODE I Force item code

9 UNDEF None

5-654 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

10 ELID I Element identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =26 RMSDISP

8 COMP I RMS Displacement component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

11 DMFREQ RS Dummy frequency for internal use

12 UNDEF None

TYPE =27 RMSVELO

8 COMP I RMS Velocity component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

11 DMFREQ RS Dummy frequency for internal use

12 UNDEF None

TYPE =28 RMSACCL

8 COMP I RMS Acceleration component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

11 DMFREQ RS Dummy frequency for internal use

12 UNDEF None

TYPE =29 PSDDISP

8 COMP I PSD of Displacement component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

DMAP Programmer's Guide 5-655


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =30 PSDVELO

8 COMP I PSD of Velocity component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =31 PSDACCL

8 COMP I PSD of Acceleration component

9 RANDPS I RANDPS entry identification number

10 GRID I Grid identification number

11 FREQ RS Frequency

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

Word Name Type Description

TYPE =60 TDISP

8 COMP I Displacement component

9 UNDEF None

10 GRID I Grid identification number

11 TIME RS Time step

5-656 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =61 TVELO

8 COMP I Velocity component

9 UNDEF None

10 GRID I Grid identification number

11 TIME RS Time step

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =62 TACCL

8 COMP I Acceleration component

9 UNDEF None

10 GRID I Grid identification number

11 TIME RS Time step

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =63 TSPCF

8 COMP I SPCForce component

9 UNDEF None

10 GRID I Grid identification number

11 TIME RS Time step

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =64 TSTRE

DMAP Programmer's Guide 5-657


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

8 ICODE I Stress item code

9 UNDEF None

10 ELID I Element identification number

11 TIME RS Time step

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

TYPE =65 TFORCE

8 ICODE I Force item code

9 UNDEF None

10 ELID I Element identification number

11 TIME RS Time step

12 IFLAG I Integrated response flag. See Remark 20 of


DRESP1.
Value is -1 to -6, for SUM, AVG, SSQ, RSS,
MAX, MIN, respectively. Otherwise, 0.

Word Name Type Description

TYPE =81 DIVERG

8 ROOT I Root number

9 UNDEF(2 ) None

11 MACH RS Mach number

12 DIVERG I DIVERG identification number

TYPE =82 TRIM

8 XID I AESTAT or AESURF identification number

9 UNDEF(3 ) None

12 TRIM I TRIM identification number

TYPE =83 STABDER

8 XID I AESTAT or AESURF identification number

5-658 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 COMP I Component

10 RESFLG I Restraint flag

11 UNDEF None

12 TRIM I TRIM identification number

TYPE =84 FLUTTER

8 MODE I Mode number

9 MACH RS Mach numbers

10 VELOC RS Velocity

11 DENSITY RS Density

12 FLUTTER I Flutter identification number

End TYPE

13 UNDEF(2) None

15 SEID I Superelement identification number, where


applicable.

Record - TRAILER

Word Name Type Description

1 NR1 I Number of type one responses (number of


records in table)

2 UNDEF(5) None

Notes:

1. Table is in IRID order and is in the order in which responses are to be generated.

2. TYFLG currently has no meaning. The intent was to use this attribute to identify responses that
should always be retained in DSAD. However, this option is not currently supported.

5.45 RESP3
Table of second level (synthetic) responses computed by an external user-supplied program.

DMAP Programmer's Guide 5-659


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 - Repeat - for each Type 3 response

Word Name Type Description

1 IR3ID I Internal response identification number

2 R3ID I External response identification number

3 SUBID I Subcase identification number

4 LABEL(2) CHAR4 Label

6 GROUP(2) CHAR4 Group defined on an FMS CONNECT statement

8 TYPE(2) CHAR4 User-created response calculation type in the


external user-supplied program

10 REG I Region identification number

11 ND(C) I Number of design variables

12 NC(C) I Number of constants from constant table (Data


block DTB)

13 NR(C) I Number of type one responses

14 NCORD(C) I Number of coordinates

15 NPROP1(C) I Number of type one properties

16 NCONP1(C) I Number of type one connectivity properties

17 NMATP1(C) I Number of type one material properties

18 NPROP2(C) I Number of type two properties

19 NCONP2(C) I Number of type two connectivity properties

20 NMATP2(C) I Number of type two material properties

21 NRR2(C) I Number of referenced type two responses

22 NSTR(C) I Number of CHAR4 words of USRDATA (rounded


to an even number)

23 IDV I Internal design variable identification number

5-660 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

Word 23 repeats ND times

24 CVLT1 RS Table constant

Word 24 repeats NC times

25 IR1ID I Type one response identification number

Word 25 repeats NR times

26 NODE I Node number

27 DIR I Direction

Words 26 through 27 repeat NCORD times

28 PROP1ID I Type one property identification number

Word 28 repeats NPROP1 times

29 CONP1ID I Type one connectivity property identification


number

Word 29 repeats NCONP1 times

30 MATP1ID I Type one material property identification number

Word 30 repeats NMATP1 times

31 PROP2ID I Type two property identification number

Word 31 repeats NPROP2 times

32 CONP2ID I Type two connectivity property identification


number

Word 32 repeats NCONP2 times

33 MATP2ID I Type two material property identification number

Word 33 repeats NMATP2 times

34 IR2ID I Type two response identification number

Word 34 repeats NRR2 times

35 USRDATA CHAR4 User input data

Word 35 repeats NSTR times

DMAP Programmer's Guide 5-661


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 2 - TRAILER

Word Name Type Description

1 NRP3 I Number of records (type 3 responses) in the


table

2 MAXL I Maximum record length

3 UNDEF(4) None

5.46 RESP12
Table of second level (synthetic) responses

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 - Repeat - for each Type 2 response

Word Name Type Description

1 IR2ID I Internal response identification number

2 R2ID I External response identification number

3 SUBID I Subcase external identification number

4 LABEL(2) CHAR4 Label

6 EQID I Equation external identification number, or


mathematical function flag when negative

7 REG I Region identification number

8 ND(C) I Number of design variables

9 NC(C) I Number of constants from constant table (Data


block DTB)

10 NR(C) I Number of type one responses

11 NCORD(C) I Number of coordinates

12 NPROP1(C) I Number of type one properties (DVPREL1)

5-662 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

13 NCONP1(C) I Number of type one connectivity properties


(DVCREL1)

14 NMATP1(C) I Number of type one material properties


(DVMREL1)

15 NPROP2(C) I Number of type two properties (DVPREL2)

16 NCONP2(C) I Number of type two connectivity properties


(DVCREL2)

17 NMATP2(C) I Number of type two material properties


(DVMREL2)

18 NRR2(C) I Number of referenced type two responses


(DRESP2)

19 ARGDSP I Number of discrepancy on arguments

20 NCEQ(C) I Number of constants from equation table (Data


block DEQATN)

21 IDV I Design variable internal identification number

Word 21 repeats ND times

22 CVLT1 RS Table constant

Word 22 repeats NC times

23 IR1ID I Type one response internal identification number

Word 23 repeats NR times

24 NODE I Node number

25 DIR I Direction

Words 24 through 25 repeat NCORD times

26 PROP1ID I Type one property (DVPREL1) internal


identification number

Word 26 repeats NPROP1 times

27 CONP1ID I Type one connectivity property (DVCREL1)


internal identification number

Word 27 repeats NCONP1 times

DMAP Programmer's Guide 5-663


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

28 MATP1ID I Type one material property (DVMREL1) internal


identification number

Word 28 repeats NMATP1 times

29 PROP2ID I Type two property (DVPREL2) internal


identification number

Word 29 repeats NPROP2 times

30 CONP2ID I Type two connectivity property (DVCREL2)


internal identification number

Word 30 repeats NCONP2 times

31 MATP2ID I Type two material property (DVMREL2) internal


identification number

Word 31 repeats NMATP2 times

32 IR2ID I Type two response (DRESP2) internal


identification number

Word 32 repeats NRR2 times

33 CVLQ RS Equation constant

Word 33 repeats NCEQ times

34 RC I Record count

35 ARGS I Number of arguments

36 OSCAR I Oscar type; always 13

37 DEQA CHAR4 "DEQA"

38 RECNUM I Record number

39 BIT I Bitwise OR of the DEQATN external identification


number and bit 32 (in LP), or bit 64 (in ILP)

40 TLC(C) I Temporary VPS location count

41 TEMPVPS I Temporary VPS locations

Word 41 repeats TLC times

42 IC(C) I Instruction word count

43 INST CHAR4 Instruction character word

5-664 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

44 INSTI(3) I Instruction integer words

Words 43 through 46 repeat IC/4 times

47 DATATYP I Temporary VPS value section

DATATYP =1 Integer input

48 INT I Integer

DATATYP =2 Real input

48 REAL RS Real

DATATYP =3 Character input

48 CHARS(2) CHAR4 Character

End DATATYP

Words 47 through max repeat until End of Record

Record 2 - TRAILER

Word Name Type Description

1 NRP2 I Number of records (type 2 responses) in the


table

2 MAXL I Maximum record length

3 MAXEQ I Maximum value of EQPOS - 1 for all the records

4 UNDEF(3 ) None

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.47 SEMAP
Superelement Definition Table (Map)
Provides geometry and connection information for a problem formulated in terms of superelements.

DMAP Programmer's Guide 5-665


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 - DEFINE

Repeated for each superelement according to process order

Word Name Type Description

1 SEID I Super element identification number

2 INTIDX I Internal index of superelement

3 ORDER I Processing order

4 SEDN I Downstream superelement identification number

5 SEDWNIDX I Internal index of downstream superelement

6 PEID I Primary superelement identification number

7 TYPEBIT I Superelement type bit map (See note 3)

8 NODNCNCT I Number of downstream connections

9 BITINFO I On bits correspond to connected downstream


SE’s

Word 9 repeats LENTRY-1 times

Words 8 through 9 repeat NBRSE times

10 NLBL I Number of SELABEL entries

11 NWLBL(C) I Number of words in label

12 SEID I Super element identification number

13 LABELI CHAR4 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

5-666 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

1 GRIDID I Grid point identification number

2 GRIDBIT I Grid point bit map

Word 2 repeats LENTRY-1 times

Record 3 - INFO
Repeated for each superelement according to process order

Word Name Type Description

1 SEID I Superelement identification number

2 BITNO I Bit number for superelement

3 NG(C) I Number of exterior grid points

4 NE(C) I Number of elements NE=NBR of simple+genel+rigid

5 PEID I Primary superelement identification number

6 SEBITS I Superelement type bit map (See Note 3)

7 SEDWN I Downstream superelement identification number

8 BITDWN I Bit number of downstream superelement

9 EXTGRD I 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 Name Type Description

1 NBRSE I Number of superelements including residual


(NBRSE+1)

2 NBRGP I Total number of grid and scalar points in structure

DMAP Programmer's Guide 5-667


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

3 NBRSCL I Number of scalar points

4 LENTRY I Number of words per entry in RECORD=MAP

5 NBRSEC I Number of secondary superelements

6 NWDDEF I 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 Primary
1 . . . . . . . . . Partitioned
. 1 . . . . . . . . Reflect Z
. . 1 . . . . . . . Reflect Y
. . . 1 . . . . . . Reflect X
. . . . 1 . . . . . Repeated
. . . . . 1 . . . . Collector
. . . . . . 1 . . . External
. . . . . . . 1 . . Mirror
. . . . . . . . 1 . Identical
. . . . . . . . . 1 Apply mapping transform

4. The BITINFO in ENTRY=DWNCNCT indicates the downstream superelement(s?).

Bit Number Downstream superelement is:

0 The residual structure

1 through NBRSE-1 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 Meaning

0 Grid is connected to the residual structure

1 through NBRSE-1 Grid is connected to the superelement(s)


corresponding to the INTIDX-th bit(s)

NBRSE Grid is a scalar point

NBRSE+1 Grid is an incongruent boundary point

5-668 DMAP Programmer's Guide


Data Block Descriptions O-V

Bit number Meaning

MAXBIT-IDBITS through MAXBIT 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)) + 1.01)

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.

LENTRY = int ( NBRSE + IDBITS + 1 + 2)

NBPW

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.48 SET
Table of combined sets

DMAP Programmer's Guide 5-669


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 – (*)

Word Name Type Description

1 ID I Set identification number

2 TYPE I Set type

3 SETORIG I Origin of set

4 SETLEN I Length of set

5 SETMEM I Set members

Word 5 repeats SETLEN times

Record 2 – TRAILER

Word Name Type Description

1 WORD1 I Number of sets

2 WORD2 I Number of members in largest set

3 UNDEF(4 ) None

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.49 SETMC
Table of SETMC case control commands.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

5-670 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 1 - IDENT
Word Name Type Description

1 SID I Subcase identification number

2 SETID I Set identification number

3 SETLEN(C) I Length of this set

4 SETMEM I Set member identification number

Word 4 repeats SETLEN times

Words 2 through 4 repeat NSETS times

Record N - TRAILER
Word Name Type Description

1 WORD1 I Number of records

2 WORD2 I Maximum record length

3 UNDEF(4) None

5.50 SIL
Scalar index list.

Record – HEADER
Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record – SIL
Word Name Type Description

GRID = scalar point

1 SIL I Scalar index list item

GRID = heat transfer

1 SIL I Scalar index list item

GRID = grid point

DMAP Programmer's Guide 5-671


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

1 SIL1 I Scalar index list item

2 SIL2 I Scalar index list item

3 SIL3 I Scalar index list item

4 SIL4 I Scalar index list item

5 SIL5 I Scalar index list item

6 SIL6 I Scalar index list item

Record – TRAILER

Word Name Type Description

1 WORD1 I Number of grid points plus scalar points

2 WORD2 I Number of degrees-of-freedom in the g-displacement


set

3 WORD3 I 0

4 WORD4 I 0

5 WORD5 I 0

6 WORD6 I 0

5.51 TOL
Transient response time step output list

Record 0 – HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

3 TIME RS Time step

Word 3 repeats until End of Record

5-672 DMAP Programmer's Guide


Data Block Descriptions O-V

Record 1 – TRAILER

Word Name Type Description

1 WORD1 I Number of time steps

2 UNDEF(5 ) None

5.52 VIEWTB
View information table
Contains the relationship between each p-element and its view-elements and view-grids.

Record 0 - HEADER

Word Name Type Description

1 NAME(2) CHAR4 Data block name

Record 1 - BEAMP(10500,105,14)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number - from


CID field

3 NX I View mesh subdivision - from VIEW field

4 NY I View mesh subdivision - from VIEW field

5 NZ I View mesh subdivision - from VIEW field

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUHEXA identification number for this


element

8 MAXEID I Maximum VUHEXA identification number for this


element

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(2) I Corner Grid identification numbers

DMAP Programmer's Guide 5-673


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Word Name Type Description

12 ICORD CHAR4 Flags for convective coordinate system – from


PROJ and NORMAL fields

13 UNDEF

Record 2 - HEXAP(14100,141,18)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number - from


CID field

3 NX I View mesh subdivision - from VIEW field

4 NY I View mesh subdivision - from VIEW field

5 NZ I View mesh subdivision - from VIEW field

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUHEXA identification number for this


element

8 MAXEID I Maximum VUHEXA identification number for this


element

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(8) I Corner Grid identification numbers

Record 3 – PENTAP(14200,142,16)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number - from


CID field

3 NX I View mesh subdivision – from VIEW field

4 NY I View mesh subdivision – from VIEW field

5 NZ I View mesh subdivision – from VIEW field

5-674 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUPENTA IDENTIFICATION NUMBER


for this element

8 MAXEID I Maximum VUPENTA IDENTIFICATION NUMBER


for this element

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(6) I Corner Grid identification numbers

Record 4 - QUADP(10300,103,16)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number - from


CID field

3 NX I View mesh subdivision - from VIEW field

4 NY I View mesh subdivision - from VIEW field

5 NZ I View mesh subdivision - from VIEW field

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUHEXA identification number for this


element

8 MAXEID I Maximum VUHEXA identification number for this


element

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(4) I Corner Grid identification numbers

12 ICORD CHAR4 Flags for convective coordinate system – from


PROJ and NORMAL fields

13 THETA RS Rotation of convective system

DMAP Programmer's Guide 5-675


Chapter
Chapter 5: 5: Data Data
BlockBlock Descriptions
Descriptions O-V O-V

Record 5 – TETRAP(14300,143,14)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number – from


CID field

3 NX I View mesh subdivision – from VIEW field

4 NY I View mesh subdivision – from VIEW field

5 NZ I View mesh subdivision – from VIEW field

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUTETRA identification number for this


element

8 MAXEID I Maximum VUTETRA identification number for this


element

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(4) I Corner Grid identification numbers

Record 6 - TRIAP(10400,104,15)

Word Name Type Description

1 EID I Element identification number

2 CID I Coordinate system identification number - from


CID field

3 NX I View mesh subdivision - from VIEW field

4 NY I View mesh subdivision - from VIEW field

5 NZ I View mesh subdivision - from VIEW field

6 MTH CHAR4 Method – ’DIRE’ means direct

7 MINEID I Mininum VUHEXA identification number for this


element

8 MAXEID I Maximum VUHEXA identification number for this


element

5-676 DMAP Programmer's Guide


Data Block Descriptions O-V

Word Name Type Description

9 MINGID I Minimum Grid identification number for this element

10 MAXGID I Maximum Grid identification number for this


element

11 G(3) I Corner Grid identification numbers

12 ICORD CHAR4 Flags for convective coordinate system – from


PROJ and NORMAL fields

13 THETA RS Rotation of convective system

Record 7 – TRAILER

Word Name Type Description

1 UNDEF(6 ) None

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.

DMAP Programmer's Guide 5-677


Chapter 6: Data Block Glossary

The Data Block Glossary lists the names and a brief description of all data blocks listed in the module
descriptions. Naming conventions appear at the end of the glossary.

Parent Data
Data Block Name Description
Block Format

Square matrix to be decomposed by DCMP, DECOMP, SOLVE, and SOLVIT. Rectangular


matrix to be processed by the DIAGONAL and SCALAR modules. Rectangular matrix
A 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.

Matrix defined on DMIG Bulk Data entries and referenced by the A2GG Case Control
A2GG
command. Output by MTRXIN.

ABESF* Family of a-set size panel area matrices.

Column vector containing the grid IDs of the grids which are a part of the acoustic
ACGRIDS
coupling; the grid IDs are represented as real values.

ACPT Aerodynamic connection and property table. Output by APD.

Table of the aerodynamic database contents. (one entry for each of the NV instances
ADBINDX
created). Output by ADG.

ADELX Matrix of adjoint sensitivities. Output by DSADJ.

ADJG Adjoint sensitivity displacement matrix in the g-set or p-set.

AEBGPDT* BGPDT Family of aerodynamic basic grid point definition tables. Output by APD.

AEBGPDTI Basic grid point definition table for the aerodynamic js-set interference degrees-of-freedom.

Family of basic grid point definition tables for the interference js-set aerodynamic
AEBGPDTI*
degrees-of-freedom.

AEBGPDTJ Basic grid point definition table for the aerodynamic js-set degrees-of-freedom.

AEBGPDTJ* Family of basic grid point definition tables for the js-set aerodynamic degrees-of-freedom.

AEBGPDTK Basic grid point definition table for the aerodynamic ks-set degrees-of-freedom.

AEBGPDTK* Family of basic grid point definition tables for the ks-set aerodynamic degrees-of-freedom.

AECMPOLD Previously generated AECOMP.

AECOMP Aerodynamic component definition table. Output by APD.

Table of aerodynamic coordinate system transformation matrices that only contains the
AECSTMHG
hinge moment referenced coordinates systems if not null. Output by MKCNTRL.

AECTRL Table of aerodynamic model's control definition. Output by ADG.

AEDBIDX Index table consisting of the triples. Output by MAKAEFS.

AEDBINDX Aeroelastic database index for monitor point data.

AEDBUXV Matrix of vehicle states.

DMAP Programmer's Guide 6-1


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Matrix of downwash vectors contained on DMIJ Bulk Data entries referenced by the
AEDW
AEDW entries. Ouptut by MAKAEFA.

AEDWIDX Index to the AEDW tables. Ouptut by MAKAEFA.

AEECT* GEOM2 Family of aerodynamic element connection tables. Output by APD.

AEFIDX Index to the AEFORCE tables. Ouptut by MAKAEFA.

Matrix of force vectors contained on DMIK Bulk data entries referenced by the AEFORCE
AEFRC
entries. Ouptut by MAKAEFA.

Basic grid point definition tables for the aerodynamic model. Output by APD as BGPDT
AEGRID BGPDT
with qualifier MODLTYPE='AEROMESH'.

Matrix of interference downwash vectors contained on DMIJ Bulk Data entries referenced
AEIDW
by the AEDW entries. Ouptut by MAKAEFA.

Matrix of interference pressure vectors contained on DMIJ Bulk data entries referenced by
AEIPRE
the AEPRESS entries. Ouptut by MAKAEFA.

AEMONOLD Table of HM monitor points.

AEMONPT Aerodynamic monitor point table. Output by MAKAEMON and MAKMON.

Matrix of pressure vectors contained on DMIJ Bulk data entries referenced by the
AEPRE
AEPRESS entries. Ouptut by MAKAEFA.

AEPRSIDX Index to the AEPRESS tables. Ouptut by MAKAEFA.

AERO Table of control information for aerodynamic analysis. Output by APD.

AEROCOMP Table of aerodynamic components when MESH='AERO'. Output by MAKCOMP.

AEUSET* USET Family of aerodynamic USET tables. Output by APD.

Column matrix of maximum values in each row of the AG0 matrix (usually derived using
AG0MAX
MATMOD option 6).

AGG 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
AGX
backward perturbed configuration. Output by SSG1.

AH Signed global modally reduced area matrix

Aij Matrix partitions. Output by PARTN and UPARTN.

AJJT Aerodynamic influence matrix. Output by AMG.

Family of data blocks for bulk files for the original analysis/design model as well as for all
ALBULK
auxiliary models, if any.

Damping matrix in the d-set for linear elements multiplied by the negative of the time
AM2
step delta

Combined mass and damping matrix multiplied the square of the reciprocal of the time
AM3
step delta and the reciprocal of twice the time step delta, respectively.

AMAT State-space [A] matrix for superelement.

AMLIST List of auxiliary model identification numbers. Output by AXMPR1.

Table of aerodynamic splines for display. Converted from forces and pressures computed
AMSPLINE on AEBGPDT grid points, (box centroidal points) to AEGRID grid points (box corner
points). Output by APD.

6-2 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

ANORM Normalized matrix. Output by NORM.

APART Partitioning vector for panel coupling matrix when PNLPTV=TRUE.

APC Absolute panel contributions results matrix.

APL Lower triangular factor of null space A matrix.

APU Upper triangular factor of null space A matrix.

AUG1 Displacement matrix in g-set for aerostatic analysis. Output by DSAD.

AUTO Autocorrelation function table. Output by RANDOM.

Table of aerodynamic extra point identification numbers, displacements, labels, type,


AUXTAB
status, position and hinge moments for all subcases.

Table of Bulk Data entry images related to conical shell, hydro elastic, and acoustic cavity
AXIC
analysis. Output by IFP.

AXIC68 Element property table (Pre-MSC Nastran Version 69).

Parent Data
Data Block Name Description
Block Format

Output matrix from the DIAGONAL module. Right hand side of a system of equations
B 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
B2DD 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
B2GG
command. Output by MTRXIN.

Matrix defined on DMIG Bulk Data entries and referenced by the B2PP Case Control
B2PP
command. Output by MTRXIN.

BAA Viscous damping matrix in a-set or d-set.

Transformation matrix from cyclic to physical components. Required in static and


BACK
pre-buckling analysis only. Output by CYCLIC1.

BASVEC Auxiliary displacement matrix.

BASVEC0 Auxiliary displacement matrix. Optional user input.

BCON0 Table of constant terms in the beam section constraint relationship. Output by DOPR1.

Matrix relating beam library constraints to the independent design variables. Output by
BCONXI
DOPR1.

BCONXT Matrix transpose of BCONXI.

3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel domain
BD3X3
decomposition. Output by GPSP.

BDD Damping (or heat capacitance) matrix for the d-set for linear elements only.

Diagonal matrix of buckling divided by buckling generalized differential stiffness matrix.


BDIAG
Output by DSAH.

BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format. Output by BMG.

DMAP Programmer's Guide 6-3


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

BDICT KDICT BELM dictionary table. Output by EMG.

BELM KELM Table of element damping or heat capacity matrices. Output by EMG.

BFHH Fluid partition of modal damping matrix BHH.

BGPDT* BGPDT Family of basic grid point definition tables for all superelements.

BGPDT BGPDT Basic grid point definition table. Output by GP1.

BGPDTD BGPDT 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
BGPDTM BGPDT
GEOM1M and GEOM2M as inputs.

BGPDTN BGPDT New BGPDT table based on displaced grid locations. Output by MATMOD option 11.

BGPDTS BGPDT Basic grid point definition table for a superelement. Output by GP1.

BGPDT assembled for superelements defined on the SEPLOT or SEUPPLOT command.


BGPDTX BGPDT
Output by SEPLOT.

BGPDVB BGPDT Basic grid point definition table for the backward perturbed configuration. Output by DSAM.

Basic grid point definition table for the forward (or central) perturbed configuration. Output
BGPDVP BGPDT
by DSAM.

Basic grid point definition table for the central, forward, or backward perturbed
BGPDVX BGPDT
configuration. Output by DSAM.

BGPECT GEOM2 Boundary grid point element connection table. Output by BGP.

BHH Generalized (modal) damping matrix

BHH1 Modified generalized (modal) damping matrix. Output by FA1.

BIN Results from bolt preload phase.

BKDICT KDICT BKELM dictionary table.

BKK Viscous damping matrix in cyclic components. Output by CYCLIC3.

BLAMA LAMA Buckling eigenvalue summary table. Output by READ.

BLAMA* LAMA Family of buckling eigenvalue summary tables.

BMAT State-space [B] matrix for superelement.

Table containing the local and global boundary grids in the order given by extreme for
BNDFIL
domain decomposition. Output by SEQP.

BNFDAT Bolt element grid point force data.

BOLTFOR List of element numbers and bolt force for SDRX.

BOPHIG OUG Eigenvectors in the basic coordinate system.

BOUT Results from bolt preload phase.

BP Null space B matrix.

Damping matrix in the d-set for linear elements only or heat capacitance matrix for both
BRDD
linear and nonlinear elements in the d-set.

BTOPO Contact regions topological information table. Output by BGP.

BTOPOCNV Updated contact regions input information table. Output by NLITER and NLTRD2.

6-4 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

BTOPOSTF 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,
BXX
TRD1, and TRD2.

BUG* Family of buckling eigenvector matrices in the g-set

BUX Matrix of damping multiplied by displacement or eigenvectors.

BULK Table of all Bulk Data entries. Output by XSORT.

BULK* Family of auxiliary model or superelement Bulk Data sections.

BULKOLD BULK table from a prior run.

Parent Data
Data Block Name Description
Block Format

C Rectangular matrix to be used in MPYAD module addition and SMPYAD module product.

CASADJ CASECC Case Control table associated with adjoint method. Output by DSAD.

Case Control table with unneeded analysis subcase(s) deleted, excluding static
CASDSN CASECC
aeroelastic subcases. Output by DSAD.

CASDSX CASECC Case Control table with unneeded analysis subcase deleted

CASE CASECC Table of Case Control commands for the current analysis type and superelement.

CASEA CASECC A single record (subcase) of CASECC for aerodynamic analysis. Output by AELOOP.

Case Control table for cyclic data recovery. One record for every column in BACK.
CASEBK CASECC
Required in static and pre-buckling analysis only. Output by CYCLIC1.

Case Control table for buckling analysis and based on ANALYSIS=BUCK. Output by
CASEBUCK CASECC
MDCASE.

CASECC CASECC Table of Case Control command images. Output by IFP1.

CASECC* CASECC Family of auxiliary model Case Control tables.

Primary model Case Control table appended with extra subcases to account for the
CASECC1 CASECC
boundary shapes. Output by SHPCAS.

CASECCBO CASECC Updated CASECC for contact region data recovery operations. Output by BGCASO.

CASECCR CASECC 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
CASECEIG
ANALYSIS=MCEIG or DCEIG. Output by MDCASE.

Table of Case Control command images for the superelement (identification number equal
CASEDR CASECC
to output value of SEID). Output by SEDR.

Case control table for the data recovery of design responses. Output by DOPR3 and
CASEDS CASECC
DSTA.

Case Control table for all load cases and all design variables for the perturbed
CASEDSF CASECC
configuration. Output by DSAH.

Case Control table for aerostatic divergence analysis and based on ANALYSIS=DIVERG.
CASEDVRG CASECC
Output by MDCASE.

CASEFLUT CASECC Case Control table for flutter and based on ANALYSIS=FLUTTER. Output by MDCASE.

DMAP Programmer's Guide 6-5


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Updated Case Control table for static loads generation and solution in cyclic symmetry
CASEFR CASECC
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
CASEFREQ CASECC
ANALYSIS=MFREQ or DFREQ. Output by MDCASE.

CASEG CASECC Table of Case Control command images for current subcase.

Case Control table for heat transfer analysis and based on ANALYSIS=HEAT. Output
CASEHEAT CASECC
by MDCASE.

Case Control table for normal modes analysis and based on ANALYSIS=MODES. Output
CASEMODE CASECC
by MDCASE.

Case Control table for modal transient analysis and based on ANALYSIS=MTRAN. Output
CASEMTRN CASECC
by MDCASE.

Residual superelement Case Control table for plotting basis vectors. Output by DOPR2.
CASEP CASECC Case Control table with number of basis vectors in the DESVEC as the number of Case
Control records. Output by DSAJ.

CASERS CASECC Case Control table for the residual structure and a given analysis type.

Table of Case Control command images for the current superelement (identification
CASES CASECC
number equal to output value of SEID). Output by SEP2CT.

Combined Case Control table which includes CASESAER or CASEDVRG. Output by


CASESADV CASECC
MDCASE.

Case Control table for aerostatic analysis and based on ANALYSIS=SAERO. Output
CASESAER CASECC
by MDCASE.

Case Control table for electromagnetic analysis and based on ANALYSIS=ELEC. Output
CASESMEM CASECC
by MDCASE.

Case Control table for structural analysis and based on ANALYSIS=STRU. Output by
CASESMST CASECC
MDCASE.

Combined Case Control table which includes CASESTAT, CASEMODE, CASEBUCK,


CASESNMB CASECC
CASESAER, CASEDVRG, and CASEFLUT. Output by MDCASE.

Case Control table for static analysis and based on ANALYSIS=STATICS. Output by
CASESTAT CASECC
MDCASE.

CASESX CASECC Expanded Case Control table. Output by LCGEN.

Case Control table intended for Phase 1 matrix generation, assembly and reduction.
CASEXX CASECC
Output by MDCASE.

CASEUPSE CASECC Case Control table for upstream superelements only. Output by MDCASE.

Table of Case Control command images with the PARTN command referencing all of
CASEVEC CASECC
auxiliary model's grid identification numbers. Output by AXMPR2.

CASEXX CASECC Subset of CASECC for current loop. Output by CASE.

CASEYY CASECC Appended Case Control table in flutter analysis. Output by FA2.

CDDATA Campbell diagram data table.

CDELB Triple matrix product for flutter damping sensitivity

CDELK Triple matrix product for flutter stiffness sensitivity

CDELM Triple matrix product for flutter mass sensitivity

6-6 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

CFSAB Matrix of spectral densities–weighting factors for RMS calculations. Output by DOPRAN.

CIDATA Miscellaneous data for controlled increment method. Output by NLITER.

CLAMA LAMA Complex eigenvalue summary table. Output by CEAD.

CLAMA1 LAMA Complex eigenvalue summary table in flutter analysis. Output by CEAD.

CLAMA2 LAMA Appended complex eigenvalue summary table in flutter analysis. Output by FA2.

Diagonal matrix with complex eigenvalues on the diagonal. Output by CEAD, LAMX,
CLAMMAT
and UEIGL.

CMAT State-space [C] matrix for superelement.

CNELM Contact element definition table.

CNTABR CONTAB Table of retained constraint attributes. Output by DSAD.

CNTABRG CONTAB Table of retained constraint attributes.

CNVTST Convergence test matrix.

COELEM Correlation table between idcid/eid/component for element responses. Output by DSAH.

Correlation table between idcid/gid component for displacement responses. Output by


COGRID
DSAH.

COMP Merged table of components. Output by MRGCOMP.

COMPEST Composite solid element summary table.

COMPi Table of aerodynamic or structural components

Matrix of constants that relates design variables and design coordinates. Output by
CON
DOPR2.

Matrix transpose of relationship between dependent and independent design variables.


CONS1T
Output by DOPR1.

CONSBL Matrix of constant property values. Output by DOPR1.

CONSBL* Family of matrices of constant property values. Output by DOPR1.

CONTAB CONTAB Table of constraint attributes. Output by DOPR3.

CONTACT Table of Bulk Data entries related to contact regions. Output by IFP.

CONTROL Table of editing directives for the TABEDIT module.

COORD Matrix of initial or final designed coordinate values, COORDO or COORDN.

COORDN Updated (optimized) COORDO. Output by DOM11.

Matrix of initial designed coordinate values at the beginning of each design cycle. Output
COORDO
by DOPR2.

CP Column partitioning vector. Output by VEC and MATMOD option 17.

CPH1 Complex eigenvector matrix for h-set in flutter analysis. Output by CEAD.

CPH2 Appended complex eigenvector matrix for h-set in flutter analysis. Output by FA2.

CPHFL Left flutter eigenvector - h-set. Output by DSFLTE.

CPHP Complex eigenvector matrix in the p-set.

DMAP Programmer's Guide 6-7


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

CPHFR Left flutter eigenvector - h-set. Output by DSFLTE.

CPHX Complex eigenvector matrix in the d-set or h-set. Output by CEAD.

CPHL Complex eigenvector matrix in the l-set. Output by CEAD.

CSNMB CASECC Case Control table for a given superelement and all analysis types.

CSTM CSTM Table of coordinate system transformation matrices. Output by GP1.

CSTMi CSTM Tables of coordinate system transformation matrices; either aerodynamic or structural.

CSTM0 CSTM Table of coordinate system transformation matrices for the residual structure.

Table of aerodynamic coordinate system transformation matrices for g-set + ks-set grid
CSTMA CSTM
points. Output by APD.

CSTMD CSTM Table of coordinate system transformation matrices for a downstream superelement.

CSTMM CSTM Merged table of coordinate system transformation matrices. Output by MKCSTMA.

CSTMS CSTM Table of coordinate system transformation matrices for a superelement.

CVAL Matrix of constraint values, CVALO or CVALRG.

CVALO Matrix of final (optimized) constraint values. Output by DOM9.

CVAL Matrix of retained constraint values. Output by DSAD.

CVALR Matrix of retained constraint values. Output by DSAD.

CVALRG Matrix of initial constraint values.

Partitioning vector for separating the primary model solutions from boundary shape
CVEC
induced solutions. Output by SHPCAS.

CVECT Load combination factor matrix. Output by PCOMB.

CYCD Table of constraints in harmonic components. Output by CYCLIC2.

Parent Data
Data Block Name Description
Block Format

Rectangular matrix to be used in SMPYAD module product. Diagonal matrix extracted


D
from LD. Output by MATMOD option 21.

D1JE Real part of downwash matrix due to extra points.

D1JK Real part of downwash matrix. Output by AMG.

D2JE Imaginary part of downwash matrix due to extra points.

D2JK Imaginary part of downwash matrix. Output by AMG.

Rigid body transformation matrix for the r-set to the a-set. Formed from the merge of DM
DAR
and an l-set size identity matrix.

DBCOPT DBCOPT Design optimization history table for post-processing. Output by DOM12.

DB Data block.

Data block to be processed by the DBC, INPUTT2, and OUTPUT2 modules. Data blocks
DBi to be compared in the RESTART module. Data block declared on the FILE statement.
Data block to be purged by PURGEX module.

DBMLIB Table of designed beam library data. Output by DOPR1.

6-8 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Modified DBMLIB data block updated for current values of designed PBARL/PBEAML
DBMLIBU
dimensions.

DBNAME Data block for 'NAME' option of PARAML module. Output by PARAML.

DBP Primary data block.

DBS Secondary data block. Output by EQUIVX.

Buckling eigenvector matrix in the g-set associated with designed (active) eigenvalues.
DBUG
Output by DSAH.

DCLDXT Matrix of coefficients in the grid to design variable relationship. Output by DOPR2.

Complex eigenvectors associated with the divergence eigenvalues extracted from the real
DCPHL
part of eigenvectors associated with the divergence eigenvalues. Output by CEAD.

DEFUSET Table of DEFUSET Bulk Data entry images. Output by IFP.

DELB1 Matrix of delta buckling load factor for all design variables.

DELBSH Matrix of finite difference shape step sizes.

Updated DELBSH where the numerical zero terms are replaced by a prescribed small
DELBSX
value. Output by DOPR5.

DELCE Matrix of delta complex eigenvalue for all design variables

DELDV Matrix of divergence sensitivity. Output by DSDVRG.

DELF1 Matrix of delta eigenvalue for all design variables.

DELFL Matrix of delta flutter responses for all design variables. Output by DSFLTF.

DELS Matrix of delta stability derivative responses for all design variables.

Matrix of delta stability derivative responses for all design variables for a single trim
DELS1
subcase. Output by DSARSN.

Multipoint constraint transformation matrix for the perturbed configuration. Output by


DELTGM
DSVGP4.

DELVS Matrix of delta volume for all design variables. Output by DSAW.

DELWS Matrix of delta weight for all design variables. Output by DSAW.

DELX Matrix of delta trim variable responses for all design variables.

Matrix of delta trim variable responses for all design variables for a single trim subcase.
DELX1
Output by DSARSN.

DEQATN Table of DEQATN Bulk Data entry images. Output by IFP.

DEQIND Index table to DEQATN data block. Output by IFP.

Defines the design cycle to which the results data blocks that follow belong, up to the next
DESCYC
design cycle data block (i.e. the next DESCYC).

DESELM Table of designed elements. Output by DOPR3.

DESGID Table of designed grid coordinate attributes. Output by DOPR2.

DESNEW Update table of design variable attributes. Output by DOM12.

DESTAB DESTAB Table of design variable attributes. Output by DOPR1.

DMAP Programmer's Guide 6-9


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Global shape basis vector matrix with incorporation of DLINK relations with extra columns
DESVCP
for property/dummy variables. Output by DOPR2.

Basis vector matrix which consists of basis vectors generated from DVGRID Bulk Data
DESVEC 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
DESVECP 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.
DFFDNF
Output by FRLGEN.

DFRFNC Table of frequency functions records (see bulk data input DTI,DFRFNC).

Table of Bulk Data entry images related to element connectivity and scalar points for the
DGEOM2 GEOM2
perturbed configuration. Output by DSAH.

Table of Bulk Data entry images related to static loads for the perturbed configuration.
DGEOM3 GEOM3
Output by DSAH.

Table relating DTOS4 records and designed grid data. Correlation table of internal grid
DGTAB
sequence for the baseline and perturbed configuration. Output by DOPR6.

DISTAB Table of discrete optimization value sets. Output by DOPR1.

DISTL Direct table input table for RS.

DIT DIT Table of TABLEij Bulk Data entry images. Output by IFP.

DITID Table of identification numbers in DIT. Output by TA1.

Direct input tables with modified TABLEDi for updated values of designed frequency
DITN
dependent properties.

DIVDAT Table of divergence data. Output by DIVERG.

DIVTAB Table of aerostatic divergence data for all subcases.

Downwash matrix. Downwash at the j-point due to the x aerodynamic extra point. Output
DJX
by ADG.

Left-handed complex eigenvectors associated with the divergence eigenvalues extracted


DLCPHL from the real part of left-handed eigenvectors associated with the divergence eigenvalues.
Output by DIVERG.

DLSTIN List of data blocks and their paths. Output in a previous execution of RESTART.

DLSTOUT List of data blocks and their paths. Output by RESTART.

DLT Table of dynamic loads. Output by DPD.

DLT1 Table of dynamic loads updated for nonlinear analysis. Output by NLCOMB.

DLTH Table of dynamic loads updated for heat transfer analysis. Output by TRLG.

DM Rigid body transformation matrix for the r-set to the l-set. Output by RBMG3.

DMATCK Table of designed material consistency check. Output by DOPR1.

DMI Table of all matrices specified on DMI Bulk Data entries. Output by IFP.

DMIi Matrix data blocks created from DMI. Output by DMIIN.

DMINDX Index into DMI. Output by IFP.

6-10 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

DNODEL Table of designed and non-designed locations. Output by DOPR2.

Normal modes eigenvector matrix in the g-set associated with designed (active)
DPHG
eigenvalues. Output by DSAH.

Matrix of coefficients in the property to independent design variable relationship. Output


DPLDXI
by DOPR1.

Family of matrices of coefficients in the property to independent design variable


DPLDXI*
relationship. Output by DOPR1.

DPLDXT Matrix transpose of DPLDXI.

DRDUG Matrix of adjoint loads for the g-set. Output by DSAD.

DRDUTB Table of adjoint load attributes. Output by DSAD.

DRLIST Superelement processing list for data recovery. Output by SEP4.

Table of the RMS response values with respect to the design variables. Output by
DRMSVL
DSAMRG.

Table containing the number of retained responses for each subcase for each of the
DRSTBL
response types. Output by DSAD.

Table containing the number of retained responses for each subcase for each of the
DRSTBLG
response types.

DSCM Design sensitivity coefficient matrix. Output by DSAL.

DSCM2 Normalized design sensitivity coefficient matrix. Output by DOM6.

DSCMCOL DCSMCOL Correlation table for normalized design sensitivity coefficient matrix. Output by DSTAP2.

DSCMG Unnormalized design sensitivity matrix.

DSCMR Old combined design sensitivity/constraint matrix. Output by DSMA.

Table of design sensitivity column labels for design sensitivity matrix, DSCMR. Output
DSCOLL
by DSTA.

DSCREN Table of constants from the DSCREEN Bulk Data entry. Output by DOPR1.

DSDIV Matrix of delta divergence speed for all design variables.

DSEDV Partitioning vector for retained divergence responses. Output by DSAH.

DSEGM Old design sensitivity eigenvalue gradient matrix.

Design sensitivity eigenvector selection matrix - Boolean operator to select eigenvectors


DSESM
which are referenced by constraints (buckling and normal modes only). Output by DSTA.

DSIDLBL Table of design response labels. Output by DSTAP2.

Superelement processing list to direct the pseudo-load and response sensitivity


DSLIST
calculations. Output by SDSB.

DSPT1 Design sensitivity processing table. Output by DSAN and DSTA.

DSPT2 Old Design sensitivity processor table two. Output by DSTA.

Table of design sensitivity row labels for design sensitivity matrix, DSCMR. Output by
DSROWL
DSTA.

DSTABR Matrix of restrained perturbed dimensional stability derivatives.

DSTABU Matrix of unrestrained perturbed dimensional stability derivatives.

DMAP Programmer's Guide 6-11


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

DTB Table of constants from the DTABLE Bulk Data entry. Output by DOPR1.

DTI Table of all matrices specified on DTI Bulk Data entries. Output by IFP.

DTIi Table data blocks created from DTI. Output by DTIIN.

DTINDX Index into DTI. Output by IFP.

Design variable/property cross reference table. Same as DTOS2K except that the PREF
DTOS2 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
DTOS2* the product of a DPLDXI element and the corresponding design variable value. Output by
DOPR5.

DTOS2J Table identifying independent design variables and property values. Output by DOPR1.

DTOS2J* Family of tables identifying independent design variables and property. Output by DOPR1.

Same as DTOS2J except that the dvid in each entry refers to the position of an internal
DTOS2K
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
DTOS2K* 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
DTOS4 three words in each entry contains the product of those in DTOS4K and the shape step
size. Output by DOPR5.

DTOS4J Designed grid perturbation vector in basic coordinate system. Output by DOPR2.

Same as DTOS4J except that the ID in each five-word entry is the position of an internal
DTOS4K
design variable ID in the first TABDEQ record. Output by DOPR4.

Incremental displacement matrix between the last two converged steps. Output by
DUGNI
NLITER.

Matrix of aerodynamic extra point displacements for the perturbed configuration. Output
DUX
by ASG.

List of shape variable identification numbers to be used for the boundary DVGRID option.
DVIDS
Output by DSAJ.

Table of attributes of the designed properties by internal property identification number


DVPTAB DVPTAB
order. Output by DOPR1.

Family of tables of attributes of the designed properties by internal property identification


DVPTAB* DVPTAB
number order. Output by DOPR1.

DVSLIS List of design variables affected by shape variations. Output by DSVGP4.

DXDXI Matrix relating linked and independent design variables. Output by DOPR1.

DXDXIT Matrix transpose of DXDXI.

DYNAMIC DYNAMIC Table of Bulk Data entry images related to dynamics. Output by IFP.

Table of Bulk Data entry images related to dynamics without DAREA entry images. Output
DYNAMICB
by GP1.

Table of Bulk Data entry images related to dynamics for the current superelement. Output
DYNAMICS DYNAMIC
by SEP2 and SEP2X.

6-12 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

E Rectangular matrix to be used in SMPYAD module product.

ECT GEOM2 Element connectivity table. Output by GP2.

ECT* GEOM2 Family of element connectivity tables for all superelements.

ECTA GEOM2 Secondary element connectivity table. Output by GP2.

EDITVEC Vector with zeros in rows to be removed under usetop='filter'.

EDOM Table of Bulk Data entries related to design sensitivity and optimization. Output by IFP.

EDOM* Family of EDOM tables for all superelements.

Table of Bulk Data entries related to design sensitivity and optimization updated for
EDOMM
p-element analysis. Output by OPTGP0.

Table of Bulk Data entries related to design sensitivity and optimization for a superelement.
EDOMS
Output by SDSA.

Table of Bulk Data entry images related to element deformation, aerodynamics, p-element
EDT analysis, divergence analysis, and the iterative solver. Also contains SET1 and SET3
entries. Output by IFP.

EED DYNAMIC Table of eigenvalue extraction parameters. Output by DPD.

EFILL Element fill ratio.

EGK Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness. Output by DSVG1P.

EGM Pseudo-load (equilibrium variation) matrix in the g-set due to mass. Output by DSVG1P.

EGPSF EGPSF Table of element to grid point interpolation factors. Output by GPSTR1.

Table of grid point stresses or strains for post-processing in the DBC module. Output by
EGPSTR EGPSTR
GPSTR2.

Pseudo-load matrix (variation in equilibrium) due to changes in the thermal load/design


EGTX
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
EGX
damping or structural damping. Output by DSVG1P.

EHT Element hierarchical table for p-element analysis. Output by GP0.

EHTA Secondary element hierarchical table. Output by GP0.

ELDATA Table of combined nonlinear information data. Output by NLCOMB.

Table of element stress discontinuities for post-processing in the DBC module. Output
ELDCT ELDCT
by STDCON.

Element volume table, contains p-element volumes and the p-value dependencies of each
ELEMVOL
P-element grid, edge, face and body. Output by VIEWP.

ELGNST Table of glue element stiffness.

Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section of Case


ELSET
Control. Output by PLTSET and SEPLOT.

EMAT State-space [E] matrix for superelement.

EMM Effective mass matrix. Output by EFFMAS.

EMVD Equivalent modal viscous damping matrix for superelement.

EPSSE Table of epsilon and external work. Output by SSG3, SOLVIT, and DISUTIL.

DMAP Programmer's Guide 6-13


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

EPT EPT Table of Bulk Data entry images related to element properties. Output by IFP and IFP6.

EPT705 Element property table (Pre-MSC Nastran 2001).

EPTA EPT Secondary table of Bulk Data entry images related to element properties.

Copy of EPT except PCOMP records are replaced by equivalent PSHELL records. Output
EPTC EPT
by IFP6, CMPZPR, and DSTA.

EPTN EPT Updated (optimized) EPT. Output by DOM11.

Table of Bulk Data entry images related to element properties for a superelement. Output
EPTS EPT
by SEP2 and SEP2X.

EPTTAB EPT Table of designed property attributes. Output by DOPR1.

EPTTAB* EPT Family of tables of designed property attributes. Output by DOPR1.

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
EPTX EPT 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
EQACST
which lie on the fluid/structure boundary. Output by GP5.

Equivalence table between external and internal grid/scalar/extra point identification


EQDYN EQEXIN
numbers. (EQEXIN appended with extra point data). Output by DPD.

Equivalence table between external and internal grid/scalar identification numbers.


EQEXIN EQEXIN
OUTPUT by GP1.

Equivalence table between external and internal grid/scalar identification numbers for a
EQEXINS EQEXIN
superelement. Output by SEP2 and SEP2X.

Table of degree-of-freedom global-to-local maps for domain decomposition. Output by


EQMAP
PRESOL.

ERHM Matrix of dimensional unsplined restrained elastic hinge moment data

Error estimate table generated by ADAPT module in previous superelement or adaptivity


ERROR0 ERROR
loop.

Error-estimate table updated for current superelement or adaptivity loop. Output by


ERROR1 ERROR
ADAPT.

EST Element summary table. Output by TA1.

ESTDATA Table of superelement estimation data overrides. Output by DTIIN.

ESTL Linear element summary table. Output by TA1.

Element summary table which incorporates combined constraints and design variables.
ESTDCN
Output by DSAF and DSTA.

Merged EST with grid and element property design variable perturbations. If CDIF='YES'
ESTDV2
then this is the forward perturbation. Output by DSAE.

Element summary table for the backward perturbed configuration. Required only if
ESTDVB
CDIF='YES'.

ESTDVM EST EST with updated material property identification numbers. Output by DSABO.

ESTDVP EST with element property design variable perturbations. Output by DSABO and DSTA.

6-14 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

ESTDVS EST with grid design variable perturbations. Output by DOPR6.

ESTF Element summary table for follower force stiffness. Output by TAFF.

ESTNL Nonlinear element summary table. Output by TA1.

ESTNL1 Nonlinear element summary table updated for heat transfer analysis. Output by TAHT.

Nonlinear element summary table at converged step. Output by NLITER, NLTRD, and
ESTNLH
NLTRD2.

ESTR EST table with reduced records. Output by MATMOD option 38.

ETT Element temperature table. Output by GP3.

Table of design variable and constraint internal identification numbers for the effects of
ETTDCN
temperature. Output by DSAF and DSTA.

Element temperature table where the original element identification numbers have been
ETTDV
converted to new design variable identification numbers. Output by DSAN and DSTA.

EUHM Matrix of dimensional unsplined unrestrained elastic hinge moment data.

Parent Data
Data Block Name Description
Block Format

F Rectangular matrix to be used in SMPYAD module addition.

Strain energy and grid point force at every element from the previous load step in
FENL
nonlinear matrix format.

Strain energy and grid point force at every element at the current load step in nonlinear
FENL1
matrix format. Output by NLITER.

FFAJ Matrix of pressures at aerodynamic boxes.

FFGH Follower force for OLOAD output. Output by NLITER.

FG Element forces due to large displacements. Output by GNFM.

FGNL Nonlinear element force matrix from the last iteration. Output by NLITER.

FLUTAB Flutter summary table for all subcases.

FMPF Matrix of fluid mode participation factors. Output by MODEPF.

FN 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
FOL1 FOL
command. Output by MODACC.

FOLMAT Matrix of frequencies in radian units. Output by MATMOD Option 33.

Frequency response frequency output list with first frequency truncated if first frequency is
FOLT FOL
zero. UXF is also similarly truncated. Output by FRRD1 or FRRD2.

Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS) section in


FORCE
CASE CONTROL and MSGMESH field information. Output by IFP1.

FORE Transformation matrix from physical to cyclic components. Output by CYCLIC1.

FREQMASS Matrix of frequencies and generalized masses.

DMAP Programmer's Guide 6-15


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

FRL Frequency response list. Output by FRLGEN.

Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list. Output by FRLG, TRLG, CEAD, and READ.
FRLF However, with Version 6.0, for frequency response, this is no longer the same as the
previous OL data block, but is now the full data block for the frequency sets data for the
current cycle, together with a header record listing the frequency sets.

A composite FRL data block containing only the relevant records from each FRL data
FRLTMP block in multiple subcase, multiple frequency set, frequency response analysis, relevant
when the PRESENS3 parameter is TRUE.

Frequency response list for the current processor if distributed processing is requested.
FRL1
Output by FRLGEN.

FRLI Frequency response list for a single frequency. Output by FRQDRV.

Table of frequencies matching the perturbed elements summary table (ESTDV) when
FRQDPV
frequency dependent properties are designed.

FRQRMF FRQRPR table for frequency response.

Table of the count of type 1 frequency/time responses per response type per frequency
FRQRSP
or time step. Output by DOPR3.

Table containing the number of first level (direct) retained responses per response type
FRQRPR
and per frequency or time step. Output by DSAD.

Table containing the number of first level (direct) retained responses per response type
FRQRPRG
and per frequency or time step.

FSAVE Flutter storage save or answer table. Output by FA1.

Parent Data
Data Block Name Description
Block Format

GAMMAD Complex double precision. This is the scalar multiplier for [C].

GAOSM Constraint matrix relating the a-set to the (o+s+m)-set for superelement.

Partitioning vector which is used to partition the local a-set displacements from the global
GAPAR 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.

Transformations matrix between symmetric (cosine) components and solution set


GC
components. Output by CYCLIC3.

GDGK Aerodynamic transformation matrix for displacements from the k-set to g-set. Output by GI.

GDKI Aerodynamic transformation matrix for displacements from the k-set to h-set.

GDNTAB Table of grid points generated for p-element analysis. Output by GP0.

GEG Element displacement interpolation matrix. Output by MGEN.

GEI Table of general element data. Output by TA1.

GEOM1 GEOM1 Table of Bulk Data entry images related to geometry. Output by IFP

GEOM168 Table of Bulk Data entry images related to geometry (Pre-MSC Nastran Version 69).

Family of GEOM1 tables for all partitioned superelements defined in separate Bulk Data
GEOM1* GEOM1
sections.

6-16 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of Bulk Data entry images related to geometry and assigned to an auxiliary model.
GEOM1A GEOM1
Output by IFP.

Table of Bulk Data entry images related to geometry and merged from GEOM1 and
GEOM1C GEOM1
GEOM1A. Output by AXMPR2.

GEOM1 table containing records which define an external superelement. Specifically, it


GEOM1EX GEOM1
contains CORD1j, CORD2j, EXTRN, and GRID Bulk Data records. Output by BDRYINFO.

GEOM1EXA GEOM1 GEOM1 table containing all geometry definitions of an external superelement.

Table of Bulk Data entry images related to geometry and updated for the current p-level.
GEOM1M GEOM1
Output by GP0.

Updated (optimized) GEOM1. Output by DOM11. Modified GEOM1 with CORD1j records
GEOM1N GEOM1
converted to CORD2j records. Output by SECONVRT.

Table of Bulk Data entry images related to geometry updated for p-elements and
GEOM1P GEOM1
superelements. Output by MODGDN.

Same as GEOM1 except SEQGP Bulk Data entry records have been added and any
GEOM1Q GEOM1
pre-existing SEQGP records are removed. Output by SEQP.

GEOM1R GEOM1 table with reduced GRID record. Output by MATMOD option 36.

Table of Bulk Data entry images related to geometry for the current superelement. Output
GEOM1S GEOM1
by SEP2 and SEP2X.

Table of Bulk Data entry images related to geometry with view-grids added. Output by
GEOM1VU GEOM1
VIEWP.

GEOM1 table related to axisymmetric conical shell, hydroelastic, and acoustic cavity
GEOM1X GEOM1 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
GEOM2 GEOM2
by IFP.

Family of GEOM2 tables for all partitioned superelements defined in separate Bulk Data
GEOM2* GEOM2
sections.

Table of secondary Bulk Data entry images related to element connectivity and updated
GEOM2A GEOM2
for the current p-level. Output by GP0.

GEOM2 table containing records which define an external superelement. Specifically, it


GEOM2EX GEOM2
PLOTEL and SPOINT Bulk Data records. Output by BDRYINFO.

GEOM2EXA GEOM2 GEOM2 table containing all element connectivity of an external superelement.

Table of Bulk Data entry images related to element connectivity and scalar points and
GEOM2M GEOM2
updated for the current p-level. Output by GP0.

Updated (optimized) GEOM2. Output by DOM11. Modified GEOM2 with GO replaced


GEOM2N GEOM2 by X1, X2, and X3 on CBAR, CBEAM, CBEND, CBUSH and CGAP records. Output
by SECONVRT.

GEOM2R GEOM2 table with reduced element record. Output by MATMOD option 37.

Table of Bulk Data entry images related to element connectivity and scalar points for the
GEOM2S GEOM2
current superelement. Output by SEP2 and SEP2X.

Table of Bulk Data entry images related to element connectivity and scalar points
GEOM2VU GEOM2
p-elements removed and view-elements added. Output by VIEWP.

DMAP Programmer's Guide 6-17


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

GEOM2 table related to axisymmetric conical shell, hydroelastic, and acoustic cavity
GEOM2X GEOM2 analysis. Output by IFP3, IFP4, and IFP5. GEOM2 table augmented with fluid data and
SPOINTS if ACMS='YES'. Output by SEQP.

GEOM3 GEOM3 Table of Bulk Data entry images related to static and thermal loads. Output by IFP.

Table of Bulk Data entry images related to static and thermal loads with DAREA entry
GEOM3B
images converted to equivalent FORCE and MOMENT entry images. Output by GP1.

Table of Bulk Data entry images related to static and thermal loads and updated for the
GEOM3M GEOM3
current p-level. Output by GP0.

Updated GEOM3 for cyclic symmetry analysis. Output by CYCLIC1. Modified GEOM3
GEOM3N 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
GEOM3S GEOM3
superelement. Output by SEP2 and SEP2X.

GEOM3T GEOM3 GEOM3 table with new or modified temperatures. Output by MATMOD option 18.

GEOM3 table related to axisymmetric conical shell, hydroelastic, and acoustic cavity
GEOM3X GEOM3
analysis. Output by IFP3.

Table of bulk data entry images related to static and thermal loads for the entire model that
GEOM3XSE GEOM3 now contains FORCE and MOMENT bulk images to represent the external superelement
applied loads.

Table of Bulk Data entry images related to constraints, degree-of-freedom membership


GEOM4 GEOM4
and rigid element connectivity. Output by IFP.

GEOM4705 Table of Bulk Data entry images related to constraints (Pre-MSC Nastran 2001).

Family of GEOM4 tables for all partitioned superelements defined in separate Bulk Data
GEOM4* GEOM4
sections.

GEOM4 table containing records which define an external superelement. Specifically,


GEOM4EX GEOM4
ASETi and QSETi Bulk Data records. Output by BDRYINFO.

GEOM4EXA GEOM4 GEOM4 table containing all constraints and sets of an external superelement.

Table of Bulk Data entry images related to constraints, degree-of-freedom membership


GEOM4M GEOM4
and rigid element connectivity and updated for the current p-level. Output by GP0.

GEOM4N GEOM4 Updated GEOM4 data block with the a-set data.

Table of Bulk Data entry images related to constraints and updated for the constraints
GEOM4P GEOM4
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


GEOM4S GEOM4
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
GEOM4X GEOM4
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.

Logical. Panel static load computation flag. If TRUE then get number of panels flag
GETNUMPN
only and do not compute panel static loads.

Table of grid based local equation map indicating which grid resides on which
GEQMAP
processors/partitions for domain decomposition. Output by SEQP.

GLBRSP Matrix of global responses when system cell 297=-1. Output by SDRP.

6-18 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

GLBRSPDS Global results matrix

GLBTAB Table of global responses when system cell 297=-1. Output by SDRP.

GLBTABDS Global results correlation table

GLERR Table of global error estimates from previous iteration. Output by ADAPT.

GLERR1 Table of global error estimates for current iteration. Output by ADAPT.

GM Multipoint constraint transformation matrix, m-set by n-set. Output by MCE1.

Multipoint constraint transformation matrix with extra points, m-set by ne-set. Output
GMD
by UMERGE1.

GNELM Glue element definition table.

GOA 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
GOD
by UMERGE1.

Table of grid point stress discontinuities for post-processing in the DBC module. Output
GPDCT
by STDCON.

GPDT GPDT Grid point definition table. Output by GP1.

GPECT Grid point element connection table. Output by TA1.

GPECT1 Grid point element connection table for heat transfer analysis. Output by TAHT.

GPECTF 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
GPFORCE or ESE command is present.

GPGK Aerodynamic transformation matrix for loads from the k-set to g-set. Output by GI.

GPKH Aerodynamic transformation matrix for loads from the k-set to h-set.

GPIK Aerodynamic transformation matrix for loads from the h-set to k-set.

GPKE Matrix of grid point kinetic energies.

GPL GPL External grid/scalar point identification number list. Output by GP1.

External grid/scalar/extra point identification number list. (GPL appended with extra point
GPLD
data). Output by DPD.

GPMPF Matrix of grid panel mode participation factors. Output by MODEPF.

GPSETS Table of grid point sets related to the element plot sets. Output by PLTSET and SEPLOT.

GPSNT Grid point shell normal table. Output by TASNP2.

GPSNTC Table of grid point shell normals.

GPSNTS Grid point shell normal table for the current superelement. Output by SEP2 and TASNP2.

GRIDFMP Integer. Case Control set identification number of fluid grids that will be output.

GRIDMP Integer. Case Control set identification number for a set of fluid grids.

Integer. SET Case Control command identification number which contains a list grid
GRIDSET
point identification numbers.

DMAP Programmer's Guide 6-19


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Transformation matrix between symmetric (sine) components and solution set


GS
components. Output by CYCLIC3.

Parent Data
Data Block Name Description
Block Format

HARM Table of harmonic indices. Output by CYCLIC1.

Character. Header with up to 64 characters to be printed and centered at the top of


HDRLBLi
of each page.

List of integer codes for header print control in the DISUTIL module under VECPLOT
HEADCNTL
options IOPT=1 or 5. Output by VECPLOT.

HIS HIS Table of design iteration history.

HISADD HIS Table of design iteration history for current design cycle. Output by DOM12.

HMKT Matrix used to compute hinge moments for each AESURF entry. Output by ADG.

Table of element fluxes in SORT1 format updated for CHBDYi elements. Output by
HOEF1 OEF
SDRHT.

Parent Data
Data Block Name Description
Block Format

Ii Inputs to MATMOD and MATPCH module.

Table of element forces due to unit modal displacement in SORT1 or SORT2 format.
IEF OEF
Output by SDR2 or SDR3.

Table of element stresses or strains due to unit modal displacement in SORT1 or SORT2
IES OES
format. Output by SDR2 or SDR3.

Matrix of nonlinear element forces at constrained points at the output time steps. Output
IFD
by NLTRD and NLTRD2.

IFG Matrix of nonlinear element forces for the g-set at the output time steps. Output by NLTRD.

IFPDB Table data block with IFP module table attributes.

IFS Matrix of total element forces and their rate of change. Output by NLTRD2.

IMi Matrix of independent points.

IMAT Matrix containing imaginary part of CMAT. Output by MATMOD option 34.

INDTA Table of element stress/strain or force item code overrides.

INVEC Starting vector(s).

Table of single point forces of constraint due to unit modal displacement in SORT1 or
IQG OQG
SORT2 format. Output by SDR2 or SDR3.

Table of displacements due to unit modal displacement in SORT1 or SORT2 format.


IUG OUG
Output by SDR2 or SDR3.

Integer. If IUNITSOL=0, then trim solution is being supplied. If IUNITSOL>0, then


IUNITSOL
IUNITSOL'th unit solution is being supplied.

6-20 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Stiffness matrix contribution from the K2PP Case Control command and reduced to the
K2DD
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
K2GG
command. Output by MTRXIN.

Matrix defined on DMIG Bulk Data entries and referenced by the K2PP Case Control
K2PP
command. Output by MTRXIN.

K4AA Structural damping matrix in a-set or d-set.

K4KK Structural damping matrix in cyclic components. Output by CYCLIC3.

K4XX Structural damping matrix in any set. Usually h-set or d-set in FRRD1.

Matrix defined on DMIG Bulk Data entries and referenced by the K42GG Case Control
K42GG
command. Output by MTRXIN.

KAA Stiffness matrix in a-set or d-set.

KAAL Element stiffness matrix for linear elements only reduced to a-set.

KBDD Tangential stiffness in d-set.

KDD Stiffness matrix for the d-set, linear elements only.

KDDICT KDICT KDELM dictionary table. Output by EMG.

KDELM KELM Table of element matrices for differential stiffness. Output by EMG.

KDICT KDICT KELM dictionary table. Output by EMG.

KDICT1 KDICT KELM1 dictionary table. Output by GNFM.

KELM dictionary table. which incorporates combined constraints and design variables.
KDICTDCN
Output by DSAF.

Perturbed element stiffness matrix dictionary table. If CDIF='YES' then this is the forward
KDICTDS
perturbed element matrix dictionary. Output by EMG.

KDICTNL KDICT KELMNL dictionary table. Output by EMG.

Baseline element stiffness matrix dictionary table for h-elements or p-elements. Output
KDICTX KDICT
by EMG.

Table of element matrices for stiffness, heat conduction, differential stiffness, or follower
KELM KELM
stiffness. Output by EMG.

KELM1 KELM Table of element matrices for incremental stiffness. Output by GNFM.

Table of element matrices for stiffness, heat conduction, differential stiffness, or follower
KELMDCN KELM
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
KELMDS KELM
perturbed element matrix dictionary. Output by EMG.

KELMNL KELM Table of element matrices for stiffness for nonlinear elements.

KFHH Fluid partition of modal stiffness matrix KHH.

KFS Stiffness matrix partition (f-set by s-set) from KNN.

KGG Stiffness matrix in g-set.

KGG1 Stiffness matrix in g-set with general elements. Output by SMA3.

KGGNL Stiffness (or heat conduction) matrix in g-set for material nonlinear elements only.

DMAP Programmer's Guide 6-21


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Conduction matrix in g-set for material nonlinear elements only and updated for radiation.
KGGNL1
Output by RMG2.

KGGT Total structural stiffness matrix in g-size (sum of linear, nonlinear and differential matrices).

KHH Generalized (modal) stiffness matrix.

KHH1 Modified generalized (modal) stiffness matrix. Output by FA1.

KKK Stiffness matrix in cyclic components. Output by CYCLIC3.

KLL Stiffness matrix reduced to the l-set.

KLR Stiffness matrix partition (l-set by r-set) from KTT.

KMM Stiffness matrix in m-set (partition of KGG).

KNN Stiffness matrix in n-set; after multipoint constraint reduction.

KOA o-set and a-set matrix partition of stiffness matrix.

KOO Stiffness matrix partitioned to the o-set from KFF.

KRDD Combined linear and material nonlinear stiffness matrix in the d-set.

KRFGG Stiffness matrix due to follower rotational forces in g-set. Output by EMAKFR.

KRR Stiffness matrix partition (r-set by r-set) from KTT.

KRZX Matrix of restrained dimensional elastic derivatives.

KSAZX Matrix of dimensional rigid stability derivatives that includes the effect of splines.

S-set by f-set matrix and s-set by s-set partitions of the material nonlinear stiffness matrix
KSGG
and expanded to g-set size.

KSS Stiffness matrix partition (s-set by s-set) from KNN.

KUX Matrix of stiffness multiplied by displacement or eigenvectors.

KVAL 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,
KXX
FRRD1, FRRD2, TRD1, and TRD2.

Parent Data
Data Block Name Description
Block Format

L Lower triangular decomposition factor. Output by MATMOD option 21.

LAJJT Lower triangular decomposition factor matrix of AJJT.

LAM1DD Lower triangular factor of the dynamic tangential matrix in the d-set.

Normal modes eigenvalue summary table. Output by READ, LANCZOS, MODACC,


LAMA LAMA
and UEIGL.

LAMA* LAMA Family of normal modes eigenvalue summary tables.

LAMA1 LAMA Normal modes eigenvalue summary table updated for mode tracking. Output by MODTRK.

LAMAF LAMA Normal modes eigenvalue summary table for the fluid portion of the model.

LAMAS LAMA Normal modes eigenvalue summary table for the structural portion of the model.

LAMAX LAMA Modified LAMA table. Output by LAMX.

6-22 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Diagonal matrix containing eigenvalues on the diagonal. Output by READ, LANCZOS,


LAMMAT
and UEIGL.

Table of eigenvalues and generalized masses for retained buckling eigenvalue responses.
LBTAB
Output by DSAH.

Partitioning vector for load case deletion. The row size is the same number of columns
LCDVEC 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


LCOLLBLi
of each page.

LCPHL Left-handed complex eigenvector matrix in the l-set. Output by CEAD.

LCPHP Left-handed complex eigenvector matrix in the p-set.

LCPHX Left-handed complex eigenvector matrix in the d-set or h-set. Output by CEAD.

LD Lower triangular factor/diagonal. Output by DECOMP and DCMP.

Table of eigenvalues and generalized masses for retained normal mode eigenvalue
LFTAB
responses. Output by DSAH.

Same as SPCPART except LGPART includes grid points not connected to any element.
LGPART
Output by SEQP.

LISET Integer. Size of interference js-set extracted from the AEBGPTI table. Output by MTRXIN.

LJSET Integer. Size of js-set extracted from the AEBGPTJ table. Output by MTRXIN.

LKSET Integer. Size of ks-set extracted from the AEBGPTK table. Output by MTRXIN.

LLL Lower triangular factor/diagonal for the l-set from KLL.

Lower triangular factor for nonlinear elements including material, slideline, and differential
LLLT
stiffness effects.

LMAT 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
LMTROWS
excluded from the internal reordering in the DCMP module.

LMPF Matrix of fluid force to fluid mode participation factors. Output by MODEPF.

LOCVEC Vector containing grid locations in the basic coordinate system.

LOO Lower triangular factor/diagonal for the o-set from KOO. Output by DCMP.

Resequencing matrix based on internal resequencing of KLL. Output by DCMP and


LSEQ
DECOMP.

LXX Lower triangular factor/diagonal of shifted stiffness matrix.

Parent Data
Data Block Name Description
Block Format

M2DD Mass matrix contribution from the M2PP Case Control command and reduced to the d-set.

Matrix defined on DMIG Bulk Data entries and referenced by the M2GG Case Control
M2GG
command. Output by MTRXIN.

Matrix defined on DMIG Bulk Data entries and referenced by the M2PP Case Control
M2PP
command. Output by MTRXIN.

DMAP Programmer's Guide 6-23


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

MA Rigid body mass matrix for the a-set. Output by EFFMAS.

MAA Mass matrix in a-set or d-set.

MAG Magnitudes of modal contributions matrix.

Superelement upstream to downstream boundary coordinate system transformation


matrix output by GENTRAN. Superelement boundary transformation matrix for secondary
MAPS
superelements (mirror, identical, and repeated), boundary resequencing and releases
output by SEP2 and SEP2X.

Family of MAPS (superelement upstream to downstream boundary coordinate system,


MAPS*
secondary (mirror, identical, and repeated), and release transformation matrix).

MAR Table of virtual mass element areas. Output by MGEN.

MAT Matrix. Output by MATGEN.

MATIi 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
MATGi
MTRXIN.

MATJi Matrices defined on DMIJ Bulk Data entries. Output by MTRXIN.

MATKi Matrices defined on DMIK Bulk Data entries. Output by MTRXIN.

MATNAMi Character. Matrix name found on DMIG, DMIJ, DMIK, and DMIJI Bulk Data entries.

Matrices defined on DMIG Bulk Data entries and intended for the p-set. Output by
MATPi
MTRXIN.

Table of Bulk Data entry images related to hydroelastic boundary, heat transfer radiation,
MATPOOL
virtual mass, DMIG, and DMIAX entries. Output by IFP and IFP4.

MATPOOLS MATPOOL table for the current superelement. Output by SEP2X.

MATPOOLX MATPOOL table related to hydroelastic analysis. Output by IFP4.

MATS Any matrix on slave processors.

MATM Any matrix on master processor. Output by DISUTIL.

MBODY Body table for p-element analysis. Output by GP0.

Logical. Modal complex eigenvalue analysis subcase flag. Set to TRUE if at least one
MCEIGCC ANALYSIS=MCEIG command was found in CASECC and CASECEIG is specified in the
output list. Output by MDCASE.

MCHI Matrix relating displacements to source strengths. Output by MGEN.

MCHI2 Secondary matrix relating displacements to source strengths. Output by MGEN.

MDD Mass (or radiation) matrix for the d-set

MDICT MELM dictionary table. Output by EMG.

MDLIST Selected mode list from EFFMAS.

MEA Matrix of element forces per unit motion of the a-set.

MEDGE Edge table for p-element analysis. Output by GP0.

MEF Matrix form of element force output table. Output by DRMH1 and DRMS1.

MEM Modal effective mass matrix. Output by EFFMAS.

6-24 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

MEMF Modal effective mass fraction table. Output by EFFMAS.

MES Matrix form of element stress or strain output table. Output by DRMH1 and DRMS1.

MELM KELM Table of element mass matrices. Output by EMG.

MESH Mesh type for aerodynamic or structural components: 'AERO' or 'STRU'.

MESTNL Nonlinear element summary table at current step. Output by NLITER and NLTRD2.

MEW Modal effective weight matrix. Output by EFFMAS.

MFACE Face table for p-element analysis. Output by GP0.

MFHH Fluid partition of modal mass matrix MHH.

MFORC Modal force vector for superelement.

MFRDEP Table for frequency dependent properties that can be designed.

MGG Mass or radiation matrix in g-size.

MGGDIAG Column vector of diagonal values from superelement mass matrix (g-set size).

MHH Generalized (modal) mass matrix

MHH1 Modified generalized (modal) mass matrix. Output by FA1.

MI Modal mass matrix. Output by READ and LANCZOS.

Mi Matrix data block. Output by INPUTT4 and input to MATPRN and OUTPUT4.

Table of pairs of user-supplied material property identification numbers (MIDs) and internal
MIDLIS
baseline MIDs. Output by DSABO.

MKK Mass matrix in cyclic components. Output by CYCLIC3.

MKLIST Table of Mach number and reduced frequency pairs. Output by GETMKL.

MLAM Matrix relating element forces to source strengths. Output by MGEN.

MLAM2 Secondary matrix relating element forces to source strengths. Output by MGEN.

MLL Mass matrix reduced to the l-set.

MLR Mass matrix partition (l-set by r-set) from MTT.

MOA Mass matrix partition (o-set by a-set) from MFF.

MOFPi Matrix form of the i-th output table. Output by DRMH1 and DRMS1.

MON Merged monitor table. Output by MRGMON.

MONi Monitor tables

MONITOR Structural monitor point table. Output by MAKAEMON and MAKMON.

MOO Mass matrix partitioned to the o-set from KFF.

MPAER Elastic restrained loads on aerodynamic monitor points at trim.

MPAERV Elastic restrained monitor point loads on aerodynamic model

MPAEUV Elastic unrestrained monitor point loads on aerodynamic model

MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim.

MPARV Rigid monitor point loads on aerodynamic model

DMAP Programmer's Guide 6-25


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

MPFEM Modal participation factors for effective mass. Output by EFFMAS.

MPFMAP Table describing content of mode participation factor matrices. Output by MODEPF.

MPJN2O Mapping matrix to map j-set data from new order to old order. Output by APD.

MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images. Output by VDR.

Elastic restrained loads on structural monitor points at trim(excluding inertial loads and
MPSER
static applied loads).

MPSERP Elastic restrained loads on structural monitor points due to static applied loads.

MPSERV Elastic restrained monitor point loads on structural model

MPSEUV Elastic unrestrained monitor point loads on structural model

MPSIR Inertial loads on structural monitor points at trim.

MPSIRV Inertial restrained monitor point loads on structural model

MPSIUV Inertial unrestrained monitor point loads on structural model

Rigid aerodynamic loads on structural monitor points at trim (excluding inertial loads
MPSR
and static applied loads).

MPSRP Rigid loads on structural monitor points due to static applied loads.

MPSRV Rigid splined monitor point loads on structural model

MPT MPT Table of Bulk Data entry images related to material properties. Output by IFP and IFP6.

Copy of MPT except MAT8 records are replaced by equivalent MAT2 records. Output
MPTC MPT
by IFP6, CMPZPR, and DSTA.

MPTN MPT Updated (optimized) MPT. Output by DOM11.

Table of Bulk Data entry images related to material properties for the current superelement.
MPTS MPT
Output by SEP2 and SEP2X.

MPT with design variable perturbations. Output by DSABO. Copy of MPT except MATHP
MPTX MPT 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


MQG
and DRMS1.

MR Rigid body mass matrix (r-set by r-set). Output by RBMG4.

MRR Stiffness matrix partition (r-set by r-set) from MTT.

Table of updated DRESP1 Bulk Data entry images corresponding to the new mode
MTRAK
numbering. Output by MODTRK.

MUG Matrix form of displacement output table. Output by DRMH1 and DRMS1.

Displacement (or temperature) matrix for stiffness (or heat conduction) update. Output by
MUGNI
NLITER.

Solution matrix from nonlinear transient response analysis in the d-set from the previous
MULNT
subcase. Output by NLTRD2.

MUX 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,
MXX
FRRD2, TRD1, and TRD2.

6-26 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

MZZ Generalized mass matrix based on PHZ.

Parent Data
Data Block Name Description
Block Format

NAMEi Matrices defined on DMIG Bulk Data entries. Output by MTRXIN.

NEWDBi Input table in Version 69 (or greater) format. Output by MAKENEW.

NFDICT Nonlinear element energy/force index table. Output by TA1.

NLFT Nonlinear Forcing function table. Output by DPD.

NPC Normalized panel contributions results matrix.

Table containing fluid face and the maximum of eight structural grids which lie within the
NORTAB
acoustic face. Output by GP5.

NSMEST Non-structural mass element summary table.

Parent Data
Data Block Name Description
Block Format

Oi Outputs of MATMOD module.

OBC Output contact pressure and traction results.

Output glue normal and in-plane tractions for SOL 101, SOL 103 and SOL 105. SORT1
OBG
and SORT2 formats are supported.

OBG1 Glue normal and tangential tractions at grid point in basic coordinate system.

Design objective table for a given analysis type and superelement. Objective attributes with
OBJTAB OBJTAB
retained response identification number. Output by DOPR3.

OBJTBG OBJTAB Design objective table. Objective attributes with retained response identification number.

Table of design objective attributes with retained response identification number. Output
OBJTBR OBJTAB
by DSAD.

OCCORF Output table of cross-correlation functions. Output by RANDOM.

OCEIG Complex eigenvalue extraction report. Output by CEAD.

OCPSDF Output table of cross-power-spectral-density functions. Output by RANDOM.

OEDE1 Elemental energy loss. Output by GPFDR.

OEDS1 OES Table of element stress discontinuities. Output by STDCON.

OEE OEE Output element energy (strain, kinetic, loss).

Table of element strains in SORT2 format for the autocorrelation function. Output by
OEEATO2 OEE
RANDOM.

Table of element strains in SORT2 format for the cross correlation function. Output by
OEECRM2
RANDOM.

OEENO2 OEE Table of element strains in SORT2 format for the NO function. Output by RANDOM.

OEEPSD2 OEE Table of element strains in SORT2 format for the PSD function. Output by RANDOM.

OEERMS2 OEE Table of element strains in SORT2 format for the RMS function. Output by RANDOM.

DMAP Programmer's Guide 6-27


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

OEF OEF Table of element forces in SORT1 or SORT2 format. Output by DDRMM.

OEF1 OEF Table of element forces (or fluxes) in SORT1 format. Output by SDR2 or DRMH3.

OEF1A OEF Table of element forces in SORT1 format for the composite elements only. Output by SDR2.

Table of element forces in SORT1 format for the non-composite elements only. Output
OEF1AA OEF
by SDRCOMP.

Table of element forces, excluding non-composite elements, in SORT1 format for design
OEF1DS OEF
responses.

OEF1VU OEF 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
OEF1X OEF
station output. Output by SDRX and SDRXD.

OEF2 OEF Table of element forces in SORT2 format.

OEFATO1 OEF 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
OEFATO1M OEF
autocorrelation

Table of element forces in SORT2 format for the autocorrelation function. Output by
OEFATO2 OEF
RANDOM.

Table of element forces in SORT2 format in the material coordinate system for the
OEFATO2M OEF
autocorrelation. Output by RANDOM.

OEFCRM1 OEF 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
OEFCRM1M OEF
function.

Table of element forces in SORT2 format for the cross correlation function. Output by
OEFCRM2 OEF
RANDOM.

Table of element forces in SORT2 format in the material coordinate system for the CRMS
OEFCRM2M OEF
function. Output by RANDOM.

Table of element forces, excluding non-composite elements, in SORT1 format for the
OEFDSN OEF
perturbed configuration.

OEFIIP OEF Data block for in-plane ply failure indices.

OEFIIS OEF Data block for inter-laminar shear failure indices.

OEFIT OEF Table of composite element failure indices. Output by SDRCOMP.

OEFITDS OEF Table of composite element failure indices for design responses.

OEFITDSN OEF Table of composite element failure indices for the perturbed configuration.

OEFMC Table of modal contributions of element forces.

OEFNL1 OEF Table of nonlinear element fluxes in SORT1 format. Output by SDR2.

OEFNO1 OEF 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
OEFNO1M OEF
function.

OEFNO2 OEF Table of element forces in SORT2 format for the NO function. Output by RANDOM.

6-28 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of element forces in SORT2 format in the material coordinate system for the NO
OEFNO2M OEF
function. Output by RANDOM.

OEFPSD1 OEF 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
OEFPSD1M OEF
function.

OEFPSD2 OEF 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
OEFPSD2M OEF
function. Output by RANDOM.

OEFRMS1 OEF Table of element forces in SORT1 format for the RMS function.

Table of element forces in SORT1 format in the material coordinate system for the RMS
OEFRMS1M OEF
function.

OEFRMS2 OEF 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
OEFRMS2M OEF
function. Output by RANDOM.

OEIG Real eigenvalue extraction report. Output by READ.

OEKE1 Elemental kinetic energy. Output by GPFDR.

Table of element pressures due to virtual mass in SORT1 or SORT2 format. Output
OEP
by MDATA.

OERP Equivalent radiated power output.

OERPEL Element equivalent radiated power output.

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.


OES1 OES OES1A Table of element strain/curvatures in SORT1 format for the composite elements
only. Output by SDR2.

OES1C OES Table of composite element stresses or strains in SORT1 format. Output by SDRCOMP.

OES1CDS OES Table of composite element stresses in SORT1 format for design responses.

OES1DS OES Table of element stresses in SORT1 format for design responses.

Element stress or strain table in SORT1 format in the material coordinate system defined
OES1M OES
on the MAT1 entry. Output by CURV.

Grid point stress or strain table in SORT1 format and interpolated from the centroidal stress
OES1G OES
table, OES1M. Output by CURV.

OES1VU OES 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
OES1X OES station output. Output by SDRX and SDRXD. Table of linear and nonlinear element
stresses in SORT1 and linear element format. Output by MERGEOFP.

OES2 OES Table of element stresses or strains in SORT2 format.

OES2GX OES Table of grid point stresses in SORT2 format. Output by CURVPLOT.

OESATO1 OES Table of element stresses in SORT1 format for the autocorrelation function.

OESATO1C OES Table of composite element stresses in SORT1 format for the autocorrelation function.

DMAP Programmer's Guide 6-29


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Table of element stresses in SORT1 format in the material coordinate system for the
OESATO1M OES
autocorrelation function.

Table of element stresses in SORT2 format for the autocorrelation function. Output by
OESATO2 OES
RANDOM.

Table of composite element stresses in SORT2 format for the autocorrelation function.
OESATO2C OES
Output by RANDOM.

Table of element stresses in SORT2 format in the material coordinate system for the
OESATO2M OES
autocorrelation function. Output by RANDOM.

OESCDSN OES Table of composite element stresses in SORT1 format for the perturbed configuration.

OESCRM1 OES Table of element stresses in SORT1 format for the CRMS function.

OESCRM1C OES Table of composite element stresses in SORT1 format for the CRMS function.

Table of element stresses in SORT1 format in the material coordinate system for the CRMS
OESCRM1M OES
function.

OESCRM2 OES Table of element stresses in SORT2 format for the CRMS function. Output by RANDOM

Table of composite element stresses in SORT2 format for the CRMS function. Output
OESCRM2C OES
by RANDOM

Table of element stresses in SORT2 format in the material coordinate system for the CRMS
OESCRM2M OES
function. Output by RANDOM

OESDSN OES Table of element stresses in SORT1 format for the perturbed configuration

OESMC Table of modal contributions of element stresses.

Table of nonlinear element stresses in SORT1 format. Output by NLTRD, NLTRD2, and
OESNL1 OES
SDRNL.

Table of slideline contact element stresses in SORT1 format. Output by NLTRD2 and
OESNLB1 OES
SDRNL.

Table of nonlinear element stresses in SORT1 format and appended for all subcases
OESNLXR OES
(OESNLX from SDRNL).

OESNO1 OES Table of element stresses in SORT1 format for the NO function.

OESNO1C OES Table of composite element stresses in SORT1 format for the NO function.

Table of element stresses in SORT1 format in the material coordinate system for the NO
OESNO1M OES
function.

OESNO2 OES Table of element stresses in SORT2 format for the NO function. Output by RANDOM.

Table of composite element stresses in SORT2 format for the NO function. Output by
OESNO2C OES
RANDOM.

Table of element stresses in SORT2 format in the material coordinate system for the NO
OESNO2M OES
function. Output by RANDOM.

OESPSD1 OES Table of element stresses in SORT1 format for the PSD function.

OESPSD1C OES Table of composite element stresses in SORT1 format for the PSD function.

Table of element stresses in SORT1 format in the material coordinate system for the PSD
OESPSD1M OES
function.

OESPSD2 OES Table of element stresses in SORT2 format for the PSD function. Output by RANDOM.

6-30 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of composite element stresses in SORT2 format for the PSD function. Output by
OESPSD2C OES
RANDOM.

Table of element stresses in SORT2 format in the material coordinate system for the PSD
OESPSD2M OES
function. Output by RANDOM.

OESRIP OES Data block for in-plane ply strength ratios.

OESRIS OES Data block for inter-laminar shear strength ratios.

OESRMS1 OES Table of element stresses in SORT1 format for the RMS function.

OESRMS1C OES Table of composite element stresses in SORT1 format for the RMS function.

Table of element stresses in SORT1 format in the material coordinate system for the RMS
OESRMS1M OES
function.

OESRMS2 OES Table of element stresses in SORT2 format for the RMS function. Output by RANDOM.

Table of composite element stresses in SORT2 format for the RMS function. Output by
OESRMS2C OES
RANDOM.

Table of element stresses in SORT2 format in the material coordinate system for the RMS
OESRMS2M OES
function. Output by RANDOM.

OESRT OEF Table of composite element ply strength ratio. Output by SDRCOMP

Table of element stresses for frequency response analysis that includes von Mises stress
OESVM OES
output.

Table of element stresses for frequency response analysis that includes von Mises stress
OESVM1 OES
output in SORT1 format.

Table of element stresses for frequency response analysis that includes von Mises stress
OESVM2 OES
output in SORT2 format.

Table of composite element stresses for frequency response analysis that includes von
OESVM1C OES
Mises stress output in SORT1 format.

Table of composite element stresses for frequency response analysis that includes von
OESVM2C OES
Mises stress output in SORT2 format.

Table of element RMS stresses in SORT1 format for random analysis that includes von
OESXRMS1 OES
Mises stress output.

Table of composite element RMS stresses in SORT1 format for random analysis that
OESXRM1C OES
includes von Mises stress output.

Table of element stresses in SORT1 format in the material coordinate system for the RMS
OESXRM1M OES
function.

Table of element RMS stresses in SORT2 format for random analysis that includes von
OESXRMS2 OES
Mises stress output. Output by RANDOM.

Table of composite element RMS stresses in SORT2 format for random analysis that
OESXRM2C OES
includes von Mises stress output. Output by RANDOM.

Table of element stresses in SORT2 format in the material coordinate system for the RMS
OESXRM2M OES
function. Output by RANDOM.

Table of fluid modal participation factors by natural modes in SORT2 format. Output by
OFMPF2M
RANDOM.

OFPE Element data recovery table in SORT1 or SORT2 format.

OFPES Filtered and sorted element data recovery table. Output by STRSORT.

DMAP Programmer's Guide 6-31


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

OFPi Output table suitable for processing by the OFP module.

OFPi1 Output table in SORT1 format usually created by, but not limited to, the SDR2 module.

OFPi2 Output table in SORT2 format.

OFPiX Output table in SORT2 or SORT1 format. Output by SDR3.

OGDS1 Table of grid point stress discontinuities. Output by STDCON.

OGK Output gasket element results.

OGPFB1 OGF Table of grid point forces. Output by GPFDR.

Grid point force balance data block (SORT1 format) for which grid point force balance
OGPFIN
totals are to be recalculated.

OGPFOU Resulting grid point force balance data block (SORT1 format).

OGPFTMP Grid point force balance data block to be used as a template (SORT1 format).

OGPKE1 Table of grid point kinetic energies in SORT1 format. Output by SDR2.

Table of panel grid modal participation factors by natural modes in SORT2 format. Output
OGPMPF2M
by RANDOM.

OGPWG Grid point weight generator table in weight units. Output by GPWG or VECPLOT (option 7).

OGS1 OGS Table of grid point stresses or strains in SORT1 format. Output by GPSTR2.

OINT P-element output control table. Contains OUTPUT Bulk Data entries. Output by IFP.

OINTDS P-element output control table for constrained elements. Output by DOPR3.

OINTDSF P-element output control table for the perturbed configuration. Output by DSAH.

Complex or real eigenvalue summary table, transient response time output list or frequency
OL
response frequency output list. Output by CEAD, READ, TRLG, and FRLG.

OL1 OL truncated by the OFREQ or OTIME or OMODES command.

OLDDBi Output table in pre-Version 69 format. Output by MAKEOLD.

OLF Nonlinear static load factor list.

Table of load modal participation factors by natural modes in SORT2 format. Output by
OLMPF2M
RANDOM.

Transformation matrix describing the surface spline connection. NI rows by ND columns. NI


OM1
= number of independent points. ND = number of dependent points.

OMECON Table of constant total modal energies.

OMEOSC Table of oscillating total modal energies.

OMKEC Table of constant modal kinetic energies.

OMKEO Table of oscillating modal kinetic energies.

OMSEC Table of constant modal strain energies.

OMSEO Table of oscillating modal strain energies.

ONRGY1 Table of element strain energies and energy densities. Output by GPFDR.

ONRGYDS OEE Table of element strain energies in SORT1 format for design responses. Output by GPFDR.

6-32 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of element strain energies and energy densities in SORT1 format for design
ONRGYDSN OEE
responses for the perturbed configuration.

OPG OPG Table of applied loads.

OPG1 OPG Table of applied loads in SORT1 format. Output by SDR2.

OPG2 OPG Table of applied loads in SORT2 format.

OPG2X OPG Table of applied loads in SORT2 format. Output by CURVPLOT.

OPGATO1 OPG Table of applied loads in SORT1 format for the autocorrelation function.

Table of applied loads in SORT2 format for the autocorrelation function. Output by
OPGATO2 OPG
RANDOM.

OPGCRM1 OPG 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
OPGCRM2 OPG
RANDOM.

OPGNO1 OPG Table of applied loads in SORT1 format for the NO function.

OPGNO2 OPG Table of applied loads in SORT2 format for the NO function. Output by RANDOM.

OPGPSD1 OPG Table of applied loads in SORT1 format for the PSD function.

OPGPSD2 OPG Table of applied loads in SORT2 format for the PSD function. Output by RANDOM.

OPGRMS1 OPG Table of applied loads in SORT1 format for the RMS function.

OPGRMS2 OPG 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
OPMPF2M
by RANDOM.

OPNL1 Table of nonlinear loads in SORT1 format for the h-set or d-set. Output by VDR.

OPTPRM OPTPRM Table of optimization parameters.

OPTPRMG OPTPRM Table of optimization parameters.

OPTNEW Updated table of optimization parameters. Output by DOM12.

Table of single or multipoint forces-of-constraint in SORT1 or SORT2 format. Output by


OQG OQG
DDRMM.

Table of single or multipoint forces-of-constraint in SORT1 format. Output by SDR2 or


OQG1 OQG
DRMH3.

OQG1DS OQG Table of single point forces-of-constraint in SORT1 format for design responses.

OQG2 OQG Table of single point forces of constraint in SORT2 format.

OQG2X OQG Table of single point forces of constraint in SORT2 format. Output by CURVPLOT.

OQGATO1 OQG 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.
OQGATO2 OQG
Output by RANDOM.

OQGCRM1 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
OQGCRM2
by RANDOM.

DMAP Programmer's Guide 6-33


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Table of single forces-of-constraint in SORT1 format for design responses for the perturbed
OQGDSN OQG
configuration.

OQGGF1 OQG Glue forces at grid point in basic coordinate system.

OQGMC Table of modal contributions of single point constraint forces.

OQGNO1 OQG 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
OQGNO2 OQG
by RANDOM.

OQGPSD1 OQG 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
OQGPSD2 OQG
by RANDOM.

OQGRMS1 OQG 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
OQGRMS2 OQG
by RANDOM.

OQMATO1 OQG 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.
OQMATO2 OQG
Output by RANDOM.

OQMCRM1 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
OQMCRM2
by RANDOM

OQMG2 OQG Table of multipoint forces of constraint in SORT2 format.

OQMNO1 OQG Table of multipoint forces of constraint in SORT1 format for the NO function.

Table of multipoint forces of constraint in SORT2 format for the NO function. Output
OQMNO2 OQG
by RANDOM.

OQMPSD1 OQG 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
OQMPSD2 OQG
by RANDOM.

OQMRMS1 OQG 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
OQMRMS2 OQG
by RANDOM.

OSDISP2 Table of Modal Contributions.

OSHT Output shell element thickness results.

Table of structural modal participation factors by natural modes in SORT2 format. Output
OSMPF2M
by RANDOM.

OSPDS Output contact separation distance results.

OSTATO1C OES Table of composite element strains in SORT1 format for the autocorrelation function.

Table of element strains in SORT1 format in the material coordinate system for the
OSTATO1M OES
autocorrelation function.

Table of composite element strains in SORT2 format for the autocorrelation function.
OSTATO2C OES
Output by RANDOM.

6-34 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of element strains in SORT2 format in the material coordinate system for the
OSTATO2M OES
autocorrelation function. Output by RANDOM.

OSTCRM1C OES Table of composite element strains in SORT1 format for the CRMS function.

Table of element strains in SORT1 format in the material coordinate system for the CRMS
OSTCRM1M OES
function.

Table of composite element strains in SORT2 format for the CRMS function. Output by
OSTCRM2C OES
RANDOM

Table of element strains in SORT2 format in the material coordinate system for the CRMS
OSTCRM2M OES
function. Output by RANDOM

OSTNO1C OES Table of composite element strains in SORT1 format for the NO function.

Table of element strains in SORT1 format in the material coordinate system for the NO
OSTNO1M OES
function.

Table of composite element strains in SORT2 format for the NO function. Output by
OSTNO2C OES
RANDOM.

Table of element strains in SORT2 format in the material coordinate system for the NO
OSTNO2M OES
function. Output by RANDOM.

OSTPSD1C OES Table of composite element strains in SORT1 format for the PSD function.

Table of element strains in SORT1 format in the material coordinate system for the PSD
OSTPSD1M OES
function.

Table of composite element strains in SORT2 format for the PSD function. Output by
OSTPSD2C OES
RANDOM.

Table of element strains in SORT2 format in the material coordinate system for the PSD
OSTPSD2M OES
function. Output by RANDOM.

OSTR1CDS OEE Table of composite element strains in SORT1 format for design responses.

OSTR1DS OEE Table of element strains in SORT1 format for design responses.

OSTR1G OEE Table of grid point strains in SORT1 format. Output by CURV.

OSTR1VU OEE Table of element strains in SORT1 format for view elements. Output by SDRP.

Table of element strains in SORT1 format augmented with strains for 1-D elements. Output
OSTR1X
by SDRX and SDRXD.

OSTR2 OEE Table of element strains in SORT2 format.

OSTRATO1 OES Table of element strains in SORT1 format for the autocorrelation function.

Table of element strains in SORT2 format for the autocorrelation function. Output by
OSTRATO2 OES
RANDOM.

OSTR2GX OEE Table of grid point strains in SORT2 format. Output by CURVPLOT.

OSTRCDSN OEE Table of composite element strains in SORT1 format for the perturbed configuration.

OSTRCRM1 OES Table of element strains in SORT1 format for the CRMS function.

OSTRCRM2 OES Table of element strains in SORT2 format for the CRMS function. Output by RANDOM

OSTRDSN OEE Table of element strains in SORT1 format for the perturbed configuration

OSTRMC Table of modal contributions of element strains.

DMAP Programmer's Guide 6-35


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

OSTRMS1C OES Table of composite element strains in SORT1 format for the RMS function.

Table of element strains in SORT1 format in the material coordinate system for the RMS
OSTRMS1M OES
function.

Table of composite element strains in SORT2 format for the RMS function. Output by
OSTRMS2C OES
RANDOM.

Table of element strains in SORT2 format in the material coordinate system for the RMS
OSTRMS2M OES
function. Output by RANDOM.

OSTRNO1 OES Table of element strains in SORT1 format for the NO function.

OSTRNO2 OES Table of element strains in SORT2 format for the NO function. Output by RANDOM.

OSTRPSD1 OES Table of element strains in SORT1 format for the PSD function.

OSTRPSD2 OES Table of element strains in SORT2 format for the PSD function. Output by RANDOM.

OSTRRMS1 OES Table of element strains in SORT1 format for the RMS function.

OSTRRMS2 OES Table of element strains in SORT2 format for the RMS function. Output by RANDOM.

OTEMP Table of grid point temperatures.

OUG OUG Table of displacements in SORT1 or SORT2 format. Output by DDRMM.

OUG1 OUG Table of displacements in SORT1 format. Output by SDR2 or DRMH3.

OUG1DS OUG Table of displacements in SORT1 format for design responses.

OUG1VU OUG Table of displacements in SORT1 format for view grids. Output by SDRP.

OUG2 OUG Table of displacements in SORT2 format.

OUG2X OUG Table of displacements in SORT2 format. Output by CURVPLOT.

OUGATO1 OUG Table of displacements in SORT1 format for the autocorrelation function.

Table of displacements in SORT2 format for the autocorrelation function. Output by


OUGATO2 OUG
RANDOM.

OUGCRM1 OUG Table of displacements in SORT1 format for the cross correlation function.

Table of displacements in SORT2 format for the cross correlation function. Output by
OUGCRM2 OUG
RANDOM.

Table of displacements in SORT1 format for design responses for the perturbed
OUGDSN OUG
configuration.

OUGGC Table of grid contributions.

OUGMC Table of modal contributions for displacements, velocities, accelerations.

OUGNO1 OUG Table of displacements in SORT1 format for the NO function.

OUGNO2 OUG Table of displacements in SORT2 format for the NO function. Output by RANDOM.

OUGPC Table of panel contributions.

OUGPSD1 OUG Table of displacements in SORT1 format for the PSD function.

OUGPSD2 OUG Table of displacements in SORT2 format for the PSD function. Output by RANDOM.

OUGRC Table of reciprocal panel contributions.

OUGRMS1 OUG Table of displacements in SORT1 format for the RMS function.

6-36 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

OUGRMS2 OUG Table of displacements in SORT2 format for the RMS function. Output by RANDOM.

OUGV1 OUG Table of absolute displacement, velocity and acceleration in SORT1 format.

OUGV2 OUG Table of absolute displacement, velocity and acceleration in SORT2 format.

OUTFLE Table of panel or grid contributions in SORT1 format.

OUTVEC Last vector block (Lanczos only). Output by READ.

OUXY1 OUG Table of displacements in SORT1 format for h-set or d-set. Output by VDR.

OVG Table of aeroelastic x-y plot data for V-g or V-f curves. Output by FA2.

OXRESP Table of response spectra in SORT2 format. Output by RSPEC.

Parent Data
Data Block Name Description
Block Format

Pi1 Pi truncated by the OFREQ or OTIME or OMODES command.

Matrix defined on DMIG Bulk Data entries and referenced by the P2G Case Control
P2G
command. Output by MTRXIN.

PA 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
PA*
superelements.

PAK Aerodynamic forces at aerodynamic boxes.

PANSLT Panel static load table. Output by GP5.

PARTV Partitioning vector.

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
PARTVEC 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.

Basic grid point definition table updated to support plotting CHBDYi elements. Output
PBGPDT BGPDT
by PLTHBDY.

PBYG 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


PC
respectively.

PC1 Updated stepwise preconditioner matrix. Output by SOLVIT and STATICS.

PCDB Table of model (undeformed and deformed) plotting commands. Output by IFP1.

Table of model (undeformed and deformed) plotting commands for the current
PCDBS
superelement (identification number equal to output value of SEID). Output by SEP2CT.

Table of model (undeformed and deformed) plotting commands for the superelement
PCDBDR
(identification number equal to output value of SEID). Output by SEDR.

Table containing LAM option input and expanded information from the PCOMP Bulk
PCOMPT
Data entry.

Table containing LAM option input and expanded information from the PCOMP Bulk
PCOMPTC
Data entry. Output by IFP6.

DMAP Programmer's Guide 6-37


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

PCOMPTX PCOMPT with design variable perturbations. Output by DSABO.

PD Dynamic load matrix for the d-set.

PD1 Equivalent load vector for mode acceleration computations for the a-set. Output by DDR2.

PDF Frequency response load matrix in the d-set. Output by FRLG.

PDT Transient response load matrix in the d-set for output time steps. Output by TRLG.

PDT1 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


PECT
PLTHBDY.

PELSDSF P-element set table for the perturbed configuration. Output by DSAH.

PELSET P-element set table, contains SETS DEFINITIONS. Output by PLTSET.

PELSETDS P-element set table for constrained elements. Output by DOPR3.

PFHF Fluid partition of frequency response modally reduced load matrix.

PFP Frequency response load matrix in the p-set combined with gust loads. Output by GUST.

Static load matrix applied to the g-set. In superelement analysis and output by SELA, PG
PG
includes the loads from upstream superelements. Output by SSG1 and SELA.

PG1 Combined static load matrix for the g-set and in the residual structure. Output by PCOMB.

PGG 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
PGT
by SDR1.

Static load matrix for the g-set and in the residual structure due to static loads in upstream
PGUP
superelements only.

PGVST Static load vector matrix (g-set). Output by MAKAEFS.

PHA 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
PHA1
MODTRK.

Designed normal modes eigenvector matrix in the a-set updated for mode tracking.
PHAREF1
Output by MODTRK.

Structural partition (row-wise) of eigenvector matrix PHDH. Also partitioned column-wise


PHASH2
according to parameter STRUCTMP.

PHDFH Fluid partition (row-wise) of eigenvector matrix PHDH.

PHDH Transformation matrix from d-set to h-set (modal). Output by GKAM.

PHF Frequency response load matrix in the h-set (modal). Output by FRLG.

Frequency response load matrix in the h-set (modal) combined with gust loads. Output
PHF1
by GUST.

PHG Normal modes eigenvector matrix in the g-set. Output by READ and LANCZOS.

PHG* Family of normal modes eigenvector matrices in the g-set.

Normal modes eigenvector matrix in the g-set updated for mode tracking. Output by
PHG1
MODTRK.

6-38 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Designed normal modes eigenvector matrix in the g-set from the prior design cycle output
PHGREF
of MODTRK. Output by MODTRK.

Designed normal modes eigenvector matrix in the g-set updated for mode tracking.
PHGREF1
Output by MODTRK.

PHIDLL Retained left divergence eigenvector responses.

PHIDRL Retained right divergence eigenvector responses.

PHIG Mode shape matrix (U8-set) for superelement.

PHT Transient response load matrix in the h-set (modal) for all time steps. Output by TRLG.

PHX Right eigenvector matrix for real eigenvalues only. Output by UEIGL.

PHXL Left eigenvector matrix for real eigenvalues only. Output by UEIGL.

PHZ Generalized degree-of-freedom transformation matrix. Output by DYNREDU.

Static load matrix for the g-set of the current superelement and applied to its interior
PJ
points only.

PKF Matrix of k-set forces per frequency.

PKYG Matrix of equivalent static loads due to enforced displacement for the g-set.

PL Static load matrix reduced to the l-set. Output by SSG2.

PLI Static load matrix with inertial loads and reduced to the l-set. Output by SSG4.

PLIST2 Table of type two properties on DVPREL2 Bulk Data entries. Output by DOPR1.

PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries. Output by DOPR1.

PLMAT Initial and final load matrices for subcase.

PLOTMSG Table of user informational messages generated during the plot process. Output by PLOT.

Table of user informational messages generated during the definition of element plot sets.
PLSETMSG
Output by PLTSET and SEPLOT.

PLTPAR 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


PMPF
MODEPF.

PMYG 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,
PNL
TRD1, and TRD2.

PNLLST Table of triplets defining panel names and their associated IPANEL qualifier values.

PO Static load matrix partitioned to the o-set. Output by SSG2.

POI Static load matrix with inertial loads and reduced to the o-set. Output by SSG4.

POSTCDB Table of commands from the OUTPUT(POST) section of Case Control. Output by IFP1.

PPF Frequency response load matrix in the p-set. Output by FRLG.

PPT Transient response load matrix in the p-set for output time steps. Output by TRLG.

PPVR Partitioning vector for random responses. Output by DOPRAN.

DMAP Programmer's Guide 6-39


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Partitioning matrix to partition the "active" URDDI from the "inactive". Active URRDI are
PRBDOFS assigned a 1.0 value and are connected to the SUPORT degrees-of-freedom. Output
by MAKETR.

PROPI Matrix of initial property values. Output by DOPR1.

PROPI* Family of matrices of initial property values. Output by DOPR1.

PROPO Matrix of final (optimized) property values. Output by DOM9.

PS Static load matrix partitioned to the s-set. Output by SSG2.

PSDF Power spectral density table. Output by RANDOM.

PSDL Power spectral density list. Output by DPD.

PSF Frequency response load matrix in the s-set. Output by FRLG.

PSI Modal partitioning factor matrix.

PST Transient response load matrix in the s-set for output time steps. Output by TRLG.

PTELEM Table of thermal loads in the elemental coordinate system. Output by SSG1.

Table of thermal loads in the elemental coordinate system from prior subcase. Output
PTELEM0
by SSG1.

Table of thermal loads in the elemental coordinate system which incorporates combined
PTELMDCN
constraints and design variables. Output by DSAF.

Table of thermal loads in the elemental coordinate system for the central, forward, or
PTELMDSX
backward perturbed configuration. Output by SSG1.

PUG Matrix of translational displacements. Output by SDR2.

PUG* Family of matrices of translational displacements for all superelements.

PUGD Matrix of translational displacements in dynamic analysis. Output by SDR2.

PUGS Matrix of translational displacements in static analysis. Output by SDR2.

PUG assembled for superelements defined on the SEPLOT or SEUPPLOT command.


PUGX
Output by SEPLOT.

P-value table generated by the ADAPT module in previous superelement, adaptivity


PVAL0
cycle, or run.

PVAL1 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


PVEC
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,
PVGRID
VELOCITY, ACCELERATION, FORCE, STRESS, STRAIN, SPCFORCE, MPCFORCE,
MPRES, GPFORCE, ESE, EKE, EDE, GPKE, MODCON, PANCON. Output by OUTPRT.

Partitioning vector with ones at rows corresponding to degrees-of-freedom at which static


PVLOAD
and dynamic loads are applied. Output by OUTPRT.

Partitioning vector with ones at rows corresponding to degrees-of-freedom connected


PVMPC to elements or grids specified on the MPCFORCE Case Control command. Output by
OUTPRT.

6-40 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Partitioning vector with ones at rows corresponding to degrees-of-freedom connected


PVSPC to elements or grids specified on the SPCFORCE Case Control command. Output by
OUTPRT.

PVT Table containing parameter values from PARAM Bulk Data entry images. Output by IFP.

Table containing parameter values which are resolved from values in PVT, CASECC,
PVTS
and, optionally, the NDDL. Output by PVT.

PX Inertial or pseudo-load matrix. Output by DSAP.

PXF Frequency response load matrix in h-set (modal) or d-set.

PXT Transient response load matrix in the h-set (modal) or d-set. Output by TRLG.

PXT1 Reduced transient response load matrix analysis. Output by DSAR.

PZ Reduced aerostatic loads matrix.

Parent Data
Data Block Name Description
Block Format

Single-point constraint forces of constraint matrix in the g-set. Output by LANCZOS,


QG
STATICS, and SDR1.

QHH Aerodynamic matrix of size h- by h-set. Output by AMP.

QHHL Aerodynamic matrix list

QHJ Aerodynamic matrix of size h- by j-set. Output by AMP.

QHJK Aero transformation matrix between h and j sets. Output by GUST.

QHJL Aero transformation matrix between h and j sets.

QKH Aerodynamic matrix of size k- by h-set. Output by AMP.

QKHL Aero transformation matrix between h and k sets.

QLL Aerodynamic matrix for divergence analysis.

Multipoint constraint forces of constraint matrix in the g-set. Output by LANCZOS and
QMG
STATICS.

QNV Quasi-Newton sweeping vectors. Output by NLITER.

QR Matrix of determinate support forces. Output by SSG2.

QXX Aerodynamic matrix in any set.

Parent Data Block


Data Block Name Description
Format

R Residual matrix. Output by SOLVIT.

R1MAPR R1MAP Table of mapping from original first level (direct) retained responses. Output by DSAD.

R1TAB Table of first level (direct) (DRESP1 Bulk Data entry) attributes. Output by DOPR3.

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes. Output by DSAD.

R1TABRG Table of attributes of the retained first level (direct) responses.

R1VAL Matrix of initial values of the retained first level (direct) responses. Output by DSAD.

DMAP Programmer's Guide 6-41


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data Block


Data Block Name Description
Format

Matrix of final (optimized) values of the retained first level (direct) responses. Output
R1VALO
by DOM9.

R1VALR Matrix of retained type one responses. Output by DSAD.

R1VALRG Matrix of initial values of the retained first level (direct) responses.

Table of mapping from original second level (synthetic) retained responses. Output by
R2MAPR
DSAD.

R2VAL 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
R2VALO
DOM9.

R2VALR Matrix of retained second level (synthetic) responses.

R2VALRG Matrix of initial values of the retained second level (synthetic) responses.

R3VAL Matrix of initial values of the retained third level responses. Output by DSAD.

R3VALO Matrix of final values of the third level responses. Output by DOM9.

R3VALR Matrix of initial values of the retained third level responses. Output by DSAD.

R3VALRG Matrix of initial values of the retained third level responses.

RADAMPG Structural damping ratio matrix

RADAMPZ Viscous damping ratio matrix

RADCONS OUG Displacement Constraint Mode

RADDATC OUG Displacement Distributed Attachment Mode

RADEATC OUG Displacement Equivalent Inertia Attachment mode

RADEFFM OUG Displacement Effective Inertia Mode

RADEFMP OUG Displacement PHA^T

RADNATC OUG Displacement Nodal Attachment Mode

RAECONS OES Strain Constraint Mode

RAEDATC OES Strain Distributed Attachment Mode

RAEEATC OES Strain Equivalent Inertia Attachment mode

RAENATC OES Strain Nodal Attachment Mode

RAFCONS OEF Element Force Constraint Mode

RAFDATC OEF Element Force Distributed Attachment Mode

RAFEATC OEF Element Force Equivalent Inertia Attachment mode

RAFNATC OEF Element Force Nodal Attachment Mode

RAGCONS OEF Grid Point Forces Constraint Mode

RAGDATC OEF Grid Point Forces Distributed Attachment Mode

RAGEATC OEF Grid Point Forces Equivalent Inertia Attachment mode

RAGNATC OEF Grid Point Forces Nodal Attachment Mode

6-42 DMAP Programmer's Guide


Data Block Glossary

Parent Data Block


Data Block Name Description
Format

RALDATC OUG Load vector used to compute the Distributed Attachment modes

RANCONS OEE Strain Energy Constraint Mode

RANDATC OEE Strain Energy Distributed Attachment Mode

RANEATC OEE Strain Energy Equivalent Inertia Attachment mode

RANNATC OEE Strain Energy Nodal Attachment Mode

RARCONS OQG Reaction Force Constraint Mode

RARDATC OQG Reaction Force Distributed Attachment Mode

RAREATC OQG Reaction Force Equivalent Inertia Attachment mode

RARNATC OQG Reaction Force Nodal Attachment Mode

RASCONS OES Stress Constraint Mode

RASDATC OES Stress Distributed Attachment Mode

RASEATC OES Stress Equivalent Inertia Attachment mode

RASNATC OES Stress Nodal Attachment Mode

RBF Rigid body force matrix.

RCROSSL Table of RCROSS Bulk Data entry images. Output by DPD.

RDEST Radiation element summary table. Output by RMG2.

RECM Radiation exchange coefficient matrix. Output by RMG2.

RESMAX Resultant or maxima matrix. Output by VECPLOT.

RESMAX0 Resultant or maxima matrix for residual structure. Output by VECPLOT.

RESP3 Table of third level responses. Output by DOPR3.

RESP3R Table of retained third level responses in RESP3. Output by DSAD.

RESP12 RESP12 Table of second level (synthetic) responses. Output by DOPR3.

RGG Radiation transfer matrix in the g-set. Output by RMG2.

RHMCF Matrix of dimensional rigid unsplined hinge moment data

RMAT 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
RMATG
of columns but g-set rows, similar to P2G. Output by MTRXIN.

RMG Multipoint constraint equation matrix. Output by GP4.

RMSTAB Table of RMS responses. Output by DOPRAN.

RMSTABR Table of retained RMS responses in RMSTAB. Output by DSAD.

RMSTBR Table of retained RMS responses.

RMSVAL Matrix of initial RMS values. Output by DSARME.

DMAP Programmer's Guide 6-43


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data Block


Data Block Name Description
Format

RMSVALR Matrix of initial values of the retained RMS responses in RMSVAL. Output by DSAD.

RMSVLR Matrix of retained RMS values.

ROUGV1 OUG Table of relative displacement, velocity and acceleration in SORT1 format.

ROUGV2 OUG Table of relative displacement, velocity and acceleration in SORT2 format.

RP Row partitioning vector.

RPX Reduction matrix from p-set to h-set (modal) or d-set.

RR2IDR Table of retained referenced type two response identification list. Output by DSAD.

RSLTDATA Table of actual results data when system cell 297=3. Output by SDRP.

RSLTSTAT Table of result-state information when system cell 297=2. Output by SDRP.

RSP12R RESP12 Table of retained second level (synthetic) responses in RESP12. Output by DSAD.

Table of the count of type 1 responses per response type per subcase in R1TAB. Output by
RSP1CT
DOPR3.

RSP2RG RESP12 Table of attributes of the retained second level (synthetic) responses.

RSP3RG Table of attributes of the retained third level responses.

RSQUERY Table of results state query.

Matrix of dimensional rigid stability derivatives generated directly from the aerodynamic
RSTAB
model.

RUG Residual matrix for the g-set. Output by STATICS.

RUL Residual matrix for the l-set. Output by SSG3.

RUO Residual matrix for the o-set. Output by SSG3.

Parent Data
Data Block Name Description
Block Format

Table of SOL 200 related information regarding the RANDPS data, frequency responses,
SABFIL
and load PSD values associated with constrained PSD responses.

SCSTM Table of global transformation matrices for partitioned superelements. Output by SEP1X.

Table containing the list of partitioned superelements defined in separate Bulk Data
SELIST
sections. Output by SEPR1.

SELOAD DTI table for SELOAD bulk entry images.

SEMAP SEMAP Superelement map table. Output by SEP1 or SEP1X.

SEQMAP Mapping matrix for resequencing. Output by SEQP.

SET SET Table of combined sets. Output by NASSETS.

SETMC Table of SETMC Case Control definitions.

SETREE Superelement tree table usually input via the DTI,SETREE Bulk Data entry.

SGPDT Superelement basic grid point definition table. Output by SEP1X.

Superelement basic grid point definition table for the current superelement. Output by
SGPDTS
SEP2X.

6-44 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

SGPDTS* Family of SGPDTS tables created in previous runs.

Matrix of basis vectors - coefficients relating designed grid coordinates and design
SHPVEC
variables. Output by DOPR2.

SIL Scalar index list. Output by GP1.

SIL0 SIL table from a previous adaptivity index in p-version analysis.

SILD Scalar index list for the p-set. Output by DPD.

SKJ Integration matrix. Output by AMG.

SLGRIDS List of selected grids (for DATTYP=2).

Superelement processing list to matrix generation, assembly, and reduction. Output


SLIST
by SEP3.

SLT Table of static loads. Output by GP3.

SLT1 Table of static loads updated for nonlinear analysis. Output by NLCOMB.

SLTH Table of static loads updated for heat transfer analysis. Output by SSG1.

SMPF Matrix of contribution of structure to fluid mode participation factors. Output by MODEPF.

SNORM* Family of shell normal vectors at superelement boundaries.

SNORMS 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
SORTBOOL
row terms. Output by MATMOD option 35.

Vector consisting of the row numbers of the original positions of the sorted terms. Output
SORTLIST
by MATMOD option 35.

SPAN1RG Global table of DRSPAN related DRESP1 information.

SPAN23 Table for DRSPAN related DRESP2 and DRESP3, and referenced DRESP1.

SPANSV Relevant DRSPAN related internal DRESP1 IDs and their values for the current DSAD call.

Global form of SPANSV, containing information from all DSAD calls in the analysis types
SPANSVG
loop.

Local f-size partitioning vector with 1.0 for the local boundary's s-set degrees-of-freedom.
SPCCOL
Required only for geometric domain decomp.

SPCPART Partitioning vector for domain decomposition. Output by SEQP.

SPECSEL Response spectra input correlation table.

Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external grid
SPLINE
identification numbers. Output by MKSPLINE.

SPSEL Table of response spectra generation correlation selections.

SRKS 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
SRKT
reference point. Output by ADG.

STATDATA Table of state information when system cell 297=1. Output by SDRP.

STBDER Table of aerostatic stability derivatives for a single subcase. Output by SDP.

STBTAB Table of aerostatic stability derivatives for all subcases.

DMAP Programmer's Guide 6-45


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

STRUCOMP Table of structural components when MESH='STRU'. Output by MAKCOMP.

SVEC Starting "random" eigenvector matrix.

SZR Merged monitor matrices. Output by MRGMON.

SZRi Associated monitor matrices

Parent Data
Data Block Name Description
Block Format

Table information to support MATGEN module options. Diagonal from symmetric


T
decomposition. Output by MATMOD option 21.

TA Secondary table to be merged into TOLD to form TNEW.

TAB Table.

TABi Tables.

TABDEQ Table of unique design variable identification numbers. Output by DOPR4.

Table of relationship between internal identification numbers of constraints in ESTDCN


TABECN
and elements and responses in R1TABR. Output by DSAF.

Cross-reference table between ESTDVP records and element and design variable
TABEVP
identification numbers. Output by DSABO.

Cross reference table between ESTDVS records and element and design variable
TABEVS
identification numbers. Output by DOPR6.

TABEV2 Merged cross reference table of TABEVP and TABEVS. Output by DSAE.

TB Secondary table to be merged into TOLD to form TNEW.

TC Secondary table to be merged into TOLD to form TNEW.

TEF Directory table for MEF. Output by DRMH1 and DRMS1.

Transient response time output list appended from each subcase. Output by NLTRD
TEL
and NLTRD2.

TEMF Total effective mass fraction table. Output by EFFMAS.

TES Directory table for MES. Output by DRMH1 and DRMS1.

TFPOOL Table of TF Bulk Data entry images. Output by DPD.

TIMSIZ Table of CPU and disk space estimation parameters. Output by SEQP.

TNEW Table data block to be edited by TABEDIT.

DOPR3 module updated temporary copy of SPAN23, the table for DRSPAN related
TNSPAN23
DRESP2 and DRESP3, and referenced DRESP1.

TOFPi 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
TOL1 TOL
the current nonlinear transient subcase. Output by MODACC and TOLAPP.

TOLD Table data block to be edited by TABEDIT.

TOUT DRMH1 directory table in table data block or DTI format.

6-46 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

TQG Directory table for MQG. Output by DRMH1 and DRMS1.

Matrix to transform forces from the support point to the aerodynamic reference point.
TR
Output by MAKETR.

Transpose of TR where the number of columns of TR matches the URDDUXV states of


TRANTR TRX. Both are reduced to just the active origin rigid body degrees-of-freedom. Output
by MAKETR.

TRL Transient response list. Output by DPD.

Boolean matrix to select accelerations from the list of aerodynamic extra points. Output
TRX
by ADG.

Temporary copy of SPAN23, the table for DRSPAN related DRESP2 and DRESP3, and
TSPAN23
referenced DRESP1.

TUG Directory table for MUG. Output by DRMH1 and DRMS1.

TXY DRMH1 directory table in DTI or table data block format. Output by DRMH1.

Parent Data
Data Block Name Description
Block Format

U Upper triangular factor. Output by DECOMP and DCMP.

U1 U truncated by the OFREQ or OTIME or OMODES command.

U7DOF U7-set DOF vector (input DOF) for superelement.

U8DOF U8-set DOF vector (output DOF) for superelement.

Displacement or eigenvector matrix in the a-set or solution matrix on the boundary (a-set)
UA
of the superelement (identification number equal to output value of SEID).

UACCE Reduced acceleration solution matrix from transient response analysis. Output by DSAR.

UAJJT Upper triangular decomposition factor matrix of AJJT.

UAM1DD Upper triangular factor of the dynamic tangential matrix in the d-set.

Solution matrix for the d-set. Displacements only in frequency response. Displacements,
UD
velocities, and accelerations in transient response.

UD1 Improved solution matrix for the d-set. Output by DDR2.

UDISP Reduced displacement solution matrix from transient response analysis. Output by DSAR.

UE Improved solution matrix for the e-set (extra points). Output by DDR2.

Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG can also
UG
represent velocity or acceleration. Output by SDR1 and STATICS.

UGD Displacement matrix in g-set for the downstream superelement.

UGDS Displacement matrix in g-set due to pseudo-loads.

UGDS1 Displacement matrix in g-set for the total variation. Output by DSVG3.

UGG Displacement matrix in g-set for all processors (global). Output by DISUTIL.

UGLCURB Global displacements in basic coordinate system.

UGNI Displacement matrix at converged step in the g-set. Output by NLITER.

DMAP Programmer's Guide 6-47


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

UGNT Total displacement matrix in the g-set. Output by UGVADD.

UGT Updated temperature matrix in g-set. Output by MATMOD option 19.

UGX Matrix of analysis model displacements in g-set or p-set.

UGX1 Copy of UGX matrix with null columns in place of the deleted responses. Output by DSAD.

Solution matrix for the h-set (modal degrees-of-freedom). Modal displacements only in
UH frequency response. Modal displacements, velocities, and accelerations in transient
response.

Modal velocities solution matrix for the h-set (modal degrees-of-freedom). Required only
UHD
for frequency response.

Fluid partition (row-wise) of solution matrix UHF. Also partitioned column-wise according
UHFF
to parameter FLUIDMP.

Structural partition (row-wise) of solution matrix UHF. Also partitioned column-wise


UHFS
according to parameter STRUCTMP.

UHR Modal displacement vector for spectral analysis. Output by INTERR.

UL Displacement matrix in l-set. Output by SSG3.

ULAMA Unsymmetric eigenvalue summary table. Output by UEIGL.

ULL Upper triangular factor for the l-set from KLL.

Upper triangular factor for nonlinear elements including material, slideline, and differential
ULLT
stiffness effects.

Solution matrix from nonlinear transient response analysis in the d-set. Output by NLTRD
ULNT
and NLTRD2.

UNITS UNITS data block from the DTI,UNITS bulk data entry.

UO 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
UOO
to zero).

UPSDT Table of transfer function data needed for RMS calculations.

URDDIDX 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
URDDUXV
associated URDDi is invalid for this symmetry condition (e.g., URDD1,3,5 are invalid for
antisymmetric analysis). Output by MAKETR.

USET USET Degree-of-freedom set membership table for g-set. Output by GPSP.

Degree-of-freedom set membership table for g-set usually prior to Auto-SPC update in
USET0 USET
GPSP. Output by GP4. USET table from a previous adaptivity index in p-version analysis.

USET1 USET USET updated with constraints from upstream superelements. Output by BNDSPC.

USETD USET Degree-of-freedom set membership table for p-set. Output by DPD.

USETM USET Modified degree-of-freedom set membership table for g-set. Output by MODUSET.

UVELO Reduced velocity solution matrix from transient response analysis. Output by DSAR.

UX Matrix of aerodynamic extra point displacements. Output by ASG.

6-48 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of aerodynamic extra point identification numbers, displacements, labels, type,


UXDAT
status, position and hinge moments. Output by ASG.

UXDIFV 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


UXF
FRRD2.

Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of restrained
UXR
stability derivatives. Output by DSARLP.

Solution matrix from transient response analysis in d- or h-set. Output by TRD1, TRD2,
UXT
and IFT.

UXT1 Reduced solution matrix from transient response analysis. Output by DSAR.

UXTRIM UX vector at trim.

Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of
UXU
unrestrained stability derivatives. Output by DSARLP.

UXV Control state matrix for ADB or AEDB

Controller state matrix for WJVBRL downwash vectors. UXVBRL has NX rows and NV
UXVBRL
columns. Output by ADG.

Matrix of UXVEC vectors defined by the AEFORCE Bulk Data entries. Ouptut by
UXVF
MAKAEFA.

Matrix of UXVEC vectors defined by the AEPRESS Bulk Data entries. Ouptut by
UXVP
MAKAEFA.

UXVST Aerodynamic extra point displacement matrix. Output by MAKAEFS.

UXVW Matrix of UXVEC vectors defined by the AEDW Bulk Data entries. Ouptut by MAKAEFA.

Parent Data
Data Block Name Description
Block Format

V01P Partitioning vector for sparse load reduction.

VAXWN Modified VAXW corresponding to USETN.

VDXC Partitioning vector with 1.0 at rows corresponding to null columns in KDD, BDD, and MDD.

VDXR Partitioning vector with 1.0 at rows corresponding to null rows in KDD, BDD, and MDD.

VELEM Table of element lengths, areas, and volumes. Output by ELTPRT.

Table of element lengths, areas, and volumes which incorporates combined constraints
VELEMDCN
and design variables. Output by DSAF.

Table of element lengths, areas, and volumes for the perturbed configuration. Output by
VELEMN
ELTPRT.

VFO zero-partition by SPCCOL. VFO is the local f-size partitioning vector with 6 values of
VFO1
1.0 for every grid in the local residual. Required only for geometric domain decomp.

VG Left-handed displacement matrix in g-set. Divergence and flutter analysis only.

VGA 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


VGF
degrees-of-freedom. Output by GP1.

DMAP Programmer's Guide 6-49


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

Partitioning vector with ones at rows corresponding to degrees-of-freedom connected to


VGFD
frequency-dependent elements. Output by TA1.

VGA G-set size partitioning vector with values of 1.0 at the rows corresponding to the a-set.

Partitioning vector with values of 1.0 at rows corresponding to degrees-of-freedom in


VGQ
the q-set.

View information table, contains the relationship between each p-element and its
VIEWTB VIEWTB
view-elements and view-grids. Output by VIEWP.

View information table, contains the relationship between each p-element and its
VIEWTBDS VIEWTB
view-elements and view-grids for the perturbed model. Output by DVIEWP.

VTQU Table of flutter sensitivity data. Output by DSFLTE.

Parent Data
Data Block Name Description
Block Format

WGTM Table of 6x6 rigid body mass matrix. Output by WEIGHT.

WJ Gust matrix. Output by GUST.

WMID Table of weight as a function of material identification number. Output by WEIGHT.

Downwash matrix (NJ rows by NV columns). Downwash at the j-points due to the linear,
WRJVBRL angle/rate rigid body aerodynamic extra-points and linear control surfaces. Output by
ADG.

WSKJF Weighted integration matrix.

Table of retained weight responses with column and row numbers in rigid mass matrix.
WTCRID
Output by DSAW.

WTDSCP Partitioning vector for weight. Output by DSAW.

Parent Data
Data Block Name Description
Block Format

Solution of the equation [A][X]=[B]. Output by FBS, SOLVE, and SOLVIT. Matrix product.
X
Output by MPYAD and SMPYAD. Matrix transpose. Output by TRNSP.

X66 Triple-product of XG with rigid body modes for IOPT=9 or 10. Output by VECPLOT.

Previous output of X66, usually at g-set. Used by IOPT=9, when setnam<>'g', as a


X66P
baseline to compare against the non-g-set results in X66.

XAA Reduced square matrix in a-set. Output by MATREDU.

XAA* Family of reduced square matrices in a-set pertaining to the upstream superelements.

XD Rectangular matrix of displacements or loads in the p-set. Output by UREDUC.

XDD Reduced square matrix in d-set. Output by MATREDU.

XDICT KDICT Baseline element matrix dictionary table.

Perturbed element matrix dictionary table. If CDIF='YES' then this is the forward or
XDICTDS KDICT
backward perturbed element matrix dictionary.

Baseline element matrix dictionary table or backward perturbed element matrix dictionary
XDICTX KDICT
if CDIF='YES'.

XELM KELM Baseline element matrices. Output by EMG.

6-50 DMAP Programmer's Guide


Data Block Glossary

Parent Data
Data Block Name Description
Block Format

Table of perturbed element matrices. If CDIF='YES' then this is the forward or backward
XELMDS KELM
perturbed element matrix dictionary.

XELMX KELM Baseline element matrices or backward perturbed element matrices if CDIF='YES'.

XG Rectangular matrix of displacements or loads in the g-set.

Square matrix in g-set. In superelement analysis, XGG includes contributions from


XGG
upstream superelements. Output by EMA and SEMA.

XGGi Square matrices in g-set. Output by EMA and SEMA.

XH Rectangular matrix of displacements or loads in the h-set (modal). Output by UREDUC.

XINIT Matrix of initial values of the design variables. Output by DOPR1.

Square matrix for the g-set of the current superelement and applied to its interior points
XJJ
only.

XNNi Square matrices in n-set. Output by MCE2.

XO Matrix of final (optimized) values of the design variables.

XORTH Cross-orthogonality matrix. Output by CEAD and UEIGL.

XOUT Resultant to table output. Output by VECPLOT.

XP Rectangular matrix of displacements or loads in the p-set

XPP Square matrix in p-set.

Optional starting vector, same type as B and PG in SOLVIT and STATICS, respectively.
XS
Rectangular matrix of displacements or loads in the s-set. Output by UREDUC.

Table of DTI,SELOAD definitions of the external superelement consistent with the applied
XSELOAD
loads.

S-set by f-set matrix partition of XGG or XPP after multipoint constraint elimination and
XSF
reduction. Output by MATREDU.

S-set by s-set matrix partition of XGG or XPP after multipoint constraint elimination and
XSS
reduction. Output by MATREDU.

XYCDB Table of x-y plotting commands. Output by IFP1.

Table of x-y plotting commands for a superelement (identification number equal to output
XYCDBDR
value of SEID). Output by SEDR.

Table of x-y plotting commands for the current superelement (identification number equal
XYCDBS
to output value of SEID). Output by SEP2CT.

XYPLOT Table of x-y plot control values. Output by XYTRAN.

Matrix containing the constant portion of the dependent to independent design variable
XZ
linking relationship. Output y DOPR1.

Parent Data
Data Block Name Description
Block Format

YGBNDR Boundary shape matrices appended for all auxiliary or geometric models.

YPF 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.
YPO
Output by TRLG.

DMAP Programmer's Guide 6-51


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

Parent Data
Data Block Name Description
Block Format

YPT Transient response enforced motion matrix in the p-set. Output by TRLG.

YS Matrix of enforced displacements or temperatures. Output by GPSP.

Matrix of enforced displacements temperatures usually prior to Auto-SPC update in


YS0
GPSP. Output by GP4.

YS updated with enforced displacements from upstream superelements. Output by


YS1
BNDSPC.

YSD Accumulated matrix of enforced displacements from upstream superelements.

YSD updated with enforced displacements from upstream and current superelements to
YSD1
be passed to downstream superelements. Output by BNDSPC.

YSMAT Initial and final enforced displacement matrices.

Parent Data
Data Block Name Description
Block Format

ZETA Diagonal matrix of modal damping coefficients as produced by the GKAM module.

ZETAH Mass-normalized damping.

Z1ZX Matrix of unrestrained dimensional elastic derivatives

ZZX Reduced aerostatic solution matrix.

6.1 Data Block Naming Conventions

Stiffness, Damping, and Mass


K_____ Stiffness

KD____ Differential stiffness

B_____ Viscous damping

K4____ Structural damping (See GE field on MATi entries)

__2DD Stiffness in dynamic formulation

M____ Mass

Stiffness, damping, and mass matrices without upstream superelement contributions. Exception: __AJJ_ is the
___JJ
aerodynamic influence matrix.

L__, U__ Lower and upper triangular decomposition factors

Note

Some of the above names may be prefixed with a "C" to indicate a complex matrix.

Superelements
CM____ Superelement (component) modes

6-52 DMAP Programmer's Guide


Data Block Glossary

_____S Assigned only to SEP2 and GP1 module outputs

__LIST Superelement processing list; for example, SLIST, DRLIST, and DSLIST

MAPS Superelement boundary grid map

SEMAP Superelement map

Loads and Solutions


A_____ Aeroelastic or aerostatic

B_____ Buckling

C_____ Complex modes

CY____ Cyclic symmetry

F_____ Flutter

_____F Frequency response

_____T Transient response

___NL_ Nonlinear static or transient response; for example, USETNL, ESTNL and OESNLX

_____NI Nonlinear static or transient response generated in a nonlinear loop.

___PH__ Eigensolution

PH____ Normal modes eigenvector matrix; for example, PHG (g-set) and PHA(a-set)

CPH___ Complex modes eigenvector matrix; for example, CPHD (d-set) and CPHL (l-set).

BPH___ Buckling eigenvector matrix; for example, BPHA (a-set)

Solutions
___U___ 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
___Q___
aerodynamic matrices; for example, QHH, QKHL, and QLL

___QM__ Multipoint forces of constraint in statics and dynamics solution; for example, QMG, QMPT, and CYQMG

CMPH___ Component modes eigenvector matrices.

Eigenvalue summary table; for example, LAMA, BLAMA (buckling), CLAMA (complex), and CMLAMA
__LAMA
(component modes)

__UH__ Dynamic solution at modal degrees-of-freedom; for example, AUHF is the Aeroelastic solution h-set

__OL__ Dynamic output list; for example, FOL (frequency) and TOL (transient).

___NT__ Nonlinear transient response; for example, UPNT and ULNTH

_____N Nonlinear static solution appended for all loops; for example, UGN and QGN

Loads
P_____ Dynamic and static loads

Y___ Enforced displacement

DMAP Programmer's Guide 6-53


Chapter
Chapter 6: 6: Data Data
BlockBlock Glossary
Glossary

PA Static loads a-set

PJ Static loads g-set (no upstream loads)

PG Static loads g-set

PP____ Dynamic loads p-set

PH____ Dynamic loads h-set

__PPF_ Dynamic loads p-set, frequency response

__PPT_ Dynamic loads p-set, transient response

__UH__ Dynamic solution at modal degrees-of-freedom

__UG__ Static solution g-set; for example, UGN is the nonlinear solution at the g-set.

__UL__ Static or dynamic solution l-set; for example, ULN is the nonlinear solution at the g-set.

__UP__ Dynamic solution p-set; for example, UPN is the nonlinear transient solution at the p-set.

Solution Output Tables


O__ES__ Element stresses (STRESS=n)

O__GPS__ Grid point stresses (GPSTRESS=n)

O__GPF__ Grid point forces (GPFORCE=n)

O__NRG__ Element strain energy (ESE=n)

O__EF__ Element forces (FORCE=n)

O__EE__ Element strains (STRAIN=n)

O__STR__ Element strains (STRAIN=n)

O__UG__ Static solution (DISP=n)

O__UP__ Dynamic solution (DISP=n)

O__QG__ Static spcforces (SPCF=n)

O__QMG_ Static mpcforces (MPCF=n)

O__QP__ Dynamic spcforces (SPCF=n)

O_____1 SORT1 format

O_____2 SORT2 format

Miscellaneous
Case Control section tables; for example, Outputs from IFP1, SEP2 and SEDRDR are CASECC, CASES,
__CASE__
and CASEDR.

Control data blocks from the OUTPUT(XY_____), OUTPUT(PLOT), and OUTPUT(POST) sections; for
___CDB_
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
GEOM__
set membership.

USET__ Degree-of-freedom set; for example, USET0 (from GP4), USET (from GPSP), and USETD (from DPD).

_GPDT_ Grid point definition tables; for example, BGPDT and GPDT.

6-54 DMAP Programmer's Guide


Data Block Glossary

CSTM_ 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
O_____
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
_EST__
and NLTRD is named ESTNL.

Dictionary table for element stiffness, mass, etc.; for example, KDICT (linear), KDDICT (differential), KDICTNL
_DICT_
(material nonlinear), MDICT (mass)

_ELM_ Element stiffness, mass, etc.; for example, KELM (linear), KDELM (differential), MELM (mass)

_____1 MODACC module outputs. (OTIME and OFREQ); for example, ULF1, FOL1

_____1X SDRX and SDRXD module outputs; for example, OES1X, OEF1X

Inconsistent Names
BUG Buckling eigenvector matrix; should be renamed to BPHG.

GM Transformation between m-set and n-set; should be renamed to GMN.

POS Static loads on the o-set; should be renamed to PO.

PSS Static loads on the s-set; should be renamed to PS.

DM Transformation between l-set and r-set; should be renamed to DLR.

MR Rigid body mass matrix (r-set by r-set); should be renamed to MRR.

MRR Stiffness matrix partition (r-set by r-set) from MTT; should be renamed to MRR1.

__V__ Obsolete designation indicating "vector"; for example, OUGV1, UGVS, UHVF.

__PHI__ Obsolete designation indicating eigensolution; for example, PHIDH (should be PHDH)

PHDH Transformation from d-set to h-set; should be renamed to PHD.

DMAP Programmer's Guide 6-55


Chapter 7: NASTRAN Data Definition Language (NDDL)

• NDDL Summary

• Detailed Description of NDDL Statements

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 Define a data block’s name, path, and location and describe its contents

DEPEN Define a data block, parameter, or virtual parameter to be dependent upon other
data block(s), parameter(s) or virtual parameter(s)

PARAM Define a parameter’s name, type, path, location, and default value

PATH List the QUALifiers to be used in accessing the data block or parameter via the
NDDL

QUAL Define a qualifier’s name, type and default value

Detailed Description of NDDL Statements

Syntactical Descriptions
In the descriptions of the NDDL statements, the following notation is used:

DMAP Programmer's Guide 7-1


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

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.

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 = The db_description has special rules. Only TABLE(OFP) and


TABLE(CASE) are allowed.

SAMEAS = The db_description on another DATABLK, sname statement.

db_description = One or more record descriptions providing a word-by-word description of


each record in which each word (or item) is assigned a name and type.

7-2 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

where:

RECORD(*) = rec_description defines all records. It can be specified only once following
RECORD=HEADER.

RECORD = 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.

• 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 = The number of times the item is repeated. The default is zero.

C = item_name is referenced by BACK in an either_component or COUNT in an


entry_component.

• item_type is:

Item type Description

I Integer

RS Real — single precision

RD Real — double precision

CS Complex — single precision

DMAP Programmer's Guide 7-3


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

Item type Description

CD Complex — double precision

CHARi Character (i = length)

LOGICAL Logical

• UNDEF indicates a dummy item that is one machine-word in length.

entry_component has the following form:


ENTRY[ = entry-name],
rec_component

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.

SAMEAS = An entry description specified on another ENTRY=sentry_name

end_valuei = A numeric value(s) that identifies the end of repeating ENTRY...


ENDENTRY grouping.

If EOR = If this is specified, no more rec_components follow in the record and


RECORD or EOF must follow.

ENDENTRY = This is required; it terminates the entry_components.

either_component has the following form:

7-4 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

where:

AHEAD or = An item defined elsewhere in the record.


BACK

OR = The beginning of an optional description of the item=item_valn.

ENDEITH = This is required and terminates the either_component.

Keywords:

TYPE Defines the class or characteristics of information it contains.

TABLE A collection of records.

TABLE (CASE) Special style of table for Case Control tables.

TABLE (OFP) Special style of table that are suitable for input to the OFP module.

MATRIX A M by N dimensional array of related items obeying the rules of


matrix algebra.

UNSTRUCTURED The data block has no description. db_description, and SAMEAS


are ignored.

EOR End of record description.

EOF End of the data block description.

DMAP Programmer's Guide 7-5


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

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 data
block-names: A through Z and 0 through 9.

pathname Name of the path, which is also referenced on a PATH statement.

loc_param Variable character parameter name with a value that is the DBset name.
See the PARAM NDDL statement and the INlT FMS statement.

rec_name Record name (optional).

entry_name Entry name (optional).

item_name Item name. Item_name can have an integer argument and would then
take the form: item_name(i) where i is an explicit integer value.

item_vali Item value.

func_code 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.

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

7-6 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

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 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 ...

DMAP Programmer's Guide 7-7


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

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:
,...,
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.

7-8 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

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.

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_* Dependent data block, parameter, or virtual parameter as indicated by DB,


P, or VP, respectively.

indep_* Independent data block, parameter, or virtual parameter as indicated by DB,


P, or VP, respectively.

desc_loc Description locator of the independent record, entry, or item. The format is
[record_name][:[entry_name]][:[item_name]].

DMAP Programmer's Guide 7-9


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

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,
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

7-10 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

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.

default-value The explicit default value of the parameter. If no default value is given,
CHARi defaults to a “blank” and all others default to zero.

data-type The data type. Possible data types are as follows:

Data type Description

I Integer

RS Real — single precision

RD Real — double precision

CS Complex — single precision

CD Complex — double precision

CHARi, where i = 1 through 80 Character

LOGICAL Logical

path-name 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 DBset name. Its default value must be defined on another PARAM NDDL
statement and cannot be blank.

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.

DMAP Programmer's Guide 7-11


Chapter
Chapter 7: 7: NASTRAN
NASTRAN
Data Data Definition
Definition Language
Language (NDDL)
(NDDL)

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, ...

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.

qual-namei A list of qualifiers that are defined on QUAL NDDL statements.

Example:
The path DMSL specifies qualifiers MODEL, SEID, and LID.
PATH DMSL MODEL,SEID,LID $

QUAL
Defines qualifiers referenced on PATH NDDL statement

Format:

QUAL(qtype) qual-name1=default-value1 qual-name2=default-value2,...

Variables:

qtype Type of qualifier.

qtype Description

I Integer

RS Real — single precision

RD Real — double precision

7-12 DMAP Programmer's Guide


NASTRAN Data Definition Language (NDDL)

qtype Description

CS Complex — single precision

CD Complex — double precision

CHARi, where i = 1,80 Character

LOGICAL Logical

qual-namei Name of the qualifier referenced on a PATH NDDL statement.

default-valuei 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.

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

DMAP Programmer's Guide 7-13


Chapter 8: Overview of DMAP Modules and Statements

• DMAP Module and Statement List

• DMAP Module and Statement Description Summary

8.1 DMAP Module and Statement List


Descriptions of the most common and easy-to-use DMAP modules and statements are contained
in “DMAP Module and Statement Descriptions A-D”, “DMAP Module and Statement Descriptions
E-M”, and “DMAP Module and Statement Descriptions N-X”. 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 MERGE SOLVIT
ADD5 MPYAD TRNSP
CEAD NORM UMERGE
DCMP PARTN UMERGE1
DECOMP READ UPARTN
DIAGONAL SMPYAD
FBS SOLVE

Utility Modules
APPEND MATGEN PRTPARM
COPY MATGPR PVT
DBC MATMOD RESTART
DBDICT MATPCH SCALAR
DMIIN MATPRN SEQP
DRMS1 MATPRT TABEDIT
DTIIN MODTRL TABPRT
ELTPRT MTRXIN TABPT

DMAP Programmer's Guide 8-1


Chapter
Chapter 8: 8: Overview
Overview of DMAP
of DMAP Modules
Modules and Statements
and Statements

IFP NXNADAMS VEC


IFP1, . . . IFP9 OFP VECPLOT
INPUTT2 OUTPUT2 XSORT
INPUTT4 OUTPUT4
LAMX PARAML

Executive Modules and Statements


DBVIEW
DELETE
EQUIVX
FILE
MESSAGE
PURGEX

Miscellaneous Modules and Statements

ACMG AEMODEL ASG BCDR


ADAPT AMG AXMDRV BGCASO
ADG AMP AXMPR1 BGICA
ADR APD AXMPR2 BGP
AELOOP ASDR BDRYINFO BMG
BNDSPC

CASE CYCLIC4 DISOFPM DOM6


CHKPNL DBDELETE DISOFPS DOM9
CMPZPR DBEQUIV DISOPT DOPFS
CURV DBSTATUS DISUTIL DOPR1
CURVPLOT DDR2 DIVERG DOPR2
CYCLIC1 DDRMM DOM10 DOPR3
CYCLIC2 DISDCMP DOM11 DOPR4
CYCLIC3 DISFBS DOM12 DOPR5

8-2 DMAP Programmer's Guide


Overview of DMAP Modules and Statements

DOPR6 DSADJ DSAP DSDVRG


DOPRAN DSAE DSAPRT DSFLTE
DPD DSAF DSAR DSFLTF
DRMH1 DSAH DSARLP DSMA
DRMH3 DSAJ DSARME DSPRM
DRMT1 DSAL DSARMG DSTA
DSABO DSAM DSARSN DSTAP2
DSA DSAN DSAW DSVG1

DSVG1P EFFMAS FRLG GKAM


DSVG2 ELFDR FRLGEN GNFM
DSVG3 EMA FRQDRV GP0
DSVGP4 EMAKFR FRRD1 GP1
DSVGP5 EMG FRRD2 GP2
DUMMOD1-4 ESTINDX GENTRAN GP3
DVIEWP FA1 GETCOL GP4
DYCNTRL FA2 GETMKL GP5
DYNREDU FORTIO GI GPFDR

GPFTOTL IFPINDX MACOFP MATGEN


GPFXPND IFT MAKAEFA MATREDU
GPJAC INTERR MAKAEFS MCE1
GPSP ISHELL MAKAEMON MCE2
GPSTR1 LANCZOS MAKCOMP MDATA
GPSTR2 LCGEN MAKENEW MDCASE
GPWG LMATPRT MAKEOLD MGEN
GUST MAKMON MKCNTRL

DMAP Programmer's Guide 8-3


Chapter
Chapter 8: 8: Overview
Overview of DMAP
of DMAP Modules
Modules and Statements
and Statements

MKCSTMA MODTRK NASSETS OUTPRT


MKRBVEC MODUSET NLCOMB PCOMB
MKSPLINE MONVEC NLITER PLOT
MODACC MPP NLTRD PLTHBDY
MODEPF MRGCOMP NLTRD2 PLTSET
MODEPOUT MRGMON OFPINDX PLTMSG
MODGDN MSGHAN OPTGP0 PRESOL
MODGM4 MSGSTRES ORTHOG PROJVER

RANDOM SDR2 SDSA SEP1


RBMG3 SDR3 SDSB SEP1X
RBMG4 SDRCOMP SDSC SEP2
RMG2 SDRHT SECONVRT SEP2CT
RSPEC SDRNL SEDR SEP2DR
SCE1 SDRP SEDRDR SEP2X
SDP SDRX SELA SEP3
SDR1 SDRXD SEMA PROJVER

RANDOM STDCON TRD2 XYPLOT


RMAXMIN STRSORT TRLG XYTRAN
SHPCAS TA1 UEIGL
SMA3 TAFF UGVADD
SSG1 TAHT UREDUC
SSG2 TASNP1 VDR
SSG3 TASNP2 VIEW
SSG4 TOLAPP VIEWP
STATICS TRD1 WEIGHT

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.

8-4 DMAP Programmer's Guide


Overview of DMAP Modules and Statements

Matrix Modules

Module Basic operation

ADD [X] = α[A] β[B]

ADD5 [X] = α[A] + β[B] + λ[C] + Δ[D] + [E]

CEAD Solves for p and {φ} in([M]p2 + [B]p + [K]) {φ} = {0}

DECOMP,DCMP [A] → [L] [U]

DIAGONAL

FBS [X] = ±([L] [U])−1[B]

MERGE

MPYAD [X] = ±[A][B] ± [C] or [X] = ±[A]T [B] ± [C]

NORM [X] = [A] normalized to 1.0 maximum in each column

PARTN

READ, LANCZOS Solves for λ and {φ} in ([K] − λ[M]){φ} = {0}

SMPYAD [X] = [A][B][C][D][E] ± [F] or [A]T [B][A]

SOLVE, SOLVIT [X] = ± [A]−1 [B] or ± [A]−1

TRNSP [X] = [A]T

UMERGE

UMERGE1

UPARTN

DMAP Programmer's Guide 8-5


Chapter
Chapter 8: 8: Overview
Overview of DMAP
of DMAP Modules
Modules and Statements
and Statements

Utility Modules

Module Basic function

APPEND Concatenates two data blocks

COPY Copies a data block

DBC Converts data blocks for model generation and results processing

DBDICT Prints database directory tables with optional user-selectable format

DMIIN Converts DMI Bulk Data entries to data blocks

DRMS1 Recovers data by mode superposition

DTIIN Converts DTI Bulk Data entries to data blocks

ELTPRT Prints Element Summary Information

IFP1 Reads in the Case Control Section

IFP, IFP3 Converts the output from the XSORT module into several tables
through IFP9

INPUTT2 Reads data blocks from FORTRAN-readable files

INPUTT4 Reads matrices from FORTRAN-readable files

LAMX Edits or generates real or complex eigenvalue summary table

MATGEN Generates special matrices, such as identities, and so on

MATGPR Prints matrices with grid point and component identification

MATMOD Transforms a collection of input matrices into output matrices

MATPCH Punches the contents of matrix data blocks onto DMI Bulk Data entries

MATPRN Prints general matrix data blocks (10 items per line)

MATPRT Prints matrix data blocks (6 items per line)

MERGEOFP Merges linear and nonlinear stress data blocks from SDR2

MESSAGE Prints user defined messages

MODACC Partitions solution vectors based on the OTIME or OFREQ Case Control
command

MODTRL Modifies data block trailer data

MTRXlN Converts DMIG Bulk Data entries to matrix data blocks

NXNADAMS Writes ADAMS Modal Neutral File (MNF) for a superelement.

8-6 DMAP Programmer's Guide


Overview of DMAP Modules and Statements

Module Basic function

OFP Provides user-oriented self-explanatory formats for data blocks prepared by


other functional modules (for example, READ, CEAD, SDR2, etc.)

OUTPUT2 Writes tables or matrices onto FORTRAN-readable files

OUTPUT4 Writes matrices onto FORTRAN-readable files

PARAML Select parameters from a user input matrix or table

PRTPARM Prints parameter values and DMAP error messages

PVT Sets parameter values from Case Control and/or Bulk Data PARAM entries

RESTART Compares two data blocks and/or invokes dependencies defined in the NDDL

SCALAR Selects parameters from a user input matrix or table

SEQP Generates a mapping matrix for use in resequencing matrices

TABEDlT Edits tables

TABPRT Prints selected table data blocks using user-oriented formats

TABPT Prints table data blocks

TIMETEST Compute timing data

VEC Generates partitioning vector

VECPLOT Transforms, searches, and computes resultants of vectors

XSORT Reads in the Bulk Data Section

Executive Modules and Statements

Module or Basic function


statement

DBVIEW Creates a virtual data block from an NDDL data block

DELETE Deletes a data block(s) from the database

EQUIVX Assign another name to a data block

FILE Defines special data block characteristics to DMAP compiler

PURGEX Flags a data block as empty on the database

TYPE Identifies NDDL data blocks and parameters

DMAP Programmer's Guide 8-7


Chapter
Chapter 8: 8: Overview
Overview of DMAP
of DMAP Modules
Modules and Statements
and Statements

Obsolete Modules and Statements


The following modules are obsolete and are either no longer available or not recommended:

DMAP module or Alternate method or modules


statement

COND IF and IF ( ) THEN statement

DBDIR DBDICT statement

EQUIV EQUIVX module

INREL SubDMAP SEMR3

PARAMR Function and assignment statements

PURGE PURGEX module

RBMG2 DECOMP

REIGL READ module

REPT DO WHILE statement

SCE1 UPARTN

SETVAL Assignment statement

SMP2 UPARTN, MPYAD, SMPYAD

TASN TASNP2

8-8 DMAP Programmer's Guide


Chapter 9: DMAP Module and Statement Descriptions A-D

9.1 ACMG
Computes the coupling matrix for fluid/structure interface at all points or only points on a given
structural panel.

Format:

ACMG PANSLT,BGPDT,CSTM,SIL,ECT,EQACST,NORTAB,EQEXIN,EDT,GEOM2/
{AGG or APART}/
LUSET/MPNFLG/NUMPAN/S,N,PANAME/IPANEL/MATCH/
PNLPTV $

Input Data Blocks:

PANSLT Panel static load table

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

ECT Element connectivity table

EQACST Equivalence between internal fluid grid points and internal structural grid points
which lie on the fluid/structure boundary

NORTAB Table containing fluid face and the maximum of eight structural grids which lie
within the acoustic face

EQEXIN Equivalence between external grid/scalar and internal identification numbers

EDT Element deformation table, which contains SET1 and SET3 entries

GEOM2 Table of bulk data images related to element connectivity

Output Data Blocks:

AGG Fluid/structure coupling matrix at all points or for a structural panel

APART Partitioning vector for panel coupling matrix when PNLPTV=TRUE

DMAP Programmer's Guide 9-1


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

MPNFLG Input-integer-default=0. Set to 1 if multiple panels exist.

NUMPAN Input-integer-default=1. Number of panels.

PANAME Output-character-default=‘NASTPANL’ Name of the panel whose coupling matrix


is created.

IPANEL Input-integer-default=1. Number of records to skip to get the required data in


the PANSLT table.

MATCH Input-integer-default=0. Type of fluid/structural mesh matching.

0 matching mesh

1 nonmatching mesh

PNLPTV Input-logical-default=FALSE. Panel participation/partition vector flag. If TRUE,


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 $
ACMG PANSLT,BGPDTS,CSTMS,SILS,ECTS,EQACST,NORTAB,EQEXINS/
AGG/LUSETS/////MATCH $

Compute coupling matrices for all structural panels.


GP5 ECTS,BGPDTS,EQEXINS,EDT,SILS/
MPNSLT,EQACST,MNRTAB/
MPNFLG/S,N,NUMPAN/S,N,MATCH $
IPANEL=1 $
DO WHILE ( IPANEL<=NUMPAN ) $
ACMG MPNSLT,BGPDTS,CSTMS,SILS,ECTS,EQACST,MNRTAB,EQEXINS/
ABE/LUSETS/MPNFLG/NUMPAN/S,N,PANAME/IPANEL/MATCH $
IPANEL=IPANEL+1 $
ENDDO $ IPANEL<=NUMPAN

9-2 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Case Control table

EPT Table of Bulk Data entry images related to element properties

EDT Element deformation table. Contains ADAPT Bulk Data entries.

EST Element summary table

ELEMVOL Element volume table, contains p-element volumes and the p-value dependencies
of each p-element grid, edge, face and body

VIEWTB View information table, contains the relationship between each p-element and its
view-elements and view-grids

UG Displacement matrix in g-set

MPT Table of Bulk Data entry images related to material properties

ETT Element temperature table

CSTM Table of coordinate system transformation matrices

PVAL0 p-value table generated by ADAPT module in previous superelement or adaptivity


loop

ERROR0 Error estimate table generated by ADAPT module in previous superelement or


adaptivity loop

PELSET p-element set table, contains SETS DEFINITIONS

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

DIT Table of TABLEij Bulk Data entry images

OINT p-element output control table, contains OUTPUT Bulk Data entries

DMAP Programmer's Guide 9-3


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

BGPDT Basic grid point definition table

GPSNT Grid point shell normal table

EPSSE Table of epsilon and external work

LAMA Normal modes eigenvalue summary table

GLERR Table of global error estimates from previous iteration

Output Data Blocks:

PVAL1 P-value table updated for current superelement or adaptivity loop

ERROR1 Error-estimate table updated for current superelement or adaptivity loop

GLERR1 Table of global error estimates for current iteration

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.

APP Input-character-no default. Analysis type: ‘STATICS’or ‘REIGEN’

ADPTIND Input-integer-no default. P-version analysis adaptivity index.

SEID Input-integer-no default. Superelement identification number.

PVALNEW Output-integer-no default. New p-value set identification number.

ADPTEXIT Output-logical-no default. Set to TRUE if this is the final adaptivity loop.

DESITER Input-integer-no default. Design optimization iteration number.

DESMAX Input-integer-no default. Design optimization maximum allowed iteration number.

CNVFLG Input-integer-default=0. Design optimization convergence flag.

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.

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.

9-4 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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
Matrix add

Computes [X] = α[A] β [B] where α and β are scalar multipliers ( can be the +, *, ÷ or overwrite
operators).

Format:

ADD A,B/X/ALPHA/BETA/IOPT $

Input Data Blocks:

A Any matrix (real or complex).

B Any matrix (real or complex).

Output Data Block:

X Matrix.

DMAP Programmer's Guide 9-5


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

ALPHA Input-complex single precision-default = (1.0,0.0). This is α, the scalar multiplier


for [A].

BETA Input-complex single precision-default = (1.0,0.0). This is β, the scalar multiplier


for [B ].

IOPT Input-integer-default = 0. This chooses the operator in xjj = αAjj βBij

IOPT Operation

0 + , add
1
2

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

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.

9-6 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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

Parameters:

ALPHA Input-complex single precision-default = (1.0,0.0). This is α, the scalar multiplier


for [A].

BETA Input-complex single precision-default = (1.0,0.0). This is β, the scalar multiplier


for [B].

GAMMA Input-complex single precision-default = (1.0,0.0). This is λ, the scalar multiplier


for [C].

DMAP Programmer's Guide 9-7


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

DELTA Input-complex single precision-default = (1.0,0.0). This is Δ, the scalar multiplier


for [D].

EPSLN Input-complex single precision-default = (1.0,0.0). This is ε, the scalar multiplier


for [E].

ALPHAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar


multiplier for [A].

BETAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar


multiplier for [B].

GAMMAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar


multiplier for [C].

DELTAD Input-complex double precision-default = (1.0D0,0.0D0). This is the scalar


multiplier for [D].

EPSLND 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).

6. If ALPHAD, BETAD, GAMMAD, DELTAD, or EPSNLN is non-zero, the corresponding single


precision parameter is ignored EXCEPT when any of these parameter is complex unity. In that
case, the value of the single-precision parameter is used instead. Caution must be exercised
in a DMAP loop to insure that the single-prec parameter is also complex unity whenever the
double-prec parameter is complex unity.

Examples:
1. Compute:

9-8 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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/ICOL/IOPT/NCOL $

Input Data Blocks:

VEC Matrix containing the vector

MATI Input matrix

Output Data Blocks:

MATO Output matrix

Parameters:

ICOL Input-integer. Column of VEC to be used.

IOPT Input-integer. Option flag.


= 1 Add a vector to a matrix
= 2 Subtract a vector from a matrix

NCOL Input-integer-default = 0. Number of columns to create in MATO when MATI is null.

DMAP Programmer's Guide 9-9


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Table of aeroelastic model controls

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set and
ks-set grid points

AERO Table of control information for aerodynamic analysis

AECOMP Aerodynamic component definition table

W2GJ Matrix of aerodynamic intercepts that is usually input via DMI Bulk Data entries

ACPT Aerodynamic connection and property table

Output Data Blocks:

UXVBRL Controller state matrix for WJVBRL downwash vectors. UXVBRL has NX rows
and NV columns.

WJVBRL Downwash matrix (NJ rows by NV columns). Downwash at the j-points due to the
linear, angle/rate rigid body aerodynamic extra-points and linear control surfaces.

ADBINDX Table of the aerodynamic database contents (one entry for each of the NV
instances created)

Parameters:

NJ Input-integer-no default. Number of aerodynamic boxes (j-points).

NK Input-integer-no default. Number of aerodynamic degrees of freedom (k-points).

SYMXZ Input-integer-no default. x-z symmetry flag.

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.

9-10 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Complex modal displacements matrix - h-set

CASECC Case Control table

QKHL Aero transformation matrix between h and k sets

OL Complex eigenvalue summary table for flutter analysis or frequency response


output list for aeroelastic analysis

AEBGPDT Basic grid point definition table with the aerodynamic degrees of freedom added
(ks-set in AEUSET)

AEUSET Aerodynamic USET table

Output Data Block:

PKF Matrix of k-set forces per frequency

Parameters:

BOV Input-real-no default. Conversion from frequency to reduced frequency.

MACH Input-real-default=0.0. Mach number.

APP Input-character-no default. Analysis type.


‘FREQRESP’– aeroelastic
‘FLUTTER’ – flutter

DMAP Programmer's Guide 9-11


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

AECONFIG Input-character-no default. Aerodynamic configuration.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

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.

EDT Element Deformation Table. Contains all of the entries for related to aerostatic
and aeroelastic analysis.

9-12 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Output Data Blocks:

CASEA A single record (subcase) of CASECC

Parameters:

NSKIP Input/output-integer-default=0. Trim subcase counter.

LPFLG Input/output-integer-default=0. Flag to indicate whether there is another case


control record to process. Set to -1 for the last subcase and Mach number.

MFLG Input/output-integer-default=0. Flag to indicate whether there is another Mach


number to process in the current subcase. Set to 0 for the last Mach number in
the subcase

MACH Output-real-no default. Mach number.

Q Output-real-no default. Dynamic pressure.

AEQRATIO Output-real-no default. Aeroelastic feedback dynamic pressure ratio.

AECONFIG Output-character-no default. Aerodynamic configuration.

SYMXY Output-integer-no default. Aerodynamic x-y symmetry flag.

SYMXZ Output-integer-no default. Aerodynamic x-z symmetry flag.

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/
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.

DMAP Programmer's Guide 9-13


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Table of Case Control command images.

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

Output Data Blocks:

None.

Parameters:

NSKIP Input/output-integer-default=0. Trim subcase counter.

LPFLG Input/output-integer-default=0. Flag to indicate whether there is another case


control record to process. Set to -1 for the last aerodynamic subcase.

AECONFIG Output-character-no default. Aerodynamic configuration.

SYMXZ Output-integer-no default. Aerodynamic z-y symmetry flag.

SYMXY Output-integer-no default. Aerodynamic x-y symmetry flag.

9.10 AMG
Builds aerodynamic influence matrix

9-14 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Aerodynamic matrix generation table

ACPT Aerodynamic connection and property table

Output Data Blocks:

AJJT Aerodynamic influence matrix

SKJ Integration matrix list

D1JK Real part of downwash matrix

D2JK Imaginary part of downwash matrix

Parameters:

NK Input-integer-no default. Number of degrees of freedom in k-set.

NJ Input-integer-no default. Number of degrees of freedom in j-set.

SYMXZ Input-integer-no default. Aerodynamic z-y symmetry flag.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

REFC Input-real-no default.

MACH0 Input/output-real-default=-1.0. Previously processed Mach number.

MACHNO Input-real-default=0.0. Mach number.

KBAR Input-real-default = 0.0. Reduced frequency.

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’

DMAP Programmer's Guide 9-15


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Aerodynamic influence matrix

WSKJF Weighted integration matrix

D1JK Real part of downwash matrix

D2JK Imaginary part of downwash matrix

GDKI Aerodynamic transformation matrix for displacements from the k-set to h-set

GPIK Aerodynamic transformation matrix for loads from the h-set to k-set

GPKH Aerodynamic transformation matrix for loads from the k-set to h-set

D1JE Imaginary part of downwash matrix due to extra points

D2JE Imaginary part of downwash matrix due to extra points

MKLIST Table of Mach number and reduced frequency pairs

LAJJT Lower triangular decomposition factor matrix of AJJT

9-16 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

UAJJT Upper triangular decomposition factor matrix of AJJT

Output Data Blocks:

QHH Aerodynamic matrix of size h- by h-set

QKH Aerodynamic matrix of size k- by h-set

QHJ Aerodynamic matrix of size h- by j-set

Parameters:

NUMHDOF Input-integer-no default. The number of modes.

NOUE Input-integer-no default. The number of extra points.

GUSTAERO Input-integer-default=0. QHJ computed only if GUSTAERO<0.

MACH Input-real-default=0.0. Mach number.

KBAR 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.

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.

DMAP Programmer's Guide 9-17


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Table of Bulk Data entry images related to aerodynamics.

CSTM 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.

AEBGPDT* Two aerodynamic basic grid point definition tables (BGPDT) with
the degrees of freedom added and based on MODLTYPE qualifier:
MODLTYPE=‘AEROMESH’and MODLTYPE=‘AEROSTRC’ See Example.

AEUSET* Aerodynamic USET table defining ks-set based on MODLTYPE qualifier:


MODLTYPE=‘AEROSTRC’ See Example.

AECOMP Aerodynamic component definition table

AERO Control information for control of aerodynamic matrix generation and flutter
analysis

ACPT Aerodynamic connection and property table

CSTMA Aerodynamic coordinate system transformation matrices for g-set and ks-set
grid points

AMSPLINE Table of aerodynamic splines for display.

MPJN2O Mapping matrix to map j-set data from neworder to old order

Parameters:

NK Output-integer-no default. Number of degrees of freedom in the k displacement


set.

NJ Output-integer-no default. Number of degrees of freedom in the j displacement set.

BOV Output-integer-default=0.0. Value calculated by REFC/(2.*VELOCITY).

9-18 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

AERTYP 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 Points have unique identification numbers starting with the aerodynamic


component identification number.

-1 Points identification numbers are incremented by 1, to avoid an overlap if


they were started with the aerodynamic component identification numbers.
No display of the corner points is possible.

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 Model DOF set

STRUCTUR structural p-set

AEROSTRC aero-structural ks-set

AEROMESH plotting 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‘) $
DBVIEW AEUSET=USET0 WHERE (MODLTYPE=‘AEROSTRC‘) $
DBVIEW AEBGPDT=BGPDTS WHERE (MODLTYPE=‘AEROSTRC‘) $

9.13 APPEND
Concatenate two data blocks

DMAP Programmer's Guide 9-19


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.

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

9-20 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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
For values of IOPT -16, -17, -18, -19, or -20, the order of the parameters written is
reversed. For example, IOPT=-20 causes CHAR to be written first, then NULL2.

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.

NULL2 Input-integer-default = 0. The number of null columns or records to append onto


IN1 if IN2 is purged. Used only if lOPT = 1.

REAL Input-real-default=0.0. Real value in the next record.

REALD Input-complex-default=0.D0. Complex value in the next record.

CMPX Input-complex-default=(0.0,0.0). Complex value in the next record.

CMPXD Input-complex double precision-default=(0.D0,0.D0). Complex double precision


value in the next record.

CHAR Input-character-default=‘XXXXXXXX’ Character value in the next record.

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.

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. Siemens PLM Software recommends that the OUT data block be a scratch data block. In other
words, it should not be saved on a permanent DBset.

7. 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.

8. 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.

DMAP Programmer's Guide 9-21


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.

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 A single record (subcase) of CASECC for aerodynamic analysis

UXDAT Table of aerodynamic extra point identification numbers, displacements, labels,


type, status, position and hinge moments

AECTRL Table of aeroelastic model controls

FFAJ Matrix of pressures at aerodynamic boxes

ACPT Aerodynamic connection and property table

9-22 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

PAK Matrix of aerodynamic forces at aerodynamic boxes

AEUSET Aerodynamic USET table

AEBGPDT Basic grid point definition table with the aerodynamic degrees of freedom added
(ksa-set in AEUSET)

AECOMP Aerodynamic component definition table

MONITOR Structural monitor point table

MPSR Rigid aerodynamic loads on structural monitor points at trim (excluding inertial
loads and static applied loads)

MPSER Elastic restrained loads on structural monitor points at trim (excluding inertial
loads and static applied loads)

MPSIR Inertial loads on structural monitor points at trim

MPSRP Rigid loads on structural monitor points due to static applied loads

MPSERP Elastic restrained loads on structural monitor points due to static applied loads

AEMONPT Aerodynamic monitor point table

MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim

MPAER Elastic restrained loads on aerodynamic monitor points at trim

AERO Table of control information for aerodynamic analysis.

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

Output Data Blocks:

None.

Parameters:

MACH Input-real-no default. Mach number.

Q Input-real-no default. Dynamic pressure.

AECONFIG Input-character-no default. Aerodynamic configuration.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

IUNITSOL Input-integer-default=0. If IUNITSOL=0, trim solution is being supplied. If


IUNITSOL>0, IUNITSOL‘th unit solution is being supplied.

DMAP Programmer's Guide 9-23


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 A single record (subcase) of CASECC for aerodynamic analysis

AEMONPT Aerodynamic monitor point table

MONITOR Structural monitor point table

MPAERV Elastic restrained monitor point loads on aerodynamic model

MPSERV Elastic restrained monitor point loads on structural model

MPSIR Inertial loads on structural monitor points at trim

AEDBUXV Matrix of vehicle states

MPSERP Elastic restrained loads on structural monitor points due to static applied loads

AECTRL Table of aerodynamic model‘s control definition

EDT Table of Bulk Data entry images related to aerodynamics

PRBDOFS Partitioning matrix to partition the "active" URDDI from the "inactive." Active URRDI
are assigned a 1.0 value and are connected to the SUPORT degrees-of-freedom.

DIT Table of TABLEij Bulk Data entry images

AEDBINDX Aeroelastic database index for monitor point data

Output Data Blocks:

UX Matrix of aerodynamic extra point displacements

UXDAT Table of aerodynamic extra point identification numbers, displacements, labels,


type, status, position and hinge moments

UXDIFV Derivative interpolation factors matrix at UX = UXREF

Parameter:

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

9-24 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

ISENS 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.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 Output-integer-default=0. Auxiliary model identification number.

AUXMFL Output-logical-default=TRUE. Auxiliary model loop control flag. Set to FALSE


when processing the last auxiliary model.

DMAP Programmer's Guide 9-25


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 $

Input Data Blocks:

CASECC* Family of auxiliary model Case Control sections

BULK* 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

9-26 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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

GEOM1A Table of Bulk Data entry images related to geometry and assigned to the auxiliary
model identified by AUXMID

Output Data Blocks:

GEOM1C Table of Bulk Data entry images related to geometry and merged from GEOM1
and GEOM1A

CASEVEC Case Control table with the PARTN command referencing all of auxiliary model‘s
grid identification numbers

Parameter:

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.

DMAP Programmer's Guide 9-27


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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/NLBEAR $

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.

SOLAPP Output-character-no default. Design optimization analysis type.

NSKIP Input/output-integer-no default. The record number in CASECC corresponding to


the first subcase of the current boundary condition.

NLOADS Output-integer-default=0. The number of subcase records contiguous with respect


to the MPC and SPC command in the first subcase of the current boundary
condition.

BCFLAG Output-logical-no default. Set to FALSE at the last boundary condition.

SPC Output-integer-default=0. SPC Case Control command set identification number


specified in the third word of the SKIP-th record of CASECC.

MPC Output-integer-default=0. MPC Case Control command set identification number


specified in the second word of the NSKIP-th record of CASECC.

SUPORT Output-integer-default=0. SUPORT Case Control command set identification


number specified in the 255-th word of the NSKIP-th record of CASECC.

BCSET Output-integer-default=0. Contact set identification number.

BGSET Output-integer-default=0. Glue set identification number.

BOLTPRE Output-integer-default=0. Bolt preload identification number.

RIGID Output-character-default=linear. Selects the rigid element processing method for


RBAR, RBE1, RBE2, RROD and RTRPLT elements.

9-28 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

LOAD Output-integer-default=0. LOAD Case Control command set identification number


specified in the fourth word of the NSKIP-th record of CASECC.

LSEQ Output-integer-default=0. LOADSET Case Control command set identification


number specified in the 205-th word of the NSKIP-th record of CASECC.

STATSUB Output-integer-default=0. STATSUB Case Control command set identification


number specified in the 256-th word of the NSKIP-th record of CASECC.

BC Output-integer-default=0. BC Case Control command set identification number


specified in the 257-th word of the NSKIP-th record of CASECC.

BCLBL Input-integer-default=0. f06 file page header control.

-1 Clear page header

0 Initialize page header without page eject

1 Initialize page header with page eject.

NLBEAR Input-logical-default=FALSE. Flag indicating presence of nonlinear bearings.

Example:

Excerpt from subDMAP PHASE0:


BCFLAG=TRUE $
NSKIP=0 $
DO WHILE ( BCFLAG ) $
BCDR CASES//SEID/’‘/
S,N,NSKIP/S,N,NLOADS/S,N,BCFLAG/S,N,SPC/S,N,MPC/
S,N,SUPORT/S,N,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,GPDT,USET,
EQEXIN,GPECT,EST,ECT,KDICT,MDICT,BDICT/
GEOM1EX,GEOM2EX,GEOM4EX,CASEX,USETX,
EQEXINX,BGPDTX,GPECTX,ESTX,ECTX,KDICTX,MDICTX,BDICTX/
NOQSET/NOMATK/NOMATM/NOMATB/NOMATKY/NOMATP/DMIGSFIX $

DMAP Programmer's Guide 9-29


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Input Data Blocks:

CASECC Table of Case Control command images.

GEOM1 Table of Bulk Data entry images related to geometry.

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.

BGPDT Basic grid point definition table.

GPDT Grid point definition table.

USET Degree-of-freedom set membership table for g-set.

EQEXIN Table to equivalence external to internal grid/scalar numbering.

GPECT Grid point element connection table.

EST Element summary table.

ECT Element connectivity table.

KDICT Element stiffness dictionary.

MDICT Element mass dictionary.

BDICT Element damping dictionary.

Output Data Block:

GEOM1EX GEOM1 table containing records which define an external superelement.


Specifically, it contains CORD1j, CORD2j, EXTRN, and GRID Bulk Data records.

GEOM2EX GEOM2 table containing records which define an external superelement.


Specifically, it contains PLOTEL and SPOINT Bulk Data records.

GEOM4EX GEOM4 table containing records which define an external superelement.


Specifically, it contains ASETi and QSETi Bulk Data records.

CASEX Table of Case Control command images modified with additional output requests
due to PLOTELs.

USETX Modified USET table (only if NOQSET > 0).

EQEXINX Modified EQEXIN table (only if NOQSET > 0).

BGPDTX Modified BGPDT table (only if NOQSET > 0).

GPECTX Modified GPECT table (only if NOQSET > 0).

ESTX Modified EST table (only if NOQSET > 0).

ECTX Modified ECT table (only if NOQSET > 0).

9-30 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

KDICTX Modified KDICT table (only if NOQSET > 0).

MDICTX Modified MDICT table (only if NOQSET > 0).

BDICTX Modified BDICT table (only if NOQSET > 0).

Parameters:

NOQSET Input-integer-default=0. Number of actual q-set dof used to define modal


coordinates.

NOMATK Input-integer-default= -1. Stiffness matrix existence flag.

-1 Does not exist

0 Empty

1 Exists

NOMATM Input-integer-default= -1. Mass matrix existence flag.

-1 Does not exist

0 Empty

1 Exists

NOMATB Input-integer-default= -1. Viscous damping matrix existence flag.

-1 Does not exist

0 Empty

1 Exists

NOMATKY Input-integer-default= -1. Hysteretic damping matrix existence flag.

-1 Does not exist

0 Empty

1 Exists

NOMATP Input-integer-default= -1. Load matrix existence flag.

-1 Does not exist

0 Empty

1 Exists

DMIGSFIX Input-character-default = “ ” (default = eight blank spaces). Suffix for DMIG


matrices.

DMAP Programmer's Guide 9-31


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Table of Bulk Data entries related to contact regions

CASECC Table of Case Control command images

BTOPO Contact regions topological information table

XYCDB Table of x-y plotting command

Output Data Block:

CASECCBO Updated CASECC for contact region data recovery operations

Parameters:

NEWCASE Output-integer-no default. CASECCBO output flag. Set to 1 if CASSECBO


is generated.

NBSORT2 Output-integer-default=0. Contact region output sort format flag.

1 if SORT2 format is requested for printing

2 if x-y plotting is requested

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 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Input Data Blocks:

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

KGGT Total structural stiffness matrix in g-size (sum of linear, nonlinear and differential
matrices)

Output Data Block:

BTOPO Contact regions topological information table

BGPECT Boundary grid point element connection table

Parameters:

ADPCON Input-real-default=1.0. Scale factor for adjusting penalty values on restart. Update
penalty values if positive.

ISKIP Input-integer-default=0. Counter to update penalty values; updates on first pass


and no update later.

Remarks:
1. CSTM can be purged.

2. BTOPO is both input and output. See example.

Example:
Excerpt of BGP for a nonlinear loop in SOL 106:
FILE BTOPSTF=APPEND/BTOPCNV=APPEND $
BGP CSTMS,SILS,KGGT/BTOPSTF,BGPECT/ADPCONx/ISKIP $
COPY BTOPSTF/BTOPCNV/-1/1 $

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

DMAP Programmer's Guide 9-33


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

Output Data Block:

BDPOOL Hydroelastic boundary matrices in DMIG Bulk Data entry format

Parameters:

NOKBFL Output-integer-no default. Matrix KBFL existence flag; 0 if KBFL exists and
-1 otherwise.

NOABFL Output-integer-no default. Matrix ABFL existence flag; 0 if ABFL exists and
-1 otherwise.

MFACT Output-complex-no default. Scale factor for hydroelastic boundary mass matrix.

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

USET Degree-of-freedom set membership table

9-34 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

BGPDT Basic grid point definition table for the current superelement

YS Matrix of enforced displacements

YSD Accumulated matrix of enforced displacements from upstream superelements

Output Data Blocks:

USET1 USET updated with constraints from upstream superelements

YS1 YS updated with enforced displacements from upstream superelements

Parameters:

SEID Integer-input-default=0. Superelement identification number.

NLOADS Integer-input-default=0. The number of subcase records contiguous with respect


to the MPC and SPC command in the first subcase of the current boundary
condition.

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 $
.
.
.
ENDDO $ BCFLAG
ENDDO $ LPFLG

DMAP Programmer's Guide 9-35


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.25 BOLTFOR
Calculates bolt forces from preload.

Format:

BOLTFOR CASECC,BGPDT,CSTM,GEOM3,ECT,EDT,SIL,SBDATA/
BTFG,ELIST/
NSKIP/NDOFG/S,N,NBOLTS $

Input Data Blocks:

CASECC Table of case control command images.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

GEOM3 Table of Bulk Data entry images related to static and thermal loads.

ECT Element connectivity table.

EDT Element data table.

SIL Scalar index list.

SBDATA Solid bolt data.

Output Data Blocks:

BTFG Bolt force vector.

ELIST List of active bolt element numbers.

Parameters:

NSKIP Input-integer-no default. Number of cases to skip.

NDOFG Integer-input-no default. Number of degrees of freedom in the g-set.

NBOLTS Output-integer-no default. Number of bolts used.

9.26 BOLTSF
Calculates bolt strain force.

9-36 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

BOLTSF CASECC,BGPDT,CSTM,GEOM3,KDICT,KELM,EDT,UG,SBDATA/
BOLTFOR,BTSFG,YG/NSKIP $

Input Data Blocks:

CASECC Table of Case Control command images.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

GEOM3 Table of Bulk Data entry images related to static and thermal loads.

KDICT Element stiffness dictionary.

KELM Element stiffness matrix.

EDT Element data table.

UG Displacements due to bolt preload forces in the g-set.

SBDATA Solid bolt data.

Output Data Blocks:

BOLTFOR List of element numbers and bolt force for SDRX.

BTSFG Bolt force vector due to initial strain applied to the g-set.

YG Displacements to be applied.

Parameter:

NSKIP Input-integer-default=0. Number of cases to skip.

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.

DMAP Programmer's Guide 9-37


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format 1:

CASE CASECC,PSDL/
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP/S,N,LINC/GMAFLG/
S,N,MSCHG/S,N,TESTNEG/S,N,IMETHOD/CASCOM1/CASCOM2/
CASCOM3/CASCOM4/CASCOM5/CASCOM6/CASCOM7/CASCOM8/
CASCOM9/CASCOM10/

Format 2:

CASE CASECC,MPT/
CASEXX/
APP/S,N,NSKIP/S,N,NOLOOP/S,N,LINC/LGDISP/
S,N,MSCHG/S,N,TESTNEG/S,N,IMETHOD/CASCOM1/CASCOM2/
CASCOM3/CASCOM4/CASCOM5/CASCOM6/CASCOM7/CASCOM8/
CASCOM9/CASCOM10/

Input Data Blocks:

CASECC Table of Case Control command images.

PSDL Power spectral density list. Applicable only when APP=‘FREQ’

MPT Table of Bulk Data entry images for TSTEPNL, NLPARM, and NLPCI. Applicable
only when APP=‘NONL’

Output Data Block:

CASEXX Subset of CASECC for current loop

Parameters:

APP Input-character-no default. Analysis type.

‘CEIG’ Complex eigenvalue

‘FREQ’ Frequency response

‘TRAN’ Transient response

‘NONL’ Nonlinear static or transient

‘SLIC’ Slice a contiguous subset of CASECC records into CASEXX; that is,
NOLOOP number of records starting with the NSKIP-th record.

9-38 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

‘COMM’ Extract a slice of contiguous subset records, beginning at the


NSKIP-th record, with the same Case Control command set
identification numbers for command names specified in CASCOMi.

NSKIP Input/output-integer-default=1. CASECC record counter or nonlinear transient


loop identification number

Input:

≤0 Skip one record on CASECC

>0 Number of records to skip on CASECC to reach the current subset


of CASECC

Output:

-1 No more cases

>0 and APP<>‘NONL’: Indicates the number of records to skip on


CASECC to reach the next subset of CASECC.

>0 and APP=‘NONL’: Indicates that there are more CASECC records to
process and NSKIP must be incremented in the DMAP.

NOLOOP Output-integer-default=-1. Looping test flag

-1 No DMAP looping is required.

1 DMAP looping is required.

LINC Output-integer-default=0. Number of load increments for this subcase. Used in


nonlinear static analysis only (APP=‘NONL’and IMETHOD=0).

GMAFLG Input-integer-default=0. Test control flag for changes in the set identification
numbers specified for the SDAMPING, K2PP, M2PP, B2PP, and TFL commands.
Used only when APP=‘FREQ’or ‘CEIG’

0 Do not ignore changes (default).

1 Ignore changes.

LGDISP Determines if large displacement effects are included in nonlinear solutions 106,
129, 153, and 159. SOLs 601 and 701 support LGDISP = +1 or -1 only.

+1 All nonlinear element types that have a large displacement capability


will have large displacement effects (updated element coordinates
and follower forces).

-1 No large displacement effects will be considered.

2 Follower force effects will be ignored but large displacement effects


will be considered.

DMAP Programmer's Guide 9-39


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

≥0 The differential stiffness is computed for the linear elements and


added to the differential stiffness of the nonlinear elements.

MSCHG Output-integer-default=0. Boundary condition change flag. Used in nonlinear


static analysis only (APP=‘NONL’and IMETHOD=0).

-1 If MPC and SPC Case Control commands for this subcase are the
same as those in the immediately preceding subcase.

1 If MPC or SPC commands are different.

TESTNEG Output-integer-default=-2. Load increment method flag. Used in nonlinear static


analysis only (APP=‘NONL’and IMETHOD=0).

-2 Standard

1 Controlled increment

IMETHOD Input/output-integer-default=0. Nonlinear transient analysis flag.

Input:

0 Nonlinear static analysis (default)

<>0 Nonlinear transient analysis

Output (nonlinear transient only):

-1 Auto or TSTEP method (NLTRD module)

2 ADAPT method (NLTRD2 module)

CASCOMi Input-character-default=’ ’ Case Control command names. See APP=‘COMM’

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/

9-40 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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/LGDISP/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.
If LGDISP>0 and ESE output is requested, INTOUT on the NLPARM bulk data entry must be set
to “YES” for all subcases. If not, ESE output will be turned off.
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:

Extract the load and subcase identification numbers and a parameter value from each
1.
subcase.

DMAP Programmer's Guide 9-41


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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

Extract Case Control records 10, 11, and 12.


2.
CASE CASECC,/CASE10/‘SLIC‘/10/3 $

Extract Case Control records with the same MPC, SPC, and SUPORT set identification
numbers beginning at the NSKIP-th record.
3.
CASE CASECC,/CASEBC/‘COMM‘/S,N,NSKIP/
//////‘MPC‘/‘SPC‘/‘SUPO’$

9.28 CEAD
Complex or unsymmetric eigenvalue analysis
Given that [M], [B] and [K] are mass, damping, and stiffness, solve the equation:

or

9-42 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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/RSPEED/RUNIT $

Input Data Blocks:

KXX Stiffness matrix. Usually KHH or KDD.

BXX Viscous damping matrix. Usually BHH or BDD.

MXX Mass matrix. Usually MHH or MDD.

DYNAMIC Table of Bulk Data entry images related to dynamics.

CASECC Table of Case Control command images.

VDXC Partitioning vector with 1.0 at rows corresponding to null columns in KDD, BDD,
and MDD.

VDXR Partitioning vector with 1.0 at rows corresponding to null rows in KDD, BDD,
and MDD.

Output Data Blocks:

CPHX Complex eigenvector matrix. Usually CPHH or CPHD.

CLAMA Complex eigenvalue summary table.

OCEIG Complex eigenvalue extraction report.

LCPHX Left-handed complex eigenvector matrix (Lanczos only). Usually LCPHH or


LCPHD.

CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal. See Remark 8.

Parameters:

NEIGV Output-integer-no default. NEIGV indicates the number of eigenvalues found. If


none were found, NEIGV is set to -1.

UNUSED2 Input-integer-default=1. Unused.

DMAP Programmer's Guide 9-43


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

SID Input-integer-default=0. Alternate set identification number.


If SID=0, the set identification number is obtained from the CMETHOD command
in CASECC and used to select the EIGC entry in DYNAMIC.
If SID>0, 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 Complex Lanczos (block or single vector)

HESS QZ Hessenberg or QR Hessenberg

SVD Singular Value Decomposition

ISRR Iterative Schur-Rayleigh-Ritz method

SOAR Second-Order Arnoldi method

EPS Input-real-default=1.E-5. Used only when SID<0.

ND1 Input-integer-default=0. The number of desired eigenvectors. Used only when


SID<0.

ALPHAJ Input-real-default=0.0. Real part of shift point for pre-Version 70.5 Lanczos
method. Used only when SID<0.

OMEGAJ Input-real-default=0.0. Imaginary part of shift point for pre-Version 70.5 Lanczos
method. Used only when SID<0.

MAXBLK Input-integer-default=0. Maximum block size. Used only when SID<0.

IBLK Input-integer-default=0. Initial block size. Used only when SID<0.

KSTEP Input-integer-default=0. Number of frequency steps. Used only when SID<0.

NDJ Input-integer-default=0. The number of desired eigenvectors at desired shift point


for pre-Version 70.5 Lanczos method. Used only when SID<0.

RSPEED Input-real-default=0.0. Rotor speed in RUNIT units.

RUNIT Input-character-default=‘ ’ (8 blank spaces). Units for RSPEED. Options are


‘RPM’, ‘CPS’, ‘HZ’, and ‘RAD’. Blank for non-rotor dynamic analyses.

Remarks:
1. Eigenvalues are extracted by the Inverse Power, Hessenberg, or Lanczos method.

9-44 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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. Siemens PLM Software 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 K,B,M,DYNAMIC,CASECC,,/VEC,CLAMA,OCEIGS,/
S,N,NFOUND $
OFP CLAMA,OCEIGS// $
IF (NFOUND>-1) MATPRN VEC// $

9.29 CHKCOME
Check that PARAM,SECOMB,YES is valid for element-specific outputs.

Format:

CHKCOME SEMAP,SETABLE,SEELMSO/SEELEMS/S,N,YESOK

Input Data Blocks:

SEMAP Superelement map. (Required)

DMAP Programmer's Guide 9-45


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

SETABLE Table of internal element IDs for current external partitioned superelement.
(Optional)

SEELMSO Table of element IDs for all previous external partitioned superelements. (Optional)

Output Data Blocks:

SEELEMS Table of element IDs for all external partitioned superelements including the
current one. Required only if SETABLE exists. If SEELMSO exists, it will be
merged with the element IDs of the current superelement in SETABLE to form
SEELEMS. (Required)

Parameters:

YESOK Output-integer. Set to 0 if duplicates found (indicating that PARAM,SECOMB,YES


is invalid); set to 1 if no duplicates found (indicating that PARAM,SECOMB,YES
is valid).

9.30 CHKCOMG
Check that PARAM,SECOMB,YES is valid for grid/scalar-specific outputs.

Format:

CHKCOMG SGPDT,EQEXINS,SETABLE,SEGRDSO/SEGRIDS/SEID/S,N,YESOK

Input Data Blocks:

SGPDT Superelement grid point definition table. (Required if SETABLE not present)

EQEXINS EQEXIN for current superelement. (Required if SETABLE not present)

SETABLE Table of internal grid/scalar IDs for current external partitioned superelement.
(Optional)

SEGRDSO Table of grid/scalar IDs for all previous external partitioned superelements.
(Optional)

Output Data Blocks:

SEGRIDS Table of grid/scalar IDs for all external partitioned superelements including the
current one. Required only if SETABLE exists. If SEGRDSO exists, it will be
merged with the grid/scalar IDs of the current superelement in SETABLE to form
SEGRIDS. (Required)

9-46 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Parameters:

SEID Input-integer-no default. ID of current superelement.

YESOK Output-integer. Set to 0 if duplicates found (indicating that PARAM,SECOMB,YES


is invalid); set to 1 if no duplicates found (indicating that PARAM,SECOMB,YES
is valid).

9.31 CHKCVG
Check on contact convergence

Format:

CHKCVG TLAMDA,TLAMDO//TYPE/S,N,CMXF/S,N,FRAT/S,N,CNVI $

Input Data Blocks:

TLAMDA Current contact result.

TLAMDO Previous contact result.

Output Data Blocks:

TYPE Input-integer. Type of convergence check.

CMXF Input/Output - integer. Input - Convergence ratio factor. Output - Maxmum value.

FRAT Output - real. Convergence ratio.

CNVI Output-integer. Convergence flag.


0 - Not converged
1 - Converged

9.32 CHKPNL
Checks Bulk Data PANEL input against ERP requests in Case Control.

Format:

CHKPNL CASECC,EDT//S,N,NOGO $

Input Data Blocks:

CASECC Table of Case Control entries

DMAP Programmer's Guide 9-47


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

EDT Table of a subset of Bulk Data entries that also includes PANEL entries

Output Data Blocks:

None

Parameters:

NOGO Output-logical-default=FALSE. Set to TRUE if an error is detected

9.33 CKROTCN
Check rotor connections for rotor dynamic analysis.

Format:

CKROTCN DYNAMIC,GPECT,BGPDT//RSETI $

Input Data Blocks:

DYNAMIC Table of bulk entry images related to dynamics

GPECT Grid point element connectivity table

BGPDT Basic grid point definition table

Output Data Blocks:

None

Parameters:

RESTI Input-integer-no default. RSETI value for the current rotor from the ROTORD
bulk entry

Remarks:

If there are any invalid connections between a rotor and the stationary portion of the structure, Error
2050 is issued and the NOGO flag is set. NOGO=–1 in the DMAP code indicates that CKROTCN has
issued one or more errors.

9-48 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

9.34 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 Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries.

MPT Table of Bulk Data entry images related to material properties, in particular, MAT2
and MAT8 entries.

DIT Table of TABLEij Bulk Data entry images.

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry.

Output Data Blocks:

EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL records.

MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2 records.

Parameter:

NOCOMP Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry records
are found.

Remarks:
1. CMPZPR is functionally equivalent to module IFP6.

2. For each PCOMP entry (with PID<100000000) in EPT, an equivalent PSHELL entry image with
associated MAT2 images is generated. The newly generated images are then merged with the
existing PSHELL and MAT2 entries and written to the output data blocks 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.35 CNTGLUE
Creates the surface-to-surface glue dof sequence table.

DMAP Programmer's Guide 9-49


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:

CNTGLUE CNELM,GPL/GLUESEQ $

Input Data Blocks:

CNELM Glue element definition table

GPL External grid/scalar point identification number list

Output Data Blocks:

GLUESEQ Glue dof sequence number table

9.36 CNTITER
Perform surface to surface contact using the element iterative solver.

Format:

CNTITER KELM,PGALL,KDICT,SILS,ECT,BGPDT,CSTM,EDT,CASECC,USET,RG,MPT,
YG,SLT,MDICT,MELM,EPT,CNELM,ELCNST,ELCTST,ELGSTF,GLUESEQ,BIN/
UGV1,QG1,OQGCF1,OBC1,CONFON,ELTRCT1,OSPDSI1,OSPDS1,BOUT/
NSKIP/NLOADS/NOFAC/
S,N,MAXO/S,N,MAXI/S,N,CNTS/S,N,AITK/S,N,RESET/S,N,MINOLP/
S,N,TARPEN/S,N,ADAPT/S,N,SCALMT/S,N,IMODE/WTMASS $

Input Data Blocks:

KELM Table of element matrices for stiffness, heat conduction, differential stiffness, or
follower stiffness.

PGALL Combined static load matrix for the g-set and in the residual structure. Output
by PCOMB.

KDICT KELM dictionary table.

SILS Global scalar index list (required only for OPTION=1).

ECT Element connectivity table.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

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.

9-50 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

CASECC Table of Case Control command images. Required if SMETHOD Case Control
command is used and NSIP=-1.

USET Degree-of-freedom set membership table for g-set.

RG Constraint matrix in g set.

MPT Material property table.

YG Specified non-zero displacements in g set.

SLT Static load table.

MDICT Mass dictionary.

MELM Element mass matrix.

EPT Element property table.

CNELM Contact/Glue element definition.

ELCNST Element normal stiffness.

ELCTST Element tangential stiffness.

ELGSTF Element stiffness terms.

GLUESEQ Element node sequence numbers.

BIN Results from bolt preload phase.

Output Data Blocks:

UGV1 Displacements - g set.

QG1 SPC forces - g set.

OQGCF1 Contact force at grid point.

OBC1 Contact pressures and tractions at grid points.

CONFON Contact forces on elements.

ELTRCT1 Contact tractions on elements.

OSPDSI1 Initial separation distance.

OSPDS1 Final separation distance.

BOUT Results from bolt preload phase.

DMAP Programmer's Guide 9-51


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

NSKIP Input-integer-no default. Record number in CASECC corresponding to the first


subcase of the current boundary condition.

NLOADS Input-integer-no default. Number of subcases in the contact solution.

NOFAC Input - integer. Percent of initially open contacts to make active.

MAXO Input-integer-no default – Maximum number of iterations for the Status/Outer


loop (BCTPARM MAXS value).

MAXI Input-integer-no default – Maximum number of iterations for the Force/Inner loop
(BCTPARM MAXF value).

CNTS Input-real. Allowable number of contact changes for convergence. (Same as


NCHG parameter on BCTPARM bulk data entry).

AITK Input-integer-no default – Aitken iteration flag.

RESET Input-integer-no default – Contact Reset flag specified on the BCTPARM Bulk
data.

MINOLP Input-integer-no default – Minimum number of outer loops to execute.

TARPEN Input-integer-no default. Target penetration. TARPEN is the product of the


BCTPARM parameter PENETFAC and the effective depth calculated by the
solver. It is used in the calculation of a scale factor that adaptively scales the
contact stiffness matrix when PENADAPT is selected in the BCTPARM bulk entry.

ADAPT Input-integer default=0


=0 adaptive stiffness option is not selected in the BCTPARM bulk entry.
>0 adaptive stiffness option is selected in the BCTPARM bulk entry.

SCALMT Input-integer-no default. Maximum number of outer loop iterations to allow scaling
of contact stiffness matrix.
=3 for shell models
=MAXO for solid models

IMODE Input-integer-no default. Contact/Bolt-preload option


=1 contact only
=2 contact and preload
=3 contact, preload and applied load

WTMASS Input-real-default=1.0. Weight to mass conversion factor.

9.37 CNTMAPTR
Map the contact tractions from the contact face to the new contact points following a geometry update.

9-52 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

CNTMAPTR CNELM,TFTRAC/TLAMDA/ $

Input Data Blocks:

CNELM Contact element definition table

TFTRAC Extrapolated contact tractions on a per face basis

Output Data Blocks:

TLAMDA Contact tractions at new contact locations after geometry update

Parameters:

None

9.38 CNTSTAT
Compute and update contact element status.

Format:

CNTSTAT CNELM,ECSTAT,ELAMDA,TLAMDA,ECDISP,UGCB,BGPDT/
ECSTAT2/
S,N,CITO/NOFAC/S,N,NCS0/S,N,NCS1/S,N,NCS2/S,N,NCS3/
S,N,NCSC/S,Y,INREL/S,N,NOGSET/LGDISP $

Input Data Blocks:

CNELM Contact element definition table

ECSTAT Contact element status

ELAMDA Contact element tractions from last augmented state

TLAMDA Current total contact element tractions

ECDISP Contact element displacements

UGCB Nodal displacements in the basic coordinate system

BGPDT Basic grid point definition table

Output Data Blocks:

ECSTAT2 Updated contact element status

DMAP Programmer's Guide 9-53


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

CITO Input-integer-default=0. Contact augmentation loop ID

NOFAC Integer-real-no default. Percentage of initially open contact elements to make


active

NCS0 Output-integer-default=0. Number of inactive contact elements

NCS1 Output-integer-default=0. Number of active open contact elements

NCS2 Output-integer-default=0. Number of sticking contact elements

NCS3 Output-integer-default=0. Number of sliding contact elements

NCSC Output-integer-default=0. Number of contact status changes

INREL Input-integer-default=0. Inertia relief options


=0 No inertia relief
=1 Manual inertia relief
=2 Automatic inertia relief

NOGSET Input-integer-no default. Size of g-set

LGDISP Input-integer-default=-1. Large displacement flag

9.39 CNTXTRAP
Extrapolates contact tractions to contact face.

Format:

CNTXTRAP CNELM,ECSTAT,TLAMDA/TFTRAC/ $

Input Data Blocks:

CNELM Contact element definition table

ECSTAT Contact status table

TLAMDA Contact tractions

Output Data Blocks:

TFTRAC Extrapolated contact tractions for each face involved in contact

9-54 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Parameters:

None

9.40 COMBOUT
Combine output data blocks.

Format:

COMBOUT OUT1,OUT2/OUTC/S,N,CFLAG

Input Data Blocks:

OUT1 Output data block number 1.

OUT2 Output data block number 2

Output Data Blocks:

OUTC Output data block containing combination of OUT1 and OUT2.

Parameter:

CFLAG Output-integer.

= 0: Combination process OK; OUTC created

= 1: OUT1 empty; OUTC not created

= 2: OUT2 empty; OUTC not created

= 3: OUT1 and OUT2 both empty; OUTC not created

Remarks:

1. OUT1 and OUT2 must be compatible. This means the data must be the same (e.g. both
are displacements) and the numerical type must be the same (e.g. both are real or both are
complex). If both are complex, both must be real/imaginary or magnitude/phase.

2. Only SORT1 data blocks are valid.

3. Data for duplicate grids/scalars/elements is eliminated.

4. This is useful for combining results for superelements with results for the residual structure.

DMAP Programmer's Guide 9-55


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.41 CONSTF
Forms contact element stiffness.

Format:

CONSTF CNELM,BGPDT,CSTM,UGCB,ECSTAT,TLAMDA,ELAMDA/
ELCNST,ELCTST/
GSIZE/LGDISP/IOPT $

Input Data Blocks:

CNELM Contact element definition table

BGPDT Basic grid point definition table

CSTM Coordinate system definition table

UGCB Nodal displacements in basic coordinate system

ECSTAT Contact element status table

TLAMBDA Current total contact element tractions

ELAMBDA Previous augmented contact element tractions

Output Data Blocks:

ELCNST Normal contact element stiffness

ELCTST Tangential contact element stiffness

Parameters:

GSIZE Input-integer-no default. Size of the g-set

LGDISP Input-integer-default=-1. Large displacement flag

IOPT Input-integer-no default. Analysis flag


=1 Statics
=2 Modal

9.42 CONTOUT
Computes separation distance, slide distance and status at each contact node at requested output
time intervals.

9-56 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

CONTOUT CNELM,ECDISP,CASESX2H,ECSTAT,ECDISD,BGPDT,CNTPENTR/
OSPDS1,OSLIDE1,OCONST1/
NVEC/DMAPNO/RSTIME/LGDISP $

Input Data Blocks:

CNELM Contact element definition table

ECDISP Contact element displacements at requested output time interval

CASESX2H Case control for current subcase

ECSTAT Contact element status table

ECDISD Contact element displacements from last output time interval

BGPDT Basic grid point definition table

CNTPENTR Contact element penetrations

Output Data Blocks:

OSPDS1 Separation distance in SORT1 format

OSLIDE1 Slide distance in SORT1 format

OCONST1 Contact status in SORT1 format

Parameters:

NVEC Input-integer-no default. Number of solution results to process

DMAPNO Input-integer-no default. DMAP number

RSTIME Input-real-no default. Current output interval time

LGDISP Input-integer-default=-1. Large displacement flag

9.43 COPY
Copies data blocks.

Format:

COPY DBI/DBO/PARM/BLOCK $

DMAP Programmer's Guide 9-57


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Input Data Block:

DBI The data block to be copied

Output Data Block:

DBO A copy of DBI

Parameters:

PARM Input-integer-default=-1 (PARM < 0 – the data block is copied. PARM ≥ 0 – no


action is taken.)

BLOCK Input-integer-default=1
BLOCK < 0 – Block sensitive copy is used.
BLOCK ≥ 0 – Standard copy is used.

Remarks:
1. If BLOCK < 0 and the block size between DBI and DBO is different, a fatal error is issued.

2. This module is preferred over the copy options in MATMOD option 13 and TABEDIT.

Example:
Copy data block KELM.
COPY KELM/KELMX/ALWAYS/-1 $

9.44 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 Element stress or strain table in SORT1 format

MPT Table of Bulk Data entry images related to material properties

CSTM Table of coordinate system transformation matrices

9-58 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

EST Element summary table

BGPDT Basic grid point definition table

Output Data Blocks:

OES1M Element stress or strain table in SORT1 format in the element‘s material
coordinate system defined on the MAT1 entry

OES1G Grid point stress or strain table in SORT1 format and interpolated from the
centroidal stress table, OES1M

Parameters:

OUTOPT Input-integer-default=0. Output option:

≤0 Use the element output option found on OES1.

1 Print

2 Plot

4 Punch

The above values can be added together to select two or more forms of output.
For example, OUTOPT=6 requests both plot and punch output.

OG Input-integer-default=0. Grid point processing flag. If set to 0, grid point stresses


or strains are computed.

NINPTPS Input-integer-default=0. Approximate number of surrounding independent element


interpolation points to be considered when interpolating at a grid point for a given
material coordinate system.

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.45 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.

DMAP Programmer's Guide 9-59


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:

CURVPLOT EQEXIN,BGPDT,EDT,XYCDB,OPG1,OQG1,OUG1,OES1G,OSTR1G/
OPG2X,OQG2X,OUG2X,OES2GX,OSTR2GX/
DOPT $

Input Data Blocks:

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

BGPDT Basic grid point definition table

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, and the iterative solver; and in particular, SET1 entries

XYCDB Table of x-y plotting commands

OPG1 Table of applied loads in SORT1 format

OQG1 Table of single point forces of constraint in SORT1 format

OUG1 Table of displacements in SORT1 format

OES1G Table of grid point stresses in SORT1 format

OSTR1G Table of grid point strains in SORT1 format

Output Data Blocks:

OPG2X Table of applied loads in SORT2 format

OQG2X Table of single point forces of constraint in SORT2 format

OUG2X Table of displacements in SORT2 format

OES2GX Table of grid point stresses in SORT2 format

OSTR2GX Table of grid point strains in SORT2 format

Parameter:

DOPT Input-integer-default=0. Scaling method between grid points on the abscissa.

0 Proportional with respect to total distance

1 Proportional with respect to x distance only

2 Proportional with respect to y distance only

3 Proportional with respect to z distance only

4 Equally

9-60 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 $
IF ( NOXYP>=0 ) XYPLOT XYPLTS/ $

9.46 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 Table of Case Control command images

GEOM3 Table of Bulk Data entry images related to static loads

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity

DIT Table of TABLEij Bulk Data entry images

FRL Frequency response list

DMAP Programmer's Guide 9-61


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Output Data Blocks:

KVAL Table of harmonic indices for analysis

GEOM3N Updated GEOM3 for cyclic symmetry analysis

CASEFR Updated Case Control table for static loads generation and solution in cyclic
symmetry analysis. One record for every distinct load set identification number.

HARM Table of harmonic indices

FORE Transformation matrix from physical to cyclic components

CASEBK Case Control table for cyclic data recovery. One record for every column in BACK.
Required in static and pre-buckling analysis only.

BACK Transformation matrix from cyclic to physical components. Required in static


and pre-buckling analysis only.

Parameters:

NSEG Output-integer-no default. Number of cyclic segments as specified on CYSYM


Bulk Data entry.

CTYPE Output-character-no default. Cyclic symmetry type as specified on CYSYM Bulk


Data entry.

‘ROT’ Rotational

‘AXI’ Axisymmetric

‘DIH’ Dihedral

APP Input-character-no default. Analysis type.

‘STATICS’ Statics

‘MODES’ Normal modes

‘BUCKLNG1’ Pre-buckling (statics)

‘BUCKLNG2’ Buckling

‘FREQRESP’ Frequency response

NOGEOM3 Output-integer-no default. GEOM3N creation flag. Set to 1 if GEOM3N is created,


otherwise set to -1.

NFREQ Output-integer-no default. Number of frequencies for frequency response analysis.

TOTALK Output-integer-default=0. Total number of harmonics.

9-62 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Remarks:

CYCLIC1 generates equivalent GRAV and RFORCE Bulk Data entry images in harmonic components.

9.47 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 $

Input Data Blocks:

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

USET Degree-of-freedom set membership table

Output Data Block:

CYCD Table of constraints in harmonic components

Parameters:

NSEG Input-integer-no default. Number of cyclic segments as specified on CYSYM


Bulk Data entry.

CTYPE Input-character-no default. Cyclic symmetry type as specified on CYSYM Bulk


Data entry.

‘ROT’ Rotational

‘AXI’ Axisymmetric

‘DIH’ Dihedral

Remarks:

1. CYCLIC2 is a preprocessor for the CYCLIC3 and CYCLIC4 modules and is specified before
the harmonic index loop in DMAP.

DMAP Programmer's Guide 9-63


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.48 CYCLIC3
Forms cyclic matrices
Forms transformation matrices between cyclic components and solution set. Form partitioning
vector for supported degrees-of-freedom. Perform transformation of structural matrices in cyclic
components to the solution set.

Format:

CYCLIC3 CYCD,KVAL,KAA,MAA,BAA,K4AA/
KKK,MKK,BKK,K4KK,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $

Input Data Blocks:

CYCD Table of constraints in harmonic components

KVAL Table of harmonic indices for analysis

KAA Stiffness matrix in a-set or d-set

MAA Mass matrix in a-set or d-set

BAA Viscous damping matrix in a-set or d-set

K4AA Structural damping matrix in a-set or d-set

Output Data Blocks:

KKK Stiffness matrix in cyclic components

MKK Mass matrix in cyclic components

BKK Viscous damping matrix in cyclic components

K4KK Structural damping matrix in cyclic components

GC Transformations matrix between symmetric (cosine) components and solution set


components

9-64 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

GS Transformation matrix between symmetric (sine) components and solution set


components

PVEC Partitioning vector for supported degrees-of-freedom specified on CYSUP Bulk


Data entry

Parameters:

HINDEX Input-integer-no default. Harmonic index.

NSEG Input-integer-no default. Number of segments.

NOKVAL Output-integer-no default. Set to -1 if the value of HINDEX is not in the analysis
set of harmonic IDs.

KGTH Output-integer-no default. Set to -1 if all harmonic IDs (in analysis set) have
been processed.

REACT Output-integer-no default. Set to -1 if no support degrees-of- freedom; +1 if


support degrees of freedom exist; for k > 2, it 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 KDAA,/KDAAM/-1. $
CYCLIC3 CYCD,TKVAL,KAA,KDAAM,,/
KKK,MKK,,,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $

2. CYCLIC3 can also accommodate the p-set:


CYCLIC3 CYCD,KVAL,KDD,MDD,BDD,K4DD/
KKK,MKK,BKK,K4KK,GC,GS,PVEC/
HINDEX/NSEG/S,N,NOKVAL/S,N,KGTH/S,N,REACT $

3. PVEC is formed in normal modes and static analysis if support degrees-of-freedom are
specified on the CYCSUP Bulk Data entry. PVEC is used to partition the solution set (cyclic
degrees-of-freedom) into l-set and r-set degrees-of- freedom for the zero-th and first harmonics.
PVEC has rows equal to the number of columns in the GC matrix.

9.49 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.

DMAP Programmer's Guide 9-65


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:

CYCLIC4

Input Data Blocks:

HARM Table of Case Control command images.

GC Transformations matrix between symmetric (cosine) components and solution set


components

GS Transformation matrix between symmetric (sine) components and solution set


components

PAC Static loads matrix in harmonic components

PHK Eigenvectors in solution set components

UK Solution vector in solution set components

LAMA Eigenvalue summary table for current harmonic. Required for normal modes
analysis only (APP=‘REIG’and PATH=‘BACK‘).

CASEBK Case Control Data Block for output requests. Required for normal modes analysis
only. (APP=‘REIG’and PATH=‘BACK‘).

BACK Backward transformation matrix from cyclic to physical components. Required for
normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘).

Output Data Blocks:

PK Load vector matrix in solution set components

UX Solution vector matrix in cyclic components

PHX Eigenvector matrix in cyclic component.

LAMA1 Appended eigenvalue summary table for all harmonics. Required for normal
modes analysis only. (APP=‘REIG’and PATH=‘BACK‘).

9-66 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

CASEBK1 Case Control table for data recovery requests for all harmonics. Required for
normal modes analysis only. (APP=‘REIG’and PATH=‘BACK‘).

BACK1 Backward transformation matrix from cyclic to physical components for all
harmonics. Required for normal modes analysis only. (APP=‘REIG’and
PATH=‘BACK‘).

Parameters:

PATH Input-character-no default. Direction of cyclic transformation:

‘FORE’ Forward (analysis)

‘BACK’ Backward (data recovery)

HINDEX Input-integer-no default. Harmonic index.

APP Input-character-no default. Analysis type.

‘STAT’ Statics

‘REIG’ Normal modes

‘BUCK’ Buckling

‘FREQ’ Frequency response

NFREQ Input/output-integer-no default. The number of passes through CYCLIC4. NFREQ


is incremented by one on each execution of CYCLIC4.

TOTALK Input-integer-default=0. Total number of harmonics. If TOTALK>0, 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 $

DMAP Programmer's Guide 9-67


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

HINDEX=0 $ QUALIFIER
DO WHILE ( DONE>=0 ) $
IF ( DONE>=0 ) THEN $
IF ( NOKVAL>=0 ) THEN $
.
.
.
CYCLIC4 HARMF,GC,GS,PXF,,,/
PKF,,,/
‘FORE‘/HINDEX/RFNAME/NFREQ $
.
.
.
CYCLIC4 HARMF,GC,GS,UKVF,,,/
UXVF,,,/
‘BACK‘/HINDEX/RFNAME/NFREQ $
ENDIF $ NOKVAL>=0
HINDEX=HINDEX+1
ENDIF $ DONE>=0
ENDDO $ DONE>=0
MPYAD UXVF,BACKF,/UDVF $

3. Normal modes or buckling analysis:


FILE CYPHX=APPEND,SAVE/CYLAMA1=APPEND,SAVE/
CASEBK1=SAVE/BACK1=SAVE,OVRWRT $
PARAML KVALM//‘TRAILER‘/1/S,N,TOTALK $
PARAML KVALM//‘DTI‘/1/TOTALK//S,N,KMAX $
PARAML KVALM//‘IMATCH‘/1/HINDEX//S,N,KVAL $
HINDEX=0 $
DO WHILE ( HINDEX<=KMAX ) $
IF ( KVAL=-1 ) THEN $
.
.
.
CYCLIC4 HARM,GC,GS,CYPHA,CYLAMA,CASEBK,BACK/
CYPHX,CYLAMA1,CASEBK1,BACK1/
‘BACK‘/HINDEX/APPCYC4/S,N,NFREQ/TOTALK $
ENDIF $ KVAL=-1
HINDEX=HINDEX+1 $
PARAML KVALM//‘IMATCH‘/1/HINDEX//S,N,KVAL $
ENDDO $ HINDEX<=KMAX
MPYAD CYPHX,BACK1,/CYPHA1 $

9.50 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 $

9-68 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.)

SEID 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.

DBCPATH Dummy variable parameter to allow the passing of qualifiers from the NX Nastran
database to the DBC database. SEID must be -1.

CP Integer-input/output-default=0. Control parameter. If set to other than zero, an


error occurs in the module and further attempts to execute the module causes a
module return without module execution.

APP Character-input-default is blank. Allowable values of approach code:

STATICS or blank Statics

TRANRESP Linear/nonlinear transient response

FREQRESP Frequency response

REIG Normal modes

NLST Nonlinear statics

BKL1 Buckling

BKL0 Statics in a buckling solution

CEIGEN Complex modes

AERO Aerodynamics

CYCLIC Integer-input-default is 0. If CYCLIC = -1, data is interpreted as cyclic analysis.

GEOMU Integer-input-default=40; the geometric information is output to this FORTRAN


unit.

LOADU Integer-input-default=-1 (LOADU = GEOMU). If LOADU >0, the static load


information is output to this FORTRAN unit.

DMAP Programmer's Guide 9-69


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

POSTU Integer-input-default=-1 (POSTU = GEOMU). If POSTU >0, the data recovery


information is output to this FORTRAN unit.

DBCDIAG 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 Diagnostic Output

0 No diagnostics are printed.

1 Grid relation record

2 Element connection record

4 Internal module begin message

8 Internal module statistics

16 Internal module CPU time and begin message in


performance summary table

32 DBC database dictionary entries

64 Messages for null NASTRAN logical file connections

128 Suppress diagnostics when geometry updates occur

256 Save the grid point stress surface and volume factors

512 Do not save the grid point stress surface and volume
subcase data.

PROGRAM Character-input-default=’XL’. If PROGRAM =’XL’, the DBC database is suitable


for processing in MSC.Patran. If PROGRAM =’GRASP’, the DBC database is
suitable for processing in NX Nastran Access.

OVRWRT 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.

DESITER Integer-input-defaul =0. Design optimization loop identification number.

ADPTINDX 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.

LUSET 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.

9-70 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Remarks:

1. Data block name table:

Generic Name Data Block Stored on Unit Description


(P1-P20) Description
Name

BEPT AEBGPDT — Aerostructural basic grid point definition table

BGPDT BGPDT GEOMU Basic grid point definition table

CASECC CASECC POSTU Table of Case Control command images

CONTAB CONTAB POSTU Table of design constraint attributes

CONTROL AECTRL POSTU Table of aerodynamic model‘s control definition

CSTM CSTM GEOMU Table of coordinate system transformation matrices

CVAL CVAL POSTU Matrix of design constraint values

DBCOPT DBCOPT POSTU Design optimization history table for

DESTAB DESTAB POSTU Table of design variable attributes

DIT DIT GEOMU/POSTU Table of TABLEij Bulk Data entry images

DSCM2 DSCM2 POSTU Normalized design sensitivity coefficient matrix

DYNAMIC DYNAMIC GEOMU Table of Bulk Data entry images related to dynamics

ECT GEOM2 GEOMU Element connectivity table

ELDCT ELDCT POSTU Table of element stress discontinuities

EMAP SEMAP GEOMU Superelement map table

EPT EPT GEOMU Table of Bulk Data entry images related to element
properties

EQEXIN EQEXIN GEOMU Equivalence between external and internal point


identification numbers

EST EST GEOMU Element summary table

FRM — POSTU Matrix of aerodynamic restrained elastic forces

FURM — POSTU Matrix of aerodynamic unrestrained elastic forces

GEOM1 GEOM1 GEOMU Table of Bulk Data entry images related to geometry

GEOM3 GEOM3 LOADU Table of Bulk Data entry images related to static and
thermal loads

GEOM4 GEOM4 GEOMU/LOADU Table of Bulk Data entry images related to constraints,
degree-of-freedom membership and rigid element
connectivity

GPDCT GPDCT POSTU Table of grid point stress discontinuities

DMAP Programmer's Guide 9-71


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Generic Name Data Block Stored on Unit Description


(P1-P20) Description
Name

GPDT GPDT GEOMU Grid point definition table

GPECT GPECT POSTU Grid point element connection table

GPL GPL GEOMU/POSTU External grid/scalar point identification number list

GPS EGPSTR POSTU Table of grid point stresses or strains for


post-processing

HIS HIS POSTU Table of design iteration history

IRM — POSTU Matrix of aerodynamic restrained inertia forces

IURM — POSTU Matrix of aerodynamic unrestrained inertia forces

LAMA LAMA/CLAMA POSTU Real or complex eigenvalue summary table

Generic Name Data Block Stored on Unit Description


(P1-P20) Description
Name

MPT MPT GEOMU Table of Bulk Data entry images related to material
properties

OBJTAB OBJTAB POSTU Design objective table

OEDE ONRGY1 POSTU Table of element energy losses

OEF OEF POSTU Table of element forces in SORT1 or SORT2 format

OEKE ONRGY1 POSTU Table of element kinetic energies

OES OES POSTU Table of element stresses or strains in SORT1 or


SORT2 format

OESC OES1C POSTU Table of composite element stresses or strains in


SORT1 format

OESE ONRGY1 POSTU Table of element strain energies and energy densities

OESNL OESNL1 POSTU Table of nonlinear element stresses in SORT1 format

OGPF OGPFB1 POSTU Table of grid point forces

OL OL POSTU Transient or frequency response output list

OPG OPG POSTU Table of applied loads in SORT1 or SORT2 format

OQG OQG POSTU Table of single or multipoint forces-of-constraint in


SORT1 or SORT2 format

OUG OUG POSTU Table of displacements in SORT1 or SORT2 format

PERROR ERROR1 POSTU Error-estimate table updated for current superelement


or adaptivity loop

9-72 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Generic Name Data Block Stored on Unit Description


(P1-P20) Description
Name

R1MAPR R1MAPR POSTU Table of mapping from original first level (direct)
retained responses

R1TAB R1TAB POSTU Table of first level (direct) (DRESP1 Bulk Data entry)
attributes

R1VAL R1VAL POSTU Matrix of initial values of the retained first level (direct)
responses

R2MAPR R2MAPR POSTU Table of mapping from original second level (synthetic)
retained responses

R2VAL R2VAL POSTU Matrix of initial values of the retained second level
(synthetic) responses

RESP12 RESP12 POSTU Table of second level (synthetic) responses

RM — POSTU Matrix of aerodynamic rigid forces

SCSTM SCSTM GEOMU Table of global transformation matrices for partitioned


superelements

SETS SET GEOMU Table of combined sets

SVF EGPSF POSTU Table of element to grid point interpolation factors

UG — POSTU Matrix of aerodynamic restrained elastic displacements

UUG — POSTU Matrix of aerodynamic unrestrained elastic


displacements

VIEWTB VIEWTB GEOMU/POSTU View information table, contains the relationship


between each p-element and its view-elements and
view-grids

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. Siemens PLM Software 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.

DMAP Programmer's Guide 9-73


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 BGPDT, CSTM, ECT, EMAP, EPT, GPDT, MPT, and SETS

LOADU GEOM3 and GEOM4

POSTU CASECC, GPS, EQEXIN, GEOM1, GPL, LAMA, OEF, OES, OESNL, OGPF,
OESE, OPG, OQG, OUG, OESC, DBCOPT, GPDCT, and ELDCT

5. If PROGRAM =’GRASP’, the converted format of the above data blocks is written only to the
database: GEOMU.

6. Generic data blocks ECT, BGPDT, GPL, and GPDT should be specified simultaneously on
the same DBC statement.

7. Generic names OES and OESC must be specified in separate DBC modules and 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’/

9-74 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

’GEOM1’/’EQEXIN’//////////SEID//S,N,CP/
APP//GEOMU/LOADU/POSTU/DBCDIAG/
PROGRAM/ $

9.51 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.

Format:

Describers:

DATABLK Delete data blocks. datablk-list specifies a list of NDDL-defined data blocks
separated by commas.

PARAM Delete parameters. param-list specifies a list of parameters separated by commas.

where-expr Logical expression that specifies the desired values of colnames described in
Table 2 under the “DBDICT” 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) $

DMAP Programmer's Guide 9-75


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.52 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.

9-76 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

SELECT(colname[- ’col-label’]. . . ),
FORMAT (FWIDTH = w [.d] DWIDTH = w [.d] AWIDTH = a IWIDTH = i,
LWIDTH = k COLSPACE = c VALUE = w,
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.

PARAM Print the parameter table. param-list specifies a list of parameters


separated by commas. If LOCAL is specified, the non-NDDL-defined
parameters are printed.

PROJVERS Print the project-version table.

QUALIFIERS Print the qualifier table.

QUALCURR Print the current values of the qualifiers. SORT is ignored.

DMAP Programmer's Guide 9-77


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

where-expr Logical expression that specifies the desired values of colnames described
below. For example, WHERE(VERSION = 4 AND SEID <> 2 AND SEID
>0) selects all items under version 4 for all values of SEID greater than 0
except 2. See WHERE and CONVERT Clauses for a further description.
The default for VERSION is the current version and PROJECT is the
current project. The default for qual is * which is all qualifier values found
on the database. See Remark 12.

SELECT Specifies a list of column names to be printed. The order of the specified
colnames is printed from left to right. If colname is not specified, all
columns are printed.

colname Column name. Colname specifies a particular attribute of the database


item; such as data block name (NAME), creation date (CDATE), number
of blocks (SIZE), or qualifier name (SEID, SPC, etc.). The allowable
colnames are given in the Remarks.

col-label The label to printed above the column identified by colname. The default
for col-label is the colname. col-label cannot be specified for colnames:
QUALSET, QUALALL, and TRAILER.

FWIDTH = w.d Specifies the default width for single precision real numbers in real and
complex qualifiers. (Integers: w >0 and d>0, Default = 12.5).

DWIDTH = w.d Specifies the default width for double precision real numbers in real and
complex qualifiers. (Integers: w > 0 and d > 0, Default = 17.10).

AWIDTH = a Specifies the default width for character string qualifiers. Character strings
are printed with enclosing single quotation marks, even if the string is
blank. (Integer > 0, Default = 8.)

IWIDTH = i Specifies the default width for integer qualifiers. (Integer > 0, see Remarks
for defaults.)

LWIDTH = k Specifies the default width for logical qualifiers. Logical values are printed
as either “T” for TRUE or “F” for FALSE. (Integer >0, Default = 1.)

COLSPACE = c Specifies the default number of spaces between columns. (Integer > 0,
see Remarks for defaults).

VALUE = w Specifies the default width for parameter values. The values are printed as
character strings with left justification. (Integer>0, Default=40.)

col-width The print width of the data under colname or qual-name. For real numbers,
specify w.d where w is the width of the field and d is the number of digits in
the mantissa. For integers and character strings, specify w where w is the
width of the field. col-width cannot be specified for colnames: QUALSET,
QUALALL, and TRAILER.

9-78 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

SORT Specifies how the rows are sorted. The sort based on ASCII sequence and
is performed in order according to each colname specified in the list. A “D”
following the colname causes the sort to be in descending order. An “A”
following the colname causes the sort to be in ascending order. Colnames
QUALSET, QUALALL, and TRAILER cannot be specified under SORT.
Each colname specified in SORT must be separated by commas.

page-title A title to be printed on each page of the directory output.

RIGHT, CENTER, Print justification of the page title.


LEFT

Remarks:
1. DBDICT prints seven different tables according to a default or user-defined format. The tables are:

Describer Description Default page-title See remark

DATABLK Data blocks described by a NDDL NDDL DATABLOCKS 2


DATABLK statement

PARAM Parameters described by a NDDL NDDL PARAMETERS 3


PARAM statement

QUALCURR Current Qualifiers and their CURRENT QUALIFIERS 4


values

QUALIFIERS Qualifiers and their values for QUALIFIERS 5


each key number

DATABLK(LOCAL) Data blocks not described by a LOCAL DATABLOCKS 6


NDDL DATABLK statement

PARAM(LOCAL) Parameters not described by a LOCAL PARAMETERS 7


NDDL PARAM statement

PROJVERS Project-Version PROJECT-VERSION 8

If DBDICT is specified without any describers, 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 ,

DMAP Programmer's Guide 9-79


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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


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 Default column label Description


width

PROJECT 40 PROJECT NAME Project name defined by PROJECT statement

PROJNO 4 PROJ NO Project number associated with PROJECT

VERSION 4 VERSION Version number

CDATE 6 CDATE Creation Date

CTIME 6 CTIME Creation Time

NAME 8 NAME Parameter name

DATABASE 8 DATABASE MASTER DBset name

DBSET 8 DBSET DBset name

RDATE 6 RDATE Revision Date

RTIME 6 RTIME Revision Time

SIZE 5 SIZE Number of blocks

qual-name See Note qualifier name Qualifier name

KEY 4 KEY Key number

9-80 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Column name Default column Default column label Description


width

TRLi 8 TRLi i-th word in the trailer

TRAILER 8 TRLi All 10 trailer words

EXTNAME 8 EXTNAME Extended name

EQUIVD 4 EQ Equivalenced flag

PURGED 4 PU Purged flag

EQFLAG 4 EF Scratch equivalenced flag

SCRFLAG 4 SF Scratch DBSET flag

POINTER 8 POINTER Directory pointer

DBENTRY 8 DBENTRY Database entry pointer

FEQCHAIN 8 FEQCHAIN Forward equivalence chain

BEQCHAIN 8 BEQCHAIN Backward equivalence chain

DBDIR20 9 DBDIR(20) Directory word 20

QUALALL See Note qualifier name All qualifiers

QUALSET See Note qualifier name Predefined subset of all qualifiers

Note

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:

DMAP Programmer's Guide 9-81


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Default column label Description


width

PROJECT 40 PROJECT NAME Project name defined by PROJECT statement

PROJNO 5 PROJ Project number associated with PROJECT

VERSION 4 VERS Version number

CDATE 6 CDATE Creation Date

CTIME 6 CTIME Creation Time

NAME 8 NAME Parameter name

DATABASE 8 DATABASE MASTER DBset name

DBSET 8 DBSET DBset name

RDATE 6 RDATE Revision Date

RTIME 6 RTIME Revision Time

POINTER 8 POINTER Directory pointer

VALUE 40 VALUE Parameter value

KEY 4 KEY Key number

qual-name See Note qualifier name Qualifier name

QUALALL See Note qualifier name All qualifiers

QUALSET See Note qualifier name Predefined subset of all qualifiers

9-82 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Note

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.
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 Default column width Default column label Description

KEY 5 KEY Key number

qual-name See Note qualifier name Qualifier name

QUALALL See Note qualifier name All qualifiers

QUALSET See Note qualifier name Predefined subset of all qualifiers

DMAP Programmer's Guide 9-83


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Note

Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and


FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.

5. The default print of the current qualifier values table is obtained by:
DBDICT QUALCURR

and is equivalent to:


DBDICT QUALCURR SELECT(QUALALL),
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 Default column label Description


width

qual-name See Note qualifier name Qualifier name

QUALALL See Note qualifier name All qualifiers

QUALSET See Note qualifier name Pre-defined subset of all qualifiers

Note

Default widths for qualifiers are DWIDTH=17.10, IWIDTH=5, LWIDTH=1, and


FWIDTH=12.5. AWIDTH defaults to the length specified on the QUAL statement in the
NDDL sequence.

Note: DBDICT QUALCURR Colnames.

6. The default print of the local data block table is obtained by:
DBDICT DATABLK(LOCAL)

9-84 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Default column label Description


width

NAME 8 NAME Parameter name

SUBDMAP 8 SUBDMAP SubDMAP name

SIZE 8 BLOCKS Number of blocks

EQUIVD 8 EQ Equivalenced flag

PURGED 8 PU Scratch flag

POINTER 8 POINTER Directory pointer

TRLi 8 TRLi i-th word in the trailer

TRAILER 8 TRLi All 10 trailer words

EXTNAME 8 EXTNAME Extended name

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:

DMAP Programmer's Guide 9-85


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Default column label Description


width

NAME 8 NAME Parameter name

SUBDMAP 8 SUBDMAP SubDMAP name

VALUE 40 VALUE Parameter name

8. The default print of Project Version Table is obtained by:


DBDICT PROJVERS

and is equivalent to:


DBDICT PROJVERS ,
SELECT(PROJECT=’PROJECT NAME’,PROJNO,
VERSION ,DELFLG=’DELETED’ ,
CDATE=’CREATION DATE’ CTIME=’CREATION
TIME’) ,
FORMAT(PROJECT=40,PROJ=10,VERS=10,DELFLG=7,
COLSPACE=1 ,CDATE=13,CTIME=13) ,
LABEL(’PROJECT-VERSION’,CENTER)
SORT(PROJNO=A,VERSION=A)

and looks like:

9-86 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Default column label Description


column width

PROJECT 40 PROJECT NAME Project name defined by PROJECT statement

PROJNO 10 PROJ NO Project number associated with PROJECT

VERSION 10 VERSION Version number

DELFLG 7 DELETED Flag indicating whether this project/version has been


deleted by the RESTART NOKEEP or DBCLEAN
statements

CDATE 13 CREATION DATE Creation Date

CTIME 13 CREATION TIME Creation Time

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.

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 = *) $

DMAP Programmer's Guide 9-87


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.53 DBEQUIV
Equivalences (or copies) NDDL data blocks and parameters
Equivalences (or copies) NDDL data blocks and parameters based upon qualifiers in a CONVERT
clause. An optional WHERE can be specified for a more selective equivalence.

Format:

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.

param-list 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.

where-expr 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.

9-88 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

convert-expr Modifies the values for PROJECT, VERSION, DBSET, and qualifiers selected
by the where-expr. The format of convert-expr is:
PROJECT=project-expr;VERSION=version-expr;
DBSET=DBsetname;quali=qual-expri[;...]

For example, CONVERT (SEID=100+SEID; SPC=102).


See WHERE and CONVERT Clauses 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 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
NOOVRWRT 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.

RESTART 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.

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) $

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) $

Note

WILDCARD applies only to qualifiers and not colnames like PROJECT, PROJNO,
VERSION, CDATE, and so on.

DMAP Programmer's Guide 9-89


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.54 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 Integer-input-no default. First qualifier.

Q2 Integer-input-no default. Second qualifier.

FLAG Integer-input-no default. Name flag: 0 means fetch DBi with name DBi. 1 means
drop the first character of DBi before searching the directory.

SUCCESS Integer-output-no default. SUCCESS = -1 means all data blocks were successfully
retrieved. SUCCESS = 0 means otherwise.

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.

9-90 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.55 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.

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 Integer-input-no default. First qualifier of DBi.

Q2 Integer-input-no default. Second qualifier of DBi.

DBi Character-input-no default. Names of data blocks to be deleted

DMAP Programmer's Guide 9-91


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Integer-input-no default. First qualifier of primary data block (DBP).

QP2 Integer-input-no default. Second qualifier of primary data block (DBP).

QS1 Integer-input-no default. First qualifier of secondary data block (DBSi).

QS2 Integer-input-no default. Second qualifier of secondary data block (DBSi). DBP
Character-input-no default. Primary data block name.

DBSi Character-input-no default. Secondary data block names to be equivalenced


to DBP.

4. Data block rename


Rename and/or modify the qualifier values of a data block previously stored with CALL DBSTORE.

Format:

//9/QO1/QO2/QN1/QN2/0/
CALL DBMGR
DBOLD/DBNEW/’ ’/’ ’ $

Input Data Blocks:


None.

Output Data Blocks:


None.

Parameters:

QO1 Integer-input-no default. First qualifier of previously stored data block (DBOLD).

QO2 Integer-input-no default. Second qualifier of previously stored data block (DBOLD).

QN1 Integer-input-no default. First qualifier of new name of data block (DBNEW).

QN2 Integer-input-no default. Second qualifier of new name of data block (DBNEW).

DBOLD Character-input-no default. Name of the previously stored data block.

DBNEW Character-input-no default. New name of the previously stored data block.

9-92 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Integer-input-no default. First qualifier of STRi.

Q2 Integer-input-no default. Second qualifier of STRi.

STRi Character-input-no default. Strings up to 8 characters in length.

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/’ ’/’ ’ $

Parameters:

Q1 Integer-input-no default. First qualifier of DBi.

Q2 Integer-input-no default. Second qualifier of DBi.

PRESi Integer-output-no default. 0 means DBi not present. -1 means DBi present.

DBi Character-input-no default. Character strings or the names of data blocks.

Remarks:
1. All parameters must be specified even if they are not used or the default value is desired. Unused
integer parameters can be set to 0 and unused character parameters to ’ ’ (a string with 5 blanks).

2. If data blocks exist when storing, renaming or equivalencing, 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.56 DBSTATUS
Checks status of up to ten data blocks

DMAP Programmer's Guide 9-93


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Not generated

0 Empty

1 Generated

10 Offline and empty

11 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.57 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.

9-94 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

CALL DBSTORE DB1,DB2,DB3,DB4,DB5/DUMMY/Q1/Q2/DBSET/COND $

Input Data Blocks:

DBi Data blocks to be stored. See Remark 5.

Output Data Blocks:

DUMMY A dummy output data block is required to guarantee that the DBSTORE
subdmap is executed when SYSTEM(109) = 0 (alternatively, see Remark 4).
Otherwise, the output data block name may be left blank.

Parameters:

Q1 Integer-input-no default. First qualifier of DBi.

Q2 Integer-input-no default. Second qualifier of DBi.

DBSET Character-input-no default. The dbset-name to store DBi. The dbset-name must
be padded with blanks to 5 characters in length; for example, ’DBDN ’.

COND 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.

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. Another way to force execution, one without changing the value
of system cell 109 or specifying an output block, is to use an actual parameter for COND, instead
of an integer, together with the S,N prefix (See Example 3). This can be used as an alternative to
specifying a DUMMY output block in non-restart runs where DBSTORE is called.

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.

DMAP Programmer's Guide 9-95


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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,.....
DMI,B,.....
DMI,M,.....
DTI,LAMLST,.....
ENDDATA

3. Store data block B on dbset DB100.


TYPE PARM,,I,N,COND
...
CALL DBSTORE B,,,,//2/2/’DB100’/S,N,COND $

9.58 DBVIEW
Creates a virtual data block (or view) from one or more data blocks

9-96 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

Describers:

view-name Name of the view; 1 through 8 characters in length. The first character must be
alphabetic. The following characters can be used for view-names: A through Z
and 0 through 9.

data-block Name of a data block.

where-expr A logical expression that specifies the desired values of qualifiers, PROJECT,
PROJNO, VERSION, and DBSET. For example, WHERE(VERSION=4 AND
SEID< >2 AND SEID>0) selects all items under version 4 for all values of SEID
greater than 0 except 2. See WHERE and CONVERT Clauses and Remark 6.

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.

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) $

DMAP Programmer's Guide 9-97


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.59 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 Degree-of-freedom set membership table

SIL Scalar index list

EQEXIN Equivalence between external and internal numbers

A A square matrix (real or complex, symmetric or unsymmetric)

PARTVEC Partitioning vector specified when A is a partition of SETNAME. Its rowsize is


indicated by SETNAME. A is the zero-th partition from PARTVEC.

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

Output Data Blocks:

LD Nonstandard lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor.
[LD] also contains [D] for symmetric decomposition.

9-98 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

U 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.

LSEQ Resequencing matrix based on internal resequencing of A.

Parameters:

KSYM Input/output-integer-default=1.

1 Use symmetric decomposition (default).

0 Use unsymmetric decomposition.

-1 Use decomposition consistent with form of [A]. KSYM is reset to 0 or 1


consistent with actual decomposition type.

3 Use symmetric partial decomposition.

CHOLSKY Input-integer-default=0. If KSYM=1 or KSYM=-1 and [A] is symmetric:

1 Use Cholesky decomposition.

0 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.

MAXRATIO Input-real-default=1.E5. See the BAILOUT and ERR parameter.

SETNAME Input-character-default=‘H’. One or two letters indicating the set membership


of [A].

F1 Input-real-default = 0.0. Tolerance for suppressing numbers of small magnitude.


Matrix elements with magnitudes less than F1 are set to zero.

DECOMP Input-integer-default=-1. See the “DECOMP” module.

DEBUG Input-integer-default=-1. See the “DECOMP” module.

THRESH Input-integer-default=-6. See the “DECOMP” module.

MINDIAG Output-real double precision-default=0.0D0. See the “DECOMP” module.

DET Output-complex-default=(0.0,0.0). See the “DECOMP” module.

DMAP Programmer's Guide 9-99


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

POWER Output-integer-default=0. See the “DECOMP” module.

SING Output-integer-default=0. See the “DECOMP” module.

NBRCHG Output-integer-default=0. See the “DECOMP” module.

ERR Output-integer-default=-1. If BAILOUT=-1, this parameter always remains at


zero. If BAILOUT=0 and the factor-to-diagonal ratio is negative or greater than
MAXRATIO, ERR is reset to -1.

LMTROWS Input-integer-default=0. Number of Lagrange Multipliers appended to the A matrix.


These rows are excluded from the internal reordering in the DCMP module.

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. If data blocks USET and SIL are not available, SETNAME could be set as “NONE”
for more efficient method of decomposition without grid compression.

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.
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.

9-100 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.60 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 Degree-of-freedom set membership table for p-set

UD Solution matrix for the d-set. Displacements only in frequency response.


Displacements, velocities, and accelerations in transient response.

PD Dynamic load matrix for the d-set

KDD Stiffness matrix for the d-set

BDD Damping matrix for the d-set

MDD Mass matrix for the d-set

OL Transient response time output list or frequency response frequency output list

LLL Lower triangular factor/diagonal for the l-set

DM Rigid body transformation matrix for the r-set to the l-set

Output Data Blocks:

UD1 Improved solution matrix for the d-set

UE Improved solution matrix for the e-set (extra points)

PD1 Equivalent load vector for mode acceleration computations for the a-set

DMAP Programmer's Guide 9-101


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

APP Input-character-no default. Analysis type.


‘TRAN’: transient response
‘FREQ’: frequency response

NOUE Input-integer-default=-1. The number of extra points.

UNUSED1 Input-integer-default=-1. Unused.

UNUSED2 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}, { }, and {üd} are given explicitly. For frequency response
analysis,

Equation 9-7.

Equation 9-8.

9-102 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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,

DMAP Programmer's Guide 9-103


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Equation 9-15.

Note: If the problem type is transient, {uad} must be merged with { }, and {üd}.

9.61 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 Solution matrix for the h-set. Displacements only in frequency response.
Displacements, velocities, and accelerations in transient response.

KHH Stiffness matrix for the h-set

BHH Damping matrix for the h-set

MHH Mass matrix for the h-set

PHDH Mode shape matrix for (d-set) – (e-set)

OL Transient response time output list or frequency response frequency output list

CONMODS Constraint
modes

YS Enforced motion

EAMACC Equivalent mass attachment modes

EAMVEL Equivalent viscous damping attachment modes

EAMDIS Equivalent structural damping attachment modes

LDATTMOD Load attachment modes

9-104 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.

DMAP Programmer's Guide 9-105


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Velocities and accelerations are still recovered directly from the normal modes responses as:

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

Ω= diagonal matrix of
= m-th natural frequency

m=

c=
(in general, not diagonal)

=
(in general, not diagonal)

9-106 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

If rigid body modes exist, the responses can be calculated by including the rigid body motion term

into equation 9-20,

where = matrix of rigid body modes

= modal displacements of rigid body modes.

9.62 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,UHD/
OUG,OQG,OES,OEF,UNUSED5/
OPTION/NOCOMP/PEXIST/ACOUSTIC/ACOUT/PREFDB/SEID/APP $

Input Data Blocks:

CASECC Table of Case Control command images.

UH Solution matrix for the h-set (modal degrees-of-freedom). Modal displacements


only in frequency response. Modal displacements, velocities, and accelerations
in transient response.

OL Transient response time output list or frequency response frequency output list.

IUG Table of displacements due to unit modal displacement in SORT1 or SORT2


format.

IQG Table of single point forces of constraint due to unit modal displacement in SORT1
or SORT2 format.

IES Table of element stresses or strains due to unit modal displacement in SORT1 or
SORT2 format. For strains, NOCOMP must be set to 3.

IEF Table of element forces due to unit modal displacement in SORT1 or SORT2
format.

XYCDB Table of x-y plotting commands.

IUG1 Table of displacements due to unit modal displacement in SORT1. Required only
for the sparse data recovery in SORT2 format.

DMAP Programmer's Guide 9-107


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

IQG1 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.

IES1 Table of element stresses or strains due to unit modal displacement in SORT1
format. Required only for the sparse data recovery in SORT2 format.

IEF1 Table of element forces due to unit modal displacement in SORT1 format.
Required only for the sparse data recovery in SORT2 format.

UHD Modal velocities solution matrix for the h-set (modal degrees-of-freedom).
Required only for frequency response.

Output Data Blocks:

OUG Table of displacements in SORT1 or SORT2 format

OQG Table of single point forces of constraint SORT1 or SORT2 format

OES Table of element stresses or strains in SORT1 or SORT2 format

OEF Table of element forces in SORT1 or SORT2 format

UNUSED5 Unused and can be purged

Parameters:

OPTION Input-character-default=‘ABS’ Response summation method for scaled response


spectra analysis only. Possible values are:

‘ABS’ Absolute

‘SRSS’ Square root of the sum of the squares

‘NRL’ Naval Research Laboratory (new)

‘NRLO’ Naval Research Laboratory (old)

NOCOMP Input-integer-default=0. Set to 3 if IES is element strains.

PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.

ACOUSTIC Input-integer-default=0. Fluid-structure analysis flag.

0 No fluid elements exist.

1 Penalty or fluid acoustic elements exist.

2 Fluid/structure coupling exists.

ACOUT Input-character-default=‘PEAK’ Type of acoustic pressure output in fluid-structural


analysis.

9-108 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

‘RMS’ Root-mean-square

‘PEAK’ Peak

PREFDB Input-real-default=1.0. Peak pressure reference for pressure level in units of dB


or dBA.

SEID Input-integer-default=0. Superelement identification number. When APP=’DDAM’


this value is an integer 1,2 or 3 to indicate if X,Y or Z results are stored in the
output data blocks.

APP Input-character-default=’ ‘. Analysis type.


For modal complex eigenvalue analysis, set to ‘CEIG’;
for DDAM analysis, set to ‘DDAM’;
otherwise, leave blank.

Remarks:

1. If UH 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.63 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).

DMAP Programmer's Guide 9-109


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Output Data Blocks:

LD Lower triangular factor [L] and diagonal matrix [D] or Cholesky Factor. [LD] also
contains [D] for symmetric decomposition.

U Upper triangular factor or trapezoidal factor for partial decomposition. (See


Remark 4.)

LSEQ Resequencing matrix based on internal resequencing of A.

Parameters:

KSYM Input/output-integer-default=-1.

1 Use standard decomposition.

0 Use unsymmetric decomposition.

-1 Use decomposition consistent with form of [A]. KSYM is reset to 0 or 1


consistent with actual decomposition type (default).

3 Use symmetric partial decomposition. Sparse method is not available with


partial decomposition.

CHOLSKY Input-integer-default=0. If KSYM = 1 or KSYM = -1 and [A] is symmetric:

1 Use Cholesky decomposition.

0 Use standard decomposition (default).

If KSYM = 3, CHOLSKY is set to the number of degrees of freedom in the


o-set.

MINDIAG Output-real double precision-default = 0.0D0. The norm of the minimum diagonal
term of [U].

DET Output-complex single precision-default=(0.0,0.0). The scaled value of the


determinant of [A]. See the POWER parameter. DET is not applicable to sparse
methods. See Remark 1.

POWER Output-integer-default=0. Integer POWER of 10 by which DET should be


multiplied to obtain the determinant of [A]. In other words, the determinant of [A]
is equal to DET*10POWER. POWER is not applicable to sparse methods. See
Remark 1.

SING Output-integer-default=0. SING is set to -1 if [A] is singular. See Remark 3.

NBRCHG Output (for symmetric decomposition only)-integer-default=0. NBRCHG is the


number of negative terms on the diagonal.

MAXRAT Output (for symmetric decomposition only)-real-default=0.0. MAXRAT is the


maximum value of the ratio of the matrix diagonal to the factor diagonal.

9-110 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DECOMP 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 Action

0 or -1 Print up to 50 messages for null columns and zero diagonals


(non-sparse method only).

1 Terminate execution when first null column is encountered.

2 Suppress printing of message when a null column is encountered


(non-sparse method only).

4 Terminate execution when first zero diagonal term is encountered.

8 Suppress printing of message when a zero diagonal term is


encountered (non-sparse method only).

16 Place 1.0 in diagonal position for all null columns and proceed
with the decomposition.

32 Stop the decomposition when zero diagonal terms are


encountered.

64 Exit after execution of preface for symmetric decomposition.

DEBUG Input-integer-default=-1. Passive column logic control. DEBUG is used only by


non-sparse method. See the NX Nastran Numerical Methods User’s Guide and
Remark 8.

THRESH Input-integer-default=-6. Power of 10 defining the pivoting threshold for


unsymmetric decomposition. Row pivoting is done if any value on the factor
diagonal is less than 10THRESH. Siemens PLM Software recommends using
THRESH = -2 for indefinite matrices because accuracy is improved even though
execution time is increased.

Remarks:

1. By default, the DECOMP module uses sparse matrix methods. See the 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.

DMAP Programmer's Guide 9-111


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

0 No action

1 If insufficient core is encountered, switch to conventional decomposition and continue


(default)

2 Print diagnostics

4 Do not issue fatal message if maximum ratios are exceeded. The maximum ratios
are replaced by 1.0.

2. Nonstandard triangular factor matrix data blocks are used to improve the efficiency of the back
substitution process in module FBS.

3. if the value of 16 is specified for the DECOMP parameter, 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 Factor type Matrix type

4 Lower triangle Symmetric or unsymmetric

5 Upper triangle Unsymmetric only

10 Cholesky Symmetric only

11 Trapezoidal Symmetric only

13 Lower triangular Sparse symmetric

15 Lower or upper triangular Sparse unsymmetric

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, Siemens PLM Software also recommends
that the SEQP module be used with parameter NEWSEQ = 2.

9-112 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Examples:
1. Solve [A][X] = [B].
DECOMP A/L,U,/ $
FBS L,U,B/X/ $
MATPRN X// $

2. Form [K] = [G]T[A][G]. Then decompose [K] into [L] [L]T assuming that [K] is a symmetric matrix.
SMPYAD G,A,G,,,/K/3////1////6 $
DECOMP K/L,,/ $

3. Calculate using partial decomposition, form [Loo] given the following:


• 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.64 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.

DMAP Programmer's Guide 9-113


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Example:
DELETE /A,B,C,, $

9.65 DIAGONAL
Extracts diagonal from matrix or raises matrix to a power
Extracts the diagonal elements from a matrix, raises each term to a specified power, and outputs a
vector (column matrix) or a rectangular matrix.

Format:

DIAGONAL A/B/OPT/POWER $

Input Data Block:

A OPT ≠ ‘WHOLE’ means A is a square or diagonal matrix (real or complex).


OPT = ’WHOLE’ means A is a rectangular matrix (real or complex).

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.

‘SQUARE’ 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.

’WHOLE’ 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.

’MAGCOL’ Extract the magnitude of the diagonal elements of square matrix


A into vector B and raise the elements to the exponent POWER.

’MAGSQ’ Extract the magnitude of the diagonal elements of square matrix


A into diagonal matrix B and raise the elements to the exponent
POWER.

9-114 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

’CMPCOL’ Extract the diagonal elements of complex square matrix A into


complex vector B.

’CMPSQ’ Extract the diagonal elements of complex square matrix A into


complex diagonal matrix B.

POWER Input-real single precision-default=1. Exponent to which the real part or the
magnitude 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.

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.

6. For OPT='MAGCOL', [B] is a real vector obtained by extracting the magnitude of the diagonal
terms of [A] and raising them to the exponent POWER. For OPT='MAGSQ', [B] is a real diagonal
matrix obtained by extracting the magnitude of the diagonal terms of [A] and raising them to the
exponent POWER. If POWER=0, all nonzero diagonal terms of [A] produce unit terms in [B].
Zero terms in [A] produce zero terms in [B].

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 LOO/LOOD/’COLUMN’/1. $
DIAGONAL KOO/KOOD $
ADD LOOD,KOOD/LOVERK///2 $

DMAP Programmer's Guide 9-115


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

MATMOD LOVERK,,,,/BIGLOVRK,/2////1.E-3 $
ADD LOVERK,BIGLOVRK/DIFF//-1.0 $
MATGPR BGPDT,USET,,DIFF//’H’/’O’ $

2. Obtain the absolute value of a matrix [A]


DIAGONAL A/AA/’WHOLE’ $.

9.66 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 Degree-of-freedom set membership table

SIL Scalar index list

EQEXIN Equivalence between external and internal numbers

SCHUR Local Schur complement matrix in sparse factor format

Unused5 Unused and can be purged

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

Output Data Blocks:

LBB Distributed boundary matrix factor in sparse factor format (contains the local
panels of the fronts).

DSFDSC Distributed boundary matrix factor.

SCHURS Sum of all SCHUR matrices from all processors.

Parameters:

HLPMETH Input-integer-default=1. Processing option.

>0 Summation ONLY.

9-116 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

=0 Complete boundary decomposition (default).

Unused2 Input-integer-default=0. Unused and can be left unspecified.

Unused3 Input-integer-default=0. Unused and can be left unspecified.

Unused4 Input-real-default=1.E5. Unused and can be left unspecified.

Unused5 Input-character-default=‘H’ Unused and can be left unspecified.

Unused6 Input-real-default=0.0. Unused and can be left unspecified.

Unused7 Input-integer-default=-1. Unused and can be left unspecified.

Unused8 Input-integer-default=-1. Unused and can be left unspecified.

Unused9 Input-integer-default=-6. Unused and can be left unspecified.

Unused10 Input-real double precision-default=0.D0. Unused and can be left unspecified.

Unused11 Output-complex-default=(0.0,0.0). Unused and can be left unspecified.

Unused12 Input-integer-default=0. Unused and can be left unspecified.

Unused13 Input-integer-default=0. Unused and can be left unspecified.

Unused14 Input-integer-default=0. Unused and can be left unspecified.

Unused15 Input-integer-default=-1. Unused and can be left unspecified.

9.67 DISFBS
Performs distributed forward-backward substitution

Format:

DISFBS LBB,DSFDSC,EQMAP,UABAR/
UA,PABAR,LOO/
HLPMETH $

Input Data Blocks:

LBB Distributed boundary sparse factor matrix (contains the local panels of the fronts)

DSFDSC Table description of boundary sparse factor matrix

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

UABAR Local updated rectangular ("loads") matrix

DMAP Programmer's Guide 9-117


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Output Data Blocks:

UA Global boundary solution for distributed decomposition

PABAR Summed up updated rectangular ("loads") matrix for distributed decomposition

LOO Merged boundary sparse factor matrix for distributed decomposition

Parameters:

HLPMETH Input-integer-default=0. Processing option.

>0 Summation only

0 Complete distributed forward-backward substitution (default)

4 Summation operation and merging of distributed sparse boundary factor


matrix

Remarks:

LBB and DSFDSC can be purged.

9.68 DISOFPM
Collects and merges OFP data blocks
Collects and merges OFP data blocks from the slave processors to the master processor.

Format:

DISOFPM OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,OFP7,OFP8/
OFP1M,OFP2M,OFP3M,OFP4M,OFP5M,OFP6M,OFP7M,OFP8M/
MAXBUFF $

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.

9-118 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.69 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.

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.70 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.

DMAP Programmer's Guide 9-119


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Matrix of initial values of the design variables

DESTAB Table of design variable attributes

CONSBL* Matrix family of constant property values

DPLDXI* Matrix family of coefficients in the property to independent design variable


relationship

XZ Matrix containing the constant portion of the dependent to independent design


variable linking relationship

DXDXI Matrix relating linked and independent design variables

DPLDXT* Matrix family of transpose of DPLDXI.

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

DXDXIT Matrix transponse of DXDXI

PLIST2* Table family of type two properties on DVPREL2 Bulk Data entries

OPTPRMG Table of optimization parameters

R1VALRG Matrix initial values of the retained first level responses

RSP2RG Table of attributes of the retained second level responses

R1TABRG Table of attributes of the retained first level responses

CNTABRG Table of retained constraint attributes

DSCMG Unnormalized design sensitivity matrix

DVPTAB* Table family of attributes of the designed properties by internal property


identification number order

9-120 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

PROPI* Matrix family of initial property values

CONS1T Matrix transpose of relationship between dependent and independent design


variables

OBJTBG Design objective table. Objective attributes with retained response identification
number.

COORDO Updated (optimized) Table of designed coordinate values

CON Matrix of constants that relates design variables and design coordinates.

SHPVEC Matrix of basis vectors – coefficients relating designed grid coordinates and
design variables

DCLDXT Matrix of coefficients in the grid to independent design variable relationship

TABDEQ Table of unique design variable identification numbers

EPTTAB* Table family of designed property attributes

DBMLIB Table of designed beam library data

BCON0 Table of constant terms in the beam section constraint relationship

BCONXI Matrix relating beam library constraints to the independent design variables

BCONXT Matrix transpose of BCONXI

DNODEL Table of designed node list

RR2IDRG Table of retained referenced type two response identification list

RESP3RG Table of retained third level responses in RESP3 tabl

DISTAB Table of discrete optimization value sets

Output Data Blocks:

XO Matrix of final (optimized) values of the design variables

CVALO Matrix of final (optimized) constraint values

R1VALO Matrix of final (optimized) values of the retained first level responses

R2VALO Matrix of final (optimized) values of the second level responses

PROPO Matrix of final (optimized) property values

R3VALO Matrix of final (optimized) values of the third level responses

DMAP Programmer's Guide 9-121


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

OBJIN Input-real-no default. Initial objective value.

OBJOUT Output-real-no default. Final objective value.

PROTYP Input-integer-default=0. Designed property type code.

UNUSEDi Input-integer-default=0. Unused.

Remarks:
None.

9.71 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:

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 $

9-122 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Rectangular matrix which is the local load vector (with local values in local
a-set)

X Solution of the equation [A][X]=[B] which is the local solution matrix (with
global values in local a-set)

R Residual matrix which is local (with local or global values in local a-set)

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

DB Any data block to be broadcast from the master to the slave processors

RESMAX Resultant or maxima matrix

RESMAX0 Resultant or maxima matrix for residual structure

CASECC Table of Case Control command images

HEADCNTL List of integer codes for header print control

UG Displacement matrix in g-set for the current processor (local)

SPCPART Partitioning vector for domain decomposition

GEQMAP Table of grid based local equation map indicating which grid resides on
which processors/partitions for domain decomposition

MATS Any matrix on slave processors

Output Data Blocks:

EPSSE Table of epsilon and external work

UGG Displacement matrix in g-set for all processors (global)

PGG Force matrix in g-set for all processors (global)

DB Any data block to be broadcast from the master to the slave processors

MATM Any matrix on master processor

DMAP Programmer's Guide 9-123


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

NSKIP Input-integer-default=1. Record number in CASECC corresponding to the first


subcase of the current boundary condition.

EPSI Output-integer-default=1. Static solution error ratio flag. Set to -1 if the error
ratio is greater than 1.E-3.

DISMETH Input-integer-default=1. Method.

1 Compute epsilons and external works assuming a-set components


of RUF are local values (which occurs in a direct solution).

2 Compute epsilons and external works assuming a-set components


of RUF are global values (which occurs in a in iterative solution).

3 Broadcast table or matrix from master to slaves.

4 Broadcast VECPLOT resultant output from slaves to master and


combine on master.

5 Broadcast VECPLOT maxima output from slaves to master and


combine on master.

6 Broadcast displacement matrices from slaves to master and merge


into global displacement matrix on master.

7 Broadcast force matrices from slaves to master and add/merge


into global force matrix on master.

8, -8 Broadcast any matrix from slaves to master and add all matrices
on master. Siemens PLM Software recommends DISMETH=8 for
dense matrices and -8 for sparse matrices.

9 Broadcast any matrix from slaves to master and append


columnwise all matrices on master.

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.

9-124 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

5. For DISMETH=8 or 9, MATS and MATM must be in machine precision.

9.72 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 Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk
Data entries.

DYNAMIC Table of Bulk Data entry images related to dynamics. Contains the EIGC Bulk
Data entries.

CASEA A single record (subcase) of CASECC for aerodynamic analysis. Specifies the
DIVERG and CMETHOD command set identification numbers.

EDT Table of Bulk Data entry images related to aerostatic and divergence analysis.

CPHL Complex eigenvector matrix in the l-set

LCPHL Left-handed complex eigenvector matrix in the l-set

Output Data Blocks:

DIVDAT Table of divergence data.

DCPHL Complex eigenvectors associated with the divergence eigenvalues extracted from
the real part of eigenvectors associated with the divergence eigenvalues.

DLCPHL Left-handed complex eigenvectors associated with the divergence eigenvalues


extracted from the real part of left-handed eigenvectors associated with the
divergence eigenvalues.

Parameters:

IMACHNO Input-integer-no default. Mach number multiplied by 1000 and specified as an


integer.

LPRINT Input-logical-default=TRUE. Print flag for divergence analysis.

DMAP Programmer's Guide 9-125


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 DIVDTX=APPEND/PHIDRX=APPEND/PHIDLX=APPEND $
DIVERG CLAMAD,DYNAMICS,CASEA,EDT,PHIR,PHIL/
DIVDAT,PHIDR,PHIDL/
IMACHNO/LPRINT $ OUTPUT DIVERGENCE RESULTS
APPEND DIVDAT, /DIVDTX/2 $ APPEND DIVERGENCE INFORMATION
APPEND PHIDR, /PHIDRX/2 $ APPEND RIGHT EIGENVECTORS
APPEND PHIDL, /PHIDLX/2 $ APPEND LEFT EIGENVECTORS

9.73 DLT2SLT
Generates static loads from the dynamic load values at a given time.

Format:

DLT2SLT DLT,SLT,DIT,EST/NEWSLT/DTIME/CASELOAD/CASEDLOD/S,N,NEWLOAD $

Input Data Blocks:

DLT Dynamic load table

SLT Static load table

DIT Direct input table

EST Element summary table

Output Data Block:

NEWSLT New static load table with values sampled from the time-dependent load at DTIME

Parameters:

DTIME Input-real-no default. Solution time when the values for the new static load
table are sampled

CASELOAD Input-integer-no default. LOAD case control for the subcase. Set to 0, if no
LOAD in the subcase

CASEDLOD Input-integer-no default. DLOAD ID for the subcase

NEWLOAD Output-integer-no default. SID of the equivalent static load in NEWSLT

9-126 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Remarks:
1. If CASELOAD=0 and CASEDLOD=0, there are no mechanical loads in the subcase. For this
situation, NEWLOAD is 0 and NEWSLT will be purged.

2. If CASELOAD=0 and CASEDLOD>0, there is DLOAD in the subcase only. For this situation,
NEWLOAD is 1.

3. If CASELOAD>0 but CASEDLOD=0, there is LOAD in the subcase only.For this situation,
NEWLOAD is the same as CASELOAD and NEWSLT is the same as the input SLT.

9.74 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/NAME1/NAME2 $

Input Data Blocks:

DMI Table of all matrices specified on DMI Bulk Data entries.

DMINDX 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.

NAME1 Input-character-default = “ “. If NAME1 is specified, read the DMI matrix


associated with NAME1 instead of the name DMI1.

NAME2 Input-character-default = “ “. If NAME2 is specified, read the DMI matrix


associated with NAME2 instead of the name DMI2.

Remarks:
1. The input data blocks DMI and DMINDX are output from the preface module IFP.

DMAP Programmer's Guide 9-127


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.75 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/PBRPROP/UNUSED3/UNUSED4/UNUSED5/UNUSED6/
UNUSED7/UNUSED8/UNUSED9/UNUSED10/UNUSED11/UNUSED12 $

Input Data Blocks:

XINIT Matrix of initial values of the design variable

DPLDXI* Family of matrices of coefficients in the property to independent design variable


relationship

CONSBL* Family of matrices of constant property values

R1VALRG Matrix of initial values of the retained first level responses

R2VALRG Matrix of initial values of the retained second level responses

DSCMG Unnormalized design sensitivity matrix

RSP2RG Table of attributes of the retained second level responses

DEQATN Table of DEQATN Bulk Data entry images

PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries

DEQIND Index table to DEQATN data block

DXDXIT Matrix of coefficients in the design variable linking relationship

9-128 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DCLDXT Matrix of coefficients in the grid to design variable relationship

COORD Matrix of initial or final designed coordinate values, COORDO or COORDN

DESTAB Table of design variable attributes

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

TABDEQ Table of unique design variable identification numbers

EPTTAB* Family of tables of designed property attributes

DBMLIB Table of designed beam library data

DPLDXT* Family of matrix transposes of DPLDXI

DNODEL Table of designed and non-designed locations

RR2IDR Table of retained referenced type two response identification list

RSP3RG Table of attributes of the retained third level responses

R3VALRG Matrix of initial values of the retained third level responses

Output Data Blocks:

DSCM2 Normalized design sensitivity coefficient matrix

Parameters:

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

PBRPROP Input-character-default=’NO’. Flag to select the Pilkey method for calculating


PBEAML and PBARL cross section properties.

UNUSEDi Input-integer-default=0. Unused.

9.76 DOM9
Performs the approximate optimization problem

DMAP Programmer's Guide 9-129


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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,CVALRG,DESVUP,
GCMMAI, DSVCSV, XLURNG, XOTSID, CNTBSV,
CVALSV, UVLCIN/
XO,CVALO,R1VALO,R2VALO,PROPO,R3VALO,
GCMMAO, XNRANG, DESVEC, UVLCOT/
OBJIN/S,N,OBJOUT/PROTYP/PROPTN/PBRPROP/
DESMAX/ DESCYCLE/ S,N,FLGINT/
/UNUSED5/UNUSED6/UNUSED7/UNUSED8/UNUSED9/UNUSED10 $

Input Data Blocks:

XINIT Matrix of initial values of the design variable

DESTAB Table of design variable attributes

CONSBL* Family of matrices of constant property values

DPLDXI* Family of matrices of coefficients in the property to independent design variable


relationship

XZ Matrix containing the constant portion of the dependent to independent design


variable linking relationship

DXDXI Matrix relating linked and independent design variables

DPLDXT* Family of matrix transposes of DPLDXI

DEQATN Table of DEQATN Bulk Data entry images. Output by IFP

DEQIND Index table to DEQATN data block. Output by IFP

DXDXIT Matrix transpose of DXDXI

PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries

OPTPRMG Table of optimization parameters

R1VALRG Matrix of initial values of the retained first level responses

RSP2RG Table of attributes of the retained second level responses

R1TABRG Table of attributes of the retained first level responses

CNTABRG Table of retained constraint attributes

9-130 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DSCMG Unnormalized design sensitivity matrix

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

PROPI* Family of matrices of initial property values

CONS1T Matrix transpose of relationship between dependent and independent design


variables

OBJTBG Design objective table. Objective attributes with retained response identification
number

COORDO Updated (optimized) table of designed coordinate values

CON Matrix of constants that relates design variables and design coordinates

SHPVEC Matrix of basis vectors – coefficients relating designed grid coordinates and
design variables

DCLDXT Matrix of coefficients in the grid to independent design variable relationship

TABDEQ Table of unique design variable identification numbers

EPTTAB* Family of tables of designed property attributes

DBMLIB Table of designed beam library data

BCON0 Table of constant terms in the beam section constraint relationship

BCONXI Matrix relating beam library constraints to the independent design variables

BCONXT Matrix transpose of BCONXI

DNODEL Table of designed and non-designed locations

RR2IDR Table of retained referenced type two response identification list

RESP3RG Table of attributes of the retained third level responses

CVALRG The global data block for retained constraint values

DESVUP Updates for design variable bounds based on relevant DV*REL1 data

GCMMAI Currently not active.

DSVCSV Previous best design.

XLURNG Design variables dynamic ranges.

XOTSID Worsened design in this cycle.

CNTBSV Unused

DMAP Programmer's Guide 9-131


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CVALSV Unused

UVLCIN Internally generated blocking constraint vector(s).

Output Data Blocks:

XO Matrix of final (optimized) values of the design variables

CVALO Matrix of final (optimized) constraint values

R1VALO Matrix of final (optimized) values of the retained first level responses

R2VALO Matrix of final (optimized) values of the second level responses

PROPO Matrix of final (optimized) property values

R3VALO Matrix of final (optimized) values of the third level responses

GCMMAO Currently not active.

XNRANG Updated design variables dynamic ranges.

DESVEC Saves entry design as previous best if FLGINT=0.

UVLCOT Internally generated blocking constraint vector(s).

Parameters:

OBJIN Input-real-no default. Initial objective value.

OBJOUT Output-real-no default. Final objective value.

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

PROPTN Input-integer-default=0. In order to support a pre-Version 68 capability, if


PROPTN=-1, an EPT data block which is based on the values and the property to
design variable relations is produced.

PBRPROP Input-character-default=’NO’. Flag to select the Pilkey method for calculating


PBEAML and PBARL cross section properties.

DESMAX Maximum number of design cycles specified.

9-132 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DESCYCLE Current design cycle.

FLGINT Flag for design quality level.

UNUSEDi Input-integer-default=0. Unused.

9.77 DOM10
Prints initial and final results for design optimization
In design optimization, prints the initial and final results for the approximate optimization problem.

Format:

DOM10 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,EDT//
DESCYCLE/DESMAX/OBJIN/OBJOUT/EIGNFREQ/PROTYP/
RESTYP $

Input Data Blocks:

DESTAB Table of design variable attributes

XINIT Matrix of initial values of the design variable

XO Matrix of final (optimized) values of the design variables

CNTABRG Table of retained constraint attributes

CVALRG Matrix of initial constraint values

CVALO Matrix of final (optimized) constraint values.

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

PROPI* Family of matrices of initial property values

PROPO* Family of matrices of final (optimized) property values

R1TABRG Table of attributes of the retained first level responses

R1VALRG Matrix of initial values of the retained first level responses

R1VALO Matrix of final (optimized) values of the retained first level responses

RSP2RG Table of attributes of the retained second level responses

R2VALRG Matrix of initial values of the retained second level responses

DMAP Programmer's Guide 9-133


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

R2VALO Matrix of final values of the second level responses

OPTPRMG Table of optimization parameters

OBJTBG Design objective table. Objective attributes with retained response identification
number.

DRSTBLG Table containing the number of retained responses for each subcase for each
of the response types

TOL1 Transient response time output list truncated by the OTIME Case Control
command

FOL1 Frequency response frequency output list truncated by the OFREQ Case Control
command

FRQRPRG Table containing the number of first level retained responses per response type
and per frequency or time step

DBMLIB Table of designed beam library data

BCON0 Table of constant terms in the beam section constraint relationship

BCONXI Matrix relating beam library constraints to the independent design variables

WMID Table of weight as a function of material identification number

RSP3RG Table of attributes of the retained third level responses

R3VALRG Matrix of initial values of the retained third level responses

R3VALO Matrix of final values of the third level responses

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:

None.

Parameters:

DESCYCLE Input-integer-default=0. Design cycle analysis counter or flag.

-1 Initial execution of DOM10

-2 Final execution of DOM10

>0 Design cycle number

DESMAX Input-integer-default=0. Maximum allowed design optimization iteration number.

9-134 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

OBJIN Input-real-default=0.0. Initial objective value.

OBJOUT Input-real-default=0.0. Final objective value.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

RESTYP Input-integer-default=0. Optimization results flag.

0 Approximate model

1 Exact analysis for fully stessed design optimization

Examples:

Excerpt from subDMAP DESOPT for initial execution:


DBVIEW TOLV=OLI WHERE (SOLAPP=‘MTRAN‘) $
DBVIEW FOLV=OLI WHERE (SOLAPP=‘MFREQ’OR SOLAPP=‘DFREQ‘) $
IF ( DESCYCLE=1
) DOM10 DESTAB,XINIT,,CNTABRG, CVALRG, ,
DVPTAB,PROPI,,R1TABRG,R1VALRG,,
RSP2RG,R2VALRG,,OPTPRMG,OBJTBG,DRSTBLG,
TOLV,FOLV,FRQRPRG,DBMLIB,BCON0,BCONXI,WMIDG//
-1/DESMAX/OBJIN//EIGNFREQ $

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 $

DMAP Programmer's Guide 9-135


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.78 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,
DIT,MFRDEP/
EPTN,COORDN,GEOM1N,GEOM2N,MPTN,DITN/
DESCYCLE/PROTYP $

Input Data Blocks:

EPT Table of Bulk Data entry images related to element properties

EPTTAB* Family of tables of designed property attributes

PROPO* Family of matrices of final (optimized) property values

XO Matrix of final (optimized) values of the design variables

DESTAB Table of design variable attributes

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

DESGID Table of designed grid coordinate attributes

COORDO Table of designed coordinate values

CON Matrix of constants that relates design variables and design coordinates

SHPVEC Matrix of basis vectors – coefficients relating designed grid coordinates and
design variables

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

MPT Table of Bulk Data entry images related to material properties

DMATCK Table of designed material consistency check

DIT Direct input tables containing also TABLEDi bulk data for use herein

MFRDEP Table for frequency dependent properties that can be designed

Output Data Blocks:

EPTN Updated (optimized) EPT

9-136 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

COORDN Updated (optimized) COORDO

GEOM1N Updated (optimized) GEOM1

GEOM2N Updated (optimized) GEOM2

MPTN Updated (optimized) MPT

DITN Direct input tables with modified TABLEDi for updated values of designed
frequency dependent properties

Parameters:

DESCYCLE Input-integer-default=0. Design cycle analysis counter.

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

Remarks:

The DOM11 module performs the following functions:


1. Creates the COORDN data block at the beginning of each iteration and updates property and
shape data blocks EPTN and GEOM1N at the end of each iteration.

2. Writes iteration information to the punch file.

3. Punches updated GRID and DESVAR entries.

Example:

Excerpt from subDMAP PREDOM:


DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,,,
DESGID,COORDO,CON,SHPVEC,,,,,,/
EPTNN,COORDN,JUNKL,,,/0/0 $

Initial:
DOM11 EPT,EPTTAB,PROPI,XINIT,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,,,,,,/
EPTNNX,COORDN,,,,/0 $

Final:
DOM11 EPT,EPTTAB,PROPO,XO,DESTAB,CSTM,BGPDT,
DESGID,COORDO,CON,SHPVEC,GEOM1,,,,,/
EPTN,COORDN,GEOM1N,,,/DESCYCLE $

DMAP Programmer's Guide 9-137


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.79 DOM12
Performs soft and hard convergence checks in design optimization. Outputs updated optimization
data into the punch file, and prints final optimization results. Helps steer the SDO optimization
process.

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,OBJTBG,
ALBULK,AMLIST,DIT,CNTABRG/
HISADD,NEWPRM,DBCOPT,NEWDES,XNTSID/
DESCYCLE/OBJIN/OBJOUT/S,N,CNVFLG/CVTYP/OPTEXIT/
DESMAX/MDTRKFLG/DESPCH/DESPCH1/MODETRAK/
EIGNFREQ/DSAPRT/PROTYP/BADMESH/XYUNIT/FSDCYC/S,N,FLGINT $

Input Data Blocks:

XINIT Matrix of initial values of the design variables

XO Matrix of final (optimized) values of the design variables

CVAL Matrix of constraint values, CVALO or CVALRG

PROPI* Family of matrices of initial property values

PROPO* Family of matrices of final (optimized) property values

OPTPRM Table of optimization parameters

HIS Table of design iteration history

DESTAB Table of design variable attributes

GEOM1N Updated (optimized) Table of Bulk Data entry images related to geometry

COORDO Matrix of designed coordinate values

EDOM Table of Bulk Data entries related to design sensitivity and optimization

MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to the new
mode numbering

EPT Table of Bulk Data entry images related to element properties

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

MPT Table of Bulk Data entry images related to material properties

EPTTAB* Family of tables of designed property attributes

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

9-138 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

XVALP XVAL table from previous iteration

GEOM1P GEOM1 table from previous design iteration

R1TABRG Table of attributes of the retained first level responses

R1VALRG Matrix of initial values of the retained first level responses

RSP2RG Table of attributes of the retained second level responses

R2VALRG Matrix of initial values of the retained second level responses

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

OBJTBG Overall (global) objective function data block

ALBULK Family of data blocks for bulk files for the original analysis/design model as well as
for all auxiliary models, if any

AMLIST List of auxiliary model identification numbers

DIT Direct input tables containing also TABLEDi bulk data for use herein

CNTABRG Global table of retained constraint attributes.

Output Data Blocks:

HISADD Table of design iteration history for current design cycle

NEWPRM Updated table of optimization parameters

DBCOPT Design optimization history table for post-processing

NEWDES Update table of design variable attributes

XNTSID Worsened design that triggers intermediate design stage.

Parameters:

DESCYCLE Input-integer-default=0. Design cycle analysis counter.

OBJIN Input-real-default=0.0. Initial objective value.

OBJOUT Input-real-default=0.0. Final objective value.

CNVFLG Output-integer-default=0. Design optimization convergence flag.

0 No convergence is achieved.

1 Soft convergence is achieved.

DMAP Programmer's Guide 9-139


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

2 Hard convergence is achieved.

CVTYP Input-integer-default=0. Type of convergence test.

1 Soft convergence is to be checked.

2 Hard convergence is to be checked.

3 Final iteration histories are to be printed.

OPTEXIT Input-integer-default=0. Design optimization termination option. See OPTEXIT


description in the NX Nastran Quick Reference Guide.

DESMAX Input-integer-default=0. Maximum allowed design optimization iteration number.

MDTRKFLG Input-integer-default=0. Mode tracking status flag.

0 Mode tracking was successful.

1 Mode tracking was unsuccessful.

DESPCH Input-integer-default=0. Punch control for updated DESVAR, DREPS1 and


GRID Bulk Data entries. See DESPCH description in the NX Nastran Quick
Reference Guide.

DESPCH1 Input-integer-default=6. Punch output type flag.

0 None

1 Designed analysis property entries.

2 All of the entries of the type as long as

at least one property entry is designed for the type.

4 Design model entries.

<>0 For combinations, sum above values.

>0 Indicates large field format.

<0 Indicates small field format.

MODETRAK Input-integer-default=0. Mode tracking request flag.

0 Mode tracking was not requested.

>0 Mode tracking is requested.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

9-140 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DSAPRT Input-logical-default=FALSE. DSAPRT Case Control command print flag.

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist.

2 DVCRELi entries exist.

4 DVMRELi entries exist.

>0 For combinations, add above values.

BADMESH Input-logical-default=FALSE. Bad geometry was detected.

XYUNIT Input-integer-default=0. Fortran unit number to which the DOM12.

FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if


this is a fully stressed design cycle.

FLGINT Flag for design quality level.

9.80 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,DESVUP/
XO,PROPO $

Input Data Blocks:

R1TABRG Table of attributes of the retained first level (direct) responses

CNTABRG Table of retained constraint attributes

DESELM Table of designed elements

DVPTAB* Table family of attributes of the designed properties by internal property


identification number order

CVALRG Matrix of initial constraint values

PROPI Matrix of initial property values

OPTPRMG Table of optimization parameters

DPLDXT* Matrix family of transpose of DPLDXI

DMAP Programmer's Guide 9-141


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CONSBL* Matrix family of constant property values

DESTAB Table of design variable attributes

XINIT Matrix of initial values of the design variables

DPLDXI* Matrix family of coefficients in the property to independent design variable


relationship

PLIST2* Table family of type two properties on DVPREL2 Bulk Data entries

DEQIND Index table to DEQATN data block

DEQATN Table of DEQATN Bulk Data entry images

EPTTAB* Table family of designed property attributes

DBMLIB Table of designed beam library data

XZ Matrix containing the constant portion of the dependent to independent design


variable linking relationship

DXDXI Matrix relating linked and independent design variables

DXDXIT Matrix transpose of DXDXI

DESVUP Updates for design variable bounds based on relevant DV*REL1 data

Output Data Blocks:

XO Matrix of final (optimized) values of the design variables

PROPO Matrix of final (optimized) property values

Remarks:

None

9.81 DOPR1
Preprocesses design variables and designed property values

Format:

DOPR1 EDOM,EPT,DEQATN,DEQIND,GEOM2,MPT,CASEXX,DIT/
DESTAB,XZ,DXDXI,DTB,DVPTAB*,EPTTAB*,CONSBL*,
DPLDXI*,PLIST2*,XINIT,PROPI*,DSCREN,DTOS2J*,
OPTPRM,CONS1T,DBMLIB,BCON0,BCONXI,DMATCK,DISTAB,
CASETM,SPAN23,MFRDEP,DESVUP/
S,N,MODEPT/S,N,MODGEOM2/S,N,MODMPT/DPEPS/
S,N,PROTYP/S,N,DISVAR $

9-142 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Input Data Blocks:

EDOM Table of Bulk Data entries related to design sensitivity and optimization.

EPT Table of Bulk Data entry images related to element properties.

DEQATN Table of DEQATN Bulk Data entry images.

DEQIND Index table to DEQATN data block.

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.

MPT Table of Bulk Data entry images related to material properties.

CASEXX The main case control data block.

DIT Direct input tables containing also TABLEDi bulk data for use herein.

Output Data Blocks:

DESTAB Table of design variable attributes.

XZ Matrix containing the constant portion of the dependent to independent design


variable linking relationship.

DXDXI Matrix relating linked and independent design variables.

DTB Table of constants from the DTABLE Bulk Data entry.

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order.

EPTTAB* Family of tables of designed property attributes.

CONSBL* Family of matrices of constant property values.

DPLDXI* Family of matrices of coefficients in the property to independent design variable


relationship.

PLIST2* Family of tables of type two properties on DVPREL2 Bulk Data entries.

XINIT Matrix of initial values of the design variables.

PROPI* Family of matrices of initial property values.

DSCREN Table of constants from the DSCREEN Bulk Data entry.

DTOS2J* Family of tables identifying independent design variables and property.

OPTPRM Table of optimization parameters.

CONS1T Matrix transpose of relationship between dependent and independent design


variables.

DMAP Programmer's Guide 9-143


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

DBMLIB Table of designed beam library data.

BCON0 Table of constant terms in the beam section constraint relationship.

BCONXI Matrix relating beam library constraints to the independent design variables.

DMATCK Table of designed material consistency check.

DISTAB Table of discrete optimization value sets.

CASETM Superelement frequency set & dynamic load updated CASEXX data block.

SPAN23 Table for DRSPAN related DRESP2 and DRESP3, and referenced DRESP1.

MFRDEP Table for frequency dependent properties that can be designed.

DESVUP Updates for design variable bounds based on relevant DV*REL1 data.

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.

MODGEOM2 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.

MODMPT 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.

DPEPS 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.

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

DISVAR Output-logical-default=FALSE. Discrete optimization variable flag. Set to TRUE


if discrete optimization design variables are specified.

9-144 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

9.82 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 $

Input Data Blocks:

EDOM Table of Bulk Data entries related to design sensitivity and optimization

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

BASVEC Auxiliary displacement matrix

DESTAB Table of design variable attributes

DXDXI Matrix relating linked and independent design variables

XINIT Matrix of initial values of the design variables

CASECC Table of Case Control command images

AMLIST List of auxiliary model identification numbers

DVIDS List of shape variable identification numbers to be used for the boundary dvgrid
option

Output Data Blocks:

DESGID Table of designed grid coordinate attributes

COORDO Matrix of initial designed coordinate values at the beginning of each design cycle

SHPVEC Matrix of basis vectors – coefficients relating designed grid coordinates and
design variables

DCLDXT Matrix of coefficients in the grid to design variable relationship

CON Matrix of constants that relates design variables and design coordinates

DTOS4J Designed grid perturbation vector in basic coordinate system

DESVCP Global shape basis vector matrix with incorporation of DLINK relations with extra
columns for property/dummy variables

DMAP Programmer's Guide 9-145


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CASEP Residual superelement Case Control table for plotting basis vectors

DNODEL Table of designed and non-designed locations

Parameters:

LUSET Input-integer-default=0. The number of degrees-of-freedom in the g-set.

NOUGD Input-integer-default=-1. Flag for external input of auxiliary model displacement


matrix. If NOUGD>0, the matrix exists.

PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.

DVGRDN Input-character-default=‘NO’ Flag for skipping basis vector components


associated with all GRIDNs in DESVCP. If DVGRDN=‘YES‘, 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.83 DOPR3
Preprocesses DCONSTR, DRESP1, DRESP2, and DRESP3 Bulk Data entries per analysis type
and superelement. Creates tables related to the design objective and a Case Control table for
recovering design responses.

9-146 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

DOPR3 CASE,EDOMS,DTB,ECT,EPT,DESTAB,EDT,FRLF,DEQIND,
DEQATN,DESGID,DVPTAB,VIEWTB,OINT,PELSET,DFRFNC,
TSPAN23,DIT,EDOM/
OBJTAB,CONTAB,R1TAB,RESP12,RSP1CT,FRQRSP,CASEDS,
OINTDS,PELSETDS,DESELM,RESP3,TNSPAN23,SPAN1RG,
FRLTMP/
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/PRESENS3 $

Input Data Blocks:

CASE Table of Case Control commands for the current analysis type and superelement.

EDOMS Table of Bulk Data entries related to design sensitivity and optimization for current
superelement.

DTB Table of constants from the DTABLE Bulk Data entry.

ECT Element connectivity table.

EPT Table of Bulk Data entry images related to element properties.

DESTAB Table of design variable attributes.

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

FRLF Complex or real eigenvalue summary table, transient response time output list,
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ. However, with Version 6.0, for frequency response, this is no longer
the same as the previous OL data block, but is now the full data block for the
frequency sets data for the current cycle, together with a header record listing
the frequency sets.

DEQIND Index table to DEQATN.

DEQATN Table of DEQATN Bulk Data entry images.

DESGID Table relating the designed grid coordinates and a reduced basis vector.

DVPTAB Table of attributes of the designed properties by internal property identification


number order. Output by DOPR1.

VIEWTB View information table, contains the relationship between each p-element and its
view-elements and view-grids.

DMAP Programmer's Guide 9-147


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

OINT P-element output control table. Contains OUTPUT Bulk Data entries. Output by
IFP.

PELSET P-element set table, contains SETS DEFINITIONS.

DFRFNC Table of frequency functions records (see bulk data input DTI,DFRFNC).

TSPAN23 Temporary copy of SPAN23, the table for DRSPAN related DRESP2 and
DRESP3, and referenced DRESP1.

DIT Table of TABLEij Bulk Data entry images.

EDOM Global table of Bulk Data entries related to design sensitivity and optimization.

Output Data Blocks:

OBJTAB Design objective table for a given analysis type and superelement. Objective
attributes with retained response identification number.

CONTAB Table of constraint attributes.

R1TAB Table of first level (DRESP1 Bulk Data entry) attributes.

RESP12 Table of second level responses.

RSP1CT Table of the count of type 1 responses per response type per subcase in R1TAB.

FRQRSP Table of the count of type 1 frequency/time responses per response type per
frequency or time step.

CASEDS Case control table for the data recovery of design responses.

OINTDS P-element output control table for constrained elements.

PELSETDS P-element set table for constrained elements.

DESELM Table of designed elements.

RESP3 Table of third level responses.

TNSPAN23 DOPR3 module updated temporary copy of SPAN23, the table for DRSPAN
related DRESP2 and DRESP3, and referenced DRESP1.

SPAN1RG Global table of DRSPAN related DRESP1 information.

FRLTMP A composite FRL data block containing only the relevant records from each
FRL data block in multiple subcase, multiple frequency set, frequency response
analysis, relevant when the PRESENS3 parameter is TRUE. (See the parameter
list.)

9-148 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Parameters:

DMRESD Input-integer-default=-1. Design model flag. If set to -1, the design model is
limited to the residual structure.

DESGLB Output-integer-default=0. DESGLB Case Control command set identification


number.

DESOBJ Output-integer-default=0. DESOBJ Case Control command set identification


number.

R1CNT Input/output-integer-default=0. Counter for type 1 responses in data block R1TAB.

R2CNT Input/output-integer-default=0. Counter for type 2 responses in data block


RESP12.

CNCNT Input/output-integer-default=0. Counter for constraints in CONTAB.

SOLAPP Input-character-no default. Design optimization analysis type.

SEID Input-integer-default=-1. Superelement identification number.

EIGNFREQ Output-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

DSNOKD Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling


design sensitivity analysis. Usually specified as a user parameter.

SHAPES Input-logical-no default. Shape optimization Bulk Data entry presence flag. Must
be TRUE if DVGRID, DVSHAP, or DVBSHAP Bulk Data entries are present.

R3CNT Input/output-integer-default=0. Counter for type 3 responses in the RESP3 table.

PRESENS3 Logical parameter that is TRUE when one or more of FREQ3, FREQ4, or FREQ5
types of bulk data exist.

Remarks:

1. DOPR3 must be executed in two nested DMAP loops based on every analysis type and
superelement. See subDMAP PRESENS for an example.

DMAP Programmer's Guide 9-149


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

2. R1CNT, R2CNT, and CNCNT are accumulations of the number of records in R1TAB, RESP12,
and CONTAB.

9.84 DOPR4
Creates design sensitivity tables for property and/or shape variables

Format:

DOPR4 DTOS2J*,DTOS4J,DESTAB/
TABDEQ,DTOS2K*,DTOS4K/
PROTYP $

Input Data Blocks:

DTOS2J* Family of tables identifying independent design variables and property

DTOS4J Designed grid perturbation vector in basic coordinate system

DESTAB Table of design variable attributes

Output Data Blocks:

TABDEQ Table of unique design variable identification numbers

DTOS2K* 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.

DTOS4K 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.

Parameters:

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

9.85 DOPR5
Updates design sensitivity tables

9-150 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

DOPR5 XINIT,EPTTAB*,PROPI*,DESTAB,DTOS2K*,DTOS4K,
TABDEQ,DELBSH,GEOM4,DESGID,DVPTAB*,DBMLIB/
DTOS2*,DTOS4,DELBSX,DBMLIBU/
STPSCL/S,N,RGSENS/PROTYP $

Input Data Blocks:

XINIT Matrix of initial values of the design variables

EPTTAB* Family of tables of designed property attributes

PROPI* Family of matrices of initial property values

DESTAB Table of design variable attributes

DTOS2K* Family of tables. 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.

DTOS4K 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.

TABDEQ Table of unique design variable identification numbers

DELBSH Matrix of finite difference shape step sizes

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

DESGID Table of designed grid coordinate attributes

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

DBMLIB Table of designed beam library data

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.

DTOS4 Same as DTOS4K except that the last three words in each entry contain the
product of those in DTOS4K and the shape step size.

DELBSX Updated DELBSH, where the numerical zero terms are replaced by a prescribed
small value.

DBMLIBU Modified DBMLIB data block updated for current values of designed
PBARL/PBEAML dimensions.

DMAP Programmer's Guide 9-151


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

STPSCL Input-real-default=1.0. Shape step size scaling factor.

RGSENS Output-logical-default=FALSE. Rigid element sensitivity flag.

PROTYP Input-integer-default=1. Designed property type code.

1 DVPRELi entries exist

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

9.86 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 Table relating design variable to grid perturbation

GPECT Grid point element connection table

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

DESGID Table of designed grid coordinate attributes

EST Element summary table

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs) and
internal baseline MIDs

Output Data Blocks:

DGTAB Table relating DTOS4 records and designed grid data

ESTDVS EST with grid design variable perturbations

9-152 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

TABEVS 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.87 DOPRAN
Preprocess RMS responses in design optimization.

Format:

DYNAMIC,DIT,OL,R1TCSC,BGPDT,CASEMR/
DOPRAN RMSTAB,CFSAB,PPVR/
LUSET $

Input Data Blocks:

DYNAMIC Table of Bulk Data entry images related to dynamics, specifically RANDPS

DIT Table of TABLEij Bulk Data entry images, specifically TABRND1

OL Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list

R1TCSC Table of first level (direct) (DRESP1 Bulk Data entry) attributes. When multiple
batches of frequency response subcases with different boundary conditions and/or
frequency sets exist, then R1TCSC is per such subcase batch.

BGPDT Basic grid point definition table

DMAP Programmer's Guide 9-153


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CASEMR Table of Case Control commands for the current analysis type and superelement.
When multiple batches of frequency response subcases with different boundary
conditions and/or frequency sets exist, then CASEMR is per such subcase batch.

Output Data Blocks:

RMSTAB Table of RMS responses

CFSAB Matrix of spectral densities – weighting factors for RMS calculations

PPVR Partitioning vector for random responses

Parameters:

LUSET Input-integer-default=-1. The number of degrees-of-freedom in the g-set.

Remarks:
None.

9.88 DPD
Creates tables from Bulk Data entry images specified for dynamic analysis.

Format:

DPD DYNAMIC,GPL,SIL,USET,CASECC,PG,PKYG,PBYG,PMYG,YG,SLT,GEOM4/
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.

GPL External grid/scalar point identification number list.

SIL Scalar index list.

USET Degree-of-freedom set membership table for g-set.

CASECC Table of case control command images.

PG Static load matrix for the g-set.

PKYG Matrix of equivalent static loads due to enforced displacement for the g-set.

PBYG Matrix of equivalent static loads due to enforced velocity for the g-set.

9-154 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

PMYG Matrix of equivalent static loads due to enforced acceleration for the g-set.

YG Matrix of enforced displacements or temperatures for the g-set.

SLT Table of static loads SLT.

GEOM4 Table of bulk data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity.

Output Data Blocks:

GPLD External grid/scalar/extra point identification number list. (GPL appended with
extra point data.)

SILD Scalar index list for p-set. (SIL appended with extra point data.)

USETD Degree-of-freedom set membership table for p-set. (USET appended with
extra point data.)

TFPOOL Table of TF Bulk Data entry images.

DLT Table of dynamic loads.

PSDL Power spectral density list.

RCROSSL Table of RCROSS Bulk Data entry images.

NLFT Nonlinear Forcing function table.

TRL Transient response list.

EED Table of eigenvalue extraction parameters.

EQDYN Equivalence table between external and internal grid/scalar/extra point


identification numbers. (EQEXIN appended with extra point data.)

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

LUSETD Output-integer-no default. The number of degrees-of-freedom in the p-set.

NOTFL Output-integer-no default. The number of transfer function Bulk Data entries.
Set to -1 if no sets are defined.

NODLT Output-integer-no default. Set to 1 if dynamics loads Bulk Data entries are
processed, -1 otherwise. 1 also means that DLT is created.

NOPSDL Output-integer-no default. Set to 1 if random analysis Bulk Data entries are
processed, -1 otherwise. 1 also means that PSDL is created.

DMAP Programmer's Guide 9-155


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

DATAREC 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.

UNUSED6 Input-integer-default=0. Unused.

NONLFT Output-integer-no default. Set to 1 if nonlinear forcing function Bulk Data


entries are processed, -1 otherwise. 1 also means that PSDL is created.

NOTRL Output-integer-no default. Set to 1 if transient time step parameter Bulk Data
entries are processed, -1 otherwise. 1 also means that TRL is created.

NOEED Output-integer-no default. Set to 1 if eigenvalue extraction Bulk Data entries


are processed, -1 otherwise. 1 also means that EED is created.

UNUSED10 Input-integer-no default. Unused.

NOUE Output-integer-no default. Number of extra points. Set to -1 if there are no


extra points.

UNUSED12 Input-integer-default=0. Unused.

SEID Input-integer-default=0. Superelement identification number.

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.89 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.

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

9-156 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Output Data Blocks:

TOFPi Directory table for MOFPi

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.

NULLROW Input-integer-default=1. Flag to insert null rows in the output matrices for
nonlinear quantities. See Remark 1.
0: Insert null rows. Compatible with DRMS1 output format
1: Do not insert null rows. Required for DRMH3 processing

TRL5Ti Output-integer-default=0. Specifies value for the fifth word in TOFPi‘s trailer.

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,,,,,, $
ADD5 MES,,,,/MES2/2. $
DRMH3 TES,MES2,,,,,,,OL2,CASEDR/OES12,,,/APP1 $
OFP OES12/ $
CEND

9.90 DRMH2
Creates partitioning vector to properly align external superelement OTMs with system solution.

DMAP Programmer's Guide 9-157


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:

DRMH2 BGPDTS,USET/PARTV/S,N,NOPARTV $

Input Data Blocks:

BGPDTS Basic grid point definitions table for external superelement.

USET DOF set definition table for external superelements.

Output Data Blocks:

PARTV Partitioning vector.

Parameters:

NOPARTV Input-integer-no default. Partitioning vector existence flag.


-1 = PARTV not created; external superelement OTMs are already correct
0 = PARTV created; external superelement OTMs need to be realigned

Remarks:

1. All data blocks are required.

Example:

Partition displacements OTM.


DRMH2 BGPDTS,USET/PARTV/S,N,NOPARTV $
IF (NOPARTV>-1) THEN $
FILE MUG1X=APPEND $
PARTN MUG1,PARTV,/MUG1G,,MUG1S,/1 $
APPEND MUG1G,MUG1S/MUG1X $
ELSE $
EQUIVX MUG1/MUG1X/ALWAYS $
ENDIF $

In the example, MUG1X is then used in the call to DRMH3.

9.91 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.

9-158 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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 Directory table for MOFPi

MOFPi Matrix form of the i-th output table

OL Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list. Output by FRLG, TRLG, CEAD, and
READ. May also be output by MODACC, if truncated via the OFREQ and OTIME
Case Control commands.

CASECC Table of Case Control command images

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

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:

DMAP Programmer's Guide 9-159


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.92 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 Directory table for MOFPi.

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 will
be 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.

9-160 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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
– Identification 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.93 DSABO
Incorporates element property design variable perturbations
Incorporates element property design variable perturbations into tables required for stiffness, mass,
damping, and load generation.

Format:

DSABO ECT,EPT,EST,DTOS2*,ETT,DIT,MPT,DMATCK,PCOMPT,
DBMLIBU/
ESTDVP,MPTX,EPTX,TABEVP,MIDLIS,ESTDVM,PCOMPTX,
FRQDPV/
S,N,PROPOPT/DELTAB/PROTYP/PEXIST/PBRPROP $

Input Data Blocks:

ECT Element connectivity table

EPT Table of Bulk Data entry images related to element properties

EST Element summary table

DMAP Programmer's Guide 9-161


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

DTOS2* 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.

ETT Element temperature table

DIT Table of TABLEij Bulk Data entry images

MPT Table of Bulk Data entry images related to material properties

DMATCK Table of designed material consistency check

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

DBMLIBU Modified DBMLIB data block updated for current values of designed
PBARL/PBEAML dimensions

Output Data Blocks:

ESTDVP EST with element property design variable perturbations

MPTX MPT with design variable perturbations

EPTX EPT with design variable perturbations

TABEVP Cross-reference table between ESTDVP records and element and design variable
identification numbers

MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs) and
internal baseline MIDs

ESTDVM EST with updated material property identification numbers

PCOMPTX PCOMPT with design variable perturbations

FRQDPV Table of frequencies matching the perturbed elements summary table (ESTDV)
when frequency dependent properties are designed

Parameters:

PROPOPT Output-integer-default=0. Property optimization flag. Set to 1 if element


properties are defined as design variables.

DELTAB Input-real-no default. Relative finite difference move parameter as specified on


the DOPTPRM Bulk Data entry and stored in the OPTPRM data block.

PROTYP Input-integer-default=0. Designed property type code.

1 DVPRELi entries exist

9-162 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

2 DVCRELi entries exist

4 DVMRELi entries exist

>0 For combinations, add above values

PEXIST Input-logical-default=FALSE. P-element flag. Set to TRUE if p-elements are


present.

PBRPROP Input-character-default=’NO’. Flag to select the Pilkey method for calculating


PBEAML and PBARL cross section properties.

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.94 DSAD
Processes tables related to design sensitivity response evaluation, constraint screening and load
case deletion.

DMAP Programmer's Guide 9-163


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:
DSAD RSPCSC,R1TCSC,R12CSC,OBJCSC,CONCSC,
BLAMA,LAMA,CLAMA,DIVTAB,AUXTAB,STBTAB,
FLUTAB,OUG1DS,OES1DS,OSTR1DS,OEF1DS,
OEFITDS,OES1CDS,OSTR1CDS,OQG1DS,DSCREN,
XINIT,COORDN,OL,FRQRSP,CASEER,
CASERS,UGX,OPTPRM,DVPTAB*,PROPI*,
BGPDT,DNODEL,WGTM,ONRGYDS,
GLBTABDS,GLBRSPDS,R3CSC,RMSTAB,RMSVAL,SPAN1RG,
OUGPSD1,DYNAMICS,SABFIL,OERP200,OERPEL0,ERPFIL*/
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,SPANSV,SPANSVG/
WGTS/VOLS/S,N,OBJVAL/S,N,NR1OFFST/S,N,NR2OFFST/
S,N,NCNOFFST/APP/DMRESD/SEID/DESITER/
EIGNFREQ/S,N,ADJFLG/PEXIST/MBCFLG/RGSENS/
PROTYP/AUTOADJ/FSDCYC/S,N,NR3OFFST/INREL $

Input Data Blocks:

RSPCSC Table of the count of type 1 responses per response type per subcase in R1TAB.
Output by DOPR3. When multiple batches of frequency response subcases with
different boundary conditions and/or frequency sets exist, then RSPCSC is per
such subcase batch.

R1TCSC Table of first level (DRESP1 Bulk Data entry) attributes. When multiple batches of
frequency response subcases with different boundary conditions and/or frequency
sets exist, then R1TCSC is per such subcase batch.

R12CSC Table of second level responses. When multiple batches of frequency response
subcases with different boundary conditions and/or frequency sets exist, then
R12CSC is per such subcase batch.

OBJCSC Design objective table for a given analysis type and superelement. Objective
attributes with retained response identification number. When multiple batches of
frequency response subcases with different boundary conditions and/or frequency
sets exist, then OBJCSC is for the appropriate batch.

CONCSC Table of constraint attributes. When multiple batches of frequency response


subcases with different boundary conditions and/or frequency sets exist, then
CONCSC is per such subcase batch.

BLAMA Buckling eigenvalue summary table

LAMA Normal modes eigenvalue summary table

CLAMA Complex eigenvalue summary table

DIVTAB Table of aerostatic divergence data for all subcases

AUXTAB Table of aerodynamic extra point identification numbers, displacements, labels,


type, status, position and hinge moments for all subcases

9-164 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

STBTAB Table of aerostatic stability derivatives for all subcases

FLUTAB Flutter summary table for all subcases

OUG1DS Table of displacements in SORT1 format for design responses

OES1DS Table of element stresses in SORT1 format for design responses

OSTR1DS Table of element strains in SORT1 format for design responses

OEF1DS Table of element forces, excluding non-composite elements, in SORT1 format


for design responses

OEFITDS Table of composite element failure indices for design responses

OES1CDS Table of composite element stresses in SORT1 format for design responses

OSTR1CDS Table of composite element strains in SORT1 format for design responses.

OQG1DS Table of single point forces-of-constraint in SORT1 format for design responses

DSCREN Table of constants from the DSCREEN Bulk Data entry

XINIT Matrix of initial values of the design variables

COORDN Matrix of initial or final designed coordinate values

OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list. Output by FRLG, TRLG, CEAD,
and READ.

FRQRSP Table of the count of type 1 frequency/time responses per response type per
frequency or time step.

CASEER Case Control table for the data recovery of design responses. When multiple
batches of frequency response subcases with different boundary conditions and/or
frequency sets exist, then CASEER is per such subcase batch.

CASERS Case Control table for the data recovery of design responses

UGX Matrix of analysis model displacements in g-set or p-set

OPTPRM Table of optimization parameters

DVPTAB* Family of tables of attributes of the designed properties by internal property


identification number order

PROPI* Family of matrices of initial property values

BGPDT Basic grid point definition table

DNODEL Table of designed and non-designed locations

WGTM Table of 6x6 rigid body mass matrix

DMAP Programmer's Guide 9-165


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

ONRGYDS Table of element strain energies in SORT1 format for design responses

GLBTABDS Global results correlation table

GLBRSPDS Global results matrix

R3CSC Table of third level responses. When multiple batches of frequency response
subcases with different boundary conditions and/or frequency sets exist, then
R3CSC is per such subcase batch.

RMSTAB Table of RMS responses

RMSVAL Matrix of initial RMS values

SPAN1RG Global table of DRSPAN related DRESP1 information.

OUGPSD1 Table of displacements in SORT1 format for the PSD function.

DYNAMICS Table of bulk data entry images related to dynamics for the current superelement.

SABFIL Table of SOL 200 related information regarding the RANDPS data, frequency
responses, and load PSD values associated with constrained PSD responses.

OERP200 Panel ERP design responses.

OERPEL0 Element ERP design responses in SORT1 format.

ERPFIL* Subcase based family of element level ERP design response derivatives.

Output Data Blocks:

R1VAL Matrix of initial values of the retained first level responses

R2VAL Matrix of initial values of the retained second level responses

RSP2R Table of retained second level responses in RESP12

R2VALR Matrix of retained second level responses

CVAL Matrix of constraint values

CVALR Matrix of retained constraint values

OBJTBR Table of design objective attributes with retained response identification number

CNTABR Table of retained constraint attributes

R1TABR Table of retained first level (DRESP1 Bulk Data entry) attributes

R1VALR Matrix of retained type one responses

DRSTBL Table containing the number of retained responses for each subcase for each
of the response types

9-166 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step

UGX1 Copy of UGX matrix with null columns in place of the deleted responses

AUG1 Displacement matrix in g-set for aerostatic analysis

R1MAPR Table of mapping from original first level retained responses

R2MAPR Table of mapping from original second level retained responses

CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcases

CASDSX Case Control table with unneeded analysis subcase deleted

DRDUG Matrix of adjoint loads for the g-set

DRDUTB Table of adjoint load attributes

CASADJ Case Control table associated with adjoint method

LCDVEC Partitioning vector for load case deletion. The row size is the same number of
columns in UGX and ones for columns which are retained in UGX1. LCDVEC is
intended for partitioning of analysis results related to inertia relief and SPCforces.

RR2IDR Table of retained referenced type two response identification list

R3VAL Matrix of initial values of the retained third level responses

R3VALR Matrix of initial values of the retained third level responses

RESP3R Table of retained third level responses in RESP3

RMSTABR Table of retained RMS responses in RMSTAB

RMSVALR Matrix of initial values of the retained RMS responses in RMSVAL

SPANSV Relevant DRSPAN related internal DRESP1 IDs and their values for the current
DSAD call.

SPANSVG Global form of SPANSV, containing information from all DSAD calls in the analysis
types loop.

Parameters:

WGTS Input-real-default=0.0. Total weight of analysis model.

VOLS Input-real-default=0.0. Total volume of analysis model.

OBJVAL Output-real-default=0.0. Objective value.

DMAP Programmer's Guide 9-167


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

NR1OFFST Input/output-integer-default=0. Counter for retained type 1 responses. The


value is initialized to 1 and is incremented by the number of records in R1TABR.

NR2OFFST Input/output-integer-default=0. Counter for retained type 2 responses. The


value is initialized to 1 and is incremented by the number of records in RSP2R.

NCNOFFST 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.

APP Input-character-default=’ ’ Analysis type. Allowable values are:

‘STATICS’: statics=
‘FREQRESP’: frequency response
‘TRANRESP’: transient respsonse

DMRESD Input-integer-default=-1. Design model flag. If set to -1, the design model is
limited to the residual structure.

SEID Input-integer-default=0. Superelement identification number.

DESITER Input-integer-default=0. Design optimization iteration number.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

ADJFLG Output-integer-default=0. Adjoint sensitivity method flag.

0 No adjoint sensitivity

1 Adjoint sensitivity for static analysis

2 Adjoint sensitivity for frequency response analysis

PEXIST Input-logical-default=FALSE. P-element existence flag. Set to TRUE if


p-elements are present.

MBCFLG Input-logical-default=FALSE. Multiple boundary condition in static analysis flag.


Set to TRUE if multiple boundary conditions are specified in static analysis.

RGSENS Input-logical-default=FALSE. Rigid element sensitivity flag.

PROTYP Input-integer-default=0. Designed property type code.

1 1: DVPRELi entries exist

2 2: DVCRELi entries exist

4 4: DVMRELi entries exist

9-168 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

>0 >0: For combinations, add above values

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.

FSDCYC Input-logical-default=FALSE. Fully stressed design cycle flag. Set to TRUE if


this is a fully stressed design cycle.

NR3OFFST Input/output-integer-default=0. Counter for retained type 3 responses. The


value is initialized to 1 and is incremented by the number of records in RESP3R.

INREL Input/output-integer-default=0. Controls the calculation of inertia relief or


enforced acceleration in SOLs 101, 105, and 200. See INREL parameter
definition in the Quick Reference Guide for details.

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.95 DSADJ
Creates sensitivity of grid responses
Creates sensitivity of grid responses with respect to design variables based on the combination of
adjoint and analysis solution matrices and element sensitivity data. Applicable in frequency response
or static analysis only.

Format:

DSADJ XDICTDS,XELMDS,BGPDT,CSTM,XDICTX,XELMX,UGX,ADJG,
DRDUTB,DSPT1,FRQDPV/
ADELX/
NOK4GG/WTMASS/XTYPE/CDIF/COUPMASS/SHAPEOPT $

Input Data Blocks:

XDICTDS Perturbed element matrix dictionary table

XELMDS Table of perturbed element matrices

BGPDT Basic grid point definition table

DMAP Programmer's Guide 9-169


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CSTM Table of coordinate system transformation matrices

XDICTX Baseline element matrix dictionary table or backward perturbed element matrix
dictionary if CDIF=‘YES’

XELMX Baseline element matrices or backward perturbed element matrices if CDIF=‘YES’

UGX Matrix of analysis model displacements in g-set or p-set

ADJG Adjoint sensitivity displacement matrix in the g-set or p-set

DRDUTB Table of adjoint load attributes

DSPT1 Design sensitivity processing table

FRQDPV Table of frequencies matching the perturbed elements summary table (ESTDV)
when frequency dependent properties are designed

Output Data Blocks:

ADELX Matrix of adjoint sensitivities

Parameters:

NOK4GG Input-integer-default=-1. Structural damping generation flag.

-1 Do not generate

0 Generate

WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.

XTYPE Input-integer-default=0. Type of element matrix data:

0 Stiffness

1 Damping

2 Mass

CDIF Input-character-no default. Finite difference scheme.

‘YES’ Central

‘NO’ Forward

COUPMASS Input-integer-default=0. Coupled mass generation flag.

-1 Lumped

0 Coupled

9-170 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

SHAPEOPT Input-integer-default=0. Shape optimization flag. Set to 1 if shape optimization


is activated.

9.96 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 EST with element property design variable perturbations

ESTDVS EST with grid design variable perturbations

TABEVP Cross-reference table between ESTDVP records and element and design variable
identification numbers

TABEVS Cross reference table between ESTDVS records and element and design variable
identification numbers

TABDEQ Table of unique design variable identification numbers

Output Data Blocks:

ESTDV2 Merged EST with grid and element property design variable perturbations

TABEV2 Merged cross reference table of TABEVP and TABEVS

Parameters:
None.

Remarks:
1. TABEV2 is in the ascending alphanumeric EST sort. IVEIDs are assigned to ensure that internal
element 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.

DMAP Programmer's Guide 9-171


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.97 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 Table of retained first level (DRESP1 Bulk Data entry) attributes

EST Element summary table

ESTDV2 Merged element summary table with grid and element property design variable
perturbations

TABEV2 Merged cross reference table of TABEVP and TABEVS

ETT Element temperature table

MIDLIS Table of pairs of user-supplied material property identification numbers (MIDs) and
internal baseline MIDs

KELM Table of element matrices for stiffness, heat conduction, differential stiffness, or
follower stiffness

KDICT KELM dictionary table

PTELEM Table of thermal loads in the elemental coordinate system

KELMDS Table of perturbed element stiffness matrices. If CDIF=‘YES‘, this is the forward
perturbed element matrix dictionary.

KDICTDS Perturbed element stiffness matrix dictionary table. If CDIF=‘YES, this is the
forward perturbed element matrix dictionary.

9-172 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

PTELMDSX Table of thermal loads in the elemental coordinate system for the central, forward,
or backward perturbed configuration.

ECT Element connectivity table

VELEM Table of element lengths, areas, and volumes

VELEMN Table of element lengths, areas, and volumes for the perturbed configuration

Output Data Blocks:

ESTDCN Element summary table which incorporates combined constraints and design
variables

TABECN Table of relationship between internal identification numbers of constraints in


ESTDCN and elements and responses in R1TABR

ETTDCN Table of design variable and constraint internal identification numbers for the
effects of temperature

KELMDCN Table of element matrices for stiffness, heat conduction, differential stiffness, or
follower stiffness which incorporates combined constraints and design variables

KDICTDCN KELM dictionary table which incorporates combined constraints and design
variables

PTELMDCN Table of thermal loads in the elemental coordinate system which incorporates
combined constraints and design variables

VELEMDCN Table of element lengths, areas, and volumes which incorporates combined
constraints and design variables

Parameters:

NDVTOT Input-integer-default=0. Number of unique referenced design variables.

PESE Input-integer-default=0. Element strain energy flag for static analysis.

9.98 DSAH
Generates data blocks required for DSAL module
Generates data blocks required for the DSAL module to compute sensitivities.

DMAP Programmer's Guide 9-173


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Table containing the number of retained responses for each subcase for each of
the response types. Output by DSAD

R1TABR Table of retained first level (DRESP1 Bulk Data entry) attributes

CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcase

TABECN Table of relationship between internal identification numbers of constraints in


ESTDCN and elements and responses in R1TABR

BLAMA* Family of buckling eigenvalue summary tables

LAMA* Family of normal modes eigenvalue summary tables

OL Transient response time output list or frequency response frequency output list

DIVTAB Table of aerostatic divergence data for all subcases

FRQRPR Table containing the number of first level retained responses per response type
and per frequency or time step

VIEWTBDS View information table, contains the relationship between each p-element and its
view-elements and view-grids for the perturbed model

CASERS Case Control table for the residual structure and a given analysis type

CSNMB Case Control table for a given superelement and all analysis types

BUG* Family of buckling eigenvector matrices in the g-set

PHG* Family of normal modes eigenvector matrices in the g-set

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static loads

FRQRMF FRQRPR table for frequency response

DFFDNF Table containing the derivatives of forcing frequencies with respect to natural
frequencies

9-174 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

CASEFREQ Case Control table for modal or direct frequency response analysis and based on
ANALYSIS=MFREQ or DFREQ

Output Data Blocks:

DBUG Buckling eigenvector matrix in the g-set associated with designed (active)
eigenvalues

DPHG Normal modes eigenvector matrix in the g-set associated with designed (active)
eigenvalues

CASEDSF Case Control table for all load cases and all design variables for the perturbed
configuration

LBTAB Table of eigenvalues and generalized masses for retained buckling eigenvalue
responses

BDIAG Diagonal matrix of buckling divided by buckling generalized differential stiffness


matrix

LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses

COGRID Correlation table between idcid/gid component for displacement responses

COELEM Correlation table between idcid/eid/component for element responses

DSEDV Partitioning vector for retained divergence responses

OINTDSF P-element output control table for the perturbed configuration

PELSDSF P-element set table for the perturbed configuration

DGEOM2 Table of Bulk Data entry images related to element connectivity and scalar points
for the perturbed configuration

DGEOM3 Table of Bulk Data entry images related to static loads for the perturbed
configuration

Parameters:

APP Input-character-default=’ ’ Analysis type. Allowable values are:

STATICS’statics
‘FREQRESP’frequency response
‘TRANRESP’transient respsonse

DMRESD Input-integer-default=0. Design model flag. If set to -1, the design model is limited
to the residual structure.

DMAP Programmer's Guide 9-175


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

NDVTOT Input-integer-default=0. Number of unique referenced design variables.

ADJFLG Output-integer-default=-1. Adjoint sensitivity method flag.

0 No adjoint sensitivity

1 Adjoint sensitivity for static analysis

2 Adjoint sensitivity for frequency response analysis

SEID Input-integer-default=0. Superelement identification number.

DSNOKD Input-real-default=0.0. Scale factor on the differential stiffness matrix in buckling


design sensitivity analysis. Usually specified as a user parameter.

NNDFRQ Output-integer-default=0. Number of forcing frequencies which depend upon


natural frequencies.

9.99 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 Table of Bulk Data entries related to design sensitivity and optimization

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

BASVEC0 Auxiliary displacement matrix. Optional user input.

CASECC Table of Case Control command images

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

9-176 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.

DVIDS List of shape variable identification numbers to be used for the boundary DVGRID
option

CASEP Case Control table with number of basis vectors in the DESVEC as the number of
Case Control records

DESVECP Basis vector matrix which consists of basis vectors generated from DVGRID bulk
data entries and from columns of basvec matrix. Its components are expressed in
the global coordinate system.

Parameter:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

9.100 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

DELWS Matrix of delta weight for all design variables

DELVS Matrix of delta volume for all design variables

DELB1 Matrix of delta buckling load factor for all design variables

DELF1 Matrix of delta eigenvalue for all design variables

COGRID Correlation table between idcid/gid component for displacement responses

DMAP Programmer's Guide 9-177


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

COELEM Correlation table between idcid/eid/component for element responses

OUGDSN Table of displacements in SORT1 format for design responses for the perturbed
configuration

OESDSN Table of element stresses in SORT1 format for the perturbed configuration

OSTRDSN Table of element strains in SORT1 format for the perturbed configuration

OEFDSN Table of element forces, excluding non-composite elements, in SORT1 format


for the perturbed configuration

OEFITDSN Table of composite element failure indices for the perturbed configuration

OESCDSN Table of composite element stresses in SORT1 format for the perturbed
configuration

OSTRCDSN Table of composite element strains in SORT1 format for the perturbed
configuration

R1VALR Matrix of retained type one responses

OQGDSN Table of single forces-of-constraint in SORT1 format for design responses for
the perturbed configuration

ONRGYDSN Table of element strain energies and energy densities in SORT1 format for
design responses for the perturbed configuration

TABDEQ Table of unique design variable identification numbers

OL Complex or real eigenvalue summary table, transient response time output list
or frequency response frequency output list

DSDIV Matrix of delta divergence speed for all design variables

DELX Matrix of delta trim variable responses for all design variables

DELS Matrix of delta stability derivative responses for all design variables

DELFL Matrix of delta flutter responses for all design variables

DELCE Matrix of delta complex eigenvalue for all design variables

FRQRPR Table containing the number of first level retained responses per response
type and per frequency or time step

DELBSH Matrix of finite difference shape step sizes

DRDUTB Table of adjoint load attributes

ADELX Matrix of adjoint sensitivities

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes

9-178 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DRMSVL Table of the RMS response values with respect to the design variables

Output Data Blocks:

DSCM Design sensitivity coefficient matrix

Parameters:

NDVTOT Input-integer-no default. Number of unique referenced design variables.

DELTAB Input-real-no default. Relative finite difference move parameter as specified on


the DOPTPRM Bulk Data entry and stored in the OPTPRM data block.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

ADJFLG Input-integer-default=0. Adjoint sensitivity method flag.

0 No adjoint sensitivity

1 Adjoint sensitivity for static analysis

2 Adjoint sensitivity for frequency response analysis

SEID Input-integer-default=0. Superelement identification number.

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.101 DSAM
Creates geometry for backward and forward (or central) perturbation

Format:

DSAM DTOS4,DGTAB,BGPDT/
BGPDVP,BGPDVB/
S,N,SHAPEOPT/CDIF $

DMAP Programmer's Guide 9-179


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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.

DGTAB Table relating DTOS4 records and designed grid data. Correlation table of internal
grid sequence for the baseline and perturbed configuration.

Output Data Blocks:

BGPDVP Basic grid point definition table for the forward (or central) perturbed configuration

BGPDVB Basic grid point definition table for the backward perturbed configuration

Parameters:

SHAPEOPT Output-integer-default=0. Shape optimization flag. Set to 1 if shape design


variables are defined.

CDIF Input-character-no default. Finite difference scheme.

‘YES’ Central

‘NO’ Forward

9.102 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

ETT Element temperature table

Output Data Blocks:

DSPT1 Design sensitivity processing table.

9-180 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

ETTDV Element temperature table where the original element identification numbers have
been converted to new design variable identification numbers

Parameters:

None.

9.103 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 $

Input Data Blocks:

MUX Matrix of mass multiplied by displacements or eigenvectors

BUX Matrix of damping multiplied by displacement or eigenvectors

DMAP Programmer's Guide 9-181


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

KUX Matrix of stiffness multiplied by displacement or eigenvectors

OL Complex or real eigenvalue summary table, or frequency response frequency


output list

DSPT1 Design sensitivity processing table. See Remarks.

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.104 DSAPRT
Prints the normalized design sensitivity coefficient matrix
Prints the normalized design sensitivity coefficient matrix according to the DSAPRT Case Control
command request.

Format:

DSAPRT CASECC,DESTAB,DSCMCOL,DSCM2,R1VALRG,R2VALRG,R3VALRG,
DSIDLBL//
DSZERO/EIGNFREQ/XYUNIT/DESCYCLE $

9-182 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Input Data Blocks:

CASECC Table of Case Control command images

DESTAB Table of design variable attributes

DSCMCOL Correlation table for normalized design sensitivity coefficient matrix

DSCM2 Normalized design sensitivity coefficient matrix

R1VALRG Matrix of initial values of the retained first level (direct) responses

R2VALRG Matrix of initial values of the retained second level (synthetic) responses

R3VALRG Matrix of initial values of the retained third level responses

DSIDLBL Table of design response labels

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.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

XYUNIT Input-integer-default=0. Fortran unit number to which the DOM12 module writes
design optimization x-y plot data.

DESCYCLE Input-integer-default=0. Design cycle analysis counter.

9.105 DSAR
Extracts and truncates data from the transient solution matrix
Extracts and truncates the displacement, velocity, acceleration, and dynamic loads from the transient
solution matrix into separate matrices.

Format:

DSAR UXT,TOL,TOL1,PXT/
UDISP,UVELO,UACCE,UXT1,PXT1/
EXTRPL/NDEL $

DMAP Programmer's Guide 9-183


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Input Data Blocks:

UXT Solution matrix from transient response analysis

TOL Transient response time output list consistent with columns in UXT and PXT

TOL1 Reduced transient response time output list. Subset of time steps in TOL and
consistent with columns in outputs

PXT Transient load matrix in the h-set (modal) or d-set for time steps in TOL

Output Data Blocks:

UDISP Reduced displacement solution matrix from transient response analysis

UVELO Reduced velocity solution matrix from transient response analysis

UACCE Reduced acceleration solution matrix from transient response analysis

UXT1 Reduced solution matrix from transient response analysis

PXT1 Reduced transient response load matrix in the h-set (modal) or d-set

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 Not appended

1 From the last time step

2 By extrapolation

NDEL Input-integer-default=3. If NDEL is -1, an unneeded load vector is deleted for the
final time step for each design variable.

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 $

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-184 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

9.106 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 Table containing the number of retained responses for each subcase for each
of the response types

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attribute.

AECTRL Table of aerodynamic model‘s control definition

CASECC Table of Case Control command images

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

Output Data Blocks:

CASEA A single record (subcase) of CASECC for aerodynamic analysis

UXU Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of
unrestrained stability derivatives

UXR Matrix of aerodynamic extra point vectors for use in calculating the sensitivity of
restrained stability derivatives

Parameters:

STFLG Output-integer-no default. Flag to indicate whether the current subcase has
active static response (DISP, STRAIN,STRESS, FORCE, CSTRAIN, CSTRESS,
or CFORCE on the DRESP1 Bulk Data entry). 0 indicates no response, 1
indicates an active response.

TFLG Output-integer-no default. Flag to indicate whether the current subcase has
active trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no
response, 1 indicates an active response.

DMAP Programmer's Guide 9-185


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

SDFLG Output-integer-no default. Flag to indicate whether the current subcase has
active stability derivative response (STABDER on the DRESP1 Bulk Data entry).
0 indicates no response, 1 indicates an active response.

NSKIP Input/output-integer-no default. Trim subcase counter.

LPFLG Input/output-integer-default=0. Flag to indicate whether there is another Case


Control record to process. Set to -1 for the last subcase and Mach number.

MACH Output-real-no default. Mach number.

Q Output-real-no default. Dynamic pressure.

AEQRATIO Output-real-no default. Aeroelastic feedback dynamic pressure ratio.

Remarks:
DSARLP performs a function for static aeroelastic sensitivity analysis that is similar to the AELOOP
module for static aeroelastic analysis.

9.107 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 Table of transfer function data needed for RMS calculations

RMSTAB Table of RMS responses

CFSAB Matrix of spectral densities–weighting factors for RMS calculations

Output Data Blocks:

RMSVAL Matrix of initial RMS values

Parameters:
None.

Remarks:
None.

9-186 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

9.108 DSARMG
Computes gradients of RMS values.
Computes the gradients of the RMS values for random response analysis in design sensitivity.

Format:

DSARMG ADELU, DRDUTB, UPSDT, RMSTBR, CFSAB, RMSVLR/


DRMSVL

Input Data Blocks:

ADELU Matrix of basic response sensitivities from adjoint load method.

DRDUTB Table of adjoint load attributes.

UPSDT Table of transfer function data needed for RMS calculations.

RMSTBR Table of retained RMS responses.

CFSAB Matrix of spectral densities used as weighting factors for RMS.

RMSVLR Matrix of retained RMS values.

Output Data Blocks:

DRMSVL Sensitivities of the RMS responses.

Remark:
DSARMG combines appropriately the sensitivities for the DRESP1 type basic frequency responses,
to arrive at the sensitivities for the RMS type responses.

9.109 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 A single record (subcase) of CASECC for aerodynamic analysis

DMAP Programmer's Guide 9-187


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes

AECTRL Table of aerodynamic model‘s control definition

DUX Matrix of aerodynamic extra point displacements for the perturbed configuration

TR Matrix to transform forces from the support point to the aerodynamic reference
point

AERO Table of control information for aerodynamic analysis

DSTABU Matrix of unrestrained perturbed dimensional stability derivatives

DSTABR Matrix of restrained perturbed dimensional stability derivatives

Output Data Blocks:

DELX1 Matrix of delta trim variable responses for all design variables for a single trim
subcase

DELS1 Matrix of delta stability derivative responses for all design variables for a single
trim subcase

Parameters:

TFLG Input-integer-no default. Flag to indicate whether the current subcase has active
trim responses (TRIM on the DRESP1 Bulk Data entry). 0 indicates no response,
1 indicates an active response.

SDFLG Input-integer-no default. Flag to indicate whether the current subcase has active
stability derivative response (STABDER on the DRESP1 Bulk Data entry). 0
indicates no response, 1 indicates an active response.

Q Input-real-no default. Dynamic pressure.

Remarks:
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.110 DSAW
Calculates delta-weight and/or delta-volume for each design variable

Format:

DSAW DRSTBL,TABEV2,VELEM,VELEMN,R1TABR/
DELVS,WTCRID,WTDSCP/
CFDFLG $

9-188 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Input Data Blocks:

DRSTBL Table containing the number of retained responses for each subcase for each
of the response types

TABEV2 Merged cross reference table of TABEVP and TABEVS

VELEM Table of element lengths, areas, and volumes

VELEMN Table of element lengths, areas, and volumes for the perturbed configuration

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes

Output Data Blocks:

DELVS Matrix of delta volume for all design variables

WTCRID Table of retained weight responses with column and row numbers in rigid mass
matrix

WTDSCP Partitioning vector for weight

Parameter:

CFDFLG Input-integer-default=0. Central finite difference flag. 1 means forward and -1


backward.

9.111 DSDVRG
Computes weighting factors to calculate retained divergence response sensitivities

Format:

DSDVRG DSEDV,DIVTAB,PHIDRLR,PHIDLLR,QLLX/
DELDV $

Input Data Blocks:

DSEDV Partitioning vector for retained divergence responses

DIVTAB Table of aerostatic divergence data for all subcases

PHIDRL Retained right divergence eigenvector responses

PHIDLL Retained left divergence eigenvector responses

QLL Aerodynamic matrix for divergence analysis

DMAP Programmer's Guide 9-189


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Output Data Blocks:

DELDV Matrix of divergence sensitivity

Parameters:

None.

9.112 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:

KHH,BHH,MHH,QHHL,FLUTAB,R1TABR,CASECC,CPHP,LCPHP/
DSFLTE
CPHFL,CPHFR,VTQU/FCSENS $

Input Data Blocks:

KHH Generalized (modal) stiffness matrix

BHH Generalized (modal) damping matrix

MHH Generalized (modal) mass matrix

QHHL Aerodynamic matrix list

FLUTAB Flutter summary table for all subcases

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes

CASECC Table of Case Control command images

CPHP Complex eigenvector matrix in the p-set

LCPHP Left-handed complex eigenvector matrix in the p-set

Output Data Blocks:

CPHFL Left flutter eigenvector - h-set

CPHFR Right flutter eigenvector - h-set

VTQU Table of flutter sensitivity data

9-190 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.113 DSFLTF
Calculates sensitivity of active flutter responses
Format:

DSFLTF VTQU,CDELK,CDELB,CDELM/DELFL/FCSENS $

Input Data Blocks:

CDELK Triple matrix product for flutter stiffness sensitivity

CDELB Triple matrix product for flutter damping sensitivity

CDELM Triple matrix product for flutter mass sensitivity

VTQU Table of flutter sensitivity data

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.114 DSMA
Generates combined design sensitivity/constraint matrix

DMAP Programmer's Guide 9-191


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

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 Old design sensitivity processor table two

DSEGM Old design sensitivity eigenvalue gradient matrix

OUG1DS Table of displacements in SORT1 format for design responses

OES1DS Table of element stresses in SORT1 format for design responses

OEF1DS Table of element forces in SORT1 format for design responses

OES1CDS Table of composite element stresses in SORT1 format for design responses

OEFITDS Table of composite element failure indices for design responses

UNUSED2 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.

9-192 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

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.115 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 $

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 Weight only

2 Volume only

3 Weight and volume

DOBUCK Output-integer-default=0. Buckling constraint flag. Set to >0 if any constraint.

DOMODES Output-integer-default=0. Normal modes constraint flag. Set to >0 if any


constraint.

DOSTAT Output-integer-default=0. Statics constraint flag. Set to >0 if any constraint.

FAILI Output-integer-default=0. Composite failure index constraint flag. Set to >0


if any constraint.

DMAP Programmer's Guide 9-193


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

CSTRES Output-integer-default=0. Composite lamina stress constraint flag. Set to >0


if any constraint.

CSTRN Output-integer-default=0. Composite lamina strain constraint flag. Set to >0


if any constraint.

DOFREQ Output-integer-default=0. Frequency response retained response flag. Set to


>0 if any retained response.

DOCEIG Output-integer-default=0. Complex eigenvalue response retained response flag.


Set to >0 if any retained response.

DOMTRAN Output-integer-default=0. Transient response retained response flag. Set to >0 if


any retained response.

DODIVG Output-integer-default=0. Divergence analysis retained response flag. Set to


>0 if any retained response.

DOSAERO Output-integer-default=0. Aerostatic trim or stability derivative retained response


flag. Set to >0 if any retained response.

DOFLUT Output-integer-default=0. Flutter analysis retained response flag. Set to >0 if


any retained response.

DOANALY Output-integer-default=0. Any analysis retained response flag. Set to >0 if any
retained response.

DOSASTAT Output-integer-default=0. Statics or aerostatic retained response flag. Set to


>0 if any retained response.

ADJFLG Input-integer-default=0. Adjoint sensitivity flag.

0 No adjoint sensitivity

1 Adjoint sensitivity for static analysis

2 Adjoint sensitivity for frequency response analysis

DOFSPCF Output-integer-default=0. Frequency response retained SPCforce response flag.


Set to >0 if any retained response.

DOTSPCF Output-integer-default=0. Transient response retained SPCforce response flag.


Set to >0 if any retained response.

DOWGHT Output-integer-default=0. Weight retained response flag. Set to >0 if any retained
response.

DOESE Output-integer-default=0. Static analysis retained element strain energy response


flag. Set to >0 if any retained response.

DOSSPCF Output-integer-default=0. Static analysis retained SPCforce response flag. Set to


>0 if any retained response.

9-194 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

DORMS 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.116 DSTA
Creates tables for legacy Design Sensitivity Analysis only.
Creates tables related to the design perturbation in legacy Design Sensitivity Analysis only.

Format:

DSTA ECT,EPT,EST,CASECC,EDOM,{UG or LAMA or BLAMA},


CASECCX,ETT,DIT,MPT/
ESTDVP,ESTDCN,CASEDS,ETTDCN,DSPT1,DSPT2,
DSROWL,DSCOLL,ETTDV,MPTC,EPTC/
APP/S,N,NOPRT/S,N,NOSAVE/S,N,NOFORT/NEIG $

Input Data Blocks:

ECT Element connectivity table

EPT Table of Bulk Data entry images related to element properties

EST Element summary table

CASECC Table of Case Control command images. of static loads

EDOM Table of Bulk Data entries related to design sensitivity and optimization

UG Displacement matrix in g-set from static analysis

LAMA Normal modes eigenvalue summary table

BLAMA Buckling eigenvalue summary table

CASECCX Table of Case Control command images used to generate static loads

ETT Element temperature table

DIT Table of TABLEij Bulk Data entry images

MPT Table of Bulk Data entry images related to material properties

Output Data Blocks:

ESTDVP EST with element property design variable perturbations

DMAP Programmer's Guide 9-195


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

ESTDCN Element summary table which incorporates combined constraints and design
variables

CASEDS Case control table for the data recovery of design responses

DSESM Design sensitivity eigenvector selection matrix – Boolean operator to select


eigenvectors which are referenced by constraints (buckling and normal modes
only).

ETTDCN Table of design variable and constraint internal identification numbers for the
effects of temperature

DSPT1 Design sensitivity processing table

DSPT2 Old Design sensitivity processor table two

DSROWL Table of design sensitivity row labels for design sensitivity matrix, DSCMR

DSCOLL Table of design sensitivity column labels for design sensitivity matrix, DSCMR

ETTDV Element temperature table where the original element identification numbers have
been converted to new design variable identification numbers.

MPTC Copy of MPT except MAT8 records are replaced by equivalent MAT2 records

EPTC Copy of EPT except PCOMP records are replaced by equivalent PSHELL records

Parameters:

APP Input-character-default=‘STATICS’ Analysis type. Allowable values are:

‘STATICS’: statics
‘BUCKL’: buckling
‘MODES’: normal modes

NOPRT Output-integer-default=0. Print flag. Set to 1 if PRINT is requested on the legacy


SENSITY Case Control command.

NOSAVE Output-integer-default=-1. Data base store flag. Set to 0 if SAVE is requested on


the legacy SENSITY Case Control command.

NOFORT Output-integer-default=-1. OUTPUT4 flag. Set to 0 if FORT is requested on the


legacy SENSITY Case Control command.

NEIG Input-integer-default=0. Number of eigenvalues to keep.

0 Keep all eigenvalues

>0 Keep first NEIG-th eigenvalues

9-196 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Remarks:

1. ETT, ETTDV, and ETTDC can be purged if no element temperature data exists.

2. DSTA generates the tables necessary to drive other modules that calculate design sensitivity data.
These modules include EMG, SSG1, DSVG1, DSVG2, DSVG3, SDR2, DSMAS and LMATPRT.

9.117 DSTAP2
Creates correlation table for normalized design sensitivity coefficient matrix

Format:

DSTAP2 R1TABRG,RSP2RG,RSP3RG/
DSCMCOL,DSIDLBL/
UNUSED1/UNUSED2/UNUSED3 $

Input Data Blocks:

R1TABRG Table of attributes of the retained first level (direct) responses

RSP2RG Table of attributes of the retained second level (synthetic) responses

RSP3RG Table of attributes of the retained third level responses

Output Data Blocks:

DSCMCOL Correlation table for normalized design sensitivity coefficient matrix

DSIDLBL Table of design response labels

Parameters:

UNUSEDi Input-integer-default=0. Unused.

9.118 DSVG1
Creates pseudo loads or scalar terms required in sensitivity analysis

Format:

DSVG1 XDICTDS,XELMDS,BGPDT,SIL,CSTM,XDICT,XELM,
{UGX or AGX},VG,LAMA,DSPT1,FRQDPV,FRQRPR/
EGX/
NOK4GG/WTMASS/IAPP/DSVGSF/NOPSLG $

DMAP Programmer's Guide 9-197


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Input Data Blocks:

XDICTDS Perturbed element matrix dictionary table. If CDIF=‘YES’, this is the forward or
backward perturbed element matrix dictionary.

XELMDS Table of perturbed element matrices. If CDIF=‘YES’, this is the forward or


backward perturbed element matrices.

BGPDT Basic grid point definition table

SIL Scalar index list

CSTM Table of coordinate system transformation matrices

XDICT Baseline element matrix dictionary table

XELM Baseline element matrices

UGX Displacement matrix in g-set. For transient response analysis, UGX can also
represent velocity or acceleration.

AGX Gravity/thermal load matrix due to volumetric changes for the central, forward,
or backward perturbed configuration

VG Left-handed displacement matrix in g-set. Divergence and flutter analysis only.

LAMA Normal modes or buckling eigenvalue summary table

DSPT1 Design sensitivity processing table

FRQDPV Table of frequencies matching the perturbed elements summary table (ESTDV)
when frequency dependent properties are designed

FRQRPR Table containing the number of first level retained (DRESP1) responses per
response type and per frequency or time step

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 Generate

WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.

IAPP Input-integer-default=1. Analysis type. Allowable values are:

9-198 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

1 Statics, aerostatic, frequency, or transient response

2 Buckling or normal modes

4 Flutter or divergence

DSVGF Input-integer-default=0. Specifies scaling of solution vector by eigenvalue.

0 No scaling

1 Scale

NOPSLG Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load


generation is requested for the current superelement based on the SEDV Case
Control command.

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.119 DSVG1P
Creates pseudo loads or scalar terms for p-elements in design sensitivity analysis

Format:

DSVG1P ESTDVM,ESTDV2,BGPDVP,CSTM,MPTX,DIT,DEQATN,DEQIND,
UGX,LFTAB,DSPT1,GPSNT,ESTDVB/
EGK,EGM/
COUPMASS/K6ROT/ALTSHAPE/WTMASS/NOPSLG/OPTFLG/
UNUSED7 $

Input Data Blocks:

ESTDVM EST with updated material property identification numbers

ESTDV2 Merged EST with grid and element property design variable perturbations. If
CDIF=‘YES,’this is the forward perturbation.

BGPDVP Basic grid point definition table for the forward (or central) perturbed configuration

CSTM Table of coordinate system transformation matrices

MPTX MPT with design variable perturbations

DMAP Programmer's Guide 9-199


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

DIT Table of TABLEij Bulk Data entry images

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

UGX Matrix of analysis model displacements in g-set or p-set

DSPT1 Design sensitivity processing table

LFTAB Table of eigenvalues and generalized masses for retained normal mode
eigenvalue responses

GPSNT Grid point shell normal table

ESTDVB Element summary table for the backward perturbed configuration. Required only if
CDIF=‘YES’

Output Data Blocks:

EGK Pseudo-load (equilibrium variation) matrix in the g-set due to stiffness

EGM Pseudo-load (equilibrium variation) matrix in the g-set due to mass

Parameters:

COUPMASS Input-integer-default=-1. Coupled mass generation flag.

-1 Lumped

0 Coupled

K6ROT Input-real-default=-1.0. Normal rotational stiffness factor for CQUAD4 and


CTRIA3 elements.

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

WTMASS Input-real-default=-1.0. Specifies scale factor on structural mass matrix.

NOPSLG Input-integer-default=0. Pseudo-load generation flag. Set to -1 if no load


generation is requested for the current superelement based on the SEDV Case
Control command.

OPTFLG Input-integer-default=0. DSVG1P application method:

1 Statics

2 Normal modes

3 Acceleration load

9-200 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

UNUSED7 Input-integer-default=0. Unused.

Remarks:
If NOPSLG ≠ 0, a null EGX matrix is generated.

9.120 DSVG2
Generates pseudo-load matrix for equilibrium changes in thermal load
Generates the pseudo-load matrix which reflects equilibrium changes in the thermal load due
to variations in the design variables.

Format:

DSVG2 BGPDVX,CSTM,SIL,KDICTX,CASDSN,PTELEM,
PTELMDSX,{UGX or AGX},DSPT1/
EGTX/
PEXIST/HPFLAG $

Input Data Blocks:

BGPDVX Basic grid point definition table for the central, forward, or backward perturbed
configuration

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

KDICTX Baseline element stiffness matrix dictionary table for h-elements or p-elements

CASDSN Case Control table with unneeded analysis subcase(s) deleted, excluding static
aeroelastic subcases

PTELEM Table of thermal loads in the elemental coordinate system

PTELMDSX Table of thermal loads in the elemental coordinate system for the central, forward,
or backward perturbed configuration

UGX Matrix of analysis model displacements in g-set or p-set

AGX Gravity/thermal load matrix due to volumetric changes for the central, forward,
or backward perturbed configuration

DSPT1 Design sensitivity processing table

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

DMAP Programmer's Guide 9-201


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Parameters:

PEXIST Input-logical-default=FALSE. Set to TRUE if p-elements are present.

HPFLAG Input-integer-default=1. Element type processing flag.

1 h-element

2 p-element

Remarks:

CSTM and BGPDT can be purged.

9.121 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 Displacement matrix in g-set from the analysis

UGDS Displacement matrix in g-set due to pseudo-loads

Output Data Block:

UGDS1 Displacement matrix in g-set for the total variation

Parameters:

None.

9.122 DSVGP4
Generates a perturbed multipoint constraint transformation matrix
Generates a perturbed multipoint constraint transformation matrix for rigid element shape sensitivity
analysis.

9-202 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Format:

DSVGP4 DGTAB,EQEXIN,GEOM4,RMG,GM,USET,CSTM,BPGDVP/
DELTGM,DVSLIS/
LUSET/NDVTOT/S,N,RGSENS/MPCZERO $

Input Data Blocks:

DGTAB Table relating DTOS4 records and designed grid data. Correlation table of internal
grid sequence for the baseline and perturbed configuration.

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

RMG Multipoint constraint equation matrix

GM Multipoint constraint transformation matrix, m-set by n-set

USET Degree-of-freedom set membership table for g-set

CSTM Table of coordinate system transformation matrices

BGPDVP Basic grid point definition table for the forward (or central) perturbed configuration

Output Data Blocks:

DELTGM Multipoint constraint transformation matrix for the perturbed configuration

DVSLIS List of design variables affected by shape variations

Parameters:

LUSET Input-integer-default=0. The number of degrees-of-freedom in the g-set.

NDVTOT Input-integer-default=0. Number of unique referenced design variables.

RGSENS Output-logical-default=FALSE. Rigid element sensitivity flag.

MPCZERO Input-real-default=1.0E–11. Threshold to remove very small numbers in MPC


relations.

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.

DMAP Programmer's Guide 9-203


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.123 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 Matrix with NSMATS number of submatrices

B Submatrix multiplier

C Additive matrix to be added to product of A and B. Used only if IOPT=0 or 2.

DVSLIS List of design variables affected by shape variations

Output Data Block:

D Matrix product

Parameters:

NSMATS Input-integer-default=0. Number of submatrices in A.

T Input-integer-default=0. Ai submatrix transpose flag. Applicable only when


IOPT=0.

0 No transpose of Ai (default)

1 Transpose Ai

IOPT Input-integer-default=0. DSVGP5 method. T is ignored when IOPT>0.

0 Ai * B + Ci (default)

1 B * Ai

2 Same as 0 except diagonal is extracted from Ai * B + Ci and stored as


a column in D.

9-204 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-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.124 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 Collection of tables specified on DTI Bulk Data entries (from IFP)

DTlNDX 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.125 DUMMOD1
Provides dummy module for inclusion of user written subroutines and modules

DMAP Programmer's Guide 9-205


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

Format:

DUMMOD1 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/
ODB1,ODB2,ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $

Input Data Blocks:

IDBi Table or matrix

Output Data Blocks:

ODBi Table or matrix

Parameters:

IPARMi Input/output-integer-default=-1

RPARMi Input/output-real-default=-1.0

CHPARM Input/output-character-default=‘ABCDEFGH’

RDPARM Input/output-real double precision-default=-1.D0

CPARM Input/output-complex-default=(-1.0,-1.0)

CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0)

9.126 DUMMOD2
Provides dummy module for inclusion of user written subroutines and modules

Format:

DUMMOD2 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/ODB1,ODB2,
ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $

Input Data Blocks:

IDBi Table or matrix

Output Data Blocks:

ODBi Table or matrix

9-206 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Parameters:

IPARMi Input/output-integer-default=-1

RPARMi Input/output-real-default=-1.0

CHPARM Input/output-character-default=‘ABCDEFGH’

RDPARM Input/output-real double precision-default=-1.D0

CPARM Input/output-complex-default=(-1.0,-1.0)

CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0)

9.127 DUMMOD3
Provides dummy module for inclusion of user written subroutines and modules

Format:

DUMMOD3 IDB1,IDB2,IDB3,IDB4,IDB5,IDB6,IDB7,IDB8/
ODB1,ODB2,ODB3,ODB4,ODB5,ODB6,ODB7,ODB8/
IPARM1/IPARM2/IPARM3/IPARM4/RPARM1/RPARM2/
CHPARM/RDPARM/CPARM/CDPARM $

Input Data Blocks:

IDBi Table of matrix

Output Data Blocks:

ODBi Table of matrix

Parameters:

IPARMi Input/output-integer-default=-1

RPARMi Input/output-real-default=-1.0

CHPARM Input/output-character-default=‘ABCDEFGH’

RDPARM Input/output-real double precision-default=-1.D0

CPARM Input/output-complex-default=(-1.0,-1.0)

CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0)

DMAP Programmer's Guide 9-207


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.128 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 Input/output-integer-default=-1

RPARMi Input/output-real-default=-1.0

CHPARM Input/output-character-default=‘ABCDEFGH’

RDPARM Input/output-real double precision-default=-1.D0

CPARM Input/output-complex-default=(-1.0,-1.0)

CDPARM Input/output-complex double precision-default=(-1.D0, 1.0D0)

9.129 DVIEWP
Generates view-element and view-grid information for processing p-elements
Generates the view-element and view-grid information for processing p-elements in design sensitivity
analysis.

Format:

DVIEWP CASECC,OINT,PELSET,ESTDCN,TABECN,BGPDVP,CSTM/
VIEWTBDS/
S,N,VUGNEXT/S,N,VUENEXT/VUGJUMP/VUELJUMP/
VUHEXA/VUPENTA/VUTETRA/VUQUAD4/VUTRIA3/VUBEAM/
S,N,VUEXIST $

9-208 DMAP Programmer's Guide


DMAP Module and Statement Descriptions A-D

Input Data Blocks:

CASECC Table of Case Control command images

OINT P-element output control table. Contains OUTPUT and OUTRCV Bulk Data
entries.

PELSET P-element set table, contains SETS DEFINITIONS

ESTDCN Element summary table which incorporates combined constraints and design
variables

TABECN Table of relationship between internal identification numbers of constraints in


ESTDCN and elements and responses in R1TABR

BGPDVP Basic grid point definition table for the forward (or central) perturbed configuration

CSTM Table of coordinate system transformation matrices

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 Input/output-integer-default=0. Starting identification number for next view-grid.

VUENEXT Input/output-integer-default=0. Starting identification number for next


view-element

VUGJUMP Input-integer-default=1000. Delta between view-grid identification numbers.

VUELJUMP Input-integer-default=1000. Delta between view-element identification numbers.

VUHEXA Input-character-default=‘VUHEXA’ Name for VUHEXA element.

VUPENTA Input-character-default=‘VUPENTA’ Name for VUPENTA element.

VUTETRA Input-character-default=‘VUTETRA’ Name for VUTETRA element.

VUQUAD4 Input-character-default=‘VUQUAD4’ Name for VUQUAD4 element.

VUTRIA3 Input-character-default=‘VUTRIA3’ Name for VUTRIA3 element.

VUBEAM Input-character-default=‘VUBEAM’ Name for VUBEAM element.

VUEXIST Output-logical-default=FALSE. View-element flag. Set to TRUE if view-elements


exist.

DMAP Programmer's Guide 9-209


Chapter
Chapter 9: 9: DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions A-D A-D

9.130 DYNREDU
Computes approximate eigenvectors

Format:

DYNREDU LXX,MXX,CASECC,DYNAMIC/
PHZ,MZZ/
NOZSET/NOYSET/EPSMALC/EPSBIG/S,N,NOBSET0/NORSET $

Input Data Blocks:

LXX Lower triangular factor/diagonal of shifted stiffness matrix

MXX Mass matrix in any set. Usually v-set.

CASECC Table of Case Control command images

DYNAMIC Table of Bulk Data entry images related to dynamics

Output Data Blocks:

PHZ Generalized degree-of-freedom transformation matrix

MZZ Generalized mass matrix based on PHZ

Parameters:

NOZSET Input-integer-no default. Number of generalized degrees-of-freedom. Also


number of columns in PHZ.

NOYSET Input-integer-no default. Number of generalized degrees-of-freedom with


non-null columns in PHZ.

EPSMALC Input-real-no default. Small number for tuning.

EPSBIG Input-real-no default. Large number for tuning.

NOBSET0 Output-integer-default=0. Number of null columns in PHZ in front of non-null


columns.

NORSET Input-integer-default=0. Number of degrees-of-freedom in the r-set.

Remarks:

Siemens PLM Software 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-210 DMAP Programmer's Guide


Chapter 10: DMAP Module and Statement Descriptions E-M

10.1 EFFMAS
Computes modal effective mass.
Compute the modal effective mass based on the normal modes.

Format:

EFFMAS CASECC,MAA,PHA,LAMA,USET,BGPDT,UNUSED,CSTM,VGQ,VAFS/
TEMF,EMM,DMA,MEMF,MPFEM,MEM,MEW,MDLIST/
SEID/WTMASS/S,N,CARDNO/SETNAM/IUNIT/S,N,IPLOT/EFOPT/S,N,NORBM/FLUID $

Input Data Blocks:

CASECC Table of Case Control command images

MAA Mass matrix in a-set or g-set

PHA Normal modes eigenvector matrix in the a-set or g-set

LAMA Normal modes eigenvalue summary table

USET Degree-of-freedom set membership table for g-set

BGPDT Basic grid point definition table

UNUSED Unused

CSTM Table of coordinate system transformation matrices

VGQ Partitioning vector which is g-set size and contains values of 1.0 at rows
corresponding to degrees-of-freedom in the q-set

VAFS A-set size partitioning vector of structure and fluid

Output Data Blocks:

TEMF Total effective mass fraction table

EMM Effective mass matrix

MA Rigid body mass matrix for the a-set

MEMF Modal effective mass fraction table

MPFEM Modal participation factors for effective mass

DMAP Programmer's Guide 10-1


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

MEM Modal effective mass matrix

MEW Modal effective weight matrix

MDLIST List of modes for output selected by effective mass fraction

Parameters:

SEID Input-integer-no default. Superelement identification number.

WTMASS Input-real-no default. Scale factor on structural mass matrix. See the NX Nastran
Quick Reference Guide.

CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is incremented


by one for each line written to the punch file and is also written into columns
73-80 of each line.

SETNAM Input-character-default=‘g’. Degree-of-freedom set name.

IUNIT 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.

IPLOT Output-integer-default=0. Set to 1 if PLOT option is requested.

EFOPT Input-integer-default=0. When set to 1, ignores case control parameters and


forces output of all results.

NORBM Output-integer-default=0. Set to 1 if no rigid body mass matrix was produced.

FLUID Input-integer-default=0. When set to 0, calculation is based on structural DOF.


When set to 1, calculation is based on fluid DOF.

10.2 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

10-2 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

GPECT Grid point element connection table

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

GPL External grid/scalar point identification number list

BGPDT Basic grid point definition table

Output Data Blocks:

OELOF1 Table of element oriented forces connected to common grid points in SORT1
format

OELOP1 Table of element-oriented forces oriented along adjacent element edge directions
and summations of these components on equivalent edges in SORT1 format

Parameters:

NOELOF Input-integer-default=0. OELOF1 generation flag.

<0 Do not generate

0 Generate

NOELOP Input-integer-default=0. OELOP1 generation flag.

<0 Do not generate

0 Generate

UNUSED3 Input-integer-default=0. Unused.

10.3 ELTPRT
Prints element summary information.

Format:

ELTPRT ECT,GPECT,BGPDT,NSMEST,EST,CSTM,MPT,DIT,CASECC,EPT/
VELEM/
PROUT/S,N,ERROR/WTMASS $

Input Data Blocks:

ECT Element connectivity table

GPECT Grid point element connection table

DMAP Programmer's Guide 10-3


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

BGPDT Basic grid point definition table

NSMEST Non-structural mass element summary table

EST Element summary table

CSTM Table of coordinate system transformation matrices

MPT Table of Bulk Data entry images related to material properties for ELSUM
command

DIT Table of TABLEij Bulk Data entry images for ELSUM command

CASECC Table of Case Control command images

EPT Table of Bulk Data entry images related to element properties

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.

WTMASS Input-real-default=1.0. Scale factor on structural mass matrix.

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.

10-4 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Data blocks to be included to activate output options

ECT GPECT BGPDT EST CSTM

2. For Options 1 and 2 the output contains the following items.


• Identify all duplicate elements, for example,
10 ROD.
**** 10 BAR.

• 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/ $

10.4 EMA
Assembles global g-set size matrix from elemental matrices.

Format:

EMA GPECT,XDICT,XELM,BGPDT,SIL,CSTM,XDICTP,XELMP,X4ELM,X4DICT/
XGG,UNUSED2/
NOK4GG/WTMASS/S,N,CONGE/NOSHIFT $

DMAP Programmer's Guide 10-5


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

GPECT Grid point element connection table

XDICT Element matrix dictionary table

XELM Table of element matrices

BGPDT Basic grid point definition table

SIL Scalar index list

CSTM Table of coordinate system transformation matrices

XDICTP Element matrix dictionary table for p-elements

XELMP Table of element matrices for p-elements

X4ELM Table of element matrices for structural damping

X4DICT Element matrix dictionary table for structural damping

Output Data Blocks:

XGG Global matrix of g-set size

UNUSED2 Not used and can be purged

Parameters:

NOK4GG Input-integer-default=-1. Structural damping generation flag


=-1 Do not generate
=0 Apply GE (on MATi entry) to stiffness

WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix

CONGE Output-real-default=0.0. The most common GE value. For NOSHIFT>0, only


affects assembly of K4GG matrix in SOL 111

NOSHIFT Input-integer-no default. Controls whether to attempt to shift


=0 Do not shift
>0 Attempt to shift

Remarks:

EMA is used to generate stiffness (KGG), mass (MGG), damping (BGG), and structural damping
(K4GG) matrices.

10-6 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.5 EMADM
Assemble a diagonal mass matrix into a full matrix.

Format:

EMADM MDICT,MELM,SIL/MGG/WTMASS $

Input Data Blocks:

MDICT Element mass matrix dictionary table.

MELM Table of element mass matrices.

SIL Scalar index list.

Output Data Block:

MGG Global mass matrix.

Parameter:

WTMASS Input-real-default = 1.0. Specifies scale factor on structural mass matrix.

10.6 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 $

Input Data Blocks:

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

SLT Table of static loads

MGG Mass matrix in g-size

CSTM0 Table of coordinate system transformation matrices for the residual structure

SCSTM Table of global transformation matrices for partitioned superelements

DMAP Programmer's Guide 10-7


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output:

KRFGG Stiffness matrix due to follower rotational forces in g-set

Parameters:

LOADID Input-integer-no default. Load set identification number for the current subcase.

LOADIDP Input-integer-default=0. Load set identification number for the previous subcase.

SEID Input-integer-default=0. Superelement identification number.

LOADFACR Input-real-default=1.0. Load factor in nonlinear static analysis. (Same as


LOADFAC except real.)

SYS66 Input-integer-default=255. System cell 66 override for matrix multiply.

Remarks:
1. Rotational forces are derived from the RFORCE Bulk Data entry.

2. LOADFACR is applied in the following manner to compute the total load:


Ptotal = LOADFACR • PLOADID + (1.0 − LOADFACR) • PLOADID

10.7 EMC
Create final contact stiffness for current status

Format:

EMC CNELM,ECSTAT,ELCNST,ELCTST/KELMC,KDICTC/
S,N,NLHEAT/S,N,CONV/S,N,CITO/

Input Data Blocks:

CNELM Contact element definition table.

ECSTAT Contact element status table

ELCNST Contact element normal stiffness table.

ELCTST Contact element tangential stiffness table.

Output Data Blocks:

KELMC Contact element matrix dictionary table.

KDICTC Table of contact element matrices.

10-8 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

NOHEAT Input-logical-no default.

TRUE if nonlinear heat transfer analysis.

CONV Input-integer. Converged solution flag.

0: Converged
1: Not converged

CITO Input-integer. Contact outer (status) loop counter.

10.8 EMG
Computes elemental matrices
Computes elemental matrices for stiffness, differential stiffness, mass, damping, heat conduction,
or heat capacity.

Format:

EMG EST,CSTM,MPT,DIT,CASECC,UG,ETT,EDT,DEQATN,DEQIND,
BGPDT,GPSNT,ECTA,EPTA,EHTA,DITID,EBOLT,COMPEST,EFILL,PCOMPT,EPT/
KELM,KDICT,MELM,MDICT,BELM,BDICT,ELMMOD,CONFAC2/
S,N,NOKGG/S,N,NOMGG/S,N,NOBGG/S,N,NOK4GG/S,N,NONLHT/COUPMASS/
TEMPSID/DEFRMSID/PENFAC/IGAPS/LUMPD/LUMPM/MATCPX/KDGEN/TABS/
SIGMA/K6ROT/LANGLE/NOBKGG/ALTSHAPE/PEXIST/FREQTYP/FREQVAL/
FREQWA/UNSYMF/S,N,BADMESH/DMGCHK/BOLTFACT/REDMAS/TORSIN/SHLDAMP/
SHLDMP/BSHDMP/LMSTAT/LMDYN/STFOPTN/MODOPTN $

Input Data Blocks:

EST Element summary table

CSTM Table of coordinate system transformation matrices

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

CASECC Case control data block

UG Displacement matrix in g-set. Required only for differential stiffness generation

ETT Element temperature table

EDT Table of Bulk Data entry images related to element deformation. Required
only for differential stiffness generation

DEQATN Table of DEQATN Bulk Data entry images

DMAP Programmer's Guide 10-9


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

DEQIND Index table to DEQATN data block

BGPDT Basic grid point definition table

GPSNT Grid point shell normal table

ECTA Secondary element connectivity table

EPTA Secondary table of Bulk Data entry images related to element properties

EHTA Secondary element hierarchical table

DITID Table of identification numbers in DIT

EBOLT Table of element ids of bolt elements

COMPEST Composite solid element summary table

EFILL Element fill ratio (TBD)

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

EPT Table of Bulk Data entry images related to element properties

Output Data Blocks:

KELM Table of element matrices for stiffness, heat conduction, differential, or follower
stiffness

KDICT KELM dictionary table

MELM Table of element mass matrices

MDICT MELM dictionary table

BELM Table of element damping or heat capacity matrices

BDICT BELM dictionary table

ELMMOD Effective element modulus table at a temperature

CONFAC2 Condensation factors

Parameters:

NOKGG Input/output-integer-default=-1. KELM and KDICT generation flag.

Input

0 Do not generate

10-10 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

≠0 Generate

Output

-1 Not generated

≠ -1 Generated

NOMGG Input/output-integer-default=-1. Same as NOKGG except for MELM and


MDICT.

NOBGG Input/output-integer-default=-1. Same as NOKGG except for BELM and BDICT.

NOK4GG Input/output-integer-default=1. Structural damping generation flag. Set to -1 if


a nonzero damping constant (GE field on MATi Bulk Data entry) is not found
for any element.

NONLHT Output-integer-default=-1. Nonlinear heat transfer or differential stiffness


generation flag. Set to 1 if nonlinear heat transfer elements are detected.

On input:

>3 Compute geometric nonlinear effects

<3 Do not compute geometric nonlinear effects

On output:

-1 if no nonlinear material was found in a heat transfer problem

1 Otherwise

COUPMASS Input-integer-default=-1. Coupled mass generation flag.

-1 Lumped

1 Coupled

TEMPSID Input-integer-default=-1. Temperature set identification number. Usually


obtained from the TEMPERATURE Case Control command. Required for use
in stress recovery of differential stiffness.

DEFRMID Input-integer-default=-1. Element deformation set identification number.


Usually obtained from the DEFORM Case Control command. Required for use
in stress recovery of differential stiffness.

PENFAC Input-real-default=0.0. Penalty factor for electromagnetic elements.

DMAP Programmer's Guide 10-11


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

IGAPS Input-integer. Determines how CGAP elements are treated in SOL 101.
Default = 0 when contact conditions exist and the system cell OLDGAPS=1,
or simply no contact conditions exist. CGAP elements will receive a spring
stiffness.
Default = –2 when contact conditions exist and the system cell OLDGAPS=0.
CGAP elements do not receive a spring stiffness, and instead are treated as
contact elements.

LUMPB Input-real-default=0.0. Lumping factor for electromagnetic damping.

LUMPM Input-real-default=0.0. Lumping factor for electromagnetic mass.

MATCPX Input-integer-default=-1. Complex material properties flag for electromagnetic


elements.

KDGEN Input-integer-default=0. Differential or follower stiffness matrix generation


flag. Usually the column number in UG to use in differential stiffness matrix
generation. If KDGEN is negative, follower stiffness is generated.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.

SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute


radiant heat flux.

K6ROT Input-real-default=0.0. Normal rotational stiffness factor for CQUAD4 and


CTRIA3 elements.

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Fimbal angle

2 Rotation vector

NOBKGG Input-integer-default=0. Slideline contact stiffness generation flag. Set to 1 to


generate slideline contact stiffness.

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

PEXIST Input-logical-default=FALSE. P-element flag. Set to TRUE if p-elements are


present and to be processed.

FREQTYP Input-character-default=’ ’ Frequency dependent element processing mode.

‘ESTF’Compute frequency dependent stiffness ‘ESTNF’Compute nominal


frequency dependent stiffness.

FREQVAL Input-real-default=0.0. Frequency value for frequency dependent element


generation.

10-12 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

FREQWA Input-real-default=0.0. Parameter for electromagnetic analysis.

UNSYMF Input-character-default=‘NO’ Unsymmetric stiffness generation for slideline


contact stiffness. If set to ‘YES‘, stiffness matrix is unsymmetric for slideline
contact.

BADMESH Output-logical-default=FALSE. Bad geometry was detected.

DMGCHK Input-logical-default=TRUE. Element geometry check flag. It works in


conjunction with the GEOMCHECK exec control statement. If both the
GEOMCHECK statement (via the GCHECK logical variable in /ERRMSG/ ...
WORD6) and DMGCHK=TRUE, then optional checks are performed.

BOLTFACT Input-real-default=1.0E+07. Factor used to reduce the bolt stiffness during the
first phase of a bolt preload analysis.

REDMAS Input-logical-default=TRUE. Determines if reduced mass integration occurs.


Only for tetrahedral elements and when mass is for acceleration loading.

TORSIN Input-integer-default=0. Determines if torsional mass moment of inertia is


included for CROD and CBAR.
TORSIN=0 Torsional mass moment of inertia is not included for CROD and
CBAR
TORSIN=1 It is included for CROD and CBAR
TORSIN=2 Included only for CBAR.
TORSIN=3 Included only for CROD.

SHLDAMP Input-character-default=‘SAME’ Determines the strategy for shell structural


damping.
= SAME The structural damping coefficient (GE) defined on a PSHELL MID1
material will be used by all MIDi for that PSHELL, and SHLDMP is assigned a
value of 0 (see SHLDMP below).
= DIFF The structural damping coefficient (GE) defined on each PSHELL
MIDi will be used. SHLDMP is assigned a value of 1 (see SHLDMP below).
Otherwise, SHLDMP=0.

SHLDMP Input/output-integer-default=0. Structural damping flag for PSHELL property


entries.
First call to EMG:
Input From
Output Value Definition
SHLDAMP
All elements are processed normally. Just
0 0
one call to EMG.
All elements are processed normally,
except the value of GE on the KDICT
1 -1 data block for the shell element stiffness
is assigned a value of 0.0, and EMG is

DMAP Programmer's Guide 10-13


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

called a second time for element damping


matrices.

Second call to EMG when SHLDMP=-1:


Input Value Output Value Definition
For shell elements, the element stiffness is
–1 1 multiplied by the corresponding GEi, and GE on the
KDICT data block is assigned a value of 1.0.

BSHDMP Input/output-integer-default=0. Structural damping flag for PBUSH and


PBUSHT property entries.
First call to EMG:
Input From
BSHDAMP on TA1 Output Value Definition
module
All elements are processed normally. Just
0 0
one call to EMG.
All elements are processed normally,
except the value of GE on the KDICT
data block for the bush element stiffness
1 -1
is assigned a value of 0.0, and EMG is
called a second time for element damping
matrices.

Second call to EMG when BSHDMP=-1:


Output
Input Value Definition
Value
For bush elements, the element stiffness is multiplied
–1 1 by the corresponding GEi, and GE on the KDICT
data block is assigned a value of 1.0.

LMSTAT Input-integer-default=6. Power of 10 used to reduce the stiffness in a static


analysis.

LMDYN Input-integer-default=-1. Power of 10 used to reduce the stiffness in a dynamic


analysis.

STFOPTN Input-integer-default=1. Stiffness option


STFOPTN = 1 for elastic stiffness
STFOPTN = 2 for tangent stiffness

MODOPTN Input-integer-default=0. Effective element modulus table creation option


MODOPTN = 0 to not create
MODOPTN ≠ 0 to create

10-14 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

3. ELMMOD will only be created when KELM and KDICT are created.

10.9 EMR
Generate the constraint matrix for the Lagrange Multiplier partition.

Format:

EMR GEOM4,EQEXIN,SIL,BGPDT,CSTM,/LMFACT/NROWS $

Input Data Block:

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity.

EQEXIN Equivalence table between external and internal grid/scalar identification numbers.

SIL Scalar index list.

BGPDT Basic grid point definition list.

CSTM Table of coordinate system transformation matrices.

Parameter:

LMFACT Input-real-default = 1.0. Lagrange multiplier.

NROWS Input-integer-no default. Number of rows in G-set.

10.10 EQUIVX
Data block name equivalence
Attaches a second name to an existing data block.

Format:

EQUIVX DBP/DBS/PARM $

DMAP Programmer's Guide 10-15


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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, Siemens PLM
Software 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 DBS prior to EQUIVX DBS after EQUIVX

Generated Any Equivalenced

Purged or Not Generated Any Purged and not equivalenced

Status with PARM ≥ 0

DBP prior to EQUIVX DBS prior to EQUIVX DBS after EQUIVX

Generated Not Equivalenced Unchanged

Generated Equivalenced Purged and Not Generated

Purged or Not Generated Any Unchanged

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 $

10-16 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

10.11 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.

Parameters:
None.

Remarks:
EST must be declared as an append file on the FILE statement.

10.12 EXTSEIDS
Generate grid and element ID lists for an external partitioned superelement.

Format:

EXTSEIDS TUG1,TQG1,TQMG1,TGPF,TES1,TEE1,TEF1/SEGRD,SEELM

DMAP Programmer's Guide 10-17


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

TUG1 Table of displacement grids for external partitioned superelement.

TQG1 Table of SPC force grids for external partitioned superelement.

TQMG1 Table of MPC force grids for external partitioned superelement.

TGPF Table of grid point force balance grids for external partitioned superelement.

TES1 Table of stress elements for external partitioned superelement.

TEE1 Table of strain elements for external partitioned superelement.

TEF1 Table of element force elements for external partitioned superelement.

Output Data Blocks:

SEGRD Table of grid IDs for external partitioned superelement.

SEELM Table of element IDs for external partitioned superelement.

10.13 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 Generalized (modal) stiffness matrix

BHH Generalized (modal) damping matrix

MHH Generalized (modal) mass matrix

QHHL Aerodynamic matrix list

CASECC Table of Case Control command images

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

10-18 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

FSAVE Flutter storage save or answer table

KHH1 Modified generalized (modal) stiffness matrix.

BHH1 Modified generalized (modal) damping matrix

MHH1 Modified generalized (modal) mass matrix

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.

TSTART Output-integer-no default. CPU clock time at entry to module.

NOCEAD Output-integer-default=0. Complex eigenvalue analysis flag. Set to 1 if complex


eigenvalue analysis needs to be performed, otherwise, set to -1.

LPRINT Input-logical-default=TRUE. Print flag for flutter analysis.

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.

10.14 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 Complex eigenvector matrix for h-set in flutter analysis

CLAMA1 Complex eigenvalue summary table in flutter analysis

FSAVE Flutter storage save table

DMAP Programmer's Guide 10-19


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Blocks:

CPH2 Appended complex eigenvector matrix for h-set in flutter analysis

CLAMA2 Appended complex eigenvalue summary table in flutter analysis

CASEYY Appended Case Control table in flutter analysis

OVG Table of aeroelastic x-y plot data for V-g or V-f curves

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.

VREF Input-real-no default. Flutter velocity divisor to obtain flutter indices.

AECONFIG Input-character-no default. Aerodynamic configuration.

SYMXZ Input-integer-no default. Aerodynamic z-y symmetry flag.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

LPRINT Input-logical-default=TRUE. Print flag for flutter analysis.

Remarks:

All output data blocks must be declared on the FILE statement with the APPEND keyword in order to
append outputs from previous loops.

10.15 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 Lower triangular factor/diagonal, or Cholesky factor

U Upper triangular factor. Purged unless [A] is unsymmetric.

B Rectangular matrix

10-20 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Block:

X Rectangular matrix having the same dimensions as [B]

Parameters:

KSYM Input-integer-default = -1. Symmetry flag.

-1 Choose symmetric if [U] is purged, otherwise unsymmetric (default).

0 Matrix [A] is unsymmetric.

1 Matrix [A] is symmetric.

2 Perform left-handed solution.

SIGN Input-integer-default = 1. Sign of [B].

1 Solve [A] [X] = [B] (default).

-1 Solve [A] [X] = -[B] (default).

FBTYP Input-integer-default = 0. Forward or backward pass selection.

-1 Perform backward pass only.

0 Perform forward and backward passes (default).

1 Perform forward pass only.

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.

DMAP Programmer's Guide 10-21


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

FBSOPT Non-sparse submethod selection

-2 Method 1A

-1 Method 1

0 Automatic selection method based on minimum of l/O + CPU time

+1 Method 2

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 A/LD,U, $
FBS LD,U,B/X/ $
MATPRN X// $

2. Solve [A] [X] = [B] assuming [A] is symmetric (form = 6 in matrix trailer).
DECOMP A/LD,, $
FBS LD,,B/X/ $
MATPRN 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 M/LD,,//1 $ CHOLESKY
FBS LD,,K/Y///1 $ FWD.ONLY,Y AN INTERMEDIATE RESULT

10-22 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

FBS LD,,Y/J/2//1 $ FWD.ONLY, LEFT-HAND

10.16 FILE
Data block declaration
Declares special characteristics of a data block(s).

Format:

FILE DB1=[SAVE,APPEND,OVRWRT]/DB2=[SAVE,APPEND,
OVRWRT]/... $

Data Blocks:

DBi Names of the data blocks possessing special characteristics

Parameters:

SAVE Indicates that the data block is to be saved for possible looping in DMAP program

APPEND Same as SAVE. Also allows a module to append other data blocks to DBi on
successive passes through a DMAP loop.

OVRWRT Allows a data block to be overwritten

Remarks:
1. FILE is a nonexecutable DMAP instruction that is used only by the DMAP compiler for information
purposes. It 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. Siemens PLM Software 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 ) $

DMAP Programmer's Guide 10-23


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

IF ( COUNT=1 ) MPYAD A,B,/C $


.
.
.
ADD A,C/D/R $
R=R+(1.,0.) $
COUNT=COUNT+1 $
ENDDO $

2. For an example of the APPEND keyword see the “APPEND” module description.

10.17 FOCOASET
ASET processing of contact DOF.

Format:

FOCOASET CASECC,GEOM4,CNELM/GEOM4N/S,N,ICTASET $

Input Data Blocks:

CASECC Table of Case Control command images

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity

CNELM Contact element definition table

Output Data Blocks:

GEOM4N Updated GEOM4 data block with the a-set data

Parameters:

ICTASET Output-integer-no default. Contact ASET status parameter:

1 Not all criteria for ASET processing with contact have been met

-1 All criteria for ASET processing with contact have been met

10.18 FOCODS
Form contact element displacements.

Format:

FOCODS CNELM,USET,UA/ECDISP $

10-24 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Input Data Blocks:

CNELM Contact element definition table.

USET Degree-of-freedom set membership table for g-set.

UA Displacement vector -a set.

Output Data Blocks:

ECDISP Contact element displacements.

10.19 FOCOEL
Form contact elements.

Format:

FOCOEL CASECC,BGPDT,CSTM,GEOM2,EST,MPT,CONTACT,SIL,GPSNTC,UG/
CNELM,GPECTC/
NSKIP/OPTION/NLHEAT/MEL/S,N,REFOPT/S,N,CNTSET/S,N,NCELS/S,N,MAXO/
S,N,MAXI/CNTS/S,N,AITK/S,N,MPLI/S,N,RESET/S,N,CTOL/CNTLOOP $

Input Data Blocks:

CASECC Table of case control command images.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.

EST Element summary table.

MPT Material property table.

CONTACT Contact data table.

SIL Scalar index list.

GPSNTC Table of grid point shell normals.

UG Nodal displacements in basic coordinate system.

Output Data Blocks:

CNELM Contact element definition table.

GPECTC Grid point contact element connection table.

DMAP Programmer's Guide 10-25


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

NSKIP Input-integer-no default. Record number in CASECC corresponding to the first


subcase of the current boundary condition.

OPTION Input-integer-no default. Setup option.


= -1 for contact analysis phase 1 – pre refine
= 1 for contact analysis phase 2 – post refine
= 3 to only read the parameters and return

NLHEAT Input-logical-no default. TRUE if nonlinear heat transfer analysis.

MEL Input-integer-no default. Maximum number of elements connected to a grid.

REFOPT Output-integer. Refinement option.


= 0 - no refinement
= 1 - pre NXN7 refinement method
= 2 - NXN7 refinement method

CNTSET Output-integer. Contact set ID.

NCELS Output-integer. Number of contact elements.

MAXO Output-integer. Maximum number of iterations for status loop.

MAXI Output-integer. Maximum number of iterations for force loop.

CNTS Input-real. Allowable number of contact changes for convergence. (Same as


NCHG parameter on BCTPARM bulk data entry).

AITK Output-integer. Aitken iteration flag.

MPLI Output-integer. Minimum contact set percentage.

RESET Output-integer. Reset flag.

CTOL Output-real-default=0.01. Contact force convergence tolerance.

CNTLOOP Input-integer-no default. Contact loop ID.

Remarks:

NCELS will equal -1 if error is encountered forming the contact element.

10.20 FOCOST
Form contact status

10-26 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

FOCOST CNELM,ECSTAT,ELAMDA,DLAMDA,ECDISP/ECSTAT2/
CITO/NOFAC/S,N,NCS0/S,N,NCS1/S,N,NCS2/S,N,NCS3/S,N,NCSC/INREL $

Input Data Blocks:

CNELM Contact element definition table.

ECSTAT Contact element status table from previous iteration.

ELAMDA Previous tractions.

DLAMDA Change of tractions.

ECDISP Contact element displacements.

Output Data Blocks:

ECSTAT2 Contact element status table.

Parameters:

CITO Input-integer-default=0. Contact outer (status) loop counter.

NOFAC Input-real-no default. Percent of initially open contacts to make active.

NCS0 Output-integer-default=0. Number of inactive contact elements.

NCS1 Output-integer-default=0. Number of active open contact elements

NCS2 Output-integer-default=0. Number of sticking contact elements.

NCS3 Output-integer-default=0. Number of sliding contact elements.

NCSC Output-integer-default=0. Number of contact element changes.

INREL Input-integer-default=0. Inertia relief options.


= 0 No inertia relief
= -1 Manual inertia relief
= -2 Automatic inertia relief

10.21 FOELCCS
Combines the normal and tangential contact penalty stiffness matrices depending on contact status.

DMAP Programmer's Guide 10-27


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

FOELCCS CNELM,ECSTAT,ELCNST,ELCTST,SIL/ELCSTF/S,N,CONV/S,N,CITO/S,N,NOKGGC

Input Data Blocks:

CNELM Contact element definition table.

ECSTAT Contact status vector

ELCNST Normal contact stiffness

ELCTST Tangential contact stiffness

SIL Nodal SILS

Output Data Blocks:

ELCSTF Combined contact stiffness

Parameters:

CONV Input,integer. Converged solution (=0 not converged =1 converged)

CITO Input,integer. Contact outer loop counter.

NOKGGC Output,integer. ELCSTF existence flag (= –1 does not exist, =0 exists)

10.22 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/S,N,SCALE/S,N,KCSCALE/
S,N,TARPEN/S,N,CITI $

Input Data Blocks:

CNELM Contact element definition table.

10-28 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

ECSTAT Contact element status table.

ECDISP Contact element displacements.

ECDISO Contact element displacements from previous load case.

ELAMDA Previous contact element tractions.

DLAMDA Previous contact element change in tractions.

XYDISP XY relative displacements.

Output Data Blocks:

DLAMUP Update change in contact element tractions.

CONFOR Contact element force vector.

TLAMCK Contact element tractions including spring forces.

XUDISU Updated XY relative displacements.

Parameters:

NROW Input-integer. Number of rows for contact force vector.

CONV Input-integer. Converged solution flag.

CITO Input-integer. Contact outer (status) loop counter.

SCALE Input-real. Scale factor for normal and tangential penalty factors.

TARPEN Output-real. Target penetration. TARPEN is the product of the BCTPARM


parameter PENETFAC and the effective depth calculated by the solver. It is used
in the calculation of a scale factor that adaptively scales the contact stiffness matrix
when PENADAPT is selected in the BCTPARM bulk entry.

KCSCALE Output-real. Scale factor used for contact stiffness matrix. It is computed based on
the ration of average penetrations in the model and target penetration (TARPEN).

CITI Input-integer. Contact inner (force) loop counter.

10.23 FOELCS
Form contact element stiffness.

DMAP Programmer's Guide 10-29


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

FOELCS CNELM,BGPDT,CSTM,USET/ELCNST,ELCTST $
S,N,NLHEAT/S,N,IMODE/K6ROT $

Input Data Blocks:

CNELM Contact element definition table.

BGPDT Basic grid point data table.

CSTM Table of coordinate system transformation matrices.

USET Degree-of-freedom set membership table for g-set.

Output Data Blocks:

ELCNST Contact element normal stiffness table.

ELCTST Contact element tangential stiffness table.

Parameters:

NLHEAT Input-logical-no default. TRUE if nonlinear heat transfer analysis.

IMODE Integer. Glue or contact flag.

= 1 for contact.

= 2 for glue.

K6ROT Input-real-default=100.0. Specifies the stiffness to be added to the normal rotation


for CQUAD4 and CTRIA3 elements.

10.24 FOGLEL
Form glue elements.

Format:

FOGLEL CASECC,BGPDT,CSTM,GEOM2,EST,MPT,CONTACT,SIL,GPSNTC,UNUSED/
GNELM,GPECTC/
NSKIP/OPTION/NLHEAT/MEL/S,N,REFOPT/S,N,GLUSET/S,N,NGELS $

10-30 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Input Data Blocks:

CASECC Table of case control command images.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points.

EST Element summary table.

MPT Material property table.

CONTACT Contact data table.

SIL Scalar index list.

GPSNTC Table of grid point shell normals.

Output Data Blocks:

GNELM Glue element definition table.

GPECTC Grid point contact element connection table.

Parameters:

NSKIP Input-integer-no default. Record number in CASECC corresponding to the first


subcase of the current boundary condition.

OPTION Input-integer-no default. Setup option.


= -2 for glue analysis phase 1 – pre refine
= 2 for glue analysis phase 2 – post refine

NLHEAT Input-logical-no default. TRUE if nonlinear heat transfer analysis.

MEL Input-integer-no default. Maximum number of elements connected to a grid.

REFOPT Output-integer. Refinement option.


= 0 - no refinement
= 1 - pre NXN7 refinement method
= 2 - NXN7 refinement method

GLUSET Output-integer. Glue set ID.

NGELS Output-integer. Number of glue elements.

Remarks:

NGELS will equal -1 if error is encountered forming the glue element.

DMAP Programmer's Guide 10-31


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.25 FONOTR
Form contact tractions and pressures

Format:

FONOTR CNELM,ECSTAT,ELAMDA,CASESX/
OQGCFF1,OBC1,CONFON,ELTRCT/
NROW/NVEC/DMAPNO/RSTIME/LGDISP $

Input Data Blocks:

CNELM Contact element definition table.

ECSTAT Contact element status table.

ELAMDA Contact element tractions.

CASESX Table of case control command images.

Output Data Blocks:

OQGCF1 Contact force at grid point.

OBC1 Contact pressures and tractions at grid points.

CONFON Contact forces on elements.

ELTCT Contact tractions on elements.

Parameters:

NROW Input-integer-no default. Number of rows in contact force vector.

NVEC Input-integer-no default. Number of solution results to process.

DMAPNO Input-integer-no default. DMAP number.

RSTIME Input-real-no default. Results output time.

LGDISP Input-integer-default=-1. Large displacement flag.

10.26 FORTIO
Opens or closes a FORTRAN file

10-32 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

FORTIO //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 Input-integer-no default. Specifies FORTRAN unit number.

CLOSEOPT Input-integer-default=2. FORTIO close options.

1 Rewind (leaves file open, if open)

2 Close/keep (default)

3 Close/delete

IOSTAT Output-integer-no default. FORTIO status return code. For OPERATN=‘OPEN’or


‘CLOSE’:

0 Successful

1 Unsuccessful

For OPERATN=‘EXISTS’:

0 Assigned physical file exists.

1 Assigned physical file does not exist.

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.

DMAP Programmer's Guide 10-33


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Example:

Close FORTRAN unit 24.


FORTIO //‘CLOSE‘/24/2/S,N,IOSTAT $

10.27 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 Table of Case Control command images

USETD Degree-of-freedom set membership table for p-set

DLT Table of dynamic loads

FRL Frequency response list

GMD Multipoint constraint transformation matrix with extra points, m-set by ne-set

GOD Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set

DIT Table of TABLEij Bulk Data entry images

PHDH Transformation matrix from d-set to modal coordinates

Output Data Blocks:

PPF Frequency response load matrix in the p-set

PSF Frequency response load matrix in the s-set

PDF Frequency response load matrix in the d-set

FOL Frequency response frequency output list

PHF Frequency response load matrix in the h-set (modal)

YPF Frequency response enforced motion matrix in the p-set

10-34 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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

FOURIER Output-integer-default=-1. Fourier transform. Set to 1 if TLOADi Bulk Data entries


are referenced by the DLOAD set identification number in CASECC.

APP Output-character-default=‘FREQ’ Dynamic load type. Set to ‘FREQ‘, if RLOAD1


or RLOAD2 entries are referenced. Set to ‘TRAN‘, if TLOAD1 or TLOAD2 entries
are referenced.

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.

10.28 FRLGEN
Creates frequency response list from the FREQi Bulk Data entries

Format:

FRLGEN DYNAMIC,LAMAS,LAMAF/
FRL,FRL1,DFFDNF/
S,N,NOFRL/S,N,NOOPT/DFREQ $

DMAP Programmer's Guide 10-35


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

DYNAMIC Table of Bulk Data entry images related to dynamics

LAMAS Normal modes eigenvalue summary table for the structural portion of the model

LAMAF Normal modes eigenvalue summary table for the fluid portion of the model

Output Data Blocks:

FRL Frequency response list

FRL1 Frequency response list for the current processor if distributed processing is
requested

DFFDNF Table containing the derivatives of forcing frequencies with respect to natural
frequencies

Parameters:

NOFRL Output-integer-default=0. FRL generation flag. Set to -1 if FRL is not generated.

NOOPT Output-integer-default=0. FRLGEN reexecution flag. Set to -1 for no re-execution.

DFREQ Input-real-default=1.E-5. Duplicate frequency threshold. Two frequencies, f1 and


f2, are considered duplicates if

Equation 10-1.
where fmax and fmin are the maximum and minimum frequencies across all FREQi
Bulk Data entries.

Remarks:

LAMAF can be purged.

10.29 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.

10-36 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

FRQDRV CASECC,FRL/
FRLI/
S,N,FRQLOOP/S,N,FREQVAL $

Input Data Blocks:

CASECC Table of Case Control command images

FRL 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.

FREQVAL Output-real-no default. Frequency value for frequency dependent element


generation.

Example:
TYPE PARM,,I,N,FRQLOOP=0 $
DO WHILE ( FRQLOOP>=0 ) $
FRQDRV CASES,FRL/FRLI/S,N,FRQLOOP/S,N,FREQVAL $
.
.
.
ENDDO $ FRQLOOP>=0

10.30 FRRD1
Solves for the steady-state frequency response displacement solution
Solves for the steady-state, modal or direct, frequency response, displacement solution using
iterative or direct methods.

Format:

FRRD1 CASECC,DIT,KXX,BXX,MXX,K4XX,PXF,FRL,FOL,EDT,
SILD,USETD,PARTVEC/
UXF,FOLT/
SOLTYP/NONCUP/ITSEPS/ITSMAX/NSKIP/FRRD1SEL/
S,N,FIRSTBAD/SETNAME/FREQDEP $

DMAP Programmer's Guide 10-37


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

CASECC Table of Case Control command images.

DIT Table of TABLEij Bulk Data entry images.

KXX Stiffness matrix in any set. Usually h- or d-set.

BXX Viscous damping in any set. Usually h- or d-set.

MXX Mass matrix in any set. Usually h- or d-set.

K4XX Structural damping in any set. Usually h- or d-set.

FRL Frequency response list.

FOL Frequency response frequency output list.

PXF Frequency response load matrix in h-set (modal) or d-set.

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

SILD Scalar index list for the p-set. Required for maximum efficiency during symmetric
decomposition and if KXX represents the d-set or a subset of the d-set
(SETNAME=‘D‘).

USETD Degree-of-freedom set membership table for the p-set. Required for maximum
efficiency during symmetric decomposition and if KXX represents the d-set or a
subset of the d-set (SETNAME=‘D‘).

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, 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.

Output Data Blocks:

UXF Solution matrix from frequency response analysis in d- or h-set.

FOLT Frequency response frequency output list with first frequency truncated if first
frequency is zero. UXF is also similarly truncated.

Parameters:

SOLTYP Input-character-no default. Solution method.

‘MODAL’: modal, usually for h-set matrices


‘DIRECT’: direct, usually for d-set matrices

10-38 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

ITSEPS Input-integer-default=0. Power of ten for convergence parameter epsilon for


iterative solution method.

ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution


method.

NSKIP Input-integer-default=1. Record number of current subcase in CASECC. 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.

ZFREQ Input-integer-default=0. Zero frequency truncation selection. If set to 1, the zero


frequency, if any, is truncated from UXF and FOL.

FIRSTBAD Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if first


frequency is truncated.

SETNAME Input-character-default=‘H’ Degree-of-freedom set name represented by KXX,


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.

FREQDEP Input-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE if


processing frequency-dependent elements.

Remarks:

1. CASECC, FRL, FOL, and PXF cannot be purged. KXX, BXX, and MXX can be purged.

2. If SOLTYP=‘DIRECT‘, K4XX is only used to simulate viscoelastic materials. (See the NX Nastran
User‘s Guide.) Otherwise, it is ignored and 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.

10.31 FRRD2
Solves for the steady-state frequency response displacement solution

DMAP Programmer's Guide 10-39


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Stiffness matrix in any set. Usually h- or d-set.

BXX Viscous damping in any set. Usually h- or d-set.

MXX Mass matrix in any set. Usually h- or d-set.

QHHL Aerodynamic matrix list

PXF Frequency response load matrix in h-set (modal) or d-set

FOL Frequency response frequency output list

CASECC Table of Case Control command images

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

SILD Scalar index list for the p-set. Required for maximum efficiency during symmetric
decomposition and if KXX represents the d-set or a subset of the d-set
(SETNAME=‘D‘).

USETD Degree-of-freedom set membership table for the p-set. Required for maximum
efficiency during symmetric decomposition and if KXX represents the d-set or a
subset of the d-set (SETNAME=‘D‘).

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, 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.

Output Data Blocks:

UXF Solution matrix from frequency response analysis in d- or h-set

FOLT Frequency response frequency output list with first frequency truncated if first
frequency is zero. UXF is also similarly truncated.

10-40 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

BOV Input-real-no default. Conversion from frequency to reduced frequency.

Q Output-real-default=0.0. Dynamic pressure.

MACH Output-real-default=0.0. Mach number.

NONCUP Input-integer-default=-1. Algorithm selection. NONCUP=-1 requests uncoupled


algorithm if KXX, BXX, and MXX are diagonal. NONCUP=-2, requests uncoupled
algorithm and off-diagonal terms of KXX, BXX, and MXX is ignored.

ITSEPS Input-integer-default=0. Power of ten for convergence parameter epsilon for


iterative solution method.

ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution


method.

SETNAME Input-character-default=‘H’ Degree-of-freedom set name represented by KXX,


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.

ZFREQ Input-integer-default=0. Zero frequency truncation selection. If set to 1, the zero


frequency, if any, is truncated from UXF and FOL.

FIRSTBAD Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if first


frequency is truncated.

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.

10.32 FRRDRU
Solves for modal frequency response. Modal matrices from GKAMW are needed for displacement
solution.

DMAP Programmer's Guide 10-41


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

FRRDRU CASES,DIT,K2HHF,M2HHF,B2HHF,B2HHCP,PXF,FRL,FOL,UNUSED1,
UNUSED2,UNUSED3,VPHFS,KDD1,BDD1,MDD1,PHDSH,KDD2,BDD2,MDD2/
UXF,FOLT/
SOLTYP/NONCUP/ZFREQ/NOERR/FIRSTBAD $

Input Data Blocks:

CASES Table of case control command images

DIT Table of TABLEij Bulk Data entry images

K2HHF Modal stiffness matrix of fluid

M2HHF Modal mass matrix of fluid

B2HHF Modal damping matrix of fluid

B2HHCP Modal damping matrix of coupling

PXF Frequency response load matrix in h-set

FRL Frequency response list

FOL Frequency response frequency output list

VPHFS Partition vector of fluid and structure

KDD1 Modal stiffness matrix generated by GKAMW if system cell 462 is 2; Stiffness
matrix in h-set or d-set (CKDD) if system cell 462 is 3 or 4.

BDD1 Modal damping matrix generated by GKAMW

MDD1 Modal mass matrix generated by GKAMW if system cell 462 is 2; Mass matrix in
h-set or d-set (CMDD) if system cell 462 is 3 or 4.

PHDSH Projection vectors from D-set to H-set

KDD2 Stiffness matrix of structure if system cell 462 is 2; Viscous damping matrix in
h-set or d-set (CBDD) if system cell 462 is 3 or 4.

BDD2 Damping matrix of structure

MDD2 Mass matrix of structure

Output Data Blocks:

UXF Solution matrix from frequency response analysis in h-set

10-42 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

FOLT Frequency response frequency output list with first frequency truncated if first
frequency is zero. UXF is also similarly truncated

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 KDD1,
BDD1 and MDD1 are diagonal.
NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KDD1,
BDD1, and MDD1 are ignored.

ZFREQ Input-integer-default=0. Zero frequency truncation selection. If set to 1, the


zero frequency, if any, is truncated from UXF and FOL.

NOERR Output-integer-default=0. If an error occurred, then NOERR is set to 1.

FIRSTBAD Output-logical-default=FALSE. Zero frequency truncation flag. Set to TRUE if


first frequency is truncated.

10.33 GENTRAN
Generates a transformation matrix
Generates a transformation matrix that converts the upstream boundary coordinate system to the
downstream coordinate system.

Format:

GENTRAN SEMAP,BGPDTS,CSTMS,BGPDTD,CSTMD,SCSTM/
MAPS/
SEID $

Input Data Blocks:

SEMAP Superelement map table

BGPDTS Basic grid point definition table for the current superelement

CSTMS Table of coordinate system transformation matrices for the current superelement

BGPDTD Basic grid point definition table for the downstream superelement

DMAP Programmer's Guide 10-43


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

CSTMD Table of coordinate system transformation matrices for the downstream


superelement

SCSTM 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

10.34 GETCOL
Reads the STATSUB and IC(STATSUB) Case Control command subcase identification number.

Format:

GETCOL CASEBUCK,CASESTAT//
NSKIP/S,N,BCKCOL/S,N,PRECOL/S,N,ICCOLN $

Input Data Blocks:

CASEBUCK Table of Case Control command images for buckling analysis

CASESTAT Table of Case Control command images for static analysis

Output Data Blocks:

None.

10-44 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

NSKIP Input-integer-default=1. Subcase record number to read in CASEBUCK for the


STATSUB subcase identification number.

BCKCOL Output-integer-no default. Subcase record number in CASESTAT referenced


by the STATSUB(BUCKLE) subcase identification number. BCKCOL also
corresponds to the column number of static solution vector.

PRECOL Output-integer-default-0. Subcase record number in CASESTAT referenced


by the STATSUB(PRELOAD) subcase identification number. PRECOL also
corresponds to the column number of static solution vector.

ICCOLN Output-integer-default=0. Column number of static solution matrix as derived


from the IC(STATSUB) Case Control command specification.

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.

10.35 GETMKL
Create list of Mach numbers on reduced frequency pairs

Format:

GETMKL EDT/MKLIST/S,N,NMK $

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.

DMAP Programmer's Guide 10-45


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.36 GETSCF
Get scale factor to process external superelement results recovery.

Format:

GETSCF CASECC//SUBC/LCN/SEID/COLNO/S,N,SETID/S,N,SCF $

Input Data Blocks:

CASECC Case Control table.

Parameters:

SUBC Input-integer-default=0. External superelement subcase ID.

LCN Input-integer-default=0. External superelement load case number.

SEID Input-integer-default=0. External superelement ID.

COLNO Input-integer-default=0. Column number of external superelement applied loading


from SELOAD reference.

SETID Output-integer-no default. Set ID of applied SELOADS in corresponding residual


subcase. Set to 0 if none found.

SCF Output-complex single precision-no default. Scale factor to be applied to U00


recovey component.

10.37 GI
Generates aerodynamic spline transformation matrix

Format:

GI

Input Data Blocks:

AERO Table of control information for aerodynamic analysis. Output by APD.

SPLINE Table of SETi, AELIST, and SPLINEi Bulk Data entry images with external grid
identification numbers

AMSPLINE Table of aerodynamic splines for display

10-46 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

BGPDT Basic grid point definition table

AEBGPDT The basic grid point definition table with the aerodynamic degrees of freedom
added (ks-set in AEUSET)

AEUSET Aerodynamic USET table

AECOMP Aerodynamic component definition table

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

Output Data Blocks:

GPGK Aerodynamic transformation matrix for loads from the k-set to g-set

GDGK Aerodynamic transformation matrix for displacements from the k-set to g-set

Parameters:
None.

Example:
Excerpt from subDMAP AERO0:
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 $

10.38 GKAM
Assembles modal mass, damping and stiffness matrices

Format:

GKAM USETD,PHA,MI,LAMA,DIT,M2DD,B2DD,K2DD,CASECC/
MHH,BHH,KHH,PHDH,ZETA/
NOUE/LMODES/LFREQ/HFREQ/UNUSED5/UNUSED6/UNUSED7/
S,N,NONCUP/S,N,FMODE/KDAMP/FLUID/UNUSED12/NOPHI $

Input Data Blocks:

USETD Degree-of-freedom set membership table for p-set

PHA Normal modes eigenvector matrix in the a-set

MI Modal mass matrix. See Remark 5.

LAMA Normal modes eigenvalue summary table

DMAP Programmer's Guide 10-47


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

DIT Table of TABLEij Bulk Data entry images

M2DD Mass matrix contribution from the M2PP Case Control command and reduced to
the d-set

B2DD Total damping matrix from viscous damping elements and the B2PP Case Control
command and reduced to the d-set. In transient response analysis, B2DD can
also include structural damping effects.

K2DD Stiffness matrix contribution from the K2PP Case Control command and reduced
to the d-set. In frequency response analysis, K2DD can also include structural
damping effects.

CASECC Table of Case Control command images

Output Data Blocks:

BHH Generalized (modal) damping matrix

MHH Generalized (modal) mass matrix

KHH Generalized (modal) stiffness matrix

PHDH Transformation matrix from d-set to h-set (modal)

ZETA Diagonal matrix of viscous damping coefficients (modal)

Parameters:

NOUE Input-integer-no default. The number of EXTRA points. Set to -1 if there are no
extra points.

LMODES Input-integer-no default. The number of lowest modes to use in modal


transformation. All outputs have LMODES number of columns.

LFREQ Input-real-no default. Lower frequency limit of modes to use in modal


transformation.

HFREQ Input-real-no default. Upper frequency limit of modes to use in modal


transformation.

UNUSED5 Input-integer-no default. Unused.

UNUSED6 Input-integer-no default. Unused.

UNUSED7 Input-integer-no default. Unused.

NONCUP Output-integer-no default. If K2DD, B2DD, and M2DD are purged. the model
is considered uncoupled and NONCUP is set to -1.

10-48 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

FMODE Output-integer-default=1. The lowest mode number resulting from LMODES or


LFREQ and HFREQ.

KDAMP Input-integer-default=1. Viscous modal to structural damping flag. If set to -1,


viscous modal damping (SDAMPING Case Control command) is included in the
stiffness matrix as structural damping.

FLUID 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.

UNUSED12 Input-logical-default=FALSE. Unused.

NOPHI Input-integer-no default. If positive, the input data block PHA is recycled for the
performance improvement and the output data block PHDH is purged.

Remarks:

1. USETD can be purged if there are no extra points (NOUE<0).

2. PHA and LAMA cannot be purged.

3. CASECC and DIT cannot be purged if SDAMPING is specified.

4. M2DD, B2DD, K2DD, and MI 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.

10.39 GKAMW
Assembles modal mass, damping and stiffness matrices for FRRDRU.

Format:

GKAMW USETD,PHA,MI,LAMA,DIT,M2DD,B2DD,K2DD,CASECC/
MHH,BHH,KHH,PHDH,ZETA,BDD1,MDD1/
NOUE/LMODES/LFREQ/HFREQ/UNUSED5/UNUSED6/UNUSED7/
S,N,NONCUP/S,N,FMODE/KDAMP/FLUID/UNUSED12 $

Input Data Blocks:

USETD Degree-of-freedom set membership table for p-set

DMAP Programmer's Guide 10-49


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

PHA Normal modes eigenvector matrix in the a-set

MI Modal mass matrix. See Remark 6.

LAMA Normal modes eigenvalue summary table

DIT Table of TABLEij Bulk Data entry images

M2DD Mass matrix contribution from the M2PP Case Control command and reduced to
the d-set

B2DD Total damping matrix from viscous damping elements and the B2PP Case Control
command and reduced to the d-set. In transient response analysis, B2DD can
also include structural damping effects.

K2DD Stiffness matrix contribution from the K2PP Case Control command and reduced
to the d-set. In frequency response analysis, K2DD can also include structural
damping effects.

CASECC Table of Case Control command images

Output Data Blocks:

BHH Generalized (modal) damping matrix

MHH Generalized (modal) mass matrix

KHH Generalized (modal) stiffness matrix

PHDH Transformation matrix from d-set to h-set (modal)

ZETA Diagonal matrix of viscous damping coefficients (modal).

BDD1 Modal damping matrix

MDD1 Modal mass matrix

Parameters:

NOUE Input-integer-no default. The number of EXTRA points. Set to -1 if there are no
extra points.

LMODES Input-integer-no default. The number of lowest modes to use in modal


transformation. All outputs have LMODES number of columns.

LFREQ Input-real-no default. Lower frequency limit of modes to use in modal


transformation.

HFREQ Input-real-no default. Upper frequency limit of modes to use in modal


transformation.

10-50 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

UNUSED5 Input-integer-no default. Unused.

UNUSED6 Input-integer-no default. Unused.

UNUSED7 Input-integer-no default. Unused.

NONCUP Output-integer-no default. If K2DD, B2DD, and M2DD are purged. the model
is considered uncoupled and NONCUP is set to -1.

FMODE Output-integer-default=1. The lowest mode number resulting from LMODES or


LFREQ and HFREQ.

KDAMP Input-integer-default=1. Viscous modal to structural damping flag. If set to -1,


viscous modal damping (SDAMPING Case Control command) is included in the
stiffness matrix as structural damping.

FLUID 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.

UNUSED12 Input-logical-default=FALSE. Unused.

Remarks:
1. GKAMW is the same as GKAM, except that GKAMW generates special modal matrices for
FRRDRU.

2. USETD can be purged if there are no extra points (NOUE<0).

3. PHA and LAMA cannot be purged.

4. CASECC and DIT cannot be purged if SDAMPING is specified.

5. M2DD, B2DD, K2DD, and MI can be purged.

6. MI can be purged. MI must be purged if generalized mass is to be extracted from LAMA.

7. No output matrix can be purged.

8. HFREQ and LFREQ are ignored if LMODES>0.

9. See the NX Nastran User‘s Guide for further details.

10.40 GLFONOTR
Glue normal and in-plane tractions.

Format:

GLFONOTR GNELM,UGLCURB,ELGNST,CASECC/
OQGGF1,OBG1/NROW/NVEC $

DMAP Programmer's Guide 10-51


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

GNELM Glue element definition table

UGLCURB Global displacements in basic coordinate system

ELGNST Table of glue element stiffness

CASECC Table of Case Control command images

Output Data Blocks:

OQGGF1 Glue forces at grid point in basic coordinate system

OBG1 Glue normal and tangential tractions at grid point in basic coordinate system

Parameters:

NROW Input-integer-no default. Number of rows in the glue force vector.

NVEC Input-integer-no default. Number of solution results to process.

10.41 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 Local eigenvector file (required).

LAMA Local eigenvalue file (required)

COLMAP Color map from GPARTN

BNDMAP Local boundary map from GPARTN

NUMCPU Number of dmp processors parameter (required)

Output Data Blocks:

PHIX Global eigenvector file

ERROR Merging error

10-52 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.42 GNFM
Computes element forces due to large displacements
Computes the element forces due to large displacements and optionally computes the elemental
stiffness matrices associated with incremental deflections.

Format:

GNFM KELM,KDICT,KDELM,KDDICT,EST,CSTM,UG,BGPDT/
FG,KELM1,KDICT1/
SKPMTX/LUSET/NSKIP $

Input Data Blocks:

KELM Table of element matrices for stiffness

KDICT KELM dictionary table

KDELM Table of element matrices for differential stiffness

KDDICT KDELM dictionary table

EST Element summary table

CSTM Table of coordinate system transformation matrices

UG Displacement matrix in g-set

BGPDT Basic grid point definition table

Output Data Blocks:

FG Element forces due to large displacements

KELM1 Table of element matrices for incremental stiffness

KDICT1 KELM1 dictionary table

Parameters:

SKPMTX Input-integer-default=0. If SKPMTX<>0, KELM1 and KDICT1 are generated.

LUSET Input-integer-default=0. The number of degrees-of-freedom in the g-set.

NSKIP Input-integer-default=0. Loop counter in old geometric nonlinear analysis.

Remarks:
1. FG cannot be purged.

2. KELM1 and KDICT1 can be purged if SKPMTX<>0.

DMAP Programmer's Guide 10-53


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.43 GP0
Modifies tables to include p-element information
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 Table of Case Control command images

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EPT Table of Bulk Data entry images related to element properties

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

PELSET P-element set table, contains SETS DEFINITIONS. Output by PLTSET.

PVAL0 P-value table generated by the ADAPT module in previous superelement,


adaptivity cycle, or run.

Output Data Blocks:

GEOM1M Table of Bulk Data entry images related to geometry and updated for the current
p-level

GEOM2M Table of Bulk Data entry images related to element connectivity and scalar points
and updated for the current p-level.

10-54 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

GEOM2A Table of secondary Bulk Data entry images related to element connectivity and
updated for the current p-level

GEOM3M Table of Bulk Data entry images related to static and thermal loads and updated
for the current p-level

GEOM4M Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity and updated for the current p-level

EHT Element hierarchical table for p-element analysis

EHTA Secondary element hierarchical table for p-element analysis

MEDGE Edge table for p-element analysis

MFACE Face table for p-element analysis

GDNTAB Table of grid points generated for p-element analysis

MBODY Body table for p-element analysis

Parameters:

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

UNIT1 Input-integer-default=0. Fortran unit number containing edge table information.

UNIT2 Input-integer-default=0. Fortran unit number containing face table information.

PVALID Output-integer-default=0. P-value set identification number.

PEXIST Output-logical-default=TRUE. Set to FALSE if p-elements are not present.

GNSTART Input-integer-default=0. First grid identification number in GEOM1M.

GNMAX Output-integer-no default. Maximum grid identification number in GEOM1M.

GMTOL Input-real-default=1.E-5. Geometric tolerance.

INITAPI Input-logical-default=TRUE. API flag.

PEDGEP Input-integer-default=0.

GNPROC Input-logical-default=TRUE. Grid-n processing flag. If set to TRUE, grid-n


information is processed.

10.44 GP1
Performs basic geometry processing

DMAP Programmer's Guide 10-55


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GDNTAB Table of grid points generated for p-element analysis

MEDGE Edge table for p-element analysis

SGPDT Superelement basic grid point definition table

DYNAMIC Table of Bulk Data entry images related to dynamics

Output Data Blocks:

GPL External grid/scalar point identification number list

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

GPDT Grid point definition table

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

SIL Scalar index list

VGF Fluid/structure partitioning vector with ones at the rows corresponding to fluid
degrees-of-freedom

GEOM3B Table of Bulk Data entry images related to static and thermal loads with DAREA
entry images converted to equivalent FORCE and MOMENT entry images

DYNAMICB Table of Bulk Data entry images related to dynamics without DAREA entry images

Parameters:

LUSET Output-integer-default=0. The number of degrees-of-freedom in the g-set.

NOCSTM Output-integer-no default. Number of coordinate systems found in GEOM1. Set


to -1 if none are found.

10-56 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

NOPOINTS Output-integer-no default. Grid point flag. Set to -1 if none are found. Otherwise,
set to 1.

UNIT Input-real-default=1.0. AUNIT record factor for electromagnetic analysis.

UPERM Input-real-default=1.2566E-06. Permeability for electromagnetic analysis.

UPRMT Input-real-default=8.8542E-12. Permittivity for electromagnetic analysis.

NUFLAG Input-integer-default=10. Unit type for electromagnetic analysis.

SEID Input-integer-default=-1. Superelement identification number.

NUMLM 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.

10.45 GP1EX
Modify the GEOM3 data block to convert external superelement loads via SELOAD bulk entries into
FORCE and MOMENT bulk entries.

Format:
GP1EX CASECC,GEOM1,GEOM3,BGPDTS,EQEXINS,SELOAD,PG/
GEOM3XSE,CASECCN/SEID/S,N,UPDATE $

Input Data Blocks:

CASECC Table of case control entries.

GEOM1 Table of bulk entry images related to geometry for the entire model.

GEOM3 Table of bulk entry images related to static and thermal loads for the entire model.

BGPDTS Basic grid point definition table for the external superelement.

EQEXINS Table to equivalence external and internal grid/scalar numbers for the external
superelement.

SELOAD DTI table for SELOAD bulk entry images.

PG External superelement load matrix in the g-set.

DMAP Programmer's Guide 10-57


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Blocks:

GEOM3XSE Table of bulk data entry images related to static and thermal loads for the entire
model that now contains FORCE and MOMENT bulk images to represent the
external superelement applied loads.

CASECCN Table of case control entries modified to contain sets related to SELOAD scaling
for static analysis.

Parameters:

SEID Input-integer-no default. Superelement ID of the external superelement.

UPDATE Output-integer-no default. GEOM3 update flag.


0 = GEOM3 not updated and GEOM3XSE not created
1 = GEOM3 updated and GEOM3XSE created

10.46 GP1LM
Add Lagrange rigids to geom2 table

Format:
GP1LM GEOM2,GEOM4/GEOMN/SEID/NUMLM $

Input Data Blocks:

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

Output Data Blocks:

GEOM2N Updated GEOM2 TABLE

Parameters:

SEID Input-integer. Superelement identification number.

NUMLM Output – integer. Number of Lagrange multipliers.

10.47 GP2
Processes element connectivity

10-58 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

GP2 GEOM2,EQEXIN,EPT,GEOM2A,UNUSED5/
ECT,ECTA/
S,N,ACOUSTIC $

Input Data Blocks:

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

EQEXIN Equivalence table between external and internal grid/scalar identification


numbers

EPT Element property table

GEOM2A Table of secondary Bulk Data entry images related to element connectivity and
updated for the current p-level

UNUSED5 Unused and can be purged

Output Data Blocks:

ECT Element connectivity table

ECTA Secondary element connectivity table

Parameter:

ACOUSTIC Output-integer-default=0. Fluid-structure analysis flag.

0 No fluid elements exist.

1 Penalty or fluid acoustic elements exists.

2 Fluid/structure coupling exists.

Remarks:

1. EQEXIN and ECT cannot be purged.

2. ECTA can be purged if GEOM2A is purged.

10.48 GP3
Processes static and thermal loads

DMAP Programmer's Guide 10-59


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

GP3 GEOM3,EQEXIN,GEOM2,EDT,UGH,ESTH,BGPDTH,CASEHEAT,CASECC,GEOM5/
SLT,ETT,CASECCN/
S,N,NOLOAD/S,N,NOGRAV/S,N,NOTEMP $

Input Data Blocks:

GEOM3 Table of Bulk Data entry images related to static and thermal loads

EQEXIN Table to equivalence external to internal grid/scalar numbering

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries

UGH Temperature matrix in g-set from a heat transfer analysis

ESTH Element summary table from a heat transfer analysis

BGPDTH Basic grid point definition table from a heat transfer analysis

CASEHEAT Case Control table from a heat transfer analysis

CASECC Case Control table (only required for SELOAD processing)

GEOM5 Table of bulk data entry images related to thermal loads from external files

Output Data Blocks:

SLT Table of static loads

ETT Element temperature table

CASECCN Case Control table modified with SELOAD scaling factors

Parameters:

NOLOAD Output-integer-no default. Static load existence flag. Set to -1 if no static loads
and SLT is not created, +1 otherwise.

NOGRAV Output-integer-no default. Gravity load existence flag. Set to -1 if no GRAV


Bulk Data entry images, +1 otherwise.

NOTEMP Output-integer-no default. Thermal load existence flag. Set to -1 if no TEMP or


TEMPD Bulk Data entry images in GEOM3 and ETT is not created, +1 otherwise.

Remarks:
1. BGPDTH cannot be purged.

10-60 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 (WHERE APRCH=‘HEAT ’AND WILDCARD) $


DBVIEW ESTH=EST (WHERE APRCH=‘HEAT ’) $
DBVIEW (WHERE APRCH=‘HEAT ‘) $
BGPDTH=BGPDTS

CASEHEAT can come from the CASE module or DBLOCATE DATABLK=


(CASECCR/CASEHEAT) in the FMS.

5. CASECC is only needed for processing of SELOAD bulk data in a static analysis. CASECCN will
only be created if CASECC is present and only if SELOADs are referenced in the analysis.

10.49 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,DYNAMIC/
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/AMPCZ/RSONLY/NLBEAR $

Input Data Blocks:

CASECC Table of Case Control command images

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

SIL Scalar index list

DMAP Programmer's Guide 10-61


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

GPDT Grid point definition table

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

MEDGE Edge table for p-element analysis

MFACE Face table for p-element analysis

MBODY Body table for p-element analysis

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GDNTAB Table of grid points generated for p-element analysis

GPECT0 Grid point element connection table

DYNAMIC Table of bulk data entry images related to dynamics.

Output Data Blocks:

RMG Multipoint constraint equation matrix

YS0 Matrix of enforced displacements

USET0 Degree-of-freedom set membership table for g-set

PARTV Partitioning vector of enforced motion dof

Parameters:

LUSET Input-integer-default=0. The number of degrees-of-freedom in the g-set.

NOMSET Output-integer-no default. Number of degrees-of-freedom in the m-set or


multipoint constraint and rigid element flag. Set to -1 if there are none.

MPCF2 Output-integer-no default. Multipoint constraint set identification number change


flag. Set to 1 if the current subcase contains a different multipoint constraint
set from the previous subcase. Set to -1 otherwise or if there are no multipoint
constraints in the current subcase.

NOSSET Output-integer-no default. Number of degrees-of-freedom in the s-set. or single


point constraint flag. Set to -1 if there are none.

NOOSET Output-integer-no default. Number of degrees-of-freedom in the o-set or omitted


degree-of-freedom flag. Set to -1 if there are none.

NORSET Output-integer-no default. Number of degrees-of-freedom in the r-set. or


supported degree-of-freedom flag. Set to -1 if there are none.

10-62 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

NSKIP Input/output-integer-no default. The record number in CASECC corresponding to


the first subcase of the current boundary condition.

REPEAT Output-integer-no default. Last boundary condition flag. Set to -1 at the last
boundary condition; +1 otherwise.

NOSET Output-integer-no default. Constraint, omit, and support set flag. Set
to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no
degrees-of-freedom defined in the a-set (for example, ASETi, QSETi Bulk Data
entries); +1 otherwise.

NOL Output-integer-default=1. Dependent set flag. Set to -1 if all degrees-of-freedom


belong to m-set, s-set, o-set, and/or r-set; otherwise, the degrees-of-freedom in
the l-set.

NOA Output-integer-default=1. Constraint and omit set flag. Set to -1 if NOMSET=-1,


NOSSET=-1, and NOOSET=-1; otherwise the number of degrees-of-freedom
in the a-set.

SEID Input-integer-default=0. Superelement identification number.

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

SEBULK Input-logical-default=FALSE. Partitioned superelement presence flag. Set to


TRUE if partitioned superelements are present or BEGIN SUPER is specified for
the first BEGIN BULK Case Control command.

DMAPNO Input-Integer-default=0. Solution sequence number stored in word 244 of the


case control record.

AUTOMPC Input-character-default=no. Specifies that the software automatically select the


m-set dofs rather than use the m-set values as specified on MPC or RIGID element
cards. See the AUTOMPC parameter in the Quick Reference Guide for details.

AMPCZ Input-real-default=1.0e-6. The zero tolerance for pivot elements in the AUTOMPC
process.

RSONLY Input-logical-default=FALSE. Residual structure only flag.

NLBEAR Input-logical-default=FALSE. Flag indicating presence of nonlinear bearings.

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.

DMAP Programmer's Guide 10-63


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.50 GP5
Creates table of static loads for panels in coupled fluid/structure analysis.

Format:

GP5 ECT,BGPDT,EQEXIN,EDT,SIL,GEOM2/
PANSLT,EQACST,NORTAB/
S,N,MPNFLG/S,N,NUMPAN/S,N,MATCH/NASOUT/GETNUMPN/
S,N,METHOD/S,N,SKINOUT/S,N,NORMAL/S,N,OVLPANG/
S,N,INTOL/S,N,ABSFLG/S,N,NGAUSS $

Input Data Blocks:

ECT Element connectivity table

BGPDT Basic grid point definition table

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 and SET3 entries

SIL Scalar index list

GEOM2 Table of bulk data images related to element connectivity

Output Data Blocks:

PANSLT Panel static load table

EQACST Equivalence table between internal fluid grid points and internal structural grid
points which lie on the fluid/structure boundary. Output by GP5.

NORTAB Table containing fluid face and the maximum of eight structural grids which lie
within the acoustic face

Parameters:

MPNFLG Output-integer-default=0. Set to 1 if multiple panels exist.

NUMPAN Output-integer-default=1. Number of panels.

MATCH Output-integer-default=0. Type of fluid/structural mesh matching.

0 Matching mesh

1 Non-meshing mesh

NASOUT Input-logical-default=TRUE. Print flag for fluid/structural mesh matching


summary.

10-64 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

GETNUMPN Input-logical-default=FALSE. Panel static load computation flag. If TRUE, get


number of panels flag only and do not compute panel static loads.

METHOD Output-character-default=”AS”. Fluid/structural coupling method. When = “AS”,


the new accelerated coupling method is used. When = “CP”, the old coupling
method is used.

SKINOUT Input-character-default=”NONE”. Requests coupling debug punch file. When =


“PUNCH”, a debug input file and punch file are output. Available only when
METHOD = “AS”.

NORMAL Output-real-default=0.2 when METHOD = “AS”; when = .001 METHOD = “CP”.


Determines coupling search distance.

OVLPANG Output-real-default=30 degrees. Overlapping angular tolerance in degrees. Used


only when METHOD = “AS”.

INTOL Input-real-See the ACMODL bulk data entry in the Quick Reference Guide for
defaults. Inward normal search distance to detect fluid-structure interface.

ABSFLG Input-logical-default=”FALSE”. When “TRUE”, the ABSOLUTE values for search


distance are used. Else, use the relative search distance.

NGAUSS Input-integer-default=0. Number of gauss points.

10.51 GP6
Converts NSML and NSML1 into NSM and NSM1 cards.

Format:

GP6 ECT,IEPT,BGPDT,CSTM/EPTNSML/S,N,EPTNSML $

Input Data Blocks:

ECT Element connectivity table

IEPT Table of bulk data entry images related to element properties

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

Output Data Blocks:

EPTNSML EPT updated from NSML and NSML1 records

DMAP Programmer's Guide 10-65


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

EPTNSML Output-Integer-Default=0. EPTNSML Creation Flag (0: No; -1: Yes)

10.52 GP7
Generates TEMP, TEMPD, and DTEMP bulk data entries for DTEMPEX and TEMPEX bulk data
entries. The TEMP, TEMPD and DTEMP bulk data entries for nodal temperatures are created by
reading the bun files assigned to the DTEMPEX and TEMPEX bulk data entries. The new bulk data
entries are stored in the GEOM5 output data block.

Format:

GP7 GEOM3/
GEOM5/
S,N,NOGOGP7/UNITSYS $

Input Data Blocks:

GEOM3 Table of bulk data entry images related to static and thermal loads

Output Data Blocks:

GEOM5 Table of bulk data entry images related to thermal loads from external files

Parameters:

NOGOGP7 Output-logical-default=FALSE. Output data of type logical for GO/NOGO flag. If


TRUE, abort.

UNITSYS Input-character-no default. Stores the NX unit system. For valid entries, see the
UNITSYS parameter in the NX Nastran Quick Reference Guide.

Remarks:

1. For a TEMPEX bulk data entry, a TEMP bulk data entry is created for each nodal temperature. All
of the TEMP bulk data entries have the same SID. For DTEMPEX bulk data entries, TEMP bulk
data entries are created at each time instant. All TEMP bulk data entries at the same time instant
have a unique SID. An additional DTEMP bulk data entry is created to represent the time-varying
temperature field of the DTEMPEX bulk data entry.

2. It is possible to assign a TEMPD and a DTEMPEX with same SID. For such cases, a TEMPD
bulk data entry is also created at each time instant along with the TEMP bulk data entries. In
this case, the SID of the TEMPD bulk data entry at each instant is same as the SID of the
corresponding TEMP bulk data entry.

10-66 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.53 GPARTN
Graph partitioning used for DMP solutions.

Format:

GPARTN KXX,MXX,USET,SILS,EQEXINS/
KXX1,MXX1,EQMAP,GAPAR,VFO1,USET1,SIL1,
EQEXIN1,SPCCOL,MAPFIL,COLMAP,BNDMAP/
NUMCPU/GLOBDOF/LOCDOF/BNDDOF/OPTION $

Input Data Blocks:

KXX Global stiffness matrix file (required)

MXX Global mass matrix file (required)

USETS Global set definition data (required only for OPTION=1)

SILS Global scalar index list (required only for OPTION=1)

EQEXINS Global external/internal list (required only for OPTION=1)

NUMCPU Number of dmp processors parameter (required)

Output Data Blocks:

KXX1 Local stiffness matrix partition file (including global boundary)

MXX1 Local mass matrix partition file (including global boundary)

USET1 Local set definition data.

SIL1 Local scalar index list

EQEXIN1 Local external/internal list

EQMAP Local interior/boundary information data

GAPAR Local a-set partitioning vector

VF01 Local f-set partitioning vector

SPCCOL Local spc dof partitioning vector

DMAP Programmer's Guide 10-67


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

MAPFILE 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

COLMAP Color map from GPARTN

BNDMAP Local boundary map from GPARTN

GLOBDOF Global degrees of freedom parameter

LOCDOF Local degrees of freedom parameter

BNDDOF Boundary degrees of freedom parameter

OPTION Partitioning (1) or graph information generation (2) parameter

10.54 GPFDR
Computes grid point forces and element strain energy

Format:

GPFDR CASECC,UG,KELM,KDICT,ECT,EQEXIN,GPECT,PG,QG,
BGPDT,{LAMA or FOL or TOL or OLF},CSTM,VELEM,PTELEM,
QMG,NFDICT,FENL,MELM,MDICT,BELM,BDICT,MDLIST/
ONRGY1,OGPFB1,OEKE1,OEDE1/
APP/TINY/XFLAG/CYCLIC/WTMASS/S,N,NOSORT2 $

Input Data Blocks:

CASECC Table of Case Control command images

UG Displacement matrix in g-set

KELM Table of element matrices for stiffness

KDICT KELM dictionary table

ECT Element connectivity table

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

GPECT Grid point element connection table

PG Static load matrix for the g-set

10-68 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

QG Single-point constraint forces of constraint matrix in the g-set

BGPDT Basic grid point definition table

LAMA Eigenvalue summary table for normal modes. Required for APP=‘REIG’

FOL Frequency output list. Required for APP=‘FREQRESP’

TOL Time output list. Required for APP=‘TRANRESP’

OLF Nonlinear static load factor list. Required for APP=‘NLST’

SIL Scalar index list

CSTM Table of coordinate system transformation matrices

VELEM Table of element lengths, areas, and volumes

PTELEM Table of thermal loads in the elemental coordinate system

QMG Multipoint constraint forces of constraint matrix in the g-set

NFDICT Nonlinear element energy/force index table

FENL Element energy and forces in nonlinear matrix format

MELM Elemental matrices for mass

MDICT Dictionary table for MELM

BELM Elemental matrices for damping

BDICT Dictionary table for BELM

MDLIST Selected mode list from EFFMAS

Output Data Blocks:

ONRGY1 Table of element strain energies and energy densities in SORT1 format.

OGPFB1 Table of grid point forces in SORT1 format.

OEKE1 Elemental kinetic energy in SORT1 format.

OEDE1 Elemental energy loss in SORT1 format.

Parameters:

APP Input-character-no default. Analysis type. Allowable types are:

‘STATICS’ Linear statics

DMAP Programmer's Guide 10-69


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

‘REIG’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘NLST’ Nonlinear static

TINY Input-real-default=1.E-03. Small element strain energy value. Element strain


energies less than TINY are not printed.

XFLAG Input-integer-default=0. Strain energy method selection.

0 Elemental force

1 Cross displacement. See Remark 2.

CYCLIC Input-logical-default=FALSE. Set to TRUE for cyclic symmetry models.

WTMASS Input-real-default=1.0. Specifies scale factor on elemental mass matrix.

NOSORT2 Output-integer-default=-1. SORT2 format flag for OGPFB1 data block. Set to 1 if
SORT2 format is requested; –1 otherwise.

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 10-2.
If XFLAG=1:

Equation 10-3.

10-70 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

10.55 GPFTOTL
Recalculates the totals for grid point force output.

Format:

GPFTOTL OGPFIN/OGPFOU $

Input Data Blocks:

OGPFIN Grid point force balance data block (SORT1 format) for which grid point force
balance totals are to be recalculated.

Output Data Blocks:

OGPFOU Resulting grid point force balance data block (SORT1 format).

Parameters:

None

10.56 GPFXPND
Expands a grid point force output data block based on a template.

Format:

GPFXPND OGPFTMP,OGPFIN/OGPFOU $

Input Data Blocks:

OGPFTMP Grid point force balance data block to be used as a template (SORT1 format).

OGPFIN Grid point force balance data block (SORT1 format) to be expanded.

DMAP Programmer's Guide 10-71


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Blocks:

OGPFOU Resulting grid point force balance data block (SORT1 format).

Parameters:

None

10.57 GPJAC
Checks element Jacobians

Format:

GPJAC ECT,BGPDT//S,N,JACDET $

Input Data Blocks:

ECT Element connectivity table

BGPDT 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.

10.58 GPSP
Performs auto-SPC operation

Performs auto-SPC operation; that is, identifies and automatically constrains singularities.

10-72 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

GPSP

Input Data Blocks:

KNN Stiffness matrix in n-set; after multipoint constraint reduction

KGG Stiffness matrix in g-set

KMM Stiffness matrix in m-set

RMG Multipoint constraint equation matrix

USET0 Degree-of-freedom set membership table for g-set

SIL Scalar index list

GPL External grid/scalar point identification number list

YS0 Matrix of enforced displacements

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

Output Data Blocks:

USET Degree-of-freedom set membership table for g-set

YS Matrix of enforced displacements in the s-set

BD3X3 3x3 diagonal strip for boundary degrees-of-freedom from KGG for parallel domain
decomposition

Parameters:

NOSSET Output-integer-default=0. Number of degrees-of-freedom in the s-set. or single


point constraint flag. Set to -1 if there are none.

AUTOSPC Input-character-default=‘YES’ Automatic constraint flag. If set to ‘YES‘,


singularities are constrained.

DMAP Programmer's Guide 10-73


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

PRGPST Input-character-default=‘YES’ Singularity summary print flag. If set to ‘YES‘, the


summary is printed.

SPCGEN 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.

EPZERO Input-real-default=1.E-8. Singularity test parameter. Singularities greater than


EPZERO are not constrained.

ACON Input-integer-default=0. B-set constraint flag. If ACON<0, b-set


degrees-of-freedom are constrained if AUTOSPC=‘YES’

SING Output-integer-default=0. Singularity flag. If singularities are found, SING is set to


-1; otherwise +1.

EPPRT Input-real-default=0.0. Singularity print parameter. Singularities greater than


EPPRT are not printed if PRGPST=‘YES’

NOSET Input/output-integer-default=0. Constraint, omit, and support set flag. Set


to -1 if NOMSET=-1, NOSSET=-1, NOOSET=-1, NORSET=-1 and no
degrees-of-freedom defined in the a-set (for example, ASETi, QSETi Bulk Data
entries); +1 otherwise.

NGERR Output-integer-default=0. Error flag. If errors are encountered, NGERR is set to


-1; otherwise +1.

MPCMETH Input-character-default=‘RG’ Multipoint constraint processing method. Also


indicates the type of matrix in the second input position: ‘RG’for RMG and
‘KMM’for KMM. See Remarks 2 and 3.

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 USET0,KGG/KMM,,,/‘G‘/‘M‘/‘N’$
MCE2 USET0,GM,KGG,,,/KNN,,, $
GPSP 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.

10-74 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

4. ACON should be set to -1 if processing a superelement.

10.59 GPSTR1
Computes element to grid point interpolation factors

Format:

GPSTR1 POSTCDB,BGPDT,EST,CSTM,ELSET,ESTNL,UNUSED7,CASECC/
EGPSF/
S,N,NOEGPSF $

Input Data Blocks:

POSTCDB Table of commands from the OUTPUT(POST) section of Case Control

BGPDT Basic grid point definition table

EST Element summary table

CSTM Table of coordinate system transformation matrices

ELSET Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section


of Case Control

ESTNL Nonlinear element summary table

UNUSED7 Unused and can be purged

CASECC 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.

10.60 GPSTR2
Computes grid point stresses or strains
Computes grid point stresses or strains interpolated from element centroid stresses or strains.

DMAP Programmer's Guide 10-75


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

GPSTR2 CASECC,EGPSF,BGPDT,OES1,OESNLXR/
OGS1,EGPSTR,OGSR1/
S,N,NOOGS1/S,N,NOEGPSTR/APP/NLSTRAIN $

Input Data Blocks:

CASECC Table of Case Control command images

EGPSF Table of element to grid point interpolation factors

BGPDT Basic grid point definition table

OES1 Table of element stresses or strains in SORT1 format

OESNLXR Table of nonlinear element stresses in SORT1 format and appended for all
subcases

Output Data Blocks:

OGS1 Table of grid point stresses or strains in SORT1 format

EGPSTR Table of grid point stresses or strains for post-processing in the DBC module

OGSR1 Table of raw grid point stresses or strains in SORT1 format.

Parameters:

NOOGS1 Output-integer-default=-1. OGS1 creation flag. Set to 0 if OGS1 is created.

NOEGPSTR Output-integer-default=-1. EGPSTR creation flag. Set to 0 if EGPSTR is created.

APP Input-character-default=‘STATICS’ Analysis type. Allowable values are:

‘STATICS’: statics
‘REIGEN’: normal modes
‘TRANRESP’: transient response

NLSTRAIN Logical-input-default=FALSE. Nonlinear strain data recovery, otherwise 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.

10-76 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.61 GPWG
Computes center of mass of structure relative to a given point
Computes the center of mass of the structure relative to a given point and the principal inertias
about the center of gravity.

Format:

GPWG BGPDT,CSTM,UNUSED3,MGG,MEDGE,UNUSED6/
OGPWG/
GRDPNT/WTMASS/ALTSHAPE/SEID $

Input Data Blocks:

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

UNUSED3 Unused and can be purged

MGG Mass matrix in g-size

MEDGE Edge table for p-element analysis

UNUSED6 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.

WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

SEID Input-integer-default=-1. Superelement identification number.

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.

DMAP Programmer's Guide 10-77


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

3. GPWG calculates the masses, centers of gravity, and inertias of the general mathematical model
of the structure. The data are extracted from the [Mgg] matrix by using a rigid body transformation
calculation. The transformation is defined by the global coordinate displacements resulting from
unit translations and rotations of the whole body about a reference point.

4. Because of the scalar mass effects, the total mass 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.

10.62 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 Table of Case Control command images

DLT Table of dynamic loads

FRL Frequency response list

DIT Table of TABLEij Bulk Data entry images

QHJL Aero transformation matrix between h and j sets

UNUSED6 Unused and can be purged

UNUSED7 Unused and can be purged

ACPT Aerodynamic connection and property table

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set and
ks-set grid points

PHF Frequency response load matrix in the h-set (modal)

10-78 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

PHF1 Frequency response load matrix in the h-set (modal) combined with gust loads

WJ Gust matrix

QHJK Aero transformation matrix between h and j sets

PFP Frequency response load matrix in the p-set combined with gust loads

Parameters:

NOGUST Output-integer-no default. Gust load flag. Set to -1 if no gust loads exist;
otherwise set to 1.

BOV Input-real-default=0.0. Conversion from frequency to reduced frequency.

MACH Input-real-default=0.0. Mach number.

Q Input-real-default=0.0. Dynamic pressure.

Remarks:

1. If DIT is purged, GUST 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.)

10.63 IFP
Reads Bulk Data Section

DMAP Programmer's Guide 10-79


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Reads in the Bulk Data and outputs the finite element model in table form.

Format:

IFP BULK/
GEOM1,EPT,MPT,EDT,DIT,DYNAMIC,GEOM2,
GEOM3,GEOM4,EPTA,PCOMPT,MATPOOL,AXIC,PVT,DMI,
DMINDX,DTI,DTINDX,DEFUSET,EDOM,DEQATN,DEQIND,
CONTACT,OINT,UNUSED25/
S,N,NOGOIFP/S,N,RUNIFP3/S,N,RUNIFP4/
S,N,RUNIFP5/S,N,RUNIFP6/S,N,RUNIFP7/S,N,RUNIFP8/
S,N,RUNIFP9/SEID/S,N,RUNMEPT $

Input Data Block:

BULK Table of all Bulk Data entries

Output Data Blocks:

GEOM1 Table of Bulk Data entry images related to geometry

EPT Table of Bulk Data entry images related to element properties

MPT Table of Bulk Data entry images related to material properties

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 and SET3 entries.

DIT Table of TABLEij Bulk Data entry images

DYNAMICS Table of Bulk Data entry images related to dynamics

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EPTA Secondary table of Bulk Data entry images related to element properties

PCOMPT Table containing LAM option input from the PCOMP bulk entry.

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

AXIC Table of Bulk Data entry images related to conical shell, hydroelastic, and
acoustic cavity analysis

PVT Table containing parameter values from PARAM Bulk Data entry images

DMI Table of all matrices specified on DMI Bulk Data entries

10-80 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

DMINDX Index into DMI

DTI Table of all matrices specified on DTI Bulk Data entries

DTlNDX Index into DTI

DEFUSET Table of DEFUSET Bulk Data entry images

EDOM Table of Bulk Data entries related to design sensitivity and optimization

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

CONTACT Table of Bulk Data entries related to contact regions

OINT P-element output control table. Contains OUTPUT Bulk Data entries.

UNUSED25 Unused and can be purged

Parameters:

NOGOIFP Logical-output-default=FALSE. Set to TRUE if an error is detected.

RUNIFPi Logical-output-default=FALSE. Set to TRUE if IFPi module execution is required.

SEID Integer-input-default=-1. Superelement identification number.

RUNMEPT Logical-output-default=FALSE. Set to TRUE if MODEPT module execution is


required.

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 $
ELSE $
EQUIVX GEOM1.1/GEOM1.3/-1 $

DMAP Programmer's Guide 10-81


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 $

10.64 IFP1
Reads Case Control Section

Format:

IFP1 /CASECC,PCDB,XYCDB,POSTCDB,FORCE,SETMC/S,N,NOGOIFP1/
S,N,LASTCC/S,N,BEGSUP/DMAPNO $

Output Data Blocks:

CASECC Table of Case Control command images.

10-82 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

PCDB Table of model (undeformed and deformed) plotting commands

XYCDB Table of x-y plotting commands

POSTCDB Table of commands from the OUTPUT(POST) section of Case Control

FORCE Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS)


section in CASE CONTROL and MSGMESH field information

SETMC Table of SETMC commands

Parameter:

NOGOIFP1 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Case


Control Section.

LASTCC Integer-output-default=0. Set to 2 if the last auxiliary model Case Control section
is being processed.

BEGSUP Logical-output-default=FALSE. BEGIN SUPER flag. Set to TRUE if the first Bulk
Data section begins with BEGIN SUPER instead of BEGIN BULK.

DMAPNO 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 $
PARAML XCASECC//‘DTI‘/1/258//S,N,AUXMID $
EQUIVX XCASECC/CASEXX/-1 $
EQUIVX XPCDB/PCDB/-1 $
EQUIVX XXYCDB/XYCDB/-1 $
EQUIVX XPOSTCDB/POSTCDB/-1 $
EQUIVX XFORCE/FORCE/-1 $
ENDDO $

DMAP Programmer's Guide 10-83


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.65 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 GEOM1 table related to axisymmetric conical shell analysis

GEOM2X GEOM2 table related to axisymmetric conical shell analysis

GEOM3X GEOM3 table related to axisymmetric conical shell analysis

GEOM4X GEOM4 table related to axisymmetric conical shell analysis

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 Output records Output data blocks

AXIC None None

CCONEAX CCONE GEOM2

FORCEAX FORCE GEOM3

MOMAX MOMENT GEOM3

MPCAX MPC GEOM4

10-84 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Bulk data entry record Output records Output data blocks

OMITAX OMIT GEOM4

POINTAX MPC GEOM4

GRID GEOM1

PRESAX PLOAD GEOM3

RINGAX SPC GEOM4

GRID GEOM1

SECTAX MPC GEOM4

GRID GEOM1

SPCAX SPC GEOM4

SUPAX SUPORT GEOM4

TEMPAX TEMP GEOM3

4. The other Bulk Data entries recognized and processed by IFP3 are:

FORCE
GRAV
LOAD
MOMENT
TEMPD
TEMP
GRID
MPCADD
OMIT
SEQGP
SPC
SPCADD
SUPORT

Example

See the example in the “IFP” module description.

DMAP Programmer's Guide 10-85


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.66 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 Table of Bulk Data entry images related to axisymmetric conical shell,
hydroelastic, and acoustic cavity analysis

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

Output Data Blocks:

GEOM1X GEOM1 table related to hydroelastic analysis

GEOM2X GEOM2 table related to hydroelastic analysis

GEOM4X GEOM3 table related to hydroelastic analysis

MATPOOLX MATPOOL table related to hydroelastic analysis

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:

Bulk data entry record Output tecords Output data blocks

AXIF None None

10-86 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Bulk data entry record Output tecords Output data blocks

BDYLIST Various MATPOOLX

CFLUID2 CFLUID2 GEOM2X

CFLUID3 CFLUID3 GEOM2X

CFLUID4 CFLUID4 GEOM2X

FLSYM Various MATPOOLX

FREEPT SPOINT GEOM2X

MPC GEOM4X

FSLIST CFSMASS GEOM2X

SPC GEOM4X

GRIDB GRID GEOM1X

PRESPT SPOINT GEOM2X

MPC GEOM4X

RINGFL GRID GEOM1X

SEQGP GEOM1X

DMIAX DMIG MATPOOLX

Example:
See the example in the “IFP” module description.

10.67 IFP5
Process acoustic cavity-related Bulk Data entry records

Format:

IFP5 AXIC,GEOM1,GEOM2/
GEOM1X,GEOM2X/S,N,NOGOIFP5 $

Input Data Blocks:

AXIC Table of Bulk Data entry images related to axisymmetric conical shell, hydroelastic,
and acoustic cavity analysis

GEOM1 Table of Bulk Data entry images related to geometry

DMAP Programmer's Guide 10-87


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

Output Data Blocks:

GEOM1X GEOM1 table related to acoustic cavity analysis

GEOM2X 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 Input data block Output record Output data block

AXSLOT AXIC None None

CAXIF2 GEOM2 PLOTEL GEOM2X

CAXIF3 GEOM2 PLOTEL GEOM2X

CSLOT3 GEOM2 PLOTEL GEOM2X

CSLOT4 GEOM2 PLOTEL GEOM2X

CAXIF4 GEOM2 PLOTEL GEOM2X

GRIDF AXIC GRID GEOM1X

GRIDS AXIC GRID GEOM1X

SLBDY AXIC CELAS2 GEOM2X

Example:
See the example in the “IFP” module description.

10.68 IFP6
Creates PSHELL and MAT2 Bulk Data entry records

10-88 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Table of Bulk Data entry images related to element properties, in particular,
PSHELL and PCOMP entries

MPT Table of Bulk Data entry images related to material properties, in particular, MAT2
and MAT8 entries

DIT Table of TABLEij Bulk Data entry images

PCOMPT Table containing LAM option input from the PCOMP Bulk Data entry

Output Data Blocks:

EPTC A copy of EPT except that PCOMP records are replaced by equivalent PSHELL
records

MPTC A copy of MPT except that MAT8 records are replaced by equivalent MAT2 records

PCOMPTC A table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

Parameter:

NOGOIFP6 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk


Data entries.

NOCOMP Integer-output-default=0. Set to 1 if MAT8 and PCOMP Bulk Data entry records
are found.

DSFLAG Input-logical-default=FALSE. Design sensitivity flag. Set to TRUE for design


sensitivity job.

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.

DMAP Programmer's Guide 10-89


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Example:

See the example in the “IFP” module description.

10.69 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 Table of Bulk Data entry images related to element connectivity and scalar points

EPT Table of Bulk Data entry images related to element properties; in particular,
PBCOMP entries

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

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.

Example:

See the example in the “IFP” module description.

10-90 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.70 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 Table of Bulk Data entry images related to material properties

DIT 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.

10.71 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.

DMAP Programmer's Guide 10-91


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

IFP9 EPT/EPTX/S,N,NOGOIFP9/PBRPROP $

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

Parameters:

NOGOIFP9 Logical-output-default=FALSE. Set to TRUE if an error is detected in the Bulk


Data entries.

PBRPROP Input-character-default=’NO’. Flag to select the Pilkey method for calculating


PBEAML and PBARL cross section properties.

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.

10.72 IFPINDX
Creates an IFP table index keyed by identification number

Format:

IFPINDX /IFPDB $

Input Data Blocks:

None.

10-92 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

10.73 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 Solution matrix from frequency response analysis in d- or h-set

CASECC Table of Case Control command images

TRL Transient response list

FOL Frequency response frequency output list

Output Data Blocks:

UXT Solution matrix from transient response analysis in d- or h-set

TOL Transient response time output list

Parameters:

IFTM Input-integer-default=1. Fourier transform method.

DMAP Programmer's Guide 10-93


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

0 Constant

1 Piecewise linear (default)

2 Cubic spline

10.74 IN4WA
Reads binary input file in special format for use with AMLS. Similar to INPUTT4 with IUNIT = 46.

Format:

IN4WA /DB/IUNIT/VSIZE $

Output Data Blocks:

DB Matrix stored in binary file.

Parameters:

IUNIT Integer-input-default=0. FORTRAN unit number (typically 46). The module will
open a file named ‘fort.IUNIT’.

VSIZE Integer-input-default=0. Size of output vector.

Remarks:

The INPUTT4 module may be used similarly as follows:


NASTRAN SYSTEM(459) = 0
ASSIGN INPUTT4 = ‘fort.46’
.....
.....
INPUTT4/DB,,,,/1/46/VSIZE $

10.75 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/NDDLNAM1/
NDDLNAM2/NDDLNAM3/NDDLNAM4/NDDLNAM5/S,N,HNAME1/S,N,HNAME2/
S,N,HNAME3/S,N,HNAME4/S,N,HNAME5 $

10-94 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

ITAPE value Action

+n Skip forward n data blocks before reading.

0 Data blocks are read starting at the current position.

-1 Rewind before reading, position tape past label (LABL).

-3 Print data block names and rewind before reading (checks LABL).

IUNIT Input-integer-no default. IUNIT is the FORTRAN unit number from which the
data blocks are to be read. Siemens PLM Software does not recommend using
IUNIT = 0.

LABL Input-character-default = ’XXXXXXXX’. LABL is the label on the FORTRAN unit.


A check of the label may or may not be performed based on the value of ITAPE as
indicated in the following table.

ITAPE value Tape label checked

+n No

0 No

-1 Yes

-3 Yes (Warning Check)

NDDLNAMi Input-character-default = blank. NDDL names corresponding to DB1 through DB5.


If DBi is a matrix, then the corresponding NDDLNAMi should be ‘MATRIX’.

HNAMEi Output-character-default = blank. Names of the data block as they appear in


the OP2 file being read.

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

DMAP Programmer's Guide 10-95


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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. Siemens PLM Software 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.

6. If the NDDLNAMi is left blank, then the corresponding DMAP name (DB1 through DB5) is
assumed to be the NDDL-defined name.

Example:

INPUTT2 /GEOM2,BGPDT,,,/-1/25/'NX6.0'/'GEOM2'/'BGPDT' $

10.76 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 Input-integer-default=1. NMAT is the number of matrices that have been written
on the user-supplied unit. Must be less than or equal to 5.

IUNIT Input-integer-no default. The value of IUNIT is the FORTRAN unit number on
which the user-supplied matrix was written.

ITAPE Input-integer-default=-1. ITAPE controls the status of the unit before INPUTT4
tries to extract any matrices as follows:

10-96 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

ITAPE Action

0 None

-1 Rewind IUNIT before read

-2 Rewind IUNIT at end

-3 Both

UNUSED4 Input-integer-default=1. Unused.

BIGMAT Input-logical-default=FALSE. BIGMAT = FALSE selects the format that uses a


string header as described under Remark 1. But if the matrix has more than 65535
rows, BIGMAT is automatically set to TRUE regardless of the value specified.

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
WRITE(8,100) NCOL,NROW,NF,NTYPE
100 FORMAT(4I8)

Record 2,3, and so on


WRITE(8,200) ICOL,IROW,NW,(X(I),I=1,NW)
200 FORMAT(3I8,(1P,5E16.9))

The format for X(I) above must be (1P,rEw.d),


where d is the number of digits in the fractional part, w must be greater than d+7, and r is
the integer part of 80/w.

• The 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.)

DMAP Programmer's Guide 10-97


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

• 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. Siemens PLM Software 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.

10.77 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 Table of Case Control command images

DIT Table of TABLEij Bulk Data entry images

DYNAMIC Table of Bulk Data entry images related to dynamics

ZETAH Mass-normalized damping

FN Matrix of natural frequencies (mass normalized stiffness)

SPECSEL Response spectra input correlation table

PSI Modal partitioning factor matrix

Output Data Block:

UHR Modal displacement vector for spectral analysis

10-98 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

10.78 ISHELL
Invokes an external program

Format:

ISHELL //PRGNAME/S,N,IRTN/NOINT/NOREAL/NOCMPX/NOCHAR/NOUNIT/
INT1 /INT2 /INT3 /INT4 /
REAL1/REAL2/REAL3/REAL4/
CMPX1/CMPX2/CMPX3/CMPX4/
CHAR1/CHAR2/CHAR3/CHAR4/
IUNIT1/IUNIT2/IUNIT3/IUNIT4 $

Input Data Blocks:

None.

Output Data Blocks:

None.

Parameters:

PRGNAME Input-character-no default. Name of external program.

IRTN Output-integer-default=0. External program return code. -1 indicates failure.

NOINT Input-integer-default=0. Number of integer value inputs.

DMAP Programmer's Guide 10-99


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

NOREAL Input-integer-default=0. Number of real value inputs.

NOCMPX Input-integer-default=0. Number of complex value inputs.

NOCHAR Input-integer-default=0. Number of character value inputs.

NOUNIT Input-integer-default=0. Number of Fortran input units.

INTi Input-integers-default=0. Integer values.

REALi Input-real-default=-1.0. Real values.

CMPXi Input-complex-default=(-1.0,0.0). Complex values.

CHARi Input-character-default=‘NULLNULL’ Character values.

IUNITi Input-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. PRGNAME cannot be more
than 8 characters long.

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. The name of external program must be uppercase and limited to 8 characters.

5. The unit numbers must have associated ASSIGN statements. Based on the ASSIGN statements,
the module automatically passes the physical filenames associated with unit numbers to the
external program. These filenames are passed at positions 31 through 34.

6. Errors encountered in ISHELL do not terminate the NX Nastran execution.

7. IRTN=-1 indicates a failure during invocation of PRGNAME. It is not related to errors encountered
within the invoked script or executable. For example, PRGNAME cannot be found or does not
have execute permission.

8. You need a utility program to parse the arguments for your external program. For example, use
set -A argarray "$@" or a similar technique.

9. The FORTIO module must be used with ISHELL to OPEN and CLOSE FORTRAN units
referenced by the external program.

Example:
Invoke user executable DOITPGM.

10-100 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

ISHELL //‘DOITPGM’$

10.79 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 Matrix of editing parameters. See Remark 1.

LAMA Normal modes eigenvalue summary table

FREQMASS Matrix of frequencies and generalized masses. See Remark 2.

CLAMA Complex eigenvalue summary table

CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal

Output Data Blocks:

LAMAX Modified LAMA table

LAMA Normal modes eigenvalue summary table created from FREQMASS

DMAP Programmer's Guide 10-101


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

LMAT Normal modes eigenvalue summary table converted to a matrix. See Remark 3.

CLAMMAT 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.

RESFLG Integer-input-default=0. Subheading print flag used by the OFP module for
residual vector eigenvalues.

1 ”Print “BEFORE AUGMENTATION OF RESIDUAL VECTORS

2 Print “AFTER AUGMENTATION OF RESIDUAL VECTORS”

0 No print

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 10-1.
• If R3j ≥ 0, the frequency f0j and generalized mass m0j are extracted from LAMA and modified
accordingly:
o frequency: fj = Rij + (1.0 + R2j)f0jfixed shift: R1j = shift and R2j = −1.0 fractional change:
R1j = 0.0 and R2j = fraction

o Generalized mass:

• Then eigenvalue, radians, and generalized stiffness are based on the modified frequency
and generalized mass:
radians: ωj = 2πfj
eigenvalue: λj = ω2j

10-102 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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:

Mode(s) Desired modification DMl format for EMAT

1 through 3 none —

4 multiply f4 by 0.8 DMI,EMAT,4,2,-0.2

5 none —

6 delete DMI,EMAT,6,3,-1.0

7 replace f7 by 173.20 DMI,EMAT,7,1,173.20,-1.0

8 replace m8 by 2.98 DMI,EMAT,8,3,2.98

DMAP Programmer's Guide 10-103


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Mode(s) Desired modification DMl format for EMAT

9 none —

10 delete 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 DMI,DMINDX/EMAT,,,,,,,,, $
LAMX EMAT,LAMA/LAMB/9 $
EQUIVX 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, FREQMASS, 0, 2, 1, 1, , 3, 4
DMI, FREQMASS, 1, 1, 10.0, 00, 1.0
DMI, FREQMASS, 2, 1, 20.0, 0.0, 1.0
DMI, FREQMASS, 3, 1, 30.0, 0.0, 1.0
DMI, FREQMASS, 4, 1, 40.0, 0.0, 2.0

The DMAP is:


DMIIN DMI,DMINDX/,,,,,,,,,$
LAMX FREQMASS,/LAMB $
OFP LAMB//$

• Generate a matrix LMAT from a LAMA table.


The DMAP is:
LAMX, ,LAMA/LMAT/-1 $

2. For CLAMA (complex) tables:


• Create a CLAMA table with eigenvalues -1.0, -1.0, -2.0, -2.0, and -3.0, +1.0.
The DMI data for CLAMMAT is:
DMI, CLAMMAT, 0,6,3,3, ,3,3
DMI, CLAMMAT, 1,1,-1.0,-1.0
DMI, CLAMMAT, 2,2, -2.0, -2.0
DMI, CLAMMAT, 3,3, -3.0, +1.0

The DMAP is:


DMIIN DMI,DMINDX/CLAMMAT,,,,,,,,,/$
LAMX CLAMMAT,/CLAMB/-1 $

• Generate a matrix CLAMMAT from a CLAMA table.


The DMAP is:
LAMX, ,CLAMA/CLAMMAT/-2 $

10.80 LANCZOS
Performs real eigenvalue analysis

10-104 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Stiffness matrix in g-set

MGG Mass matrix in g-set

RMG Multipoint constraint equation matrix

CASECC Table of Case Control command images

USET Degree-of-freedom set membership table for g-set

CSTM Table of coordinate system transformation matrices

CASECC Table of Case Control command images

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

SIL Scalar index list

DYNAMIC Table of Bulk Data entry images related to dynamics

INVEC Starting vector(s)

Output Data Blocks:

PHG Normal modes eigenvector matrix in the g-set

LAMA Normal modes eigenvalue summary table

LAMMAT Diagonal matrix containing eigenvalues on the diagonal

MI Modal mass matrix

QG Single-point constraint forces of constraint matrix in the g-set

QMG Multipoint constraint forces of constraint matrix in the g-set

DMAP Programmer's Guide 10-105


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

FORMAT Input-character-no default. Problem type. Must specify ‘MODES’ Buckling


problems are not supported.

NEIGV Output-integer-no default. The number of eigenvectors found. Set to -1 if none


were found.

NSKIP Input-integer-default=1. Subcase record number to read in CASECC for the


METHOD set identification number.

FLUID Input-logical-default=FALSE. METHOD command option (FLUID or


STRUCTURE). If FLUID=TRUE, the EIGRL entry is selected from
METHOD(FLUID) Case Control command.

EPSORTH Input-real-default=1.0E-10. Unused.

SID Input-integer-default=0. Alternate set identification number.


If SID=0, the set identification number is obtained from the METHOD command in
CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMICS.
If SID>0, 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 Input-real-default=0.0. The lower frequency bound in cycles per unit time.

F2 Input-real-default=0.0. The upper frequency bound in cycles per unit time. The
default value of 0.0 indicates machine infinity.

NDES Input-integer-default=0. The number of desired eigenvalues. If the last mode is


repeated, nDes + m (where m is the multiplicity of the last mode) solutions are
found.

MSGLVL Input-integer-default=1. The level of diagnostic output for the Lanczos method
only.

0 No output

1 Warning and fatal messages

2 Summary output

3 Detailed output on cost and convergence

4 More detailed output on orthogonalizations and some extraarithmetic to


check on orthogonality

10-106 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

SHFSCL Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL


must be greater than 0.0.

NORM Input-character-default=’ ’ Method for normalizing eigenvectors. By default


(or NORM=‘MASS‘), MASS normalization is performed. NORM=‘MAX’selects
normalization by maximum displacement.

EPSNO Input-integer-default=-1. Number of eigensolutions to check and the quantity of


error checking output. If left at its default value, only the highest epsilon for the
first ten or NEIGV modes (whichever is less) are printed. If EPSNO is greater than
zero, the epsilons for the first EPSNO are printed.

NOQG Input-integer-default=1. Single point forces of constraint matrix creation flag.


Default of 1 requests computation of the forces. Specify -1 to request no
computation.

NOQMG Input-integer-default=1. Multipoint forces of constraint matrix creation flag. Default


of 1 requests computation of the forces. Specify -1 to request no computation.

Remarks:
1. Buckling is not supported.

2. KGG and MGG must be real and symmetric

3. INVEC can be purged.

4. QG and QMG are created only if USET is specified and NOQG and NOQMG are specified to 1.

10.81 LCGEN
Expands Case Control table based on LSEQ Bulk Data entries

Format:

LCGEN CASECC,SLT,ETT,DYNAMIC,GEOM4/
CASESX/
NSKIP/APP/IOPT $

Input Data Blocks:

CASECC Table of Case Control command images

SLT Table of static loads

ETT Element temperature table

DMAP Programmer's Guide 10-107


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

DYNAMIC Table of Bulk Data entry images related to dynamics without DAREA entry images.
LCGEN reads the RLOADi and TLOADi records to determine unique DAREA
identification numbers

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity. LCGEN matches the SPCD and SPC
IDs with TLOADi and RLOADi images for possible enforced motion

Output Data Block:

CASESX Expanded Case Control table

Parameters:

NSKIP Input-integer-default=0. Subcase record number to read in CASECC for the


LOADSET set identification number

APP Input-character-no default. Analysis type. Allowable types are:

Blank Not dynamics

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

IOPT Input-integer-default=0. If IOPT = 1, skip overwrite of the forth word (the external
static load set) of CASECC for SOL 401.

10.82 LMATPRT
Prints combined design sensitivity/constraint matrix
Prints the combined design sensitivity/constraint matrix. Applicable to Old Design Sensitivity Analysis
only.

Format:

LMATPRT DSCMR,DSROWL,DSCOLL//
DSZERO $

Input Data Blocks:

DSCMR Old combined design sensitivity/constraint matrix

DSROWL Table of design sensitivity row labels for design sensitivity matrix, DSCMR

DSCOLL Table of design sensitivity column labels for design sensitivity matrix, DSCMR

10-108 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

10.83 LRFORCE
Takes Lagrange rigid forces from the displacement vector and stores them in the MPC force vector.

Format:

LRFORCE UY,KDICT,KELM,GEOM2S/QMM,QNN/LMFACT/S,N,NOLM $

Input Data Blocks:

UY Displacements in G set

KDICT KELM dictionary table

KELM Table of element matrices for stiffness.

GEOM2S Table of Bulk Data entry images related to element connectivity and scalar points
for the current superelement.

Output Data Blocks:

QMM M set constraint forces

QNN N set constraint forces

Parameter:

LMFACT Real, LM scaling factor

NOLM Integer, Number of LM

10.84 MACOFP
Creates FORTRAN file containing OFP module output
Creates a FORTRAN file containing selected output normally printed by the OFP module.

DMAP Programmer's Guide 10-109


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Input-integer-default=0. FORTRAN unit number.

UNUSED3 Input-character-default=‘XXXXXXXX’ Unused.

10.85 MAKAEFA
Extracts data specified on AEDW, AEPRESS and AEFORCE Bulk Data entries
Extracts data specified on the AEDW, AEPRESS and AEFORCE Bulk Data entries that reference
UXVEC, DMIJ and DMIK Bulk Data entries.

Format:

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 Table of Bulk Data entry images related to aerodynamics

MATPOOL Table of Bulk Data entry images containing DMIJ, DMIJI and DMIK entries

10-110 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

AECTRL Table of aeroelastic model controls

AEBGPDTJ* Family of basic grid point definition tables for the js-set aerodynamic degrees of
freedom

AEBGPDTI* Family of basic grid point definition tables for the interference js-set aerodynamic
degrees of freedom

AEBGPDTK* Family of basic grid point definition tables for the ks-set aerodynamic degrees of
freedom

Output Data Blocks:

AEDWIDX Index to the AEDW tables

UXVW Matrix of UXVEC vectors defined by the AEDW Bulk Data entries

AEDW Matrix of downwash vectors contained on DMIJ Bulk Data entries referenced
by the AEDW entries

AEIDW Matrix of interference downwash vectors contained on DMIJ Bulk Data entries
referenced by the AEDW entries

AEPRSIDX Index to the AEPRESS tables

UXVP Matrix of UXVEC vectors defined by the AEPRESS Bulk Data entries

AEPRE Matrix of pressure vectors contained on DMIJ Bulk data entries referenced by
the AEPRESS entries

AEIPRE Matrix of interference pressure vectors contained on DMIJ Bulk data entries
referenced by the AEPRESS entries

AEFIDX Index to the AEFORCE tables

UXVF Matrix of UXVEC vectors defined by the AEFORCE Bulk Data entries

AEFRC Matrix of force vectors contained on DMIK Bulk data entries referenced by the
AEFORCE entries

Parameters:

MACH Input-real-no default. Mach number.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

Remarks:

None.

DMAP Programmer's Guide 10-111


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.86 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 Table of Bulk Data entry images related to aerodynamics

AECTRL Table of aeroelastic model controls

BGPDT Basic grid point definition table

GEOM3 Table of Bulk Data entry images related to static and thermal loads

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

Output Data Blocks:

AEDBIDX Index table consisting of the triples

UXVST Aerodynamic extra point displacement matrix

PGVST Static load vector matrix (g-set)

Parameters:

MACH Input-real-no default. Mach number.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

Remarks:

None.

10.87 MAKAEMON
Creates hinge moment (HM) monitor points

10-112 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Table of control information for aerodynamic analysis

EDT Element deformation table. Contains aerodynamic model records, specifically


AESURF and AESURFS.

AEMONOLD Table of HM monitor points

Output Data Blocks:

AEMONPT Table of aerodynamic monitor points (COEF and HM only)

MONITOR Table of structural monitor points (COEF and HM only)

Parameters:

AECONFIG Input-character-default=‘REFCSTOT’ Aerodynamic configuration.

Remarks:
None.

10.88 MAKCOMP
Extracts components from EDT
Extract components from EDT and merge with previously defined components if OLDCMP is present.

Format:

MAKCOMP EDT,AECOMP,AECMPOLD/
{AEROCOMP or STRUCOMP}/
MESH $

Input Data Blocks:

EDT Element deformation table. Contains aerodynamic model records, specifically


monitor and component input.

DMAP Programmer's Guide 10-113


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

AECOMP Aerodynamic component definition table (CAEROi Bulk Data entries).

AECMPOLD Previously generated AECOMP.

Output Data Blocks:

AEROCOMP Table of aerodynamic components when MESH=‘AERO’

STRUCOMP Table of structural components when MESH=‘STRU’

Parameters:

MESH Input-character-no default. Mesh type.

Remarks:

None.

10.89 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 $

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 Input-character-default=’ ’ The generic name of the corresponding output; for


example, OLDNAM3 corresponds to OLDDB3, and so on. See Remarks.

NEWNAMi Input-character-default=’ ’ The generic name of the corresponding input table; for
example, NEWNAM3 corresponds to NEWDB3, and so on. See Remarks.

10-114 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Remarks:
1. The allowable values for NEWNAMi and OLDNAMi are:

AXIC Table of axisymmetric and fluid Bulk Data entries

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices.

EQEXIN Equivalence table between external and internal grid/scalar identification


numbers

EST Element summary table

GEOM1 Table of Bulk Data entry images related to geometry

GEOM4 Table of Bulk Data entry images related to degree-of-freedom set membership
and constraints

GPDT Grid point definition table

GPL External grid/scalar point identification number list

SIL Scalar index list

EPT 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 GEOM1,AXIC,,,/NGEOM1,NAXIC,,,/
‘GEOM1‘/‘AXIC‘///‘GEOM1‘/‘AXIC’$
MAKENEW AXIC,GEOM1,,,/NAXIC,NGEOM1,,,/
‘AXIC‘/‘GEOM1‘///‘AXIC‘/‘GEOM1’$

3. In order to create BGPDT, EST, and CSTM, MAKENEW requires multiple inputs. For example,
MAKENEW BGPDT,EQEXIN,SIL,GPL,/NBGPDT,,,,/
‘BGPDT‘/‘EQEXIN‘/‘SIL‘/‘GPL‘//‘BGPDT’ $
MAKENEW EST,EQEXIN,SIL,,,/NEST,,,,/
‘EST‘/‘EQEXIN‘/‘SIL‘///‘EST’$
MAKENEW CSTM,EQEXIN,GPL,,,/NCSTM,,,,/
‘CSTM‘/‘EQEXIN‘/‘GPL‘///‘CSTM’$

4. The generation of the new data organization on 32 bit platforms does not increase the precisional
values of the data items.

5. Heat transfer and p-elements in EST cannot be processed by MAKENEW.

10.90 MAKEOLD
Converts tables from the current NX Nastran version to either a pre-MSC Nastran Version 69
or pre-MSC Nastran 2001 version.

DMAP Programmer's Guide 10-115


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

MAKEOLD 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 current version format. See Remark 1.

Output Data Blocks:

OLDDBi Output table in older version format. See Remark 2.

Parameters:

NEWNAMi Input-character-default=’ ’ The generic name of the corresponding input table; for
example, NEWNAM3 corresponds to NEWDB3, and so on.

OLDNAMi Input-character-default=’ ’ The generic name of the corresponding output; for


example, OLDNAM3 corresponds to OLDDB3, and so on.

Alternate Format:

MAKEOLD BGPDT,,,,/OBGPDT,OEQEXIN,OSIL,OGPL,/
'BGPDT'/////'BGPDT'/'EQEXIN'/'SIL'/'GPL' $

Input Data Block:

BGPDT Basic grid point definition table.

Output Data Blocks:

OBGPDT Basic grid point definition table in pre-MSC Nastran Version 69 format.

OEXEXIN Equivalence table between external and internal grid/scalar identification


numbers. See Remark 3.

OGPL External grid/scalar point identification number list without the extra grids
associated with Lagrangian rigids.

OSIL Scalar index list. See Remark 3.

Parameters:

BGPDT Input-character. The name of the corresponding BGPDT output table.

10-116 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

EQEXIN Input-character. The name of the corresponding EQEXIN output table.

GPL Input-character. The name of the corresponding GPL output table.

SIL Input-character. The name of the corresponding SIL output table.

Remarks:

1. The allowable values for NEWNAMi and OLDNAMi are:

AXIC Table of axisymmetric and fluid Bulk Data entries.

BGPDT Basic grid point definition table.

CSTM Table of coordinate system transformation matrices.

EPT Element property table.

GEOM1 Table of Bulk Data entry images related to geometry.

GEOM4 Table of Bulk Data entry images related to geometry.

GPDT Grid point definition table.

GPL External grid/scalar point identification number list.

2. The following table lists the MSC Nastran version of the output data block. For details regarding
the differences between corresponding input and output data blocks, see the specific data block
descriptions.

Input Data Output Data Output Data Block Version


Block (in Block
current
version)

AXIC AXIC68 Pre-MSC Nastran Version 69

BGPDT BGPDT68 Pre-MSC Nastran Version 69

CSTM CSTM68 Pre-MSC Nastran Version 69

EPT EPT705 Pre-MSC Nastran 2001

GEOM1 GEOM168 Pre-MSC Nastran Version 69

GEOM4 GEOM4705 Pre-MSC Nastran 2001

GPDT GPDT68 Pre-MSC Nastran Version 69

GPL GPL With OMACHPR = NO, the extra grids associated with
Lagrangian rigids are removed.

DMAP Programmer's Guide 10-117


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

3. OEQEXIN and OSIL are created from BGPDT.

4. The inputs, outputs, and parameters can be specified in any order as long as the parameters
are in the same positions as their respective inputs or outputs. For example, the following
specifications are equivalent:
MAKEOLD GEOM1,AXIC,,,/OGEOM1,OAXIC,,,/
‘GEOM1‘/‘AXIC‘///‘GEOM1‘/‘AXIC’$
MAKEOLD AXIC,GEOM1,,,/OAXIC,OGEOM1,,,/
‘AXIC‘/‘GEOM1‘///‘AXIC‘/‘GEOM1’$

10.91 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 Table of control information for aerodynamic analysis

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

BGPDT Basic grid point definition table

USET Degree-of-freedom set membership table for g-set

TRX Acceleration selection matrix for the list of aerodynamic extra-points (6 rows by
NX columns)

Output Data Block:

TR Matrix to transform forces from the support point to the aerodynamic reference
point

PRBDOFS Partitioning matrix to partition the "active" URDDI from the "inactive". Active URRDI
are assigned a 1.0 value and are connected to the SUPORT degrees-of-freedom

URDDIDX An instance of an ADBINDX that describes the acceleration entries

URDDUXV UX vector states for the active URDDi. These are rows of TRX that are non-null.
Null rows occur either because 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).

10-118 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

TRANTR Transpose of TR where the number of columns of TR matches the


URDDUXV states of TRX. Both are reduced to just the active origin rigid body
degrees-of-freedom.

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 $

10.92 MAKMON
Builds table of monitor points

Format:

MAKMON EDT,{AEROCOMP or STRUCOMP}/


{AEMONPT or MONITOR} $

Input Data Blocks:

EDT Element deformation table. Contains aerodynamic model records, specifically


monitor and component input.

AEROCOMP Table of aerodynamic components when MESH=‘AERO’

STRUCOMP Table of structural components when MESH=‘STRU’

Output Data Blocks:

AEMONPT Table of aerodynamic monitor points

MONITOR Table of structural monitor points

Parameters:

None.

Remarks:

None.

DMAP Programmer's Guide 10-119


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.93 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.

Output Data Block:

MAT Matrix data block.

Parameters:

P1 Input-integer-no default. Option selection parameter as described below.

P2 through Input-integer-default=0. Provide parametric data depending on P1.


P11

P12 Input-character-default=‘A’ See Option P1 = 11.

P13 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.

10-120 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Summary of Options:

P1 Option Description

P1=1 Generate a real identity matrix.

P1=2 Generates an identity matrix trailer.

P1=3 Generate a data block of prescribed size.

P1=4 Generate a pattern matrix.

P1=5 Generate a matrix of pseudorandom numbers. The numbers span the range 0 to
1.0, with a uniform distribution.

P1=6 Generate a partitioning vector for use in PARTN or MERGE.

P1=7 Generate a null matrix.

P1=8 Generate a matrix from equations based on its indices. The matrix is in single
precision.

P1=9 Generate a transformation between external and internal sequence matrices for
g-set size matrices.

P1=10 Not used.

P1=11 Generate a rectangular matrix, driven by USET table.

P1=12 Generate a rectangular matrix of prescribed properties.

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 Order of matrix.

P3 Skew flag. If nonzero, generate a skew-diagonal matrix.

DMAP Programmer's Guide 10-121


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

P4 Precision (1 or 2). If zero, use machine precision.

Example:

Generate a real 10 x 10 identity matrix.


MATGEN ,/I10X10/1/10 $

Option P1 = 2

Generates an identity matrix trailer.

Format:

MATGEN ,/MAT/2/P2 $

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.

10-122 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Block:

DB Data block. See Remarks.

Parameters:

P2 Number of GINO blocks to be written

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 Number of columns

P3 Number of rows

P4 Precision

P5 Number of values in nonzero string

P6 Row number increment between nonzero strings after first nonzero string (P7-1).
Produces (P6-1) zeros.

P7 Row number of first nonzero value in first column. Produces (P7-1) zero values.

P8 Row number increment to first nonzero string in second and subsequent

DMAP Programmer's Guide 10-123


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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.

10-124 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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

P3 Number of rows

DMAP Programmer's Guide 10-125


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

P4 Precision (1 or 2). If zero, use machine precision.

P5 Seed for random number generation. If P5 ≤ 0, the time of day (seconds past midnight) is
used.

P6 Output-integer-mean of all random numbers multiplied by 100,000.

Option P1 = 6
Generate a partitioning vector for use in PARTN or MERGE.

Format:

MATGEN ,/CP/6/P2/P3/P4/P5/P6/P7/P8/P9/P10 $

Input Data Blocks:


None.

Output Data Block:

CP Column partitioning vector

Parameters:

P2 Number of rows

P3, P5, P7, P9 Number of rows with zero coefficients

P4, P6, P8, P10 Number of rows with unit coefficients

Remarks:
1. If

Pi < P2, the remaining terms contain zeros.

2. If

Pi > P2, the terms are ignored after P2.

Example:
Generate a vector of 5 unit terms followed by 7 zeros followed by two unit terms.

10-126 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Number of rows

P3 Number of columns

P4 Form; if P4 = 0 and P2 = P3, the form is 6 (symmetric). If P4 = 0 and P2 ≠ P3, the


form is 2 (rectangular).

P5 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.

Output Data Block:

MAT Matrix with element values based on its indices

DMAP Programmer's Guide 10-127


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

T DTI table input

P2 = 0 generate all terms


≠ 0 generate only diagonal terms

P3 Number of rows

P4 Number of columns

P5 Number of the record in field 3 of the DTI entry used to define real coefficients

P5<0 Coefficient taken from DTI trailer:


C(t1) = float (t2) all trailer items are integer.
C(t3) = float (t4) all trailer items are integer.
C(t5) = float (t6) all trailer items are integer.

P5=0 Data pairs from record 0 (data block header record) are interpreted as
definingC(ν1) = (ν2)(ν1) is integer; (ν2) is real

P5>0 Data pairs from record P5 interpreted as above.

P6 Number of the record in field 3 of the DTI entry used to define imaginary coefficients D1

P6 ≤ 0 No coefficients defined.

P6 > 0 Data pairs from record P6 interpreted as above where D(ν1) = (ν2).

P7 Form of output matrix

P7 ≤ 0 Form chosen to be 1 or 2, depending on P3 and P4.

P7 > 0 Form set to P7.

P8 Coefficient print flag

P8 = 0 Do not print coefficient lists.

P8 ≠ 0 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:

10-128 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Equation 10-4.
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 2 3 4 5 6 7 8 9 10

DTI AB 0 7 1 8 4

2 3.5 1 -5.2

DTI AB 1 3 0.01 4 7.9

DTI AB 2 12 -21.8 13 6.6

DTI AB 3 9 1.0

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.

DMAP Programmer's Guide 10-129


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 EQEXIN table output by module GP1

P2 0 Output nontransposed factor where [UINT]=[MAT][UEXT]

1 Output transposed factor where [UEXT]=[MAT][UINT]

P3 Number of terms in g-set. The parameter LUSET, which is output by the GP1 module,
contains this number in most solution sequences.

Examples:
Transform a g-set size vector UGV to external sequence.
MATGEN EQEXIN/INTEXT/9//LUSET $
MPYAD INTEXT,UGV,/UGVEXT/1 $

Transform an a-set size matrix to external sequence.


VEC USET/VATOG/’G’/’A’/’COMP’ $
MERGE KAA,,,,VATOG,/KAGG/ $0 EXPAND TO
$ G- SIZE, INTERNAL SORT
MATGEN EQEXIN/INTEXT/9/0/LUSET $
SMPYAD INTEXT,KAGG,INTEXT,,/KAAGEXT/3////1////6 $
$ (KAAGEXT) = TRANSPOSE(INTEXT)*(KAAG)*
$ (INTEXT) ITS FORM IS 6 (SYMMETRIC)

By default in SOLs 100 through 200, PARAM, OLDSEQ is -1, which means this operation is not
required.

Option P1 = 10
Not used.

Option P1 = 11
Generate a rectangular matrix, driven by USET table

Format:

MATGEN USET/MAT/11/P2/P3/////////SET1/SET2 $

10-130 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 USET table output by module GP4

P2 Input-integer-default=0. Null matrix generation option flag.

=1 Generate a null matrix P3 columns and a-set size rows.

≠0 Generate a null matrix with an identity sub-matrix based on SET1 and SET2
degree-of-freedom sets.

P3 Input-integer-default=0. Number of columns in MAT. Applies only to P2=1.

SET1 Input-character-default=‘A’ Degree-of-freedom set name which corresponds to the


number of rows in MAT. Applies only when P2≠1.

SET2 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.

Output Data Block:

MAT Rectangular matrix

DMAP Programmer's Guide 10-131


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

P2 Number of columns

P3 Number of rows

P4 Type of elements in the matrix:

1 Real single precision

2 Real double precision

3 Complex single precision

4 Complex double precision

P5 Density of the matrix times 10000

P6 Average string length

P7 Total number of strings in the matrix

P8 Number of null columns

P9 Average bandwidth

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.

10.94 MATGPR
Degree-of-freedom matrix printer
Prints nonzero terms of matrices along with the external grid point and component identification
numbers corresponding to the row and column position of each term.

Formats:
1. For matrices with degrees of freedom that relate to grid or scalar points (g-set):

MATGPR BGPDT,USET,,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1$

MATGPR GPL,USET,SIL,MATRIX//COLNAM/ROWNAM/PRNTOPT/TINY/F1 $

10-132 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 External grid/scalar point identification number list

GPLD External grid/scalar/extra point identification number list. (GPL appended with
extra point data.)

USET Degree-of-freedom set membership table for g-set

USETD Degree-of-freedom set membership table for p-set

SIL Scalar index list

SILD Scalar index list for the p-set

MATRIX Any matrix related to degrees-of-freedom

BGPDT Basic grid point definition table

BGPDT* Family of basic grid point definition tables for all superelements

USET* Family of USET tables

Parameters:

COLNAM Input-character-no default. Set name for columns in MATRIX.

ROWNAM Input-character-default = ’ ’ Set name for rows in MATRIX. If ROWNAM is blank, it


defaults to COLNAM.

DMAP Programmer's Guide 10-133


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

PRNTOPT Input-character-default = ’ALL’. Must be one of the following values:

Option Action
NULL Only null columns are identified.
ALL Print all nonzero terms in matrix.
ALLP Print numbers converted to magnitude/phase.

TINY Real-default = 0.0. If F1 = 0 and TINY ≥ 0, printed output 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.

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.

LCOLLBLi Input-character-default=’ ’ Label with up to 32 characters to be printed left-justified


in upper left corner of each page.

RCOLLBLi Input-character-default=’ ’ If RCOLLBLi is blank, ‘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.

HDRLBLi Input-character-default=‘MATRIX‘(followed by matrix name). Header with up to 64


characters to be printed and centered at the top of of each page.

HDRLBLi Input-character-default=‘MATRIX‘(followed by matrix name). Header with up to 64


characters to be printed and centered at the top of of each page.

PUNCH Input-logical-default=FALSE. Punch file write control flag. (DELAY)

CARDNO Input/output-integer-default=0. Punch file line counter. CARDNO is incremented


by one for each line written to the punch file and is also written into columns
73-80 of each line. (DELAY)

Remarks:

The supersets formed by the union of other sets have the following definitions:

10-134 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 LOO/LOOD $

DMAP Programmer's Guide 10-135


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

MATGPR BGPDT,USET,,LOOD//’H’/’O’//-1.E-2 $

4. Print PHIA, H columns by A rows (also good for any single column).
MATGPR BGPDT,USET,,PHIA//’H’/’A’ $

5. Print all terms of KGG outside the range of 0 through 107.


MATGPR BGPDT,USET,,KGG//’G’/’G’//1.E7/0. $

6. Print aerodynamic spline matrices.


NP=SEID $
DBVIEW BGPDTF=BGPDTS WHERE (
(PEID=-1 AND MODLTYPE=‘AEROSTRC‘) OR
(PEID=NP AND MODLTYPE=‘STRUCTUR‘) ) $
DBVIEW USETFF=USET0 WHERE (
(PEID=-1 AND MODLTYPE=‘AEROSTRC’AND SPC=*
AND MPC=* AND SUPORT=*) OR
(PEID=NP AND MODLTYPE=‘STRUCTUR’AND SPC=*
AND MPC=* AND SUPORT=*) ) $
MATGPR BGPDTF,USETFF,,GPJK//‘K‘/‘G’$
MATGPR BGPDTF,USETFF,,GDJK//‘K‘/‘G’$

7. Print g-size matrix GCF similarly to displacement output.


MATGPR BGPDT,USET,,GCF//‘ofp‘/‘g’$
COLUMN 1
MATRIX GCF
POINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0 1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0 1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0 4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0

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 - S E T )
POINT ID. TYPE T1 T2 T3 R1 R2 R3
1 G .0 .0 .0 .0 .0 1.862645E-09
3 G -1.303852E-08 -4.656613E-10 .0 .0 .0 1.862645E-09
4 G -1.490116E-08 4.656613E-10 .0 .0 .0 .0
6 G 1.862645E-09 .0 .0 .0 .0 -4.656613E-10
7 G 1.862645E-09 .0 .0 .0 .0 4.656613E-10
9 G -3.725290E-09 .0 .0 .0 .0 .0
10 G -3.725290E-09 .0 .0 .0 .0 .0

10.95 MATINIT
Initializes matrices to zero.

Format:
MATINIT /MAT/P1/P2/P3 $

10-136 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

MAT Matrix to be created.

Parameters:

P1 Type (1 for integer, 2 for real)

P2 Number of columns

P3 Number of rows

10.96 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,I10,I11,I12,I13,I14,I15,I16/
O1,O2/
P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/p13/p14/p15/p16/p17/p18/p19 $

Input Data Blocks:

Ii Input data blocks. I1 is required; I2 through I16 may not be necessary depending
on the value P1.

Output Data Blocks:

Oi Output data blocks

Parameters:

P1 Input-integer-no default. Option selection described in the table that follows.

P2, P3, P4 Input/output-integer-default=0. Parametric data depending on P1.

P5, P6 Input/output-real-default=0. Parametric data depending on P1.

P7 through Input/output-integer-default=0. Parametric data depending on P1.


P11

P12 Input/output-character-default=blank. Parametric data depending on P1.

P13 Input/output-character-default=” Parametric data depending on P1.

DMAP Programmer's Guide 10-137


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

P14 Input/output-character-default=” Parametric data depending on P1.

P15 Input/output-character-default=” Parametric data depending on P1.

P16 Input/output-integer-default=0. Parametric data depending on P1.

P17 Input/output-real double precision-default=0.D0. Parametric data depending on


P1.

P18 Input/output-complex single precision-default=(0.0,0.0). Parametric data


depending on P1.

P19 Input/output-complex double precision-default=(0.D0,0.D0). 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.

Summary of Options:

P1 Option Description

P1=1 Copy selected columns from a matrix into one or two other matrices.

P1=2 Filter small magnitude terms of a matrix.

P1=3 Zeros out rows and columns of a matrix according to degree of freedom component
number.

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.

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.

P1=6 Find the maximum absolute value for each row over all columns of a matrix.

P1=7 Find the maximum absolute value for each column over all the rows of a matrix.

P1=8 Normalize matrix.

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.)

P1=10 Convert matrix I1 into its complex conjugate.

P1=11 Form a new Basic Grid Point Definition Table (BGPDT) with grid locations that
are given by I1.

10-138 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

P1 Option Description

P1=12 Perform simultaneous null column search on up to three matrices.

P1=13 Copies any data block.

P1=14 Filter small magnitude terms from a matrix; more capabilities than option 2.

P1=15 Not implemented.

P1=16 Put matrix into MATPOOL format, optional DMIG punched output.

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.

P1=18 Insert or modify a GEOM3 table temperature record.

P1=19 Extract a temperature vector from a GEOM3 table.

P1=20 Print the magnitude of the largest terms of up to six matrices.

P1=21 Extracts the components of a factor matrix and converts them to a standard form
suitable for input to any matrix module.

P1=22 Generate special aeroelasticity matrix with modified trailers.

P1=23 Determines type of eigenvalue analysis requested and optionally extracts values
from the selected EIGR or EIGRL Bulk Data entry.

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.

P1=25 Generate vectors that have 1.0 corresponding to each null row and null column in
I1, I2, and I3 simultaneously.

P1=26 Used internally for development testing.

P1=27 Convert a diagonal matrix (form 3) to a symmetric matrix (form 6).

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.

P1=29 Make output requests consistent for superelement combined output.

P1=30 Print data blocks or a portion of data blocks as a table of hexadecimal values.

P1=31 Writes the bit map of a matrix to the punch file.

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.

DMAP Programmer's Guide 10-139


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

P1 Option Description

P1=33 Create a single column matrix from the frequency response output list table, FOL.
The frequencies are also converted to radian units.

P1=34 Extract the real and imaginary parts of complex matrix into two real matrices.

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.

P1=36 Reduce the GRID record in the GEOM1 table to the entries corresponding to grid
identification numbers specified in a Case Control set.

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.

P1=38 Reduce the records in the EST table to the entries corresponding to element
numbers specified in a Case Control set.

P1=39 Remove and identify explicit zero terms in a matrix.

P1=40 Remove unused q-set degrees-of-freedom from USET.

P1=41 Generate a partitioning vector from a set of grid points defined in the Bulk Data
Section on a ROTORG card.

P1=42 Generate a partitioning vector from a set of data defined in the Bulk Data Section
on SOL 200.

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.

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.

P1=45 Construct XCASECC by selecting the desired records of CASECC.

P1=46 Used internally for development.

P1=47 Used internally for development.

P1=48 Used internally for development.

P1=49 Modify Case Control to create data type-specific set and reference.

P1=50 Extract item-code specific data from a modal contributions output data block and
create a column vector.

P1=51 Generate a surface spline to connect two point fields in close proximity, but not
necessarily coincident.

10-140 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

P1 Option Description

P1=52 Used internally for development.

P1=53 Generate a g-size partitioning vector and a list of grid IDs that correspond to the
structural grids that are a part of an acoustic coupling matrix.

P1=54 Used internally for development.

P1=55 Compute modal damping coefficients, as in the GKAM module.

P1=56 Replace the value of, or add a value to, a single term in a matrix.

P1=57 Modify frequency list table TOL.

P1=58 Present the topology optimization EFILL table in ONRGY format.

P1=59 Create an element grid connectivity matrix for the elements contained in the EFILL
matrix.

Option P1 = 1

Copy selected columns from a matrix into one or two other matrices.

Format:

MATMOD I1,,,,,,,,,,,,,,,/O1,[O2]/1/STARTCOL/ENDCOL/COLINC $

Input Data Block:

I1 Any matrix (real or complex)

Output Data Block:

O1 A matrix consisting of columns copied from input matrix I1, starting with matrix I1
column STARTCOL (P2), in increments of COLINC (P4), with the last column
copied being ≤ ENDCOL (P3), depending on the relative values of P2, P4, and P3.

O2 If matrix O2 is specified, the columns of I1 not copied into O1 are copied into O2.

Parameter:

STARTCOL Input-integer. Starting column number to copy from I1.

ENDCOL Input-integer. Ending column number to copy from I1

COLINC Input-integer-default=1. Column increment. Copy every COLINC‘th column


between STARTCOL and ENDCOL.

DMAP Programmer's Guide 10-141


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Remarks:
1. If ENDCOL is zero, ENDCOL=STARTCOL.

2. If COLINC is entered as 0 (or is left out), it reverts to the default of 1, and every column between
STARTCOL and ENDCOL is copied.

Examples:
1. Copy the seventh column from A and call it A7.
MATMOD A,,,,,,,,,,,,,,,/A7, /1/7 $

2. Copy the third, fourth, and fifth columns from A into matrix A345.
MATMOD A,,,,,,,,,,,,,,,/A345, /1/3/5 $

3. Copy columns 2 and 4 of matrix ABCD into matrix XYZ, and columns 1, 3, 5, and remaining
columns of same matrix ABCD into matrix KLMN.
MATMOD ABCD,,,,,,,,,,,,,,,/XYZ, KLMN /1/2/5/2 $

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.

FILTER 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.

Example:
Print terms in A smaller in magnitude than 100.0.
MATMOD A,,,,,,,,,,,,,,,/AFILTER,/2////100.0 $
ADD A,AFILTER/ASMALL//-1 $
MATPRN ASMALL// $

10-142 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 KGG,,,,,,,,,,,,,,,/KGG1,/3/126 $
EQUIVX KGGQ/KGG/ALWAYS $

Option P1 = 4
Replicates a matrix six rows by N columns row-wise to a g-row by N-column matrix. The input
matrix is replicated for each grid point.

Format:
Form 1

MATMOD I1,SIL,,,,,,,,,,,,,,/O1,/4 $

Form 2

MATMOD I1,,,,,,,,,,,,,,,/O1,/4/LUSET $

DMAP Programmer's Guide 10-143


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

I1 Any six-row by N-column matrix (real or complex)

SIL 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 $

Input Data Blocks:

I1 Any six-row by six-column matrix (real or complex)

SIL Scalar index list table output from the GP1 module

BGPDT Basic grid point definition table

10-144 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.
This parameter is valid for Forms 1 and 2 only.

P3 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 TRANS,SIL,,,,,,,,,,,,,,/TRANSG,/5 $
TRNSP TRANS/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGPRIME/3 $

2. Assume KGG was formed using coordinate system 10 as the global coordinate system for all
grid points. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,,,,,,,,,,,,,,/TRANSG,/5//10 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $

3. Assume KGG was formed using arbitrary coordinate systems as the global coordinate system for
each grid point. Transform KGG to the basic coordinate system.
MATMOD CSTM,SIL,BGPDT,,,,,,,,,,,,,/TRANSG,/5//-1 $
TRNSP TRANSG/TRANSGT $
SMPYAD TRANSG,KGG,TRANSGT,,,/KGGBASIC/3 $

Transform KGGBASIC coordinate system 10.

DMAP Programmer's Guide 10-145


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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)

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 $

10-146 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Output-real single precision. Set to the real part of the normalizing factor.

NORMIMAG Output-real single precision. Set to the imaginary part of the normalizing factor
if I1 is complex.

Option P1 = 9
Find the maximum (absolute magnitude) value of each 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 $

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

DMAP Programmer's Guide 10-147


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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.

Format:

MATMOD LOCVEC,BGPDT,,,,,,,,,,,,,,/BGPDTN,/11 $

Input Data Blocks:

LOCVEC G-size vector with values that represent grid locations in the basic coordinate
system

BGPDT Basic grid point definition table

Output Data Block:

BGPDTN New BGPDT table with grid point locations that are displaced by LOCVEC

10-148 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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

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 Output-integer. Set to -1 if no simultaneous null columns found; otherwise, it is set


to the number of simultaneous null columns.

NMATRIX Input-integer-default=0. Number of matrices to be included in null column search.

Remarks:

1. I2 and I3 can be purged.

2. O2 can be purged.

DMAP Programmer's Guide 10-149


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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.

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.

10-150 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

UPLOW 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.

STRTR Input-integer-default=0. If STRTR=0, string trailer is written.

FILTER 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.

RELFLT Input-real single precision-default=0.0. If RELFLT≠ 0.0, terms of I1 are set to


zero when

Equation 10-5.
I1 must be square for this option

TRUNC Input-integer-default=0. If TRUNC ≠ 0, truncate terms of I1 accordingly

Equation 10-6.

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.

DMAP Programmer's Guide 10-151


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

MATMOD I1,I2,,,,,,,,,,,,,,/O1,/16/PNDMIG/USENAM/
TYPOUT////////CCHAR/MATNAM $

Input Data Blocks:

I1 Any matrix of g-rows arranged in external (ascending by GRID ID) sequence.


(Real or complex).

I2 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).

USENAM Input-integer-default=0. If USENAM≠0 and PNDMIG≠0, I1 is printed using


the name defined in MATNAM.

TYPOUT Input-integer-default=0. Default is to set DMIG precision to machine


precision. The default can be overridden by specifying:

1 Real single-precision output

2 Real double-precision output

3 Complex single-precision output

4 Complex double-precision output

CCHAR 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.

MATNAM Input-character-default=blank. Matrix name to use for I1. Only valid when
USENAM≠0 and PNDMIG≠0.

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

10-152 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

(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 EQEXIN/INTEXT/9/0/LUSET $
MPYAD INTEXT,KGG,/KGGE/1 $
MPYAD KGGE,INTEXT,/KGGEXT $
MATMOD KGGEXT,EQEXIN,,,,,,,,,,,,,,/MATPOOL1,/16/1 $
MPYAD INTEXT,PG,/PGEXT/1 $
MATMOD PGEXT,EQEXIN,,,,,,,,,,,,,,/MATPOOL2,/16/1 $
MATMOD KGGEXT,EQEXIN,,,,,,,,,,,,,,/MATPOOL1,/16/1/1//////////KNAME $

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,GRDLST,,,,,,,,,,,/CP,/17/UBIT/SETFLG/
S,N,NOCP////////SETSTR1/SETSTR2/SETSTR3/SETSTR4 $

Input Data Blocks:

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

USET Degree-of-freedom set membership table for g-set

SIL Scalar index list

CASECC Table of Case Control command images

GRDLST Optional line of allowable grid and scalar points. (Real single-precision vector.) If
purged, all are allowed. Only applies to SETFLG≠0 and UBIT=0.

Output Data Block:

CP Column partitioning vector

DMAP Programmer's Guide 10-153


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 DecimalEquivalentNumber

Q 4194304

BE 2097152

C 1048576

K 262144

SA 131072

E 2048

SB 1024

SG 512

R 8

O 4

BF 2

M 1

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 Output-integer. NOCP is set to -1 if the partitioning vector is null or cannot be


generated. Otherwise, it is set to zero.

10-154 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

SETSTRi Input-character-default=’ ’ Set name string. SETSTR1 through SETSTR4 form a


single string of set name(s) and is 32 characters in length. The set names must
be separated by a plus sign, "+". For example, SETSTR1=‘M+R+N+SG’and
SETSTR2=‘+A+Q’specifies the m, r, n, sg, a, and q sets.

Remarks:
1. None of the data blocks 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 $

Note

If no set had been selected in the Case Control Section, the vector VECX would have been
generated using the a-set degrees of freedom since UBIT=128.

The Case Control Section contains:


SET 10 = 1 THRU 50
PARTN = 10

Option P1 = 18
Insert or modify a GEOM3 table temperature record.

Format:

MATMOD GEOM,GPL,UG,,,,,,,,,,,,,/GEOM3T,/18/SID $

Input Data Blocks:

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GPL External grid/scalar point identification number list

UG Temperature matrix in g-set

Output Data Block:

GEOM3T GEOM3 table with new or modified temperatures

Parameter:

SID Input-integer. Temperature set to be modified or added.

DMAP Programmer's Guide 10-155


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Table of Bulk Data entry images related to static and thermal loads

EQEXIN 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.

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 $

10-156 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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/P2///S,N,SUM $

Input Data Blocks:

I1 though I6 Any matrix (real or complex)

Output Data Block:

O1 Dummy output data block

Parameter:

P2 Input-integer-default=0. Print flag. If 0, print SUM; if not 0, do not print SUM.

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 $

Input Data Block:

LD Lower triangular factor/diagonal matrix

Output Data Blocks:

T Diagonal from symmetric decomposition

LP Lower triangular [L] and permutation matrix appended together

DMAP Programmer's Guide 10-157


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Table of Mach number and reduced frequency pairs

Qij Aerodynamic matrix

Output Data Block:

QijL Special aerodynamic matrix with modified trailers

Option P1 = 23
Determines type of eigenvalue analysis requested and optionally extracts values from the selected
EIGR or EIGRL Bulk Data entry.

Format:

MATMOD CASECC,DYNAMIC,,,,,,,,,,,,,,/,/23/S,N,METHTYP/S,N,LANCZOS/S,N,EIGRVALI/S,N,EIGRVALR//
S,N,NFOUND/ICASE////S,N,EIGRFLD $

Input Data Blocks:

CASECC Table of Case Control command images

10-158 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

DYNAMIC Table of Bulk Data entry images related to dynamics

Parameters:

METHTYP Output-integer. Set to 1 if Inverse Power or Lanczos method selected; otherwise,


set to zero.

LANCZOS Output-integer. Set to -1 if Lanczos method selected; otherwise, set to zero.

EIGRVALI Output-integer-default=0. Extracted integer value from the EIGR or EIGRL entry.

EIGRVALR Output-real-default=0.0. Extracted real value from the EIGR or EIGRL entry

NFOUND Output-integer-default=0. EIGR* entry found flag; 0 if entry was found and -1
if entry was not found.

ICASE Input-integer-default=1. Case Control record number which contains the


METHOD command.

EIGRFLD EIGRFLD Input/output-character-default=’ ’ Field name of EIGR or EIGRL entry.


EIGRFLD is also an output if the field value is a character string.

Examples:
1. Determine method type on the EIGR entry.
MATMOD CASECC,DYNAMIC,,,,,,,,,,,,,,/,/23/S,N,METHTYP $
IF ( METHTYP=1 ) THEN $
MESSAGE //’LANCZOS OR SINV IS SELECTED.’$
ELSE $
MESSAGE //’GIVENS OR HOUSEHOLDER IS SELECTED.’$
ENDIF $

2. Extract the F2 field value from the EIGR entry:


MATMOD CASECC,DYNAMIC,,,,,,,,,,,,,,/,/23////S,N,F2///////‘F2’$

3. Extract the NORM field value from the EIGR entry:


NORM=‘NORM’$ initialize and will change on output
MATMOD CASECC,DYNAMIC,,,,,,,,,,,,,,/,/23///////////S,N,NORM $

Option P1 = 24
Generate a square matrix that has a 1.0 at the intersection of every null row and null column of
I1, I2, and I3 simultaneously.

Format:

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)

DMAP Programmer's Guide 10-159


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 Output-integer. Set to -1 if O1 is null.

NMATX Input-integer-default=1. Number of input matrices to be used for search, starting


from the first input.

NRNENC Output-integer. Set to -1 if the number of null rows does not equal the number
of null columns.

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 $

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)

10-160 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

O1 Vector that has 1.0 corresponding to each null row in I1, I2, and I3 simultaneously.
See Remark 1.

O2 Vector that has 1.0 corresponding to each null column in I1, I2, and I3
simultaneously.

Parameters:

NOOUT Output-integer. Set to -1 if both output vectors are null, set to zero otherwise.

NMATX Input-integer-default=1. Number of input matrices to be used for search, starting


from the first input.

NRNENC Output-integer. Set to -1 if number of null rows does not equal the number of
null columns; otherwise zero.

SYM Output-integer. Set to -1 if I1, I2, and I3 are symmetric; otherwise zero. See
Remark 2.

Remarks:
1. Any two input matrices can be purged.

2. If I1, I2, and I3 are symmetric, O2 is purged.

Example:
Remove null rows and columns from matrix A.
MATMOD A,,,,,,,,,,,,,,,/RPARTN,CPARTN/25/S,N,NOOUT/1////S,N,SYM $
IF (NOOUT > -1) THEN $
PARTN A,CPARTN,RPARTN/ANEW/SYM $
EQUIVX ANEW/A/ALWAYS $
ENDIF $

Option P1 = 26
Used 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)

DMAP Programmer's Guide 10-161


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 DMI,DMINDX/A3,,,,,,,,, $
MATMOD A3,,,,,,,,,,,,,,,/A6,/27 $

where A3 is the DMI matrix defined by the Bulk Data entries


DMI,A3,0,3,1,1,,4,1
DMI,A3,1,2,2.0,3.0,4.0

and A6 is the matrix

Option P1 = 28
Convert the first column of a matrix to a symmetric matrix (form 6) with the terms of the first column
along the diagonal and off-diagonal terms set to zero.

Format:

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 $

10-162 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

If B is the matrix

Figure 10-2.
BDIAG is

Figure 10-3.

Option P1 = 29

Make output requests consistent for superelement combined output.

Format:

MATMOD CASECC,,,,,,,,,,,,,,,/XCASECC,/29 $

Input Data Blocks:

CASECC Table of Case Control command images

Output Data Blocks:

XCASECC Modified table of Case Control command images

Remarks:

This only makes sense with PARAM,SECOMB,YES.

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 Blocks:

Ii Any data block (matrix or table)

DMAP Programmer's Guide 10-163


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

BBLK Input-integer-default=1. Beginning GINO block number.

EBLK Input-integer-default=-1. Ending GINO block number. Default value implies the
total number of blocks.

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

Parameter:

CONVERT Input-integer-default=0. Convert option.

10-164 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

0 Table data block format to DTI format

1 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

Output Data Blocks:

RMAT Matrix containing real part of CMAT

IMAT Matrix containing imaginary part of CMAT

DMAP Programmer's Guide 10-165


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameter:

PREC Input-integer-default=0. Precision of output matrices.

0 Machine-precision (default)

1 Single

2 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 Vector consisting of the row numbers of the original positions of the sorted terms

SORTBOOL Square matrix containing unity at a row position in the column associated with the
sorted row terms

Parameters:

P1 Input/output-integer-no default. On output, P1=-1 if the input matrix is purged or


both output data blocks are purged.

COLNUM Input-integer-default=0. Selects the column number of the input matrix that is
sorted to produce SORTLIST and SORTBOOL. Default selects the first column.

PRESORT Output-integer-default=0 Pre-sort flag. Set to -1 if column is already sorted.

SORTOPT Input-integer-default=0. Sort option specification.

-2 Absolute value in descending order

-1 Algebraic value in descending order

0 Implies SORTOPT=1 if IM is real, and SORTOPT=2 if IM is complex.

1 Algebraic value in ascending order

10-166 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

2 Absolute value in ascending order

NKEYS Input-integer-default=1. Duplicate value sort option specification.

1 Single key sort

2 Double key sort to maintain original order of terms in case of duplicate


terms

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

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

DMAP Programmer's Guide 10-167


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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

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.

10-168 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 Table of Bulk Data entry images related to geometry

CASECC 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.

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 $

DMAP Programmer's Guide 10-169


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Blocks:

GEOM2 Table of Bulk Data entry images related to geometry

CASECC Table of Case Control command selections

Output Data Block:

GEOM2R GEOM2 table with reduced element record

Parameters:

ELEMSET Input-integer. SET Case Control command identification number which contains a
list element point identification numbers.

GRIDSET Input-integer. SET Case Control command identification number which contains
a list SPOINT identification numbers.

NOGEOM2 Output-integer. Processing status flag.

+1 No element and SPOINTs found 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.

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 Table of Bulk Data entry images related to geometry

CASECC Table of Case Control command selections.

Output Data Block:

ESTR EST table with reduced records

10-170 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

ELEMSET Input-integer. SET Case Control command identification number that contains a
list element point identification numbers.

GRIDSET Input-integer. SET Case Control command identification number which contains a
list grid point identification numbers.

NOEST Output-integer. Processing status flag.

+1 No element found 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

Output Data Blocks:

O1 Matrix I1 with explicit zero terms removed

O2 Matrix containing a 1.0 at the row and column, where an explicit zero was found
in I1

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,VAXWN/40 $

DMAP Programmer's Guide 10-171


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Block:

USET Degree-of-freedom set membership table for g-set.

VAXW 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).

VAXWN Modified VAXW corresponding to USETN.

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,,,,,,,,,,,/PARTV,/41/PFLAG/ROTGID/NOVEC $

Input Data Block:

EQEXIN Equivalence table between external and internal grid/scalar


identification numbers.

USET Degree-of-freedom set membership table for g-set.

SIL Scalar index list.

CASECC Table of Case Control command images.

DYNAMICS Table of Bulk Data entry images related to dynamics.

Output Data Blocks:

PARTV Column partitioning vector.

10-172 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

PFLAG Input-integer-default=0. Processing flag. If 0, process ROTORG bulk data entries.


If 1, process ROTORB bulk data entries.

ROTGID Input-integer. ROTGID must be less than zero. The absolute value of ROTGID
selects the ROTORG or ROTORB 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 PARTV.

NOVEC Output-integer-no default. Set to 0 if PARTV created; set to -1 if PARTV is not


created (i.e. ROTORG or ROTORB bulk data entry doesn’t exist).

Remarks:

1. None of the data blocks may be purged.

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.

Format:

MATMOD BGPDT,EQEXIN,SIL,CASECC,EDOM,EPT,EPTABF,GEOM2,XYCDB,PARTV,DYNAMIC,,,,,/
RGPV,/42/NEPT/NOSE $

Input Data Blocks:

BGPDT Basic grid point definition table.

EQEXIN Equivalence table between external and internal grid/scalar


identification numbers.

SIL 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.

DMAP Programmer's Guide 10-173


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

GEOM2 Table of Bulk Data entry images related to element connectivity


and scalar point.

XYCDB Table of X-Y plotting commands.

PARTV Partitioning vector output by MATMOD with option P1=44.

DYNAMIC Table of bulk data entry images related to dynamics.

Output Data Blocks:

RGPV Row partitioning vector.

Parameters:

NEPT Input-integer-default=0. The number of EPOINT used in FE model.

NOSE Input-integer default=0. NOSE should be set to 1 if superelement is used.

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.

10-174 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

MATMOD EQEXIN,USET,SIL,CASECC,DYNAMICS,,,,,,,,,,,/PARTMS1,/43/NEIGV/MODSEL/NOVEC $

Input Data Block:

EQEXIN Equivalence table between external and internal grid/scalar


identification numbers.

USET Degree-of-freedom set membership table for g-set.

SIL Scalar index list.

CASECC Table of Case Control command images.

DYNAMICS Table of Bulk Data entry images related to dynamics.

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.

MODSEL 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.

NOVEC 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.

Remarks:

1. None of the data blocks may be purged.

DMAP Programmer's Guide 10-175


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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,GOATG,GPECT,PCDB,POSTCDB,SETMC,EDT,DYNAMIC/PARTV,
/44/NOEPT/NOSE/IWHO///NUMPAN $

Input Data Blocks:

BGPDTS Basic grid point definition table.

SILS 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.

GOATG Transpost of GOA (o-set to a-set transformation) which has been


expanded to the g-set.

GPECT Grid point element connection table.

PCDB Table of model plotting commands.

POSTCDB Table of OUTPUT(POST) commands.

SETMC Modal contribution set definitions

10-176 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

EDT Element deformation table. Contains PANEL, SET1, and SET3


bulk entries.

DYNAMIC Table of bulk data images related to dynamics.

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 Input-integer default=0. Number of EPOINTs to process.

NOSE Input-integer default=0. NOSE should be set to 1 if superelement is used.

IWHO Input-integer default=0. IWHO should be set to 0 for enforced motion; set to 1 for
SOL 111 or SOL 112 with superelements.

NUMPAN Input-integer default=0. Number of acoustic panels.

Remarks:
1. All data blocks must exist except for GMTG, GOATG, PCDB, and POSTCDB. If any of the
required data blocks are purged, the module will not produce PARTV.

2. GMTG must exist in order to process m-set degrees-of-freedom. GOATG must exist to process
o-set degrees-of-freedom. PCDB and POSTCDB must exist to process model plotting commands
and OUTPUT(POST) commands, respectively.

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. DISPLACEMENT
b. VELOCITY
c. ACCELERATION
d. OLOAD
e. STRESS/ELSTRESS
f. STRAIN/ELSTRAIN
g. FORCE/ELFORCE
h. EDE
I. EKE

DMAP Programmer's Guide 10-177


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

j. ESE
k. XYPEAK
l. XYPRINT
m. XYPLOT
n. XYPUNCH
o. MPCFORCE
p. SPCFORCE
q. GPFORCE
r. GPSTRESS
s. GPSTRAIN
t. MODCON
u. PANCON

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.

P3 Input-integer default=0. Copy the subsequent P3 records to XCASECC after P2


records.

P4 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 $

10-178 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Option P1=46
Used internally for development.

Option P1=47
Used internally for development.

Option P1=48
Used internally for development.

Option P1=49
Modify Case Control to create data type-specific set and reference.

Format:

MATMOD CASECC,,,,,,,,,,,,,,,/CASEX,/49/IDTYPE/IELEM $

Input Data Blocks:

CASECC Case Control data block

Output Data Block:

CASEX Modified Case Control data block

Parameters:

IDTYPE Integer-input-default=0. Data type code: 0=stress, 1=strain, 2=element force.

IELEM Integer-input-default=0. Element ID.

Option P1=50
Extract item-code specific data from a modal contributions output data block and create a column
vector.

Format:

MATMOD ORES,,,,,,,,,,,,,,,/VECT,/50/ITMCOD $

Input Data Blocks:

ORES Modal contributions results data block

DMAP Programmer's Guide 10-179


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Block:

VECT Vector of modal contributions results

Parameters:

ITMCOD Integer-input-default=0. Element item code.

Option P1=51
Generate a surface spline to connect two point fields in close proximity, but not necessarily coincident.

Format:

MATMOD IM1,IM2,,,,,,,,,,,,,,/OM1,/51/P2/P3/P4/P5 $

Input Data Blocks:

IM1 Matrix of independent points. 3 rows by NI columns. NI = number


of independent points.

IM2 Matrix of dependent points. 3 rows by ND columns. ND = number


of dependent points.

Output Data Block:

OM1 Transformation matrix describing the surface spline connection. NI rows by ND


columns. NI = number of independent points. ND = number of dependent points.

Parameters:

P2,P3 Input-integer default=0,0. Used to define boundary condition of the surface spline.

0,0 Surface spline is unconstrained at the edges.

-1,0 A zero moment X-directional end condition is imposed on the surface


spline.

0,-1 A zero moment Y-directional end condition is imposed on the surface spline.

P4 Input-integer default=1. Coordinate pair selection.

1 XY point pairs are used for the surface spline fit.

2 XZ point pairs are used for the surface spline fit.

3 YZ point pairs are used for the surface spline fit.

10-180 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

P5 Input-real default=1.0. Used to stiffen springs applied during the surface spline
generation.

Option P1=52
Used internally for development.

Option P1=53
Generate a g-size partitioning vector and a list of grid IDs that correspond to the structural grids
that are a part of an acoustic coupling matrix.

Format:

MATMOD EQEXIN,USET,SIL,AG0MAX,,,,,,,,,,,,/PARTV,ACGRIDS/53///
S,N,NOPARTV $

Input Data Blocks:

EQEXIN Equivalence table between external and internal grid/scalar


identification numbers

USET Degree-of-freedom set membership table for g-set

SIL Scalar index list

AG0MAX Column matrix of maximum values in each row of the AG0 matrix
(usually derived using MATMOD option 6)

Output Data Block:

PARTV Column partitioning vector for all 6 degrees-of-freedom of grids which are a part of
the acoustic coupling

ACGRIDS Column vector containing the grid IDs of the grids which are a part of the acoustic
coupling; the grid IDs are represented as real values

Parameters:

NOPARTV Output-integer. NOPARTV is set to -1 if the output data blocks are null or cannot
be generated. Otherwise, it is set to zero.

Remarks:
1. None of the data blocks can be purged.

Option P1=54
Used internally for development.

DMAP Programmer's Guide 10-181


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Option P1=55

Compute modal damping coefficients, as in the GKAM module.

Format:

MATMOD LAMA,CASECC,DIT,,,,,,,,,,,,,/ZETA,/55 $

Input Data Block:

LAMA Normal modes eigenvalue summary table.

CASECC Table of Case Control command images.

DIT Table of TABLEij Bulk Data entry images.

Output Data Block:

ZETA Diagonal matrix of modal damping coefficients as produced by the GKAM module.

Option P1=56

Replace the value of, or add a value to, a single term in a matrix.

Format:

MATMOD I1,,,,,,,,,,,,,,,/
O1,/
56/ICOL/IROW/TYPE/REAL//NCOL/NROW/////////REALD/CMPLX/CMPLXD $

Input Data Block:

I1 A matrix. May be purged. See NCOL.

Output Data Block:

O1 Modified I1 matrix.

Parameters:

ICOL Column number.

IROW Row number.

10-182 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

TYPE Type of value to be replaced or added.


1 Replace current value with REAL.
2 Replace current value with REALD.
3 Replace current value with CMPLX.
4 Replace current value with CMPLXD.
-1 Add REAL to current value.
-2 Add REALD to current value.
-3 Add CMPLX to current value.
-4 Add CMPLXD to current value.

REAL Real single-precision value.

NCOL Number of columns in O1 if I1 is purged. Default=ICOL.

NROW Number of rows in O1 if I1 is purged. Default=IROW.

REALD Real double-precision value.

CMPLX Complex single-precision value.

CMPLXD Complex double-precision value.

Example:

In matrix A, add 10.5 to the value of a32 (the element of the matrix at column 2 and row 3):
MATMOD A,,,,,,,,,,,,,,,/A1,/56/2/3/—1/10.5 $

Option P1=57

Modify frequency list table TOL.

Format:

MATMOD TOL,,,,,,,,,,,,,,,/
TOL1,/
57/P2/P3 $

DMAP Programmer's Guide 10-183


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Input Data Block:

TOL Table of frequencies in transient response.

Output Data Block:

TOL1 Truncated table of frequencies containing values ranging between P2 and P3.

Parameters:

P2 Input-integer-default = 0. First frequency table entry to copy from TOL to TOL1.

P3 Input-integer-default = 0. Last frequency table entry to copy from TOL to TOL1.

Option P1=58

Present the topology optimization EFILL table in ONRGY format.

Format:

MATMOD ONRGY,EFILL,,,,,,,,,,,,,,/ONRGYC,/58 $

Input Data Block:

ONRGY Basic ONRGY table.

EFILL Element fill in table.

Output Data Block:

ONRGYC EFILL table in ONRGY format

Remarks:

1. The strain energy output data block (ONRGY) is used to store the element fill in ratios in the
case of topology optimization with the external optimizer. This enables the user to visualize the
optimized geometry without changing the OP2 file structure or introducing a new entity. This
option is available beginning in Version 8.5.

10-184 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Option P1=59
Create an element grid connectivity matrix for the elements contained in the EFILL matrix.

Format:

MATMOD MGEOM2,EFILL,,,,,,,,,,,,,,/BEGCPL,/58 $

Input Data Block:

GEOM2 Stardard geometry table.

EFILL Element fill in matrix.

Output Data Block:

BEGCPL Matrix containing ndvar columns, where ndvar is the number of rows in EFILL,
and ncgrid+m rows, where ncgrid is the total number of grids connected to the
element in EFILL.

Remarks:
1. The first ncgrid terms in each column are either 1 or zero, indicating whether the element is
connected to the grid corresponding to the row index or not.

2. The last m terms in each column contain the indices of the connected grids. For example, in
the case of Quad4 and TET4 elements m=4.

3. Note that the element indices are not the external grid IDs.

10.97 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.

DMAP Programmer's Guide 10-185


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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.

Ni Input-character-default=blank. Continuation entry prefix. Used to form a unique


continuation string for the DMI Bulk Data entries. For example, if Ni=’xx’, 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.

Remarks:

1. The nonzero elements of each matrix are punched on double-field DMI entries as shown in the
example below. The name of the matrix is obtained from the header record of the data block. Field
10 contains the three-character parameter value in columns 74 through 76 and an incremented
integer record count in columns 77 through 80 if nondefault values are used for the Ni parameters.

2. Double precision matrices 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 10-4.
The DMAP statement
MATPCH MAT// $

produces the following DMI entries:

10-186 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

1 2 3 4 5 6 7 8 9 10

DMI MAT 0 2 1 2 5 6

DMI MAT 1 1 1.000000E 00

* 3 2.000000E 00 5 3.000000E 00

DMI* MAT 2 3 4.000000E 00

* 5.000000E 00

DMI* MAT 3 1 6.000000E 00

* 7.000000E 00 5 8.000000E 00

DMI* MAT 6 4 9.000000E 00

10.98 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, Siemens PLM Software recommends using
either the MATPRT or MATGPR modules.

DMAP Programmer's Guide 10-187


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Examples:
1.
MATPRN KGG/$

2.
MATPRN KGG,PL,PG,BGG,UPV//$

3.
DIAGON(30) $ PRINT EXTENDED PRECISION
MATPRN KGG/$
DIAGOFF(30) $

10.99 MATPRT
Matrix printer

Format:
MATPRT MATRIX//PRNTLABL/PRNTFLAG $

Input Data Block:

MATRIX Matrix data block to be printed. If [X] is purged, nothing is done.

Parameters:

PRNTLABL Integer-input-default=0. Print label. If PRNTFLG=1, the matrix is labeled with


“ROW n”; otherwise it is labeled with “COLUMN n.”

PRNTFLAG Integer-input-default=0. Print flag. If PRNTFLAG < 0, do not print [X]; Y ≥ 0,


print [X].

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// $

10.100 MATREDU
Reduces square matrix from g-set to a-set or p-set to d-set

10-188 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 {XGG or XPP},{USET or USETD},{GM or GMD},{GOA or GOD}/


{XAA or XDD},XSF,XSS/
S,N,{NOXGG OR NOXPP} $

Input Data Blocks:

XGG Square matrix in g-set

XPP Square matrix in p-set

USET Degree-of-freedom set membership table for g-set

USETD Degree-of-freedom set membership table for p-set

GM Multipoint constraint transformation matrix, m-set by n-set

GMD Multipoint constraint transformation matrix with extra points, m-set by ne-set

GOA Omitted degree-of-freedom transformation matrix, o-set by a-set

GOD Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set

Output Data Blocks:

XAA Reduced square matrix in a-set

XDD Reduced square matrix in d-set

XSF S-set by f-set matrix partition of XGG or XPP after multipoint constraint elimination
and reduction

XSS S-set by s-set matrix partition of XGG or XPP after multipoint constraint elimination
and reduction

Parameters:

NOXGG Output-integer-default=1. XGG existence flag. Set to -1 if XGG does not exist.

NOXPP Output-integer-default=1. XPP existence flag. Set to -1 if XPP does not exist.

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.

DMAP Programmer's Guide 10-189


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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.

10.101 MCE1
Creates multipoint constraint transformation matrix

Format:

MCE1 USET,RMG/
GM $

Input Data Blocks:

USET Degree-of-freedom set membership table for g-set

RMG Multipoint constraint equation matrix

Output Data Block:

GM Multipoint constraint transformation matrix, m-set by n-set

Parameters:
None.

10.102 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 Degree-of-freedom set membership table for g-set

GM Multipoint constraint transformation matrix, m-set by n-set

10-190 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

XGGi Square matrices in g-set

Output Data Blocks:

XNNi Square matrices in n-set

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,,, $

10.103 MDATA
Computes pressures for selected elements associated with virtual fluid mass

Format:

MDATA CASECC,XYCDB,MAR,MEA,UAX,OL/
OEP/
APP/S,N,NOSORT2/FREQINDX $

Input Data Blocks:

CASECC Table of Case Control command images for the primary model

XYCDB Table of x-y plotting commands

MAR Table of virtual mass element areas

MEA Matrix of element forces per unit motion of the a-set

UA Displacement or eigenvector matrix in the a-set

Output Data Block:

OEP Table of element pressures due to virtual mass in SORT1 or SORT2 format

DMAP Programmer's Guide 10-191


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

APP Input-character-no default. Type of analysis. Allowable values are:


‘REIG’: Normal modes
‘CEIG’: Complex eigenvalues
‘FREQ’: Frequency response
‘TRAN’: Transient response

NOSORT2 Input-integer-default=-1. Set to 1 if SORT2 format is requested.

FREQINDX Input-integer-default=0. Frequency or time step index. Selects frequency


associated with UA.

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.

10.104 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 Table of Case Control command images

EDOM Table of Bulk Data entries related to design sensitivity and optimization

10-192 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

CASESTAT Case Control table for static analysis and based on ANALYSIS=STATICS

CASEMODE Case Control table for normal modes analysis and based on
ANALYSIS=MODES

CASEBUCK Case Control table for buckling analysis and based on ANALYSIS=BUCK

CASEFREQ Case Control table for modal or direct frequency response analysis and based
on ANALYSIS=MFREQ or DFREQ

CASECEIG Case Control table for modal or direct complex eigenvalue analysis and based
on ANALYSIS=MCEIG or DCEIG

CASEMTRN Case Control table for modal transient analysis and based on
ANALYSIS=MTRAN

CASESAER Case Control table for aerostatic analysis and based on ANALYSIS=SAERO

CASEDVRG Case Control table for aerostatic divergence analysis and based on
ANALYSIS=DIVERG

CASEFLUT Case Control table for flutter and based on ANALYSIS=FLUTTER

CASESMST Case Control table for structural analysis and based on ANALYSIS=STRU

CASESMEM Case Control table for electromagnetic analysis and based on


ANALYSIS=ELEC

CASEHEAT Case Control table for heat transfer analysis and based on ANALYSIS=HEAT

CASEUPSE Case Control table for upstream superelements only

CASESADV Combined Case Control table which includes CASESAER or CASEDVRG

CASESNMB Combined Case Control table which includes CASESTAT, CASEMODE,


CASEBUCK, CASESAER, CASEDVRG, and CASEFLUT

CASEXX Case Control table intended for Phase 1 matrix generation, assembly and
reduction

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.

MODECC 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.

DMAP Programmer's Guide 10-193


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

BUCKCC 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.

DFRQCC 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.

MFRQCC 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.

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.

MCEIGCC 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.

MTRNCC 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.

SAERCC 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.

DVRGCC 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.

FLUTCC 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.

SMSTCC 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.

SMEMCC 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.

HEATCC 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.

UPSECC Output-logical-default=FALSE. Superelement analysis subcase flag. Set to


TRUE if SUPER=ALL or SUPER>0 in CASECC, and CASEUPSE is specified
in the output list.

10-194 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

DESOBJ Output-integer-default=0. DESOBJ Case Control command set identification


number.

DESGLB Output-integer-default=0. DESGLB Case Control command set identification


number.

OBJSID Output-integer-default=-1. Superelement identification number associated with


DESOBJ. Set to -1 for all cases unless you specify the DESOBJ command in
a particular superelement subcase.

SEPRTN Input-logical-default=FALSE. SUPER command processing flag. Set to TRUE


to ignore SUPER command.

WVFLG Output-integer-default=0. Weight/volume response flag. If CASECC does not


contain any subcases for statics, normal modes, or buckling subcase, 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

10.105 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 Matrix partitions (real or complex)

DMAP Programmer's Guide 10-195


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

CP Column partitioning vector

RP Row partitioning vector

Output Data Block:

A Merged matrix from Aij

Parameters:

SYM Input-integer-default=-1. SYM < 0, {CP} is used for {RP}. SYM ≥ 0, {CP} and
{RP} are distinct.

TYPE 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].

FORM 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 10-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]

10-196 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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.

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 Rectangular Symmetric

Square Square Rectangular Rectangular

Form of [A11] Rectangular Rectangular Rectangular Rectangular

Symmetric Rectangular Rectangular Symmetric

DMAP Programmer's Guide 10-197


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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:

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

10-198 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

3. If, in Example 1, the DMAP instruction was written as


MERGE A11,A21,,,,RP/A/1 $

the input matrices would be

4. If the DMAP instruction is written as


MERGE A11,A21,A12,A22,,RP/A/-1 $

and the input matrices are:

the resulting matrix would be

10.106 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 Table of element stresses in SORT1

OESNL1 Table of nonlinear element stresses in SORT1 format

DMAP Programmer's Guide 10-199


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Block:

OES1X Table of linear and nonlinear element stresses in the SORT1 and linear element
format

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.

10.107 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 $

10.108 MGEN
Creates virtual fluid mass matrices

10-200 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Format:

MGEN CASECC,MATPOOL,EST,CSTM,BGPDT/
MCHI,MLAM,GEG,MAR,MCHI2,MLAM2/
LUSET/S,N,NOMGEN/UNUSED3/WTMASS/UNUSED5 $

Input Data Blocks:

CASECC Table of Case Control command images

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

EST Element summary table

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

Output Data Blocks:

MCHI Matrix relating displacements to source strengths

MLAM Matrix relating element forces to source strengths

GEG Element displacement interpolation matrix

MAR Table of virtual mass element areas

MCHI2 Secondary matrix relating displacements to source strengths

MLAM2 Secondary matrix relating element forces to source strengths

Parameters

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

NOMGEN Output-integer-default=-1. Fluid mass existence flag. Set to the MFLUID set
identification number if MFLUID is specified in CASECC.

unused3 Input-real-default=0.0. Unused.

WTMASS Input-real-default=1.0. Specifies scale factor on structural mass matrix.

unused5 Input-integer-default=-1. Unused.

10.109 MKCNTRL
Assembles a description of aerodynamic controllers sets

DMAP Programmer's Guide 10-201


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

MKCNTRL EDT,CSTMA,AEBGPDT/
AECTRL,TRX,AECSTMHG/
SYMXZ/AUNITS $

Input Data Blocks:

EDT Element deformation table

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

AEBGPDT Basic grid point definition table for the aerodynamic degrees-of-freedom

Output Data Blocks:

AECTRL Table of aeroelastic model controls

TRX Boolean matrix to select accelerations from the list of aerodynamic


extra points

AECSTMHG Table of aerodynamic coordinate system transformation matrices that


contains only the hinge moment referenced coordinates systems, if not
null.

Parameters:

SYMXZ Input-real-no default. x-z symmetry flag.

AUNITS Input-real-no default. Used to convert accelerations expressed in gravity


units to units of length per time squared.

Remarks:
None.

10.110 MKCSTMA
Merge coordinate system tables; usually tables from structural and aerodynamic models.

Format:

MKCSTMA CSTM1,CSTM2/CSTMM $

Input Data Block:

CSTMi Tables of coordinate system transformation matrices

10-202 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Block:

CSTMM Merged table of coordinate system transformation matrices

Parameters:
None.

10.111 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.

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

AEGRID Basic grid point definition tables for the aerodynamic model

AECOMP Aerodynamic component definition table

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 $

10.112 MODACC
OFREQ, OTIME, and OMODES command processor.

DMAP Programmer's Guide 10-203


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Removes columns in solution and load matrices based on the OTIME, OFREQ, and OMODES
case control commands.

Format:

MODACC CASECC,OL,U,P1,P2,P3/
OL1,U1,P11,P21,P31/APP/IOPT $

Input Data Blocks:

CASECC Table of Case Control command images.

OL Complex or real eigenvalue summary table, transient response time output


list or frequency response frequency output list.

U Solution matrix from normal modes, complex modes, transient response,


or frequency response.

Pi Any matrix with the same number of columns as there are eigenvalues,
frequencies, or time steps in OL.

Output Data Blocks:

OL1 OL truncated by the OFREQ or OTIME or OMODES command.

U1 U truncated by the OFREQ or OTIME or OMODES command.

Pi1 Pi truncated by the OFREQ or OTIME or OMODES command.

Parameters:

APP Input-character-default=‘TRAN’. Analysis type.

‘REIGEN’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘CEIGEN’ Complex eigenvalues

IOPT Input-integer-default=0. Processing options:


0=process OFREQ or OTIME or OMODES.

1=process SETMC for MODCON.

2=process SETMC for PANCON.

3=process SETMC for ERP.

10-204 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Remarks:
1. MODACC selects vectors based on OTIME or OFREQ or OMODES 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 APP = ‘REIG’

CLAMA APP = ‘CEIG’

FOL APP = ‘FREQ’

TOL APP = ‘TRAN’

3. If APP=’CEIGEN,’ P11 must not be purged.

10.113 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,GEOM2/
GPMPF,FMPF,SMPF,PMPF,LMPF,
MPFMAP/
NOFREQ/NOLOADF/GRIDFMP/NUMPAN/PNQALNAM/
SYMFLG/MPNFLG/FLUIDMP/STRUCTMP/PANELMP/
GRIDMP/NOSASET/FILTERF/FILTERS $

Input Data Blocks:

BGPDT Basic grid point definition table

USET Degree-of-freedom set membership table for g-set

CASECC Table of Case Control command images

EDT Table of Bulk Data entry images containing SET1 entries

ABESF* Family of a-set size panel area matrices

PHASH2 Structural partition (row-wise) of eigenvector matrix PHDH. Also


partitioned column-wise according to parameter STRUCTMP

DMAP Programmer's Guide 10-205


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

UHFS Structural partition (row-wise) of solution matrix UHF. Also partitioned


column-wise according to parameter STRUCTMP

PHDFH Fluid partition (row-wise) of eigenvector matrix PHDH

MFHH Fluid partition of modal mass matrix MHH

BFHH Fluid partition of modal damping matrix BHH

KFHH Fluid partition of modal stiffness matrix KHH

FOL Table of forcing frequencies

ABEH* Family of signed modally reduced area matrices

PHDFH1 Fluid partition (row-wise) of eigenvector matrix PHDH reduced to a-set


size

PHDFH2 PHDFH1 partitioned by parameter FLUIDMP

UHFF Fluid partition (row-wise) of solution matrix UHF. Also partitioned


column-wise according to parameter FLUIDMP

AH Signed global modally reduced area matrix

PFHF Fluid partition of frequency response modally reduced load matrix

UNUSED Unused

PNLLST Table of triplets defining panel names and their associated IPANEL
qualifier values

VGA G-set size partitioning vector with values of 1.0 at the rows
corresponding to the a-set

GEOM2 Table of bulk data images related to element connectivity

Output Data Blocks:

GPMPF Matrix of grid panel mode participation factors

FMPF Matrix of fluid mode participation factors

SMPF Matrix of contribution of structure to fluid mode participation factors

PMPF Matrix of contribution of structural panels to fluid mode participation


factors

LMPF Matrix of fluid force to fluid mode participation factors

MPFMAP Table describing content of mode participation factor matrices

10-206 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Parameters:

NOFREQ Input-integer-no default. Number of excitation frequencies.

NOLOADF Input-integer-no default. Number of load cases per frequency.

GRIDFMP Input-integer-no default. Case Control set identification number of


fluid grids that are output:

<0 Print matrices; if -999, print matrices for -1 (set = all)

-1 All fluid grid a-set

0 No fluid grid a-set

>0 Case Control set that contains grid list to be output

NUMPAN Input-integer-no default. Number of panels.

PNQALNAM Input-character-default=” Name of qualifier for panels.

SYMFLG Input-complex-default=(1.,0.). Scale factor.

MPNFLG Input-integer-no default. Panel existence flag.

FLUIDMP Input-integer-default=-1. Number of fluid modes to use in computing


factors. If FLUIDMP>0, compute factors for the first FLUIDMP modes.

STRUCTMP Input-integer-default=-1. Number of structure modes to use


computing factors.

PANELMP Input-integer-default=-1. Flag to compute panel participation factors.


See Remark 2.

GRIDMP Input-integer-default=-1. Case Control set identification number for


a set of fluid grids.

NOSASET Input-integer-default=-1. Number of degrees-of-freedom in the a-set


of the structure.

FILTERF Input-real-default=0.95. Filter for fluid factor matrices.

FILTERS Input-real-default=0.95. Filter for structure factor matrices.

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.

DMAP Programmer's Guide 10-207


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

• Compute load mode participation factors, LMPF.

• If MPNFLG>0 and GRIDMP>-1, compute fluid grid mode participation factors, GMPF.

10.114 MODEPOUT
Filter, sort, and printout mode participation factor matrices. Also create table data blocks suitable for
XY plots and power spectral density calculations.

Format:

MODEPOUT LAMAF,LAMAS,CASECC,FMPF,SMPF,
PMPF,LMPF,GMPF,MPFMAP/
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 Normal modes eigenvalue summary table for the fluid portion of the model

LAMAS Normal modes eigenvalue summary table for the structural portion of the
model

CASECC Table of Case Control command images

FMPF Matrix of fluid mode participation factors

SMPF Matrix of contribution of structure to fluid mode participation factors

PMPF Matrix of contribution of structural panels to fluid mode participation factors

LMPF Matrix of fluid force to fluid mode participation factors

GPMPF Matrix of grid panel mode participation factors

MPFMAP Table describing content of mode participation factor matrices

Output Data Blocks:

OFMPF2E Table of fluid mode participation factors by excitation frequencies

OFMPF2M Table of fluid mode participation factors by normal mode

OSMPF2E Table of structure mode participation factors by excitation frequencies

OSMPF2M Table of structure mode participation factors by normal mode

OPMPF2E Table of panel mode participation factors by excitation frequencies

10-208 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

OPMPF2M Table of panel mode participation factors by normal mode

OLMPF2E Table of load mode participation factors by excitation frequencies

OLMPF2M Table of load mode participation factors by normal mode

OGMPF2E Table of grid mode participation factors by excitation frequencies

OGMPF2M Table of grid mode participation factors by normal mode

UNUSEDi Unused

Parameters:

OUTFMP Input-integer-default=0. Number of fluid modes to output.

OUTSMP Input-integer-default=0. Number of structure modes to output.

FMPFEPS Input-real-default=0.0. Threshold for filtering out small fluid factor


magnitudes.

SMPFEPS Input-real-default=0.0. Threshold for filtering out small structure


factor magnitudes.

MPFSORT Input-integer-default=11. Sort flag.

10 Sort on absolute value (magnitude)

20 Sort on real portion

30 Sort on complex portion

40 Sort on phase angle (must convert)

1 Descending sort

2 Ascending sort

NOMPF2E Input-integer-default=-1.

0 Generate

-1 Do not generate

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.

DMAP Programmer's Guide 10-209


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.115 MODEPT
Updates PACABS and PACABR Bulk Data entry records based upon data on TABLEDi Bulk Data
entry records.

Format:

MODEPT EPT,DIT/EPTX/S,N,NOGOMEPT $

Input Data Blocks:

EPT Table of Bulk Data entry images related to element properties; in particular,
PACABS and PACABR entries

DIT Table of TABLEij Bulk Data entry images

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.

10.116 MODGDN
Updates geometry table for existence of p-elements and superelements

Format:

MODGDN GEOM1,SEMAP,MFACE,MEDGE,MBODY/
GEOM1P/
S,N,NOSEMAP $

10-210 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Input Data Blocks:

GEOM1 Table of Bulk Data entry images related to geometry

SEMAP Superelement map table

MFACE Face table for p-element analysis

MEDGE Edge table for p-element analysis

MBODY Body table for p-element analysis

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.

10.117 MODGMRB
Modifies GEOM2 and GEOM4 data blocks for converting RBAR and RBE2 elements into CBEAM
and CELAS1 elements in SOL 401 when either RIGID = STIFF is specified or RIGID = AUTO with
LGDISP = 1 are specified.

Format:

MODGMRB BGPDT,IGEOM2,IGEOM4,MPT/
OGEOM2,OGEOM4/
RGLCRIT/RGBEAME/RGBEAMA/RGSPRGK $

Input Data Blocks:

BGPDT Basic grid point definition table

IGEOM2 Table of bulk data entry images related to element connectivity and scalar points

IGEOM4 Table of bulk data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity

MPT Table of bulk data entry images related to material properties

DMAP Programmer's Guide 10-211


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Blocks:

OGEOM2 Modified table of bulk data entry images related to element connectivity and
scalar points

OGEOM4 Modified table of bulk data entry images related to constraints, degree-of-freedom
membership, and rigid element connectivity

Parameters:

RGLCRIT Input-real-default = 1.0 x 10-6 x largest dimension in the model. Coincident grid
tolerance.

RGBEAME Input-real-default = 1.0 x 102 x largest Young’s Modulus in the model. Determines
the Young’s modulus for the beam element. Default = 1.0 x 1012 if an MPT data
block is not present.

RGBEAMA Input-real-default = (1.0 x 10–2 x largest dimension in the model)2. Determines the
cross-sectional area of the beam element.

RGSPRGK Input-real-default = largest dimension in the model x largest Young’s Modulus in


the model. Determines the stiffness of the CELAS1 element. Default = 1.0 x 1012
if an MPT data block is not present.

10.118 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 Table containing element properties Bulk Data entry records

GEOM2 Table containing element connectivity Bulk Data entry records

GEOM1 Table of Bulk Data entry images related to geometry

10-212 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Block:

EPTX Copy of EPT except for the records shown in Remark 2

GEOM1X GEOM1 table related to axisymmetric conical shell, hydroelastic, acoustic cavity,
and spot weld element analysis

Parameter:

ACFLAG Integer-output-default=0. ACFLAG>0 indicates fluid elements:


0 No fluid elements
1 Fluid elements
2 Fluid/structure coupling

OSWPPT Input-integer-default=0. Offset for spot weld projection point IDs.

OSWELM Input-integer-default=0. Offset for spot weld element IDs.

NSWPPT Output-integer-default=0. Current spot weld projection point ID.

NSWELM Output-integer-default=0. Current spot weld element ID.

SWEXIST Output-logical-no default. Spot weld element existence flag. Set to TRUE if spot
weld elements exist.

NOGOMGM2 Output-logical-no default. MODGM2 module error return flag. Set to TRUE if
an error is found.

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 GEOM2X record
Record Fluid Hyperelastic
------ --------------------
CQUAD4 n/a QUAD4FD
CQUAD8 n/a QUAD8FD
CTRIA3 n/a TRIA3FD
CTRIA6 n/a TRIA3FD
CQUAD n/a QUADFD
CTRIAX n/a TRIAXFD
CQUADX n/a QUADXFD
CHEXA HEXPR HEXAFD
CPENTA PENPR PENTAFD
CTETRA TETPR TETRAFD

Example:

See the example in the IFP module description.

DMAP Programmer's Guide 10-213


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

10.119 MODGM2B
Modifies GEOM1, GEOM2 and GEOM4 data blocks and creates the SBDATA block for bolts modeled
as solids.

Format:

MODGM2B CASECC,MPT,EPT,GEOM1,GEOM2,GEOM4,CONTACT,EDT,IGEOM3/
MGEOM1,MGEOM2,MGEOM4,MCONTACT,SBDATA,MGEOM3/
BOLTFACT/S,N,IBTEX $

Input Data Blocks:

CASECC Case control data block

MPT Table containing element properties Bulk Data entry records

EPT Material property data block

GEOM1 Grid geometry Bulk Data block

GEOM2 Element connectivity Bulk Data block

GEOM4 Rigid element Bulk Data block

CONTACT Contact/Glue Bulk Data definitions

EDT Table of Bulk Data entry images with Bolt definitions

IGEOM3 Static and thermal load information

Output Data Blocks:

MGEOM1 Modified grid geometry Bulk Data block

MGEOM2 Modified element connectivity Bulk Data block

MGEOM4 Modified data block with bolt constraint data

MCONTACT Modified data block with adjustments for the solid bolt definitions

SBDATA Solid bolt data for downstream processing

MGEOM3 Modified static and thermal load information

Parameters:

BOLTFACT Input-real-default=1.0E+07. Factor used to reduce the bolt stiffness during the
first phase of a bolt preload analysis.

10-214 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

IBTEX Output-logical.
FALSE if no solid bolts are defined.
TRUE if solid bolts are defined.

Remarks:

None

10.120 MODGM4
Reads SPCs and SPCDs and generates unique SPC and SPCD records

Reads the SPCs and SPCDs that were defined by GMBC, GMSPC, SPC, SPC1, or SPCD Bulk Data
entries and generates the unique SPC and SPCD records.

Format:

MODGM4 CASECC,GEOM2M,GEOM4M,DEQATN,DEQIND,DIT,BGPDTM,EPT/
GEOM4P/
GNSTART/S,N,MODGM4/ALTSHAPE/S,N,NSWELM $

Input Data Blocks:

CASECC Table of Case Control command images

GEOM2M Table of Bulk Data entry images related to element connectivity and scalar points
and updated for the current p-level

GEOM4M Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity and updated for the current p-level

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

DIT Table of TABLEij Bulk Data entry images

BGPDTM Basic grid point definition table and updated for the current p-level

EPT Table containing element properties Bulk Data entry records

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

DMAP Programmer's Guide 10-215


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Parameters:

GNSTART Input-integer-default=0. First grid identification number in GEOM1M.

MODGM4 Output-logical-default=FALSE. GEOM4P update flag. Set to TRUE if GEOM4M is


updated.

ALTSHAPE Input-integer-no default. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

NSWELM Output-integer-default=0. Current spot weld element ID.

10.121 MODTRK
Reorders eigenvalues and eigenvectors to be consistent with previous design cycle
Compares the mode set of the current design cycle with those of the previous design cycle, identifies
or tracks these modes, and reorders the eigenvalues and eigenvectors to be consistent with the
previous design cycle.

Format:

MODTRK CASECC,EDOM,R1TABR,LAMA,MGG,MAA,PHG,PHA,PHGREF,
PHAREF/MTRAK,LAMA1,PHG1,PHA1,PHGREF1,PHAREF1/
DESCYCLE/S,N,NOTRACK $

Input Data Blocks:

CASECC Table of Case Control command images

EDOM Table of Bulk Data entries related to design sensitivity and optimization

R1TABR Table of retained first level (direct) (DRESP1 Bulk Data entry) attributes

LAMA Normal modes eigenvalue summary table

MGG Mass matrix in g-size

MAA Mass matrix in a-set

PHG Normal modes eigenvector matrix in the g-set

PHA Normal modes eigenvector matrix in the a-set

PHGREF Designed normal modes eigenvector matrix in the g-set from the prior design
cycle output of MODTRK

PHAREF Designed normal modes eigenvector matrix in the a-set from the prior design
cycle output of MODTRK

10-216 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Output Data Blocks:

MTRAK Table of updated DRESP1 Bulk Data entry images corresponding to the new
mode numbering

LAMA1 Normal modes eigenvalue summary table updated for mode tracking

PHG1 Normal modes eigenvector matrix in the g-set updated for mode tracking

PHA1 Normal modes eigenvector matrix in the a-set updated for mode tracking

PHGREF1 Designed normal modes eigenvector matrix in the g-set updated for mode tracking

PHAREF1 Designed normal modes eigenvector matrix in the a-set updated for mode tracking

Parameters:

DESCYCLE Input-integer-no default. Design cycle analysis counter.

NOTRACK Output-logical-default=FALSE. Mode tracking success flag. Set to TRUE if mode


tracking was successful.

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 $

10.122 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

DMAP Programmer's Guide 10-217


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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 I1,I2/O1 $
MODTRL O1////6 $
EQUIVX Ol/O2/ALWAYS $

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 Matrix trailer

P1 Number of columns

P2 Number of rows

P3 Form

P5 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 GO,KOA,KAAB/KAA/1 $
MODTRL 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) $

10-218 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 $

10.123 MODUSET
Modifies the degree-of-freedom set membership table (USET)

Format:

MODUSET UNUSED1,USET/
USETM/
USETOP/MAJOR/SET0/SET1/USETADD/UNUSED6/UNUSED7 $

Input Data Blocks:

EDITVEC Vector with zeros in rows to be removed under USETOP=‘FILTER’ See Remark 2.

USET 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 Input-character-default=‘UNION’ Name of desired operation. See Remark 1.

MAJOR Input-character-default=‘U3’ Name of the major set. The major set must be larger
than the subsets defined by SET0 and SET1.

SET0 Input-character-default=‘U2’ Name of the "zeros" subset of MAJOR.

SET1 Input-character-default=‘U1’ Name of the "ones" subset of MAJOR.

USETADD Input-integer-default=1. USET length extension. If USETOP=‘EXPAND‘, extend


the size of the USET by this amount.

UNUSED6 Input-integer-default=0. Unused.

UNUSED7 Input-integer-default=0. Unused.

Remarks:
1. The values and actions for USETOP are:

DMAP Programmer's Guide 10-219


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

UNION Combine SET0 and SET1 into MAJOR

COMP0 Form SET0 from complement of MAJOR and SET1

COMP1 Form SET1 from complement of MAJOR and SET0

DELETE Remove degrees-of-freedom from MAJOR

TURNON Add degrees-of-freedom from MAJOR

COPY Copy degrees-of-freedom from SET0 to MAJOR

EXPAND Extend USET length by USETADD.

MOVE Move SET0 degrees-of-freedom to MAJOR

FILTER Remove degrees-of-freedom from USET that correspond to zero rows in


EDITVEC

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 ,,USET/VSET/‘COMP0‘/‘F’/‘U1‘/‘A’ $
MODUSET ,,VSET/WSET/‘COMP1‘/‘F’/ /‘U2’$
MODUSET ,,WSET/XSET/‘UNION‘/‘U3‘/‘U1‘/‘U2’$

3. The following alter puts all degrees-of-freedom automatically constrained by GPSP into the sg-set.
COMPILE SEKR0
ALTER ‘GPSP‘(,-1) $ BEFORE GPSP
$ MOVE DOF IN SET SB INTO SET U3
MODUSET, ,USET0/VSET/‘MOVE‘/‘U3‘/‘SB‘/ $
EQUIVX VSET/USET0/ALWAYS $
MESSAGE //‘SB SET SHOULD NOW BE EMPTY - CHECK BELOW‘/ $
TABPRT USET0,EQEXINS//‘USET‘/11
ALTER ‘GPSP’$ AFTER GPSP
MESSAGE //‘SB SET SHOULD NOW BE ONLY AUTOSPC DOF - CHECK BELOW‘/ $
TABPRT USET,EQEXINS//‘USET‘/11
$ MOVE CURRENT SB (ALL FROM AUTOSPC) INTO SG
MODUSET, ,USET/VSET1/‘MOVE‘/‘SG‘/‘SB‘/ $
MESSAGE //‘SB SET SHOULD NOW BE EMPTY,SG SHOULD BE PS + AUTOSPC‘/ $
TABPRT VSET1,EQEXINS//‘USET‘/11
$ NOW MOVE SET U3 BACK INTO SB
MODUSET, ,VSET1/VSET2/‘MOVE‘/‘SB‘/‘U3‘/ $

10-220 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

EQUIVX VSET2/USET/ALWAYS $
MESSAGE //‘SB SET SHOULD NOW BE ONLY SPC DOF‘/
’SG SHOULD BE PS + AUTOSPC‘/ $
TABPRT USET,EQEXINS//‘USET‘/11 $

10.124 MONVEC
Forms monitor point rigid body vectors

Format:

MONVEC

Input Data Blocks:

AEMONPT Table of aerodynamic monitor points

MONITOR Table of structural monitor points

AEROCOMP Table of aerodynamic components when MESH=‘AERO’

STRUCOMP Table of structural components when MESH=‘STRU’

AEBGPDT Basic grid point definition table for the aerodynamic degrees-of-freedom

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

Output Data Blocks:

SRKS Matrix of monitor point rigid body vectors

Parameters:

None.

10.125 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.

DMAP Programmer's Guide 10-221


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Format:

MPP

Input Data Blocks:

AECTRL Table of aeroelastic model controls.

UXDAT Table of aerodynamic extra point identification numbers, displacements, labels,


type, status, position and hinge moments

MONITOR Monitor point table

AEMONPT Aerodynamic monitor point table

MPSR Rigid aerodynamic loads on structural monitor points at trim (excluding inertial
loads and static applied loads)

MPAR Rigid aerodynamic loads on aerodynamic monitor points at trim

MPSER Elastic restrained loads on structural monitor points at trim (excluding inertial
loads and static applied loads)

MPAER Elastic restrained loads on aerodynamic monitor points at trim

MPEU Elastic unrestrained loads on monitor points either at trim or across ADB/AEDB

MPSIR Inertial loads on structural monitor points at trim

MPSRP Rigid loads on structural monitor points due to static applied loads

MPSERP Elastic restrained loads on structural monitor points due to static applied loads

UXV Control state matrix for ADB or AEDB

ADBINDX Index of ADB or AEDB

Output Data Blocks:

None.

Parameters:

MACH Input-real-no default. Mach number.

Q Input-real-no default. Dynamic pressure.

10-222 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

AECONFIG Input-character-no default. Aerodynamic configuration.

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

MESH Input-character-no default. Mesh type

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’$

10.126 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 Left-hand matrix in the matrix product

B Right-hand matrix in the matrix product

C Matrix to be added to the product

Output Data Block:

X Matrix product

DMAP Programmer's Guide 10-223


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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]

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.

10-224 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Method Storage technique MPYAD keyword


deselection value

1 Nontranspose 1 1

1 Transpose 1 2

2 Nontranspose — 4

2 Transpose — 8

3 Nontranspose — 16

3 Transpose — 32

4 Nontranspose — 64

4 Transpose — 128

1 Nontranspose A 256

1 Nontranspose B 512

1 Nontranspose C 1024

1 Nontranspose D 2048

1 Nontranspose E 4096

1 Nontranspose F 8192

1 Transpose A 16384

1 Transpose B 32768

1 Transpose C 65536

1 Transpose D 131072

1 Nontranspose 2 8388608

1 Transpose 2 16777216

1 Nontranspose 3 67108864

1 Transpose 3 134217728

• 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.

DMAP Programmer's Guide 10-225


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

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)).

Example 2: If Method 2 is also desired in Example 1, NASTRAN MPYAD=247794


(which is obtained from 262143-(2048 + 4096 + 8192 + 8 + 4 + 1)).

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.

Method Storage submethod Selection value

Method StorageSubmethod SelectionValue

1 Nontranspose 1 0

1 Transpose 1 1

2 Nontranspose — 2

2 Transpose — 3

3 Nontranspose — 4

3 Transpose — 5

4 Nontranspose — 6

4 Transpose — 7

1 Nontranspose A 8

1 Nontranspose B 9

1 Nontranspose C 10

1 Nontranspose D 11

1 Nontranspose E 12

1 Nontranspose F 13

1 Transpose A 14

1 Transpose B 15

1 Transpose C 16

1 Transpose D 17

10-226 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

Method Storage submethod Selection value

1 Nontranspose 2 23

1 Transpose 2 24

1 Nontranspose 3 26

1 Transpose 3 27

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.

Sparse method SPARSE keyword value

Nontranspose 2

Transpose 4

Example 1: To force the sparse nontranspose method, specify SPARSE = 3,


computed from 1 + 2.

Example 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:

DMAP Programmer's Guide 10-227


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

MPYAD keyword Storage technique

1048592 Transpose C

1048588 Nontranspose E

192512 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 $

10.127 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.

10-228 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

10.128 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 Monitor tables

SZRi Associated monitor matrices

Output Data Blocks:

MON Merged monitor table

SZR 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.

10.129 MSGHAN
Passes message number for processing by MSGPOP API

Format:

MSGHAN //MSGNUM/MSGINP1/MSGINP2/S,N,MSGOUT $

Input Data Blocks:


None.

DMAP Programmer's Guide 10-229


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

Output Data Blocks:

None.

Parameters:

MSGNUM Input-integer-default=0. Message number.

MSGINP1 Input-integer-default=0. Optional integer input.

MSGINP2 Input-integer-default=0. Optional integer input.

MSGOUT Output-integer-default=0. Optional integer output.

10.130 MSGSTRES
Computes data based on fields generated by MSGMESH
Computes grid point stresses, maximum and minimum stresses, and stress contour plots based
on fields generated by MSGMESH.

Format:

MSGSTRES FORCE,OES1X//
S,N,PLTNUM/NOMSGSTR $

Input Data Blocks:

FORCE Table of MSGSTRESS plotting commands defined under the OUTPUT(CARDS)


section in CASE CONTROL and MSGMESH field information

OES1 Table of element stresses or strains in SORT1 format

Output Data Blocks:

None.

Parameters:

PLTNUM Input/output-integer-default=0. Plot frame counter.

NOMSGSTR Input-integer-default=0. MSGSTRES execution flag. Set to -1 if MSGSTRES


execution is not desired.

10.131 MTRXIN
Converts matrices input on DMIG Bulk Data entries to matrix data blocks.

10-230 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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)

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).

DMAP Programmer's Guide 10-231


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

MTRXIN

Form 6 - Selection of DMIK, DMIJ, and DMIJI matrices by the MATNAMi input parameter values
(IOPT=13 through 15)

MTRXIN

Input Data Blocks:

CASECC Table of Case Control command images

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

EQDYN Equivalence table between external and internal grid/scalar/extra point


identification numbers. (EQEXIN appended with extra point data)

TFPOOL Table of TF Bulk Data entry images

AEBGPDTK Basic grid point definition table for the aerodynamic ks-set degrees of freedom

AEBGPDTJ Basic grid point definition table for the aerodynamic js-set degrees of freedom

10-232 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

AEBGPDTI Basic grid point definition table for the aerodynamic js-set interference degrees of
freedom

Output Data Blocks:

NAMEi Matrices defined on DMIG Bulk Data entries

K2GG, etc. Matrices defined on DMIG Bulk Data entries and referenced by the K2GG, M2GG,
B2GG, K42GG, A2GG, K2PP, M2PP, B2PP, or P2G Case Control commands

MATPi Matrices defined on DMIG Bulk Data entries and intended for the p-set

MATGi Matrices defined on DMIG Bulk Data entries and intended for the g-set

RMATG Rectangular matrix defined on DMIG Bulk Data entries and can have an arbitrary
number of columns but g-set rows, similar to P2G

MATKi Matrices defined on DMIK Bulk Data entries

MATJi Matrices defined on DMIJ Bulk Data entries

MATIi Matrices defined on DMIJI Bulk Data entries

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

LUSETD Input-integer-no default. The number of degrees-of-freedom in the p-set.

NONAMEi Output-integer-default=-1. NAMEi generation flag. Set to +1 if NAMEi is


generated; -1 otherwise.

NOK2, etc. Output-integer-default=-1. K2GG, and so on, generation flag. Set to +1 if K2GG,
and so on is generated; -1 otherwise.

IOPT Input-integer-default=0. Case Control command selection flag.

0 No Case Control command selection (see Form 1) or K2GG, and so on, and
TFL Case Control command selection (see Form 2)

1 K2GG, and so on, Case Control command selection (see Form 2)

2 P2G Case Control command selection (see Form 3)

3 DMIK selection by output data block name (see Form 4)

4 DMIJ selection by output data block name (see Form 4)

5 DMIJI selection by output data block name (see Form 4)

10 K2PP, M2PP, and B2PP selection by input parameter value (see Form 5)

DMAP Programmer's Guide 10-233


Chapter
Chapter 10:10:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions E-M E-M

11 K2GG, M2GG, B2GG, K42GG, and A2GG selection by input parameter


value (see Form 5)

12 P2G selection by input parameter value (see Form 5)

13 DMIK selection by input parameter value (see Form 6)

14 DMIJ selection by input parameter value (see Form 6)

15 DMIJI selection by input parameter value (see Form 6)

LKSET Output-integer-default=0. Size of ks-set, js-set, and inteference js-set


LJSET, extracted from the AEBGPTK, AEBGPDTJ and AEBGPDTI tables.
LISET

NOMATi Output-integer-default=1. Generation flag. Set to +1 if MAT* is generated;


1 otherwise.

MATNAMi Input-character-default=’ ’ Matrix name found on DMIG, DMIJ, DMIK, and


DMIJI Bulk Data entries.

TFLID Input-integer-default=0. Transfer function set identification number. TFLID


is ignored if IOPT=3, 4, 5, 13, 14, or 15.

NFEXIT Input-logical-default=TRUE. Termination flag. If FALSE, do not issue User


Fatal Message 2070 and do not terminate the module if the matrix is not
found.

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, A2GG, 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 $

10-234 DMAP Programmer's Guide


DMAP Module and Statement Descriptions E-M

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 $
ENDIF $
IF (NOMASS > -1) THEN $
ADD MGG,MASS/MGGNEW $
EQUIVX MGGNEW/MGG/ALWAYS $
ENDIF

DMAP Programmer's Guide 10-235


Chapter 11: DMAP Module and Statement Descriptions N-X

11.1 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 Table of Case Control command images

ELSET Table of element sets defined in OUTPUT(POST) or SETS DEFINITION section


of Case Control

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

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.

11.2 NLCBRFOR
Nonlinear CBEAR element force request checker.

Format:

NLCBRFOR CASECC,DYNAMIC,EDT//S,N,FLAG $

DMAP Programmer's Guide 11-1


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Input Data Blocks:

CASECC Table of case control command images

DYNAMIC Table of bulk data entry images related to dynamics

EDT Element definition table

Output Data Blocks:

None

Parameters:

FLAG Output-integer-no default. If returned as “1”, nonlinear CBEAR elements are


requested for element force output

11.3 NLCOMB
Consolidates tables related to nonlinear elements and applied loads.
Consolidates tables related to nonlinear elements and applied loads for the current nonlinear analysis
iteration.

Format:

NLCOMB CASECC,ESTNL,KDICTNL,BKDICT,ETT,PTELEM0,
UNUSED8,MPT,EQEXIN,SLT,DLT,BGPDT/
ELDATA,{SLT1 or DLT1}/
NSKIP/LSTEP/LINC/STATIC/LGDISP/TSETPREV $

Input Data Blocks:

CASECC Table of Case Control command images

EST Element summary table containing geometric and/or material nonlinear elements

KDICTNL KELMNL dictionary table

BKDICT BKELM dictionary table

ETT Element temperature table

PTELEM0 Table of thermal loads in the elemental coordinate system from prior subcase

PTELEM Table of thermal loads in the elemental coordinate system for the current subcase

UNUSED8 Not used and can be purged

MPT Table of Bulk Data entry images related to material properties

11-2 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

SLT Table of static loads

DLT Table of dynamic loads

BGPDT Basic grid point definition table

Output Data Blocks:

ELDATA Table of combined nonlinear information data

SLT1 Table of static loads updated for nonlinear analysis

DLT1 Table of dynamic loads updated for nonlinear analysis

Parameters:

NSKIP Input-integer-no default. Subcase record number to read in CASECC.

LSTEP Input-integer-no default. Load step. The current iteration step at the subcase
level for static solutions.

LINC Input-integer-no default. Number of load increments for this subcase.

STATIC Input-integer-default=0. Static analysis flag. Set to zero for static analysis and one
for dynamic analysis.

LGDISP Input-integer-default=0. Large displacement flag. Set to 1 for large displacement


analysis.

TSETPREV Input-integer-default=0. Set ID of TEMP(LOAD) from the previous subcase. For


the first subcase or the global case, set TSETPREV to zero.

11.4 NLCPRM
Returns value of parameter set in NLCNTL bulk data entry.

Format:

NLCPRM CASECC,MPT//P1/P2/S,N,P3/S,N,P4/S,N,P5 $

Input Data Blocks:

CASECC Table of case control command images

MPT Table of bulk data entry images related to material properties

DMAP Programmer's Guide 11-3


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:

None

Parameters:

P1 Input-character-no default

P2 Input-character-no default

P3 Output-integer-default=0

P4 Output-real-default=0.0

P5 Output-character-default=blank

Remarks:

1. Currently, P1 can be set to any character string and does not have any impact on the module’s
operation. In the future, more options will be added. Example, P1=‘DTI’.

2. P2 is the parameter whose value the user requires to be returned. This parameter can be any
of those allowed in NLCNTL bulk data entry. The entire parameter name is required. Example,
P2=’FOLLOWK’. See the NLCNTL bulk data entry for a complete list of parameter names in
the NX NASTRAN Quick Reference Guide.

3. Depending on the parameter requested, P3, P4, or P5 will need to be requested in order to return
the value of that parameter. For instance, P2=’FOLLOWK’ will require a character output variable
to be specified in P5, leaving P3 and P4 blank.

4. If the output variable is specified in the wrong location, there will be no fatal or warning and
the returned value will be incorrect. For instance, for P2=’FOLLOWK’, if an output variable is
requested in P4 (which is a real) instead of P5, then there will be no fatal or warning but P4 will
not contain the value of FOLLOWK.

11.5 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.

11-4 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Table of Case Control command images

CNVTST Convergence test matrix

PLMAT Initial and final load matrices for subcase

YSMAT Initial and final enforced displacement matrices

KAAL Element stiffness matrix for linear elements only reduced to a-set

ELDATA Table of combined nonlinear information data

KELMNL Table of element matrices for stiffness for nonlinear elements

LLLT Lower triangular factor for nonlinear elements including material, slideline, and
differential stiffness effects

GM Multipoint constraint transformation matrix, m-set by n-set

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

MGG Radiation matrix in g-size

SLT1 Table of static loads updated for nonlinear analysis

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

SIL Scalar index list

USET Degree-of-freedom set membership table for g-set

DMAP Programmer's Guide 11-5


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

RDEST Radiation element summary table

RECM Radiation exchange coefficient matrix

KGGNL Stiffness matrix in g-set for material nonlinear elements only

ULLT Upper triangular factor for nonlinear elements including material, slideline, and
differential stiffness effects

GPSNT Grid point shell normal table

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries.

DITID Table of identification numbers in DIT

DEQIND Index table to DEQATN data block

DEQATN Table of DEQATN Bulk Data entry images

FENL Strain energy and grid point force at every element from the previous load step in
nonlinear matrix format

EPT Table of Bulk Data entry images related to element properties

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

Output Data Blocks:

UGNI Displacement matrix at converged step in the g-set

FGNL Nonlinear element force matrix from the last iteration

ESTNLH Nonlinear element summary table at converged step

CIDATA Miscellaneous data for controlled increment method

QNV Quasi-Newton sweeping vectors

FFGH Follower force for OLOAD output

MUGNI Displacement matrix for stiffness update

MESTNL Nonlinear element summary table at current step

DUGNI Incremental displacement matrix between the last two converged steps

BTOPOCNV Updated contact regions input information table

BTOPOSTF Updated contact regions topological information table

11-6 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

FENL1 Strain energy and grid point force at every element at the current load step in
nonlinear matrix format

Parameters:

LOADFAC Input/output-complex-no default. Load factor. The real part is the load factor
for the current iteration, having a fractional value between 0 and 1.

CONV Input/output-integer-default=0. Nonlinear analysis convergence flag.

On input:

0 Initialization

On output:

-1 Convergence has not been achieved.

1 Convergence has been achieved.

RSTEP Input/output-integer-default=0. Controlled increments counter.

NEWP Input/output-integer-default=1. New subcase flag.

-1 Current subcase has not been completed.

1 Current subcase has been completed.

NEWK Output-integer-default=1. Stiffness update flag.

-1 Do not update stiffness.

1 Update stiffness.

2 Update stiffness, the solution is diverging and MAXBIS has been


reached.

POUTF Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate


output is not requested.

NSKIP Input/output-integer-no default.


On input: Subcase record number to read in CASECC.
On output: Set to -2 if run is to be fatally terminated.

LGDISP Input-integer-no default. Large displacement and follower force flag.

-1 No large displacement and follower force effects are considered.

1 Large displacement and follower force effects are considered.

2 Only large displacement effects are considered.

DMAP Programmer's Guide 11-7


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

NLFLAG Output-integer-default=0

ITERID Input/output-integer-no default. Nonlinear analysis iteration count.

KMATUP Input/output-integer-default=1. Stiffness matrix update count within the


increment.

LSTEP Input/output-integer-default=0. Load step. The current iteration step at the


subcase level for static solutions.

KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive, KTIME


is the time remaining at the start of the stiffness update. If negative, no
stiffness update was done since the last exit from NLITER. KTIME still holds
the negative of the stiffness update time from the last stiffness update.

SOLCUR Input/output-integer-default=0. Nonlinear loop identification number.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.

KFLAG Input/output-integer-default=1. Stiffness update flag. Set to -1 to update


stiffness before starting bisection. It reflects the NEWK and CONV status at
the last converged solution or stiffness update. See Remark 6.

NBIS Input/output-integer-default=0. Current bisection counter.

NORADMAT Input-integer-default=0. Radiation flag.

-2 No radiation

-1 Initial radiation

1 Single band radiation with constant emissivity

2 Radiation with temperature dependent emissivity

3 Multiple band radiation with constant emissivity

LASTCNMU Input/output-real-default=0.0. Last converged value of the arc-length load


factor.

SIGMA Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute


radiant heat flux.

ARCLG Input/output-real-default=1.0. The arc length at the last converged step.

ARCSGN 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.

TWODIV Input/output-integer-default=0. Nonlinear analysis divergence flag.

0 No previous divergence on this load step

11-8 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

1 One previous divergence on this load step

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Gimbal angle

2 Rotation vector

ITOPT Input-integer-default=0. Preconditioner method for iterative solver. See the


“SOLVIT” module description.

ITSEPS Input/output-integer-default=0. Power of ten for convergence parameter


epsilon for iterative solution method. On output, set to 0 for convergence
and 1 for no convergence.

ITSMAX Input-integer-default=0. Maximum number of iterations for iterative solution


method.

PLSIZE Input/output-integer-default=0. Size of the load matrix. Compared to the size


of load matrix in the previous subcase in order to detect boundary condition
changes in the current subcase. Boundary condition changes are not allowed
in the arc-length method.

IPAD Input-integer-default=0. Padding level for reduced incomplete Cholesky


factorization. See the “SOLVIT” module description.

IEXT Input-integer-default=0. Extraction level for reduced incomplete Coolest


factorization. See the “SOLVIT” module description.

ADPCON Input-real-default=0.0. Contact penalty value. Scale factor for adjusting


penalty values on restart. Update penalty values if positive.

PBCONT Input-integer-default=0. Slideline contact flag.

NBCONT Output-integer-default=0. Number of bisections due to slideline contact.

GPFORCE Input-integer-default=-1. The number of columns in FENL. If GPFORCE 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.

DMAP Programmer's Guide 11-9


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

1 Solution had converged and a stiffness update had been made. No new stiffness matrix
is required before starting bisection.

11.6 NLTRD
Computes transient nonlinear analysis solution matrices and tables
Computes transient nonlinear analysis solution matrices and tables. Applicable to dynamic structural
analysis only.

Format:

NLTRD CASECC,MESTNL,PDT,YS,KRDD,
ELDATA,KELMNL,LAM1DD,GM,MPT,
DIT,UAM1DD,DLT1,CSTM,BGPDT,
SIL,USETD,AM2,AM3,NLFT,
KSGG,DITID/
ULNT,IFG,ESTNLH,IFD,OESNL1,
PNL,TEL/
BETA/S,N,CONV/S,N,STIME/S,N,NEWP/S,N,NEWK/
S,N,OLDDT/S,N,NSTEP/LGDISP/S,N,CONSEC/S,N,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 Table of Case Control command images

MESTNL Nonlinear element summary table at current step

PDT Dynamic load vectors for transient analysis in the d-set

YS Matrix of enforced displacements or temperatures

KRDD Combined linear and material nonlinear stiffness matrix in the d-set

ELDATA Table of combined nonlinear information data

KELMNL Table of element matrices for stiffness for nonlinear elements

LAM1DD Lower triangular factor of the dynamic tangential matrix in the d-set

GM Multipoint constraint transformation matrix, m-set by n-set

11-10 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

UAM1DD Upper triangular factor of the dynamic tangential matrix in the d-set

DLT1 Table of dynamic loads updated for nonlinear analysis

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

SIL Scalar index list

USETD Degree-of-freedom set membership table for the p-set

AM2 Damping matrix in the d-set for linear elements multiplied by the negative of the
time step delta

AM3 Combined mass and damping matrix multiplied the square of the reciprocal of the
time step delta and the reciprocal of twice the time step delta, respectively

NLFT Nonlinear Forcing function table

KSGG S-set by f-set matrix and s-set by s-set partitions of the material nonlinear stiffness
matrix and expanded to g-set size

DITID Table of identification numbers in DIT

Output Data Blocks:

ULNT Solution matrix from nonlinear transient response analysis in the d-set

IFG Matrix of nonlinear element forces for the g-set at the output time steps

ESTNLH Nonlinear element summary table at converged step

IFD Matrix of nonlinear element forces at constrained points at the output time steps

OESNL1 Table of nonlinear element stresses in SORT1 format

PNL Nonlinear load matrix appended from each output time step

TEL Transient response time output list appended from each subcase

Parameters:

BETA Input-complex-default=(.33333,0.0). Integration parameter.

CONV Input/output-integer-default=1. Nonlinear analysis convergence flag.

On input:

DMAP Programmer's Guide 11-11


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

0 Initialization

On output:

-1 Convergence has not been achieved.

1 Convergence has been achieved.

STIME Input/output-real-default=0.0. On initial input, starting time step and on output,


accumulated time used for restarts.

NEWP Output-integer-default=1. New subcase flag.

-1 Current subcase has not been completed.

1 Current subcase has been completed.

NEWK Input/output-integer-default=1. Stiffness update flag.

-1 Do not update stiffness.

>0 Update stiffness. Represents the number of consecutive time steps which
have shown divergence. If this number reaches 5, the solution process is
terminated.

OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration


or time step to be used after the matrix update or subcase switch.

NSTEP Input/output-integer-default=0. Current time step position for subcase, set to 0 at


the beginning of the subcase.

LGDISP Input-integer-no default. Large displacement and follower force flag.

-1 No large displacement and follower force effects aree considered.

1 Large displacement and follower force effects are considered.

2 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.

ITERID Input/output-integer-no default. Nonlinear analysis iteration count.

MU Input/output-real-default=0.0. The magnitude of the last g-set displacement matrix.

KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive, 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.

11-12 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update.
Set to 0 if the stiffness update is performed due to the CGAP element during
the iteration.

NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1 to


terminate.

NOTIME Output-integer-default=0. Time out flag. Set to 1 if there is no time left for further
iterations but enough time to perform data recovery.

MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration


and the material subincrement processes.

UNUSED17 Input-integer-default=0. Unused.

UNUSED18 Input-integer-default=0. Unused.

UNUSED19 Input-integer-default=0. Unused.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Gimbal angle

2 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.

11.7 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.

DMAP Programmer's Guide 11-13


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Table of Case Control command images

PDT Dynamic load vectors for transient analysis in the d-set

YS Matrix of enforced displacements or temperatures

ELDATA Table of combined nonlinear information data

KELMNL Table of element matrices for stiffness for nonlinear elements

KDD Stiffness matrix for the d-set, linear elements only

GM Multipoint constraint transformation matrix, m-set by n-set

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

KBDD Tangential stiffness in d-set

DLT1 Table of dynamic loads updated for nonlinear analysis

CSTM Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

SIL Scalar index list

USETD Degree-of-freedom set membership table for the p-set

BRDD Damping matrix in the d-set for linear elements only or heat capacitance matrix for
both linear and nonlinear elements in the d-set

MDD Mass (or radiation) matrix for the d-set

NLFT Nonlinear Forcing function table

11-14 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

RDEST Radiation element summary table

RECM Radiation exchange coefficient matrix

BDD Damping (or heat capacitance) matrix for the d-set for linear elements only

GPSNT Grid point shell normal table

DITID Table of identification numbers in DIT

DEQIND Index table to DEQATN data block

DEQATN Table of DEQATN Bulk Data entry images

Output Data Blocks:

ULNT Solution matrix from nonlinear transient response analysis in the d-set

IFS Matrix of nonlinear element forces at constrained points at the output time steps

ESTNLH Nonlinear element summary table at converged step

IFD Matrix of nonlinear element forces at constrained points at the output time steps

OESNL1 Table of nonlinear element stresses in SORT1 format

PNL Nonlinear load matrix appended from each output time step

TEL Transient response time output list appended from each subcase

MULNT Solution matrix from nonlinear transient response analysis in the d-set from the
previous subcase

MESTNL Nonlinear element summary table at current step

BTOPOCNV Updated contact regions input information table

BTOPOSTF Updated contact regions topological information table

OESNLB1 Table of slideline contact element stresses in SORT1 format

Parameters:

KRATIO Input/output-complex-default=(1.,0.). Stiffness ratio to be used for time step


adjustment.

CONV Input/output-integer-default=1. Nonlinear analysis convergence flag.

On input:

0 Initialization

DMAP Programmer's Guide 11-15


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

On output:

-1 Convergence has not been achieved.

1 Convergence has been achieved.

STIME Input/output-real-default=0.0. On initial input, starting time step and on output,


accumulated time used for restarts.

NEWP Output-integer-default=1. New subcase flag.

-1 Current subcase has not been completed.

1 Current subcase has been completed.

NEWK Input/output-integer-default=1. Stiffness update flag.

-1 Do not update stiffness.

>0 Update stiffness. Represents the number of consecutive time steps which
have shown divergence. If this number reaches 5, the solution process is
terminated.

OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration


or time step to be used after the matrix update or subcase switch.

NSTEP Input/output-integer-default=0. Current time step position for subcase, set to 0


at the beginning of the subcase.

LGDISP Input-integer-no default. Large displacement and follower force flag.

-1 No large displacement and follower force effects are considered.

1 Large displacement and follower force effects are considered.

2 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.

ITERID Input/output-integer-no default. Nonlinear analysis iteration count.

ITIME Input-real-default=0.0. Initial time step at the beginning of a subcase.

KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive, 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.

11-16 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

LASTUPD Input/output-integer-default=0. The time step number of the last stiffness


update. Set to 0 if the stiffness update is performed due to the CGAP element
during the iteration.

NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1


to terminate.

NBIS Input/output-integer-default=0. Current bisection counter.

MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration


and the material subincrement processes.

TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and


damping forces.

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Gimbal angle

2 Rotation vector

NDAMP Input-real-default=0.0. Numerical damping.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit.

SIGMA Input-real-default=1.0. The Stefan-Boltzmann constant. Used to compute


radiant heat flux.

NORADMAT Input-integer-default=0. Radiation flag.

-2 No radiation

-1 Initial radiation

1 Single band radiation with constant emissivity

2 Radiation with temperature dependent emissivity

3 Multiple band radiation with constant emissivity

ADPCON Input-real-default=0.0. Contact penalty value. Scale factor for adjusting penalty
values on restart. Update penalty values if positive.

PBCONT Input-integer-default=0. Slideline contact flag.

NBCONT 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

DMAP Programmer's Guide 11-17


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

11.8 NLTRD3
Computes nonlinear analysis solution matrices and tables for SOL 401. Applicable to quasi-static
structural and thermal analysis.

Format:

NLTRD3 CASESX2H,PDT,YS,ELDATAH,KELMNL,KDDL,GMNL,MPTS,DITS,KBDD,
DLT1,CSTMS,BGPDT,SILS,USETD,BRDD,MJJ,NLFT,UNUSED,UNUSED,BDDL,GPSNTS,
DITID,DEQIND,DEQATN,ELGNST,GLUESEQ,COMPEST,KDICTUP,EPT,ECTS,EDT,RGNL,
UNUSED,SLT,KELMUP,GEOM3,GEOM5,ETT,FBSIN,CNELM,ECSTAT,ELAMDA,UNUSED,PLAMDA,
EST,GPECT,UNUSED,UGCPREV,YS1I,ECDISPG,DLT,KDICTNL,CONFAC2,GEOM1,GEOM2/
ULNTH,IFSH,ESTNLH,IFDH,OES1,PNLH,TELH,MULNT,MESTNL,UNUSED,UNUSED,UNUSED,
OSTR1,OSTR1EL,OSTR1TH,OSTR1PL,OSTR1CR,OES1G,OSTR1G,OSTR1ELG,OSTR1THG,
OSTR1PLG,OSTR1CRG,OTEMP1,OES1C,OSTR1C,OSTR1ELC,OSTR1THC,OQGGF1,OBG1,PLPG,
FENLR,PLFG,UGLAST,FBSOUT,TLAMUP,ADGPECT,ADEST,ADSTRES,OERRES,OERREP,
OERRSS,OERRSP,CNELMUP,OJINT,ECSTATUP,ELAMUP,YS2F,UDLAST,ESTNLINI,CSDATA,
PBDATA,OJINE,CNTPENTR/
KRATIO/S,N,CONV/S,N,RSTIME/S,N,NEWP/S,N,NEWDT/S,N,OLDDT/S,N,NSTEP/LGDISP/
S,N,UNUSED/S,N,ITERID/ITIME/S,N,KTIME/S,N,LASTUPD/S,N,NOGONL/S,N,NBIS/
MAXLP/TSTATIC/LANGLE/NDAMP/TABS/UNUSED/MATNL/S,N,UNUSED/UNUSED/UNUSED/GLUE/
GPFORCE/BCSET/S,N,CITO/S,N,CITI/MAXI/S,N,CNVO/S,N,CNVI/S,N,CONFLAG/MINILP/
S,N,BISFLAG/S,N,DTLAST/S,N,CPLFLG/S,N,PBCONV/S,N,CNTUPDT/NCELS/S,N,CRPFLAG/
S,N,COUNT $

Input Data Blocks:

CASESX2H Table of case control command images for current subcase

PDT Time-dependent load vectors for quasi-static analysis in the d-set

YS Matrix of time unassigned (fixed) enforced displacements

ELDATAH Table of combined nonlinear information data

KELMNL Table of element matrices for stiffness for nonlinear elements

KDDL Stiffness matrix for the d-set, linear elements only

GMNL Multipoint constraint transformation matrix for multipoint constraint reduction

MPTS Table of bulk data entry images related to material properties

11-18 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

DITS Table of TABLEij bulk data entry images

KBDD Tangential stiffness in d-set

DLT1 Table of dynamic loads updated for nonlinear analysis

CSTMS Table of coordinate system transformation matrices

BGPDT Basic grid point definition table

SILS Scalar index list

USETD Degree-of-freedom set membership table for the p-set

BRDD Damping matrix in the d-set for linear elements only

MJJ Mass matrix for the d-set

NLFT Nonlinear forcing function table

UNUSED Unused

UNUSED Unused

BDDL Damping matrix for the d-set for linear elements only

GPSNTS Grid point shell normal table

DITID Table of identification numbers in DIT

DEQIND Index table to DEQATN data block

DEQATN Table of DEQATN bulk data entry images

ELGNST Table of glue element stiffness

GLUESEQ Data table for glue elements

COMPEST Summary table for composite solid elements

KDICTUP Same as KDICTNL, KELMNL dictionary table, output by EMG

For Problems involving Contact:


KDICTNL – KELMNL dictionary table, output by EMG
KDICTC – Table of contact element matrices, output by EMC
KDICTUP – Is a combination of KDICTNL and KDICTC

EPT Element property table

ECTS Element connectivity table, output by GP2

EDT Element data table for iterative solver

DMAP Programmer's Guide 11-19


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

RGNL Matrix for multipoint constraint equations

UNUSED Unused

SLT Static load table

KELMUP Updated KELMNL.


(For problems involving contact, includes KELMC: Contact element matrix
dictionary table, output by EMC)

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GEOM5 Table of Bulk Data entry images related to thermal loads from external files

ETT Element temperature table

FBSIN Stiffness matrix decomposition for reuse

CNELM Contact element definition table

ECSTAT Contact element status table

ELAMDA Previous augment contact tractions

UNUSED Unused

PLAMDA Contact tractions from previous time step

EST Element summary table

GPECT Grid point element connections table

UNUSED Unused

UGCPREV Last converged GSET displacement

YS1I Matrix of time assigned enforced displacements

ECDISPG Contact element displacements

DLT Table of dynamic loads

KDICTNL KELMNL dictionary table, output by EMG

CONFAC2 Table of condensation factors used for bubble functions

GEOM1 Table of bulk data entry images related to geometry

GEOM2 Table of bulk data entry images related to element connectivity and scalar points

Output Data Blocks:

ULNTH Solution matrix from nonlinear quasi-static analysis in the d-set

11-20 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

IFSH Matrix of nonlinear element forces at constrained points at the output time steps

ESTNLH Nonlinear element summary table at converged step

IFDH Matrix of nonlinear element forces in the d-set at the output time steps

OES1 Table of nonlinear element stresses in SORT1 format

PNLH Nonlinear load matrix appended from each output time step

TELH Time output list

MULNT Solution matrix from nonlinear quasi-static analysis in the d-set from the previous
subcase. Not supported in NX Nastran 10.

MESTNL Nonlinear element summary table at current step

UNUSED Unused

UNUSED Unused

UNUSED Unused

OSTR1 Table of total strain in SORT1 format

OSTR1EL Table of elastic strain in SORT1 format

OSTR1TH Table of thermal strain in SORT1 format

OSTR1PL Table of plastic strain in SORT1 format

OSTR1CR Table of creep strain in SORT1 format

OES1G Table of stress at Gauss points in SORT1 format

OSTR1G Table of total strain at Gauss points in SORT1 format

OSTR1ELG Table of elastic strain at Gauss points in SORT1 format

OSTR1THG Table of thermal strain at Gauss points in SORT1 format

OSTR1PLG Table of plastic strain at Gauss points in SORT1 format

OSTR1CRG Table of creep strain at Gauss points in SORT1 format

OTEMP1 Table of grid point temperatures

OES1C Table of ply stress in SORT1 format

OSTR1C Table of ply strain in SORT1 format

OSTR1ELC Table of ply strains-elastic in SORT1 format

OSTR1THC Table of ply strains-thermal in SORT1 format

DMAP Programmer's Guide 11-21


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

OQGGF1 Table of glue forces

OBG1 Table of glue tractions

PLPG Matrix of load vectors (P external + P follower force)

FENLR Element energy and forces in nonlinear matrix format

PLFG Matrix of internal force vectors

UGLAST Matrix of vectors needed for automatic stiffness update method

FBSOUT Stiffness matrix decomposition. If reuse is intended, it is copied into FBSIN

TLAMUP Updated total contact tractions

ADGPECT Grid point element connection table used for mesh adaptive

ADEST Element and grid table used for mesh adaptive

ADSTRES Table for average stress for each element for mesh adaptive

OERRES Table for error estimator for strain energy, step results (used for mesh adaptive)

OERREP Table for error estimator for strain energy, profile results (used for mesh adaptive)

OERRSS Table for error estimator for stress, step results (used for mesh adaptive)

OERRSP Table for error estimator for stress, profile results (used for mesh adaptive)

CNELMUP Updated contact table

OJINT Table for J integral output

ECSTATUP Updated contact element status

ELAMUP Updated augmented contact tractions

YS2F Matrix of time assigned enforced displacement in the solution format

UDLAST Matrix containing D-set displacement, velocity and acceleration at the subcase end

ESTNLINI Initial stress/strain datablock

CSDATA Bolt preload cross-section data

PBDATA Bolt preload load data

OJINE Table for intermediate data used for J-integral calculations

CNTPENTR Contact element penetrations

11-22 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

KRATIO Input/output-complex-default=(1.0,0.0). Stiffness ratio used for time step


adjustment. Not implemented on NX Nastran 9.

CONV Input/output-integer-no default. Nonlinear analysis convergence flag

On input:

0 Initialization

On output:

-1 Convergence has not been achieved

1 Convergence has been achieved

RSTIME Input/output-real-default=0.0. Time corresponding to the current entry into


NLTRD3

NEWP Output-integer-default=1. New subcase flag

-1 Current subcase has not been completed

1 Current subcase has been completed

NEWDT Input/output-integer-default=1. Stiffness update flag

-1 Do not update stiffness

>0 Update stiffness

OLDDT Input/output-real-default=0.0. Time step increment used in the previous iteration


or time step to be used after the matrix update or subcase switch

NSTEP Input/output-integer-default=0. Current time step position for subcase, set to 0 at


the beginning of the subcase

LGDISP Input-integer-no default. Large displacement flag

-1 No large displacement effects are considered

1 Large displacement effects are considered

UNUSED Unused

ITERID Input/output-integer-no default. Nonlinear analysis iteration count

ITIME Input-real-default=0.0. Initial time step at the beginning of a subcase

KTIME Input/output-real-no default. CPU time remaining. If KTIME is positive, KTIME is


the time remaining at the start of the stiffness update. If negative, no stiffness
update was done since the last exit from NLTRD3. KTIME still holds the negative
of the stiffness update time from the last stiffness update

DMAP Programmer's Guide 11-23


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

LASTUPD Input/output-integer-default=0. The time step number of the last stiffness update

NOGONL Output-integer-default=0. Nonlinear "no-go" flag. Set to +1 to continue or -1


to terminate

NBIS Input/output-integer-default=0. Current bisection counter

MAXLP Input-integer-default=0. Maximum limit allowed for element relaxation iteration


and the material subincrement processes. Set to 10 in NX Nastran 9 because
only TSTATIC = 1 (quasi-static analysis) is supported.

TSTATIC Input-integer-default=-1. Static analysis flag. Set to 1 to ignore inertia and


damping forces. In NX Nastran 9, only TSTATIC = 1 is supported.

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Gimbal angle

2 Rotation vector

NDAMP Input-real-default=0.0. Numerical damping. Set to 0.01 for SOL 401 in NX


Nastran 9.

TABS Input-real-default=0.0. Absolute temperature conversion constant. For example,


set to 273.16 when specifying temperatures in Celsius or 459.69 in Fahrenheit

UNUSED Unused

MATNL Input-Integer-default =0. Material nonlinear flag

0 No material nonlinear effects

1 Material nonlinear effects present

UNUSED Unused

UNUSED Unused

UNUSED Unused

GLUE Input-logical-no default. Set to “TRUE” if glue is defined

GPFORCE Input-integer-default=-1. Represents number of columns in FENLR


If GPFORCE≤0, no GPFORCE or ESE is requested

BCSET Input-Integer-no default. Contact set from bulk data

CITO Input/Output-Integer-default=0.Contact augmentation number

CITI Input/Output-Integer-default=0. Number of contact inner iterations

MAXI Input-Integer-no default. Maximum number of contact inner iteration before


updating stiffness

11-24 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

CNVO Input/Output-Integer-default=0. Convergence flag for contact

CNVI Input/Output-Integer-default=0. Convergence flag for contact inner iterations

CONFLAG Input-Integer-default=0. Contact output request

0 No contact output for the current time step.

1 Produce contact output for the current time step.

MINILP Input-Integer-no default. Number of contact inner iterations before updating


stiffness

BISFLAG Input/Output-Integer-default=0

0 Bisection not initiated for a contact solution

1 Bisection initiated for a contact solution

DTLAST Output–real–no default. Last converged time step size for a subcase

CPLFLG Input-Integer-default=1

1 Flag for sequential coupling solution in multiphysics 401 analysis

2 Flag for iterative coupling solution in multiphysics 401 analysis

PBCONV Output-Integer–default=0. Bolt convergence flag

0 Either Bolt not present or bolt preload update is not needed

1 Bolt has converged

2 Bolt hasn’t converged and bolt preload needs to be updated

CNTUPDT Output-Integer–default=0. Geometry update flag for contact

0 No geometry update needed

1 Geometry update needed

NCELS Input-Integer-no default. Number of contact elements formed

CRPFLAG Input/Output-integer-default=0

0 Creep solution not requested

1 Creep solution requested

COUNT Input/Output-integer-default=0. Counter for number of bolt iterations

DMAP Programmer's Guide 11-25


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.9 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 $

Input Data Block:

A Any matrix (real or complex)

Output Data Block:

ANORM Normalized matrix

Parameters:

NCOL Number of columns in A

NROW Integer-output-default=0. Number of rows in A.

XNORM Real-output-default=0.0. Maximum absolute normalizing value over all columns.

IOPT Integer-input-default=1. Normalization option.

1 Normalize by largest element

2 Compute SRSS

XNORMD Real double precision-output-default=0.D0. Same as XNORM except in double


precision.

PRTSWM Logical-input-default=TRUE. If PRTSUM=FALSE, System Warning Message


6991 is suppressed. This message is printed when the maximum term exceeds
the single precision limit for the machine type. When it is TRUE, the message is
printed.

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.

11-26 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Examples:

1. Normalize PHIG so that the maximum deflection is 1.0 (or -1.0).


NORM PHIG/PHIG1 $

2. Compute complex eigenvectors that have been normalized such that the product[CPHG]T
[CPHG] produces a square matrix with off-diagonal terms of computational zero, and complex
diagonal terms whose magnitude is unity.
TRNSP CPHG/CPHGT $
NORM CPHGT/CX2////2 $
MATMOD CX2,,,,,/INORM22,/28 $ DIAGONALIZE
DIAGONAL INORM22/NORM22/‘WHOLE‘/-1.0 $ INVERT
MPYAD CPHG,NORM22,/CPHGNORM $ NORMALIZE
MPYAD CPHGNORM,CPHGNORM,/N22/1 $ SHOULD BE IDENTITY IN MAGNITUDE
DIAGONAL N22/N22MAG/‘WHOLE‘/1.0 $ FIND MAGNITUDES

11.10 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:

UNITS,CASES,BGPDTS,GEOM2,GEOM4,USET,LAMA,PHIG,
NXNADAMS MGGDIAG,PCDB,OGPWG,OGSR1,OGSTRR1,CSTMS,EMVD//
SEID/FLXONL/FLXERR/WTMASS/GRDPNT $

Input Data Blocks:

UNITS UNITS data block from the DTI,UNITS bulk data entry

CASES Case Control table associated with superelement

BGPDTS Basic Grid Point Definition Table associated with superelement

GEOM2 Table of Bulk Data entries related to element connectivity

GEOM4 Table of Bulk Data entries related to constraints

USET Table of degree-of-freedom sets

LAMA Eigenvalue summary table for superelement

PHIG Matrix of eigenvectors (g-set size) corresponding to LAMA

MGGDIAG Column vector of diagonal values from superelement mass matrix (g-set size)

PCDB Plot Control Data Block from OUTPUT(PLOT) case control

OGPWG Output table of Grid Point Weight Generator of superelement

DMAP Programmer's Guide 11-27


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

OGSR1 Output table of grid point stresses of superelement

OGSTRR1 Output table of grid point strains of superelement

CSTMS Coordinate System Transformation Matrices for superelement

EMVD Equivalent modal viscous damping matrix.

Parameters:

SEID Input-integer-default=0. Superelement ID number (0 for residual-only analysis).

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 Input-real-default=1.0. Value of WTMASS parameter from


PARAM,WTMASS,value.

GRDPNT 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.

11.11 NXNMATLB
Creates an MATLAB .m script file for a superelement.
Creates an MATLAB .m script file for a superelement. The output is based on the MBDEXPORT case
control command with the MATLAB describer specified.

Format:

For the STANDARD case control option:

NXNMATLB CASES,LAMA,PHIG,EMVD,U8DOF,MFORC,//
SEID/WTMASS/FLXERR $

11-28 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

For the STATESPACE case control option:

NXNMATLB CASES,AMAT,BMAT,CMAT,EMAT,U7DOF,U8DOF//
SEID/WTMASS/FLXERR $

Input Data Blocks:

CASES Case control table associated with superelement.

LAMA Eigenvalue summary table for superelement.

PHIG Mode shape matrix (U8-set) for superelement.

EMVD Equivalent modal viscous damping matrix for superelement.

AMAT State-space [A] matrix for superelement.

BMAT State-space [B] matrix for superelement.

CMAT State-space [C] matrix for superelement.

EMAT State-space [E] matrix for superelement.

U7DOF U7-set DOF vector (input DOF) for superelement.

U8DOF U8-set DOF vector (output DOF) for superelement.

MFORC Modal force vector for superelement.

Parameters:

SEID Input-integer-no default. Superelement ID number.

WTMASS Input-real-no default. Value of WTMASS parameter from PARAM,WTMASS,value.

FLXERR Output-integer-no default. Error flag. Options are:

0: No error

1: Error

Remarks:

This module will generate a MATLAB .m script file.

11.12 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.

DMAP Programmer's Guide 11-29


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

UNITS,CASES,BGPDTS,GEOM2,GEOM4,USET,LAMA,PHIG,
NXNRFI MGGDIAG,PCDB,OGPWG,OGSR1,OGSTRR1,CSTMS//
SEID/FLXONL/FLXERR/WTMASS/GRDPNT $

Input Data Blocks:

UNITS UNITS data block from the DTI,UNITS bulk data entry

CASES Case Control table associated with superelement

BGPDTS Basic Grid Point Definition Table associated with superelement

GEOM2 Table of Bulk Data entries related to element connectivity

GEOM4 Table of Bulk Data entries related to constraints

USET Table of degree-of-freedom sets

LAMA Eigenvalue summary table for superelement

PHIG Matrix of eigenvectors (g-set size) corresponding to LAMA

MGGDIAG Column vector of diagonal values from superelement mass matrix (g-set size)

PCDB Plot Control Data Block from OUTPUT(PLOT) case control

OGPWG Output table of Grid Point Weight Generator of superelement

OGSR1 Output table of grid point stresses of superelement

OGSTRR1 Output table of grid point strains of superelement

CSTMS Coordinate System Transformation Matrices for superelement

Parameters:

SEID Input-integer-default=0. Superelement ID number (0 for residual-only analysis).

FLXONL 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.

11-30 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

WTMASS Input-real-default=1.0. Value of WTMASS parameter from


PARAM,WTMASS,value.

GRDPNT 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.

11.13 NXNSMPK
Creates a SIMPACK Flexible Body Input (FBI) file for a superelement.

Format:

NXNSMPK UNITS,CASES,BGPDTS,GEOM2S,GEOM4S,USET,KAA,MAA,MGGDIAG,PCDB,OGPWG,CSTMS,GAOSM//
SEID/S,N,FLXONL/S,N,FLXERR/WTMASS/GRDPNT/NOQS $

Input Data Blocks:

UNITS UNITS data block from the DTI,UNITS bulk data entry

CASES Case Control table associated with superelement

BGPDTS Basic Grid Point Definition table associated with superelement

GEOM2S Table of Bulk Data entries related to element connectivity

GEOM4S Table of Bulk Data entries related to constraints

USET Table of degree-of-freedom sets

KAA Superelement stiffness matrix reduced to the a-set

MAA Superelement mass matrix reduced to the a-set

MGGDIAG Column vector of diagonal values from superelement mass matrix (g-set size)

PCDB Plot Control Data Block from OUTPUT(PLOT) case control

OGPWG Output table of Grid Point Weight Generator of superelement

CSTMS Coordinate system transformation matrices for superelement

GAOSM Constraint matrix relating the a-set to the (o+s+m)-set for superelement

DMAP Programmer's Guide 11-31


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Parameters:

SEID Input-integer-no default. Superelement identification number.

FLXONL Output-integer-no default. Value of FLEXONLY keyword from MBDEXPORT


case control command. Options are:
0: Continue with solution
1: Do not perform solution

FLXERR Output-integer-no default. Error flag. Options are:


0: No error
1: Error

WTMASS Input-real-default=1.0. Value of WTMASS parameter from


PARAM,WTMASS,value.

GRDPNT Input-integer-default=-1. Value of GRDPNT parameter from


PARAM,GRDPNT,value.

NOQS Input-integer-no default. Number of valid (used) q-set DOFs.

Remarks:
1. This module generates a SIMPACK FBI file. The FBI file is named ‘jid_SEID.fbi’ where ‘jid’ is the
name of the input file for the job and SEID is the superelement identification number. The FBI file
is written to the same location as the ‘jid.f06’ file.

11.14 OFP
Output file processor
Outputs (print or punch) data blocks prepared by other modules in user-oriented, self-explanatory
formats.

Format:

OFP OFP1,OFP2,OFP3,OFP4,OFP5,OFP6,
CSTM,EHT,BGPDTVU,ERROR1,DEQATN,DEQIND,DIT//
S,N,CARDNO/ODCODE/PVALID/ABSEM $

Input Data Blocks:

OFPi Output table suitable for processing by the OFP module. See Remark 2.

CSTM Table of coordinate system transformation matrices

EHT Element hierarchical table for p-element analysis

BGPDTVU Basic grid point definition table for a superelement and related to geometry with
view-grids added

11-32 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

ERROR1 Error-estimate table updated for current superelement or adaptivity loop

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

DIT Table of TABLEDi Bulk Data entry images

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.

ODCODE Input-integer-default=-1. Output device code override. See Remark 4. ODCODE


overrides the code stored in the DBi‘s according to the following table:

ODCODE Output directed to:

1 Print

2 Plot

3 Print and Plot

4 Punch

5 Print and Punch

6 Plot and Punch

7 Print, Plot, and Punch

PVALID Input-integer-default=0. P-element adaptivity loop identification number.

ABSEM Input-integer-default=1. Enforced motion code for header labeling (0=constraint


modes method; 1=absolute displacement method).

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.

DMAP Programmer's Guide 11-33


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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/ $

11.15 OPRESSDB
Uses linear interpolation to compute the pressure loads at certain time points.

Format:

OPRESSDB CASECC,GEOM3PLD0,GEOM3PLD,TELH/
OPRESS/
STIME/ETIME/LVAR $

Input Data Blocks:

CASECC Table of case control command images

GEOM3PLD0 Table of bulk data entry images related to pressure loads such as PLOAD4,
PLOADE1, AND PLOADX1 at the start time

GEOM3PLD Table of bulk data entry images related to pressure loads such as PLOAD4,
PLOADE1, AND PLOADX1 at the end time

TELH Time output list

Output Data Blocks:

OPRESS Table that contains pressure loads at certain time points

Parameters:

STIME Input-real-no default. Start time

ETIME Input-real-no default. End time

11-34 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

LVAR Input-integer-default = 0. Selects pressure computation


If LVAR = 0, use the pressure at the ending time point as the pressure for all time
points.
If LVAR = 1, use the pressure at the starting and ending time points to linearly
interpolate the pressure at all other time points.

11.16 OPTGP0
p-element analysis preprocessor
Preprocesses the input design optimization shape basis vectors for p-element analysis.

Format:

OPTGP0 GEOM1M,GEOM2M,MEDGE,EDOM,UNUSED5,UNUSED6,UNUSED7,
DEQATN,DEQIND/
EDOMM/
DELG $

Input Data Blocks:

GEOM1M Table of Bulk Data entry images related to geometry and updated for the current
p-level

GEOM2M Table of Bulk Data entry images related to element connectivity and scalar points
and updated for the current p-level

MEDGE Edge table for p-element analysis

EDOM Table of Bulk Data entries related to design sensitivity and optimization

unused5 Unused and can be purged

unused6 Unused and can be purged

unused7 Unused and can be purged

DEQATN Table of DEQATN Bulk Data entry images

DEQIND 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.

DMAP Programmer's Guide 11-35


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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).

11.17 ORTHOG
Generates orthonormal set of vectors
Generates an orthonormal set of vectors from a given set of vectors. For example, orthogonalize
with respect to an identity matrix or mass matrix.

Format:

ORTHOG A,M/
Q,R/
ORTHOPT/ORTHCON/S,N,ORTHEPS/ORTHREPT/ORTHTOL $

Input Data Blocks:

A Rectangular matrix of m columns (vectors) by n rows to be orthogonalized


where m≤n

M Weighting matrix: symmetric and positive definite

Output Data Blocks:

Q Rectangular matrix of orthogonalized vectors

R Rectangular matrix whose m by m upper triangle contains an intermediate


factor of the process

Parameters:

ORTHOPT Input-integer-default=1. Orthogonalization method.

1 And M is purged, perform Householder Orthogonalization.

2 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.

ORTHCON Input-integer-default=1. Matrix Modified Gram-Schmidt termination flag or


Householder partitioning vector generation flag.

For Householder:

0 R contains the upper triangular matrix.

1 R contains the partitioning vector.

11-36 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

For Matrix Modified Gram-Schmidt termination:

0 Exit the program if M is not at least a positive semi-definite matrix. R is


not used and can be purged.

1 Let Rii = -Rii and continue, if M is not at least a positive semi-definite matrix.
R contains the partitioning vector

ORTHEPS Output-real-no default. Level of orthogonality. ORTHEPS is the largest lower


triangular term of the matrix R and is computed with the Householder method.

ORTHREPT Input-real-default=0.707. Matrix Modified Gram-Schmidt algorithm repeat flag.


The default is approximately the square root of 0.5.

ORTHTOL Input-real-default=0.0. Linear dependence tolerance. By default, ORTHTOL is


set to the square root of the minimum machine value.

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.

11.18 OUTPRT
Constructs sparse load reduction and sparse data recovery partitioning vectors.

Format:

OUTPRT CASECC,ECT,BGPDT,SIL,XYCDB,DYNAMIC,MATPOOL,PG,VGFD,
TABEVP,TABEVS,SETMC,TEXTSE/
PVGRID,PVSPC,PVMPC,PVLOAD,PVCODES,TEXTOU/
S,N,SDRMETH/NOSE/SDROVR/SDRDENS/MCSET/
MCFLAG/IRTYPE/MATTYP/APP $

Input Data Blocks:

CASECC Table of Case Control command images

ECT Element connectivity table

BGPDT Basic grid point definition table

SIL Scalar index list

XYCDB Table of x-y plotting commands

DMAP Programmer's Guide 11-37


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

DYNAMIC Table of Bulk Data entry images related to dynamics

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

PG Static load matrix applied to the g-set

VGFD Partitioning vector with ones at rows corresponding to degrees-of-freedom


connected to frequency-dependent elements

TABEVP Cross-reference table between ESTDVP records and element and design
variable identification numbers

TABEVS Cross reference table between ESTDVS records and element and design
variable identification numbers

SETMC Modal contribution set definitions

TEXTSE Directory table for external superelement

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:
• DISPLACEMENT

• VELOCITY

• ACCELERATION

• FORCE

• STRESS

• STRAIN

• SPCFORCE

• MPCFORCE

• MPRES

• GPFORCE

• ESE

• EKE

11-38 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

• EDE

• GPKE

• MODCON

• PANCON

PVSPC Partitioning vector with ones at rows corresponding to degrees-of-freedom


connected to elements or grids specified on the SPCFORCE Case Control
command

PVMPC Partitioning vector with ones at rows corresponding to degrees-of-freedom


connected to elements or grids specified on the MPCFORCE Case Control
command

PVLOAD Partitioning vector with ones at rows corresponding to degrees-of-freedom at


which static and dynamic loads are applied.

PVCODES Modal contributions output request codes corresponding to selections contained


in PVGRID (MCFLAG=0 or 1). For MCFLAG=2, this is a 3-column matrix
wherein column 1 is a list of output request codes, column 2 is a list of element
IDs, and column 3 is a list of element item codes.

TEXTOU Modified directory table for external superelement. Created only when TEXTSE
exists, MCFLAG=2, and IRTYPE=9, 10, or 11.

Parameters:

SDRMETH Output-integer-no default. Data recovery method flag:

-1 Sparse data recovery

0 Full (or standard) data recovery

1 No data recovery is requested or required.

NOSE Input-integer-default=0.

Set to -1 if there are no superelements; 0 otherwise. Superelement presence


flag.

SDROVR Input-character-default=‘AUTO’. Override for data recovery method flag, SDR:

AUTO Choose full or sparse data recovery based on SDRDENS.

FULL Choose full data recovery.

SPARSE Choose sparse data recovery.

DMAP Programmer's Guide 11-39


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

MCSET Input-integer-default=0. Modal contribution set to use.

-1 Use all sets in SETMC

0 Ignore SETMC

>0 Use set=MCSET in SETMC

MCFLAG Input-integer-default=0. Modal contribution set usage flag.

0 grids and elements

1 grids only

2 elements only

3 acoustic/fluid points only

IRTYPE Input-integer-default=0. Response type.

9 element stress

10 element strain

11 element force

MATTYP Input-integer-default=0. External superelement matrix type.

APP Input-character-default=‘ ’. Analysis type.

Remarks:

1. PVCODES is only created for MCFLAG=1 or 2.

2. If TEXTSE is present, external superelement processing is assumed. Therefore, all other input
data blocks will be ignored except SETMC, and MCFLAG must be either 1 or 2.

3. If TEXTSE is present, MCFLAG=2, and IRTYPE=9, 10, or 11, TEXTOU will be created. The
values of IRTYPE and MATTYP must be consistent with the type of data contained in the
TEXTSE data block.

11.19 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.

11-40 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

OUTPUT2 DB1,DB2,DB3,DB4,DB5//ITAPE/IUNIT/LABL/MAXR/
NDDLNAM1/NDDLNAM2/NDDLNAM3/NDDLNAM4/NDDLNAM5/HNAME1/
HNAME2/HNAME3/HNAME4/HNAME5 $

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.

Parameters:

ITAPE Input-integer-default=0. ITAPE is used to select the file positioning option as


follows:

+n Skip forward n data blocks before writing (used only if file has no label).

0 Data blocks are written starting at the current position. If this is the first
use, no label is written.

-1 Rewind IUNIT before writing, and label file.

-3 Rewind IUNIT, print data block names and write after the last data block
on IUNIT (file must have a label).

-9 Write a final EOF on IUNIT (must be used before -3 option and as last
I/O use of unit), then rewind IUNIT.

IUNIT Input-integer-no default. IUNIT is the FORTRAN unit number on which the
data blocks are to be written. Siemens PLM Software does not recommend
IUNIT=0. See Remark 7.

LABL Input-character-default = ‘XXXXXXXX’ LABL is used for file identification. The


label is written only if ITAPE=-1, and is checked only if ITAPE=-3.

MAXR Input-integer-default=2 * BUFFS IZE words. Maximum physical record size.


(See Remarks.)

NDDLNAMi Input-character-default=blank. NDDL names corresponding to DB1 through


DB5. If DBi is a matrix, the corresponding NDDLNAMi is ‘MATRIX’ (See
Remarks.)

HNAMEi Input-character-default=blank. Name of the data block as it needs to appear in


the output2 file.

Remarks:

1. A data block (table or matrix) consists of logical records:

DMAP Programmer's Guide 11-41


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

• 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 Description

>0 The length of the next physical record. It can also indicate the start of a new
logical record.

0 End-of-File (data block) (EOF) or End-of-Data (EOD)

<0 End-of-Logical record (EOR) or a null column. The absolute value indicates the
logical record number.

3. The End-of-Data (EOD) follows the last end-of-file (data block) written to the binary file.

4. If possible, each logical record of the data block 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. Siemens PLM Software 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:

11-42 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Represents the maximum physical record size (in words) on the target
machine(s) for the machine binary-formatted file. For neutral files, this
MAXR
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
NDDLNAMi NDDL-defined name. If this parameter is left blank, the corresponding
DMAP name (DB1 through DB5) is assumed to be the NDDL-defined name.

The following is a partial list of the table data block names available for OUTPUT2 neutral file
formatting. For a more complete list see the NDDL.

AXIC GEOM1 GPLS OEIGS OESNL2 OQG2

CASES GEOM1Q LAMA OEP OESNLX OSTR1

CLAMA GEOM2 MATPOOL OES1 OGPWG OSTR2

CSTMS GEOM2S MPT OES1C OGS1 OUGV1

DIT GEOM3 MPTS OES1X OPG1 OUGV2

DYNAMICS GEOM3S OEF1 OES1X1 OPG2 PSDF

EPT GEOM4 OEF1X OES2 OPNL1 PVT

EPTS GEOM4S OEF2 OESNL1 OQG1 USET

FOL GPDTS

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 Length Contents Description


record
number

1 1 KEY = 3

2 KEY Date (3 words, month-day-year) –


integer

DMAP Programmer's Guide 11-43


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Physical Length Contents Description


record
number

3 1 KEY = 7

4 KEY NASTRAN Header (7 words, One Logical


Character-A4) Record

5 1 KEY = 2

6 KEY LABEL (2 words, Character-A4 = LABL)

7 1 KEY = -1 (EOR)

8 1 KEY = 0 (EOF) End of Label

Note

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

Physical Length Contents Description


record
number

9 1 KEY = 2

10 KEY Data Block Name (2 words, Header: Logical.


Character-A4) Record1 of Data Block

11 1 KEY = -1 (EOR)

12 1 KEY = 7

13 KEY NASTRAN Trailer (7 words, integer) Trailer: Logical

14 1 KEY = -2 (EOR) Record 2 of Data Block

15 1 KEY = 1 (Start new logical record)

16 KEY Logical Record Type:0 : table1 :


matrix column (string records)2 :
factor matrix (string record)3 : factor
matrix (matrix record)

17 1 KEY Š 2. Logical Record

18 KEY Data Block Name (2 words, 3 of Data Block


Character-A4) and data (if any)

11-44 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Physical Length Contents Description


record
number

19 1 KEY=-3 (EOR).

• Format for Tables (Records 20 through n)

Physical Length Contents Description


record
number

20 1 KEY=1 (Start new logical record) Logical Record 4 of


Table
21 KEY Next Logical Record Type=0 for table
record

22 1 KEY > 0

23 KEY Data

24 1 KEY < 0 (EOR)**

25 1 KEY = 1 (Start new logical record) Logical Record 5 of


Table
26 KEY Next Logical Record Type = 0

27 1 KEY > 0

28 KEY Data

29 1 KEY < 0 (EOR)**

. . Repeat Physical Records 25-29 for Additional Records of


Additional Records in Table Table
. .
. .

n-7 1 KEY = 1 (Start new logical record) Last Logical Record


of Table
n-6 KEY Next Logical Record Type = 0

n-5 1 KEY > 0

n-4 KEY Data

n-3 1 KEY < 0 (EOR)**

n-2 1 KEY = 1 (Start new logical record) If Last “Next Logical


Record Type" = 0, this
n-1 KEY Next Logical Record Type = 0 is the end of the table.
n 1 KEY = 0 (EOF)

DMAP Programmer's Guide 11-45


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Note

*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 Length Contents Description


record
number

20 1 KEY=1 (Start new logical record)

21 KEY Next Logical Record Type Logical Record 4 of


Matrix=first column
1 : matrix column (string records)2 :
factor matrix 3 : factor matrix

22 1 KEY > 0 Number of non-zero terms in First Column First


next string in word unit String Record

23 KEY+1 First non-zero row, followed by


non-zero terms

24 1 KEY > 0 Number of non-zero terms in First Column Second


next string in word unit String Record

25 KEY+1 First non-zero row, followed by


non-zero terms.
Repeat String Records 22-23 for
Additional Strings in Column

n-2 1 KEY > 0 Number of non-zero terms in First Column Last


next string in word unit String Record

n-1 KEY+1 First non-zero row, followed by


non-zero terms.

n 1 KEY<0 (EOR) End of First Column

Repeat Column/String Records 20


through n for additional columns in
matrix if a column is null there is no
String Record for that column

n 1 KEY=1 (Start new logical record) Null Column

n+1 KEY Next Logical Record Type


(See Record 21 above)

11-46 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Physical Length Contents Description


record
number

n+2 1 KEY<0 (EOR) End of Null Column

m-5 1 KEY > 0 Number of non-zero terms in Last Column Last


next string in word unit String Record

m-4 KEY+1 First non-zero row, followed by


non-zero terms

m-3 1 KEY<0 End of Last Column

m-2 1 KEY=1 (Start new logical record)TD>

m-1 KEY Next Logical Record type=0 If Last "Next Logical


Record Type" = 0

m 1 KEY = 0 (EOF) End of Matrix

• Format for Tables and Matrix-End-of-Data

Physical Length Contents Description


record
number

n+1 1 If No Data Blocks Follow, KEY = 0 End-of-Data


(EOD)

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 Once per FORTRAN unit

IHEADR Once per data block

IREAD 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.

DMAP Programmer's Guide 11-47


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

• Data can be processed in logical groups rather than in a "blast" read mode.

Major limitations include:


• Matrices cannot be processed in this manner.

• Multiple FORTRAN units cannot be simultaneously processed.

• BACKSPACE operations are not permitted.

Following are descriptions and use of the three OUTPUT2 service routines.

Entry Description
point

IOPEN Initializes an OUTPUT2 file and read the label (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.

11-48 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Entry Description
point

IREAD Supplies data to the calling program in a logical (as opposed to a physical)
manner.
Format:
CALL IREAD(IUN,ARRY,NARY,IMETH,NT,IRTN)

where IUN is as described in IOPEN.


ARRY is the array into which a record is transmitted.
NARY is an integer input that requests the number of words to be transmitted.
If NARY is zero, no words 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.
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.

11.20 OUTPUT4
Output matrices onto a FORTRAN readable file
Write matrices in ASCII or binary format onto a FORTRAN readable file.

DMAP Programmer's Guide 11-49


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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:

ITAPE ACTION

0 None

-1 Rewind IUNIT before Write.

-2 End File and Rewind IUNIT after Write.

-3 Both

IUNIT Input-integer-no default. The absolute value of IUNIT is the FORTRAN unit
number on which the matrices 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. Siemens PLM Software does not recommend IUNIT = 0. See Remark 1.

UNUSED3 Input-integer-default=1. Unused.

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.

DIGITS 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)

For example, if
DIGITS = 9, the format is 1P,5E16.9
or if DIGITS = 16, the format is 1P,3E23.16

11-50 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Remarks:

1. Each matrix is written on IUNIT as follows:

• Record 1:

Word Type Meaning


number

1 Integer Number of columns (NCOL)

2 Integer Number of rows (NR, if BIGMAT=TRUE, NR < 0)

3 Integer Form of matrix (NF). See Remark 11 and Section 1.4.

4 Integer Type of matrix (NTYPE). See Remark 11 and Section


1.4.

5 and 6 Character Name of matrix (2A4 format)

7 Character 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 Type Meaning


number

1 Integer Column number (ICOL)

2 Integer Row position of first nonzero term (IROW)

3 Integer Number of words in the column (NW). See Remark 3.

4 through Real or Column element values, single or double precision


(NW+3) Complex

• 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 Word number Type Meaning


number

2 1 Integer Column number (ICOL)

2 Integer Row position of first nonzero


term (IROW)

DMAP Programmer's Guide 11-51


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Record Word number Type Meaning


number

3 Integer Number of words in the


column (NW). See Remark 3.

3, 4, and so on 1 through NW Real or Column element values, single


Complex or double precision

• Records 2, 3, 4, and so on for sparse, binary, and string header format (IUNIT < 0, and
BIGMAT = FALSE).

Word Type Meaning


number

1 Integer Column number (ICOL)

2 Integer Zero

3 Integer Number of words in the column (NW). See Remark 3.

4 through Integer String header (IS)*


(NW+3)
Real or A string of nonzero values, single or double precision
Complex

*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 Type Meaning


number

1 Integer Column number (ICOL)

2 Integer Zero

3 Integer Number of words in the column (NW). See


Remark 3.

11-52 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Word Type Meaning


number

4 through Integer Length of string, L, plus 1. See Remark 3. Repeated for


(NW+3) each string.
Integer Row position of first term in string (IROW)

Real or A string of nonzero values, single or


complex double precision

• 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).

Record Word number Type Meaning


number

2 1 Integer Column number (ICOL)

2 Integer Zero

3 Integer Number of words in the column


(NW). See Remark 3.

3 1 Integer String header (IS)*

4 1 through NW Real or A string of nonzero values, single or


Complex double precision

• 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 Word number Type Meaning


number

2 1 Integer Column number (ICOL)

2 Integer Zero

3 Integer Number of words in the column


(NW). See Remark 3.

3 1 Integer Length of string, L, plus 1. See


Remark 3.

2 Integer Row position of first term in string


(IROW)

4 1 through NW Real or A string of nonzero values, single or


Complex double precision

DMAP Programmer's Guide 11-53


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Number of words

1 – Real single precision 1

2 – Real double precision 2

3 – Complex single precision 2

4 – Complex double precision 4

4. Siemens PLM Software 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.

11.21 PANELERP
Output equivalent radiated power data.

11-54 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

PANELERP CASEG,BGPDTS,CSTMS,ECTS,EDTS,FOLX,UGCASE/OERP,OERPEL1,ERPFIL $

Input Data Blocks:

CASEG Table of case control command images for current subcase.

BGPDTS Basic grid point definition table for a superelement.

CSTMS Table of coordinate system transformation matrices for a superelement.

ECTS Element connectivity table.

EDTS Element data table.

FOLX Frequency response output list table.

UGCASE Displacement vector for current subcase.

Output Data Blocks:

OERP Equivalent radiated power output.

OERPEL1 ERP design responses at element level in SORT1 format for a particular subcase.

ERPFIL Element level ERP design response derivatives for a particular subcase.

Parameters:

None

11.22 PARAM
Performs specified operations on integer DMAP parameters.

Format:

PARAM //OP/S,N,OUT/IN1/IN2 $

Parameters:

OP Input-character-no default. An operation code from the following tables.

OUT Output-integer-default = 1. The parameter name.

IN1 Input-integer-default = 1. The first input value used to compute OUT according to
the tables in Remark 2.

DMAP Programmer's Guide 11-55


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

IN2 Input-integer-default = 1. The second input value used to compute OUT according
to the tables in Remark 2.

Remarks:

1. Since the release of MSC Nastran Version 66, all of the options of this module have equivalent
formats, as noted below, that use the assignment statement, functions, expressions, and
operators. Many of these are analogous to FORTRAN statements. See the “Direct Matrix
Abstraction” chapter of the DMAP Programmer's Guide for additional information.

2. The following tables give OUT as a function of inputs OP, IN1, and IN2.

Arithmetic Operations

OP ADD SUB MPY DIV NOT

OUT IN1+IN2 IN1–IN2 IN1*IN2 IN1/IN2 -IN1(1)

Equivalent OUT= OUT= OUT= OUT= OUT=-IN1


DMAP IN1+IN2 IN1–IN2 IN1*IN2 IN1/IN2
Assignment
Statement

(1) If IN1=0, then OUT=-1

Logical Operations

OP AND OR IMPL

OUT -1 +1 +1 +1 -1 -1 -1 +1 -1 +1 -1 -1

IN1 <0 <0 ≥0 ≥0 <0 <0 ≥0 ≥0 <0 <0 ≥0 ≥0

IN2 <0 ≥0 <0 ≥0 <0 ≥0 <0 ≥0 <0 ≥0 <0 ≥0

Equivalent LOUT= ANDL(IN1,IN2) LOUT= ORL(IN1,IN2) LOUT= IMPL(IN1,IN2)


DMAP
Assignment
Statement

LOUT is a logical parameter. If OUT=-1, then LOUT=TRUE. If OUT=+1, then LOUT=FALSE.

11-56 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Test Operations

OP EQ LT LE

OUT -1 +1 -1 +1 -1 +1

IN1,IN2 IN1=IN2 IN1≠IN2 IN1<IN2 IN1≥IN2 IN1≤IN2 IN1>IN2

Equivalent LOUT= LOUT= NUMLT(IN1,IN2) LOUT=


DMAP NUMEQ(IN1,IN2) NUMLE(IN1,IN2)
Assignment
Statement

LOUT is a logical parameter. If OUT=-1, then LOUT=TRUE. If OUT=+1, then LOUT=FALSE.

Test Operations (cont.)

OP GT GE NE

OUT -1 +1 -1 +1 -1 +1

IN1,IN2 IN1>IN2 IN1≤IN2 IN1≥IN2 IN1<IN2 IN1≠IN2 IN1=IN2

Equivalent LOUT= LOUT= LOUT=


DMAP NUMGT(IN1,IN2) NUMGE(IN1,IN2) NUMNE(IN1,IN2)
Assignment
Statement

LOUT is a logical parameter. If OUT=-1, then LOUT=TRUE. If OUT=+1, then LOUT=FALSE.

DMAP Programmer's Guide 11-57


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Special Operations

OP OUT Equivalent DMAP Function

NOP OUT (unchanged). NOOP( )

KLOCK Current CPU time in integer seconds from the CLOCK( )


start of the job.

TMTOGO Remaining CPU time in integer seconds based on TIMETOGO( )


the TIME executive control statement.

PREC Returns the currently requested precision; 1=S.P. PRECISION( )


and 2=D.P.

SYSTEM OUT and SYSTEM cell IN1 will be set to IN2. PUTSYS(IN2,IN1)

DIAGON Turn on DIAGs IN1 through IN2. IN2=0 implies RDIAGON(IN1,IN2)


IN2=IN1.

DIAGOFF Turn off DIAGs IN1 through IN2. IN2=0 implies RDIAGOFF(IN1,IN2)
IN2=IN1.

SYSR Set OUT to SYSTEM cell IN1. OUT=GETSYS(IN2,IN1)

SSST If OUT > 0, turn DIAG OUT on. DIAGON(OUT)


If OUT < 0, turn DIAG abs(OUT) off. DIAGOFF(OUT)

STSR If IN1 < 0, store OUT in SYSTEM cell abs(IN1). PUTSYS(OUT,IN1)


If IN1 > 0, store SYSTEM cell IN1 in OUT. OUT=GETSYS(OUT,IN1)

SETC Initialize all words in memory to value of OUT. SETCORE(OUT)

MODCOM If IN1 < 0, set SYSTEM( 70+abs(IN1))=OUT. MCPUTSYS(OUT,IN1)


If IN1 > 0, set OUT=SYSTEM(70+IN1). MCGETSYS(OUT,IN1)

11.23 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/
S,N,P7/S,N,P8/S,N,P9 $

11-58 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Input-character-no default. Only the first 4 characters are required. For example,
‘PRES’ and ‘PRESENCE’ are equivalent.

P2 Input/output-integer-default = 1

P3 Input/output-integer-default = 1

P4 Output-real-default = 0.0

P5 Output-integer-default = 0.0

P6 Output-real-default = 0.0

SETi Input/output-character-default = ’ ’

Fi 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.

Summary of Options:

P1 Option Description

P1='BULK' Check for the presence of Bulk Data entry records by examining the trailer
bits of its IFP module related table.

P1='DMI' Extract an element from a matrix.

P1='DTI' Extract a real, integer, complex, or character value from a table.

P1='DTI2' Extract double precision load factor stored in two consecutive words of the
ESTNL data block and truncate to single precision.

P1='DTI2C' Extract character value stored in two consecutive words.

P1='IMATCH' Search for a specific integer value in a table record.

P1='NAME' Return the name and purge status of a data block.

DMAP Programmer's Guide 11-59


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

P1 Option Description

P1='NULL' Test for a null matrix.

P1='PARAM' Check for the presence of a parameter PVT table.

P1='PRESENCE' Test for the presence (existence) of a data block.

P1='SET' Extract elements of a SET defined in Case Control.

P1='TABDEL' Delete a group of words in a record, the trailing portion of a record, or the
entire record in a table.

P1='TABINSR' Insert the WORDNUM-th word in the RECNUM-th record by real number
REAL.

P1='TABINSI' Insert the WORDNUM-th word in the RECNUM-th record by integer INTEG.

P1='TABINSC' Insert the WORDNUM-th word in the RECNUM-th record by four character
string CHAR.

P1='TABINS2C' Insert the WORDNUM-th and WORDNUM+1-th words in the RECNUM-th


record by two 4-character values comprising the character parameter CHAR.

P1='TABREPR' Replace the WORDNUM-th word in the RECNUM-th record by real number
REAL.

P1='TABREPI' Replace the WORDNUM-th word in the RECNUM-th record by integer


INTEG.

P1='TABREPC' Replace the WORDNUM-th word in the RECNUM-th record by four character
string CHAR.

P1='TABREP2C' Replace the WORDNUM-th and WORDNUM+1-th words in the RECNUM-th


record by two 4-character values comprising the character parameter CHAR.

P1='TRAILER' Extract a value from the trailer of a data block.

P1='USET' Search for a specific integer value in a table record.

P1='XYCDB' Check for the presence of a response types specified on xy plotting


commands: XYPAPLOT, XYPEAK, XYPLOT, XYPRINT and XYPUNCH.

Option P1 = ‘BULK’
Check for the presence of Bulk Data entry records by examining the trailer bits of its IFP module
related table.

11-60 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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

Parameters:

BULKNMi Input-character. Name of Bulk Data entry.

BULKFGi 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/////////////
////////////S,N,DFLAG/S,N,DREAL/S,N,DIMAG $

Input Data Block:

MAT Any matrix (real or complex)

Parameters:

ICOL Input-integer-default=1. Column number of matrix element.

DMAP Programmer's Guide 11-61


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

IROW Input-integer-default=1. Row number of matrix element.

REAL Output-real. Real part of matrix element.

IMAG Output-real. Imaginary part of matrix element, if element is complex.

DFLAG Output-integer.

=1, single precision

=2, double precision.

DREAL Output-real(double precision). Real part of matrix element.

DIMAG Output-real(double precision). 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, IMAG, DREAL and DIMAG are set to zero.

Example:
Obtain the value in column 6, row 11 of matrix KGG and save in parameter TERM.

PARAML KGG//’DMI’/6/11/S,N,TERM/S,N,NOKGG $

Option P1 = ‘DTI’
Extract a real, integer, complex, or character value from a table.

Format:

PARAML TAB//’DTI’/S,N,RECNUM/S,N,WRDNUM/
S,N,REAL/S,N,INTGR/S,N,IMAG/S,N,CHAR/
S,N,RECNEW//S,N,INTNEW $

Input Data Block:

TAB Any table

Parameters:

RECNUM Input/output-integer. Record number of value.

WRDNUM Input/output-integer. Word number of value.

REAL Output-real. Real part of value.

INTGR Output-integer. Integer value.

11-62 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

IMAG Output-real. Imaginary part of value.

CHAR Output-character. Character value. The first four characters in CHAR contain the
table value. The second four characters are blank.

RECNEW Output-integer. Record number in which table value at WORDNM-th word is


nonzero for RECNUM=-1 or changes for RECNUM=-2.

INTNEW 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.

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.

DMAP Programmer's Guide 11-63


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

PARAML ESTNL//‘DTI2‘/S,N,RECNUM/S,N,WRDNUM/S,N,REAL $

Input Data Block:

ESTNL Material nonlinear element summary table

Parameters:

RECNUM Input/output-integer. Record number of value.

WRDNUM Input/output-integer. First word number of value.

REAL 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.

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 Input/output-integer. Record number of value.

WRDNUM Input/output-integer. First word number of value.

11-64 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

INTGR Output-integer. Integer value and search flag when RECNUM<0.

CHAR2 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 $

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 Input-integer. Record number for search.

IVALUE Input-integer. Value to search.

FOUND 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 $

DMAP Programmer's Guide 11-65


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Output-integer. Set to -1 if the data block is purged.

NAME Output-character. Name of the data block. Set to blank if data block is purged.

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

11-66 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 $

Input Data Block:

PVT Parameter value table

Parameters:

PARAMi Input-character. Parameter name.

NOPARMi Output-integer. If parameter exists then NOPARMi=-1, otherwise the


parameter is unchanged.

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 $

DMAP Programmer's Guide 11-67


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

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 Input/output-integer. Record number.

WRDNUM Input/output-integer. Word number of Case Control command selection


which references the desired set.

REAL Output-real. Real part of value in the set.

INTGR Output-integer. Integer value in the set.

IMAG Output-real. Imaginary part in the set.

CHAR Output-character. Character value in the set.

SETKNTR 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.

11-68 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Example:
Extract the members of the sample Case Control command.
K2GG=MATA MATB MATC

(Word 338 in CASECC contains the internal set identification number for K2GG.)
PARAML CASECC//‘SET‘/1/338////S,N,MATNAM/S,N,SETKNTR $

Option P1=‘TABDEL’
Delete a group of words in a record, the trailing portion of a record, or the entire record in a table.

Format:

PARAML TABIN/TABOUT/’TABDEL’/
RECNUM/WORDNUM//NWORDS $

Input Data Block:

TABIN Any table.

Output Data Block:

TABOUT Modified TABIN.

Parameters:

RECNUM Input/output-integer. Record number. If RECNUM is greater than the


number of records in TABIN, it will result in a fatal error. (RECNUM=0 refers
to the header record of TABIN.)

WORDNUM Input-integer. Word number.


>0 A total of NWORDS entries starting from word number. WORDNUM
(and going forward) are deleted from record number RECNUM. If NWORDS
is not specified, it is internally assumed to be 1.
=0 Delete the entire record RECNUM. NWORDS is ignored in this case.
<0 Delete the trailing portion of record RECNUM starting from word number
ABS(WORDNUM). NWORDS is ignored in this case.

NWORDS Input-integer. Number of words to delete.

Remark:
1. The usage implies that the use of WORDNUM=0 and WORDNUM=-1 will both result in the
deletion of the entire record number RECNUM.

Option P1=’TABINSR’, ‘TABINSI’, ‘TABINSC’, and ‘TABINS2C’


Insert a new value in a record or insert a new record after an existing record in a table.

DMAP Programmer's Guide 11-69


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format for P1=’TABINSR’:

Insert the WORDNUM-th word in the RECNUM-th record by real number REAL.

PARAML TABIN/TABOUT/’TABINSR’//
RECNUM/WORDNUM/REAL $

Format for P1=’TABINSI’:

Insert the WORDNUM-th word in the RECNUM-th record by integer INTEG.

PARAML TABIN/TABOUT/’TABINSI’//
RECNUM/WORDNUM//INTEG $

Format for P1=’TABINSC’:

Insert the WORDNUM-th word in the RECNUM-th record by four character string CHAR.

PARAML TABIN/TABOUT/’TABINSC’/
RECNUM/WORDNUM////CHAR $

Format for P1=’TABINS2C’:

Insert the WORDNUM-th and WORDNUM+1-th words in the RECNUM-th record by two 4-character
values comprising the character parameter CHAR.

PARAML TABIN/TABOUT/’TABINS2C’/
RECNUM/WORDNUM////CHAR $

Input Data Block:

TABIN Any table.

Output Data Block:

TABOUT Modified TABIN.

Parameters:

RECNUM Input-integer. Record number. If RECNUM is greater than the number of


records in TABIN, it will result in a fatal error. (RECNUM=0 refers to the
header record of TABIN.)

11-70 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

WORDNUM Input-integer. Word number.


>0 The new value is inserted AFTER word number WORDNUM in record
number RECNUM.
<0 The new value is inserted BEFORE word number ABS(WORDNUM) in
record number RECNUM.
=0 A new record containing the new value is inserted AFTER record number
RECNUM.

REAL Input-real. New real value to be inserted in TABIN.

INTGR Input-integer. New integer to be inserted value in TABIN.

CHAR Input-character. New character value to be inserted in TABIN.

Option P1=’TABREPR’, ‘TABREPI’, ‘TABREPC’, and ‘TABREP2C’


Replace any value in any record of a table.

Format for P1=’TABREPR’:


Replace the WORDNUM-th word in the RECNUM-th record by real number REAL.

PARAML TABIN/TABOUT/’TABREPR’//
RECNUM/WORDNUM/REAL $

Format for P1=’TABREPI’:


Replace the WORDNUM-th word in the RECNUM-th record by integer INTEG.

PARAML TABIN/TABOUT/’TABREPI’/
RECNUM/WORDNUM//INTEG $

Format for P1=’TABREPC’:


Replace the WORDNUM-th word in the RECNUM-th record by four character string CHAR.

PARAML TABIN/TABOUT/’TABREPC’/
RECNUM/WORDNUM////CHAR $

Format for P1=’TABREP2C’:


Replace the WORDNUM-th and WORDNUM+1-th words in the RECNUM-th record by two
4-character values comprising the character parameter CHAR.

PARAML TABIN/TABOUT/’TABREP2C’/
RECNUM/WORDNUM////CHAR $

Input Data Block:

TABIN Any table.

DMAP Programmer's Guide 11-71


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Block:

TABOUT Modified TABIN.

Parameters:

RECNUM Input-integer. Record number. If RECNUM is greater than the number of


records in TABIN, it will result in a fatal error. (RECNUM=0 refers to the
header record of TABIN.)

WORDNUM Input-integer. Word number.


>0 The new value is inserted AFTER word number WORDNUM in record
number RECNUM.
<0 The new value is inserted BEFORE word number ABS(WORDNUM) in
record number RECNUM.
=0 A new record containing the new value is inserted AFTER record number
RECNUM.

REAL Input-real. New real value to be inserted in TABIN.

INTGR Input-integer. New integer to be inserted value in TABIN.

CHAR Input-character. New character value to be inserted in TABIN.

Remarks:

1. When replacing words, make sure that the new word is the same type as the original since
the program does not check for this condition.

Option P1 = ‘TRAILER’
Extract a value from the trailer of a data block.

Format:

PARAML DB//‘TRAILER‘/WRDNUM/S,N,TVALUE/S,N,REAL/
S,N,NOSET/SETNAME $

Input Data Block:

DB Any data block

Parameter:

WRDNUM Input-integer. Word number of trailer.

TVALUE 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.

11-72 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

REAL Output-real. Trailer value as a real number. Used only if WRDNUM=6. See
Remark 2.

NOSET Output-integer. USET flag for existence for the set specified by SETNAME.
NOSET is set to -1 if the set does not exist.

SETNAME Input-character. Degree-of-freedom set name. Used only if NOSET=0.

Remarks:
1. Meaning of TVALUE:

WRDNUM Meaning of TVALUE

1 Number of columns in matrix

2 Number of rows in matrix

3 Form of the matrix

4 Type of matrix

5 Largest number of nonzero words among all columns

6 Density of the matrix multiplied by 10000

7 Size in blocks

8 Maximum string length over all strings

9 Number of strings

10 Average bandwidth

11 Maximum bandwidth

12 Number of null columns

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 $

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.

DMAP Programmer's Guide 11-73


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Input-character. Degree-of-freedom Set name.

NOSETi 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.

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.

11-74 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

RESPi Input-character. The valid names are:

• DISP

• VELO

• ACCE

• SPCF

• OLOAVG

• STRE

• FORC

• SDIS

• SVELSACC

• NFOR

• ORES

• BOUT

• STRAMPCF

• FPRE

• FMPF

• SMPF

• PMPF

• LMPF

• 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.

DMAP Programmer's Guide 11-75


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Example:

Check for the presence of the MPCF response type.


PARAML XYCDBS//‘XYCDB‘//////‘MPCF‘/S,N,NOMPCF $

11.24 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 Matrix to be partitioned

CP Column partitioning vector – single precision column vector

RP Row partitioning vector – single precision column vector

Output Data Blocks:

Aij Matrix partitions. See Remarks below.

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.

TYPE 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].

Fij Input-integer-default=0. Form of [Aij]. See Remarks.

11-76 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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].

Case 1: {CP} is purged and SYM ≥ 0:


PARTN A,,RP/A11,A21,,/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.

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:

DMAP Programmer's Guide 11-77


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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:

The DMAP instruction

11-78 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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

4. If

and the DMAP instruction was written as


PARTN A,RP,/A11,A21,A12,A22/-1 $

the resulting partitions would be

DMAP Programmer's Guide 11-79


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.25 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 Table of Case Control command images.

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries

SLT Table of static loads

PGUP Static load matrix for the g-set and in the residual structure due to static loads in
upstream superelements only

PJ Static load matrix for the g-set of the residual structure and applied to its interior
points only

Output Data Blocks:

CVECT Load combination factor matrix

PG1 Combined static load matrix for the g-set and in the residual structure

Parameters:

NSKIP Input-integer-default=0. Subcase record number to read in CASECC.

NVECT Output-integer-default=0. Number of columns in CVECT and PG1.

11-80 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

MODE Input-character-no default. Boundary condition change ignore flag. See Remark 2.
NONLINEAR Ignore boundary condition changes STATICS Do not ignore
boundary condition changes

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.

11.26 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

>0 Do not perform copy

PCOPY2 Input-integer-default=1. Parallel copy method.

>0 Perform standard copy using CPYFIL

<0 Perform copy using single buffer for input and output

Remarks:
PCOPY is a reserved for internal development purposes and should not be used.

DMAP Programmer's Guide 11-81


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.27 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 Table of plot parameters and plot control

GPSETS Table of grid point sets related to the element plot sets

ELSET Table of element plot set connections

CASECC Table of Case Control command images.

BGPDT Basic grid point definition table.

PUGS Matrix of translational displacements in static analysis

USET Degree-of-freedom set membership table for g-set

PUGD Matrix of translational displacements in dynamic analysis

ECT Element connectivity table

GPECT Grid point element connection table

OES1 Table of element stresses or strains in SORT1 format

Output Data Blocks:

PLOTMSG Table of user informational messages generated during the plot process

Parameters:

NGP Input-integer-no default. Number of grid points and scalar points in the structure

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set. If


LUSET=0, its value is extracted from the trailer of BGPDT.

11-82 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

JPLOT Input-integer-no default. Number of element plot sets. Set to -1 if there are none.

DEFORMED Input-integer-default=1. Deformed plot request flag.

1 Plot undeformed shapes

-1 Plot deformed shapes

PLTNUM Input/output-integer-default=0. Plot frame counter.

Remarks:

1. If GPECT, OES1, PUGS, and PUGD are purged, 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.

11.28 PLTHBDY
Supports plotting of CHBDYi elements

Updates the geometry and connectivity tables to support plotting of CHBDYi elements.

Format:

PLTHBDY GEOM2,ECT,EPT,BGPDT,CSTM/
PECT,PBGPDT/
S,N,NHBDY/MESH $

Input Data Blocks:

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

ECT Element connectivity table

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

DMAP Programmer's Guide 11-83


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:

PECT Element connectivity table updated to support plotting CHBDYi elements

PBGPDT Basic grid point definition table updated to support plotting CHBDYi elements

Parameters:

NHBDY Output-integer-no default. Number of CHBDYi elements. Set to -1 if none exist.

MESH Input-character-no default. Shading summary print flag. Set to ‘YES’to print
summary; ‘NO’otherwise.

11.29 PLTSET
Generates element sets for plotting

Format:

PLTSET

Input Data Blocks:

PCDB Table of model (undeformed and deformed) plotting commands

POSTCDB Table of commands from the OUTPUT(POST) section of Case Control

BGPDT Basic grid point definition table

PBGPDT Basic grid point definition table updated to support plotting CHBDYi elements

ECT Element connectivity table

PECT Element connectivity table updated to support plotting CHBDYi elements

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

11-84 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Output Data Blocks:

PLSETMSG Table of user informational messages generated during the definition of element
plot sets

PLTPAR Table of plot parameters and plot control

GPSETS Table of grid point sets related to the element plot sets

ELSET Table of element plot set connections

PELSET P-element set table, contains SETS DEFINITIONS

Parameters:

NGP Output-integer-no default. Number of grid points and scalar points in the structure.

JPLOT Output-integer-no default. Number of element plot sets. Set to -1 if there are none.

ECTYPE Input-integer-default=0. Type of element connectivity input and plot set output:

0 ECT and ELSET

1 GEOM2 and ELSET

2 ECT and PELSET

Remarks:

PCDB can be purged if ECTYPE>0.

Examples:

1. For p-elements in subDMAP IFPS1, ELSET is required by GP0.


PLTSET POSTCDB,,GEOM2/X1,X2,X3,ELSET/0/0/1 $

2. For undeformed plotting in subDMAP SEPLOT:


PLTSET PCDB,PBGPDT,PECT/
PLTMSG,PLTPAR,GPSETS,ELSETS/
S,N,NSILS/S,N,JPLOT $

11.30 PRESOL
Prepares special tables for the distributed parallel solution

Prepares special tables for the distributed parallel solution using the domain

decomposition method.

DMAP Programmer's Guide 11-85


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

PRESOL GEQMAP,USET,SIL,PARFIL,PFA,PJXL/
EQMAP,GAPAR,PARTF,PFA1/
UNUSED1/UNUSED2 $

Input Data Blocks:

GEQMAP Table of grid based local equation map indicating which grid resides on which
processors/partitions for domain decomposition

USET Degree-of-freedom set membership table for g-set

SIL Scalar index list

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to


degrees-of-freedom that are locally constrained

PFA Static load matrix with partial boundary loads in the a-set

PJXL Static load matrix for boundary load contribution from the residual structure

Output Data Blocks:

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

GAPAR Partitioning vector which is used to partition the local a-set displacements from
the global a-set displacements. It contains a 1 at each row that does not have a
contribution from the current processor, and zero if it does.

PARTVEC1 Updated PARTVEC indicating for all constraints; local and boundary

PFA1 Updated PFA with complete boundary loads

Parameters:

Unusedi Input-integer-default=0. Unused and can be unspecified.

11.31 PROJVER
Set or query project identification numbers

Format:

PROJVER //PRJVEROP/S,N,PROJNO/S,N,VERSION/S,N,EXISTS $

Input Data Blocks:


None.

11-86 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Output Data Blocks:

None.

Parameters:

PRJVEROP Input-character-no default. Operation name.

‘GET’ Get current project and version

‘NEXT’ Get next non-deleted project and version

‘SET’ Set current project and version

‘LAST’ Get the last (bottom) project and version

‘RESTART’ Get restart project and version

PROJNO Input/output-integer-no default. Project number.

VERSION Input/output-integer-no default. Version number.

EXISTS Output-character-no default. Project and version status.

‘EXISTS’ If project and version exists

‘DELETED’ If project and version is deleted

‘NONE’ If project and version never existed

11.32 PRTMSG
Prints plotting information messages
Prints user information messages related to plot set definition and plotting.

Format:

PRTMSG

Input Data Blocks:

PLOTMSG Table of user informational messages generated during the plot process

PLSETMSG Table of user informational messages generated during the definition of element
plot sets

DMAP Programmer's Guide 11-87


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:


None.

Parameter:

PDRMSG Input-integer-default=1. Message print flag. Set to 0 to suppress printout.

11.33 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.

b Input-character-default = ‘XXXXXXXX’ Name of a parameter enclosed by single


quotation marks. See Remark 1.

c Input-integer-default=0. If c=1, parameters are sorted alphabetically.

SUBDMAP 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’$

11-88 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

• 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.

11.34 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.

< Data blocks are deleted and marked empty


0

≥ No action is taken
0

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.

DMAP Programmer's Guide 11-89


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

PURGEX /MGGX,,,,/NOMGGX $

11.35 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 Parameter value table from IFP module (Bulk Data PARAM entries)

CASECC 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.

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.

11-90 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

• 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.

11.36 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,SABFIL/
S,N,NORAND/RMSINT/CPLX/SSFLAG/RMSSF/CMPFLAG $

Input Data Blocks:

XYCDB Table of x-y plotting commands

DIT Table of TABLEij Bulk Data entry images

PSDL Power spectral density list

OUG2 Table of displacements in SORT2 format

OPG2 Table of applied loads in SORT2 format

OQG2 Table of single point forces of constraint in SORT2 format

OES2 Table of element stresses or strains in SORT2 format

OEF2 Table of element forces in SORT2 format

CASECC Table of Case Control command images

OSTR2 Table of element strains in SORT2 format

OQMG2 Table of multipoint forces of constraint in SORT2 format

RCROSSL Table of RCROSS Bulk Data entry images

DMAP Programmer's Guide 11-91


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

OFMPF2M Table of fluid modal participation factors by natural modes in SORT2 format

OSMPF2M Table of structural modal participation factors by natural modes in SORT2 format

OLMPF2M Table of load modal participation factors by natural modes in SORT2 format

OPMPF2M Table of panel modal participation factors by natural modes in SORT2 format

OGPMPF2M Table of panel grid modal participation factors by natural modes in SORT2 format

Output Data Blocks:

PSDF Power spectral density table

AUTO Autocorrelation function table

OUGPSD2 Table of displacements in SORT2 format for the PSD function

OUGATO2 Table of displacements in SORT2 format for the autocorrelation function

OUGRMS2 Table of displacements in SORT2 format for the RMS function

OUGNO2 Table of displacements in SORT2 format for the NO function

OUGCRM2 Table of displacements in SORT2 format for the cross correlation function

OPGPSD2 Table of applied loads in SORT2 format for the PSD function

OPGATO2 Table of applied loads in SORT2 format for the autocorrelation function

OPGRMS2 Table of applied loads in SORT2 format for the RMS function

OPGNO2 Table of applied loads in SORT2 format for the NO function

OPGCRM2 Table of applied loads in SORT2 format for the cross correlation function

OQGPSD2 Table of single point forces of constraint in SORT2 format for the PSD function

OQGATO2 Table of single point forces of constraint in SORT2 format for the autocorrelation
function

OQGRMS2 Table of single point forces of constraint in SORT2 format for the RMS function

OQGNO2 Table of single point forces of constraint in SORT2 format for the NO function

OQGCRM2 Table of single point forces of constraint in SORT2 format for the cross correlation

OESPSD2 Table of element stresses in SORT2 format for the PSD function

OESATO2 Table of element stresses in SORT2 format for the autocorrelation function

OESRMS2 Table of element stresses in SORT2 format for the RMS function

11-92 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

OESNO2 Table of element stresses in SORT2 format for the NO function

OESCRM2 Table of element stresses in SORT2 format for the cross correlation function

OEFPSD2 Table of element forces in SORT2 format for the PSD function

OEFATO2 Table of element forces in SORT2 format for the autocorrelation function

OEFRMS2 Table of element forces in SORT2 format for the RMS function

OEFNO2 Table of element forces in SORT2 format for the NO function

OEFCRM2 Table of element forces in SORT2 format for the cross correlation function

OEEPSD2 Table of element strains in SORT2 format for the PSD function

OEEATO2 Table of element strains in SORT2 format for the autocorrelation function

OEERMS2 Table of element strains in SORT2 format for the RMS function

OEENO2 Table of element strains in SORT2 format for the NO function

OEECRM2 Table of element strains in SORT2 format for the cross correlation function

OQMPSD2 Table of multipoint forces of constraint in SORT2 format for the PSD function

OQMATO2 Table of multipoint forces of constraint in SORT2 format for the autocorrelation
function

OQMRMS2 Table of multipoint forces of constraint in SORT2 format for the RMS function

OQMNO2 Table of multipoint forces of constraint in SORT2 format for the NO function

OQMCRM2 Table of multipoint forces of constraint in SORT2 format for the cross correlation
function

OCPSDF Output table of cross-power-spectral-density functions

OCCORF Output table of cross-correlation functions

SABFIL Table of SOL 200 related information regarding the RANDPS data, frequency
responses, and load PSD values associated with constrained PSD responses

Parameters:

NORAND Output-integer-default =-1. Set to -1 if no random analysis is requested; 0


otherwise.

RMSINT Input-character-default = ‘LINEAR’ Power-spectral-density function interpolation


option. A log-log option can be selected with RMSINT=‘LOGLOG’

CPLX Input-integer-default = 0. Set to 1 if complex data is requested. Set to 0 for real


data.

DMAP Programmer's Guide 11-93


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

SSFLAG Input-integer-default = 0. Set to 1 if processing solution set data.

RMSSF Input-real single precision-default = 1.0. RMS results are multiplied by this scale
factor.

CMPFLAG Input-integer-default = 0. Set to 1 if the table of composite element stresses/strains


is present.

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.

11.37 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/CDITER $

Input Data Blocks:

LLL Lower triangular factor/diagonal for the l-set from KLL

ULL Upper triangular factor/diagonal for the l-set from KLL

KLR Stiffness matrix partition (l-set by r-set) from KTT

KRR Stiffness matrix partition (r-set by r-set) from KTT

Output Data Block:

DM Rigid body transformation matrix for the r-set to the l-set

Parameters:

CDITER Input-integer-default=0. Maximum number of iterations in a constrained


displacement analysis.

11-94 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Remarks:
1. The rigid body transformation matrix is computed from:

Equation 11-1.

2. The rigid body error ratio, e, is computed from:

Equation 11-2.
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 11-3.

3. ULL can be purged if KLL is symmetric.

11.38 RBMG4
Computes rigid body mass matrix

Format:

RBMG4 DM,MLL,MLR,MRR/
MR $

Input Data Blocks:

DM Rigid body transformation matrix for the r-set to the l-set

MLL Mass matrix reduced to the l-set

MLR Mass matrix partition (l-set by r-set) from MTT

MRR Mass matrix partition (r-set by r-set) from MTT

DMAP Programmer's Guide 11-95


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 11-4.

11.39 READ
Extracts real symmetric system eigenvaules

Extracts eigenvalues from a real symmetric system.

Solves the following equations for eigenvalues and their associated eigenvectors:

Format:

READ

11-96 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Input Data Blocks:

KAA K matrix in

MAA M matrix in

or Kd matrix in

MR Rigid body mass matrix

DAR Rigid body transformation matrix

DYNAMIC Eigenvalue Extraction Data (output by IFP module)

USET Degree-of-freedom set membership table

CASECC Case Control Data Table (selects EIGR, EIGRL, or EIGB entries, output by IFP
module)

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KAA and MAA. Required
for maximum efficiency. See SETNAME parameter description below.

SIL Scalar index list. Required for maximum efficiency.

VACOMP Partitioning vector of size of a-set with a value of 1.0 at the rows corresponding
to r-set degrees-of-freedom. The USET table 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.

SPCCOL Local f-size partitioning vector with 1.0 for the local boundary‘s s-set
degrees-of-freedom. Required only for geometric domain decomp.

INVEC Starting vector(s) for Lanczos method only

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition.


Required only for geometric domain decomp.

LLL Lower triangular factor from decomposition of KAA. Use to enhance shift logic for
buckling eigenvalue extraction.

DMAP Programmer's Guide 11-97


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

VFO1 VFO zero-partition by SPCCOL. VFO is the local f-size partitioning vector with
6 values of 1.0 for every grid in the local residual. Required only for geometric
domain decomp.

EQEXIN Equivalence between external and internal grid identification numbers. Required
for maximum efficiency.

GAPAR Partitioning vector which is used to partition the local a-set displacements from
the global a-set displacements. It contains a 1 at each row that does not have
a contribution from the current processor and zero if it does. Required only for
geometric domain decomp.

Output Data Blocks:

LAMA Normal modes eigenvalue summary table

PHA Normal modes eigenvector matrix in the a-set

OEIGS Real eigenvalue extraction report

MI Modal mass matrix

LAMMAT Diagonal matrix containing eigenvalues on the diagonal (Lanczos only)

OUTVEC 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.

NEIGV Output-integer-no default. NEIGV is the number of eigenvectors found.

0 No eigenvectors found

>0 NEIGV eigenvectors found

<0 NEIGV eigenvectors found but there was an error encountered during
the extraction

NSKIP Input-integer-default=1. The method used by READ is taken from the NSKIP
record of CASECC.

FLUID Input-logical-default=FALSE. If FLUID = TRUE, the EIGRL or EIGR entry is


selected from METHOD(FLUID) Case Control command.

SETNAME Input-character-default=‘A’ For maximum efficiency, the rows and columns KXX
and MXX must correspond to, or be a partition of the displacement set specified by
SETNAME. If KAA and MAA are a partition, PARTVEC must be specified.

11-98 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SID Input-integer-default=0. Alternate set identification number.


If SID=0, the set identification number is obtained from the METHOD command in
CASECC and used to select the EIGR, EIGB, or EIGRL entries in DYNAMIC.
If SID>0, 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.

METH Input-character-default=‘LAN’ If SID<0, METH specifies the method of eigenvalue


extraction.

LAN Lanczos

SINV Inverse power with Sturm sequence

HOU Householder

MHOU Modified Householder

AGIV Automatic selection of MGIV

AHOU Automatic selection of HOU or MHOU

F1 Input-real-default=0.0. The lower frequency bound.

F2 Input-real-default=0.0. The upper frequency bound. The default value of 0.0


indicates machine infinity.

NE Input-integer-default=20. The number of estimated eigenvalues for non-Lanczos


methods only. For the Lanczos method, NE is the problem size which the QL
Householder method is using.
Note

NE default changed from 0 to 20

ND Input-integer-default=0. The number of desired eigenvalues.

MSGLVL Input-integer-default=0. The level of diagnostic output for the Lanczos method only.

0 No output

1 Warning and fatal messages

2 Ssummary output

DMAP Programmer's Guide 11-99


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

3 Detailed output on cost and convergence

4 Detailed output on orthogonalization

MAXSET Input-integer-default=0. Vector block size for Lanczos method only.

SHFSCL Input-real-default=0.0. Estimate of the first flexible natural frequency. SHFSCL


must be greater than 0.0.

NORM Input-character-default=’ ’ Method for normalizing eigenvectors. By default


(or NORM=‘MASS‘), MASS normalization is performed. NORM=‘MAX’selects
normalization by maximum displacement.

PRTSUM Inpput-logical-default=TRUE. Lanczos eigenvalue summary print flag.

MAXRATIO Input-real-default=1.0E7. Minimum value of factor diagonal ratio which causes


termination of decomposition.

BAILOUT Input-integer-default=0. If BAILOUT ≥ 0, the module exits with an error message if


the Sturm sequence number is in disagreement with the number of modes actually
computed in the range. If BAILOUT ≤ -1, the module continues with a warning
message after the Sturm sequence check error.

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 $

• 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 $

11-100 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 $

It is recommended 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 method, 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.

DMAP Programmer's Guide 11-101


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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, Siemens PLM
Software 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.

• For maximum efficiency in the Lanczos method, Siemens PLM Software 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:

11-102 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

• 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 A//’TRAILER’/1/S,N,NCOLA $
MATGEN ,/IDEN/1/NCOLA $
READ A,IDEN,,,DYNAMICS,,CASECC,,,,,,,,/LAMA,VECTOR,MI,
OEIGS,/’MODES’/S,N,NEIGS/1 $
OFP LAMA,OEIGS//$
IF (NEIGS > -1) MATPRN VECTOR// $

2. Suppose that 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// $

11.40 RESTART
Data block comparison
Compares two data blocks and invokes dependencies.

Format:

RESTART DB1,DB2,DLSTIN/DLSTOUT/
INVOKE/SPEXP/DPEXP/NDDLNAM/S,CMPDIF $

Input Data Blocks:

DBi Data blocks to be compared

DLSTIN A list of data blocks and the associated pathnames. DLSTIN was built as
DLSTOUT during prior executions of the RESTART module. DLSTIN is used to
invoke the same restart dependencies, but with different qualifiers, as done during
previous RESTART comparisons.

DMAP Programmer's Guide 11-103


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

SPEXP Input-integer-default=6. Single-precision tolerance exponent. Two single-precision


numbers x and y are considered equal if

DBEXP Input-logical-default=12. Double-precision tolerance component. Two


double-precision numbers, x and y are considered equal if

NDDLNAM Input-character-default=’ ’ NDDL is the name of the DATABLK statement to use


for a description in the comparison that overrides the name of DB1.

CMPDIF Output-integer. If CMPDIF=1, the comparison between DB1 and DB2 found
differences. Only valid for DB1 and DB2 existing with DLSTIN purged.

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.

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) $

11-104 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

DBVIEW GEOM2R = GEOM2 (WHERE VERSION=RESVER) $


RESTART GEOM1,GEOM1R,/HIST/ $
RESTART GEOM2,GEOM2R,/HIST/ $
SEID = SEDWN $
RESTART ,,,HIST//TRUE $

11.41 RMAXMIN
Searches result tables during SOL 112.
Searches stress, force and displacement tables during SOLs 101 or 112 for extreme values.

Format:

RMAXMIN OUGV1,OEF1,OES1,PNLIN1,PNLIN2,PNLIN3/
OUGV1MX,OEF1MX,OES1MX,PNLOUT1,PNLOUT2,PNLOUT3/
IFABS/IAPPN/IDIAG/RMXTRAN/NPAVG/START/END/ISTART/IEND/RMXPAN $

Input Data Blocks:

OUGV1 Table of displacements or accelerations in SORT1 format

OEF1 Table of element forces in SORT1 format

OES1 Table of element stress in SORT1 format

PNLINi Control information for successive calls when using the panel method and
parameter RMXPAN > 0

Output Data Blocks:

OUGV1MX Displacement output data block

OEF1MX Force output data block

OES1MX Stress output data block

PNLOUTi Updated control information for successive calls when using the panel method
and parameter RMXPAN > 0

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.

IAPPN Input parameter to modify how approach code is written: IAPPN = 0 write approach
code found in data block header (default). IAPPN > 0 write approach code iappn.

DMAP Programmer's Guide 11-105


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

RMXTRAN Input parameter to provide an alternate and overiding request of the bulk data
parameter RMXTRAN.

NPAVG Input parameter to declare the maximum number of peaks to average.

START Input parameter to set the start time of an interval in the total time domain.

END Input parameter to set the end time of an interval in the total time domain.

ISTART First subcase ID used in SOL 101.

IEND Last subcase ID used in SOL 101.

RMXPAN Input-integer-no default.


Determines whether SOL 112 runs utilize special sub-DMAP in SEDRCVR.
RMXPAN = 0: The RMAXMIN module is not used by the special paneling
sub-DMAP in SEDRCVR.
RMXPAN ≠ 0: The RMAXMIN module is used by the special paneling sub-DMAP
in SEDRCVR.

Remarks:
1. If PARAM POST is not enabled, the output data blocks 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 data blocks 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 data blocks:
OUGV1MX, OEF1MX and OES1MX.

3. The size of paneling within sub-DMAP SEDRCVR is determined by the parameter,


RMXPANEL. See the RMXPANEL parameter description in the Quick Reference Guide for
further details.

11.42 RMG2
Processes radiation exchange coefficients

11-106 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Element summary table

MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images

MUGNI Temperature matrix for stiffness update

KGGNL Conduction matrix in g-set for material nonlinear elements only

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

BGPDT Basic grid point definition table

SIL Scalar index list

USET Degree-of-freedom set membership table for g-set

Output Data Blocks:

RDEST Radiation element summary table

RECM Radiation exchange coefficient matrix

RGG Radiation transfer matrix in the g-set

KGGNL1 Conduction matrix in g-set for material nonlinear elements only and updated for
radiation

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.

SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute


radiant heat flux.

NORADMAT Input/output-integer-default=-1. Radiation flag.

2 No radiation

DMAP Programmer's Guide 11-107


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

-1 Initial radiation

1 Single band radiation with constant emissivity

2 Radiation with temperature dependent emissivity

3 Multiple band radiation with constant emissivity

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

Remarks:
If KGGNL is not purged, LUSET is determined from KGGNL.

11.43 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.

Format:

ROTCDA OMGMTDR,CLAMTRDR,CLAMTIDR,WHRDIR,SLAMTRDR,
SLAMTIDR,SWHRDIR,RSPEEDT/CDDATA/
ROTGPF/ROTCSV/IREFS/IRSPEED/IRFREQ/ROTPRNT/
MODTRK/MAXROOT/MTRFMAX/MTRRMAX/MTREPSR/
MTREPSI/MTRFCTD/MTRFCTV/MTRSKIP/ $

Input Data Blocks:

OMGMTDR Vector of rotor speeds.

CLAMTRDR Real part of solutions.

CLAMTIDR Imaginary part of solutions.

WHRDIR Whirl directions.

SLAMTRDR Real part of synchronous solution.

SLAMTIDR Imaginary part of synchronous solution.

SWHRDIR Whirl directions of synchronous solution.

RSPEEDT Rotational speed factors.

Output Data Blocks:

CDDATA Output table of solution data for Campbell’s diagram.

11-108 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

ROTGPF Output unit for GAROS post-processing file.

ROTCSV Output unit for comma-separated Excel file.

IREFS Reference system (1: fixed, 2: rotating).

IRSPEED Unit for speed (1: rpm, 2: Hz, 3: rad/sec).

IRFREQ Unit for frequency (1:rpm, 2: Hz, 3: rad/sec).

ROTPRNT Flag for extra printing.

MODTRK Input-integer-default=2. Mode tracking method (1, 2, or 3).

MAXROOT Input-integer-default=0. Maximum number of roots found for all speeds.

MTRFMAX Input-real-default=0.0. Maximum frequency to consider. If 0.0, all frequencies


are used.

MTRRMAX Input-real-default=0.0. Maximum absolute value of real part of solution to


consider. If 0.0, all real part values are used.

MTREPSR Input-real-default=0.05. Relative tolerance for the real part (eigenfrequency).

MTREPSI Input-real-default=0.01. Relative tolerance for the imaginary part


(eigenfrequency).

MTRFCTD Input-real-default=0.5. Threshold value for damping.

MTRFCTV Input-real-default=0.0. Reference value for converting aerodynamic speed to


rotor speed for wind turbines. Used only for wind turbines in SOL 145.

MTRSKIP Input-integer-default=5. If roots are not found for a specific speed, this speed
is skipped and the next speed is analyzed. If there are more than MTRSKIP
values missing, the curve is not considered.

Remarks:

1. Parameters MTRFMAX and MTRRMAX are valid for mode tracking methods 2 and 3.

2. Parameters MTREPSR, MTREPSI, MTRFCTD, MTRFCTV, and MTRSKIP are only valid for
mode tracking method 2.

11.44 ROTCZG
Calculates the gyroscopic/coriolis matrix and centrifugal matrix in the g-set for a rotor.

DMAP Programmer's Guide 11-109


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

ROTCZG SILS,CSTMS,BGPDTS,MGGDI,XYZ/CGGR,ZGGR/
IREFS/IFSTEIN/RCORD $

Input Data Blocks:

SILS Scalar index list.

CSTMS Coordinate system transformation matrices.

BGPDTS Basic grid point definition table.

MGGDI Diagonal mass matrix input as vector.

XYZ g-set by 3 matrix of x,y,z coordinates transformed to the rotor system.

Output Data Blocks:

CGGR Coriolis/gyroscopic, velocity-dependent matrix of size g-set.

ZGGR Centrifugal, displacement-dependent matrix of size g-set.

Parameters:

IREFS Reference system (1: fixed, 2: rotating)

IFSTEIN Flag for calculating Steiner’s terms (1: calculate)

RCORD Coordinate system ID for rotor definition.

11.45 ROTSDB
Create speed-dependent bearing matrices, mapping matrices, and speed-dependent speed ratio
table.

Format:

ROTSDB I1,I2/
O1,O2,O3,O4,O5,O6,O7,O8,O9,O10,O11,O12,O13/
P1/P2/P3/P4/P5/P6/P7/P8/P9/P10/P11/P12/P13/P14/
P15/P16/P17/P18/P19/P20/P21/P22/P23/P24/P25/P26/
P27/P28/P29/P30/P31/P32/P33/P34/P35/P36/P37/P38/
P39/P40/P41/P42/P43 $

Input Data Blocks:

Ii Input data blocks. I2 may not be necessary depending on the value P1.

11-110 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Output Data Blocks:

Oi Output data blocks. O2 through O13 may not be necessary depending on the
value P1.

Parameters:

P1 Input-integer-no default. Option selection described in the table that follows.

P2 through Input/output-integer/real-default/no default. Parametric data depending on P1.


P43

Remarks:
Each option corresponds to a different value of the first parameter, P1. The following summary table
provides descriptions of the options.

Summary of Options:

P1 Option Description

P1=1 Create mapping matrices.

P1=2 Create speed-dependent bearing matrices.

P1=3 Create speed-dependent speed ratio table.

Option P1 = 1
Create mapping matrices.

Format:

ROTSDB DIT,EQEXINS/
BEARXX,BEARXY,BEARYX,BEARYY,BEARXZ,BEARYZ,BEARZX,BEARZY,BEARZZ,
BEARRXX,BEARRXY,BEARRYX,BEARRYY/
1////GRIDA/GRIDB $

Input Data Blocks:

DIT Table of TABLEij bulk entry images.

EQEXINS Table between external and internal degree of freedom.

Output Data Blocks:

BEARXX Matrix mapping the bearing XX translational component into the system matrix.

BEARXY Matrix mapping the bearing XY translational component into the system matrix.

DMAP Programmer's Guide 11-111


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

BEARYX Matrix mapping the bearing YX translational component into the system matrix.

BEARYY Matrix mapping the bearing YY translational component into the system matrix.

BEARXZ Matrix mapping the bearing XZ translational component into the system matrix.

BEARYZ Matrix mapping the bearing YZ translational component into the system matrix.

BEARZX Matrix mapping the bearing ZX translational component into the system matrix.

BEARZY Matrix mapping the bearing ZY translational component into the system matrix.

BEARZZ Matrix mapping the bearing ZZ translational component into the system matrix.

BEARRXX Matrix mapping the bearing XX rotational component into the system matrix.

BEARRXY Matrix mapping the bearing XY rotational component into the system matrix.

BEARRYX Matrix mapping the bearing YX rotational component into the system matrix.

BEARRYY Matrix mapping the bearing YY rotational component into the system matrix.

Parameters:

GRIDA Input-integer-no default. Grid point identification number of bearing connection


point.

GRIDB Input-integer-no default. Grid point identification number of bearing connection


point.

Option P1 = 2

Create speed-dependent bearing matrices.

Format:

ROTSDB DIT,EQEXINS/
BEARS (or BEARD),,BEARSDF (or BEARDDF),,,,,,,,,,/
2/NUMRPM/BGNRPM/DELRPM/TXX/TXY/TYX/TYY/TXZ/TYZ/TZX/TZY/TZZ/
TRXX/TRXY/TRYX/TRYY/DFTYPE/RXX/RXY/RYX/RYY/RXZ/RYZ/RZX/RZY/RZZ/
RRXX/RRXY/RRYX/RRYY/NOMVAL1/NOMVAL2/NOMVAL3/C1R/C1Z/C2R/C2Z/C3R/C3Z/
D10/D20/D30 $

Input Data Blocks:

DIT Table of TABLEij bulk entry images.

EQEXINS Table between external and internal degree of freedom.

11-112 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Output Data Blocks:

BEARS Bearing stiffness values.

BEARD Bearing damping values.

BEARSDF Bearing displacement-dependent or force-dependent stiffness values.

BEARDDF Bearing displacement-dependent or force-dependent stiffness values.

Parameters:

NUMRPM Input-integer-no default. Number of steps for reference rotor speed.

BGNRPM Input-real-no default. Starting reference rotor speed.

DELRPM Input-real-no default. Step-size of reference rotor speed.

TXX Input-integer-no default. Table ID referenced by the PBEAR bulk entry for XX
translational component.

TXY Input-integer-no default. Table ID referenced by the PBEAR bulk entry for XY
translational component.

TYX Input-integer-no default. Table ID referenced by the PBEAR bulk entry for YX
translational component.

TYY Input-integer-no default. Table ID referenced by the PBEAR bulk entry for YY
translational component.

TXZ Input-integer-no default. Table ID referenced by the PBEAR bulk entry for XZ
translational component.

TYZ Input-integer-no default. Table ID referenced by the PBEAR bulk entry for YZ
translational component.

TZX Input-integer-no default. Table ID referenced by the PBEAR bulk entry for ZX
translational component.

TZY Input-integer-no default. Table ID referenced by the PBEAR bulk entry for ZY
translational component.

TZZ Input-integer-no default. Table ID referenced by the PBEAR bulk entry for ZZ
translational component.

TRXX Input-integer-no default. Table ID referenced by the PBEAR bulk entry for XX
rotational component.

TRXY Input-integer-no default. Table ID referenced by the PBEAR bulk entry for XY
rotational component.

DMAP Programmer's Guide 11-113


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

TRYX Input-integer-no default. Table ID referenced by the PBEAR bulk entry for YX
rotational component.

TRYY Input-integer-no default. Table ID referenced by the PBEAR bulk entry for YY
rotational component.

DFTYPE Input-integer-no default. Displacement or force dependency flag.

0 Not displacement- or force-dependent

1 Displacement-dependent

2 Force-dependent

RXX Input-real-no default. Direct value for bearing stiffness or damping for XX
translational component.

RXY Input-real-no default. Direct value for bearing stiffness or damping for XY
translational component.

RYX Input-real-no default. Direct value for bearing stiffness or damping for YX
translational component.

RYY Input-real-no default. Direct value for bearing stiffness or damping for YY
translational component.

RXZ Input-real-no default. Direct value for bearing stiffness or damping for XZ translational
component.

RYZ Input-real-no default. Direct value for bearing stiffness or damping for YZ translational
component.

RZX Input-real-no default. Direct value for bearing stiffness or damping for ZX translational
component.

RZY Input-real-no default. Direct value for bearing stiffness or damping for ZY translational
component.

RZZ Input-real-no default. Direct value for bearing stiffness or damping for ZZ translational
component.

RRXX Input-real-no default. Direct value for bearing stiffness or damping for XX rotational
component.

RRXY Input-real-no default. Direct value for bearing stiffness or damping for XY rotational
component.

RRYX Input-real-no default. Direct value for bearing stiffness or damping for YX rotational
component.

RRYY Input-real-no default. Direct value for bearing stiffness or damping for YY rotational
component.

11-114 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

NOMVAL1 Input-real-no default. NOMVAL entry from PBEAR bulk entry.

NOMVAL2 Input-real-no default. NOMVAL entry from PBEAR bulk entry.

NOMVAL3 Input-real-no default. NOMVAL entry from PBEAR bulk entry.

C1R Input-real-no default. Constant for composite equation from PBEAR bulk entry.

C1Z Input-real-no default. Constant for composite equation from PBEAR bulk entry.

C2R Input-real-no default. Constant for composite equation from PBEAR bulk entry.

C2Z Input-real-no default. Constant for composite equation from PBEAR bulk entry.

C3R Input-real-no default. Constant for composite equation from PBEAR bulk entry.

C3Z Input-real-no default. Constant for composite equation from PBEAR bulk entry.

D10 Input-real-no default. Preload value for composite equation from PBEAR bulk entry.

D20 Input-real-no default. Preload value for composite equation from PBEAR bulk entry.

D30 Input-real-no default. Preload value for composite equation from PBEAR bulk entry.

Option P1 = 3

Create speed-dependent speed ratio table.

Format:

ROTSDB DIT,/
TSPEEDR,,,,,,,,,,,,/
3/NUMRPM/BGNRPM/DELRPM/TABLEID//////////////RSPEED $

Input Data Blocks:

DIT Table of TABLEij bulk entry images.

Output Data Blocks:

TSPEEDR Result table containing speed-dependent speed ratios.

Parameters:

NUMRPM Input-integer-no default. Number of steps for reference rotor speed.

BGNRPM Input-real-no default. Starting reference rotor speed.

DELRPM Input-real-no default. Step-size of reference rotor speed.

DMAP Programmer's Guide 11-115


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

TABLEID Input-integer-no default. Identification number of the TABLED bulk entry that
defines the multiplier of the reference rotor speed for this rotor. TABLEID = 0
implies “use RSPEED”.

RSPEED Input-real-no default. Constant multiplier of the reference rotor speed for this rotor.
RSPEED = 0.0 implies “use TABLEID”.

11.46 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=SILS table
II4, 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

IOPT1=3 Edit a table


I1 = input table
I2, I3, I4, I5 are not used

IOPT1=4 Not used at this time.

IOPT1=5 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

11-116 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Output Data Blocks:

IOPT1=1 O1=whirl directions for each solution


O2 is not used

IOPT1=2 O1,O2 are not used

IOPT1=3 O1=modified table


O2 is not used

IOPT1=4 Not yet implemented.

IOPT1=5 O1,O2 are not used

Parameters:

IOPT1 Function controlling parameter (see above)

IOPT1=1 IOPT2, IOPT3, IOPT4 are not used


ROPT5=epsilon value for decision of whirl

IOPT1=2 IOPT2, IOPT3, IOPT5, ROPT5 are not used

IOPT1=3 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.

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

11.47 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 $

DMAP Programmer's Guide 11-117


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Input Data Blocks:

FRL Frequency response list

OUG2 Table of displacements in SORT1 format from transient response analysis

SPSEL 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

11.48 RSVECEL
Converts RVEL bulk entries into residual vectors.

Format:

RSVECEL ECT,GEOM4,BGPDT,CSTM,EPT/
RVELG/
NOGSET/OPTION $

Input Data Blocks:

ECT Element connectivity table

GEOM4 Table of bulk entry images related to constraints, degree-of-freedom membership,


and rigid element connectivity

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

11-118 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

EPT Table of bulk entry images related to element properties

Output Data Blocks:

RVELG Residual vectors for each entry in RVEL cards. Row size is the G-set and one
column for each vector

Parameters:

NOGSET Input-integer-no default. Size of g-set

OPTION Input-integer-default=0. Residual vector request option.


=0 No RVEL/DAMP
=1 RVEL only
=2 DAMP only
=3 RVEL and DAMP

11.49 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:

NROW Input/output-integer-default=1. Row number of element to be extracted from [A].


See Remark 4.

NCOL Input/output-integer-default=1. Column number of element. See Remark 4.

VALUED Output-complex double precision-default=(0.D0,0.D0). Contents of element at


NROW-th row and NCOL-th column in matrix [A].

DMAP Programmer's Guide 11-119


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 NROW (or NCOL) is greater than the number of rows (or columns) in A, NROW or (NCOL) 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) $

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 $

11.50 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 A single record (subcase) of CASECC for aerodynamic analysis

11-120 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

AECTRL Table of aerodynamic model‘s control definition

AERO Table of control information for aerodynamic analysis

CSTMA Table of aerodynamic coordinate system transformation matrices for g-set +


ks-set grid points

EDT Element deformation table. Contains aerodynamic model records.

AEDBUXV Matrix of vehicle states

AEMONPT Aerodynamic monitor points

MONITOR Structural monitor points

MPARV Rigid monitor point loads on aerodynamic model

MPAERV Elastic restrained monitor point loads on aerodynamic model

MPAEUV Elastic unrestrained monitor point loads on aerodynamic model

MPSRV Rigid splined monitor point loads on structural model

MPSERV Elastic restrained monitor point loads on structural model

MPSIRV Inertial restrained monitor point loads on structural model

MPSEUV Elastic unrestrained monitor point loads on structural model

MPSIUV Inertial unrestrained monitor point loads on structural model

UXTRIM UX vector at trim

AEDBINDX Aeroelastic database index for monitor point data

PRBDOFS Partitioning matrix to partition the "active" URDDI from the "inactive". Active URRDI
are assigned a 1.0 value and are connected to the SUPORT degrees-of-freedom.

Output Data Block:

STBDER Table of aerostatic stability derivatives for a single subcase

UXDIFV Derivative interpolation factors matrix at UX = UXREF

Parameters:

MACH Input-real-default=no default. Mach number.

Q Input-real-default=no default. Dynamic pressure.

AECONFIG Input-character-no default. Aerodynamic configuration.

DMAP Programmer's Guide 11-121


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

SYMXY Input-integer-no default. Aerodynamic x-y symmetry flag.

SYMXZ Input-integer-no default. Aerodynamic x-z symmetry flag.

LPRINT Input-logical-default=TRUE. Print flag for stability derivatives.

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.

11.51 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,RGPV,KOA/
UG,PGT,QG/
NSKIP/APP/NOQG $

Input Data Blocks:

USET Degree-of-freedom set membership table for g-set

PG Static load matrix applied to the g-set

UL Displacement matrix in l-set

UOO Displacement matrix in o-set due to applied loads on the o-set with the a-set
fixed (set to zero)

YS Matrix of enforced displacements or temperatures

GOA Omitted degree-of-freedom transformation matrix, o-set by a-set

GM Multipoint constraint transformation matrix, m-set by n-set

11-122 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

PS Static load matrix partitioned to the s-set

KFS Stiffness matrix partition (f-set by s-set) from KNN

KSS Stiffness matrix partition (s-set by s-set) from KNN

QR Matrix of determinate support forces

RGPV Sparse data recovery partitioning vector

KOA o-set and a-set matrix partition of stiffness matrix

Output Data Blocks:

UG Displacement matrix in the g-set appended for all boundary conditions

PGT Static load matrix applied to the g-set appended for all boundary conditions

QG Single-point constraint forces of constraint matrix in the g-set appended for all
boundary conditions

Parameters:

NSKIP Input-integer-no default. The first subcase of the current boundary condition.

APP Input-character-no default. Analysis type.


Allowable values:

‘STATICS’ Statics

‘REIG’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘CEIGEN’ Complex eigenvalues

‘MMREIG’ Normal modes for matrix method

‘BKL0’ Pre-buckling (statics)

‘BKL1’ Buckling

‘DYNAMIC’ Dynamics

NOQG Input-integer-default=0. Single point forces of constraint matrix creation flag.


Default of 1 requests computation of the forces. Specify -1 to request no
computation.

DMAP Programmer's Guide 11-123


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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, PS, and RGPV 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.

11. RGPV must be present for sparse data recovery.

11.52 SDR2
Creates output tables.
Creates tables based on output requests for forces of single-point and multipoint forces of
constraint, applied loads, displacements, velocities, accelerations, element stresses, element
strains, and element forces. These output tables are suitable for printing, plotting, and various other
postprocessing.

Format:

SDR2 CASECC,CSTM,MPT,DIT,EQEXIN,SILD,ETT,{OL or EDT},


BGPDT,PG,QG,UG,EST,XYCDB,OINT,PELSET,VIEWTB,GPSNT,DEQATN,DEQIND,
DITID,PCOMPT,GPKE,BOLTFOR,MDLIST,COMPEST,EPT,DYNAMIC,EDT,CBRROT/
OPG1,OQG1,OUG1,OES1,OEF1,PUG,OGPKE1,OEFIIP,OEFIIS,OESRIP,OESRIS/
APP/S,N,NOSORT2/NOCOMP/ACOUSTIC/METRIK/ISOFLG/GPF/ACOUT/PREFDB/
TABS/SIGMA/ADPTINDX/ADPTEXIT/BSKIP/FREQW/BTBRS/LANGLE/OMID/
SRCOMPS/APP1/GSPF/RPM/SWPANGLE/STFOPTN/RUNIT $

Input Data Blocks:

CASECC Table of Case Control command images.

CSTM Table of coordinate system transformation matrices.

MPT Table of Bulk Data entry images related to material properties.

11-124 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

DIT Table of TABLEij Bulk Data entry images.

EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
See Remark 5.

EQDYN Equivalence table between external and internal grid/scalar/extra point identification
numbers. (EQEXIN appended with extra point data.)

SILD Scalar index list for the p-set. See Remark 5.

ETT Element temperature table.

OL Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list.

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.

BGPDT Basic grid point definition table.

PG Static load matrix applied to the g-set.

QG Single-point (or multipoint-QMG) constraint forces of constraint matrix in the g-set.

UG Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG
can also represent velocity or acceleration.

EST Element summary table.

XYCDB Table of x-y plotting commands.

OINT P-element output control table. Contains OUTPUT Bulk Data entries.

PELSET P-element set table, contains SETS DEFINITIONS. Output by PLTSET.

VIEWTB View information table, contains the relationship between each p-element and its
view-elements and view-grids.

GPSNT Grid point shell normal table.

DEQATN Table of DEQATN Bulk Data entry images.

DEQIND Index table to DEQATN data block.

DITID Table of identification numbers in DIT.

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry.

GPKE Matrix of grid point kinetic energies.

BOLTFOR Bolt force data.

DMAP Programmer's Guide 11-125


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

MDLIST List of modes for output selected by effective mass fraction.

COMPEST Composite solid element summary table.

EPT Table of Bulk Data entry images related to element properties.

DYNAMIC Table of Bulk Data entry images related to dynamics.

EDT Table of Bulk Data entry images related to element deformation.

CBRROT CBEAR/rotor connection table. Required for CBEAR element forces in rotor
dynamic analysis.

Output Data Blocks:

OPG1 Table of applied loads in SORT1 format.

OQG1 Table of single or multipoint forces-of-constraint in SORT1 format.

OUG1 Table of displacements in SORT1 format.

OES1 Table of element stresses or strains in SORT1 format.

OEF1 Table of element forces in SORT1 format.

PUG Matrix of translational displacements for plotting purposes.

OGPKE1 Table of grid point kinetic energies in SORT1 format.

OEFIIP Data block for in-plane ply failure indices.

OEFIIS Data block for inter-laminar shear failure indices.

OESRIP Data block for in-plane ply strength ratios.

OESRIS Data block for inter-laminar shear strength ratios.

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

‘STATICS’ Statics

‘REIGEN’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘CEIGEN’ Complex eigenvalues

‘MMREIG’ Normal modes for matrix method

11-126 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

‘BKL0’ Pre-buckling (statics)

‘BKL1’ Buckling

‘NLST’ Nonlinear statics

‘GNST’ Geometric nonlinear statics

NOSORT2 Output-integer=default=0. SORT2 format flag. Set to 1 if SORT2 format is


requested or XYCDB is present; -1 otherwise.

NOCOMP Input-integer-default=-1. Composite stress/strain flag.

-5 Forces of composites in STRAIN=sid

-2 Forces of composites in STRESS=sid

-1 Stresses for all elements (same as 0 except in DMAP)

0 Stresses for all elements

1 Stresses for non-composites only

2 Strain/curvature and forces of composites in STRESS=sid

3 Strains for all elements and MPC forces

4 Strains for non-composites only

5 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

1 Penalty or fluid acoustic elements exists

2 Fluid/structure coupling exists

METRIK Input-integer-default=-1. Parameter for electromagnetic analysis.

ISOFLG Input-integer-default=-1. Parameter for electromagnetic analysis.

GPF Input-integer-default=-1. Parameter for electromagnetic analysis.

ACOUT Input-character-default=‘PEAK’ Type of acoustic pressure output in fluid-structural


analysis.

‘RMS’ Root-mean-square

‘PEAK’ Peak

DMAP Programmer's Guide 11-127


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

PREFDB Input-real-default=1.0. Peak pressure reference for pressure level in units of dB


or dBA.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying
temperatures in Fahrenheit.

SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute radiant


heat flux.

ADPTINDX Input-integer-default=-1. P-version analysis adaptivity index.

ADPTEXIT Output-logical-default=FALSE. Set to TRUE if this is the final.

BSKIP Input-logical-default=TRUE. Pre-buckling subcase skip flag. If TRUE, skip the first
subcase in CASECC.

FREQWA Input-real-default=0.0. Parameter for electromagnetic analysis.

BTBRS Input-real-default=0.0. Parameter for electromagnetic analysis.

LANGLE Input-integer-default=1. Large rotation calculation method:

1 Gimbal angle

2 Rotation vector

OMID Input-character-default=‘NO’. Material output coordinate system flag. If


OMID=‘YES’, stresses, strains, and forces are output in the material coordinate
system of CQUAD4, CTRIA3, CQUAD8, and CTRIA6 elements.

SRCOMPS Input-character-default=’NO’. Requests output of failure indices for composite solid


elements. If SRCOMPS=‘YES”, requests output of strength ratios for composite
solid elements.

APP1 Input-character-default=’ ’. Analysis type. Required only if APP = ‘MMREIG’ and


element force output is requested.

‘FREQRESP’ Frequency response.

‘TRANRESP’ Transient response.

GSPF Input-integer-default=1. PARAM,G inclusion in scalar element force calculation.

1 PARAM,G is included.

0 PARAM,G is not included.

RPM Input-real-default=0.0
Reference rotor speed in units of RUNIT on ROTORD bulk entry. Required for
CBEAR element forces in rotor dynamic analysis.

11-128 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SWPANGLE Input-real-default=1.0. Sweep angle increment in degrees for failure index and
strength ratio calculation.

STFOPTN Input-integer-default=1. Stiffness option


STFOPTN = 1 for elastic stiffness
STFOPTN = 2 for tangent stiffness

RUNIT Input-character-default=’RPM’. Rotor speed units. Options are ‘RPM’, ‘CPS’,


‘HZ’, and ‘RAD’.

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.

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.

11.53 SDR2CVM
Calculates von Mises results for complex solutions.

Format:

SDR2CVM OES2/OESVM2 $

Input Data Blocks:

OES2 Table of element stresses in SORT2 format

DMAP Programmer's Guide 11-129


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:

OESVM2 Table of element stresses including von Mises stress in SORT2 format

Parameters:

None

Remarks:
1. For strain results, OES2/OESVM2 are replaced with OSTR2/OSTRVM2, where OSTRVM2
includes von Mises strain.

11.54 SDR3
Converts tables in SORT1 (or SORT2) format to SORT2 (or SORT1) format

Format:

SDR3 OFP1,OFP2,OFP3,OFP4,OFP5,OFP6/
OFP1X,OFP2X,OFP3X,OFP4X,OFP5X,OFP6X $

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

11.55 SDRCOMP
Calculates laminar stresses
Calculates laminar stresses, or strains, and failure indices in composite elements.

11-130 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

SDRCOMP CASECC,MPT,EPT,ETT,EST,OES1A,OEF1A,DIT,BGPDT,PCOMPT/
OES1C,OEFIT,OEF1AA,OESRT,OGPLYSS,OGPLYFI,OGPSR/
STRNFLG/DESOPT/LOADFAC/SRCOMPS/SWPANGLE $

Input Data Blocks:

CASECC Table of Case Control command images

MPT Table of Bulk Data entry images related to material properties

EPT Table of Bulk Data entry images related to element properties

ETT Element temperature table

EST Element summary table

OES1A Table of element strain/curvatures in SORT1 format for the composite elements
only

OEF1A Table of element forces in SORT1 format for the composite elements only

DIT Table of TABLEij Bulk Data entry images

BGPDT Basic grid point definition table

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

Output Data Blocks:

OES1C Table of composite element stresses or strains in SORT1 format

OEFIT Table of composite element failure indices

OEF1AA Table of element forces in SORT1 format for the non-composite elements only

OESRT Table of composite element strength ratios

OGPLYSS Table of global ply stresses/strains.

OGPLYFI Table of global ply failure indices.

OGPSR Table of global ply strength ratios.

Parameters:

LSTRN Input-integer-default=0. Laminar strain flag.

0 Compute laminar stresses

DMAP Programmer's Guide 11-131


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

1 Compute laminar strains

DESOPT 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.

LOADFACR Input-real-default=0.0. Load factor in nonlinear static analysis.

SRCOMPS Input-character-default='NO' Flag to request output table of ply strength ratios


(OESRT).

SWPANGLE Input-real-default=1.0. Sweep angle increment in degrees for failure index and
strength ratio calculation.

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.

11.56 SDREE
Data recovery for Element Energy
Scans through all of the elemental energy values and applies the user tolerance value, culling out
any element data which doesn’t meet the criterion. The elements which pass the tolerance are
written to the output table.

Format:

SDREE OEEI,EFILL/OEEO/XFLAG

Input Data Blocks:

OEEI Input Element Energy data block.

EFILL Table of scaling factors for each element. Only those elements present in the
EFILL table will be output.

Output Data Blocks:

OEEO Output Element Energy data block containing only the elements that meet the
user criteria.

11-132 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

XFLAG Input-integer-default=0. Cull method.

0 Cull elements based on user criterion.

1 Do not cull, perform a simple copy from OEEI to OEEO.

11.57 SDRHT
Combines heat flow for CHBDYi elements with heat flux of other elements

Format:

SDRHT UG,OEF1,SLT,EST,DIT,RDEST,RECM,DLT,
OEFNL1,MPT,BGPDT,CSTM,SIL,USET,CASECC/
HOEF1/
TABS/SIGMA/NORADMAT $

Input Data Blocks:

UG Temperature matrix in g-set

OEF1 Table of element fluxes in SORT1 format

SLT Table of static loads

EST Element summary table

DIT Table of TABLEij Bulk Data entry images

RDEST Radiation element summary table

RECM Radiation exchange coefficient matrix

DLT Table of dynamic loads

OEFNL1 Table of nonlinear element fluxes in SORT1 format

MPT Table of Bulk Data entry images related to material properties

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

SIL Scalar index list

USET Degree-of-freedom set membership table for g-set

CASECC Table of Case Control command images

DMAP Programmer's Guide 11-133


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

SIGMA Input-real-default=0.0. The Stefan-Boltzmann constant. Used to compute


radiant heat flux.

NORADMAT Input-integer-default=-1. Radiation flag.

-2 No radiation

-1 Initial radiation (default)

1 Single band radiation with constant emissivity

2 Radiation with temperature dependent emissivity

3 Multiple band radiation with constant emissivity

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.

11.58 SDRNL
Performs stress data recovery for nonlinear elements

Format:

SDRNL CASECC,ESTNL,ELDATA,UNUSED4,UNUSED5,UNUSED6,UNUSED7,
CSTM,UGNI,BGPDT/
OESNL1,OESNLB1,UNUSED3/
NLTYPE/UNUSED2/UNUSED3/NSKIP/LINC/UNUSED6/UNUSED7/
UNUSED8 $

Input Data Blocks:

CASECC Table of Case Control command images

11-134 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

ESTNL Nonlinear element summary table

ELDATA Table of combined nonlinear information data

UNUSED4 Unused and can be purged

UNUSED5 Unused and can be purged

UNUSED6 Unused and can be purged

UNUSED7 Unused and can be purged

CSTM Table of coordinate system transformation matrices

UGNI Displacement matrix at converged step in the g-set

BGPDT Basic grid point definition table

Output Data Blocks:

OESNL1 Table of nonlinear element stresses in SORT1 format

OESNLB1 Table of slideline contact element stresses in SORT1 format

UNUSED3 Unused and can be purged

Parameters:

NLTYPE Input-integer-no default. Nonlinear analysis type.

0 Statics

1 Transient response

UNUSED2 Input-integer-no default. Unused.

UNUSED3 Input-integer-no default. Unused.

NSKIP Input-integer-no default. Subcase record number to read in CASECC.

LINC Input-integer-no default. Number of load increments for this subcase

UNUSED6 Input-integer-default=0.0. Unused.

UNUSED7 Input-integer-default=0.0. Unused.

UNUSED8 Input-integer-default=0.0. Unused.

11.59 SDRP
Computes data for p-elements

DMAP Programmer's Guide 11-135


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Table of Case Control command images

EST Element summary table

VIEWTB View information table. Contains the relationship between each p-element and its
view-elements and view-grids.

UG Displacement matrix in g-set. For the DSVG1 module and transient analysis, UG
can also represent velocity or acceleration.

OUG1 Table of displacements in SORT1 format

OES1 Table of element stresses in SORT1 format

OSTR1 Table of element strains in SORT1 format

OEF1 Table of element forces in SORT1 format.

DEQATN Table of DEQATN Bulk Data entry images

DEQIND Index table to DEQATN data block

DIT Table of TABLEij Bulk Data entry images

MPT Table of Bulk Data entry images related to material properties

CSTM Table of coordinate system transformation matrices

ETT Element temperature table

OINT p-element output control table. Contains OUTPUT Bulk Data entries.

PELSET p-element set table. Contains SETS DEFINITIONS.

BGPDT Basic grid point definition table

OL Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list

11-136 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

GPSNT Grid point shell normal table

ERROR1 Error-estimate table updated for current superelement or adaptivity loop

RSQUERY Table of results state query

Output Data Blocks:

OUG1VU Table of displacements in SORT1 format for view grids

OES1VU Table of element stresses in SORT1 format for view elements

OSTR1VU Table of element strains in SORT1 format for view elements

OEF1VU Table of element forces in SORT1 format for view elements

STATDATA Table of state information when system cell 297=1

RSTLSTAT Table of result-state information when system cell 297=2

RSLTDATA Table of actual results data when system cell 297=3

GLBTAB Table of global responses when system cell 297=-1

GLBRSP Matrix of global responses when system cell 297=-1

Parameters:

ADPTEXIT Input-logical-no default. Set to TRUE if this is the final adaptivity loop.

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

APP Input-character-no default. Analysis type. Allowable values:

‘STATICS’ Statics

‘REIGEN’ Normal modes

‘FREQ’ Frequency response

‘TRANSNT’ Transient response

‘CEIGEN’ Complex eigenvalues

SDRPOPT Input-character-no default. Principal stress/strain computation selection:

‘SDRP’ Compute in SDRP

‘OFP’ Compute in OFP

DMAP Programmer's Guide 11-137


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

PVALID Input-integer-no default. p-value set identification number.

DESCYCLE Input-integer-no default. Design cycle analysis counter.

ADPTINDX Input-integer-no default. p-version analysis adaptivity index.

ODESMAX Input-integer-no default. Total number of design cycles performed.

OADPMAX Input-integer-no default. Total number of adaptivity cycles performed.

SEID Input-integer-no default. Superelement identification number.

Remarks:

1 If disk space is critical, SDRPOPT can set to ‘OFP’to delay computation of principal stresses
and strains to the OFP module.

2 The scope of SDRP processing depends on the value system cell 297:

0 Traditional NASTRAN data recovery

1,2,3 On-the-fly data recovery

-1 Global Response (that is, find the minimum/maximum values of certain data recovery
quantities)

11.60 SDRX
Modifies CBAR, CBEAM and CBEND element results
Modifies CBAR, CBEAM and CBEND element forces, stresses, and strains due to CBARAO and
PLOAD1 Bulk Data entries. Also computes intermediate station output. Applicable to static and
normal modes analysis only.

Format:

SDRX CASECC,OEF1,OES1,GEOM2,GEOM3,EST,CSTM,MPT,DIT,BGPDT,
OSTR1/
OEF1X,OES1X,OSTR1X/
S,N,NOXOUT/ICAM $

Input Data Blocks:

CASECC Table of Case Control command images

OEF1 Table of element forces in SORT1 format

OES1 Table of element stresses in SORT1 format

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

11-138 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

GEOM3 Table of Bulk Data entry images related to static and thermal loads

EST Element summary table

CSTM Table of coordinate system transformation matrices

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

BGPDT Basic grid point definition table

OSTR1 Table of element strains in SORT1 format

Output Data Blocks:

OEF1X Table of displacements in SORT1 format for view grids

OES1X Table of element stresses in SORT1 format updated for PLOAD1 loads and
intermediate station output

OSTR1X Table of element strains in SORT1 format augmented with strains for 1-D elements

Parameter:

NOXOUT Output-integer-no default. SDRX update flag.

0 OEF1X, OES1X, and OSTR1X are updated

-1 OEF1X, OES1X, and OSTR1X are not updated

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 $

11.61 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.

DMAP Programmer's Guide 11-139


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Table of Case Control command images

OEF1 Table of element forces in SORT1 format

OES1 Table of element stresses in SORT1 format

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

EST Element summary table

CSTM Table of coordinate system transformation matrices

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

UG Displacement matrix in g-set

DLT Table of dynamic loads

OL Transient response time output list or frequency response frequency output list

BGPDT Basic grid point definition table

OSTR1 Table of element strains in SORT1 format

Output Data Blocks:

OEF1X Table of displacements in SORT1 format for view grids

OES1X Table of element stresses in SORT1 format updated for PLOAD1 loads and
intermediate station output

OSTR1X Table of element strains in SORT1 format augmented with strains for 1-D elements

Parameters:

NOXOUT Output-integer-no default. SDRX update flag.

0 OEF1X, OES1X, and OSTR1X are updated

11-140 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

-1 OEF1X, OES1X, and OSTR1X are not updated

APP Input-character-no default. Analysis type. Allowable values:

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

COUPMASS Input-integer-default=-1. Coupled mass generation flag.

-1 Lumped

0 Coupled

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 $

11.62 SDSA
Partitions design model to superelements

Partitions the design model (that is, the design optimization Bulk Data entries) to superelements.

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 Table of Bulk Data entries related to design sensitivity and optimization

EPTS Table of Bulk Data entry images related to element properties for the superelement
specified by SEID

EQEXINS Equivalence table between external and internal grid/scalar identification numbers
for the superelement specified by SEID

SEMAP Superelement map table

MPTS Table of Bulk Data entry images related to material properties for the current
superelement

DMAP Programmer's Guide 11-141


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Block:

EDOMS Table of Bulk Data entries related to design sensitivity and optimization for the
superelement specified by SEID

Parameters:

SEID Input-integer-default=0. Superelement identification number.

PEID Input-integer-default=0. Primary superelement identification number.

OBJSID Output-integer-default=-1. Superelement identification number associated with


DESOBJ. Set to -1 for all cases unless you specify the DESOBJ command in a
particular superelement subcase.

DESOBJ Input-integer-default=0. DESOBJ Case Control command set identification


number.

DESVAR Output-integer-default=0. Retained DVPRELi or DVGRID entry flag for


superelement SEID. Set to -1 if there are retained design variable perturbations.

DRESP Output-integer-default=0. Retained DRESP1 entry flag for superelement SEID.


Set to -1 if there are retained design responses.

TWGTFL Output-integer-default=0. Total weight flag.

TVOLFL Output-integer-default=0. Total volume flag.

Remarks:

SDSA is intended to be executed in a superelement DMAP loop driven by SEP2DR. See subDMAP
DESINIT for an example.

11.63 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 Table of Case Control command images

11-142 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SLIST Superelement processing list to matrix generation, assembly, and reduction

EDOM* Family of EDOM tables for all superelements

unused4 Unused and can be purged

unused5 Unused and can be purged

Output Data Block:

DSLIST Superelement processing list to direct the pseudo-load and response sensitivity
calculations

Parameters:

DMRESD Output-integer-default=-1. Design model flag. If set to -1, the design model is
limited to the residual structure.

NOSEDV Output-integer-default=0. Pseudo-load generation flag based on the SEDV


Case Control command. Set to -1 if pseudo-loads are not requested for any
superelement.

NOSERESP Output-integer-default=0. Response sensitivity calculation flag based on the


SERESP Case Control command. Set to -1 if response sensitivities are not
requested for any superelement.

Example:

Excerpt from subDMAP DESINIT:


DBVIEW EDOMF=EDOMS WHERE (wildcard) $
IF ( NOT(RSONLY) AND NOEDOM>0
) SDSB SLIST,EDOMF,CASEXX,,/DSLIST/S,N,DMRESD/
S,N,NOSEDV/S,N,NOSERESP $

11.64 SDSC
Prints correlation table for normalized design sensitivity coefficient matrix

Format:

SDSC DSCMCOL//
OBJSID/DESOBJ/UNUSED3/EIGNFREQ $

Input Data Block:

DSCMCOL Correlation table for normalized design sensitivity coefficient matrix

DMAP Programmer's Guide 11-143


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

DESOBJ Input-integer-default=0. DESOBJ Case Control command set identification


number.

UNUSED3 Input-integer-default=1. Unused.

EIGNFREQ Input-integer-default=0. Eigenvalue/frequency response type flag.

1 Eigenvalue (radian/time)

2 Frequency (cycle/time)

11.65 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/
GEOM1N,GEOM2N,GEOM3N $

Input Data Blocks:

BGPDT Basic grid point definition table

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

Output Data Blocks:

GEOM1N Modified GEOM1 with CORD1j records converted to CORD2j records

11-144 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

GEOM2N Modified GEOM2 with GO replaced by X1, X2, and X3 on CBAR, CBEAM,
CBEND, CBUSH and CGAP records

GEOM3N Modified GEOM3 with FORCEi and MOMENTi records converted to FORCE
and MOMENT records

Parameters:

None.

Remarks:

System cell 350 controls execution of the SECONVRT module.

-1 No converson

0 Convert and echo all converted entries in the f06

>0 Convert and echo the first n converted entries in the f06 where n is the value of system
cell 350

11.66 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 $

Input Data Blocks:

SEMAP Superelement map table

CASECC Table of Case Control command images

PCDB Table of model (undeformed and deformed) plotting commands

DRLIST Superelement processing list for data recovery

XYCDB Table of x-y plotting commands

SLT Table of static loads

ETT Element temperature table

DMAP Programmer's Guide 11-145


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

MAPS* Family of MAPS (superelement upstream to downstream boundary coordinate


system, secondary (mirror, identical, and repeated), and release transformation
matrix)

UGD Displacement matrix in g-set for the downstream superelement

BGPDT Basic grid point definition table

GDNTAB Table of grid points generated for p-element analysis

Output Data Blocks:

UA Solution matrix on the boundary (a-set) of the superelement (identification number


equal to output value of SEID)

CASEDR Table of Case Control command images for the superelement (identification
number equal to output value of SEID)

PCDBDR Table of model (undeformed and deformed) plotting commands for the
superelement (identification number equal to output value of SEID)

XYCDBDR Table of x-y plotting commands for a superelement (identification number equal to
output value of SEID)

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

‘STATICS’ Statics

≠‘STATICS’ Not statics

SEID Input-integer-default=0. Superelement identification number.

NOUP Output-integer-default=0. Upstream superelement flag. Set to -1 if there are no


superelements connected upstream from the current superelement.

NOSORT1 Output-integer-default=0. SORT1 format flag. Set to -1 if SORT1 format is not


requested for current superelement.

NOUG Output-integer-default=0. UG presence flag. Set to -1 if UG already exists for the


current superelement.

NOOUT Output-integer-default=0. Output request flag. Set to -1 if no output requests are


specified for the current superelement.

NOPLOT Output-integer-default=0. Plot request flag. Set to -1 if no deformed plot requests


are specified for the current superelement.

NOXYPLOT Output-integer-default=0. X-Y plot request flag. Set to -1 if no x-y plot requests
are specified for the current superelement.

11-146 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS.

NCUL Input-integer-no default. Number of columns desired in the solution matrix for the
residual structure. Usually determined by the PARAML module.

11.67 SEDRDR
Drives superelement data recovery loop

Format:

SEDRDR DRLIST,SEMAP//
S,N,LASTSE/S,N,SEID/S,N,PEID/S,N,SEDWN/S,N,NODR/
NOSE/S,N,SETYPE/S,N,RSEID/S,N,SCNDRY/S,N,EXTRN/
SEDRCNTL/NOPGHD $

Input Data Blocks:

DRLIST Superelement processing list for data recovery

SEMAP Superelement map table

Output Data Blocks:

None.

Parameters:

LASTSE Output-integer-default=0. Last superelement flag. Set to -1 if the current


superelement is the last to process.

SEID Input/output-integer-default=0. Superelement identification number and


initialization flag.

On input:

-1 Initialization

-2 Same as -1 except do not print UIM 7321

≥0 Previous superelement identification number

On output:

≥0 Current superelement identification number

PEID Output-integer-default=0. Primary superelement identification number.

SEDWN Output-integer-default=0. Downstream superelement identification number.

DMAP Programmer's Guide 11-147


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

NODR Output-integer-default=0. Data recovery request flag. Set to -1 if there is no data


recovery requested for any superelement.

NOSE Input-integer-default=0. Superelement presence flag. Set to -1 if there are no


superelements.

SETYPE Output-character-default=’ ’ Superelement type as specified on the SEBULK


Bulk Data entry.

‘REPEAT’ Repeated

‘MIRROR’ Mirror

‘COLLTR’ Collector

‘EXTRNA’ External

‘PRIMARY’ Primary

RSEID Output-integer-default=0. Repeated superelement identification number as


specified on the SEBULK Bulk Data entry.

SCNDRY Output-integer-default=0. Secondary (identical or mirror) superelement flag. Set


to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0.

EXTRN Output-integer-default=0. External superelement flag. Set to -1 if superelement


is defined by the CSUPER Bulk Data entry with PEID=0.

SEDRCNTL Input-character-default=’ ’ Processing list selection.

’‘ All superelements are processed (default).

‘CURR‘ Only the superelements specified by the SEID parameter are


processed.

NOPGHD Input-integer-default=0. Page header superelement label print control.

0 Print page header and UIM 7321.

-1 Do not print page header and UIM 7321.

-2 Same as -1 and do not print .f04 label.

-3 Same as -2 and do not print superelement label in SUBTITLE


line of page header.

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.

11-148 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 $

11.68 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 Static load matrix for the g-set of the current superelement and applied to its
interior points only

SLIST Superelement processing list to matrix generation, assembly, and reduction

SEMAP Superelement map table

BGPDTS Basic grid point definition table for the current superelement

PA* Family of static load matrices (PA) applied on the boundary (a-set) of all
upstream superelements

MAPS* Family of MAPS (superelement upstream to downstream boundary coordinate


system, secondary (mirror, identical, and repeated), and release transformation
matrix)

GDNTAB Table of grid points generated for p-element analysis

DMAP Programmer's Guide 11-149


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Block:

PG Static load matrix for the g-set of the current superelement including loads from
upstream superelements

Parameters:

SEID Input-integer-default=0. Superelement identification number.

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS


and PA.

LDSEQ Input/output-integer-default=0. PG column number. On input, last column


number of PG on previous SELA execution. On output, last column number
of PG on current execution.

NOPG Output-integer-default=0. Upstream load presence flag. Set to -1 if there are no


loads due to upstream superelements.

PRTUIM Input-logical-default=TRUE. UIM 4570 print control flag in SELA module.

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 $

11.69 SEMA
Assembles square symmetric matrices from upstream superelements
Assembles square symmetric matrices (for example, stiffness, mass, damping) from upstream
superelements into the current superelement.

Format:

SEMA BGPDTS,SLIST,SEMAP,XJJ,XAA*,MAPS*,GDNTAB/
XGG/
SEID/LUSETS/QUALNAM/UPFM $

Input Data Blocks:

BGPDTS Basic grid point definition table for the current superelement

SLIST Superelement processing list to matrix generation, assembly, and reduction

11-150 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SEMAP Superelement map table

XJJ Square matrix for the g-set of the current superelement and applied to its
interior points only

XAA* Family of reduced square matrices in a-set pertaining to the upstream


superelements

MAPS* Family of MAPS (superelement upstream to downstream boundary coordinate


system, secondary (mirror, identical, and repeated), and release transformation
matrix)

GDNTAB Table of grid points generated for p-element analysis

Output Data Block:

XGG Square matrix in g-set including contributions from upstream superelements.

Parameters:

SEID Input-integer-default=0. Superelement identification number.

LUSETS Input-integer-default=0. The number of degrees-of-freedom in the g-set of the


current superelement.

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting MAPS


and PA.

UPFM Input-integer-default=0. UFM 4252 print flag. Set to -1 to print UFM 4252 and
set NOGO=-1 if there are missing upstream boundary matrices.

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) $
DBVIEW MAPUP = MAPS WHERE (SEID=* AND PEID=*) $
SEMA BGPDTS,SLIST,SEMAP,KJJ,KAAUP,MAPUP,GDNTAB/
KGG/
SEID/LUSETS/‘SEID‘/-1 $
IF ( NOGO=-1 ) EXIT $

11.70 SEP1
Constructs superelement map table

DMAP Programmer's Guide 11-151


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

SEP1 GEOM1,GEOM2,GEOM4,EQEXIN,BGPDT,CSTM,CASECC,SETREE/
SEMAP/
S,N,NOSE/CONFAC/LST2REC/AUTOSEEL $

Input Data Blocks:

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

CASECC Table of Case Control command images

SETREE Superelement tree table usually input via the DTI,SETREE Bulk Data entry

Output Data Block:

SEMAP Superelement map table

Parameters:

NOSE Output-integer=default=0. Superelement presence flag. Set to -1 if there are


no superelements.

CONFAC Input-integer-default=1.E-5. Image superelement congruence tolerance for the


location of boundary grid points and displacement coordinate systems.

LST2REC Input-integer-default=TRUE. Last two records write flag. Set to TRUE to write
last two records.

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

11-152 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

a more recently developed module intended for superelements defined in separate Bulk Data
sections; that is, partitioned superelements.

11.71 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 Table containing the list of partitioned superelements defined in separate Bulk
Data sections

GEOM1* Family of GEOM1 tables for all partitioned superelements defined in separate
Bulk Data sections

GEOM2* Family of GEOM2 tables for all partitioned superelements defined in separate
Bulk Data sections

GEOM4* Family of GEOM4 tables for all partitioned superelements defined in separate
Bulk Data sections

SETREE Superelement tree table usually input via the DTI,SETREE Bulk Data entry

SGPDTS* Family of SGPDTS tables created in previous runs

BNDFIL Table containing the local and global boundary grids in the order given by extreme
for domain decomposition

Output Data Blocks:

SEMAP Superelement map table

SGPDT Global superelement basic grid point definition table including RSSCON grid
point location corrections

SCSTM Table of global transformation matrices for partitioned superelements

DMAP Programmer's Guide 11-153


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Parameters:

NOSE Output-integer=default=0. Superelement presence flag. Set to -1 if there are no


superelements. Set to number of superelements if superelements exist.

CONFAC Input-integer-default=1.E-5. Image superelement congruence tolerance for the


location of boundary grid points and displacement coordinate systems.

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting GEOM1,


GEOM2, GEOM4, and SGPDT.

QUALVAL Input-integer-default=-1. QUALNAM value assigned to the main Bulk Data section.

RSFLAG Output-logical-default=FALSE. Main Bulk Data superelement presence flag. Set


to TRUE if superelements are defined in the main Bulk Data section.

NQSET Input-integer-default=0. Number of automatic q-set degrees-of-freedom


(auto-q-set). Each superelement has NQSET number of q-set degrees-of-freedom.

EXTNAME Input-character-default=‘XEID’ Name of the qualifier used to identify External


Superelements. Note linkage to the SEBULK data entry.

SEP1XOVR Input-integer-default=0. Override bits for module processing.

Bit(s) Value(s) Description

1-3 1-5 Override Search Algorithm Selection

4 8 Disable Automatic Main Bulk Scalar Linkages via


internal SECONCT entries

5 16 Print RSSCON old/new locations

6 32 Print Boundary Search Sequence

7 64 SEP1X "Diag 30" Debugging Output

8 128 Auto-SET in Residual place in OSET when other sets


present in the Residual

NQMAX Input-integer-default=3000. Maximum number of auto-q-set‘s allowed per


partitioned superelement. See NQSET.

SEBULK Input-logical-default=FALSE. Partitioned superelement presence flag. Set to


TRUE if partitioned superelements are present or BEGIN SUPER is specified for
the first BEGIN BULK Case Control command. If TRUE, superelement processing
is performed. Otherwise, only the RSSCON element corrections are performed.

TOLRSC Input-real-default=1.0E-4. RSSCON element alignment tolerance factor.

Examples:

1. Excerpt from subDMAP PHASE0:

11-154 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

DBVIEW GEOM1F=GEOM1QS WHERE ( PEID<>0 ) $


DBVIEW GEOM2F=GEOM2S WHERE ( PEID<>0 ) $
DBVIEW GEOM4F=GEOM4QS WHERE ( PEID<>0 ) $
DBVIEW SGPDTF=SGPDTS WHERE ( PEID<>0 ) $
SEP1X 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 $

11.72 SEP2
Partitions tables for each superelement

Format:

SEP2 GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,
SLIST,SEMAP,CASES,DYNAMIC,GPSNT/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,UNUSED8,UNUSED9,DYNAMICS,GPSNTS/
SEID/METHCMRS/DMAPNO/AUTOMPC $

Input Data Blocks:

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar
points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EPT Table of Bulk Data entry images related to element properties

MPT Table of Bulk Data entry images related to material properties.

SLIST Superelement processing list to matrix generation, assembly, and reduction

SEMAP Superelement map table

CASES Table of Case Control commands for the current superelement

DYNAMIC Table of Bulk Data entry images related to dynamics

GPSNT Grid point shell normal table

DMAP Programmer's Guide 11-155


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:

GEOM1S Table of Bulk Data entry images related to geometry for the current
superelement

GEOM2S Table of Bulk Data entry images related to element connectivity and scalar
points for the current superelement

GEOM3S Table of Bulk Data entry images related to static and thermal loads for the
current superelement

GEOM4S Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity for the current superelement

EPTS Table of Bulk Data entry images related to element properties for the current
superelement

MPTS Table of Bulk Data entry images related to material properties for the current
superelement

MAPS Superelement boundary transformation matrix for secondary superelements


(mirror, identical, and repeated), boundary resequencing and releases

UNUSED8 Unused and can be purged

UNUSED9 Unused and can be purged

DYNAMICS Table of Bulk Data entry images related to dynamics for the current
superelement

GPSNTS Grid point shell normal table for the current superelement

Parameters:

SEID Input-integer-default=0. Superelement identification number.

METHCMRS Input-integer-default=0. Residual structure METHOD set identification (SID)


override. METHCMRS>0 overrides SID value specified in CASES.

DMAPNO Integer-input-default=0. Solution sequence number stored in word 244 of the


case control record.

AUTOMPC Input-character-default=no. Specifies that the software automatically select the


m-set dofs rather than use the m-set values as specified on MPC or RIGID
element cards. See the AUTOMPC parameter in the Quick Reference Guide
for details.

11.73 SEP2CT
Partitions Case Control and Plot Control tables for each superelement

11-156 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:
SLIST,CASECC,PCDB,UNUSED4,XYCDB/
SEP2CT CASES,PCDBS,XYCDBS/
APP/SEID $

Input Data Blocks:

SLIST Superelement processing list to matrix generation, assembly, and reduction

CASECC Table of Case Control command images

PCDB Table of model (undeformed and deformed) plotting commands

UNUSED4 Unused and can be purged

XYCDB Table of x-y plotting commands

Output Data Blocks:

CASES Table of Case Control command images for the current superelement
(identification number equal to output value of SEID)

PCDBS Table of model (undeformed and deformed) plotting commands for the current
superelement (identification number equal to output value of SEID)

XYCDBS Table of x-y plotting commands for the current superelement (identification number
equal to output value of SEID)

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

‘STATICS’ Statics

≠‘STATICS’ Not statics

SEID Input-integer-default=0. Superelement identification number.

11.74 SEP2DR
Drives superelement generation, assembly, and reduction loop
Drives the superelement generation, assembly, and reduction loop. Also drives the pseudo-load
generation loop.

DMAP Programmer's Guide 11-157


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

SEP2DR

Input Data Blocks:

SLIST Superelement processing list to matrix generation, assembly, and reduction

DSLIST Superelement processing list to direct the pseudo-load and response sensitivity
calculations

SEMAP Superelement map table

Output Data Blocks:

None.

Parameters:

SEID Input/output-integer-default=0. Superelement identification number and


initialization flag.

On input:

-1 Initialization

-2 Same as -1 except do not print UIM 7321

≥0 Previous superelement identification number

On output:

≥0 Current superelement identification number

PEID Output-integer-default=0. Primary superelement identification number.

SEDWN Output-integer-default=0. Downstream superelement identification number.

LASTSE Output-integer-default=0. Last superelement flag. Set to -1 if the current


superelement is the last to process.

11-158 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

NOMAT Output-integer-default=0. Matrix generation flag. Set to -1 if no matrix generation


is requested for the current superelement based on the SEMG or SEALL Case
Control commands.

NOASM Output-integer-default=0. Matrix assembly flag. Set to -1 if no matrix assembly


and reduction is requested for the current superelement based on the SEKR
or SEALL Case Control commands.

NOLOAD Output-integer-default=0. Load generation flag. Set to -1 if no load generation


is requested for the current superelement based on the SELG or SEALL Case
Control commands.

NOLASM Output-integer-default=0. Load assembly flag. Set to -1 if no load assembly and


reduction is requested for the current superelement based on the SELR or SEALL
Case Control commands.

NOUP Output-integer-default=0. Upstream superelement flag. Set to -1 if there are no


superelements connected upstream from the current superelement.

SCNDRY Output-integer-default=0. Secondary (identical or mirror) superelement flag. Set


to -1 if superelement is defined by the CSUPER Bulk Data entry with PEID>0.

EXTRN Output-integer-default=0. External superelement flag. Set to -1 if superelement is


defined by the CSUPER Bulk Data entry with PEID=0.

NOMR Output-integer-default=0. Mass and damping assembly flag. Set to -1 if no mass


and damping assembly and reduction is requested for the current superelement
based on the SEMR or SEALL Case Control commands.

SEP2CNTL Input-character-default=‘SLIST’ Processing list selection.

‘ALL’ All superelements are processed.

‘PSLGDV’ Only superelements specified on the SEDV Case Control


commands

‘DSLIST’ Only superelements specified on the SERESP Case Control


commands

‘SLIST’ Only superelements specified on the SEALL, SEMG, SEKR,


SELG, SELR, or SEMR Case Control commands

‘SEDWN’ All superelements that have SEDWN as their downstream


superelement

‘CURR’ Only the superelement specified by SEID parameter is processed

NOPSLG Output-integer-default=0. Pseudo-load generation flag. Set to -1 if no load


generation is requested for the current superelement based on the SEDV or
SERESP Case Control commands.

NOPGHD Input-integer-default=0. Page header and eject flag.

DMAP Programmer's Guide 11-159


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

0 Print page header in f06 and label in f04.

-1 Do not print page header in f06.

-2 Do not print page header in f06 and label in f04

PARTSE Output-logical-default=FALSE. Partitioned superelement flag. Set to TRUE if the


current superelement is a partitioned superelement.

SETYPE Output-character-default=’ ’ Superelement type as specified on the SEBULK


Bulk Data entry.

‘REPEAT’ Repeated

‘MIRROR’ Mirror

‘COLLTR’ Collector

‘EXTRNA’ External

‘PRIMARY’ Primary

RSEID Output-integer-default=0. Repeated superelement identification number as


specified on the SEBULK Bulk Data entry.

NSENQSET Output-integer-default=0. Number of SENQSET degrees-of-freedom allocated


to the current superelement.

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 $

11-160 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

11.75 SEP2X
Partitions tables for each superelement

Format:

SEP2X GEOM1,GEOM2,GEOM3,GEOM4,EPT,MPT,SLIST,SEMAP,CASES,
DYNAMIC,UNUSED11,SGPDT,SCSTM,MATPOOL/
GEOM1S,GEOM2S,GEOM3S,GEOM4S,EPTS,MPTS,
MAPS,SGPDTS,UNUSED9,DYNAMICS,MATPOOLS,UNUSED12/
SEID/METHCMRS/DMAPNO/AUTOMPC $

Input Data Blocks:

GEOM1 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM3 Table of Bulk Data entry images related to static and thermal loads

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity

EPT Table of Bulk Data entry images related to element properties

MPT Table of Bulk Data entry images related to material properties

SLIST Superelement processing list to matrix generation, assembly, and reduction

SEMAP Superelement map table

CASES Table of Case Control commands for the current superelement

DYNAMIC Table of Bulk Data entry images related to dynamics

UNUSED11 Unused and can be purged

SGPDT Superelement basic grid point definition table

SCSTM Table of global transformation matrices for partitioned superelements

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entrie

Output Data Blocks:

GEOM1S Table of Bulk Data entry images related to geometry for the current superelement

GEOM2S Table of Bulk Data entry images related to element connectivity and scalar points
for the current superelement

GEOM3S Table of Bulk Data entry images related to static and thermal loads for the current
superelement

DMAP Programmer's Guide 11-161


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

GEOM4S Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity for the current superelement

EPTS Table of Bulk Data entry images related to element properties for the current
superelement

MPTS Table of Bulk Data entry images related to material properties for the current
superelement

MAPS Superelement boundary transformation matrix for secondary superelements


(mirror, identical, and repeated), boundary resequencing and releases

SGPDTS Superelement basic grid point definition table for the current superelement

UNUSED9 Unused and can be purged

DYNAMICS Table of Bulk Data entry images related to dynamics for the current superelement

MATPOOLS MATPOOL table for the current superelement

UNUSED12 Unused and can be purged

Parameters:

SEID Input-integer-default=0. Superelement identification number.

METHCMRS Input-integer-default=0. Residual structure METHOD set identification (SID)


override. METHCMRS>0 overrides SID value specified in CASES.

DMAPNO Integer-input-default=0. Solution sequence number stored in word 244 of the


case control record.

AUTOMPC Input-character-default=no. Specifies that the software automatically select the


m-set dofs rather than use the m-set values as specified on MPC or RIGID
element cards. See the AUTOMPC parameter in the Quick Reference Guide
for details.

11.76 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 $

11-162 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Input Data Blocks:

CASECC Table of Case Control command images

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.

SEID Output-integer-default=0. Initialization flag. If there are superelements, SEID is


set to -1 to initialize SEP2DR; otherwise 0.

NOSE Input-integer=default=0. Superelement presence flag. Set to -1 if there are no


superelements.

NOMAT Output-integer-default=0. Matrix generation flag. If there are no superelements,


NOMAT is set to -1 if no SEMG and no SEALL Case Control commands are
specified.

NOASM Output-integer-default=0. Matrix assembly flag. If there are no superelements,


NOASM is set to -1 if no SEKR and no SEALL Case Control commands are
specified.

NOLOAD 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.

NOLASM 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.

NOMR 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.

UNUSED9 Input-integer-default=0. Unused.

Remarks:

If there are no superelements, SLIST is not created and can be purged.

DMAP Programmer's Guide 11-163


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.77 SEP4
Examines table and data base information for superelement processing
Examines the Case Control and Plot Control tables, queries the data base for existing solution
matrices, and determines which superelements are to be processed for data recovery.

Format:

SEP4 CASECC,PCDB,EMAP,XYCDB,UG*,PUG*,QG*/
DRLIST/
UNUSED1/QUALNAM/S,N,NODR/S,N,SEID/S,N,NOSEPLOT/
SEP4CNTL $

Input Data Blocks:

CASECC Table of Case Control command images

PCDB Table of model (undeformed and deformed) plotting commands

SEMAP Superelement map table

XYCDB Table of x-y plotting commands

UG* Family of displacement matrices in g-set for all superelements

PUG* Family of matrices of translational displacements for all superelements

QG* Family of single-point constraint forces of constraint matrices in the g-set for
all superelements

Output Data Block:

DRLIST Superelement processing list for data recovery

Parameters:

UNUSED1 Input-character-no default. Specify ’ ’

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting UG,


PUG, and QG.

NODR Output-integer-default=0. Data recovery request flag. Set to -1 if there is no


data recovery requested for any superelement.

SEID Input-integer-default=0. Initialization flag. If there are superelements, SEID is


set to -1 to initialize SEDRDR; otherwise 0.

NOSEPLOT Output-integer-default=0. SEPLOT or SEUPPLOT request flag. Set to -1 if there


are no SEPLOT or SEUPPLOT commands specified in the OUTPUT(PLOT)
section.

11-164 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SEP4CNTL Output-integer-default=’ ’ Processing list selection.

‘ALL’ All superelements are processed.

≠‘ALL’ Only superelements specified on the SEDR Case Control command

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 $

11.78 SEPDIS
Contact solution separation distance output creation.

Format:

SEPDIS CNELM,ECDISP,CASECC/OSPDS/
NVEC/DMAPNO/TIME $

Input Data Blocks:

CNELM Contact element definition table.

ECDISP Contact element displacements.

CASECC Table of case control command images.

Output Data Blocks:

OSPDS Table of initial or final separation distances at the contact grids.

Parameters:

NVEC Input-integer-no default. Number of solution results to process.

DMAPNO Input-integer-no default. DMAP number.

TIME Input-real-no default. Results output time.

11.79 SEPLOT
Assembles plot displacement matrices for superelements

DMAP Programmer's Guide 11-165


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Table of model (undeformed and deformed) plotting commands

SEMAP Superelement map table

SCSTM Table of global transformation matrices for partitioned superelements

BGPDT* Family of basic grid point definition tables for all superelements

ECT* Family of element connectivity tables for all superelements

PUG* Family of matrices of translational displacements for all superelements

Output Data Blocks:

BGPDTX BGPDT assembled for superelements defined on the SEPLOT or SEUPPLOT


command

PUGX PUG assembled for superelements defined on the SEPLOT or SEUPPLOT


command

PLSETMSG Table of user informational messages generated during the definition of


element plot sets

PLTPAR Table of plot parameters and plot control

GPSETS Table of grid point sets related to the element plot sets

ELSET Table of element plot set connections

Parameters:

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting


BGPDT and ECT.

QUALNAMP Input-character-default=‘PEID’ Name of qualifier to be used in selecting PUG.

PLTCNT Input/output-integer-no default. SEPLOT (or SEUPPLOT) command counter.

On input:

11-166 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

0 Initialization

On output:

≥0 Current SEPLOT (or SEUPPLOT) command

NGP Output-integer-no default. Number of grid points and scalar points in the
BGPDTX.

JPLOT Output-integer-no default. Number of element plot sets. Set to -1 if there are
none.

Example:
Excerpt from subDMAP SUPER3:
DBVIEW BGPDTF=BGPDTS WHERE (PEID=* AND MODLTYPE=‘STRUCTUR‘) $
DBVIEW ECTF=ECTS WHERE (PEID=* AND MODLTYPE=‘STRUCTUR‘) $
DO WHILE ( PLTCNT>-1 ) $
SEPLOT PCDB,EMAP,scstm,BGPDTF,ECTF,PUGF/
BGPDTX,PUGX,PLTXY,PLTPARY,GPSETSY,ELTSETSY/
‘PEID‘/‘SEID‘/S,N,PLTCNT/S,N,NSILS/S,N,JPLOT $
PRTMSG PLTXY//PDRMSG $
IF ( JPLOT>=0 ) THEN $
PLOT PLTPARY,GPSETSY,ELTSETSY,CASECC,BGPDTX,
PUGX,PUGX,gpect,oes1x/
PLOTY2/NSILS/0/JPLOT/-1/S,N,PFILE $
PRTMSG PLOTY2//PDRMSG $
ENDIF $ JPLOT>=0
ENDDO $ PLTCNT>-1

11.80 SEPR1
Builds a list of partitioned superelement Bulk Data sections

Format:

SEPR1 BULK*/
SELIST/
QUALNAM/S,N,SEFLAG $

Input Data Blocks:

BULK* Family of partitioned superelement Bulk Data sections

Output Data Blocks:

SELIST List of partitioned superelement identification numbers

Parameters:

QUALNAM Input-character-default=‘SEID’ Name of qualifier to be used in selecting BULK.

DMAP Programmer's Guide 11-167


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

SEFLAG 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 $

11.81 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 Table of Bulk Data entry images related to geometry

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership, and rigid element connectivity

EPT Table of Bulk Data entry images related to element properties

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries. Required for DMIG and virtual
mass partitioning with domain solver ACMS=‘YES’

DYNAMIC Table of Bulk Data entry images related to dynamics. Grid points on DPHASE,
DELAY, TIC, and DAREA records are assigned to the residual structure if
ACMS=‘YES’

CASECC Table of Case Control command images. Required for MFLUID set identification
number.

11-168 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

MAT Matrix. Must be square and symmetric.

GPL External grid/scalar point identification number list

USET Degree-of-freedom set membership table for g-set

SIL Scalar index list

Output Data Block:

GEOM1Q Same as GEOM1 except SEQGP Bulk Data entry records have been added and
any pre-existing SEQGP records are removed

TIMSIZ Table of CPU and disk space estimation parameters

GEQMAP Table of grid based local equation map indicating which grid resides on which
processors/partitions for domain decomposition

BNDFIL Table containing the local and global boundary grids in the order given by extreme
for domain decomposition

SPCPART Partitioning vector for domain decomposition

SEQMAP Mapping matrix for resequencing

LGPART Same as SPCPART except it includes disjoint grid points

GEOM2X GEOM2 table augmented with fluid data and SPOINTS if ACMS=‘YES‘

GEOM4X GEOM4 table augmented with new RBE1 and RBE2 records (because all RBE1
and RBE2 elements are split so that each one contains only one m-set grid) for
ACMS=‘YES’ Also augmented with SEQSET1 records for ACMS=‘YES’

Parameters:

SEQOUT Input-integer-default=0. Output options:

0 No output

1 Print a formatted table of the internal vs. external grid identification number

2 Write the SEQGP entries to the punch file (.pch)

3 Combines 1 and 2

SEQMETH Input/output-integer-default=3. Resequencing method:

-1 No resequencing is performed.

1 Active/passive

2 Band

DMAP Programmer's Guide 11-169


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

3 For the active/passive and the band options, select the option giving the
lowest RMS value of the active columns for each group of grid points
(default).

4 Wavefront (Levy)

5 Gibbs-King. See Remark 4.

6 Automatic nested dissection. See Remark 4.

7 Multiple Minimum Degree of Freedom. See Remarks 3 and 4.

8 Semiautomatic selection. See Remark 5.

On output, METHOD is set to -1 if new sequence results in a lower decomposition


time estimate. Otherwise it is set to 0.

SETNAME Input-character-default=‘G’ Degree-of-freedom set name corresponding to the


size of MAT (Format 2 only).

SUPER Input-integer-default=0. Selects coupled or uncoupled sequencing or special


handling of multipoint constraints.

FACTOR Input-integer-default=0. Factor in the computation of the sequenced identification


number (SEQID) on the SEQGP. See Remark 7.

MPCFLG Input-integer-default=0. Controls whether the grid point connectivity created by


multipoint constraint Bulk Data entries (MPC, MPCADD, and MPCAX and the rigid
element entries; for example, RBAR) is considered during resequencing.

-1 Do not consider

0 Consider (default)

>0 Consider only the MPC, MPCADD, and MPCAX entries with a set
identification number equal to this parameter‘s value as well as the of the
rigid element entries

START Input-integer-default=0. The number of the grid points at the beginning of the
input sequence. See Remark 8.

MSGLVL Input-integer-default=0. Diagnostic output flag.

0 No

>0 Yes

PEXIST Input-logical-default=FALSE. If set to TRUE, it specifies the existence of


p-elements.

PSEQOPT Input-character-default=’ ’ Specifies append (default) or insert option for


p-elements. See Remark 9.

11-170 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

NTIPS 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.

APP Input-character-default=” Analysis type. Allowable values:

STATICS Statics

REIGEN Normal modes

FREQRESP Frequency response

TRANRESP Transient response

CEIGEN Complex eigenvalues

ZCOLLCT Input/output-integer-default=-1. The absolute value is the number of collectors


in the last level of a multilevel tree (see ACMS=‘YES). If ZCOLLCT<0, a single
final collector is added.

TIPSCOL Input/output-integer-default=-1. The number of tip superelements upstream of


each downstream collector superelement. See ACMS=‘YES’

ACMS Input-character-default=” Automatic Component Mode Synthesis flag. If


ACMS=‘YES‘, the model is automatically partitioned into superelements
according to NTIPS, TIPSCOL, and ZCOLLCT.

FLUIDSE Output-integer-default=0. Fluid superelement identification number. Set to a


value greater than zero if ACMS=‘YES’and fluid elements are present.

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. Siemens PLM Software 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.

DMAP Programmer's Guide 11-171


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Decomposition method Suitable SEQMETH

Non-sparse and non-parallel 1 and 4

Parallel 2 and 5

Sparse 6 and 7

6. Description of SUPER:

• If PARAM,SUPER=0, all grid points from the connection table that are not part of the group
currently being processed are deleted. This option provides for sequencing only the interior
points of a superelement. If any superelements are present, the residual structure is not
resequenced. If all of the grid points are in the residual structure, they are resequenced.

• If PARAM,SUPER=0 or 1, all grid points in the connection table are considered. This option
provides for the recognition of passive columns.

• If PARAM,SUPER=2, 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.

7. FACTOR is used as follows:


SEQID = FACTOR * GRP + SEQ

where SEQ is a generated sequence number and GRP is a group sequence number.
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.

11-172 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 KAA,,,/SEQMAP,//METHOD $
SMPYAD SEQMAP,KAA,SEQMAP,,,/KAAX/3////1////6 $
DECOMP KAAX/LAA,/ $
MPYAD SEQMAP,PA,/PAX/1 $
FBS LAA,, PAX/UAX/ $
MPYAD SEQMAP,UAX,/UA/ $

11.82 SETMON
Setup the parameters for the dof display in the solution monitor.

Format:

SETMON EQEXIN,USET/MGRID/MDOF/IOPT $

Input Data Blocks:

EQEXIN Equivalence table between external and internal grid/scalar identification numbers.

USET Degree-of-freedom set membership table.

Parameters:

MGRID Input-integer. Grid ID for display.

MDOF Input-integer. Grid dof for display.

IOPT Input-integer. Analysis option.


= 0 for direct frequency/transient.
= 1 for modal frequency/transient.

11.83 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.

DMAP Programmer's Guide 11-173


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format:

SHPCAS CASECC,YGBNDR/
CASECC1,CVEC $

Input Data Blocks:

CASECC Table of Case Control command images for the primary model

YGBNDR Boundary shape matrices appended for all auxiliary or geometric models

Output Data Blocks:

CASECC1 Primary model Case Control table appended with extra subcases to account for
the boundary shapes

CVEC Partitioning vector for separating the primary model solutions from boundary
shape induced solutions

Parameters:

None.

11.84 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 Table of general element data

KGG 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 ].

11-174 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

NOGENL Input-integer-no default. The number of general elements.

NOSIMP Input-integer-no default. The number of simple elements. Set to -1 if there are
no elements.

Remarks:
KGG can be purged.

11.85 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 Matrices multiplied from left to right (real or complex)

F Matrix to be added to the above product (real or complex)

Output Data Block:

X Resultant matrix

Parameters:

NMAT Integer-input-no default. Number of matrices involved in the product; that is,
[A][B][C][D][E].

SIGNP Integer-input-default=1. Sign of the product matrix (that is, [A] [B] [C] [D] [E]):
-1 for minus.

SIGNF Integer-input-default=1. Sign of the matrix. [F], to be added to the product matrix:
-1 for minus.

PREC Integer-input-default=0. Output precision of the final result: 0 for choose proper
precision, 1 for single precision, 2 for double precision.

DMAP Programmer's Guide 11-175


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

TA, TB, TC, Integer-input-default=0. Transpose indicators for the [A] [B] [C] and [D] matrices:
TD 1 if transposed matrix to be used in the product, 0 if untransposed. The last
nonpurged matrix must be untransposed.

FORM Integer-input-default=0. Form of the X matrix. If FORM is zero, the form of [X] 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.

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. The triple multiply can also be forced by setting
system cell 129 to 2 for sparse [B] and to 3 for dense [B].)

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 $

11.86 SOLVE
Linear system solver
Solves the matrix equation [A] [X] = ± [B] or the left-hand solution [X]T[A] = ± [B]T.

Format:

11-176 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SOLVE A,B,SIL,USET,PARTVEC/
X/
SYM/SIGN/SETNAME $

Input Data Blocks:

A Square, symmetric or unsymmetric, matrix (real or complex)

B Rectangular matrix (real or complex)

SIL Scalar index list

USET Degree-of-freedom set membership table

PARTVEC Partitioning vector which is specified when A and B are the zero-th partitions of
the set specified by SETNAME

Output Data Block:

X Rectangular matrix. See Remark 1.

Parameters:

SYM Input integer default = 0 selects solution method.

0 Use either symmetric or unsymmetric method consistent with symmetric or


unsymmetric [A].

1 Use symmetric method

-1 Use unsymmetric method

2 Solve left-hand solution for [X]T

3 Compute inverse of [A]. See Remark 2.

SIGN Input integer default = 1. Sign of right-hand side flag.

1 Solve [A] [X] = [B]

-1 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.

DMAP Programmer's Guide 11-177


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

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 $

11.87 SOLVIT
Iterative solver
Solves the matrix equation [A] [X] = ± [B] for [X] using a preconditioned conjugate gradient method.
The element and the global iterative solutions have different formats, input data blocks, output data
blocks, and parameters. The element based solution format is described below, then the global
based solution format follows.

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/UGV,QG,,/
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,ITSERR/WTMASS $

Input data blocks for element based solution:

KELM Element stiffness matrix

PG Load vector in g set

KDICT Element stiffness dictionary

SIL Scalar index list

ECT Element connectivity table

BGPDT Basic grid point data table

11-178 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

CSTM Coordinate system transformation matrix

EDT Element data table

CASECC Case control command images

USETB Degree-of-freedom set membership table

RG Constraint matrix in g set

MPT Material property table

YGB Specified non-zero displacements in g set

SLT Static load table

MDICT Mass dictionary

MELM Element mass matrix

EPT Element property table

CNELM Glue element definition

ELCNST Element normal stiffness

ELCTST Element tangential stiffness

Output data blocks for element based solution:

UGV Displacements - g set

QG SPC forces - g set

Parameters for element based solution:

ISIGN Not currently used.

IOPT Input-integer. Preconditioner option

ITSEPS Input-real-default = 1.0E-6. Convergence parameter epsilon.

ITSMAX Input-integer-default = 1000. Maximum number of iterations.

IPAD Not currently used.

IEXT Not currently used.

ADPTINDX Not currently used.

NSKIP Input-integer-default=1. Record number of current subcase in CASECC

DMAP Programmer's Guide 11-179


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

IMSGFL Input-integer-default = 0. Output message flag

IDEBUG Input-integer=default = 0. Debug flag

ITSERR Output-integer-default = 0. Iterative solver return code.

WTMASS Input,Real – Weight to mass factor

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 for global solution:

A Square matrix (real or complex, symmetric or unsymmetric)

B Rectangular matrix (real or complex), the right-hand side

XS Optional starting vector, same type as B (can be purged)

PC Optional stepwise preconditioner, same type as A (can be purged.

USET Degree-of-freedom set membership table. See Remark 3.

KGG Stiffness matrix - g-set. See Remark 3.

GM Multipoint constraint transformation matrix. See Remark 3.

USET0 USET table from previous adaptivity index in p-version analysis

SIL Scalar index list

SIL0 SIL table from previous adaptivity index in p-version analysis

EQEXIN Equivalence table between external and internal grid/scalar identification numbers.
Required for p-version preconditioning only.

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver.

CASECC Table of Case Control command images. Required if SMETHOD Case Control
command is used and NSIP=-1.

11-180 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

EQMAP Table of degree-of-freedom global-to-local maps for domain decomposition

Output data blocks for global solution:

X Solution matrix. Rectangular matrix having the same dimensions and type as [B].

R Residual matrix. Rectangular matrix having the same dimensions and type as [B],
the residual [R] = [B] - [A][X].

PC1 Updated stepwise preconditioner matrix. See Remark 6.

EPSSE Table of epsilon and external work

Parameters for global solution:

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 Jacobi preconditioning (default) for real, complex, symmetric and


unsymmetric A

2 Incomplete Cholesky preconditioning or user-given preconditioner

3 Reduced incomplete Cholesky preconditioning. preconditioner (available for


real symmetric A only)

4 User supplied for real, complex, symmetric A

5 Incomplete geometric, Jacobi hierarchic for real symmetric A

6 Complete geometric, Jacobi hierarchic for real symmetric A

7 Complete geometric, incomplete hierarchic for real symmetric A

10 Block incomplete Cholesky for well-conditioned real symmetric A (default


for real A)

11 Block incomplete Cholesky for well-conditioned complex symmetric A


(default for complex A)

DMAP Programmer's Guide 11-181


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

<0 Same as above with diagonal scaling

ITSEPS Input-real-default = 1.0E-6. Convergence parameter epsilon.

ITSMAX Input-integer-default = 0. Maximum number of iterations. The default value


implies N/4 (N = dimension of [A]).

IPAD Input-integer-default = 0 (see table below). Padding level for reduced or block
incomplete Cholesky factorization (0, 1, 2, ...). See Remarks 1 and 2. See also .

IPAD Method ITSOPT Model Type of [A]


default type

0 Reduced incomplete Cholesky 3 all real

2 Block incomplete Cholesky 10,11 3-D real

3 Block incomplete Cholesky 10,11 2-D or real


mixed

5 Block incomplete Cholesky 10,11 all complex

IEXT Input-integer-default = 0. Extraction level in reduced or block incomplete Cholesky


factorization. See Remarks 1 and 2. See also .

IPAD default Reduced Block

0 0 solid bodies, no rigid elements. Requires USET and SIL

1 1 shells only Heuristic block structure (default)

2 2 mixed including rigid elements N/A

ADPTINDX Input-integer-default=0. P-version analysis adaptivity index. See Remark 7.

NSKIP Input-integer-default=1. Record number of current subcase in CASECC and


used only if the SMETHOD command selects the ITER Bulk Data entry which
specifies values for the desired iteration parameters. If NSKIP=-1, CASECC is
not required and the values are taken from the module specification of the values.

MSGLVL Input-integer-default=0. Message level output. See .

0 Minimal; that is, UIM 6447 (default)

1 UIM 6447, convergence ratios, and residual norms

PREFONLY Input-integer-default=0. Preface execution only. If set to -1, SOLVIT is


terminated after the preface information is computed and printed.

11-182 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

ITSERR Output-integer-default=0. Iterative solver return code.

1 No convergence

2 Insufficent memory

SEID Input-integer-default=0. Superelement identification number.

Global solution remarks:


1. If ITSOPT = 3, Siemens PLM Software 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 Action

2 Suppresses the user information message at each iteration

8 Use alternative convergence criterion (less conservative than default)

6. If data block PC1 is specified, the CPU time 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.

Global solution examples:


1. Solve [A][X]=[B] with Jacobi pre-conditioning with convergence established at 1.E-4 and
maximum allowed iterations at 55 specified for the module parameters.
SOLVIT A,B,,,,,,,,,/X,,//1/1.E-4////-1 $

2. Same as 1 except parameters are obtained from the SMETHOD command and ITER entry.
SOLVIT A,B,,,,,,,,EDT,CASECC/X,, $

3. Same as 2 except for p-version analysis.

DMAP Programmer's Guide 11-183


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 $

11.88 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 generates the acceleration matrix due to inertial loads for design
sensitivity analysis.

Format:

SSG1 SLT,BGPDT,CSTM,MEDGE,EST,MPT,ETT,EDT,MGG,CASECC,
DIT,UG,DEQATN,DEQIND,GPSNT,CSTMO,SCSTM,GEOM4,
EPT,PCOMPT,COMPEST/
{PG or AG},PTELEM,SLTH/
LUSET/NSKIP/DSENS/APP/ALTSHAPE/TABS/SEID/LMFACT $

Input Data Blocks:

SLT Table of static loads

BGPDT Basic grid point definition table

CSTM Table of coordinate system transformation matrices

MEDGE Edge table for p-element analysis

EST Element summary table

MPT Table of Bulk Data entry images related to material properties

ETT Element temperature table

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver. Also contains
SET1 entries

MGG Mass or radiation matrix in g-set

CASECC Table of Case Control command images

DIT Table of TABLEij Bulk Data entry images

UG Displacement matrix in g-set

DEQATN Table of DEQATN Bulk Data entry images

11-184 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

DEQIND Index table to DEQATN data block

GPSNT Grid point shell normal table

CSTM0 Table of coordinate system transformation matrices for the residual structure

SCSTM Table of global transformation matrices for partitioned superelements

GEOM4 Table of Bulk Data entry images related to constraints, degree-of-freedom


membership and rigid element connectivity. Required for selected SPCD
existence checks

EPT Table of Bulk Data entry images related to element properties

PCOMPT Table containing LAM option input and expanded information from the PCOMP
Bulk Data entry

COMPEST Composite solid element summary table

Output Data Blocks:

PG Static load matrix applied to the g-set

AG Acceleration matrix due to inertial loads in the g-set. See DSENS

PTELEM Table of thermal loads in the elemental coordinate system

SLTH Table of static loads updated for heat transfer analysis

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

NSKIP Input-integer-default=1. The record number in CASECC corresponding to the first


subcase of the current boundary condition.

DSENS Input-integer-default=-1. Acceleration matrix creation flag. Set to 1 to generate


AG, accelerations due to inertial loads.

APP Input-character-default=‘STATICS’ Analysis type.

‘STATICS’ Generate loads for current boundary condition only.

‘BUCK’ Generate loads for first subcase only.

‘NLST’ Generate loads for nonlinear static or steady state heat transfer
analysis.

‘ALL’ Generate loads for all subcases.

DMAP Programmer's Guide 11-185


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

ALTSHAPE Input-integer-default=0. Specifies set of displacement functions in p-element


analysis. ALTSHAPE=0 selects the MacNeal set and 1 selects the Full Product
Space set.

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying
temperatures in Fahrenheit.

SEID Input-integer-default=0. Superelement identification number.

LMFACT Scale factor for the stiffness matrix of Lagrange rigid elements.

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.

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.

11.89 SSG2
Reduces static load and enforced displacement matrices

11-186 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

SSG2 USET,GM,YS,KFS,GOA,DM,PG,KOA/
QR,PO,PS,PA,PL $

Input Data Blocks:

USET Degree-of-freedom set membership table for g-set

GM Multipoint constraint transformation matrix, m-set by n-set

YS Matrix of enforced displacements or temperatures

KFS Stiffness matrix partition (f-set by s-set) from KNN

GOA Omitted degree-of-freedom transformation matrix, o-set by a-set

DM Rigid body transformation matrix for the r-set to the l-set

PG Static load matrix applied to the g-set

KOA o-set and a-set matrix partition of stiffness matrix

Output Data Blocks:

QR Matrix of determinate support forces

PO Static load matrix partitioned to the o-set

PS Static load matrix partitioned to the s-set

PA Static load matrix reduced to the a-set

PL Static load matrix reduced to the l-set

Parameters:
None

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.

DMAP Programmer's Guide 11-187


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

11.90 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 Lower triangular factor/diagonal for the l-set from KLL

UNUSED2 Unused and can be purged

KLL Stiffness matrix reduced to the l-set

PL Static load matrix reduced to the l-set

LOO Lower triangular factor/diagonal for the o-set from KOO

UNUSED6 Unused and can be purged

KOO Stiffness matrix partitioned to the o-set from KFF

PO Static load matrix partitioned to the o-set

LSEQ Resequencing matrix based on internal resequencing of KLL in DCMP

Output Data Blocks:

UL Displacement matrix in l-set

UO Displacement matrix in o-set

RUL Residual matrix for the l-set

RUO Residual matrix for the o-set

EPSSE Table of epsilon and external work.

11-188 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

NOOSET Input-integer-no default. Number of degrees-of-freedom in the o-set or omitted


degree-of-freedom flag. Set to -1 if there are none.

UNUSED2 Input-integer-no default. Not used, but specify 0.

NSKIP Input-integer-default=1. The record number in CASECC corresponding to the


first subcase of the current boundary condition.

EPSI Output-integer-default=1. Static solution error ratio flag. Set to -1 if the error ratio
is greater than 1.E-3.

EXTWORK Output-real-default=0.0. External work.

SEID Input-integer-default=0. Superelement identification number.

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.

11.91 SSG4
Updates static loads with inertial loads

Format:

SSG4 PL,QR,PO,MR,MLR,DM,MLL,MOO,MOA,GOA,USET/
PLI,POI/
NOOSET $

Input Data Blocks:

PL Static load matrix reduced to the l-set

QR Matrix of determinate support forces

PO Static load matrix partitioned to the o-set

MR Rigid body mass matrix (r-set by r-set)

DMAP Programmer's Guide 11-189


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

MLR Mass matrix partition (l-set by r-set) from MTT

DM Rigid body transformation matrix for the r-set to the l-set

MLL Mass matrix reduced to the l-set

MOO Mass matrix partitioned to the o-set from KFF

MOA Mass matrix partition (o-set by a-set) from MFF

GOA Omitted degree-of-freedom transformation matrix, o-set by a-set

USET Degree-of-freedom set membership table for g-set

Output Data Blocks:

PLI Static load matrix with inertial loads and reduced to the l-set

POI Static load matrix with inertial loads and reduced to the o-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.

11.92 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 $

11-190 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Input Data Blocks:

KGG Stiffness matrix in g-set

PG Static load matrix applied to the g-set

YS Matrix of enforced displacements

RMG Multipoint constraint equation matrix

CASECC Table of Case Control command images

USET Degree-of-freedom set membership table for g-set

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

SIL Scalar index list

XS Optional starting vector, same as PG

PC Optional stepwise preconditioner, same as KGG

EDT Table which contains ITER Bulk Data entries. Required for NSKIP=-1 only.

Output Data Blocks:

UG Displacement matrix in g-set

PC1 Updated stepwise preconditioner matrix.

RUG Residual matrix for the g-set

QG Single-point constraint forces of constraint matrix in the g-set

QMG Multipoint constraint forces of constraint matrix in the g-set

Parameters:

STATOPT Input-character-no default. Static solution method.

‘DRCT’ Direct

‘ITER’ Iterative

SIGN Input-integer-default=1. Sign of right hand side matrix, PG.

1 Positive

-1 Negative

ITSOPT Input-integer-default=1. Preconditioner flag. See the “SOLVIT” module.

DMAP Programmer's Guide 11-191


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

ITSMAX Input-integer-default=1. Maximum number of iterations for iterative solution


method.

ITSEPSR Input-real-default=1.E-6. Convergence parameter epsilon for iterative solution


method.

NSKIP Input-integer-default=1. Record number of current subcase in CASECC and used


only if the SMETHOD command selects the ITER Bulk Data entry which specifies
values for the desired iteration parameters. If NSKIP=-1, CASECC and EDT are
not required and the values are taken ITSOPT, ITSMAX, and ITSEPSR.

NOQG Input-integer-default=1. Single-point forces of constraint matrix creation flag.


Default of 1 requests computation of the forces. Specify -1 to request no
computation.

NOQMG Input-integer-default=1. Multipoint forces of constraint matrix creation flag. Default


of 1 requests computation of the forces. Specify -1 to request no computation.

EPSNO Input-integer-default=-1. Number of solutions to check and the quantity of error


checking output. If left at its default value, only the highest epsilon for the first
ten solutions (whichever is less) are printed. If EPSNO is greater than zero, the
epsilons for the first EPSNO are printed.

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.

11.93 STDCON
Calculate stress discontinuities across elements and grid points

Format:

CASECC,EGPSF,EQEXIN,OES1,EGPSTR,ECT/
STDCON OEDS1,OGDS1,ELDCT,GPDCT/
S,N,NOEDS1/S,N,NOGDS1/S,N,NOELDCT/S,N,NOGDCT/APP $

Input Data Blocks:

CASECC Table of Case Control command images

EGPSF Table of element to grid point interpolation factors

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

11-192 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

GPL External grid/scalar point identification number list

OES1 Table of element stresses or strains in SORT1 format

EGPSTR Table of grid point stresses or strains for post-processing in the DBC module

ECT Element connectivity table

Output Data Blocks:

OEDS1 Table of element stress discontinuities

OGDS1 Table of grid point stress discontinuities

ELDCT Table of element stress discontinuities for post-processing in the DBC module

GPDCT Table of grid point stress discontinuities for post-processing in the DBC module

Parameters:

NOEDS1 Output-integer-default=-1. OEDS1 generation flag. Set to 0 if OEDS1 is


generated.

NOGDS1 Output-integer-default=-1. OGDS1 generation flag. Set to 0 if OGDS1 is


generated.

NOELDCT Output-integer-default=-1. ELDCT generation flag. Set to 0 if ELDCT is generated.

NOGPDCT Output-integer-default=-1. GPDCT generation flag. Set to 0 if GPDCT is


generated.

APP Input-character-default=‘STATICS. Analysis type. Allowable values:

‘STATICS’ Statics

‘REIGEN’ Normal modes

11.94 STRSORT
Filters and sorts element data recovery tables

Format:

STRSORT OFPE,INDTA/
OFPES/
NUMOUT/BIGER/SRTOPT/SRTELTYP/SRTTYP $

DMAP Programmer's Guide 11-193


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Input Data Blocks:

OFPE Element data recovery table in SORT1 or SORT2 format

INDTA 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 Number of element quantities per element type to be output

0 Output all quantities for elements in a group if the absolute value of one or
more elements is greater than BIGER

-1 Output sorted quantities with absolute value greater than BIGER

-2 Output filtered quantities with absolute value greater than BIGER

BIGER Input-real-default=0.0. Minimum absolute value of element quantity to be output.

SRTOPT Input-integer-default=0. Filter/sort option based on NUMOUT and BIGER.

0 Maximum magnitude

1 Minimum magnitude

2 Maximum algebraic

3 Minimum algebraic

SRTELTYP Input-integer-default=0. Element type to be filtered and sorted. By default, all


element types are filtered and sorted.

SRTTYP Input-integer-default=0. Item code 1 sort flag. Set to 1 to perform an integer sort
on item code 1 which is usually an integer quantity.

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.

11-194 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

11.95 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,COMPEST,NSMEST/
TA1
LUSET/S,N,NOESTL/S,N,NOSIMP/NOSUP/S,N,NOGENL/SEID/
LGDISP/NLAYERS/S,N,FREQDEP/BSHDAMP/S,N,BSHDMP/NSMID/MATNL $

Input Data Blocks:

MPT Table of Bulk Data entry images related to material properties

ECT Element connectivity table

EPT Table of Bulk Data entry images related to element properties

BGPDT Basic grid point definition table

SIL Scalar index list

ETT Element temperature table

CSTM Table of coordinate system transformation matrices

DIT Table of TABLEij Bulk Data entry images

ECTA Secondary element connectivity table

EHT Element hierarchical table for p-element analysis

Output Data Blocks:

EST Element summary table

ESTNL Nonlinear element summary table

GEI Table of general element data

GPECT Grid point element connection table

ESTL Linear element summary table

VGFD Partitioning vector with ones at rows corresponding to degrees-of-freedom


connected to frequency-dependent elements

DITID Table of identification numbers in DIT

DMAP Programmer's Guide 11-195


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

NFDICT Nonlinear element energy/force index table

COMPEST Composite solid element summary table

NSMEST Non-structural mass element summary table

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

NOESTL Output-integer-no default. ESTL generation output flag. Set to 1 if ESTL is


generated; -1 otherwise.

NOSIMP Output-integer-no default. The number of elements exclusive of general elements.


Set to -1 if there are no simple elements.

NOSUP Input-integer-no default. Element summary table request flag.

1 Generate EST only (usually for linear analysis)

2 Form EST, ESTNL and ESTL (usually for nonlinear analysis)

NOGENL Output-integer-no default. The number of general elements.Set to -1 if there are


no general elements.

SEID Input-integer-no default. Superelement identification number.

LGDISP Input-integer-default=1. Large displacement and follower force flag.

-1 No large displacement and follower force effects are considered.

1 Large displacement and follower force effects are considered.

2 Only large displacement effects are considered.

NLAYERS Input-integer-default=6. Number of layers to integrate through the thickness of


CQUAD4 and CTRIA3 elements in nonlinear analysis.

FREQDEP Output-logical-default=FALSE. Frequency-dependent element flag. Set to TRUE


if frequency-dependent elements are present.

BSHDAMP Input-character-default=‘DIFF’. Determines if the PBUSH/PBUSHT bulk entry


fields GE2-GE6 and TGEID2-TGEID6 are considered.
= SAME The fields GE2-GE6/TGEID2-TGEID6 are ignored, only the fields
GE1/TGEID1 are considered and BSHDMP on the EMG module is assigned a
value of 0.
= DIFF The fields GE2-GE6/TGEID2-TGEID6 are considered. If all
PBUSH/PBUSHT GE2-GE6/TGEID2-TGEID6 fields are blank, BSHDMP on the
EMG module is assigned a value of 0. Otherwise, BSHDMP=1.

BSHDMP Output-integer-default=0. BUSH structural damping strategy for EMG module.


See BSHDAMP above and BSHDMP on EMG module for details.

11-196 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

NSMSID Input-integer-default=0. Set identification number from the NSM Case Control
command.

MATNL Input-integer-default=-1. Material nonlinearity flag.

-1 Turn off material nonlinearity.

1 Turn on material nonlinearity.

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.

11.96 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 Table data block to be edited. Cannot be purged, and in general, contains
string-formatted records.

CONTROL 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.

TA,TB,TC Secondary tables to be merged into TOLD. Can be purged.

DMAP Programmer's Guide 11-197


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 Print information messages and trace editing process

=0 Print information messages only

>0 No print activity occurs

DUPWG Input-integer-default=0. Duplicate word group option and applicable only to the
Merge-Edit option.

=0 Duplicate word groups are dropped from TOLD.

=1 Duplicate word groups are added after TOLD version.

UNUSED3 Input-integer-default=0. Unused.

UNUSED4 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 Remarks

ER End Record-Edit processing by copying rest of TOLD to TNEW. This


directive is optional.

QR, i Quit Record-Edit processing by copying rest of TOLD onto TNEW


through record i and exiting

DR, i or DR ,i ,j Delete Record i (or records i through j) from TOLD after copying up
to record i

IR, i Insert Records from TOLD after copying up to record i

CR, i, options Correct Record i (after copying up to record i) by deleting, adding


or replacing word groups according to the options as described in
Remark 2

11-198 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

TABEDIT directives

Directive Remarks

KRA,n Copy n Records from TA, TB, or TC onto TNEW


KRB,n
KRC,n

SRA,n Skip n Records forward on TA, TB, or TC. Used to position secondary
data block TA, TB, or TC for a subsequent KR* operation.
SRB,n
SRC,n

MEA,i,n Merge-Edit the next record on TA, TB, or TC into record i according
to IFP specifications for fixed-length word groups of length n.
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.

2. The CR directive requires at least one subdirective from the table below:

CR sub-directives

Sub-directive Remarks

QW, i Quit after copying Word i. Record specified by CR directive is


copied through word i and the rest of the record is ignored.

DW, i, j, n,n words Delete Words i through j of the record specified by the CR directive
and replace by the n words that follows on the CR directive record

IW, i, n,n words Insert after Word i of the record specified by the CR directive the n
words that follow on the CR directive record

KWA,n Copy n Words from TA, TB, or TC onto TNEW


KWB,n
KWC,n

SWA,n Skip n words forward on TA, TB, or TC. Used to position secondary
data block TA, TB or TC for a subsequent KW* operation.
SWB,n
SWC,n

DMAP Programmer's Guide 11-199


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

CR sub-directives

Sub-directive Remarks

AWA,n Append n Words from TA, TB, or TC onto TNEW after copying the
rest of the record specified by the CR directive.
AWB,n
AWC,n

KRA,n Copy the Remaining contents of the current record from TA, TB,
or TC onto TNEW
KRB,n
KRC,n

ARA Append the Remaining contents of the current record from TA, TB,
or TC onto TNEW after copying the rest of the record specified
ARB by the CR directive
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.

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 XSORT-IFP

11-200 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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

11.97 TABPRT
Formatted table printer
Formatted print of selected table data blocks.

DMAP Programmer's Guide 11-201


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Format 1:
TABPRT TABLE//KEY/OPT1//OPT3 $

Format 2: (KEY=’USET’)
g-set

TABPRT USET,BGPDT//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $

TABPRT USET,EQEXIN,SIL//USET/OPT1/OPT2//
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $

p-set

TABPRT USETD,EQDYN,SILD//USET/OPT1/OPT2/
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $

ks-set

TABPRT AEUSET,AEBGPDT//USET/OPT1/OPT2/
SETSTR1/SETSTR2/SETSTR3/SETSTR4 $

Format 3: (KEY=’SEMAP’)

TABPRT SEMAP,ESTDATA,TIMSIZ,SGPDT//
’SEMAP’/OPT1/OPT2 $

Input Data Blocks:

TABLE Table data block

USET Degree-of-freedom set membership table for g-set

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

SIL Scalar index list

BGPDT Basic grid point definition table

USETD Degree-of-freedom set membership table for p-set

EQDYN Equivalence table between external and internal grid/scalar/extra point


identification numbers

SILD Scalar index list for p-set

AEUSET Degree-of-freedom set membership table for ks-set

AEBGPDT Basic grid point definition table for the ks-set

ESTDATA Table of superelement estimation data overrides

TIMSIZ Table of CPU and disk space estimation parameters

11-202 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SGPDT Superelement basic grid point definition table

Parameters:

KEY Input-character-default=‘FINDIT’. Identifies the generic name of the data block.

OPTi 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 All sets in the following table

0 Mutually exclusive sets only; that is, sets M, SB, SG, O, Q, R, C, BE, BF,
E, SA, K, and A.

>0 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 EquivalentDecimalNumber

Q 4194304

BE 2097152

C 1048576

K 262144

SA 131072

E 2048

SB 1024

SG 512

R 8

O 4

BF 2

DMAP Programmer's Guide 11-203


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

M 1

SETSTRi Input-character-default=’ ’ Set name string for the row sort (OPT1 = 0 or 10).
SETSTR1 through SETSTR4 form a single string of set name(s) 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 KEY

BGPDT BDPDT

CSTM CSTM

EQDYN EQEXIN

EQEXIN EQEXIN

ETT ETT

GPDT GPDT

GPL GPL

GPLD GPLD

GPTT GPTT

SEMAP SEMAP

any FINDIT

USET USET

If OPT3≠ 0;
TABPRT TABLE//NDDLNAME/OPT1//OPT3 $

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:

11-204 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

1 Print with labels defined under the DATABLK statement for data
block name specified for parameter KEY

2 Same as OPT3=1 and any data with an undefined format is printed


as "???"

3 Same as OPT3=2 except only print records with undefined formats

-1 Print without labels

Format 2: (KEY=’USET’):
Input-integer-default=0.
OPT1
Controls the tabular printout of the degree of freedom sets.

Sequence Print USETPRT

None None (default) -1

Row sort only 0

Internal Column sort only 1

Row and column sort 2

Row sort only 10

External Column sort only 11

Row and column sort 12

The degrees of freedom can be listed in ascending order according to their internal
or external sequence number, but not both. The external sequence number is the
grid, scalar, or extra point identification number. The internal sequence number is
the number assigned after resequencing.
For a given sequence, there are two types of tables that 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 D E F I N I T I O N T A B L E ( I N T E R N A L S E Q U E N C E , R O W S O R T )
A DISPLACEMENT SET
-1- -2- -3- -4- -5- -6- -7- -8- -9- -10-
1= 2-1 2-2

For column sort, a single table is printed for the following sets: SB, SG, L, A, F, N, G,
R, O, S, M, E. 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 1- 1 G 1 1 1 1
- 2 2- 2 2 2 2
- 3 3- 1 3 3 3
- 4 4- 2 4 4 4

DMAP Programmer's Guide 11-205


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

- 5 5- 3 5 5 5
- 6 6- 4 6 6 6

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
OPT2
corresponding decimal equivalent numbers. For example, sets A, L, and R are
selected with OPT2 = 128+256+8 = 392.

OPT2 Sets printed

-1 All sets in the following table

0 Mutually exclusive sets only; that is, sets M, SB, SG, O, Q, R, C, B, E, SA, K, and A.

>0 Selected sets according to the sum of their decimal equivalent numbers in the
following table

Table 11-1. Set Names and Their Decimal Equivalents.

Set name Decimal equivalent Set name Decimal equivalent


number number

V 33554432 P 4096

FR 16777216 E 2048

T 8388608 SB 1024

Q 4194304 SG 512

B 2097152 L 256

C 1048576 A 128

J 524288 F 64

K 262144 N 32

SA 131072 G 16

KS 65536 R 8

D 32768 O 4

FE 16384 S 2

NE 8192 M 1

11-206 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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:

OPT1 value Selection within record 2

0 All parts (GRID list and summaries of GRID list)

1 Only GRID List

2 Only Summaries of GRID List

-g GRID List for Pattern Starting with Entry GRID ID = G (if any)

10X+010X+2 Same as 0 or 2 but with Summary List.Selection based on X

X = 0, 1, 3, 5, or 7 - 1st Summary (sorted by 1st GRID)

X = 0, 2, 3, 6, or 7 - 2nd Summary (sorted by count)

X = 0, 4, 5, 6, or 7 - 3rd Summary (sorted by superelement)

100+X List all point IDs for any unique connection list produced by X

200+X Same as 100+X except that additional pure interior points are not listed.

300+X Same as 200+X except that additional nonresidual points are not listed

400+X Same as 100+X except that additional scalar points are not listed.

500+X Same as 200+X except that additional scalar points are not listed

600+X Same as 300+X except that additional scalar points are not listed

If OPT2 = 4, OPT1 chooses CSUPER entry as follows:

OPT1 value Meaning

>0 Write CSUPER Bulk Data entries for superelement OPT1

≤ 0 Write CSUPER Bulk Data entries for residual structure but give SEID = - OPT1

OPT2 Integer-default = 0. Print/punch selection as follows:

OPT2 value Meaning of selection

-1 No output (1, 2 and a record for each superelement)

0 Print contents of all records (1, 2 and a record for each superelement) of SEMAP
except last two

DMAP Programmer's Guide 11-207


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

OPT2 value Meaning of selection

1 Print only Record 1 contents

2 Print contents of Records 1 (except for OPT1 < 0) and 2 (see OPT1 for selection
options within Record 2)

3 Print contents of Records 1, 2 and a record for each superelement giving a list of
internal points, a list of external points, a list of elements, and estimation data
for the superelement. The third part of each superelement record (containing
the lists of primary superelement points to which a secondary superelement is
connected) is omitted.

4 Punch CSUPER entries according to OPT1 (see Remarks)

5 Print only Records 1 (except for OPT1 < 0), 2 (see OPT1 for selection options
within Record 2), and estimation data for each superelement

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 EMAP//’SEMAP’/1/4 $
TABPRT EMAP//’SEMAP’/-100/4 $

1 2 3 4 5 6 7 8 9 10

CSUPER 1 0 11 13 14

CSUPER 100 0 1 3 4 11 13 14

21 24 31 34 51 53 54 61

64 71 74 230 330 630 730

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 can be printed with
TABPRT. If ‘FINDIT’ (default) is specified, the KEY is taken from the header of the data block.

11-208 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 $

11.98 TABPT
Table printer
Prints table or matrix data blocks.

Format:

TABPT TAB1,TAB2,TAB3,TAB4,TAB5/ $

Input Data Blocks:

TABi Data block name

DMAP Programmer's Guide 11-209


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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 GEOM1/ $
TABPT GEOM1,GEOM2,GEOM3,GEOM4/ $

11.99 TAFF
Creates tables for follower force stiffness

Format:

TAFF SLT,BGPDT/
ESTF,GPECTF/
LUSET/LOADID/LOADIDP/LOADFACR/NBLOCK $

Input Data Blocks:

SLT Table of static loads

BGPDT Basic grid point definition table

Output Data Blocks:

ESTF Element summary table for follower force stiffness

GPECTF Grid point element connection table for follower force stiffness

Parameters:

LUSET Input-integer-default=0. The number of degrees-of-freedom in the g-set.

LOADID Input-integer-default=0. Load set identification number for the current subcase.

LOADIDP Input-integer-default=0. Load set identification number for the previous subcase.

11-210 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

LOADFACR Input-real-default=0.0. Load factor in nonlinear static analysis.

NBLOCK Input-integer-default=10. Number of spill blocks to form if “out-of-memory”


algorithm is used.

11.100 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 Table of static loads updated for heat transfer analysis

DLTH Table of dynamic loads updated for heat transfer analysis

EPT Table of Bulk Data entry images related to element properties

SIL Scalar index list

ESTNL Nonlinear element summary table

GPECT Grid point element connection table

DIT Table of TABLEij Bulk Data entry images

Output Data Blocks:

ESTNL1 Nonlinear element summary table updated for heat transfer analysis

GPECT1 Grid point element connection table for heat transfer analysis

Parameters:

LUSET Input-integer-no default. The number of degrees-of-freedom in the g-set.

DMAP Programmer's Guide 11-211


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

NOSIMP Output-integer-no default. The number of elements exclusive of general elements.


Set to -1 if there are no simple elements.

LOADID Input-integer-no default. Load set identification number for the current subcase.

STIME Input-real-default=0.0. On initial input, starting time step and on output,


accumulated time used for restarts.

Remarks:
DIT can be purged if DLTH does not reference tables in DIT.

11.101 TASNP1
Computes the shell normal vectors on a superelement‘s boundary

Format:

TASNP1 BGPDTS,GPECTS,GEOM1S,CSTMS/
SNORMS $

Input Data Blocks:

BGPDTS Basic grid point definition table for a superelement

GPECTS Grid point element connection table for a superelement

GEOM1S Table of Bulk Data entry images related to geometry for a superelement

CSTMS Table of coordinate system transformation matrices for a superelement

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.

11.102 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.

11-212 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Basic grid point definition table

BGPDTS Basic grid point definition table for a superelement

GPECT Grid point element connection table

GPECTS Grid point element connection table for a superelement

GEOM1 Table of Bulk Data entry images related to geometry

GEOM1S Table of Bulk Data entry images related to geometry for a superelement

CSTM Table of coordinate system transformation matrices

CSTMS Table of coordinate system transformation matrices for a superelement

SEMAP Superelement map table

SCSTM Table of global transformation matrices for partitioned superelements

SNORM* Family of shell normal vectors at superelement boundaries

Output Data Blocks:

GPSNT Grid point shell normal table

GPSNTS Grid point shell normal table for a superelement

Parameters:

SNORM Input-real-no default. Maximum angle between grid point normal and shell
normal. If angle is less than SNORM, grid point normal is computed.

SNORMPRT Input-integer-no default. Grid point shell normal print/punch flag.

0 No print or punch

DMAP Programmer's Guide 11-213


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

1 Punch

2 Print only

3 Print and punch

SEID Input-character-no default. Name of qualifier to be used in selecting SNORMS.

QUALNAM 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.

11.103 TEMPATT
Generates nodal temperature data at a given time instant for a time-assigned temperature load
(DTEMP or DTEMPEX). It also checks whether the solution time falls within the definition of the time
interval for the DTEMP or DTEMPEX bulk data entries.

Format:

TEMPATT CASECC,GEOM3,GEOM5,ETTORIG/TSETATT/
S,N,ERRTEMPATT/RSTIME/TEMPOPT/S,N,NEWTSETID/S,N,TIMEDEP/
S,N,TIMEINDT/TEMPINIT/TEMPLOAD/DTEMP $

Input Data Blocks:

CASECC Table of case control command images

GEOM3 Table of bulk data entry images related to static and thermal loads

GEOM5 Table of bulk data entry images related to thermal loads from external files

ETTORIG Element nodal temperature table that is created by the NLCOMB module

Output Data Blocks:

TSETATT Table containing TEMP and/or TEMPD bulk entries for interpolated nodal
temperature values at the time-instant, RSTIME. See Remark 1.

Parameters:

ERRTEMPATT Output-logical-no default. Output data of type logical for GO/NOGO flag. If
TRUE, abort.

RSTIME Input-real-no default. Current solution time

11-214 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

TEMPOPT Input-integer-no default. Calling options


=0 Determine if RSTIME for interpolation is inside or outside the definition of
DTEMP
=1 Compute the interpolated temperature bulk entries and store them in
TSETATT

NEWTSETID Output-integer-no default. The SID of the new temperature bulk entry for the
interpolated nodal temperature. See Remarks 3 and 4.

TIMEDEP Output-integer-no default. Notifies whether the subcase includes time-assigned


temperature loads
=1 if the subcase has time-dependent temperature load from
DTEMP/DTEMPEX
=0 if the subcase has time-unassigned temperature load from
TEMP(LOAD)=TEMP/TEMPD/TEMPEX
=-1 if the subcase has no temperature load

TIMEINDT Output-integer-no default. Notifies whether the solution time RSTIME is inside
or outside the interval of definition of DTEMP or DTEMPEX
=0 if RSTIME is outside the interval of definition of DTEMP or DTEMPEX
=1 if RSTIME is inside the interval of definition of DTEMP or DTEMPEX
=-1 if not applicable such as when the subcase does not include DTEMP or
DTEMPEX

TEMPINIT Input-integer-no default. Required if the current subcase is MODAL subcase.


Set ID specified for TEMP(INIT) of the last static subcase that comes before
the current modal subcase. Set to 0 if the last static subcase does not have
TEMP(INIT). Set to -1 for static a subcase in which CASECC is specified. See
Remark 2.

TEMPLOAD Input-integer-no default. Required if the current subcase is a MODAL subcase.


Set ID specified for TEMP(LOAD) of the last static subcase that comes before
the current modal subcase. Set to 0 if the last static subcase does not have
TEMP(LOAD). Set to -1 for a static subcase in which CASECC is specified.
See Remark 2.

DTEMP Input-integer-no default. Required if the current subcase is a MODAL subcase.


Set ID specified for DTEMP of the last static subcase that comes before the
current modal subcase. Set to 0 if the last static subcase does not have DTEMP.
Set to -1 for a static subcase in which CASECC is specified. See Remark 2.

Remarks:

1. If the solution time, RSTIME, lies within the definition of the DTEMP or DTEMPEX bulk entry,
the nodal temperatures are interpolated by linear interpolation. If RSTIME lies outside the time
domain of the DTEMP or DTEMPEX bulk entry, the temperature values are step-extension.

2. For a modal subcase, CASECC may not have TEMP(INIT), TEMP(LOAD), or DTEMP. These
values should be provided for the previous static subcase preceding the modal subcase.

DMAP Programmer's Guide 11-215


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Therefore, for the MODAL subcase, instead of CASECC, the values of TEMPINIT, TEMPLOAD
and DTEMP should be provided as input.

3. If the subcase has DTEMP case control only, such as time-assigned temperatures with DTEMP
or DTEMPEX, the NEWTSETID is the ID of the new temperature set in TSETATT.

4. If the subcase has TEMP(LOAD) only, the value of NEWTSETID will be same as TEMP(LOAD).

11.104 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 $

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 $

11-216 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Option 7: Sparse kernel timing

TIMETEST TIMTS3,,,,/TOUT7,/N/M/ /7 $

Option 8: Element timing

TIMETEST TIMTS8,,,/TOUT8,/ / / /8/CASE $

Input Data Blocks:

TIMTS3 Table created with DTI entries as follows:

1 2 3 4 5 6 7 8 9 10

DTI TIMTS3 IREC CASE M N P

CASE = Record number (null records are ignored so records can be numbered by tens for
convenience in making changes) IREC

CASE = “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 = Number of terms in inner loop

N = Number of terms in outer loop

P = Number of times kernel is called

TIMTS4 Table created with DTI entries as follows:

1 2 3 4 5 6 7 8 9 10

DTI TIMTS4 IREC CASE ROWS COLS DENS STRL

IREC Record number (null records are ignored so records can be numbered by tens for
convenience in making in making changes)

CASE “A” normal case definition.“B” indicates the last case to be used in the least
squares solution for timing constants.
Note

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.

DMAP Programmer's Guide 11-217


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

ROWS Number of rows the matrix is to have

COLS Number of columns the matrix is to have

DENS Density to be used in building the matrix

STRL String length to be used in building the matrix

TIMTS5 (for CASE=1 only) Table created with DTI entries as follows:

1 2 3 4 5 6 7 8 9 10

DTI TIMTS5 IREC CASE ROWS COLS DENS TYPE STRL

TIMTS5 (for both cases) Table created with DTI entries as follows:

1 2 3 4 5 6 7 8 9 10

DTI TIMTS5 IREC CASE T CORE METHOD

IREC Record number (null records are ignored so records can be numbered by tens for
convenience in making in making changes)

CASE “CASE” normal case definition.“END” indicates the last case to be used.

Note

The T, CORE, and METHOD field are not populated when this form of the case is used.

T Value to be used

CORE Size of the core to be used

METHOD Method to be used

TlMTS8 Element generation and assembly timing.

Output Data Blocks:

TOUT, TOUTi Timing results

N Options 1 and 2: n* - Default = 50. External loop index.


Options 3, 4, and 5: Scale Factor. Negative value means scale down. Value 0 or
1 means do not change. Positive value means scale up.
Options 6 and 8: Not used.

11-218 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Input/Output Operations (default) (old)

2 Arithmetic Operations (old)

3 Matrix Timing Operations (new)

4 Kernel Timing Operations (new)

5 MPYAD Timing Operations CASE = 1 (new). Uses data in DTI file.


MPYAD Timing Operations CASE = 2 (new). Uses data defined by
remaining arguments.

6 KERNDB Data Block Generation (new)

7 Sparse Kernel Timing (new)

8 Element Timing (new)

CASE Options 1 and 2: Default = 0. Code indicating which unit operations are to be
tested.

If OPT = 1, CASE means:

1 WRITE

2 READ

4 READ BACKWARDS

8 BLDPK

16 INTPK

32 PACK

64 UNPACK

128 PUTSTR

DMAP Programmer's Guide 11-219


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

256 GETSTR

If OPT = 2, CASE means:

1 RSP

2 RDP

4 CSP

8 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.

11.105 TOLAPP
Appends nonlinear data and Case Control for data recovery

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 Table of Case Control command images

11-220 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

CASEXX Subset of CASECC for current loop

MPT Table of Bulk Data entry images related to material properties

TEL Transient response time output list appended from each subcase

ESTNL Nonlinear element summary table

Output Data Blocks:

TOL Transient response time output list for all subcases

OLF Nonlinear load factors for all subcases

TOL1 Transient response time output list for the current subcase

CASECCR Table of Case Control command images for data recovery

Parameters:

TOLAPPF Input-integer-no default. Nonlinear analysis type:

0 Nonlinear transient

1 Nonlinear statics

NSOUT Input-integer-default=0. Number of time steps to output. By default, all time


steps are output.

NSKIP Input/output-integer-default=1. CASECC record counter or nonlinear transient


loop identification number.

NEWP Input/output-integer-default=1. New subcase flag.

-1 Current subcase has not been completed.

1 Current subcase has been completed.

POUTF Output-integer-default=1. Intermediate output flag. Set to -1 if intermediate output


is not requested.

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.

DMAP Programmer's Guide 11-221


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.106 TOPOPT
Performs Topology optimization with the LMS implementation of the GCMMA optimizer.

Format:

TOPOPT EFILL,OBJMA,SENSMA,DVARMA,WMEMIN,FORCEM,BEGCM/EFILLI,WMEMOUT,/
ITOITCNT/ITOMXITR/ITOPOPT/ITOOPITR/S,Y,DONE/
ITODENS/ITOSIMP/ITORMAS/ITONGHBR/
ITOPDIAG/ITOPALG/ITOPCONV/ITOPALLR $

Input Data Blocks:

EFILL Element fill table.

OBJMA Objective matrix.

SENSMA Sensitivity matrix.

DVARMA Design variable matrix.

WMEMIN Cached working memory.

FORCEM Force matrix.

BEGCM Boolean element-grid connectivity matrix.

Output Data Blocks:

EFILLI Updated EFILL table for subsequent iterations.

WMEMOUT Updated cached working memory.

Parameters:

ITOITCNT Input-integer, no default. The counter of iterations.

ITOMXITR Input-integer, no default. The maximum number of iterations.

ITOPOPT Input-integer, no default. Optimizer option:

1 External optimization branch.

2 Embedded optimization with LMS optimizer.

4 Embedded optimization with GCMMA optimizer.

ITOOPITR Input-integer, no default. The number of the optimum iteration.

DONE Output-integer, no default. The completion flag of the optimization.

11-222 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

ITODENS Input-real, no default. The density of the material assigned to the elements in
the EFILL list.

ITOSIMP Input-integer-default=0. Penalty factor. ITOSIMP=1 to active penalty factor.

ITORMAS Input-real, no default. The residual mass of the structure to be optimized.

ITONGHBR Input-integer, default=0. Flag for checkerboard filter. ITONGHBR=1 to enable


checkerboard filter.

ITOPDIAG Input-integer, default= -1. Diagnostic level.

ITOPALG Input-integer, default= -1. Algorithm type.

ITOPCONV Input-real, default=0.0. Convergence threshold.

ITOPALLR Input-integer, default=0. Helps control the size of opt and punch file. By default,
output only occurs for the last iteration.

11.107 TRD1
Solves for modal/direct transient analysis displacement, velocity, and acceleration solution.

Format:

TRD1 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,SILD,USETD,
PARTVEC,MIC/
UXT,PNL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/SETNAME/S,N,NMODES $

Input Data Blocks:

CASECC Table of Case Control command images

TRL Transient response list

NLFT Nonlinear Forcing function table

DIT Table of TABLEij Bulk Data entry images

KXX Stiffness matrix in any set. Usually h- or d-set.

BXX Viscous damping in any set. Usually h- or d-set.

MXX Mass matrix in any set. Usually h- or d-set.

PXT Transient response load matrix in h-set (modal) or d-set

DMAP Programmer's Guide 11-223


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

SILD Scalar index list for the p-set. Required for maximum efficiency during symmetric
decomposition and if KXX represents the d-set or a subset of the d-set
(SETNAME=‘D‘).

USETD Degree-of-freedom set membership table for the p-set. Required for maximum
efficiency during symmetric decomposition and if KXX represents the d-set or a
subset of the d-set (SETNAME=‘D‘).

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, 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.

MIC Initial conditions for modal coordinates. Only valid for SOLTYP=’MODAL’.

Output Data Blocks:

UXT Solution matrix from transient response analysis in d- or h-set. For


SOLTYP=’PHYSMOD’, this is the initial conditions matrix input by the user in d-set
with column 1 being initial displacements and column 2 being initial velocities.

PNL Nonlinear load matrix appended from each output time step

Parameters:

SOLTYP Input-character-no default. Solution method.

‘MODAL’ Usually for h-set matrices

‘DIRECT’ Usually for d-set matrices

‘IC’ Initial conditions for direct transient analysis.

‘PHYSMOD’ Initial conditions for modal transient analysis.

‘DIRMOD’ Same as ‘DIRECT’, but for mode acceleration with initial conditions.

NOUE Input-integer-no default. Number of extra points.


Set to -1 if there are no extra points.

NONCUP Input-integer-default=0. Algorithm selection. NONCUP=-1 requests uncoupled


algorithm if SOLTYP=‘MODAL’and KXX, BXX, and MXX are diagonal.
NONCUP=-2 requests uncoupled algorithm and off-diagonal terms of KXX, BXX,
and MXX is ignored.

NCOL Input/output-integer-default=0. Number of time steps in the solution matrix UXT


prior to execution of TRD1.

11-224 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

FAC3 Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step


increment.

SETNAME Input-character-default=‘H’ Degree-of-freedom set name represented by KXX,


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.

NMODES Input-integer-default=0. Number of modes for SOLTYP=’PHYSMOD’ and user


has entered modal initial conditions. Must be zero if SOLTYP=’PHYSMOD’ and
user has entered non-modal initial conditions.

Remarks:
1. NLFT and PNLD1 cannot be purged if nonlinear loads are selected in CASEXX.

2. NCOL>0 indicates a restart.

3. Only CASECC, TRL, and UXT are required for SOLTYP=PHYSMOD. UXT is the matrix of initial
conditions.

11.108 TRD2
Solves for modal/direct, transient, displacement, velocity, and acceleration solution

Format:

TRD2 CASECC,TRL,NLFT,DIT,KXX,BXX,MXX,PXT,DSPT1,SILD,
USETD,PARTVEC/
UXT,PNL,TOL/
SOLTYP/NOUE/NONCUP/S,N,NCOL/FAC3/TRD2OPT/SETNAME $

Input Data Blocks:

CASECC Table of Case Control command images

TRL Transient response list

NLFT Nonlinear Forcing function table

DIT Table of TABLEij Bulk Data entry images

KXX Stiffness matrix in any set. Usually h- or d-set.

BXX Viscous damping in any set. Usually h- or d-set.

MXX Mass matrix in any set. Usually h- or d-set.

PXT Transient response load matrix in h-set (modal) or d-set

DMAP Programmer's Guide 11-225


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

DSPT1 Design sensitivity processing table

SILD Scalar index list for the p-set. Required for maximum efficiency during symmetric
decomposition and if KXX represents the d-set or a subset of the d-set
(SETNAME=‘D‘).

USETD Degree-of-freedom set membership table for the p-set. Required for maximum
efficiency during symmetric decomposition and if KXX represents the d-set or a
subset of the d-set (SETNAME=‘D‘).

PARTVEC Partitioning vector with values of 1.0 at the rows corresponding to degrees of
freedom which were eliminated in the partition to obtain KXX, 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.

Output Data Blocks:

UXT Solution matrix from transient response analysis in d- or h-set

PNL Nonlinear load matrix appended from each output time step

TOL Transient response time output list

Parameters:

SOLTYP Input-character-no default. Solution method.

‘MODAL’ Modal; usually for h-set matrices

‘DIRECT’ Direct; usually for d-set matrices

‘IC’ Initial conditions for nonlinear transient analysis

NOUE Input-integer-no default. Number of extra points. Set to -1 if there are no extra
points.

NONCUP Input-integer-default=0. Algorithm selection. NONCUP=-1 requests uncoupled


algorithm if SOLTYP=‘MODAL’and KXX, BXX, and MXX are diagonal.
NONCUP=-2, requests uncoupled algorithm and off-diagonal terms of KXX, BXX,
and MXX are ignored.

NCOL Input/output-integer-default=0. Number of time steps in the solution matrix UXT


prior to execution of TRD1.

FAC3 Input-complex-default=(1.0,0.0). Negative of the reciprocal of the time step


increment.

TRD2OPT Input-integer-default=1. TRD2 output option.

1 Output based on TSTEP Bulk Data entry

11-226 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

2 Output based on every time step

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.

11.109 TRLG
Generates applied loads in transient analysis

Format:

TRLG CASECC,USETD,DLT,SLT,BGPDT,SIL,CSTM,TRL,DIT,
GMD,GOD,{PHDH or RPX},EST,MPT,MGG,V01P/
{PPT or PPT},PST,PDT,PDT1,{PHT or PXT},TOL,DLTH,
YPT,YPO/
S,N,NOSET/S,N,PDEPDO/IMETHOD/STIME/BETA/
S,N,FAC1/S,N,FAC2/S,N,FAC3/TOUT/TABS/OPT $

Input Data Blocks:

CASECC Table of Case Control command images

USETD Degree-of-freedom set membership table for p-set

DLT Table of dynamic loads

SLT Table of static loads

BGPDT Basic grid point definition table

SIL Scalar index list

CSTM Table of coordinate system transformation matrices

TRL Transient response list

DIT Table of TABLEij Bulk Data entry images

GMD Multipoint constraint transformation matrix with extra points, m-set by ne-set

DMAP Programmer's Guide 11-227


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

GOD Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set

PHDH Transformation matrix from d-set to h-set (modal)

RPX Reduction matrix from p-set to h-set (modal) or d-set

EST Element summary table.

MPT Table of Bulk Data entry images related to material properties

MGG Mass or radiation matrix in g-size

V01P Partitioning vector for sparse load reduction

Output Data Blocks:

PPT Transient response load matrix in the p-set for output time steps

PST Transient response load matrix in the s-set for output time steps

PDT Transient response load matrix in the d-set for output time steps

PDT1 Transient response load matrix in the d-set for all time steps

PHT Transient response load matrix in the h-set (modal) for all time steps

PXT Transient response load matrix in the h-set (modal) or d-set for all time steps
only when RPX is input and TOUT=2

TOL Transient response time output list

DLTH Table of dynamic loads updated for heat transfer analysis

YPT Transient response enforced motion matrix in the p-set

YPO Transient response enforced motion matrix in the p-set and for the output time
steps

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

PDEPDO 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.

11-228 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

0 Linear analysis

-1 AUTO or TSTEP method (NLTRD module)

2 ADAPT method (NLTRD2 module)

STIME Input-real-default=0.0. Accumulated time used for restarts.

BETA Input-complex-default=(.33333,0.0). Integration parameter.

FAC1 Output-complex-default=(0.0,0.0). Square of the reciprocal of the time step


increment. Imaginary part is always zero.

FAC2 Output-complex-default=(0.0,0.0). Reciprocal of twice the time step increment.


Imaginary part is always zero.

FAC3 Output-complex-default=(0.0,0.0). Negative of the reciprocal of the time step


increment. Imaginary part is always zero.

TOUT Input-integer-default=-1. Processing flag.

<1 Use NOi on TSTEP Bulk Data entry

1 All time steps

2 Same as <1 except RPX is input

TABS Input-real-default=0.0. Absolute temperature conversion. For example, set to


273.16 when specifying temperatures in Celsius, or set to 459.69 when specifying
temperatures in Fahrenheit.

OPT 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

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.

DMAP Programmer's Guide 11-229


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.110 TRNSP
Matrix transpose
Computes [X] = [A]T.

Format:

TRNSP A/X $

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.

11.111 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:

11-230 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

TYPE PARM, NDDL, ptype, , prmlist $

3. Local parameters:

TYPE PARM,,ptype, , prmlist = [default] $

Describers:

dblist A list of NDDL data blocks. Each data block must be separated by a comma or
a space.

ptype Parameter type. Possible parameter types are as follows:

Description ptype

Integer I

Real single precision RS

Real double precision RD

Complex single precision CS

Complex double precision CD

Character CHARi, where i = 1-80

Logical LOGICAL

Remarks:

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.

prmlist A list of parameters. Each parameter must be separated by a comma or a space.

default 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.

NDDL Keyword that identifies parameters or qualifiers defined in the NDDL.

DMAP Programmer's Guide 11-231


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

1. Within any subDMAP, parameters are typed at first occurrence in either a TYPE statement
or a DMAP module. Parameters occurring in Assignment(=) statements must be defined in a
previous DMAP module or TYPE statement.

2. A TYPE statement is required for a parameter if it appears first in one of the following instructions:
• CALL

• MESSAGE

• Assignment

• Conditional (IF and DO WHILE)

• DBVlEW module (WHERE clause if its not a qualifier)

3. Default values for NDDL parameters and qualifiers are specified on the PARAM and QUAL NDDL
statements and, if specified on the TYPE statement, result in a warning message.

4. With the exception of parameters declared as QUALifiers through the QUAL NDDL statement, all
NDDL parameters are stored immediately in the database on completion of a DMAP assignment
statement or the module S option.

5. As described under 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. Siemens PLM Software 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.

11-232 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Examples:

The following TYPE PARM statements show how parameters are typed in a subDMAP. Note the
use of comments.
$
$ QUALS
TYPE PARM,NDDL,I,Y,MODEL,SOLlD,SElD,BASE $
$ IFP PARAMETERS
TYPE PARM,NDDL,I,Y,ERROR,NOTRED,ASING,MODACC,FIXEDB,
BAILOUT $
TYPE PARM,NDDL,RS,,MAXRATIO $
$ LOCAL PARAMETERS PASSED IN OR OUT
TYPE PARM,,I,,GO,NOSSET,NOOSET,UNSYM=6,NORC,NOQSET,
DONOGO,LOOPERR,NOTSET,ERRNO,RESlD,ACON,NOASM,
NORSET,NOLSET $
$ LOCAL PARAMETERS TO THIS SUB DMAP
TYPE PARM,,I, ,NOKFF,QNOTNULL,NOKQQl $
TYPE PARM,,CHAR8,N,APP,F=’F’ $
$
A typical TYPE DB statement is as follows:
TYPE DB A,B,C,D,
U,V,W,X,Y,Z $

11.112 UEIGL
Solves both linear and quadratic real unsymmetric eigenvalue problems

Format:

UEIGL KXX,QXX,MXX,DYNAMIC,CASECC,SVEC,BP,APL,APU/
PHX,ULAMA,PHXL,XORTH,LAMMAT,CLAMMAT,LAMA/
S,N,NEIGV/SID/F1/F2/ND/EPS $

Input Data Blocks:

KXX Stiffness matrix in any set

QXX Aerodynamic matrix in any set for the linear unsymmetric eigensolution

MXX Mass matrix in any set for the quadratic unsymmetric eigensolution

DYNAMIC Table of Bulk Data entry images related to dynamics

CASECC Table of Case Control command images

SVEC Starting "random" eigenvector matrix

BP Null space B matrix

APL Lower triangular factor of null space A matrix

APU Upper triangular factor of null space A matrix

DMAP Programmer's Guide 11-233


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

Output Data Blocks:

PHX Right eigenvector matrix for real eigenvalues only

ULAMA Unsymmetric eigenvalue summary table

PHXL Left eigenvector matrix for real eigenvalues only

XORTH Cross-orthogonality matrix

LAMMAT Diagonal matrix with real eigenvalues on the diagonal

CLAMMAT Diagonal matrix with complex eigenvalues on the diagonal

LAMA Normal modes eigenvalue summary table

Parameters:

NEIGV Output-integer-no default. The number of eigenvectors found. Set to -1 if none


were found.

SID Input-integer-default=0. Alternate set identification number.


If SID=0, the set identification number is obtained from the UMETHOD command
in CASECC and used to select the EIGUL Bulk Data entry in DYNAMIC.
If SID>0, 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 Input-real-default=0.0. The lower frequency/eigenvalue bound.

F2 Input-real-default=0.0. The upper frequency/eigenvalue bound. The default value


of 0.0 indicates machine infinity.

ND Input-integer-default=0. The number of desired eigenvalues.

EPS Input-real-default=0.0. Convergence criterion. By default, EPS 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:

11-234 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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

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.

11.113 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 Displacement matrix at converged step in the g-set

DUGNI Incremental displacement matrix between the last two converged steps

SIL Scalar index list

DMAP Programmer's Guide 11-235


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

11.114 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 USET table output from module GP4 or GPSP (or USETD table from DPD for
dynamics or AEUSET table from APD for aerodynamics)

Aij Matrix partitions

Output Data Block:

A Assembled matrix

Parameters:

MAJOR Character-input-no default. Major degree-of-freedom set name. See Remarks.


Character-input-default=‘COMP’ Subset degree-of-freedom names. See
SETi
Remarks.

11-236 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Remarks:

1. The supersets formed by the union of other sets have the following definitions.

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’$

DMAP Programmer's Guide 11-237


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

2. Expand PHA to g-set size.


a. UMERGE USET,PHA,/PHG/‘G‘/‘A’$
b. UMERGE USET,,PHA/PHG/‘G‘//‘A’$
3. Expand PHRC with rows corresponding to the r and c-set to the union of the t, o, and m-sets.
UMERGE USET,PHRC,/PHTOM/‘T+O+M‘/‘R+C’$

11.115 UMERGE1
Merges two matrices based on USET

Format:

UMERGE1 USET,A11,A21,A12,A22/A/MAJOR/SET1/SET2/IOPT $

Input Data Blocks:

USET USET table output from module GP4 or GPSP (or USETD table from DPD for
dynamics or AEUSET table from APD for aerodynamics)

Aij Matrix partitions with rows and columns that correspond to degrees-of-freedom
in the USET table

Output Data Block:

A Assembled matrix

Parameters:

MAJOR Character-input-no default. Major degree-of-freedom set name. See Remarks.

SETi Character-input-default=‘COMP’ Subset degree-of-freedom names. See


Remarks.

IOPT Integer-input-default = 0. IOPT chooses between square and rectangular.

IOPT = 0 IOPT = 1 IOPT = 2

Remarks:
The supersets formed by the union of other sets have the following definitions:

11-238 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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.

DMAP Programmer's Guide 11-239


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.116 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 USET table output from module GP4 or GPSP (or USETD table from DPD for
dynamics or AEUSET table from APD for aerodynamics)

A Any matrix with rows or columns that correspond to degrees-of-freedom in the


USET table

Output Data Blocks:

Aij Matrix partitions

Parameters:

MAJOR Character-input-no default. Major degree-of-freedom set name. See Remarks.

SETi Character-input-default=‘COMP’ Subset degree-of-freedom names. See


Remarks.

IOPT Integer-input-default = 0. IOPT chooses between a symmetric partition and a


vector partition. A vector partition is performed if IOPT = 1 or 2.

IOPT = 0 IOPT = 1 IOPT = 2

Remarks:

1. The supersets formed by the union of other sets have the following definitions:

11-240 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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’$
c. UPARTN USET,KFF/KOO,KAO,KOA,KAA/‘F‘/‘O’$

DMAP Programmer's Guide 11-241


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

2 Extract PHRC, with rows corresponding to the union of the r and c-set, from PHTOM, with rows
corresponding to the union of the t, o, and m-sets.
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 $

11.117 UPGLSTF
Creates/updates glue stiffness in SOL 401.

Format:

UPGLSTF GNELM,BGPDT,CSTM,UGVBAS/ELGNST/NLHEAT/NROW/K6ROT $

Input Data Blocks:

GNELM Glue element definition table

BGPDT Basic grid point data table

CSTM Table of coordinate system transformation matrices

UGVBAS G-set displacements in basic coordinate system

Output Data Blocks:

ELGNST Glue element stiffness table

Parameters:

NLHEAT Input-logical-no default. Currently always set to FALSE for SOL 401

NROW Input-integer-no default. Number of rows in G-set

K6ROT Input-real-default=100.0. Specifies the stiffness to be added to the normal rotation


for CQUAD4 and CTRIA3 elements.

11.118 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.

11-242 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

UREDUC

XD,XH,XS $

Input Data Blocks:

XP Rectangular matrix of displacements or loads in the p-set

XG Rectangular matrix of displacements or loads in the g-set

USETD Degree-of-freedom set membership table for p-set

USET Degree-of-freedom set membership table for g-set

GMD Multipoint constraint transformation matrix with extra points, m-set by ne-set

GM Multipoint constraint transformation matrix, m-set by n-set

GOD Omitted degree-of-freedom transformation matrix with extra points, o-set by d-set

GOA Omitted degree-of-freedom transformation matrix, o-set by a-set

PHDH Transformation matrix from d-set to h-set (modal)

PHA Normal modes eigenvector matrix in the a-set

Output Data Blocks:

XD Rectangular matrix of displacements or loads in the p-set

XH Rectangular matrix of displacements or loads in the h-set (modal)

XS Rectangular matrix of displacements or loads in the s-set

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.

DMAP Programmer's Guide 11-243


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

11.119 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 Table of Case Control command images

EQDYN Equivalence table between external and internal grid/scalar/extra point


identification numbers. (EQEXIN appended with extra point data).

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

USETD Degree-of-freedom set membership table for p-set

USET Degree-of-freedom set membership table for g-set

UXY Solution matrix from dynamic analysis (transient, frequency, normal or complex
modes) in the d- or h-set

OL Complex or real eigenvalue summary table, transient response time output list or
frequency response frequency output list

XYCDB Table of x-y plotting commands

PNL Nonlinear load matrix appended from each output time step

Output Data Blocks:

OUXY1 Table of displacements in SORT1 format for h-set or d-set

OPNL1 Table of nonlinear loads in SORT1 format for the h-set or d-set

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

11-244 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

‘REIGEN’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘CEIGEN’ Complex eigenvalues

SOLTYP Input-character-no default. Solution method.

‘MODAL’ Modal

‘DIRECT’ Direct

NOSORT2S Output-integer-no default. Solution set SORT2 format flag. Set to 1 if SORT2
format or x-y plotting is requested for the solution set; -1 otherwise.

NOSOUT Output-integer-default=0. Solution set (d- or h-set) output flag. Set to 1 if any
solution set output is requested; -1 otherwise.

NOSDR2 Output-integer-no default. Physical set (g-set) output flag. Set to 1 if any physical
set output is requested in CASECC or XYCDB; -1 otherwise.

FMODE Input-integer-no default. The lowest mode number resulting from LMODES or
LFREQ and HFREQ.

NOSORT2 Output-integer-default=0. Physical set SORT2 format flag. Set to 1 if SORT2


format is requested or XYCDB is present; -1 otherwise.

Remarks:

1. PP can be purged only if UDV is purged.

2. PNL, XYCDB, OUXY1, and OPNL1 can be purged.

11.120 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 Table of Case Control command images

DMAP Programmer's Guide 11-245


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

EQDYN Equivalence table between external and internal grid/scalar/extra point


identification numbers.

USET Degree-of-freedom set membership table for g-set.

MDEN 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.

OL Modal frequency response frequency output list.

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

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 Output-integer-no default. SORT1 format flag. Set to 1 if SORT1 format is


requested; -1 otherwise

NOOUT Output-integer-default=0. OFP output flag. Set to 1 if any OFP output is


requested; -1 otherwise.

FMODE Input-integer-no default. The lowest mode number resulting from LMODES or
LFREQ and HFREQ parameters.

11.121 VDRMC
Creates modal contribution tables based on modal contribution output requests.

11-246 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

VDRMC CASEG,SETMC,AMC,NMC,MAG,APC,NPC,PNLLST,OL,MFRQ,ECT,BGPDT,TEXTSE/
OUTFLE/
APP/S,N,NOSORT2/S,N,NOSOUT/FMODE/IRTYPE/FSFLAG $

Input Data Blocks:

CASEG Table of Case Control command images for current subcase.

SETMC Table of SETMC Case Control definitions.

AMC Absolute modal contributions results matrix.

NMC Normalized modal contributions results matrix.

MAG Magnitudes of modal contributions matrix.

APC Absolute panel contributions results matrix.

NPC Normalized panel contributions results matrix.

PNLLST Panels list table.

OL Complex eigenvalue summary table, transient response time output list, or


frequency response frequency output list.

MFRQ Vector of modal frequencies.

ECT Element connectivity table.

BGPDT Basic grid point definition table.

TEXTSE Directory table for external superelement.

Output Data Blocks:

OUTFLE Table of modal contributions in SORT1 format.

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

‘CEIGEN’ Complex eigenvalues

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

NOSORT2 Output-integer-no default. Solution set SORT2 format flag. Set to 1 if SORT2 format
is requested; -1 otherwise.

DMAP Programmer's Guide 11-247


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

NOSOUT Output-integer-default=0. Output flag. Set to 1 if any output is requested; -1


otherwise.

FMODE Input-integer-no default. The lowest mode number resulting from LMODES or
LFREQ and HFREQ.

IRTYPE Input-integer-default=1. Modal contributions results type.


1 = displacements
2 = velocities
3 = displacements and velocities
4 = accelerations
5 = displacements and accelerations
6 = velocities and accelerations
7 = displacements, velocities, and accelerations
8 = SPC forces
9 = element forces
10 = element stresses
11 = element strains

FSFLAG Input-integer-default=0. Fluid/structure flag. Only applies to IRTYPEs 1 thru 7.


0 = structural modal contribution results from structural modes
1 = fluid modal contribution results from structural modes
11 = fluid modal contribution results from fluid modes

Remarks:

1. ECT may be purged if IRTYPE>8.

2. BGPDT may be purged if IRTYPE<9.

3. The existence of TEXTSE indicates that an external superelement is being processed. Thus, in
this case, ECT and BGPDT may be purged, since they won’t be used.

4. If constraint modes are present, their combined effect will appear as mode number -1 in OUTFLE
and will be printed to the .f06 file with the label “C/M”.

5. Modal contribution totals will appear as mode number 0 in OUTFLE and will be printed to the .f06
file with the label “TOTAL”.

6. APC and PNLLST are only valid for acoustic analysis in SOL 111. They are optional and may
be purged.

11.122 VDRPC
Creates panel or grid contribution tables based on panel/grid contribution output requests.

11-248 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Format:

VDRPC

Input Data Blocks:

CASEG Table of Case Control command images for current subcase.

SETMC Table of SETMC Case Control definitions.

APC Absolute panel contributions results matrix.

NPC Normalized panel contributions results matrix.

MAG Magnitudes of modal contributions matrix.

FOL Frequency response frequency output list.

BGPDT Basic grid point definition table.

PNLLST Panels list table (for DATTYP=1).

SLGRIDS List of selected grids (for DATTYP=2).

Output Data Blocks:

OUTFLE Table of panel or grid contributions in SORT1 format.

Parameters:

APP Input-character-no default. Analysis type. Allowable values:

‘FREQRESP’ Frequency response

NOSORT2 Output-integer-no default. Solution set SORT2 format flag. Set to 1 if SORT2 format
is requested; -1 otherwise.

NOSOUT Output-integer-default=0. Output flag. Set to 1 if any output is requested; -1


otherwise.

DMAP Programmer's Guide 11-249


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

IRTYPE Input-integer-default=1. Panel contributions results type.


1 = pressures
2 = first derivative of pressures
3 = pressure and first derivatives
4 = second derivative of pressures
5 = pressures and second derivatives
6 = first and second derivative of pressures
7 = pressures, first derivatives, and second derivatives

DATTYP Input-integer-no default. Data type.


1 = panel contributions
2 = grid contributions
3 = reciprocal panel contributions

Remarks:
1. Contribution totals will appear as ID number 0 in OUTFLE and will be printed to the .f06 file
with the label “TOTAL”.

2. None of the data blocks can be purged.

11.123 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 1 (Partitioning Vector):

VEC USET,/CP/MAJOR/SET1/SET2/UNUSED4/SET3 $

Format 2 (DOF Vector):

VEC USET,BGPDT/DOFVEC/MAJOR//SET2 $

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)

BGPDT Basic grid point definition table.

Output Data Block:

CP Partitioning vector

DOFVEC Dof vector

11-250 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

Parameters:

MAJOR Character-input-no default. Major degree-of-freedom set name. See Remarks.

SETi Character-input-default=‘COMP’ Subset degree-of-freedom names. See


Remarks.

UNUSED4 Integer-input-default=0. Unused and can be unspecified.

SET3 Character-input-default=’ ’

Remarks:

The supersets formed by the union of other sets have the following definitions:

1. For format 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. For format 1, 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. For format 2, MAJOR corresponds to the size of USET and SET2 corresponds to the required
set within USET. DOFVEC will contain two columns of real values for each dof in the SET2 set;
column 1 will contain the grid numbers and column2 will contain the corresponding direction
numbers. DOFVEC will be the length of the SET2 set. Scalar dof are ignored.

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 (-)

DMAP Programmer's Guide 11-251


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

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.

Examples:
1. To partition [Kff] into a- and o-set based matrices, use
VEC USET,/V/‘F‘/‘O’$
PARTN KFF,V,/KOO,KAO,KOA,KAA $

Note that the same thing can be done in one step by:
UPARTN USET,KFF/KOO,KAO,KOA,KAA/‘F‘/‘O’$

2. Example 1 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’$

4. To generate a DOFVEC of the f-set degrees-of-freedom contained within USET:


VEC USET,BGPDT/DOFVEC/’G’//’F’ $

11.124 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 Any matrix with rows corresponding to the g-set or p-set in the global coordinate
system. An example is a displacement or load matrix.

BGPDT Basic grid point definition table

11-252 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

SCSTM Table of global transformation matrices for partitioned superelements

CSTM Table of coordinate system transformation matrices

CASECC Table of Case Control command images

LAMA Normal modes eigenvalue summary table

USET Degree-of-freedom set membership table for g-set

MEDGE Edge table for p-element analysis

X66P Previous output of X66, usually at g-set. Used by IOPT=9, when setnam<>‘g‘, as
a baseline to compare against the non-g-set results in X66.

VGQ Partitioning vector with values of 1.0 at rows corresponding to degrees-of-freedom


in the q-set.

RBF Rigid body force matrix

UNUSED8 Unused and can be purged

Output Data Block:

XOUT Output matrix or table as described in Remark 1

RESMAX Resultant or maxima matrix that is printed out with IOPT=1 or 5

HEADCNTL List of integer codes for header print control in the DISUTIL module under IOPT=1
or 5

x66 Triple-product of XG with rigid body modes for IOPT=9 or 10

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.

COORID 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.

IOPT Input-integer-default=-1. Output option. See Remark 1.

IOPT=9 is intended for processing of the WEIGHTCHECK Case Control


command. Similar to IOPT=7 except

XG is a mass matrix:

DMAP Programmer's Guide 11-253


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

1) Allows other sets

2) Compares x66 (for non-g-set) with x66p

IOPT=10 is intended for processing of the GROUNDCHECK Case Control


command. Similar to IOPT=7 except

XG is a stiffness matrix:

1) Allows other sets

2) Prints UIM indicating strain energy in each rigid body direction

TITLEi Input-character. Title which appears above the printed output. See Remark 1.
TITLE1 default = ’VECTOR
’TITLE2 default = ’RESULTAN’
TITLE3 default = ’T ’

ALTSHAPE Input-integer-default=0. Set of displacement functions in p-element analysis. See


“Parameters” in the NX Nastran Quick Reference Guide.

WTMASS 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.

SEID Input-integer-default=-1. Superelement identification number.

SETNAM Input-character-default=‘g’ Degree-of-freedom set name used by IOPT=9 and 10.

RBFAIL Output-logical-default=‘false’ Set to TRUE if grounding check does not pass 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 Contents of XOUT Printed output

<0 Displacement vector file suitable for input to the PLOT None
module

1 XG converted to the coordinate system specified by Resultants of the input


COORID vectors about GRDPNT
in the basic coordinate
system

2 Same as IOPT=1 and for each grid point,u′x = u′y = θ′x Same as IOPT = 1
= θ′y = θ′z = 0 and u′zux + uy + uz + θx + θy + θz,
where ui and θi are the translations and rotations of XG.

11-254 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

IOPT Contents of XOUT Printed output

3 The coordinate locations (x, y, z) in BGPDT converted None


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.

4 A six-row by g-column rigid body matrix where each row None


represents the motion, in the global coordinate system,
of all grid points due to the unit motion of the grid point
listed on PARAM,GRDPNT. Grid point GRDPNT is
given a unit translation or rotation in each direction of
the basic coordinate system. XOUT represents the
rigid body modes of the structure with no mechanisms.
The motion is output in the global coordinate system.
XG and COORID are ignored.

5 Same as IOPT=1

6 A g-row by six-column rigid body matrix where each None


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.

7 Grid point weight generator summary table suitable for None


printing by the OFP module. Same as GPWG module.

DMAP Programmer's Guide 11-255


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

IOPT Contents of XOUT Printed output

8 Same as IOPT=1 Same as IOPT=1


except output includes
contributions from each
direction

9 Same as IOPT=7 None

10 Same as IOPT=7 User Information


Message 7570, which
shows grounding check
strain energies and
pass/fail report

11 Same as IOPT=1 None

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 UG,BGPDT,SCSTM,CSTM,,,,/UGBASIC/0/0/1 $
MATGPR BGPDT,USET,,UGBASIC//’H’/’G’ $

2. Given a free-free model with no mechanisms, compute its rigid body modes in the global and
basic coordinate systems.
VECPLOT ,,BGPDT,SCSTM,CSTM,,,,/RBGLOBAL//4 $
TRNSP RBGLOBAL/RBT $
VECPLOT RBT,BGPDT,,CSTM,,,,/RBBASIC///1 $

3. Convert a load matrix to the basic coordinate system, and print out the maximum load at any grid
point for each load vector.
VECPLOT PG,BGPDT,SCSTM,CSTM,,,,/PGBASIC//0/5 $
MATPRN PG,PGBASIC//$

11-256 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

11.125 VIEW
Computes heat transfer radiation view factors

Format:

VIEW EST,BGPDT,EQEXIN,EPT,EDT,MATPOOL/
MPOOL $

Input Data Blocks:

EST Element summary table

BGPDT Basic grid point definition table

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

EPT Table of Bulk Data entry images related to element properties

EDT Table of Bulk Data entry images related to element deformation. Required only for
differential stiffness generation

MATPOOL Table of Bulk Data entry images related to hydroelastic boundary, heat transfer
radiation, virtual mass, DMIG, and DMIAX entries

Output Data Block:

MPOOL Table of RADSET, RADLST, and RADMTX Bulk Data entry images

Parameters:
None.

11.126 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 Table of Bulk Data entry images related to geometry

DMAP Programmer's Guide 11-257


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

GEOM2 Table of Bulk Data entry images related to element connectivity and scalar points

EST Element summary table

CASECC Table of Case Control command images

OINT p-element output control table

EDT Table of Bulk Data entry images related to element deformation, aerodynamics,
p-element analysis, divergence analysis, and the iterative solver

EPT Table of Bulk Data entry images related to element properties

PELSET p-element set table, contains SETS DEFINITIONS

BGPDT Basic grid point definition table

EQEXIN Equivalence table between external and internal grid/scalar identification numbers

CSTM Table of coordinate system transformation matrices

PVAL0 p-value table generated by the ADAPT module in a previous run or superelement

Output Data Blocks:

ELEMVOL Element volume table, contains p-element volumes and the p-value dependencies
of each P-element grid, edge, face and body

GEOM1VU Table of Bulk Data entry images related to geometry with view-grids added

GEOM2VU Table of Bulk Data entry images related to element connectivity and scalar points
p-elements removed and view-elements added

VIEWTB View information table, contains the relationship between each p-element and its
view-elements and view-grids

Parameters:

VUGNEXT Input/output-integer-default=0. Starting identification number for next view-grid.

VUENEXT Input/output-integer-default=0. Starting identification number for next


view-element.

VUGJUMP Input-integer-default=1000. Delta between view-grid identification numbers.

VUELJUMP Input-integer-default=1000. Delta between view-element identification numbers.

VUHEXA Input-character-default=‘VUHEXA’ Name for VUHEXA element.

VUPENTA Input-character-default=‘VUPENTA’ Name for VUPENTA element.

VUTETRA Input-character-default=‘VUTETRA’ Name for VUTETRA element.

11-258 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

VUQUAD4 Input-character-default=‘VUQUAD4’ Name for VUQUAD4 element.

VUTRIA3 Input-character-default=‘VUTRIA3’ Name for VUTRIA3 element.

VUBEAM Input-character-default=‘VUBEAM’ Name for VUBEAM element.

VUEXIST Output-logical-default=FALSE. View-element flag. Set to TRUE if view-elements


exist.

11.127 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 Table of element lengths, areas, and volumes

EST Element summary table

MPT Table of Bulk Data entry images related to material properties

DIT Table of TABLEij Bulk Data entry images

OPTPRM Table of optimization parameters

OGPWG Grid point weight generator table in weight units

Output Data Blocks:

WMID Table of weight as a function of material identification number

WGTM 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

DMAP Programmer's Guide 11-259


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

VOLS Output-real-default=0.0. Total volume of analysis model.

SEID Input-integer-default=0. Superelement identification number.

11.128 XSELOADS
Generates DTI,SELOAD entries for an external superelement.

Format:

XSELOADS CASECC,SELOAD,GEOM3,DYNAMIC,PA/XSELOADS $

Input Data Blocks:

CASECC Case control data block.

SELOAD Table of user-supplied DTI,SELOAD entries.

GEOM3 Table of applied load card images.

DYNAMIC Table of dynamic data card images.

PA Matrix of applied loads.

Output Data Block:

XSELOAD Table of DTI,SELOAD definitions of the external superelement consistent with


the applied loads.

Parameters:

None

11.129 XSORT
Reads and sorts Bulk Data section

Format:

XSORT FORCE,BULKOLD/BULK,JBULK/
S,N,NOGOXSRT/S,N,QUALNAM/S,N,NEXTID/S,N,LASTBULK/S,N,EQVBLK/SEID $

Input Data Blocks:

FORCE Table of MSGSTRESS plotting commands

11-260 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

BULKOLD Bulk table from a prior run, to be merged into BULK

Output Data Block:

BULK Table of all Bulk Data entries

JBULK Table of all Bulk Data entries that are unsorted and comments are not stripped
out

Parameter:

NOGOXSRT Logical-output-default=FALSE. Set to TRUE an error is detected in the Bulk


Data.

QUALNAM Output-character-default=’ ’ Keyword which appears on the BEGIN BULK


command of the next Bulk Data section; usually SUPER or AUXMODEL.

NEXTID Input/output-integer-default=0. Identification number which appears on the


BEGIN BULK command of the next Bulk Data section. Usually indicates
superelement or auxiliary model identification number.

LASTBULK Output-logical-default=FALSE. Flag to indicate that the current Bulk Data


section is the last section in the input file.

EQVBLK Input/output-logical-default=FALSE. Copy/equivalence flag of BULKOLD to


BULK. If on input EQVBLK=FALSE, and no new Bulk Data, 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.

SEID Input-integer-no default. Identification number of current superelement.

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.
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 ) $

DMAP Programmer's Guide 11-261


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

XSORT ,,/IBULK/
S,N,NOGOXSRT//S,N,NEXTID/S,N,LASTBULK $
SEID=NEXTID $
ENDDO $

11.130 XYPLOT
Writes plot information to plot file (.plt)

Format:

XYPLOT XYPLOT// $

Input Data Blocks:

XYPLOT Table of x-y plot control values

Output Data Block:

None.

Parameters:

None.

11.131 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 $

11-262 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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 Table of x-y plotting commands

PSDF Power spectral density table

AUTO Autocorrelation function table

OVG Table of aeroelastic x-y plot data for V-g or V-f curves

OXRESP Table of response spectra in SORT2 format

OUXY2 Table of displacements in SORT2 format for h-set or d-set.

OPNL2 Table of nonlinear loads in SORT2 format for the h-set or d-set.

OFMPF2M Table of fluid mode participation factors by normal mode.

OFMPF2E Table of fluid mode participation factors by excitation frequencies.

OSMPF2M Table of structure mode participation factors by normal mode.

OSMPF2E Table of structure mode participation factors by excitation frequencies.

OPMPF2M Table of panel mode participation factors by normal mode.

DMAP Programmer's Guide 11-263


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

OPMPF2E Table of panel mode participation factors by excitation frequencies.

OLMPF2M Table of load mode participation factors by normal mode.

OLMPF2E Table of load mode participation factors by excitation frequencies.

OGMPF2M Table of grid mode participation factors by normal mode.

OGMPF2E Table of grid mode participation factors by excitation frequencies.

Output Data Blocks:

XYPLOT Table of x-y plot control values

Parameters:

APP Input-character-default=‘TRANRESP’ Analysis type.Allowable values are:

‘REIGEN’ Normal modes

‘FREQRESP’ Frequency response

‘TRANRESP’ Transient response

‘CEIGEN’ Complex eigenvalues

‘VG’ Aeroelastic V-g or V-f data

‘CONTACT’ Slideline contact

‘RANDOM’ Process all random results excluding acoustic modal 'RANDOM'


participation factor outputs from MODEPOUT.

‘RANDMPF’ Process only MODEPOUT outputs.

‘SET1’ Abscissa points are specified on SET1 Bulk Data entries

‘RSPEC’ Response spectra

XYSET Input-character-default=‘SOL’ Degree-of-freedom set type.

‘SOL’ Solution set (d-set or h-set)

‘DSET’ d-set

‘HSET’ h-set

‘PSET’ p-set

PLTNUM Input/output-integer-default=0. Plot frame counter.

11-264 DMAP Programmer's Guide


DMAP Module and Statement Descriptions N-X

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.

NOXYPLOT Output-integer-default=1. Set to 1 if XYPLOT is created; -1 otherwise.

TABID Input/output-integer-default=0. TABLED1 punch flag. If IDTAB is greater than


zero, all requests for XYPUNCH produce TABLED1 Bulk Data entries for the
curve. The table identification number starts at TABID and increases by one
for each table punched.

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:

DMAP Programmer's Guide 11-265


Chapter
Chapter 11:11:DMAP
DMAP Module
Module and Statement
and Statement Descriptions
Descriptions N-X N-X

XYTRAN XYCDBS,OESNLBP2,,,,/XYPLTB1/‘CONT‘/‘PSET‘/
S,N,PFILE/S,N,CARDNO/S,N,NOXYP $

11-266 DMAP Programmer's Guide


Siemens Industry Software

Headquarters
Europe
Granite Park One
Stephenson House
5800 Granite Parkway
Sir William Siemens Square
Suite 600
Frimley, Camberley
Plano, TX 75024
Surrey, GU16 8QD
USA
+44 (0) 1276 413200
+1 972 987 3000

Asia-Pacific
Americas
Suites 4301-4302, 43/F
Granite Park One
AIA Kowloon Tower, Landmark East
5800 Granite Parkway
100 How Ming Street
Suite 600
Kwun Tong, Kowloon
Plano, TX 75024
Hong Kong
USA
+852 2230 3308
+1 314 264 8499

About Siemens PLM Software


© 2014 Siemens Product Lifecycle Management
Siemens PLM Software, a business unit of the Siemens Software Inc. Siemens and the Siemens logo are
Industry Automation Division, is a leading global provider registered trademarks of Siemens AG. D-Cubed,
of product lifecycle management (PLM) software and Femap, Geolus, GO PLM, I-deas, Insight, JT, NX,
services with 7 million licensed seats and 71,000 customers Parasolid, Solid Edge, Teamcenter, Tecnomatix and
worldwide. Headquartered in Plano, Texas, Siemens Velocity Series are trademarks or registered trademarks
PLM Software works collaboratively with companies of Siemens Product Lifecycle Management Software
to deliver open solutions that help them turn more Inc. or its subsidiaries in the United States and in other
ideas into successful products. For more information countries. All other trademarks, registered trademarks
on Siemens PLM Software products and services, visit or service marks belong to their respective holders.
www.siemens.com/plm.

You might also like