background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
1/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
Organization (S):
EDF-R & D/AMA, CS















Data-processing manual of Description
D6.05 booklet: -
D6.05.01 document




Use of
SD_RESULTAT



Summary:

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

The routine
RSCRSD
must be supplemented to create new types of
SD_RESULTAT
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
2/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
Count
matters
1
Routines of creation, destruction, enlarging .............................................................................. 3
2
Routines of access starting from the key words of the control Aster ........................................................... 4
3
Routines of access to the structures
SD_RESULTAT
................................................................................... 5
4
Routine interpolation .............................................................................................................................. 8
5
Routines of existence .............................................................................................................................. 8
6
Example ............................................................................................................................................... 10
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
3/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
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
RESULT
(in) typesd
k16
type of the structure of donnéss
RESULT
(in) nbordr
I
sequence number numbers.
To create a structure
SD_RESULTAT
(if this structure already exists, it is destroyed).
The amendment 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
RESULT
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
RESULT
(in) iordr I
sequence number.
To destroy in the structure
SD_RESULTAT
fields starting from a given sequence number.

CAL RSAGSD
(nomsd, nbordr)
(in) nomsd
K8
name of the structure of data
RESULT
(in) nbordr I
new size of
RESULT
(the size is doubled if
NBORDR = 0
)
To increase a structure
SD_RESULTAT
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
4/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
2
Routines of access starting from the key words of the control
Aster
The access via the process control language to the data indexed in
SD_RESULTAT
is possible
by the same key words whatever the control (
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 controls (
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
RESULT
(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 the vector
ZI
(in) prec
R8
precision requested
(in) crit
K8
criterion requested
(in) itout I
access of the control by the key word “
ALL
(in) ilinst I
access of the control by the key word “
LIST_INST
(in) ilfreq I
access of the control by the key word “
LIST_FREQ
(out) iret
I
code return, =
0
: ok
Recovery starting from the key words of the control, 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 K4
type 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
moments
(out) jrang
I
address JEVEUX of the vector
ZI
numbers
(out) iret
I
code return, =
0
: ok
Recovery from the key words of the control for a structure Result
tran_gene
, following
the type of interpolation:
·
moments (
INTERP
=
“FLAX”
,
“LOG”
), user datum,
·
moments and their associated sequence numbers (
INTERP = “NOT”
), moments of calculation of
tran_gene
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
5/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
3
Routines of access to the 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
RESULT
(in) K16 access
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.
ORDR
if access =
“LONMAX”
: recovery maximum length of.
ORDR
if access =
“LAST”
: recovery of the last sequence number
if access =
“FIRST”
: 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
RESULT
(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
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
6/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
This routine manages the fields in the structure
SD_RESULTAT
and fact call to the routine
RSUTCH
.

CAL RSNOCH
(nomsd, nomsy, iordr, chextr)
(in) nomsd K8
name of the structure of data
RESULT
(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:
The routine
RSNOCH
manage the links (via the routine
SDLIEN
) between the various structures
SD_RESULTAT
.
CAL
RSADPA
(nomsd, concealment, will npara, lpara, iordr, itype, ljeveu,
ctype)
(in) nomsd K8
name of the structure of data
RESULT
(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
list names of the parameters
(in) iordr I
sequence number
(in) itype I
code indicating that one wishes the type
=
0
no the type
0
the type is provided
(out) ljeveu I
list addresses JEVEUX in
ZI
,
ZR
,…
(out) ctype
K4
list types of addresses JEVEUX
I
entirety,
R
reality,
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
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
7/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
CAL RSNOPA
(nomsd, icode, nomjv, nbacc, will nbpara, jpara)
(in) nomsd K8
name of the structure of data
RESULT
(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
RESULT
(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 found number
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
RESULT
(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 found number
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.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
8/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
4 Routine
interpolation
CAL
RSINCH
(nomsd, nomsy, access, rval, chextr, proldr,
prolga, istop, iret)
(in) nomsd K8
name of the structure of data
RESULT
(in) nomsy K16
reference symbol
(in) K16 access
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 K8
type of prolongation wanted on the right
(in) prolga K8
type of prolongation wanted on the left
(in) istop I
in the event of interpolation error:
=
0
, does not write a message, does not make stop.
=
1
, writing message, does not make stop.
=
2
, writing message, made stop.
(out) iret
I
code return:
1) the field is calculated:
=
0
, the field is 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
RESULT
(out) iret
I
code return
=
0
, the structure exists;
0
, the structure does not exist.
Checking of the existence of a structure
SD_RESULTAT
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
9/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
CAL RSEXPA
(nomsd, icode, nompar, iret)
(in) nomsd K8
name of the structure of data
RESULT
(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 does 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
RESULT
(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 is 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
.
background image
Code_Aster
®
Version
8.1
Titrate:
Use of
SD_RESULTAT
Date:
01/12/05
Author (S):
J. PELLET, L. VIVAN
Key
:
D6.05.01-B
Page
:
10/10
Data-processing manual of Description
D6.05 booklet: -
HT-66/05/003/A
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 the 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)
CAL
JEVEUO (CHAMNO//“.VALE”, “E”, LVALE)
C 12 IEQ = 1, NEQ
ZR (LVALE+IEQ-1)
=
12
CONTINUOUS
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)
=