Next: 1.6 DS FORC Up: 1 Description of DS by type Prev: 1.4 DS BDCL Index Contents

1.5 DS COOR

1.5.1 Contents

This DS is used to store the point or node coordinates in a mesh.

DS COOR consists of five arrays of predefined order.

Array COO0:

General information.

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

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 'B'

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

Array COO1:

Description of any supplementary arrays.

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

Array COO2:

General description of the DS.

This integer array contains 7 values.

1 NTYP

the type of array COO4,

2 NIND

the number of indices (set to 2),

3 M1

the maximum value of its first index (NDIM, the space dimension),

4 M2

the maximum value of its second index (for example, NP or NOE, depending on the space available),

5 NCOD

the code for splitting array COO4 into blocks, where:

• NCOD = 1 is all the blocks are equal in size (except the last), and
• NCOD = 0 if not.
  

6 NBLOC

the number of blocks,

7 NTACOO

the coordinate type:

• 1: Cartesian (x,y,z)
• 2: polar ()
• 3: spherical ()

Array COO3:

Pointer to the blocks.

This integer array contains, in NBLOC+1 variables, the segmentation of array COO4.

• COO3(1) = 0
• COO3(i+1) = number of last point or node in block i

Array COO4:

The coordinates.

This NTYP type array contains the point or node coordinates of each page.

1.5.2 Corresponding tools

Reading and writing a DS COOR

A DS residing in M.M. is written to S.M. on sequential access file.

This is a category 2 DS where only the first four arrays, as well as any associated arrays (described in array COO1), are read (module SDLECT) or written (module SDECRI):

• when reading, array COO4 is only addressed and the read is performed by the program via a READ command, for example:

  READ(NFCOOR) LE,(M(IACOO4-1+I),I=1,LE)

• when writing, array COO4 is transfered via a WRITE command:

  REAL COO4(NDIM,NP)
  LE = NDIM * NP
  WRITE(NFCOOR) LE,(COO4(I,J),I=1,NDIM),J=1,NP)

Printing a DS COOR

The contents (total or partial) of a DS COOR can be printed by the following modules:

IMCOOR:

The entire DS (as a function of the print parameter, IMPRE, all or part of array COO4 is output):

      SUBROUTINE  IMCOOR(M,NFCOOR,NICOOR,IMPRE)
C AIM : PRINT THE ARRAYS OF DS COOR, INCREASING WITH IMPRE
C ---   FILE NFCOOR (OR MC IF 0), LEVEL NICOOR

INFOCO:

Print a particular value contained in the DS:

      SUBROUTINE INFOCO(M,IOPT,TYPESD,NIVEAU,TAB2,TAB3,TAB4,NUMREC,
     +                  XREC,YREC,ZREC)
C AIM : OUTPUT INFORMATION REGARDING A DS COOR

Preprocessors IMAGXX and INFOXX are used if a conversational call of IMCOOR and INFOCO, respectively, is desired.

Creation and modification modules for a DS COOR

DS COOR (of the points) generally results from computation performed by the interpolation module ( COMACO), whereas the DS corresponding to the nodes is obtained by employing module CORNOE.

Preprocessors COMAXX and CORNXX are used when a conversational call of the modules is desired.