Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 1/10
Organization (S): EDF-R & D/AMA
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
Document: U4.91.01
Procedure IMPR_RESU with formats “RESULTAT”
and “ASTER”
1 Goal
To write the grid or the results of a calculation in a file with format “RESULTAT” or the grid with
format “ASTER”.
Currently this procedure makes it possible to write with the choice:
·
a grid,
·
fields with the nodes (of displacements, temperatures, clean modes, modes
statics,…),
·
fields by elements with the nodes or the points of GAUSS (of constraints, efforts
generalized, of variables intern…).
Procedure IMPR_RESU also makes it possible to write a grid and/or results on a file in
sight, in particular of their graphic visualization (cf documents [U7.05.01] (format “IDEAS”),
[U7.05.11] (format “CASTEM”), [U7.05.21] (format “MED”) and [U7.05.31] (format “ENSIGHT”)).
For the concepts of the result type, one can print only part of information, in
selecting the fields and the sequence numbers which one wishes to exploit.
For the impressions with format “RESULTAT”, it is possible to select the topological entities
(nodes, meshs, groups of nodes and groups of meshs) on which one wants to print them
results. One can also reduce the number of the information printed while asking only
impression of certain components, values included/understood in an interval chosen by the user
or of extreme values. One can combine all the possibilities, for example to obtain the value
maximum of a component given, on a particular topological entity and in an interval of
values chosen by the user.
Format “RESULTAT” should not be used as a basis to store or exchange results, its format
is not fixed.
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 2/10
2 Syntax
IMPR_RESU
(
MODELE
=
Mo,
[model]
UNITE = links, [I]
FORMAT =/“RESULT”, [DEFECT]
/“ASTER”,
RESU = (_F (
# Syntax of procedure IMPR_RESU to format “RESULTAT”
|
MAILLAGE =
MA, [grid]
| /
CHAM_GD =
CH_GD,
[cham_gd]
/
RESULTAT
=
RESU,
[result]
SENSIBILITE
=
(… to see [U4.50.02])
# Extraction of a field of size of resu
/
TOUT_CHAM
=
/“YES”, [DEFECT]
/“NON”,
/
NOM_CHAM
=
L_NOMSYMB, [l_K16]
/
TOUT_ORDRE =
“OUI”,
[DEFAUT]
/
NUME_ORDRE =
LORDRE,
[l_I]
/
LIST_ORDRE =
LENTI,
[listis]
/
NUME_MODE
=
LMODE,
[l_I]
/
NOEUD_CMP
=
LNOECMP,
[l_K16]
/
NOM_CAS =
NCAS,
[l_K16]
/
ANGL =
LANGL,
[l_K16]
/
/
FREQ =
LFREQ,
[l_R]
/
LIST_FREQ
=
LREEL,
[listr8]
/
INST =
LINST,
[l_R]
/
LIST_INST
=
LREEL,
[listr8]
| PRECISION
=
/
PREC, [R]
/
1.0D-3,
[DEFAUT]
|
CRITERION =/“RELATIVE”,
[DEFAUT]
/
“ABSOLU”
,
INFO_RESU
=/“OUI”,
/“NOT”, [DEFECT]
# Parameters
/
TOUT_PARA
=/“OUI”,
/“NOT”, [DEFECT]
/
NOM_PARA
=
L_NOMPARA, [l_K16]
FORM_TABL
=/“OUI”,
/“EXCEL”,
/“NOT”, [DEFECT]
# Selection of the components
/
TOUT_CMP
=
“OUI”,
[DEFAUT]
/
NOM_CMP =
L_NOMCMP,
[l_K8]
# Selection of the topological entities
/
TOUT =
“OUI”,
[DEFAUT]
/ |
NOEUD
=
L_NOEU, [l_noeud]
|
GROUP_NO
=
L_GRNO,
[l_gr_noeud]
|
MAILLE
=
L_MAILLE,
[l_maille]
|
GROUP_MA
=
L_GRMA, [l_gr_maille]
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 3/10
# Selection on the values
VALE_MAX
=
/“OUI”,
/“NOT”, [DEFECT]
VALE_MIN
=
/“OUI”,
/“NOT”, [DEFECT]
BORNE_SUP
=
VSUP,
[R]
BORNE_INF
=
VINF,
[R]
# Impression of the co-ordinates
IMPR_COOR
=
/“OUI”,
/“NOT”, [DEFECT]
# Choice of the format of writing of the actual values
FORMAT_R =/FORM,
/
“1PE12.5”, [DEFAUT]
SOUS_TITER = L_ST,
[l_Kn]
# Syntax of procedure IMPR_RESU to format “ASTER”
|
GRID = MA,
/
[grid]
/
[skeleton]
SOUS_TITER = L_ST,
[l_Kn]
)
))
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 4/10
3
Print in documentation IMPR_RESU
For including/understanding the documentation of IMPR_RESU well, it should be noted that term “RESULTAT”
gather in Code_Aster three rather different concepts:
·
a type of concept,
·
a type of file,
·
a format of writing.
Indeed, on the one hand, one indicates by result, the quantities produced by an operator of Aster calculation
producing several fields (evolutionary calculation, calculation of clean modes, etc…).
These data (results) are contained in a structure of Aster data of the generic type said
result. This generic type is declined in under types, for example mode_meca, evol_elas, etc,
whose mode of storage differs somewhat. A concept of the result type has only one under type.
In Aster documentation the names of the types of concept are in small letters Courier.
In addition, the results intended for the impression, in particular those resulting from IMPR_RESU, are versed
in a file indicated by file RESULTAT (associate with unit 8, standard resu in astk). The format
of writing associated with this file intended for the impression is him also baptized RESULTAT.
In short:
result
data resulting from the resolution of the system,
result
generic designation of the type of concept (of the structure of data) which
the result contains,
evol_ther
name of under type of the result of the result type,
mode_meca
FICHIER
(without quote) designation of the file which contains the results, independently
format of its contents,
“RESULTAT”
(with quotes) designation of the format (Aster) of the file which contains the results.
4 Operands
FORMAT and UNITE
Procedure IMPR_RESU makes it possible to write a grid and/or values of results in different
formats in sight, in particular, of a graphic visualization [U7.05.01], [U7.05.11], [U7.05.21] and
[U7.05.31].
Operand FORMAT makes it possible to specify the format of impression of a result.
Format “RESULTAT” is taken by defect. It makes it possible to print the grid and/or the results under
form listing.
One specifies in which file the data will be written via key word UNITE (cf orders
DEFI_FICHIER). By defect, UNITE = 8 with format “RESULTAT” and UNITE = 26 with format “ASTER”.
5 Word
key
RESU
This key word factor makes it possible to specify the results to print and the format according to which one wants them
to print.
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 5/10
6 Operands
CHAM_GD and RESULTAT
The values of the computed fields are stored in structures of data called fields of
size. These fields of size can be directly accessible (concept cham_gd) or
to find in a structure of data gathering several fields of size (concept
result).
·
a field of size is a structure of data which makes it possible to store definite fields
with the nodes (cham_no_ *) or fields defined by elements (cham_elem_ *). For the fields
by elements, one distinguishes the fields defined in the nodes from the elements and the fields defined in
points of GAUSS of the elements,
·
a concept result is composed of one or more fields of size. For example, with
each step of calculation one stores in the structure of data result, the field of size
displacement. This structure is thus indexed by a matric structure of command 2, including one
index is, for example, the list of the moments of calculation and the other the whole of the computed fields
(displacements, constraints, deformations,…).
One reaches in this case a field of size by specifying the value of a variable of access
(sequence number, moment, frequency, number of mode…) and a field name (“DEPL”,
“SIGM_ELNO_DEPL”,…). There are several types of concept result: evol_elas,
evol_noli, mode_meca,…. With each one corresponds a list of fields and a list of variables
licit accesses (cf [U5]).
In addition, with a concept result a certain number of results is also associated
complementary (for example generalized mass or modal factors of participation
in a modal calculation (concept result of the mode_meca type)), different for each value from
the variable of access. These complementary results are called parameters.
Taking into account the structure of data result, one understands easily that the possibilities
of impression which one lays out are those of the fields of size, supplemented by
specific possibilities:
-
information on the structure of data (for example: list variables of access, lists
actually calculated fields,…),
- direct access to a field of size (for example, impression of the field of
displacements at the moment t=15.),
-
impression of the values of parameters.
Operand RESULTAT makes it possible to print the fields contained in a concept result. One
can for example choose to print only certain fields (Cf. the following key word: NOM_CHAM)
on certain components of certain nodes (cf NOEUD_CMP).
7 Operand
SENSIBILITE
SENSIBILITE = list of the significant parameters
The use of this operand will mean that one is not interested in the result in itself, but with
derived from this result compared to significant parameters.
Example:
RESULT = RESU,
NOM_CHAM = “DEPL”
This sequence prints the field of displacement contained in the resu result.
RESULTAT =
RESU,
SENSIBILITE = (PS1, PS2),
NOM_CHAM =
“DEPL”
This sequence prints the derivative of the field of displacement of result RESU compared to
parameter PS1, then the derivative compared to PS2.
Cf document [U4.50.02].
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 6/10
8
Extraction of a field of size
8.1 Operands
TOUT_CHAM/NOM_CHAM
Cf document [U4.71.00].
8.2 Operands TOUT_ORDRE/NUME_ORDRE/LIST_ORDRE/
NUME_MODE/INST/LIST_INST/FREQ/LIST_FREQ/
NOEUD_CMP/NOM_CAS/ENG/PRECISION/CRITERION
Cf document [U4.71.00].
9 Operand
INFO_RESU
During the impression of a concept result, one can have forgotten the exact contents of the structure of
data. Operand INFO_RESU makes it possible to print these contents (a number of sequence numbers, lists
reference symbols of the actually calculated fields, list of the reference symbols of
actually calculated parameters,…).
For example:
IMPR_RESU (FORMAT=' RESULTAT', RESU= (_F (RESULTAT=resu, INFO_RESU= “YES”)))
Impression in file RESULTAT in the case of a concept result of name RESU of the type
mode_meca:
Structure of concept RESU calculated for 2 sequence numbers.
List reference symbols:
DEPL of the type DEPL_R
List names of variables of access:
NUME_MODE
FREQ
List names of parameters:
NORME
METHODE
ITER_QR
ITER_BATHE
ITER_ARNO
ITER_JACOBI
ITER_SEPARE
ITER_AJUSTE
ITER_INVERSE
OMEGA2
AMOR_REDUIT
ERREUR
MASS_GENE
RIGI_GENE
AMOR_GENE
MASS_EFFE_DX
MASS_EFFE_DY
MASS_EFFE_DZ
FACT_PARTICI_DX
FACT_PARTICI_DY
FACT_PARTICI_DZ
MASS_EFFE_UN_DX
MASS_EFFE_UN_DY
MASS_EFFE_UN_DZ
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 7/10
10 Parameters
10.1 Operand
TOUT_PARA
This key word indicates if one wants or not to print all the values of the parameters attached to
concept of the result type.
Example:
IMPR_RESU (RESU= (_F (RESULTAT= resu,
TOUT_PARA= “YES”, NUME_ORDRE= 3)))
One prints in file RESULTAT the values of all the parameters but only for
third step of calculation of a concept result of the mode_meca type:
Impression of the parameters of the concept resu for the sequence number 3:
NOM_MODE
3
FREQ 1.09787E+4
OMEGA2
4.75843E+09
AMOR_REDUIT
0.00000E+00
ERREUR
2.76853E-10
MASS_GENE
1.50009E-07
RIGI_GENE
7.13806E+02
........
........
NORME
SANS_CMP:
LAGR
10.2 Operand
NOM_PARA
This key word makes it possible to choose a list of reference symbols of parameters among the whole of
possible (Cf. [U5] or INFO_RESU).
Key words TOUT_PARA and NOM_PARA cannot be used simultaneously.
Example:
IMPR_RESU (RESU= (_F (RESULTAT= resu, NOM_PARA= (“NORME”), NUME_ORDRE= 3)))
One prints in file RESULTAT the value of the parameter of name “NORME” but only
for the third step of calculation of a concept result of the mode_meca type:
Impression of the parameters of the concept resu for the sequence number 3:
NORME
SANS_CMP:
LAGR
10.3 Operand
FORM_TABL
This key word makes it possible to choose the format of impression of the values of the parameters. Maybe in form
of a table whose each line is limited to 80 characters (FORM_TABL = “OUI”), that is to say in form
of a table whose each line can reach 2000 characters (FORM_TABL = “EXCEL”), that is to say
in the form of a list (a parameter by line) (FORM_TABL = “NON”).
By defect the parameters are printed in the form of a table.
Example:
1/FORM_TABL = “YES”
NUME_ORDRE NUME_MODE
ITER_QR ITER_BATHE
FREQ OMEGA2
AMOR_REDUIT
MASS_GENE
RIGI_GENE
AMOR_GENE
MASS_EFFE_DY
MASS_EFFE_DZ
FACT_PARTICI_DX
FACT_PARTICI_DZ
MASS_EFFE_UN_DX
MASS_EFFE_UN_DY
NORME
METHODE
2/FORM_TABL = “EXCEL”
NUME_ORDRE NUME_MODE
ITER_QR ITER_BATHE…
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 8/10
11 Selection on the components
Another manner of reducing the volume of the impressions is to print only the values of
certain components (for example that displacement following axis X: component DX).
11.1 Operand
TOUT_CMP
This key word makes it possible to indicate that one wishes to print all the components of the field.
11.2 Operand
NOM_CMP
This key word makes it possible to choose the list of the components of the cham_gd or all the fields of the concept
result which one wishes to print.
Key words TOUT_CMP and NOM_CMP cannot be used simultaneously.
These components are described in the specific documentation of the elements.
12 Selection of the topological entities
In order to reduce the volume of the impressions, it is sometimes necessary to print only part of
result. With this intention one can print a field with the nodes only in certain nodes, or a field
by element that in certain elements.
12.1 Operand
TOUT
This key word indicates that one wishes to print the field on all the structure (all the nodes for one
field with the nodes, all the elements for a field by element).
12.2 Operand
NOEUD
This key word makes it possible to indicate the list of the nodes on which one wishes to print a cham_no. If it
key word is used in the case of the impression of a cham_elem, it is ignored, and the cham_elem is
printed in all the meshs specified in addition.
12.3 Operand
GROUP_NO
This key word makes it possible to indicate the list of the groups of nodes on which one wishes to print one
cham_no. If this key word is used in the case of the impression of a cham_elem, it is ignored, and it
cham_elem is printed in all the meshs, specified in addition.
12.4 Operand
MAILLE
This key word makes it possible to indicate the list of the meshs on which one wishes to print a cham_elem.
For a cham_no, it makes it possible to indicate the list of the nodes, nodes of the meshs to which one wishes
to print the cham_no.
12.5 Operand
GROUP_MA
This key word makes it possible to indicate the list of the groups of meshs on which one wishes to print one
cham_elem. For a cham_no, it makes it possible to indicate the list of the nodes, nodes of the meshs to which
one wishes to print the cham_no.
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 9/10
13 Selection on the values
It is also interesting to print only the extreme values of all or some
components, on whole or part of the structure.
13.1 Operand
VALE_MAX
This key word indicates that one wishes to print the maximum value of each component of the field,
possibly in a given interval specified by arguments BORNE_SUP and/or BORNE_INF.
13.2 Operand
VALE_MIN
This key word indicates that one wishes to print the minimal value of each component of the field,
possibly in a given interval specified by arguments BORNE_SUP and/or BORNE_INF.
13.3 Operand
BORNE_SUP
This key word indicates the upper limit of the interval on which one wishes to print the field. One
print all the values of the field lower than this upper limit.
13.4 Operand
BORNE_INF
This key word indicates the lower limit of the interval on which one wishes to print the field. One
print the values of the field higher on this lower terminal.
14 Impression of the co-ordinates: operand IMPR_COOR
This key word makes it possible to specify if one wishes to print the co-ordinates of a node at the time of the writing of one
cham_no with format “RESULTAT”.
15 Operand
FORMAT_R
FORMAT_R =/FORM,
/
“1PE12.5”
[DEFAUT]
Allows to specify the format of writing of the actual values to format “RESULTAT”.
16 Remark
In Aster, there are cham_elem with under points (as well for cham_elem with
nodes that for cham_elem at the points of Gauss). Format “RESULTAT”, IMPR_RESU allows
impression of the cham_elem with under points.
If same a cham_elem has under points on certain meshs and not on others,
the impression of the cham_elem will be done in two times:
·
initially impression of the cham_elem on all the meshs on which there is not under
points,
·
then impression of the cham_elem on all the meshs on which there is under points.
A specific format is used for each one of these impressions.
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_RESU with formats “RESULTAT” and “ASTER”
Date:
18/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.01-H Page
: 10/10
17 Operand
SOUS_TITER
This argument makes it possible to print under title of comment, for more details to consult it
document [U4.03.01].
The SOUS_TITER by defect is:
·
for a champ_gd
- for
one
cham_no
SOUS_TITER
=
('CHAMP
AUX
NOEUDS'
)
- for
one
cham_elem
SOUS_TITER =
(“CHAMP PAR ELEMENT &LOC (cham_elem)”)
Example: `'FIELD BY ELEMENT AT THE POINTS OF GAUSS ''
·
for a result
- for
one
cham_no
SOUS_TITER = (“FIELD WITH THE NODES”,
'OF
NOM
SYMBOLIQUE
&NOM_SYMB (Resultat
cham_no) &RL',
'NUMERO
D '' COMMAND
&NUM_ORDRE (Resultat
cham_no) ',
'&ACCES (Resultat
cham_no)
')
Example of impression:
CHAMP
AUX
NOEUDS
OF
NOM
SYMBOLIQUE
DEPL
NUMERO
Of COMMAND:
2
NUME_MODE:
3
FREQ
:
5.52739E+00
- for
one
cham_elem
SOUS_TITER
=
('CHAMP
PAR
ELEMENT
&LOC (Resultat
cham_elem) ',
'OF
NOM
SYMBOLIQUE
&NOM_SYMB (Resultat
cham_elem) &RL',
'NUMERO
D '' COMMAND
&NUM_ORDRE (Resultat
cham_elem)
',
'&ACCES (Resultat
cham_elem)
')
Example of impression:
FIELD BY ELEMENT WITH THE NODES OF REFERENCE SYMBOL
EPSI_ELNO_DEPL
NUMERO
Of COMMAND:
1
INST
:
0.00000E+00
18 Impression of the grid: operands MAILLAGE/MODELE
This argument makes it possible to print the grid with FORMAT = “ASTER” and/or “RESULTAT”. One
then find the format used for LIRE_MAILLAGE [U4.21.01] and defined in [U3.01.00].
By defect, one prints all the grid.
Concept of the model type is optional in the majority of the impressions. However, it can be
used in the case of the impression of a grid to formats “ASTER” and/or “RESULTAT”, in order to
to print only the part of the grid whose meshs are affected in the model.
If one chooses format “ASTER”, the grid is written in a file of the .mail type which can then be
read again by LIRE_MAILLAGE.
If one chooses format “RESULTAT”, the grid is written, by defect, in the file .resu and cannot
to be read again by LIRE_MAILLAGE just as it is because the file .resu contains titles in addition, under
titles and possibly of other information.
Handbook of Utilization
U4.9- booklet: Impression of the results and tests
HT-66/05/004/A
Outline document