Next: 1.11 DS MUA Up: 1 Description of DS by type Prev: 1.9 DS MILI Index Contents

1.10 DS MPLR

1.10.1 Contents

This DS stores information corresponding to the reference numbers.

DS MPLR consists of 6 arrays of predefined order.

Array MPL0:

General information.

This integer array contains 32 variables, consisting of a general description of the job (title, date, name), of DS MPLR (type, level, ...), and indicates the presence or absence of array MPL1.

1:20 TITRE

the job title in 20 words of 4 characters,

21:22 DATE

the date of creation in 2 words of 4 characters,

23:28 NOMCRE

the creator's name in 6 words of 4 characters,

29 'MPLR'

the DS type,

30 NIVEAU

the DS level,

31 ETAT

a reserved parameter,

32 NTACM

the number of supplementary arrays
(they are described in array MPL1).

Array MPL1:

Description of any supplementary arrays.

This array is analogous to array B1 of DS B (see this DS).

Array MPL2:

General description.

This integer array contains 10 values.

1 NTYP

the type of array MPL4,

2 NINDI

its number of indices,

3 NCODSA

the storage code:

• > 0: symmetric
• = 0: diagonal
• < 0: non-symmetric
  

4 NOE

the number of nodes

5 NOEFF

the number of referenced nodes

6 NBFR

the number of reference numbers

7 IEMPL5

0 if array MPL5 does not exist, 1 otherwise,

8 LMPL5

the number of words in array MPL5

9 NBMAT

the number of matrices

10 IMPL4

the existence or not of a third column in MPL4:

• < 0: this column exists,
• = 0: it does not exist,
• = ND: the number of degrees of freedom per node if it is constant (in this case, the third column is superfluous).

Array MPL3:

Description of the reference numbers under consideration.

This integer array, of length NBFR, contains:

• MPL3(i) reference number i under consideration

Array MPL4:

Description of the nodes under consideration.

This integer array, of length 2*NOEFF or 3*NOEFF depending on IMPL4, contains:

• MPL4(i,1) the global number of node i,
• MPL4(i,2) its reference,
• MPL4(i,3) the number of degrees of freedom.

Array MPL5:

The matrix coefficients:

This NTYP type array contains the matrix coefficients:

• if NCODSA > 0: storage by columns of the upper triangle
• if NCODSA < 0: storage by columns
• if NCODSA = 0: diagonal matrix

1.10.2 Corresponding tools

Reading and writing a DS MPLR

A DS residing in main memory is written partially (only its 5 generic arrays and any associated arrays described in array MPL1 on sequential file via module SDECRI.

A DS residing on file is read and transferred partially (its 5 generic arrays and any associated arrays described in array MPL1) to main memory via module SDLECT; array MPL6 is only addressed:

• When reading, array MPL5 is only addressed and the read is performed by the program via a READ type command.
• When writing, array MPL5 is transferred via a WRITE type command.

Printing a DS MPLR

The contents (total or partial) of a DS MPLR can be printed by module IMMPLR. Preprocessor IMAGXX is used if a conversational call of IMMPLR is desired.

Creation and modification modules for DS MPLR

DS MPLR is created using a DS MAIL, and possibly NDL1, via module CALMAI:

      SUBROUTINE CALMAI(M,NOFR,NBFR,NTY,NFMAIL,NIMAIL,NFNDL1,
     +                  NINDL1,NFMPLR,NIMPLR,NTMPLR)
C AIM : CONSTRUCT THE FIRST ARRAYS OF DS MPLR