Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 1/10
Organization (S): EDF-R & D/AMA
Handbook of Utilization
U4.9- booklet: Impression/Test
Document: U4.91.03
Procedure IMPR_TABLE
1 Goal
To print the contents of a table in a file.
The command makes it possible to print a subset of the table under various formats. The format by
defect (TABLEAU) is practical for an examination by software of the type spreadsheet, others
formats allow a direct visualization with a graph plotter (for example xmgrace or
agraf).
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 2/10
2 Syntax
IMPR_TABLE
(
TABLE
= matable,
[tabl_ *]
TITER
=
titrate
[l_Kn]
SENSIBILITE = (… to see [U4.50.02])
UNITE
=
/
8, [DEFAUT]
/
links, [I]
# 1. choice of the lines to be printed:
FILTRE = (_F (
NOM_PARA
=
para, [kN]
/
CRIT_COMP
=
/“EQ”,
[DEFAUT]
/“”,
/“LT”,
/“WP”,
/“IT”,
/“GE”,
/VALE_I
=
ival,
[I]
/
VALE_K
=
kval,
[KN]
//
VALE
=
rval,
[R]
/
VALE_C
=
cval,
[C]
|
PRECISION =/prec,
[R8]
/
1.0D-3,
[DEFAUT]
|
CRITERION =/“RELATIVE”, [DEFECT]
/
“ABSOLU”,
/
CRIT_COMP
=
/“MAXI”,
/“ABS_MAXI”,
/“MINI”,
/“ABS_MINI”,
/“VIDE”,
/“NON_VIDE”,
),),
# 2. choices of the columns to be printed:
NOM_PARA
=
will lpara,
[l_Kn]
# 3. choices about the lines to be printed:
TRI = (_F (
NOM_PARA
=
will lpara,
[l_Kn]
ORDRE
=
/“CROISSANT”
,
[l_Kn]
/“DECROISSANT”,
),),
# 4. choices of the formats of impression:
FORMAT
=
/
“TABLEAU”,
[DEFAUT]
/
“ASTER”,
/“XMGRACE”,
/“AGRAF”,
/“TABLEAU_CROISE”,
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 3/10
PAGINATION
=
lpagi,
[l_Kn]
FORMAT_R
=
/
“E12.5”,
[DEFAUT]
/
form,
FORMAT_C =/“MODULE_PHASE”,
[DEFAUT]
/
“REEL_IMAG”,
IMPR_FONCTION
=
/
“NON”,
[DEFAUT]
/
“OUI”,
INFO
=/
1,
[DEFAUT]
/2,
# If FORMAT = “XMGRACE”
PILOTE
=
/
“XMGRACE”,
[DEFAUT]
/
“POSTSCRIPT”,
[KN]
/“EPS”,
/“MIF”,
/“SVG”,
/“PNM”,
/“Png”,
/“JPEG”,
/“Pdf”,
/“INTERACTIF”,
# Mise in form if FORMAT = “XMGRACE”
LEGENDE =
leg, [kN]
STYLE
=
sty, [I]
COULEUR =
coul,
[I]
MARQUEUR
=
marq,
[I]
FREQ_MARQUEUR
= Fm,
[I]
BORNE_X = (xmin,
xmax),
[l_R]
BORNE_Y = (ymin,
ymax),
[l_R]
ECHELLE_X
=
/
“LIN”,
[KN]
/“LOG”,
ECHELLE_Y
=
/
“LIN”,
[KN]
/“LOG”,
GRILL_X
=
pasx,
[R]
GRILL_Y
=
pasy,
[R]
LEGENDE_X
=
legx,
[KN]
LEGENDE_Y
=
legy,
[KN]
)
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 4/10
3 Operands
3.1 What is this
that one
counts?
A table is a structure of data of data-processing nature making it possible to store one
together of whole values, real, complex or character strings.
A table is comparable with the worksheet of a spreadsheet, i.e. one can see it like one
list columns in opposite. Each column has a field name, which we call parameter,
and contains similar data of type: I, R, C, K8, K16, K24 or K32.
Example:
NUME_ORDRE INST NODE G_LOCAL
1 10.
N1
5.
1 10.
N2
6.
1 10.
N3
7.
1 10.
N4
8.
2 20.
N1
9.
2 20.
N2
9.
2 20.
N3
8.
2 20.
N4
8.
3 30.
N1
7.
3 30.
N2
6.
3 30.
N3
5.
One can also see the table as a succession of recordings (which we will call lines). All
the lines do not have inevitably the same structure (i.e. same parameters). For example:
ACTION NUME_ORDRE INST NODE DX
DY NET SIXX
INTITULE
1
1
10. N1 3. 5.
INTITULE
1
1
10. N2 6. 7.
INTITULE
1
1
10. N3 8. 9.
INTITULE 1
2
20.
N1
11.
12.
INTITULE 1
2
20.
N2
15.
13.
INTITULE 1
2
20.
N3
19.
18.
INTITULE
2 2 20.
MA1
- 12.
INTITULE
2 2 20.
MA2
- 14.
To print the contents of a table, the user will be able:
·
to select the columns and the lines which he wants to print [§3.6]
·
to choose a criterion of command of impression of the lines [§3.7]
·
to choose the “format” of impression: in lines, tables,… [§3.8]
3.2 Operand
TABLE
TABLE = matable
Name of the table which one wants to print
3.3 Operand
TITER
TITER = title
Character string which will be printed before the table (and the title possibly attached to
count). This chain can make it possible to better distinguish from the impressions of tables put end at
boils in the same file.
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 5/10
3.4 Operand
UNITE
Allows to choose in which file, one prints the table.
By defect, UNITE = 8 what corresponds to the file .resu.
With format “XMGRACE”, the default value is 29, standard dat in astk.
3.5 Operand
SENSIBILITE
SENSIBILITE = par_sensi
Name of the associated significant parameter (see [U4.50.01])
3.6 To select what one wants to print: key words FILTRE and
NOM_PARA, TOUT_PARA
The user chooses the columns to be printed thanks to key words NOM_PARA and TOUT_PARA. He chooses
lines to be printed thanks to the key word factor (répétable at will) FILTRE.
3.6.1 Word
key
FILTRE
The key word factor FILTRE makes it possible to retain in the table only the lines checking certain criteria
imposed by the user. The occurrences of the key word are added the ones to the others like
successive filters. For each occurrence of this key word, one specifies the name of the parameter for
which one imposes a condition, the type of condition (equality, not-equality, smaller,…) as well as
value associated with the condition.
3.6.1.1 Operand
NOM_PARA
NOM_PARA = para
para is the name of the parameter to which the constraint of filtering relates.
3.6.1.2 Operand
CRIT_COMP
CRIT_COMP = crit
crit is the type of the constraint of filtering.
EQ
“equality” for the entireties, the texts, realities or the complexes.
For the floating numbers (real or complex), this equality is evaluated with
a certain tolerance given by key words PRECISION and CRITERE.
“not-equality” (Cf. EQ)
LT
“smaller than”
Relations of command:
- natural for the entireties and realities
- alphabetical for the texts
- invalid for the complexes
WP
“larger than” (Cf. LT)
“smaller or equal to” (Cf. LT)
GE
“larger or equal to” (Cf. LT)
VIDE
blank cell
NON_VIDE
nonempty cell
MAXI
the line selected will be that which will have the maximum value
ABS_MAXI
the line selected will be that which will have the maximum absolute value
MINI
the line selected will be that which will have the minimal value
ABS_MINI
the line selected will be that which will have the minimal absolute value
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 6/10
3.6.1.3 Operands
VALE/VALE_I/VALE_C/VALE_K
These various key words are used according to the type of the column associated with the parameter on
which carries the constraint: entirety, reality, complex or text.
One gives in argument the value associated with the constraint; for example 12 if one is interested only in
sequence number 12.
This operand is useless when the types of constraint are used: “VACUUM”, “NON_VIDE”, “MAXIMUM”,
“MINI”,…
3.6.1.4 Operands
CRITERION/PRECISION
When the constrained parameter is of floating type (real or complex) and that the type of constraint is
the equality (or not-equality), this equality is evaluated with a certain tolerance.
PRECISION = eps,
eps is the tolerance
“RELATIVE” CRITERE=/,
|x-xref| < eps *|xref|
/“ABSOLU”
,
|x-xref|
<
eps
3.6.1.5 Example
of use of key word FILTRE
If one specifies:
FILTRE= (_F (NOM_PARA= “NODE”, VALE_K = “N7”,),
_F (NOM_PARA= “INST”, CRIT_COMP= “WP”, VALE= 3.0,),
_F (NOM_PARA= “INST”, CRIT_COMP= “LT”, VALE= 13.0,),
),
One thus selects the lines of the table such as parameter NOEUD is worth “N7” and such as
parameter INST lies between 3. and 13.
3.6.2 Operand
NOM_PARA
If key word NOM_PARA misses, all the columns of the table will be printed.
If the user uses the key word NOM_PARA = will lpara, only the specified parameters will be printed
in the list will lpara and the order of the list.
3.7
To order the lines of a table: the key word factor TRI
Only one occurrence is accepted for the key word factor TRI.
3.7.1 Operand NOM_PARA = will lpara
This key word is used to specify the list of the parameters which will be used to order the lines of the table (it can
y to need several parameters). In the event of equality on the first parameter, one uses it
according to…
Note:
One can use for the sorting of the parameters which one does not print.
3.7.2 Operand COMMAND
This key word is used to specify if one must use an order ascending or decreasing. By defect, one sorts by
ascending order.
The relations of command used are:
·
the natural command for the entireties and realities,
·
the alphabetical order for the texts and the names of concepts.
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 7/10
Note:
One cannot be useful oneself of a parameter complexes to classify the lines of a table.
For the parameters of the type NOEUD (or MAILLE), the command is alphabetical because these parameters
contain the name of the nodes (or meshs).
3.7.3 Example of use of key word TRI
If one specifies:
TRI=_F (NOM_PARA= (“NODE”, “INST”), ORDRE= “GROWING”),
One will print the lines of the table in the alphabetical order of the nodes. If there are several lines
correspondent with a given node, the second sort key (INST) will be used to classify these lines.
3.8
Choice of the format of impression: key words FORMAT, PAGINATION,…
By defect the format of impression is format “TABLEAU”, i.e. presentation in columns of
various selected parameters (as for the examples of this document). Software EXCELTM
offer a whole of tools allowing to exploit this type of file: dynamic sorting, filtering, tables,
…
3.8.1 FORMAT = “TABLEAU” or “AGRAF”
An example of table printed with format “TABLEAU”:
NUME_ORDRE INST NODE DX DY
1
4. N7 3.4
3.8
1
4. N4 2.4
2.8
1
4. N2 1.4
1.8
4
8. N7 3.4
3.8
4
8. N4 2.4
2.8
4
8. N2 1.4
1.8
7 20.
N7
3.4
3.8
7 20.
N4
2.4
2.8
7 20.
N2
1.4
1.8
The only difference between format “TABLEAU” and format “AGRAF” is that for this last, them
columns of “text” (for example NOEUD above) are preceded by a” \ “.
Note:
With format AGRAF, any directive (file .digr) is not produced, only the values (file
.dogr) is it.
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 8/10
3.8.2 FORMAT = “ASTER”
The difference between format “ASTER” and format “TABLEAU” is the heading of the table and its last
line. This difference is justified by fact qu `a table printed with format “ASTER” can be read again
by Code_Aster (command LIRE_TABLE [U7.02.03]).
Example:
# DEBUT_TABLE
# TITRATES ASTER 6.03.11 CONCEPT TAB_REAC CALCULATES THE 12/07/2002
# TITRATES TABL_POST_RELE
ENTITLE RESU NOM_CHAM NUME_ORD INST DY
K8 K8 K16 I R R
MESSAGE RESU REAC_NODA 1 2.50000E-01 - 2.25146E+00
MESSAGE RESU REAC_NODA 2 5.00000E-01 - 4.44089E+00
MESSAGE RESU REAC_NODA 3 7.50000E-01 - 6.59515E+00
MESSAGE RESU REAC_NODA 4 1.00000E+00 - 8.65972E+00
MESSAGE RESU REAC_NODA 5 1.25000E+00 - 1.06742E+01
MESSAGE RESU REAC_NODA 6 1.50000E+00 - 1.26438E+01
MESSAGE RESU REAC_NODA 7 1.75000E+00 - 1.45569E+01
# FIN_TABLE
3.8.3 FORMAT = “TABLEAU_CROISE”
Format “TABLEAU_CROISE” is reserved for the tables at double entry. The impression is done under
form of a table which one documented the names of columns and the names of lines. This
impression relates to the tables having 3 parameters. One represents the values of the one of the 3
parameters according to the 2 others.
Example: DX according to NOEUD and INST:
DX FUNCTION OF NODE AND INST
4.
8.
20.
NODE/INST N7
3.4
3.4
3.4
N4
2.4 2.4
2.4
N2
1.4 1.4
1.4
NOM_PARA = (“NODE”, “INST”, “DX”)
The parameter “filling out” the table is 3rd list indicated by single-ended spanner word NOM_PARA.
The parameter “X-coordinate” is 2nd list indicated by single-ended spanner word NOM_PARA.
The parameter “ordered” is 1st list indicated by single-ended spanner word NOM_PARA.
Note:
If the table contains more than 3 parameters, one can use key word PAGINATION for
“to shell” the values taken by the other parameters (see example 3).
3.8.4 FORMAT = “XMGRACE”
This format makes it possible to produce a directly displayable file in xmgrace in the form of
curve.
One has the same functionalities of working as in IMPR_FONCTION.
If PILOTE is not specified, one produces a data file for xmgrace; if PILOTE is
informed and if the selected pilot is indeed available on the machine, one can produce
directly a file postscript, png,…
Key words of working of the graph: to see IMPR_FONCTION [U4.33.01].
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 9/10
3.8.5 Operand
PAGINATION
This key word is used to print a table per pieces (like a whole of smaller tables). One
give a parameter list (lpagi) which will be shelled and printed like titles of small
tables.
The list of the parameters of pagination (lpagi) must be included in the complete list of the parameters
that one wants to print (will lpara).
If one wants to use the pagination and format “TABLEAU_CROISE”, one needs that the list will lpara, once
that the parameters of lpagi were withdrawn to him is made of 3 residual parameters. These 3 parameters
will be used for the presentation in table [§3.4.3].
Example: FORMAT= `TABLEAU', PAGINATION = “NODE”
NOEUD: N7
NUME_ORDRE INST
DX
DY
1 4.
3.4
3.8
4 8.
3.4
3.8
7 20.
3.4
3.8
NOEUD: N4
NUME_ORDRE INST
DX
DY
1 4.
2.4
2.8
4 8.
2.4
2.8
7 20.
2.4
2.8
NOEUD: N2
NUME_ORDRE INST
DX
DY
1 4.
1.4
1.8
4 8
1.4
1.8
7 20.
1.4
1.8
3.8.6 Operand
FORMAT_C
For the complexes, two formats of impression are available (module/phase by defect or part
real/left imaginary).
3.8.7 Operand
FORMAT_R
This key word makes it possible to choose the number of decimals printed for each floating number: (reality or
complex).
One uses for that the syntax of FORTRAN.
For example, for the default value: “E12.5”, one will print each floating number on 12
characters, with 5 decimals and in scientific notation (with an exhibitor).
3.8.8 Operand
IMPR_FONCTION
For the tables containing in their cells of the names of function, this key word makes it possible to indicate
that one wants to also print the contents of the functions referred in the table.
One prints initially the table (as it was seen above) then one “loops” on all the functions
contained in the printed part of the table and one these functions (like does it the command prints
IMPR_FONCTION).
3.9 Operand
INFO
INFO = inf
Print in the file “message” of additional information if inf=2. Nothing occurs
if inf=1.
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Code_Aster ®
Version
7.4
Titrate:
Procedure IMPR_TABLE
Date:
15/02/05
Author (S):
Key COURTEOUS Mr.
:
U4.91.03-E Page
: 10/10
4 Examples
Example 1: to discover the structure of a table
IMPR_TABLE (TABLE = POST_REL)
Example 2: to print some parameters with filter and sorting
IMPR_TABLE (TABLE = POST_REL,
FILTRE=_F (NOM_PARA=' INST', VALE= 0.,
CRITERION = “ABSOLUTE”),
TRI=_F (NOM_PARA= (“ABS_CURV”, “COOR_X”), ORDRE= (“GROWING”),
NOM_PARA = (“COOR_X”, “TEMP”),
)
Example 3: to use the pagination and format TABLEAU_CROISE
IMPR_TABLE (TABLE = POST_REL,
NOM_PARA = (“COOR_X”, “TEMP”, “ABS_CURV”, “INST”, “COOR_Y”),
PAGINATION= (“INST”, “COOR_X”),
FORMAT = “TABLEAU_CROISE”,
)
Example 4: to print the contents of derived from the G1 table compared to the significant parameter
YOUNG:
IMPR_TABLE (TABLE = G1, SENSITIVITY = YOUNG)
Handbook of Utilization
U4.9- booklet: Impression/Test HT-66/05/004/A
Outline document