Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 1/10

Organization (S): EDF-R & D/AMA, CS

Handbook of Descriptif Informatique
D6.05 booklet: -
D6.05.01 document

Use of the SD_RESULTAT

Summary:

The SD_RESULTAT [D4.06.08] is accessible only through the routines described in this document.

Routine RSCRSD must be supplemented to create new types of SD_RESULTAT.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 2/10

Count

matters

1 Routines of creation, destruction, enlarging .............................................................................. 3
2 Routines of access starting from the key words of the command Aster ........................................................... 4
3 Routines of access to structures SD_RESULTAT ................................................................................... 5
4 Routine interpolation .............................................................................................................................. 8
5 Routines of existence .............................................................................................................................. 8
6 Example ............................................................................................................................................... 10
Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 3/10

1
Routines of creation, destruction, enlarging

Note:

What a structure of data SD_RESULTAT, what a sequence number, one
parameter, a variable of access…? the answers to these questions are in [D3.04.01] and
[D4.06.08].

CAL RSCRSD
(nomsd, typesd, nbordr)

(in) nomsd

K8
name of the structure of data RESULTAT
(in) typesd
k16 standard of the structure of donnéss RESULTAT
(in) nbordr
I
sequence number numbers.

To create a structure SD_RESULTAT (if this structure already exists, one destroys it).
The modification of this routine makes it possible to create new types of SD_RESULTAT or to enrich
those existing.

CAL RSDLSD
(nomsd)

(in) nomsd
K8 name of the structure of data RESULTAT

To destroy a structure SD_RESULTAT. This routine does not destroy the fields indexed by
SD_RESULTAT.

CAL RSRUSD
(nomsd, iordr)

(in) nomsd
K8 name of the structure of data RESULTAT
(in) iordr I
sequence number.

To destroy in structure SD_RESULTAT the fields starting from a given sequence number.

CAL RSAGSD
(nomsd, nbordr)

(in) nomsd
K8 name of the structure of data RESULTAT
(in) nbordr I
new size of the RESULTAT (the size is doubled if NBORDR = 0)

To increase a structure SD_RESULTAT.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 4/10

2
Routines of access starting from the key words of the command
Aster

The access via the process control language to the data indexed in the SD_RESULTAT is possible
by the same key words whatever the command (IMPR_RESU, CALC_G_THETA, etc…).

The description of these key words (TOUT_ORDRE, NUME_ORDRE, etc…) is for example in
[U4.71.01].

For certain commands (IMPR_RESU, for example) these key words are under a key word factor
(RESU) for others not (CALC_G_THETA). In this last case the argument key word specified in
routines below must be ''.

CAL RSUTNU
(nomsd, motcle, iocc, knum, nbordr, jordr, prec,
crit, all, ilinst, ilfreq, iret)




(in) nomsd K8 name of the structure of data RESULTAT
(in) motcle K * key word control ratio
(in) iocc
I
number of occurrence of the key word factor
(in) knum
K19 name of vector JEVEUX to write the list of the numbers
(out) nbordr I
a number of found sequence numbers
(out) jordr
I
address JEVEUX of vector ZI
(in) prec
R8 precision requested
(in) crit
K8 criterion requested
(in) itout I
access of the command by key word “TOUT”
(in) ilinst I
access of the command by key word “LIST_INST”
(in) ilfreq I
access of the command by key word “LIST_FREQ”
(out) iret
I
code return, = 0: ok

Recovery starting from the key words of the command, the sequence numbers in a structure
SD_RESULTAT.

Note:

Routine RSUTNU above recovers the list of the possible sequence numbers of
SD_RESULTAT, possibly filtered by the key words of the process control language
(TOUT=' OUI', LIST_INST=…). It is not sure for as much, that for all these numbers
of command, all fields (NOM_CHAM) or all the parameters really exist. When one
wants to recover the list of the sequence numbers for which a field (or a parameter) exists
really, routines RSUTN1 or RSUTN2 should be used.

CAL RSTRAN
(interp, nomsd, motcle, iocc, kinst, krang, nbinst,
jinst, jrang, iret)




(in) interp standard K4 of interpolation wished
(in) nomsd K8 name of the structure tran_gene
(in) motcle K16 key word control ratio
(in) iocc
I
number of occurrence of the key word factor
(in) kinst K19 name of vector JEVEUX to write the list of the moments
(in) krang K19 name of vector JEVEUX to write the list of the numbers
(out) nbinst I
a number of moments read
(out) jinst
I
address JEVEUX of the vector ZR of the moments
(out) jrang
I
address JEVEUX of vector ZI of the numbers
(out) iret
I
code return, = 0: ok

Recovery from the key words of the command for a structure Résultat tran_gene, following
the type of interpolation:

·
moments (INTERP = “LIN”, “LOG”), user datum,
·
moments and their associated sequence numbers (INTERP = “NON”), moments of calculation of
tran_gene.
Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 5/10

3
Routines of access to structures SD_RESULTAT



CAL RSORAC
(nomsd, access, ival, rval, kval, cval, prec, crit,
nutrou, ndim, nbtrou)




(in) nomsd K8 name of the structure of data RESULTAT
(in) access K16 name of the variable of access.
(in) ival
I
value of the so whole variable of access
(in) rval
R8 value of the so real variable of access
(in) kval
K. value of the variable of access if character
(in) cval
C16 value of the so complex variable of access
(in) prec
R8 precision requested
(in) crit
K8 criterion requested
(in) ndim
I
dimension of the list nutrou.
(out) nutrou I
list found sequence numbers.
(out) nbtrou I
a number of found sequence numbers.
if the number found nbtrou is higher than ndim,
then one returns nbtrou = - nbtrou

Recovery starting from a variable of access, sequence numbers of a structure
SD_RESULTAT.

Convention:

if access =
“LONUTI”
: recovery working length of the .ORDR
if access =
“LONMAX”
: recovery maximum length of the .ORDR
if access =
“DERNIER”
: recovery of the last sequence number
if access =
“PREMIER”
: recovery of the first sequence number
if access =
“TOUT_ORDRE”: recovery of all the sequence numbers.



CAL RSEXCH
(nomsd, nomsy, iordr, chextr, iret)




(in) nomsd K8 name of the structure of give RESULTAT
(in) nomsy K16 reference symbol
(in) iordr I
sequence number
(out) chextr K19 name of the extracted field
(out) iret
I
code return
0: the field exists.
>0: the field does not exist.
1) IORDR lower than the max is authorized:
100: the reference symbol is licit.
101: the reference symbol is prohibited.
1) IORDR higher than the max is authorized:
110: the reference symbol is licit.
111: the reference symbol is prohibited.

Recovery starting from a reference symbol and of a sequence number, name of a field in one
structure SD_RESULTAT.
Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 6/10

This routine manages the fields in structure SD_RESULTAT and called upon routine RSUTCH.



CAL RSNOCH
(nomsd, nomsy, iordr, chextr)




(in) nomsd K8 name of the structure of data RESULTAT
(in) nomsy K16 reference symbol
(in) iordr I
sequence number
(in) chextr K19 name of the field “extracts” on which one wants to point.

To note starting from a reference symbol and of a sequence number, the name of a field in a structure
SD_RESULTAT.

Convention:

chextr
= '': the name of the field is that built by the routine,
chextr
'': the name of the field will be that provides by the developer.

Note:
Routine RSNOCH manages the links (via routine SDLIEN) between the various structures
SD_RESULTAT.



CALL
RSADPA
(nomsd, concealment, will npara, lpara, iordr, itype, ljeveu,
ctype)




(in) nomsd K8 name of the structure of data RESULTAT
(in) concealment
K1 condition of access to the parameters:
“It: reading, “E”: writing.
(in) I will npara
a number of sought parameters
(in) K16 will lpara lists names of the parameters
(in) iordr I
sequence number
(in) itype I
code indicating that one wishes the type
= 0 step of the type
0 one provide the type
(out) ljeveu I
list addresses JEVEUX in ZI, ZR,…

(out) ctype
K4
list types of addresses JEVEUX
I whole, R real, C complex,
K8 K16 K24 K32 K80 character.

Recovery starting from and a list sequence number of name (S) of parameter (S) or variable (S)
access, addresses JEVEUX of a structure SD_RESULTAT.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 7/10



CAL RSNOPA
(nomsd, icode, nomjv, nbacc, will nbpara, jpara)




(in) nomsd K8 name of the structure of data RESULTAT
(in) nomjv K19 name of vector JEVEUX to write the list of the names
(in) icode I
= 0, variables of access alone
= 1, parameters alone
= 2, variables of access and parameters
(out) nbacc
I
a number of variables of access
(out) I will nbpara
a number of parameters
(out) will jpara
I
address JEVEUX of nomjv

Recovery of the names and the number of parameters in a structure SD_RESULTAT as well as
names and the number of variables of access. These names are stored in a vector JEVEUX of name
nomjv.



CAL RSUTNC
(nomsd, nomsy, ndim, nomch, nuordr, nbtrou)




(in) nomsd K8 name of the structure of data RESULTAT
(in) nomsy K16 reference symbol
(in) ndim
I
dimension of the tables
(out) nomch
K16 table of the field names
(out) nuordr I
table of the sequence numbers of the found fields
(out) nbtrou I
a number of found fields
if the number found nbtrou is higher than ndim,
then one returns nbtrou = - nbtrou

Recovery starting from a reference symbol, fields noted and their associated sequence numbers
in a structure SD_RESULTAT.



CAL RSUTOR
(nomsd, nomsy, chextr, ndim, tnomsy, nuordr, nbtrou)




(in) nomsd K8 name of the structure of data RESULTAT
(in) nomsy K16 reference symbol
(in) chextr K19 name of the field to be sought
(in) ndim
I
dimension of the tables
(out) tnomsy K16 table of the reference symbols
(out) nuordr I
table of the sequence numbers
(out) nbtrou I
a number of found fields
if the number found nbtrou is higher than ndim,
then one returns nbtrou = - nbtrou

Recovery starting from a field, sequence number and possibly the reference symbol in one
structure SD_RESULTAT.

Convention:

if nomsy = '': recovery of the reference symbols and the sequence numbers.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 8/10

4 Routine
interpolation



CALL
RSINCH
(nomsd, nomsy, access, rval, chextr, proldr,
prolga, istop, iret)




(in) nomsd K8 name of the structure of data RESULTAT
(in) nomsy K16 reference symbol
(in) access K16 name of the variable of access
(in) rval
R8 actual value of the variable of access
(in) chextr K19 name of the field has to create. (if there exists, it is destroyed)
(in) proldr standard K8 of prolongation wanted on the right
(in) prolga standard K8 of prolongation wanted on the left
(in) istop I
in the event of interpolation error:
= 0, do not write a message, do not make stop.
= 1, written message, does not make stop.
= 2, written message, made stop.
(out) iret
I
code return:
1) the field is calculated:
= 0, the field are interpolated between 2 values.
= 1, the field is prolonged on the left.
= 2, the field is prolonged on the right.
1) the field is not calculated:
= 10, there is not any field for the interpolation.
= 11, prolongation on the left prohibited.
= 12, prolongation on the right prohibited.
= 20, the variable of access is illicit.

Interpolation for a reference symbol and a variable of access, a field in a structure
SD_RESULTAT.

5 Routines
of existence



CAL RSEXIS
(nomsd, iret)




(in) nomsd K8 name of the structure of data RESULTAT

(out) iret
I
code return
= 0, the structure exist; 0, the structure do not exist.

Checking of the existence of a structure SD_RESULTAT.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 9/10



CAL RSEXPA
(nomsd, icode, nompar, iret)




(in) nomsd K8 name of the structure of data RESULTAT
(in) icode I
= 0, variable of access
= 1, parameter
= 2, variable of access or parameter
(in) nompar K16 name of the parameter or the variable of access
(out) iret
I
= 0, the name do not exist.
= 100, the name exists

Checking of the existence of a name of parameter or a name of variable of access in a structure
SD_RESULTAT.



CAL RSVPAR
(nomsd, iordr, nompar, ipar, rpar, kpar, iret)




(in) nomsd K8 name of the structure of data RESULTAT
(in) iordr I
sequence number
(in) nompar K16 name of the parameter to be checked
(in) ipar
I
so whole value of the parameter
(in) rpar
R8 so real value of the parameter
(in) kpar
K. value of the parameter if character
(out) iret
I
= 0, it are not a parameter
= 100, the value of the parameter is correct
= 110, the value of the parameter is not correct

Checking of the existence of a name of parameter and its value for a sequence number gives in
a structure SD_RESULTAT.

Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Code_Aster ®
Version
8.1
Titrate:
Use of the SD_RESULTAT


Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN Key
:
D6.05.01-B Page
: 10/10

6 Example

Let us take the example of the storage of the modes of mechanical vibration (mode_meca):

one calculated 5 modes and one stores them in a structure SD_RESULTAT.

Stage 1: creation of structure SD_RESULTAT

NBMODE
=
5


CAL RSCRSD (MODES, “MODE_MECA”, NBMODE)

Stage 2: storage of the clean vectors



C 10 LM = 1, NBMODE







CAL RSEXCH (MODES, “DEPL”, IM, CHAMNO, IER)




CALL
JEVEUO (CHAMNO//“.VALE”, “E”, LVALE)



C 12 IEQ = 1, NEQ
ZR (LVALE+IEQ-1)
=

12
CONTINUE



CAL RSNOCH (MODES, “DEPL”, IM, '')





Stage 3: storage of the variables of access and parameters modal




CAL RSADPA (MODES, “E”, 1, “FREQ”, IM, 0, LFREQ, K8B)
ZR (LFREQ)
=




CAL RSADPA (MODES, “E”, 1, “NUME_MODE”, IM, 0, LNUME, K8B)
ZI (LNUME)
=




CAL RSADPA (MODES, “E”, 1, “STANDARD”, IM, 0, LNORM, K8B)
ZK24 (LNORM)
=






Handbook of Descriptif Informatique
D6.05 booklet: -
HT-66/05/003/A

Outline document