**************
Dataset Syntax
**************

The following syntax rules must be observed for a dataset:

- The ``*`` character indicates that the remaining part of the line is a comment;
- The dataset consists of a sequence of blocks containing keywords and their associated argument values, which can be separated by any number of spaces or line breaks;
- Keywords in M6Geo generally consist of 3 or 4 letters.
- Identifiers for the different entities defined within the dataset (volumes name, types name) can contain any number of alphanumeric characters.

Some keywords may be followed by a variable number of arguments.
Two syntaxes exist:

- The user first specifies the number of parameters, then lists the parameters;
- The user writes the parameters within parentheses.

For example, the two syntaxes are equivalent:

.. code-block:: m6geo

  SUPE 4 1 2 3 4    * Specify the number of arguments first
  SUPE ( 1 2 3 4 )  * Arguments are within parentheses

.. hint::
  While the dataset layout is free-form, it is recommended to adopt the following tips to make it easier to read:

  - arrange the data in an easily readable format;
  - add comment lines.

As an example, M6Geo will interpret the following two datasets in the same way. 
However, the first version is clearly preferable.

.. code-block:: m6geo

  * dataset easily readable

  * Hexagonal lattice - upper part according to OZ
  MODU  M_lat1
  
  * External Volume of the module
  TYPE  F_ext   CYLZ 117.  10.8
  VOLU  V_ext  0  F_ext  air    0.  0.  0.
  
  * Type for the meshes
  TYPE  F_mesh  HEXZ  7.5089  10.8  150.
  
  * Mesh external zone
  VOLU  V1  V_ext F_mesh  air    0.  0.  0. 
  HOLE  H_mesh1   V1   F_mesh   M_mesh1   0.  0.  0. 
  * Mesh internal zone
  VOLU  V2   V_ext F_mesh   air   0.  0.  0.
  HOLE  H_mesh2   V2   F_mesh   M_mesh2   0.  0.  0.
  
  * Hexagonal Lattice with both types of meshes
  LATH
    MPRI  V2
    DIML 9 1
  LAYE  0
                      V1  V1  V1  V1  V1  V1  V1  V1 V1
                    V1  V1  V1  V1  V1  V1  V1  V1  V1  V1
                  V1  V1  V2  V2  V2  V2  V2  V2  V2  V1  V1
                V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
              V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
            V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
          V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
        V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
      V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
        V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
          V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
            V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
              V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
                V1  V1  V2  V2  V2  V2  V2  V2  V2  V2  V1  V1
                  V1  V1  V2  V2  V2  V2  V2  V2  V2  V1  V1
                    V1  V1  V1  V1  V1  V1  V1  V1  V1  V1
                      V1  V1  V1  V1  V1  V1  V1  V1  V1

  ENDL
  ENDM

.. code-block:: m6geo

  * Same as above but more complicated to read
  MODU 4
  TYPE 5 CYLZ 117 10.8 VOLU 5 0 5 10 0 0 0
  TYPE 10 HEXZ 7.5089 10.8 150
  VOLU 12 5 10 1 0 0 0 HOLE 12 12 10 23 0 0 0
  VOLU 14 5 10 2 0 0 0 HOLE 14 12 10 22 0 0 0
  LATH
  MPRI 14 DIML 9 1 LAYE 0
  12 12 12 12 12 12 12 12 12 12 12 12 12 12 12 12 12 12 12
  12 12 14 14 14 14 14 14 14 12 12 12 12 14 14 14 14 14 14
  14 14 12 12 12 12 14 14 14 14 14 14 14 14 14 12 12 12 12
  14 14 14 14 14 14 14 14 14 14 12 12 12 12 14 14 14 14 14
  14 14 14 14 14 14 12 12 12 12 14 14 14 14 14 14 14 14 14
  14 14 14 12 12 12 12 14 14 14 14 14 14 14 14 14 14 14 14
  14 12 12 12 12 14 14 14 14 14 14 14 14 14 14 14 14 12 12
  12 12 14 14 14 14 14 14 14 14 14 14 14 12 12 12 12 14 14
  14 14 14 14 14 14 14 14 12 12 12 12 14 14 14 14 14 14 14
  14 14 12 12 12 12 14 14 14 14 14 14 14 14 12 12 12 12 14
  14 14 14 14 14 14 12 12 12 12 12 12 12 12 12 12 12 12 12
  12 12 12 12 12 12 12 12
  ENDL
  ENDM