Operands
=========


Operand FICHIER
----------------


.. code-block:: text

    ♦ FICHIER = fart,

Here we provide the name of the file to be analyzed with its path relative to the execution directory or in absolute terms. Examples: 'fort.37' or '. /REPE_OUT /results.pos'.


Operand EXPR_IGNORE
--------------------


.. code-block:: text

    ◊ EXPR_IGNORE = regexp

The lines in the file satisfying the regular expressions given behind this keyword will be ignored in the analysis of the file.


.. code-block:: text

    Example: *


.. code-block:: text

    EXPR_IGNORE = ('DATE = [0-9] {2}/[0-9] {2}/[0-9] {4}',
'^ VERSION ')

Here lines containing DATE =dd/mm/yyyy where :math:`j`, :math:`m`, :math:`a` are numbers **or** starting with VERSION are ignored.


Operand TYPE_TEST
------------------

Type of test done on the real and integer values of the file. Possible values are:


* SOMM: sum of values


* SOMM_ABS: sum of absolute values


* MAXI: maximum value


* MINI: minimum value


* MAXI_ABS: maximum absolute values


* MINI_ABS: minimum of absolute values


Operands NB_VALE and NB_VALE_I
-----------------------------

NB_VALE is the number of actual values expected in the file. This is the only mandatory test.

NB_VALE_I is the number of integer values expected in the file.


Keywords common to orders TEST_XXX
----------------------------------------

The definition of the non-regression and reference values, as well as the allowable tolerances, and the criteria for comparison are detailed in the documentation [:ref:`u4.92.01 <u4.92.01>`] for the TEST_RESU command.

The specificities of TEST_FICHIER are:


* no complex values,


* no absolute value test (except with TYPE_TEST),


* VALE_CALC, VALE_CALC_I, and VALE_CALC_K can be provided together,


* no tolerance on the value of the parameter (TOLE_MACHINE and CRITERE take only one value).


* VALE_CALC provides the expected reference value for the test on real values (the sum or maximum or...).


* VALE_CALC_I provides the expected reference value for the test on integer values (the sum or maximum or...).


* VALE_CALC_K provides the md5 signature of the file text after all real and integer values have been removed. To get the value on the reference file, simply run the TEST_FICHIER command and record the displayed value (it is a sequence of 32 hexadecimal characters).


Operand INFO
-------------

◊ INFO = under

Specify the details of the information printed in the message file.

If inf=1, we get the following summary:

(taken from ssls108a)

File name:. /REPE_OUT/DEP12 .pos

Calculated Reference

Integers:

Number of values: 176 176

Sum of values: 878,878

Real:

Number of values: 10375 10375

Sum of values: 1.5553683808e+04 1.5553683808e+04

checksum: e5050b2a3517728c4cc0e23af2b16ba5 not_tested

If inf=2, we have the list of all values recorded in the file, read by block (5897 real values and 118 integer values in the 3rd block of this example):

Real numbers: 5897

[:ref:`'2.1774365E-003', '2.4554530E-003', '2.4552944E-003', '7.0000000E+000', ... <'2.1774365E-003', '2.4554530E-003', '2.4552944E-003', '7.0000000E+000', ...>`]

Whole numbers: 118

[:ref:`'1', '0', '0', '0', '0', '0', '0', '144', '0', '0', '0', '0', '0', '0', ... <'1', '0', '0', '0', '0', '0', '0', '144', '0', '0', '0', '0', '0', '0', ...>`]

as well as all the remaining text once all the numbers have been extracted:

Text:

$endView$view DEFZ_DRX