3. Operands#
3.1. Operand UNITE#
Logical unit number of the file containing the table (s) to be read.
3.2. Operand FORMAT#
Name of the format in which the file table was written.
3.2.1. notes#
When reading values, we try to interpret the value as integer, real, real with the decimal point instead of the dot as a decimal separator, otherwise as a character string.
The empty cell value is not the same in the TABLEAU, ASTER, and LIBRE formats.
3.2.2. Size TABLEAU#
This is the format by default.
In TABLEAU format, the command estimates the number of columns in the file. To do this, the lines are cut using SEPARATEUR. The number of columns in the table is then supposed to be the maximum found across all rows.
Lines beginning with the # character are considered comments and added to the table title.
Among the values we can find (-), which means that there is no value for this parameter.
There are no delimiters to separate multiple tables in a file. We consider that we have reached the end of a table when the number of columns decreases.
The TABLEAU format should allow tables printed with IMPR_TABLE to be re-read in the same format. However, unlike the ASTER format, the type is automatically determined based on the values read. The type of character strings can thus be different.
3.2.3. Size ASTER#
The ASTER format requires some characteristics as shown in the following table:
+————————————+——+——-+—-+———+———–+————++ |**# DEBUT_TABLE** | +------------------------------------+------+-------+----+---------+-----------+------------++ |**# TITRE** line 1 of the title text | +------------------------------------+------+-------+----+---------+-----------+------------++ |**# TITRE** ** line 2 and following | +------------------------------------+------+-------+----+---------+-----------+------------++ |INTITULE |CHEMIN|SEGMENT|RESU|NOM_CHAM |INST |SIXX || +————————————+——+——-+—-+———+———–+————++ |K8 |K16 |I |K8 |K16 |R |R || +————————————+——+——-+—-+———+———–+————++ |GLOBAL |CHEM1 |1 |SIG |SIGM_ELNO|0.00000E+00|—1.48981E+07|| +————————————+——+——-+—-+———+———–+————++ |GLOBAL |CHEM1 | |SIG | |1.00000E+00|—2.48981E+07|| +————————————+——+——-+—-+———+———–+————++ |GLOBAL |CHEM1 |2 |SIG |SIGM_ELNO|1.00000E+00|—3.48981E+07|| +————————————+——+——-+—-+———+———–+————++ |... | | | | | | || +————————————+——+——-+—-+———+———–+————++ |**# FIN_TABLE** | | | | | | || +————————————+——+——-+—-+———+———–+————++
Any table in the ASTER format starts with the keyword # DEBUT_TABLE **and ends with**# FIN_TABLE **. These are the boundaries that make it possible to know where reading starts and where it stops.
# DEBUT_TABLE is then followed by title lines that are necessarily preceded by the keyword # TITRE.
Next is a line containing all the names of the parameters, then a line containing all the types of these parameters. These types must belong to the following list: K8, K16, K16, K24, K32, K80, I, R.
The following lines give the values for all parameters.
Among the values we can find (-), which means that there is no value for this parameter.
The ASTER format should allow tables printed with IMPR_TABLE to be re-read in the same format.
3.2.4. Size LIBRE#
The LIBRE format is very similar to the TABLEAU format except that the # character has no particular meaning and that the absence of a value for a parameter corresponds to an empty string.
3.3. Operand NUME_TABLE#
It is possible to read one of several tables in a file. Indicate the number of the th table to be read. By default, the first table is read.
3.4. Operand SEPARATEUR#
Multiple separators in a row only count as one. The separator by default is a space.
To indicate that the fields are separated by a tab, we will say: SEPARATEUR =”t”.
3.5. Operand RENOMME_PARA#
In a table, all parameters should be distinct. If this is not the case in the file to be read, the reading fails because the table cannot be produced.
By specifying, RENOMME_PARA = “UNIQUE” (the only choice possible if the keyword is entered), if a parameter read has already been encountered, a numbered suffix of the form: « _i » is added to it.
Example: two columns are named INST in the file. The table will be produced with one parameter named INST and the second one named INST_1.
3.6. Operand TITRE#
Title attached to the concept produced by this operand [U4.03.01].
This title replaces the title of the table read.
3.7. Operand INFO#
With INFO = 2, details about the data read are shown. They are very numerous and are only useful in order to understand why a file is not read as expected.