..
- Copyright (C) 2008-2015 EDF R&D
+ Copyright (C) 2008-2023 EDF R&D
This file is part of SALOME ADAO module.
List of possible input types
----------------------------
-.. index:: single: Dict
-.. index:: single: Function
-.. index:: single: Matrix
-.. index:: single: ScalarSparseMatrix
-.. index:: single: DiagonalSparseMatrix
-.. index:: single: String
-.. index:: single: Script
-.. index:: single: Vector
+Each variable to be entered for the use of ADAO can be represented by means of
+particular "pseudo-types", which help to logically fill it in and validate it
+computationally. These pseudo-types explicitly represent mathematical forms
+(:ref:`section_ref_entry_types_math`) or simple computer forms
+(:ref:`section_ref_entry_types_info`), which are detailed here.
+:ref:`section_notations` are also used, together with
+:ref:`section_ref_entry_types_names`.
-Each ADAO variable has a pseudo-type to help filling it and validation. The
-different pseudo-types are:
+The explicit :ref:`section_ref_algorithm_InputValuesTest` test is designed so
+that the user can specifically check some entries, with the same analysis and
+criteria as during the usual setup of a study.
-.. index:: single: Dict
+.. _section_ref_entry_types_math:
-**Dict**
- This indicates a variable that has to be filled by a Python dictionary
- ``{"key":"value...}``, usually given either as a string or as a script file.
+Pseudo-types of mathematical representation of data
++++++++++++++++++++++++++++++++++++++++++++++++++++
-.. index:: single: Function
+The inputs are described according to the simplest possible logic, in
+mathematical representation, for algorithms or calculation tools.
-**Function**
- This indicates a variable that has to be filled by a Python function,
- usually given as a script file or a component method.
+.. include:: snippets/EntryTypeVector.rst
-.. index:: single: Matrix
+.. include:: snippets/EntryTypeVectorSerie.rst
-**Matrix**
- This indicates a variable that has to be filled by a matrix, usually given
- either as a string or as a script file.
+.. include:: snippets/EntryTypeMatrix.rst
-.. index:: single: ScalarSparseMatrix
+.. include:: snippets/EntryTypeFunction.rst
-**ScalarSparseMatrix**
- This indicates a variable that has to be filled by a unique number (which
- will be used to multiply an identity matrix), usually given either as a
- string or as a script file.
+.. include:: snippets/EntryTypeDict.rst
-.. index:: single: DiagonalSparseMatrix
+The variables to which these pseudo-types apply can themselves be given using
+the following computer descriptions.
-**DiagonalSparseMatrix**
- This indicates a variable that has to be filled by a vector (which will be
- used to replace the diagonal of an identity matrix), usually given either as
- a string or as a script file.
+.. _section_ref_entry_types_info:
-.. index:: single: Script
+Pseudo-types of digital data description
+++++++++++++++++++++++++++++++++++++++++
-**Script**
- This indicates a script given as an external file. It can be described by a
- full absolute path name or only by the file name without path. If the file
- is given only by a file name without path, and if a study directory is also
- indicated, the file is searched in the given directory.
+Three pseudo-types, purely computer-based, are used to specify the way in which
+input variables are provided.
-.. index:: single: String
+.. include:: snippets/EntryTypeScript.rst
-**String**
- This indicates a string giving a literal representation of a matrix, a
- vector or a vector series, such as "1 2 ; 3 4" or "[[1,2],[3,4]]" for a
- square 2x2 matrix.
+.. include:: snippets/EntryTypeString.rst
-.. index:: single: Vector
+.. include:: snippets/EntryTypeDataFile.rst
-**Vector**
- This indicates a variable that has to be filled by a vector, usually given
- either as a string or as a script file.
+.. _section_ref_entry_types_names:
-.. index:: single: VectorSerie
+Information on the names required for file entries
+++++++++++++++++++++++++++++++++++++++++++++++++++
-**VectorSerie**
- This indicates a variable that has to be filled by a list of
- vectors, usually given either as a string or as a script file.
+When a command or keyword can be entered using a script file identified by the
+pseudo-type "*Script*", this script must contain a variable or method that has
+the same name than the variable to be completed. In other words, when importing
+such a script into a Python command or Python node, it must create a variable
+of the correct name in the current namespace of the node. For example, a Python
+script making available the draft variable, named "*Background*", must have the
+following form::
-When a command or keyword can be filled by a script file name, the script has to
-contain a variable or a method that has the same name as the one to be filled.
-In other words, when importing the script in a YACS Python node, it must create
-a variable of the good name in the current name space of the node.
+ ...
+ ...
+ Background =...
+ ...
+ ...
+
+Its import thus makes it possible to create the variable "*Background*" in the
+current namespace. The dots"..." symbolize any code around this particular line
+beginning.
+
+Similarly, when a particular vector can be filled in using a data file
+designated by the pseudo-type "*DataFile*", the information in the file
+"*DataFile*" must be named after the vector to be loaded.