Next: 1.7 DS GEOM Up: 1 Description of DS by type Prev: 1.5 DS COOR Index Contents

1.6 DS FORC

1.6.1 Contents

This DS stores information describing the manner in which the data corresponding to the computation of the RHS will be input to the appropriate module (for example module THELAS).

The RHS can be computed using:

• one or several arrays containing the values required by the computation,
• a user sub-program,
• the general subroutine FORCE, or
• a sensible combination of the above 3 possibilities.

The data consists therefore of, depending on the problem under consideration and on the items of interest (reference numbers or sub-domain numbers):

• the numbers to be considered,
• the array name and address of the values required for computation,
• the computation option, its nature, etc.

DS FORC consists of 11 arrays of predefined order.

Array FOR0:

General information.

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

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

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

Array FOR1:

Description of any supplementary arrays.

This integer array exists if NTACM (see FOR0) is non-zero. It contains 22 variables for each array to be described. When describing the data which will be contained in one or several arrays, it is useful to associate them with the DS (other possibilities are permissible, such as associating them with DS MILI (see this DS) or DS TAE (see this DS), or otherwise with all the DS present in memory during the computation of the element matrices).

If array FOR1 exists, it contains sequentially:

• Loop i from 1 to NTACM
  • array name in 4 characters,
  • array address in super-array M,
  • array length in number of words,
  • array type (1 = integer, 2 = real single precision, 4 = character, 5 = real double precision, ...),
  • comments on the contents of the array in 18 words of 4 characters.
  End of loop.

Array FOR2:

General description of the data sets.

This integer array contains 9 values.

• Loop i from 1 to 8
  • FOR2(i) = 0 if array FORi+2 does not exist, i.e. there is no description corresponding to this case,
  • FOR2(i) = n, array FORi+2 exists and there are n sets described (i.e. n reference numbers, sub-domain numbers or n elements)
  End of loop i

• FOR2(9) = NDSM the number of load cases of RHS.

Array FOR3:

Description for a volumetric treatment by sub-domain number.

This integer array contains 7 values.

1 NDSD

the number of the sub-domain described,

2 IADR

the value 0,

3 NUM

the value 0,

4 IOPT

the treatment option: > 0 for isotropic case, < 0 for anisotropic case,

5 CODE

the treatment code, i.e:

• 1: by array,
• 2: by subroutine FORCE, or
• 3: by a user subroutine.

6 INFO1

the first data item corresponding to the treatment:

• if CODE = 1: the array name,
• if CODE = 2: the option in subroutine FORCE, or
• if CODE = 3: 0

7 INFO2

the second data item corresponding to the treatment:

• if CODE = 1: the address in the array containing the first value to be used,
• if CODE = 2: the return address in the array of subroutine FORCE of the first value to be used, or
• if CODE = 3: 0

Arrays FOR4 to FORA have the same form.

Array FOR4:

Description for a surface treatment by reference numbers.

Same as array FOR3, where here:

1 NREF

the reference number described,

2:7

identical to FOR3.

Array FOR5:

Description for a linear treatment by reference numbers.

Same as array FOR3, where here:

1 NREF

the reference number described,

2:7

identical to FOR3.

Array FOR6:

Description for a point treatment by reference numbers.

Same as array FOR3, where here:

1 NREF

the reference number described,

2:7

identical to FOR3.

Array FOR7:

Description for a volumetric treatment by element.

Same as array FOR3, where here:

1 NREF

the element number described,

2 IADR

the address in array MAIL of DS MAIL of the element,

3:7

identical to FOR3.

Array FOR8:

Description for a surface treatment by element.

Same as array FOR3, where here:

1 NREF

the element number described,

2 IADR

its address in MAIL,

3 NUM

the number of the face under consideration,

4:7

identical to FOR3.

Array FOR9:

Description for a linear treatment by element.

Same as array FOR3, where here:

1 NREF

the element number described,

2 IADR

its address in MAIL,

3 NUM

the number of the edge under consideration,

4:7

identical to FOR3.

Array FORA:

Description for a point treatment by element.

Same as array FOR3, where here:

1 NREF

the element number described,

2 IADR

its address in MAIL,

3 NUM

the number of the vertex under consideration,

4:7

identical to FOR3.

1.6.2 Corresponding tools

Reading and writing a DS FORC

A DS residing in main memory is written completely (it is a category 1 DS) on sequential file via module SDECRI.

Similarly, it is read and restored completely into main memory via SDLECT.

Printing a DS FORC

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

Creation and modification modules for a DS FORC

DS FORC is constructed via module COFORC which can be called by preprocessor FOMIXX.